ss5e common software description...sirfstar-v osp-icd updates (cs-337488-sp-3), qualcomm...

SS5e Common Software Description 80424DSW10086A - rev 5 - 2017-12-13

SS5e Common Software Description

80424DSW10086A - rev 5 - 2017-12-13

Reproduction forbidden without Telit Communications S.p.A. written authorization - All Rights reserved page 2 of 18 Mod. 0811 2014-10 Rev.2

APPLICABLE PRODUCTS

PRODUCT P/N

SE868-V3 SE868V3A577

SE868V3B577

SE868V3B001

SE873 SE873GNS577

SE873GNS578

SE873GNS001

SE873Q5 SE873Q5F577

SE873Q5F001

SL876Q5-A SL876Q5A001


80424DSW10086A - rev 5 - 2017-12-13


SPECIFICATIONS SUBJECT TO CHANGE WITHOUT NOTICE

Notice

While reasonable efforts have been made to assure the accuracy of this document, Telit assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. The information in this document has been carefully checked and is believed to be entirely reliable. However, no responsibility is assumed for inaccuracies or omissions. Telit reserves the right to make changes to any products described herein and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes. Telit does not assume any liability arising out of the application or use of any product, software, or circuit described herein; neither does it convey license under its patent rights or the rights of others.

It is possible that this publication may contain references to, or information about Telit products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that Telit intends to announce such Telit products, programming, or services in your country.

Copyrights

This instruction manual and the Telit products described in this instruction manual may be, include or describe copyrighted Telit material, such as computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and its licensors certain exclusive rights for copyrighted material, including the exclusive right to copy, reproduce in any form, distribute and make derivative works of the copyrighted material. Accordingly, any copyrighted material of Telit and its licensors contained herein or in the Telit products described in this instruction manual may not be copied, reproduced, distributed, merged or modified in any manner without the express written permission of Telit. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit, as arises by operation of law in the sale of a product.

Computer Software Copyrights

The Telit and 3rd Party supplied Software (SW) products described in this instruction manual may include copyrighted Telit and other 3rd Party supplied computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and other 3rd Party supplied SW certain exclusive rights for copyrighted computer programs, including the exclusive right to copy or reproduce in any form the copyrighted computer program. Accordingly, any copyrighted Telit or other 3rd Party supplied SW computer programs contained in the Telit products described in this instruction manual may not be copied (reverse engineered) or reproduced in any manner without the express written permission of Telit or the 3rd Party SW supplier. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit or other 3rd Party supplied SW, except for the normal non-exclusive, royalty free license to use that arises by operation of law in the sale of a product.


80424DSW10086A - rev 5 - 2017-12-13


Usage and Disclosure Restrictions

License Agreements

The software described in this document is the property of Telit and its licensors. It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement.

Copyrighted Materials

Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, without prior written permission of Telit

High Risk Materials

Components, units, or third-party products used in the product described herein are NOT fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control equipment in the following hazardous environments requiring fail-safe controls: the operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High Risk Activities.

Trademarks

TELIT and the Stylized T Logo are registered in Trademark Office. All other product or service names are the property of their respective owners. Copyright © Telit Communications S.p.A. 2015, 2016, 2017.


80424DSW10086A - rev 5 - 2017-12-13


Contents 1. INTRODUCTION ..............................................................................................................................................6

1.1. CONTACT INFORMATION, SUPPORT ..............................................................................................................6 1.2. TEXT CONVENTIONS ....................................................................................................................................6 1.3. RELATED DOCUMENTS ................................................................................................................................7

2. SUMMARY DESCRIPTION ..............................................................................................................................8

2.1. CONFIGURATION DETAILS ............................................................................................................................8 2.2. VARIANT CONFIGURATIONS .........................................................................................................................9 2.3. VERSION STRINGS ......................................................................................................................................9 2.4. NOTES ON 5.7.7-P1 ................................................................................................................................. 10

3. CHANGE DESCRIPTIONS ........................................................................................................................... 11

3.1. DELTA SOFTWARE FROM VERSION 5.7.7 TO 5.7.8 ..................................................................................... 11 3.1.1. New Features................................................................................................................................. 11 3.1.2. NMEA Messages ........................................................................................................................... 11 3.1.3. OSP Messages .............................................................................................................................. 11 3.1.4. Improvements ................................................................................................................................ 12 3.1.5. Corrections ..................................................................................................................................... 12 3.1.6. New Variant Configurations ........................................................................................................... 13 3.1.7. Version Strings............................................................................................................................... 13 3.1.8. Notes .............................................................................................................................................. 14

3.2. DELTA SOFTWARE FROM VERSION 5.7.8 TO 5.7.10 ................................................................................... 14 3.2.1. New Features................................................................................................................................. 14 3.2.2. Improvements ................................................................................................................................ 15 3.2.3. Enhancements ............................................................................................................................... 15 3.2.4. Corrections ..................................................................................................................................... 15 3.2.5. New Variant Configurations ........................................................................................................... 16 3.2.6. Version Strings............................................................................................................................... 16

4. NOTES ........................................................................................................................................................... 17

5. DOCUMENT HISTORY ................................................................................................................................. 18


80424DSW10086A - rev 5 - 2017-12-13


1. Introduction

This document describes common firmware that can be used in any Jupiter GNSS receiver module based on the CSR GSD5e B02 device. The information presented in this document is believed to be accurate and reliable. However, no responsibility is assumed by Telit Communications S.p.A. for its use, nor any infringement of patents or other rights of third parties which may result from its use. No license is granted by implication or otherwise under any patent rights of Telit Communications S.p.A. other than for circuitry embodied in Telit products. This document is subject to change without notice.

1.1. Contact Information, Support For general contact, technical support, to report documentation errors and to order manuals, contact Telit’s Technical Support Center (TTSC) at: [email protected] [email protected] [email protected] [email protected] Alternatively, use: http://www.telit.com/en/products/technical-support-center/contact.php For detailed information about where you can buy the Telit modules or for recommendations on accessories and components visit: http://www.telit.com

To register for product news and announcements or for product questions contact Telit's Technical Support Center (TTSC). Our aim is to make this guide as helpful as possible. Keep us informed of your comments and suggestions for improvements. Telit appreciates feedback from the users of our information.

1.2. Text Conventions Danger – This information MUST be followed or catastrophic equipment failure or bodily injury may occur. Caution or Warning – Alerts the user to important points about integrating the module, if these points are not followed, the module and end user equipment may fail or malfunction. Tip or Information – Provides advice and suggestions that may be useful when integrating the module.

All dates are in ISO 8601 format, i.e. YYYY-MM-DD.

mailto:[email protected]:[email protected]:[email protected]:[email protected]://www.telit.com/en/products/technical-support-center/contact.phphttp://www.telit.com/


80424DSW10086A - rev 5 - 2017-12-13


1.3. Related Documents The following is a list of applicable documents that are either downloadable from the Download Zone section of Telit’s website http://www.telit.com or can be obtained by contacting Telit’s Technical Support Center.

1. SE868-V3 Product User Guide, 1VV0301205

2. SE873 Product User Guide, 1VV0301216

3. NMEA Reference Guide, CS-129435-MA, Issue 9 or higher, Cambridge Silicon Radio

4. SiRFstar OSP Interface Control Document, CS-129291-DC, Issue 15, Cambridge Silicon Radio

5. SiRFstar-V OSP Supplement Specification, CS-303979-SP, Qualcomm Technologies International

6. SiRFstar-V OSP-ICD Updates (CS-337488-SP-3), Qualcomm Technologies International

http://www.telit.com/


80424DSW10086A - rev 5 - 2017-12-13


2. Summary Description

This section provides an overall description of common firmware that can be used in any Jupiter GNSS receiver module based on the CSR GSD5e B02 device. The initial version of common firmware is based on the 5.7.7-P1 production release from CSR.

2.1. Configuration Details A list of characteristics and default settings common to all variants of 5.7.7-P1 firmware is provided below.

GPS and GLONASS constellations are enabled and used for navigation. QZSS satellite ranging is also enabled by default.

Time Mark pulse (1PPS) is output on GPIO5.

The GNSS_ON signal is output on GPIO8.

The serial port default protocol is NMEA at a rate of 9600bps. The supported NMEA version is 3.01. GGA, GSA, GSV, and RMC messages are output once per second, all other messages are disabled by default.

One Socket Protocol (OSP) serial data protocol is also supported.

Static navigation (position pinning) is disabled by default.

The groundtrack smoothing filter is disabled by default.

Velocity propagation (dead reckoning) is disabled by default.

Automatic altitude hold (2D navigation) is enabled.

Three-satellite (2D) acquisitions are enabled.

The default elevation mask angle for using satellite measurements is five degrees.

Maximum altitude is 24km.

The use of Satellite-Based Augmentation System (SBAS) satellite ranging for navigation, and SBAS satellite corrections for differential operation, is supported. However, SBAS usage is disabled by default.

Differential operation using RTCM corrections is not supported.


80424DSW10086A - rev 5 - 2017-12-13


SiRFInstantFixTM Client-Generated Extended Ephemeris (CGEE) is generated for three days of GPS EE data and one day of GLONASS EE data.

SiRFInstantFix Server-Generated Extended Ephemeris (SGEE) is supported for up to 14-day GPS EE files and 14-day GLONASS EE files.

Continuous-wave and narrow-band interference detection and mitigation is performed for GPS and GLONASS frequency bands.

The device wake-up feature is enabled. The module wakes up from a commanded Hibernate state if the ON_OFF input signal remains high and there is data traffic on the Host serial port.

2.2. Variant Configurations Additional default settings that are unique to each of the available 5.7.7-P1 firmware variants are listed below.

Start-up power mode is Full Power, internal LNA set to fixed Low gain mode. Start-up power mode is SmartGNSS-I, internal LNA set to fixed Low gain mode. Start-up power mode is Full Power, internal LNA set to fixed High gain mode. Start-up power mode is SmartGNSS-I, internal LNA set to High gain mode.

2.3. Version Strings The version string for each variant of the 5.7.7-P1 firmware release is of the form: 5xp__5.7.7-P1.GCC_ N96[S1]+5xpt_5.7.7-P1.KCC If S1 is present, the start-up power mode is SmartGNSS-I instead of full power. If LG is present the internal LNA is set to fixed Low gain; otherwise if HG is present it is fixed High gain. As an example, the version string for the SmartGNSS-I, low internal gain variant is 5xp__5.7.7-P1.GCC_ N96S1LG+5xpt_5.7.7-P1.KCC

When polled for the firmware version in NMEA mode, the module returns two version strings in the $PSRF195 message. An example for the SmartGNSS-I, Low internal gain variant is shown below: $PSRF195,5xp__5.7.7-P1.GCC+5xpt_5.7.7-P1.KCC*0A $PSRF195,N96S1LG*2E


80424DSW10086A - rev 5 - 2017-12-13


2.4. Notes on 5.7.7-P1

Although the GNSS_ON output signal (GPIO 8) is supported, under some circumstances it will be set high when the receiver module is in the Hibernate state or when it is in a low power state during Trickle Power operation. These are states in which GNSS_ON is normally set low. If this signal is used to enable an external LNA, the RF front end will draw higher current if this behavior occurs.

The NMEA datum control input message ($PSRF106) is not supported.

Differential GNSS operation for GLONASS from SBAS is not supported.


80424DSW10086A - rev 5 - 2017-12-13


3. Change Descriptions

This section details the changes made in subsequent versions of common firmware released by Telit for modules based on the GSD5e B02 device.

3.1. Delta Software from Version 5.7.7 to 5.7.8 Version 5.7.8 is a production firmware release based on Qualcomm firmware version 5.7.8-P1, and it supersedes firmware version 5.7.7. Changes from 5.7.7 to 5.7.8 are listed in the subsections below.

3.1.1. New Features

Dual UART serial operation is supported. Ports can be configured as one OSP and one NMEA, or as both NMEA. However, protocol switching while maintaining dual port operation is not supported. Contact a Telit Sales Representative regarding requests for firmware variants configured for dual-UART operation.

Support was added for 10Hz navigation updates.

3.1.2. NMEA Messages

A new command for datum control ($PSRF106) was added. See Reference 3 for command details.

3.1.3. OSP Messages

A new command, MID 169, for datum control was added. Name Bytes Example Description MID 1 U A9 Message ID Datum 1 U B2 Datum identification code Flag 1 U 01 Enable DTM sentence when switching to

NMEA protocol Reserved 1 U 00 The example data selects Tokyo Mean local datum and enables the DTM sentence output if switching to NMEA protocol. The permitted datum identification codes are the same as that for the NMEA $PSRF106 command (see previous section).


80424DSW10086A - rev 5 - 2017-12-13


3.1.4. Improvements

Default UTC offset has been updated to 17 seconds.

Improvement has been made in the time to obtain GLONASS ephemeris data from weak signals in certain scenarios, sometimes resulting in improvement in TTFF in those cases.

Reported C/No values have been improved when SmartGNSS mode is enabled. The C/No spikes that were seen during transitions between Full Power and SmartGNSS operating modes have been reduced.

Positioning performance in urban canyon scenarios has been improved for Full Power mode so that it is comparable to performance when SmartGNSS is enabled.

Trickle Power navigational performance has been improved.

Improvement has been made in multi-path mitigation involving higher elevation satellites.

3.1.5. Corrections

Corrected the behavior of the GNSS_ON signal (GPIO8) where it would sometimes remain high even though the module was in a low power state (see section 2.4).

Corrected an issue that caused GAGAN satellites not to be tracked.

Corrected an issue whereby DGPS corrections were getting corrupted when multiple SBAS constellations were used.

Corrected an issue that could cause maintenance cycles in Micro Power Mode (MPM) to have extended TTFF and consequently increased power consumption.

Corrected an issue with MPM that caused MEMS Wake-up configuration information to be lost after the module was awakened from the Hibernate state.

Corrected an issue with Push-To-Fix (PTF) low power mode whereby the module occasionally did not output the OKToSend message indicating receiver initialization complete in Full Power mode (MID 18 with indicator value 2).

Corrected an issue that could cause incorrect heading output.

Corrected the malformed NMEA GLGSV message after a cold start when no GLONASS satellites are in the visible list.


80424DSW10086A - rev 5 - 2017-12-13


Corrected the value returned in the NMEA SGEE age response (SPSRF156,22).

Corrected an issue whereby OSP messages MID 54, SID 3 (PowerUp) and MID 54, SID 4 (PowerDown) were not sent out when the module was operating in a low power mode.

Corrected an issue whereby OSP MID 18, SID 1 (OkToSend) was being output twice during a software reset.

Corrected the failure to NACK OSP input messages with invalid checksums or invalid message lengths.

Corrected the absence of an ACK or NACK response to OSP message MID 222, SID 16 (Location Technology Constraints).

3.1.6. New Variant Configurations

For each of the variant configurations described in Paragraph 2.2, the PPS signal starts being output once the module achieves navigation with five SVs, and ceases being output when the module falls out of navigation. With version 5.7.8-P1 firmware, additional variants are available in which the default PPS behavior is changed so that it is output under less restrictive conditions. The PPS will start being output when the module achieves navigation with four SVs, and continues being output upon loss of navigation.

3.1.7. Version Strings

The complete version string returned in OSP MID 6 for each variant of the 5.7.8-P1 firmware release is of the form: 5xp__5.7.8-P1.GCC_5xpt_5.7.8-P1.KCCN96[S1][PPS]+ 5xpt_5.7.8-P1.KCC If S1 is present, the start-up power mode is SmartGNSS-I instead of full power. If LG is present the internal LNA is set to fixed Low gain; otherwise if HG is present it is fixed High gain. As an example, the version string for the SmartGNSS-I, low internal gain variant is 5xp__5.7.8-P1.GCC_ 5xpt_5.7.8-P1.KCCN96S1LG+5xpt_5.7.8-P1.KCC

If PPS is present, the PPS signal is output is under less restrictive conditions. At start-up the PPS will start being output when the module navigates using four SVs rather than five SVs. And upon loss of navigation, the PPS will continue to be output.


80424DSW10086A - rev 5 - 2017-12-13


When polled in NMEA mode, the module returns two version strings in a pair of $PSRF195 messages. The first message is the same for all 5.7.8-P1 firmware variants, while the second message is unique to the variant. An example for the SmartGNSS-I, low internal gain variant is shown below: $PSRF195,5xp__5.7.8-P1.GCC+5xpt_5.7.8-P1.KCC*0A $PSRF195,N96S1LG*2E

3.1.8. Notes on 5.7.8-P1

Differential GNSS operation for GLONASS from SBAS is not supported.

3.2. Delta Software from Version 5.7.8 to 5.7.10 Version 5.7.10 is a production firmware release based on Qualcomm firmware version 5.7.10-P2.1, and it supersedes firmware version 5.7.8. Changes from 5.7.8 to 5.7.10 are listed in the subsections below.

3.2.1. New Features

Incorporation of GLONASS satellite measurements has been added to differential GNSS operation using corrections obtained from SBAS satellites.

Static motion detection using a MEMS accelerometer has been added. This feature is only applicable to modules with a MEMS I2C interface.

Drone platforms using OSP protocol are now supported. Firmware that is configured for use in drone applications will output a new OSP message (MID67, SID2) which is described in Reference 6. Contact a Telit Sales Representative or Technical Support Services regarding requests for firmware variants that are configured for drone platforms. Note – In firmware configured for drone platforms, the navigation filter is tuned for best overall performance at 5Hz.

GLONASS-only and Beidou-only operating modes are supported. These modes can be

commanded in OSP protocol using MID222, SID16 as described in Reference 6. Caution – Although these modes are supported, they have not been optimized, and therefore their performance has not been characterized.


80424DSW10086A - rev 5 - 2017-12-13


3.2.2. Improvements

Average power consumption in SmartGNSS-II continuous low power mode has been improved through more efficient maintenance of satellite data obtained from GNSS satellites.

Tunnel Detection logic has been improved in order to lessen the impact of tunnels on Trickle Power and SmartGNSS low power modes.

Weak signal data collection for GLONASS satellites has been added, reducing the C/No threshold for downloading ephemeris from 27 dB-Hz to 23 dB-Hz.

Position accuracy while operating in Trickle Power mode has been improved.

3.2.3. Enhancements

The command to switch from OSP to NMEA (OSP MID 129) has been updated to support NMEA bit rates that are higher than 57600 bps. For higher rates, the baud field value represents the lower 16 bits of the desired baud:

o 49664 (0xC200): 115200 bps o 33792 (0x8400): 230400 bps o 2048 (0x0800): 460800 bps o 4096 (0x1000): 921600 bps o 49152 (0xC000): 1228800 bps

Support for navigation using the new Type K1 GLONASS SVs has been added.

Dual UART serial operation has been enhance to allow protocol switching under certain

conditions when both ports are active. Protocol can be switched between OSP and NMEA one port, provided that the other port is NMEA.

Search and acquisition of Beidou satellites has been expanded from 14 PRNs to all 37 PRNs specified by the Beidou Interface Control Document.

3.2.4. Corrections

An issue has been corrected that caused the speed over ground to be incorrectly reported in the NMEA VTG message as 0.0 when the module is operating at the 10Hz navigation update rate.

Two issues related to Trickle Power have been resolved: o The receiver failed to switch to Full Power when the ON_OFF signal was

toggled during Trickle Power.


80424DSW10086A - rev 5 - 2017-12-13


o When commanded to one-second updates and high power reduction using MID 218, SID 8, the receiver intermittently dropped an update and momentarily failed to meet the one-second rate.

A problem that could cause the MEMS wakeup feature in SiRFaware to fail has been corrected. When the EIT signal was asserted due to motion, the signal would not wake up the module when the problem occurred.

3.2.5. New Variant Configurations

With version 5.7.10-P2.1 firmware, additional variants are available in which the default power mode can be set to SmartGNSS-II.

3.2.6. Version Strings

The complete version string returned in OSP MID 6 for each variant of the 5.7.10 firmware release is of the form: 5xp__5.7.10-P2.1.GCC_[S1|S2][PPS][HD]+ 5xpt_5.7.10-P2.1.KCC

When N96 is present the serial port defaults to NMEA protocol at 9600 baud; otherwise when B115 is present the serial port defaults to OSP (binary) protocol at 115200 baud.

If S1 is present, the start-up power mode is SmartGNSS-I instead of full power. Similarly, if S2 is present, the start-up power mode is SmartGNSS-II instead of full power.

When LG is present the internal LNA is set to fixed Low gain; otherwise when HG is present it is set to fixed High gain.

If PPS is present, the PPS signal is output is under less restrictive conditions. At start-up the PPS will start being output when the module navigates using four SVs rather than five SVs. And upon loss of navigation, the PPS will continue to be output.

If HD (High Dynamics) is present, the firmware is configured for use in Drone applications.

As an example, the MID 6 version string for the SmartGNSS-I, low internal gain variant that defaults to NMEA at 9600 baud is 5xp__5.7.10-P2.1.GCC_N96S1LG+5xpt_5.7.10-P2.1.KCC When polled in NMEA mode, the module returns two version strings in a pair of $PSRF195 messages. The first message is the same for all 5.7.10-P2.1 firmware variants, while the second message is unique to the variant. The output for the example above is: $PSRF195,5xp__5.7.10-P2.1.GCC+5xpt_5.7.10-P2.1.KCC*0A $PSRF195,N96S1LG*2E


80424DSW10086A - rev 5 - 2017-12-13


4. Notes

EGNOS and GAGAN SBAS range measurements are not supported.

SBAS ranging and differential operation require SBAS signals to have C/No values of at least 37dB-Hz when the module is in Full Power mode. When the module is in SmartGNSS-I power mode, SBAS signals must be even stronger in order for SBAS to be operational.


80424DSW10086A - rev 5 - 2017-12-13


5. Document History

RReevviissiioonn DDaattee CChhaannggeess

0 2015-09-14 First Issue 1 2015-10-28 Added Notes section with details about GPIO8 support in 5.7.7-P1. 2 2016-04-15 Added new sections for 5.7.8-P1 3 2017-01-17 Added new sections for 5.7.10-P2. Corrected firmware version references

in section 3.1. 4 2017-06-01 Corrected default QZSS configuration. Updated Applicability Table. 5 2017-12-13 Corrected another version reference in section 3.1. Updated Applicability

Table.

1. Introduction1.1. Contact Information, Support1.2. Text Conventions1.3. Related Documents

2. Summary Description2.1. Configuration Details2.2. Variant Configurations2.3. Version Strings2.4. Notes on 5.7.7-P1

3. Change Descriptions3.1. Delta Software from Version 5.7.7 to 5.7.83.1.1. New Features3.1.2. NMEA Messages3.1.3. OSP Messages3.1.4. Improvements3.1.5. Corrections3.1.6. New Variant Configurations3.1.7. Version Strings3.1.8. Notes on 5.7.8-P1

3.2. Delta Software from Version 5.7.8 to 5.7.103.2.1. New Features3.2.2. Improvements3.2.3. Enhancements3.2.4. Corrections3.2.5. New Variant Configurations3.2.6. Version Strings

4. Notes5. Document History