Preview only show first 10 pages with watermark. For full document please download

Gl300 @tracker Air Interface Protocol V1.02

   EMBED

Share

Transcript

GSM/GPRS/GPS Tracker GL300 @Track Air Interface Protocol Application Notes: TRACGL300AN001 Revision: 1.02 [email protected] GL300 @Tracker Air Interface Protocol Document Title GL300 @Tracker Air Interface Protocol Version 1.02 Date 2013-11-26 Status Release Document Control ID TRACGL300AN001 k n i l l c a i e t u n Q fide n o C General Notes Queclink offers this information as a service to its customers, to support application and engineering efforts that use the products designed by Queclink. The information provided is based upon requirements specifically provided to Queclink by the customers. Queclink has not undertaken any independent search for additional relevant information, including any information that may be in the customer’s possession. Furthermore, system validation of this product designed by Queclink within a larger electronic system remains the responsibility of the customer or the customer’s system integrator. All specifications supplied herein are subject to change. Copyright This document contains proprietary technical information which is the property of Queclink Limited. The copying of this document, distribution to others, and communication of the contents thereof, are forbidden without express authority. Offenders are liable to the payment of damages. All rights are reserved in the event of a patent grant or the registration of a utility model or design. All specification supplied herein are subject to change without notice at any time. Copyright © Queclink Wireless Solutions Co., Ltd. 2011 TRACGL300AN001 -1- GL300 @Tracker Air Interface Protocol Contents Contents ............................................................................................................................................2 Table Index........................................................................................................................................4 Figure Index ......................................................................................................................................5 0. Revision history ............................................................................................................................6 1. Overview.......................................................................................................................................8 1.1. Scope ...................................................................................................................................8 1.2. Terms and Abbreviations.....................................................................................................8 2. System Architecture ......................................................................................................................9 3. Message Description ...................................................................................................................10 3.1. Message Format ................................................................................................................10 3.2. Command and Acknowledgement.....................................................................................12 3.2.1. Quick Start Setting...............................................................................................12 3.2.2. Bearer Setting Information ..................................................................................15 3.2.3. Backend Server Register Information..................................................................16 3.2.4. Global Configuration ...........................................................................................18 3.2.5. Non movement detection .....................................................................................21 3.2.6. Time Adjustment..................................................................................................23 3.2.7. Fixed Report Information ....................................................................................24 3.2.8. Geo-Fence Information........................................................................................27 3.2.9. Speed Alarm.........................................................................................................29 3.2.10. Function Key Setting ...........................................................................................30 3.2.11. Real Time Operation............................................................................................32 3.2.12. White Call List Configuration .............................................................................33 3.2.13. Google link SMS configuration ...........................................................................35 3.2.14. Auto unlock SIM-PIN..........................................................................................36 3.2.15. Digital Input Port Settings ...................................................................................37 3.2.16. Protocol watchdog ...............................................................................................38 3.2.17. Data transfer between UART and backend server ...............................................40 3.2.18. Network Select.....................................................................................................41 3.2.19. Outside Working Hours .......................................................................................42 3.2.20. Temperature Alarm ..............................................................................................43 3.2.21. Store Command String.........................................................................................45 3.2.22. User Defined Function.........................................................................................46 3.2.23. Update configuration over the air ........................................................................48 3.2.24. Jamming Detection ..............................................................................................49 3.3. Report................................................................................................................................52 3.3.1. Position Related Report .......................................................................................52 3.3.2. Device Information Report ..................................................................................56 3.3.3. Report for Querying.............................................................................................58 3.3.4. Event Report ........................................................................................................70 3.3.5. Buffer Report .......................................................................................................83 k n i l l c a i e t u n Q fide n o C TRACGL300AN001 -2- GL300 @Tracker Air Interface Protocol 3.3.6. Report Google Maps hyperlink............................................................................84 3.4. Heartbeat ...........................................................................................................................85 3.5. Sever Acknowledgement...................................................................................................85 Appendix: Message Index...............................................................................................................87 k n i l l c a i e t u n Q fide n o C TRACGL300AN001 -3- GL300 @Tracker Air Interface Protocol Table Index TABLE 1: TERMS AND ABBREVIATIONS .........................................................................................8 k n i l l c a i e t u n Q fide n o C TRACGL300AN001 -4- GL300 @Tracker Air Interface Protocol Figure Index FIGURE 1: SYSTEM ARCHITECTURE................................................................................................9 FIGURE 2: @TRACKER PROTOCOL MESSAGES FLOW...............................................................10 k n i l l c a i e t u n Q fide n o C TRACGL300AN001 -5- GL300 @Tracker Air Interface Protocol 0. Revision history Revision Date Author Description of change 0.02 2012-10-12 Evan.tu Initial 1.00 2012-10-26 Evan.Tu 2012-11-12 2012-11-14 Evan.Tu Evan.Tu 1. Add a new parameter to control whether to drive the motor in the command “AT+GTFKS” 2. Add a new command “AT+GTMON” 3.Delete the command “AT+GTFFC” protocol 4.Modified the command “AT+GTRTO” protocol 5.Modified the command “AT+GTOWH” protocol 6.Delete the report massage “+RESP:GTANT” 7.Add the report massage “+RESP:GTALS” 8.Add 4 reserved parameter in the command “AT+GTOWH” 9.Modified the parameter is reserved in the commands “AT+GTQSS 、AT+GTBSI” 10.Modified the report massage “+RESP:GTDOG” 11.Modified the description of NOTE in the command “AT+GTFRI” 12.Add the report massage “+RESP:GTDAT” 13.Add a parameter in the command “AT+GTNTS” 14.Modified the report massage “+RESP：GTALL” 15.Modified the report massage “+RESP:GTDOG” 16.Modified the decription of the parameter in command “AT+GTFKS” 17.Add the report massage “+RESP:GTMON” 18.Add the temperature alarm report function AT+GTTEM and the alarm report massage +RESP:GTTEM 19.Add a parameter in the report massage +RESP:GTINF 20.Modified the report massage “+RESP:GTMON” k n i l l c a i e t u n Q fide n o C 2012-11-16 2012-11-19 2012-11-20 Evan.Tu Evan.Tu Evan.Tu 2012-11-26 2012-11-28 Evan.Tu Evan.Tu Evan.Tu 1.01 1.02 2012-11-29 Evan.Tu Evan.Tu 2012-12-04 Evan.Tu 2012-12-15 Evan.Tu 2013-1-5 Evan.Tu 2013-1-9 Evan.Tu 2013-1-15 Evan.Tu 2013-07-24 Evan.Tu 1.Add two new commands “AT + GTCMD” and “AT + GTUDF” 2.Add two new parameters and in the command “AT+GTSRI” 2013-08-28 Evan.Tu 1.Add a new protocol command AT + GTUPC 2013-08-30 Evan.Tu 1.Delete a protocol command AT + GTMON 2013-10-17 Evan.Tu 1.Add the report mode 6 in the command AT+GTQSS TRACGL300AN001 -6- GL300 @Tracker Air Interface Protocol 2.Add the mode 6 in the command AT+GTFRI 2013-11-14 Evan.Tu 1.Add a new protocol command AT+GTJDC k n i l l c a i e t u n Q fide n o C TRACGL300AN001 -7- GL300 @Tracker Air Interface Protocol 1. Overview 1.1. Scope The @Track Air Interface Protocol is a digital communication interface based on printable ASCII characters over SMS or GPRS which is used for all communication between the backend server and the terminal. The backend server sends a command to the terminal and then the terminal confirms with an acknowledgement message. If necessary, the terminal also sends report messages to the backend server. The purpose of this document is to describe how to build up the backend server based on the @Track Air Interface Protocol. k n i l l c a i e t u n Q fide n o C 1.2. Terms and Abbreviations Table 1: Terms and abbreviations Abbreviation Description APN Access Point Network ASCII GPRS GSM HDOP ICCID IP SMS TCP UDP UTC TRACGL300AN001 American National Standard Code for Information Interchange General Packet Radio Service Global System for Mobile Communications Horizontal Dilution of Precision Integrated Circuit Card Identity Internet Protocol Short Message Service Transmission Control Protocol User Datagram Protocol Coordinated Universal Time -8- GL300 @Tracker Air Interface Protocol 2. System Architecture k n i l l c a i e t u n Q fide n o C Figure 1: System architecture The backend server can be accessed by many terminals and should have the following abilities:  The backend server should be able to access the internet and listen to the connection originating from the terminal.  The backend server should be able to support a TCP or UDP connection with the terminal. It should be able to receive data from the terminal and send data to the terminal.  The backend server should be able to receive and send SMS. TRACGL300AN001 -9- GL300 @Tracker Air Interface Protocol 3. Message Description 3.1. Message Format All of the @Track Air Interface Protocol messages are composed of printable ASCII characters. Each message has the following format: Message format Message type AT+GTXXX=,,…$ Command +ACK:GTXXX,,,…$ Acknowledgement +RESP:GTXXX,,,…$ Report k n i l l c a i e t u n Q fide n o C The entire message string ends with character ‘$’. The characters ‘XXX’ identify the deferent message. The “,,…” carry the message’s parameters. The number of parameters is different in different messages. The ASCII character ‘,’ is used to separate the neighbouring parameter characters. The parameter string may contain the ASCII characters: ‘0’-‘9’, ’a’-‘z’, ’A’-‘Z’. Detailed descriptions of each message format are located in the specific message sections. By sending Commands to the terminal, the backend server can either configure and query the parameters of the terminal or control the terminal to perform specific actions. When the terminal receives Commands over the air, it will reply with a corresponding Acknowledgement message. According to the configuration of the parameters, the terminal can send Report messages to the backend server. Please see the following figure: Command Acknowledgement Terminal Backend Server Report Report Report Figure 2: @Tracker protocol messages flow TRACGL300AN001 - 10 - GL300 @Tracker Air Interface Protocol When the device receives commands over the air, it supports several commands in one SMS or GPRS packet without separate symbol between two close commands. But it is necessary to make sure the total size of the several commands is not longer than 160 if the commands are sent via SMS. Here is an example to send three commands in one SMS. AT+GTFRI=gl300,1,1,,,0000,2359,60,60,,,1F,0,,,,,,,,0007$AT+GTGEO=gl300,0,3,101.412248, 21.187891,1000,600,,,,,,,,,0008$AT+GTSPD=gl300,1,5,40,30,60,,,,,,,,,,,,,,,,0009$ It includes three commands (AT+GTFRI, AT+GTGEO and AT+GTSPD) in the above message. And the terminal will handle the three commands one by one after it received the message via SMS and it will report the following three acknowledgement message to the backend server one by one. k n i l l c a i e t u n Q fide n o C +ACK:GTFRI,1A0102,135790246811220,,0007,20100310172830,11F0$ +ACK:GTGEO,1A0102,135790246811220,,0,0008,20100310172900,11F1$ +ACK:GTSPD,1A0102,135790246811220,,0009,20100310172930,11F2$ TRACGL300AN001 - 11 - GL300 @Tracker Air Interface Protocol 3.2. Command and Acknowledgement 3.2.1. Quick Start Setting The command AT+GTQSS is used to set the GPRS parameter and backend server information in one command if all these settings are within 160 bytes, otherwise use AT+GTBSI and AT+GTSRI in two steps.  AT+GTQSS= Example: AT+GTQSS=gl300,cmnet,,,4,,,116.226.44.17,9001,116.226.44.16,9002,+8613812341234,0,1, ,,0001$ k n i l l c a i e t u n Q fide n o C Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 0–6 0 0|1|2 1 0 – 65535 0 APN <=40 APN user name <=30 APN password <=30 Report mode 1 Reserved 0 Buffer enable 1 Main server IP/domain name <=60 Main server port <=5 Backup server IP <=15 Backup server port <=5 SMS gateway <=20 Heartbeat interval 0.0.0.0 0 – 65535 0 <=3 0|5 – 360min 0 SACK enable 1 0|1 0 Reserved 0 Reserved 0 Serial number 4 0000 – FFFF Tail character 1 $      $ : The valid character of password is ‘0’-9’, ‘a’-‘z’, ‘A’-‘Z’. The default value is “gl300”. : Access point name (APN). : the GPRS APN user name. If the parameter field is empty, the parameter will be cleared. : the GPRS APN password. If the parameter field is empty, the parameter will be cleared. : Supports report modes as following:  0: Stop reporting.  1: TCP short-connect preferred mode. The connection is based on TCP protocol. The TRACGL300AN001 - 12 - GL300 @Tracker Air Interface Protocol          terminal connects to the backend server every time it needs to send data and will shut down the connection when the terminal finishes sending data. And if it is failed to establish a TCP connection with the backend server (including Main Server and Backup Server), it will try to send data via SMS.  2: TCP short-connect forced mode. The connection is based on TCP protocol. The terminal connects to the backend server every time it needs to send data and will shut down the connection when the terminal finishes sending data. And if it is failed to establish a TCP connection with the backend server (including Main Server and Backup Server), it will be stored in the BUFFER (if BUFFER function is enabled, please refer to ) or discarded (if the BUFFER function is disabled).  3: TCP long-connect mode. The connection is based on TCP protocol. The terminal connects to the backend server and maintains the connection using the heart beat data. Please note that in this mode the backend server should respond to the heart beat data from the terminals.  4: UDP mode. The terminal will send data to the backend server by UDP protocol. It supports to receive protocol command via UDP. But it is recommended to make sure the IP address and UDP port of the device can be visited in the internet, and this is generally realized by heart beat package and the message +RESP:GTPDP.  5: Force on SMS. Only use the SMS for transmitting.  6: UDP with fixed local port. Like the UDP mode, the terminal will send data using UDP protocol. The difference is the terminal will use fixed local port rather than random port to communicate with the server in this mode. Thus the backend server could use identical port to communicate with all terminals if the backend server and the terminals are all in the same VPN network. The port number the device uses is the same as the port number of the primary server. : .Not used at present.Please keep empty : Enable or disable BUFFER function. Please refer to 3.3.5 for the details about BUFFER function.  0: Disable the BUFFER function.  1: Enable the BUFFER function.  2: High priority. Enable the buffer report function. Under this working mode, the device will send all the buffered messages before sending any normal message except for the SOS message (+RESP:GTSOS).
: The IP address or the domain name of the main server.
: The port of the main server. : The IP address of the backup backend server. : The port of the backup server. : Maximum 20 characters including the optional national code starting with “+” for SMS messages. Short code (for example: 10086) is also supported. : the interval for the terminal to send heartbeat package message to the backend server. If set to 0, no heartbeat package is sent. : A numeric to indicate whether the backend server should reply SACK message to the device.  0: the backend server does not reply SACK message after receiving a message from k n i l l c a i e t u n Q fide n o C TRACGL300AN001 - 13 - GL300 @Tracker Air Interface Protocol the device.  1: the backend server should reply SACK message after receiving a message from the device.  : the serial number for the command. It will be invoked in the ACK message of the command.  : a character to indicate the end of the command. And it should be “$”. Note: If is set as 4 (UDP mode), it is strongly recommended to enable SACK or heart beat mechanism ( doesn’t equal to 0). The acknowledgement message of AT+GTQSS command:  +ACK:GTQSS, k n i l l c a i e t u n Q fide n o C Example: +ACK:GTQSS,1A0102,135790246811220,,0001,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $       Default $ : The combination of the device type and the version number of the applied protocol. The first two characters ‘XX’ indicate the device type. ‘1A’ represents GL300. The middle two characters are the main version number and the last two characters are the minimum version number. Both the main version and the minimum version are hex digital. For example, ‘020A’ means version 2.10. : ID of the device, use the IMEI of the current SIM card inside the terminal. : Please refer to the parameter in the command AT+GTCFG. : The same serial number which is sent to the device with the corresponding command. The backend server could use it to distinguish which command the ACK message is for. : The local time to send the ACK message. : The self-increasing count number will be put into every acknowledgment message and report message. The count is beginning from 0000 and increases by 1 every time. It will roll back after “FFFF”. TRACGL300AN001 - 14 - GL300 @Tracker Air Interface Protocol 3.2.2. Bearer Setting Information The command AT+GTBSI is used to set the GPRS parameter.  AT+GTBSI= Example: AT+GTBSI=gl300,cmnet,,,,,,,0002$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 APN <=40 APN user name <=30 k n i l l c a i e t u n Q fide n o C APN password <=30 Reserved 0 Reserved Reserved Reserved 0 0 0 Serial number 4 0000 – FFFF Tail character 1 $ $ The acknowledgement message of AT+GTBSI command:  +ACK:GTBSI, Example: +ACK:GTBSI,1A0102,135790246811220,,0002,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ TRACGL300AN001 Default $ - 15 - GL300 @Tracker Air Interface Protocol 3.2.3. Backend Server Register Information The command AT+GTSRI is used to configure the backend server information that the terminal reports to and the report mode that defines the communication method between the backend server and the terminal.  AT+GTSRI= Example: AT+GTSRI=gl300,4,,,116.226.44.17,9001,116.226.44.16,9002,+8613812341234,0,1,,,,,0003$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 Report mode 1 0–5 0 Reserved 0 0|1|2 1 0 – 65535 0 k n i l l c a i e t u n Q fide n o C Buffer enable 1 Main server IP/domain name <=60 Main server port <=5 Backup server IP <=15 Backup server port <=5 SMS gateway <=20 Heartbeat interval 0.0.0.0 0 – 65535 0 <=3 0|5 – 360min 0 SACK enable 1 0|1 0 SMS ACK Enable 1 0|1 0 Quick Link Enable 1 0|1 0 Reserved 0 Reserved 0 Serial number 4 0000 – FFFF Tail character 1 $   $ : This defines whether the ACK confirmation should respond by SMS when the command was sent by SMS.  0: the device will send the ACK confirmation with the mode configured by the .  1: the device will send the ACK confirmation by SMS to the phone which sent the command by SMS. : This defines whether the device should establish TCP connection under certain condition.  0: disable.  1: The device should establish TCP connection immediately when a call is coming. This feature will be valid only when the report mode is set as TCP long connection. The acknowledgement message of AT+GTSRI command:  +ACK:GTSRI, TRACGL300AN001 - 16 - GL300 @Tracker Air Interface Protocol Example: +ACK:GTSRI,1A0102,135790246811220,,0003,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ Default $ k n i l l c a i e t u n Q fide n o C TRACGL300AN001 - 17 - GL300 @Tracker Air Interface Protocol 3.2.4. Global Configuration The AT+GTCFG command is used to configure the global parameters.  AT+GTCFG= Example: AT+GTCFG=quectl,123456,,,,,,,,,,,,,,,,,,,,0004$ AT+GTCFG=gl300,,GL300,0,0.0,0,7,0,0,,,,1,1,300,1,0,20491231235959,1,0,,0004$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 New password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ Device name 20 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’, ‘-’, ‘_’ GL300 ODO enable 1 0|1 0 ODO mileage <=9 0.0 – 4294967.0Km 0.0 GPS on need 1 0|1|2|3 1 GPS fix delay 2 5 – 60sec 5 Report items mask <=4 0000 – 007F 001F Gsm report 1 0|1|2|3 0 Reserved 0 k n i l l c a i e t u n Q fide n o C Event mask 4 0000-3FFF 0FFF EPB mode 1 0|1 0 LED on 1 0|1|2 1 Info report enable 1 0|1 1 Info report interval <=5 30 – 86400sec 300 Location by call 1 0|1 1 Expiry enable 1 0|1 0 Expiry time 14 YYYYMMDDHHMMSS 204912312 35959 Agps mode 1 0|1 0 Sleep enable 1 0|1 0 Reserved 0 Serial number 4 0000 – FFFF Tail character 1 $     $ : Set to change the current password. : the name of the device, which appears in each uplink message. : Enable or disable the odograph function to calculate the total mileage. The current mileage is included in the message GTINF.  0: Disable the ODO mileage function.  1: Enable the ODO mileage function. : The value of the current total mileage. TRACGL300AN001 - 18 - GL300 @Tracker Air Interface Protocol      : Whether to close GPS chip after retrieving GPS position information.  0: Never close GPS chip  1: Close GPS chip after retrieving GPS information every time.  2: Never close GPS chip only in ignition on state or movement state.  3: Never open GPS chip. : This is the time to wait after GPS fixing succeed. After GPS fixing succeed, the device will wait for a period of time (defined by ) and then get the result of GPS fixing because maybe it is not accurate to get the position immediately after GPS fixing succeed. (e.g. if is set as 7, we will wait for 7 seconds after GPS fixing succeed and then get the position as the result). The range of the parameter is 5 – 60, and the default value is 5. Unit: second. : Bitwise report mask to configure the composition of all the uplink message. Each bit represents a field in the uplink message. If some bit is set as 1, the corresponding field will be filled if it is included in the uplink message. Otherwise, the field will be empty. Bit0(0001): Bit1(0002): Bit2(0004): Bit3(0008): GSM LAI and CI, including , , , Bit4(0010): Bit5(0020): : A Hex value to configure which event reports can be sent to the backend server: Each bit corresponds to a report message. And if the bit is set as 1, the corresponding report message can be sent to the backend server. Otherwise, it can not be sent to the backend server. Here is the mapping between each bit and each report message. bit0(0001): +RESP:GTPNA bit1(0002): +RESP:GTPFA bit2(0004): +RESP:GTEPN bti3(0008): +RESP:GTEPF bit4(0010): Reserved bit5(0020): +RESP:GTBPL Bit6(0040): +RESP:GTBTC Bit7(0080): +RESP:GTSTC bit8(0100): +RESP:GTSTT bit9(0200): Reserved bit10(0400): +RESP:GTPDP bit11(0800): +RESP:GTPNL bit12(1000): +RESP:GTIGN and +RESP:GTIGF bit13(2000): +RESP:GTIGL : If GPS fixing for the report message +RESP:GTSOS, +RESP:GTRTL, +RESP:GTLBC and +RESP:GTFRI were failed and the parameter was set as 1, the terminal reports the message +RESP:GTGSM, including the information of the service cell and the neighbour cells after those messages.  0: Not allow the cells’ information report after failed to get GPS position. k n i l l c a i e t u n Q fide n o C TRACGL300AN001 - 19 - GL300 @Tracker Air Interface Protocol  1: Allow the cells’ information report after failed to get GPS position.  2: Do not report the message +RESP:GTGSM if no cell’s information is found.  3: Allow the cells’ information report whatever it gets GPS position or not  : The mode of External Power Control Unit With Built-in Motion Sensor.  0: disable External Power Control Unit With Built-in Motion Sensor.  1: enable External Power Control Unit With Built-in Motion Sensor.  : Configure the working mode of LEDs.  0: Each time after the device powers on or the parameter is updated to 0 from other values, GPS LED will work for 150 seconds and then turn off deadly. GSM LED and Power LED work normally.  1: All LEDs work normally.  2: All LEDs are off always except the following cases. The first exception is all LEDs will work for a period time after power on. The second exception is Power LED will flash fast during power off procedure. The third exception is Power LED will work normally for charging status when a charger is inserted in power off state.  : Enable/disable the device information report （+RESP:GTINF） function. The device information include state of the device, ICCID, GSM signal strength, adapter connection status, battery voltage, charging status, Power and GPS LED working mode, GPS on need setting, GPS antenna type, GPS antenna status, the last known time of GPS fix.  0: Disable the device information report function.  1: Enable the device information report function.  : The interval of reporting the device information.  : Configure how to handle the incoming call.  0: Just hang up the call.  1: Hang up the call and report the current position.  : Enable or disable the expiry function to stop all the GPS fixing and any reports.  0: Disable the Expiry function.  1: Enable the Expiry function.  : The time when to stop all the GPS fixing and any reports. The valid format is “YYYYMMDDHHMMSS”. The value range of “YYYY” is “2000”-“3000”. The value range of “MM” is “01”-“12”. The value range of “DD” is “00”-“31”. The value range of “HH” is “00”-“23”. The value range of “MM” is “00”-“59”. The value range of “SS” is “00”-“59”It is noticed to use RTC time here.  : A numeric to indicate whether to enable AGPS. AGPS is helpful to improve the ratio to get GPS position successfully and reduce the time to get GPS position.  0: Disable the AGPS function.  1: Enable the AGPS function.  : Enable or disable the sleep mode when charging.  0: Disable the sleep mode when charging.  1: Do not disable the sleep mode when charging. Note: For AGPS function, it is necessary to download AGPS file from the specified URL, so it is k n i l l c a i e t u n Q fide n o C TRACGL300AN001 - 20 - GL300 @Tracker Air Interface Protocol unavoidable to cost some data traffic for the AGPS function. At present, it takes about 10 KB data traffic for the AGPS function each day. The acknowledgement message of AT+GTCFG command:  +ACK:GTCFG, Example: +ACK:GTCFG,1A0102,135790246811220,,0004,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ 3.2.5. Default k n i l l c a i e t u n Q fide n o C $ Non movement detection The AT+GTNMD command is used to configure the parameters for non movement detection.  AT+GTNMD= Example: AT+GTNMD=gl300,,3,2,3,,,,,,,,,,0005$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 1 0-F 0 Non-movement duration <=3 1 – 255(×15sec) 2 Movement duration <=2 1 – 50(×128ms) 3 Movement threshold 1 2–9 2 rest fix interval 5 5 – 86400sec 300 rest send interval 5 5 – 86400sec 300 pm rest threshold 1 2–9 2 pm motion threshold 1 2–9 3 Urc report 1 0|1 0 Reserved 0 Reserved 0 Reserved 0 Reserved 0 Serial number 4 0000 – FFFF Tail character 1 $ mode TRACGL300AN001 $ - 21 - GL300 @Tracker Air Interface Protocol          : A hex numeric to determine how the function works. Each bit of the hex numeric indicate different behavior that device could do. If the corresponding bit is 1, the device will behave as the description. Otherwise, it won’t behave as the description. Bit0(1): Suspend the report of FRI(including +RESP:GTGSM for FRI) and Geo-Fence when it detects non-movement. Bit1(2): Report the message +RESP:GTNMR to the backend server when it detects non-movement. Bit2(4): Report the message +RESP:GTNMR to the backend server when it detects movement. Bit3(8): Change the fix interval and send interval of FRI(including +RESP:GTGSM for FRI) to and when it detects non-movement. In the case, it just modify the fix interval and send interval of FRI(including +RESP:GTGSM for FRI) but not suspend the report of FRI(including +RESP:GTGSM for FRI) even if Bit0 is 1. : A time parameter to determine whether the device enters non-movement status, i.e. if the motion sensor detects that the device keeps in non-movement for a period of time defined by , the device will be considered as in non-movement status. : A time parameter to determine whether the device enters movement status. If the motion sensor detects that the device keeps in movement for a period of time defined by , the device will be considered as in movement status. : The threshold for the motion sensor to determine whether the device is in movement. The less, the more likely to be treated as movement. : the fix interval for the report of FRI when the device is in rest state if Bit3 of is 1. : the send interval for the report of FRI when the device is in rest state if Bit3 of is 1. : The threshold for the EBK motion sensor to determine whether the EBK enters non-movement status. : The threshold for the EBK motion sensor to determine whether the EBK enters movement status. : Enable or disable output sensor state through urc.  0: Do not output the sensor’s state to UART.  1: Output a URC to UART to indicate state changing. “SENSOR:REST” means state changing from MOTION to REST. “SENSOR:MOTION” means state changing from REST to MOTION. k n i l l c a i e t u n Q fide n o C The acknowledgement message of AT+GTNMD command:  +ACK:GTNMD, Example: +ACK:GTNMD,1A0102,135790246811220,,0005,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} TRACGL300AN001 Default - 22 - GL300 @Tracker Air Interface Protocol Unique ID 15 Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ 3.2.6. IMEI $ Time Adjustment The command AT+GTTMA is used to adjust local time. If the GPS fixing is successful, the local time will be automatically adjusted according to the GPS UTC time.  k n i l l c a i e t u n Q fide n o C AT+GTTMA= Example: AT+GTTMA=gl300,-,3,30,0,20090917203500,,,,,0006$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 1 +|- + Hour Offset <=2 0 - 23 00 Minute Offset <=2 0 - 59 00 Daylight Saving 1 0|1 0 UTC Time 14 YYYYMMDDHHMMSS Reserved 0 Sign Reserved Reserved Reserved 0 0 0 Serial number 4 0000 – FFFF Tail character 1 $      $ : Indicate the positive or negative of the local time offset to UTC : UTC offset in hours : UTC offset in minutes : Enable/disable daylight saving time.  0: Disable daylight saving  1: Enable daylight saving : The configuration UTC time. The acknowledgement message of AT+GTTMA command:  +ACK:GTTMA, Example: +ACK:GTTMA,1A0102,135790246811220,,0007,20100310172830,11F0$ Parameter TRACGL300AN001 Length (byte) Range/Format Default - 23 - GL300 @Tracker Air Interface Protocol Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ 3.2.7. $ Fixed Report Information k n i l l c a i e t u n Q fide n o C The command AT+GTFRI is used to configure the parameters of scheduled report.  AT+GTFRI= Example: AT+GTFRI=gl300,0,,,,,,,,,,,,,,,,,,,0007$ AT+GTFRI=gl300,1,1,,,0000,2359,60,60,,,1F,,,,,,,,,0007$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 1 0|1|2|3|4|5|6 0 Discard no fix 1 0|1 1 Reserved 0 Mode Reserved 0 Begin time 4 HHMM 0000 End time 4 HHMM 0000 Check interval <=5 5 – 86400sec 180 Send interval <=5 5 – 86400sec 180 Ignition check interval <=5 5 – 86400sec 180 Ignition send interval <=5 5 – 86400sec 180 Report mask <=4 0000 – 007F 001F Distance <=5 50 – 65535m 1000 <=5 50 – 65535m 1000 movement detect mode 1 0|1 0 movement speed <=3 1-999(km/h) 5 movement distance <=4 1-9999(m) 50 Movement send number 1 1-5 5 corner 3 0 - 180 0 Reserved 0 Serial number 4 0000 – FFFF Tail character 1 $ Mileage TRACGL300AN001 $ - 24 - GL300 @Tracker Air Interface Protocol          : The working mode of the fixed report.  0: Disable fixed report function.  1: Enable the scheduled timing report.  2: Enable the scheduled distance report. Report each time the straight length that the device moved has exceeded the specified distance. It ignores the detail path the device has passed along. This function is invalid unless the GPS chip opens always. Unit: Meter.  3: Enable the scheduled mileage report. Report each time the path length that the device moved has exceeded the specified length. It calculates the length of the detail path the device has passed along. This function is invalid unless the GPS chip opens always. Unit: Meter.  4: Optimum Report. Simultaneously observe time interval and path length between two adjacent reports. Report device position if the calculated time interval per current time against the last report time is greater than the , and the length of path between the current position and the last position is greater than the setting. There is a precondition for the function. It is that must be 0 (Never close GPS chip) or 2 (Never close GPS chip in ignition on state or movement state).  5: Enable the scheduled timing report for GSM.  6: Fixed Time or Mileage Report. Simultaneously observe both time interval and path length between two adjacent reports. Report device position if the calculated time interval per current time against the last report time is greater than the , or the length of path between the current position and the last position is greater than the setting. : 0 to report last known GPS position if there is no GPS fix, 1 to send nothing if there is no GPS fix. : The start time of scheduled fixed report. The valid format is “HHMM”. The value range of “HH” is “00”-“23”. The value range of “MM” is “00”-“59”. It is noticed to use system time here. : The end time of scheduled fixed report. The valid format and range are same as . : The interval time to fix GPS when the device attached vehicle is ignition off, its value range is 5-86400 and the unit is second. : The period to send the position information when the device attached vehicle is ignition off. The value range is 5-86400 and the unit is second. : The interval time to fix GPS when the device attached vehicle is ignition on, its value range is 5-86400 and the unit is second. : The period to send the position information when the device attached vehicle is ignition on. The value range is 5-86400 and the unit is second. : Bitwise report mask to configure the composition of GPS position information for fixed report. If some bit is set as 1, the corresponding field will be filled in the position related message. Otherwise, the field will be empty. Bit0(0001): Bit1(0002): k n i l l c a i e t u n Q fide n o C TRACGL300AN001 - 25 - GL300 @Tracker Air Interface Protocol Bit2(0004): Bit3(0008): GSM LAI and CI, including , , , Bit4(0010): : the specified distance to send the position information when is 2 and this is valid only in the case that GPS chip keep opened always. Unit: meter.  : the specified path length to send the position information when is 3 and this is valid only in the case that GPS chip keep opened always.. Unit: meter.  : Enable or disable the movement detect function.  0: Disable the movement detect function.  1: Enable the movement detect function. If the movement detect function is enabled, it will consider the device is non-movement if the speed according to the GPS fixing result is slower than and the distance between the current GPS point and the last moving GPS point is less than . After it considers the device is non-movement, it will stop reporting FRI message after report FRI messages (speed field is shown as -1 in these messages.) for times.  : The speed threshold of movement detect. The unit is km/h.  : The distance threshold of movement detect. The unit is meter.  : According to the speed threshold and distance threshold, if the terminal is considered staying at one position, the terminal will send out at most this number of reports before it moves again.  : A numeric to indicate whether to report +RESP:GTFRI message according to the heading changing, i.e. the movement direction of the device changing. 0: disable the function, i.e. do not detect whether the device has changed its direction. 1 – 180: The angle used for deciding whether the device turn around. If the heading changing is greater than the specified value, the device will be considered turning around. Unit: degree. Note:  Check interval If was set as 1 or was set as 2 without ignition on, The terminal has two modes to operate the GPS module according to the value of :  Mode 1: If the is more than 60 seconds, the terminal will close the GPS part every time after GPS fixing finishes in order to save power.  Mode 2: If the is less than 60 seconds, the terminal will never close the GPS part in this mode. k n i l l c a i e t u n Q fide n o C Due to the maximum length limitation of the report message, it must be assured that: / <= 15. If exceed that limitation, the command is discarded and the previous settings keep untouched. If the terminal is in “Force on SMS Mode” ( = 5) while the / > 1, the terminal will report only the last position in the fixed timing report, because only one position could be filled in one single SMS message (160 bytes at most). TRACGL300AN001 - 26 - GL300 @Tracker Air Interface Protocol  Action time range  < : reports in the time period (begin time, end time) every day.  > : reports starting from and stopping at on the following day.  = : reports on the whole day.  Scheduled Report Mode For the mode schedule distance report and scheduled mileage report and optimum report, must be 0 (Never close GPS chip) or 2 (Never close GPS chip in ignition on state or movement state) for the function. For the mode scheduled timing report, it doesn’t care whether GPS works always.  Corner report It is necessary to set as 0 or 2 for detecting turning point. Because the detection for turning point is based on heading in GPS position which is not so accurate, it could make mistake to detect turning point sometimes. k n i l l c a i e t u n Q fide n o C The acknowledgement message of AT+GTFRI command:  +ACK:GTFRI, Example: +ACK:GTFRI,1A0102,135790246811220,,0007,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ 3.2.8. Default $ Geo-Fence Information The command AT+GTGEO is used to configure the parameters of Geo-Fence. Geo-Fence is a virtual perimeter on a geographic area using a location-based service, so that when the geofencing terminal enters or exits the area a notification is generated. The notification can contain information about the location of the terminal and may be sent to the backend server.  AT+GTGEO= Example: AT+GTGEO=gl300,0,3,101.412248,21.187891,1000,600,,,,,,,,,0008$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 GEO ID 1 0–4 TRACGL300AN001 - 27 - GL300 @Tracker Air Interface Protocol Mode 1 0–3 Longitude <=11 (-)xxx.xxxxxx Latitude <=10 (-)xx.xxxxxx Radius <=7 50 – 6000000m 50 Check interval <=5 0|30 – 86400sec 0 State mode 1 0|1 0 Reserved 0 Reserved 0 Reserved 0 Reserved 0 Reserved 0 Reserved Reserved k n i l l c a i e t u n Q fide n o C 0 0 Serial number 4 0000 – FFFF Tail character 1 $   0 $ : A numeric to identify the Geo-Fence. : A numeric which indicates when to report the notification to the backend server based on the following:  0: Disable the Geo-Fence on the specified GEO ID.  1: Reports when enters the Geo-Fence.  2: Reports when leaves the Geo-Fence.  3: Reports when enters or leaves the Geo-Fence.  : The longitude of a point which is defined as the center of the Geo-Fence circular region. The format is “(-)xxx.xxxxxx” and the value range is from “-180.000000” to “180.000000”. The unit is degree. West longitude is defined as negative starting with minus “-” and east longitude is defined as positive without “+”.  : The latitude of a point which is defined as the centre of the Geo-Fence circular region. The format is “(-)xx.xxxxxx” and the value range is from “-90.000000” to “90.000000”. The unit is degree. South Latitude is defined as negative starting with minus “-” and north Latitude is defined as positive without “+”.  : The radius of the Geo-Fence circular region. The value range is (50-6000000) and the unit is meter.  : The interval of GPS checking for the Geo-Fence alarm.  :  0: It should report when get the state first time.  1: It doesn’t report until the state changes. Note: If the parameter is set as 0, will be set as 0 automatically (To Geo-Fence 0, will be restored at first and it could be used later when switch on Geo-Fence 0 via Function Key), because the terminal doesn’t know when to check Geo-Fence if the parameter is 0. The acknowledgement message of AT+GTGEO command: TRACGL300AN001 - 28 - GL300 @Tracker Air Interface Protocol  +ACK:GTGEO, Example: +ACK:GTGEO,1A0102,135790246811220,,0,0008,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 GEO ID 1 0–4 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ 3.2.9. Default k n i l l c a i e t u n Q fide n o C $ Speed Alarm The AT+GTSPD command is used to configure speed alarm of the device. Based on the working mode set, the device will report speed alarm when its speed is outside or inside of a predefined range.  AT+GTSPD= Example: AT+GTSPD=gl300,1,5,40,30,60,,,,,,,,,,,,,,,,0009$ AT+GTSPD=gl300,2,0,80,30,60,,,,,,,,,,,,,,,,0009$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 1 0|1|2 0 Min speed <=3 0 – 400km/h 0 Max speed <=3 0 – 400km/h 0 Duration <=4 15 – 3600sec 60 Send interval <=4 0|5 – 3600sec 300 Reserved 0 Mode Reserved Reserved Reserved Reserved 0 0 0 0 Reserved 0 Reserved 0 Reserved 0 Reserved 0 Reserved 0 Reserved 0 TRACGL300AN001 - 29 - GL300 @Tracker Air Interface Protocol Reserved 0 Reserved 0 Reserved 0 Reserved 0 Serial number 4 0000 – FFFF Tail character 1 $ $  : A numeric to indicate the working mode of speed alarm.  0: Disable speed alarm.  1: Enable speed alarm. If the current speed is within the speed range defined by min speed and max speed, a speed alarm is sent.  2: Enable speed alarm. If the current speed is outside the speed range defined by min speed and max speed, a speed alarm is sent.  : The lower limit of the speed range.  : The upper limit of the speed range.  : According to the working mode, if the speed satisfies the specified speed range and maintains a period of time defined by , the speed alarm will be triggered.  : After the speed alarm is triggered, the speed alarm message is sent every interval time, but when the send interval is set to 0, the speed alarm message will be sent only once. Note: The parameter and are invalid when GPS doesn’t open always. When GPS doesn’t open always, it will report speed alarm immediately if it detects the speed of the terminal is out of the allowed speed range. k n i l l c a i e t u n Q fide n o C The acknowledgement message of AT+GTSPD command:  +ACK:GTSPD, Example: +ACK:GTSPD,1A0102,135790246811220,,0009,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ Default $ 3.2.10. Function Key Setting The AT+GTFKS command is used to configure the function of the power key and the function key. TRACGL300AN001 - 30 - GL300 @Tracker Air Interface Protocol  AT+GTFKS= Example: AT+GTFKS=gl300,1,,1,1,1,,,ffff$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 Power key mode 1 0|1|2 1 Full power up 1 0|1 1 Function key mode 1 0|1|2|3 3 Power key ind 0 0|1 0 Function key ind 0 0|1 0 Reserved 0 Reserved k n i l l c a i e t u n Q fide n o C 0 Serial number 4 0000 – FFFF Tail character 1 $     $ : A numeric to indicate the working mode of the power key.  0: Press power key will not power down the device.  1: Press power key will power down the device.  2: Press power key after long press for 1.5 seconds, it will work as SOS mode. : A numeric to indicate whether the terminal powers on completely after the terminal was power on because of charger inserted.  0: Do not power on the terminal completely. And the terminal will only work on charging.  1: Power on the terminal completely. The terminal will work normally as power on by power key long pressed. : The working mode for the function key operation..  0: Ignore the function key operation.  1: Geo-Fence mode. Switch on/off the Geo-Fence ID 0 when the function key is long pressed. And after long press the function key, the terminal will report the message +RESP:GTSWG to inform to switch on or off Geo-Fence ID 0 via this operation.  2: Geo-Fence in current position. Switch on/off the Geo-Fence 0 when the function key is long pressed and use the current position as the centre of Geo-Fence 0 when switch on the Geo Fence 0 via the function key. After long press the function key, the terminal will report the message +RESP:GTSWG immediately. And if this operation is expected to switch on Geo-Fence ID 0, the terminal will start GPS fixing to get the current position as the centre of Geo-Fence ID 0. After GPS fixing finishes, it will report the message +RESP:GTGCR to inform the result of GPS fixing and whether Geo-Fence ID 0 was switched on successfully.  3: SOS mode. After long press for 3 seconds, the device will report the current position according to the result of the latest GPS fixing and then start GPS fixing. After the GPS fixing finishes or timeout, the device will report the SOS message according the result of the GPS fixing. : A numeric to indicate the working mode of the motor for power key.  0: Disable drive the motor when the power key is long pressed TRACGL300AN001 - 31 - GL300 @Tracker Air Interface Protocol   1: Drive the motor vibration when the power key is long pressed to power off : A numeric to indicate the working mode of the motor for function key.  0: Disable drive the motor when the function key is long pressed  1: Drive the motor vibration when the function key is long pressed The acknowledgement message of AT+GTFKS command:  +ACK:GTFKS, Example: +ACK:GTFKS,1A0102,135790246811220,,000A,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ Default k n i l l c a i e t u n Q fide n o C $ 3.2.11. Real Time Operation The AT+GTRTO command is used to retrieve information from the terminal or control the terminal.  AT+GTRTO= Example: AT+GTRTO=gl300,0,,,,,,000B$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 Sub command 1 0–F Single Configuration Command 3 Reserved 0 Reserved Reserved Reserved 0 0 0 Serial number 4 0000 – FFFF Tail character 1 $  $ : A numeric to indicate the sub command to execute. 0: (GPS): Request GPS related information, including setting of , , of fixed report, GPS antenna type, GPS antenna status and the last known time of successful GPS fixing. TRACGL300AN001 - 32 - GL300 @Tracker Air Interface Protocol  1: (RTL): Request the device to report its current position. 2: (READ): Request the device to report its entire configuration. 3: (REBOOT): Reboot the device remotely. 4: (RESET): Reset all parameters to factory default except parameter of AT+GTBSI, AT+GTSRI, AT+GTTMA. 5: (PWROFF): Power off the device remotely. 6: (CID): Request the device to report the ICCID of the installed SIM card. 7: (CSQ): Request the device to report the current GSM signal level. 8: (VER): Request the device to report version information including the device type, the firmware version and the hardware version. 9: (BAT): Request the device to report power supply related information including the external power supply status, current voltage of the battery, the battery charging status and the working mode of LED. A: (TMZ): Request the device to report the time zone setting. B: (INF): Read the device information report function. The corresponding information will be reported via the message +RESP:GTINF. C: (RESERVED) D: (RESERVED) E: (GSV): Request the device to report the GPS fix level. F: (GSM): Request the device to report the cells’ information. : Get the specified command configuration of the terminal via the message +RESP:GTALS. For example, it is OK to get the configuration of AT+GTCFG by the command “AT+GTRTO=gl300,2,CFG,,,,,000F$”. NOTE: This parameter is available only when is set to 2. If the parameter is default, the terminal will report all configuration via the message +RESP:GTALL. k n i l l c a i e t u n Q fide n o C The acknowledgement message of AT+GTRTO command:  +ACK:GTRTO, Example: +ACK:GTRTO,1A0102,135790246811220,,GPS,000B,20100310172830,11F0$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Sub command <=6 Sub command string Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ Default $ 3.2.12. White Call List Configuration The AT+GTWLT command is used to set white call list table. TRACGL300AN001 - 33 - GL300 @Tracker Air Interface Protocol  AT+GTWLT= Example: AT+GTWLT=gl300,1,1,2,13813888888,13913999999,,,,,000C$ Parameter Length(byte) Range/format password 4~6 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ call filter 1 0|1|2 mobile start mobile end 1 1 white number list <=20*10 reserved 0 reserved 0 reserved 0 reserved    1-10 1-10 k n i l l c a i e t u n Q fide n o C Serial number Tail character  Default gl300 1 0 4 1 0000 – FFFF $ : A numeric to indicate whether to filter the incoming call according to and before it tries to send google link SMS to the incoming number.  0: Do not return a google link SMS to incoming number no matter what the parameter was set and no matter whether the incoming number is in the or .  1: Do not filter the incoming call. It will return a google link SMS to the incoming number as long as the parameter was set as 1.  2: Filter the incoming call. If the incoming number isn’t in or , it won’t return a google link SMS to the incoming number even if the parameter was set as 1. : A numeric to indicate the first index of the white call number to input. For example, if it is 1, it will update the white call list from the 1st one. If it is empty, it should not include later. : A numeric to indicate the last index of the white call number to input. For example, if it is 2, it will update the white call list until the 2nd one. If it is empty, it should not include later. : A phone number list. It could include several phone numbers. And two close phone numbers are separated with ",". The number of the phone number in the list is up to the parameter and . For example, if is 1 and is 2, the should include 2 phone numbers and the two numbers are separated with ",". The acknowledgment message of the AT+GTWLT command:  +ACK:GTWLT, Example: +ACK:GTWLT,1A0102, 135790246811220,,000C,20101029085505,0025$ Parameter TRACGL300AN001 Length (byte) Range/Format Default - 34 - GL300 @Tracker Air Interface Protocol Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ $ Note: It is necessary to make sure the total size of the command is not greater than 160 if it is sent via SMS. k n i l l c a i e t u n Q fide n o C 3.2.13. Google link SMS configuration The AT+GTGLM command is used to configure whether to send SMS with google link for SOS and GEO event.  AT+GTGLM= Example: AT+GTGLM=gl300,1,1,2,13813888888,13913999999,,,,,000D$ Parameter Length(byte) Range/format password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ google mode 1 0|1|2 mobile start mobile end 1 1 direct number list <=20*3 reserved 0 reserved reserved reserved Serial number Tail character   Default gl300 0 1-3 1-3 0 0 0 4 1 0000 – FFFF $ : A numeric to indicate whether to send a SMS with google link to the number in for SOS and GEO event.  0: Do not send a SMS with google link to the number is in the for SOS and GEO event.  1: Send a SMS with google link to the number is in the for SOS and GEO event and include the terminal name in the google hyperlink.  2: Send a SMS with google link to the number is in the for SOS and GEO event and do not include the terminal name in the google hyperlink. : A numeric to indicate the first index of the direct number to input. For example, if it is 1, it will update the direct number list from the 1st one. If it is empty, it TRACGL300AN001 - 35 - GL300 @Tracker Air Interface Protocol   should not include later. : A numeric to indicate the last index of the direct number to input. For example, if it is 2, it will update the direct number list until the 2nd one. If it is empty, it should not include later. : A phone number list. It could include several phone numbers. And two close phone numbers are separated with ",". The number of the phone number in the list is up to the parameter and . For example, if is 1 and is 2, the should include 2 phone numbers and the two numbers are separated by with ",". The acknowledgment message of the AT+GTGLM command:  +ACK:GTGLM, k n i l l c a i e t u n Q fide n o C Example: +ACK:GTGLM,1A0102, 135790246811220,,000D,20101029085505,0025$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ Default $ 3.2.14. Auto unlock SIM-PIN The AT+GTPIN command is used to configure whether to automatically unlock the PIN of the SIM card in the device.  AT+GTPIN= Example: AT+GTPIN=gl300,1,1234,1,,,,,000E$ Parameter Length(byte) password 4~6 auto unlock PIN 1 Range/format ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ 0|1 Default gl300 1 PIN PIN checking 4-8 1 ‘0’-‘9’ 0|1 0 reserved 0 reserved 0 reserved 0 reserved 0 Serial number Tail character 4 1  0000 – FFFF $ : A numeric to indicate whether to unlock the SIM-PIN for the device. TRACGL300AN001 - 36 - GL300 @Tracker Air Interface Protocol    0: Do not unlock SIM-PIN automatically.  1: Each time the device powers on, it will detect whether the SIM card is locked with a PIN. If it is locked, the device will unlock the PIN automatically for one time. : The PIN code which is used when unlocks PIN automatically. If it is empty, the PIN code saved in the device will be cleared. : A numeric to indicate whether to lock the device with SIM-PIN.  0: Do not lock the SIM-PIN.  1: Lock the SIM-PIN. The acknowledgment message of the AT+GTPIN command:  +ACK:GTPIN, k n i l l c a i e t u n Q fide n o C Example: +ACK:GTPIN,1A0102, 135790246811220,,000E,20101029085505,0027$ Parameter Length (byte) Range/Format Default Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ $ Example: AT+GTDIS=gl300,1,1,5,,,,,,0010$ Parameter Length(byte) password 4~6 Input ID 1 Range/format ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ 1 Default gl300 1 Mode 1 0|1|2|3 Debounce time reserved <=2 0 0-20 (×10ms) 0 5 reserved 0 3.2.15. Digital Input Port Settings  AT+GTDIS reserved reserved 0 0 reserved 0 Serial number Tail character 4 1  0000 – FFFF $ : The ID of the digital input. It is always 1. If the filed is empty, the device will ignore the following settings about the digital input 1, i.e. change nothing about the digital input 1. TRACGL300AN001 - 37 - GL300 @Tracker Air Interface Protocol   : A numeric to check whether to enable the digital input.  0: Disable the digital input, i.e. ignore the status changing of the digital input.  1: Enable the digital input. If the status of the input change, the device will report the message +RESP:GTDIS to the backend server to inform the latest status.  2: If the status of the input is changed to 0, the device will disable the sleep mode. If the status of the input is changed to 1, the device will enable the sleep mode.  3: If the status of the input is changed to 0, it will trigger the SOS event. : The time for debouncing. The acknowledgment message of the AT+GTDIS command:  +ACK:GTDIS, k n i l l c a i e t u n Q fide n o C Example: +ACK:GTDIS,1A0102,135790246811220,,0010,20101029085505,0028$ Parameter Length (byte) Range/Format Protocol version 6 XX0000 – XXFFFF, X∈{'A'-'Z','0'-'9'} Unique ID 15 IMEI Device name 20 Serial number 4 0000 – FFFF Send time 14 YYYYMMDDHHMMSS Count number 4 0000 – FFFF Tail character 1 $ Default $ 3.2.16. Protocol watchdog The AT+GTDOG command is used to reboot the device in a time based manner or upon ignition. This helps the device avoid working in an exceptional status for a long time. Besides these two automatically reboot method, the device also supports to use the digital input to trigger the reboot manually.  AT+GTDOG= Example: AT+GTDOG=gl300,1,,1,0130,,1,1,,,,,0011$ AT+GTDOG=gl300,2,30,,,,1,1,,,,,0011$ Parameter Length (byte) Range/Format Default Password 4–6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl300 Mode 1 0|1|2 0 Ignition Frequency <=3 10-120 60 Interval <=2 1-30 30 Time 4 HHMM 0200 Reserved 0 Report Before Reboot 1 0|1 1 TRACGL300AN001 - 38 - GL300 @Tracker Air Interface Protocol Input ID 1 0|1 0 Unit 1 0|1 0 Gsm interval 4 0|5-1440min 60min Pdp interval 4 0|5-1440min 60min Reserved 0 Serial number 4 0000 – FFFF Tail character 1 $       $ : Working mode.  0: Disable this function  1: Reboot periodically according to the and