Location Library 1.1 Release note

Apr 12, 2011 - Author: Sierra Wireless - Version 1.1 - 4467 Views
  1. NEW FEATURES. Last Update: April 12, 2011
  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.1 release includes following new features compared to Location Plug-In 1.0 release:

  • XM0110 I2C serial interface support, in addition to UART interface
  • Compatibility to Embedded Module sleep mode (32K mode) when using XM0110 UART serial interface (not available with XM0110 I2C interface)
  • PDOP and VDOP fields support (for both PVT and NMEA)
  • ARM_EABI_GCC and RVDS tool chains support. ARM_ELF_GCC tool chain is no more supported
  • Simple sample application for Location Plug-In for XM0110 GPS
  • GPS AT command application default settings compatible to SL6087 development kit


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.


As a complement to Location Plug-In, Sierra Wireless also distributes:

  • The Extended AT Command Application, that extends AirPrime Firmware AT command set with additional AT commands, including AT commands for AirPrime XM0110 GPS module. This application is available in particular in binary format for download and execution on AirPrime Embedded Module. This application integrates the GPS_AT_cmd sample application. The “Location AT Commands Interface Guide” is the user guide of the GPS AT commands of the Extended AT Command Application.

2. Software Release Description.

2.1 Software Identification.

Software Identification

Location Plug-In Package

1.1.0.201103021409

Version string reported by the Plug-In Library API

GPS-LocLib.1.1.0-Mar 2 2011-14:04:23-SiRFHostIV-4.0.2-B17c1c GSD4t_4.0.2-B17_16x 08/27/2010 300

Version string reported by the +GPSVERS? AT command

GPS-LocLib.1.1.0-Mar 2 2011-14:04:23-SiRFHostIV-4.0.2-B17c1c GSD4t_4.0.2-B17_16x 08/27/2010 300

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.35 or later

IMPORTANT: not compatible to OASiS 2.34 / not compatible to Firmware 7.44

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 1.01 Application binary on top of your Embedded Module Firmware. The .dwl application file is available from OASiS SDK 2.35 (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_INITIALIZED 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

60361

Inconsistent number of sentences indicated in PVT:3 in 6SV case: 2 is indicated, whereas only 1 sentence is present.

GPS AT cmd.

PVT

1.1

60184

60186

The number and indication of Satellites in View Used for Navigation are not consistent in the PVT structure and in the +GPSPVT event. All satellites in view are considered as used for navigation.

GPS AT cmd.

Location Lib.

PVT

1.1

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.

1.1

60107

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

GPS AT cmd.

Location Lib.

I2C

1.1

60273

Raw data is not compatible with CMUX protocol use.

GPS AT cmd.

1.0.1

60552

Inconsistent position with West longitude or South latitude in GPSPVT: 0 sentence

GPSATcmd.

PVT

1.1

60688

gps_corePowerRate_e documented but not implemented in the code

Location Lib.

1.1

59830

I2C bus is not released after gps release.

Location Lib.

GPSATcmd.

1.1

60585

HDOP in frame $GPGGA does not match with HDOP value reported into $GPGSA.

GPSATcmd.

NMEA

1.1

4. Interface modifications.

4.1 Library APIs.

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

Backward

Compatible

Change

Comments

Yes

gps_coreOpt_e GPS_OPT_CORE_WAKEUP enum value added

Yes

gps_coreWakeup_e GPS_WAKEUP_DISABLED and GPS_WAKEUP_ENABLED enum values added

4.2 GPS AT Commands.

The Location AT commands interface modifications since 1.0.1.201011031042 release are:

Backward

Compatible

Change

Comments

Yes

+GPSCONF new supported values for host wakeup mechanism option

Yes

+GPSINIT new supported values for I2C hardware configuration

Yes

+GPSINIT=12 is made obsolete. Must use +GPSINIT=11 instead.

Value still supported in this release, but may be removed in future releases

No

PDOP and VDOP fields support (for both PVT and NMEA frames)

No

New Geoidal separation field on §GPGGA frame

5. Corrections & Improvements.

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

Id

Issue Description

Impacted Domain

58773

Debug UART remains subscribe in Data mode when AT+GPSDEBUG=0,X is entered

GPS AT cmd.

59281

The AT+GPSINIT response is not received immediately through the virtual port (CMUX) used to send the AT command until new AT command is sent in the same virtual port.

GPS AT cmd.

59418

The configuration of the navigation low power mode is not functional in GPS_INITIALIZED and GPS_SLEEP state. This configuration should be applied in the GPS_RUNNING state through the gps_coreSetOpts function or the AT+GPSCONF=0,X command.

GPS AT cmd.

Location Lib.

59369

When start from the state GPS_SLEEP / GPS_HIBERNATE_MODE is failed, any next start will always fail. The Location Plug-In should be stopped in this case before the restart.

GPS AT cmd.

Location Lib.

59317

The AEE feature not activated if a first gps_start was previously done with AEE option disabled. Embedded Module reset is then required.

GPS AT cmd.

Location Lib.

59423

The Satellites in View Signal To Noise Ratio of the PVT service is not consistent when the Very Low/Low/Medium power navigation modes are activated. The field statsInViewSNR of the PVT structure gps_pvtSatInViewInfo_t is not consistent.
The fields 8/11/14/17/20 of the PVT sentence number 3 are not consistent.

GPS AT cmd.

Location Lib.

58578

Location Plug-In is not compatible with AirPrime module W32K sleep mode

GPS AT cmd.

Location Lib.

57781

AT+GPSNMEA=2 generates a WCPU reset due to conflict on UART 2 (used for GPS companion communication).

GPS AT cmd.

59418

The configuration of the navigation low power mode is not functional in GPS_INITIALIZED and GPS_SLEEP state. This configuration should be applied in the GPS_RUNNING state through the gps_coreSetOpts function or the AT+GPSCONF=0,X command.

GPS AT cmd.

Location Lib.

6. Memory requirements.

The GPS_AT_cmd application binary size is 774kB 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

662 kBytes

679 kBytes

RAM total (with AEE)

408 kBytes

419 kBytes

RAM total (no AEE)

315 kBytes

326 kBytes

Static RAM

293 kBytes

293 kBytes

Stack size (no AEE)

22 kBytes

33 kBytes

Extra Stack size for AEE

7 kBytes

7 kBytes

Dynamic RAM (no AEE)

0 kBytes

0 kBytes

Extra dynamic RAM for AEE

86 kBytes

86 kBytes

NV Memory (with AEE)

106 kBytes

106 kBytes

NV Memory (no AEE)

20 kBytes

20 kBytes

RVDS

ROM

661 kBytes

679 kBytes

RAM total (with AEE)

408 kBytes

420 kBytes

RAM total (no AEE)

315 kBytes

327 kBytes

Static RAM

293 kBytes

294 kBytes

Stack size (no AEE)

22 kBytes

33 kBytes

Extra Stack size for AEE

7 kBytes

7 kBytes

Dynamic RAM (no AEE)

0 kBytes

0 kBytes

Extra dynamic RAM for AEE

86 kBytes

86 kBytes

NV Memory (with AEE)

106 kBytes

106 kBytes

NV Memory (no AEE)

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

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