CDMA-C1 AT Commands AT Commands Reference Guide
Copyright and Technical Support CDMA C1 AT Commands Reference Guide This Command Set Applies to the Following Products: SocketModem® Cell (MTSMC-C1, MTSMC-C1-V) MultiModem® iCell (MTSMC-C1-IP) MultiModem® iCell (MTCMR-C1) MultiModem® rCell (MTCBA-C1-EN2) MultiModem® CDMA C1X (MTCBA-C1X-xx) Product Number S000478C Copyright This publication may not be reproduced, in whole or in part, without prior expressed written permission from MultiTech Systems, Inc. All rights reserved.
Table of Contents Contents Chapter 1 – Introduction ............................................................................................................................................ 7 Scope of This Document......................................................................................................................................... 7 Related References .......................................................................................................................................
Table of Contents Chapter 9 – Call Control Commands ..................................................................................................................... 33 Dial Command D .................................................................................................................................................. 33 Hang-Up Command H ........................................................................................................................................
Table of Contents Chapter 13 – OMA / DM Control Commands ......................................................................................................... 64 Wavecom Device Services Session +WDSS ..................................................................................................... 64 Wavecom Device Services Error +WDSE .......................................................................................................... 64 Wavecom Device Services Reply +WDSR .....................
Table of Contents Service Status Unsolicited Response 2 +WIPACCEPT ................................................................................... 102 Service Status Unsolicited Response 3 +WIPERROR ..................................................................................... 103 Last Socket Error Query +WIPERR .................................................................................................................. 103 Socket Data Exchange +WIPDATA ......................................
Chapter 1 – Introduction Chapter 1 – Introduction The AT command set is one of the main interfaces for the modem to interact with an external application layer. CDMA AT commands are defined in TIA/EIA/IS707.3. However, as the wireless applications increase, TIA/EIA/IS707.3 is not sufficient. In addition, a lot of GSM applications already exist and GSM customers would like to maintain the same interface in order to make no or minimum changes to the applications to be used with CDMA modem.
Chapter 2 – AT Commands Overview Chapter 2 – AT Commands Overview Serial Interface Settings A modem serial interface is set with the following default values (factory settings): 115,200bps 8 bits data 1 stop bit no parity RTS/CTS flow control. Note: Some models may have a different value for the default baud rate. The +IPR, +IFC and +ICF commands can be used to change these settings, if required.
Chapter 2 – AT Commands Overview Command Types Terminology Used to Describe AT Command Communication Term Definition This is referred to as a command from the host application to modem with a AT Command request to perform a service. This is an immediate response to a command, informing the host application Result Code whether the execution of the command succeeded or failed. The strings “OK” or “ERROR” are the only two Result Codes available.
Chapter 2 – AT Commands Overview Input Command Syntax A command line is made up of the following three elements: the prefix, the body, and the termination character. AT+WSCI=1 In the example above, AT is the prefix. The modem expects all commands to begin with the letters “AT” or “at”. If the host application inadvertently begins a command with characters other than “AT” or “at”, the modem will ignore the characters and will not echo them.
Chapter 2 – AT Commands Overview Unsolicited Message Syntax The modem can notify the application of events as they occur. There are two types of unsolicited messages: those that the modem will always report and those that are optional. The format for unsolicited messages is: +WIND: 4 As a general rule, unsolicited messages are not embedded in an AT command response.
Chapter 3 – General Commands Chapter 3 - General Commands Provides detailed descriptions of the AT commands supported by CDMA C1 modems. The functionality and syntax as well as expected result codes and responses are documented for each command. Attention AT Description: This two-character command prefix is used to alert the modem software that a command has been entered for processing. This prefix must be included in all commands unless otherwise noted.
Chapter 3 – General Commands Enable/Disable Individual Unsolicited Message Mask Bits +WUSLMSK Description: The intent of this AT command is to enable/disable individual unsolicited message mask bits to be sent out to the serial port. This is a 64-bit mask that determines which messages are enabled or disabled. The setting is persistent over power cycle. The default setting is to allow all unsolicited messages.
Chapter 3 – General Commands Bit Mask Value 23 24 25 26 27 28 29 30 31 0x00800000 0x01000000 0x02000000 0x04000000 0x08000000 0x10000000 0x20000000 0x40000000 0x80000000 Unsolicited Response "BUSY TONE" "+WMGF" "+WDSI: " "+DPRL:" "+WVMI:" “+WAKETA” “RING” “+WANTS” “+WBCI” Response for: Busy Tone SMS +WMGF memory full notification OMA/DM Event notifications +DPRL PRL validated ok Voice Mail Indication Alert Timer Indicator Incoming call notification Antenna Diagnostics Status Change Battery Charging St
Chapter 4 – Identification Commands Chapter 4 – Identification Commands Request Revision Identification +CGMR Description: This command is used to display the operating software version. Syntax: Command syntax: AT+CGMR Command Possible Responses AT+CGMR +CGMR: S/W VER: Q26EL001 P1A066 Jan 1 2009 23:02:14 Note: Get software version OK Hardware Version +WHWV Description: This command displays the hardware version number.
Chapter 4 – Identification Commands Manufacturer Identification +CGMI Description: This command gives the manufacturer identification. Syntax: Command syntax: AT+CGMI Command AT+CGMI Note: Get manufacturer identification Possible Responses +CGMI: (BRAND OF) MODEM OK Note: Command valid, modem Request Model Identification (Frequency Bands) +CGMM Description: This command is used to get the supported frequency bands. With multi-band products the response may be a combination of different bands.
Chapter 5 – Query Commands Chapter 5 – Query Commands Capabilities List +GCAP Description: This command gets the complete list of capabilities. Syntax: Command syntax: AT+GCAP Command AT+GCAP Note: Get capabilities list Possible Responses +GCAP: +CGSM, +CIS707-A, +DS OK Subscriber Number +CNUM Description: This command is used to return the subscriber MSISDN for the current NAM.
Chapter 6 – Global Configuration Commands Chapter 6 – Global Configuration Commands Set Phone Functionality +CFUN Description: This command selects the mobile station’s level of functionality. The AT+CFUN=1 command restarts the entire CDMA stack and CDMA functionality: a complete software reset is performed. The OK response will be sent at the last baud rate defined by the +IPR command. Issuing the AT+CFUN with no arguments will act the same as AT+CFUN=1.
Chapter 6 – Global Configuration Commands Restore Factory Settings &F Description: Note: Syntax: This command is used to restore the factory settings from NV memory. This is a standard Hayes® modem AT command. See Appendix "Effects of AT&W, ATZ and AT&F There is a remote chance of NV memory corruption if a reset or power loss occurs during the processing of this command. This command should be used only during the initial setup of the operating characteristics.
Chapter 7 – Status Commands Chapter 7 – Status Commands General Indicator +WIND Description: This is a general mechanism to send unsolicited non-standardized indications to the application. The identified unsolicited non-standardized indications are: • Indication during mobile originated call setup that the calling party is ringing. • Indication of the availability of the product to receive AT commands after boot. The +WIND is overloaded with two functionalities: 1.
Chapter 7 – Status Commands +WIND General Indicator Unsolicited Message The unsolicited response indicates a variety of events. Result Examples +WIND: 4 Note: General indication that AT commands are ready to be accepted The supported events are: 0: Reserved 1: Reserved 2: Reserved 3: Reserved 4: Product is ready to process all AT commands 5: A call has been created (after ATD, +CCWA, etc.) 6: A call has been released (NO_CARRIER, ATH, etc.
Chapter 7 – Status Commands Report Mobile Equipment Errors +CMEE Description: This command disables or enables the use of the "Extended" error codes. The extended errors are output instead of "ERROR" when +CMEE is enabled. Extended error codes are output as "+CME ERROR: " for most errors, or as "+CMS ERROR: " for SMS-related commands. See error codes descriptions below.
Chapter 7 – Status Commands CME Error Codes Continued: Meaning 148 149 150-239 240 241-299 300-399 400-499 500 502-512 513 514 515 516-518 519 520-530 531 532-599 601 800 801 803 804 805 806 808 830 832 834 835 837 838 840 842 844 850 860 863 864 CMS Error Codes: 300-301 302 303 304 305 306-320 321 322-339 341 342-399 Unsupported serial port baud rate Socket transmit timeout Reserved FDN is active and number is not in FDN Reserved See CMS Errors Reserved unknown error.
Chapter 7 – Status Commands Cellular Result Codes +CRC Description: This command gives more detailed ring information for an incoming call. Instead of the string “RING”, an extended string is used to indicate which type of call is ringing (e.g., +CRING:0).
Chapter 7 – Status Commands Non Volatile Memory Unsolicited Message +WNVM Description: This unsolicited response is used to indicate various Non-Volatile Memory (NVM) events. The messages will only be presented during the startup sequence; before receiving +WIND:4. Synchronization at startup may occur if the modem was improperly shut down before an NVM synchronization between primary NVM storage and secondary NVM storage was completed.
Chapter 8 – Communication Commands Chapter 8 – Communication Commands Fixed DTE Rate +IPR Description: Syntax: This command is used to specify the baud rate for the modem DATA port. The factory default value is 115200. Note: Auto-baud (automatic detection of DTE rate) is not supported. At power-up, the interface rate is set to the value that was active when the last AT&W command was used. Note: The use of baud rates below 9600 may affect the operability of some software features; e.g., TCP App.
Chapter 8 – Communication Commands 0 None 1 XON/XOFF 2 Hardware Receive data flow control disabled. Not Supported. Remove Xon (0x19) and Xoff (0x17) characters from data stream. Use CTS (Clear To Send) signal (default) Set Diagnostic Port +WDMX Description: Set the diagnostic port to either UART2 or USB. The diagnostic port is used with tools like QPST, QXDM, and WPST. These tools can run in conjunction with normal execution of the modem.
Chapter 8 – Communication Commands Set DTR Signal &D Description: Syntax: Values: This command controls the interpretation of the Data Terminal Ready (DTR) signal on the modem DATA port. The factory default value is 2. The AT&F command restores the value to the factory default.
Chapter 8 – Communication Commands V.42bis Data Compression +DS Description: This command enables or disables V.42bis data compression if this feature is provided on the PSTN in the IWF.
Chapter 8 – Communication Commands V.42bis Data Compression Report +DR Description: This command returns the results of data compression capability. If data reporting is enabled, this command returns the data compression type of an incoming or outgoing data call. Otherwise, the command returns NONE. The intermediate result code represents current DCE-DCE data compression type.
Chapter 8 – Communication Commands Line Termination Character S3 Description: This command is used to terminate an incoming command line. The value is not persistent.
Chapter 8 – Communication Commands Carrier Detect Threshold S9 Description: This command defines the amount of time the carrier detect signal stays high. The value is not persistent. Syntax: Command syntax: ATS9= Command Possible Responses ATS9=10 OK Values: 1 – 255 Value in tenths of a second Default value is 60 (or 6 seconds) Automatic Disconnect Delay S10 Description: This command defines the duration of received-line-signal loss that the DCE tolerates.
Chapter 9 – Call Control Commands Chapter 9 – Call Control Commands Dial Command D Description: The ATD command is used to originate a voice or data call. For a data call, the application sends the following ASCII string to the product: ATD where is the destination phone number. Note: ATD is followed by PPP session startup and negotiation. Standard PPP packets are HDLC formatted. A packet data call is terminated by de-assertion of the DTR signal to the modem. See the AT&D command.
Chapter 9 – Call Control Commands Hang-Up Command H Description: The ATH (or ATH0) command is used by the application to disconnect the remote user. In the case of multiple calls, all calls are released (active, on-hold and waiting calls).
Chapter 9 – Call Control Commands Caller ID Presentation Unsolicited Response +CLIP: This response indicates that CLIP (Calling Line Identification Presentation) is enabled for the current incoming call. See +CLIP for enable and disabling this result. Syntax: Response Syntax: +CLIP: , Result Example 1: +CLIP: “8585551212”,129 Note: Incoming call with CLIP and CNAP available Result Example 2: +CLIP: “”,”” Note: Incoming call with CLIP and CNAP not available.
Chapter 9 – Call Control Commands Set Voice Privacy Level +WPRV Description: This command requests the CDMA voice privacy level. CDMA voice privacy is an optional feature of CDMA networks. Therefore, voice privacy will only become enabled during a voice call if the base station supports voice privacy; otherwise this feature is unavailable on your CDMA carrier. This command enables a request from the modem to the base station for voice privacy.
Chapter 9 – Call Control Commands Emergency Mode +WSOS Description: In the event of a user-originated emergency call, the modem will automatically put itself into Emergency callback state. The modem will remain on the same system to be able to receive callbacks from emergency personnel. The modem behavior during Emergency callback state depends on the factory-provisioned mode--Timer Reset Mode or Basic Mode. The mode is carrier-specific.
Chapter 9 – Call Control Commands Call Answered +WANS Description: This response indicates that a voice call has been answered.
Chapter 9 – Call Control Commands Call Ended +WEND Description: This response indicates that a voice call or attempt to establish a voice call has ended. Syntax: Response syntax: +WEND: Command Possible Responses OK ATD18005551212; +WORG:18005551212 +WCNT:3 OK +WEND:29 ATH Note: Call Ended with a normal release ATD18005551212; OK +WORG:18005551212 +WEND:22 Note: Call failed because the signal faded.
Chapter 9 – Call Control Commands Call Originated +WORG Description: This response indicates that an attempt to establish a voice call has occurred. Syntax: Response Syntax: +WORG: Command Possible Responses ATD18005551212; OK +WORG:18005551212 +WCNT:3 OK Notes: is the dialing string sent to the base station. You may see extra numbers before the intended dialing string; this is a result of pre-pended numbers or other call options.
Chapter 9 – Call Control Commands Voice Mail Indicator +WVMI Description: This response indicates the status of the Voicemail Inbox. Syntax: Response syntax: +WVMI: , Possible Responses +WVMI: 1,2 OK Note: 2 messages are in your voicemail box. Values: 1 0 1 3 Examples: Line 1 The number of messages waiting in the inbox. Maximum value is 99. No message waiting.
Chapter 9 – Call Control Commands List Current Call State +CLCC Description: This command is used to return the current call state of the modem. Note that when dormant mode is active, a “no call” status will be returned even though a data call may still be in progress.
Chapter 9 – Call Control Commands Send Flash to Base Station +WFSH Description: This command sends a flash or flash with information to the base station. The flash command is used to manage call waiting and 3-way calls. For call waiting situations when the 3rd party call is received, send a flash (AT+WFSH) to toggle between the two different call parties. The +WFSH unsolicited AT command will be returned if a flash was sent to the base station over the air.
Chapter 9 – Call Control Commands ATD858551212 Note: Make a voice call OK +WORG:858551212 +WCNT:3 Note: Conversation... AT+WFSH=6195552121 Note: Place first call on hold, connect to second party. OK +WFSH Note Modem now places first call on hold and attempts connection to second call. AT+WFSH Note: Connect all 3 parties. OK +WFSH Note: All 3 parties now connected. OK +WFSH Note: Disconnect second party, connected to first party only.
Chapter 10 – Network Service Commands Chapter 10 – Network Service Commands Serving System +CSS Description: Syntax: Values: The numeric parameter is used to query the serving system.
Chapter 10 – Network Service Commands Set Rm Interface Protocol +CRM Description: Syntax: Values: The numeric parameter is used to set the Rm interface protocol. The Rm interface protocol value is affected by the current $QCMIP setting. The Rm interface protocol can be set by the +CRM command only if $QCMIP is set to zero (Mobile IP disabled; Single IP only). Command syntax: AT+CRM= Command Possible Responses AT+CRM? +CRM: 0 Note: Display the current setting.
Chapter 10 – Network Service Commands Signal Quality Unsolicited Response for +CSQ: The Signal Quality (CSQ) unsolicited response is reported whenever the signal quality changes by a predetermined threshold. See +CCED for enabling and disabling this result. This unsolicited response may also be suppressed by using the +WUSLMSK command. Response Syntax: +CSQ: , Result Example +CSQ: 31,99 Note: Signal quality is now -51 dBm or greater. Frame error rate is unknown.
Chapter 10 – Network Service Commands Network Registration & Roaming Unsolicited Response +CREG This response indicates the current state of roaming. Response Syntax: +CREG: Result Example +CREG: 1 Note: Modem has found the home network and is registered.
Chapter 10 – Network Service Commands Set Uniform Out-Of-Service Values +WTUOOS Description: Syntax: Values: This command is used to update the scan and sleep durations for the Uniform Out-of-Service scanning algorithm. The settings are saved in non-volatile memory. The scan duration and sleep duration are specified in seconds with values between 1 second and 32767 seconds.
Chapter 10 – Network Service Commands Service Indication +WSRV Description: This response indicates the SID and NID of the service provider selected for the modem as dictated by the PRL, AT+WBND, and AT+WRMP commands. Syntax: Response Syntax: +WSRV: , Possible Responses +WSRV: 69, 101 Values: 0-65536 Values of the SID and NID.
Chapter 10 – Network Service Commands Default Cell Band +WDCB Description: This command allows the user to display or override the Auto-A or Auto-B selection made by a prior AT+WRMP command or an OTASP session. The Auto-A/Auto-B selection determines which cell bands, if any, are scanned when the channels listed in the PRL are not found. If the AutoA/Auto-B feature is enabled, the default cell band is set based on the value of the home SID.
Chapter 10 – Network Service Commands Cell Environment and RxLev Indication +CCED Description: This command can be used by the application to retrieve information about the main cell and up to six neighboring cells. This is an extended command that may be used in two different settings: 1. Interrogation of the cell environment information 2.
Chapter 10 – Network Service Commands Notes: The CCED response format is , , SID, NID, ,, , , , , , . values are 0 for cellular band (800 MHz) or 1 for PCS band (1900 MHz). The value displayed for is the index of the Active set in 0.5dB steps from 0 (0dB) to 63 (31.5dB). For example: 0 = 0dB, 1 = 0.5dB, 2 = 1dB, … 62 = 31dB, 63 = 31.5dB.
Chapter 11 – Provisioning Control Commands Chapter 11 – Provisioning Control Commands Change NAM Selection +WNAM Description: This command is used to request a change in the NAM (Number Assignment Modem) selection. The modem supports up to 2 NAMs. However, if a NAM is not fully programmed, the modem will not switch to the requested NAM. The default NAM for the modem is 1. The response to this command is only OK, and there is no guarantee that the NAM will change.
Chapter 11 – Provisioning Control Commands Service Programming Code +WSPC Description: This command allows for entry of the service programming code (either MSL or OTKSL). Upon successful entry of this code, all other service provisioning AT commands may be used. If this code is not properly entered prior to attempting other provisioning AT commands, all provisioning commands will return ERROR. If the OTKSL is used to enter provisioning mode, only the +WIMI, +WMDN, and +WCMT commands will be allowed.
Chapter 11 – Provisioning Control Commands Download PRL +DPRL Description: This command is used to download a Preferred Roamer List (PRL) to the modem. The PRL must be formatted in accordance with TIA/EIA-683-A. The +DPRL command is part of the Wavecom suite of service programming commands. The modem service programming code must be successfully entered (see +WSPC) prior to using this command.
Chapter 11 – Provisioning Control Commands AT+DPRL=? Note: Display parameter ranges. AT+DPRL? Note: Display last used parameter values. Values: +DPRL: (1-2),(0-255),(0-255),(1-16384) OK Note: Valid parameter ranges. +DPRL: 1,0,0,57 OK Note: Parameter values displayed. NAM to receive the . Note: Some modems are configured to support only a single NAM. This is carrier dependent and settable at the factory.
Chapter 11 – Provisioning Control Commands Access Overload Class +WAOC Description: This command is used to set the Access Overload Class. If the +WAOC command is used specifically to modify the AOC value, it will retain this value and will not be automatically updated via the WIMI or WMDN commands. Otherwise, if the AOC has not been modified via the WAOC command, it will be automatically updated to be the last digit of the MDN (WMDN) or IMSI (WIMI) when the commit (WCMT=1) command is issued.
Chapter 11 – Provisioning Control Commands Mobile Directory Number +WMDN Description: This command is used to enter a new mobile directory number. Valid numbers are between 10 and 15 digits in length. For support of Wireless Number Portability in all non-RUIM software versions, changes to the MDN will update the IMSI_M portion (least significant 10 digits) of the IMSI. Changes to the MDN will also automatically update the Access Overload Class values unless specifically modified using the +WAOC command.
Chapter 11 – Provisioning Control Commands Slot Cycle Index +WSCI Description: This command is used to set the slot cycle index. Changes made to this data will not be committed to NV memory until the +WCMT command is issued. . Syntax: Command syntax: AT+WSCI= Command Possible Responses AT+WSCI? +WSCI: 2 Note: Read the current slot cycle OK index AT+WSCI=1 OK Note: Set the slot cycle index Values: Slot cycle index; ranges from 0 to 7.
Chapter 12 – OTASP / OTAPA Commands Chapter 12 – OTASP / OTAPA Commands OTASP OTASP stands for Over the Air Service Programming. This gives a wireless carrier the ability to provision new services over the network, rather than requiring the customers to bring the terminal device into a store for programming. For example, an automatic update in internal software parameters PRL can be performed. OTAPA OTAPA stands for Over the Air Parameter Administration.
Chapter 12 – OTASP / OTAPA Commands Programming Unsuccessful +WOT3 Description: This Over-The-Air Service Provisioning (OTASP) response indicates that device programming has been completed unsuccessfully. This response will be accompanied by three quick audio tones from the speaker.
Chapter 12 – OTASP / OTAPA Commands IMSI Download OK +WOTI Description: This Over-The-Air Service Provisioning (OTASP) response indicates that the IMSI download has been completed successfully. Syntax: Response Syntax: +WOTI: “IMSI Download OK” Possible Responses +WOTI: “IMSI Download OK” PRL Download OK +WOTP Description: This Over-The-Air Service Provisioning (OTASP) response indicates that the PRL download has been completed successfully.
Chapter 13 – OMA / DM Control Commands Chapter 13 – OMA / DM Control Commands This chapter is subject to change. Wavecom Device Services Session +WDSS Description: This Wavecom proprietary command allows a user to configure a dedicated Network Access Point (NAP) and to initiate a connection to the OMA/DM server.
Chapter 13 – OMA / DM Control Commands Values: 100 101 200 201 202 203 204 205 206 300 301 302 303 304 305 307 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 500 501 502 503 504 505 Note: Last HTTP response received by the device.
Chapter 13 – OMA / DM Control Commands Wavecom Device Services Reply +WDSR Description: This Wavecom proprietary command allows a user to respond to the Device Services server request when user agreement is requested for connection, download and/or package install (see +WDSI command).
Chapter 13 – OMA / DM Control Commands Wavecom Device Services Wavecom +WDSW Description: This Wavecom proprietary command allows carrier- or customer-specific configuration of Device Services.
Chapter 13 – OMA / DM Control Commands 128 (bit 7) Reserved 256 (bit 8) Activate download progress indication (=18) 512 (bit 9) Reserved 1024 (bit 10) Reserved 2048 (bit 11) Reserved 4096 (bit 12) Activate automatic registration indication (=22) 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 Reserved Reserved Reserved Reserved The modem starts sending data to the server. Authentication with the server failed.
Chapter 13 – OMA / DM Control Commands Examples: Example 1: Example 2: Client-initiated device configuration request, no errors AT+WDSS=1,1 OK +WDSI: 4 +WDSI: 6 +WDSI: 8 Client-initiated device configuration request, authentication error AT+WDSS=1,1 OK +WDSI: 4 +WDSI: 5 Wavecom Device Services Configuration +WDSC Description: This Wavecom proprietary command allows a user to configure: • The user agreement for connection, package download and package install • The mode of automatic registration to the I
Chapter 14 – Short Message Service Control Commands Chapter 14 – Short Message Service Control Commands Send Message +CMGS Description: Syntax: This command is used to send an SMS message. The field is the address of the terminal to which the message is sent. To send the text message, type (0x1A) as the final character of the message. This command can be aborted using the (0x1B) character while entering the message text.
Chapter 14 – Short Message Service Control Commands The reply options for the message. 0 No acknowledgement requested (default) 1 Positive user acknowledgement request 2 Delivery acknowledgement request 3 Request both user acknowledgement and delivery acknowledgement The call back number (not included by default). Read Message +CMGR Description: Syntax: Values: This command allows the application to read stored messages.
Chapter 14 – Short Message Service Control Commands 0 1 2 3 Message priority: Normal Interactive Urgent Emergency Call Back Number Length of the text message (in bytes). The maximum message text length for all other software editions is 160 characters. Message text List Message +CMGL Description: This command allows the application to list stored messages as indicated by the type of the message to read.
Chapter 14 – Short Message Service Control Commands 0 1 2 3 4 Encoding (network specific) Octet (or Unspecified) IS91EP ASCII IA5 UCS-2 Unicode Length of the text message (in bytes). Message text Delete Message +CMGD Description: Syntax: This command is used to delete one or several messages from preferred message storage.
Chapter 14 – Short Message Service Control Commands Preferred Message Storage +CPMS Description: Syntax: Values: This command allows the message storage area to be selected (for reading, writing, etc). The total storage area size is: 100 for “MT”. In the future when the RUIM is supported, the size will vary dependent on the configuration of the SIM card. Command syntax: AT+CPMS=,, Command Possible Responses AT+CPMS=? +CPMS: (“MT”) Note: Display available message storage areas.
Chapter 14 – Short Message Service Control Commands New Message Indication +CNMI Description: This command selects the procedure for message reception from the network. Note: Cell Broadcast messages and Status Report messages are not stored.
Chapter 14 – Short Message Service Control Commands Incoming Message Directly Displayed +CMT Description: This response indicates that an incoming message has been received and according to the message storage preferences (+CNMI), is to be directly displayed.
Chapter 14 – Short Message Service Control Commands SMS Status Report Indication Directly Displayed +CDS Description: This response indicates an SMS status report has been received and according to the message storage preferences (+CNMI), is to be directly displayed. Status report messages are not saved to NV; the host application must be communicating with the modem by either the UART or USB channel. In addition, there is not RI pulse.
Chapter 14 – Short Message Service Control Commands General Codes 32768 SMS OK.
Chapter 15 – Audio Commands Chapter 15 – Audio Commands Audio Subsystem Overview The audio sub-system block diagram below indicates where the various gains and AT commands take effect. Since the AT command values are saved separately for each audio path, the audio gains should be tuned independently for each audio path. Note that the +CLVL is intended to operate like a volume control, so it should be set to 0dB gain during the tuning process (this is the default value).
Chapter 15 – Audio Commands Speaker & Microphone Selection +SPEAKER Description: This command is used to select the voice path, and activates a speaker/microphone audio path. The modem provides three audio paths: analog1, analog2, and digital1. An audio path is functional only with appropriate external hardware. Voice paths may be changed while a call is in progress as well as in the idle state.
Chapter 15 – Audio Commands Microphone Gain +VGT Description: This command sets the voice gain in the transmit direction (microphone gain) of the current audio path.
Chapter 15 – Audio Commands Speaker Gain Control +VGR Description: This command sets the voice gain in the receiver direction (speaker gain) of the current audio path.
Chapter 15 – Audio Commands Digital Gain Transmit +WDGT Description: This command sets the digital gain in the transmit direction (microphone gain) of the current audio path.
Chapter 15 – Audio Commands Digital Gain Receive +WDGR Description: This command sets the digital gain in the receive direction (speaker gain) of the current audio path.
Chapter 15 – Audio Commands Side Tone Modification +SIDET Description: Syntax: Values: This command is used to set the level of audio feedback in the speaker (microphone feedback in the speaker).
Chapter 15 – Audio Commands Echo Cancellation +ECHO Description: This command is used to enable, disable or configure the Echo Cancellation functions for voice calls (in rooms, in cars, etc.). The +SPEAKER function automatically sets echo cancellation based upon audio path choice and this command allows non-standard operation.
Chapter 15 – Audio Commands 5 -16dB 6 -12dB 7 -8dB 8 -4dB 9 0dB (default) 10 4dB 11 8dB 12 12dB If no argument is supplied to the command, the default value is assumed. The configuration is saved immediately. See the Audio Overview section for more information. Special Considerations: Example: The +CLVL gain value is added onto the +WDGR gain. Depending on the gain setting of +WDGR, the full range of the +CLVL command may not be realized.
Chapter 15 – Audio Commands Initialize Voice Parameters +VIP Description: This resets audio parameters back to factory default values for the currently selected audio path (See +SPEAKER).
Chapter 16 – Data Commands Chapter 16 – Data Commands Quick Net Connect $QCQNC Description: This command is used to enable or disable the Quick Net Connect (QNC) feature.
Chapter 16 – Data Commands Mobile Station IP Address +CMIP Description: This read-only command is used to display the mobile station’s temporary IP address. The value displayed is in standard IP address format. Note: This command returns an IP value only during a data call when a temporary IP address has been assigned. Syntax: Command syntax: AT+CMIP Command AT+CMIP? Note: Display the current setting AT+CMIP? Note: Display the current setting AT+CMIP Possible Responses +CMIP: 198.229.142.
Chapter 16 – Data Commands MIP Selection $QCMIPP Description: This command is used to select and activate an MIP user profile. Syntax: Command syntax: AT$QCMIPP Command AT$QCMIPP? Note: Display the current setting AT$QCMIPP=2 Note: Set to user profile 2 AT$QCMIPP=? Note: Display the range of values Note: Possible Responses $QCMIPP: 0 Note: User profile 1 is currently used OK Note: Command is valid $QCMIPP: (0-5) OK Note: Command is valid Takes a profile number between 0 and 5.
Chapter 16 – Data Commands Set NAI for Active Profile $QCMIPNAI Description: This command is used to set the network access identifier (NAI) for the currently active profile. Note: Writing the NAI is not allowed for a Verizon configuration. Command will return ERROR if the modem is configured for Verizon. Syntax: Command syntax: AT$QCMIPNAI=, Command Possible Responses AT$QCMIPNAI? Wavecom 1 @myprovider.
Chapter 16 – Data Commands Set MN-AAA Shared Secrets $QCMIPMASS Description: This command is used to set MN-AAA shared secrets for the currently active profile. It should be noted that the length of the shared secret is 16 bytes (128 bits). Syntax: Command syntax: AT$QCMIPMASS =, Command Possible Responses AT$QCMIPMASS? $QCMIPMASS: Set Note: Display the current setting OK Note: Command is valid AT$QCMIPMASS=? $QCMIPMASS: (20,21,23-7E),(0-1) Note: Display the range of values.
Chapter 16 – Data Commands Set MN-AAA Shared Secrets in HEX $QCMIPMASSX Description: This command is used to set MN-AAA shared secrets for the currently active profile in HEX. It should be noted that the length of the shared secret is 16 bytes (128 bits).
Chapter 16 – Data Commands Set MN-AAA Shared Secrets SPI Values $QCMIPMASPI Description: This command is used to set MN-AAA SPI values for the currently active profile.
Chapter 16 – Data Commands Set Primary HA IP Address $QCMIPPHA Description: This command is used to set the primary HA address of the mobile for the currently active profile. The command takes two arguments, a string corresponding to the IP address of the HA to be stored and a number (either 0 or 1) indicating whether or not to commit this value to NV. The IP address should be formatted in standard dotted-decimal notation; e.g., “10.1.1.20”.
Chapter 16 – Data Commands Set Home HA IP Address $QCMIPHA Description: This command is used to set the home HA address of the mobile for the currently active profile. The command takes two arguments, a string corresponding to the IP address of the HA to be stored and a number (either 0 or 1) indicating whether or not to commit this value to NV. The IP address should be formatted in standard dotted-decimal notation; e.g., “10.1.1.20”.
Chapter 17 – TCP APP AT Commands Chapter 17 – TCP APP AT Commands (For Non-UPI and NonGPS Builds) This section details the AT commands that are available with the TCP App feature. This feature provides functionality for establishing multiple TCP and UDP compliant non-blocking socket connections over an IP network while retaining AT command level control of the modem.
Chapter 17 – TCP APP AT Commands Values: 0 Stop TCP/IP stack 1 Start TCP/IP stack 2 Configure TCP/IP stack 4 Save/Restore Configuration to/from NV memory when = 2 0 Default TTL of outgoing data grams. This option is a limit on the period of time or number of iterations or transmissions that a unit of data can experience before it should be discarded. The time to live (TTL) is an 8-bit field in the Internet Protocol (IP) header. It is the 9th octet of 20.
Chapter 17 – TCP APP AT Commands Bearer Configuration +WIPBR Description: This command is used to open or close a PPP session with the carrier and to read the PPP session options. A CDMA 1xRTT data call will be originated when a PPP session is started and will be terminated when a PPP session is closed. The modem must be in the idle state (no call in progress) when a new PPP session is requested; otherwise, an error will be returned.
Chapter 17 – TCP APP AT Commands Service Creation +WIPCREATE Description: The +WIPCREATE command is used to create UDP, TCP client, and TCP server sockets associated with the specified index and service. If a local port is specified while creating a socket, the created socket will be assigned to this port; if not, a port will be assigned dynamically. If peer IP and peer port are specified, the created socket will be connected to the specified IP and port. TCP server cannot be used to transfer data.
Chapter 17 – TCP APP AT Commands Notes: • • • Starting a TCP server requires specifying the maximum number of client sockets that can be spawned. This can be done using the and parameters. Note that the value set for should be equal or more than .
Chapter 17 – TCP APP AT Commands Service Status Unsolicited Response 3 +WIPERROR Description: This unsolicited response indicates an error occurred while attempting to connect a socket to it’s peer, or that an error occurred on the socket after the socket was created.
Chapter 17 – TCP APP AT Commands Socket Data Exchange +WIPDATA Description: The +WIPDATA command is used to read from or write to a socket. On successful execution of the command, the UART switches to online data mode. The UART can be switched back to online command mode (AT mode with PPP data call established) by sending an escape sequence (“+++”) within a 1 second guard time before and after the sequence.
Chapter 17 – TCP APP AT Commands TCP/IP Service Option Handling +WIPOPT Description: The +WIPOPT command is used to read and/or configure different parameters on sockets. Syntax: Command syntax: AT+WIPOPT=,,,[,] Command Possible Responses AT+WIPOPT=2,1,1,0 +WIPOPT: 2,0,56228 Note: Display local port number for connection on TCP OK socket 1 Note: Display is +WIPOPT: ,, AT+WIPOPT=2,1,1,2 +WIPOPT: 2,2,"192.168.13.
Chapter 17 – TCP APP AT Commands Optnum 8 Value Format 0-255 9 0-255 Description UDP Time-to-live for IP packets default: 64 Type of Service default: 0 RW RW TCP TCP Client Server RW RW RW RW Notes: • • The +WIPOPT command will return ERROR if the socket is not active. Option 3 is used to check whether an UDP socket is bound to any other UDP socket or not. When the UDP socket is created without specifying the IP address of the peer, then option 3 will be read as 0 ( FALSE).
Chapter 18 – Sleep Commands Chapter 18 – Sleep Commands (Not for IP and GPS Builds) Wavecom 32kHz Sleep Mode +W32K Description: This specific command allows the 32kHz sleep mode to be enabled or disabled. When sleep mode is entered, the product uses a 32kHz internal clock during inactivity stages.
Chapter 18 – Sleep Commands Query Scan Sleep State +WSPS Description: This specific command queries the state of the service scan. It returns the same data as the +WSPS unsolicited message.
Chapter 18 – Sleep Commands Values: 0 1 2 3 (Default) Timer Length 0.5 Second 1.0 Second 1.5 Seconds 2.0 Seconds Sudden Momentary Power Loss (SMPL) $WSMPL Description: This command enables or disables the Sudden Momentary Power Loss feature. When AT+CFUN is issued SMPL is disabled to allow for a normal power down and is enabled again on power up. Please note that if the command receives the input value that is the currently set parameter value it will return an error.
Chapter 18 – Sleep Commands Set CDMA Network Time Format +WNETTIMEFMT Description: This command sets the CDMA time response output format for the WNETTIMEGET command. This setting is not persistent.
Chapter 19 – Antenna Commands Chapter 19 – Antenna Commands (Not for IP and GPS Builds) Configure Antenna Diagnostics +WANTLIM Description: This command is used to configure the low limit and high limit diagnostic values of the primary and secondary (diversity or GPS) antenna. The values are compared to the ADC reading from the antenna diagnostic voltage divider network. The current antenna status (NORMAL, OPEN, or SHORTED) is derived from comparison to these limits.
Chapter 19 – Antenna Commands The ADC value below which the powered antenna is considered to be in a shorted condition. Possible values are 0-255. Default is 0. Not applicable to the primary antenna. The ADC value above which the powered antenna is considered to be in an open condition. Possible values are 0-255. Default is 255. Not applicable to the primary antenna.
Chapter 19 – Antenna Commands Values: 0 SHORTED (ADC value < low limit) 1 NORMAL ( low limit <= ADC value <= high limit) 2 OPEN (ADC value > high limit) 0 SHORTED (ADC value < low limit) 1 NORMAL ( low limit <= ADC value <= high limit) 2 OPEN (ADC value > high limit) Configure Antenna Diagnostics Polling Interval +WANTPOLL Description: This command is used to configure the interval between primary and/or secondary antenna diagnostic checks.
Chapter 19 – Antenna Commands Notes: 1. If periodic antenna diagnostic checking is enabled and the modem enters sleep mode, it will awaken at the intervals specified to perform the antenna checks. Disable periodic checking if you do not want to wake from sleep for periodic checking. 2. If a failure (open or short) of the secondary antenna is detected and the antenna is powered, we recommend that you disable power to the antenna and suspend GPS operation while the fault condition persists.
Chapter 19 – Antenna Commands Auxiliary GPS Power +WANT Description: This command enables or disables power to the secondary antenna. A secondary active GPS antenna requires a power source. For these types of antennas, power to the GPS antenna should be enabled with this command. The AT+WANT command is also used when determining the non-powered limits of the diagnostic check. See the AT+WANTLIM command for more information. The state of AT+WANT is persistent across power-downs.
Chapter 19 – Antenna Commands Set Secondary Antenna Diagnostic Limits Command Attach active GPS antenna. Enable power to the antenna. AT+WANT=1 Response OK AT+ADC=7 Request the secondary antenna ADC voltage. +ADC: 200 OK Assume a +/- 5% variance in antenna ADC reading. Powered low limit = 200 – (.05 * 200) = 190 Powered high limit = 200 + (.05 * 200) = 210 AT+WANTLIM=1,2,0,255,190,210 Set secondary antenna diagnostic limits. OK AT+WANTS Check antenna diagnostic status.
Chapter 19 – Antenna Commands AT+ADC=7 Request the secondary antenna ADC voltage. +ADC: 50 OK Assume a +/- 5% variance in antenna ADC reading. Powered short limit = 50 – (.05 *50) = 47 Powered open limit = 50 + (.05 * 50) =53. AT+WANTLIM=1,2,47,53,190,210 Set secondary antenna diagnostic limits. OK AT+WANT=1 Re-enable power to the antenna. OK AT+WANTS Check antenna diagnostic status +WANTS: 1,1 OK Multi-Tech Systems, Inc.
Chapter 20 – Host Application Scenarios Chapter 20 – Host Application Scenarios Introduction This chapter contains descriptions and examples of how to use many of the features that are supported by the CDMA C1 devices. While the AT commands sections describe each AT command and its syntax and function, the focus of this chapter is on the usage of the commands and how they are related to each other. Each scenario lists the AT commands that are used in the examples.
Chapter 20 – Host Application Scenarios Call Processing Call Origination Calls are originated by using the ATD command. Answer Incoming Call Incoming calls are answered either by using the ATA command or setting the value of the Automatic Answer S0 register to a non-zero value. Hang Up Call Calls can be terminated either by using the ATH command or by negating the modem signal DTR on UART1. See the AT&D command for more information.
Chapter 20 – Host Application Scenarios SMS Mobile Originated (MO) Messages The AT+CMGS command is used to originate SMS messages. Up to 140 characters may be sent in a text message. Note that a ctrl-Z terminates the message text entry. The Short Message Service Control Commands section contains more information. For example: at+cmgs="9195551212" > hi, there. +CMGS: 150 OK +WORG: +WCNT: 6 +WEND: 29 It is recommended that you enable ASCII mode for text messages using the AT+WSCL command.
Chapter 20 – Host Application Scenarios Temporarily Store SMS Messages If short messages are stored to non-volatile memory on the module, the +CMTI unsolicited response reports the receipt and storage of the message. The +CMGL, +CMGR and +CMGD commands can be used to list, read and delete the stored messages. For example: at+cnmi=2,1,2,1,0 OK +WANS: 3 +WCNT: 6 +CMTI: "MT",0,0 +WEND: 25 at+cmgl +CMGL: 0,"REC UNREAD","9195551212",0,2,9 hi there.
Chapter 20 – Host Application Scenarios TCP Server Example The device can also act as a server and wait for incoming connections. In this example, a listening socket is opened. When a connection is established from a client, the module receives an unsolicited response. When the client sends data, another unsolicited response is received. The application switches the module to on-line data mode to read the received data. The client closes the connection and the module receives another unsolicited response.
Chapter 21 – Effects of AT&W, ATZ, and AT&F Chapter 21 – Effects of AT&W, ATZ, and AT&F The below table shows what impact AT&W, ATZ, and AT&F has on the various commands. AT&W – Save Configuration. This command writes the current configuration to NV. ATZ – Reset to Default Configuration. This command restores the configuration last saved by AT&W. AT&F – Restore Factory Settings. This command restores the factory default setting.
Chapter 21 – Effects of AT&W, ATZ, and AT&F Command Name $WCCELL $WEMER $WMEM $WPLTIME $WSMPL $WVCOIN &C &D &F &S &V &W +ADC +CAD +CBC +CBIP +CCFC +CDR +CDS +CFC +CFUN +CGMR +CGSN +CLCC +CLIP +CLVL +CMEE +CMGD +CMGL +CMGR +CMGS +CNMI +CNUM +CPAS +CPHS +CPMS +CRC +CREG +CRM +CSQ +CSS +DPRL +DR +DS +ECHO +FAA +FAP +FBO +FBS +FBU Saved Directly to NV No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No No Yes No No Yes No No No No No No Yes No No Yes No No No No No Saved
Chapter 21 – Effects of AT&W, ATZ, and AT&F Command Name +FCC +FCQ +FCR +FCT +FDR +FDT +FEA +FFC +FHS +FIE +FIP +FIS +FKS +FLI +FLO +FLP +FMS +FNR +FNS +FPA +FPI +FPP +FPR +FPS +FPW +FRQ +FRY +FSA +FSP +GCAP +GMI +GMM +GMR +IFC +IPR +MGE +SIDET +SPEAKER +VGR +VGT +VIP +VTS +W32K +WAKESET +WAKET +WAKY +WANT +WANTADC Saved Directly Saved to NV Affected by Z to NV with &W No No Yes (Set to 0,1,0,0,0,0,0,0) No No Yes (Set to 1,0) No No Yes (Set to 0) No No Yes (Set to 1E) No No No No No No No No Yes (Set to 0
Chapter 21 – Effects of AT&W, ATZ, and AT&F Command Name +WANTLIM +WANTPOLL +WANTS +WAOC +WBCI +WBND +WBTM +WCHD +WCMT +WDMX +WDSI +WDSS +WFSH +WGDR +WGDT +WHWV +WIMI +WIND +WIOR +WIOR +WIOW +WIPBR +WIPCFG +WIPCLOSE +WIPCREATE +WIPDATA +WIPOPT +WMBDPT +WMBENABLE +WMBSMS +WMDN +WMSN +WNAM +WNETTIMEFMT +WNETTIMEGET +WGPSTRACK +WPCC +WPDCT +WGPSPARAM +WPDR +WPDUC +WGPSFIX +WPRL +WPRV +WRID +WRMP +WSCC +WSCI +WSCL +WSID Saved Directly to NV Yes No No No No Yes No No Yes Yes Yes Yes No Yes Yes No No Yes No No
Chapter 21 – Effects of AT&W, ATZ, and AT&F Command Name Saved Directly to NV +WSMO No +WSPS No +WSOS No +WSPC Yes +WSRA Yes +WTBMPRS Yes +WTUOOS Yes +WUSLMSK Yes Saved to NV with &W No No No No Yes Yes Yes Yes Affected by Z Affected by &F Yes (Set to C,2) No No No Yes (Set to NV) Yes (Set to NV) Yes (Set to NV) Yes (Set to NV) +WWAKE A D E H I L M S0 S10 S11 S3 S4 S5 S6 S7 S8 S9 T Z No No No No No No No No No No No No No No No No No No No No No No No Yes (Set to 1) No No Yes (Set to 0) Yes (Set to
Chapter 22 – CDMA Terminology and Acronyms Chapter 22 – CDMA Terminology and Acronyms This is an alphabetical list of the CDMA cellular industry’s terminology and acronyms. 2G Second Generation. This is an all digital cellular systems developed to replace the first analog cellular systems. (GSM and CDMA). 3G Third Generation. This is the next generation digital cellular systems designed to have high-speed data access and higher voice capacity (CDMA & CDMA2000).
Chapter 22 – CDMA Terminology and Acronyms IS-95 IS-95 is the first CDMA standard published by Qualcomm in 1993. It is a TIA standard for North American cellular systems based on CDMA. It is widely deployed in North America and Asia. IS-95A IS-95A is a CDMA standard with improved voice quality. IS-95A defines what generally is known as cdmaOne, which supports voice and 14.4 Kbps data rates. This standard is widely used throughout the world.
Chapter 22 – CDMA Terminology and Acronyms PN Offset PN Offset stands for Pseudorandom Noise Offset. In a CDMA network the PN offset is a variable time delay offset of a repeating random noise generator that is used to distinguish individual sectors of a base station. P-REV P-REV is the CDMA revision of the mobile or base station. PRI PRI stands for Provisioning Information.
Index Index $ $QCMIP R-SCH IP Selection ................................ 90 $QCMIPEP Current Active Profile ......................... 91 $QCMIPGETP Return Profile Information ............. 91 $QCMIPHA Set Home HA IP Address .................. 97 $QCMIPMASPI Set MN-AAA Shared Secrets SPI Values.................................................................. 95 $QCMIPMASS MN-AAA Shared Secrets .............. 93 $QCMIPMASSX MN-AAA Shared Secrets in HEX .......................................................
Index +WDGT Digital Gain Transmit ............................... 83 +WDMX Set Diagnostic Port ................................. 27 +WDSC Wavecom Device Services Configuration ............................................................................. 69 +WDSE Wavecom Device Services Error ............. 64 +WDSI Wavecom Device Services Indications ..... 67 +WDSR Wavecom Device Services Reply ........... 66 +WDSS Wavecom Device Services Session ........ 64 +WDSW Wavecom Device Services Wavecom ....
Index AFLT .................................................................. 128 CDMA ................................................................ 128 cdma2000 .......................................................... 128 cdma2000 1xRTT .............................................. 128 cdmaONE .......................................................... 128 DCE ................................................................... 128 DTE ...................................................................
Index I Q IMSI Download OK +WOTI.................................... 63 Incoming Call +RING ............................................. 35 Incoming Message Displayed +CMT..................... 76 Initial Programming Required +WOT0 .................. 61 Initialize Voice Parameters +VIP ........................... 88 Query Scan Sleep State +WSPS ....................... 108 Quick Net Connect $QCQNC ............................... 89 L Last Socket Error Query +WIPERR ....................
Index Set NAI for Active Profile $QCMIPNAI .................. 92 Set Phone Functionality +CFUN ........................... 18 Set Primary HA IP Address $QCMIPPHA ............. 96 Set Reverse Tunneling $QCMIPRT ...................... 92 Set Rm Interface Protocol +CRM .......................... 46 Set Secondary HA IP Address $QCMIPSHA ........ 96 Set Uniform Out-of-Service Values +WTUOOS .... 49 Set Voice Privacy Level +WPRV ........................... 36 Setting Antenna Diagnostic Limits – Examples ....
