Transcript
TN2009-33-V1.0
AT COMMAND REFERENCE FOR MODEL A3LA-XG Version 1.0 May 22, 2009
Copyright © 2009 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 A3LA-XG 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.
TABLE OF CONTENTS
TABLE OF CONTENTS ............................................................................................................ 2 GLOSSARY ............................................................................................................................ 7 1.0 INTRODUCTION ............................................................................................................... 8 2.0 MODEM OVERVIEW .......................................................................................................... 8 2.1 DTE-ISU Interchange Circuits ..................................................................................... 8 2.2 9-Wire and 3-Wire Operation ...................................................................................... 8 2.3 Modes of Operation ................................................................................................... 8 2.4 Ring Indicate Signal .................................................................................................. 9
3.0 AT COMMANDS ................................................................................................................ 9 3.1 Command Entry ....................................................................................................... 9 3.2 Command Responses ................................................................................................ 10
4.0 PHASED IMPLEMENTATION BY SOFTWARE VERSION .......................................................... 11 5.0 PHASE 1 AT COMMANDS .................................................................................................. 11 5.1 +++ – Escape Sequence ........................................................................................... 11 5.2 AT – Attention Code .................................................................................................. 11 5.3 A – Answer .............................................................................................................. 11 5.4 A/ – Repeat Last Command ........................................................................................ 11 5.5 Bn – Communication Standards .................................................................................. 11 5.6 Cn – Carrier Control .................................................................................................. 12 5.7 D – Dial .................................................................................................................. 12 5.8 En – Echo ................................................................................................................ 13 5.9 Fn – Line Modulation ................................................................................................. 13 5.10 Hn – Hangup .......................................................................................................... 13 5.11 In – Identification ................................................................................................... 13 5.12 Ln – Loudspeaker Volume ........................................................................................ 14 5.13 Mn – Speaker Control .............................................................................................. 14 5.14 Nn – Automode Enable ............................................................................................ 14 5.15 On – Online ........................................................................................................... 14 5.16 P – Pulse Dial ......................................................................................................... 14 5.17 Qn – Quiet Mode ..................................................................................................... 14 5.18 S0=n – Auto-Answer ............................................................................................... 14 5.19 T – Tone Dial ......................................................................................................... 14 5.20 Vn – Verbose Mode ................................................................................................. 14 5.21 Wn – Error Correction Message Control ...................................................................... 15 5.22 Xn – Extended Result Codes ..................................................................................... 15 5.23 Yn – Long Space Disconnect ..................................................................................... 15 5.24 Zn – Soft Reset ...................................................................................................... 15 5.25 &Cn – DCD Option .................................................................................................. 15 5.26 &Dn – DTR Option ................................................................................................... 15 5.27 &Fn – Restore Factory Settings ................................................................................. 16 5.28 &Gn – Guard Tone .................................................................................................. 16
NAL Research Corporation (TN2009-33-V1.0)
2
5.29 &Jn – Jack Control .................................................................................................. 16 5.30 &Kn – Flow Control ................................................................................................. 16 5.31 &Ln – Leased Line Operation .................................................................................... 16 5.32 &Mn – Asynchronous/Synchronous Mode .................................................................... 16 5.33 &Pn – Pulse Dial Make/Break Ratio ............................................................................ 17 5.34 &Qn – Sync/Async Mode .......................................................................................... 17 5.35 &Rn – RTS/CTS Option ............................................................................................ 17 5.36 &Sn – DSR Override ................................................................................................ 17 5.37 &V – View Active and Store Configuration ................................................................... 17 5.38 &Wn – Store Active Configuration .............................................................................. 17 5.39 &Xn – Select Synchronous Clock ............................................................................... 17 5.40 &Yn – Designate Default Reset Profile ........................................................................ 17 5.41 \An – MNP Block Size .............................................................................................. 18 5.42 \Bn – Transmit Break .............................................................................................. 18 5.43 \Gn – XON/XOFF Flow Control .................................................................................. 18 5.44 \Jn – DTE Auto Rate ................................................................................................ 18 5.45 \Kn – Control Break ................................................................................................ 18 5.46 \Nn – Link Type ...................................................................................................... 18 5.47 %Cn – Compression Control ..................................................................................... 18 5.48 %En – Auto Retrain ................................................................................................ 18 5.49 %R – Display Registers ............................................................................................ 18 5.50 *F – Flush To EEPROM ............................................................................................. 19 5.51 *Pn – Power Phone ................................................................................................. 19 5.52 *Sn – RF Power State .............................................................................................. 19 5.53 *W – Wait ............................................................................................................. 19 5.54 +CAR – Audio Output Control ................................................................................... 19 5.55 +CBC – Battery Charge ........................................................................................... 20 5.56 +CCLK – Real-Time Clock ........................................................................................ 20 5.57 +CBST – Select Bearer Service Type .......................................................................... 21 5.58 +CCFC – Call Forward Service .................................................................................. 21 5.59 +CCWA – Call Waiting Service .................................................................................. 23 5.60 +CEER – Extended Error Report ................................................................................ 24 5.61 +CHUP – Hangup call .............................................................................................. 24 5.62 +CGMI – Manufacturer Identification ......................................................................... 25 5.63 +CGMM – Model Identification .................................................................................. 25 5.64 +CGMR – Revision .................................................................................................. 25 5.65 +CGSN – Serial Number .......................................................................................... 25 5.66 +CICCID – Read ICC ID from SIM ............................................................................. 25 5.67 +CIER – Indicator Event Reporting ............................................................................ 25 5.68 +CLCC – Request Current Call Status ........................................................................ 26 5.69 +CLCK – Facility Lock .............................................................................................. 27 5.70 +CLIP – Calling Line Identification Presentation ........................................................... 29 5.71 +CLIR – Calling Line Identification Restriction ............................................................. 29 5.72 +CLVL – Loudspeaker Volume Level Control ............................................................... 30 5.73 +CMUT – Mute Control ............................................................................................ 30 5.74 +CMGD – Delete SMS Message ................................................................................. 31 5.75 +CMGF – SMS Message Format ................................................................................. 32 5.76 +CMGL – List SMS Messages .................................................................................... 33 5.77 +CMGR – Read SMS Messages .................................................................................. 33
NAL Research Corporation (TN2009-33-V1.0)
3
5.78 +CMGS – Send SMS Messages .................................................................................. 34 5.79 +CMGW – Write SMS Messages To Memory ................................................................ 34 5.80 +CMEE – Report Mobile Equipment ............................................................................ 34 5.81 +CMOD – Call Mode ................................................................................................ 36 5.82 +CNMI – New SMS Message Indications to DTE ........................................................... 36 5.83 +CNUM – Read MSISDN Numbers ............................................................................. 37 5.84 +COPS – Operator Select ......................................................................................... 38 5.85 +CPAS – Phone Activity Status ................................................................................. 39 5.86 +CPBF – Find phonebook entries ............................................................................... 39 5.87 +CPBR – Read phonebook entries ............................................................................. 39 5.88 +CPBS – Select phonebook storage ........................................................................... 40 5.89 +CPBW – Write phonebook entry .............................................................................. 40 5.90 +CPIN – Enter PIN .................................................................................................. 41 5.91 +CPMS – Select Preferred SMS Storage ...................................................................... 41 5.92 +CPWD – Change Password ..................................................................................... 42 5.93 +CR – Service Reporting Control ............................................................................... 42 5.94 +CRC – Cellular Result Codes ................................................................................... 43 5.95 +CREG – Network Registration ................................................................................. 43 5.96 +CRIS – Ring Indication Status ................................................................................. 44 5.97 +CSCA – SMS Service Center Address ....................................................................... 44 5.98 +CSCB – Select Cell Broadcast Message Types ............................................................ 44 5.99 +CSCS – Select TE Character Set .............................................................................. 45 5.100 +CSDT – Sidetone ................................................................................................. 45 5.101 +CSMS – Select SMS Message Service ..................................................................... 45 5.102 +CSQ[F] – Signal Quality ....................................................................................... 46 5.103 +CSTA – Select Type of Address ............................................................................. 46 5.104 +CULK – Unlock .................................................................................................... 47 5.105 +CVHU – Voice Hangup Control ............................................................................... 47 5.106 +CVMI – Voicemail Indication ................................................................................. 48 5.107 +DS – Set Data Compression Function ..................................................................... 48 5.108 +DR – Data Compression Report Level ..................................................................... 49 5.109 +GMI – Manufacturer Identification ......................................................................... 49 5.110 +GMM – Model Identification .................................................................................. 49 5.111 +GMR – Revision .................................................................................................. 49 5.112 +GCAP – General Capabilities ................................................................................. 49 5.113 +GSN – Serial Number .......................................................................................... 50 5.114 +IPR – Fixed DTE Rate ........................................................................................... 50 5.115 +PA – GPS: List of NMEA message formats ............................................................... 50 5.116 +PD – GPS: UTC Date ............................................................................................ 51 5.117 +PG – GPS: GPS Automatically Sent ........................................................................ 51 5.118 +PL – GPS: Display Position to 4th Decimal Place ....................................................... 52 5.119 +PLOC – GPS: Display Position to 5th Decimal Place ................................................... 52 5.120 +PSIX[A] – GPS: Initiate SBD Session Utilizing GPS ................................................... 53 5.121 +PSREG – GPS: Network Registration Utilizing GPS .................................................... 55 5.122 +PT – GPS: UTC Time ............................................................................................ 56 5.123 +PV – GPS: Basic GPS Velocity ............................................................................... 56 5.124 +PVEL – GPS: GPS Velocity .................................................................................... 57 5.125 +SBDAREG – Short Burst Data: Automatic Registration .............................................. 57 5.126 +SBDC – Short Burst Data: Clear SBD MOMSN .......................................................... 59
NAL Research Corporation (TN2009-33-V1.0)
4
5.127 +SBDD – Short Burst Data: Clear SBD Message Buffer(s) ........................................... 59 5.128 +SBDDET – Short Burst Data: Detach ...................................................................... 59 5.129 +SBDDSC – Short Burst Data: Delivery Short Code .................................................... 60 5.130 +SBDI – Short Burst Data: Initiate an SBD Session ................................................... 60 5.131 +SBDMTA – Short Burst Data: Mobile-Terminated Alert .............................................. 61 5.132 +SBDIX[A] – Short Burst Data: Initiate an SBD Session Extended ............................... 62 5.133 +SBDRB – Short Burst Data: Read Binary Data from the ISU ...................................... 64 5.134 +SBDREG – Short Burst Data: Network Registration .................................................. 65 5.135 +SBDRT – Short Burst Data: Read a Text Message from the ISU ................................. 66 5.136 +SBDS – Short Burst Data: Status .......................................................................... 67 5.137 +SBDSX – Short Burst Data: Status Extended ........................................................... 67 5.138 +SBDTC – Short Burst Data: Transfer MO Buffer to MT Buffer ..................................... 68 5.139 +SBDWB – Short Burst Data: Write Binary Data to ISU .............................................. 68 5.140 +SBDWT – Short Burst Data: Write a Text Message to the ISU .................................... 69 5.141 +WDAV – Register or Deregister an RS232 DAV Data Peripheral .................................. 70 5.142 +WDLDM – IRLP Dynamic Link Delay Measurement .................................................... 70 5.143 +WFRNG – Force IRLP Renegotiation ....................................................................... 71 5.144 +WIRLP – Iridium Radio Link Protocol ...................................................................... 71 5.145 +WTM – IRLP Test ................................................................................................ 72 5.146 –MSVTS – DTMF Generation in Voice Call .................................................................. 73 5.147 –MSVTR – DTMF Received in Voice Call .................................................................... 73 5.148 –MSVLS – Local DTMF Feedback Selection ................................................................ 74 5.149 –MSSTM – Request System Time ............................................................................. 74 5.150 –MSGEO – Request Geolocation .............................................................................. 75 5.151 ^CCOP – Change Crypto Officer Password (Encryption) .............................................. 75 5.152 ^CMGEC – Clears all of the SMS messages ............................................................... 75 5.153 ^KD – Key for Decryption (Encryption) ..................................................................... 76 5.154 ^KE – Key for Encryption (Encryption) ..................................................................... 76 5.155 ^KZ – Key Zeroization (Encryption) ......................................................................... 76 5.156 ^MODRSTn – Modem Reset Information Message Displayed ....................................... 77 5.157 ^MPTDC – Modem Power Toggle Data Connection ..................................................... 77 5.158 ^MPTFP – Modem Power Toggle Forced Power-cycle .................................................. 77 5.159 ^MPTFR – Modem Power Toggle Forced Registration ................................................. 77 5.160 ^MPTNC – Modem Power Toggle Not in Data Connection ............................................ 78 5.161 ^MSA - Motion Sensor Awakes (Revised) ................................................................. 78 5.162 ^MSB – Motion Sensor Begin ................................................................................. 79 5.163 ^PKTS – Packet Transmit ...................................................................................... 79 5.164 ^PKTST – Packet Send Timeout ............................................................................. 79 5.165 ^PKTRT – Packet Reset Timeout ............................................................................. 79 5.166 ^PKTTH – Packet Threshold Size ............................................................................ 80 5.167 ^RESETMODEMTG – Reset Modem Toggle ............................................................... 80 5.168 ^RESETMODEMVF – Reset Modem Verify ................................................................. 80 5.169 ^STR – Self Test Run (Encryption) .......................................................................... 80 5.170 ^UE – Use Encryption (Encryption) .......................................................................... 80 5.171 ^USMSE – Use SMS Encryption (Encryption) ............................................................. 81 6.0 S-REGISTER DEFINITIONS ................................................................................................. 82 6.1 S-Register Commands ............................................................................................... 82 6.2 Sr – Direct S-Register Reference ................................................................................. 82
NAL Research Corporation (TN2009-33-V1.0)
5
6.3 Sr? – Direct S-Register Read ...................................................................................... 82 6.4 Sr=n – Direct S-Register Write ................................................................................... 82 6.5 Referenced S-Register Read ....................................................................................... 82 6.6 Referenced S-Register Write ....................................................................................... 82 6.7 Standard S-Registers ................................................................................................ 83 6.8 Iridium Specific S-Register Extensions ......................................................................... 85
7.0 SUMMARY OF RESULT CODES .......................................................................................... 82 8.0 INFORMATION EXAMPLES ................................................................................................ 83 8.1 Sending an SBD Message to the ISU ............................................................................ 83 8.2 Field Elements of an SBD Message (Commercial Gateway Only) ...................................... 83
APPENDIX A – ENCRYPTED SBD SENDING WITH NO RECEIVING ............................................... 85 APPENDIX b – NMEA MESSAGE FORMATS ............................................................................... 90
NAL Research Corporation (TN2009-33-V1.0)
6
GLOSSARY BCD
Binary Coded Decimal
CI
Cell Identifier
CTS
Clear To Send
DCD
Data Carrier Detect
DCE
Data Communications Equipment
DSR
Data Set Ready
DTE
Data Terminal Equipment
ESS
ETC SBD Subsystem (Synonymous with GSS)
ETC
Earth Terminal Controller
ETSI
European Telecommunications Standards Institute
FA
Field Application
GND
Ground
GSS
Gateway SBD Subsystem (Synonymous with ESS)
GSM
Global System for Mobile Communications
IMEI
International Mobile Equipment Identity
IRLP
Iridium Radio Link Protocol
ISU
Individual Subscriber Unit (A3LA-XG)
LAC
Location Area Code
LBT
L-Band Transceiver
MO
Mobile Originated
MOMSN
Mobile Originated Message Sequence Number
MT
Mobile Terminated
MTMSN
Mobile Terminated Message Sequence Number
NMEA
National Marine Electronics Association
RI
Ring Indicator
RP
Relay Protocol
RTS
Request To Send
Rx
Data line from DCE to DTE
SBD
Short Burst Data
SMS
SMS Short Message Service
SMSSC
Short Message Service – Service Centre
TP
Transfer Protocol
Tx
Data line from DTE to DCE
UART
Universal Asynchronous Receiver Transmitter
UTC
Universal Time Coordinated
NAL Research Corporation (TN2009-33-V1.0)
7
1.0 INTRODUCTION This document is intended as a reference guide to the usage of AT command set for the A3LA-XG Iridium satellite modem. The terms ISU and A3LA-XG are used interchangeably. Note that AT commands may be periodically modified, removed or added and, therefore, 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).
2.0 MODEM OVERVIEW 2.1 DTE-ISU Interchange Circuits The communication between the ISU (Iridium Subscriber Unit) and the DTE (Data Terminal Equipment) was made to be similar to the 9522B unit which follows the ITU-T V.24 (RS-232) recommendation. 2.2 9-Wire and 3-Wire Operation The ISU supports a full 9-wire interface to the DTE, incorporating hardware handshaking and flow control. A 3-wire DTE interface, where only transmit, receive, and ground signals are used, is supported in those ISUs where the AT&D0 command has been revised to ignore the DTR (Data Terminal Ready) signal. When operating with a 3-wire connection, the following limitations apply: AT&Dn must be set to AT&D0 to ignore the DTR input from the DTE, as it will not be present as an input from the DTE. AT&Kn must be set to AT&K0 for no flow control or AT&K4 for XON/XOFF software flow control, as RTS (Request To Send) and CTS (Clear To Send) hardware flow control signals will not be present. AT&Cn setting will have no effect, as DCD (Data Carrier Detect) output to the DTE will not be present. AT&Sn setting will have no effect, as DSR (Data Set Ready) output to the DTE will not be present. RI (Ring Indicate) output to the DTE will not be present. 2.3 Modes of Operation An ISU is always in one of two modes—command or data mode. In data mode, an ISU can send data in either normal or packet send mode. An ISU transmits data in packet send mode when encryption is enabled. The ISU does not support encryption in voice calls. All voice calls are made in the ‗clear‘ unless an external encryption module is hooked to it such as the General Dynamics® Sectéra. Packet send mode is NAL Research‘s proprietary format and is implemented to handle AES-256 bit frame synchronization between the ISU and a connected device. The encryption and decryption keys are matched in each frame to ensure NIST FIPS 140-2 compliance. The encryption algorithm implemented into the ISU complies with NIST FIPS 140-2 as defined in the following documents: 1.
Security Requirements for Cryptographic Modules, FIPS PUB 140-2, US Department of Commerce, National Institute of Standards and Technology, May 25th, 2001.
2.
Security Requirements for Cryptographic Modules, Annex A: Approved Security Functions for FIPS PUB 140-2, US Department of Commerce, National Institute of Standards and Technology, February 19th, 2003
When the ISU is in command mode, AT commands can be entered. Command mode can be accessed while on-hook (i.e. not in a call) or in-call. When in data mode, an ISU is connected to a remote system and any characters sent to it will be transmitted to the remote system. Data mode can be only accessed while
NAL Research Corporation (TN2009-33-V1.0)
8
in-call. If in packet send mode an ISU uses packets to send and receive data from the remote system. To use packet send mode you need to have either another ISU on the remote system or the Server for Trackers program with either a standard modem or a RUDICS connection. While in-call, the escape sequence (+++) is used to enter the command mode. The Online command (ATOn) is used to return to the data mode. These mode transitions are made without terminating the call. In packet send mode the +++ sequence escapes to a command mode that only allows the command ATH and AT+CHUP to hang up the call. 2.4 Ring Indicate Signal The standard RI (Ring Indicate) signal is used to indicate the presence of an incoming telephony call. However, on an ISU it is also used to indicate reception of an SBD Ring Alert. It is accompanied by the unsolicited announcements RING or SBDRING. In the case of an incoming telephony call, which may be a voice, data or fax call, the RI signal is active for as long as the call is offered. The RI signal is deactivated when the call is answered or when it is no longer offered (e.g. the originator terminates the call before it is answered). A RING announcement is issued if the DTE interface is in command mode. In the case of an SBD ring alert, which indicates that there is at least one SBD message at the gateway awaiting collection, provided that SBD ring alerts are enabled (see +SBDMTA), the RI signal is activated on reception of the SBD ring alert. It is held active for a period of 5 seconds from reception of the SBD ring alert, or until the DTE initiates an SBD session to retrieve the waiting message, whichever occurs first. An SBDRING announcement is issued if the DTE interface is in command mode, or when it next returns to command mode. If an ISU receives an SBD ring alert at the same time as an incoming telephony call, the RI signal combines both of the above behaviors, remaining active as long as required by either the telephony or SBD criteria. The +CRIS command may be used to query the ISU as to the reason for the most recent assertion of the RI signal.
3.0 AT COMMANDS An AT command is a string of characters sent by a DTE to an ISU while the ISU is in Command mode. During Tracking mode, the only AT command accepted by an ISU is a sequence of three pluses (+++). All other commands are ignored. An AT command string has a prefix, a body, and a terminator. The prefix consists of the ASCII upper case characters AT or lower case characters at. The body is a string of commands restricted to printable ASCII characters. The terminator is the carriage return
character. 3.1 Command Entry AT command syntax is critical and the following rules apply: All commands (apart from A/ and +++) begin with the prefix of AT or at. The commands in a command string (apart from A/ and +++) are executed only after the return or enter key is pressed. The maximum number of characters in a command string is 128. If the numeric parameter n is omitted from the basic command entry, a value of zero is assumed for n.
NAL Research Corporation (TN2009-33-V1.0)
9
If an optional parameter is omitted from an extended command, the current value is implied. Optional parameters are enclosed by square brackets ([…]) in this document. Multiple commands can be concatenated into a single command line by separating the additional non-prefixed commands with a space or a semicolon or with no separator. Spaces entered into a command string for clarity between the AT prefix and the body of the command are ignored. Likewise, spaces entered for clarity within the command body between alpha characters and decimal parameters are ignored. Backspace can be used to edit AT commands. The single quotes (‗) are used to enclose sensitive information such as passwords. When an entry is enclosed by the single quotes and the ISU is set to echo, the entry is replaced with asterisks (*) instead of the actual value. For the commands requiring the Crypto Officer Password or the ^ID command, all characters values may be entered. For passwords containing the single quote (‗), a backslash must be entered in front of it. Similarly, for passwords containing a backslash (\), an additional backslash must be entered in front of it as well. For example the password Qt3&\v‘3 would be entered as ‗Qt3&\\v\‘3‘. If underscore (_) is used in the ID field, it will appear as spaces in NAL Research‘s provided PC software because of backwards compatibility issues with the A3LA-DGS and the A3LA-TSS. For the ^ID command with the static identifiers containing the double quote (―), they must be entered with a backslash (\) in front of it. For static identifiers containing a backslash (\), an additional backslash must be entered in front of it as well. For example, for static identifier The ―fast‖ ship\boat would be entered as ―The \‖fast\‖ ship\\boat‖. All entries with \\, \‘ and \‖ are treated as single character in length. Characters that proceed the AT prefix are ignored. CTRL-X will abort a command line input. NOTE: The restriction of not allowing upper and lower case letters in a command string was dropped so all NAL Research‘s ISUs will work in a similar manner as the 9522B. 3.2 Command Responses A result code is sent to the DTE by an ISU in response to the execution of an AT command. It may also occur unsolicited from other conditions such as an SBDRING alert. Responses returned as a result of a query are called information responses. Result codes can be represented by text if an ISU is in verbose mode or with numbers if in numeric mode. The command ATVn informs an ISU whether to respond in verbose or numeric mode. Responses can be suppressed by setting the command ATQn to ATQ1. The table below shows the difference in format between these modes. Numeric Mode
Verbose Mode
ATQ0 ATV0
ATQ0 ATV1
Result codes
Information Responses
NAL Research Corporation (TN2009-33-V1.0)
10
Invalid input for certain types of commands will cause an ISU to return a short description of failure before returning the information response and error message. Command entries to an ISU with invalid syntax typically cause the ISU to respond with an ERROR. Command entries of valid syntax with an out-ofrange parameter can cause an ISU to respond in one of the three ways: Disallow out-of-range entry and respond with ERROR Disallow out-of-range entry and respond with OK Disallow out-of-range entry, accept the closest in-range value, and respond with OK.
4.0 PHASED IMPLEMENTATION BY SOFTWARE VERSION NAL Research continues to improve and add capabilities to our modems and trackers. Therefore, the AT command manual should be treated as a ―living document‖ and is expected to expand in future versions. ―Phased Release‖ is an approach NAL Research implements to release all future AT commands set. Minor error corrections will be released by increasing the sub-version number; e.g. Version 1.X.X. Major improvements and added capabilities will be released by increasing the version number; e.g. Version X.0.0. Whenever a version number is incremented, a new ―Phase‖ is incremented and assigned to that particular version. For example, the first AT command manual release has Version 1.0.0 and is called Phase 1. If the 3rd number is left off then all version beginning with the first 2 numbers are referred to. Some of the AT commands were just included for compatibility with other modems like the 9522B and just accept the commands and return OK. These commands are noted below.
5.0 PHASE 1 AT COMMANDS The following list specifies the AT commands in Phase 1. 5.1 +++ – Escape Tracking Mode The escape sequence is used to transfer from in-call data mode to in-call command mode without disconnecting from the remote modem. After a pause, the ISU will respond with OK. If packets are being used during the call then the escape will escape to a command mode that only allows the ATH and the AT+CHUP commands. If any other command is sent it will go back to data mode. The purpose of this is so when packet send mode is used with encryption the rule may be followed that whenever the CD line is high only encrypted packets are sent over the link. 5.2 AT – ATtention Code This is the prefix for all commands except A/ and +++. When entered by itself, the ISU will respond with OK. 5.3 A – Answer Answer immediately. This causes the ISU to answer the incoming data or voice call. 5.4 A/ – Repeat Last Command Repeat the last command issued to an ISU unless power was interrupted or the ISU is reset. A/ is not followed by . 5.5 Bn – Communication Standards Select the communications standard to be used for the data calls. No action, compatibility only.
NAL Research Corporation (TN2009-33-V1.0)
11
Any value for n accepted. 5.6 Cn – Carrier Control Control carrier detection. No action, compatibility only. Only n = 1 accepted. 5.7 D – Dial Dial a data or voice call number. The dial command causes the ISU to enter originate mode and act as auto dialer for connection to other modems or voice lines. The usual format is ATDnx..x where n is a dial modifier and x is a number. The following are valid numbers: 0123456789*#ABC. Dial modifiers are used to alter the manner in which the ISU dials. L
Redial last number
P
Use pulse dialing No action, compatibility only
T
Use tone dialing No action, compatibility only
+
International dialing prefix. Allows the international access code to be omitted from dial string.
>
Direct dial from phonebook locations. See subsection below for further details.
;
Start up a voice call. This modifier should be given after the dialing digits (or modifiers).
Any character received from the DTE during the call establishment phase will cause the call attempted to be terminated. The L command works slightly different on the NAL Research‘s ISUs than on the 9522B modem. On the NAL Research‘s ISUs, it includes all prefixes again as well as showing the direct dial in the same format it was entered. For instance, if the dial number is entered with the +, the NAL Research‘s ISUs will also use the + on the redial while the 9522B will not. Direct Dial From Phonebook: The ISU and SIM contain phonebooks which have a phone number and an alphanumeric field for each phonebook entry location. The use of V.25ter dialing command ensures that direct dialing from phone memory and SIM phonebook is possible through ordinary communications software which just gives the phone number field to be filled and then use the D command to originate the call. Available memories may be queried with Select Phonebook Storage test command +CPBS=?, and location range for example with Read Phonebook Entries test command +CPBR=?. Exec Commands D>[;] Originate call to phone number which corresponding alphanumeric field is (if possible, all available memories should be searched for the correct entry). is of string type value and should enclosed by ―― (e.g., ―John‖).
NAL Research Corporation (TN2009-33-V1.0)
12
D> mem[;] Originate call to phone number in memory mem entry location (available memories may be queried with Select Phonebook Storage test command +CPBS=?). mem can be one of the following: FD
SIM fixed dialing phonebook
LD
Last ten calls dialed phonebook
ME
Phone memory
MT
combined phone and SIM phonebook locations
SM
SIM phonebook
D>[;] Originate call to phone number in entry location (the command Select Phonebook Memory Storage +CPBS setting determines which phonebook storage is used). 5.8 En – Echo Echo command characters to DTE. 0
Characters are not echoed to the DTE
1
Characters are echoed to the DTE (default)
5.9 Fn – Line Modulation Select line modulation standard. No action, compatibility only. Allowed values for n are 0, 1,3, 4, 5, 6, 7, 8, 9 and 10. 5.10 Hn – Hangup Control the hook switch. This command is used to clear a data call connection. It is also used to clear a voice call connection when the ISU has originated the voice call with the ATD dial command or terminated the voice call with the ATA or ATS0=n answer command. 0 Place the ISU on hook. 5.11 In – Identification Request the ISU 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 of micro-controller/GPS) then on the next line ―XXXXXXXX‖ (software revision level of 9522B RF board)
4
―NAL Research Corporation product description‖
5
―8816‖ (Country Code)
6
―XXX‖ (RF board factory identity)
7
―XXXXXXXX‖ (RF board hardware specification)
NAL Research Corporation (TN2009-33-V1.0)
13
5.12 Ln – Loudspeaker Volume Set the loudspeaker volume according to the parameter supplied. No action, compatibility only. Allowed values for n are 0, 1, 2, and 3. 5.13 Mn – Speaker Control Command is for selecting when the speaker will be on or off. This unit does not have a speaker. No action, compatibility only. Allowed values for n are 0, 1, 2, and 3. 5.14 Nn – Automode Enable Enable or disable automode detection. No action, compatibility only. Any value for n is accepted. 5.15 On – Online Enter in-call data mode. This is used to return to in-call data mode from in-call command mode using an existing connection. An error is reported if on-hook. When in a packet send mode although it is not searching for this command any command besides ATH or AT+CHUP will return to the data call. 0
Switch from in-call command mode to in-call data mode. No action, compatibility only. Any value for n is accepted.
5.16 P – Pulse Dial Set pulse dial. No action, compatibility only. 5.17 Qn – Quiet Mode Control the ISU responses to DTE. 0
ISU responses are sent to the DTE (default)
1
ISU responses are NOT sent to the DTE
5.18 S0=n – Auto-Answer Auto-answer. This causes the ISU to auto-answer the incoming data or voice call. 0
Disable auto-answer
n>0
Enable auto-answer after n rings
5.19 T – Tone Dial Set tone dial. No action, compatibility only. 5.20 Vn – Verbose Mode Set the response format of the ISU, which may be either numeric or textual. 0
Numeric responses
1
Textual responses (default)
NAL Research Corporation (TN2009-33-V1.0)
14
5.21 Wn – Error Correction Message Control Set the response format of the ISU during a data connection. Upon connection, the ISU will always report the DTE speed. No action, compatibility only. Allowed values for n are 0, 1 and 2. 5.22 Xn – Extended Result Codes Select the response set to be used by the ISU when informing the DTE of the results of a command or data or voice call. 0
OK, CONNECT, RING, NO CARRIER, NO ANSWER and ERROR.
1
As X0 plus CONNECT x, where x is the DTE speed. CONNECT x response is used for data calls only.
2
As X1 plus NO DIALTONE.
3
As X2 plus BUSY.
4
Same as 3.
NOTE: CONNECT response is used to inform of a data call connection; OK response is used to inform of a voice call connection. DAV connections start out as a voice call and will produce an OK response followed by a CONNECT response when the call automatically transitions to data mode. 5.23 Yn – Long Space Disconnect Enable or disable the generation and response to long space disconnect. No action, compatibility only. Allowed values for n is accepted. 5.24 Zn – Soft Reset Soft reset the ISU‘s active operating profile to a user-defined operating profile that has been previously stored using &Wn. The active operating profile will revert back to the user-defined operating profile designated under the &Yn command at power reset. 0
Restores user-defined operating profile 0
1
Restores user-defined operating profile 1
5.25 &Cn – DCD Option Select how the ISU controls the DCD behavior. DCD always indicates the connection status. No action, compatibility only. Allowed values for n are 0 and 1. 5.26 &Dn – DTR Option Set the ISU reaction to DTR signal. 0
DTR is ignored in all modes. A DTR signal input is not needed when set to &D0. For all other &Dn settings, the following applies. DTR must be ON during on-hook command mode. If DTR transitions from ON to OFF during on-hook command mode, operation will be locked after approximately 10 seconds. On-hook command mode operation will resume when DTR is restored ON. DTR must be ON at call
NAL Research Corporation (TN2009-33-V1.0)
15
connection DTR must be ON during both in-call command mode and in-call data mode. Reaction to DTR ON to OFF transitions during in-call command mode and incall data mode is determined by the &Dn setting as shown below. Note that the +CVHU command can be set to override these specified reactions. 1
If DTR transitions from ON to OFF during in-call command mode, and DTR is restored ON within approximately 10 seconds, the call will remain up. If DTR is not restored ON within approximately 10 seconds, the call will drop to on-hook command mode. If DTR transitions from ON to OFF during in-call data mode, the mode will change to in-call command mode. If DTR is restored ON within approximately 10 seconds, the call will remain up. If DTR is not restored ON within approximately 10 seconds, the call will drop to on-hook command mode.
2
If DTR transitions from ON to OFF during either in-call command mode or in-call data mode, the call will drop to on-hook command mode (default).
5.27 &Fn – Restore Factory Settings Soft reset an ISU‘s active operating profile to factory-default operating profile. The active operating profile will revert back to the user-defined operating profile designated under the &Yn command at power reset. This does not reset encryption/decryption keys or the crypto officer password. 0
Recall factory-default operating profile
5.28 &Gn – Guard Tone Enable or disable the generation and response to long space disconnect. No action, compatibility only. Allowed values for n is accepted. 5.29 &Jn – Jack Control Enable or disable the generation and response to long space disconnect. No action, compatibility only. Allowed values for n is accepted. 5.30 &Kn – Flow Control Select the flow control method between the ISU and DTE 0
Disables flow control.
3
Enabled RTS/CTS flow control (default).
5.31 &Ln – Leased Line Operation Request leased line or dial-up operation. No action, compatibility only. Allowed values for n is accepted. 5.32 &Mn – Asynchronous/Synchronous Mode Select the DTR operating mode. 0
Selects normal asynchronous operation (default).
NAL Research Corporation (TN2009-33-V1.0)
16
5.33 &Pn – Pulse Dial Make/Break Ration Select the make/break ratio during pulse dialing. No action, compatibility only. Allowed values for n are 0, 1, 2 and 3. 5.34 &Qn – Sync/Aus Mode Select asynchronous mode. This is an extension of the &M command and is used to control the connection modes permitted. NOTE: The register is not updated right after the user requests new values because the requested values may or may not be what IRLP will use once a data call is established due to negotiations with the other peer. If the register is updated right away, this may give the user the impression that those values will be used during the data call, but there is no guarantee that will be the case. The real values will only be known once a data call is established and the negotiation phase is done. For that reason, the values are written to the register only after a call is established and both sides have negotiated parameter values (such as mode of operation). The value of the register will be reset to default value (5) after the call completed. the DTR operating mode. 0,6
Normal asynchronous operation with no error correction (unacknowledged mode).
5
Asynchronous operation with error correction (acknowledged mode) (default)
5.35 &Rn – RTS/CTS Option Select how the ISU controls CTS. No action, compatibility only. Allowed values for n are 0 and 1. 5.36 &Sn – DSR Override Define the behavior of DSR. 0
DSR always active (default).
1
Same as 0.
5.37 &V – View Active and Stored Configurations View the current active operating profile and stored operating profiles. 5.38 &Wn – Store Active Configuration Store the current active operating profile as user-defined operating profile in non-volatile memory for later use. 0
Store current (active) configuration profile as user-defined operating profile 0
1
Store current (active) configuration profile as user-defined operating profile 1
5.39 &Xn – Select Synchronous Clock Select the transmit clock for synchronous mode of operation. No action, compatibility only. Allowed values for n is accepted. 5.40 &Yn – Designate Default Reset Profile Select user-defined operating profile for use after power-up.
NAL Research Corporation (TN2009-33-V1.0)
17
0
Select user-defined operating profile 0 (default)
1
Select user-defined operating profile 1
NOTE: The ISU is factory-set to have the user-defined operating profile 0 as the factory-default operating profile. 5.41 \An – MNP Block Size Select maximum MNP block size. No action, compatibility only. 5.42 \Bn – Transmit Break Transmit break to remote. In non-error correction mode, the ISU will transmit a break signal to the remote modem with a length in multiples of 100 ms according to the parameter specified. Values for n are 1-9. No action, compatibility only. 5.43 \Gn – XON/XOFF Flow Control Set the use of XON/OFF flow control in normal mode. No action, compatibility only. 5.44 \Jn – DTE Auto Rate Enable DTE auto rate adjustment. No action, compatibility only. 5.45 \Kn – Control Break Control the response of the ISU to a break received from the DTE or the remote modem according to the parameter specified. The response is different in 3 different states. No action, compatibility only. Allowed values for n are 0, 1, 2, 3, 4 and 5. 5.46 \Nn – Link Type Enable DTE auto rate adjustment. No action, compatibility only. 5.47 %Cn – Compression Control Enable/disable data compression. Data compression can only be performed on an error corrected link (i.e., acknowledged mode). No action, compatibility only. 5.48 %En – Auto Retrain Enable/disable auto retrain. No action, compatibility only. Allowed values for n are 0, 1 and 2. 5.49 %Rn – Display Registers Display all the S registers in the system.
NAL Research Corporation (TN2009-33-V1.0)
18
5.50 *F – Flush To EEPROM (for compatibility only) On the standard 9601 this flushes all pending writes to EEPROM, shuts down the RF board or radio, and prepares the unit 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. On the NAL Research‘s ISUs this command does not do anything but only returns a success response. 5.51 *Pn – Power Phone Turn ISU off. If the unit should permanently be turned off then disable the relevant commands beginning with ^MPT before beginning this command. 0
Turn phone OFF.
5.52 *Sn – L-Band Transceiver On/Off Control state of the LBT. 0
LBT power is off
1
LBT power is on
When the Iridium RF board is OFF, only commands associated with the ISU will work. For this command n must be 0 or 1. 1 will be assumed if n is left off. This is not stored in a configuration and always begins in the on state when power is applied. Read Command: *S? Query the current LBT setting. The response is in the form: 5.53 *W=m,s – Wait Exec Command: *W=,, This puts the ISU/tracker into a sleep state for minutes and seconds. During this off time, the ISU/tracker can only be awoken by a change to Test or Emergency modes or if enabled by , motion detected on the motion sensor. The ^MPT commands will not work during the sleep state. : Whether the motion sensor will wake the unit up from sleep mode. ‗1‘ is wakes up and ‗0‘ is let sleep. : Number of minutes to wait. Valid values are between 0 and 99. : Number of seconds to wait. Valid values are between 0 and 59. NOTE: If and are both 0 an ERROR will be returned. Command Response: This will return OK, the ISU/tracker will go into Sleep mode, and nothing else will be returned. Test Command: *W=? Returns a fixed message indicating the range of acceptable values. NOTE: Since the active profile is not started over a sleep period the ISU/tracker will revert back to the stored profile when it wakes up. 5.54 +CAR – Audio Output Control Set Command: +CAR=
NAL Research Corporation (TN2009-33-V1.0)
19
This command switches the type of audio output between analog, digital and mute (no audio output). Valid values for are as follows: 0
mute
1
analog
2
digital
Read Command: +CAR? This command queries the current audio settings. Response is in the form: +CAR: Test Command: +CAR=? This command lists the supported values of . Response is in the form: +CAR: (list of supported values of ) 5.55 +CBC – Battery Charge Exec Command: +CBC This command is for compatibility only since the ISU does not have an internal battery that is measured by these responses. Execution command returns the battery connection status and battery charge level of the phone. The response is in the form: +CBC: , where : 000
ISU is powered by the battery.
001
ISU has a battery connected, but is not powered by it.
002
ISU does not have a battery connected.
003
Recognized power fault, calls inhibited.
and : 000
Equivalent to 0 bars displayed on the ISU battery charge indicator, or the ISU does not have a battery connected.
001
Equivalent to 1 bar displayed on the ISU battery charge indicator.
002
Equivalent to 2 bars displayed on the ISU battery charge indicator.
003
Equivalent to 3 bars displayed on the ISU battery charge indicator.
Test Command: +CBC=? Test command returns the values for and supported by the ISU. Response is in the form: +CBC: (list of supported s),(list of supported s) 5.56 +CCLK – Real-Time Clock Exec Command: +CCLK=[