Siemens XT55 AVL User Manual

XT55 AVL
Siemens Cellular Engine
Version: 03 DocID: XT55_avl_ug_V03
User’s Guide
Confidential/Released
s
mo b i l e
Document Name:
Version:
Date:
DocId:
Status:
General note
Product is deemed accepted by Recipient and is provided without interface to Recipient´s products. The Product constitutes pre-release version and code and may be changed substantially before commercial release. The Product is provided on an “as is” basis only and may contain deficiencies or inadequacies. The Product is provided without warranty of any kind, express or implied. To the maximum extent permitted by applicable law, Siemens further disclaims all warranties, including without limitation any implied warranties of merchantability, fitness for a particular purpose and noninfringement of third-party rights. The entire risk arising out of the use or performance of the Product and documentation remains with Recipient. This Product is not intended for use in life support appliances, devices or systems where a malfunction of the product can reasonably be expected to result in personal injury. Applications incorporating the described product must be designed to be in accordance with the technical specifications provided in these guidelines. Failure to comply with any of the required procedures can result in malfunctions or serious discrepancies in results. Furthermore, all safety instructions regarding the use of mobile technical systems, including GSM products, which also apply to cellular phones must be followed. Siemens AG customers using or selling this product for use in any applications do so at their own risk and agree to fully indemnify Siemens for any damages resulting from illegal use or resale. To the maximum extent permitted by applicable law, in no event shall Siemens or its suppliers be liable for any consequential, incidental, direct, indirect, punitive or other damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information or data, or other pecuniary loss) arising out the use of or inability to use the Product, even if Siemens has been advised of the possibility of such damages. Subject to change without notice at any time.
Third party products
Siemens disclaims all warranties concerning the software or their freedom from the rights of third parties. CUSTOMER shall indemnify and hold harmless Siemens from and against any claims or demands for damages asserted on account of the use of the applications developed by CUSTOMER or third parties using the software, unless CUSTOMER is able to prove that such third party damages or claims are not based on the software or the developed applications
Copyright
Transmittal, reproduction, dissemination and/or editing of this document as well as utilization of its contents and communication thereof to others without express authorization are prohibited. Offenders will be held liable for payment of damages. All rights created by patent grant or registration of a utility model or design patent are reserved.
Copyright © Siemens AG 2004
Trademark notices
MS Windows® is a registered trademark of Microsoft Corporation. SiRFDemo, SiRFflash and SiRFstar software are registered trademarks of SiRF Technology Inc. Section 3.2.1 and 4.1 used with the permission of SiRF Technology, Inc., San Jose, California
XT55 AVL User’s Guide
03
June 28, 2004
XT55_avl_ug_V03
Confidential/Released
XT55_avl_ug_V03 Page 2 of 37 28.06.2004
Confidential/Released
s
mo b i l e
Contents
0 Version history..............................................................................................................5
1 Overview of the document ...........................................................................................6
1.1 Hardware configuration..........................................................................................7
1.2 Related documents................................................................................................8
2 How to configure and evaluate the XT55 module ......................................................9
2.1 Terminal emulator setup ........................................................................................9
3 Tracking .......................................................................................................................14
3.1 History function ....................................................................................................14
3.1.1 Configuration examples .........................................................................16
3.2 XT55 AVL software main features at a glance ....................................................17
3.2.1 Extended NMEA commands..................................................................18
3.2.1.1 Command Syntax ..................................................................................18
3.2.1.2 Extended NMEA command description .................................................19
4 Software interface.......................................................................................................34
4.1 NMEA output messages ......................................................................................34
4.2 How to switch the XT55 AVL in the command mode and vice versa...................34
4.3 Digital Inputs ........................................................................................................35
5 Example application ...................................................................................................36
XT55_avl_ug_V03 Page 3 of 37 28.06.2004
Confidential/Released
s
mo b i l e
Figures
Figure 1: Simplified presentation of the AVL client-server architecture.................................... 7
Figure 2: Block diagram of XT55 with AVL application ............................................................7
Figure 3: Assign the name for a new session ........................................................................10
Figure 4: COM Port transmission settings.............................................................................. 10
Figure 5: Displaying of the transmitted NMEA protocols........................................................11
Figure 6: Settings of connection properties............................................................................11
Figure 7: ASCII setup .............................................................................................................12
Figure 8: Example of an extended NMEA command ............................................................. 12
Figure 9: Import saved text file ...............................................................................................13
Figure 10: Select text file with included command(s) ............................................................. 13
Figure 11: History filter ...........................................................................................................15
Figure 12: Connection example for GPIO 15 and GPIO 3 ..................................................... 35
Figure 13: Example application of XT55 module with integrated AVL software.....................36

Tables

Table 1: Conditions for saving data in the GPS history..........................................................16
Table 2: Programming example ............................................................................................. 16
Table 3: Average supply current without antenna .................................................................. 37
XT55_avl_ug_V03 Page 4 of 37 28.06.2004
Confidential/Released
s
0 Version history
Preceding document: "XT55 AVL Software User’s Guide" Version 02 New document: "XT55 AVL Software User’s Guide " Version 03
Chapter What is new
2nd front page Added trademark notice regarding SiRF software
5 Revised Figure 13, improved description of example application
Preceding document: "XT55 AVL Software User’s Guide" Version 01 New document: "XT55 AVL Software User’s Guide " Version 02
Chapter What is new
2nd front page New version of General Notes
3.1 Revised Figure 11: History filter
mo b i l e
3.1.1 New chapter giving examples how to set filters for GPS history data
3.2.1.1 Added footnote 4 regarding the termination of messages and further information about carriage return and line feed
3.2 New chapter explaining the advantages of the implemented XT55 AVL software
3.2.1.2
5
Added new commands:
PARF112,1
PARF112,2
PARF112,4
PARF112,5
PSRF112,31
PSRF112,32
PSRF103
PRSF109
Added new chapter: Example application
XT55_avl_ug_V03 Page 5 of 37 28.06.2004
Confidential/Released
s
mo b i l e
1 Overview of the document
The XT55 module, supporting GSM, GPRS and GPS features, contains the Automatic Vehicle Location software application (AVL) which can be configured. The Global Positioning System (GPS) is a satellite-based navigation system made up of a network of 24 satellites placed into orbit. GPS satellites receive data to determine the current position of the tracked vehicle. The concept of the device is based on a simple implementation for a wide range of applications with low costs and high flexibility. In particular it offers a fast development of system solutions within the fields of:
Tracking
The vehicle to be tracked is fitted with the module XT55 including a GPS and a GSM antenna. GPS satellites are continuously transmitting a radio message containing information, including when the data was sent, which satellite sent it and the current reliability of the system. The XT55, containing the AVL software, fitted in a vehicle receives this information from at least 4 satellites and carries out the necessary calculations to determine its current position.
AVL
The GPS receiver embedded into the XT55 module determines its current location, speed and heading. These data can either be stored or directly transmitted to an operating center. The terminal reports its position to the call center over GSM communications network. The current position can be displayed on a PC/PDA in digital maps which must be obtained separately.
Depending on the configuration, the device exchanges data with a server application (e.g. mapping software, etc.). The module XT55 can be configured by the user via local RS-232 interface or via remote GSM (air link).
At the core of the system solutions mentioned above is a classical set-up with client-server architecture. In this scenario, the module XT55 represents the so called mobile client (see Figure 1).
The integration of the module XT55 requires a clear definition:
- The characteristics of the integrated AVL software solution of the module XT55 as a
client of the user solution, and the possibilities for configuration.
- The instruction command for communicating with the client as the main part of the
server application
This document intends to describe the module XT55 AVL firmware and how it can be configured, including the description, which is based on the Windows HyperTerminal configuration (terminal emulator program). For the flashing process of the AVL software into the module please contact Siemens AG for further information.
Furthermore, this document gives a detailed description of the instruction command, providing information for setting up customized server applications for communicating with the mobile client (XT55).
XT55_avl_ug_V03 Page 6 of 37 28.06.2004
Confidential/Released
s
mo b i l e
Application example:
Figure 1: Simplified presentation of the AVL client-server architecture.
The connected GSM modem enables the communication to the XT55 (server side).
1.1 Hardware configuration
Please use the following hardware configuration to ensure the proper operation of the AVL application (see Figure 2).
Figure 2: Block diagram of XT55 with AVL application
XT55_avl_ug_V03 Page 7 of 37 28.06.2004
Confidential/Released
s
mo b i l e
1.2 Related documents
[1] XT55 AT Command Set [2] XT55 Hardware Interface Description [3] XT55 GPS Startup Users Guide [4] XT55 GPS Command Specification [5] XT55 TCP/IP Software User’s Guide [6] GPRS Startup User's Guide [7] Remote-SAT User's Guide [8] GSM / GPS Evaluation Board Description [9] Application Note 16: Upgrading XT55 Firmware [10] Application Note 14: Audio and Battery Parameter Download [11] Application Note 02: Audio Interface Design [12] Application Note 24: Application Developer’s Guide [13] Multiplexer User's Guide [14] Multiplex Driver Developer’s Guide for Windows 2000 and Windows XP [15] Multiplex Driver Installation Guide for Windows 2000 and Windows XP
Prior to using the XT55 engines or upgrading to a new firmware release, be sure to carefully read the latest product information.
To visit the Siemens Website you can use the following link:
http://www.siemens.com/wm
XT55_avl_ug_V03 Page 8 of 37 28.06.2004
Confidential/Released
s
mo b i l e
2 How to configure and evaluate the XT55 module
The XT55 device can be easily configured and evaluated by the customer using the local RS-232 interface (directly connected to the serial port) or via remote (e.g. installed in a vehicle) GSM (air link).
With the Windows HyperTerminal application (utility that is preinstalled on all versions of Windows 98, 98SE, Windows ME, Windows NT, Windows 2000 and Windows XP) it is possible to receive GPS position data and alarm status reports, as well as to execute a range of remote configurations.
In order to connect the XT55 remotely it is absolutely necessary to establish a connection to a suitable GSM modem. If the module XT55 is configured remotely, prerequisite is the connection of a suitable GSM modem.
The configuration possibilities mainly cover the following areas:
1. GPS
History function
- Activation of predefined time, distance and speed as a condition for storing position
data in the internal history memory, as well as the option of remotely retrieving the history.
GPS polling (NMEA commands, data calls)
- NMEA command remote request the current status of alarms, start position request.
- Start data calls directly to the GPS position surveillance of a module XT55.
2.1 Terminal emulator setup
The example given below is based on the Windows™ HyperTerminal application (terminal emulator program). It describes how to use the module XT55 with a PC running Windows
2000.
On the first time power-up you can use terminal software, which makes the communication with modem through a RS-232 serial port possible. The following example is using the Hyper Terminal in Windows 2000.
XT55_avl_ug_V03 Page 9 of 37 28.06.2004
Confidential/Released
s
mo b i l e
On Windows 2000, start the Hyper Terminal program. Assign the name for a new session on the displayed window (e.g. XT55-AVL).
Figure 3: Assign the name for a new session
Choose the correct COM Port and baud rate settings (9600bps, 8 bit, no parity bit, 1 stop bit).
Figure 4: COM Port transmission settings
XT55_avl_ug_V03 Page 10 of 37 28.06.2004
Confidential/Released
s
mo b i l e
The connection to the module XT55 is established, the transmitted protocols are already displaying.
Figure 5: Displaying of the transmitted NMEA protocols
Next, click the Property button. Then select the settings tab sheet. Click the ASCI setup... button.
Property button
Figure 6: Settings of connection properties
XT55_avl_ug_V03 Page 11 of 37 28.06.2004
Confidential/Released
s
mo b i l e
On the appeared window thick the check box with caption Send line ends with line feeds.
Figure 7: ASCII setup
Next, open a text file and write the desired command (see Figure 8). Please note that after the command is written, the enter key needs to be pressed in order to complete the NMEA command (<CR><LF>), else the command will be ignored from the XT55 module. To save the active document to its current name and directory just open File menu and click Save item. Then close the current file.
Figure 8: Example of an extended NMEA command
XT55_avl_ug_V03 Page 12 of 37 28.06.2004
Loading...
+ 25 hidden pages