Vous êtes sur la page 1sur 48

Location Library 1.

4 AT Commands Interface User Guide
AirPrime SL808xT Built-In gpsOne

4111879 1.1 November 6, 2012

Location Library 1.4 AT Commands Interface User Guide

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. Although significant delays or losses of data are rare when wireless devices such as the Sierra Wireless modem are used in a normal manner with a well-constructed network, the Sierra Wireless modem should not be used in situations where failure to transmit or receive data could result in damage of any kind to the user or any other party, including but not limited to personal injury, death, or loss of property. Sierra Wireless accepts no responsibility for damages of any kind resulting from delays or errors in data transmitted or received using the Sierra Wireless modem, or for failure of the Sierra Wireless modem to transmit or receive such data.

Safety and Hazards
Do not operate the Sierra Wireless modem in areas where cellular modems are not advised without proper device certifications. These areas include environments where cellular radio can interfere such as explosive atmospheres, medical equipment, or any other equipment which may be susceptible to any form of radio interference. The Sierra Wireless modem can transmit signals that could interfere with this equipment. 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 communications devices while in control of a vehicle is an offence.

Limitations of Liability
This manual is provided “as is”. Sierra Wireless makes no warranties of any kind, either expressed or implied, including any implied warranties of merchantability, fitness for a particular purpose, or noninfringement. The recipient of the manual shall endorse all risks arising from its use. The information in this manual is subject to change without notice and does not represent a commitment on the part of Sierra Wireless. SIERRA WIRELESS AND ITS AFFILIATES SPECIFICALLY DISCLAIM LIABILITY FOR ANY AND ALL DIRECT, INDIRECT, SPECIAL, GENERAL, INCIDENTAL, CONSEQUENTIAL, PUNITIVE OR EXEMPLARY DAMAGES INCLUDING, BUT NOT LIMITED TO, LOSS OF PROFITS OR 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. Customer understands that Sierra Wireless is not providing cellular or GPS (including A-GPS) services. These services are provided by a third party and should be purchased directly by the Customer.

4111879

Rev 1.1

November 6, 2012

2

Location Library 1.4 AT Commands Interface User Guide SPECIFIC DISCLAIMERS OF LIABILITY: CUSTOMER RECOGNIZES AND ACKNOWLEDGES SIERRA WIRELESS IS NOT RESPONSIBLE FOR AND SHALL NOT BE HELD LIABLE FOR ANY DEFECT OR DEFICIENCY OF ANY KIND OF CELLULAR OR GPS (INCLUDING A-GPS) SERVICES.

Patents
This product may contain technology developed by or for Sierra Wireless Inc. This product includes technology licensed from QUALCOMM®. This product is manufactured or sold by Sierra Wireless Inc. or its affiliates under one or more patents licensed from InterDigital Group.

Copyright
© 2012 Sierra Wireless. All rights reserved.

Trademarks
AirCard® is a registered trademark of Sierra Wireless. Sierra Wireless™, AirPrime™, AirLink™, AirVantage™, Watcher™ and the Sierra Wireless logo are trademarks of Sierra Wireless. , ®, inSIM®, WAVECOM®, WISMO®, Wireless Microprocessor®, Wireless CPU®, Open AT® are filed or registered trademarks of Sierra Wireless S.A. in France and/or in other countries. Windows® and Windows Vista® are registered trademarks of Microsoft Corporation. Macintosh and Mac OS are registered trademarks of Apple Inc., registered in the U.S. and other countries. QUALCOMM® is a registered trademark of QUALCOMM Incorporated. Used under license. Other trademarks are the property of the respective owners.

Contact Information
Phone: Sales Desk: Hours: E-mail: Sierra Wireless 13811 Wireless Way Richmond, BC Canada V6V 3A4 1-604-232-1488 8:00 AM to 5:00 PM Pacific Time

sales@sierrawireless.com

Post:

Technical Support: RMA Support: Fax: Web:

support@sierrawireless.com repairs@sierrawireless.com
1-604-231-1109

www.sierrawireless.com

Consult our website for up-to-date product descriptions, documentation, application notes, firmware upgrades, troubleshooting tips, and press releases: www.sierrawireless.com

4111879

Rev 1.1

November 6, 2012

3

Location Library 1.4 AT Commands Interface User Guide

Document History
Version 1.0 Date June 20, 2012 Updates Creation document based on Location Library 1.51 for Open AT Application Framework AT Command Interface Guide (along with SiRF-GSD4t) and updated for AirPrime SL808xT built-in gpsOne. New interface for the aid_event

1.1

November 6, 2012

4111879

Rev 1.1

November 6, 2012

4

............................................................18 5..........4............22 Rev 1..... 5....2.........................................18 5....................................................1.....................................................10 Features .......................1................3.1 November 6.................. Command Line .......................................................... Parameters and Defined Values ..............................................................4.......................................... 2..........................................................3.....................4............................................ 4111879 .........................................1... AT COMMANDS REFERENCE...1..........2............. AT COMMAND SYNTAX ...........................................................2............................................................20 Command +GPSSAVE............... Purpose ...................................................... 5 1................................10 AT command sequence to start Location Services .................8 1................................................................17 5.....................................3......14 AT Commands Calls Requirements .................... Parameters and Defined Values ........................................ 4..........1...........2.... Examples.........3........................................2.. Syntax ............................................21 5.....................................19 5.........21 5............................................................. Glossary ......17 5... USER GUIDE ........................................................3.............................................................8 Abbreviations and Glossary .........................................................10 2.2........................................3.....................................3.............................................................................3................21 5................................... Parameters and Defined Values ........................ Abbreviations .................................... AirPrime SL808x gpsOne......4........... Examples......11 2.............................................21 5........................18 5.......14 4......................2..................................... Factory default configuration ............................ 2012 5 5......2...................................... Example of start sequence............................1............................. AT command sequence .........3..................................12 2........................................................................................................2................ LOCATION SERVICES STATES ...............................................1..............................1... 16 4.............................................................................1.............................................................................................................................................................................. Command +GPSHELP ......................8 1..16 5....... 17 5.................................................. 3.................3..........3...............1..........3.....2.....3...........1......................... 8 1............................................................................ Restriction of Use ................................................. State Machine.............16 Information Responses and Result Codes ...............................................10 2........................ 1.............. INTRODUCTION ... Examples.......11 GPS receiver specific capabilities and restrictions...............Contents CONTENTS .................................. Syntax ......................2................................................................................................................... Description ...........................................................2................................................1.... 3............... Description .................8 Related Documents ...............17 5... 1.2...............................................................17 5............3...................................4............3........1..................................................... 14 3.................................................. Syntax ........11 2.............................1............... 2...17 Command +GPSNMEA ....................................................................................9 2............................ 10 2..... Description ............................................3......................................2.........1...............................................

.............32 6....................................33 Command +GPSVERS . Syntax ....... Description ... Syntax ....................3................................................ Examples...................................... ADVANCED AT COMMANDS REFERENCE ................................................... Parameters and Defined Values ..............23 5..........................34 6................ 25 6....... Diagram for settings management ................4.........................................................................4..................1..........................................2.......................................2......24 5.. Parameters and Defined Values . Parameters and Defined Values ...................................................................................2...................................................................27 6.............8......25 6........................................................................................................................................31 Command +GPSRELEASE .............. Examples............................................. Description ...................5..............................................4......................................4. Examples..............................................................1.............................33 6................. Syntax ............................................5............ Parameters and Defined Values ..................................................28 6.4..........................2............................................7.....................33 6....................................... 6..........................................................................32 6..........30 6...................................... 6..........7...4.....................28 6........................................3.....31 6...................26 6..........7..........................................................24 6...................................Location Library 1................. 2012 6 6....................... 4111879 ............................ 6..................7.................................................... Examples................29 6.......................26 6............2............................................27 Command +GPSSTOP ................4........................................1............................23 5....1.. Parameters and Defined Values .......1.....................................................2........................ Description ..............................................................................................3.......... Examples...... Description .................................................4..........................5.........................................................4......... Description ................. 6............................................... Description .................4................1 November 6........4.............29 Command +GPSSLEEP......5................2....1...............................1......................28 6..........................................2................................................................................ Description ............26 6.....................33 6......................3............................................................................4............5..................23 5..... Command +GPSSTATE.............................................................................................................5.....................2... Examples............. 5....................34 Command +GPSCONF .............22 Command +GPSSTART ..................................................30 6..................... 6.............................................4..............................1...................................... Description .........4..................................... 6........3............................5...............1....6......... Parameters and Defined Values .....................................3....................4 AT Commands Interface User Guide 5..........................................................2............. Syntax ..........3...............................................................................................................................1.....27 6....7.............................4........................2......................................30 Command +GPSTTFF .......... Syntax .......26 Command +GPSINIT .......... Examples...............1......................25 6.......................3.......................... Syntax ..................28 6..........................................30 6..29 6........6........................................................... Syntax ...................6...............................................................................34 Rev 1..........................8................3.............29 6................................................3............31 6.........4.....................2............................32 6....................1.3............................................ Examples.........2...3..............3........................25 6. Hardware Configuration ...4....1....................................................................... Description .................................33 6..........................................................................2............................6....................25 6...................................1...........................................................................6..... Parameters and Defined Values ........................4...................3................ Syntax .................32 6.................. Parameters and Defined Values ............................................

......8.................................................................. 47 4111879 Rev 1..9.8........................................................................................................41 6............9......... Description ...............Location Library 1..... 7...................9....................................................................36 6...........................39 6..........................10................................................................45 8............................................................10......2. Aiding Service Configuration Restrictions .................................2..... LOCATION AT COMMANDS ERROR CODES .36 6.................................................................36 6............................................................1 November 6..............................41 6...................................................................................9... 7................................................................3......3..................... ASYNCHRONOUS EVENTS ................41 6...35 Location service configuration restrictions ........... Foreword ...37 6.. Parameters and Defined Values .........4 AT Commands Interface User Guide 6...........43 Parameters and Defined Values . Description .............................................42 7... Examples of AT Command Sequence .3...................................................................................9............ Syntax ...................................................................2.......9...1... Examples................................ Parameters and Defined Values ................................................................................................. Command +GPSCORE ...........................................3....................................................1............................................... 46 INDEX .... 2012 7 .......................................36 Command +GPSAID ............4...........8.......43 Syntax.... Description.............38 6.......................5...........6..... 6.................10.. 6...................................5........................................................................................35 Examples.................................................. 6.... 43 7...... Syntax ...................9.......................................................................... Syntax ....9.4..8........2..............40 6........................................................40 6........................................1...........................................................................................................................34 Parameters and Defined Values ................................ 6.10...............................7..................................

1. Velocity.1.2.1 November 6. Time Time To First Fix Coordinated Universal Time Abbreviation CW DR ECEF GPIO GPS HW ID IO KF LNA LSQ NMEA NV PPS PVT TTFF UTC 4111879 Rev 1.1. available when using the AirPrime SL808xT built-in gpsOne. [1] Related Documents Open AT Framework AT Commands Interface Guide for Firmware 7.Product Technical Specification & Customer Design Guidelines Reference: 2400058 [5] 1. 1. Introduction The following subsections present introductory information regarding the Location AT Commands. Purpose This document provides Sierra Wireless customers with a full description of the AT Commands for Location Services. Earth-Fixed (ECEF) General Purpose Input Output Global Positioning System Hardware Identifier Input/Output Kalman Filter Low-Noise Amplifier Least SQuare (approximation) National Marine Electronics Association standard Non-Volatile Pulse-Per-Second The primary GPS outputs: Position.50.A1 for AirPrime SL808xT Reference: 4112152 AirPrime – SL808xT .3. 2012 8 . 1.1.3. Abbreviations and Glossary Abbreviations Definition Continuous Waveform Dead Reckoning Reference used in GNSS is called Earth-Centered.

WGS 84 The World Geodetic System is a standard for use in cartography.2. 1.3. on which Location AT commands are executed. 4111879 Rev 1.2.4 AT Commands Interface User Guide 1. For more details about NMEA standards.3.3. NMEA sentences The National Marine Electronics Association (NMEA) standard defines an electrical interface and data protocol for communications between marine instrumentation. The NMEA-0183.4.3.2.1 November 6. 1.org/. scope of this document.2. please refer to http://www. 2012 9 .1. defines a set of frame prefixed by $GP and concerning Global Positioning System.3.Location Library 1. Glossary Embedded Module Sierra Wireless’ AirPrime Embedded Module running OS. gpsOne GPS module QCT built-in GPS module. The latest revision is WGS 84 (dating from 1984 and last revised in 2004).3. 1.2. 1.nmea. geodesy. and navigation.2.

2012 10 .2. The default configuration used by the application is: Configuration Hardware configuration NMEA mode Starting Mode Factory default value Refer to document [5] for complete information. 4111879 Rev 1. Modify and save the default configuration. UART number 1 All supported NMEA frames are displayed 1 second NMEA frames update “HOT” start with all previous NV stored data. For more information about factory default settings. Restriction of Use The use of the Location AT software described in this document is strictly limited to the use in combination with the Sierra Wireless AirPrime SL808xT embedded module. Get the TTFF value. Get the NMEA frames on a specified port (UART1. Use of this software to operate or enable any other position-fix or location hardware is prohibited.2.3. 2.1.1 November 6. The Location AT command set extends the AirPrime™ Intelligent Embedded Module command set to allow users to: 2. please refer to +GPSSAVE AT command.     Features Control the Location feature and GPS receiver. 2. or USB). UART2. Also refer to the command +GPSINIT for more information. How to change it? AT+GPSINIT command AT+GPSNMEA command AT+GPSSTART command To start the Location Services for the first time. AT command sequence to start Location Services Factory default configuration 2. if you don’t use the default settings you must specify your settings through the advanced AT commands described in this document. User Guide This section provides introduction and high level description of the Location Services features and AT command set. including default GPS receiver hardware configuration if needed. configure the NMEA rate and select the NMEA sentences.1.3. Please contact a Sierra Wireless representative in case of any question or concerns.

4849.15.22.9.43.0. 2.313.*68 $GPRMC.45.17.28.E.36.M.17.3.0.12.136. AT+GPSINIT=<hw> (only if the Factory default hardware configuration must be changed.321.110412.M.K.0929.1.3.22.39.3.160254.6..54.1 November 6.E.A*35 $GPGSV.090. +GPSNMEA…). GPS receiver specific capabilities and restrictions The features supported by the Location Services may depend on the GPS receiver type.76.282.61.10.44.30.2. and.211.18.0.4. AT command sequence The AT command sequence to type to start receiving NMEA frames on the specified port is: 1..10. AT+GPSNMEA=<output> (only if the Factory default configuration should be changed) 4.3. make sure that the application automatically restarts to reach the same state with same settings when the Embedded Module is reset. AT+GPSSTART (Starts the GPS). You can then type AT+GPSSAVE=1 to save the current setting configured through AT commands (+GPSINIT. 2012 11 .1. AT+WOPEN=1 (activate AT command extension set.77.3.44.27.Location Library 1..0.1.2.4 AT Commands Interface User Guide 2.0929. specifies the GPS receiver hardware type or the hardware configuration on which the application will be run).26.24..09.0. NMEA frames will be received every second on the requested port.0.47. Needed only the first time).3.9404.000.A.27.12.00*75 … 2. 3.32.3. After few seconds.222.T.42*7A $GPGSV.N.09.18.0.8.00216.3. 4111879 Rev 1.37. +GPSSTART.3.09.7.15.3.0.3.M.4*32 $GPVTG.4849.10.41*74 $GPGSV.26.049.28.N.32.g..44.38.9.295.12.24..1..68.68. 2. 2. SL808x + gpsOne-Gen7) OK +GPSEVINIT: 1 +GPSEVSTART: 1 +GPSEVPOS: 0 $GPGGA.A. The following sections provide the GPS receiver specificities.000.282.A*5A $GPGSA.9404.160254.00216.1.N.6. AT+GPSSTART Example of start sequence Start sequence for the default configuration (e.

GPS receiver hardware and software resources are activated. Restriction on use of Embedded Module AT commands Start-up time The startup time is the duration between the +GPSSTART command and the +GPSEVSTART event.3. and GPS acquisition phase is starting. The startup time includes the GPS receiver firmware download time if applicable. Please refer to +GPSSTART AT command for more information. 2. The following table describes minimum required data for each starting mode: Starting mode Broadcasted Ephemeris X Approximate Time and Position X X Almanac Calibration Data X X X X HOT WARM COLD FACTORY Note: Updated Updated Updated Factory Ephemeris data (Broadcasted) are used if data are available and valid.1.4 AT Commands Interface User Guide 2.1.1. Starting mode Starting modes are used only for test purposes and allow start performance measurement. a hot start performed without broadcasted ephemeris will be treated as a warm star The following table describes supported starting mode(s) from each Location Services application state: 4111879 Rev 1.4.2. 2.4.1.Location Library 1. For example.1 November 6.      AirPrime SL808x gpsOne Supported NMEA Sentences The following NMEA sentences are provided by the GPS receiver: $GPGGA (GPS Fix Data) $GPGSA (GNSS DOPS and Active Satellites) $GPRMC (Recommended Minimum GNSS Sentence) $GPVTG (Course Over Ground and Ground Speed): Magnetic course (field #3) is not available.1. 2012 12 .4. The Start mode parameter is specified for each start using the +GPSSTART AT command.1. the Location Service has been correctly started. 2.4.4.4. left empty $GPGSV (GNSS Satellites in View) 2. After the +GPSEVSTART event.

5.1 November 6.Location Library 1.4.1.     GPS data management GPS Data are required to improve next GPS start performances. 4111879 Rev 1. 2012 13 .4 AT Commands Interface User Guide Description From INITIALIZED state HOT WARM COLD FACTORY From SLEEP state/ IDLE mode HOT WARM COLD FACTORY From SLEEP state /HIBERNATE mode HOT WARM COLD FACTORY From SLEEP state /DEEP SLEEP mode HOT WARM COLD FACTORY Supported start performances 2. GPS data are mainly made up of: Ephemeris data (Broadcasted) Time and Position Broadcasted Almanac Calibration data GPS Data are stored to NV memory (Embedded Module NVRAM) in the following transition(s): Location Library state transition UNINITIALIZED to INITIALIZED state (+GPSINIT) INITIALIZED to UNINITIALIZED state (+GPSRELEASE) INITIALIZED to RUNNING state (+GPSSTART) RUNNING to INITIALIZED state (+GPSSTOP) RUNNING to SLEEP/IDLE state (+GPSSLEEP=0) RUNNING to SLEEP/HIBERNATE state (+GPSSLEEP=1) RUNNING to SLEEP/DEEP SLEEP state (+GPSSLEEP=2) Note: GPS Data stored to NV memory N/A N/A N/A YES NO YES YES Please refer State Machine for more information about state transitions.

Location Services state diagram Note: “GPSEVXXXX: 0” events are not represented. Location Services States This section provides information of the Location Services states. 2012 GPS_SLEEP - 14 . State Machine Airprime Embedded Module Power On / Reset Below is a diagram of states and transitions of the Location Services application. ‘-’ means the AT Command is NOT authorized in the corresponding state.2. ‘X’ means the AT Command is authorized in the corresponding state. Table 1: Location AT commands prerequisites Function GPS_UNINITIALIZED GPS_INITIALIZED GPS_RUNNING AT+GPSINIT X - - 4111879 Rev 1. as they do not trigger any state transition.3.1 November 6. AT Commands Calls Requirements The following table shows the prerequisites when using the Location AT commands. GPS_UNINITIALIZED Quick start with default configuration AT+GPSINIT +GPSEVINIT: 1 +GPSEVABORT: AT+GPSSTART +GPSEVINIT: 1 +GPSEVSTART: 1 AT+GPSXXXX : AT command initially called by the user +GPSEVAAAA: Event that triggers the transition AT+GPSRELEASE +GPSEVRELEASE: 1 GPS_INITIALIZED AT+GPSSTOP +GPSEVSTOP: 1 AT+GPSSTART +GPSEVSTART: 1 AT+GPSSLEEP +GPSEVSLEEP: 1 AT+GPSSTOP +GPSEVSTOP: 1 GPS_RUNNING GPS_SLEEP AT+GPSSTART +GPSEVSTART: 1 Figure 1. 3. their transitions and allowed AT commands for each state. 3.1.

1 November 6. 4111879 Rev 1.4 AT Commands Interface User Guide Function GPS_UNINITIALIZED GPS_INITIALIZED GPS_RUNNING AT+GPSSTART AT+GPSSTOP AT+GPSRELEASE AT+GPSSLEEP AT+GPSCONF AT+GPSSTATE AT+GPSVERS AT+GPSNMEA AT+GPSTTFF AT+GPSSAVE AT+GPSDEBUG AT+GPSHELP X X X X X X X X X X X X X X X X X X* X X X X X X X X* X X X X X X X * Some configurations cannot be set in this state.Location Library 1. 2012 GPS_SLEEP X X - 15 . See the +GPSCONF command section for more information.

2012 16 . Optional parameters are shown in brackets [ ].<Param2>] <Param2> is optional. Default value is the last configured parameter or the last saved parameter value after the Embedded Module reset or factory default value if parameters were not saved. 4. Responses start and end with <CR><LF>. an "OK" string is returned.2.1. When the AT+GPScmd is executed without <Param2> the default value of <param2> is used.4.1 November 6. the "+GPS ERROR: <Err>" string is returned with adequate error codes. Please refer to Location AT commands error codes description for more details about error code values. Note: The unsolicited AT command responses are sent through the AT port. If the command line has been executed successfully.  In the following examples <CR> and <CR><LF> are intentionally. AT+GPScmd=<Param1>[. 4. If command syntax is correct but transmitted with wrong parameters. 4111879 Rev 1. The factory default configuration can be changed with +GPSSAVE Command. the "ERROR" string is returned.   Information Responses and Result Codes If command syntax is incorrect. AT Command Syntax This section describes the AT command format and the default value for their parameters. Example: Command Line Commands always start by the standard prefix “AT+GPS” and end with the <CR> character.

5.2.<enable>. <clock32k>] … OK AT+GPSHELP Note: displays all supported Location Services AT command format. Parameters and Defined Values The string parameter specifies the AT command described by help display.1.1.<reset>. 2012 17 . 5.1. <at_command >: 5.1. Syntax Action command AT+GPSHELP=[<at_command>] OK Test command AT+GPSHELP=? +GPSHELP: (list of supported <at_command>s) OK 5.<spi>.3. 5. Command Examples Responses +GPSINIT= <hw>[. 4111879 Rev 1.1 November 6.4. AT Commands Reference The following AT commands allow the control of Location Services for basic operation.1. 5. This AT Command is used to display the Location AT commands help.1.<cs>. Note: Command +GPSHELP Description +GPSHELP command syntax is subject to change with application evolution.

)OK 5. AT+GPSHELP=? Note: displays all supported Location AT command. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode. Command +GPSNMEA Description This AT command configures the NMEA frames flow. please refer to Location AT commands error codes description. +GPSSTART=[<starting_mode>] <starting_mode>: 0 [GPS_HOT_START] <starting_mode>: 1 [GPS_WARM_START] <starting_mode>: 2 [GPS_COLD_START] <starting_mode>: 3 [GPS_FACTCOLD_START] OK or +GPS ERROR: X Note: For more information about X value.GPSSTOP. In case of significant delay.GPSSTART. Note: NMEA sentences are output as unsolicited AT command responses.GPSTTFF. NMEA frames output will be suspended while an AT command is being processed.1.2. 5. In consequence.1 November 6.2.GPSS AVE.<nmea_mask>]] OK 4111879 Rev 1.GPSNMEA. in case the output port is not dedicated but shared with AT commands.[<rate>][.2.4 AT Commands Interface User Guide Command Responses AT+GPSHELP=GPSSTART Note: displays information about the +GPSINIT AT command. etc. Syntax Action command AT+GPSNMEA=[<output>][. The list of supported NMEA frames depends on the GPS receiver. the output port and the NMEA sentences encode mask. and resume once the AT command has returned.4 for more details. +GPSHELP: (GPSINIT. some NMEA sentences may be partially or totally lost.Location Library 1. Please refer to 2.GPSSTATE. 5. 2012 18 .2.

2. If omitted: last known value within current session.1 for more information. If omitted: last known value within current session.All NMEA frames output are disabled 4111879 Rev 1. 2012 19 . 0 1 2 3 NMEA frames are not output.<nmea_mask> OK Test command AT+GPSNMEA=? +GPSNMEA: (list of supported <output>s).(list of supported <rate>s).<rate>. (list of supported <nmea_mask>s) OK 5. Factory default value: 1. Please refer to Diagram for settings management for more information. Refer to 2.Location Library 1. This parameter defines the NMEA sentences encode mask as described hereunder. If omitted: last known value within current session.3. This parameter defines the NMEA frames update rate in seconds. Please refer to Diagram for settings management for more information. Range: 0-65535 Note: If this parameter is equal to 0.1.1 November 6. <output>: Parameters and Defined Values This parameter specifies the port which is to be used by the application to transmit the NMEA frames. NMEA frames output on UART 2. This port can also be used simultaneously as the PVT sentences output port if need be. Range: 0x0-0xFFFF Note: All NMEA frames may not be supported depending on GPS receiver type. Please refer to Diagram for settings management for more information.4. 0: GPS_NMEA_NONE_EN . (Hexadecimal value entered without the prefix “0x”). on the next occurrence of the NMEA frames update. NMEA frames output on USB. Factory default value: 0xFFFF. <rate>: <nmea_mask>: NMEA sentences list encode mask (Hexadecimal value entered without the prefix “0x”).4 AT Commands Interface User Guide Read command AT+GPSNMEA? +GPSNMEA: <output>. NMEA frames output on UART 1. Factory default value: 1. the NMEA frames will be sent only once.

NMEA $GPRMC (Recommended Minimum GNSS Sentence) output enabled.1.4 AT Commands Interface User Guide (1 << 0): (1 << 1): GPS_NMEA_GGA_EN . Command Examples Responses OK or +GPS ERROR: X Note: For more information about X value.21-24).1.5 Note: request NMEA frames output on port 1 (1) with an update rate of 5 seconds.NMEA $GPGGA (GPS Fix Data) output enabled GPS_NMEA_GGSA_EN . please refer to Location AT commands error codes description.1 November 6.4.FFFF Note: request all NMEA frames output on port 1 (1) with an update rate of 1 second.Location Library 1. AT+GPSNMEA=1.11-14. retrieve the current default +GPSNMEA: 1.NMEA $GPGSA (GNSS DOPS and Active Satellites) output enabled. please refer to Location AT commands error codes description.(0-65535). GPS_NMEA_VTG_EN . AT+GPSNMEA=? +GPSNMEA: (0-4.(0-FFFF) OK AT+GPSNMEA? Note: Allow to configuration. (1 << 2): (1 << 3): (1 << 6): 0xFFFF: 5.NMEA $GPVTG (Course Over Ground and Ground Speed) output enabled. AT+GPSNMEA=1. please refer to Location AT commands error codes description. GPS_NMEA_ALL_EN . OK or +GPS ERROR: X Note: For more information about X value.2. 2012 20 . OK or +GPS ERROR: X Note: For more information about X value. GPS_NMEA_RMC_EN .NMEA $GPGSV (GNSS Satellites in View) output enabled. GPS_NMEA_GSV_EN .ALL NMEA frames output supported by the GPS receiver are enabled.FFFF OK 4111879 Rev 1. AT+GPSNMEA=1 Note: request NMEA frames output on port 1).

3. 1 4111879 Rev 1.3. the command AT+GPSSAVE = 0 should be given and the Embedded Module should be reset. The application state (Please refer to State Machine for more information) is also saved as default configuration and used at the start (after the Embedded Module reset) to put the application in this state. If the Embedded Module is reset. Please refer to Diagram for settings management for more information. These settings will be used after each Embedded Module reset as default configuration. <mode>: 0 Parameters and Defined Values Saving mode. The application should reset all settings to their factory default values for the next Embedded Module reset. If the user wants the application to retrieve the default factory configuration (refer to each AT command description). This configuration is used for the automatic start. the application uses these settings at restart.1. 2012 21 . Command +GPSSAVE Description The current setting is stored in FLASH memory as the new default settings when the command +GPSSAVE=1 is entered.Location Library 1.1 November 6. 5.2.3.3. 5.4 AT Commands Interface User Guide 5. The application should save the current settings as new default settings. All the parameters of +GPS AT commands are saved. Syntax Action command AT+GPSSAVE= <mode> OK Read command AT+GPSSAVE? +GPSSAVE:<mode> OK Test command AT+GPSSAVE=? +GPSSAVE: (list of supported <mode>s) OK 5.3.

4111879 Rev 1. Command Examples Responses +GPSSAVE: 0 OK Note: 0 if no saved settings or 1 if settings have been saved.3. the modified setting is not saved until the +GPSSAVE=1 command is entered.5.4. Diagram for settings management The following diagram describes the Location AT application settings management: AirPrime Embedded Module Power On / Reset Location AT application started +GPSSAVE: 0 (NO) +GPSSAVE? (Does Location Application Flash Object exist?) +GPSSAVE: 1 (YES) Factory Default values are applied Impact on next start Location Library Flash object deleted Values of current session saved in Location Library Flash object Impact on next start Last stored values when +GPSSAVE command has been enterred Values modified through Location AT command AT+GPSSAVE=0 AT+GPSSAVE=1 Values modified through Location AT command Last know values within current session Note: Note: The factory default values are described for each field in tables describing Location AT commands.4 AT Commands Interface User Guide 5. please refer to Location AT commands error codes description. AT+GPSSAVE=? +GPSSAVE: (0-1) OK 5.3. AT+GPSSAVE? AT+GPSSAVE=1 Note: The current settings are saved.Location Library 1.1 November 6. 2012 22 . If +GPSSAVE already equals 1 and a setting is modified through an AT command (for example +GPSCONF). OK or +GPS ERROR: X Note: For more information about X value.

1. The final result will be sent to the associated event through an unsolicited response after the action has been completed.4.1 November 6. The input parameter specifies the type of START command When AT+GPSSTART (without parameter) is entered. for example AT+GPSCONF?.Location Library 1. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode. 5.4.2. 5.4. 2012 23 . 5. the GPS start with the default mode is selected by default.4 AT Commands Interface User Guide Note: The configuration of current session can be retrieved with the read command of each +GPS AT command. Command +GPSSTART Description This AT command starts the GPS or restarts the GPS after the +GPSSTOP or +GPSSLEEP command. Syntax Action command AT+GPSSTART= [<starting_mode>] OK Read command AT+GPSSTART? +GPSSTART:<starting_mode> OK Test command AT+GPSSTART=? +GPSSTART: (list of supported <starting_mode>s) OK 4111879 Rev 1. OK is returned if the request has been processed.

OK +GPSEVSTART: 1 or +GPS ERROR: X Note: For more information about X value.4. 3 <status> Please refer to Starting mode for more information about starting modes. 2012 24 . please refer to Location AT commands error codes description. AT+GPSSTART=? +GPSSTART: (0-3) OK 4111879 Rev 1. updated Almanac. "FACTCOLD" start with Factory Default Data instead of previous run data. 5. “WARM" start with previous NV stored data except Broadcasted Ephemeris.Location Library 1. Please refer to Diagram for settings management for more information.4 AT Commands Interface User Guide Unsolicited response +GPSEVSTART: <status> 5.1 November 6. The action has been successfully completed. AT+GPSSTART? AT+GPSSTART=1 Note: Starts GPS in WARM mode. If omitted: last known value within current session.4. Application state is unchanged. Command Examples Responses +GPSSTART: 0 OK Note: The current starting mode is the “HOT” start. Parameters and Defined Values The parameter specifies the GPS starting mode of the application.4. Factory default value: 0. "COLD" start with NO previous NV store data except calibration data. Event status 0 1 Note: Note: The action has failed. GPS Data are stored to NV memory during specific Location Services Application transition. These <starting_mode>: starting modes are used for test purposes.3. Time and last location are unknown. 0 1 2 "HOT" start with all previous NV stored data. Please refer to GPS data management for more information.

3.6. Command +GPSSTATE Description This AT command returns the current application state. Application is in GPS_UNINITIALIZED state 2. 2012 25 .1. Syntax Read command AT+GPSSTATE? +GPSSTATE:<state> OK Test command AT+GPSSTATE=? OK 6. Application is in GPS_SLEEP state 4111879 Rev 1. Application is in GPS_RUNNING state 4. 6.1. Advanced AT Commands Reference The following specific AT commands are defined to finely control and monitor the Location Services. Application is in GPS_INITIALIZED state 3. These commands can be used to assess performances of the system. 6.1.1.1 November 6.2. <state>: 0 1 2 3 Parameters and Defined Values Application state as described below 1.1. 6. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode.

<on_off>.2.<host_wakeup >. Command Examples Responses +GPSSTATE: 0 OK AT+GPSSTATE? AT+GPSSTATE=? OK 6.(list of supported <host_wakeup >s).(list of supported <gps_wakeup>s).(list of supported 4111879 Rev 1. If this command is omitted. Syntax Action command AT+GPSINIT= <hw> [.1.<reset>.1 November 6.1. It allows specifying the hardware setup of the system. default factory configuration is used.2.4. 6.2.<bus_type>.(list of supported <clock32k>s). 2012 26 . If no hardware setup was saved.<appli_led>] OK Read command AT+GPSINIT? +GPSINIT:2 OK Test command AT+GPSINIT=? +GPSINIT: (list of supported <hw>s). OK is returned if the request has been processed.4 AT Commands Interface User Guide 6. Command +GPSINIT Description This AT command initializes the Location Services. 6.2. (list of supported <on_off>s).<gps_wakeup>. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode. The final result will be sent to the associated event through an unsolicited response after the request has been processed. (list of supported <bus_number>s).<bus_number>.(list of supported < reset >s).Location Library 1. last saved hardware setup is used.<clock32k>. (list of supported <bus_type>s). It is accepted only if application is in GPS_UNINITIALIZED state.

4 AT Commands Interface User Guide <appli_led>s) OK Unsolicited response +GPSEVINIT: <status> 6. the other hardware settings should be specified or previously specified parameters apply.1 November 6.<clock32k>. 6. please refer to Location AT commands error codes description.<bus_number>.Location Library 1. If a Hardware Type is provided. no other parameter can be specified.4.3.2.<reset>. The action has been successfully completed. Hardware Configuration The default hardware resources settings according to the Hardware Type and Hardware Configuration are described below: 4111879 Rev 1.2.2. 2012 27 . 2 Hardware Type: SL808xT gpsOne Event status 0 1 The action has failed. Application state is unchanged. If a Hardware Configuration is provided.5.<host_wakeup >.<appli_led>] Command Responses +GPSINIT: 2 OK Note: Default configuration response AT+GPSINIT? AT+GPSINIT=2 Note: For default configuration applied on SL808xT gpsOne OK +GPSEVINIT: 1 or +GPS ERROR: X Note: For more information about X value.<bus_type>. See the Hardware Configuration section for more details on default hardware settings. Examples <hw> [.<gps_wakeup>. <hw >: Parameters and Defined Values Hardware value: Hardware Type or Hardware Configuration for initialization. <status> 6.<on_off>.

3.1 November 6.4 AT Commands Interface User Guide Hardware Type 2 (<hw>=2) Hardware setup compatibility <hw> SL808xT gpsOne.3. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode. 6.3. 6.Location Library 1. Please refer to GPS data management for more information. OK is returned if the request has been processed.2. The final result will be sent to the associated event through an unsolicited response after the action has been completed. Command +GPSSTOP Description This AT command stops the Location Services. The action has been successfully completed.1.3. 2 6. 4111879 Rev 1. Syntax Action command AT+GPSSTOP OK Test command AT+GPSSTOP=? OK Unsolicited response +GPSEVSTOP: <status> 6. 2012 28 .3. GPS Data are stored to NV memory during specific Location Services Application transitions. <status> 0 1 Parameters and Defined Values Event status The action has failed. Application state is unchanged.

AT+GPSSTOP AT+GPSSTOP=? OK 6. 6.1. 6.4. Command +GPSSLEEP Description This AT command puts the GPS receiver into the specified GPS sleep mode i. Command Examples Responses OK +GPSEVSTOP: 1 or +GPS ERROR: X Note: For more information about X value.3. This command stops the GPS processing mode.4 AT Commands Interface User Guide 6.e.4. please refer to Location AT commands error codes description. but allows for faster restarts when the GPS is restarted with the +GPSSTART command. This consumes slightly more power than complete off mode. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode. 2012 29 . Please refer to GPS data management for more information. Syntax Action command AT+GPSSLEEP = [<sleep_mode>] OK Read command AT+GPSSLEEP? +GPSSLEEP:<sleep_mode> OK Test command AT+GPSSLEEP=? +GPSSLEEP: (list of supported <sleep_mode>s) 4111879 Rev 1.4.2. GPS Data are stored to NV memory during specific Location Services Application transitions. it disables the gpsOne. The final result will be sent to the associated event through an unsolicited response after the action has been completed.1 November 6.4.Location Library 1. OK is returned if the request has been processed.

Application state is unchanged. Parameters and Defined Values GPS sleep mode If omitted: last known value within current session. <sleep_mode>: 0 1 2 <status> 0 1 GPS Idle mode (gpsOne is disabled) 6.5. 6. AT+GPSSLEEP AT+GPSSLEEP=? +GPSSLEEP: (0. or the calculated TTFF of this run if it has fixed.4.5. Command +GPSTTFF Description This command reports the calculated TTFF (2-Dimensional Position Fix and 3-Dimensional Position Fix) of the last run if no new run has started. GPS Deep Sleep mode Event status The action has failed.Location Library 1. GPS Hibernate mode 7.4.1. 5. The action has been successfully completed. Factory default value: 0. 4111879 Rev 1.4.1 November 6. 6.4 AT Commands Interface User Guide OK Unsolicited response +GPSEVSLEEP: <status> 6. please refer to Location AT commands error codes description. an error if the current run has no fix yet.3.2) OK 6. Command Examples Responses OK +GPSEVSLEEP: 1 or +GPS ERROR: X Note: For more information about X value. Please refer to Diagram for settings management for more information. 2012 30 .

Command Examples Responses +GPSTTFF: 32051. 3-Dimensional Position Time To First Fix. defined in ms.<3D_time> OK Test command AT+GPSTTFF=? OK 6.-30 OK Note: The current run is not fixed. This is subjected to GPS conditions. 6. 6. GPS_ERR_GPS_POS_NOT_FIXED (-30) is returned if the current run is not fixed.4. AT+GPSTTFF? AT+GPSTTFF? +GPSTTFF: -30.5.1 November 6. defined in ms. <2D_time>: <3D_time>: Parameters and Defined Values 2-Dimensional Position Time To First Fix.Location Library 1.5. AT+GPSTTFF=? OK 4111879 Rev 1. Syntax Read command AT+GPSTTFF? +GPSTTFF:<2D_time>.32051 OK or +GPS ERROR: X Note: For more information about X value.3. Note: Note: 2D TTFF value can be equal to 3D TTFF value if 3-Dimensional Position is directly fixed.5. please refer to Location AT commands error codes description.2. 2012 31 .4 AT Commands Interface User Guide Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode.

6. The action has been successfully completed.1 November 6.3. Application state is unchanged. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode. Syntax Action command AT+GPSRELEASE OK Test command AT+GPSRELEASE=? OK Unsolicited response +GPSEVRELEASE: <status> 6. 4111879 Rev 1. OK is returned if the request has been processed.6. 6.2. 6. 2012 32 .6.1. <status> 0 1 Parameters and Defined Values Event status The action has failed.4 AT Commands Interface User Guide 6.Location Library 1. The final result will be sent to the associated event through an unsolicited response after the action has been completed.6. Command +GPSRELEASE Description This AT Command releases the Location Services hardware and software resources.

AT+GPSRELASE AT+GPSRELEASE=? OK 6. please refer to Location AT commands error codes description.7.6.7.4 AT Commands Interface User Guide 6.2. 6. Syntax Read command AT+GPSVERS? +GPSVERS:<version> OK Test command AT+GPSVERS=? OK 6. <version>: Parameters and Defined Values Location Services version including:   AT command set version Location Library version 4111879 Rev 1. 2012 33 .3.7. Command Examples Responses OK +GPSEVRELEASE: 1 or +GPS ERROR: X Note: For more information about X value. Command +GPSVERS Description This AT Command reports the Software Version of the Location AT command set.4.1 November 6.1. 6.Location Library 1.7.

8. 6. AT+GPSVERS? AT+GPSVERS=? OK 6.4.<config_value> Action command AT+GPSCONF= OK Read command AT+GPSCONF? +GPSCONF: <config_type>.7.2.1.8. Command +GPSCONF No need to port that command on top of AirPrime SL808x-gpsOne for the first Location AT commands porting step (NMEA service support only).1 November 6. 2012 34 .(list of supported <config_value>s) [+GPSCONF:<config_type>.4 AT Commands Interface User Guide 6.Location Library 1.8. Command Examples Responses +GPSVERS: “Location Services version string” OK or +GPS ERROR: X Note: For more information about X value. Syntax <config_type>.<config_value>] OK Test command AT+GPSCONF=? +GPSCONF:<config_type>. Description This AT command configures the Location service and GPS receiver. please refer to Location AT commands error codes description. 6. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode.(list of supported <config_value>s)] OK 4111879 Rev 1.<config_value> [+GPSCONF: <config_type>.

In this case.3. If omitted: last known value within current session.4. Parameters and Defined Values This parameter specifies the configuration type on which the configuration value is applied.1 November 6. and reset must be issued after using this command. Restrictions are listed in the table below: GPS_SLEEP / GPS_HIBERNATE_MODE <config_type> = 8 (GPS enable) Allowed GPS_RUNNING Option Allowed Allowed Allowed 4111879 Rev 1. Location service configuration restrictions Some options cannot be configured while in GPS_RUNNING state. 2012 GPS_INITIALIZED GPS_SLEEP / GPS_IDLE_MODE 35 . Factory default value: 1.Location Library 1. Please refer to Diagram for settings management for more information. If value has been changed. +GPSSAVE=1 AT Command must be send.8. or in GPS_SLEEP state depending on the GPS sleep mode. GPS_ERR_BAD_STATE is returned by the +GPSCONF AT command.4 AT Commands Interface User Guide 6. <config_type>: 8 <config_value>: For <config_type> = 8 Define if GPS feature is allowed at the next boot. Define if GPS feature is allowed at the next boot Requested value of configuration type. 0: 1: GPS feature disabled GPS feature enabled 6.8.

1 November 6. 6.Location Library 1.2. 6.5. please refer to Location AT commands error codes description. AT+GPSCONF=8. Command Examples Responses OK or +GPS ERROR: X Note: For more information about X value. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode.8. retrieve the current default +GPSCONF: 8. SL808xT gpsOne GPS solution supports DEE thru the gpsOne XTRA (XTRA for short) feature.(0-1) +GPSCONF: 8. Command +GPSAID Foreword Intention has been to limit as much as possible the Location Library GPS Aiding Service AT commands changes while porting to SL808s gpsOne GPS solution. For example.1 6.0 Note: disable GPS feature at next boot AT+GPSCONF=? AT+GPSCONF? Note: Allow to configuration.4 AT Commands Interface User Guide 6. As a consequence some terminology may not be as accurate as it could be when considering gpsOne iso XM GPS solution.1.9.9. Downloaded Extended Ephemeris DEE (Downloaded Extended Ephemeris) improves start-up GPS performance by employing Extended Ephemeris data.2. In order to compute a position XTRA requires 1°) XTRA servers that provide assistance data so called XTRA data and 2°) the ability to acquire GPS satellites in order to compute a position (No Sattelites then NO Fix) 4111879 Rev 1. 6.9. 2012 36 . “Assistance data” or “Predicted Orbit data” would have been more appropriate than Downloaded Extended Ephemeris as in gpsOne case those data are not only Ephemeris.9.1. Description This AT command activates and configures the Aiding modes. The Extended Ephemeris data should be downloaded from an Extended Ephemeris server and outlast a standard broadcast ephemeris.

Syntax For <config_type> = 1 Action command AT+GPSAID=<config_type>.1 November 6. Both bearer and communication socket management are encapsulated within SL808xT gpsOne XTRA assisted GPS.[<dee_timeout>]]]]]]] OK For <config_type> = 2 Action command AT+GPSAID=<config_type>.9. While the XTRA download/injection is in progress. Assistance data validity XTRA Data is valid for seven days. 2012 37 . the GPS Engine will send an event via a registered client event handler to download the assistance data. If the XTRA download/injection fails. the device will do a check to determine if it’s assistance data is valid (XTRA data valid for 7 days once downloaded/injected).9. SL808x assisted GPS operation using XTRA First.3.[<dee_sever_code>][.9. 6.<dee_mode>[. If the data is not valid.1. 6. XTRA Data is downloaded using an http get as a binary file that must be injected into the gpsOne GPS Engine using specific PDAPI function calls (Practically it appears that the XTRA data files are updated each day).2. The assistance data is stored in the device EFS (CGPS_PE Folder in EFS Explorer) for later use. gpsOneXTRA feature must be enabled on the device.9. If it is valid. XTRA Servers and XTRA data are fully hosted by QC and provided as free service.<dee_command> OK 4111879 Rev 1.2.2. the standalone fix in progress may still return successful if satellites are acquired during the standalone search.[<dee_socket_type>][.1. it uses the assistance data to compute the fix.3.4 AT Commands Interface User Guide 6. Server and Assistance data download Three servers are provided (URL set by default) so that the requests are load balanced.1. the standalone fix will continue to be processed. Any time a fix is requested.1. [<dee_period>] [.Location Library 1.[<dee_server_address>] [.[<dee_sever_port>] [.2. and XTRA is enabled. 6.

(list of supported <dee_socket_type>s). <dee_period>.   DEE configuration.<dee_mode>.4 AT Commands Interface User Guide Read command AT+GPSAID? +GPSAID:1.<dee_server_address>.bin”.(list of supported <dee_timeout>s) +GPSAID:2.<dee_sever_code>.  Range: 0-65535 <dee_server_address> Address of the DEE servers (up to 3) are URL Can be one of the 3 following preset assistance data server: Primary Server: http://xtra1.(list of supported <dee_sever_port>s). Please refer to Diagram for settings management for more information.9.net/xtra. DEE is activated.gpsonextra.1 November 6.  Factory default value: 0.bin"  If omitted: last known value within current session.Location Library 1. Read Only parameter: returns GPS_ERR_NOT_AVAILABLE(. <config_type>: 1 2 <dee_mode>:  This parameter specifies the DEE (Downloaded Extended Ephemeris) mode.<dee_sever_port>.(list of supported <dee_period>s).gpsonextra.4.(list of supported <dee_command>s) OK 6.<dee_so cket_type>.  Factory default value: 3.gpsonextra. Parameters and Defined Values  This parameter specifies the configuration type on which the configuration is applied.(list of supported <dee_mode>s).gpsonextra.bin Tertiary Server: "http://xtra3.net/xtra.<dee_command> OK Test command AT+GPSAID=? +GPSAID:1.  If omitted: last known value within current session. Please refer to Diagram for settings management for more information.4) error <dee_server_port> <dee_server_code> 4111879 Rev 1. (list of supported <dee_sever_code>s). 0: 1: <dee_period> DEE period in day(s). 2012 38 . If omitted: last known value within current session.bin Secondary Server: http://xtra2.4) error.  Factory default value: “http://xtra1.<dee_timeout> +GPSAID:2.net/xtra.net/xtra. Read Only parameter: returns GPS_ERR_NOT_AVAILABLE(. DEE command.(list of supported <dee_server_address>s).     DEE is deactivated.

This command requests EE file update This command stops EE download if any. Download is always forced: same as dee_command=3 (Force download)    o o o   <dee_command> = 2 Stop ongoing XTRA data file download not possible. If the command is pending. <dee_command> is automatically configured to 0 when the command is performed. GPS_ERR_BAD_STATE is returned by the +GPSAID AT command. While the XTRA download/injection is in progress. The assistance data is stored in the device NV memory for later use.65535 <dee_command> 0: 1: 2: 3:     This command has no effect.4) error Socket connection timeout value in second(s).Location Library 1. The FW is capable to download the XTRA data thru an embedded client. Factory default value: 10 <dee_socket_type> <dee_timeout> Range: 0 . it uses the assistance data to compute the fix. In this case. This command stops aiding sequencer and returns related stop event. If the data is not valid. the standalone fix in progress may still return successful if satellites are acquired during the standalone search. o o o o Anytime a fix is requested (assuming XTRA is enabled) the device will check validity of assistance data (XTRA data valid for 7 days once downloaded/injected). the error GPS_ERR_INVALID_PARAMETER is returned.5.9. 6. the read of this parameter returns the last entered DEE command. the Location library will request to download the assistance data. DEE file download should be requested once again. <dee_command> = 1 does not assume any service aiding configuration (neither Assistance data server URLs nor connection settings nor credential for server access… etc) <dee_command> = 1 allows DEE file update as described hereunder. Factory start (please refer to gps_startingMode_e) removes DEE file. Aiding Service Configuration Restrictions Some options cannot be configured while in some state(s). Please refer to Diagram for settings management for more information. Once the XTRA data is downloaded. for example in GPS_INITIALIZED state. Download process is not aborted. This command forces EE file download.  <dee_mode> : RESET must be issued after this command is used. but indicates that no command is pending. This command is used only for test purpose. To retrieve it. If it is valid. If omitted: last known value within current session. 4111879 Rev 1.4 AT Commands Interface User Guide Read Only parameter: returns GPS_ERR_NOT_AVAILABLE(. the standalone fix will continue to be processed.1 November 6. If <dee_period> is not supported. it is injected into the GPS Engine and the assistance data flags is show that assistance data is valid (download and injection have been successful). XTRA data file download started immediately (for example in GPS_INITIALIZED state). If the XTRA download/injection fails. 2012 39 .

(“TCP”).10 +GPSAID: 2.(065535).(0-1).1.”ServerAuthCode”.6.(0-65535). . OK or +GPS ERROR: X Note: For more information about X value. Command Examples Responses OK or +GPS ERROR: X Note: For more information about X value.4 AT Commands Interface User Guide Restrictions are listed in the table below: Option   <config_type> = 1 (DEE configuration) <config_type> = 2 (DEE command)   Allowed Authorized   Not allowed Allowed   Not allowed Allowed   Authorized 6.”ServerAddress”.””. +GPSAID: 1.9.0. 2012 GPS_SLEEP / GPS_HIBERNATE_MODE Allowed GPS_SLEEP / GPS_IDLE_MODE GPS_NITIALIZED GPS_RUNNING 40 .3. please refer to Location AT commands error codes description.. please refer to Location AT commands error codes description. Examples of AT Command Sequence AT+GPSSAVE=0 /* reset the whole of gps settings */ 4111879 Rev 1.(0-65535) +GPSAID: 2.7. AT+GPSAID=1. AT+GPSAID=? +GPSAID: 1.Location Library 1..1 Note: activates the DEE mode.TCP.(0-2) OK AT+GPSAID? Note: Allow to retrieve the current configuration.0 OK 6.1 November 6.1 Note: requests EE file download.9. AT+GPSAID=2.””.

10.2. Command +GPSCORE 6.Location Library 1... AT+GPSSTART=3 OK +GPSEVSTART: 1 +GPSEVPOS: 0 +GPSEVPOS: 3 … 6.<rate>.10.4 AT Commands Interface User Guide AT+CFUN=1 or HW reset AT+GPSINIT=2 AT+GPSAID=1. 6.<core_info> OK Test command AT+GPSCORE=? +GPSCORE: (list of supported <output>s) .[<rate>][.10080 . Syntax Action command AT+GPSCORE=[<output>][.<core_info>]] OK Read command AT+GPSCORE? +GPSCORE: <output>. Description This AT command configures core information mode and the output port of the core information.10.(list of supported <rate>s) .2.1.1 November 6.(list of supported <core_info>s) OK 4111879 Rev 1.1 AT+GPSSAVE=1 /* save gps settings */ AT+CFUN=1 or HW reset AT+CGDCONT= «PDP Profile» /* if not define */ AT+GPSAID=2. Please refer to the State Machine and AT Commands Calls Requirements for more information about call state and transition mode.1 +GPSEVAID: 1. 2012 41 .

4 AT Commands Interface User Guide 6.1 November 6. If omitted: last known value within current session. Factory default value: 0. Note: Core information is received through +GPSEVCORE asynchronous event. Core information output on port where the +GPSCORE command was received. Core information output on UART 2.Location Library 1. If omitted: last known value within current session. Please refer to Asynchronous_Events for more information. (Hexadecimal value entered without the prefix “0x”). Core information output on USB. Factory default value: 1. Factory default value: 0. Please refer to Diagram for settings management for more information. Core information output on UART 1. This parameter defines the core information update rate in seconds. (0<<0): Core information data output disabled. the core information frames will be sent only once. Please refer to Diagram for settings management for more information. <core info>: Core information list encode mask. Please refer to Diagram for settings management for more information. Range: 0-65535 Note: If this parameter equals 0. 0 1 2 3 4 <rate>: Core information output disabled. 4111879 Rev 1. 2012 42 . on the next occurrence of the core information frames update. If omitted: last known value within current session.10.3. Hexadecimal value entered without the prefix “0x”. Parameters and Defined Values <output>: This parameter specifies the port to be used by the application to transmit the core information.

+GPSEVERROR: An error has been detected. Please refer to Location AT commands error codes for more details. 7. Description The following asynchronous events can be received as unsolicited responses: +GPSEVABORT: Following error detection.2. 2012 43 . Syntax Unsolicited response +GPSEVPOS: <pos_event> Unsolicited response +GPSEVABORT: <abort_cause> Unsolicited response +GPSEVERROR: <error> Unsolicited response +GPSEVINIT: <status> Unsolicited response +GPSEVSTART: <status> 4111879 Rev 1. +GPSSTART. Asynchronous Events The asynchronous events inform about Location Services events. After this event the application state is automatically changed to GPS_INITIALIZED. +GPSSTOP.1 November 6. +GPSSLEEP and +GPSRELEASE.1.7. 7. The others events are associated to the following AT Commands described in this document: +GPSINIT. the Location Services are aborted and the application is stopped.

<aid_event> Note: This event informs the user that DEE files are valid.hh:mm:ss” Unsolicited response +GPSEVAIDERROR: <aid_error>. 2012 44 .Location Library 1.<aid_ext_error> 4111879 Rev 1. For <aid_mode> = 1 and <aid_event> = 4 and <aid_event_display> = 1 Unsolicited response +GPSEVAID: <aid_mode>.<dee_validity_stop> Note: <dee_validity_start> and <dee_validity_stop> are printed with the following format: “yy/MM/dd.<aid_event> For <aid_mode> = 1 and <aid_event> = 2 Unsolicited response +GPSEVAID: <aid_mode>.1 November 6.<aid_event_display>.4 AT Commands Interface User Guide Unsolicited response +GPSEVSTOP: <status> Unsolicited response +GPSEVSLEEP: <status> Unsolicited response +GPSEVAID: <aid_mode>.<aid_event>.<dee_validity_start>.

Location Library 1. <error> Parameters and Defined Values Error number (Please refer to Location AT Application error codes) <pos_event> 0 1 2 3 4 <abort_cause> <status> 0 1 <aid_mode> 1 <aid_event> 0 1 2 3 4 DEE is stopped DEE is started DEE is valid : DEE is aborted : not supported DEE information : Returned deeValidity is given as two timestamps (first corresponding to the time the validity of the DEE begins. Application state is unchanged.1 November 6. The action has been successfully completed. Error number (Please refer to Location AT Application error codes) Event status The action has failed. second corresponding to the time the validity of the DEE ends) The GPS fix position has been detected lost. GPS fix state has been changed to 2-Dimensional Position. GPS Aiding mode Downloaded Extended Ephemeris 4111879 Rev 1.4 AT Commands Interface User Guide Unsolicited response +GPSEVRELEASE: <status> 7. GPS fix state has been changed to 3-Dimensional Position. GPS fix state has been changed to estimated (ie forward predicted) Position. GPS fix state has been changed to invalid Position. 2012 45 .3.

A state transition is in progress. Internal error. Table 2: Location AT commands error codes Error Code -1 -2 -3 -4 -5 -10 -11 -12 -13 -14 -15 -16 -20 -21 -22 -23 -24 -25 -26 -30 -40 -41 -42 -60 -61 -62 -63 -64 -65 Error name Description GPS_ERR_BAD_STATE GPS_ERR_STATE_ALREADY GPS_ERR_INVALID_PARAMETER GPS_ERR_NOT_AVAILABLE GPS_ERR_STATE_TRANSITION GPS_ERR_PORTING_LAYER_INIT GPS_ERR_INIT GPS_ERR_IO_INIT GPS_ERR_BUS_INIT GPS_ERR_SCHED_INIT GPS_ERR_CORE_SW_INIT GPS_ERR_NV_MEMORY_INIT GPS_ERR_SCHED_TASK GPS_ERR_BUS GPS_ERR_IO_MNGT GPS_ERR_CORE_SW GPS_ERR_NV_DATA_ACCESS GPS_ERR_INTERNAL GPS_ERR_SERVICE GPS_ERR_GPS_POS_NOT_FIXED GPS_ERR_ABORT_INTERNAL GPS_ERR_ABORT_NMEA GPS_ERR_ABORT_RESET GPS_AT_ERR_INTERNAL GPS_AT_ERR_INVALID_PARAMETER GPS_AT_ERR_FLASH_DATA_ACCESS GPS_AT_ERR_PORT GPS_AT_ERR_APPLI_LED GPS_AT_ERR_SCHED_TASK The function has been called in an unauthorized application state The requested action has been already performed and the target application state is currently activated. Application port configuration error. Invalid input parameter.1 November 6. The initialization of the porting layer failed (Internal error) Application initialization error IO initialization error Bus initialization error Scheduler initialization error Application core software initialization error Non-Volatile memory initialization error Application task schedule error. Location AT Commands Error Codes The following error codes could be returned from Location AT commands.8. Application internal error. Application task schedule error. Application Flash access error. 4111879 Rev 1. Bus error IO management error Application core software error Non-Volatile store media (Embedded Module FLASH memory) access error for the GPS Non-Volatile data. Reset Watchdog. Application invalid input parameter. 2012 46 . This feature or configuration is not available for software and/or hardware version. The current run is not fixed Internal abort. NMEA update rate Watchdog. The asked service is not performed. Application Led management error.

Index +GPSAID. 17 +GPSINIT. 32 +GPSSAVE. 18 +GPSRELEASE. 25 +GPSSTOP. 29 +GPSSTART. 28 +GPSTTFF. 23 +GPSSTATE.1 November 6. 2012 47 . 34 +GPSCORE. 33 4111879 Rev 1. 36 +GPSCONF. 30 +GPSVERS. 21 +GPSSLEEP. 26 +GPSNMEA. 41 +GPSHELP.