Location Library 1.2 Release notes

Aug 19, 2011 - Author: Sierra Wireless - Version 1.2 - 787 Views

    Last Update: August 19th, 2011

  1. NEW FEATURES. 
  2. SOFTWARE RELEASE DESCRIPTION.
    2.1 Software Identification.
    2.2 Compatibility.
    2.3 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 Plug-In 1.2 is an update release of Location Plug-In 1.1.1 that does include following new features compared to Location Plug-In 1.1.x release:

  • Compatibility to Embedded Module sleep mode (32K mode) when using XM0110 I2C interface.
  • Support SirfHostIV tracker - v4.1 (Host and FW libraries)
  • A-GPS based upon 3 days of DEE and including interface with WIP APIs and ATCommands
  • Option to set the AEE banking period
  • Mechanism to enable and output AEE debug info.
  • CW jammer removal (anti-jamming) feature that’s always enabled by default.
  • SW blanking feature that’s always enabled by default.

This Location Plug-In release includes

  • The Location Plug-In 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 Plug-In Development Guide” for API description and porting guidelines..
  • The GPS_AT_cmd sample application: an application offering AT commands on top of Location Plug-In 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.

2. Software Release Description.

2.1 Software Identification.

Software Identification

Location Plug-In Package

1.2.0.201108191103

Version string reported by the Plug-In Library API

GPS-LocLib.1.2-Aug 19 2011-10:57:24 -SiRFHostIV-4.1.0-P1c2b GSD4t_4.1.0-P1 01/07/2011 007

Version string reported by the +GPSVERS? AT command

GPS-LocLib.1.2-Aug 19 2011-10:57:24 -SiRFHostIV-4.1.0-P1c2b GSD4t_4.1.0-P1 01/07/2011 007

2.2 Compatibility.

Air Prime™ Intelligent Embedded Module compatibility list

WMP1x0* / Q2686G/87G** / Q26Ex / 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 / Plug-Ins compatibility

OASiS 2.36 or later

Firmware 7.46 or later

OS 6.36 or later

WIP 5.42 or later

IMPORTANT: not compatible with OASiS 2.34, OASiS 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.3 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 OASiS SDK 2.36 (see Download tab on Location Plug-In 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 Plug-In for Open AT® to your own application, you must install the OASiS SDK and include the “Location Plug-In” in the Plug-Ins tabs of your project properties. You can also create a new Open AT project based on the Location Plug-In 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.

3. Known restrictions.

The known restrictions of this release are:

Id

Description (What / When)

Impacted Domain

Impacted

Sub Domain

Detected in …

58187

When in GPS_SLEEP state, sleep request (AT+GPSSLEEP=X or gps_sleep(GPS_XXX_MODE)) is rejected. It is required to go to GPS_RUNNING state to change sleep mode.

GPS AT cmd.

Location Lib.

Sleep mode

1.0.1

59165

GPS_SLEEP state is not restored after AT+GPSSAVE=1 and +CFUN=1.

GPS AT cmd.

 

Sleep mode

1.0.1

61415

 GPSSTART fails 1 time / over 2 when it is performed in SLEEP IDLE

GPS AT cmd.

Location Lib.

 

1.2.0

60688

gps_corePowerRate_e documented but not implemented in the code

Location Lib.

 

1.1

59669

gps_getState should return GPS_ERR_STATE_TRANSITION (-5) when the transition is in progress

GPS AT cmd.

Location Lib.

 

1.1

60806

Lost of channel communication between Host and XM0110 in I2C

GPS AT cmd.

Location Lib.

 

1.1

61393

GPSEVABORT: -41 may be produced while SLEEP IDLE.

GPS AT cmd.

Location Lib.

 

1.1

 

DEE are valid for 3days. DEE that have been stored in NV memory can be replaced with newer Ephemeris only when validity period has expired. DEE validity is not more than 3days.

GPS AT cmd.

Location Lib.

A-GPS

 

4. Interface modifications.

4.1 Library APIs.

The Location Plug-In interface modifications since 1.1.1.201104130840 release are:

Backward

Compatible

Change

Comments

Yes

gps_coreOpt_e GPS_OPT_CORE_BANKING_EE enum value added

 

Yes

gps_coreAidingMode_e enum DEPRECATED, need to use gps_aidingMode_e enum instead

 

Yes

Add gps_aidingOpt_e, gps_aidingMode_e, gps_aidingDeeCmd_e, gps_aidingEvent_e and gps_aidingStatus_e enum for Aiding mode management

 

Yes

Add gps_aidingErrorEvent_t, gps_aidingAeeEventInfo_t, gps_aidingDeeEventCompleted_t, gps_aidingDeeEventInfo_t and gps_aidingEventData_u types for Aiding mode management

 

Yes

Add new callback definition gps_aidingHandler_f for Aiding mode management

 

Yes

Add gps_aidingSetOpts and gps_aidingGetOpts function for Aiding mode management

 

4.2 GPS AT Commands.

The Location AT commands interface modifications since 1.1.1.201104130840 release are:

Backward

Compatible

Change

Comments

Yes

+GPSCONF=2,X command DEPRECATED

 

Yes

+GPSAID new command for Aiding mode management

 

Yes

+GPSPVT sentence updated. Longitude format for Degrees displayed on 3 digits

 

5. Corrections & Improvements.

The following issues have been fixed in this release compared to 1.1.1.201104130840 release:

Id

Issue Description

Impacted Domain

60273

Raw data is not compatible with CMUX protocol use.

GPS AT cmd.

60442

The GPS_ABORT_EVENT events are never indicated and GPS_START_ERROR_EVENT event is not sent in case of failure after a first successful GPS start.

GPS AT cmd.

Location Lib.

60107

In I2C configuration, Location Plug-In is not compatible with AirPrime module W32K sleep mode.

GPS AT cmd.

Location Lib.

6. Memory requirements.

The GPS_AT_cmd application binary size is 820kB for RVDS compiler use.

The Plug-In memory footprint depends on the tool chain used:

Tool chain

 

Location Plug-In library

Location Plug-In with AT Application

GCC_EABI

ROM

692 kBytes

714 kBytes

RAM total (with EE)

369 kBytes

381 kBytes

RAM total (no EE)

260 kBytes

272 kBytes

Static RAM

238 kBytes

239 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

86 kBytes

86 kBytes

NV Memory (with EE)

106 kBytes

106 kBytes

NV Memory (no EE)

20 kBytes

20 kBytes

RVDS

ROM

692 kBytes

713 kBytes

RAM total (with EE)

369 kBytes

381 kBytes

RAM total (no EE)

260 kBytes

272 kBytes

Static RAM

238 kBytes

239 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

86 kBytes

86 kBytes

NV Memory (with EE)

106 kBytes

106 kBytes

NV Memory (no EE)

20 kBytes

20 kBytes

IMPORTANT: Due to memory constraints,

  • Applications based on Location Plug-In are not compatible with
    • Q2686H/Q2687H. Q2686G/Q2687G must be used instead.
    • WMP1x0 with 32/8Mb memory combo. 32/16Mb, 64/16Mb, or larger must be used.
  • Applications based on Location Plug-In 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

Tags

AirPrimeOpen AT
©2025 All rights reserved
×
Subscribe Subscribed
You have been successfully unsubscribed to this product. To access your subscription click here.