MC87xx Modem Extended AT Command Reference Proprietary and Confidential Includes: MC8775 / MC8775V MC8780 / MC8781 MC8785V MC8790 / MC8790V MC8791V MC8792V 2130616 Rev 2.
Preface Important Notice Due to the nature of wireless communications, transmission and reception of data can never be guaranteed. Data may be delayed, corrupted (i.e., have errors) or be totally lost.
MC87xx Extended AT Command Reference REVENUE OR ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE USE OR INABILITY TO USE ANY SIERRA WIRELESS PRODUCT, EVEN IF SIERRA WIRELESS AND/OR ITS AFFILIATES HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR THEY ARE FORESEEABLE OR FOR CLAIMS BY ANY THIRD PARTY.
Preface Windows® is a registered trademark of Microsoft Corporation. QUALCOMM® is a registered trademark of QUALCOMM Incorporated. Used under license. Other trademarks are the property of the respective owners. Contact Information Sales Desk: Phone: 1-604-232-1488 Hours: 8:00 AM to 5:00 PM Pacific Time E-mail: sales@sierrawireless.com Post: Sierra Wireless 13811 Wireless Way Richmond, BC Canada V6V 3A4 Fax: 1-604-231-1109 Web: www.sierrawireless.
MC87xx Extended AT Command Reference Revision History Revision number 2.4 2.5 2.
Preface Revision number 2.7 2.8 2.9 Rev 2.9 Oct.
MC87xx Extended AT Command Reference 8 Proprietary and Confidential 2130616
Table of Contents About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Command timing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 Result codes . . . . . . . . . . . . .
MC87xx Extended AT Command Reference Test Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 Command summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 Command reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 STK interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 Command summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 Command reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
MC87xx Extended AT Command Reference 12 2130616
1 1: About This Guide • • • • Introduction Result codes References Current firmware versions • Document structure • Conventions Introduction This document describes proprietary, password‐protected AT commands available for the MC87xx embedded modem. These commands are supplemental to the standard AT commands for GSM devices defined by the 3GPP (The 3rd Generation Partnership Project) and are intended for use by OEMs.
MC87xx Extended AT Command Reference The password assigned to AT!ENTERCND is unique to each carrier and is configured onto the modem during manufacture. If you do not know your password, contact your Sierra Wireless Account Manager. Command timing Some commands require time to process before additional commands are entered. For example, the modem will return “OK” when it receives AT!DAFTMACT. If AT!DASBAND is received too soon after this, the modem will return an error.
About This Guide Current firmware versions Versions Note: Revisions using letters are to be considered drafts and are subject to change before final release. This document is revised periodically as new firmware versions are released. This edition is: Document Rev 2.9 9 October 2008 Each command listed in this guide includes a list of supporting MC87xx modules.
MC87xx Extended AT Command Reference Note: The ‘Supporting Mini Cards’ column indicates which Mini Card models support each command. If an entry is marked with an asterisk (*), a firmware upgrade may be required. See the detailed command entry for details. This chapter describes commands used to enable access to password‐protected AT commands and to set the AT command password.
About This Guide Table 1-2: Modem status and reset commands (Continued) Command Pg Description Supporting Mini Cards !GCFUIMTYPE 38 Query / set current SIM type All !HSDCAT 39 Query / set HSDPA category Alla !HSUCAT 39 Query / set HSUPA category MC8780 / 81 MC8785V MC8790/90V !LEDCTRL 40 Query / set LED control pattern All !MXPORTMAP 41 Query / set MUX mode port mappings MC8780 / 81a MC8785V MC8790 / 90V !NASREL 51 Query / set active protocol / revision MC8780 / 81 MC8785Va MC879
MC87xx Extended AT Command Reference Table 1-2: Modem status and reset commands (Continued) Command Pg Description Supporting Mini Cards !SLEEP 53 Query / set Sleep Enable state All !SWOCMODE 54 Set module operating mode MC8780 / 81 !UOOS 54 Query / set UMTS ‘Out of Service’ parameters Alla a. For some of these modules, a firmware upgrade may be required, as noted in the detailed command listing.
About This Guide Table 1-4: Test commands (Continued) Command Pg Description Supporting Mini Cards !DAGGRSSI 66 Return the RSSI value in dBm (GSM only) All !DAGGRSSIRAW 66 Return the raw RSSI value All !DAGINFO 67 Return GSM mode RF information (GSM only) All !DAGSLOCK 68 Return the synthesizer lock state All !DAGSRXBURST 68 Set the GSM receiver to burst mode All !DAGSRXCONT 68 Set the GSM receiver continuously on All !DAGSTXBURST 69 Set the GSM transmitter to burst mode All
MC87xx Extended AT Command Reference Memory Management Commands This chapter describes commands that control the data stored in non‐volatile memory of the modem. Table 1-5: Memory management commands Command Pg Description Supporting Mini Cards !NVDEF 85 Reset non-volatile memory All !NVRESTORE 86 Restore backup data All This chapter describes voice commands. Voice is supported on the MC8775V, MC8785V, and MC8790V modems.
About This Guide Table 1-6: Voice commands (Continued) Command Pg Description Supporting Mini Cards AVEXTPCMSEL 99 Query / set external PCM interface for profile MC8775V AVEXTPCMSTOPCLKOFF 100 Enable / disable ability to turn off the external PCM interface clock MC8775V MC8785V MC8790Va !AVMICGAIN 101 Set / query the microphone gain MC8775V MC8785V MC8790V !AVNS 102 Enable / disable noise suppression MC8775V MC8785V MC8790V !AVRXAGC 103 Set / query RX AVC / AGC configuration MC8775V
MC87xx Extended AT Command Reference Table 1-7: GPS commands Command 22 Pg Description Supporting Mini Cards !GPSAUTOSTART 117 Configure GPS auto-start features MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSCLRASSIST 117 Configure GPS auto-start features MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSCOLDSTART 118 Clear all GPS assistance data MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSENABLE 119 (Deprecated) Enable GPS functionality and MTLR support MC8780 / 8
About This Guide Table 1-7: GPS commands (Continued) Command Pg Description Supporting Mini Cards !GPSMTLRSETTINGS 124 Set / query MT location request settings MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSNIQOSTIME 124 Set / query GPS QoS timeout period for networkinitialized fixes MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSPORTID 125 Set / query port ID to use over TCP/IP MC8780 / 81a MC8785V MC8790 / 90V !GPSPOSMODE 126 Configure support for GPS positioning modes MC
MC87xx Extended AT Command Reference Table 1-7: GPS commands (Continued) Command Pg Description Supporting Mini Cards !GPSTRANSSEC 132 Control GPS transport security MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSXTRADATAENABLE 133 Set / query GPS XTRA settings MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSXTRADATAURL 134 Set / query GPS XTRA data server URLs MC8780 / 81a MC8785V MC8790 / 90V MC8791V MC8792V !GPSXTRAINITDNLD 134 Initiate gpsOneXTRA data download and inject
About This Guide This chapter describes SIM Application Toolkit commands. STK commands are supported on the MC8790, MC8790V, MC8791V, and MC8792V modems.
MC87xx Extended AT Command Reference Characters that are required are shown in uppercase; param‐ eters are noted in lowercase. Required parameters are enclosed in angle brackets () while optional parameters are enclosed within square brackets ([x]). The brackets are not to be included in the command string. Commands are presented in table format. Each chapter covers the commands related to that subject and presents a summary table to help you locate a needed command.
2 2: AT Password Commands • Introduction • Command summary • Command reference Introduction The AT commands described in this document are password‐ protected. This chapter describes how to enter and change the password. Command summary The table below lists the commands described in this chapter.
MC87xx Extended AT Command Reference Table 2-2: AT command password details (Continued) Command !SETCND =<“Key”> Supporting Mini Cards: • All Description Set AT command password This allows you to change the password that you enter using the !ENTERCND command. Before you can change the password using !SETCND, you must enable access to this command using !ENTERCND. Parameters: <“Key”> (new password): • Password must be entered with quotation marks (for example, AT!ENTERCND=”NewPW”).
3 3: Modem Status, Customization, and Reset Commands • Introduction • Command summary • Command reference Introduction This chapter describes commands used to reset the modem, adjust customization settings, retrieve the hardware version, and monitor the temperature, voltage, and modem status. Command summary The table below lists the commands described in this chapter.
MC87xx Extended AT Command Reference Table 3-1: Modem status commands (Continued) Command 30 Description Page !NVMUXMODE Query / set USB descriptor MUX mode 44 !NVOEM Query / set values of non-volatile (NV) memory items 45 !NVPLMN Provision the PLMN list for Network Personalization locking 46 !NVPLMNCLR Reset Network Personalization data 46 !NVPORTMAP Change modem port mappings in non-MUX mode 46 !NVSWOC Configure Software on Card feature 47 !PCINFO Return power control status inform
Modem Status, Customization, and Reset Commands Command reference Table 3-2: Modem status, customization, and reset commands Command !BPLMNTIMER? !BPLMNTIMER= Supporting Mini Cards: • MC8775 / 75V (minimum FW rev: H1_1_8_12mcap) • MC8780 / 81 • MC8785V • MC8790 / 90V Description Query / set data inactivity timer value This command indicates or sets the data inactivity timer ‘expiry’ value.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Version 1 and Version 2: !CMEN? Version 1 and Version 2: !CMEN=? Version 1: !CMEN= Version 2: !CMEN= [,] Supporting Mini Cards: • Version 1: All • Version 2:MC8780 / 81 (minimum FW rev: F1_2_1_3ap) • MC8785V • MC8790 / 90V Note: Only the assignment operation (“=”) is passwordprotected.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command !CUSTOM? !CUSTOM=? Description Set / query customization settings This command identifies or sets several customization values.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command !CUSTOM (Continued) Description Set / query customization settings (Continued) • “MEPCODE”—Enable / disable prompt for MEP code when incorrect • • • • • • SIM is inserted : 0 = Disable; 1 = Enable.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command !CUSTOM (Continued) Description Set / query customization settings (Continued) • “PUKPRMPT”—Indicate if host will prompt for PUK code if maximum • • • • • • number of PIN unlock retries is exceeded : 0 = Don’t prompt; 1 = Prompt. “RADIORESET”—Indicate if modem should reset when coming out of Low Power Mode (AT+CFUN=1) : 0 = Reset; 1 = No reset.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command !DTEMP? Supporting Mini Cards: • All Description Return the internal temperature of the modem This command returns the internal temperature of the modem at the PA (Power Amplifier) used by the WCDMA or GSM transceivers.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command !EDAEN? !EDAEN= Description Configure protocol stack for Extended Dynamic Allocation (EDA) This command enables or disables EDA functionality in the stack. !EDAEN=? Supporting Mini Cards: • All Note: Only the assignment operation (“=”) is passwordprotected. Note: This command is only supported on devices that support EDA.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !GCFEN? Enable / disable GCF test mode !GCFEN=? This command is used to place the modem in GCF testing mode or normal operating mode. !GCFEN= Supporting Mini Cards: • All Usage: • AT!GCFEN? returns the current value. • AT!GCFEN=? returns a list of supported values in the format – .
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command !HSDCAT? !HSDCAT=? !HSDCAT= Supporting Mini Cards: • MC8775 / 75V (minimum FW rev: H2_0_1_0mcap) • MC8780 / 81 • MC8785V • MC8790 / MC8790V Note: This command is not password-protected. !HSUCAT? !HSUCAT=? !HSUCAT= Supporting Mini Cards: • MC8780 / 81 • MC8785V • MC8790 / MC8790V Note: This command is not password-protected.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command !LEDCTRL? !LEDCTRL=, , (MC8785V, MC879xV) !LEDCTRL=, ,, Supporting Mini Cards: • All Description Query / set LED control pattern This command is used to control the behavior of the LED. Note: The ‘time’ parameters ( and ) use 100 ms units for MC8785V and MC879xV. All other modems use 1 ms units.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !MXPORTMAP? Query / set MUX mode port mappings !MXPORTMAP= This command is used to set the modem’s MUX-mode DLCI port mappings for AT and PDP2. Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_1_0_2ap) • MC8785V • MC8790 / 90V Usage: • AT!MXPORTMAP? reports the current port mapping.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !NASREL? Query / set supported NAS release compliance version !NASREL=? This command is used to configure the modem to support a specific NAS (Non-Access Stratum) release compliance version.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !NVENCRYPTIMEI= ,,,, ,,, Write unencrypted IMEI to modem Supporting Mini Cards: • All The IMEI is a fifteen digit string formed by concatenating the following elements: This command writes an unencrypted IMEI to a modem if the modem does not already have an IMEI—it can only be used once per modem.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !NVMUXMODE=? Query / set USB descriptor MUX mode !NVMUXMODE? This command is used to change the mode (MUX / non-MUX) in which the Windows driver operates. !NVMUXMODE= Supporting Mini Cards: • MC8780 / 81 • MC8785V In non-MUX mode, supported ports are: • MC8780 / 81 — Data (endpoint 2), HIP carrying CnS and DM (endpoint 4), and AT (endpoint 5).
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !NVOEM=? Query / set values of non-volatile (NV) memory items !NVOEM?- This command is used to read or write the values of specific modem operation values held in NV memory. !NVOEM=
- , Usage: • AT!NVOEM=? returns a list of NV items that can be read or written. , ...
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command !NVPLMN? !NVPLMN= , , ..., , Supporting Mini Cards: • All Description Provision the PLMN list for Network Personalization locking This command is used to provision the list of PLMN (MCC / MNC pairs) used for Network Personalization locking. Usage: • AT!NVPLMN? returns a list of NV items that can be read or written. • AT!NVPLMN=, , ...
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !NVSWOC? Configure Software on Card feature !NVSWOC= This command is used to enable and configure the TRU-Install (Software on Card (SWoC)) feature, which allows the modem to start up as a mass-storage device when it is first used in a host device.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !PCINFO? Return power control status information Supporting Mini Cards: • All This command returns the modem’s power control status in the format: Note: This command is not password-protected.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command !PCINFO (Continued) Description Return power control status information (Continued) (FW rev D0_0_4_2ap and later) (Current power off mode—preset by device manufacturer): • 0 = Enter LPM when W_DISABLE is asserted • 1 = Power down modem when W_DISABLE is asserted • 2 = Ignore changes on W_DISABLE (State of user-initiated low power mode) • 0 = Disabled (normal p
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !PCVOLTLIMITS? Query / set power supply voltage state limit values !PCVOLTLIMITS=, ,,, Certain modem functionality is affected by the modem’s power supply voltage state. The possible voltage states are high critical, high normal, low normal, low warning, and low critical.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command !REL? !REL=? !REL= [,,] Supporting Mini Cards: • All Note: Only the assignment operation (“=”) is passwordprotected. Description Query / set active protocol / revision This command is used to configure the modem to use specific protocol, SGSN, and MSC revisions, and to indicate the current settings.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command !SCANTHRESH? !SCANTHRESH= Supporting Mini Cards: • MC8775 / 75V (minimum FW rev: H1_1_8_13mcap) • MC8780 / 81 • MC8785V • MC8790 / MC8790V Description Set / query WCDMA Scan Threshold This command is used to set the WCDMA Scan Threshold. The scan threshold is set to -103 dBm by default, but can be adjusted if necessary to improve scan performance by reducing ‘false positives’.
Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command !SCROPROF? !SCROPROF=, Supporting Mini Cards: • All Description Set / query profile’s read-only flag This command is used to set / query the read-only flag of a profile. Usage: • AT!SCROPROF? returns the flag value for the specified profile () in the format ,.
MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !SWOCMODE= Set module operating mode Supporting Mini Cards: • MC8780 / 81 This command is used to switch the modem to USB mass-storage mode. This lets you access the software (and other files) that were originally provisioned on the modem.
4 4: Diagnostic Commands • Introduction • Command summary • Command reference Introduction This chapter describes commands used to diagnose modem problems. Command summary The table below lists the commands described in this chapter.
MC87xx Extended AT Command Reference Table 4-2: Diagnostic command details (Continued) Command Description !CMUXLPBK? Configure ports into loopback mode / query loopback state Supporting Mini Cards: • All This command is used to select a multiplexed port and to loop data traffic between the host and the modem over that port. !CMUXLPBK = The modem is effectively in loopback mode only after the modem is put into mux mode (using the command AT+CMUX).
Diagnostic Commands Table 4-2: Diagnostic command details (Continued) Command Description !ERR Display diagnostic information Supporting Mini Cards: • All This command is used to display diagnostic information (logged error conditions) that Sierra Wireless uses to assist in resolving technical issues. Usage: • AT!ERR returns all logged error conditions that are stored in NVRAM. • AT!ERR=0 clears the logged error conditions.
MC87xx Extended AT Command Reference Table 4-2: Diagnostic command details (Continued) Command Description !GBAND= Read / set the current operating band !GBAND? This command is used to read or set the current operating bands (1 or more) of the modem. Supporting Mini Cards: • All Usage: • AT!GBAND= sets the operating bands. • AT!GBAND? returns the current operating band and the mask of preferred bands (, ).
Diagnostic Commands Table 4-2: Diagnostic command details (Continued) Command Description $QCPDPP=, Set / query PDP-IP connection authentication ,, parameters $QCPDPP? Supporting Mini Cards: • All This command sets authentication requirements (username, password) for PDP-IP packet data calls for each supported profile.
MC87xx Extended AT Command Reference Table 4-2: Diagnostic command details (Continued) Command Description !RXDEN? Enable / disable WCDMA receive diversity !RXDEN= This command enables or disables WCDMA receive diversity, or establishes receive diversity as the primary path.
Diagnostic Commands Table 4-2: Diagnostic command details (Continued) Command Description !UMTSCHAN? Query / set Priority UMTS Channel Selection state !UMTSCHAN =[,] The modem can be set to scan a ‘priority’ UMTS channel when the modem powers up, before scanning other frequencies.
MC87xx Extended AT Command Reference 62 2130616
5 5: Test Commands • • • • Introduction Command summary Command reference Sample AT command sequences Introduction To obtain regulatory approval and carrier approvals for your product, you may be required to perform tests on the radio component of the embedded modem. This chapter describes AT commands used to perform those tests. In most cases the modem must be in a particular mode before you can issue the AT commands to perform particular tests.
MC87xx Extended AT Command Reference Command summary The table below lists the commands described in this chapter.
Test Commands Table 5-1: Test commands (Continued) Command Description Page !DAWSTXCW Set the waveform used by the transmitter 79 !OSDSM Display memory usage for DSM buffer pools 79 Command reference Table 5-2: Test command details Command Description !DAFTMACT Put the modem into FTM mode Supporting Mini Cards: • All FTM (Factory Test Mode) is a non-signaling mode that allows the radio component to be manually configured to conduct certain types of tests.
MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command DAGGAVGRSSI =, Supporting Mini Cards: • All Note: The modem must be in FTM mode to use this command—use AT!DAFTMACT to enter FTM mode. Description Return an averaged RSSI value in dBm (GSM only) This command returns an averaged RSSI (Received Signal Strength Indicator) value in dBm.
Test Commands Table 5-2: Test command details (Continued) Command Description !DAGINFO Return GSM mode RF information (GSM only) Supporting Mini Cards: • All This command returns RF information for GSM mode. Note: AT!DAWINFO provides RF information for WCDMA mode. Note: The modem must be in online mode to use this command. Returned parameters GSM channel: • 0–65535 Receive power: • 0x00000000–0xFFFFFFFF LNA gain state: • 0–65535 Rx power in dBm (0.
MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description !DAGSLOCK Return the synthesizer lock state Supporting Mini Cards: • All This command returns a value indicating the lock state of the RF synthesizers: Note: The modem must be in FTM mode to use this command—use AT!DAFTMACT to enter FTM mode.
Test Commands Table 5-2: Test command details (Continued) Command !DAGSTXBURST =
MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command !DAOFFLINE Place modem offline Supporting Mini Cards: • All This commands puts the modem offline. !DASBAND Set the frequency band = Supporting Mini Cards: • All Note: The modem must be in FTM mode to use this command—use AT!DAFTMACT to enter FTM mode. 70 Description Parameters: • None This command sets the modem to use a particular frequency band.
Test Commands Table 5-2: Test command details (Continued) Command !DASCHAN = Supporting Mini Cards: • All Note: The modem must be in FTM mode to use this command—use AT!DAFTMACT to enter FTM mode. Description Set the modem channel (frequency) This command sets the modem to operate on a particular frequency channel. Before using this command to set the channel, use the command !DASBAND (described on page 70) to set the band.
MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command !DASLNAGAIN = !DASLNAGAIN = [, ] Supporting Mini Cards: • All Description Set the LNA gain state This command sets the LNA (Low Noise Amplifier) range for the main or diversity path (if applicable), in either WCDMA or GSM mode. Usage: • AT!LNAGAIN= sets the LNA range for the main path.
Test Commands Table 5-2: Test command details (Continued) Command !DASPDM =, Supporting Mini Cards: • All Note: The modem must be in FTM mode to use this command—use AT!DAFTMACT to enter FTM mode. Description Set the PDM value This command adjusts the PDM (Pulse Duration Modulation), allowing you to apply frequency offset to the LO (Local Oscillator).
MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description !DASTXON Turn the TX PA on Supporting Mini Cards: • All This command turns the transceiver PA on (the WCDMA PA or the GSM PA, depending on the mode set with !DASBAND). The PA then remains on until you turn it off again using the !DASTXOFF command, or until you reset or power the modem down and up. Note: The modem must be in FTM mode to use this command—use AT!DAFTMACT to enter FTM mode.
Test Commands Table 5-2: Test command details (Continued) Command Description !DAWGRXAGC Return the RX AGC value (WCDMA only) !DAWGRXAGC? This command returns the RX AGC (Automatic Gain Control) value of the main path or diversity path (if applicable). This value can be converted to RSSI (Received Signal Strength Indicator) in dBm. See “Calculating the RSSI in dBm from the AGC value” on page 82. Supporting Mini Cards: • All Usage: • AT!DAWGRXAGC returns the for the main path.
MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description !DAWINFO Return WCDMA mode RF information (WCDMA only) Supporting Mini Cards: • All This command returns RF information for WCDMA mode when the modem is in CELL_DCH (Designated Channel) state. Note: The modem must be in online mode to use this command. Note: !DAGINFO provides RF information for GSM mode.
Test Commands Table 5-2: Test command details (Continued) Command !DAWSCONFIGRX =, Supporting Mini Cards: • All Description Set the WCDMA receiver to factory calibration settings This command configures the WCDMA receiver according to factory calibration settings stored in the modem’s NV (Non-Volatile memory). This allows for accurate measurement of RX AGC levels.
MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command !DAWSPARANGE = Supporting Mini Cards: • All Description Set the PA range state machine This command sets the PA range state machine in WCDMA operation. Parameters: : Note: The modem must be in FTM mode to use this command—use AT!DAFTMACT to enter FTM mode.
Test Commands Table 5-2: Test command details (Continued) Command !DAWSCHAINTCM = Supporting Mini Cards: • MC8780 / 81 • MC8785V • MC8790 / MC8790V Description Place receive chain in test call mode (WCDMA only) This command places one or both of the primary and secondary receive chains in test call mode. Usage: • AT!DAWSCHAINTCM= places the requested receive chain(s) in test call mode.
MC87xx Extended AT Command Reference Sample AT command sequences Turning on the TX in WCDMA mode The sequence of AT commands that follows turns the trans‐ mitter on and adjusts the offsets. Table 5-3: Command sequence for setting WCDMA offsets Command 1. AT!ENTERCND= “password” 80 Function Enters the password, providing access to the necessary commands 2. AT!DAFTMACT Puts the modem into factory test mode 3. AT!DASBAND=16 Sets the frequency band to WCDMA 1900 4.
Test Commands Turning on the TX in GSM mode The sequence of AT commands that follows turns the trans‐ mitter on and adjusts the offsets. Table 5-4: Command sequence for setting GSM offsets Command 1. AT!ENTERCND= “password” Function Enters the password, providing access to the necessary commands 2. AT!DAFTMACT Puts the modem into factory test mode 3. AT!DASBAND=12 Sets the frequency band to GSM 1900 4. AT!DASCHAN=661 Sets the channel to 661 5.
MC87xx Extended AT Command Reference Table 5-5: Command sequence for reading the RSSI in WCDMA mode (Continued) Command 4. AT!DAWSCONFIGRX =9263,-80 5. AT!DAWGRXAGC Function Configures the WCDMA receiver using the factory calibration information for channel 9263 at the expected RX level of -80 dBm Reports the RX AGC value. This can be converted to dBm using the calculation below.
Test Commands Setting the LNA gain Note: The gain state values listed here are provided as a guideline. The values are approximations and subject to change over time. The LNA gain state (!DASLNAGAIN) is set based on the expected receive power level. The table below shows the approximate switch point values from low gain to high gain. (These are different than the values for high gain to low gain.
MC87xx Extended AT Command Reference 84 2130616
6 6: Memory Management Commands • Introduction • Command summary • Command reference Introduction The modem has 2 MB of non‐volatile memory that is used to store: • Factory calibration data • Settings made in a host application such as Watcher The commands in this chapter allow you to back up and restore the data in non‐volatile memory.
MC87xx Extended AT Command Reference Table 6-2: Memory management command details (Continued) Command !NVRESTORE = Supporting Mini Cards: • All Description Restore backup data This command restores items to non-volatile memory that were backed up with the command AT!NVBACKUP, and returns the number of NV items restored.
7 7: Voice Commands • • • • Introduction Audio profiles Command summary Command reference Introduction The MC8775V, MC8785V, MC8790V, MC8791V, and MC8792V modems have built‐in audio support that allow the modems to be used as mobile phones. The modems all support a single analog audio interface that can be used for handset‐style applications or headset applica‐ tions, and a PCM digital audio interface.
MC87xx Extended AT Command Reference The embedded module can serve as an integral component of a more complex audio system, such as a PDA with a separate codec interfacing with the main processor. In this case, the interface between the modem and PDA codec can be as simple as line‐level audio with no transducer considerations.
Voice Commands The MC87xx modem supports six or eight audio profiles, depending on the module type: • 0—Handset • 1—Headset • 2—Car kit • 3—Speaker phone • 4—Auxiliary • 5—TTY (TeleTYpe—a device that allows speech and hearing‐impaired people to use a phone) • (MC8785V / MC8790V / MC8791V / MC8792V only) 6—Auxiliary external PCM (128 kHz clock) • (MC8785V / MC8790V / MC8791V / MC8792V only) 7—Primary external PCM (2 MHz clock) AT commands that are used to change the audio configuration have
MC87xx Extended AT Command Reference Profile activation Profile 0 (Handset) is the default profile. Unless you activate a different profile prior to establishing a circuit‐switched call, the default profile is used in establishing the call. To use a profile other than Profile 0, use the command AT!AVSETPROFILE (described on page 106) to activate the profile prior to establishing the call.
Voice Commands Table 7-2: Voice command passwords Command Description Page !AVTXPCMFLTR Set / query the TX PCM filter tap 109 !AVTXVOL Set the TX volume 110 Command reference Table 7-3: Voice command details Command !AVAUDIOLPBK = Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Rev 2.9 Oct.08 Description Enable / disable an audio loopback This command sets up an audio loopback.
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVCODECRXG =, !AVCODECRXG? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set / query CODEC RX gain This command sets the CODEC RX gain for the specified audio profile. The CODEC RX gain is applied to the digital signal prior to its conversion to the analog domain to provide additional gain range from 84dB to +12dB in the receive direction.
Voice Commands Table 7-3: Voice command details (Continued) Command !AVCODECSTG =, !AVCODECSTG? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set / query CODEC sidetone gain This command sets / queries the CODEC sidetone gain for the specified audio profile. The side tone is the sound of the mobile user's own voice as heard on the mobile's speaker, and the gain ranges from -84dB to +12dB.
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVCODECTXG =, !AVCODECTXG? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set / query the TX gain This command sets the CODEC TX gain for the specified audio profile. The CODEC TX gain is applied to the digital signal after its conversion from the analog domain to provide additional gain range from -84dB to +12dB in the transmit direction.
Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVDEF Set audio settings to default values Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V This command sets all the configurable audio parameters to default values. The default values are also loaded into non-volatile memory.
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVDTMFVOLDB =, , , !AVDTMFVOLDB? , , Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set the audio volume and DTMF volume for each audio type This command sets the audio volume and the DTMF volume level for voice and key beep tones. The setting is stored in non-volatile memory and persists across power cycles.
Voice Commands Table 7-3: Voice command details (Continued) Command !AVEC =, !AVEC? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set / query the echo cancellation setting This command sets the echo cancellation mode for the specified profile. The echo canceller monitors the conversation and eliminates the echo that may return to its point of origin (far end).
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVEXTPCMCFG =, , Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Configure external PCM interface This command configures the external PCM interface by specifying the clock speed, the format, and enabling / disabling padding. The change takes place immediately if the current audio profile uses the external PCM interface.
Voice Commands Table 7-3: Voice command details (Continued) Command !AVEXTPCMSEL? !AVEXTPCMSEL = , Supporting Mini Cards: • MC8775V Note: This command is not used for newer voice-supporting modules — audio profile IDs 6 and 7 are now available for PCM audio in other commands. Description Query / set external PCM interface for profile This command enables or disables the external PCM interface for a specific audio profile—the change takes effect after the modem is reset.
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVEXTPCMSTOPCLKOFF? !AVEXTPCMSTOPCLKOFF = Supporting Mini Cards: • MC8775V (minimum FW rev: H1_0_0_10mcap) • MC8785V • MC8790V • MC8791V • MC8792V Description Enable / disable ability to turn off the external PCM interface clock If the current audio profile uses the external PCM interface, this command enables or disables the ability to turn off the external PCM interface clock—the change takes effect afte
Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVMICGAIN =, Set / query the microphone gain !AVMICGAIN? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V This command sets the microphone gain for the specified audio profile. This setting provides a set of twenty-six gain levels from -6 dB to +49.5 dB (steps of 1.5 dB). The gain is applied to the analog audio input prior to its conversion into the digital domain.
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVNS =, !AVNS? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Enable / disable noise suppression This command sets the noise suppression setting for a specified profile. The noise suppressor reduces or eliminates continuous background noise, providing a clearer Rx audio signal.
Voice Commands Table 7-3: Voice command details (Continued) Command !AVRXAGC =, !AVRXAGC? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set / query RX AVC / AGC configuration This command sets the RX AVC / AGC (Automatic Volume Control / Automatic Gain Control) configuration for the specified profile.
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVRXPCMFLTR =, , !AVRXPCMFLTR? , Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set / query the RX PCM filter tap The MC87xx modem has a 7-tap PCM (Pulse Code Modulation) filter. This command sets the RX PCM filter tap for the specified profile. Note: This command is only useful when embedding the MC87xx modem in a handset.
Voice Commands Table 7-3: Voice command details (Continued) Command !AVRXPCMFLTR (Continued) Description Set / query the RX PCM filter tap (Continued) Parameters: (audio profile number): • 0 = Handset • 1 = Headset • 2 = Car kit • 3 = Speaker phone • 4 = Auxiliary • 5 = TTY • (MC8785V / MC8790V / MC8791V / MC8792V only) 6 = Auxiliary external PCM (128 kHz clock) • (MC8785V / MC8790V / MC8791V / MC8792V only) 7 = Primary external PCM (2 MHz clock) (sets the taps in use): • 0 = Tap 0 • 1 =
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description !AVSETPROFILE =, , , , Activate a profile (MC8790V / MC8791V / MC8792V) !AVSETPROFILE =, , , , [,] The profile you select remains active until the modem is reset or powered down and up again. Following a reset or power up, Profile 0 (the default profile) is active.
Voice Commands Table 7-3: Voice command details (Continued) Command !AVSETPROFILE (continued) Description Activate a profile (continued) (enable / disable earpiece muting): • 0 = Unmuted • 1 = Muted (enable / disable microphone muting): • 0 = Unmuted • 1 = Muted (audio type): • 0 = Voice • 1 = Key beep • 2 = MIDI (volume level): • 0 = Level 0 • 1 = Level 1 • 2 = Level 2 • 3 = Level 3 • 4 = Level 4 • 5 = Level 5 • 6 = Level 6 • 7 = Level 7 (enable / disab
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVTONEPLAY =, Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Play a tone This command is used to play a specified tone with the current active audio profile. This is for testing purposes—not for normal operation. Parameters: (audio type): • 0 = Voice • 1 = Key beep (tone setting) • Valid range: 0x00 – 0x57.
Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVTXPCMFLTR =, , Set / query the TX PCM filter tap !AVTXPCMFLTR? , See “!AVRXPCMFLTR” on page 104 for a description of using the filters. Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V The MC87xx modem has a 7-tap PCM (Pulse Code Modulation) filter. This command sets the TX PCM filter tap for the specified profile.
MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command !AVTXVOL =, !AVTXVOL? Supporting Mini Cards: • MC8775V • MC8785V • MC8790V • MC8791V • MC8792V Description Set the TX volume This command sets / queries the TX volume gain for the specified audio profile. The TX volume gain determines the gain, from -84 dB to +12 dB, for the voice that is transmitted over the air.
Voice Commands Table 7-4: Tone settings for AT !AVTONEPLAY command (Continued) parameter setting Tone Description 0x05 SND_5 DTMF for 5 key 0x06 SND_6 DTMF for 6 key 0x07 SND_7 DTMF for 7 key 0x08 SND_8 DTMF for 8 key 0x09 SND_9 DTMF for 9 key 0x0A SND_A DTMF for A key 0x0B SND_B DTMF for B key 0x0C SND_C DTMF for C key 0x0D SND_D DTMF for D key 0x0E SND_POUND DTMF for # key 0x0F SND_STAR DTMF for * key 0x10 SND_CTRL Tone for a control key 0x11 SND_2ND Tone
MC87xx Extended AT Command Reference Table 7-4: Tone settings for AT !AVTONEPLAY command (Continued) parameter setting 112 Tone Description 0x21 SND_RING_F4 698.5 Hz 0x22 SND_RING_FS4 739.9 Hz 0x23 SND_RING_G4 784.0 Hz 0x24 SND_RING_GS4 830.6 Hz 0x25 SND_RING_A5 880.0 Hz 0x26 SND_RING_AS5 932.2 Hz 0x27 SND_RING_B5 987.7 Hz 0x28 SND_RING_C5 1046.5 Hz 0x29 SND_RING_CS5 1108.7 Hz 0x2A SND_RING_D5 1174.6 Hz 0x2B SND_RING_DS5 1244.3 Hz 0x2C SND_RING_E5 1318.
Voice Commands Table 7-4: Tone settings for AT !AVTONEPLAY command (Continued) parameter setting Tone Description 0x3D SND_RING_A7 3520.0 Hz 0x3E SND_RBACK Ring back (audible ring) 0x3F SND_BUSY Busy tone 0x40 SND_INTERCEPT_A First tone of an intercept 0x41 SND_INTERCEPT_B Second tone of an intercept 0x42 SND_REORDER_TONE Reorder 0x43 SND_PWRUP Power-up tone 0x44 SND_OFF_HOOK_TONE Off-hook tone, IS-95 (CAI 7.7.5.
MC87xx Extended AT Command Reference 114 2130616
8 8: GPS Commands • Introduction • Command summary • Command reference Introduction This chapter describes commands used to access GPS function‐ ality in supporting modules. Note: The modem must be in ONLINE mode to use these commands—use AT!DAFTMDEACT to enter ONLINE mode. Minimum firmware revision The minimum required firmware revision for the commands in this chapter is F1_2_0_0. Command summary The table below lists the commands described in this chapter.
MC87xx Extended AT Command Reference Table 8-1: GPS commands Command 116 Description Page !GPSPROTOSEL Control GPS protocol selection 127 !GPSSATINFO Request satellite information 128 !GPSSTATUS Request current status of a position fix session 129 !GPSSUPLURL Set / query SUPL server URL 130 !GPSTRACK Initiate a local tracking (multiple fix) session 131 !GPSTRANSSEC Control GPS transport security 132 !GPSXTRADATAENABLE Set / query GPS XTRA settings 133 !GPSXTRADATAURL Set / query G
GPS Commands Command reference Table 8-2: GPS command details Command Description !GPSAUTOSTART? Configure GPS auto-start features !GPSAUTOSTART=? This command configures the GPS auto-start features. Any changes take effect the next time the modem is reset.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSCLRASSIST? Clear specific GPS assistance data !GPSCLRASSIST=? This command clears one or more types of assistance data from the modem. This forces a cold start for GPS acquisition the next time a session starts. !GPSCLRASSIST=, , ,
GPS Commands Table 8-2: GPS command details (Continued) Command !GPSENABLE = , Description (Deprecated) Enable GPS functionality and MTLR support GPSENABLE? GPSENABLE=? Supporting Mini Cards: • MC8780 / 81 (Deprecated use !CUSTOM=”GPSENABLE”) • For newer modules, use !CUSTOM=”GPSENABLE” Note: Deprecated. !GPSENABLE should be used instead.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command !GPSEND = End an active session Supporting Mini Cards: • MC8775V • MC8780 / 81 • MC8785V • MC8790 / 90V • MC8791V • MC8792V This command ends an active position fix session. Note: This command is not password-protected. 120 Description Usage: • AT!GPSEND= ends the current session.
GPS Commands Table 8-2: GPS command details (Continued) Command !GPSFIX=, , Description Initiate a GPS position fix This command initiates a GPS position fix. !GPSFIX=? Supporting Mini Cards: • MC8775V • MC8780 / 81 • MC8785V • MC8790 / 90V • MC8791V • MC8792V Note: This command is not password-protected. Usage: • AT!GPSFIX=, , initiates a time-limited position fix with a specified accuracy.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command !GPSIPADDR = Description Set / query IP address to use over TCP/IP !GPSIPADDR? Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_0_1_4ap) • MC8785V • MC8790 / 90V Note: Deprecated. !GPSSUPLURL should be used in place of !GPSIPADDR and !GPSPORTID. This command sets or reports the IP address of the SUPL server to use when using TCP/IP as the transport mechanism for SUPL.
GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSLOC? Return the last known location of the modem Supporting Mini Cards: • MC8775V • MC8780 / 81 • MC8785V • MC8790 / 90V • MC8791V • MC8792V This command returns the details obtained during the most recent position location session, if available. Note: This command is not password-protected.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSMTLRSETTINGS = Set / query MT location request settings !GPSMTLRSETTINGS? This command sets or reports the current MT (mobile-terminated) Location Request settings. !GPSMTLRSETTINGS=? Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_3_13ap) • MC8785V (minimum FW rev: J1_0_1_3ap) • MC8790 / 90V • MC8791V • MC8792V Note: AT!RESET must be issued after this command is used.
GPS Commands Table 8-2: GPS command details (Continued) Command !GPSPORTID = Description Set / query port ID to use over TCP/IP !GPSPORTID? Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_0_1_4ap) • MC8785V • MC8790 / 90V Note: Deprecated. !GPSSUPLURL should be used in place of !GPSIPADDR and !GPSPORTID. This command sets or reports the port ID of the SUPL server to use when using TCP/IP as the transport mechanism for SUPL.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSPOSMODE = Configure support for GPS positioning modes !GPSPOSMODE? This command enables or disables support for several GPS positioning modes. !GPSPOSMODE=? Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_0_0ap) • MC8785V • MC8790 / 90V • MC8791V • MC8792V Note: AT!RESET must be issued after this command is used.
GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSPROTOSEL = Control GPS protocol selection !GPSPROTOSEL? This command sets or reports the current GPS protocol selection method for User Plane GPS. !GPSPROTOSEL=? Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_0_0ap) • MC8790 / 90V • MC8791V • MC8792V Note: AT!RESET must be issued after this command is used. Usage: • AT!GPSPROTOSEL= indicates the protocol selection method to use.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSSATINFO? Request satellite information Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_1_0_3ap) • MC8785V • MC8790 / 90V • MC8791V • MC8792V This command returns the following information for up to twelve satellites in view (including those used in the latest position fix): satellite vehicle number (SV), elevation (ELEV), azimuth (AZI), and signal to noise ratio (SNR).
GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSSTATUS? Request current status of a position fix session Supporting Mini Cards: • MC8775V (minimum FW rev: H1_1_0_1mcap) • MC8780 / 81 • MC8785V • MC8790 / 90V • MC8791V • MC8792V This command returns the current status of a position fix session.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command !GPSSUPLURL? !GPSSUPLURL=? !GPSSUPLURL=” [:]” Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_3_9ap) • MC8785 • MC8790 / MC8790V • MC8791V • MC8792V Description Set / query SUPL server URL This command sets or returns the URL of the SUPL server to be used when TCP/IP is used as the transport mechanism for location processing.
GPS Commands Table 8-2: GPS command details (Continued) Command !GPSTRACK = , , , , !GPSTRACK=? Supporting Mini Cards: • MC8775V • MC8780 / 81 • MC8785V • MC8790 / 91 • MC8791V • MC8792V Note: This command is not password-protected. Description Initiate a local tracking (multiple fix) session This command initiates a local tracking session comprising a specific number of position fixes taken at regular time intervals.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command !GPSTRACK (Continued) Description One of the following responses will be received: • “OK” if the request is successful, or • “ERROR CODE = if the request fails for any reason. See Table 8-3 on page 139 for a list of error codes. Related commands: • AT!GPSSTATUS—Use this command while the tracking session is in progress. • AT!GPSLOC—Use this command after the session completes to obtain the result.
GPS Commands Table 8-2: GPS command details (Continued) Command !GPSXTRADATAENABLE = [,, [,, ]] Description Set / query GPS XTRA settings This command enables or disables GPS XTRA data and sets or reports GPS XTRA data configuration settings. !GPSXTRADATAENABLE? !GPSXTRADATAENABLE=? Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_0_0ap) • MC8785V • MC8790 / 90V • MC8791V • MC8792V Note: These settings are persistent across power cycles.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSXTRADATAURL = , Set / query GPS XTRA data server URLs !GPSXTRADATAURL? This command sets or reports the URLs of up to three GPS XTRA data servers. Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_0_0ap) • MC8785V • MC8790 / 90V • MC8791V • MC8792V Usage: • AT!GPSXTRADATAURL=, sets the URL used for the primary, secondary, or tertiary data server.
GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSXTRASTATUS? Return current status of gpsOneXTRA Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_0_1_4ap) • MC8785V • MC8790 / 90V • MC8791V • MC8792V This command returns the status of the most recent time and data injection operations. Note: This command is not password-protected. Usage: • AT!GPSXTRASTATUS? returns the status of the most recent time and data injection operations.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSXTRATIME=, , - , , , , , , Inject GPS or UTC time into gpsOneXTRA system !GPSXTRATIME=? Usage: • AT!GPSXTRATIME=,,
- ,,,,,, injects the specfied date and time into the gpsOneXTRA system. If the command fails, it returns “Error code = ”.
GPS Commands Table 8-2: GPS command details (Continued) Command !GPSXTRATIMEENABLE = [, , ] !GPSXTRATIMEENABLE? !GPSXTRATIMEENABLE=? Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_0_0ap) • MC8785V • MC8790 / 90V • MC8791V • MC8792V Description Set / query GPS XTRA time settings This command enables or disables GPS XTRA time information, and sets or reports specific GPS XTRA time settings. Note: AT!RESET must be issued after this command is used.
MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSXTRATIMEURL = , Set / query GPS XTRA SNTP server URLs !GPSXTRATIMEURL? This command sets or reports the URLs of up to three GPS XTRA SNTP (Simple Network Time Protocol) servers. Supporting Mini Cards: • MC8780 / 81 (minimum FW rev: F1_2_0_0ap) • MC8785V • MC8790 / 90V • MC8791V • MC8792V Note: AT!RESET must be issued after this command is used.
GPS Commands Error codes Table 8‐3 describes error codes that can be returned by AT!GPSEND (page 120), AT!GPSSTATUS (page 129), and AT!GPSTRACK (page 131).
MC87xx Extended AT Command Reference Table 8-3: AT command error codes (!GPSEND, !GPSSTATUS, !GPSTRACK) (Continued) Error code Description 24 Subscription violation 25 Desired fix method failed 26 Reserved 27 No fix reported because no Tx confirmation was received 28 Network indicated normal end of session 29 No error specified by the network 30 No resources left on the network 31 Position server not available 32 Network reported an unsupported version of protocol Table 8-4: AT command
GPS Commands Table 8-4: AT command error codes (!GPSFIX) (Continued) Error code Description 15 Phone is offline 16 Phone is CDMA locked 17 GPS is locked 18 Command is invalid in current state 19 Connection failure with PDE 20 PDSM command buffer unavailable to queue command 21 Search communication problem 22 • (MC8775V / 80 / 81 / 90 / 90V) Temporary problem reporting position determination results • (MC8785V) Reserved 23 • (MC8775V / 80 / 81 / 90 / 90V) Error mode not supported • (MC878
MC87xx Extended AT Command Reference 142 2130616
9 9: STK Commands • Introduction • Command summary • Command reference Introduction This chapter describes commands used to configure host support for STK features, monitor and respond to unsolicited proactive SIM commands, and present STK option menus provided by the SIM. These commands implement a subset of the functions defined in 3GPP TS 11.14. STK interactions The host STK support profile informs the SIM about the STK features the host supports.
MC87xx Extended AT Command Reference iii. The SIM will take action on the selected item and will send a new unsolicited command to the host for the next operation to be performed. · For any other : i. Respond with “AT!STKGC=” to retrieve the data to use for . ii. Execute the requested command () and respond with “AT!STKCR=,, ...” Configuring the host’s profile To configure the host’s profile for STK support: 1.
STK Commands Command reference Table 9-2: STK command details Command !STKC? Unsolicited command: !STKC: Supporting Mini Cards: • MC8790 / 90V (minimum FW rev: K1_0_2_3ap) • MC8791V / 92V (minimum FW rev: K1_0_2_4ap) Note: This command is not password-protected. Rev 2.9 Oct.08 Description Receive unsolicited SIM command This command is used by the SIM to send unsolicited notifications to the host, and is used by the host to query the last command received.
MC87xx Extended AT Command Reference Table 9-2: STK command details (Continued) Command !STKCR=, [, ] !STKCR=? Supporting Mini Cards: • MC8790 / 90V (minimum FW rev: K1_0_2_3ap) • MC8791V / 92V (minimum FW rev: K1_0_2_4ap) Note: This command is not password-protected.
STK Commands Table 9-2: STK command details (Continued) Command Description !STKGC= Retrieve data for unsolicited SIM command !STKGC=? This command is used to retrieve the data associated with the last received unsolicited SIM command. Supporting Mini Cards: • MC8790 / 90V (minimum FW rev: K1_0_2_3ap) • MC8791V / 92V (minimum FW rev: K1_0_2_4ap) Usage: • AT!STKGC= retrieves the data for identified in the last unsolicited SIM command.
MC87xx Extended AT Command Reference Table 9-2: STK command details (Continued) Command Description !STKMS=- [, ] Request menu item selection or help from SIM !STKMS=? Supporting Mini Cards: • MC8790 / 90V (minimum FW rev: K1_0_2_3ap) • MC8791V / 92V (minimum FW rev: K1_0_2_4ap) Note: This command is not password-protected. This command is used to tell the SIM to select a menu item or to respond with help information for the menu item via a Display Text command ().
STK Commands Table 9-2: STK command details (Continued) Command Description !STKPD= Update STK supported features profile !STKPD=? This command is used to tell the SIM which STK features are supported by the host. !STKPD? Supporting Mini Cards: • MC8790 / 90V (minimum FW rev: K1_0_2_3ap) • MC8791V / 92V (minimum FW rev: K1_0_2_4ap) Note: This command is not password-protected. Note: The modem must be restarted before the new profile information takes effect.
MC87xx Extended AT Command Reference Table 9-2: STK command details (Continued) Command Description • Byte 03 · Bit 0 — Second capability configuration parameter support (B8b8) · Bit 1 — Sustained display text support (B9b1) · Bit 2 — Send DTMF command support (B9b2) · Bit 3 — Language notification command support (B9b6) · Bit 4 — Launch Browser command support (B9b7) · Bit 5 — Softkey support in select item command (B10b1) · Bit 6 — Softkey support in setup menu command (B10b2) · Bit 7 — Screen size sup
STK Commands STK command () parameters Set Up Call () Table 9-3: Setup Call parameters Parameter Format Description !STKGC parameter — Format: , , , , , , , , , , , , , Rev 2.9 Oct.
MC87xx Extended AT Command Reference Table 9-3: Setup Call parameters (Continued) Parameter Format Description !STKCR parameters Not used Integer • • • • • • • • • 0 — Command performed successfully 1 — Command beyond ME’s capabilities 2 — Currently busy on call 3 — Currently busy with SS transaction 4 — Terminated by user 5 — SS returned Result Error Code 6 — Network currently unable to process command 7 — Call setup not accepted 8 — User cleared down call before connection or networ
STK Commands Table 9-4: Send SS parameters (Continued) Parameter Format Description !STKCR parameters Not used Integer • • • • • • • 0 — Command performed successfully 1 — Command beyond ME’s capabilities 2 — Currently busy with USSD transaction 3 — Currently busy with SS transaction 4 — Terminated by user 5 — SS returned Result Error Code 6 — Network currently unable to process command Send USSD () Table 9-5: Send USSD parameters Parameter Format Description !STKGC
MC87xx Extended AT Command Reference Send SMS () Table 9-6: Send SMS parameters Parameter Format Description !STKGC parameter — Format: , , , , , , , Integer Packing flag • 0 — Packing not required • 1 — Packing required Hex string TPDU string Integer Type of number • 0 — Unknown • 1 — International • 2 — National • 3 — Network specific Integer Numbering plan identifier • 0 — Unknown • 1 —
STK Commands Send DTMF () Table 9-7: Send DTMF parameters Parameter Format Description !STKGC parameter — Format: , , , Hex string DTMF string Hex string Alpha identifier for user confirmation Integer Numeric tag of the icon to display (matches the index in the SIM’s image file) • 0 — No icon • 1..
MC87xx Extended AT Command Reference Table 9-8: Launch browser parameters (Continued) Parameter Format Description Hex string List of one or more allowed bearers, sorted in priority order • “00” — SMS • “01” — CSD • “02” — USSD • “03” — GPRS • Example: “010200” — CSD, USSD, and SMS support; CSD is highest priority Integer Data coding scheme • 0 — 7-bit GSM default alphabet (packed) • 4 — 8-bit GSM default alphabet (unpacked) • 8 — UCS2 alphabet Hex string Gateway text st
STK Commands Play tone () Table 9-9: Play tone parameters Parameter Format Description !STKGC parameter — Format: , , Hex string Alpha identifier for user confirmation Hex string Tone type.
MC87xx Extended AT Command Reference Table 9-10: Display text parameters (Continued) Parameter Format Description Integer Priority information flag • 0 — Do not display priority information • 1 — Display priority information Integer Clear message flag • 0 — Do not allow user to clear message • 1 — Allow user to clear message Integer Numeric tag of the icon to display (matches the index in the SIM’s image file) • 0 — No icon • 1..
STK Commands Table 9-11: Get Inkey parameters (Continued) Parameter Format Description Integer Expected response character format • 0 — SMS default alphabet • 1 — Yes/No response only • 2 — Digits only (0–9, *, #, +) • 3 — UCS2 alphabet Integer Help information flag • 0 — No help information available • 1 — Help information available Integer Numeric tag of the icon to display (matches the index in the SIM’s image file) • 0 — No icon • 1..
MC87xx Extended AT Command Reference Get Input () Table 9-12: Get Input parameters Parameter Format Description !STKGC parameter — Format: , , , , , , , , , , 160 Integer Data coding scheme • 0 — 7-bit GSM default alphabet (packed) • 4 — 8-bit GSM default alphabet (unpacked) • 8 — UCS2 alphabet Hex string Text string in format Integer Expected response charac
STK Commands Table 9-12: Get Input parameters (Continued) Parameter Format Description !STKCR parameters [, ] If the is present, but is an empty string, then a null text string data object must be sent to the SIM. This is caused by the user making an ‘empty’ input.
MC87xx Extended AT Command Reference Table 9-13: Select Item parameters (Continued) Parameter Format Integer Description Icon usage • 0 — Display icon only (replaces ) • 1 — Display with string !STKCR parameters [] ID of item selected, or for which help is requested Integer Identifier of the item that was selected Integer • • • • • 0 — Item selected OK 1 — Terminate proactive session 2 — Help information requested 3 — Backward move
STK Commands Table 9-14: Set Up Menu parameters (Continued) Parameter Format Description Integer Numeric tag of the icon to display (matches the index in the SIM’s image file) • 0 — No icon • 1..
MC87xx Extended AT Command Reference Table 9-15: Set Up Idle Mode parameters (Continued) Parameter Format Description !STKCR parameters Not used Integer • 0 — Text successfully added / removed • 1 — Problem performing operation Language Notification () Table 9-16: Language Notification parameters Parameter Format Description !STKGC parameter — Format: , Integer Language notification type • 0 — Non-specific language notification • 1 — Speci
STK Commands Table 9-17: Response notification to MO Call Control request parameters Parameter Format Description Integer BC repeat indicator • 1 — Alternate mode • 3 — Sequential mode Hex string Alpha identifier Integer Type of number • 0 — Unknown • 1 — International • 2 — National • 3 — Network specific Integer Numbering plan identifier • 0 — Unknown • 1 — ISDN telephony • 3 — Data • 4 — Telex • 9 — Private Hex string New dialing address
MC87xx Extended AT Command Reference Table 9-18: Response notification to MO SMS Control request parameters Parameter 166 Format Description Integer Type of number • 0 — Unknown • 1 — International • 2 — National • 3 — Network specific Integer Numbering plan identifier • 0 — Unknown • 1 — ISDN telephony • 3 — Data • 4 — Telex • 9 — Private Hex string RP (Relay Layer Protocol) address Hex string TP (Transport Layer Protocol) address 2130616
A Appendix A:Test Frequencies / Channel Lists The following tables describe the frequencies and channels typically used when checking receiver paths for the UMTS Mini Card embedded modules. Table A-1: GSM / EDGE channels 1 Frequency (MHz) Band GSM850 EGSM900 DCS1800 PCS1900 1 Rev 2.9 Oct.08 Channel MX Tx MS Rx 128 824.20 869.20 190 836.60 881.60 251 848.80 893.80 975 880.20 925.20 979 881.00 926.00 62 902.40 947.40 65 903.00 948.00 120 914.00 959.00 124 914.80 959.
MC87xx Extended AT Command Reference Table A-2: WCDMA Channels 1 Band UMTS Band I (2100) UMTS Band II (1900) UMTS Band V (850) UMTS Band Viii (900) Tx Channel UE Tx (MHz) Rx Channel UE Rx (MHz) 9612 1922.40 10562 2112.40 9750 1950.00 10700 2140.00 9888 1977.60 10838 2167.60 9262 1852.40 9662 1932.40 9400 1880.00 9800 1960.00 9538 1907.60 9938 1987.60 4132 826.40 4357 871.40 4182 836.40 4407 881.40 4233 846.60 4458 891.60 2712 882.40 2937 927.40 2787 897.
B Appendix B:HSDPA / HSUPA Categories The following tables describe standard HSDPA and HSUPA categories. Table B-1: HSDPA-capable terminals Category Maximum number of supported HS-DSCH codes Minimum inter-TTI interval Number of soft values in terminal’s hybrid ARQ buffer Theoretical download maximum (L1 peak rate [Mbps]) Modulation Category 1 5 3 19,200 1.2 16QAM, QPSK Category 2 5 3 28,800 1.2 16QAM, QPSK Category 3 5 2 28,800 1.8 16QAM, QPSK Category 4 5 2 38,400 1.
MC87xx Extended AT Command Reference 170 2130616
C Appendix C: ASCII Table Char Dec Hex Char Dec Hex Char Dec Hex Char Dec Hex NUL 0 00 SP 32 20 @ 64 40 ‘ 96 60 SOH 1 01 ! 33 21 A 65 41 a 97 61 STX 2 02 “ 34 22 B 66 42 b 98 62 ETX 3 03 # 35 23 C 67 43 c 99 63 EOT 4 04 $ 36 24 D 68 44 d 100 94 ENQ 5 05 % 37 25 E 69 45 e 101 95 ACK 6 06 & 38 26 F 70 46 f 102 96 BEL 7 07 ’ 39 27 G 71 47 g 103 97 BS 8 08 ( 40 28 H 72 48 h 104 98 HT 9 09
MC87xx Extended AT Command Reference 172 2130616
D Appendix D: Module Customization Various modem features can be customized to meet individual carrier or oem needs. The following procedure describes how to prepare the modem for customization, maintain profiles, and customize various features. Note: Some customizations described in this section may only be available on specific modules (for example, GPS customizations) or for specific minimum firmware versions.
MC87xx Extended AT Command Reference g. Mark the minimum acceptable Quality of Service profile as undefined: AT+CGQMIN= (See 3GPP TS 27.007) h. Mark the 3G Quality of Service profile as undefined: AT+CGEQREQ= (See 3GPP TS 27.007) i. Mark the minimum acceptable 3G Quality of Service profile as undefined: AT+CGEQMIN= (See 3GPP TS 27.007) j. Mark PDP context parameter values as undefined: AT+CGDCONT= (See 3GPP TS 27.007) k.
Module Customization Enable / disable FDN check for PS data calls: AT!CUSTOM=”DISFDNPDPCHK”, (page 33) · Note: The customizations in this step affect the interfaces between the modem and the user (drivers, API, CnS, Watcher)—they do not affect the modem directly. Rev 2.9 Oct.08 14. If desired, configure Watcher 3G and Windows driver functionality: a.
MC87xx Extended AT Command Reference (=1), the object is set as “voice”, and headset indications and other voice‐related CnS notifications are sent to the host. If is 0 or 1, voice calls can be made using the AT command interface.) h. Note: The host device needs to include a facility for restoring these settings after the modem power cycles.
Module Customization 18. Enable or disable scan profile (try all profiles configured on card until a successful connection is found): AT!CUSTOM=”SCANPROF”, (page 33) 19. (Mini Cards only) Enable / disable slow clocking mode: AT!SLEEP = (page 53) 20. Clear the error log: AT!ERR=0 (page 57) 21. Back up data: Note: Profiles (PDP contexts) are not restored from these backups. Host application software is responsible for this task if profiles become corrupted. a.
MC87xx Extended AT Command Reference 178 2130616