Quectel GL100 Manual
  1. Manuals
  2. Brands
  3. Quectel Manuals
  4. GSM/GPRS Modules
  5. GL100
  6. Manual

Quectel GL100 Manual

Gsm/gprs/gps tracker
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
GL100
GSM/GPRS/GPS Tracker
@Track Air Interface Protocol
Application Notes: TRACGL100AN002
Revision: 2.03
Quectel Wireless Solutions
www.quectel.com
Info@quectel.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the GL100 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Quectel GL100

Summary of Contents for Quectel GL100

  • Page 1 GL100 GSM/GPRS/GPS Tracker @Track Air Interface Protocol Application Notes: TRACGL100AN002 Revision: 2.03 Quectel Wireless Solutions www.quectel.com Info@quectel.com...
  • Page 2 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.

  • Page 3: Table Of Contents

    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.
  • Page 4 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.

  • Page 5: Revision History

    GL100 @Track Air Interface Protocol 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.

  • Page 6: Overview

    GL100 @Track Air Interface Protocol 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.

  • Page 7: System Architecture

    GL100 @Track Air Interface Protocol 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.

  • Page 8: Message Description

    GL100 @Track Air Interface Protocol 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>,…...
  • Page 9 GL100 @Track Air Interface Protocol Command Acknowledgement Terminal Backend Server 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.

  • Page 10: Command And Acknowledgement

    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.

  • Page 11: Base Equipment Information

    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.

  • Page 12: Fixed Timing Report Information

    GL100 @Track Air Interface Protocol Parameter Length(byte) Range/format Default password ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100 reserved reserved location by call second server ip <=15 second server port <=5 reserved send time 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.

  • Page 13: Geo-Fence Information

    GL100 @Track Air Interface Protocol send interval 0-1440(minute) fix interval 0-86400(second) send time 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”.

  • Page 14: Real Time Operation

    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 “+”.
  • Page 15 GL100 @Track Air Interface Protocol info reported period 0-1440(minute) send time 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”.

  • Page 16: Special Function

    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”:...

  • Page 17: Synchronization Ack Setting

    <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.
  • Page 18 GL100 @Track Air Interface Protocol Parameter Length(byte) Range/format Default password ‘0’-‘9’,’a’-‘z’,’A’-‘Z’ gl100 ack type ack value send time YYYYMMDDHHMMSS <ack type>: A numeric to indicate in which kind of connection the terminal will wait for the acknowledgements from the backend server.
  • Page 19 GL100 @Track Air Interface Protocol send time YYYYMMDDHHMMSS ack time YYYYMMDDHHMMSS count num 0000-FFFF HHHHSSPPPP TRACGL100AN002 - 18 -...

  • Page 20: Report

    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>...
  • Page 21 GL100 @Track Air Interface Protocol cellid count num HHHHSSPPPP <number>: The number of position in the report message. It is always “0” in the following three report messages: +RESP:GTSOS, +RESP:GTRTL, +RESP:GTEST. <reserved>: This parameter field is reserved. <gps fix>: 1: Successful GPS fixing; 0: Failure of GPS fixing.
  • Page 22 GL100 @Track Air Interface Protocol 0XXX 00XX cellid count num HHHHSSPPPP <number>: The number of position in the report message. It is always “0” in the +RESP:GTSZI message. <geofence id>: Corresponding to the <geofence id> of command AT+GTGEO, it indicates which Geo-Fence alarm is reported.

  • Page 23: Report For Querying

    GL100 @Track Air Interface Protocol +RESP:GTTRI, Example: +RESP:GTTRI,359231030000010,1,0,0,1,4.3,92,70.0,1,121.354335,31.222073,20090101000 000,0460,0000,18d8,6141,00,11F0,0102100203 +RESP:GTTRI,359231030000010,2,0,0,1,4.3,92,70.0,1,121.354335,31.222073,20090101000 000,0460,0000,18d8,6141,00,0,0,1,-3.6,145,30.0,2,121.354442,31.221940,20090101000100,04 60,0000,18d8,6141,00,11F0,0102100203 Parameter Length(byte) Range Default unique id IMEI number 0-15 reserved1 reserved2 gps fix speed <=5 (0.0-999.9|-1)Km/h heading <=4 0-359 altitude <=10 (xxxxx.x)m gps accuracy 0-50 longitude <=20 xxx.xxxxxx latitude <=20...
  • Page 24 GL100 @Track Air Interface Protocol +RESP:GTCBC, Example: +RESP:GTCID,359231030000010,898600810906F8048812,20090101000000,11F0,01021002 +RESP:GTHWV,359231030000010,GL100V0102,20090101000000,11F0,0102100203 +RESP:GTLGT,359231030000010,20090101100825,20090101000000,11F0,0102100203 +RESP:GTCBC,359231030000010,94,20090101000000,11F0,0102100203 Parameter Length(byte) Range/format Default unique id IMEI content <=30 send time YYYYMMDDHHMMSS count num HHHHSSPPPP <content> : the report content of the message. GTCSQ: Report GSM signal level GTSWV: Report software version...
  • Page 25 GL100 @Track Air Interface Protocol indicates sub software version. GTINF: periodically report the following information: ICCID, CSQ, battery level, charger connected. +RESP:GTINF, Example: +RESP:GTINF,359231030000010,898600810906F8048812,16,0,91,0,20090101000000,11F0, 0102100203 Parameter Length(byte) Range/format Default unique id IMEI Iccid Rssi <=2 0-31,99 battery level <=3 1-100...

  • Page 26: Report To Indicate

    GL100 @Track Air Interface Protocol detect mode>,<movement speed>,<movement distance>,<movement send number>,<full power up>,<speed alarm enable>,<speed alarm value>,<ack type>,<ack value>,<info reported period> Send time YYYYMMDDHHMMSS Count num HHHHSSPPPP <longitude0>: The <longitude> of Geo-Fence 0(<geofence id> = 0). 3.3.3. Report to Indicate...
  • Page 27 GL100 @Track Air Interface Protocol count num HHHHSSPPPP <active>: 0: Geo-Fence mode is disabled; 1: Geo-Fence mode is enabled. When <function key mode> is 2, i.e. Geo-Fence in current position, and Geo-Fence 0 is enabled after press the function key for two times in 2 seconds, the terminal will start GPS to get the current position and then report the message +RESP:GTGCR to the backend server.

  • Page 28: Heart Beat Data

    GL100 @Track Air Interface Protocol 3.4. Heart Beat Data The heart beat data is sent from the terminal to the backend server in order to maintain the long-connection of TCP. AT+GTHBD= Example: AT+GTHBD=HeartBeat,359231030000010,20090101000000,11F0,0102100203 Parameter Length(byte) Range/format Default content HeartBeat unique id...

  • Page 29: Synchronization Ack Message

    GL100 @Track Air Interface Protocol 3.5. Synchronization ACK message If the AT+GTACK command has enabled the mechanism SYNC-ACK for a specified uplink message, the backend server should respond with the synchronization ACK (SYNC-ACK) message to the terminal after it has received the specified uplink message.

  • Page 30: Develop User Guide

    GL100 @Track Air Interface Protocol Develop User Guide 4.1. Register 4.1.1. Connection mode The @Tracker Air Interface supports SMS and GPRS data communication via the GSM network and can be configured to use one or the other exclusively or automatically switch between the two by the parameter <report mode>...
  • Page 31 GL100 @Track Air Interface Protocol If <report mode> is set as 1 (Force on GPRS), the terminal will only use the secondary backend server for backup and the SMS gate will not be used. Example: Configure the terminal with the command as following.

  • Page 32: Server Setting

    GL100 @Track Air Interface Protocol Example: The following is an example for configuration: AT+GTSRI=gl100,0,2,cmnet,cmnet,cmnet,124.79.182.171,7001,+8613888888888,200808071000 Please note that the boldfaced “2” means “UDP mode” The configuration is done when the backend server receives the following message: +ACK:GTSRI,359231030000010,20080807100001,20090112104725,000a,0102100203 Force on SMS Mode Set the <report mode>...
  • Page 33 GL100 @Track Air Interface Protocol Set the IP Address and Port Number of Main Server Set the IP address and port number of the main server with the AT+GTSRI command. The main server will be the first choice of data sending, except in “Force on SMS mode”...

  • Page 34: Set Apn Parameters

    GL100 @Track Air Interface Protocol +ACK:GTBEI,359231030000010,20080807100001,20090112104725,000a,0102100203 4.1.3. Set APN Parameters Set APN parameters <apn>, <apn user name>, <apn user password> with the AT+GTSRI command. Example: Configure the terminal with the command: AT+GTSRI=gl100,0,1,cmnet,,,124.79.182.171,7001,+8613888888888,20080807100001 In the above command, “cmnet” is the APN of GPRS network, where the <apn user name> and <apn user password>...

  • Page 35: Location By Call

    GL100 @Track Air Interface Protocol 4.2. Location by Call The scope of the “Location by call” function provides a quick way for retrieving the position of the terminal. The “Location by call” function can be configured by the AT+GTBEI command. The parameter <location by call>...

  • Page 36: Fixed Timing Report

    GL100 @Track Air Interface Protocol 4.3. Fixed Timing Report “Fixed timing report” is a basic function of the @Track Protocol. The backend server can configure the <start time> and <end time> to schedule periodical position reports. In the pre-defined period of time, the terminal will start up GPS every <fix interval> time and report the recorded position log to the backend server every <send interval>...
  • Page 37 GL100 @Track Air Interface Protocol position records. AT+GTTRI=gl100,1000,2300,5,30,20090101000000 The terminal will enter “emergency mode” with the GPS part never being closed, and report the real time position every 30 seconds. AT+GTTRI=gl100,1000,1000,5,60,20090101000000 Reports on the whole day. AT+GTTRI=gl100,1000,2300,0,60,20090101000000 The fixed timing report is not valid.

  • Page 38: Geo-Fence Alarm Setting

    GL100 @Track Air Interface Protocol 4.4. Geo-Fence Alarm Setting Up to 5 Geo-Fence regions can be defined on the terminal. The terminal will report the status when it enters or leaves one of the Geo-Fence areas. Each Geo-Fence region is defined as a circular region defined by a center point and radius. The first Geo-Fence region is special because the user can also control it by the function key beside the AT+GTGEO command.

  • Page 39: Keypad Setting

    GL100 @Track Air Interface Protocol 4.5. Keypad Setting 4.5.1. Power key Configure the function of power key with the AT+GTSFR command. This command is used to enable/disable the power key. If the power key is disabled the end user cannot power off the terminal by using the power key after power on.
  • Page 40 GL100 @Track Air Interface Protocol Example1: If you want to set the function key with Geo-Fence mode, configure the terminal with the command: AT+GTSFR=gl100,1,1,0,0,0,0,0,5,0,20080102112233 “0” means Geo-Fence mode in the above command. The configuration is done when the backend server receives the following message:...

  • Page 41: Position Delay Settings

    To improve the accuracy of GPS fixing, it is useful to wait for a period of time after GPS fixing succeed and then get the result of GPS fixing. And GL100 provides to set the time to wait according to the value of <position delay> in the command AT+GTSFR. Theoretically speaking, the greater <position delay>...

  • Page 42: Movement Detect

    GL100 @Track Air Interface Protocol 4.7. Movement Detect The “Movement Detect” function is used to disable fixed timing report when the terminal stays in the same place without moving for a long time in order to save the communication cost and power consumption.

  • Page 43: Over Speed Alarm

    GL100 @Track Air Interface Protocol 4.8. Over Speed Alarm The backend server can set a speed threshold for the terminal. The terminal will report its position and speed to the backend server when its moving speed is over this threshold. The setting of over speed alarm is done by the AT+GTRTO command.

  • Page 44: Power Management

    GL100 @Track Air Interface Protocol 4.9. Power Management 4.9.1. Power Low Alarm When the battery level of the terminal is low, it will report a power low alarm to the backend server. Example: +RESP:GTPLA,357344020001500,20080111223344,000a,0102100203 4.9.2. Charge Status Report. When the charge status of the terminal status is changed, it will report a message to the backend server.
  • Page 45 GL100 @Track Air Interface Protocol The configuration is done when the backend server receives the following message: +ACK:GTSFR,359231030000010,20080102112233,20090112104725,000a,0102100203 TRACGL100AN002 - 44 -...

  • Page 46: Real Time Operate

    GL100 @Track Air Interface Protocol 4.10. Real time Operate 4.10.1. Get the Latest Successful GPS Fixing Time If the terminal has finished a successful GPS fixing, it will record its latest corresponding UTC time. The backend server can get the UTC time by using the AT+GTRTO command.

  • Page 47: Reboot The Terminal

    GL100 @Track Air Interface Protocol If the backend server wants to get all configurations of the terminal, send the following command to the terminal: AT+GTRTO=gl100,2,20090202172647 In the above command, “2” will get all configurations of the terminal. The command is accepted by the terminal when the backend server receives the following...

  • Page 48: Get The Iccid Of Sim Card

    GL100 @Track Air Interface Protocol message: +ACK:GTRTO,357344020001500,RESET,20090202172647,20090202172647,000a,0102100203 Note: The backend server can query the parameters of the terminal by using the AT+GTRTO command. 4.10.6. Get the ICCID of SIM Card Example: If the backend server wants to get the ICCID of the SIM card inserted in terminal, send the...

  • Page 49: Get Hardware Version

    GL100 @Track Air Interface Protocol AT+GTRTO=gl100,7,20090202172647 “7” means this command is used to get the firmware version. The command is accepted by the terminal when the backend server receives the following message: +ACK:GTRTO,357344020001500,SWV,20090202172647,20090202172647,000a,0102100203 The terminal will report the firmware version as following:...

  • Page 50: Power Off The Terminal

    GL100 @Track Air Interface Protocol 4.10.11. Power off the terminal Example: If the backend server needs to remotely control the terminal to power off, the following command can be sent to the terminal: AT+GTRTO=gl100,B,20090702170810 In the above command, “B” means to power off the terminal.

  • Page 51: Buffer Report Function

    GL100 @Track Air Interface Protocol 4.11. Buffer Report Function If the GSM network is not available, the terminal will record the messages required to be sent to the backend server. These messages will be sent to the backend server when the GSM network is available.

  • Page 52: Synchronization Ack Example

    GL100 @Track Air Interface Protocol 4.12. Synchronization ACK example As UDP is a connectionless protocol, the @Track Protocol provides the mechanism SYNC-ACK to ensure an uplink message has been sent to the backend server. The AT+GTACK command is used to enable or disable the mechanism. Here are two examples using the AT+GTACK...

  • Page 53: Led Indication

    GL100 @Track Air Interface Protocol Led Indication Define: The right LED on the GL100 is called LED1. The left LED is called LED2. Blue LED2 means LED2 is blue. light Color Event State LED1 The power key has been pressed...

  • Page 54: Annex: Commands Index

    GL100 @Track Air Interface Protocol Annex: Commands Index AT+GTSRI +ACK:GTSRI AT+GTBEI +ACK:GTBEI AT+GTTRI +ACK:GTTRI AT+GTGEO +ACK:GTGEO AT+GTRTO +ACK:GTRTO AT+GTSFR +ACK:GTSFR AT+GTACK +ACK:GTACK +RESP:GTSOS +RESP:GTRTL +RESP:GTEST +RESP:GTSZI +RESP:GTLBC +RESP:GTTRI +RESP:GTCID +RESP:GTHWV +RESP:GTLGT +RESP:GTCBC +RESP:GTCSQ +RESP:GTSWV +RESP:GTINF +RESP:GTALL +RESP:GTPNA +RESP:GTPFA +RESP:GTPLA +RESP:GTBTC...

Table of Contents