Location Library 1.5.1 Release note
- Jun 22, 2012
- Author: Sierra Wireless
- Version: 1
Last Update: June 15th, 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.
1. New Features.
The Location Library 1.51 is an update release of Location Library 1.3 that does include following new features compared to Location library 1.3 release:
- Host RTC: Location library/XM0110 use the Embedded Module RTC time to build its clock reference. Pay back is BOM saving (extra hw to generate/maintain the clock is useless) wo any TTFF performance degradation.
2.1 Software Identification
|
Software Identification |
|
|
Location Library Package |
1.5.1.201204231425 |
|
Version string reported by the Library Library API |
GPS-LocLib.1.5.1-Mar 28 2012-08:35:15-SiRFHostIV-4.1.2-P3 c1a GSD4t_4.1.2-P3 02/22/2012 053 |
|
Version string reported by the +GPSVERS? AT command |
GPSAT.1.5.1 -GPS-LocLib.1.5.1-Mar 28 2012-08:35:15-SiRFHostIV-4.1.2-P3 c1a GSD4t_4.1.2-P3 02/22/2012 053 |
2.2 Deliverables
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.
2.3 Compatibility
|
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.51 or later Firmware 7.51 or later OS 6.51 or later WIP 5.53 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
|
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. |
|
62737 |
GPSEVAID: 0,2 is not available |
GPS AT cmd. Location Lib. |
Memory requirements section for more details.
3. Known restrictions
The known restrictions of this release are:
|
Id |
Description (What / When) |
Impacted Domain |
Impacted Sub Domain |
Detected in … |
|
63248 |
if task for DEE is not statically declared (see simple sample to get an exemple), error event occurs during start transition or stop. |
GPS_AT_cmd |
|
1.5.1 |
|
|
4. Interface modifications
4.1 Library APIs
The Location Library interface modifications 1.3.0.201202061130 release are:
|
Backward Compatible |
Change |
Comments |
|
Yes |
gps_coreOpt_e GPS_OPT_CORE_JAMMING enum value added |
|
|
No |
gps_coreOpt_e GPS_OPT_CORE_INFO enume value renamed GPS_OPT_CORE_INFO_DATA |
|
|
No |
gps_coreDebugData_e GPS_CORE_DEBUG_TRACE enum value removed |
|
|
No |
gps_coreDebugEvent_e GPS_CORE_DEBUG_TRACE_EVT enum value removed |
|
|
No |
gps_coreBlanking_e GPS_CORE_BLANKING_ON_1_SLOT renamed GPS_CORE_BLANKING_ON. GPS_CORE_BLANKING_ON_2_SLOTS and GPS_CORE_BLANKING_ON_4_SLOTS removed |
|
|
Yes |
Add gps_coreCWRemoving_e for Jamming feature |
|
|
No |
gps_aidingAeeEventInfo_t aeeSvTime field renamed by aeeSvValidity field |
|
|
No |
gps_aidingDeeEventCompleted_t deeDownloadTime field removed |
|
4.2 GPS AT Commands
The Location AT commands interface modifications since 1.3.0.201202061130 release are:
|
Backward Compatible |
Change |
Comments |
|
YES |
New CW Removal parameter for +GPSCONF command |
|
|
NO |
Remove Debug Core trace value for <debug_data> field |
|
|
No |
Replace aee_svtime with aee_SvValidity in +GPSEVAID unsolicited response for AEE |
|
|
No |
Remove dee_dwl_time field in +GPSEVAID unsolicited response for DEE |
|
5. Corrections & Improvements
The following issues have been fixed in this release compared to 1.3.0.201202061130 release:
|
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. |
|
|
62737 |
GPSEVAID: 0,2 is not available |
GPS AT cmd. Location Lib. |
6. Memory requirements
The GPS_AT_cmd application binary size is 925kB 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 |
792 kBytes |
818 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 |
792 kBytes |
818 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,
- 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.
Comment
Forum