Siemens Cellular Engine Version: DocID: 03 XT55_avl_ug_V03 User’s Guide XT55 AVL
s XT55 AVL User’s Guide Confidential/Released mobile Document Name: XT55 AVL User’s Guide Version: 03 Date: June 28, 2004 DocId: XT55_avl_ug_V03 Status: Confidential/Released 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.
s XT55 AVL User’s Guide Confidential/Released mobile Contents 0 Version history ..............................................................................................................5 1 Overview of the document ...........................................................................................6 1.1 Hardware configuration..........................................................................................7 1.2 Related documents.......................................................
s XT55 AVL User’s Guide Confidential/Released mobile 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..............................................................
s XT55 AVL User’s Guide Confidential/Released mobile 0 Version history Preceding document: "XT55 AVL Software User’s Guide" Version 02 New document: "XT55 AVL Software User’s Guide " Version 03 Chapter nd What is new 2 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 nd What is new 2 front page
s XT55 AVL User’s Guide Confidential/Released mobile 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.
s XT55 AVL User’s Guide Confidential/Released mobile 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.
s XT55 AVL User’s Guide Confidential/Released mobile 1.
s XT55 AVL User’s Guide Confidential/Released mobile 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).
s XT55 AVL User’s Guide Confidential/Released mobile 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.
s XT55 AVL User’s Guide Confidential/Released mobile 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.
s XT55 AVL User’s Guide Confidential/Released mobile 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 (), else the command will be ignored from the XT55 module.
s XT55 AVL User’s Guide Confidential/Released mobile Next, click the Transfer on the HyperTerminal menu and select Send text file... . Figure 9: Import saved text file Select the saved text file “eula.txt” and click the open button. The text file including command(s) is sent directly to the connected module XT55.
s XT55 AVL User’s Guide Confidential/Released mobile 3 Tracking The GPS satellites in orbit are continuously transmitting radio signals. Each satellite transmits a unique code, allowing the GPS receiver to identify its position, time and speed. The main purpose of these received signals is to carry out the necessary calculation to determine the current position of the vehicle. 3.1 History function The embedded GPS receiver continuously calculates the current position data.
s XT55 AVL User’s Guide Confidential/Released mobile History - Filter No Fix Position enable ? Yes No X* SV solution? Yes No >Min Time? Yes No No End >Min Distance? >Max Time? Yes No >Max Distance? No >Max Speed? Yes End Yes End Yes No >Min Speed? Yes *) X >= 3; Store data on Flash memory END Figure 11: History filter XT55_avl_ug_V03 Page 15 of 37 28.06.
s XT55 AVL User’s Guide Confidential/Released mobile 3.1.1 Configuration examples The following example explains how to use filters for time, distance and speed. The respective minimum values for time, speed and distance have an AND-operation. This means that if only one value does not apply, all three values are ignored and not saved in the history. The maximum values have an OR-operation. If one of the maximum parameters has been met, the GPS protocols will be saved in the GPS history.
s XT55 AVL User’s Guide Confidential/Released mobile 3.
s XT55 AVL User’s Guide Confidential/Released mobile 3.2.1 Extended NMEA commands 3.2.1.1 Command Syntax The XT55 module accepts NMEA commands in the following formats: $PSRF,, .. ,<* Checksum> . Command1 Parameter2 Checksum3 End Sequence4 $PSRF11 Data *CKSUM 1 NMEA command Valid parameters 3 The checksum consists of a “*” followed by 2-digit hex value of checksum.
s XT55 AVL User’s Guide Confidential/Released mobile 3.2.1.2 Extended NMEA command description Please note that all extended NMEA commands beginning with $PSRF111 are for internal test purposes only. Whereas all extended NMEA commands beginning with $PSRF112 and $PSRF109 are implemented for configuration of history, alarm and remote tracking function. Please note that all NMEA commands, which have to be sent to the XT55 module, are accepted when the End Sequence is also included.
s XT55 AVL User’s Guide Confidential/Released mobile Commands build in remote tracking function $PSRF112, value, position, phone_number *XX Parameter description: value: // configure the remote tracking Defined values 20 //enables remote tracking for authorized phone number position: // enter the position of authorized telephone number into the list (0..9 available).
s XT55 AVL User’s Guide Confidential/Released $PSRF112, value, position, *XX mobile Parameter description: value: // configure the remote tracking Defined values 22 // deletes and disables remote tracking for specified phone number(s) in the list position: // enter the position of authorized telephone numbers into the list (0..9 available). *XX // CheckSum has to be calculated.
s XT55 AVL User’s Guide Confidential/Released mobile Enable the GSM functionality $PSRF112, 30, PIN *XX Parameter description: 30: //enable the GSM functionality (i.e. deactivate PIN request) PIN: //enter the PIN number of SIM card *XX //CheckSum has to be calculated. Example 1: $PSRF112,30,1111*26 This command enters the PIN number of SIM card also deactivates the PIN request of SIM card.
s XT55 AVL User’s Guide Confidential/Released $PSRF112, 32 *XX mobile This read command returns the current address of service centre. Parameter description: 32: // read command *XX // CheckSum has to be calculated. Enter: $PSRF112,32*08 Response: OK +CSCA: "[ServiceCenter]“,[Format] (error) +CME ERROR: [CME_error] (error) communication failure Note: - See [1] for further explanation of the displayed Address Format or CME error code.
s XT55 AVL User’s Guide Confidential/Released mobile Commands build in the history function $PSRF112, 1, Parameter description: 1: LOG=[parameter Parameters: s], *XX // enable history function // configure history function Defined values numSat // Minimum number of satellites required for storage in the GPS history.
s XT55 AVL User’s Guide Confidential/Released $PSRF112, 3, rawData, *XX mobile Parameter description: 3: rawData: // pre-defined value which performs the history download procedure // configure the data format Defined values 0 // request history in the SiRF binary format *XX // CheckSum has to be calculated.
s XT55 AVL User’s Guide Confidential/Released $PSRF109, rawData, startdate, startTime, stopDate, stopTime *XX mobile Download history from XT55 AVL using specified parameters Parameter description: rawData: // configure the data format Defined value 0 // request history in the NMEA format startdate // start date in DDMMYY format startTime // the start time in HHMMSS format stopDate // the stop date in DDMMYY format stopTime // the stop time in HHMMSS format *XX // CheckSum has to be calculate
s XT55 AVL User’s Guide Confidential/Released $PSRF103, Msg,Mode,Rate, CecksumEnable, *XX mobile This command is used to control the output of standard NMEA messages GGA, GLL, GSA, GSV, RMC and VTG. Using this command message, the standard NMEA messages may be polled once, or setup for periodic output. Checksums may also be enabled or disabled depending on the needs of the receiving program.
s XT55 AVL User’s Guide Confidential/Released mobile Commands build in the alarm function $PSRF112, Parameter description: Value, key_number, value: msg_mode, phone_number *XX // configure the alarm keys Defined value 10 // enables key configuration key_number // determine the alarm key (1,2 possible) Defined values 1 //General propose input (Pin 20) 2 //General propose input (Pin 30) msg_mode // Defines the call type for each respective telephone number.
s XT55 AVL User’s Guide Confidential/Released $PSRF112, Value, key_number, mobile Parameter description: value: // configure the alarm keys Defined value *XX 12 // displays key number Example : $PSRF112,12,2*14 This command displays the settings of given key number (2).
s XT55 AVL User’s Guide Confidential/Released mobile Command for internal test purposes $PSRF111, value, *XX Parameter description: value: //commands overview Defined value 0 //overview of all implemented test commands *XX //CheckSum has to be calculated. Example: $PSRF111,0*3A $PSRF111, value, *XX Parameter description: value: //configure the download procedure Defined values 1 //returns the current version number of software and hardware *XX //CheckSum has to be calculated.
s XT55 AVL User’s Guide Confidential/Released $PSRF111, value, *XX mobile Parameter description: value: //configure the download procedure Defined value 4 //performs the test of serial port *XX //CheckSum has to be calculated. Example: $PSRF111,4*3E Response: ERR: malfunction detected OK: serial port 2 successfully tested $PSRF111, value, *XX Parameter description: value: //configure the download procedure Defined value 5 //performs automatic test *XX //CheckSum has to be calculated.
s XT55 AVL User’s Guide Confidential/Released $PSRF111, value, *XX mobile Parameter description: value: *XX //configure the download procedure Defined value 70 //information about the malfunctional tracks //CheckSum has to be calculated. Example: $PSRF111,7*3D Response: ERROR or SUCCESS $PSRF111, value, *XX Parameter description: value: //configure the download procedure Defined value 8 // performs the test of all GPIO’s *XX // CheckSum has to be calculated.
s XT55 AVL User’s Guide Confidential/Released $PSRF111, value, *XX mobile Parameter description: value: //configure the download procedure Defined value 90 // calibration points, calculated voltage and current. *XX // CheckSum has to be calculated. Example: $PSRF111,90*03 Response: Calibration points, calculated voltage and current Received alarm SMS from XT55 Protocol Protocol The following protocol type can be received: RMC Example: $GPRMC,103530.000,A,5040.3986,N,01058.8636,E,0.06,171.
s XT55 AVL User’s Guide Confidential/Released mobile 4 Software interface The module XT55 is capable of outputting data in the NMEA-0183 format as defined by the National Marine Electronics Association (NMEA), Standard for Interfacing Marine Electronic Devices, Version 2.20, January 1st, 1997. 4.1 NMEA output messages The table below shows all NMEA output messages supported by the module XT55 as well as a brief description of each output message.
s XT55 AVL User’s Guide Confidential/Released mobile 4.3 Digital Inputs The input pins (pin 20 – GPIO 15, pin 30 – GPIO 3) of the 80-pin board-to-board connector are pre-defined as digital inputs. These input pins can be connected to the CMOS +3.3V DC. The figure below illustrates how to connect these inputs. Figure 12: Connection example for GPIO 15 and GPIO 3 XT55_avl_ug_V03 Page 35 of 37 28.06.
s XT55 AVL User’s Guide Confidential/Released mobile 5 Example application AVL G P S A n te n n a (3 V ) 3V 3 + 470u F LDO 33pF O N /O F F 33pF 1S S3 55 G S M A n te n n a BATT+ L i-Io n b a tte ry p a ck 2 .
s XT55 AVL User’s Guide Confidential/Released mobile Figure 13 shows a typical example of a portable AVL application set. Power will be supplied from an integrated Li-Ion battery pack. The charging control is integrated in the GSM part of the XT55 module and can be used for the entire module, see [2] for details. The headset jack is assigned to audio interface 1 of the XT55 module. The MICP2 and MICN2 lines are intended for feeding a microphone.