Location Library 1.3 Release note
- Mar 7, 2012
- Author: Sierra Wireless
- Version: 1
Last Update: March 7th, 2012
- NEW FEATURES.
- SOFTWARE RELEASE DESCRIPTION.
2.1 Software Identification.
2.2 Deliverables.
2.3 Compatibility.
2.4 Software Installation. - KNOWN RESTRICTIONS.
- INTERFACE MODIFICATIONS.
4.1 Library APIs.
4.2 GPS AT Commands. - CORRECTIONS & IMPROVEMENTS.
- MEMORY REQUIREMENTS.
The Location Library1.3 is an update release of Location Library 1.2 that does include following new features compared to Location library 1.2 release:
- Solution Accuracy New ‘$PSWI-SA’ NMEA sentence providing indicator about quality of fix
- XM0110 Deep sleep mode: Ability to decrease XM0110 power consumption below 10µA.
- Assisted GPS: Server based Extended Ephemeris from SiRF server.
- Time To First Fix improvement: faster TTFF now returning 2D fix in addition to 3D fix.
- GPS Tracking: now configurable at a lower rate than 1 Hertz, decreasing global power consumption of the system.
- Jamming detection and removal: Notify application of GPS Jammers presence and filter it.
- Software blanking: Limit wide band noise link to GSM/GPRS impact in case of antennas proximity.
2. Software Release Description.
|
Software Identification |
|
|
Location Library Package |
1.3.0.201202061130 |
|
Version string reported by the Library Library API |
GPS-LocLib.1.3.0-Feb 6 2012-11:24:31-SiRFHostIV-4.1.2-B9c1a GSD4t_4.1.2-B9 02/02/2012 033 |
|
Version string reported by the +GPSVERS? AT command |
GPSAT.1.3.0 -GPS-LocLib.1.3.0-Feb 6 2012-11:24:31-SiRFHostIV-4.1.2-B9c1a GSD4t_4.1.2-B9 02/02/2012 033 |
This Location Library release includes
- The Location Library for Open AT: an Open AT library, ready to be integrated into customer application thanks to an high level simple and generic GPS API set. See “Location Library Development Guide” for API description and porting guidelines..
- The GPS_AT_cmd sample application: an application offering AT commands on top of Location Library . This application is available in source code allowing customer to use it as an example, to integrate it in its application, or to enhance it. See “Location AT Commands Interface Guide” for description of the GPS AT commands implemented.
- The SimpleSample sample application: This application is available in source code, starts the Location service and output the GPS position data to the user through AT responses. It is designed for use with XM0110 Development Kit Daughter Board with UART configuration and does not require entering any application specific AT commands.
|
Air Prime™ Intelligent Embedded Module compatibility list |
|
WMP1x0* / Q2686G/87G** / SL6087 |
* 16Mb RAM or larger is required. 32/8Mb memory combo not supported, 32/16Mb memory combo supported but requires changing default memory mapping.
** Q2686H and Q2687H are not supported due to memory limitation.
|
GPS hardware compatibility list |
|
XM0110 (XM0110 Daughter Board for Development Kit, or XM0110 based application) |
|
OS / Firmware / Libraries compatibility |
|
Open AT Framework 2.37 or later Firmware 7.47 or later OS 6.37 or later WIP 5.43 or later IMPORTANT: not compatible with Open AT Framework 2.34, Open AT Framework 2.35 / not compatible with Firmware 7.44 and 7.45 |
|
Tools compatibility list |
|
Developer Studio: 1.2.0 or later Tool chains: ARM_EABI_GCC and RVDS (ARM_ELF_GCC not supported) |
You can also refer to the AirPrime XM0110 Development Kit Daughter Board User Guide or to Sierra Wireless Discovery Tool GPS page to assist you in your first steps.
To integrate the Location Library for Open AT® to your own application, you must install the Open AT Framework SDK and include the “Location Library” in the Libraries tabs of your project properties. You can also create a new Open AT project based on the Location Library samples available in the SDK: the GPS Simple sample or the GPS_AT_cmd sample.
NOTE: Depending on your system memory, you may encounter Memory Allocation Error while loading the application binary on your Embedded Module. Please review Memory requirements section for more details.
The known restrictions of this release are:
|
Id |
Description (What / When) |
Impacted Domain |
Impacted Sub Domain |
Detected in … |
|
61415 |
The first start is failed from Sleep state / IDLE mode when GPS position is not fixed within 10 sec, before going to Sleep state / IDLE mode. |
GPS AT cmd. Location Lib. |
|
1.2.0 |
|
61503 |
Stop transition could be blocked if transition is triggered on GPS_START_EVENT event. Therefore GPS_ERR_STATE_TRANSITION error (-5) is always returned. |
GPS AT cmd. Location Lib. |
|
1.2.0 |
|
62602 |
Location start error related to GPS firmware download failure can occur with I2C bus. |
GPS AT cmd. Location Lib. |
I2C |
1.3.0 |
|
62737 |
GPSEVAID: 0,2 is not available |
GPS AT cmd. Location Lib. |
A-GPS |
1.3.0 |
The Location Library interface modifications 1.2.0.201108191103 release are:
|
Backward Compatible |
Change |
Comments |
|
Yes |
gps_pvtFixState_e GPS_FIX_1SV_DEGRADED, GPS_FIX_2SV_DEGRADED enum values added |
|
|
Yes |
gps_coreOpt_e GPS_OPT_CORE_INFO_HANDLER, GPS_OPT_CORE_INFO_DATA, GPS_OPT_CORE_INFO_RATE, GPS_OPT_CORE_NAV_RATE_FACTOR, GPS_OPT_CORE_BLANKING enum values added |
|
|
Yes |
gps_coreDebugData_e GPS_CORE_DEBUG_INFO, GPS_CORE_DEBUG_TRACE, GPS_CORE_DEBUG_MAX enum values added |
|
|
Yes |
gps_coreLnaConfig_e GPS_LNA_INTERNAL_WITH_GPIO_LNA_EN_ALWAYS_OFF, GPS_LNA_EXTERNAL_WITH_GPIO_LNA_EN_ALWAYS_OFF enum values added |
|
|
Yes |
gps_coreDebugEvent_e GPS_CORE_DEBUG_INFO_EVT, GPS_CORE_DEBUG_TRACE_EVT enum values added |
|
|
Yes |
Add gps_coreInfoEvent_e, gps_coreInfoData_e, gps_coreInfoJam_t, gps_coreBlanking_e enum for Core information management |
|
|
Yes |
Add new callback definition gps_coreInfoHandler_f for Core Information management |
|
|
Yes |
gps_pvtPosition_t validStatus field added |
|
|
Yes |
gps_sleepMode_e GPS_DEEP_MODE enum value added |
|
|
Yes |
gps_infoOpt_e GPS_OPT_INFO_2D_TTFF, GPS_OPT_INFO_3D_TTFF enum values added |
|
|
Yes |
gps_aidingDeeCmd_e GPS_AIDING_DEE_CMD_FORCE enum value added |
|
- Applications based on Location Library are not compatible with
- WMP1x0 with 32/8Mb memory combo. 32/16Mb, 64/16Mb, or larger must be used.
- Applications based on Location Library may require to change Embedded Module storage space allocation. To check the current values use AT+WOPEN=6 command. The application size storage must be greater than the application binary size and can be increase by decreasing the A&D storage size with AT+WOPEN=6,XXX command.
- Developer Studio project must be built with 1MB+ memory options.
- If you are using Developer Studio 1.1.2 or later and create an application based on GPS_AT_cmd sample or Simple XM0110 GPS sample, this will be managed automatically.
The Location AT commands interface modifications since 1.2.0.201108191103 release are:
|
Backward Compatible |
Change |
Comments |
|
NO |
+GPSVERS command return : Sample version added |
|
|
YES |
New Reduced Rate GPS Navigation parameter and Blanking configuration for +GPSCONF command |
|
|
YES |
New +GPSCORE command for Jammer Information configuration |
|
|
NO |
Value 4 is forbidden in field <output> for +GPSDEBUG Command |
|
|
YES |
Add Debug Core information and Debug Core traces in field <debug data> for +GPSDEBUG Command |
|
|
YES |
+GPSSLEEP=0 can be done only if GPS 3D fix is available |
|
|
No |
+GPSTTFF command returns also the calculated 2D TTFF |
|
|
Yes |
New DEEP SLEEP mode for +GPSSLEEP command |
|
|
Yes |
New DEE forced download command for +GPSAID command |
|
5. Corrections & Improvements.
|
Id |
Issue Description |
Impacted Domain |
|
|
59165 |
GPS_SLEEP state is not restored after AT+GPSSAVE=1 and +CFUN=1. |
Sleep mode |
|
|
60806 |
Lost of channel communication between Host and XM0110 in I2C |
|
|
|
59669 |
gps_getState should return GPS_ERR_STATE_TRANSITION (-5) when the transition is in progress |
|
|
|
61393 |
GPSEVABORT: -41 may be produced while SLEEP IDLE. |
GPS AT cmd. Location Lib. |
|
|
|
Support SirfHostIV tracker - v4.1.2 (Host and FW libraries – Product candidate release) - SiRFHostIV-4.1.2-B9c1a B9c1a Host library – Product candidate release - GSD4t_4.1.2-B9 tracker FW library version – Product candidate release |
|
|
The GPS_AT_cmd application binary size is 954kB for RVDS compiler use. The Library memory footprint depends on the tool chain used:
|
Tool chain |
|
Location Library |
Location Library with AT Application |
|
GCC_EABI |
ROM |
822 kBytes |
847 kBytes |
|
RAM total (with EE) |
322 kBytes |
334 kBytes |
|
|
RAM total (no EE) |
259 kBytes |
271 kBytes |
|
|
Static RAM |
236 kBytes |
236 kBytes |
|
|
Stack size (no EE) |
23 kBytes |
35 kBytes |
|
|
Extra Stack size for AEE |
7 kBytes |
7 kBytes |
|
|
Extra Stack size for DEE |
16 kBytes |
16 kBytes |
|
|
Dynamic RAM (no EE) |
0 kBytes |
0 kBytes |
|
|
Extra dynamic RAM for EE |
40 kBytes |
40 kBytes |
|
|
NV Memory (with EE) |
60 kBytes |
60 kBytes |
|
|
NV Memory (no EE) |
20 kBytes |
20 kBytes |
|
|
RVDS |
ROM |
821 kBytes |
847 kBytes |
|
RAM total (with EE) |
321 kBytes |
332 kBytes |
|
|
RAM total (no EE) |
258 kBytes |
269 kBytes |
|
|
Static RAM |
236 kBytes |
236 kBytes |
|
|
Stack size (no EE) |
22 kBytes |
33 kBytes |
|
|
Extra Stack size for AEE |
7 kBytes |
7 kBytes |
|
|
Extra Stack size for DEE |
16 kBytes |
16 kBytes |
|
|
Dynamic RAM (no EE) |
0 kBytes |
0 kBytes |
|
|
Extra dynamic RAM for EE |
40 kBytes |
40 kBytes |
|
|
NV Memory (with EE) |
60 kBytes |
60 kBytes |
|
|
NV Memory (no EE) |
20 kBytes |
20 kBytes |
IMPORTANT: Due to memory constraints,
Comment
Forum