Telit Wireless Solutions Jupiter SL869 User manual

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 2 of 25
Mod. 0806 2011-07 Rev.2
APPLICABILITY TABLE
PRODUCT
SL869
SW Version
3.1.12.3

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 3 of 25
Mod. 0806 2011-07 Rev.2
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.

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 4 of 25
Mod. 0806 2011-07 Rev.2
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. 2013.

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 5 of 25
Mod. 0806 2011-07 Rev.2
Contents
1.Introduction .............................................................................................................7
1.1.Scope............................................................................................................................ 7
1.2.Audience....................................................................................................................... 7
1.3.Contact Information, Support ...................................................................................... 7
1.4.Document Organization ............................................................................................... 8
1.5.Text Conventions.......................................................................................................... 8
1.6.Related Documents ..................................................................................................... 8
2.Communication Interface.........................................................................................9
2.1.UART ............................................................................................................................ 9
2.2.NMEA Characteristics.................................................................................................. 9
2.3.Commands ................................................................................................................. 10
2.4.Messages ................................................................................................................... 10
3.Commands Description..........................................................................................11
3.1.$PSTMINITGPS .......................................................................................................... 12
3.2.$PSTMINITTIME......................................................................................................... 13
3.3.$PSTMCLREPHS........................................................................................................ 14
3.4.$PSTMDUMPEPHEMS ............................................................................................... 14
3.5.$PSTMEPHEM............................................................................................................ 15
3.6.$PSTMNMEAONOFF.................................................................................................. 16
3.7.$PSTMCOLD............................................................................................................... 16
3.8.$PSTMWARM ............................................................................................................. 17
3.9.$PSTMHOT................................................................................................................. 17
3.10.$PSTMSRR ............................................................................................................. 17
3.11.$PSTMGPSRESET................................................................................................... 18
3.12.$PSTMGETSWVER.................................................................................................. 18
3.13.$PSTMSBASONOFF................................................................................................ 19
3.14.$PSTMSBASSAT..................................................................................................... 19
4.Messages Description............................................................................................20

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 6 of 25
Mod. 0806 2011-07 Rev.2
4.1.GPGGA........................................................................................................................ 21
4.2.GNGSA........................................................................................................................ 22
4.3.--GSV .......................................................................................................................... 23
4.4.GPRMC ....................................................................................................................... 24
5.Document History ..................................................................................................25

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 7 of 25
Mod. 0806 2011-07 Rev.2
1. Introduction
1.1. Scope
This document describes the serial communications interface between the SL869
GPS/GLONASS receiver module firmware and Host Processor software.
1.2. Audience
This document is intended for public distribution to potential customers who are evaluating
the SL869 GPS/GLONASS module. It can also be used by customers who are developing
application software for the Host Processor in a device that incorporates the SL869.
1.3. Contact Information, Support
For general contact, technical support, to report documentation errors and to order manuals,
contact Telit 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
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.

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 8 of 25
Mod. 0806 2011-07 Rev.2
1.4. Document Organization
This document contains the following chapters (sample):
“Chapter 1: “Introduction” provides a scope for this document, target audience, contact and
support information, and text conventions.
“Chapter 2: “Communication Interface” gives an overview of the serial communications
interface and describes general characteristics of input commands and output messages.
“Chapter 3: “Commands Description” describes in detail each of the input commands for the
SL869.
“Chapter 4: “Messages Description” describes in detail each of the output messages produced
by the SL869.
“Chapter 5: “Document History” provides of the changes made to this User Guide.
1.5. 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.
1.6. Related Documents
SL869 Product Description, 80405ST10105a

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 9 of 25
Mod. 0806 2011-07 Rev.2
2. Communication Interface
The serial communication interface between the SL869 receiver module and the Host
processor is based on the NMEA-0183 protocol standard specified by the National Marine
Electronics Association (NMEA). This is an ASCII-based standard that is widely used in the
GPS industry for serial communication with GPS receivers.
2.1. UART
Serial communication with the SL869 is conducted over the UART port, which is assigned to
Pins 20 (Tx) and 21 (Rx). There is no hardware flow control. The default port settings are:
9600 Baud
Eight data bits
No parity bits
One stop bit
Note that manual user interaction with the SL869 can be achieved using a PC terminal
emulator.
2.2. NMEA Characteristics
This subsection highlights characteristics of the NMEA-0183 protocol as they pertain to the
SL869 interface.
Start And Termination
An NMEA data packet is transmitted as an ASCII string beginning with a “$” character, but it
is terminated with <carriage return> <line feed> character sequence. The hexadecimal
representation of this sequence is 0x0D 0x0A.
Proprietary Packets
Proprietary data packets are allowed by the NMEA protocol standard. They begin with “$P”
followed by a Manufacturer’s Mnemonic Code that is assigned by the NMEA. The SL869
module is based on the STA8088 device from ST Microelectronics, who has been assigned
the code “STM.” Therefore, proprietary packets used by the SL869 begin with the character
sequence “$PSTM.”
Checksums
The NMEA standard specifies a two-character checksum field that follows a ‘*” delimiting
character placed at the end of the ASCII data string. The checksum is calculated as the 8-bit
exclusive-OR (XOR) of all characters in the string, excluding the “$” and “*’ delimiters.
The SL869 includes checksums on all output NMEA messages. With one exception,
checksums are not required on input messages and if present are ignored by the SL869.

SL869 SW User Guide
1VV0301002 Rev.6 – 2013-10-1
Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 10 of 25
Mod. 0806 2011-07 Rev.2
Packet Length
The NMEA standard specifies a maximum number of characters for each data packet, but the
SL869 does not strictly adhere to this limit.
2.3. Commands
Commands are sent from the Host Processor to the SL869 and have the basic structure
illustrated below:
command-ID[,parameter1,parameter2,…,parameterN]<cr><lf>
Parameters, if present, are delimited by “,” characters as per the NMEA protocol. All SL869
commands are proprietary and therefore all command-ID’s begin with the “$PSTM” character
sequence.
In most cases, the SL869 will echo the command back out to the Host Processor after the
command has been executed. Commands that are not echoed are indicated in the detailed
commands descriptions later in this Guide.
NOTE:
An easy way to send commands to the SL869 manually is to write the command to a text
file and use the “send text file” function of the terminal emulator. When doing so, make
sure that the <cr><lf> characters are transmitted at the end of the command.
2.4. Messages
Messages are sent from the SL869 to the Host Processor and have the basic structure
illustrated below:
message-ID,<data1,data2,…,dataN>*<checksum><cr><lf>
Individual data fields are delimited by “,” characters. The checksum is provided for purposes
of bit error detection by the Host if desired.
The SL869 outputs certain standard messages as defined in version 3.01 of the NMEA-0183
protocol standard. The message-ID for standard messages begins with an NMEA talker ID:
“$GP” indicating GPS, “$GL” indicating GLONASS, and “$GN” indicating global
navigation. Specific talker IDs used for each message are described later in this Guide in the
Messages section.
The SL869 also outputs proprietary messages. As with commands, proprietary message-IDs
begin with “$PSTM.” Note that some proprietary messages are responses to input commands.