Quectel GL100, Manual

Page 1: ...GSM GPRS GPS Tracker GL100 Track Air Interface Protocol Application Notes TRACGL100AN002 Revision 2 03 Quectel Wireless Solutions www quectel com Info quectel com...

Page 2: ...e 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 her...

Page 3: ...ronization 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 Devel...

Page 4: ...et 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...

Page 5: ...mmand 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 Fen...

Page 6: ...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 Acc...

Page 7: ...ver 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...

Page 8: ...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 d...

Page 9: ...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...

Page 10: ...MSS 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 whe...

Page 11: ...fault 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...

Page 12: ...econdary 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 Exam...

Page 13: ...DHHMMSS 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 peri...

Page 14: ...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 acknowledgme...

Page 15: ...t 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 GS...

Page 16: ...0 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 positio...

Page 17: ...umber 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 Otherwis...

Page 18: ...essage 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 G...

Page 19: ...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...

Page 20: ...larm 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 0...

Page 21: ...e and data protocol for communications between marine instrumentation The range of value is 0 50 The smaller the value is the higher the accuracy is mcc Mobile country code It is 3 digits in length an...

Page 22: ...xample RESP GTLBC 359231030000010 02132523415 1 4 3 92 70 0 1 121 354335 31 222073 2009 0101000000 0460 0000 18d8 6141 00 11F0 0102100203 Parameter Length byte Range format Default unique id 15 IMEI c...

Page 23: ...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 cellid 4 ta 2 count num 4 ver 10 HHHHSSPPPP numbe...

Page 24: ...software version RESP GTCSQ RESP GTSWV Example RESP GTCSQ 359231030000010 16 0 20090101000000 11F0 0102100203 RESP GTSWV 359231030000010 1604B07GL100M32_SST34HF3284 V03 200901010000 00 11F0 0102100203...

Page 25: ...79 182 171 7001 124 79 182 171 7003 86131227746 62 Geo 3 Area1 3 Area2 3 Area3 121 412248 31 187891 1 2 3 Area4 3 0100 2359 1 5 60 1 1 0 1 1 80 100 5 0 1 100 0 0 2 20090101000000 11F0 0102100203 Param...

Page 26: ...0 20090101000000 11F0 0102100203 RESP GTPFA 359231030000010 20090101000000 11F0 0102100203 RESP GTPLA 359231030000010 20090101000000 11F0 0102100203 RESP GTBTC 359231030000010 20090101000000 11F0 0102...

Page 27: ...4 ta 2 count num 4 ver 10 HHHHSSPPPP gps fix A numeric to indicate whether GPS fixing is successful 1 Successful GPS fixing In the case the following longitude and latitude in the message specifies th...

Page 28: ...ault content 9 HeartBeat unique id 15 IMEI send time 14 YYYYMMDDHHMMSS count num 4 ver 10 HHHHSSPPPP content string HeartBeat The backend server SHOULD respond with RESP GTHBD Example RESP GTHBD GPRS...

Page 29: ...g introduction for the details about timeout and resending The maximum times to resend is 5 before the corresponding SYNC ACK message is received from the backend server and the interval between sendi...

Page 30: ...bled via the appropriate report mode setting then the GPRS connection parameters are used to establish GPRS sessions The Track Protocol supports UDP and TCP transport protocols For TCP transport the T...

Page 31: ...onnection status by heartbeat data For heartbeat please refer to chapter 3 4 The terminal will send the AT GTHBD special command to the backend server every specified period of time The backend server...

Page 32: ...200808071000 01 Please note that the boldfaced 2 means Force on SMS Mode The configuration is done when the backend server receives the following message ACK GTSRI 359231030000010 20080807100001 20090...

Page 33: ...mode Default on GPRS Example Configure the terminal with the command AT GTSRI gl100 2 0 cmnet cmnet cmnet 124 79 182 171 7001 8613888888888 200808071000 01 In the above command 8613888888888 is the p...

Page 34: ...SRI 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 parameters are empty for the AP...

Page 35: ...l100 1 124 79 182 46 7003 13888888888 20090101000000 Firstly the terminal confirms the acknowledgment ACK GTBEI 359231030000010 20090101000000 20090101000002 0010 0102100203 When an incoming call is p...

Page 36: ...S part In this mode the send interval will be ignored the terminal reports every fix interval time and the fix interval will be forced to longer than 5 seconds If the terminal is in Force on SMS Mode...

Page 37: ...al 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 gl10...

Page 38: ...erminal will report a leaving status to the backend server if necessary when it leaves the Geo Fence regions The terminal will report an entering status to the backend server if necessary when it ente...

Page 39: ...102100203 4 5 2 Function key Function Key Enable Disable The function key has two different modes Geo Fence mode and SOS mode Geo Fence mode and SOS mode are only useful when the function key is enabl...

Page 40: ...ESP GTSOS message which includes the position information to the backend server Example 1 If you want to set the function key as SOS mode configure the terminal with the command AT GTSFR gl100 1 1 1 0...

Page 41: ...the current position 100 is the radius of Geo Fence 0 2 means the terminal will check the relationship between the position of the terminal and Geo Fence 0 every 2 minutes 3 means that the terminal w...

Page 42: ...will check the movement status according to movement speed and movement distance If the distance between current position and previous is longer than movement distance in m the terminal will be consi...

Page 43: ...r successful GPS fixing Example Enable over speed alarm AT GTRTO gl100 9 1 10 20090101000000 This command will enable over speed alarm and the speed threshold is 10km h The acknowledgement from the te...

Page 44: ...When the charge is completed the terminal will send a RESP GTSTC message to the backend server as following RESP GTSTC 001000000000000 20030101120615 000b 0102100203 4 9 3 Full Power Up When Charge C...

Page 45: ...ir Interface Protocol The configuration is done when the backend server receives the following message ACK GTSFR 359231030000010 20080102112233 20090112104725 000a 0102100203 TRACGL100AN002 44 Quectel...

Page 46: ...est successful GPS fixing time to backend server as following RESP GTLGT 357344020001500 20090202091014 20090202170812 000a 0102100203 4 10 2 Real time Locate Example If the backend server wants to ge...

Page 47: ...t the terminal Example If the backend server is required to reboot the terminal remotely send the following command to the terminal AT GTRTO gl100 3 20090202170812 3 means to reboot the terminal The c...

Page 48: ...with the following message RESP GTCID 357344020001500 898600120907F6015733 20090203094907 000a 0102100203 4 10 7 Get GSM Signal level Example If the backend server is to retrieve the GSM signal level...

Page 49: ...when the backend server receives the following message ACK GTRTO 357344020001500 HWV 20090202172647 20090202172647 000a 0102100203 The terminal will report the hardware version with the following mess...

Page 50: ...option as C in the AT GTRTO command The parameter info reported period is used to configure the reporting period and the unit is minute Example The following is an example of this function AT GTRTO g...

Page 51: ...al can record up to 720 messages The string BUF will be added to all of the buffered messages Buffered messages can only be sent by TCP or UDP protocol They cannot be sent by SMS The buffered messages...

Page 52: ...FFF 20090709145700 2 means to wait for the SYNC ACK message for only the uplink messages sent by UDP connection FFFFFFF means to wait for the SYNC ACK message for all uplink messages The backend serve...

Page 53: ...times power is low Solid Red The terminal is in charging Slow flash charging has completed Solid Green After charger is connected Solid for 8 seconds to indicate the battery status is checked LED2 Blu...

Page 54: ...RTO 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...