Quectel GL100 User manual

GSM/GPRS/GPS Tracker GL100
@Track Air Interface Protocol
Application Notes: TRACGL100AN002
Revision: 2.03
Quectel Wireless Solutions
www.quectel.com
[email protected]

GL100 @Track Air Interface Protocol
Document Title GL100 @Track Air Interface Protocol
Version 2.03
Date 2009-12-08
Status Release
Document Control ID TRACGL100AN002
General Notes
Quectel offers this information as a service to its customers, to support application and
engineering efforts that use the products designed by Quectel. The information provided is
based upon requirements specifically provided to Quectel by the customers. Quectel 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 Quectel 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 Quectel
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 registration of a utility
model or design. All specification supplied herein are subject to change without notice at any
time.
Copyright © Shanghai Quectel Wireless Solutions Co., Ltd. 2009
TRACGL100AN002 -1-
Quectel
Confidential

GL100 @Track Air Interface Protocol
Contents
Contents ............................................................................................................................................2
0. Revision history ............................................................................................................................4
1. Overview.......................................................................................................................................5
1.1. Scope of This Document.....................................................................................................5
1.2. Terms and Abbreviation ......................................................................................................5
2. System Architecture......................................................................................................................6
3. Message Description.....................................................................................................................7
3.1. Message Format And Transmission....................................................................................7
3.2. Command And Acknowledgement .....................................................................................9
3.2.1. Backend Server Register Information.....................................................................9
3.2.2. Base Equipment Information ................................................................................10
3.2.3. Fixed Timing Report Information .........................................................................11
3.2.4. Geo-Fence Information.........................................................................................12
3.2.5. Real Time Operation .............................................................................................13
3.2.6. Special Function....................................................................................................15
3.2.7. Synchronization ACK setting................................................................................16
3.3. Report................................................................................................................................19
3.3.1. Position related information..................................................................................19
3.3.2. Report for Querying..............................................................................................22
3.3.3. Report to Indicate..................................................................................................25
3.4. Heart Beat Data.................................................................................................................27
3.5. Synchronization ACK message.........................................................................................28
4. Develop User Guide....................................................................................................................29
4.1. Register .............................................................................................................................29
4.1.1. Connection mode ..................................................................................................29
4.1.2. Server Setting........................................................................................................31
4.1.3. Set APN Parameters..............................................................................................33
4.2. Location by Call................................................................................................................34
4.3. Fixed Timing Report.........................................................................................................35
4.4. Geo-Fence Alarm Setting..................................................................................................37
4.5. Keypad Setting..................................................................................................................38
4.5.1. Power key..............................................................................................................38
4.5.2. Function key..........................................................................................................38
4.6. Position delay settings.......................................................................................................40
4.7. Movement Detect..............................................................................................................41
4.8. Over Speed Alarm.............................................................................................................42
4.9. Power Management...........................................................................................................43
4.9.1. Power Low Alarm.................................................................................................43
4.9.2. Charge Status Report.............................................................................................43
4.9.3. Full Power Up When Charge ................................................................................43
TRACGL100AN002 -2-
Quectel
Confidential

GL100 @Track Air Interface Protocol
4.10. Real time Operate............................................................................................................45
4.10.1. Get the Latest Successful GPS Fixing Time .........................................................45
4.10.2. Real time Locate ...................................................................................................45
4.10.3. Get All Configuration............................................................................................45
4.10.4. Reboot the terminal...............................................................................................46
4.10.5. Reset to Factory Setting ........................................................................................46
4.10.6. Get the ICCID of SIM Card..................................................................................47
4.10.7. Get GSM Signal level ...........................................................................................47
4.10.8. Get Firmware Version ...........................................................................................47
4.10.9. Get Hardware Version...........................................................................................48
4.10.10. Get the Battery Level...........................................................................................48
4.10.11. Power off the terminal.........................................................................................49
4.10.12. Report information periodically..........................................................................49
4.11. Buffer Report Function ...................................................................................................50
4.12. Synchronization ACK example.......................................................................................51
5. Led Indication.............................................................................................................................52
Annex: Commands Index................................................................................................................53
TRACGL100AN002 -3-
Quectel
Confidential

GL100 @Track Air Interface Protocol
0. Revision history
Revision Date Author Description of change
V2.01 2009-06-01 Doron Zhang New version
V2.02 2009-06-30 Doron Zhang Add GTGEO, GTACK; Add a new field <ver> at
the end of each uplink message
Add <command option> of GTRTO to power off
the terminal and report information periodically.
V2.03 2009-12-08 Colin Hu 1. Add a new mode for the function key to set the
current position as the center of Geo-Fence 0.
2. Add a numeric parameter in the field of reserved
in the command AT+GTSFR to set the position to
get as the result of GPS fixing.
3. Add the function to send several commands in
one SMS or GPRS packet.
TRACGL100AN002 -4-
Quectel
Confidential

GL100 @Track Air Interface Protocol
1. Overview
1.1. Scope of This Document
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 Abbreviation
Abbreviation Description
APN Access Point Network
ASCII American National Standard Code for Information Interchange
GPRS General Packet Radio Service
GSM Global System for Mobile Communications
HDOP Horizontal Dilution of Precision
ICCID Integrated Circuit Card Identity
IP Internet Protocol
SMS Short Message Service
SYNC-ACK Synchronization ACK
TCP Transmission Control Protocol
UDP User Datagram Protocol
UTC Coordinated Universal Time
TRACGL100AN002 -5-
Quectel
Confidential

GL100 @Track Air Interface Protocol
2. 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.
TRACGL100AN002 -6-
Quectel
Confidential

GL100 @Track Air Interface Protocol
3. Message Description
3.1. Message Format And Transmission
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=<parameter1>,<parameter2>,… Command
+ACK:GTXXX,<parameter1>,<parameter2>,… Acknowledgement
+RESP:GTXXX,<parameter1>,<parameter2>,… Report
The entire message string ends with ‘\0’.
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.
According to the configuration of the parameters, the terminal can send Report messages to the
backend server. Please see the following figure:
TRACGL100AN002 -7-
Quectel
Confidential

GL100 @Track Air Interface Protocol
Terminal Backend
Server
Command
Acknowledgement
Report
Report
Report
Figure1:@TrackerProtocolmessagesflow
Note: The Heart Beat Message (GTHBD, refer to chapter 3.4) and the Synchronization
ACK(SYNC-ACK) message (SRVACK, refer to chapter 3.5) are exceptional.
When the terminal 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+GTTRI=gl100,1000,2300,5,60,20091130091200AT+GTSFR=gl100,1,1,0,,0,0,0,5,0,200911
30091200 AT+GTGEO=gl100,1,121.412248,31.187891,1000,10,2,20090101000000
It includes three commands (AT+GTTRI, AT+GTSFR and AT+GTGEO) 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:GTTRI,359231030000010,20091130091200,20091130091205,0011,0102100203
+ACK:GTSFR,359231030000010,20091130091200,20091130091205,0012,0102100203
+ACK:GTGEO,359231030000010,1,20091130091200,20091130091205,0013,0102100203
TRACGL100AN002 -8-
Quectel
Confidential

GL100 @Track Air Interface Protocol
3.2. Command And Acknowledgement
3.2.1. Backend Server Register Information
The command AT+GTSRI is used to configure the GPRS parameters and server information of
the terminal. It is also used to configure the report mode and connection mode between the
backend server and the terminal. When the terminal is configured correctly, it should be able to
report data to the backend server.
¾AT+GTSRI=
Example:
AT+GTSRI=gl100,0,1,cmnet,,,124.79.182.171,7001,+8613888888888,20090101000000
Parameter Length(byte) Range/format Default value
password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100
report mode 1 0|1|2 0
active session 1 0|1|2 0
apn <=40
apn user name <=20 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
apn user password <=20 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’
main server ip <=15
main server port <=5
main sms gateway <=20
send time 14 YYYYMMDDHHMMSS
<password>: The valid character of password is ‘0’-9’, ‘a’-‘z’, ‘A’-‘Z’. The default value is
“gl100”.
<report mode>: Supports three report modes as following:
0: Default on GPRS. Use GPRS as default and SMS for backup when it is failed to
establish a connection with the backend server based on GPRS.
1: Force on GPRS. Only use the GPRS service.
2: Force on SMS. Only use the SMS for transmitting.
<active session>:
0: TCP short-connect 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.
1: 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.
2: UDP mode. The terminal will send data to the backend server by UDP protocol.
TRACGL100AN002 -9-
Quectel
Confidential

GL100 @Track Air Interface Protocol
<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 user password>: the GPRS APN password. If the parameter field is empty, the
parameter will be cleared.
<main server ip>: The IP address of the primary server. It is a dotted decimal notation IP
address. Example as “192.117.16.7”.
<main server port>: The port of the primary server. The valid value is 0-65535.
<main sms gateway>: Maximum 20 characters including the optional national code starting
with “+” for SMS messages. Short code (for example: 10086) is also supported.
<send time>: The UTC time when the command is sent by the backend server.
The acknowledgment message of AT+GTSRI command:
¾+ACK:GTSRI,
Example:
+ACK:GTSRI,359231030000010,20090101000000,20090101000002,11F0,0102100203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
send time 14 YYYYMMDDHHMMSS
ack time 14 YYYYMMDDHHMMSS
count num 4 0000-FFFF
Ver 10 HHHHSSPPPP
<unique id>: The terminal’s IMEI.
<send time>: The <send time> in the AT+GTSRI command.
<ack time>: The UTC time to send the message.
<count num>: The self-increasing count number will be put into every acknowledgment
message. The count is beginning from 0000 and increases by 1 every time. It will roll back
after “FFFF”.
<ver>: The “HHHH” at the beginning is the hardware version. For example: 0102 means the
hardware version is GL100V0102. The “SS” in the middle is the software version. For
example: 10 means the software version is 1604B10GL100M32_SST34HF3284. The “PPPP”
at the end is the @track protocol version. For example: 0203 means the protocol version is
V2.03.
3.2.2. Base Equipment Information
The AT+GTBEI command is used to configure the base equipment information of the terminal. It
is also used to configure parameters of the secondary backend server.
¾AT+GTBEI=
Example:
AT+GTBEI=gl100,,,0,124.79.182.171,7003,,20090101000000
TRACGL100AN002 -10-
Quectel
Confidential

GL100 @Track Air Interface Protocol
Parameter Length(byte) Range/format Default
password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100
reserved
reserved
location by call 1 0|1 0
second server ip <=15
second server port <=5
reserved
send time 14 YYYYMMDDHHMMSS
<reserved>: The parameter field is reserved.
<location by call>: The terminal will perform the following action when it receives an
incoming call according to the parameter.
0: Disconnect the call.
1: Report the position and the incoming phone number to the backend server. Please
refer to the +RESP:GTLBC message for report format.
<second server ip>: The IP address of the secondary backend server. Example as
“192.117.16.7”.
<second server port>: The port of the secondary backend server. The valid value is 0-65535.
The acknowledgment message of the AT+GTBEI command:
¾+ACK:GTBEI,
Example:
+ACK:GTBEI,359231030000010,20090101000000,20090101000002,11F0,0102100203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
send time 14 YYYYMMDDHHMMSS
ack time 14 YYYYMMDDHHMMSS
count num 4 0000-FFFF
ver 10 HHHHSSPPPP
3.2.3. Fixed Timing Report Information
The AT+GTTRI command is used to configure the parameters of scheduled fixed timing report.
¾AT+GTTRI=
Example:
AT+GTTRI=gl100,1000,2300,5,60,20090101000000
Parameter Length(byte) Range/format Default
password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100
begin time 4 0000-2359 0000
end time 4 0000-2359 0000
TRACGL100AN002 -11-
Quectel
Confidential

GL100 @Track Air Interface Protocol
send interval 4 0-1440(minute)0
fix interval 5 0-86400(second)0
send time 14 YYYYMMDDHHMMSS
<begin time>: The start time of scheduled fix timing report. The valid format is “HHMM”.
The value range of “HH” is “00”-“23”. The value range of “MM” is “00”-“59”.
<end time>: The end time of scheduled fix timing report. The valid format and range are
same as <begin time>.
<send interval>: Periodic time to send the position information. The value range is 0-1440
and the unit is minute.
<fix interval>: The interval time to fix GPS, its value range is 0-86400 and the unit is second.
The acknowledgment message of the AT+GTTRI command:
¾+ACK:GTTRI,
Example:
+ACK:GTTRI,359231030000010,20090101000000,20090101000002,11F0,0102100203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
send time 14 YYYYMMDDHHMMSS
ack time 14 YYYYMMDDHHMMSS
count num 4 0000-FFFF
ver 10 HHHHSSPPPP
3.2.4. Geo-Fence Information
The AT+GTGEO command 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=gl100,1,121.412248,31.187891,1000,10,3,20090101000000
Parameter Length(byte) Range/format Default
password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100
geofence id 1 0-4
longitude 20 xxx.xxxxxx(degree)
latitude 20 xx.xxxxxx(degree)
radius 10
0-6000000(meter)
check interval 2 0-99(minute)
geofence type 1 1-3
send time 14 YYYYMMDDHHMMSS
<geofence id>: A numeric to identify the Geo-Fence. The valid values are 0, 1, 2, 3, 4.
<longitude>: The longitude of a point which is defined as the center of the Geo-Fence
TRACGL100AN002 -12-
Quectel
Confidential

GL100 @Track Air Interface Protocol
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 “+”.
<radius>: The radius of the Geo-Fence circular region. The value range is (0-6000000) and
the unit is meter.
<check interval>: The interval of GPS checking for the Geo-Fence alarm.
<geofence type>: A numeric which indicates when to report the notification to the backend
server based on the following:
1: Reports when enters the Geo-Fence.
2: Reports when exits from the Geo-Fence.
3: Reports when enters or exits from the Geo-Fence.
The acknowledgment message of AT+GTGEO command:
¾+ACK:GTGEO,
Example:
+ACK:GTGEO,359231030000010,0,20090101000000,20090101000002,11F0,0102100203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
geofence id 1 0-4
send time 14 YYYYMMDDHHMMSS
ack time 14 YYYYMMDDHHMMSS
count num 4 0000-FFFF
ver 10 HHHHSSPPPP
3.2.5. Real Time Operation
The AT+GTRTO command is used to retrieve information from the terminal or control the
terminal. It is also used to configure the over-speed alarm.
¾AT+GTRTO=
Example:
AT+GTRTO=gl100,1,20090101000000
AT+GTRTO=gl100,9,1,10,20090101000000
AT+GTRTO=gl100,C,2,20090710091200
Parameter Length(byte) Range/fomat Default
password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100
command option 1 0-9,A,B,C
speed alarm Enable 1 0|1 0
speed alarm value 3 0-999(km/h)
TRACGL100AN002 -13-
Quectel
Confidential

GL100 @Track Air Interface Protocol
info reported period 4 0-1440(minute)
send time 14 YYYYMMDDHHMMSS
Note:
Parameters <speed alarm Enable> and <speed alarm value> are only valid when the <command
option> is “9”.
Parameter <info reported period> is only valid when the <command option> is “C”.
<command option>: Valid value is 0-9, A, B, C. For the definition, please refer to the
following.
0: Get the latest time of successful GPS fixing.
1: Require the terminal to report the current position immediately
2: Get the current configuration of the terminal.
3: Reboot the terminal.
4: Reset all parameters to factory setting. Please note that the following parameters will
not be reset: <report mode>, main server information (<main server ip>, <main
server port>, <main sms gateway>), GPRS information (<apn>, <apn user name>,
<apn user password>).
5: Get the ICCID of the SIM card which is being used by the terminal.
6: Get the current GSM signal level of the terminal.
7: Get the software version.
8: Get the hardware version.
9: Configure over speed warning function.
A: Get the battery level of the terminal.
B: Power off the terminal.
C: Configure the terminal to periodically report the information (ICCID, GSM signal
level, battery level and the status of charger). Please refer to chapter 3.3.2 for the
report message: +RESP:GTINF.
<speed alarm enable>: Disable or enable the over speed alarm function.(Refer to chapter 4.7)
<speed alarm value>: When the over speed alarm function is enabled, the terminal will report
to the backend server when the speed is larger than this value.
<info reported period>: 0 means disable report of the terminal’s information; 1-1440 means
the periodic time to report the information, and the unit is minute.
The acknowledgment message of AT+GTRTO command:
¾+ACK:GTRTO,
Example:
+ACK:GTRTO,359231030000010,SPEED,20090101000000,20090101000002,11F0,0102100
203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
option abbr <=8
send time 14 YYYYMMDDHHMMSS
ack time 14 YYYYMMDDHHMMSS
count num 4 0000-FFFF
ver 10
HHHHSSPPPP
<option abbr>: An abbreviation string corresponding to the <command option>:
TRACGL100AN002 -14-
Quectel
Confidential

GL100 @Track Air Interface Protocol
“LGT”: <command option> = 0
“RTL”: <command option> = 1
“READ”: <command option> = 2
“REBOOT”: <command option> = 3
“RESET”: <command option> = 4
“CID”: <command option> = 5
“CSQ”: <command option> = 6
“SWV”: <command option> = 7
“HWV”: <command option> = 8
“SPEED”: <command option> = 9
“CBC”: <command option> = A
“PWROFF”: <command option> = B
“REPINF”: <command option> = C
3.2.6. Special Function
The AT+GTSFR command is used to configure some special functions of the terminal such as:
enable/disable power key, the definition of function key, movement detection, enable/disable full
power up when charger is connected.
¾AT+GTSFR=
Example:
AT+GTSFR=gl100,1,1,0,1,1,20,500,3,0,20090101000000
Parameter Length(byte) Range/format Default
password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100
power key enable 1 0|1 1
function key enable 1 0|1 1
function key mode 1 0|1|2 0
position delay 3 7-900(s) 7
movement detect mode 1 0|1
movement speed <=4 0-999(km/h)
movement distance <=4 0-9999(m)
movement send number 1 1-5 5
full power up 1 0|1 0
send time 14 YYYYMMDDHHMMSS
<power key enable>: The end user cannot power down the terminal by using the power key
when the parameter is set to “0”.(Refer to chapter 4.5.1)
<function key enable>: The function key is disabled when the parameter is set to “0”.(Refer
to chapter 4.5.2)
<function key mode>:
0: Geo-Fence mode.
1: SOS mode.
2: Geo-Fence in current position. Enable or disable Geo-Fence mode and use the current
TRACGL100AN002 -15-
Quectel
Confidential

GL100 @Track Air Interface Protocol
position as the center of Geo-Fence 0.
<position delay>: This is the time to wait after GPS fixing succeed. After GPS fixing
succeed, GL100 will wait for a period of time (defined by <position delay>) and then get the
result of GPS fixing because it is not accurate to get the position immediately after GPS
fixing succeed. (e.g. if <position delay> 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 7-900,
and the default value is 7. Unit: second.
<movement detect mode>: Enable or disable the movement detect function. Please refer to
chapter 4.6 for details.
<movement speed>: The speed threshold of movement detect. The unit is km/h.
<movement distance>: The distance threshold of movement detect. The unit is meter.
<movement send number>: according to the speed threshold and distance threshold, if the
terminal is considered staying at one position, the terminal will send out at most <movement
send number> number of reports before it moves again.
<full power up>: If this parameter is set to 1, the terminal will enter normal power-on mode
even when it is powered on by the charger being inserted. Otherwise, if the parameter equals
0, it will only enter charging mode when it it powered on by the charger being inserted.
The acknowledgment message of the AT+GTSFR command:
¾+ACK:GTSFR,
Example:
+ACK:GTSFR,359231030000010,20090101000000,20090101000002,11F0,0102100203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
send time 14 YYYYMMDDHHMMSS
ack time 14 YYYYMMDDHHMMSS
count num 4 0000-FFFF
ver 10 HHHHSSPPPP
3.2.7. Synchronization ACK setting
The @Track Protocol provides a mechanism to confirm whether an uplink message has been
successfully sent to the backend server. If this mechanism is enabled, the terminal will wait for an
acknowledgement message from the backend server. (Please refer to chapter 3.5 for the details
about acknowledgement message). This document refers to the mechanism as Synchronization
ACK (SYNC-ACK).
The AT+GTACK command is used to enable or disable the mechanism SYNC-ACK.
¾AT+GTACK=
Example:
AT+GTACK=gl100,2,1FDB3,20090101000000
TRACGL100AN002 -16-
Quectel
Confidential

GL100 @Track Air Interface Protocol
Parameter Length(byte) Range/format Default
password 4~8 ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100
ack type 1 1
ack value 8 1
send time 14 YYYYMMDDHHMMSS
<ack type>: A numeric to indicate in which kind of connection the terminal will wait for the
acknowledgements from the backend server.
1: TCP packet. Not supported at this time.
2: UDP packet.
4: SMS PDU. Not supported at this time.
<ack value>: An unsigned integer in HEX format with each bit representing a type of uplink
message. If the corresponding bit is set as 1 and the uplink message is sent through the
connection specified by <ack type>, the terminal will wait for the SYNC-ACK message.
Otherwise, the terminal will not wait for the SYNC-ACK message. The following is the
relationship between each bit and the uplink message. If the SYNC-ACK message is needed
for all of the uplink messages, <ack type> is set as “FFFFFFF”.
bit0 +RESP:GTTRI
bit1 +RESP:GTEST
bit2 +RESP:GTRTL
bit3 +RESP:GTSOS
bit4 +RESP:GTALL
bit5 +RESP:GTPNA
bit6 +RESP:GTPFA (Not supported at this time）
bit7+RESP:GTPLA
bit8+RESP:GTSZI
bit9+RESP:GTGEO
bit10+RESP:GTCID
bit11 +RESP:GTCSQ
bit12+RESP:GTSWV
bit13+RESP:GTHWV
bit14AT+GTHBD
bit15+RESP: GTLBC
bit16+RESP:GTLGT
bit17+RESP:GTBTC
bit18+RESP:GTSTC
bit19+RESP:GTCBC
bit20+RESP:GTINF
bit21+ACK:GTSRI
bit22+ACK:GTBEI
bit23+ACK:GTTRI
bit24+ACK:GTRTO
bit25+ACK:GTSFR
bit26+ACK:GTGEO
bit27+ACK:GTACK
The acknowledgment message of the AT+GTACK command:
¾+ACK:GTACK,
Example:
+ACK:GTACK,359231030000010,20090101000000,20090101000002,11F0,0102100203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
TRACGL100AN002 -17-
Quectel
Confidential

GL100 @Track Air Interface Protocol
send time 14 YYYYMMDDHHMMSS
ack time 14 YYYYMMDDHHMMSS
count num 4 0000-FFFF
ver 10 HHHHSSPPPP
TRACGL100AN002 -18-
Quectel
Confidential

GL100 @Track Air Interface Protocol
3.3. Report
3.3.1. Position related information
The parameters of the three report messages GTSOS/ GTRTL/GTEST are the same.
When the function key is long pressed at least 3 seconds, the +RESP:GTSOS message will be
reported to the server if the SOS mode is enabled. (Refer to chapter 4.5.2)
¾+RESP:GTSOS,
When the terminal receives the AT+GTRTO command and the <command option> is 1, the
terminal reports the current position by sending the message +RESP:GTRTL after successful
acquisition. (Refer to chapter 4.9.2)
¾+RESP:GTRTL,
Based on the setting of AT+GTRTO, the report message +RESP:GTEST is sent to alarm over
speed when the terminal’s speed is over the threshold of speed. (Refer to chapter 4.7)
¾+RESP:GTEST,
Example:
+RESP:GTSOS,359231030000010,0,0,0,1,4.3,92,70.0,1,121.354335,31.222073,20090101000
000,0460,0000,18d8,6141,00,11F0,0102100203
+RESP:GTRTL,359231030000010,0,0,0,1,4.3,92,70.0,1,121.354335,31.222073,2009010100
0000,0460,0000,18d8,6141,00,11F0,0102100203
+RESP:GTEST,359231030000010,0,0,0,1,4.3,92,70.0,1,121.354335,31.222073,20090101000
000,0460,0000,18d8,6141,00,11F0,0102100203
Parameter Length(byte) Range/format Default
unique id 15 IMEI
number 10
reserved 0
reserved 0
gps fix 1 0|1
speed <=5 (0.0-999.9)Km/h
heading <=3 0-359
altitude <=10 (xxxxx.x)m
gps accuracy 2 0-50
longitude <=20 xxx.xxxxxx
latitude <=20 xx.xxxxxx
send time 14 YYYYMMDDHHMMSS
mcc 4 0XXX
mnc 4 0XXX
lac 4
TRACGL100AN002 -19-
Quectel
Confidential