SkyWave IDP 100 Series Developer's Manual

Text of the manual

IDP 100 Modem Series

Developer Guide T203, Version 04 The electronic version of this document allows you to use the built-in Hyperlinks and bookmarks when using Adobe Reader © SkyWave Mobile Communications Inc.

IDP 100 Modem Series - Developer Guide

T203, Version 04 ii © SkyWave Proprietary Legal Notice This documentation is owned by SkyWave Mobile Communications Inc. (SkyWave) and protected by applicable copyright laws and international treaty provisions. Other copyrighted names used are the property of their respective owners. Therefore, you must treat this documentation like any other copyrighted material. You may not make the documentation, or copies thereof, available in any manner or form, or use, copy or transfer any part, to anyone outside your company. If you received this documentation by electronic transmission or download, by installation or use of the documentation, you acknowledge that you have read and understand this license agreement and agree to be bound by its terms and conditions. This documentation is provided on an as-is basis without any warranty of any kind. You assume the entire risk as to the results or performance of the software. Under no circumstance shall SkyWave be held liable for any direct, indirect, consequential, or incidental damages arising from the use or inability to use the software or documentation. All trademarks or registered trademarks are the property of their respective owners. INMARSAT, the Inmarsat logo and IsatData Pro are trademarks of Inmarsat used under license by SkyWave. Inmarsat is not responsible for the operation and regulatory compliance of the products and services referred to in this document that connect to the Inmarsat system. SkyWave reserves the right to make changes to products and or specifications without notice. From www.SkyWave.com login, and follow the link to the downloads section. The complete Software and Documentation License Agreement is distributed as a part of the IDP Developer Toolkit. Contact Information SkyWave Mobile Communications Inc. Online:  Website www.SkyWave.com Online Documentation:  Login at support.skywave.com and follow the link to the downloads section Customer Support by Email:  [email protected] Customer Support by Telephone:  +1.613.836.2222

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary iii T203, Version 04 TABLE OF CONTENTS Legal Notice .................................................................................................................................... ii Contact Information ...................................................................................................................... ii List of Figures .............................................................................................................................. vii List of Tables ................................................................................................................................ vii Preface ........................................................................................................................................... ix What's New? ................................................................................................................................ ix Purpose ........................................................................................................................................ ix Audience ...................................................................................................................................... ix Notation ....................................................................................................................................... ix Reference ...................................................................................................................................... x Limited Liability ........................................................................................................................... x 1 Introduction ......................................................................................................................... 1 2 Modem Overview ................................................................................................................ 3 2.1 Satellite Operation .............................................................................................................. 3 2.1.1 Traffic Channel Acquisition ......................................................................................... 3 2.1.2 Acquisition Times ......................................................................................................... 3 2.1.3 Modem Registration Message ...................................................................................... 3 2.1.4 Beam Switch ................................................................................................................. 3 2.1.5 Blockage ....................................................................................................................... 4 2.1.6 Muting ........................................................................................................................... 4 2.2 Message States ................................................................................................................... 4 2.2.1 To-Mobile States........................................................................................................... 5 2.2.2 From-Mobile States ...................................................................................................... 6 2.3 AT Message Commands .................................................................................................... 7 2.3.1 From-Mobile Messages ................................................................................................ 7 2.3.2 To-Mobile Messages..................................................................................................... 8 2.4 On-board Memory .............................................................................................................. 9 2.4.1 Satellite Messages ....................................................................................................... 10 2.4.2 Network Configuration ............................................................................................... 11 2.4.3 S Registers .................................................................................................................. 11 2.5 Trace Table ....................................................................................................................... 11 2.6 Modem Outputs ................................................................................................................ 11 2.6.1 Reset Out .................................................................................................................... 12 2.6.2 Event Notification ....................................................................................................... 12 2.7 GPS ................................................................................................................................... 12 2.7.1 GPS Request Sources.................................................................................................. 12 2.7.2 GPS Fix Type ............................................................................................................. 13 2.7.3 GPS Fix Times ............................................................................................................ 13 2.7.4 Satellite Transmit Effects ............................................................................................ 14 2.8 Broadcast Messages ......................................................................................................... 14 3 Over-the-Air Interface ...................................................................................................... 15 3.1 Message Lengths .............................................................................................................. 15 3.2 Message Types ................................................................................................................. 15 3.2.1 Modem Messages ....................................................................................................... 15

IDP 100 Modem Series - Developer Guide

T203, Version 04 iv © SkyWave Proprietary 3.2.2 Terminal Core Services .............................................................................................. 16 3.2.3 User Services .............................................................................................................. 16 4 Serial Modes ...................................................................................................................... 17 4.1 Mode Switches ................................................................................................................. 17 4.1.1 Baud Rate .................................................................................................................... 17 5 AT Command Mode ......................................................................................................... 19 5.1 Syntax Definition ............................................................................................................. 19 5.1.1 Conventions ................................................................................................................ 19 5.1.2 Command Rules .......................................................................................................... 19 5.1.3 AT Command General Format ................................................................................... 19 5.2 Transfer Mode .................................................................................................................. 23 5.3 Basic Command Set ......................................................................................................... 23 5.3.1 E – Echo ...................................................................................................................... 23 5.3.2 I – Request ID ............................................................................................................. 24 5.3.3 Q – Quiet ..................................................................................................................... 24 5.3.4 V – Verbose ................................................................................................................ 24 5.3.5 Z – Load Saved Values ............................................................................................... 24 5.3.6 &F – Load with Factory Default Values ..................................................................... 24 5.3.7 &V – Display Configurations ..................................................................................... 25 5.3.8 &W – Save Configuration .......................................................................................... 25 5.3.9 Null Command ............................................................................................................ 25 5.3.10 A/ – Repeat Last Command ........................................................................................ 25 5.4 S Register Commands ...................................................................................................... 26 5.4.1 Command Format ....................................................................................................... 26 5.4.2 S Register Types ......................................................................................................... 26 5.4.3 S Register Definitions ................................................................................................. 26 5.4.4 S3 – Command Line Terminator ................................................................................ 28 5.4.5 S4 – Response Formatting Character .......................................................................... 29 5.4.6 S5 – Command Line Editing Character ...................................................................... 29 5.4.7 S50 – Power Mode ...................................................................................................... 30 5.4.8 S51 – Wake-up Interval .............................................................................................. 30 5.4.9 S60 – Echo Setting (S60) ............................................................................................ 31 5.4.10 S61 – Quiet Setting ..................................................................................................... 31 5.4.11 S62 – Verbose Setting ................................................................................................. 32 5.4.12 S63 – CRC Setting ...................................................................................................... 32 5.4.13 S64 – Prefix Character of CRC Sequence .................................................................. 33 5.4.14 S80 – Last Error Code ................................................................................................ 33 5.4.15 S81 – Most Recent Result Code ................................................................................. 34 5.4.16 S85 – Internal Temperature ........................................................................................ 34 5.4.17 S88 – Event Notification Control ............................................................................... 35 5.4.18 S89 – Event Notification Assert Status ....................................................................... 36 5.4.19 S90, S91, S92 – Capture Trace Define ....................................................................... 37 5.4.20 S93 – Captured Record Properties - Length ............................................................... 38 5.4.21 S94 – Captured Record Properties - Data Sign ........................................................... 38 5.4.22 S95 – Captured Record Properties - Network ID ....................................................... 39 5.4.23 S96 – Captured Record Properties - Timestamp ......................................................... 39 5.4.24 S97, S98 – Captured Trace Properties - Class/Subclass ............................................. 40 5.4.25 S99 – Captured Trace Properties - Severity Level ...................................................... 40 5.4.26 S100, S101, …S123 – Captured Trace Data - Index .................................................. 41

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary v T203, Version 04 5.5 Extended Commands ........................................................................................................ 42 5.6 SkyWave-Proprietary Extended Commands .................................................................... 43 5.6.1 %CRC – Error Detection ............................................................................................ 44 5.6.2 %EVNT – Event Log Get ........................................................................................... 45 5.6.3 %EXIT – Exit Command ............................................................................................ 47 5.6.4 %GPS – Get GPS Information .................................................................................... 48 5.6.5 %MGFG – To-Mobile Message Get........................................................................... 49 5.6.6 %MGFM – To-Mobile Message Rx Retrieved .......................................................... 52 5.6.7 %MGFN – To-Mobile Message New ......................................................................... 53 5.6.8 %MGFS – To-Mobile Message State ......................................................................... 55 5.6.9 %MGRC – From-Mobile Message Cancel ................................................................. 57 5.6.10 %MGRS – From-Mobile Message State .................................................................... 58 5.6.11 %MGRT – From-Mobile Message Send .................................................................... 60 5.6.12 %SREG – View all S Registers .................................................................................. 63 5.6.13 %UTC – Display UTC Date and Time ....................................................................... 63 5.7 Error Result Codes ........................................................................................................... 64 6 Trace Log Mode ................................................................................................................ 65 6.1 Trace Log Mode Commands ............................................................................................ 65 6.2 Trace Types ...................................................................................................................... 65 6.3 AT Command Access ....................................................................................................... 65 6.4 Trace Record Format ........................................................................................................ 66 6.4.1 Trace Record Header .................................................................................................. 66 6.4.2 Class Data ................................................................................................................... 67 6.5 Trace Class Definitions .................................................................................................... 68 6.5.1 System Reset Event Traces (Class 2) .......................................................................... 68 6.5.2 Satellite Event Traces (Class 3) .................................................................................. 70 6.5.3 GPS (Class 4) .............................................................................................................. 76 6.5.4 Receive Message (Class 5) ......................................................................................... 77 APPENDIX A Supported AT Commands .............................................................................. 79 APPENDIX B To-Mobile Messages ........................................................................................ 80 B.1 reset (MIN 68) .................................................................................................................. 80 B.2 setSleepSchedule (MIN 70) .............................................................................................. 81 B.3 setTxMute (MIN 71) ........................................................................................................ 81 B.4 getPosition (MIN 72) ........................................................................................................ 82 B.5 getConfiguration (MIN 97) .............................................................................................. 82 B.6 pingRequest (MIN 112) .................................................................................................... 82 B.7 pingResponse (MIN 113) ................................................................................................. 83 B.8 getBroadcastIDs (MIN 115) ............................................................................................. 83 APPENDIX C From-Mobile Messages ................................................................................... 84 C.1 modemRegistration (MIN 0) ............................................................................................ 84 C.2 protocolError (MIN 2) ...................................................................................................... 85 C.3 sleepSchedule (MIN 70) ................................................................................................... 86 C.4 position (MIN 72) ............................................................................................................. 87 C.5 configuration (MIN 97) .................................................................................................... 87 C.6 pingResponse (MIN 112) ................................................................................................. 88 C.7 pingRequest (MIN 113) .................................................................................................... 88 C.8 testMessage (MIN 114) .................................................................................................... 89 C.9 broadcastIDs (MIN 115) .................................................................................................. 89

IDP 100 Modem Series - Developer Guide

T203, Version 04 vi © SkyWave Proprietary Documentation Version............................................................................................................... 91 Acronyms/Glossary ..................................................................................................................... 92 Index… ......................................................................................................................................... 93

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary vii T203, Version 04 List of Figures Figure 1 Beam Switch ................................................................................................................. 4 Figure 2 Message States .............................................................................................................. 5 Figure 3 From-Mobile AT Command Parameters ...................................................................... 7 Figure 4 Priority Messages .......................................................................................................... 8 Figure 5 To-Mobile Message AT Command Parameters ........................................................... 9 Figure 6 Message Partitions ...................................................................................................... 10 Figure 7 Modem General Purpose Outputs ............................................................................... 12 Figure 8 Trace Log .................................................................................................................... 65 Figure 9 Trace Record Format .................................................................................................. 66 List of Tables Table 1 Maximum Flash Size .................................................................................................. 10 Table 2 Configurable Conditions ............................................................................................. 12 Table 3 Message Lengths......................................................................................................... 15 Table 4 Message Types ............................................................................................................ 15 Table 5 To-Mobile Modem Messages ..................................................................................... 16 Table 6 From-Mobile Modem Messages ................................................................................. 16 Table 7 Effect of V Parameter on Response Formats .............................................................. 21 Table 8 AT Command Information Exchange ......................................................................... 23 Table 9 Basic Commands Supported ....................................................................................... 23 Table 10 S Register Command Format ...................................................................................... 26 Table 11 S Registers .................................................................................................................. 27 Table 12 Extended Command Formats ...................................................................................... 42 Table 13 Extended AT Commands ............................................................................................ 43 Table 14 SkyWave-Proprietary Extended Commands .............................................................. 43 Table 15 Response Result Codes ............................................................................................... 64 Table 16 Common Trace Log Information ................................................................................ 66 Table 17 Trace Class and Subclasses ......................................................................................... 67 Table 18 Trace Data ................................................................................................................... 67 Table 19 Reset Trace Record (Class 2, Subclass 1) ................................................................... 68 Table 20 Low Power Trace Record (Class 2, Subclass 2) ......................................................... 69 Table 21 Satellite General Status Trace Record (Class 3, Subclass 1) ...................................... 70 Table 22 Transmit Status Trace Record (Class 3, Subclass 2) .................................................. 72 Table 23 Satellite Acquire Trace Record (Class 3, Subclass 3) ................................................. 72 Table 24 Satellite Beam Status Trace Record (Class 3, Subclass 4) ......................................... 73 Table 25 Satellite Geographic Adjust (Class 3, Subclass 5) ...................................................... 73 Table 26 Satellite Event Log Data (Class 3, Subclass 6) ........................................................... 74 Table 27 Rx Metrics Trace Record (Class 3, Subclass 16) ........................................................ 74 Table 28 Rx Metrics Trace Record (Class 3, Subclass 17, 18 and 19) ...................................... 74 Table 29 Tx Metrics Trace Record (Class 3, Subclass 20, 21 and 22) ...................................... 75 Table 30 GPS Fix Statistics Trace Record (Class 4, Subclass 1)............................................... 76

IDP 100 Modem Series - Developer Guide

T203, Version 04 viii © SkyWave Proprietary Table 31 GPS Status Trace Record (Class 4, Subclass 2) ......................................................... 76 Table 32 Receive Message Trace Record (Class 5, Subclass 1) ................................................ 77 Table 33 Transmit Message Trace Record (Class 5, Subclass 2) .............................................. 77 Table 34 Transmit Message Trace Record (Class 5, Subclass 3) .............................................. 77

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary ix T203, Version 04 Preface Note: Refer to the SkyWave Customer Support website for any updates or a possible Errata Sheet available after the release of this document. Always check the site for the most current documentation releases. What's New? Changes since the last release of this document are listed below. The updates below include new functionality for the low power firmware release 1.1.0.  Updated S50 Power Mode and S51 Wake-up Interval information to show that they are non-volatile (Sections 5.4.3, 5.4.7 and 5.4.8) Updated for Low Power Release 1.1.0  Added new S registers for low power: S50 Power Mode and S51 Wake-up Interval (Sections 5.4.3, 5.4.7 and 5.4.8)  Added new to-mobile setSleepSchedule message (Table 5 and Appendix B.2)  Added new from-mobile sleepSchedule message (Table 6 and Appendix C.3)  Added low power to Trace Class and Subclass (Table 17)  Added a new Low Power Trace Record table (Class 2, Subclass 2) (Table 20)  Added low power to the modemRegistration message (Appendix C.1) Additional Updates  New %UTC command to display UTC date and time (Section 5.6.13)  New Response Result Code added (Table 15)  Added DSP RomDB Version to Class 2, Subclass 1 (Table 19)  Minor updates throughout Purpose This document describes the behavior and interfaces of the IDP 100 series of modems. The primary modem serial interface is the AT command interface implemented in the modem. Audience This document is for technical readers. Familiarity with the Hayes command set is advantageous. Notation This document is associated with modem firmware version 3.3 or higher.

IDP 100 Modem Series - Developer Guide

T203, Version 04 x © SkyWave Proprietary An OEM Integrator is a SkyWave customer who purchases an IDP 100 series modem for integration into their own enclosure. In order to become an OEM Integrator certain commercial criteria must be met. Contact your Account Executive for further details. A forward message is a message sent to the mobile device from the gateway, while a return message is one sent from the mobile device. Reference The content of the following documents may be useful in conjunction with this guide. These SkyWave documents are available from the IDP Developer Toolkit or support.skywave.com. [N200] IsatData Pro Network Services [T201] IDP 100 Modem Series Hardware Guide Other Third Party Reference Documents: ITU1-T Recommendations V.250 – Serial asynchronous automatic dialing and control (07/2003) Limited Liability SkyWave’s liability is limited to the cost of repair or replacement of any of SkyWave’s products during the warranty period. To the maximum extent permitted by applicable law, SkyWave's total liability for damages of any kind, whether based on breach of contract, tort (including negligence), product liability, incidental, special, consequential, indirect or similar damages with product application and usages will be limited to an amount equal to the product's original price paid by the Purchaser to SkyWave and this limitation of liability is reasonable given the price of SkyWave's products. In no event will SkyWave be liable to the Purchaser, any resellers of the Purchaser or any end user for any lost profits or savings, lost business, loss of data, any telecommunications breakdown, unavailability, downtime, interruption or delay, any suspension of service by any third party service provider including Inmarsat or any incidental, special, indirect, or consequential damages, whether based on breach of contract, tort (including negligence), product liability, incidental, special, consequential, indirect or similar damages and whether or not SkyWave has been advised of the possibility of such occurrence or damage. The parties agree that the foregoing represents a fair allocation of risk hereunder. 1 http://www.itu.int

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 1 T203, Version 04 1 Introduction The IDP 100 series are IsatData Pro satellite modems. Each provides satellite messaging for a host application. The modem's primary interface is the AT command. Using AT commands, a host can configure, control and exchange data with the IDP modems. The modems' AT commands are based on the ITU-T Recommendation V.250. In addition to an AT command interface, the modems provide a trace log interface for provisioning and diagnostics. This document describes the IDP modem's serial command interfaces that allow developers to build host applications to send and receive IsatData Pro messages. This document is also applicable to developers who are using the IDP 600 series terminals configured for pass-through mode. In pass-through mode, the modem's serial interface is available on the IDP 600 terminals' RS-232 interface.

IDP 100 Modem Series - Developer Guide

T203, Version 04 2 © SkyWave Proprietary THIS PAGE INTENTIONALLY LEFT BLANK

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 3 T203, Version 04 2 Modem Overview 2.1 Satellite Operation The IDP modem must be registered on the IsatData Pro network to send and receive messages. On a power-up, the modem transmits a modemRegistration message to the IsatData Pro gateway. The modemRegistration message notifies the Gateway that the modem is active and which beam to use to send to-mobile messages. When the Gateway receives the modem registration message it transmits a modemRegistrationConfirmed message back to the modem that authorizes the modem to receive messages. 2.1.1 Traffic Channel Acquisition On a wake up from sleep, the modem tunes directly to its previous traffic channel. It does not send a modemRegistration message. 2.1.2 Acquisition Times On startup or reset, the modem must determine its operating satellite beam. The modem determines its beam by first getting a GPS fix to determine its current location. After determining its location, the modem calculates its beam by checking its current location against all beam definitions. All beam definitions are part of the broadcasted IsatData Pro network information which is stored in the terminal. If the modem was previously operating in the current region, it also has the traffic channel information. In this case, the modem tunes directly to the traffic channel. If the modem had not been previously powered in the current region, it may first need to get information from the bulletin board channel. More information on the bulletin board and how it is used is found in [N200]. 2.1.3 Modem Registration Message On a power-up or reset, the modem transmits a modemRegistration message once it is on the traffic channel. A modem registration message is not sent when the modem wakes up from a sleep mode. This is one of the advantages of using the modem's sleep mode instead of turning the modem's power off. 2.1.4 Beam Switch An operating modem can roam between different satellite beams. When a modem roams it switches beams, transmits a ReportBeamChange message and operation continues transparent to the customer. The ReportBeamChange message lets the Gateway know the modem's new satellite beam. A beam switch is transparent to the customer. Typically, the beam switch occurs within 10 seconds. The 10-second window provides time for the modem to transmit a ReportBeamChange and for the modem to receive a ReportBeamChangeConfirmed message. The modem suspends all from-mobile messages if a beam switch is pending. If either a from-mobile or a to-mobile message is in transmission prior to a beam switch, all subsequent retries are transmitted on the new beam.

IDP 100 Modem Series - Developer Guide

T203, Version 04 4 © SkyWave Proprietary The modem determines if it is roaming by monitoring the GPS and the signal strength of all adjacent traffic channels. As per Figure 1, if the modem is located in an overlapping region of three beams, it monitors the SNR of all the beams. If it is located in two regions, it monitors the SNR in two regions. The GPS location is monitored every 12 hours. SNR of adjacent traffic channels is measured every 20 minutes. Adjacent traffic channels are not always monitored; they are only monitored if the GPS fix indicates that the adjacent beam is overlapping the current operating beam. Figure 1 Beam Switch Adjacent channel SNR monitoring does not affect how the modem is sending or receiving. The modem only samples the adjacent beams when it knows it is not receiving a message and when it has no messages to transmit. 2.1.5 Blockage When a modem can no longer acquire the traffic channel, it does not know if the traffic channel has changed or if the satellite signal is blocked. Note: The modem attempts to acquire the most recent beam. Failing that, it periodically scans all possible beams until it is able to connect. 2.1.6 Muting When a modem is deactivated it is muted so that it no longer can transmit messages. The modem supports a modem command that causes the modem to stop transmitting all user services messages. When muted, the modem may still transmit modem registration and beam notification messages. 2.2 Message States Figure 2 illustrates the message states for both from-mobile and to-mobile messages. Beam 1 Beam 3 Beam 2 Check SNR for Beam 1, 2 and 3 Check SNR for Beam 1 and 2 No SNR checks

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 5 T203, Version 04 Figure 2 Message States 2.2.1 To-Mobile States When a to-mobile message is received, it is automatically stored and marked as Rx Completed. The state changes to Rx Retrieved once the to-mobile message has been retrieved. The to-mobile message remains in the partition (Figure 6) until the IDP modem requires the memory space for additional messages. At this point the message is deleted to make space for a new message. A to-mobile message can be repeatedly retrieved until it is overwritten. 2.2.1.1 Rx Completed The host only knows about messages that have completed and gone to the Completed state. The host is not notified when a to-mobile message fails. Rx Completed Rx Retrieved Message Unavailable AT Command Read Message To-Mobile Message Arrives (Over-the-Air) Modem Requires More Memory Tx Ready Tx Completed From-Mobile Message (AT command) Tx Sending Tx Failed AT Command Delete Message AT Command Return Message State Message Unavailable

IDP 100 Modem Series - Developer Guide

T203, Version 04 6 © SkyWave Proprietary The Gateway breaks to-mobile messages into fragments for transmission. The modem acknowledges each fragment in a pre-assigned timeslot. If the Gateway does not receive an acknowledgement, it immediately submits the fragment for retransmission. 2.2.1.2 Rx Retrieved Messages It is the host's responsibility to manage the from-mobile message buffer to ensure that messages are deleted so new messages can be added – the host cannot delete to-mobile messages. The IDP modem maintains the message for as long as it can so the message can be read again by the host. When the modem needs additional storage for either another incoming message or a newly submitted outgoing message, messages are deleted. The file system that manages the message buffer selects the message to delete. The algorithm is not based on message age; instead it selects the message buffer that has been used the least in order to maximize the flash lifetime. Refer to Section 2.4.1 for more details. 2.2.2 From-Mobile States The from-mobile message is added to non-volatile storage when received from the host or, by the modem. Initially, the from-mobile message's state is Tx Ready. The modem may not be ready to send the message either because it is not yet registered on the network, there are a number of messages already in progress (sending state) or the modem is not receiving a valid satellite signal. Once the modem starts the transmission, the modem automatically changes the message's state to Tx Sending when it starts transmitting the message. When a message is in the Tx Sending state, it cannot be deleted. Once the message transmission is complete, the state changes to Tx Completed or Tx Failed. The from-mobile message is automatically deleted from the message partition when an AT command reads either the Tx Completed or Tx Failed state. 2.2.2.1.1 Transmit Failure Before transmitting the message, the modem breaks the message into message fragments. Each message fragment must be acknowledged by the Gateway or else the fragment is retransmitted. If the modem does not receive an acknowledgement it immediately resubmits the message fragment for transmission. When a message or the first fragment transmission starts, the modem starts a message completion timer. The timer is reset every time a message fragment is acknowledged. If the modem does not receive any message fragment acknowledgements in a 3 hour window, the modem declares the message failed. 2.2.2.2 Submit Before Registration If a from-mobile message is received before the message registers on the network, the message is added to the transmit queue. The message stays in the queue indefinitely. Once the modem receives a valid signal and registers, if required, it starts to transmit the message.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 7 T203, Version 04 2.3 AT Message Commands The AT commands are used to send from-mobile messages and receive to-mobile messages. Message records can be extracted from the message buffer using AT commands. Separate AT commands are provided for to-mobile and from-mobile messages. 2.3.1 From-Mobile Messages The from-mobile message is submitted via an AT command that contains a number of parameters. These parameters are shown in Figure 3. As per Figure 3, the host must assign an outgoing message name to all from-mobile messages that are submitted for transmission. The outgoing message name is an eight character ASCII string. It is the host's responsibility to ensure that the outgoing message name is unique. If a new message is submitted with the same name as a stored message, the modem rejects the new message. The host can use the outgoing message name to reference the message and either check the message status or delete the message before it starts transmission. The outgoing message name is not transmitted to the Gateway. As per Figure 3, once the modem starts to send a message, the IsatData Pro network assigns a network reference number. The network reference number is in the form aa.ss, where aa is a message number and ss is a sequence number. For diagnostic purposes, the network reference number is also available on the Gateway so that numbers can be compared. Figure 3 From-Mobile AT Command Parameters Host Modem Query Message State (outgoing message name) Start Transmission (data) Network Reference Number Assigned Message Status (state, network reference number) From-Mobile Message Submit (data, priority, outgoing message name)

IDP 100 Modem Series - Developer Guide

T203, Version 04 8 © SkyWave Proprietary 2.3.1.1 Priority The host can specify up to four priorities when submitting a from-mobile message (Figure 3). The priority field is not transmitted to the Gateway. The modem selects the message with the highest priority from the message queue to transmit. The modem can deliver up to eight messages (Figure 4), or two for each priority in the Tx Sending state. Once a message is in the Tx Sending state, it cannot be deleted, although a higher priority message can be submitted. Figure 4 Priority Messages The modem always gives priority to the high priority message when selecting the next message fragment to transmit. However, if there are network slots available for a lower priority message, the modem interleaves this message to maximize the network resources. The number of network slots available for low priority messages depends on message size, coding rate and the number of outstanding acknowledgements at any one time. A high priority does not guarantee that the message is delivered before a lower priority message. As the modem can process up to eight messages at once time, a low priority message may arrive before a high priority message depending on its length and number of message retries. If the host wants to ensure a priority message transmission, it is recommended to use priority levels appropriately. 2.3.2 To-Mobile Messages Figure 5 describes the message flow for a to-mobile message. Like the from-mobile messages, to-mobile messages are sent as a sequence of message fragments. The IDP modem creates an incoming message name based on the network reference number. The modem receives the network reference number and the message length in the first packet. As the incoming message name is based on the network reference number, it is in the form FMaa.ssn where aa.ss is the network reference number and n is a number assigned by the modem. In most cases n is absent. However, if the message partition contains an older message with a matching network reference number, n is incremented. The host does not send an unsolicited message when a to-mobile message is received. If the host does not use the hardware notification (Section 2.6), the host can poll the to- mobile message state (Figure 5) to determine if there are new un-retrieved messages. AT commands can be used to obtain a list of un-retrieved messages, or all messages stored in the message buffer. The number of messages in the list could be as large as the maximum number of messages stored in the message buffer. Msg 1 Msg 2 Priority 1 Msg 3 Msg 4 Priority 2 Msg 5 Msg 6 Priority 3 Msg 7 Msg 8 Priority 4

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 9 T203, Version 04 Figure 5 To-Mobile Message AT Command Parameters 2.4 On-board Memory The modem has internal volatile and non-volatile flash memory (4 MB) to store the following:  Satellite Messages  Network Configuration  S Registers Internally, the modem uses a file system that partitions the available storage into pre- allocated files of different sizes. All files are stored with a CRC to ensure that the integrity of all data stored in the flash. By pre-allocating files, the effect of a single corrupted file is isolated to that file only and does not propagate throughout the file system. The file system also ensures that single flash memory locations are not continually overwritten. The allocation of files from flash memory storage and the individual flash memory pages are written using a wear-leveling technique to maximize the 100,000 write cycle life of each flash memory page. From the user perspective the file system is transparent – the modem does not provide file access commands. Instead, the modem provides specific AT commands to access customer data stored in flash. Query To-Mobile Message State Host Modem First Fragment Arrives (network reference number assigned Message State for all messages (incoming message name, SIN) Message Received To-Mobile Message Get (incoming message name) Message Get Response (incoming message name, SIN, data)

IDP 100 Modem Series - Developer Guide

T203, Version 04 10 © SkyWave Proprietary 2.4.1 Satellite Messages The modem stores all non-modem messages in non-volatile storage. All non-modem messages survive power-up and reset. From-mobile messages are stored non-volatile memory; to-mobile messages are stored in non-volatile memory once they are full received. In order to maximize the number of stored messages, satellite messages are stored in four separate partitions based on the message's size. There is a partition for small, medium, large and extra-large messages. Both to-mobile and from-mobile messages are stored in the same partition (Figure 6) based on their size. Figure 6 Message Partitions The message partitioning (Figure 6) ensures a conservative flash lifetime of 5 years (Table 1) when the modem sends or receives up to 1 MB of data a month. The number of writes is calculated from the maximum manufacturer’s flash writes per sector (i.e., 100,000) times the number of message partitions. Table 1 Maximum Flash Size Extra Large Message (5250 bytes) Large Message (1250 bytes) Medium Message (250 Bytes) Number Writes 500,000 800,000 1,600,000 Writes per month (assume 5 year life) 8000 13,000 44,000 Data per month 4 MB > 1.6 MB > 1.1 MB If the intended partition is full, the modem attempts to store the new message in a larger partition. The modem solely manages how it allocates messages to individual message partitions. As such, the modem does not report the partition where messages are stored, and it does not report the amount of available memory in any given partition. Maximum 16 Maximum 16 Maximum 8 Maximum 4 Small Messages (1-235 Bytes) Medium Messages (236-1235 bytes) Large Messages (1236-5235 bytes) Extra-Large Messages (5236-10000 bytes)

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 11 T203, Version 04 If the larger partitions are not available for immediate reuse, the new message is discarded. The modem transmits a protocolError message that notifies the Gateway that the message was received but discarded. As the message is discarded, it is critical that the host application read to-mobile messages and not fill the partitions full of from-mobile messages in order to ensure that any incoming to-mobile message is not discarded. On power-up, all stored from-mobile messages, regardless of age, are transmitted by the modem. This includes messages that may have been partially transmitted before a reset or power down occurred. 2.4.2 Network Configuration The modem automatically updates its network configuration file when it receives new information on the IsatData Pro bulletin board. The contents of this file are for internal modem use. 2.4.3 S Registers Some S registers are configuration settings that are persistent during power down and stored in non-volatile memory. These S registers are stored files in the serial flash memory. On power-up and reset, the non-volatile S registers from the serial flash are automatically loaded into the modem. AT commands can be used to temporary modify the current active S registers. An AT command is provided that can copy the current active S registers into flash storage. If an S register file is corrupted, or non-existent, the factory S register defaults are loaded into the current active S registers instead. 2.5 Trace Table The modem stores a trace table in non-volatile memory. The trace table is a fixed length table that contains a row entry for each key event. When a key event occurs, the trace record is updated. The trace records are intended for advanced modem users to help them diagnose problems with the assistance of SkyWave Customer Support. The trace records can be extracted from the trace table using either AT commands or by going into trace log mode. Trace logs are described in more detail in Section 6. 2.6 Modem Outputs As per Figure 7, the modem has two general purpose outputs that are under modem firmware control. The hardware characteristics of these two outputs are defined in [T201].

IDP 100 Modem Series - Developer Guide

T203, Version 04 12 © SkyWave Proprietary Figure 7 Modem General Purpose Outputs 2.6.1 Reset Out Reset out can be asserted by sending an over-the-air modem message. Reset out is a pulsed signal with a fixed 1millisecond duration. 2.6.2 Event Notification Event Notification is asserted by the modem depending on the status of a number of configurable conditions. These conditions are defined by an S register and stored in non- volatile memory. Table 2 defines the configurable condition and its trigger condition. The data fields for the reset conditions are defined in the S register definition. All trigger conditions are automatically released when the event notification indicator [T201] status register is read. Once the event notification condition is read, a new trigger condition automatically asserts the event notification output. Once the condition is set, it is necessary to confirm that the trigger condition was not set directly prior. For example, if the event notification condition is set to trigger the output, the modem should first check if there is a new incoming message. Table 2 Configurable Conditions Condition Trigger Condition Event Notification New incoming satellite messages, modem reset, new GPS position or transmit compete GPS Position A new GPS fix obtained Modem Reset Mobile has reset. A reset includes the power up Modem Registered Modem registered Message Transmit Complete A new message is complete. Complete includes both success and failure 2.7 GPS The satellite modem and GPS share a common receiver. The GPS may operate in different modes. Some applications may only request intermittent GPS fixes in order to operate with minimum power. Other applications may need continuous GPS fixes and not be concerned with minimizing power consumption. 2.7.1 GPS Request Sources The modem, the host and a modem message can independently turn on the GPS and initiate a single GPS fix. Modem Reset Out Event Notification

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 13 T203, Version 04 2.7.1.1 Satellite Modem The IDP modem initiates a GPS fix in following cases  On startup or reset to determine its operating beam  At least every 12 hours to confirm any IsatData Pro transmit timing offsets due to the position of the satellite If a GPS fix is obtained due to an AT command or other trigger, the satellite modem may delay its request for a GPS fix. 2.7.1.2 AT Command An AT command for a GPS fix does not necessarily turn on the GPS. If the modem previously obtained a GPS fix within the specified stale time that GPS fix is used. If there is no previous fix with the stale time, the modem turns on the GPS and starts to get a GPS fix. The stale time is the maximum acceptable age for a GPS position. For example, if the stale time is 5 minutes, the modem uses a previous GPS fix if it was obtained within the last 5 minutes. The AT command's wait time parameter specifies the time for the AT command to wait for a GPS fix - it does not specify the time the GPS stays on waiting for a fix. Once an AT command initiates a GPS fix, the AT command cannot turn off the GPS. The GPS remains on until one of the following occurs:  The modem gets a GPS fix  A 3-minute timeout (if the wait time is shorter than 3 minutes)  The modem reaches the wait time as specified (if the wait time is longer than 3 minutes) 2.7.1.3 Over-the-Air Request A GPS fix can be initiated by a modem message that requests a position report. When this modem message is received, the modem acknowledges the message. The modem turns on the GPS; attempts to get a GPS fix and transmit a modem message containing a GPS report. If a GPS fix is not obtained, the returned modem message contains an invalid GPS position. 2.7.2 GPS Fix Type If the modem requests a GPS fix to get a position for system purposes, the GPS fix must be a 3D fix. If a user requests a GPS fix using an AT command, the GPS normally waits for the first 3D fix. However, if the modem only has a partial view of the sky, only a 2D fix may be possible. In this case, a 2D fix report is used if a 3D fix is not available after the wait time expires. The wait time is the time specified by the AT command to wait for a GPS fix. 2.7.3 GPS Fix Times The GPS can perform both warm and cold start GPS. A warm fix is always attempted.

IDP 100 Modem Series - Developer Guide

T203, Version 04 14 © SkyWave Proprietary 2.7.4 Satellite Transmit Effects The GPS shares the antenna with the satellite modem. When the modem transmits long bursts as when it sends from-mobile message, a GPS fix cannot be obtained. However, it can obtain a GPS fix when it is transmitting acknowledgements for to-mobile messages. Note: The modem allows simultaneous GPS and message transmission providing the GPS is able to update its ephemeris data at least every four hours. 2.8 Broadcast Messages A broadcast message is a message that is sent to a broadcast ID that is programmed into multiple modems. Each modem can have up to 16 different broadcast IDs. The OEM Integrator is responsible to configure the set of beams where the broadcast message is transmitted. Note: The OEM Integrator cannot configure the broadcast IDs on the modem. The broadcast IDs must be configured by SkyWave at either the factory or over-the- air.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 15 T203, Version 04 3 Over-the-Air Interface The Gateway can either send messages to individual modems or can broadcast to multiple modems. 3.1 Message Lengths All messages, both to-mobile and from-mobile, consist of a data block and a length. Maximum message sizes are given in Table 3. The lengths shown include the Service Identification Number (SIN) and the Message Identification Number (MIN), if a MIN was specified. Table 3 Message Lengths Description Length (bytes) From-Mobile 1- 6400 To-Mobile 1-10,000 3.2 Message Types The first byte of both to-mobile and from-mobile messages defines the message type. The first byte is the SIN. The SIN identifies the message type. There are three message types as defined in Table 4. Table 4 Message Types Description SIN (Hex) SIN (Decimal) Modem 0x00 – 0x0F 0 – 15 Terminal Core Services 0x10 – 0x7F 16 – 127 User Services 0x80 – 0xFF 128 – 255 The second byte of a message is the MIN. The MIN is defined based on the SIN. Only MIN for the modem message is relevant as the modem passes through the terminal core services and user services messages. 3.2.1 Modem Messages The modem directly initiates and responds to all incoming modem messages. Modem messages do not require any interaction from an external host application. Consequently, all to-mobile modem messages are not delivered to the host. Some modem messages are available to the customer at the Gateway others are reserved for system use. The reserved messages are used to update IsatData Pro parameters such as bulletin board frequencies and beam regions definitions. A list of the user visible modem messages are listed in Table 5 and Table 6. Refer to APPENDIX B and APPENDIX C for further details. Incoming modem messages allow the IsatData Pro network to update the modem and retrieve diagnostic information.

IDP 100 Modem Series - Developer Guide

T203, Version 04 16 © SkyWave Proprietary Table 5 To-Mobile Modem Messages Modem Message SIN MIN Description reset 0 68 Message data in message indicates type of reset. Modem can reset the host using a dedicated output setSleepSchedule 0 70 Sets a low power modem's wake up interval setTxMute 0 71 Disables modem transmissions but modem still sends registration messages getPosition 0 72 Polls for a position report getConfiguration 0 97 Same data as the modem registration message pingRequest 0 112 Echo of the message pingResponse 0 113 Echo of the message getBroadcastIDs 0 115 Request for a list of broadcast IDs Table 6 From-Mobile Modem Messages Modem Message SIN MIN Description modemRegistration 0 0 Response include the modem's configuration and reset cause protocolError 0 2 Modem error cause sleepSchedule 0 70 Sent in response to change in sleep schedule position 0 72 Sent in response to a position request configuration 0 97 Same data as the modem registration message pingResponse 0 112 Echo of the response pingRequest 0 113 Echo of the response testMessage 0 114 The network requires a quality test, no payload delivery broadcastIDs 0 115 Sent in response to a request for broadcast IDs 3.2.2 Terminal Core Services Terminal core service messages are passed through the modem to the host application. These messages are reserved for SkyWave IDP terminals. 3.2.3 User Services User service messages are passed through the modem to the host application. These are message types host applications can use to send and receive data over the IsatData Pro network.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 17 T203, Version 04 4 Serial Modes On startup the modem can optionally enter a boot loader mode. The boot loader mode supports modem firmware updates. After startup, the modem supports the following operational modes  AT Command Mode  Trace Log Mode 4.1 Mode Switches The boot loader mode is a special startup mode. It can only be entered after reset if a special command sequence (BB) is received. After reset, the modem enters one of the configured operating modes. By default the modem enters AT command mode. However, the user can configure the startup mode to use any startup mode. Trace mode exits to AT command mode when is pressed. 4.1.1 Baud Rate On reset, the modem defaults to following serial port settings Rate: 9600 bits/s Data bits: 8 Stop bits: 1 Parity: none Flow control: none In AT command mode the baud rate can be configured and saved. On exit from AT command mode to another mode, the modem does not change baud rates. It continues to use the baud rate as defined by the AT command.

IDP 100 Modem Series - Developer Guide

T203, Version 04 18 © SkyWave Proprietary THIS PAGE INTENTIONALLY LEFT BLANK

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 19 T203, Version 04 5 AT Command Mode In AT command mode, data is interpreted as commands to the modem. While in AT command mode, the modem receives, processes, and responds to AT commands. This section describes the AT command syntax and the AT commands and responses. For convenience the AT commands are split into the following groups  Basic command set (non-S register commands)  S register command set  Extended command set  SkyWave-proprietary command set A complete list of all AT commands is found in APPENDIX A. 5.1 Syntax Definition 5.1.1 Conventions The following definitions apply: Command line termination character. Its value is specified in register S3. Response formatting character. Its value is specified in register S4. <…> Items enclosed in angle brackets indicate a syntactical element. The actual element appears on the command line rather than the angle brackets. [...] Indicates optional items. Brackets themselves do not appear in the command line. | Indicates or. E.g., | indicates that one of data or length must be specified. The examples in this document intentionally omit and . 5.1.2 Command Rules The IDP 100 series modems follow the basic AT command rules below:  At commands must begin with either AT or at, although the rest of the command can be a mix of upper and lowercase.  Several commands can be combined in a single command line using ";" to delimit extended commands and SkyWave-proprietary extended commands. It is not mandatory to delimit basic commands.  If a numerical parameter in a basic command is not entered, it is assumed to be zero.  Whitespace in commands is ignored. 5.1.3 AT Command General Format A command line is a string of characters sent from a host to the IDP modem while the mode is in a command state. A command line has three elements: the prefix, the body, and the termination character.

IDP 100 Modem Series - Developer Guide

T203, Version 04 20 © SkyWave Proprietary Commands to the modem are prefixed with AT or at. The body is made up of individual commands and their optional parameters, specified later in this document, and terminated by the command line termination character (defined in register S3, default = 13 (ASCII carriage return)). Multiple commands can be included in one command line, extended commands and SkyWave-proprietary extended commands must be delimited by ";". It is not mandatory to delimit basic commands. Examples:  Disable Echo: ATE0 or atE0 or ate or ATE000 or AT E 0 or at e  Request identification information, model information, and revision information: ATI+GMM;+GMR or ati0;+GMM;+gmr; or at I +gmm; +gmr 5.1.3.1 Command Line Editing A command line can be edited with the command line editing character (defined in register S5, default = 8 (ASCII backspace)). The IDP modem first checks characters from the host to see if they match the termination character (register S3) and then the editing character (register S5) before checking for other characters. This ensures that these characters are properly recognized even if they are set to values that the IDP modem uses for other purposes. If registers S3 and S5 are set to the same value, a matching character is treated as matching register S3. 5.1.3.2 Command Line Echo The IDP modem may echo characters received from the host during command state back to the host depending on the setting of the E command. 5.1.3.3 Repeating a Command Line The IDP modem immediately executes the command when it receives the prefix A/ or a/. 5.1.3.4 AT Response Format The format of the response is dependent upon the current quiet setting (Q command) and the verbose setting (V command).

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 21 T203, Version 04 The syntax of information responses and result codes for the different verbose settings is as follows (where and represent the ASCII characters configured in registers S3 and S4 respectively): Table 7 Effect of V Parameter on Response Formats V0 V1 Information Responses Result Codes When the quiet setting is enabled (via Q1), the result code is suppressed. No portion of any result code (header, result text, line terminator, or trailer) is transmitted. When using the quiet and verbose setting defaults (Q0 & V1), and register S3 and S4 defaults, the response to an AT command line comprised of multiple commands is: … Example: Command AT i +GMM Response SkyWave Mobile Communications+GMM:IsatData Pro - Modem OK On a serial interface, the dialogue would appear as follows: AT i +GMM SkyWave Mobile Communications +GMM: IsatData Pro - Modem OK 5.1.3.5 Error Detection The integrity of AT command lines and responses can be ensured via Cyclic Redundancy Checks (CRC). When error detection is enabled, the IDP modem requires a CRC sequence at the end of each AT command line to allow verification of the command line data before the command line is executed. When error detection is enabled, a CRC sequence follows AT responses to allow verification of the response data by the host. The AT command line CRC sequence is comprised of the CRC prefix character (stored in register S64), default character is "*", followed by four ASCII-Hex digits. The value of the command line CRC includes all command line characters starting with A or a (of the leading AT or at) up to the character that precedes the CRC prefix character, including any spaces or delimiters (;). E.g. for ATS5?*2FBD, 2FBD is the CRC of ATS5?. The AT response CRC sequence is comprised of the CRC prefix character (stored in register S64), followed by four ASCII-Hex digits, and and (where is

IDP 100 Modem Series - Developer Guide

T203, Version 04 22 © SkyWave Proprietary the register S3 value, and is the register S4 value). The value of the response CRC, includes the characters of all information responses, and result code, including their formatting ( and ) characters. E.g., in verbose (V1), the response with CRC sequence to ATS5?*2FBD is: 008 OK*DC04 The CRC used is the CRC-16-CCITT with initial value 0xFFFF. Error detection is enabled or disabled via the %CRC command. The following exemplifies CRC sequences associated with AT command lines (denoted by bold) and corresponding responses (using the default value * as the CRC prefix character): ATI*FD97 SkyWave Mobile Communications OK *A293 ATS5?*2FBD 008 OK *DC04 ATIS5?*1A3D SkyWave Mobile Communications 008 OK *8E41

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 23 T203, Version 04 5.2 Transfer Mode While in transfer mode, the IDP modem transfers data via the XMODEM–CRC protocol using block sizes of 128 bytes. Entry into transfer mode may occur via the %MGFG and %MGRT commands. Exit from transfer mode occurs once the XMODEM transfer is complete or times out. The information exchange of an AT command that supports transfer mode is structured as in Table 8. Table 8 AT Command Information Exchange Order Host Sends IDP Modem Sends 1 AT Command - 2 - Information response 3 XMODEM blocks XMODEM ACKs/NAKs 4 - Result code 5.3 Basic Command Set The format of the basic command set is either a single character or the & character followed by an optional single character. The basic AT commands supported are described in Table 9. Table 9 Basic Commands Supported Command Description Parameter E Echo [] I Request Identification Information [] Q Quiet [] S S Registers - V Verbose [] Z Load Current Configuration with NVM Stored Values [] &F Load Current Configuration with Factory Default Values [] &V Display Current and Stored Configuration [] &W Store Current Configuration to NVM [] Null Null Command - A/ Repeat Last Command (no leading AT or trailing ) - 5.3.1 E – Echo Description Echo The echo command defines if the IDP modems echo characters received from the host in command state. As the parameter is stored in an S register, this setting can be made non-volatile if the S registers are saved. Parameters None|0 – Disabled 1 – Enabled Information Response -

IDP 100 Modem Series - Developer Guide

T203, Version 04 24 © SkyWave Proprietary 5.3.2 I – Request ID Description Request identification information Parameters None(0)|0 – Manufacturer name 3 – Modem firmware revision 4 – Product description 5 – AT protocol version 6 – Modem hardware revision 8 – Modem firmware build timestamp Information Response None(0)|0 – SkyWave Mobile Communications 3 – E.g., 3.2 4 – E.g., IDP-180 5 – E.g., 1 6 – E.g., 2.0 8 – E.g., Mar 4 2011 10:21:45 5.3.3 Q – Quiet Description Quiet 2 mode (suppress Result Codes) Parameters None|0 – Disabled 1 – Enabled Information Response - 5.3.4 V – Verbose Description Verbose2 setting (ResultCode:numeric|textual) Parameters None|0 – Disabled 1 – Enabled Information Response - 5.3.5 Z – Load Saved Values Description Load current configuration with stored values Parameters None(0)|0 5.3.6 &F – Load with Factory Default Values Description Load current configuration with factory default values Parameters None(0)|0 (factory defaults) Information Response - 2 Setting is stored in an S register so any change becomes non-volatile (persist reset or power cycle) when S registers are stored via the &W command.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 25 T203, Version 04 5.3.7 &V – Display Configurations Description Display current and stored configurations Parameters None(0)|0 Information Response Current and stored S register values 5.3.8 &W – Save Configuration Description Store the current configuration. Configuration includes all the modem's S registers Parameters None(0)|0 Information Response - 5.3.9 Null Command Description Null command Parameters None Information Response - 5.3.10 A/ – Repeat Last Command Description Repeat last command The modem immediately executes the body of the preceding command line when it receives the prefix A/ or a/.This command is issued without the leading AT or trailing , no CRC required when error detection is enabled. Parameters None Information Response -

IDP 100 Modem Series - Developer Guide

T203, Version 04 26 © SkyWave Proprietary 5.4 S Register Commands 5.4.1 Command Format S register commands are described in Table 10. Table 10 S Register Command Format Command3 Description Parameter ATSn Direct S register reference (e.g., ATS4). Sets the current register for subsequent operations until another S register is referenced, read, or written. Sn ATSn? Direct S register read. Reads the value of the register (e.g., ATS4?) Sn? ATSn= Direct S register write. Sets the value of the register where the new value is a decimal value in the range of the minimum value and maximum value (Table 11) (e.g., ATS4=8). Sn= AT? Referenced S register read. A question mark (?) is used to read the value of the current S register. The current register is the one that was most recently acted upon by a direct reference, write or read command (e.g., AT?). ? AT= Referenced S register write. An equal sign (=) is used to write a value to the current S register. The current register is the one that was most recently acted upon by a direct reference, write or read command (e.g., AT=8). = S registers are used to configure various AT command related values, and other (non AT command related) values. 5.4.2 S Register Types Different sizes of S registers exist. S registers can be 1, 8, 16, or 32 bits in size and can contain unsigned or signed values. S registers can be read/write or read-only. There are two types of S registers. They are used to  Store configuration parameters  Provide modem status and configuration parameters All S registers that map to configuration parameters have factory default values. The modem allows users to change and save the factory defaults. Once configuration data is changed, the settings are only temporary (i.e., do not survive power down) until all new settings are explicitly saved to nonvolatile memory. The saved S registers from non- volatile memory are loaded on every reset. The factory default values of S registers can be loaded by the user to restore the modem to its factory configuration. The factory default values are also used by the modem if the stored configuration parameters cannot be read from non-volatile memory (e.g., are corrupted). 5.4.3 S Register Definitions Table 11 lists the S register definitions. 3 n represents the number of the S register.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 27 T203, Version 04 Table 11 S Registers S Register Description Size (bits) Read Only Non- Volatile Min. Value Max. Value Default Value S04 Auto answer (on number of rings) 0 –Disabled 8 N Y 0 255 0 S3 Command line termination character 8 N Y 1 127 13 () S4 Response formatting character 8 N Y 0 127 10 () S5 Command line editing character 8 N Y 0 127 8 () S64 Pause before blind dialing 8 N Y 0 255 0 S74 Connection completion timeout 8 N Y 0 255 0 S84 Comma dial modifier time 8 N Y 0 255 0 S104 Automatic disconnect delay 8 N Y 0 255 0 S50 Power Mode 8 N Y 0 9 0 S51 Wake-up Interval 8 N Y 0 6 0 S60 Echo 1 Y Y 0 1 1 S61 Quiet 1 Y Y 0 1 0 S62 Verbose 1 Y Y 0 1 1 S63 CRC 1 Y Y 0 1 0 S64 Prefix character of CRC sequence 8 N Y - 255 42 ("*") S80 Last error code 8 Y N - - 0 S81 Most recent result code 8 Y N - - 0 S85 Temperature (signed) 16 Y N - - - S88 Event Notification Control 8 N Y 0 255 0 S89 Event Notification Status 8 N N - - - S90 Capture Trace Define - Class 8 N Y 0 7 0 S91 Capture Trace Define - Subclass 8 N Y 0 31 0 S92 Capture Trace Define - Initiate 1 N N - - - S93 Captured Trace Property - Data Size 32 Y N - - - S94 Captured Trace Property - Signed Indicator 32 Y N - - - S95 Captured Trace Property - Mobile ID 32 Y N - - - S96 Captured Trace Property - Timestamp 32 Y N - - - S97 Captured Trace Property - Class 32 Y N - - - S98 Captured Trace Property - Subclass 32 Y N - - - S99 Captured Trace Property - Severity 32 Y N - - - S100 Captured Trace Data 0 32 Y N - - - S101 Captured Trace Data 1 32 Y N - - - … … … … … … … … S123 Captured Trace Data 23 32 Y N - - - 4 S registers S0, S6, S7, S8 and S10 are supported for V.250 compatibility only. Their values can be read and written, but no actions are taken.

IDP 100 Modem Series - Developer Guide

T203, Version 04 28 © SkyWave Proprietary 5.4.4 S3 – Command Line Terminator Description Configure the command line termination character. Syntax ATS3= See Table 10 for other command formats Parameters A decimal number ranging from 1 to 127 Information Response Syntax None Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 29 T203, Version 04 5.4.5 S4 – Response Formatting Character Description Configure the response formatting character. Syntax ATS4= See Table 10 for other command formats Parameters A decimal number ranging from 0 to 127 Note: When set to 0, no response formatting characters are generated Information Response Syntax None Result Codes OK Success ERROR 5.4.6 S5 – Command Line Editing Character Description Configure the command line editing character. Syntax ATS5= See Table 10 for other command formats Parameters A decimal number ranging from 0 to 127 Information Response Syntax None Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

T203, Version 04 30 © SkyWave Proprietary 5.4.7 S50 – Power Mode Description Configure the power mode setting. Syntax ATS50= See Table 10 for other command formats Parameters 0 Mobile powered terminal 1 Fixed position powered terminal 2 Mobile battery operated terminal 3 Fixed position battery operated terminal 4-9 Reserved Information Response Syntax None Result Codes OK Success ERROR 5.4.8 S51 – Wake-up Interval Description Set the wake-up interval for a terminal. Syntax ATS51= See Table 10 for other command formats Parameters 0 5 second receives 1-2 Reserved 3 3 minute receives 4 10 minute receives 5 30 minute receives 6 60 minute receives Information Response Syntax None Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 31 T203, Version 04 5.4.9 S60 – Echo Setting (S60) Description Echo setting as configured by the ATE command. Syntax ATS60? Information Response Syntax 0 Disabled 1 Enabled Result Codes OK Success 5.4.10 S61 – Quiet Setting Description Quiet setting as configured by the ATQ command. Syntax ATS61? Information Response Syntax 0 Disabled 1 Enabled Result Codes OK Success

IDP 100 Modem Series - Developer Guide

T203, Version 04 32 © SkyWave Proprietary 5.4.11 S62 – Verbose Setting Description Verbose setting as configured by the ATV command. Syntax ATS62? Information Response Syntax 0 Disabled 1 Enabled Result Codes OK Success 5.4.12 S63 – CRC Setting Description Cyclic Redundancy Check setting as configured by the %CRC command. Syntax ATS63? Information Response Syntax 0 Disabled 1 Enabled Result Codes OK Success

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 33 T203, Version 04 5.4.13 S64 – Prefix Character of CRC Sequence Description Prefix character of CRC sequence, used when error detection is enabled via the %CRC command. Syntax ATS64= See Table 10 for other command formats Parameters A decimal number ranging from 0 to 255 Information Response Syntax None Result Codes OK Success ERROR 5.4.14 S80 – Last Error Code Description Returns the last error code. Syntax ATS80? Information Response Syntax Returns the last error code (refer to Table 15) that was generated by an AT command Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

T203, Version 04 34 © SkyWave Proprietary 5.4.15 S81 – Most Recent Result Code Description Configure the recent result code. Syntax ATS81? Information Response Syntax Returns the code for the last AT command (refer to Table 15). The code is either OK or an error reason. Result Codes OK Success ERROR 5.4.16 S85 – Internal Temperature Description This command reports the modem's internal temperature. Syntax ATS85? Information Response Syntax Parameters A signed decimal number in tenths of degrees Celsius Result Codes OK Success ERROR Example Value returned corresponding to a temperature of 20.5 degrees C ATS85? 205

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 35 T203, Version 04 5.4.17 S88 – Event Notification Control Description This command sets and returns the conditions that cause the assertion of the Event Notification hardware signal [T201]. Syntax ATS88? See Table 10 for other command formats Information Response Syntax Parameters An unsigned number of Boolean flags (0=false, 1= true) if condition Bit 00 – New GPS fix Bit 01 – New message received Bit 02 – Transmit completed (either success or failure) Bit 03 – Modem registered on network Bit 04 – Modem reset Bits [05…07] – Reserved Result Codes OK Success ERROR Example Enable assertion of Event Notification on a new GPS fix, new incoming message and modem reset. ATS88=19 OK

IDP 100 Modem Series - Developer Guide

T203, Version 04 36 © SkyWave Proprietary 5.4.18 S89 – Event Notification Assert Status Description This command returns a bit map of status conditions that result in the assertion of Event Notification hardware signal [T201]. A status condition must be both enabled and active to report as true. When the register is read or written, all status conditions are automatically cleared. Syntax ATS89? See Table 10 for other command formats Parameters None Information Response Syntax Parameters Bit 00 – New GPS fix Bit 01 – New Message Received Bit 02 – Transmit completed (either success or failure) Bit 03 – Modem registered on network Bit 04 – Modem reset Bits [05…07] – Reserved Result Codes OK Success ERROR Example Modem status indicates that a new to-mobile message has been received and that this event is asserting the hardware Event Notification signal. ATS89? 2 OK

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 37 T203, Version 04 5.4.19 S90, S91, S92 – Capture Trace Define Description This command set configures a trace class and subclass. Once class and subclass are configured, the trace tables are searched for the most recent match trace record. If a match is found, the trace record is copied to the captured report. The captured report can then be obtained by reading S93…S123 (when the Result Code is OK). Syntax ATS90=n S91=m S92=p See Table 10 for other command formats Parameters n – Trace record class (Table 17) m – Trace record subclass (Table 17) p – 1 to trigger a trace record capture Information Response Syntax None Result Codes OK Success ERROR Example The trace tables are searched for a satellite status general event (Class 3, Subclass 1). The OK response indicates that a trace record was found and moved to the capture record. ATS90=3 S91=1 S92=1 OK The following command attempts to capture a trace record for a satellite event. The ERROR response indicates that there is no matching trace record in the logs. ATS90=3 S91=1 S92=1 ERROR Trace log information can also be obtained via %EVNT. When the value 1 is written to S92, the most recent trace log information corresponding to the class specified in S90 and subclass specified in S91, is captured in S93...S123. The AT command result code is OK if the trace log information was successfully captured (i.e., trace log information corresponding to the specified class and subclass existed), or ERROR otherwise.

IDP 100 Modem Series - Developer Guide

T203, Version 04 38 © SkyWave Proprietary 5.4.20 S93 – Captured Record Properties - Length Description This command returns the number of valid data fields in the capture trace record. The size identifies the number of valid S registers used to hold the capture record data. Syntax ATS93? Information Response Syntax Parameters A decimal number of size 0 to 24 Result Codes OK Success ERROR 5.4.21 S94 – Captured Record Properties - Data Sign Description This command returns a 32 bit value that contains a bitmap to identify if each data record in the capture record is signed or unsigned. S93 reports the data size and the number of valid bits reported by S94. The first bit (bit 00) corresponds to the first capture record data longword located in S100. Syntax ATS94? Information Response Syntax Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 39 T203, Version 04 5.4.22 S95 – Captured Record Properties - Network ID Description This command returns the modem's network ID. Syntax ATS95? Information Response Syntax Parameters 24 bit decimal value Result Codes OK Success ERROR 5.4.23 S96 – Captured Record Properties - Timestamp Description This command returns the timestamp for the event. The timestamp does not include the day, month, or year. Syntax ATS96? Information Response Syntax Parameters A decimal number containing UTC hour, minute and second Bits [00…07] – Seconds (0…59) Bits [08…15] – Minute (0…59) Bits [16…22] – Hour (0…23) Bits [23…31] – Reserved Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

T203, Version 04 40 © SkyWave Proprietary 5.4.24 S97, S98 – Captured Trace Properties - Class/Subclass Description This command set returns the class and subclass for the trace record captured in the capture trace. Syntax ATS97? ATS98? Information Response Syntax A decimal number identifying the class of the trace record captured. It is same as value defined by S90. A decimal number identifying the subclass trace record captured. It is same value as defined by S91. Result Codes OK Success ERROR 5.4.25 S99 – Captured Trace Properties - Severity Level Description This command returns the severity level assigned to the captured trace record. Syntax ATS99? Response Syntax 1 Critical 2 Major 3 Minor 4 Information Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 41 T203, Version 04 5.4.26 S100, S101, …S123 – Captured Trace Data - Index Description This command set returns the data for the captured trace record. A trace record contains a maximum of 24 data values. S register 93 defines how many data values in the command set are valid. The first data value is in S register 100. Some of the data register can be signed values. The bitmap in S register 94 must be queried to determine the sign of a particular data index. Syntax ATS100? S101? S102?…S123? Response Syntax A decimal number. It can be signed or unsigned A decimal number. It can be signed or unsigned …… A decimal number. It can be signed or unsigned Result Codes OK Success ERROR

IDP 100 Modem Series - Developer Guide

T203, Version 04 42 © SkyWave Proprietary 5.4.26.1 Trace Log Information Retrieval via S Registers Example The number of messages currently being transmitted and the total number of transmit messages (active + waiting) can be obtained by Writing class = 3 to S90 Writing subclass = 1 to S91 Triggering the event capture by writing 1 to S92 Reading S109 to obtain the number of messages currently being transmitted, and Reading S110 to obtain the total number of transmit messages as follows: at s90=3 s91=1 s92=1 s109? s110? 0000000002 0000000002 OK To repeat this command, the class and subclass S registers are already configured and can be omitted from the AT command: at s92=1 s109? s110? 0000000001 0000000001 OK Repeat the previous command: a/ 0000000000 0000000000 OK 5.5 Extended Commands Extended commands are prefixed by a plus sign (+). The supported formats of extended AT commands are shown in Table 12. Table 12 Extended Command Formats Extended Command Format Syntax Description Execution + or +=[] Execute command that has no parameters or optional parameters. Execute command that has parameters. Read +? Determine current value(s) of parameter(s) Test +=? Determine command support and parameter range(s).

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 43 T203, Version 04 Table 13 Extended AT Commands Command Description Parameters Information Response +GCAP Request complete capabilities list None +GCAP: +GMI Request manufacturer identification (e.g., SkyWave Mobile Communications) None +GMI: SkyWave Mobile Communications +GMM Request model identification (e.g., IsatData Pro - Modem) None +GMI: IsatData Pro – Modem +GMR Request revision identification (e.g., 1.000) None +GMR: , , +GSN Request product serial number identification (also referred to as Mobile ID) (e.g., 00000032SKY6EDD) None +GSN: +IPR Baud Rate 1200|2400|4800| 9600|19200 +IPR: 5.6 SkyWave-Proprietary Extended Commands SkyWave-proprietary extended commands are prefixed with %. The various formats of SkyWave-proprietary extended commands are similar to the extended command formats listed in Table 12. Note that in addition to the command syntax shown below, the Test syntax of %=? can be used to query the support of the command and its parameter ranges. Table 14 SkyWave-Proprietary Extended Commands Command Description Parameters %CRC Error Detection = %EVNT Event Log Get =, %EXIT Exit Command = %GPS Get GPS Information =,[,"GGA"][,"RMC"] %MGFG To-Mobile Message Get ="", %MGFM To-Mobile Message Rx Retrieved ="" %MGFN To-Mobile Message New [=""] %MGFS To-Mobile Message State [=""] %MGRC From-Mobile Message Cancel ="" %MGRS From-Mobile Message State [=""] %MGRT From-Mobile Message Send ="",,[.],,| %SREG View all S Registers - %UTC Display UTC Date and Time -

IDP 100 Modem Series - Developer Guide

T203, Version 04 44 © SkyWave Proprietary 5.6.1 %CRC – Error Detection Description This command sets or queries the error detection setting. The error detection setting is stored in an S register so any change becomes non- volatile (persists reset or power-cycle) when S registers are stored via the &W command. Syntax %CRC= Parameters 0 Disable error detection 1 Enable error detection Example AT%CRC=1 AT%CRC=0*BBEB at%crc=0*1749 Information Response Syntax None Result Codes OK Success ERROR Invalid parameter Syntax %CRC? Information Response Syntax %CRC:0 Error detection disabled %CRC:1 Error detection enabled Result Codes OK Success

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 45 T203, Version 04 5.6.2 %EVNT – Event Log Get Description Get the most recent Event Log information for the specified class and subclass. Trace log information can also be obtained via S registers. Syntax %EVNT=, Parameters Event log class (Table 17) Event log subclass (Table 17) Information Response Syntax %EVNT: ,,, ,,,,, ,…, Parameters Number of event data values (corresponding to specified event class/subclasses) 0 Unsigned 1 Signed Bit 0 corresponds to , bit N corresponds to First eight characters of the modem's Mobile ID Bits [00…07] – Seconds (0…59) Bits [08…15] – Minute (0…59) Bits [16…22] – Hour (0…23) Bits [23…31] – Reserved Refer to Table 17 Refer to Table 17 1 Critical 2 Major 3 Minor 4 Information

IDP 100 Modem Series - Developer Guide

T203, Version 04 46 © SkyWave Proprietary ,,…, Class/subclass specific event data. Refer to Table 16, and Table 19 to Table 30. indicates how many data values are present for the corresponding class/subclass. indicates whether the data longword should be interpreted as an unsigned or signed value. Result Codes OK Event log information successfully obtained (event log corresponding to the specified class and subclass exists) ERROR Invalid class and/or subclass specified, or event log corresponding to the specified class and subclass does not yet exist

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 47 T203, Version 04 5.6.3 %EXIT – Exit Command Description This command exits the AT command processor and starts a different proprietary serial protocol. Syntax %EXIT= Parameters Number indicates what protocol to invoke upon exit of AT command mode. 1 AT command mode 2 - 4 Reserved 5 Streaming trace log interface Information Response Syntax None Result Codes OK Success ERROR Invalid parameter

IDP 100 Modem Series - Developer Guide

T203, Version 04 48 © SkyWave Proprietary 5.6.4 %GPS – Get GPS Information Description This command requests NMEA sentence(s). If GPS information no older than is available, the response is immediate. Otherwise, the response can take up to . Syntax %GPS=,[,”GGA”][,”RMC”] Parameters Age threshold of GPS fix (range 1…600) Duration to wait for new GPS fix (when a GPS fix no older than staleSecs is unavailable) (range 1…600) "GGA" Request GGA NMEA sentence "RMC" Request RMC NMEA sentence Note: "GGA" and/or "RMC" must be specified. Information Response Syntax %GPS: Example %GPS: $GPGGA,182008.00,4520.2015,N,07554.2787,W,1,,,80.8,M,,,*10 $GPRMC,182008.00,A,4520.2015,N,07554.2787,W,000.019,357.43,041110,*39 Result Codes OK GPS information was obtained ERROR GPS information within age limit of is unavailable and fresh GPS information not obtained within , parameter out of range, or syntax error No information response exists when result code is ERROR.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 49 T203, Version 04 5.6.5 %MGFG – To-Mobile Message Get Description This command obtains the data of a specific to-mobile message. The parameter specifies whether the data is presented in text format bounded by double-quote (") characters, ASCII-Hex format, Base64 (MIME) format, or via transfer mode. When text format is specified, ASCII data is bounded by double-quote (") characters, although the following special characters are represented by a backslash (\) character followed by two hexadecimal digits representing the special character’s ASCII value: 00..1F,22("),5C(\),7F..FF (all values are in hexadecimal). When transfer mode is specified, transfer mode is entered after the information response to exchange the data (and AT command mode automatically resumes once the data exchange is complete). The maximum length of a to-mobile message is 10,000 bytes, including the SIN byte and the MIN byte. Syntax %MGFG="", Parameters The to-mobile message name reported by %MGFS or %MGFN 0 Transfer mode to be entered after information response to transfer message data (and AT command mode automatically resumes once the data transfer is complete) 1 Text format message data (bounded by double-quote (") characters) included in information response 2 ASCII-Hex format message data included in information response 3 Base64 (MIME) encoded message data included in information response Information Response Syntax %MGFG:"",,,, ,,[,] Parameters See above for details Message number in the form aa.ss where aa is the system assigned 2- digit message number and ss is the system assigned 2-digit message sequence number

IDP 100 Modem Series - Developer Guide

T203, Version 04 50 © SkyWave Proprietary Always 0 for to-mobile messages Service identification number 2 Rx Completed (Entire message received and available, but not yet read) 3 Rx Retrieved (Message has been retrieved/read (via %MGFG) and message data is still available) Total message length in bytes (including SIN byte and MIN byte) 0 Transfer mode to be entered after information response to transfer message data (and AT command mode automatically resumes once the data transfer is complete) 1 Text format message data (bounded by double-quote (") characters) included in information response 2 ASCII-Hex format message data included in information response 3 Base64 (MIME) encoded message data included in information response Message data, formatted as specified by See above for details Example The examples below all represent identical message (with message data ¡Olé!) Text Example: %MGFG="FM31.63",1 %MGFG: "FM31.63",31.63,0,17,2,6,1,"\ADOl\82!" ASCII-HEX Example: %MGFG="FM31.63",2 %MGFG: "FM31.63",31.63,0,17,2,6,2,AD4F6C8221 Base64 Example: %MGFG="FM31.63",3 %MGFG: "FM31.63",31.63,0,17,2,6,3,rU9sgiE= Block mode Example: %MGFG="FM31.63",0 %MGFG: "FM31.63",31.63,0,17,2,6,0 (then obtain AD4F6C8221 via transfer)

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 51 T203, Version 04 Result Codes OK To-mobile message corresponding to exists ERROR Otherwise

IDP 100 Modem Series - Developer Guide

T203, Version 04 52 © SkyWave Proprietary 5.6.6 %MGFM – To-Mobile Message Rx Retrieved Description This command changes the state of a to-mobile message from Rx Completed to Rx Retrieved. This allows the message space to be reused for future messages without retrieving the message via the %MGFG command. Syntax %MGFM="" Parameters The to-mobile name as reported by %MGFS or %MGFN Information Response Syntax None Result Codes OK To-mobile message corresponding to exists ERROR Otherwise

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 53 T203, Version 04 5.6.7 %MGFN – To-Mobile Message New Description This command is similar to the %MGFS command, but only lists messages that have not been retrieved (via %MGFG) nor marked as Rx Retrieved (via %MGFM). It may be used to query the state of all Completed to-mobile messages (when ="" is omitted, or ="" is specified), or a specific to-mobile message (when ="" is specified). When ="" is omitted, the response includes all to-mobile messages with the state Completed. Syntax %MGFN[=""] Parameters The to-mobile message name in the form FMaa.ss where aa is the active message number and ss is the system assigned 2-digit message sequence number. An empty string ("") denotes all to-mobile messages. If a to-mobile message is received with the same active message number and message sequence number as an existing message, the existing message is deleted if its state is Rx Retrieved, and the new message is saved with the name of the deleted message. If the existing message has not been read (state is Completed), the new message is saved with a name using the format FMaa.ssx where x is a character (a to z) that supports a message with a unique fwdMsgName. Information Response Syntax %MGFN: “”,,,,, , or %MGFN: ““,,,,, , ““,,,,, , … ““,,,,, , Parameters The to-mobile name in the form FMaa.ss where aa is the 2-digit active message number and the ss is the 2-digit message sequence number

IDP 100 Modem Series - Developer Guide

T203, Version 04 54 © SkyWave Proprietary Message number in the form active message number followed by '.' And message sequence number Always 0 for to-mobile messages Service identification number 2 Rx Completed (Entire message received and available, but not yet read) Total message length in bytes (including SIN byte and MIN byte) Number of bytes received (including SIN byte and MIN byte) Note: are used to delimit multiple messages. Result Codes OK If all to-mobile messages were specified (via %MGFN or %MGFN="") even if no Completed to-mobile messages exists, or a match was found when a specific msgName was specified (via %MGFN=""). ERROR Match not found when a specific msgName was specified (via %MGFN=""), or a syntax error

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 55 T203, Version 04 5.6.8 %MGFS – To-Mobile Message State Description This command queries the state of a specific to-mobile message (when ="" is specified), or all current to-mobile messages (when ="" is omitted or ="" is specified). Current messages include to-mobile messages with state Completed or with state Rx Retrieved that have not yet been automatically deleted (to make room for new messages). Syntax %MGFS[=""] Parameters The to-mobile message name in the form FMaa.ss where aa is the system assigned 2-digit message number and ss is the system assigned 2-digit message sequence number. An empty string ("") denotes all to-mobile messages. If a to-mobile message is received with the same active message number and message sequence number as an existing message, the existing message is deleted if its state is Rx Retrieved, and the new message is saved with the name of the deleted message. If the existing message has not been read (state is Completed), the new message is saved with a name using the format FMaa.ssx where x is a character (a to z) that supports a message with a unique fwdMsgName. Information Response Syntax %MGFS: “”,,,,, , or %MGFS: ““,,,,, , ““,,,,, , … “”,,,,, , Parameters The to-mobile message name in the form FMaa.ss where aa is the system assigned 2-digit message number and ss is the system assigned 2-digit message sequence number

IDP 100 Modem Series - Developer Guide

T203, Version 04 56 © SkyWave Proprietary Message number in the form aa.ss where aa is the system assigned 2- digit message number and ss is the system assigned 2-digit message sequence number Always 0 for to-mobile messages Service identification number 2 Rx Completed (Entire message received and available, but not yet read) 3 Rx Retrieved (Message has been retrieved/read (via %MGFG) and message data is still available) Total message length in bytes (including SIN byte and MIN byte) The number of bytes received (including SIN byte and MIN byte) Note: are used to delimit multiple messages. Result Codes OK If all to-mobile messages were specified (via %MGFS or %MGFS="") even if no to-mobile messages exist, or a match was found when a specific msgName was specified (via %MGFS="") ERROR Match not found when a specific msgName was specified (via %MGFS=""), or syntax error

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 57 T203, Version 04 5.6.9 %MGRC – From-Mobile Message Cancel Description This command cancels a specific from-mobile message with a state of Tx Ready. Syntax %MGRC="" Parameters Message name specified in the corresponding %MGRT command Information Response Syntax None Result Codes OK Message successfully cancelled ERROR Otherwise

IDP 100 Modem Series - Developer Guide

T203, Version 04 58 © SkyWave Proprietary 5.6.10 %MGRS – From-Mobile Message State Description This command queries the state of a specific from-mobile message (when is specified), or all from-mobile messages (when = is omitted or ="" is specified). When is omitted, the response includes all current from-mobile messages. Current from-mobile messages include messages with state Tx Ready, Tx Sending, Tx Completed, or Tx Failed. Messages with status Tx Completed or Tx Failed are deleted when they are reported by the %MGRS command. This command reports current messages created via the %MGRT command. Syntax %MGRS[=""] Parameters From-mobile message name specified in the corresponding %MGRT command. If empty string ("") or omitted all current from-mobile messages are requested. Information Response Syntax %MGRS:"",,,, ,, or %MGRS: "",,,,, , "",,,,, , … "",,,,, Parameters From-mobile message name specified in the corresponding %MGRT command From-mobile message number in the form aa.ss where aa is the system assigned 2-digit message number and ss is the system assigned 2-digit message sequence number. Note that the from-mobile message number is reported as 0.0 until a valid number is assigned.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 59 T203, Version 04 A range from 1 to 4, where 1 High 2 - 3 - 4 Low Service identification number (1…255) 4 Tx Ready (Ready to transmit) 5 Tx Sending (Transmission in progress) 6 Tx Completed (Transmission complete and successful) 7 Tx Failed (Transmission failed) Total message length in bytes (including SIN byte and MIN byte) The number of message bytes acknowledged by the gateway (including SIN byte and MIN byte) Result Codes OK If all from-mobile messages were specified (via %MGRS or %MGRS="") even if no from-mobile messages exist, or a match was found when a specific msgName was specified (via %MGRS="") ERROR Match not found when a specific msgName was specified (via %MGRS=""), or syntax error

IDP 100 Modem Series - Developer Guide

T203, Version 04 60 © SkyWave Proprietary 5.6.11 %MGRT – From-Mobile Message Send Description This command sends a from-mobile message from the IDP modem to the gateway. The parameter specifies whether the data is processed as text format bounded by double-quote (") characters, ASCII-Hex format, Base64 (MIME) format, or via transfer mode. For text format, any character value may be included in the string bounded by double-quote (") characters by representing it as a backslash (\) character followed by two hexadecimal digits. For example, "\0D" is a string consisting of a single ASCII carriage return character, and "\ADOl\82!" is the string ¡Olé!. If the backslash (\) character itself is to be represented in a string, it shall be encoded as "\5C". The double-quote character, used as the beginning and ending string delimiter, shall be represented within a string constant as "\22". When transfer mode is specified, is specified (instead of ), and transfer mode is entered after the information response to exchange the data (and AT command mode automatically resumes once the data exchange is complete). When an (optional) MIN is specified, it is prepended to the message data. The maximum number of from-mobile messages is 6,400 bytes; including the SIN byte and the MIN byte, if a MIN is specified. Syntax %MGRT="",,[.],, | Parameters User-specified from-mobile message name, maximum 8 characters, used by the IDP modem only and not sent to the gateway. The msgName must be unique and not match any previously submitted msgName. 1 High 2 - 3 - 4 Low [.] Service identification number (16…255), optionally followed by "." And message identification number (0…255)

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 61 T203, Version 04 0 Transfer mode to be entered after information response to transfer message data (and AT command mode automatically resumes once the transfer is complete) 1 Text format message data (bounded by double-quote (") characters) included in information response 2 ASCII-Hex format message data included in information response 3 Base64 (MIME) encoded message data included in information response See above. Text bounded by double-quote (") characters, ASCII-Hex, Base64 (MIME) encoded, omitted for transfer mode. The field can be a maximum of 6398 bytes if the (optional) MIN is specified, or 6399 bytes if the (optional) MIN is not specified. Number of valid data bytes to be exchanged via transfer mode (note that 128 byte blocks are used, and that data beyond bytes in the last block are discarded) Information Response Syntax None Result Codes OK Message successfully added ERROR Otherwise Example All of these commands represent identical messages. Text Example: %MGRT="TestMsg",2,128.0,1,"Hello!" Text Example: %MGRT="TestMsg",2, 128.0,1,"Hello\21" Text Example: %MGRT="TestMsg",2, 128,1,”\00Hello\21” ASCII-HEX Example: %MGRT="TestMsg",2, 128.0,2,48656C6C6F21 ASCII-HEX Example: %MGRT="TestMsg",2, 128.0,2,48656c6c6f21 ASCII-HEX Example: %MGRT="TestMsg",2, 128,2,0048656c6c6f21

IDP 100 Modem Series - Developer Guide

T203, Version 04 62 © SkyWave Proprietary Base64 Example: %MGRT="TestMsg",2, 128.0,3,SGVsbG8h Block mode Example: %MGRT="TestMsg",2, 128.0,0,6 (then send Hello! Via block mode)

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 63 T203, Version 04 5.6.12 %SREG – View all S Registers Description This command displays the current and NVM values and attributes of all S registers in table format. Syntax %SREG Parameters - Information Response Syntax Multi-line table of all S registers Result Codes OK Success 5.6.13 %UTC – Display UTC Date and Time Description This command is used to obtain the current UTC date and time. Syntax %UTC Parameters - Information Response Syntax %UTC:--
:: Result Codes OK Success ERROR UTC unavailable Example AT%UTC %UTC: 2011-10-27 18:20:25

IDP 100 Modem Series - Developer Guide

T203, Version 04 64 © SkyWave Proprietary 5.7 Error Result Codes The error result codes that follow information responses are listed in Table 15. Error codes greater than 100 apply to SkyWave proprietary AT commands. Table 15 Response Result Codes Verbose Result Code (ATV1) Numeric Result Code (ATV0) Description OK 0 Acknowledges execution of a command ERROR 4 Command not recognized, command line maximum length exceeded, parameter value invalid, or other problem with processing the command line 1005 Invalid command line CRC sequence 1015 Unknown command encountered in command line 1025 Invalid command parameter encountered 1035 Message length exceeds permitted size for specified data Format 1045 Transfer mode error occurred 1055 System error 1065 Insufficient resources 1075 Message name already in use 1085 Timeout occurred 1095 Unavailable 5 ERROR (or numeric code 4) is returned for this code. Register S80 and S81 are populated with a SkyWave-proprietary numeric result code to help identify the reason for the ERROR result code.

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 65 T203, Version 04 6 Trace Log Mode Traces are sent to a trace table in volatile memory. A new trace record overwrites an old trace record of the same type. In trace log mode, the traces are also sent to the host. Each trace record field is displayed as lines of comma delimited fields. All fields are show in decimal format. 6.1 Trace Log Mode Commands exits trace log mode. 6.2 Trace Types The modem stores trace records of key events in a trace table. The key events can be grouped in the following classes.  Hardware Faults  System Events  Satellite Events  GPS Events  Message Events 6.3 AT Command Access The AT commands have access to the trace log file. Using S registers the AT command can select a specific trace log class that it wants to read. Once the record type is selected, the modem copies the newest matching record into a trace capture record. S registers, that map into each field of the trace capture record can then be used to read the requested record. Figure 8 Trace Log Record 1 Record 2 Record n ….. Trace Class Trace Log S Registers Writes Trace Subclass Trace Capture Initiate Match? Trace Capture Record S Register Read

IDP 100 Modem Series - Developer Guide

T203, Version 04 66 © SkyWave Proprietary 6.4 Trace Record Format Trace records consist of a common header followed by class specific data. Figure 9 Trace Record Format 6.4.1 Trace Record Header The common header format for all trace records is shown in Table 16. Table 16 Common Trace Log Information Name Description Size (bytes) Captured trace data count Number of populated captured trace data S registers (corresponding to captured trace class/subclass) 4 Captured trace signed bitmask 0 – Unsigned 1 – Signed Bit 00 corresponds to S100, bit 23 corresponds to S123 4 Captured Network ID The first characters of the modem's Mobile ID 4 Captured Trace timestamp Bits [00…07] – Second (0...59) Bits [08…15] – Minute (0...59) Bits [16…22] – Hour (0...23) Bits [23…31] – Reserved 4 Captured Trace class See Table 17 1 Captured Trace subclass See Table 17 1 Captured Trace Severity 1 – Critical 2 – Major 3 – Minor 4 – Information 1 The header contains the class and subclass numbers. The definition for trace class and subclasses are defined in Table 17. Refer to Section 5.4.19 for an explanation of how S registers map to trace classes. Header Class Data

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 67 T203, Version 04 Table 17 Trace Class and Subclasses Class Subclass No. Name No. Name 1 Hardware Fault Event - - 2 System Event 1 Reset 2 Low power 3 Satellite Event 1 Status (for every successful receive) 2 Transmit status (for every transmit) 3 Beam acquire 4 Beam (beam search result) 5 Geo adjust 6 Beam sample 16 Receive metrics – Subframe block 17 Receive metrics – Minute 18 Receive metrics – Hour 19 Receive metrics – Day 20 Transmit metrics – Subframe block 21 Transmit metrics – Minute 22 Transmit metrics – Hour 23 Transmit metrics – Day 4 GPS Event 1 Fix statistics (when a fix is received by the GPS server) 2 Status (when GPS server changes its state) 5 Message Event 1 Receive message statistics 2 Transmit message statistics 3 Transmit message utilization 6.4.2 Class Data A trace record consists of a block of 24, 32-bit data entries. Not all the data indices in the class specific block contain data. The number of data indices containing valid data is defined by the first data entry in the trace header. Table 18 Trace Data Name Description Size (bytes) Trace Data 0 Data specific to trace record 4 Trace Data 1 Data specific to trace record 4 … … … Trace Data 23 Data specific to trace records 4

IDP 100 Modem Series - Developer Guide

T203, Version 04 68 © SkyWave Proprietary 6.5 Trace Class Definitions 6.5.1 System Reset Event Traces (Class 2) Table 19 Reset Trace Record (Class 2, Subclass 1) Data Index Name Description 0 ResetReason Micro-controller reset reason 0 – Unknown 1 – Power on 2 – External 3 – Brownout 4 – Watchdog 5 – Debug 6 – Software 7 – Spike 1 HwVer Hardware version Bits [00-07] – Minor Bits [08-15] – Major Bits [16-31] – Reserved 2 RelVer Release version Bits [00-07] – Minor Bits [08-15] – Major Bits [16-31] – Reserved 3 BootVer Micro-controller boot version Bits [00-07] – Minor Bits [08-15] – Major Bits [16-31] – Reserved 4 ApplVer Micro-controller application version Bits [00-07] – Minor Bits [08-15] – Major Bits [16-31] – Reserved 5 DspBootVer DSP boot version Bits [00-07] – Minor Bits [08-15] – Major Bits [16-31] – Reserved 6 DspApplVer DSP application version Bits [00-07] – Minor Bits [08-15] – Major Bits [16-31] – Reserved 7 DspDbVer DSP ROM database version Bits [00-07] – Minor Bits [08-15] – Major Bits [16-31] – Reserved

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 69 T203, Version 04 Table 20 Low Power Trace Record (Class 2, Subclass 2) Data Index Name Description 0 Low Power Event Type (see table below for additional details) 1 – Sleep request 2 – Wake up for scheduled receive 3 – Wake up for timeout 4 – Other Wake up 1 Current System Time Current operating system clock time 2 Current Wake-up Period Configured wake-up period: 0 – Off 1 – Reserved 2 – Reserved 3 – 3 min 4 – 10 min 5 – 30 min 6 – 60 min 3 Current Power Profile Configured power profile: 0 – Mobile powered 1 – Fixed powered 2 – Mobile battery 3 – Fixed battery 4 Rx Wake-up Time Operating system clock time for scheduled receive wake up (0 if none) 5 Beam Search Wake-up Time Operating system clock time for scheduled beam search 6 GPS Wake-up Time Operating system clock time for scheduled GPS fix If Low Power Event Type = 1 7 Last receive time 8 Requested sleep time If Low Power Event Type = 2 7 Current subframe 8 Scheduled subframe 9 Wake-up margin If Low Power Event Type = 4 7 Sleep requested flag 8 Reacquire beam

IDP 100 Modem Series - Developer Guide

T203, Version 04 70 © SkyWave Proprietary 6.5.2 Satellite Event Traces (Class 3) Table 21 Satellite General Status Trace Record (Class 3, Subclass 1) Data Index Name Description 0 Subframe Number Received subframe number 1 VC ID Traffic channel ID 2 Configuration ID Received configuration ID 3 Beam Number Received beam number 4 Reserved Reserved 5 System Information Packet Access Transmit access level from the System Information Packet 6 Network Access Level Transmit access level configured by the network operator 7 Customer Access Level TransmitMute configured by customer 8 Transmit Suspended True if transmit suspended (for beam change, etc.) 9 Number of Active Transmit Messages Number of active messages currently being transmitted 10 Number of Total Transmit Messages Total number of messages (active + waiting) 11 Number of Active Transmit Jobs Number of outstanding transmit packets 12 Transmit State Transmit State: 0 – Active 1 – Suspending 2 – Suspended (for GPS management or required GPS fix) 13 Number of Active Receive Messages Number of messages being received 14 Averaging Window Size of main adjacent beam samples window. Used for beam switching 15 Averaging Count Current number of main adjacent beam samples. Used for beam switching. 16 C/N x 100 Current average main beam C/N (C/N x 100) 17 Beam Sample Threshold Threshold for enabling background beam sample 18 Beam Sample Timer Current value of beam search enable timer 19 Flags General system activity flags: 0x001 – Registered 0x002 – Sending beam change notification 0x010 – Beam search enabled 0x020 – Need beam sample 0x040 – Beam switch pending 0x100 – GPS valid 0x200 – Need GPS fix 0x400 – GPS fix requested 20 GPS State timer Duration that modem network services has gone without a GPS fix 21 Reserved Reserved 22 Satellite Control State Satellite control state: 0 – Stopped 1 – Waiting for GPS 2 – Starting search 3 – Beam search 4 – Beam found 5 – Beam acquired 6 – Beam switch in progress

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 71 T203, Version 04 Data Index Name Description 7 – Registration in progress 8 – Receive only 9 – Receiving global bulletin board 10 – Active 23 Beam Search State Beam search state: 0 – Idle 1 – Search for any traffic channel 2 – Search for the last acquired traffic channel 3 – Reserved 4 – Search for another traffic channel ID 5 – Search for a global traffic channel 6 – Delay the traffic channel search 7 – Delay the last acquired traffic channel search 8 – Search for a traffic channel better than the current one

IDP 100 Modem Series - Developer Guide

T203, Version 04 72 © SkyWave Proprietary Table 22 Transmit Status Trace Record (Class 3, Subclass 2) Data Index Name Description 0 Status Transmit status: 0 – Accepted 1 – Acknowledgement received 2 – No acknowledgement received 3 – Fail 4 – Unable to send (lost signal) 5 – Unable to send (priority or Tx disabled/suspended) 6 – Missed Acknowledgement (acknowledged subframe not received) 7 – Modem error 1 Channel Type Channel type: 0 – Half second channel 1 – Once second even channel 2 – One second odd channel 3 – Small packet channel 4 – Acknowledgement channel 2 Subframe Time Transmit subframe 3, 4 Reserved Reserved 5 Message Type Modem message type 6 Reserved Reserved 7 Slot Slot (for quarter second packets or acknowledgments) 8 Modem Return Code Modem return code 9 Message Number Message number 10 Packet Type Packet type: 0 – Acknowledgement 1 – Transmit data half second coding rate (0P33) 2 – Transmit data half second coding rate (0P50) 3 – Transmit data half second coding rate (0P75) 4 – Transmit data half second coding rate (0P95) 5 – Transmit data one second coding rate (0P33) 6 – Transmit data one second coding rate (0P50) 7 – Transmit small packet 11 Packet Size Packet size 12 Packet Index Packet index 13 Sequence Number Packet sequence number 14 Priority Packet Priority packet 15 First Packet First packet (0/1) 16 Retry Send Retry flag (0/1) 17 Acknowledgement Subframe Expected acknowledgement subframe 18 Acknowledgement Bitmask Expected acknowledgement bitmask Table 23 Satellite Acquire Trace Record (Class 3, Subclass 3) Data Index Name Description 0 Subframe Number Received subframe number 1 to 15 Reserved Reserved

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 73 T203, Version 04 Table 24 Satellite Beam Status Trace Record (Class 3, Subclass 4) Data Index Name Description 0 Beam Success True if beam found 1 Return Code Modem return code 2 Subframe Subframe where beam found (0 if unsuccessful) 3 Reserved Reserved 4 Latitude Geographic position of the modem. Latitude degrees *100 5 Longitude Geographic position of the modem. Longitude degrees * 100 6 SF Number Sub-frame number from SIP 7 VC ID Traffic channel ID from SIP 8 Config ID Configuration ID from SIP 9 Beam No Beam number from SIP 10 BHP ID Beam hop pattern ID from SIP 11 SF Offset Subframe offset from SIP 12 Freq Offset Frequency offset *100 13 Time Offset Time offset in mS 14 UW Strength Signal strength of unique word 15 UW C/No C/No of unique word * 100 16 UW Berr Bit error in unique word 17 UW Bits Number of bits in unique word Table 25 Satellite Geographic Adjust (Class 3, Subclass 5) Data Index Name Description 0 VC ID Traffic channel ID from SIP 1 Config ID Configuration ID from SIP 2 Geo Beam ID - 3 Coverage Definition - 4 Latitude Geographic position of the modem. Latitude degrees *100 5 Longitude Geographic position of the modem. Longitude degrees * 100 6 Sat Longitude Geographic longitude of the satellite 7 Latency Latency in Ms 8 FL offset Forward link offset 9 Coding Rate Return link coding rate

IDP 100 Modem Series - Developer Guide

T203, Version 04 74 © SkyWave Proprietary Table 26 Satellite Event Log Data (Class 3, Subclass 6) Data Index Name Description 0 rc modem return code 1 switchbeams 1 if a beam switch will occur 0 if not 2 VC ID Traffic channel ID from SIP of background beam 3 Config ID Configuration ID from SIP of background beam 4 Beam No Beam number from SIP of background beam 5 BHP ID Beam hop pattern ID from SIP of background beam 6 Avg C/No Curr Average C/No of current beam * 100 7 Avg C/No Bgr Average C/No of background beam * 100 8 Beam switch delta Difference of current and background bean C/No 9 Count Number of samples in average 10 Access Level Current network access level 11 Latitude Geographic position of the modem. Latitude degrees *100 12 Longitude Geographic position of the modem. Longitude degrees *100 Table 27 Rx Metrics Trace Record (Class 3, Subclass 16) Data Index Name Description 0 Success Successful receive 1 Subframe Number Subframe number of this receive 2 Beam Number Beam number 3 to 8 Reserved Reserved 9 Number Packet Symbols Number of packet symbols in this receive 10 Number Packet Errors Number of packet errors 11 C/N C/N (x100) 12 Number Packets Detected Number of packets decoded The Rx metrics are defined below. Rx metrics are reported as accumulated totals over the last full minute, last full hour and last full day. The average values can be calculated by dividing the totals by the number of samples. The subclasses for the Rx metrics are:  Last Full Minute - Subclass 17  Last Full Hour - Subclass 18  Last Full Day - Subclass 19 Table 28 Rx Metrics Trace Record (Class 3, Subclass 17, 18 and 19) Data Index Name Description 0 Total C/N Accumulated C/N (x100) 1 Total Error Rate Accumulated error rate (x100) 2 Total UW Error Rate Accumulated unique word error rate (x100) 3 Total Receives Count of completed receive requests 4 Total Receive OK Count of receives with good CRC 5 Number Samples Number of samples (for accumulated stats) 6 Total Receive Fail Number of failed receive requests (no signal or modem error)

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 75 T203, Version 04 Example: The Full Hour Receive Metrics show the following values, each of which is the sum of the individual sample values times 100: totCNO = 3122952 totChErrRate = 23 totUWErrRate = 2 The number of receives (samples) is: totReceives = 688 totReceiveOK = 688 numSamples = 688 totReceiveFail = 0 The average values are calculated by dividing each total by the numSamples value times 100 (68800). avg C/N0 = 3122952/68800 or 45.4 dBHz. avg Channel Error Rate = 23/68800 or 3.3 x 10e-4 avg. UW Error Rate = 2/68800 or 2.9 x 10e-5 The Tx metrics counts are reported over the last full minute, last full hour and last full day. A subclass is provided to support each Tx metrics type.  Last Full Minute - Subclass 21  Last Full Hour - Subclass 22  Last Full Day - Subclass 23 Table 29 Tx Metrics Trace Record (Class 3, Subclass 20, 21 and 22) Data Index Name Description 0 Tx Packets Sent[Acknowledgements] Number of packets of each type 1 Tx Packets Sent[type 1] half second .33 2 Tx Packets Sent[type 2] half second .5 3 Tx Packets Sent[type 3] half second .75 4 Tx Packets Sent[type 4] half second .94 5 Tx Packets Sent[type 5] one second .33 6 Tx Packets Sent[type 6] one second .5 7 Tx Packets Sent[type 7] small packet 8 Tx Packets Success [Acknowledge] Number of successful packets of each type 9 Tx Packets Success [type 1] half second .33 10 Tx Packets Success [type 2] half second .5 11 Tx Packets Success [type 3] half second .75 12 Tx Packets Success [type 4] half second .94 13 Tx Packets Success [type 5] one second .33 14 Tx Packets Success [type 6] one second .5 15 Tx Packets Success [type 7] small packet 16 Tx Packets Lost [Acknowledge] Number of lost packets of each type 17 Tx Packets Lost [type 1] half second .33 18 Tx Packets Lost [type 2] half second .5 19 Tx Packets Lost [type 3] half second .75

IDP 100 Modem Series - Developer Guide

T203, Version 04 76 © SkyWave Proprietary Data Index Name Description 20 Tx Packets Lost [type 4] half second .94 21 Tx Packets Lost [type 5] one second .33 22 Tx Packets Lost [type 6] one second .5 23 Tx Packets Lost [type 7] small packet 6.5.3 GPS (Class 4) Table 30 GPS Fix Statistics Trace Record (Class 4, Subclass 1) Data Index Name Description 0 Current Fix Type Current fix type: 1 – 2D 2 – 3D 1 Latitude Latitude x 600,000 2 Longitude Longitude x 600,000 3 Date Encoded as a decimal number e.g. 20101225 for 2010/12/25 4 Time to First Fix Time to first fix (ms) 5 Current Fix Elapsed Time Elapsed time since start of session (seconds) 6 to 23 Reserved Reserved Table 31 GPS Status Trace Record (Class 4, Subclass 2) Data Index Name Description 0 to 5 Reserved Reserved 6 Current Fix Valid Valid fix: 0/1 7 Current Fix Age Current fix age (seconds) 8 Current Fix Type Current fix type: 1 – 2D 2 – 3D 9 Current Fix Elapsed Time Current fix elapsed time (Ms) 10 Current Latitude Current latitude x 600000 11 Current Longitude Current longitude x 600000 12 Reserved Reserved 13 Previous Latitude Previous latitude x 600000 14 Previous Longitude Previous longitude x 600000 15 Request Fix Type Request fix type: 0 – None 1 – 2D 2 – 3D 16 Request Stale Time Request stale time (seconds) 17 Request Wait Time Request wait time (seconds) 18 Reserved Reserved

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 77 T203, Version 04 6.5.4 Receive Message (Class 5) Table 32 Receive Message Trace Record (Class 5, Subclass 1) Data Index Name Description 0 to 5 Reserved Reserved 6 SIN Message control block message service identification number 7, 8 Reserved Reserved Table 33 Transmit Message Trace Record (Class 5, Subclass 2) Data Index Name Description 0 Reserved Reserved 1 Error 0 – None 1 – Unknown type 2 – Too large 3 – No message number available 4 – Service not available 5 – No data 6 – Format not configured 7 – Priority disabled 8 – No system resources 2, 3 Reserved Reserved 4 Priority Message control block message priority 5 Reserved Reserved 6 SIN Message control block message service identification number 7 to 9 Reserved Reserved Table 34 Transmit Message Trace Record (Class 5, Subclass 3) Data Index Name Description 0 Packets Formatted rate 1 Number of unique packets submitted for rate 1 (.5 s/.33) 1 Packets Transmitted rate 1 Number of packets transmitted (including retries) 2 Flags, rate 1 Bit 00 – Rate permitted in current location Bit 01 – Rate disabled due to excessive errors 3 Packets Formatted rate 2 As above, for rate 2 (.5 s/.50) 4 Packets Transmitted rate 2 5 Flags, rate 2 6 Packets Formatted rate 3 As above, for rate 3 (.5 sec/.75) 7 Packets Transmitted rate 3 8 Flags, rate 3 9 Packets Formatted rate 4 As above, for rate 4 (.5 sec/.94) 10 Packets Transmitted rate 4 - 11 Flags, rate 4 As above, for rate 3 (.5 sec/.75) 12 Packets Formatted rate 5 As above, for rate 5 (1.0 sec/.33) 13 Packets Transmitted rate 5 As above, for rate 2 (.5 s/.50) 14 Flags, rate 5 Reserved 15 Packets Formatted rate 6 As above, for rate 6 (1.0 sec/.50) 16 Packets Transmitted rate 6 As above, for rate 3 (.5 sec/.75) 17 Flags, rate6 - 18 Packets Formatted rate 7 As above, for rate 7 (small pkt)

IDP 100 Modem Series - Developer Guide

T203, Version 04 78 © SkyWave Proprietary Data Index Name Description 19 Packets Transmitted rate 7 As above, for rate 2 (.5 s/.50) 20 Flags, rate 7 Reserved 21 Utilization Disable Threshold Error threshold for disabling a rate (number sent/ number formatted)*100 22 Utilization Age Time Duration (in minutes) after which the error counts are divided by 2

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 79 T203, Version 04 APPENDIX A Supported AT Commands The table below list the AT commands supported by the modem. Command Description Parameter E Echo [] I Request identification information [] Q Quiet [] V Verbose [] Z Load current configuration with NVM stored values [] &F Load current configuration with factory default values [] &V Display current and stored configuration [] &W Store current configuration to NVM [] Null Null command (AT) - A/ Repeat last command (no leading AT) - +GCAP Request complete capabilities list - +GMI Request manufacturer identification - +GMM Request model identification - +GMR Request revision identification - +GSN Request product serial number identification (Mobile ID) - +IPR Baud rate = %CRC Error detection = %EXIT Exit command = %GPS Get GPS information =,[,"GGA" ] [,"RMC"] %MGFS To-mobile message state [=""] %MGFG To-mobile message get ="", %MGFM To-mobile message retrieved ="" %MGFN To-mobile message new. If empty string ("") or omitted all current to- mobile messages are requested [=""] %MGRT From-mobile message send ="",,[ .],,| %MGRS From-mobile message state [=""] %MGRC From-mobile message cancel ="" %SREG View all S registers - %UTC Display UTC date and time -

IDP 100 Modem Series - Developer Guide

T203, Version 04 80 © SkyWave Proprietary APPENDIX B To-Mobile Messages All parameters include the SIN and the Message Type. Element Description Value SIN service identification number 0 messageType Indicates this message B.1 reset (MIN 68) Definition This message causes various types of mobile device resets. The Gateway may restrict some types of resets. Note: Reset types 2 and 3 cause a hardware reset of the terminal application processor using the designated digital output port on the mobile device which is connected to the reset pin on the terminal board. Application messages can be sent over-the-air to the terminal to cause other types of terminal resets. Syntax reset Fields ResetType 8 bits Details Field Description Value ResetType Indicates the type of reset and whether queued from-mobile message are kept or flushed. 0 – (modem preserve) Modem software reset with messages preserved (note this resets both the DSP and microcontroller processors). Messages are reattempted from packet 1 after the reset. 1 – (modem flush) Modem software reset with messages flagged as not delivered. Messages are not reattempted after the reset. 2 – (terminal) Terminal application processor hardware reset 3 – (terminal/modem flush) Modem software reset and terminal processor hardware reset (modem messages flagged as not delivered and are not reattempted) 4 to 255 – Reserved 0-255

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 81 T203, Version 04 B.2 setSleepSchedule (MIN 70) Definition This message sets the wake-up period for a low power mode modem. The response to the setSleepSchedule is a sleepSchedule confirmation from the modem. Syntax setSleepSchedule Fields WakeupPeriod 8 bits Details Field Description Value WakeupPeriod Length of time the modem sleeps between attempts to receive to-mobile messages. 0 – Off (terminal receives every 5 seconds) 1 – Reserved 2 – Reserved 3 – 3 minutes 4 – 10 minutes 5 – 30 minutes 6 – 60 minutes 0-6 B.3 setTxMute (MIN 71) Definition This message controls an individual mobile's transmit capability. If muteFlag is set to 1 (mute) the transmission control level is only allows registration, beam login, and responses to to-mobile messages. If muteFlag is set to 0 (unmute) the transmission control level allows all messages (normal operation). Syntax setTxMute Fields Reserved 7 bits TxMute 1 bit Details Field Description Value TxMute This sets the transmission control state 0 – Unmute 1 – Mute

IDP 100 Modem Series - Developer Guide

T203, Version 04 82 © SkyWave Proprietary B.4 getPosition (MIN 72) Definition This message polls for a position report. The response to this message is position. Syntax getPosition Fields No fields B.5 getConfiguration (MIN 97) Definition This message requests configuration information from the mobile device. Syntax getConfiguration Fields No fields B.6 pingRequest (MIN 112) Definition This message is posted at the IsatData Pro Gateway Web Service (IGWS) interface and sent to the mobile device. The mobile responds with pingResponse. Syntax pingRequest Fields RequestTime 16 bits Details Field Description Value RequestTime Time the requested was posted to the Gateway (seconds since midnight UTC) 0-86, 399

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 83 T203, Version 04 B.7 pingResponse (MIN 113) Definition This message is sent by the Gateway in response to the pingRequest. Syntax pingResponse Fields RequestTime 16 bits ResponseTime 16 bits Details Field Description Value RequestTime Time the original request was sent (seconds since midnight UTC). Copied by the Gateway from the pingRequest message 0-86, 399 ResponseTime Time this response was created by the Gateway (seconds since midnight UTC) 0-86, 399 B.8 getBroadcastIDs (MIN 115) Definition This message queries mobile device broadcast IDs. The modem responds with a list of its broadcast IDs. The mobile responds with pingResponse. Syntax getBroadcastIDs Fields No fields

IDP 100 Modem Series - Developer Guide

T203, Version 04 84 © SkyWave Proprietary APPENDIX C From-Mobile Messages C.1 modemRegistration (MIN 0) Definition The mobile device registration message is sent by the mobile when it is powered-on or reset. This is the first message a mobile sends after a reset. It is the mobile's way of requesting activation within the IsatData Pro network. The mobile receives the registration reply message prior to conducting any other communication. The Gateway aborts any from- or to-mobile messages in progress (sending state) when the registration message is received. Any from-mobile messages in progress are restarted by the modem unless the registration is due to a restart which marks the messages in the queue as failed. Syntax modemRegistration Fields HardwareVersion 16 bits SoftwareVersion 16 bits Product 8 bits WakeupInterval 8 bits LastResetReason 8 bits Traffic channel 12 bits Beam 4 bits VAIN 16 bits Reserved 2 bits OperatorTxState 3 bits UserTxState 3 bits BroadcastIDCount 8 bits Details Field Description Value HardwareVersion Identifies the mobile's hardware version - SoftwareVersion Identifies the mobile's software version - Product Identifies the mobile's product ID 0-255 WakeupInterval Specifies the wake-up interval currently set in the mobile. 0 – Always on (5s) >0 – Low power 0-255 LastResetReason Specifies the reason of the last registration/login. 0 – Power on 1 – Low voltage 2 – Reset pin 3 – Watchdog 0-255 Traffic Channel Specifies the to-mobile traffic channel that the mobile communicates with and is registering in. 1-4095 0 – Invalid Beam Specifies the beam number of the traffic channel that the mobile communicates with. 1-15 0 – Invalid

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 85 T203, Version 04 Field Description Value VAIN Mobile parameter used to control a mobile's access to specific traffic channels. 0 – 65535 0 – Default OperatorTxState Specifies the operator transmission control level 0 – Normal operation All other values are for SkyWave use UserTxState Specifies the operator transmission control level 0-7 0 – Unmute, normal operation 5 – Mute, only registration and beam login messages All other values are for SkyWave use BroadcastIDCount Number of active broadcast IDs provisioned in this modem 0-16 C.2 protocolError (MIN 2) Definition This message is sent when the modem encounters an error that prevents successful message delivery. Syntax protocolError Fields Reserved 5 bits MessageReference 8 bits ErrorCode 8 bits ErrorInfo 8 bits Details Field Description Value MessageReference Provides the reference number of the to- mobile message causing this error 0-2047 ErrorCode Specifies the particular error encountered 1 – Unable to allocate message buffer 2 – Unknown message type ErrorInfo For some error codes, this extra byte is used errorCode=2, this value is the offending messageType

IDP 100 Modem Series - Developer Guide

T203, Version 04 86 © SkyWave Proprietary C.3 sleepSchedule (MIN 70) Definition This message is returned from the modem to confirm that the new wake-up interval has been set. Syntax sleepSchedule Fields WakeupPeriod 8 bits MobileInitiated 1 bit MessageReference 11 bits Reserved 5 bits Details Field Description Value WakeupPeriod Length of time the modem sleeps between attempts to receive to-mobile messages. 0 – Off (terminal receives every 5 seconds) 1 – Reserved 2 – Reserved 3 – 3 minutes 4 – 10 minutes 5 – 30 minutes 6 – 60 minutes 0-6 MobileInitiated Flag which indicates that this request was initiated from the modem AT interface. Set to 1 if request was terminal initiated. 0-1 MessageReference Message reference number of the to-mobile request. Set to 0 if the request was terminal initiated. -

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 87 T203, Version 04 C.4 position (MIN 72) Definition This message is sent by the modem as a regular message. This 15-byte report is sent in response to the getPosition message. Syntax position Fields FixStatus 8 bits Latitude 24 bits Longitude 25 bits Altitude 15 bits Speed 8 bits Heading 8 bits DayOfMonth 5 bits MinuteOfDay 11 bits Details Field Description Value FixStatus Status of fix 1 – Valid Latitude Latitude in 0.001 minutes (2’s complement) - Longitude Longitude in 0.001 minutes (2’s complement) - Altitude Altitude in meters (2’s complement) Up to ± 16,380 m Speed Speed in km/hour 0-255 Heading Heading in 2º increments 0-179 DayOfMonth Day of month this GPS fix taken 1-31 MinuteOfDay Minutes of day this GPS fix taken 0-1439 0 – Midnight GPS time C.5 configuration (MIN 97) Definition The configuration reply is sent by the mobile device in response to the mobile's configuration request message. This information is used for diagnostic purposes only. Syntax configuration Fields Refer to modemRegistration (MIN 0) for field sizes Details Refer to modemRegistration (MIN 0) for field details

IDP 100 Modem Series - Developer Guide

T203, Version 04 88 © SkyWave Proprietary C.6 pingResponse (MIN 112) Definition This message is sent by the modem in response to the pingRequest message. Syntax pingResponse Fields RequestTime 16 bits ResponseTime 16 bits Details Field Description Value RequestTime Time the original request was sent (seconds since midnight UTC). Copied by the modem for the pingRequest message. - ResponseTime Time this reply was created by the modem (seconds since midnight UTC) 0-86, 399 C.7 pingRequest (MIN 113) Definition This message is posted at the modem AT interface and sent to the Gateway. The Gateway sends a response to this message. Syntax pingRequest Fields RequestTime 16 bits Details Field Description Value RequestTime Time the request was posted at the modem (seconds since midnight UTC) 0-86, 399

IDP 100 Modem Series - Developer Guide

© SkyWave Proprietary 89 T203, Version 04 C.8 testMessage (MIN 114) Definition This message is generated automatically by the mobile device as a means to continually test the satellite network. The message content, length and repeat period are specified using the command line interface. The command line interface starts and stops the process. Syntax testMessage Fields Text variable size Details Field Description Value Text A variable length byte array containing ASCII text. The length is determined by the message length. - C.9 broadcastIDs (MIN 115) Definition This message is the response to the getBroadcastIDs message. The response contains the entire list of 16 broadcast IDs. IDs of 0 are null (no broadcast service). Syntax broadcastIDs Fields BroadcastIDs (16) ID 24 bits Details Field Description Value ID An array of 16 ID fields, each 24 bits -

IDP 100 Modem Series - Developer Guide

T203, Version 04 90 © SkyWave Proprietary THIS PAGE INTENTIONALLY LEFT BLANK

Other Modem Manuals