Location Library 1.5.1 Release note

Jun 22, 2012 - Author: Sierra Wireless - Version 1.5.1 - 3419 Views

    Last Update: June 15th, 2012

  1. NEW FEATURES. 
  2. SOFTWARE RELEASE DESCRIPTION.
    2.1 Software Identification.
    2.2 Deliverables.
    2.3 Compatibility.
    2.4 Software Installation.
  3. KNOWN RESTRICTIONS.
  4. INTERFACE MODIFICATIONS.
    4.1 Library APIs.
    4.2 GPS AT Commands.
  5. CORRECTIONS & IMPROVEMENTS.
  6. 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. Software Release Description
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)



2.4 Software Installation

To use the GPS AT commands, you can download the Extended AT Command Application binary on top of your Embedded Module Firmware. The .dwl application file is available from latest Open AT Framework SDK 2.51 (see Download tab on Location Library product page:

http://www.sierrawireless.com/productsandservices/AirPrime/Application_Framework/Libraries/Location.aspx ).

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.
please notice that start or stop event will occur anyway.

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:

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.



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.

Documentation

Comment

©2024 All rights reserved
×
You have been successfully unsubscribed to this product. To access your subscription click here.