Sierra Wireless MC8775 Reference Manual
  1. Manuals
  2. Brands
  3. Sierra Wireless Manuals
  4. Modem
  5. AirPrime MC8775
  6. Reference manual

Sierra Wireless MC8775 Reference Manual

3g wwan modem minipci express mc87 series extended at command reference
Hide thumbs Also See for MC8775:
Table of Contents

Advertisement

Quick Links

MC87xx Modem
Extended AT Command Reference
Proprietary and Confidential
Includes:
MC8775 / MC8775V
MC8780 / MC8781
MC8785V
MC8790 / MC8790V
MC8791V
MC8792V
2130616
Rev 2.9

Advertisement

Table of Contents
loading

Related Manuals for Sierra Wireless MC8775

Summary of Contents for Sierra Wireless MC8775

  • Page 1 MC87xx Modem Extended AT Command Reference Proprietary and Confidential Includes: MC8775 / MC8775V MC8780 / MC8781 MC8785V MC8790 / MC8790V MC8791V MC8792V 2130616 Rev 2.9...
  • Page 3 Do not operate the Sierra Wireless modem in any aircraft,  whether the aircraft is on the ground or in flight. In aircraft, the  Sierra Wireless modem MUST BE POWERED OFF. When  operating, the Sierra Wireless modem can transmit signals that  could interfere with various onboard systems. Note: Some airlines may permit the use of cellular phones while the aircraft is on the ground and the door is open. Sierra Wireless modems may be used at this time. The driver or operator of any vehicle should not operate the  Sierra Wireless modem while in control of a vehicle. Doing so  will detract from the driver or operatorʹs control and operation  of that vehicle. In some states and provinces, operating such ...
  • Page 4 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. Notwithstanding the foregoing, in no event shall Sierra  Wireless and/or its affiliates aggregate liability arising under or  in connection with the Sierra Wireless product, regardless of  the number of events, occurrences, or claims giving rise to  liability, be in excess of the price paid by the purchaser for the  Sierra Wireless product. Patents Portions of this product may be covered by some or all of the  following US patents: 5,515,013 5,629,960 5,845,216 5,847,553 5,878,234 5,890,057 5,929,815 6,169,884 6,191,741 6,199,168 6,339,405 6,359,591 6,400,336 6,516,204 6,561,851 6,643,501 6,653,979 6,697,030 6,785,830 6,845,249 6,847,830 6,876,697 6,879,585...

  • Page 5: Contact Information

    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 to 5:00 Pacific Time sales@sierrawireless.com E-mail: Post: Sierra Wireless 13811 Wireless Way Richmond, BC Canada V6V 3A4 Fax: 1-604-231-1109 www.sierrawireless.com Web: Consult our website for up‐to‐date product descriptions,  documentation, application notes, firmware upgrades, trouble‐ shooting tips, and press releases: www.sierrawireless.com Rev 2.9 Oct.08...

  • Page 6: Revision History

    MC87xx Extended AT Command Reference Revision History Revision Release Changes number date !SCPROFSWOPT • Jul 2007 Fixed syntax (page 52) !DAWINFO • Added new RxD parameters to (page 76) !GBAND • Fixed supported bands values (page 58) !CUSTOM • Updated customization descriptions, and added new custom- izations (HSDPATEST, CSDOFF, AUTONETWORKMODE) (page 33) !BPLMNTIMER...
  • Page 7 Preface Revision Release Changes number date • Mar 2008 Updated ‘supporting modules’ lists !NVPORTMAP AVEXTPCMSEL • (page 46) and (page 99) flagged as not supporting MC8785V !NVDEF !NVRESTORE • Added clarification to (page 85) and (page 86) descriptions • Added new audio profile IDs (6 and 7 for external PCM profiles !GPSXTRASTATUS •...
  • Page 8 MC87xx Extended AT Command Reference Proprietary and Confidential 2130616...

  • Page 9: Table Of Contents

    Table of Contents About This Guide .........13 Introduction .
  • Page 10 MC87xx Extended AT Command Reference Test Commands ......... . 63 Introduction .
  • Page 11 Table of Contents Introduction ........... . . 143 STK interactions .
  • Page 12 MC87xx Extended AT Command Reference 2130616...

  • Page 13: About This Guide

    The AT commands in this document are specific to the Sierra  the ‘Supported’ reference. Wireless MC8775  /   7 5V, MC8780  /   8 1, MC8785V, MC8790  /   9 0V,  MC8791V, and MC8792V embedded modems. Note: When designing applications that use these AT commands, use ® Watcher (and other Sierra Wireless applications) as functionality templates to ensure proper use of command groups.

  • Page 14: Command Timing

    MC87xx Extended AT Command Reference AT!ENTERCND The password assigned to   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. When building automated test scripts, ensure that sufficient  delays are embedded where necessary to avoid these errors. Result codes Result codes are not shown in the command tables unless  special conditions apply. Generally the result code   is  ERROR returned when the command has been executed.   may  be returned if parameters are out of range, and will be  returned if the command is not recognized or is not permitted  in the current state or condition of the modem. References This guide covers the command sets used by OEMs, designers  and testers of the Sierra Wireless MC87xx Embedded Modem.  It does not deal with operational use commands. For normal  operations of the modem, consult the UMTS Modems Supported  AT Command Reference (document number 2130617). You may also want to consult the other documents available in  the MC87xx Development Kit or on our Internet site at www.sierrawireless.com Terminology and acronyms This document makes wide use of acronyms that are in ...

  • Page 15: Current Firmware Versions

    Rev 2.9 9 October 2008 release. Applicability of commands to different modules Each  command listed in this guide includes a list of supporting  MC87xx modules. Unless otherwise noted, the following  minimum firmware revisions are required to support the listed  commands: • MC8775 / MC8775V  –   R evision H1_0_0_0 or higher • MC8780 / MC8781  –   R evision D1_0_3_0ap / F1_0_0_0ap or  higher • MC8785V  —   R evision J1_0_1_0ap or higher • MC8790 / MC8790V  —   R evision K1_0_0_0ap or higher •...

  • Page 16: At Password Commands

    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 ...
  • Page 17 !NVPLMNCLR Reset Network Personalization data MC8780 / 81 MC8785V MC8790 / 90V !NVPORTMAP Change modem port mappings in non-MUX mode MC8775 / 75V MC8780 / 81 !NVSWOC Configure Software on Card feature MC8780 / 81 MC8785V !PCINFO Return power control status information...
  • Page 18 MC87xx Extended AT Command Reference Table 1-2: Modem status and reset commands (Continued) Command Description Supporting Mini Cards !SLEEP Query / set Sleep Enable state !SWOCMODE Set module operating mode MC8780 / 81 !UOOS Query / set UMTS ‘Out of Service’ parameters a.
  • Page 19 About This Guide Table 1-4: Test commands (Continued) Command Description Supporting Mini Cards !DAGGRSSI Return the RSSI value in dBm (GSM only) !DAGGRSSIRAW Return the raw RSSI value !DAGINFO Return GSM mode RF information (GSM only) !DAGSLOCK Return the synthesizer lock state !DAGSRXBURST Set the GSM receiver to burst mode !DAGSRXCONT...
  • Page 20 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 Description Supporting Mini Cards !NVDEF Reset non-volatile memory !NVRESTORE Restore backup data This chapter describes voice commands.  Voice Commands Voice is supported on the MC8775V, MC8785V, and MC8790V  modems. Table 1-6: Voice commands Command Description Supporting Mini Cards !AVAUDIOLPBK...
  • Page 21 About This Guide Table 1-6: Voice commands (Continued) Command Description Supporting Mini Cards AVEXTPCMSEL Query / set external PCM interface for profile MC8775V AVEXTPCMSTOPCLKOFF Enable / disable ability to turn off the external PCM MC8775V interface clock MC8785V MC8790V !AVMICGAIN Set / query the microphone gain MC8775V MC8785V...
  • Page 22 MC87xx Extended AT Command Reference Table 1-7: GPS commands Command Description Supporting Mini Cards !GPSAUTOSTART Configure GPS auto-start features MC8780 / 81 MC8785V MC8790 / 90V MC8791V MC8792V !GPSCLRASSIST Configure GPS auto-start features MC8780 / 81 MC8785V MC8790 / 90V MC8791V MC8792V !GPSCOLDSTART...
  • Page 23 About This Guide Table 1-7: GPS commands (Continued) Command Description Supporting Mini Cards !GPSMTLRSETTINGS Set / query MT location request settings MC8780 / 81 MC8785V MC8790 / 90V MC8791V MC8792V !GPSNIQOSTIME Set / query GPS QoS timeout period for network- MC8780 / 81 initialized fixes MC8785V...
  • Page 24 MC87xx Extended AT Command Reference Table 1-7: GPS commands (Continued) Command Description Supporting Mini Cards !GPSTRANSSEC Control GPS transport security MC8780 / 81 MC8785V MC8790 / 90V MC8791V MC8792V !GPSXTRADATAENABLE Set / query GPS XTRA settings MC8780 / 81 MC8785V MC8790 / 90V MC8791V MC8792V...
  • Page 25 About This Guide STK Commands This chapter describes SIM Application  Toolkit commands. STK commands are supported on the  MC8790, MC8790V, MC8791V, and MC8792V modems. Table 1-8: GPS commands Command Description Supporting Mini Cards !STKC Receive unsolicited SIM command MC8790 / 90V MC8791V MC8792V !STKCR Respond to unsolicited SIM command MC8790 / 90V MC8791V MC8792V !STKGC Retrieve data for unsolicited SIM command MC8790 / 90V MC8791V MC8792V...
  • Page 26 MC87xx Extended AT Command Reference Characters that are required are shown in uppercase; param‐ eters are noted in lowercase. Required parameters are enclosed  <n> in angle brackets ( ) while optional parameters are enclosed  within square brackets ( ). 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. Commands are in  ASCII alphabetical order in the body of each chapter. Any default settings are noted in the command tables. Note  that these are the factory default settings and not the default  parameter value assumed if no parameter is specified. This is a numeric or text code that is returned  Result Code after all commands (except resets). Only one result code is  returned for a command line regardless of the number of  individual commands contained on the line. This term indicates a response from the modem  Response that is issued prior to a result code. Reading registers or  issuing commands that report information will provide a  response followed by a result code unless the command  generates an error. Responses and result codes from the modem, or host system  software prompts, are shown in this font: CONNECT 14400 2130616...

  • Page 27: Introduction

    2: AT Password Commands • Introduction • Command summary Introduction • Command reference 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. Table 2-1: AT command passwords Command Description Page !ENTERCND Enable access to password-protected commands !SETCND Set AT command password Command reference Table 2-2: AT command password details Command Description...
  • Page 28 Password length = 4–10 characters (0–9, A–Z, upper or lower case) Warning: Do NOT enter a null password (that is, the <“Key”> cannot be ““) — you will NOT be able to use password-protected commands, and will have to contact Sierra Wireless for help to reset the password. 2130616...

  • Page 29: Introduction

    3: Modem Status, Customization, and Reset Commands • Introduction • Command summary Introduction • Command reference 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. Table 3-1: Modem status commands Command Description Page !BPLMNTIMER Query / set data inactivity timer value !BSMCCHECK Return the modem hardware version !CMEN Enable / disable HSPA Compressed Mode stack functionality !CUSTOM...
  • Page 30 MC87xx Extended AT Command Reference Table 3-1: Modem status commands (Continued) Command Description Page !NVMUXMODE Query / set USB descriptor MUX mode !NVOEM Query / set values of non-volatile (NV) memory items !NVPLMN Provision the PLMN list for Network Personalization locking !NVPLMNCLR Reset Network Personalization data !NVPORTMAP...
  • Page 31 Supporting Mini Cards: data traffic – the timer resets to zero each time PS data traffic is received. • MC8775 / 75V (minimum After the timer expires, a background PLMN scan to find a home or more- FW rev: H1_1_8_12mcap) prefered PLMN network occurs (note that while the scan is in progress, •...
  • Page 32 MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Enable / disable HSPA Compressed Mode stack Version 1 and Version 2: !CMEN? functionality Version 1 and Version 2: This command enables or disables HSDPA and HSUPA (for supporting !CMEN=? modules) compressed mode functionality in the stack—it is typically used during testing of production networks.
  • Page 33 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !CUSTOM? Set / query customization settings This command identifies or sets several customization values. !CUSTOM=? Usage: • AT!CUSTOM? indicates customizations that are currently enabled !CUSTOM= •...
  • Page 34 MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Set / query customization settings (Continued) !CUSTOM (Continued) • “MEPCODE”—Enable / disable prompt for MEP code when incorrect SIM is inserted <value>: 0 = Disable; 1 = Enable. •...
  • Page 35 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !CUSTOM Set / query customization settings (Continued) (Continued) • “PUKPRMPT”—Indicate if host will prompt for PUK code if maximum number of PIN unlock retries is exceeded <value>: 0 = Don’t prompt;...
  • Page 36 All MC87xx modems have one thermistor to measure the temperature of the PA used by the WCDMA transceiver, and all MC87xx modems (except for MC8775 / MC8775V) have a second thermistor to measure the temperature of the PA used by the GSM transceiver.
  • Page 37 AT!EQEN? returns the current <enableFlag> value. Supporting Mini Cards: • AT!EQEN=? returns a list of supported <enableFlag> values in the • MC8775 / 75V (minimum format <enableFlag> – <description>. FW rev: H1_0_0_7 / • AT!EQEN=<enableFlag> enables / disables the L1 equalizer.
  • Page 38 MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Enable / disable GCF test mode !GCFEN? This command is used to place the modem in GCF testing mode or normal !GCFEN=? operating mode. Usage: !GCFEN=<enableFlag>...
  • Page 39 !HSDCAT=<category> • AT!HSDCAT=? returns a list of supported <category> values in the Supporting Mini Cards: format (<category> | <category> | ... ) • MC8775 / 75V (minimum • AT!HSDCAT=<category> sets the HSDPA category. FW rev: H2_0_1_0mcap) Parameters: • MC8780 / 81 <category>...
  • Page 40 MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Query / set LED control pattern !LEDCTRL? This command is used to control the behavior of the LED. !LEDCTRL=<index>, <period>,<ontime> Note: The ‘time’ parameters (<period> and <ontime>) use 100 ms units (MC8785V, MC879xV) for MC8785V and MC879xV.
  • Page 41 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Query / set MUX mode port mappings !MXPORTMAP? This command is used to set the modem’s MUX-mode DLCI port !MXPORTMAP=<mode> mappings for AT and PDP2. Usage: Supporting Mini Cards: •...
  • Page 42 MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Query / set supported NAS release compliance version !NASREL? This command is used to configure the modem to support a specific NAS !NASREL=? (Non-Access Stratum) release compliance version. Usage: !NASREL=<nasrel>...
  • Page 43 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !NVENCRYPTIMEI= Write unencrypted IMEI to modem <PI>,<P2>,<P3>,<P4>, This command writes an unencrypted IMEI to a modem if the modem <P5>,<P6>,<P7>,<P8> does not already have an IMEI—it can only be used once per modem. Supporting Mini Cards: The IMEI is a fifteen digit string formed by concatenating the following •...
  • Page 44 MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Query / set USB descriptor MUX mode !NVMUXMODE=? This command is used to change the mode (MUX / non-MUX) in which the !NVMUXMODE? Windows driver operates. In non-MUX mode, supported ports are: !NVMUXMODE=<mode>...
  • Page 45 > • AT!NVOEM?<item> returns the current configuration of the specified Supporting Mini Cards: <item> in 1-byte <values> (displayed as hexadecimal values) • MC8775 / 75V (minimum • AT!NVOEM=<item>, <value >, ..., <value > writes the specified FW rev: H1_1_5_2) configuration <values> (1-byte each) to the NV <item>...
  • Page 46 (not FTM mode) for this to <normMode> work. [,<diagMode>] Parameters: Supporting Mini Cards: <normMode>—Port map in normal mode → • MC8775 / 75V • 00 = AT UART1 → → • MC8780 / 81 •...
  • Page 47 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !NVSWOC? Configure Software on Card feature ™ This command is used to enable and configure the TRU-Install !NVSWOC=<config> (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.
  • Page 48 MC87xx Extended AT Command Reference Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Return power control status information !PCINFO? Supporting Mini Cards: This command returns the modem’s power control status in the format: • State: <state> LPM force flags: W_DISABLE:0, User:0, Temp:0, Volt:0 Note: This command is not W_DISABLE: <w_disable>...
  • Page 49 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !PCINFO Return power control status information (Continued) (Continued) (FW rev D0_0_4_2ap and later) <pwroff> (Current power off mode—preset by device manufacturer): • 0 = Enter LPM when W_DISABLE is asserted •...
  • Page 50 This command is used to report or set the module’s PRI part number and !PRIID=<priPn>, <priRev> PRI revision. Usage: Supporting Mini Cards: • • MC8775 / 75V (minimum AT!PRIID? returns the module’s PRI part number (<priPn>) and FW rev: H1_1_5_1) revision (<priRevDisplay>). Example: • MC8780 / 81...
  • Page 51 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description Query / set active protocol / revision !REL? This command is used to configure the modem to use specific protocol, !REL=? SGSN, and MSC revisions, and to indicate the current settings. Usage: !REL=<wcdmarrc>...
  • Page 52 Supporting Mini Cards: During WCDMA acquisition, L1 (stack layer 1) uses a raw scan every ten • MC8775 / 75V (minimum channels to discover potential candidates, followed by a finer scan based FW rev: H1_1_8_13mcap) on those candidates. For embedded modules in host devices, the default threshold can be very close to the noise floor of the host.
  • Page 53 Modem Status, Customization, and Reset Commands Table 3-2: Modem status, customization, and reset commands (Continued) Command Description !SCROPROF?<pid> Set / query profile’s read-only flag This command is used to set / query the read-only flag of a profile. !SCROPROF=<ro_flag>, Usage: <pid>...
  • Page 54 This command is used to indicate the current state of the Sleep Enable feature, and to set the state of the feature. Supporting Mini Cards: Usage: • MC8775 / 75V (minimum • AT!UOOS? reports the current <sleep>, <totalscan>, <umtsscan>, and FW rev: H1_1_8_9mcap) <gsmscan> settings.

  • Page 55: Command Summary

    4: Diagnostic Commands • Introduction • Command summary Introduction • Command reference This chapter describes commands used to diagnose modem  problems.  Command summary The table below lists the commands described in this chapter. Table 4-1: Diagnostic commands Command Description Page !CMUX Implement multiplexing mode !CMUXLPBK Configure ports into loopback mode / query loopback state !ERR Display diagnostic information !GBAND Read / set the current operating band $QCPDPP...
  • Page 56 MC87xx Extended AT Command Reference Table 4-2: Diagnostic command details (Continued) Command Description Configure ports into loopback mode / query loopback !CMUXLPBK = <bitmask> state !CMUXLPBK? This command is used to select a multiplexed port and to loop data traffic Supporting Mini Cards: between the host and the modem over that port.
  • Page 57 Display diagnostic information Supporting Mini Cards: 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.
  • Page 58 MC87xx Extended AT Command Reference Table 4-2: Diagnostic command details (Continued) Command Description Read / set the current operating band !GBAND=<bandmask> This command is used to read or set the current operating bands (1 or !GBAND? more) of the modem. Supporting Mini Cards: Usage: •...
  • Page 59 Diagnostic Commands Table 4-2: Diagnostic command details (Continued) Command Description $QCPDPP=<cid>, Set / query PDP-IP connection authentication <auth_type>,<password>, parameters <username> This command sets authentication requirements (username, password) for PDP-IP packet data calls for each supported profile. $QCPDPP? Usage: Supporting Mini Cards: •...
  • Page 60 MC87xx Extended AT Command Reference Table 4-2: Diagnostic command details (Continued) Command Description Enable / disable WCDMA receive diversity !RXDEN? This command enables or disables WCDMA receive diversity, or !RXDEN=<state> establishes receive diversity as the primary path. Usage: !RXDEN=? • AT!RXDEN? returns the current <state>...
  • Page 61 Diagnostic Commands Table 4-2: Diagnostic command details (Continued) Command Description !UMTSCHAN? Query / set Priority UMTS Channel Selection state The modem can be set to scan a ‘priority’ UMTS channel when the !UMTSCHAN modem powers up, before scanning other frequencies. This allows you to =<flag>[,<DL_UARFCN>] use the modem on a test cell network (that uses the priority UMTS channel) in an area where a UMTS network already exists—the modem...
  • Page 62 MC87xx Extended AT Command Reference 2130616...

  • Page 63: Test Commands

    5: Test Commands • Introduction • Command summary • Command reference Introduction • Sample AT command sequences 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.  Therefore, the order in which you issue certain commands is  important. Three AT commands are important in setting the  mode: !DAFTMACT • —puts the modem in factory test mode (a non‐ AT!DAFTMACT signaling mode). You must issue   before  issuing any other command that starts with “ ”. !DASBAND • —selects the frequency band.  AT!DASBAND You must execute   to select a WCDMA band  in order to run these commands that test the WCDMA ...
  • Page 64 MC87xx Extended AT Command Reference Command summary The table below lists the commands described in this chapter. Table 5-1: Test commands Command Description Page !DAFTMACT Put the modem into FTM mode !DAFTMDEACT Put the modem from FTM mode into online mode !DAGGAVGRSSI Return an averaged RSSI value in dBm (GSM only) !DAGGRSSI Return the RSSI value in dBm (GSM only) !DAGGRSSIRAW...

  • Page 65: Command Reference

    Test Commands Table 5-1: Test commands (Continued) Command Description Page !DAWSTXCW Set the waveform used by the transmitter !OSDSM Display memory usage for DSM buffer pools Command reference Table 5-2: Test command details Command Description !DAFTMACT Put the modem into FTM mode Supporting Mini Cards: FTM (Factory Test Mode) is a non-signaling mode that allows the radio •...
  • Page 66 MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description Return an averaged RSSI value in dBm (GSM only) DAGGAVGRSSI =<channel>, <LNA Index> This command returns an averaged RSSI (Received Signal Strength Supporting Mini Cards: Indicator) value in dBm. •...
  • Page 67 Test Commands Table 5-2: Test command details (Continued) Command Description !DAGINFO Return GSM mode RF information (GSM only) Supporting Mini Cards: 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 Returned parameters command.
  • Page 68 MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description Return the synthesizer lock state !DAGSLOCK Supporting Mini Cards: This command returns a value indicating the lock state of the RF • synthesizers: • 0 — one or more synthesizers are out of lock Note: The modem must be in •...
  • Page 69 Test Commands Table 5-2: Test command details (Continued) Command Description !DAGSTXBURST Set the GSM transmitter to burst mode =<source>,<TSCindex> This command sets the transmitter to start or stop sending bursts. <burstDur> Parameters: Supporting Mini Cards: • <source>: • 0 = Random data •...
  • Page 70 MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description Place modem offline !DAOFFLINE Supporting Mini Cards: This commands puts the modem offline. • Parameters: • None Set the frequency band !DASBAND =<rfband> This command sets the modem to use a particular frequency band. You Supporting Mini Cards: must use this command to select a WCDMA band before running WCDMA •...
  • Page 71 Test Commands Table 5-2: Test command details (Continued) Command Description !DASCHAN Set the modem channel (frequency) =<rfchannel> This command sets the modem to operate on a particular frequency Supporting Mini Cards: channel. Before using this command to set the channel, use the command •...
  • Page 72 MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description Set the LNA gain state !DASLNAGAIN =<gain index> This command sets the LNA (Low Noise Amplifier) range for the main or diversity path (if applicable), in either WCDMA or GSM mode. !DASLNAGAIN =<gain index>...
  • Page 73 Test Commands Table 5-2: Test command details (Continued) Command Description !DASPDM Set the PDM value =<PDM ID>,<PDMvalue> This command adjusts the PDM (Pulse Duration Modulation), allowing you Supporting Mini Cards: to apply frequency offset to the LO (Local Oscillator). • Parameters: <PDM ID>...
  • Page 74 MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description Turn the TX PA on !DASTXON Supporting Mini Cards: 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...
  • Page 75 Test Commands Table 5-2: Test command details (Continued) Command Description !DAWGRXAGC Return the RX AGC value (WCDMA only) !DAWGRXAGC?<path> 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 Supporting Mini Cards: RSSI (Received Signal Strength Indicator) in dBm.
  • Page 76 MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description Return WCDMA mode RF information (WCDMA only) !DAWINFO Supporting Mini Cards: This command returns RF information for WCDMA mode when the modem • is in CELL_DCH (Designated Channel) state. Note: The modem must be in Note: !DAGINFO provides RF information for GSM mode.
  • Page 77 Test Commands Table 5-2: Test command details (Continued) Command Description !DAWSCONFIGRX Set the WCDMA receiver to factory calibration settings =<channel>, <Rx_Level_dBm> This command configures the WCDMA receiver according to factory calibration settings stored in the modem’s NV (Non-Volatile memory). This Supporting Mini Cards: allows for accurate measurement of RX AGC levels.
  • Page 78 MC87xx Extended AT Command Reference Table 5-2: Test command details (Continued) Command Description Set the PA range state machine !DAWSPARANGE =<PA range> This command sets the PA range state machine in WCDMA operation. Supporting Mini Cards: Parameters: • <PA range>: •...
  • Page 79 Test Commands Table 5-2: Test command details (Continued) Command Description !DAWSCHAINTCM Place receive chain in test call mode (WCDMA only) =<chain> This command places one or both of the primary and secondary receive Supporting Mini Cards: chains in test call mode. •...

  • Page 80: Sample At Command Sequences

    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 Function AT!ENTERCND= Enters the password, providing access to the necessary commands “password” AT!DAFTMACT Puts the modem into factory test mode AT!DASBAND=16...

  • Page 81: Turning On The Tx In Gsm Mode

    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 Function AT!ENTERCND= Enters the password, providing access to the necessary commands “password” AT!DAFTMACT Puts the modem into factory test mode AT!DASBAND=12 Sets the frequency band to GSM 1900...

  • Page 82: Turning On The Rx And Reading Rssi In Gsm Mode

    MC87xx Extended AT Command Reference Table 5-5: Command sequence for reading the RSSI in WCDMA mode (Continued) Command Function AT!DAWSCONFIGRX Configures the WCDMA receiver using the factory calibration =9263,-80 information for channel 9263 at the expected RX level of -80 dBm AT!DAWGRXAGC Reports the RX AGC value.
  • Page 83 Test Commands Setting the LNA gain !DASLNAGAIN The LNA gain state ( ) is set based on the  Note: The gain state values expected receive power level. The table below shows the  listed here are provided as a approximate switch point values from low gain to high gain.  guideline. The values are (These are different than the values for high gain to low gain.)  approximations and subject to change over time. Table 5-7: LNA gain index values Gain WCDMA index...
  • Page 84 MC87xx Extended AT Command Reference 2130616...

  • Page 85: Memory Management Commands

    6: Memory Management Commands • Introduction • Command summary Introduction • Command reference 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. Command summary The table below lists the commands described in this chapter: Table 6-1: Memory management command passwords Command Description Page !NVDEF Reset non-volatile memory !NVRESTORE Restore backup data Command reference Table 6-2: Memory management command details Command...
  • Page 86 MC87xx Extended AT Command Reference Table 6-2: Memory management command details (Continued) Command Description Restore backup data !NVRESTORE =<category> This command restores items to non-volatile memory that were backed up with Supporting Mini Cards: the command AT!NVBACKUP, and returns the number of NV items restored. •...

  • Page 87: Voice Commands

    7: Voice Commands • Introduction • Audio profiles • Command summary Introduction • Command reference 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.The modems have a  wide range of software‐controlled, audio filtering and amplifi‐ cation stages, which minimize the amount of external circuitry  required on the host system. At its most basic configuration, the host audio system could  contain:  • A microphone / speaker combination (handset) —or— •  A headset jack  The audio pass band for the primary and secondary audio  paths extends from 300 Hz to 3.4 kHz in both the receive and  transmit directions.  These transmit audio features are supported: • Adjustable gain up to +40 dB • Several adjustable filtering stages (high‐pass and slope  filters)  •...
  • Page 88 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. Phone‐ oriented functions such as echo cancellation and FIR filtering  are typically left to the module, while path‐switching and  transducer interfaces are the responsibility of the PDA codec.  Functions such as adjustable gain and volume settings, DTMF  and ringer tone generation, and mixing can be accomplished in  either codec, depending on the architecture of the particular  product. The interface between the module and host audio  systems is usually the primary audio interface set to line‐level  amplitudes, routed as differential pairs for noise immunity.  Figure 7-1: Audio block diagram Audio profiles The AT command set allows you to have different audio  configurations for different purposes. As an example, assume  you are embedding the module in a device that has a handset  mode and a speakerphone mode. Assume also that you want  to use different transmit gain, noise suppression, and echo  cancellation settings in each mode. You can store the settings  for each mode in separate audio profiles, then activate the  appropriate profile as your application switches to handset or  speakerphone mode. 2130616...
  • Page 89 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  /   M C8790V  /   M C8791V  /   M C8792V only) 6—Auxiliary external PCM (128 kHz clock) • (MC8785V  /   M C8790V  /   M C8791V  /   M C8792V only) 7—Primary external PCM (2 MHz clock) AT commands that are used to change the audio configuration ...

  • Page 90: Command Summary

    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  AT!AVSET- profile other than Profile 0, use the command  PROFILE  (described on page 106) to activate the profile prior to  establishing the call. Command summary The table below lists the commands described in this chapter: Table 7-2: Voice command passwords Command Description Page !AVAUDIOLPBK Enable / disable an audio loopback !AVCODECRXG Set / query CODEC RX gain !AVCODECSTG Set / query CODEC sidetone gain !AVCODECTXG...

  • Page 91: Command Reference

    Voice Commands Table 7-2: Voice command passwords Command Description Page !AVTXPCMFLTR Set / query the TX PCM filter tap !AVTXVOL Set the TX volume Command reference Table 7-3: Voice command details Command Description !AVAUDIOLPBK Enable / disable an audio loopback =<enable>...
  • Page 92 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Set / query CODEC RX gain !AVCODECRXG =<profile>, <value> 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 !AVCODECRXG? conversion to the analog domain to provide additional gain range from - <profile>...
  • Page 93 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVCODECSTG Set / query CODEC sidetone gain =<profile>, <value> 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 !AVCODECSTG? as heard on the mobile's speaker, and the gain ranges from -84dB to <profile>...
  • Page 94 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Set / query the TX gain !AVCODECTXG =<profile>, <value> 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 !AVCODECTXG? from the analog domain to provide additional gain range from -84dB to +12dB in the transmit direction.
  • Page 95 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVDEF Set audio settings to default values Supporting Mini Cards: This command sets all the configurable audio parameters to default • MC8775V values. The default values are also loaded into non-volatile memory. •...
  • Page 96 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Set the audio volume and DTMF volume for each audio !AVDTMFVOLDB =<profile>, <method>, type <level>, <value> This command sets the audio volume and the DTMF volume level for voice and key beep tones.
  • Page 97 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVEC Set / query the echo cancellation setting =<profile>, <value> This command sets the echo cancellation mode for the specified profile. The echo canceller monitors the conversation and eliminates the echo !AVEC?<profile>...
  • Page 98 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Configure external PCM interface !AVEXTPCMCFG =<clock>, <format>, This command configures the external PCM interface by specifying the <padding> clock speed, the format, and enabling / disabling padding. Supporting Mini Cards: The change takes place immediately if the current audio profile uses the •...
  • Page 99 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVEXTPCMSEL? Query / set external PCM interface for profile <profile> This command enables or disables the external PCM interface for a specific audio profile—the change takes effect after the modem is reset. !AVEXTPCMSEL Usage: = <profile>, <value>...
  • Page 100 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Enable / disable ability to turn off the external PCM !AVEXTPCMSTOPCLKOFF? interface clock !AVEXTPCMSTOPCLKOFF If the current audio profile uses the external PCM interface, this = <value> command enables or disables the ability to turn off the external PCM Supporting Mini Cards: interface clock—the change takes effect after the modem is reset.
  • Page 101 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVMICGAIN Set / query the microphone gain =<profile>, <value> 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 !AVMICGAIN? +49.5 dB (steps of 1.5 dB).
  • Page 102 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Enable / disable noise suppression !AVNS =<profile>, <value> This command sets the noise suppression setting for a specified profile. The noise suppressor reduces or eliminates continuous background !AVNS?<profile>...
  • Page 103 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVRXAGC Set / query RX AVC / AGC configuration =<profile>, <value> This command sets the RX AVC / AGC (Automatic Volume Control / Automatic Gain Control) configuration for the specified profile. The RX !AVRXAGC? AGC compensates for variations in audio gains from the landline side, <profile>...
  • Page 104 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Set / query the RX PCM filter tap !AVRXPCMFLTR =<profile>, <tap>, The MC87xx modem has a 7-tap PCM (Pulse Code Modulation) filter. <value> This command sets the RX PCM filter tap for the specified profile. !AVRXPCMFLTR? Note: This command is only useful when embedding the MC87xx <profile>, <tap>...
  • Page 105 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVRXPCMFLTR Set / query the RX PCM filter tap (Continued) (Continued) Parameters: <profile> (audio profile number): • 0 = Handset • 1 = Headset • 2 = Car kit • 3 = Speaker phone •...
  • Page 106 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Activate a profile !AVSETPROFILE =<profile>, <earmute>, This command is used to select a profile with which to establish a <micmute>, circuit-switched call. (See “Profile activation” page 90.) This <generator>, command also enables / disables muting on the earpiece and <volume>...
  • Page 107 Voice Commands Table 7-3: Voice command details (Continued) Command Description Activate a profile !AVSETPROFILE (continued) (continued) <earmute> (enable / disable earpiece muting): • 0 = Unmuted • 1 = Muted <micmute> (enable / disable microphone muting): • 0 = Unmuted •...
  • Page 108 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Play a tone !AVTONEPLAY =<method>, <value> This command is used to play a specified tone with the current active Supporting Mini Cards: audio profile. This is for testing purposes—not for normal operation. •...
  • Page 109 Voice Commands Table 7-3: Voice command details (Continued) Command Description !AVTXPCMFLTR Set / query the TX PCM filter tap =<profile>, <tap>, The MC87xx modem has a 7-tap PCM (Pulse Code Modulation) filter. <value> This command sets the TX PCM filter tap for the specified profile. !AVTXPCMFLTR? “!AVRXPCMFLTR”...
  • Page 110 MC87xx Extended AT Command Reference Table 7-3: Voice command details (Continued) Command Description Set the TX volume !AVTXVOL =<profile>, <value> 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, !AVTXVOL? for the voice that is transmitted over the air.
  • Page 111 Voice Commands Table 7-4: Tone settings for AT !AVTONEPLAY command (Continued) <Value> Tone Description parameter setting 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...
  • Page 112 MC87xx Extended AT Command Reference !AVTONEPLAY command (Continued) Table 7-4: Tone settings for AT <Value> Tone Description parameter setting 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...
  • Page 113 Voice Commands Table 7-4: Tone settings for AT !AVTONEPLAY command (Continued) <Value> Tone Description parameter setting 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...
  • Page 114 MC87xx Extended AT Command Reference 2130616...
  • Page 115 8: GPS Commands • Introduction • Command summary Introduction • Command reference 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. Table 8-1: GPS commands Command Description Page...
  • Page 116 MC87xx Extended AT Command Reference Table 8-1: GPS commands Command Description Page !GPSPROTOSEL Control GPS protocol selection !GPSSATINFO Request satellite information !GPSSTATUS Request current status of a position fix session !GPSSUPLURL Set / query SUPL server URL !GPSTRACK Initiate a local tracking (multiple fix) session !GPSTRANSSEC Control GPS transport security !GPSXTRADATAENABLE...
  • Page 117 GPS Commands Command reference Table 8-2: GPS command details Command Description !GPSAUTOSTART? Configure GPS auto-start features This command configures the GPS auto-start features. Any changes take !GPSAUTOSTART=? effect the next time the modem is reset. !GPSAUTOSTART= Note: If auto-start is enabled, another GPS session cannot be started. <enable>[, <fixtype>, <maxtime>, <maxdist>, <fixrate>]...
  • Page 118 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Clear specific GPS assistance data !GPSCLRASSIST? This command clears one or more types of assistance data from the !GPSCLRASSIST=? modem. This forces a cold start for GPS acquisition the next time a session starts.
  • Page 119 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSENABLE = <gpsFlag>, (Deprecated) Enable GPS functionality and MTLR <mtlrFlag> support GPSENABLE? !GPSENABLE Note: Deprecated. should be used instead. GPSENABLE=? Supporting Mini Cards: This command enables or disable GPS functionality if supported by the •...
  • Page 120 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description End an active session !GPSEND = <sessType> Supporting Mini Cards: This command ends an active position fix session. • MC8775V Usage: • MC8780 / 81 • AT!GPSEND=<sessType> ends the current session. •...
  • Page 121 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSFIX=<fixType>, Initiate a GPS position fix <maxTime>, <maxDist> This command initiates a GPS position fix. !GPSFIX=? Usage: Supporting Mini Cards: • AT!GPSFIX=<fixType>, <maxTime>, <maxDist> initiates a time-limited • MC8775V position fix with a specified accuracy. •...
  • Page 122 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Set / query IP address to use over TCP/IP !GPSIPADDR = <ipaddr> !GPSIPADDR? !GPSSUPLURL Note: Deprecated. should be used in place of Supporting Mini Cards: !GPSIPADDR and !GPSPORTID. •...
  • Page 123 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSLOC? Return the last known location of the modem Supporting Mini Cards: This command returns the details obtained during the most recent position • MC8775V location session, if available. • MC8780 / 81 Usage: •...
  • Page 124 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Set / query MT location request settings !GPSMTLRSETTINGS = <notifyResp> This command sets or reports the current MT (mobile-terminated) !GPSMTLRSETTINGS? Location Request settings. !GPSMTLRSETTINGS=? Note: AT!RESET must be issued after this command is used. Supporting Mini Cards: •...
  • Page 125 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSPORTID = <portid> Set / query port ID to use over TCP/IP !GPSPORTID? !GPSSUPLURL Note: Deprecated. should be used in place of Supporting Mini Cards: !GPSIPADDR and !GPSPORTID. • MC8780 / 81 (minimum FW rev: F1_0_1_4ap) •...
  • Page 126 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Configure support for GPS positioning modes !GPSPOSMODE = <mask> !GPSPOSMODE? This command enables or disables support for several GPS positioning modes. !GPSPOSMODE=? Supporting Mini Cards: Note: AT!RESET must be issued after this command is used. •...
  • Page 127 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSPROTOSEL = Control GPS protocol selection <protocol> This command sets or reports the current GPS protocol selection method !GPSPROTOSEL? for User Plane GPS. !GPSPROTOSEL=? Note: AT!RESET must be issued after this command is used. Supporting Mini Cards: •...
  • Page 128 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Request satellite information !GPSSATINFO? Supporting Mini Cards: This command returns the following information for up to twelve satellites • MC8780 / 81 (minimum in view (including those used in the latest position fix): satellite vehicle FW rev: F1_1_0_3ap) number (SV), elevation (ELEV), azimuth (AZI), and signal to noise ratio (SNR).
  • Page 129 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSSTATUS? Request current status of a position fix session Supporting Mini Cards: This command returns the current status of a position fix session. • MC8775V (minimum Usage: FW rev: H1_1_0_1mcap) •...
  • Page 130 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Set / query SUPL server URL !GPSSUPLURL? !GPSSUPLURL=? !GPSSUPLURL=”<suplURL> This command sets or returns the URL of the SUPL server to be used [:<portNum>]” when TCP/IP is used as the transport mechanism for location processing. Supporting Mini Cards: •...
  • Page 131 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSTRACK = <fixType>, Initiate a local tracking (multiple fix) session <maxTime>, <maxDist>, <fixCount>, <fixRate> This command initiates a local tracking session comprising a specific number of position fixes taken at regular time intervals. !GPSTRACK=? Usage: Supporting Mini Cards:...
  • Page 132 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description !GPSTRACK One of the following responses will be received: (Continued) • “OK” if the request is successful, or • “ERROR CODE = <value> if the request fails for any reason. See Table 8-3 on page 139 for a list of error codes.
  • Page 133 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSXTRADATAENABLE = Set / query GPS XTRA settings <enable> [,<retries>,<retryInt> This command enables or disables GPS XTRA data and sets or reports [,<dload>, <dloadInt>]] GPS XTRA data configuration settings. !GPSXTRADATAENABLE? Note: These settings are persistent across power cycles.
  • Page 134 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Set / query GPS XTRA data server URLs !GPSXTRADATAURL = <urlIndex>, <url> This command sets or reports the URLs of up to three GPS XTRA data !GPSXTRADATAURL? servers.
  • Page 135 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSXTRASTATUS? Return current status of gpsOneXTRA Supporting Mini Cards: This command returns the status of the most recent time and data • MC8780 / 81 (minimum injection operations. FW rev: F1_0_1_4ap) Usage: •...
  • Page 136 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Inject GPS or UTC time into gpsOneXTRA system !GPSXTRATIME=<YYYY>, <MM>, <DD>, <hh>, <mm>, <ss>, <utc>, <force>, This command injects the GPS or UTC time into the gpsOneXTRA <uncrtn>...
  • Page 137 GPS Commands Table 8-2: GPS command details (Continued) Command Description !GPSXTRATIMEENABLE = Set / query GPS XTRA time settings <enable> [, <thresh>, <delay>] This command enables or disables GPS XTRA time information, and sets or reports specific GPS XTRA time settings. !GPSXTRATIMEENABLE? !GPSXTRATIMEENABLE=? Note: AT!RESET must be issued after this command is used.
  • Page 138 MC87xx Extended AT Command Reference Table 8-2: GPS command details (Continued) Command Description Set / query GPS XTRA SNTP server URLs !GPSXTRATIMEURL = <urlIndex>, <url> This command sets or reports the URLs of up to three GPS XTRA SNTP !GPSXTRATIMEURL? (Simple Network Time Protocol) servers.

  • Page 139: Error Codes

    GPS Commands Error codes Table 8‐3 describes error codes that can be returned by  AT!GPSEND AT!GPSSTATUS  (page 120),   (page 129), and  AT!GPSTRACK  (page 131). Table 8‐4 describes error codes that can be returned by  AT!GPSFIX  (page 121) Table 8-3: AT command error codes (!GPSEND, !GPSSTATUS, !GPSTRACK) Error code Description Phone is offline No service No connection with PDE (Position Determining Entity) No data available Session Manager is busy Reserved Phone is GPS-locked...
  • Page 140 MC87xx Extended AT Command Reference Table 8-3: AT command error codes (!GPSEND, !GPSSTATUS, !GPSTRACK) (Continued) Error code Description Subscription violation Desired fix method failed Reserved No fix reported because no Tx confirmation was received Network indicated normal end of session No error specified by the network No resources left on the network Position server not available...
  • Page 141 GPS Commands Table 8-4: AT command error codes (!GPSFIX) (Continued) Error code Description Phone is offline Phone is CDMA locked GPS is locked Command is invalid in current state Connection failure with PDE PDSM command buffer unavailable to queue command Search communication problem •...
  • Page 142 MC87xx Extended AT Command Reference 2130616...

  • Page 143: Stk Commands

    9: STK Commands • Introduction • Command summary Introduction • Command reference 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. This profile is downloaded to the  SIM each time the modem resets. At any time, the profile can  be updated by using AT!STKPD and then resetting the  modem. Processing unsolicited SIM commands To process commands issued by the SIM: Enable the AT interface for STK functionality  —   i ssue the  command AT!CUSTOM=”STKUIEN”, 2. Monitor the command prompt for unsolicited proactive  SIM commands: · “AT!STKC: <cmdId>”  —   T his is a command that requires  a response. See Table 9‐2 for supported commands.
  • Page 144 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 <cmdId>: Respond with “AT!STKGC=<cmdId>” to retrieve  the data to use for <cmdId>. Execute the requested command (<cmdId>) and  respond with “AT!STKCR=<cmdId>,<result>, ...” Configuring the host’s profile To configure the host’s profile for STK support: At any time, issue the command AT!STKPD=<bitmask>  where the <bitmask> indicates supported features. Reset the modem. When the modem restarts, the profile  automatically downloads to the SIM. Command summary The table below lists the commands described in this chapter. Table 9-1: STK commands Command Description Page !STKC Receive unsolicited SIM command !STKCR Respond to unsolicited SIM command !STKGC Retrieve data for unsolicited SIM command...
  • Page 145 STK Commands Command reference Table 9-2: STK command details Command Description !STKC? Receive unsolicited SIM command This command is used by the SIM to send unsolicited notifications to the Unsolicited command: host, and is used by the host to query the last command received. !STKC: <cmdId>...
  • Page 146 MC87xx Extended AT Command Reference Table 9-2: STK command details (Continued) Command Description Respond to unsolicited SIM command !STKCR=<cmdId>, <result>[, <data>] This command is used to respond to the last received unsolicited SIM command, sending the results of the command’s execution and any !STKCR=? associated data (dependent on type of command executed).
  • Page 147 STK Commands Table 9-2: STK command details (Continued) Command Description !STKGC=<cmdId> Retrieve data for unsolicited SIM command This command is used to retrieve the data associated with the last !STKGC=? received unsolicited SIM command. Usage: Supporting Mini Cards: • • MC8790 / 90V (minimum AT!STKGC=<cmdId>...
  • Page 148 MC87xx Extended AT Command Reference Table 9-2: STK command details (Continued) Command Description Request menu item selection or help from SIM !STKMS=<item>[, <help>] This command is used to tell the SIM to select a menu item or to respond !STKMS=? with help information for the menu item via a Display Text command (<cmdId = 21>).
  • Page 149 STK Commands Table 9-2: STK command details (Continued) Command Description !STKPD=<bitmask> Update STK supported features profile This command is used to tell the SIM which STK features are supported !STKPD=? by the host. !STKPD? Note: The modem must be restarted before the new profile information Supporting Mini Cards: takes effect.
  • Page 150 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) ·...

  • Page 151: Stk Command () Parameters

    STK Commands STK command (<cmdId>) parameters Set Up Call (<cmdId = 10>) Table 9-3: Setup Call parameters Parameter Format Description !STKGC <data> parameter — Format: <method>, <TON>, <NPI>, <address>, <subaddress>, <ccp>, <alphaId1>, <iconId>, <dispMode>, <alphaId2>, <iconId>, <dispMode>, <redial>, <timeout> <method> Integer Call setup method •...
  • Page 152 MC87xx Extended AT Command Reference Table 9-3: Setup Call parameters (Continued) Parameter Format Description !STKCR parameters <data> Not used • <result> Integer 0 — Command performed successfully • 1 — Command beyond ME’s capabilities • 2 — Currently busy on call •...
  • Page 153 STK Commands Table 9-4: Send SS parameters (Continued) Parameter Format Description !STKCR parameters <data> Not used • <result> Integer 0 — Command performed successfully • 1 — Command beyond ME’s capabilities • 2 — Currently busy with USSD transaction • 3 —...
  • Page 154 MC87xx Extended AT Command Reference Send SMS (<cmdId = 13>) Table 9-6: Send SMS parameters Parameter Format Description !STKGC <data> parameter — Format: <pack>, <tpdu>, <TON>, <NPI>, <address>, <alphaId>, <iconId>, <dispMode> <pack> Integer Packing flag • 0 — Packing not required •...
  • Page 155 STK Commands Send DTMF (<cmdId = 14>) Table 9-7: Send DTMF parameters Parameter Format Description !STKGC <data> parameter — Format: <dtmf>, <alphaId>, <iconId>, <dispMode> <dtmf> Hex string DTMF string <alphaId> Hex string Alpha identifier for user confirmation <iconId> Integer Numeric tag of the icon to display (matches the index in the SIM’s image file) •...
  • Page 156 MC87xx Extended AT Command Reference Table 9-8: Launch browser parameters (Continued) Parameter Format Description <bearer> Hex string List of one or more allowed bearers, sorted in priority order • “00” — SMS • “01” — CSD • “02” — USSD •...
  • Page 157 STK Commands Play tone (<cmdId = 20>) Table 9-9: Play tone parameters Parameter Format Description !STKGC <data> parameter — Format: <alphaId>, <tone>, <duration> <alphaId> Hex string Alpha identifier for user confirmation <tone> Hex string Tone type. (SST — Standard Supervisory Tone; MPT — ME Proprietary Tone) •...
  • Page 158 MC87xx Extended AT Command Reference Table 9-10: Display text parameters (Continued) Parameter Format Description <priority> Integer Priority information flag • 0 — Do not display priority information • 1 — Display priority information <clear> Integer Clear message flag • 0 — Do not allow user to clear message •...
  • Page 159 STK Commands Table 9-11: Get Inkey parameters (Continued) Parameter Format Description <response> Integer Expected response character format • 0 — SMS default alphabet • 1 — Yes/No response only • 2 — Digits only (0–9, *, #, +) • 3 — UCS2 alphabet <helpInfo>...
  • Page 160 MC87xx Extended AT Command Reference Get Input (<cmdId = 23>) Table 9-12: Get Input parameters Parameter Format Description !STKGC <data> parameter — Format: <dcs>, <text>, <response>, <echo>, <helpInfo>, <minLgth>, <maxLgth>, <dcs>, <default>, <iconId>, <dispMode> <dcs> Integer Data coding scheme • 0 —...
  • Page 161 STK Commands Table 9-12: Get Input parameters (Continued) Parameter Format Description !STKCR parameters <data> [<dcs>, If the <dcs> is present, but <text> is an empty string, <text>] then a null text string data object must be sent to the SIM. This is caused by the user making an ‘empty’ input.
  • Page 162 MC87xx Extended AT Command Reference Table 9-13: Select Item parameters (Continued) Parameter Format Description <dispMode> Integer Icon usage • 0 — Display icon only (replaces <alphaId>) • 1 — Display with <alphaId> string !STKCR parameters <data> [<itemId>] ID of item selected, or for which help is requested <itemId>...
  • Page 163 STK Commands Table 9-14: Set Up Menu parameters (Continued) Parameter Format Description <iconId> Integer Numeric tag of the icon to display (matches the index in the SIM’s image file) • 0 — No icon • 1..255 — Icon tag <dispMode> Integer Icon usage •...
  • Page 164 MC87xx Extended AT Command Reference Table 9-15: Set Up Idle Mode parameters (Continued) Parameter Format Description !STKCR parameters <data> Not used • <result> Integer 0 — Text successfully added / removed • 1 — Problem performing operation Language Notification (<cmdId = 35>) Table 9-16: Language Notification parameters Parameter Format...
  • Page 165 STK Commands Table 9-17: Response notification to MO Call Control request parameters Parameter Format Description <repeatind> Integer BC repeat indicator • 1 — Alternate mode • 3 — Sequential mode <alphaId> Hex string Alpha identifier <TON> Integer Type of number •...
  • Page 166 MC87xx Extended AT Command Reference Table 9-18: Response notification to MO SMS Control request parameters Parameter Format Description <TON> Integer Type of number • 0 — Unknown • 1 — International • 2 — National • 3 — Network specific <NPI>...

  • Page 167: Test Frequencies / Channel Lists

    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 Frequency (MHz) Band Channel MX Tx MS Rx GSM850 824.20 869.20 836.60 881.60 848.80 893.80 EGSM900 880.20 925.20 881.00 926.00 902.40 947.40 903.00 948.00 914.00 959.00 914.80 959.80...
  • Page 168 MC87xx Extended AT Command Reference Table A-2: WCDMA Channels Band Tx Channel UE Tx (MHz) Rx Channel UE Rx (MHz) UMTS Band I 9612 1922.40 10562 2112.40 (2100) 9750 1950.00 10700 2140.00 9888 1977.60 10838 2167.60 UMTS Band II 9262 1852.40 9662 1932.40...

  • Page 169: Hsdpa / Hsupa Categories

    Appendix B:HSDPA / HSUPA Categories The following tables describe standard HSDPA and HSUPA  categories. Table B-1: HSDPA-capable terminals Category Maximum Minimum Number of Theoretical Modulation number of inter-TTI soft values in download supported interval terminal’s maximum HS-DSCH hybrid ARQ (L1 peak codes buffer rate [Mbps]) Category 1 19,200 16QAM, QPSK Category 2...
  • Page 170 MC87xx Extended AT Command Reference 2130616...

  • Page 171: Ascii Table

    Appendix C: ASCII Table Char Char Char Char ‘ “ & ’ XOFF < > Rev 2.9 Oct.08...
  • Page 172 MC87xx Extended AT Command Reference 2130616...

  • Page 173: Module Customization

    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. Also, this is only a represen- tative sample of available customizations—all AT commands can be used for customizations depending on carrier requirements.
  • Page 174 MC87xx Extended AT Command Reference Mark the minimum acceptable Quality of Service profile  as undefined: AT+CGQMIN=<pid> (See 3GPP TS 27.007) Mark the 3G Quality of Service profile as undefined: AT+CGEQREQ=<pid> (See 3GPP TS 27.007) Mark the minimum acceptable 3G Quality of Service  profile as undefined: AT+CGEQMIN=<pid> (See 3GPP TS 27.007) Mark PDP context parameter values as undefined: AT+CGDCONT=<pid> (See 3GPP TS 27.007) Initialize the software option byte in the profile details: AT!SCPROFSWOPT=<pid>,0 (page 52) (Customize configuration details) If desired, assign a custom PRI part number or revision:  AT!PRIID=<priPn>, <priRev> (page 50) Clear all old customizations from non‐volatile memory and  restore factory defaults: AT!NVDEF (page 85) AT!NVRESTORE=0 (page 86) If desired, customize non‐MUX mode port mappings:  AT!NVPORTMAP=<normMode> [, <diagMode>] (page 46) Set GPRS MS Class and EDGE MS Class to match network  requirements (default is Class 10, example below switches to  Class 12): AT!NVOEM=GMSCLASS,0C (page 45) AT!NVOEM=EMSCLASS,0C (page 45) Match the modem’s ciphering and integrity settings to the live  Note: Most carriers enable both UMTS network’s settings: ciphering and integrity AT!GCIPHER=<setting> (See Supported AT reference) (<setting>...
  • Page 175 Module Customization · Enable / disable FDN check for PS data calls: AT!CUSTOM=”DISFDNPDPCHK”,<value> (page 33) If desired, configure Watcher 3G and Windows driver  Note: The customizations in this functionality: step affect the interfaces between the modem and the Enable / disable roaming indicator display: user (drivers, API, CnS, AT!CUSTOM=”NOROAM”, <value> (page 33) Watcher)—they do not affect the (<value> = 0 (enable) | 1 (disable)) modem directly. (If enabled, the firmware will always report “No Roam”  to the API in the CNS_ICON_ROAM object.) Enable / disable GPRS / EDGE indicator display: AT!CUSTOM=”NOGPRS”, <value> (page 33) (<value> = 0 (enable) | 1 (disable)) (If enabled, the firmware clears the display icon flag in ...
  • Page 176 MC87xx Extended AT Command Reference (<value>=1), the object is set as “voice”, and headset  indications and other voice‐related CnS notifications are  sent to the host. If <value> is 0 or 1, voice calls can be  made using the AT command interface.) Enable /disable GPS — causes Windows driver to display  an NMEA port: AT!CUSTOM=”GPSENABLE”, <value> (page 33) (<value=0 (disable; default) | 1 (enable)) Customize non‐persistent modem settings. Note: The host device needs to include a facility for restoring Set the band using one of the following commands: these settings after the modem · AT!BAND = <bandsetInd> (See Supported AT  power cycles. reference) · AT!GBAND = <bandmask> (page 58) Note: AT!GBAND allows for finer tuning than AT!BAND. Indicate the communications protocol to be used: AT!REL=<wcdmarrc>[, <sgsnr>, <mscr>] (page 51) (Example: HSDPA is !REL=1,1,1; HSUPA is !REL=2,1,1)
  • Page 177 Module Customization Enable or disable scan profile (try all profiles configured on  card until a successful connection is found): AT!CUSTOM=”SCANPROF”,<value> (page 33) (Mini Cards only) Enable / disable slow clocking mode: AT!SLEEP = <value> (page 53) Clear the error log: AT!ERR=0 (page 57) Back up data: Note: Profiles (PDP contexts) Back up provisioning data: AT!NVBACKUP = 1 (See Supported AT reference) are not restored from these backups. Host application Back up user data: software is responsible for this AT!NVBACKUP = 2 (See Supported AT reference) task if profiles become Backup RF calibration data: corrupted. AT!NVBACKUP = 0 (See Supported AT reference) Set up MEP / MCC / MNC: Enable / disable prompt for MEP code when incorrect  SIM is inserted: AT!CUSTOM=”MEPCODE”,<value> (page 33) (Watcher 3G only) Enable / disable MEP locking (Only ...
  • Page 178 MC87xx Extended AT Command Reference 2130616...

This manual is also suitable for:

Mc8775vMc8780Mc8790Mc8781Mc8790vMc8791v ... Show all

Table of Contents