at commands for model 9601-dg (tn2007-626-v2.0.0).pdf
TRANSCRIPT
AT COMMAND SET FOR MODEL 9601-DG
TECHNICAL NOTE
February 19, 2007
Copyright © 2007 by NAL Research Corporation
The specifications in this document are subject to change at NAL Research’s discretion. NAL Research assumes no responsibility for any claims or damages arising out of the use of this document or from the use of the 9601-DG based on this document, including but not limited to claims or damages based on infringement of patents, copyrights or other intellectual property rights. NAL Research makes no warranties, either expressed or implied with respect to the information and specifications contained in this document. Performance characteristics listed in this document are estimates only and do not constitute a warranty or guarantee of product performance.
TN2007-626-V2.0.0
NAL Research Corporation (TN2007-626-V2.0.0) 2
TABLE OF CONTENTS TABLE OF CONTENTS ........................................................................................................ 2
GLOSSARY ......................................................................................................................... 4
1.0 INTRODUCTION .......................................................................................................... 5
2.0 AT COMMANDS ........................................................................................................... 5
2.1 AT – Attention Code .................................................................................................. 5
2.2 A/ – Repeat Last Command ........................................................................................ 5
2.3 En – Echo ................................................................................................................ 5
2.4 In – Identification ..................................................................................................... 5
2.5 Qn – Quiet Mode ...................................................................................................... 6
2.6 Vn – Verbose Mode ................................................................................................... 6
2.7 Zn – Soft Reset ........................................................................................................ 6
2.8 &Dn – DTR Option (modified) ..................................................................................... 6
2.9 &Fn – Restore Factory Settings ................................................................................... 6
2.10 &Kn – Flow Control (modified) .................................................................................. 6
2.11 &V – View Active and Store Configuration ................................................................... 6
2.12 &Wn – Store Active Configuration .............................................................................. 6
2.13 &Yn – Designate Default Reset Profile ........................................................................ 7
2.14 %R – Display Registers ............................................................................................ 7
2.15 *F – Flush to EEPROM (new) .................................................................................... 7
2.16 *Rn – Radio Activity (new) ....................................................................................... 7
2.17 +CGMI – Manufacturer Identification ......................................................................... 7
2.18 +CGMM – Model Identification .................................................................................. 7
2.19 +CGMR – Revision .................................................................................................. 7
2.20 +CGSN – Serial Number .......................................................................................... 8
2.21 +CIER – Indicator Event Reporting (new) ................................................................... 8
2.22 +CSQ – Signal Quality ............................................................................................. 9
2.23 +CSQ[F] – Signal Quality (revised) ........................................................................... 10
2.24 +CULK – Unlock (new) ............................................................................................ 10
2.25 +GMI – Manufacturer Identification ........................................................................... 11
2.26 +GMM – Model Identification .................................................................................... 11
2.27 +GMR – Revision .................................................................................................... 11
2.28 +GSN – Serial Number ............................................................................................ 11
2.29 +IPR – Fixed DTE Rate (DO NOT USE) ....................................................................... 11
2.30 +SBDWB – Short Burst Data: Write Binary Data to the Module ...................................... 12
2.31 +SBDRB – Short Burst Data: Read Binary Data from the Module .................................... 13
2.32 +SBDWT – Short Burst Data: Write a Text Message to the Module ................................. 13
2.33 +SBDRT – Short Burst Data: Read a Text Message from the Module ............................... 14
2.34 +SBDI – Short Burst Data: Initiate an SBD Session ..................................................... 14
2.35 +SBDDET – Short Burst Data: Detach (new) ............................................................... 16
2.36 +SBDDSC – Short Burst Data: Delivery Short Code ..................................................... 17
2.37 +SBDIX – Short Burst Data: Initiate an SBD Session Extended (new) ............................. 17
2.38 +SBDMTA – Short Burst Data: Mobile-Terminated Alert (new) ....................................... 19
NAL Research Corporation (TN2007-626-V2.0.0) 3
2.39 +SBDREG – Short Burst Data: Network Registration (new) ........................................... 19
2.40 +SBDAREG – Short Burst Data: Automatic Registration (new) ....................................... 21
2.41 +SBDD – Short Burst Data: Clear SBD Message Buffer(s) ............................................. 22
2.42 +SBDC – Short Burst Data: Clear SBD MOMSN ........................................................... 23
2.43 +SBDS – Short Burst Data: Status ............................................................................ 23
2.44 +SBDSX – Short Burst Data: Status Extended ............................................................ 24
2.45 +SBDTC – Short Burst Data: Transfer MO Buffer to MT Buffer ....................................... 25
2.46 +MSSTM – Request System Time .............................................................................. 25
3.0 S-REGISTER DEFINITIONS ....................................................................................... 26
3.1 S-Register Commands ............................................................................................... 26
3.1.1 Sr – Direct S-Register Reference ....................................................................... 26
3.1.2 Sr? – Direct S-Register Read ............................................................................ 26
3.1.3 Sr=n – Direct S-Register Write ......................................................................... 26
3.1.4 ? – Referenced S-Register Read ........................................................................ 26
3.1.5 =n – Referenced S-Register Write ..................................................................... 26
3.2 S-Registers .............................................................................................................. 27
4.0 SUMMARY OF RESULT CODES ................................................................................... 31
5.0 INFORMATION EXAMPLES ........................................................................................ 32
5.1 Setting the Default Configuration ................................................................................ 32
5.2 Power-on to Sending a Message .................................................................................. 32
5.3 Automatic Notification Registration .............................................................................. 33
5.4 Automatic Notification Message Reception .................................................................... 33
5.5 Automatic Notification Automatic Registration ............................................................... 34
5.6 Sending a Message with Minimal Radio Activity ............................................................. 34
5.7 Power Down ............................................................................................................ 34
5.8 Sending an SBD Message to the 9601-DG .................................................................... 35
5.9 Field Elements of an SBD Message (Commercial Gateway Only) ...................................... 36
5.10 Calculate Checksum for SBDWB ................................................................................ 37
6.0 TABLE OF AT COMMAND CHANGES .......................................................................... 38
7.0 AT GPS COMMANDS ................................................................................................... 42
7.1 +PA ........................................................................................................................ 42
7.2 +PM ....................................................................................................................... 43
7.3 +PT ........................................................................................................................ 43
7.4 +PD ....................................................................................................................... 44
7.5 +PL ........................................................................................................................ 44
7.6 +PLOC .................................................................................................................... 44
7.7 +PV ........................................................................................................................ 45
7.8 +PVEL .................................................................................................................... 45
7.9 +PNAV .................................................................................................................... 46
7.10 +PNAV? ................................................................................................................. 46
7.10 +PP ...................................................................................................................... 46
APPENDIX A: NMEA MESSAGE FORMAT ......................................................................... 50
NAL Research Corporation (TN2007-626-V2.0.0) 4
GLOSSARY
CTS (V.24 signal) Clear To Send. This signal is used to control the flow of data to the 9601-DG
DCD (V.24 signal) Data Carrier Detect
DCE Data Communications Equipment. In this product, DCE refers to the 9601-DG
DSR (V.24 signal) Data Set Ready. This signal, from the 9601-DG, indicates readiness to accept
communication over the data port
DTE Data Terminal Equipment. In this product, DTE refers to the FA
DTR (V.24 signal) Data Terminal Ready. This signal, from the FA, requests the 9601-DG to accept
communication over the data port
ESS ETC SBD Subsystem (synonymous with GSS)
ETC Earth Terminal Controller, part of the Iridium Gateway
FA Field Application, the “host” of the 9601-DG
GSS Gateway SBD Subsystem (synonymous with ESS)
IMEI International Mobile Equipment Identity
MO Mobile Originated
MOMSN Mobile Originated Message Sequence Number
MT Mobile Terminated
MTMSN Mobile Terminated Message Sequence Number
RI (V.24 signal) Ring Indicate. This signal, from the 9601-DG, indicates that an MT message is
present at the ESS
RTS (V.24 signal) Request To Send. This signal is used to control the flow of data from the 9601-DG
SBD Short Burst Data
UART Universal Asynchronous Receiver Transmitter
NAL Research Corporation (TN2007-626-V2.0.0) 5
1.0 INTRODUCTION
This document is intended as a reference guide to the usage of AT command set for the Iridium 9601-
DG modem. There are two parts to this document. The first part includes AT commands for the Iridium 9601
RF board and the second part (Section 7.0) has AT GPS commands. Note that AT commands may be
modified, removed or added and users should always check for the latest revision by logging on NAL
Research’s anonymous ftp site (under RESOURCE CENTER of website www.nalresearch.com).
In order for the GPS features on the 9601-DG modem to work properly, please do not change the
following modem default values:
1. Serial port setting at 19.2 kbits/sec (can be re-configured by NAL Research for other baud rates).
Do not use the +IPR command to change the baud rate. If the +IPR as been used then follow the
instructions listed under +IPR – Fixed DTE rate (Section 2.2.8) to return the 9601-DG to standard
opration.
2. When the Iridium 9601 RF board is turned OFF by an AT command, communications with the 9601-
DG must be done with no flow control
2.0 AT COMMANDS
The following AT command can be used to put the Iridium RF board into an ON or an OFF state. A
different AT command can be used to toggle the GPS receiver and active antenna ON and OFF as well (see
Section 7.0).
AT*S=n – Change the state of the Iridium transceiver board to OFF (n=0) or to ON (n=1)
A carriage return or <Enter> key is needed after this command. Once the Iridium RF board is OFF, the
9601-DG can only communicate with a data terminal equipment (DTE) with flow control OFF. When the
Iridium RF board is OFF, only AT*S=n command and AT GPS commands work on the 9601-DG.
2.1 AT – ATtention Code
This is the prefix for all commands except A/. When entered by itself, the 9601-DG will respond with
OK.
2.2 A/ – Repeat Last Command
Repeat the last command issued to the 9601-DG unless power was interrupted or the 9601-DG is reset.
A/ is not followed by <CR>.
2.3 En – Echo
Echo command characters.
0 Characters are not echoed to the DTE.
1 Characters are echoed to the DTE (default).
2.4 In – Identification
Requests the 9601-DG to display information about itself.
0 “2400” (for compatibility only)
1 “0000” (for compatibility only)
2 “OK” (for compatibility only)
3 “XXXXXXXX” (software revision level)
NAL Research Corporation (TN2007-626-V2.0.0) 6
4 “IRIDIUM 9601” (product description)
5 “8816” (for compatibility only)
6 “XXX” (factory identity)
7 “XXXXXXXX” (hardware specification)
2.5 Qn – Quiet Mode
Control 9601-DG responses.
0 9601-DG responses are sent to the DTE (default).
1 9601-DG responses are NOT sent to the DTE.
2.6 Vn –Verbose Mode
Set the response format of the 9601-DG, which may be either numeric or textual.
0 Numeric responses.
1 Textual responses (default).
2.7 Zn – Soft Reset
Reset 9601-DG’s data port to a user-stored configuration that has been previously stored using &Wn.
0 Restores user configuration 0.
1 Restores user configuration 1.
2.8 &Dn – DTR Option (modified)
Set the 9601-DG reaction to the DTR signal.
0 DTR is ignored. A DTR signal input is not needed when set to &D0.
1-3 DTR must be ON. If DTR transitions from ON to OFF, the data port will be locked after
approximately 10 seconds to enter the UART test mode. The data port will resume when DTR is
restored to ON. There is no distinction between settings 1-3 (the default is 2).
2.9 &Fn – Restore Factory Settings
Recall factory default configuration without resetting the data port.
0 Recall factory default 0.
2.10 &Kn – Flow Control (modified)
Select the flow control method between the 9601-DG and DTE. Flow control is only applied to the
transfer of SBD message data; it does not apply to AT commands and their responses.
0 Disables flow control.
3 Enables RTS/CTS flow control (default).
2.11 &V – View Active and Stored Configuration
View the current active configuration and stored profiles.
2.12 &Wn – Store Active Configuration
Store the active profile in non-volatile memory. This is used to store user configurations for later use.
0 Store current (active) configuration as profile 0.
1 Store current (active) configuration as profile 1.
NAL Research Corporation (TN2007-626-V2.0.0) 7
2.13 &Yn – Designate Default Reset Profile
Select profile for use after power-up.
0 Select profile 0 (default).
1 Select profile 1.
2.14 %R – Display Registers
Display all the S-registers in the system.
2.15 *F – Flush to EEPROM (new)
Flush all pending writes to EEPROM, shut down the radio, and prepare the 9601-DG to be powered
down. The command returns OK upon completion, at which point it is safe to remove the power without
losing non-volatile data.
NOTE: This command stops the 9601-DG from responding to any more commands, but does not
actually power it down. The only way to power down the 9601-DG is for the DC power to be removed or
to de-assert the ON/OFF control line.
NOTE: After an SBD session, the new SBD MOMSN is always flushed to EEPROM before the +SBDI
result is issued.
2.16 *Rn – Radio Activity (new)
Control radio activity.
0 Disable radio activity.
1 Enable radio activity (default).
While the radio is disabled:
• SBD sessions can not be initiated; they will fail immediately.
• No SBD Automatic Notifications will be issued for automatic-MT messages.
• No registration, i.e. location updates will be performed.
• The baseband circuitry is still active and the 9601-DG still accepts AT commands.
This command allows the FA (field application, the “host” of the 9601-DG) to reduce detectable
emissions from the RF circuitry during the idle periods between SBD sessions, and also provides a
degree of power saving in cases where it may be inconvenient for the FA to power down the 9601-DG.
2.17 +CGMI – Manufacturer Identification
Exec Command: +CGMI
Query the 9601-DG manufacturer.
2.18 +CGMM – Model Identification
Exec Command: +CGMM
Query the 9601-DG model.
2.19 +CGMR – Revision
Exec Command: +CGMR
Query the 9601-DG revision.
NAL Research Corporation (TN2007-626-V2.0.0) 8
2.20 +CGSN – Serial Number
Exec Command: +CGSN
Query the 9601-DG IMEI.
2.21 +CIER – Indicator Event Reporting (new)
Set Command: +CIER=[<mode>[,<sigind>[,<svcind>[,<antind>]]]]
The set command enables or disables sending of the +CIEV unsolicited result code from the 9601-DG to
the DTE in case of indicator state changes. <mode> controls the processing of the +CIEV unsolicited
result codes.
<mode>:
0 Disable indicator event reporting; do not send +CIEV unsolicited result codes to the DTE;
buffer the most recent indicator event for each indicator in the 9601-DG (default).
1 Enable indicator event reporting; buffer the most recent +CIEV unsolicited result code for
each indicator when the data port is reserved (e.g. in SBD data mode) and flush them to
the DTE after reservation; otherwise forward them directly to the DTE.
<sigind>:
Control reporting of "signal quality" indicator changes:
0 No "signal quality" indicator reporting.
1 Enable "signal quality" indicator reporting using result code
+CIEV:0,<rssi>
where <rssi> is:
0 Equivalent to 0 bar on the signal strength indicator
1 Equivalent to 1 bar on the signal strength indicator
2 Equivalent to 2 bars on the signal strength indicator
3 Equivalent to 3 bars on the signal strength indicator
4 Equivalent to 4 bars on the signal strength indicator
5 Equivalent to 5 bars on the signal strength indicator
The reported signal strength is the same value that would be returned by the +CSQ command.
When enabled, the signal quality indicator is reported only when the signal strength changes.
<svcind>:
Control reporting of "service availability" indicator changes:
0 No "service availability" indicator reporting.
1 Enable "service availability" indicator reporting using result code
+CIEV:1,<value>
where <value> is:
0 Network service is currently unavailable.
1 Network service is available.
Network service availability is equivalent to a signal strength greater than 0. The service availability
indicator provides a way for the FA to wait until the 9601-DG can start an SBD session without receiving
NAL Research Corporation (TN2007-626-V2.0.0) 9
continual notifications of changes in signal strength.
<antind>:
Control reporting of "antenna fault" indicator changes:
0 No "antenna fault" indicator reporting.
1 Enable "antenna fault" indicator reporting using result code
+CIEV:2,<value>
where <value> is:
0 No antenna fault detected, or antenna fault cleared.
1 Antenna fault detected, further transmission impossible.
An antenna fault indicates that the antenna is not correctly attached, and in order to protect the
transmitter no more transmissions are permitted. On seeing an antenna fault, the user should check the
antenna connection; the fault will be automatically cleared once the 9601-DG detects network service
availability again.
Read Command: +CIER?
Query the current indicator event reporting settings. The response is of the form:
+CIER:<mode>,<sigind>,<svcind>,<antind>
Test Command: +CIER=?
List the supported settings. The response is in the form:
+CIER:(supported <mode>s),(supported <sigind>s),(supported <svcind>s),(supported <antind>s)
NOTE: In <mode> 1, the DTE may miss some indicator state changes if they occur while the data port
is reserved. However, the buffering mechanism ensures that the most recent change for each indicator
during reservation will be flushed to the DTE after reservation; thus the DTE is always made aware of
the latest state of each indicator.
NOTE: The DTE may initiate an SBD session even if service is unavailable; in this case, the 9601-DG
makes an immediate search for the network and, if successful, starts the SBD session, otherwise the
SBD session fails.
2.22 +CSQ – Signal Quality
Exec Command: +CSQ
Execution command returns the received signal strength indication <rssi> from the 9601-DG. Response
is in the form:
+CSQ:<rssi>
where <rssi> indicates:
0 Equivalent to 0 bar displayed on the signal strength indicator.
1 Equivalent to 1 bar displayed on the signal strength indicator.
2 Equivalent to 2 bars displayed on the signal strength indicator.
3 Equivalent to 3 bars displayed on the signal strength indicator.
4 Equivalent to 4 bars displayed on the signal strength indicator.
NAL Research Corporation (TN2007-626-V2.0.0) 10
5 Equivalent to 5 bars displayed on the signal strength indicator.
Test Command: +CSQ=?
List the supported signal strength indications. The response is in the form:
+CSQ:(supported <rssi>s)
NOTE: A signal strength response may not be immediately available, but will usually be received within
two seconds of issuing the command. If the 9601-DG is in the process of acquiring the system, a delay
in response of up to 10 seconds may be experienced.
2.23 +CSQ[F] – Signal Quality (Revised)
Exec Command: +CSQ[F]
Execution command returns the received signal strength indication <rssi> from the 9601-D. Response
is in the form:
+CSQ:<rssi>
where <rssi> indicates:
0 Equivalent to 0 bar displayed on the signal strength indicator
1 Equivalent to 1 bar displayed on the signal strength indicator
2 Equivalent to 2 bars displayed on the signal strength indicator
3 Equivalent to 3 bars displayed on the signal strength indicator
4 Equivalent to 4 bars displayed on the signal strength indicator
5 Equivalent to 5 bars displayed on the signal strength indicator
NOTE: The +CSQ form of the command waits for an updated signal strength reading to become
available. This will usually be within two seconds of issuing the command. If the 9601-DG is in the
process of acquiring the system, or in a satellite handoff, a delay in response of up to 10 seconds may
be experienced. If the 9601-DG has not proceeded to successful registration, the delay in response may
exceed the 50 second timeout limit. Under such condition, an ERROR response will be received. To
avoid a delayed response due to registration problems, issue the +CREG command to verify registration
prior to entering the +CSQ command to obtain signal strength.
NOTE: The +CSQF form of the command returns immediately, reporting the last known signal strength.
Test Command: +CSQ=?
List the supported signal strength indications. The response is in the form:
+CSQ:(supported <rssi>s)
2.24 +CULK – Unlock (new)
Exec Command: +CULK=<unlock key>
Unlock the 9601-DG after it has been locked by the Gateway. The unlock key must be obtained by
contacting Iridium’s customer support.
<unlock key>:
0000000000000000 .. FFFFFFFFFFFFFFFF
A string of 16 hexadecimal digits.
NAL Research Corporation (TN2007-626-V2.0.0) 11
While the 9601-DG is locked, it is unable to perform any SBD sessions. Any attempts to start a session
will return an error code indicating that the 9601-DG is locked.
Command Response:
+CULK:<status>
where <status> indicates the lock status of the 9601-DG following the unlock attempt:
0 Unlocked – 9601-DG is not locked and is permitted to perform SBD sessions.
1 Locked – 9601-DG is locked and unable to perform SBD sessions. It must be unlocked by
supplying the correct unlock key to the +CULK command.
2 Permanently locked – 9601-DG is locked and unable to perform SBD sessions. It cannot be
unlocked and must be returned to the supplier.
Read Command: +CULK?
Query the current lock status of the 9601-DG. The response is of the form:
+CULK:<status>
where <status> indicates:
0 Unlocked
1 Locked
2 Permanently locked
2.25 +GMI – Manufacturer Identification
Exec Command: +CGMI
Query the 9601-DG manufacturer.
2.26 +GMM – Model Identification
Exec Command: +CGMM
Query the 9601-DG model.
2.27 +GMR – Revision
Exec Command: +CGMR
Query the 9601-DG revision.
2.28 +GSN – Serial Number
Exec Command: +CGSN
Query the 9601-DG IMEI.
2.29 +IPR – Fixed DTE Rate (DO NOT USE)
Set Command: +IPR=<rate>
This command should not be used because of how the 9601-DG processes GPS data and the Iridium RF
board responses. This sets the data rate at which the 9601-DG will accept commands, but using this
command will causes data coming back from the 9601-DG to be corrupted. The change in data rate
takes into effect after the result code (e.g., OK) is received by the DTE.
where <rate> indicates:
NAL Research Corporation (TN2007-626-V2.0.0) 12
1 600 bps
2 1200 bps
3 2400 bps
4 4800 bps
5 9600 bps
6 19200 bps (default)
7 38400 bps
8 57600 bps
9 115200 bps
Read Command: +IPR?
Query the current data rate. The response is in the form:
+IPR:<rate>
Test Command: +IPR=?
List the supported data rates. The response is in the form:
+IPR:(supported <rate> settings)
If this command was used and the configuration was not saved then the original configuration can be
restored by power cycling the modem. If this command has been saved to memory then do the following:
1. Change the settings on the serial communications program to use the baud rate it has been set to.
2. Issue the Command, “AT+IPR=6”
3. Change the settings on the serial communications program to use 19200 bps as the baud rate.
4. Issue the Command “AT+GSN”. If the IMEI number of the unit is not returned then repeat step 1 at
a different baud rate. Otherwise continue to the next step.
5. Issue the Command “AT&Wn&Yn” where n is the profile you are currently using. For example
“AT&W0&Y0”.
NAL Research can set other permanent baud rates upon request
2.30 +SBDWB – Short Burst Data: Write Binary Data to the Module
Exec Command: +SBDWB=<SBD message length>
This command is used to transfer a binary SBD message from the DTE to the single mobile originated
buffer in the 9601-DG. The mobile originated buffer can contain only one message at any one time.
• Once the command is entered, and the message length is acceptable, the 9601-DG will indicate
to the DTE that it is prepared to receive the message by sending the ASCII encoded string
“READY<CR><LF>” (hex 52 45 41 44 59 0D 0A) to the DTE.
• The <SBD message length> parameter represents the length, in bytes, of the SBD message not
including the mandatory two-byte checksum.
• The maximum mobile originated SBD message length is specified at 205 bytes (and may be
increased in the future). The minimum mobile originated SBD message length is 1 byte. If the
<SBD message length> parameter is out of range, the 9601-DG issues response 3 (see below).
NAL Research Corporation (TN2007-626-V2.0.0) 13
• Once the DTE receives the READY indication from the 9601-DG, the SBD message must be sent
from the DTE formatted as follows: {binary SBD message} + {2-byte checksum}
• The checksum is the least significant 2-bytes of the summation of the entire SBD message. The
high order byte must be sent first. For example if the DTE were to send the word “hello”
encoded in ASCII to the 9601-DG the binary stream would be hex 68 65 6c 6c 6f 02 14.
• The mobile originated buffer will be empty upon power-up.
• If any data is currently in the mobile originated buffer, it will be overwritten.
Command Response:
0 SBD message successfully written to the 9601-DG.
1 SBD message write timeout. An insufficient number of bytes were transferred to 9601-DG
during the transfer period of 60 seconds.
2 SBD message checksum sent from DTE does not match the checksum calculated at 9601-DG.
3 SBD message size is not correct. The maximum mobile originated SBD message length is 205
bytes. The minimum mobile originated SBD message length is 1 byte.
2.31 +SBDRB – Short Burst Data: Read Binary Data from the Module
Exec Command: +SBDRB
This command is used to transfer a binary SBD message from the single mobile terminated buffer in the
9601-DG to the DTE. The mobile terminated buffer can contain only one message at any one time.
• The SBD message is transferred formatted as follows: {2-byte message length} + {binary SBD
message} + {2-byte checksum}
1. The {2-byte message length} field represents the length, in bytes, of the SBD message
not including the length field or the mandatory two-byte checksum. The high order byte
will be sent first.
2. The maximum mobile terminated SBD message length is length is specified at 135
bytes (and may be increased following actual performance testing).
3. The checksum is the least significant 2-bytes of the summation of the entire SBD
message. The high order byte will be sent first. For example if the 9601-DG were to
send the word “hello” encoded in ASCII to the DTE the binary stream would be hex 00
05 68 65 6c 6c 6f 02 14.
4. If there is no mobile terminated SBD message waiting to be retrieved from the 9601-
DG, the message length and checksum fields will be zero.
• The mobile terminated message buffer will be empty upon power-up.
Command Response:
There are no response codes generated by the 9601-DG for this command.
2.32 +SBDWT – Short Burst Data: Write a Text Message to the Module
Exec Command: +SBDWT[=<text message>]
This command is used to transfer a text SBD message from the DTE to the single mobile originated
buffer in the 9601-DG. The text message may be entered on the command line:
• For example, “AT+SBDWT=hello”.
NAL Research Corporation (TN2007-626-V2.0.0) 14
• The length of <text message> is limited to 120 characters. This is due to the length limit on the
AT command line interface.
• The message is terminated when a carriage return is entered.
Alternatively, the text message may be entered separately:
• Upon entering the command “AT+SBDWT”, the 9601-DG will indicate to the DTE that it is
prepared to receive the message by sending the string “READY<CR><LF>” (hex 52 45 41 44
59 0D 0A) to the DTE.
• Once the DTE receives the READY indication, the text message must be sent, terminated by a
carriage return.
• The length of the text message entered in this way is limited only by maximum mobile-
originated SBD message length of 205 bytes.
• The mobile originated buffer will be empty upon power-up.
• If any data is currently in the mobile originated buffer, it will be overwritten.
Command Response:
For the “AT+SBDWT” form:
0 SBD message successfully written to the 9601-DG.
1 SBD message write timeout. An insufficient number of bytes were transferred to 9601-DG
during the transfer period of 60 seconds.
For the “AT+SBDWT=<text message>” form:
OK SBD message successfully stored in mobile originated buffer.
ERROR An error occurred storing SBD message in mobile originated buffer.
2.33 +SBDRT – Short Burst Data: Read a Text Message from the Module
Exec Command: +SBDRT
This command is used to transfer a text SBD message from the single mobile terminated buffer in the
9601-DG to the DTE. This command is similar to +SBDRB but does not provide a length indicator or
checksum. The intent of this command is to provide a human friendly interface to SBD for
demonstrations and application development. It is expected that most usage of SBD will be with binary
messages.
• Once the command is entered, the SBD message in the mobile terminated buffer is sent out of
the port.
• This command is similar to +SBDRB except no length or checksum will be provided.
• The maximum mobile terminated SBD message length is 135 bytes.
• The mobile terminated message buffer will be empty upon power-up.
Command Response:
+SBDRT:<CR> {mobile terminated buffer}
2.34 +SBDI – Short Burst Data: Initiate an SBD Session
NOTE: The +SBDI command is provided for backwards compatibility with existing FAs which do not use
SBD Automatic Notification functionality. For SBD calls invoked with this command:
NAL Research Corporation (TN2007-626-V2.0.0) 15
• The SBD Session Type is fixed at type 0 – MO call.
• The SBD Delivery Short Code will be the value specified by the +SBDDSC command.
• The Detach/Attach flag is fixed at the Detach setting.
• The Location Update flag is fixed at the No Update setting.
FAs requiring SBD Automatic Notification functionality should use the extended +SBDIX command.
Exec Command: +SBDI
This command initiates an SBD session between the 9601-DG and the GSS (Gateway SBD Subsystem).
If there is a message in the mobile originated buffer it will be transferred to the GSS. Similarly if there is
one or more messages queued at the GSS the oldest will be transferred to the 9601-DG and placed into
the mobile terminated buffer.
• The message, if any, in the mobile originated buffer will be sent from the 9601-DG to the GSS.
• If there is a message queued at the GSS it will be transferred to the 9601-DG and placed into
the mobile terminated buffer.
Command Response:
+SBDI:<MO status>,<MOMSN>,<MT status>,<MTMSN>,<MT length>,<MT queued>
where:
<MO status>:
MO session status provides an indication of the disposition of the mobile originated transaction. The field
can take on the following values:
0 No SBD message to send from the 9601-DG.
1 SBD message successfully sent from the 9601-DG to the GSS.
2 An error occurred while attempting to send SBD message from 9601-DG to GSS.
<MOMSN>:
The Mobile Originated Message Sequence Number (MOMSN) is a value assigned by the 9601-DG when
sending a mobile-originated message to the GSS. This value is incremented each time an SBD session is
successfully completed between the 9601-DG to the GSS. This wrap around counter can range from 0 to
65535.
<MT status>:
The MT status provides an indication of the disposition of the mobile terminated transaction. The field
can take on the following values:
0 No SBD message to receive from the GSS.
1 SBD message successfully received from the GSS.
2 An error occurred while attempting to perform a mailbox check or receive a message from the
GSS.
<MTMSN>:
The Mobile Terminated Message Sequence Number (MTMSN) is assigned by the GSS when forwarding a
message to the 9601-DG. This value is indeterminate if the field <MT status> is zero. This wrap around
counter can range from 0 to 65535.
NAL Research Corporation (TN2007-626-V2.0.0) 16
<MT length>:
The MT length is the length in bytes of the mobile terminated SBD message received from the GSS. If
no message was received, this field will be zero.
<MT queued>:
MT queued is a count of mobile terminated SBD messages waiting at the GSS to be transferred to the
9601-DG.
2.35 +SBDDET – Short Burst Data: Detach (new)
Exec Command: +SBDDET
Initiates an SBD session to detach the 9601-DG from the Gateway.
Command Response:
+SBDDET:<status>,<error>
where <status>:
0 Detach successfully performed
1 An error occurred while attempting the detach
<error>:
Gateway-reported values
0 No error.
1..4 Reserved, but indicate success if used.
5..14 Reserved, but indicate failure if used.
15 Access is denied.
9610-D-reported values
16 9601-DG has been locked and may not make SBD calls (see +CULK command).
17 Gateway not responding (local session timeout).
18 Connection lost (RF drop).
19..31 Reserved, but indicate failure if used.
32 No network service, unable to initiate call.
33 Antenna fault, unable to initiate call.
34 Radio is disabled, unable to initiate call (see *Rn command).
35 9601-DG is busy, unable to initiate call (typically performing auto-registration).
36 Reserved, but indicate failure if used.
This instructs the Gateway to disable (detach) SBD Automatic Notifications for the calling 9601-DG.
Successful completion of the detach command implies that the Gateway has performed the requested
detach action and the 9601-DG is no longer registered. This session does not transfer any MO or MT
messages.
NOTE: A user can send an MO-SBD message and request a detach at the same time by using the
+SBDI command. The +SBDI command always requests a detach.
NAL Research Corporation (TN2007-626-V2.0.0) 17
2.36 +SBDDSC – Short Burst Data: Delivery Short Code
Set Command: +SBDDSC=<dsc>
Set the Delivery Short Code (DSC), which provides dynamic routing information for uploaded messages.
This is an 8-bit value providing the ability to set individual fields. Value 0x80 (hexadecimal) sets the
most significant bit. Value 0x01 sets the least significant bit. Flag values can be added together to
achieve a combination of settings. Some fields may be “locked” when the 9601-DG is in a special mode
(e.g. Auto-registration locks the flag values 0x80 and 0x40).
<dsc>:
0..255 DSC to be used for subsequent uploaded messages (0 default)
0x80 Hold MT message delivery
0x40 Leave MT message in queue after delivery
0x20 Destination in MO payload
Read Command: +SBDDSC?
Query the current Delivery Short Code. The response is of the form:
+SBDDSC:<dsc>
2.37 +SBDIX – Short Burst Data: Initiate an SBD Session Extended (new)
NOTE: The +SBDIX command must be used in place of the +SBDI command for FAs wishing to make
use of SBD Automatic Notification functionality.
Exec Command: +SBDIX[A][=<location>]
This command initiates an SBD session between the 9601-DG and the GSS, setting the SBD Session
Type according to the type of command +SBDIX or +SBDIXA, Delivery Short Code according to the
value specified by the +SBDDSC command, and the type of location according to whether the optional
location value is provided. If there is a message in the mobile originated buffer it will be transferred to
the GSS. Similarly if there is one or more messages queued at the GSS the oldest will be transferred to
the 9601-DG and placed into the mobile terminated buffer.
• The message, if any, in the mobile originated buffer will be sent from the 9601-DG to the GSS.
• If there is a message queued at the GSS it will be transferred to the 9601-DG and placed into
the mobile terminated buffer.
• This command will always attempt an SBD registration, consisting of attach and location
update, during the SBD session in order to support SBD Automatic Notification. If this is not
desired, the +SBDI command should be used.
• The FA should append an ‘A’ to the command, i.e. +SBDIXA, when the SBD session is in
response to an Automatic Notification.
<location> has format: [+|-]DDMM.MMM,[+|-]dddmm.mmm
where:
DD Degrees latitude (00-89)
MM Minutes latitude (00-59)
MMM Thousandths of minutes latitude (000-999)
ddd Degrees longitude (000-179)
NAL Research Corporation (TN2007-626-V2.0.0) 18
mm Minutes longitude (00-59)
mmm Thousandths of minutes longitude (000-999)
The optional sign indicators specify latitude North (+) or South (-), and longitude East (+) or West (-).
If omitted, the default is +. For example, AT+SBDIX=5212.483,-00007.350 corresponds to 52 degrees
12.483 minutes North, 0 degrees 7.35 minutes West.
Command Response:
+SBDIX:<MO status>,<MOMSN>,<MT status>,<MTMSN>,<MT length>,<MT queued>
where:
<MO status>:
MO session status provides an indication of the disposition of the mobile originated transaction. The
field can take on the following values:
Gateway-reported values
0 MO message, if any, transferred successfully.
1 MO message, if any, transferred successfully, but the MT message in the queue
was too big to be transferred.
2 MO message, if any, transferred successfully, but the requested Location Update
was not accepted.
3..4 Reserved, but indicate MO session success if used.
5..8 Reserved, but indicate MO session failure if used.
10 Gateway reported that the call did not complete in the allowed time.
11 MO message queue at the Gateway is full.
12 MO message has too many segments.
13 Gateway reported that the session did not complete.
14 Invalid segment size.
15 Access is denied.
9601-DG-reported values
16 9601-DG has been locked and may not make SBD calls (see +CULK command).
17 Gateway not responding (local session timeout).
18 Connection lost (RF drop).
19..31 Reserved, but indicate MO session failure if used.
32 No network service, unable to initiate call.
33 Antenna fault, unable to initiate call.
34 Radio is disabled, unable to initiate call (see *Rn command).
35 9601-DG is busy, unable to initiate call (typically performing auto-registration).
36.. Reserved, but indicate failure if used.
<MOMSN>:
The Mobile Originated Message Sequence Number (MOMSN) is a value assigned by the 9601-DG
when sending a mobile-originated message to the GSS. This value is incremented each time an SBD
session is successfully completed between the 9601-DG to the GSS. This wrap around counter can
range from 0 to 65535.
NAL Research Corporation (TN2007-626-V2.0.0) 19
<MT status>:
The MT status provides an indication of the disposition of the mobile terminated transaction. The
field can take on the following values:
0 No MT SBD message to receive from the Gateway.
1 MT SBD message successfully received from the Gateway.
2 An error occurred while attempting to perform a mailbox check or receive a message from
the Gateway.
<MTMSN>:
The Mobile Terminated Message Sequence Number (MTMSN) is assigned by the GSS when
forwarding a message to the 9601-DG. This value is indeterminate if the field <MT status> is zero.
This wrap around counter can range from 0 to 65535.
<MT length>:
The MT length is the length in bytes of the mobile terminated SBD message received from the GSS.
If no message was received, this field will be zero.
<MT queued>:
MT queued is a count of mobile terminated SBD messages waiting at the GSS to be transferred to
the 9601-DG.
2.38 +SBDMTA – Short Burst Data: Mobile-Terminated Alert (new)
Set Command: +SBDMTA=<mode>
Enable or disable ring indications for SBD Automatic Notifications.
<mode>:
0 Disable ring indication
1 Enable ring indication (default)
When ring indication is enabled, the 9601-DG asserts the RI line and issues the unsolicited result code
SBDRING when an SBD automatic notification is received.
Read Command: +SBDMTA?
Query the current ring indication mode. The response is of the form:
+SBDMTA:<mode>
Test Command: +SBDMTA=?
List the supported mode settings. The response is of the form:
+SBDMTA:(supported <mode> settings)
2.39 +SBDREG – Short Burst Data: Network Registration (new)
Exec Command: +SBDREG[=<location>]
Triggers an SBD session to perform a manual SBD registration.
This command initiates an SBD session to perform a manual SBD registration, consisting of an attach
and location update. The session type will be set to 2 – registration. This session does not transfer any
MO or MT messages.
NAL Research Corporation (TN2007-626-V2.0.0) 20
NOTE: The 9601-DG restricts the number of manual and automatic registrations to once every 3
minutes. Successive attempts within 3 minutes will return an error code indicating that the FA should try
later (see error 36 below).
NOTE: A user can send an MO SBD message and register at the same time by using the +SBDIX
command. The +SBDIX command always performs a registration attempt and should be used for an
application requiring SBD Automatic Notification. The +SBDI command never includes an SBD
registration and should be used for an application that does not require SBD Automatic Notification.
<location> has format: [+|-]DDMM.MMM,[+|-]dddmm.mmm
where:
DD Degrees latitude (00-89)
MM Minutes latitude (00-59)
MMM Thousandths of minutes latitude (000-999)
ddd Degrees longitude (000-179)
mm Minutes longitude (00-59)
mmm Thousandths of minutes longitude (000-999)
The optional sign indicators specify latitude North (+) or South (-), and longitude East (+) or West (-).
If omitted, the default is +. For example, AT+SBDIX=5212.483,-00007.350 corresponds to 52 degrees
12.483 minutes North, 0 degrees 7.35 minutes West.
Command Response:
+SBDREG:<status>,<reg err>
where:
<status> indicates the resulting registration status of the 9601-DG:
0 Detached –9601-DG is detached as a result of a successful +SBDDET or +SBDI command.
1 Not registered –9601-DG is attached but has not provided a good location since it was last
detached.
2 Registered –9601-DG is attached with a good location. Note that this may be the case even
when the most recent attempt did not provide a good location.
3 Registration denied –The gateway is denying service to the 9601-DG.
<reg err>:
Gateway-reported values
0 No error.
2 Session completed but the requested Location Update was not accepted.
3..14 Reserved, but indicate Location Update failure if used.
15 Access is denied.
9601-DG-reported values
16 9601-DG has been locked and may not make SBD calls (see +CULK command).
17 Gateway not responding (local session timeout).
18 Connection lost (RF drop).
19..31 Reserved, but indicate failure if used.
32 No network service, unable to initiate call.
NAL Research Corporation (TN2007-626-V2.0.0) 21
33 Antenna fault, unable to initiate call.
34 Radio is disabled, unable to initiate call (see *Rn command).
35 9601-DG is busy, unable to initiate call (typically performing auto-registration).
36 Try later, must wait 3 minutes since last registration.
37.. Reserved, but indicate failure if used.
Read Command: +SBDREG?
Query the current SBD registration status of the 9601-DG. The response is of the form:
+SBDREG:<status>
<status>:
0 Detached
1 Not registered
2 Registered
3 Registration denied
4 Unknown
The registration status is stored in 9601-DG non-volatile memory, and can therefore be queried by the
FA after powering up.
2.40 +SBDAREG – Short Burst Data: Automatic Registration (new)
Set Command: +SBDAREG=<mode>
Set the 9601-DG’s Auto-registration mode.
<mode>:
0 Disable automatic registration (default)
1 Set the Auto-registration mode to “Automatic”
2 Set the Auto-registration mode to “Ask”
When auto-registration is enabled, mode 1 or 2, the 9601-DG monitors its current location and triggers
an auto-registration when it determines that the 9601-DG has moved sufficiently far away from its last
registered location. Note that auto-registration runs only while the 9601-DG is attached to the gateway,
i.e. the registration status is “Not registered” or “Registered”.
Auto-registration may only be used with system-provided location. If the FA is providing its own location
(e.g. GPS), the FA should use the manual registration command, +SBDREG.
Upon triggering in mode 1, “Automatic”, the 9601-DG autonomously initiates an SBD session in order to
perform a registration with the updated location of the 9601-DG, with the session type set to 3 –auto-
registration. This session does not transfer any MO or MT messages.
Upon triggering in mode 2, “Ask”, the 9601-DG reports to the FA that it should register with the system
because the 9601-DG location has changed (see <event> below); it is then the responsibility of the FA
to register via +SBDREG or +SBDIX. +SBDIX allows the FA to register while including an MO message
and/or retrieving an MT message that is pending at the Gateway.
When auto-registration is enabled, mode 1 or 2, the 9601-DG reports relevant events to the FA by
issuing an unsolicited result code +AREG:<event>,<reg error>.
NAL Research Corporation (TN2007-626-V2.0.0) 22
<event>:
0 Suggest FA makes a registration attempt (mode 2 only)
1 Auto-registration has been performed successfully (mode 1 only)
2 Auto-registration has failed and will be retried after a delay (mode 1 only)
<reg error>:
Gateway-reported values
0 No error.
2 Session completed but the requested Location Update was not accepted.
3..14 Reserved, but indicate Location Update failure if used.
15 Access is denied.
9601-DG-reported values
16 9601-DG has been locked and may not make SBD calls (see +CULK command).
17 Gateway not responding (local session timeout).
18 Connection lost (RF drop).
19..31 Reserved, but indicate failure if used.
32 No network service, unable to initiate call.
33 Antenna fault, unable to initiate call.
34 Radio is disabled, unable to initiate call (see *Rn command).
35 9601-DG is busy, unable to initiate call (typically performing auto-registration).
36 Try later, must wait 3 minutes since last registration.
37.. Reserved, but indicate failure if used.
Read Command: +SBDAREG?
Query the current automatic MT registration mode. The response is of the form:
+SBDAREG:<mode>
Test Command: +SBDAREG=?
List the supported mode settings. The response is of the form:
+SBDAREG:(supported <mode> settings)
2.41 +SBDD – Short Burst Data: Clear SBD Message Buffer(s)
Exec Command: +SBDD<Delete type>
This command is used to clear the mobile originated buffer, mobile terminated buffer or both.
• The <Delete type> parameter identifies which buffers are cleared.
0 Clear the mobile originated buffer.
1 Clear the mobile terminated buffer.
2 Clear both the mobile originated and mobile terminated buffers.
• Using this command or power cycling the 9601-DG are the only means by which both buffers
are cleared.
• The mobile terminated buffer will be cleared when an SBD session is initiated.
• Sending a message from the 9601-DG to the ESS does not clear the mobile originated buffer.
• Reading a message from the 9601-DG does not clear the mobile terminated buffer.
Command Response:
NAL Research Corporation (TN2007-626-V2.0.0) 23
0 Buffer(s) cleared successfully.
1 An error occurred while clearing the buffer(s).
2.42 +SBDC –Short Burst Data: Clear SBD MOMSN
Exec Command: +SBDC
This command will clear (set to 0) the mobile originated message sequence number (MOMSN) stored in
the 9601-DG. The MOMSN is maintained even after power cycle.
Command Response:
0 The MOMSN was cleared successfully.
1 An error occurred while clearing the MOMSN.
2.43 +SBDS –Short Burst Data: Status
Exec Command: +SBDS
This command returns current state of the mobile originated and mobile terminated buffers.
Command Response:
+SBDS:<MO flag>,<MOMSN>,<MT flag>,<MTMSN>
where:
<MO flag>:
The MO flag indicates the existence of a message in the mobile originated buffer. The response from
the 9601-DG is one of the following numeric codes:
0 No message in mobile originated buffer
1 Message in mobile originated buffer
<MOMSN>:
The MOMSN identifies the sequence number that will be used during the next mobile originated SBD
session.
<MT Flag>:
The MT flag indicates the existence of a message in the mobile terminated buffer. The response
from the 9601-DG is one of the following numeric codes:
0 No message in mobile terminated buffer
1 Message in mobile terminated buffer
<MTMSN>:
The MTMSN identifies the sequence number that was used in the most recent mobile terminated
SBD session. This value will be –1 if there is nothing in the mobile terminated buffer.
NOTE: The +SBDS command has been extended to +SBDSX to display a non-volatile SBD ring alert
flag indicating the presence of an unanswered SBD ring alert. Also a new extension was added to
the +SBDSX extended status command <msg waiting> to identify the number or count of
messages waiting to be downloaded.
NAL Research Corporation (TN2007-626-V2.0.0) 24
2.44 +SBDSX – Short Burst Data: Status Extended
Exec Command: +SBDSX
This command returns current state of the mobile originated and mobile terminated buffers and the
SBD ring alert status.
Command Response:
+SBDS: <MO flag>, <MOMSN>, <MT flag>, <MTMSN>, <RA Flag>, <msg waiting>
where:
<MO flag>:
The MO flag indicates the existence of a message in the mobile originated buffer. The response
from the 9601-DG is one of the following numeric codes:
0 No message in mobile originated buffer
1 Message in mobile originated buffer
<MOMSN>:
The MOMSN identifies the sequence number that will be used during the next mobile originated
SBD session.
<MT Flag>:
The MT flag indicates the existence of a message in the mobile terminated buffer. The response
from the 9601-DG is one of the following numeric codes:
0 No message in mobile terminated buffer
1 Message in mobile terminated buffer
<MTMSN>:
The MTMSN identifies the sequence number that was used in the most recent mobile terminated
SBD session. This value will be -1 if there is nothing in the mobile terminated buffer.
<RA Flag>:
The RA flag indicates whether an SBD ring alert has been received and still needs to be
answered.
0 No SBD ring alert
1 SBD ring alert has been received and needs to be answered
NOTE: The RA flag is set whenever the 9601-DG receives an SBD ring alert; this happens even if
the +SBDMTA setting specifies that SBD ring indications are disabled. The RA flag is cleared only
on successful completion of an SBD mailbox check, i.e. an SBD session invoked with
+SBDI[X[A]] in which the returned MT status indicates that no error occurred. The value of the
RA flag is stored in non-volatile memory so it is preserved across power cycling of the 9601-DG.
<msg waiting>:
The message waiting flag indicates how many SBD mobile terminated messages are currently
queued at the gateway awaiting collection by the 9601-D. This flag is updated after every SBD
session, including +SBDI, +SBDIX, +SBDIXA, +SBDREG and +SBDDET.
NAL Research Corporation (TN2007-626-V2.0.0) 25
2.45 +SBDTC – Short Burst Data: Transfer MO Buffer to MT Buffer
Exec Command: +SBDTC
This command will transfer the contents of the mobile originated buffer to the mobile terminated buffer.
Developers of DTE can use this command to test reading and writing to the 9601-DG without actually
initiating SBD sessions with the ESS.
Command Response:
The command produces a response of the form “SBDTC: Outbound SBD copied to Inbound SBD: size =
<size>” followed by “OK”, where <size> is the length of the message in bytes.
2.46 -MSSTM – Request System Time
Exec Command: -MSSTM
Query the latest system time received from the network. The response is the form:
-MSSTM:<system_time>
<system_time> can take one of the following forms:
no network service The 9601-DG has not yet received system time from the network.
XXXXXXX Where XXXXXXXX is the current Iridium system time available from the
network. The system time as received through the Iridium Air Interface, is a
32 bit integer count of the number of 90 millisecond intervals that have
elapsed since the epoch. The return value is formatted as an ASCII
hexadecimal number. The counter will rollover approximately every 12 years.
Iridium system time epoch: June 1, 1996, 00:00:13 (GMT):
Iridium system time source: The system time is available and valid only after the 9601-DG has
registered with the network and has received the Iridium system time from the network. Once the time
is received, the 9601-DG uses its internal clock to increment the counter. In addition, at least every 8
hours, or on location update or other event that requires re-registration, the 9601-DG will obtain a new
system time from the network.
Time localization: None. The system time value is always expressed in GMT time.
Resolution and accuracy: The resolution of the system time is one Iridium frame tick, or 90 ms.
Accuracy as measured by the difference between the time reported and the actual time it is sent out the
9601-DG serial port should not exceed 4 frame ticks (.36 seconds) and in most cases will be one frame
tick (.09 seconds) or less.
NAL Research Corporation (TN2007-626-V2.0.0) 26
3.0 S-REGISTER DEFINITIONS
S-registers allow control over specific 9601-DG operations. Some S-registers contain a single numeric
value, other S-registers are bit-mapped where individual bits, or set of bits, control specific functions.
Table 1 defines the S-registers used for 9601-DG. Many of the A3LA series S-registers are obsolete for
9601-DG, and 9601-DG requires some new S-registers. To prevent reallocation of obsolete S-registers,
they are reserved and shaded out in the table, and the new S-registers are registers that are unused in
A3LA series and are marked as “new for 9601-DG”.
All S-registers, from S0 to S127, are readable. All write permissions remain unchanged from A3LA
series, even where a writable register is not used in 9601-DG. Writable registers are highlighted in the
“Sr=n writable?” column. An FA could use the unused writable S-registers to store application-specific
data.
The final column in the table indicates which S-registers are stored in non-volatile memory as part of a
user profile; the 9601-DG can be reset to a stored profile using the Zn command.
3.1 S-Register Commands
Commands allow S-registers to be read, written, or simply referenced (i.e. set a pointer to designate the
current, referenced S-register). S-register commands are described in the following subsections.
3.1.1 Sr – Direct S-Register Reference
Set a pointer to reference S-register r.
3.1.2 Sr? – Direct S-Register Read
Read the value of S-register r.
3.1.3 Sr=n – Direct S-Register Write
Set the value of S-register r to n, where n is a decimal value in the range 0 to 255.
3.1.4 ? –Referenced S-Register Read
Read the value of the current referenced S-register. The current referenced S-register is that which was
last acted upon by a direct reference (ATSr), read (ATSr?), or write (ATSr=n) command.
3.1.5 =n –Referenced S-Register Write
Set the value of the current referenced S-register to n. The current referenced S-register is that which
was last acted upon by a direct reference (ATSr), read (ATSr?), or write (ATSr=n) command.
NAL Research Corporation (TN2007-626-V2.0.0) 27
3.2 S-Registers
Table 1: 9601-DG Transceiver S-Registers
REG
ISTER
R
AN
GE
DEFA
ULT
DESCRIPTION
Sr=
n
wri
tab
le?
Pro
file
S
ett
ing
?
SO 0 – 255 0 Auto-answer. Assigning a value from 1 to 255 in register S0 tells the ISU to automatically answer incoming calls. The factory setting of 0 turns off the automatic answer feature.
S1 0 – 255 0 Ring count
S2 0 – 255 43 Escape code character
S3 0 – 127 13 Carriage return character
S4 0 – 127 10 Line feed character
S5 0 – 32 8 Backspace character
S6 0 – 255 4 Wait for dail-tone
S7 0 – 255 50 Communication standard used by ISU
S8 0 – 255 4 Pause time for comma
S9 0 – 255 6 Carrier detect response time
S10 0 – 255 14 Carrier loss time
S11 0 – 255 0 DTMF tone duration
S12 0 – 255 50 Escape guard time. Time, in 50ths of a second, until OK displayed after entering command mode by escape sequence
S13 0 – 255 49 Bitmap register: Bits 0 – 1: DCE data bits Bits 2 – 3: DCE stop bits Bits 4 – 6: DCE parity setting
S14 0 – 255 170 Bit register: Bit 1: En setting (echo) Bit 2: Qn setting (quiet) Bit 3: Vn setting (verbose) Bit 5: pulse/tone dial mode
S21 0 – 255 48 Bitmap register: Bit 0: telephone jack control Bit 2: RTS/CTS on/off Bits 3 – 4: &Dn setting (DTR operation) Bit 5: &Cn setting Bit 6: disconnecting long space
S22 0 – 255 246 Bitmap register Bits 0 – 1: speaker volume setting Bits 2 – 3: speaker on/off setting Bits 4 – 6: Xn setting
NAL Research Corporation (TN2007-626-V2.0.0) 28
REG
ISTER
R
AN
GE
DEFA
ULT
DESCRIPTION
Sr=
n
wri
tab
le?
Pro
file
S
ett
ing
?
S23 0 – 255 61 Bitmap register: Bits 1 – 4: +IPR setting (DTE baud rate) Bits 6 – 7: guard tone
S25 0 – 255 5 Sets length of time in hundredths of a second that a change in the DTR status has to persist for before it is recognized
S27 0 – 255 9 Bitmap register: Bits 0 – 2: &Qn setting Bit 3: leased line operation setting Bits 4 – 5: synchronous clock setting
S28 0 – 255 0 Bitmap register: Bits 3 – 4: &Pn setting (pulse dial make/break ratio)
S30 0 – 255 0 Disconnect activity timer. Timer used to determined how long the call connection been inactive, in increments of 1/10000ms. A value of 0 disables this function
S31 0 – 255 0 Bitmap register: Bit 1: line modulation method setting Bits 2 – 3: Wn setting
S34 0 – 255 0 Bitmap register: Bits 0 – 1: data compression type (PT) Bit 6: +DS compression negotiation setting Bit 7: +DR setting
S35 0 – 255 7 Bearer service capabilities
S36 0 – 255 0 Bitmap register: Bits 0 – 2: link type setting
S37 0 – 255 0 Bitmap register: Bits 0 – 4: Fn setting (line modulation standard)
S39 0 – 255 3 Bitmap register: Bits 0 – 2: &Kn setting (flow control)
S40 0 – 255 104 Bitmap register: Bits 2 – 4: \K setting Bits 3 – 5: \Kn setting Bits 6 – 7: \An setting
S41 0 – 255 0 Bitmap registers: Bits 2, 6: enable retrain on bad signal quality setting Bit 4: xon/xoff usage setting Bit 5: DTE auto rate adjustment setting
S42 0 – 255 16 GSM Call clearing code as returned by the network. Refer to GSM 04.08 Table 10.86 Cause Information Element Values
NAL Research Corporation (TN2007-626-V2.0.0) 29
REG
ISTER
R
AN
GE
DEFA
ULT
DESCRIPTION
Sr=
n
wri
tab
le?
Pro
file
S
ett
ing
?
S43 0 – 255 32 Bitmap register: Bit 0: +CMGF setting Bit 1: +CBST parameter <name> setting Bit 2: +CMEE setting Bit 3: +CMEE setting Bit 5: +CBST parameter <ce> setting Bit 6: +CRC setting Bit 7: +CR setting
S44 0 – 255 4 Bitmap register: Bits 0 – 2: +CPBS setting Bits 5 – 6: +CREG setting Bit 7: reserved
S45 0 – 255 0 Bitmap register: Bits 0 – 1: +CNMI parameter <mode> setting Bits 2 – 3: +CNMI parameter <mt> setting Bits 4 – 5: +CNMI parameter <bm> setting Bits 6 – 7: +CNMI parameter <ds> setting
S47 0 – 255 0 Bitmap register: Bits 4 – 6: TON settings for dial string
S49 0 – 255 1 Bitmap register: Bits 0 – 3: NPI settings for dial string
S51 0 – 255 2 V.42bis maximum codewords (P1), high byte
S52 0 – 255 0 V.42bis maximum codewords (P1), low byte
S54 0 – 255 6 V.42bis maximum string size (P2)
S58 0 – 255 3 V.42bis compression direction (P0)
S95 0 – 255 0 Bitmap register for extended result codes (overrides Wn setting): Bit 0: CONNECT shows DCE speed Bit 2: Enable CARRIER XXXX Bit 3: Enable PROTOCOL XXXX Bit 5: Enable COMPRESSION XXXX
S96 0 – 255 0 IRLP version number (N0) parameter
S98 1 – 105 105
IRLP k iwf ISU parameter
S99 1 – 105 105
IRLP k ISU iwf parameter
S100 1 – 15 15 IRLP N2 parameter
S102 26 – 255 30 IRLP T1 parameter
S103 10 – 255 10 IRLP T2 parameter
S104 4 – 255 25 IRLP T4 parameter
NAL Research Corporation (TN2007-626-V2.0.0) 30
REG
ISTER
R
AN
GE
DEFA
ULT
DESCRIPTION
Sr=
n
wri
tab
le?
Pro
file
S
ett
ing
?
S106 1 – 10 10 IRLP riwf ISU parameter
S107 1 – 10 10 IRLP risu iwf parameter
S110 0 – 1 0 SBM max segment size (40 – 310) (high byte)
S111 0 – 255 135 SBM max segment size (40 – 310) (low byte)
S112 0 – 255 0 SBD upload message sequence number (high byte)
S113 0 – 255 0 SBD upload message sequence number (low byte)
S121 0 – 15 1 New for 9601-DG Bitmap register: Bit 0: +SBDMTA setting (ring indication) Bits 1 – 2: +SBDAREG setting (automatic registration)
S122 0 – 31 1 New for 9601-DG Bitmap register: Bit 0: *R setting (radio activity) Bits 1 – 4: +CIER setting (indicator event reporting)
S123 0 – 255 8 Bitmap register: Bit 1: +WTM Bit 2: +WDLDM<dldm> Bit 3: +WIRLP<mode> Bits 4 – 5: +WFRNG
S124 0 – 255 15 Dynamic link measurement interval (+WDLM <mi> setting). Value in 1000ms unit
S125 1 – 100 10 Dynamic link delay measurement delay tolerance (+WDLM<dtl> setting). Value in % unit
S126 0 – 255 2 Bitmap register: Bit 0: ignore &Dn command specified reaction to DTR ON to OFF transitions. Disconnect as reaction to Hn command. OK response given Bit 1: ignore &Dn command specified reaction to DTR ON to OFF transitions. Ignore Hn command. OK response given Bit 2: comply with &Dn command specified reaction to DTR ON to OFF transitions. Disconnect as reaction to Hn command.
S127 0 – 255 0 Bitmap register containing copies of MSVTR/MSVLS parameters: Bit 0: -MSVTR: 0=Disabled (default) 1=Enabled Bit 1: -MSVLS: 0=No Mute (default) 1=Mute Enabled
NAL Research Corporation (TN2007-626-V2.0.0) 31
4.0 SUMMARY OF RESULT CODES
NUMERIC (V0) VERBOSE (V1) DESCRIPTION
0 ‘OK’ Acknowledges execution of command
2 ‘SBDRING’ MT messages present at gateway (unsolicited if enabled). See section 2.34
4 ‘ERROR’ Command not accepted
127 ‘HARDWARE FAILURE: <subsys>,<error>’
Issued at initialization in case of a hardware failure
as verbose ‘READY’ Ready to receive binary message data from DTE
as verbose ‘+AREG:<event>,<reg error>’
Auto-registration event report. See section 2.39
as verbose ‘’+CIEV:<sig>,<value>’
Indicator event report (unsolicited if enabled). See section 2.21
NAL Research Corporation (TN2007-626-V2.0.0) 32
5.0 INFORMATIVE EXAMPLES
5.1 Setting the Default Configuration
The FA sets the 9601-DG’s default configuration to no handshaking, no flow control, radio enabled, SBD
Automatic Notifications enabled.
5.2 Power-on to Sending a Message
The FA will power the 9601-DG, wait for the 9601-DG to acquire the network, and send a 70-byte
message.
TO 9601-DG (FROM FA)
TO FA (FROM 9601-DG) DESCRIPTION
AT&K0
OK
Disable RTS/CTS flow control
AT*R1
OK
Enable the radio
AT+SBDMTA=1
OK
Enable SBD ring indications
AT&W0
OK
Store the configuration as profile 0
AT&Y0
OK
Store profile 0 as the power-up default
TO 9601-DG (FROM FA)
TO FA (FROM 9601-DG) DESCRIPTION
Apply power to the 9601-DG
Wait for DSR to become asserted
AT+CIER=1,0,1,0
OK
Enable service indication reporting (note that this can be stored in the default configuration)
+CIEV:1,1 Wait for the 9601-DG to acquire the network
AT+SBDWB=70
READY
<binary transfer>
0
Transfer message to 9601
AT+SBDIX
+SBDIX:0,23,0,-1,0,0
Perform SBD session
AT+SBDD0
OK
Clear the MO message buffer
NAL Research Corporation (TN2007-626-V2.0.0) 33
5.3 Automatic Notification Registration
The FA verifies its registration state, performs a registration in order to be able to receive Automatic
Notifications, and enables Automatic Notification indications.
5.4 Automatic Notification Message Reception
The FA verifies its registration state. Upon receiving an Automatic Notification the FA initiates an SBD
session to receive an MT message.
TO 9601-DG (FROM FA)
TO FA (FROM 9601-DG) DESCRIPTION
AT+SBDREG? Query the 9601-DG registration status
+SBDREG:0 9601-DG is detached, i.e. un-registered
AT+SBDREG Tell the 9601-DG to register for Automatic Notifications
+SBDREG:2,0 9601-DG is now registered
AT+SBDREG? Query the 9601-DG registration status
+SBDREG:2 9601-DG is registered
AT+SBDMTA=1
OK
Enable SBD ring indications from 9601-DG to FA
TO 9601-DG (FROM FA)
TO FA (FROM 9601-DG) DESCRIPTION
AT+SBDREG? Query the 9601-DG registration status
+SBDREG:2 9601-DG is registered
………. User sending a MT message to the GSS
+SBDRING 9601-DG indicates an incoming message. The RI line also toggles
AT+SBDIXA FA initiates an SBD session in answer to the Automatic Notification
+SBDIXA:0,23,1,237,90,2 9601-DG informs FA that a 90-byte message was successfully received with MTMSN 237 and that two further MT messages are queued at the GSS
AT+SBDRB
<binary transfer>
FA retrieves the received message from the 9601-DG
NAL Research Corporation (TN2007-626-V2.0.0) 34
5.5 Automatic Notification Automatic Registration
The FA verifies its registration state and enables automatic registration using the “Ask” mode.
5.6 Sending a Message with Minimal Radio Activity
Assuming that service indication events have been turned on with AT+CIER=1,0,1 and the radio has
been disabled with AT*R0.
5.7 Powering Down
The FA flushes any pending EEPROM writes before powering down the 9601-DG.
TO 9601-DG (FROM FA)
TO FA (FROM 9601-DG) DESCRIPTION
AT+SBDREG? Query the 9601-DG registration status
+SBDREG:2 9601-DG is registered
AT+SBDAREG=2
OK
FA sets the automatic registration to “Ask” mode
… 9601-DG is moved
+AREG:0,0 9601-DG notifies FA that it needs to register
AT+SBDREG FA instructs the 9601-DG to register
+SBDREG:2,0 Registration successful
TO 9601-DG (FROM FA)
TO FA (FROM 9601-DG) DESCRIPTION
AT+SBDWB=70
READY
<binary transfer>
0
Transfer message to 9601-DG
AT*R1
OK
Activate the radio and wait for the 9601-DG to acquire the network
+CIEV:1,1 9601-DG has acquired the network
AT+SBDI
+SBDI:0,23,0,-1,0,0
Perform SBD session
AT*R0
OK
Deactivate the radio
AT+SBDD0
OK
Clear the MO message buffer
NAL Research Corporation (TN2007-626-V2.0.0) 35
5.8 Sending an SBD Message to the 9601-DG
Messages can be sent to the 9601-DG via SBD from almost any e-mail program (Outlook, Outlook
Express, etc.).
1. In order to send e-mail messages to a 9601-DG, the e-mail program must use the standard
Multipurpose Internet Mail Extensions (MIME) Base64 encoding as defined in RFC 2045. The
following instructions describe how to set this up for Microsoft Outlook Express:
a. Select “Tools/Options”
b. Click the “Send” Tab
c. Under “Mail Sending Format”, click “HTML Settings…”
d. Click MIME
e. Select “Base 64” for Encode text using
f. Click OK
g. Under “Mail Sending Format”, click “Plain Text Settings…”
h. Repeat steps d – f
2. Send all e-mail messages to [email protected]
3. Place the IMEI number of the modem in the subject line
4. The message should be carried in an attachment, which must have a “.sbd” extension
NOTE: Comparable information related to the DoD gateway is provided upon request.
TO 9601-DG (FROM FA)
TO FA (FROM 9601-DG) DESCRIPTION
AT*F
OK
FA tells the 9601-DG to flush pending writes to EEPROM and waits for completion
<binary transfer> FA may now safely disconnect the 9601-DG power supply
NAL Research Corporation (TN2007-626-V2.0.0) 36
5.9 Field Elements of an SBD Message (Commercial Gateway Only)
The table below displays the field descriptors of each SBD messages sent from the 9601-DG. This
format will appear in the body of every SBD e-mail message.
FIELD NAME DESCRIPTION
MOMSN Mobile Originated Message Sequence Number (0 – 65535).
MTMSN Mobile Terminated Message Sequence Number (0 – 65535).
Time of
Session
The UTC Timestamp of the 9601-DG session between the 9601-DG and the controller
subsystem.
Session Status Description
TRANSFER OK The SBD session completed successfully.
INCOMPLETE CALL The SBD session did not complete successfully due to
a protocol error.
SBD DENIAL The 9601-DG is not allowed to access the system.
Session
Status
SBD TIMEOUT The SBD session did not complete for an unknown
reason such as a RF fade.
Message Size The size of the attached message in decoded format. This is not the length of the MIME
encoded data.
Unit Location The latitude and longitude of the 9601-DG. The latitude and the longitude provide a center
point and the CEPradius provides the radius of a circle around that center point. The
reported position is accurate (within the reported circle) 80% of the time. This location is
estimated using Iridium satellites.
CEPradius An estimate of the accuracy of the unit in kilometers.
Example:
MOMSN: 1
MTMSN: 0
Time of Session (UTC): Tue Dec 7 13:09:43 2004
Session Status: TRANSFER OK
Message Size (bytes): 11
Unit Location: Lat = 38.766516 Long = -77.426262
CEPradius = 2
The actual message sent from the 9601-DG is in an attachment of the e-mail and the subject line
contains the IMEI number of the unit that sent the SBD message.
NAL Research Corporation (TN2007-626-V2.0.0) 37
5.10 Calculate Checksum for SBDWB
Since the calculation of the checksum for SBDWB may be confusing, a C code example is given below.
Please see Section 2.29 (+SBDWB) for additional information.
unsigned int16 checksum = 0; /*Unsigned 16 bit integer*/
int i;
unsigned char c;
char* data = “Test SBD message”;
int length = 16; /* Number of characters in data */
for (i=0;i<length;i++) {
c = data[i];
putch(c);
checksum += c;
}
//Print out the 2 byte checksum
putch(checksum/256);
putch(checksum%256);
NAL Research Corporation (TN2007-626-V2.0.0) 38
6.0 TABLE OF AT COMMAND CHANGES
Table below shows which A3LA series AT commands are modified or removed, and which AT commands
are new for 9601-DG. Removed commands are shaded.
COMMAND DESCRIPTION MODIFIED NEW
AT Attention code
A/ Repeat last command
+++ Escape sequence
A Answer
Bn Communication standards
Cn Carrier control
D Dial
En Echo
Fn Line modulation
Hn Hangup
In Identification
Ln Loudspeaker Volume
Mn Speaker control
Nn Auto-Mode enable
On Online
P Pulse dial
Qn Quiet mode
T Tome dial
Vn Verbose mode
Wn Error correction message control
Xn Extended result codes
Yn Long space disconnect
Zn Soft reset
&Cn DCD option
&Dn DTR option
&Fn Restore factory settings
&Gn Guard tone
&Jn Jack control
&Kn Flow control
&Ln Lease line operation
&Mn Asynchronous/synchronous mode
&Pn Pulse dial make/break ratio
&Qn Sync/async mode
NAL Research Corporation (TN2007-626-V2.0.0) 39
COMMAND DESCRIPTION MODIFIED NEW
&Rn RTS/CTS option
&Sn DSR override
&V View active and stored configuration
&Wn Store active configuration
&Xn Select asynchronous clock
&Yn Designate default reset profile
\An MNP block size
\Bn Transmit break
\Gn XON/XOFF flow control
\Jn DTE auto rate
\Kn Control break
\Nn Line type
%Cn Compression control
%En Auto retrain
%R Display registers
*F Flush to EEPROM
*Pn Power phone
*Rn Radio activity
+CBC Battery charge
+CBST Select bearer service type
+CCFC Call forward service
+CCLK Real-time clock
+CEER Extended error report
+CGMI Manufacturer identification
+CGMM Model identification
+CGMR Revision
+CGSN Serial number
+CHUP Hangup call
+CIER Indicator event reporting
+CLCC Request current call status
+CLCK Facility lock
+CLVL Loudspeaker volume level control
+CMEE Report mobile equipment error
+CMGD Delete SMS message
+CMGF SMS message format
NAL Research Corporation (TN2007-626-V2.0.0) 40
COMMAND DESCRIPTION MODIFIED NEW
+CMGL List SMS messages
+CMGR Read SMS message
+CMGS Send SMS message
+CMGW Write SMS message to memory
+CMOD Call mode
+CMUT Mute control
+CNMI New SMS message indications to DTE
+CNUM Read MSISDN number
+COPS Operator select
+CPAS Phone activity status
+CPBF Find phonebook entries
+CPBR Read phonebook entries
+CPBS Select phonebook storage
+CPBW Write phonebook entry
+CPIN Enter PIN
+CPMS Select preferred SMS message storage
+CPWD Change password
+CR Service reporting control
+CRC Cellular result codes
+CREG Network registration
+CSCA SMS service center address
+CSCB Select cell broadcast message types
+CSCS Select TE character set
+CSMS Select SMS message service
+CSQ Signal quality
+CSTA Select type of address
+CULK Unlock
+CVHU Voice hangup control
+DR Data compression report level
+DS Set data compression function
+GCAP General capability
+GMI Manufacture identification
+GMM Model identification
+GMR Revision
+GSN Serial number
+IPR Fixed DTE rate
+SBDAREG Short burst data: Automatic Registration
+SBDC Short burst data: Clear SBD MOMSN
NAL Research Corporation (TN2007-626-V2.0.0) 41
COMMAND DESCRIPTION MODIFIED NEW
+SBDD Short burst data: Clear SBD message buffers
+SBDDET Short burst data: Detach
+SBDDSC Short burst data: Delivery short code
+SBDI Short burst data: Initiate an SBD session
+SBDIX Short burst data: Initiate an SBD session extended
+SBDIXA Short burst data: Initiate an SBD session extended
+SBDMTA Short burst data: Mobile-terminated alert
+SBDRB Short burst data: Read binary data from 9601-DG
+SBDREG Short burst data: Automatic registration
+SBDRT Short burst data: Read text message from 9601-DG +SBDS Short burst data: Status +SBDTC Short burst data: Transfer MO buffer to MT buffer +SBDWB Short burst data: Write binary data to the 9601-DG +SBDWT Short burst data: Write a text message to 9601-DG +SBDZ Short burst data; Segment size
+WDAV Register or deregister an RS232 DAV data peripheral
+WDLDM IRLP dynamic link delay measurement
+WFRNG Force IRLP renegotiation
+WIRLP Iridium radio link protocol
+WTM IRLP test mode
-MSGEO Request geolocation
-MSSTM Request system time
-MSVLS Local DTMF feedback selection
-MSVTR DTMF received in voice call
-MSVTS DTMF generation in voice call
NAL Research Corporation (TN2007-626-V2.0.0) 42
7.0 AT GPS COMMAND
The following AT commands are available specifically for the GPS receiver and GPS antenna:
AT+PA=<n> – Displays a standard NMEA message, where <n> is NMEA format type
AT+PM=<i>,<1, …,C> – Displays multiple NMEA messages at a repeated interval, where <i> is the interval and <1, ..,C> is a list of NMEA format types
AT+PT – Displays UTC time
AT+PD – Displays UTC date
AT+PL – Displays position (latitude, longitude, altitude) to the 4th decimal place
AT+PLOC – Displays position (latitude, longitude, altitude) to the 5th decimal place
AT+PV – Displays ground velocity (speed and direction)
AT+PVEL – Displays velocity (ground speed, vertical speed and ground heading)
AT+PNAV=<n> – Increase the accuracy of the GPS receiver by specifying the environment,
where <n> is a list of 7 different environments
AT+PNAV? – Displays the status of the current environment
AT+PP=<n> – Toggles the GPS receiver ON/OFF. <n> is 0 for OFF and 1 for ON.
A carriage return or <Enter> key is needed after each command. All AT GPS commands except AT+PA,
AT+PM, AT+PNAV, and AT+PP will return the number of satellites used to generate the information. The
GPS receiver will calculate UTC time based on its own internal clock if the GPS receiver can no longer
acquire satellite signals. If the GPS receiver is turned OFF by AT+PP command and an extended AT GPS
command besides AT+PP is issued, the 9601-DG will respond with the message “GPS Off”. All other AT
commands will return the text “OK” and always be in verbose mode.
AT+PA=<n>
This command returns the complete NMEA message format (see Appendix A), where <n> is an integer
number ranging from 1 to C corresponding to the following NMEA and proprietary u-blox formats:
1 – GGA
2 – GLL
3 – GSA
4 – GSV
5 – GRS
6 – RMC
7 – VTG
8 – ZDA
9 – GST
A – PUBX,00
B – PUBX,01
C – PUBX,04
NAL Research Corporation (TN2007-626-V2.0.0) 43
AT+PM=<i>,<1,…,C)
This command returns multiple NMEA messages (see Appendix C) at a repeated interval, where <i> is
the user-defined interval. NMEA message(s) will be displayed repeatedly until a character (any character) is
received on the serial port. If the time it takes to display NMEA messages is greater than the time between
the intervals then some NMEA messages will be discarded. Possible values for <i> are:
1 – 0.20 second
2 – 0.25 second
3 – 0.50 second
4 – 1.00 second
5 – 10.00 seconds
<1,..,C> is a list of characters whose elements range from 1 to C corresponding to the following NMEA
and proprietary u-blox formats. Each element in the list corresponds to a message that will be repeated
once every cycle. Each of the characters in the list must be separated by a comma and there must be no
spaces between them.
1 – GGA
2 – GLL
3 – GSA
4 – GSV
5 – GRS
6 – RMC
7 – VTG
8 – ZDA
9 – GST
A – PUBX,00
B – PUBX,01
C – PUBX,04
AT+PT
This command returns UTC time with the format shown below. The <Invalid Position Fix> message will
appear only if the GPS receiver could not acquire a position fix.
+PT:
UTC Time=<hh>:<mm>:<ss>.<xxx>
<Invalid Position Fix>
Satellites Used=<zz>
where,
<hh> – Hours (01–23)
<mm> – Minutes (00–59)
<ss> – Seconds (00–59)
<xxx> – Fraction of seconds (000–999)
<zz> – Number of satellites used to obtain information
NAL Research Corporation (TN2007-626-V2.0.0) 44
AT+PD
This command returns UTC date with the format shown below. The <Invalid Position Fix> message will
appear only if the GPS receiver could not acquire a position fix.
+PD:
UTC Date=<mm>–<dd>–<yyyy>
<Invalid Position Fix>
Satellites Used=<zz>
where,
<mm> – Month (01–12)
<dd> – Day (01–31)
<yyyy> – Year (0000–9999), 0000 may appear for an <Invalid Position Fix>
<zz> – Number of satellites used to obtain information
AT+PL
This command returns position with the format shown below. The <Invalid Position Fix> message will
appear only if the GPS receiver could not acquire a position fix. The latitude and longitude have been
truncated to 4th decimal place for backwards compatibility with the TIM GPS receivers. The AT+PLOC
command is recommended to obtain GPS information.
+PL:
Latitude=<ll>:<mm>.<nnnn> <N/S>
Longitude=<ooo>:<pp>.<qqqq> <E/W>
Altitude=<#> meters
<Invalid Position Fix>
Satellites Used=<zz>
where,
<ll> – Latitude in degrees (00–90)
<mm> – Latitude in minutes (00–59)
<nnnn> – Fraction of minutes (0000–9999)
<N/S> – Either North or South depending on the direction
<ooo> – Longitude in degrees (000–180)
<pp> – Longitude in minutes (00–59)
<qqqq> – Fraction of minutes (0000–9999)
<E/W> – Either East or West depending on the direction
<#> – Altitude displayed with one decimal place
<zz> – Number of satellites used to obtain information
AT+PLOC
This command returns position with the format shown below. The <Invalid Position Fix> message will
appear only if the GPS receiver could not acquire a position fix.
+PLOC:
Latitude=<ll>:<mm>.<nnnnn> <N/S>
NAL Research Corporation (TN2007-626-V2.0.0) 45
Longitude=<ooo>:<pp>.<qqqqq> <E/W>
Altitude=<#> meters
<Position Fix> = Invalid Position Fix, Valid Position Fix, or Dead Reckoning
Satellites Used=<zz>
where,
<ll> – Latitude in degrees (00–90)
<mm> – Latitude in minutes (00–59)
<nnnnn> – Fraction of minutes (00000–99999)
<N/S> – Either North or South depending on the direction
<ooo> – Longitude in degrees (000–180)
<pp> – Longitude in minutes (00–59)
<qqqqq> – Fraction of minutes (00000–99999)
<E/W> – Either East or West depending on the direction
<#> – Altitude displayed with one decimal place
<zz> – Number of satellites used to obtain information
AT+PV
This command returns velocity (consisting of speed and direction) with the format shown below. The
<Invalid Position Fix> message will appear only if the GPS receiver could not acquire a position fix. The
AT+PVEL command is recommend to obtain velocity information because this command also lists the
vertical velocity and will sometimes indicate dead reckoning instead of listing Invalid Position Fix.
+PV:
Ground Velocity=<#s> km/h, <#h> degrees from true North
<Invalid Position Fix>
Satellites Used=<zz>
where,
<#s> – Speed displayed with one decimal place
<#h> – Heading in degrees from true north ranging from 0 to 360
<zz> – Number of satellites used to obtain information
AT+PVEL
This command returns velocity (consisting of speed and direction) with the format shown below. The
<Invalid Position Fix> message will appear only if the GPS receiver could not acquire a position fix.
+PVEL:
Ground Velocity=<#g> km/h, <#h> degrees from true North
Vertical Velocity=<#v> m/s
<Position Fix>
Satellites Used=<zz>
where,
<#g> – Speed displayed
NAL Research Corporation (TN2007-626-V2.0.0) 46
<#h> – Heading in degrees from true north ranging from 0 to 360
<#v> - Vertical component of velocity. Value may be negative.
<Position Fix> = Invalid Position Fix, Valid Position Fix, or Dead Reckoning
<zz> – Number of satellites used to obtain information
AT+PNAV=<n>
This command increases the accuracy of the GPS receiver by specifying the environment, where <n>
takes on one of the following values:
1. Stationary
2. Pedestrian
3. Automotive
4. AT Sea
5. Airborne < 1g
6. Airborne < 2g
7. Airborne < 4g
AT+PNAV?
This command displays the status of the current environment, which will return the following:
+PNAV: <c>
where,
<c> – Is a value between 1 and 7 corresponding to <n> specified above.
AT+PP=<n>
This command turns the GPS receiver and GPS antenna ON and OFF, where <n> takes on a value of:
0 – OFF
1 – ON
EXAMPLES AT+PA=1 +PA: $GPGGA,173047.60,3846.01520,N,07729.09861,W,1,10,0.85,84.2,M,-33.4,M,,*57 AT+PA=2 +PA: $GPGLL,3846.01496,N,07729.09773,W,173121.40,A,A*7A AT+PA=3 +PA: $GPGSA,A,3,25,30,11,09,18,14,05,22,35,15,,,1.62,0.85,1.38*06
NAL Research Corporation (TN2007-626-V2.0.0) 47
AT+PA=4 +PA: $GPGSV,3,1,11,21,04,175,,25,23,223,47,30,28,133,46,11,05,322,31*77 $GPGSV,3,2,11,09,24,046,48,18,43,127,47,14,60,312,48,05,33,091,40*76 $GPGSV,3,3,11,22,81,110,49,35,39,145,43,15,36,211,47*46 AT+PA=5 +PA: $GPGRS,160944.40,1,-1.8,-0.8,-3.0,6.7,-2.7,3.1,0.9,-3.3,-2.5,,,*60 AT+PA=6 +PA: $GPRMC,173221.60,A,3846.01492,N,07729.09772,W,0.020,103.73,300704,,,A*7D AT+PA=7 +PA: $GPVTG,125.55,T,,M,0.005,N,0.009,K,A*37 AT+PA=8 +PA: $GPZDA,173254.60,30,07,2004,00,00*64 AT+PA=9 +PA: $GPGST,161118.20,2.4,,,,1.6,1.1,2.1*77 AT+PA=A +PA: $PUBX,00,161135.80,3846.015871,N,07729.099067,W,42.863,G3,2.0,2.1,0.005,105.03,- 0.014,,1.07,1.46,1.06,8,0,0*68$GPZDA,000800.33,15,02,2003,,*69 AT+PA=B +PA: $PUBX,01,161214.60,284102.185,W,4293845.657,N,75.286,G3,2.0,2.2,0.022,282.77,-0. 007,,1.07,1.46,1.06,8,0,0*60 AT+PA=C +PA: $PUBX,04,161229.60,300704,490349.60,1281,490349.60,-3642995,-3950.460,43,*14 AT+PM=1,1,7 OK $GPVTG,336.16,T,,M,0.014,N,0.026,K,A*3D $GPGGA,172518.60,3846.01491,N,07729.09804,W,1,10,1.03,83.0,M,-33.4,M,,*5B $GPVTG,336.16,T,,M,0.011,N,0.021,K,A*3F $GPGGA,172518.80,3846.01492,N,07729.09805,W,1,10,1.03,83.0,M,-33.4,M,,*57 $GPVTG,336.16,T,,M,0.015,N,0.027,K,A*3D $GPGGA,172519.00,3846.01492,N,07729.09805,W,1,10,1.03,83.0,M,-33.4,M,,*5E OK
NAL Research Corporation (TN2007-626-V2.0.0) 48
AT+PT +PT: UTC Time=00:08:14.335 Satellites Used=07 AT+PD +PD: UTC Date=02-15-2003 Satellites Used=07 AT+PL +PL: Latitude=38:46.0127 North Longitude=077:29.0957 West Altitude=55.6 meters Satellites Used=07 AT+PLOC +PLOC: Latitude=38:46.01521 North Longitude=077:29.09869 West Altitude=82.2 meters Valid Position Fix Satellites Used=10 AT+PV +PV: Ground Velocity=0.1 km/h, 149.90 degrees from true North Satellites Used=06 AT+PVEL +PVEL: Ground Velocity=0.049 km/h, 0.06 degrees from true North Vertical Velocity=0.028 m/s Valid Position Fix Satellites Used=10 AT+PNAV? +PNAV:2 OK AT+PNAV=4 +PNAV: OK AT+PNAV? +PNAV:4 OK
NAL Research Corporation (TN2007-626-V2.0.0) 49
AT+PLOC +PLOC: Latitude=38:46.01767 North Longitude=077:29.09746 West Altitude=81.7 meters Valid Position Fix Satellites Used=8 OK AT+PP=0 OK AT+PLOC GPS Off OK AT+PP=1 OK AT+PLOC +PLOC: Latitude=38:46.01542 North Longitude=077:29.09810 West Altitude=80.3 meters Valid Position Fix Satellites Used=8 OK
NAL Research Corporation (TN2007-626-V2.0.0) 50
APPENDIX A: NMEA MESSAGE FORMAT
GGA - GPS Fix Data – AT+PA=1
ASCII String Name
Format Example Length Units Description
Message ID String $GPGGA 6 GGA protocol header UTC Time hhmmss.ss 175837.40 9 Current Time
Latitude ddmm.mmmmm 3846.01498 10 Degrees, minutes, and fraction of minutes
N/S Indicator Character N 1 N = north or S = south
Longitude dddmm.mmmm 07729.09940 11 Degrees, minutes, and fraction of minutes
E/W Indicator Character W 1 E = east or W = west
Position Fix Indicator Digit 1 1 0 = Invalid Fix, 1 or 2 = Valid Fix, 3 = Estimated Dead Reckoning
Satellites Used Ss 10 1 or 2 Range 0 to 12
HDOP Numeric 0.85 varies Horizontal Dilution of Precision
MSL Altitude1 Numeric 81.2 varies meters Altitude Units Character M 1 Stands for meters Altref Numeric -33.4 varies meters Geoid Separation Units Character M 1 Stands for meters Age of Differential Corrections
Numeric Blank
Diff. Referece Station ID Numeric Blank
Checksum hexadecimal characters
*59
<CR><LF> End of Message
Example: $GPGGA,175837.40,3846.01498,N,07729.09940,W,1,10,0.85,81.2,M,-33.4,M,,*59
1 Does not support geodic corrections values are WGS-84 heights
NAL Research Corporation (TN2007-626-V2.0.0) 51
GLL - Latitude and longitude with time position fix and status – AT+PA=2
ASCII String Name
Format Example Length Units Description
Message ID string $GPGLL 6 GLL Protocol header Latitude ddmm.mmmmm 3846.01505 10 Degrees, minutes, and fraction of minutes N/S Indicator character N 1 N = north or S = south Longitude dddmm.mmmmm 07729.09766 11 Degrees, minutes, and fraction of minutes E/W Indicator character W 1 E = east or W = west UTC Time hhmmss.xxx 181015.00 9 Current Time
Status character A 1 A = data valid or V = data invalid
Mode character A 1 N=No Fix, A=Autonomous GNSS Fix, D=Differential GNSS Fix, E=Estimated/Dead Reckoning Fix
Checksum hexadecimal characters
*7A
<CR><LF> End of Message
Example: $GPGLL,3846.01505,N,07729.09766,W,181015.00,A,A*7A
GSA - GPS dilution of precision and active satellites – AT+PA=3
ASCII String Name
Format Example Length Units Description
Message ID string $GPGSA 6 GSA Protocol header
SMode character A 1
M – Manual – forced to operate in 2D or 3D mode A – 2D Automatic – allowed to automatically switch 2D/3D
Fix Status 1 digit 3 1 1 – Fix not available 2 – 2D position fix 3 – 3D position fix
Satellites Used numeric 11 variable SV on Channel 1 Satellites Used numeric 25 variable SV on Channel 2 Satellites Used numeric 30 variable SV on Channel 3 Satellites Used numeric 09 variable SV on Channel 4 Satellites Used numeric 18 variable SV on Channel 5 Satellites Used numeric 14 variable SV on Channel 6 Satellites Used numeric 05 variable SV on Channel 7 Satellites Used numeric 22 variable SV on Channel 8 Satellites Used numeric 35 variable SV on Channel 9 Satellites Used numeric 15 variable SV on Channel 10 Satellites Used numeric variable SV on Channel 11 Satellites Used numeric variable SV on Channel 12 PDOP numeric 1.53 variable Position Dilution of Precision HDOP numeric 0.83 variable Horizontal Dilution of Precision VDOP numeric 1.29 variable Vertical Dilution of Precision
Checksum hexadecimal characters
*02
<CR><LF> End of Message
Example: $GPGSA,A,3,11,25,30,09,18,14,05,22,35,15,,,1.53,0.83,1.29*02
NAL Research Corporation (TN2007-626-V2.0.0) 52
GSV - Satellites in View – AT+PA=4
ASCII String Name
Format Example Length Units Description
Message ID string $GPGSV 6 GSV protocol header Number of Messages 1 digit 3 1 Range 1 to 3 Message Number 1 digit 1 1 Range 1 to 3 Satellites in View numeric 10 2 Satellite ID ss 11 2 Channel 1 (Range 1 to 32) Elevation dd 12 2 degree Channel 1 (Range 00 to 90) Azimuth aaa 304 3 degree Channel1 (True, Range 000 to 359) SNR numeric 36 varies dBHz Range 0 to 99, null when not tracking … Satellite ID ss 15 2 Channel _(Range 1 to 32) Elevation dd 15 2 degree Channel _ (Range 00 to 90) Azimuth aaa 199 3 degree Channel _ (True, Range 000 to 359) SNR numeric 40 varies dBHz Range 0 to 99, null when not tracking
Checksum hexadecimal characters
*76
<CR><LF> End of Message
Example: $GPGSV,3,1,10,11,12,304,36,25,43,237,50,30,43,110,46,09,04,050,37*72 $GPGSV,3,2,10,18,22,141,46,14,68,003,49,05,32,064,49,22,58,147,49*7A $GPGSV,3,3,10,35,39,145,43,15,15,199,40*76
GRS - GNSS Range Residuals – AT+PA=5
ASCII String Name
Format Example Length Units Description
Message ID string $GPGRS 6 GRS protocol header UTC Time hhmmss.ss 183431.80 9 Current Time Mode character 1 1 This will always be 1
residual numeric 1.2 varies meters
Range residuals for SVs used in navigation. The SV order matches the order from the GSA sentence.
… residual numeric varies meters
Checksum hexadecimal characters
*64
<CR><LF> End of Message
Example: $GPGRS,183431.80,1,1.2,-1.9,-0.8,-0.5,0.5,-2.3,2.5,-3.5,,,,*64
NAL Research Corporation (TN2007-626-V2.0.0) 53
RMC - Recommended Minimum Data – AT+PA=6
ASCII String Name
Format Example Length Units Description
Message ID string $GPRMC 6 RMC protocol header UTC Time hhmmss.ss 184232.60 9 Current Time
Status character A 1 A=data valid or V=data invalid
Latitude ddmm.mmmmm 3846.01437 9 Degrees, minutes, and fraction of minutes
N/S Indicator character N 1 N = north or S = south
Longitude dddmm.mmmmm 07729.09861 10 Degrees, minutes, and fraction of minutes
E/W Indicator character W 1 E = east or W = west Speed Over Ground numeric 0.027 varies knots Course Over Ground
numeric 331.95 varies degrees True
UTC Date ddmmyy 300704 6 days, months, years
Current Date
Magnetic Variation blank degrees Not Supported Magnetic Variation E/W
blank Not Supported
Mode character A 1 N=No Fix, A=Autonomous GNSS Fix, D=Differential GNSS Fix, E=Estimated/Dead Reckoning Fix
Checksum hexadecimal characters
*79
<CR><LF> End of Message
Example: $GPRMC,184232.60,A,3846.01437,N,07729.09861,W,0.027,331.95,300704,,,A*79
VTG - Course over ground and ground speed – AT+PA=7
ASCII String Name
Format Example Length Units Description
Message ID string $GPVTG 6 VTG protocol header Course (True) numeric 19.38 varies degrees Measured heading Reference character T 1 True Course (Magnetic) blank Measured Heading Reference character M 1 Magnetic Speed numeric 0.032 varies knots Units character N 1 Knots Speed numeric 0.059 varies km/h Units character K 1 Kilometers per hour
Mode character A 1
N=No Fix, A=Autonomous GNSS Fix, D=Differential GNSS Fix, E=Estimated/Dead Reckoning Fix
Checksum hexadecimal characters
*03
<CR><LF> End of Message
Example: $GPVTG,19.38,T,,M,0.032,N,0.059,K,A*03
NAL Research Corporation (TN2007-626-V2.0.0) 54
ZDA - Time and Date – AT+PA=8
ASCII String Name
Format Example Length Units Description
Message ID string $GPZDA 6 ZDA protocol header
UTC time hhmmss.ss 185741.80 9 hours minutes seconds
00…23 00…59 00.00…59.99
UTC time: day dd 30 2 days 01…31 UTC time: month mm 07 2 months 01…12 UTC time: year yyyy 2004 4 years 4 digit year Local zone hours xx or -xx 00 2 Not used (= 00) Local zone minutes zz 00 2 Not used (= 00)
Checksum hexadecimal characters
*62
<CR><LF> End of Message
Example: $GPZDA,185741.80,30,07,2004,00,00*62
GST - GNSS Pseudo Range Error Statistics – AT+PA=9
ASCII String Name
Format Example Length Units Description
Message ID string $GPST 6 GST protocol header
UTC time hhmmss.ss 190009.60 9 hours minutes seconds
00…23 00…59 00.00…59.99
Range rms numeric 2.4 varies meters RMS value of the standard deviation of the ranges
Std Major numeric Standard deviation (semi-major axis) Not supported empty.
Std Minor numeric Standard deviation of semi-minor axis Not supported empty.
Heading numeric Orientation of semi-major axis Not supported empty.
Std Latititude numeric 1.4 varies meters Standard deviation of latitude
Std Longitude numeric 1.3 varies meters Standard deviation of longitude
Std Altitude numeric 2.4 varies meters Standard deviation of altitude
Checksum hexadecimal characters
*79
<CR><LF> End of Message
Example: $GPGST,190009.60,2.4,,,,1.4,1.3,2.4*79
NAL Research Corporation (TN2007-626-V2.0.0) 55
PUBX0 - Lat/Long Position Data – AT+PA=A
ASCII String Name
Format Example Length Units Description
Message Start string $PUBX 5 Message Header Navstar Proprietary sentences
Message ID character 00 2 Proprietary Message ID
UTC time hhmmss.ss 191944.20 9 hours minutes seconds
00…23 00…59 00.00…59.99
Latitude ddmm.mmmmm 3846.012485 10 Degrees, minutes, and fraction of minutes
N/S Indicator character N 1 N = north or S = south
Longitude dddmm.mmmmm 07729.097149 11 Degrees, minutes, and fraction of minutes
E/W Indicator character W 1 E = east or W = west
AltRef numeric 40.793 Altitude above user data ellipsoid.
NavStat nn G3 2 meters Hacc numeric 1.7 varies Horizontal Accuracy Vacc numeric 2.6 varies Vertical Accuracy SOG numeric 0.032 varies Speed Over Ground COG numeric 73.26 varies Course Over Ground Vvel numeric 0.009 varies Vertical Velocity
ageC numeric varies seconds Age of most recent DGPS Corrections. 00.0 to 999.9 Empty = none available
HDOP numeric 0.84 varies 2-D Horizontal Dilution of Precision
VDOP numeric 1.28 varies Vertical Dilution of Precision
TDOP numeric 0.68 varies 4-D Geometric Dilution of Precision
Number of Satellites
numeric 9 varies Number of GPS Satellites Used
RU numeric 0 1 Number of GLONASS satellites used in the navigation solution. Always set to 0.
DR numeric 0 varies Dead Reckoning used (0 or 1)
Checksum hexadecimal characters
*79
<CR><LF> End of Message
Example: $PUBX,00,191944.20,3846.012485,N,07729.097149,W,40.793,G3,1.7,2.6,0.032,73.26,0. 009,,0.84,1.28,0.68,9,0,0*79
NAL Research Corporation (TN2007-626-V2.0.0) 56
PUBX1 - Lat/Long Position Data – AT+PA=B
ASCII String Name
Format Example Length Units Description
Message Start string $PUBX 5 Message Header Navstar Proprietary sentences
Message ID character 01 2 Proprietary Message ID
UTC time hhmmss.ss 205838.60 9 hours minutes seconds
00…23 00…59 00.00…59.99
Easting numeric 284099.823 varies meters UTM Easting E/W Indicator character W 1 E = east or W = west
Northing numeric 4293841.170 varies meters Degrees, minutes, and fraction of minutes
N/S Indicator character N 1 N = north or S = south
AltMSL numeric 69.267 varies Altitude above user datum ellipsoid.
NavStat nn G3 2 meters Hacc numeric 2.0 varies Horizontal Accuracy Vacc numeric 3.6 varies Vertical Accuracy SOG numeric 0.023 varies Speed Over Ground COG numeric 173.18 varies Course Over Ground Vvel numeric 0.005 varies Vertical Velocity
ageC numeric varies seconds Age of most recent DGPS Corrections. 00.0 to 999.9 Empty = none available
HDOP numeric 1.05 varies 2-D Horizontal Dilution of Precision
VDOP numeric 2.02 varies Vertical Dilution of Precision
TDOP numeric 1.28 varies 4-D Geometric Dilution of Precision
Number of Satellites
numeric 8 varies Number of GPS Satellites Used
RU numeric 0 1 Number of GLONASS satellites used in the navigation solution. Always set to 0.
DR numeric 0 varies Dead Reckoning used (0 or 1)
Checksum hexadecimal characters
*45
<CR><LF> End of Message
Example: $PUBX,01,205838.60,284099.823,W,4293841.170,N,69.267,G3,2.0,3.6,0.023,173.18,0.0 05,,1.05,2.02,1.28,8,0,0*45
NAL Research Corporation (TN2007-626-V2.0.0) 57
PUBX4 – Time of Day and Clock Information – AT+PA=C
ASCII String Name
Format Example Length Units Description
Message Start string $PUBX 5 Message Header Navstar Proprietary sentences
Message ID character 04 2 Proprietary Message ID
UTC time hhmmss.ss 155727.00 9 hours minutes seconds
00…23 00…59 00.00…59.99
UTC date ddmmyy 020804 6 days months years
UTC Day, Month and Year
UTC TOW numeric 143847.00 varies seconds UTC Time of Week
Week numeric 1282 varies GPS week number continues beyond 1023
Reserved numeric 143847.00 varies Reserved for future use Clk_B numeric 3448979 varies ns Receiver Clock Bias Clk_D numeric -2894.038 varies ns/s Receiver Clock Drift PG numeric 43 varies ns Time Pulse Granularity
Checksum hexadecimal characters
*45
<CR><LF> End of Message
Example: $PUBX,04,155727.00,020804,143847.00,1282,143847.00,3448979,-2894.038,43,*35