advertisement
GSM/GPRS/GPS Tracker
GL500
@Track Air Interface Protocol
Application Notes: TRACGL500AN002
Revision: 1.06
[email protected]
GL500 @Tracker Air Interface Protocol
Document Title
Version
Date
Status
GL500 @Tracker Air Interface Protocol
1.06
20130830
Release
Document Control ID
TRACGL500AN002
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
Queclink model or design. All specification supplied herein are subject to change without notice at any time.
Copyright © Queclink Wireless Solutions Co., Ltd. 2012
Confidential
TRACGL500AN002
- 1 -
GL500 @Tracker Air Interface Protocol
Contents
3.3.6. Acknowledgment For Simple SMS Command .................................................... 37
TRACGL500AN002
- 2 -
GL500 @Tracker Air Interface Protocol
Table Index
Queclink
Confidential
TRACGL500AN002
- 3 -
GL500 @Tracker Air Interface Protocol
Figure Index
Queclink
Confidential
TRACGL500AN002
- 4 -
GL500 @Tracker Air Interface Protocol
0. Revision history
V1.03
V1.04
V1.05
V1.06
Author Description of change Revision Date
V1.01
V1.02
2012-09-18 Andy Wang
2012-11-19 Andy Wang
2013-3-9 Andy Wang
2013-5-7 Andy Wang
@Tracker Air Interface Protocol Initial
1)
Add the temperature alarm report function and the alarm report message +RESP:GTTEM.
2)
Change the definition of <Report destination
mode> at AT+GTGBC.
1)
Change the length of <device name> to10.
2)
Modify the expression of <Report destination
mode>
3)
Add three parameters < APN >,<APN user
name >,< APN password > to BSR command.
4)
Change the Simple SMS Message Format, in order to limit the SMS message length less than 160.
1)
Add new command AT+GTPIN to configure the auto-unlock PIN function.
2013-6-17 Arthur Li
2013-8-30 Arthur Li
1) Modify the send interval minimum value to 1 in GTCTN.
Queclink
Confidential
TRACGL500AN002
- 5 -
GL500 @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.
1.2. Terms and Abbreviations
Table 1: Terms and abbreviations
GSM
HDOP
ICCID
IP
SMS
TCP
UDP
UTC
Abbreviation Description
APN
Access Point Network
ASCII
GPRS
American National Standard Code for Information Interchange
General Packet Radio Service
Global System for Mobile Communications
Queclink
Short Message Service
Transmission Control Protocol
User Datagram Protocol
Coordinated Universal Time
Confidential
TRACGL500AN002
- 6 -
GL500 @Tracker Air Interface Protocol
2. System Architecture
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
Queclink
Confidential
TRACGL500AN002
- 7 -
GL500 @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
AT+GTXXX=<parameter1>,<parameter2>,…$
+ACK:GTXXX,<parameter1>,<parameter2>,…$
+RESP:GTXXX,<parameter1>,<parameter2>,…$
Message type
Command
Acknowledgement
Report
The entire message string ends with character ‘$’.
The characters ‘XXX’ identify the deferent message.
The “<parameter1>,<parameter2>,…” 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.
Queclink
Command
Terminal
Confidential
Report
Report
Figure 2 : @Tracker protocol messages flow
TRACGL500AN002
- 8 -
GL500 @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+GTGBC=gl500,,,,,,,,10111111111110,,,,1,15,,,,,1,,,,,0005$AT+GTGEO=gl500,0,3,101.412
248,21.187891,,15,,,,,,,,,0008$AT+GTWLT=gl500,0,1,1,13813888888,,,,,000C$
It includes three commands (AT+GTGBC, AT+GTGEO and AT+GTWLT) 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.
+ACK:GTGBC,110102,135790246811220,,0,0005,20100310172900,1152$
+ACK:GTGEO,110102,135790246811220,,0,0008,20100310172900,1153$
+ACK:GTWLT,110102,135790246811220,,0,000C,20100310172900,1154$
Queclink
Confidential
TRACGL500AN002
- 9 -
GL500 @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=gl500,cmnet,,,3,,,116.226.44.17,9001,116.226.44.16,9002,,0,1,,,0001$
Parameter Length (byte) Range/Format Default
Password
APN
APN user name
APN password
4 – 6
<=40
<=30
<=30
‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ gl500
Report mode
Reserved
1
0
0 – 5 5
Buffer enable
Main server IP/domain
1
<=60
0|1 1 name
Main server port
Backup server IP
Backup server port
<=5
<=15
<=5
0 – 65535
0 – 65535
0
0.0.0.0
0
SMS Gateway
Heartbeat interval
SACK enable
<=20
<=3
1
0|5 – 360min
0|1
5
0
Reserved 0
Reserved
Serial number
Tail character
0
4
1
0000 – FFFF
$ $
<Password>: The valid character of password is ‘0’-9’, ‘a’-‘z’, ‘A’-‘Z’. The default value is
“gl500”.
<APN>: Access point name (APN).
<APN user name>: the GPRS APN user name. If the parameter field is empty, the parameter will be cleared.
<APN password>: the GPRS APN password. If the parameter field is empty, the parameter will be cleared.
<Report mode>: Supports report modes as following:
0: Stop reporting.
1: TCP short-connect preferred 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
TRACGL500AN002
- 10 -
GL500 @Tracker Air Interface Protocol
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 <Buffer enable>) 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
<Reserved>: Not used at present. Please keep empty.
<Buffer enable>: Enable or disable BUFFER function. Please refer to 3.4.5 for the details
about BUFFER function.
0 Disable the BUFFER function.
1 Enable the BUFFER function.
Queclink
<SMS Gateway>: Maximum 20 characters including the optional national code starting with
“+” for SMS messages sending. Short code (for example: 10086) is also supported.
<Heartbeat interval>: the interval for the terminal to send heartbeat package message to the
backend server. If set to 0, no heartbeat package is sent.
Confidential
1: the backend server should reply SACK message after receiving a message from the device.
<Serial number>: the serial number for the command. It will be invoked in the ACK message of the command.
<Tail character>: a character to indicate the end of the command. And it should be “$”.
Note:
If <Report mode> is set as 4 (UDP mode), it is strongly recommended to enable SACK or heart beat mechanism (<Heartbeat interval> doesn’t equal to 0).
TRACGL500AN002
- 11 -
GL500 @Tracker Air Interface Protocol
The acknowledgement message of AT+GTQSS command:
+ACK:GTQSS,
Example:
+ACK:GTQSS,110102,135790246811220,,0001,20100310172830,11F0$
Parameter
Protocol version
Length (byte) Range/Format
6 XX0000 – XXFFFF,
15
X∈{'A'-'Z','0'-'9'}
IMEI Unique ID
Device name
Serial number
Send time
Count number
Tail character
10
4
14
4
1
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
$
Default
$
<Protocol version>: The combination of the device type and the version number of the applied protocol. The first two characters ‘XX’ indicate the device type. ‘11’ represents
GL500. 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.
<Unique ID>: ID of the device, use the IMEI of the current SIM card inside the terminal.
<Device name>: Please refer to the parameter <Device name> in the command
AT+GTGBC. is for.
Queclink message and report message. The count is beginning from 0000 and increases by 1 every time. It will roll back after “FFFF”.
Confidential
TRACGL500AN002
- 12 -
GL500 @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=gl500,cmnet,,,,,,,0002$
Parameter
Password
APN
APN user name
Length (byte)
4 – 6
<=40
<=30
Range/Format
‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’
APN password
Reserved
Reserved
Reserved
Reserved
Serial number
Tail character
<=30
0
0
0
0
4
1
0000 – FFFF
$ $
Default
gl500
The acknowledgement message of AT+GTBSI command:
+ACK:GTBSI,
Example:
+ACK:GTBSI,110102,135790246811220,,0002,20100310172830,11F0$
Parameter
Protocol version
Queclink
Unique ID
Device name
15
10
IMEI
Serial number
Send time
Count number
Tail character
4
14
4
1
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
$ $
TRACGL500AN002
- 13 -
GL500 @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=gl500,3,,,116.226.44.17,9001,116.226.44.16,9002,,0,1,,,,,0003$
Parameter
Password
Report mode
Length (byte) Range/Format
4 – 6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’
1 0 – 5
Default
gl500
5
Reserved
Buffer enable
Main server IP/domain name
Main server port
Backup server IP
Backup server port
0
1
<=60
<=5
<=15
<=5
0|1
0 – 65535
0 – 65535
1
0
0.0.0.0
0
SMS Gateway <=20
Heartbeat interval <=3 0|5 – 360min 5
SACK enable
Reserved
Reserved
Reserved
Reserved
Serial number
Tail character
1
0
0
0
0
4
0|1
0000 – FFFF
0
Queclink
1 $ $
The acknowledgement message of AT+GTSRI command:
+ACK:GTSRI,
Example:
Parameter
Confidential
Protocol version
Unique ID
6
15
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
Device name
Serial number
Send time
Count number
Tail character
10
4
14
4
1
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
$ $
TRACGL500AN002
- 14 -
GL500 @Tracker Air Interface Protocol
3.2.4. Global Basic Configuration
The GBC command is used to configure the global basic parameters for terminal.
AT+GTGBC
Example:
AT+GTGBC=gl500,+8613585715149,GL500,,,003F,,,10101010101010,1400,12,2,1,15,10,1,1,
1,1,,2,,,00A5$
Parameter Length(byte) Range/Format Default
Password
Mobile Number
Device Name
New Password
4~8
<=20
<=10
4~8
‘0’-‘9’,’a’-‘z’,’A’-‘Z’
‘0’-‘9’
'0' – '9' 'a' – 'z' 'A' – 'Z''
‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl500
GL500
New Password
Event mask
Reserved
Reserved
4~8
<=4
0
0
‘0’-‘9’,’a’-‘z’,’A’-‘Z’
0000-1FFF 000F
Week Report Selection
Specified time of day
14
4 HHMM
10101010101010
1200
Interval hours wakeup <=2 1|2|3|4|6|8|12|24 24
Report frequency
Continuous Mode
Continuous Send interval
Battery Low Percent
<=2
1
<=4
<=2
1 – 24
0|1
0|1 – 1440min
0|5 - 20
1
0
5
5
Sensor enable 1 0|1 0
GSM Report 1
Report destination mode 1
Temperature report mode 1
0|1|2|3
0|1
0|1|2|3
0
0
0
Temperature range
AGPS Mode
Reserved
6
1
(‘+’or’-‘) LL (‘+’ or’-‘)
HH
0|2 0
Reserved
Serial Number
Tail Character
4
1
0000 – FFFF
$ $
<Reserved>: The parameter field is reserved.
<Mobile Number>: This mobile numbers can receive the simple SMS format message sent from the terminal and monitor the terminal.
<Device Name>: An ASCII string to represent the name of the device.
<New Password>,<New Password>: New password for the terminal, two <New Password> must be identical . NOTE: If the parameter is valid, next time your command must use this
TRACGL500AN002
- 15 -
GL500 @Tracker Air Interface Protocol
password replace the old password, this is very important. The valid character of password is
‘0’-9’, ‘a’- ‘z’, ‘A’-‘Z’. The default value is “gl500”.
<Event mask>: 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 bit2(0002): +RESP:GTBPL bit4(0004):
+RESP:GTTEM
bit5(0008):
+RESP:GTPDP
<Week Report Selection>: The selection of report mode for each day in one week, there are total seven groups as one group combination with two characters orderly, seven groups represent seven days of one week separately. The first two characters represent Sunday, and last two characters represent Saturday.
The first character of one group define whether the terminal report message to your mobile phone in this day of week, and the second character define whether the reported message contains GPS information when the first character set to 1.
Format the configuration 14 digits, zeros should be added.
E.g:11000000101011. Sunday and Saturday will report the message with GPS information, Monday, Tuesday and Wednesday will not report the message , Thursday and Friday report message without GPS information.
<Specified Time of Day>: The start time for terminal to wake up. The value range of “HH” is
Queclink
Time of Day> is 16:30, the first report message is tomorrow 16:30.
<Report frequency>: A numeric multiply the <interval hour wakeup> to get the
frequency(Unit: hour) to report the message +RESP:GTSTR. NOTE:
<Interval hour wakeup>
*
<Report frequency> should less than
24
. E.g. If the <report frequency> set as
Confidential into deep sleep mode.
Continuous mode: The terminal is always active. This allows you at any time to control the device and immediately receive ACK information from terminal.
0: power saving mode.
1: Continuous mode, fix GPS and report the message +RESP:GTCTN periodically with <Continuous send interval>.
<Continuous send interval>: The period to send the message +RESP:GTCTN when the <
Continuous Mode> is set as 1. The value range is :1-1440 and the unit is minute. If the value is set as ‘0’, it will not report the message.
TRACGL500AN002
- 16 -
GL500 @Tracker Air Interface Protocol
<Battery Low Percent>: If the battery percentage lower than this numeric, the terminal will report the message +RESP:GTBPL.
<Sensor enable>: Enable/Disable the sensor function. If the sensor enable, the terminal will enters the continuous mode and fix GPS and report the message +RESP:GTCTN periodically with <Continuous send interval> when it detects movement.
<GSM Report>: Control how or when to report cells’ information(including
+RESP:GTSTR,+RESP:GTCTN,+RESP:GTNMR and +RESP:GTRTL)
.
The message
+RESP:GTGSM only sends via TCP short connect even if the report mode is force on SMS.
0:
Not allow the cells’ information report.
1: Report the message +RESP: GTGSM after failed to get GPS position if cell’s information available.
2: Report the message +RESP: GTGSM after getting GPS position successfully every time if cell’s information available.
3: Report the message +RESP:GTGSM no matter what result of getting GPS position every time if cell’s information available.
<Report destination mode>: Select which destination the SMS message should report to. The mode is valid only when the <Report mode> in AT+GTQSS set as 5.
0: Report the SMS message to <
SMS Gateway
> define by AT+GTQSS.
1: Report the SMS message to <mobile number> defined in AT+GTGBC and the
CTN|GEO|NMR|STR|RTL|TEM|BPL will change to simple SMS report format.
<Temperature report mode >: The mode to report temperature alarm message
+RESP:GTTEM. The terminal check the temperature one time when wake up in power saving mode, and with <Continuous send interval> in the continuous mode.
Queclink temperature range.
3: Report the alarm message +RESP:GTTEM when the current temperature higher than the high temperature threshold defined by <temperature range >..
<temperature range >: The first 3 characters is means low temperature in the range, last 3
Confidential
<AGPS Mode>: A numeric to indicate whether to enable AGPS online. 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.
2: Enable the AGPS function.
<Serial Number>: the serial number for the command. It will be invoked in the ACK message of the command.
<Tail Character>: a character to indicate the end of the command. And it must be “$”.
The acknowledgement message of AT+GTGBC command:
TRACGL500AN002
- 17 -
Default
$
GL500 @Tracker Air Interface Protocol
+ACK:GTGBC,
Example:
+ACK:GTGBC,110102,135790246811220,,0,0008,20100310172830,11F0$
Parameter Length (byte) Range/Format
Protocol version 6
Unique ID
Device name
GEO ID
Serial number
Send time
Count number
Tail character
15
10
1
4
14
4
1
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
0 – 4
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
$
Queclink
Confidential
TRACGL500AN002
- 18 -
GL500 @Tracker Air Interface Protocol
3.2.5. 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.
AT+GTTMA=
Example:
AT+GTTMA=gl500,-,3,30,0,20090917203500,,,,,0006$
Parameter
Password
Length (byte)
4 – 6
Range/Format
‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’
Sign
Hour Offset
Minute Offset
Daylight Saving
1
<=2
<=2
1
+|-
0 - 23
0 - 59
0|1
Default
gl500
+
00
UTC Time
Reserved
Reserved
Reserved
14
0
0
0
YYYYMMDDHHMMSS
00
0
Reserved
Serial number
Tail character
0
4
1
<Hour Offset>: UTC offset in hours
0000 – FFFF
$
<Sign>: Indicate the positive or negative of the local time offset to UTC
$
<Minute Offset>: UTC offset in minutes
<Daylight Saving>: Enable/disable daylight saving time.
0: Disable daylight saving
1: Enable daylight saving
Confidential
+ACK:GTTMA,
Example:
+ACK:GTTMA,110102,135790246811220,,0007,20100310172830,11F0$
Parameter
Protocol version
Length (byte) Range/Format
6 XX0000 – XXFFFF,
15
X∈{'A'-'Z','0'-'9'}
IMEI
10
Default
Unique ID
Device name
TRACGL500AN002
- 19 -
GL500 @Tracker Air Interface Protocol
Serial number
Send time
Count number
Tail character
4
14
4
1
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
$ $
Queclink
Confidential
TRACGL500AN002
- 20 -
GL500 @Tracker Air Interface Protocol
3.2.6. Non movement detection
The AT+GTNMD command is used to configure the parameters for non movement detection.
This function works only when the <sensor enable> of AT+GTGBC is set as ‘1’.
AT+GTNMD=
Example:
AT+GTNMD=gl500,F,2,4,15,10,,,,0005$
Parameter
Password
Length (byte)
4 – 6
Range/Format
‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’ mode
Non-movement duration
Movement duration
1
<=3
0-F
1 – 200(
×15sec)
Movement threshold
Rest send interval
Reserved
Reserved
Reserved
Serial number
<=2
2
<=4
0
0
0
4
3 – 50(
×256ms)
5 – 25
0|1 – 1440min
0000 – FFFF
Default
gl500
0
2
4
10
10
Tail character
1 $ behave as the description. Otherwise, it won’t behave as the description.
$
Queclink
+RESP:GTCTN and Geo-Fence when it detects non-movement, then power off 5-minutes later.
Bit1(2): Report the message +RESP:GTNMR to the backend server when it detects non-movement. movement.
Confidential
<rest send interval> is set as ‘0’, it will not report the message. In the case, it will disable the function of Bit0 even if Bit0 is 1.
<Non-movement duration>: 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 <Non-movement duration>, the device will be considered as in non-movement status.
<Movement duration>: 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 <Movement duration>, the device will be considered as in movement status.
TRACGL500AN002
- 21 -
GL500 @Tracker Air Interface Protocol
<Movement threshold>: The threshold for the motion sensor to determine whether the device is in movement. The less, the more likely to be treated as movement.
<Rest send interval>: the send interval for the report of CTN when the device is in rest state if Bit3 of <mode> is 1.
The acknowledgement message of AT+GTNMD command:
+ACK:GTNMD,
Example:
+ACK:GTNMD,110102,135790246811220,,0005,20100310172830,11F0$
Parameter
Protocol version
Length (byte)
6
Range/Format
XX0000 – XXFFFF,
Unique ID 15
X∈{'A'-'Z','0'-'9'}
IMEI
Default
Device name
Serial number
Send time
Count number
10
4
14
4
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
1 $ $ Tail character
Queclink
Confidential
TRACGL500AN002
- 22 -
GL500 @Tracker Air Interface Protocol
3.2.7. White Call List Configuration
The AT+GTWLT command is used to set white call list table.
AT+GTWLT=
Example:
AT+GTWLT=gl500,0,1,2,13813888888,13913999999,,,,,000C$
Parameter
password call filter
Length(byte)
4~8
1
Range/format
‘0’-‘9’,’a’-‘z’,’A’-‘Z’
0|1|2
Default
gl500
0 mobile start mobile end
1
1
1-10
1-10 white number list <=20*10 reserved 0 reserved 0 reserved 0 reserved 0
Serial number
Tail character
4
1
0000 – FFFF
$
<call filter>: A numeric to indicate whether to filter the incoming call.
0: Only the <Mobile Number> predefined at AT+GTGBC can be connected by the terminal.
1: Both the <Mobile Number> defined by AT+GTGBC and phone number list in
Queclink not include <white number list> later.
<mobile end>: 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 <white number list> later.
Confidential numbers are separated by with ",".
The acknowledgment message of the AT+GTWLT command:
+ACK:GTWLT,
Example:
+ACK:GTWLT,020102, 135790246811220,,000C,20101029085505,0025$
Parameter Length (byte) Range/Format Default
TRACGL500AN002
- 23 -
GL500 @Tracker Air Interface Protocol
Protocol version 6
Unique ID
Device name
Serial number
Send time
Count number
Tail character
15
10
4
14
4
1
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
$ $
Note:
It is necessary to make sure the total size of the command is not greater than 160 if it is sent via SMS.
Queclink
Confidential
TRACGL500AN002
- 24 -
GL500 @Tracker Air Interface Protocol
3.2.8. 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 geo-fencing 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=gl500,0,3,101.412248,21.187891,1000,15,,,,,,,,,0008$
Parameter Length (byte) Range/Format
Password
GEO ID
Report Mode
Longitude
Latitude
Radius
Check interval
Reserved
4 – 6
1
1
<=11
<=10
<=7
<=4
0
‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’
0 – 4
0 – 3
(-)xxx.xxxxxx
(-)xx.xxxxxx
50 – 6000000m
0|5 – 1440 min
Default
gl500
0
50
Reserved
Reserved
0
0
0
Reserved
Reserved
Reserved
Reserved
Reserved
Serial number
Tail character
0
0
0
0
0
4 0000 – FFFF
Queclink
1 $ $
<GEO ID>: A numeric to identify the Geo-Fence.
<Report Mode>: A numeric which indicates when to report the notification to the backend
Confidential
3: Reports when enters or leaves the Geo-Fence
<Longitude>: 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 “+”.
<Latitude>: 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 “+”.
TRACGL500AN002
- 25 -
GL500 @Tracker Air Interface Protocol
<Radius>: The radius of the Geo-Fence circular region. The value range is (50-6000000) and the unit is meter.
<Check interval>: The interval of GPS checking for the Geo-Fence alarm.
Note:
If the parameter <Check interval> is set as 0, <Mode> will be set as 0 automatically.
The acknowledgement message of AT+GTGEO command:
+ACK:GTGEO,
Example:
+ACK:GTGEO,110102,135790246811220,,0,0008,20100310172830,11F0$
Parameter Length (byte) Range/Format Default
Protocol version 6
Unique ID
Device name
GEO ID
Serial number
15
10
1
4
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
0 – 4
0000 – FFFF
Send time
Count number
Tail character
14
4
1
YYYYMMDDHHMMSS
0000 – FFFF
$ $
Queclink
Confidential
TRACGL500AN002
- 26 -
GL500 @Tracker Air Interface Protocol
3.2.9. Real Time Operation
The AT+GTRTO command is used to retrieve information from the terminal or control the terminal.
AT+GTRTO=
Example:
AT+GTRTO=gl500,1,,,,,,000B$
Parameter
Password
Sub command
Length (byte)
4 – 6
1
3
Range/Format
‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’
0 – F
Single Configuration
Command
Reserved
Reserved
Reserved
0
0
0
Default
gl500
Reserved
Serial number
Tail character
0
4
1
0000 – FFFF
$ $
<Sub command>: A numeric to indicate the sub command to execute.
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 (TMZ): Get the time zone settings via message +RESP:GTTMZ.
9 (DIF): Request the device to report device information.
Confidential the command “AT+GTRTO=gl500,2,NMD,,,,,000F$”. NOTE: This parameter is available only when <Sub Command> is set to 2.
The acknowledgement message of AT+GTRTO command:
+ACK:GTRTO,
Example:
+ACK:GTRTO,110102,135790246811220,,GPS,000B,20100310172830,11F0$
Parameter Length (byte) Range/Format Default
TRACGL500AN002
- 27 -
GL500 @Tracker Air Interface Protocol
Protocol version
Unique ID
Device name
Sub command
Serial number
Send time
Count number
Tail character
6
15
10
<=6
4
14
4
1
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
Sub command string
0000 – FFFF
YYYYMMDDHHMMSS
0000 – FFFF
$ $
Queclink
Confidential
TRACGL500AN002
- 28 -
GL500 @Tracker Air Interface Protocol
3.2.10. Auto-unlock PIN
The command AT+GTPIN is used to configure the auto-unlock PIN function of the device.
Some operators offer SIM card with PIN code protection by default. To make the device work with the PIN-protected SIM card, use this command to let the device auto-unlock the SIM PIN with the pre-set PIN code.
AT+GTPIN=
Example:
AT+GTPIN=gl500,1,0000,,,,,,0010$
Parameter Length(byte) Range/Format Default
Password 4 – 6
Enable Auto-unlock PIN 1
PIN
Reserved
Reserved
4 – 8
0
0
'0' – '9' 'a' – 'z' 'A' – 'Z'
0|1
'0' – '9' gl500
0
Reserved 0
Reserved
Reserved
Serial Number
Tail Character
0
0
4
1
0000 – FFFF
$ $
<Enable Auto-unlock PIN>: 1 to enable the auto-unlock PIN function, 0 to disable.
<PIN>: Code used to unlock the SIM PIN.
Example:
Confidential
+ACK:GTPIN,110104,135790246811220,,0010,20090214093254,11F0$
Parameter Length(byte) Range/Format Default
XX0000 – XXFFFF, X∈{‘A’
– ‘Z’,’0’ – ‘9’}
Protocol Version 6
Unique ID
Device Name
Serial Number
15
<=20
4
IMEI
'0' – '9' 'a' – 'z' 'A' – 'Z' '-' '_' '?'
0000 – FFFF
TRACGL500AN002
- 29 -
GL500 @Tracker Air Interface Protocol
Send Time 14 YYYYMMDDHHMMSS
Count Number
Tail Character
4
1
0000 – FFFF
$ $
Queclink
Confidential
TRACGL500AN002
- 30 -
GL500 @Tracker Air Interface Protocol
3.3. Simple SMS Command and Acknowledgement
All the following commands is a part of AT+GTXXX protocol command both function and parameters which only be sent with SMS. All simple SMS command has same format, which differ from AT+GTXXX protocol format, as following:
Format: Password,XXX,Parameter1,…
NOTE: If the command you send to terminal with wrong password, the terminal will not respond acknowledge to the mobile number.
Queclink
Confidential
TRACGL500AN002
- 31 -
GL500 @Tracker Air Interface Protocol
3.3.1. CFG
This simple SMS command is a part of AT+GTGBC and AT+GTTMA command, you can modify the parameters: <Mobile Number>, <Device Name>,< New Password>, <Offset time> and
< UTC Time >.
CFG
Example: gl500,CFG,+8613502148756,MYGL500,123456,123456,+0800,20120315152500
Parameter Length (byte) Range/Format Default
Password
Mobile Number
Device Name
New Password
New Password
Offset time
<=20
<=10
4~8
4~8
5
‘0’-‘9’
'0' – '9' 'a' – 'z' 'A' – 'Z''
‘0’-‘9’,’a’-‘z’,’A’-‘Z’
‘0’-‘9’,’a’-‘z’,’A’-‘Z’
-|+HHMM gl500
UTC Time 14 YYYYMMDDHHMMSS
<Offset time >: The offset time compares with UTC time.
Queclink
Confidential
TRACGL500AN002
- 32 -
GL500 @Tracker Air Interface Protocol
3.3.2. REP
This simple SMS command is a part of AT+GTGBC command, you can modify the parameters: <
Week Report Selection >, < Specified time of day > and < Interval hours report >.
REP
Example: gl500,REP,10101010101111,0930,2,3
Parameter
Password
Length (byte)
Week Report Selection 14
Range/Format Default
gl500
10101010101010
Specified time of day 4
Interval hours wakeup <=2
Report frequency <=2
HHMM
1|2|3|4|6|8|12|24
1 – 24
1200
24
1
Queclink
Confidential
TRACGL500AN002
- 33 -
GL500 @Tracker Air Interface Protocol
3.3.3. EME
This simple SMS command is a part of AT+GTGBC command, you can modify the parameters: <
Continuous Mode > and <Send interval>.
Example: gl500,EME,1,5
Parameter
Password
Continuous Mode
Send interval
Length (byte) Range/Format
1 0|1
<=4 0|1 – 1440min
Default
gl500
0
5
Queclink
Confidential
TRACGL500AN002
- 34 -
GL500 @Tracker Air Interface Protocol
3.3.4. TOW
This simple SMS command is a part of AT+GTNMD command, you can modify the parameters:
< Sensor enable >, < Report mode > and < Rest report interval>.
Example: gl500,TOW,1,F,5
Parameter
Password
Sensor enable
Report mode
Rest report interval
Length (byte)
1
1
<=4
Range/Format
0|1
0-F
0|1 -1440min
Default
gl500
0
0
10
Queclink
Confidential
TRACGL500AN002
- 35 -
GL500 @Tracker Air Interface Protocol
3.3.5. BSR
This simple SMS command is a part of AT+GTSRI command, you can modify the parameters: <
Report mode >, < APN >,< APN user name >,< APN password >,< Main server IP/domain name >,< Main server port > and < Heartbeat interval >.
Example: gl500,BSR,3,cmet,,,116.228.146.250,8029,8
Parameter
Password
Length (byte) Range/Format
Report mode
APN
APN user name
APN password
Main server IP/domain name
Main server port
Heartbeat interval
1
<=40
<=30
<=30
<=60
<=5
<=3
0 – 5
0 – 65535
0|1 – 360min
Default
gl500
0
0
0
Queclink
Confidential
TRACGL500AN002
- 36 -
GL500 @Tracker Air Interface Protocol
3.3.6. Acknowledgment For Simple SMS Command
After the terminal received a simple SMS command, it will send the acknowledgment with following format:
Example1:
Command Format Right:gl500,REP,10101010101111,0930,4
Example2:
Command Format Wrong, Please Check Again:gl500,TOW,1,5
Parameter Length (byte) Range/Format
Command result
Command string
Default
< Command result>: The string to explain the result of your command :
“Command Format Right:”
“Command Format Wrong, Please Check Again:”
< Command String >: The command string that you sent to the terminal, you should check the command string carefully if you receive “Command Format Wrong, Please Check
Again:”
Queclink
Confidential
TRACGL500AN002
- 37 -
GL500 @Tracker Air Interface Protocol
3.4. Report
3.4.1. Position Related Report
+RESP:GTCTN: report message of continuous mode.
+RESP:GTGEO: report of AT+GTGEO
+RESP:GTRTL: report of AT+GTRTO-RTL
+RESP:GTSTR: report message for specified time of day.
+RESP:GTNMR: non movement is detected by motion sensor, according to the setting of
AT+GTNMD
Example:
+RESP:GTCTN,110103,135790246811220,GL500,0,0,0,25.0,81,0,0.1,0,0.3,121.390875,31.1
64600,20130312183936,0460,0000,1877,0873,,,,20130312190551,0304$
+RESP:GTGEO,110103,135790246811220,GL500,3,1,0,25.1,100,2,0.1,0,5.7,121.390839,31.
164621,20130311080111,0460,0000,1877,0873,,,,20130311080112,00A7$
+RESP:GTNMR,110102,135790246811220,GL500,0,1,0,25.5,100,0,0.0,0,-3.3,121.391070,3
1.164352,20130311124937,0460,0000,1877,0873,,,,20130311130615,00F7$
MCC
Parameter Length (byte) Range/Format Default
Protocol version
Unique ID
Device name
Report ID
Report type
Movement status
Temperature
6
15
10
1
1
4
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9' '-' '_'}
IMEI
0 – 4
0|1
XX.X
Queclink
1 0|1|2
Battery percentage
GPS accuracy
Speed
Azimuth
Altitude
Longitude
GPS UTC time
3
<=2
<=5
<=3
<=8
<=11
14
0-100
0|1 – 50
0.0 – 999.9km/h
0 – 359
(-)xxxxx.x m
(-)xxx.xxxxxx
YYYYMMDDHHMMSS
Confidential
<=10 (-)xx.xxxxxx Latitude
4 0XXX
MNC
LAC
Cell ID
Reserved
Reserved
4
4
4
0
0
0XXX
XXXX
XXXX
TRACGL500AN002
- 38 -
GL500 @Tracker Air Interface Protocol
Reserved
Send time
Count number
Tail character
0
14
4
1
YYYYMMDDHHMMSS
0000 – FFFF
$ $
<Report ID>: ID of Geo-Fence in +RESP:GTGEO.
<Report type>: type of the report for +RESP:GTCTN, +RESP:GTSTR, +RESP:GTGEO and +RESP:GTNMR, 0 for other reports.
For +RESP:GTCTN
0: Triggered by command.
1: Triggered by movement.
For +RESP:GTGEO
0: exit the corresponding Geo-Fence.
1: enter the corresponding Geo-Fence.
For +RESP:GTNMR
0: The state of the device changed from motion to rest.
1: The state of the device changed from rest to motion.
For +RESP:GTSTR
0: Need to fix.
1: Not need to fix.
<Movement status>: The terminal movement status.
0:stillness
1:move
Queclink
<GPS accuracy>: The HDOP defined in NMEA0183. The range of value is 1 – 50. The smaller the value, the higher the precision. Different from NMEA0183, 0 here means no fix,
<Speed>: The speed from GPS.
while GPS accuracy between 0 and 1 is set to 1.
Confidential as negative starting with minus “-” and east longitude is defined as positive without “+”.
<Latitude>: The latitude of the current position. The format is “(-)xx.xxx” 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 “+”.
<GPS UTC time>: UTC time from GPS.
<MCC>: Mobile country code. It is 3 digits in length and ranges from 000-999.
<MNC>: Mobile network code. It is 3 digits in length and ranges from 000-999.
<LAC>: Location area code in hex format.
<Cell ID>: Cell ID in hex format.
TRACGL500AN002
- 39 -
GL500 @Tracker Air Interface Protocol
3.4.2. Report Simple SMS Message Format
This section defines the formats of the report simple SMS messages.
The following report message’s format and message header will be changed:
+RESP:GTCTN Change to CTN
+RESP:GTGEO Change to GEO
+RESP:GTRTL Change to RTL
+RESP:GTSTR Change to STR
+RESP:GTNMR Change to NMR
+RESP:GTTEM Change to TEM
+RESP:GTBPL Change to BPL
In order to reduce the length of one SMS message, we don’t report GPS information and Cell-ID at the same time. If the report SMS message with GPS information, it will report with the format of
Example1. If the current report SMS message without GPS information, it will report with the format of Example2, which predefined without GPS information report or GPS information need to report but there is no GPS fixing.
Example1:
GEO
GL500
31
99%
28.3C
UN
FX:1
55.8M
LO:117.198705
LA:31.845209
Queclink
CN:2565
0.0KM/H
20120914185035
Confidential
TRACGL500AN002
- 40 -
GL500 @Tracker Air Interface Protocol
Example2:
STR
GL500
91%
29.3C
MOV
FX:0
MCC:0460
MNC:0001
LAC:1877
CID:2B55
CN:2560
20120914185035
Parameter ABB Format Example
Report Type
STR|CTN|NMR|GEO|
RTL|TEM|BPL
STR
Device Name
<ID><State>
Battery Voltage
Temperature
%
C
GL500
80%
29.5C
MOV / STI / UN MOV Movement Status
Fixed result
MCC
MNC
LAC
Cell ID
FX: 0|1|2 1
MCC
MNC
LAC
CID
0XXX
0XXX
XXXX
XXXX
MCC:0460
MNC:0000
LAC:18d8
CID:6141
Longitude
Latitude
Altitude
Speed
Count number
Send time
LO:
LA:
CN:
KM/H
LO:121.412248
LA:31.222073
70.0M
60.5 KM/H
0000 – FFFF
YYYYMMDDHH
MMSS
CN:F36D
TRACGL500AN002
- 41 -
GL500 @Tracker Air Interface Protocol
Google Link Message
http://maps.google.c
om/maps?q=31.2220
73,121.354335
<Fixed result>: A numeric to indicate the GPS fixed result.
0:Need to fix, but fixed failed.
1:Need to fix, and fixed succeeded.
2:Not need to fix.
< ID>< State>: Only for GEO.
<ID>: ID of Geo-Fence
<State>:
0: exit the corresponding Geo-Fence.
1: enter the corresponding Geo-Fence.
Queclink
Confidential
TRACGL500AN002
- 42 -
GL500 @Tracker Air Interface Protocol
3.4.3. Report for Querying
These are the report of real time querying by command AT+GTRTO.
+RESP:GTDIF: The report for real time operation DIF
Example:
+RESP:GTDIF,020102,135790246811220,,GL500,0100,0101,20100214093254,11F0$
Parameter Length (byte) Range/Format Default
Protocol version
Unique ID
Device name
6
15
10
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
Device type
Movement status
Temperature
Battery percentage
Firmware version
Hardware version
10
1
4
3
4
4
‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’
0|1|2
XX.X
0-100
0000 – FFFF
0000 – FFFF
GL500
MCU version 4
Last GPS fix UTC 14 YYYYMMDDHHMMSS time
Send time
Count number
Tail character
14
4
1
YYYYMMDDHHMMSS
0000 – FFFF
$
<Device type>: A string represents the type of the device.
$
<Firmware version>: The firmware version. The first two characters point out the main
<Hardware version>: The hardware version. The first two characters point out the main
version and the last two characters point out the subsidiary version. For example: 010A means the version 1.10
Confidential
1.03
<Last GPS fix UTC time>: The UTC time of the latest successful GPS fixing.
TRACGL500AN002
- 43 -
GL500 @Tracker Air Interface Protocol
+RESP:GTALL: The report for real time operation READ
Example:
+RESP:GTALL,110102,868487002001121,MYGL500,BSI,cmnet,,,,,,,SRI,3,,1,116.228.146.
250,8085,192.0.0.0,0,18019992863,5,1,,,,,GBC,+8618019992863,MYGL500,000F,,,10101010
101111,0930,2,3,1,7,20,1,3,0,3,+20+20,2,,,TMA,+0800,0,,,,,NMD,F,2,4,10,5,,,,WLT,2,18055
169615,18019992863,18356001361,,,,,,,,,,,,GEO,0,2,117.200895,31.833078,50,5,,,,,,,,,1,1,117.
200895,31.833078,50,5,,,,,,,,,2,1,117.200895,31.833078,50,5,,,,,,,,,3,1,117.200895,31.833078,5
0,5,,,,,,,,,4,1,117.200895,31.833078,50,5,,,,,,,,,PIN,1,1234,,,,,,20000101000105,0025$
Parameter Length (byte) Range/Format Default
Protocol version 6
Unique ID
Device name
BSI
APN
15
10
3
<=40
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
BSI
APN user name
APN password
Reserved
Reserved
<=30
<=30
0
0
BSI
Reserved 0
SRI name
Reserved
Report mode
Reserved
Buffer enable
Main server IP/domain
Main server port
0
3
1
0
1
<=60
SRI
0 – 5
0|1
SRI
Queclink
<=5 0 – 65535
Backup server IP
Backup server port
SMS Gateway
Heartbeat interval
SACK enable
Reserved
Reserved
Reserved
<=15
<=5
<=20
<=3
1
0
0
0 – 65535
0|10 – 360min
0|1
Confidential
0
Reserved
GBC
Mobile Number
Device Name
Event mask
Reserved
0
3
<=20
<=10
<=4
0
GBC
‘0’-‘9’
'0' – '9' 'a' – 'z' 'A' – 'Z''
0000-1FFF
GBC
GL500
TRACGL500AN002
- 44 -
GL500 @Tracker Air Interface Protocol
Reserved 0
Week Report Selection 14
Specified time of day 4
Interval hours wakeup <=2
Report frequency
Continuous Mode
Continuous interval
Send
<=2
1
<=4
Battery Low Percent
Sensor enable
<=2
1
GSM Report 1
Report destination
1 mode
Temperature report
1 mode
Temperature range 6
AGPS Mode
Reserved
1
HHMM
1|2|3|4|6|8|12|24
1 – 24
0|1
0|5 – 1440min
0|5 - 20
0|1
0|1|2|3
0|1
0|1|2|3
(‘+’or’-‘) LL (‘+’ or’-‘) HH
0|2
Reserved
WLT
TMA 3 TMA TMA
NMD mode
Time Zone
Daylight Saving
Reserved
Reserved
Reserved
Reserved
5
1
0
0
0
0
1
-|+HHMM
0|1
0-F
Queclink
3 NMD NMD duration
Non-movement
Movement duration
Movement threshold
Move report interval
Reserved
Reserved
Reserved
<=3
<=2
<=2
<=3
0
0
3 – 200(
×30sec)
3 – 50(
×512ms)
5– 25
0|5 -360min
Confidential
0
3 WLT WLT call filter white number
Reserved
Reserved
Reserved
1
20*10
0
0
0
0|1|2
TRACGL500AN002
- 45 -
GL500 @Tracker Air Interface Protocol
Reserved
GEO
GEO ID0
Report mode
Longitude
Latitude
Radius
Check interval
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
GEO ID1
Report mode
Longitude
1
0
0
0
1
<=11
0
3
1
1
<=11
<=10
<=7
<=5
0
GEO
0
0 – 3
±xxx.xxxxxx
±xx.xxxxxx
50 – 6000000m
5 – 1440min
1
0 – 3
±xxx.xxxxxx
Latitude <=10 ±xx.xxxxxx
Radius
Check interval
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
<=7
<=4
0
0
0
0
50 – 6000000m
5 – 1440min
Queclink
1
GEO
0
Reserved
Reserved
GEO ID2
Report mode
1
1
2
0 – 3
2
Longitude
Latitude
<=11
<=10
±xxx.xxxxxx
±xx.xxxxxx
Radius
Check interval
Reserved
Reserved
<=7
<=4
0
0
50 – 6000000m
5 – 1440min
Reserved
Reserved
Reserved
Reserved
0
0
TRACGL500AN002
- 46 -
GL500 @Tracker Air Interface Protocol
Reserved
Reserved
GEO ID3
Report mode
Longitude
Latitude
Radius
Check interval
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
GEO ID4
Report mode
Longitude
0
0
0
1
0
1
<=11
1
1
<=11
<=10
<=7
<=4
3
0 – 3
±xxx.xxxxxx
±xx.xxxxxx
50 – 6000000m
5 – 1440min
4
0 – 3
±xxx.xxxxxx
Latitude <=10 ±xx.xxxxxx
Radius
Check interval
Reserved
Reserved
Reserved
Reserved
Reserved
Reserved
<=7
<=4
0
0
0
0
50 – 6000000m
5 – 1440min
Queclink
4
3
Reserved
Reserved
PIN
Enable Auto-unlock
PIN
3
1
PIN
0|1
PIN
PIN 4 – 8 '0' – '9'
Reserved
Reserved
Reserved
Reserved
0
0
0
0
Reserved
Send time
Count number
Tail character
0
14
4
1
YYYYMMDDHHMMSS
0000 – FFFF
$ $
TRACGL500AN002
- 47 -
GL500 @Tracker Air Interface Protocol
No matter what report mode is set, +RESP:GTALL is only reported through GPRS. If the current report mode is forcing on SMS, +RESP:GTALL will be reported via TCP short connection.
+RESP:GTCID: The report for real time operation CID
Example:
+RESP:GTCID,020102,135790246811220,,898600810906F8048812,20100214093254,11F0$
Parameter
Protocol version
Unique ID
Length (byte)
6
15
Range/Format
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
Default
Device name
ICCID
10
20
Send time
Count number
Tail character
Example:
14
4
1
YYYYMMDDHHMMSS
0000 – FFFF
$
+RESP:GTCSQ: The report for real time operation CSQ
$
Queclink
+RESP:GTCSQ,020102,135790246811220,,16,0,20100214093254,11F0$
Parameter Length (byte) Range/Format Default
Protocol version
Unique ID
Device name
CSQ RSSI
CSQ BER
Send time
Count number
6
15
10
<=2
<=2
4
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
0 – 31 | 99
0 – 7 | 99
0000 – FFFF
Confidential
14 YYYYMMDDHHMMSS
Tail character 1 $ $
+RESP:GTTMZ: The report for real time operation TMZ
Example:
+RESP:GTTMZ,020102,135790246811220,-0330,0,20100214093254,11F0$
Parameter Length
(byte)
Range/Format Default
TRACGL500AN002
- 48 -
GL500 @Tracker Air Interface Protocol
Protocol version
Unique ID
Device name
Time zone offset
Daylight saving
Send time
Count number
Tail character
6
15
10
5
1
14
4
1
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
±HHMM
0|1
YYYYMMDDHHMMSS
0000 – FFFF
$ $
Queclink
Confidential
TRACGL500AN002
- 49 -
GL500 @Tracker Air Interface Protocol
3.4.4. Event Report
The following event reports are triggered when certain event occurs.
+RESP:GTPNA: The terminal is activated.
+RESP:GTBPL: Battery low report
+RESP:GTTEM: Temperature alarm report.
+RESP:GTPDP: GPRS PDP connection report
+RESP:GTGSM: The report for the information of the service cell and the neighbour cells.
In +RESP:GTBPL and +RESP:GTTEM event reports, the last known GPS information and the current GSM network information are involved.
+RESP:GTPNA:
Example:
+RESP:GTPNA,020102,135790246811220,,20100214093254,11F0$
Parameter Length (byte) Range/Format Default
Protocol version 6
Unique ID
Device name
15
10
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
Power On Type
Send time
Count number
Tail character
1
14
4
1
1|2|4|5
YYYYMMDDHHMMSS
0000 – FFFF
$
<Power On Type>: The type for terminal is activated:
$
1:
The terminal detects movement to activate the terminal.
2: Specified time to activate the terminal..
4: First power on by manual.
5:Power on by RTO reboot command.
Example:
Parameter
Confidential
Protocol version 6 XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
Unique ID
Device name
Send time
Count number
Tail character
15
10
14
4
1
IMEI
YYYYMMDDHHMMSS
0000 – FFFF
$ $
TRACGL500AN002
- 50 -
GL500 @Tracker Air Interface Protocol
+RESP:GTBPL:
+RESP:GTTEM
Example:
+RESP:GTBPL,110102,135790246811220,GL500,2,25.0,4,0,0.5,0,0.1,121.390978,31.16452
9,20130228202357,0460,0000,1877,0873,,,,20130228202742,018B$+RESP:GTTEM,110102,
868487002001782,GL500,2,29.4,100,0,0.4,0,-0.5,121.390989,31.164601,20130225082440,04
60,0000,1877,0873,,,,20130225082536,009A$
Parameter Length (byte) Range/Format Default
Protocol version 6
Unique ID
Device name
Movement status
Temperature
Battery voltage percent
GPS accuracy
15
10
1
4
<=3
1
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
0|1|2
XX.X
0 - 100
0
Speed <=5 0.0 – 999.9km/h
Azimuth <=3 0 – 359
±XXXXX.X m
Altitude <=8
MCC
MNC
LAC
Cell ID
Last longitude
Last latitude
GPS UTC time
Reserved
<=11
<=10
14
4
4
4
0
±XXX.XXXXXX
±XX.XXXXXX
YYYYMMDDHHMMSS
0XXX
0XXX
XXXX
Queclink
4 XXXX
Reserved
Reserved
Send time
Count number
Tail character
0
0
14
4
1
YYYYMMDDHHMMSS
0000 – FFFF
$ $
<Last longitude>: The longitude of the last position. 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
“+”.
<Last latitude>: The latitude of the last position. 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 “+”.
TRACGL500AN002
- 51 -
GL500 @Tracker Air Interface Protocol
+RESP:GTGSM
Example:
+RESP:GTGSM,110102,135790246811220,CTN,0460,0000,1877,0871,27,,0460,0000,1806,31
52,27,,0460,0000,1806,2152,17,,0460,0000,1877,03A3,13,,,,,,,,,,,,,,0460,0000,1877,0873,31,,201
30316013544,034B$
Parameter
Protocol Version
Default
Unique ID
Length(byte) Range/Format
6
15
XX0000 – XXFFFF,
X∈{'A'-'Z','0'-'9'}
IMEI
Fix Type 3 STR|CTN |NMR| RTL
MCC1 4 0XXX
MNC1 4 0XXX
LAC1 4
LAC4
Cell ID1 4
MNC4
RX Level1 2 0-63
MCC4
Reserved
MCC2
MNC2
LAC2
Cell ID2
RX Level2
0
4
4
4
4
0XXX
0XXX
Queclink
2 0-63
MCC3
MNC3
LAC3
Reserved
RX Level3
0
4
4
4
2
0XXX
0XXX
0-63
Confidential
4 Cell ID3
Reserved 0
4 0XXX
4 0XXX
4
TRACGL500AN002
- 52 -
GL500 @Tracker Air Interface Protocol
Cell ID4 4
RX Level4 2 0-63
Reserved 0
MCC5 4 0XXX
MNC5 4 0XXX
LAC5 4
Cell ID5 4
RX Level5 2 0-63
Reserved 0
MCC6 4 0XXX
MNC6 4 0XXX
LAC6 4
Cell ID6 4
RX Level6 2 0-63
MCC
MNC
LAC
Cell ID
Reserved
RX Level
0
4
4
4
4
0XXX
0XXX
Queclink
2 0-63
Reserved
Send Time
Count Number
Tail Character
0
14
4
1
YYYYMMDDHHMMSS
0000 – FFFF
$ $
<Fix Type> : A string to indicate what kind of GPS fixing this cell information is for.
"STR" This cell information is for STR requirement.
"CTN" This cell information is for CTN requirement.
"NMR" This cell information is for NMR requirement.
"RTL" This cell information is for RTL requirement.
<MCC(i)> : MCC of the neighbor cell i (i is the index of the neighbor cell).
<MNC(i)> : MNC of the neighbor cell i.
<LAC(i)> : LAC in hex format of the neighbor cell i.
<Cell ID(i)> : Cell ID in hex format of the neighbor cell i.
TRACGL500AN002
- 53 -
GL500 @Tracker Air Interface Protocol
<RX Level(i)> : The signal strength of the neighbor cell i. This parameter is a 6-bit coded in 1 dB steps:
0: -110 dBm
1 to 62: -109 to -48 dBm
63: -47 dBm
<MCC>: MCC of the service cell.
<MNC>: MNC of the service cell.
<LAC>: LAC in hex format of the service cell.
<Cell ID>: Cell ID in hex format of the service cell.
<RX Level>: The signal strength of the service cell.
Note:
1.
It probably includes only several neighbor cells’ (even no neighbor cell) information. If some neighbor cell wasn’t find, all the fields of the neighbor cell will be empty.
2.
"ffff" in the field of <LAC(i)>, <Cell ID(i)> means the terminal doesn’t know the value.
3.
This message cannot be sent via SMS.
Queclink
Confidential
TRACGL500AN002
- 54 -
GL500 @Tracker Air Interface Protocol
3.4.5. Buffer Report
If BUFFER function is enabled, the terminal will save the message into the BUFFER in the following circumstances.
No GSM signal.
Failed to activate GPRS context for the TCP or UDP connection.
Failed to establish the TCP connection with the backend server.
These messages will be sent to the backend server after the message can be sent to the backend server.. The device can save up to 3000 messages at most.
Only +RESP messages can be buffered except +RESP:GTALL
In the buffer report, the original header string “+RESP” is replaced by “+BUFF” while keeps the other content untouched including the original sending time and count number.
Buffered messages will be sent only via GPRS by TCP or UDP protocol. They cannot be sent via SMS. If the current report mode is forcing on SMS, the buffered messages will be sent via TCP short connection.
The buffered messages will be sent after the other normal messages sending if <Buffer
Mode> in AT+GTSRI is set to 1
Example:
The following is an example of the buffered message:
+BUFF:GTCTN,110103,135790246811220,GL500,0,0,0,25.0,81,0,0.1,0,0.3,121.390875,31.164
600,20130312183936,0460,0000,1877,0873,,,,20130312190551,0304$
Queclink
Confidential
TRACGL500AN002
- 55 -
GL500 @Tracker Air Interface Protocol
3.5. Heartbeat
Heartbeat is used to maintain the contact between the device and the backend server if communicating via GPRS. The heartbeat package is sent to the backend server at the interval defined by <Heartbeat interval> in AT+GTQSS or AT+GTSRI command.
+ACK:GTHBD:
Example:
+ACK:GTHBD,110102,135790246811220,,20100214093254,11F0$
Parameter
Protocol version
Length (byte)
6
Range/Format
XX0000 – XXFFFF,
Unique ID 15
X∈{'A'-'Z','0'-'9'}
IMEI
Device name
Send time
10
14 YYYYMMDDHHMMSS
Default
Count number
Tail character
4
1
0000 – FFFF
$ $
Whenever the backend server receives a heartbeat package, it should reply an acknowledgement to the device.
+SACK:GTHBD:
Example:
Parameter
Protocol version
Queclink
Count number
Tail character
4
1
0000 – FFFF
$ $
<Count number>: The backend server uses the <Count number> extracted from the heartbeat heartbeat.
Confidential
TRACGL500AN002
- 56 -
GL500 @Tracker Air Interface Protocol
3.6. Sever Acknowledgement
If server acknowledgement is enabled by AT+GTQSS or AT+GTSRI command, the backend server should reply to the device whenever it receives a message from the device.
+SACK:
Example:
+SACK:11F0$
Parameter
Count number
Tail character
Length (byte)
4
1
Range/Format
0000 – FFFF
$
Default
$
<Count number>: The backend server uses the <Count number> extracted from the received message as the <Count number> in the server acknowledgement.
Queclink
Confidential
TRACGL500AN002
- 57 -
GL500 @Tracker Air Interface Protocol
Appendix: Message Index
Command and ACK
+ACK:GTNMD
Event Report
TRACGL500AN002
- 58 -
GL500 @Tracker Air Interface Protocol
Heartbeat
Server Acknowledgement
Queclink
Confidential
TRACGL500AN002
- 59 -
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project