1. DL manuals
  2. Queclink
  3. GPS
  4. GL300
  5. Manual

Queclink GL300 Manual

Other manuals for GL300: User Manual, User Manual
Manual is about: GSM/GPRS, Track Air Interface Protocol

Summary of GL300

  • Page 1

    Gsm/gprs/gps tracker gl300 @track air interface protocol application notes: tracgl300an001 revision: 1.02 sales@eddywireless.Com.

  • Page 2

    Gl300 @tracker air interface protocol document title gl300 @tracker air interface protocol version 1.02 date 2013-11-26 status release document control id tracgl300an001 general notes queclink offers this information as a service to its customers, to support application and engineering efforts that ...

  • Page 3

    Gl300 @tracker air interface protocol contents contents ............................................................................................................................................2 table index..............................................................................................

  • Page 4

    Gl300 @tracker air interface protocol tracgl300an001 - 3 - 3.3.6. Report google maps hyperlink............................................................................84 3.4. Heartbeat ...................................................................................................................

  • Page 5

    Gl300 @tracker air interface protocol table index table 1: terms and abbreviations .........................................................................................8 tracgl300an001 - 4 - queclink confidential.

  • Page 6

    Gl300 @tracker air interface protocol figure index figure 1: system architecture................................................................................................9 figure 2: @tracker protocol messages flow...............................................................10 tracgl300an001 ...

  • Page 7

    Gl300 @tracker air interface protocol 0. Revision history revision date author description of change 0.02 2012-10-12 evan.Tu initial 1.00 2012-10-26 2012-11-12 2012-11-14 2012-11-16 2012-11-19 2012-11-20 2012-11-26 2012-11-28 2012-11-29 2012-12-04 2012-12-15 2013-1-5 2013-1-9 2013-1-15 evan.Tu evan....

  • Page 8

    Gl300 @tracker air interface protocol tracgl300an001 - 7 - 2.Add the mode 6 in the command at+gtfri 2013-11-14 evan.Tu 1.Add a new protocol command at+gtjdc queclink confidential.

  • Page 9

    Gl300 @tracker air interface protocol 1. Overview 1.1. Scope the @track air interface protocol is a digital communication interface based on printable ascii characters over sms or gprs which is used for all communication between the backend server and the terminal. The backend server sends a command...

  • Page 10

    Gl300 @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 termin...

  • Page 11

    Gl300 @tracker air interface protocol 3. Message description 3.1. Message format all of the @track air interface protocol messages are composed of printable ascii characters. Each message has the following format: message format message type at+gtxxx=,,…$ command +ack:gtxxx,,,…$ acknowledgement +res...

  • Page 12

    Gl300 @tracker air interface protocol when the device receives commands over the air, it supports several commands in one sms or gprs packet without separate symbol between two close commands. But it is necessary to make sure the total size of the several commands is not longer than 160 if the comma...

  • Page 13

    Gl300 @tracker air interface protocol 3.2. Command and acknowledgement 3.2.1. Quick start setting the command at+gtqss is used to set the gprs parameter and backend server information in one command if all these settings are within 160 bytes, otherwise use at+gtbsi and at+gtsri in two steps.  at+gt...

  • Page 14

    Gl300 @tracker air interface protocol terminal connects to the backend server every time it needs to send data and will shut down the connection when the terminal finishes sending data. And if it is failed to establish a tcp connection with the backend server (including main server and backup server...

  • Page 15

    Gl300 @tracker air interface protocol the device.  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...

  • Page 16

    Gl300 @tracker air interface protocol 3.2.2. Bearer setting information the command at+gtbsi is used to set the gprs parameter.  at+gtbsi= example: at+gtbsi=gl300,cmnet,,,,,,,0002$ parameter length (byte) range/format default password 4 – 6 ‘0’ – ‘9’, ‘a’ – ‘z’, ‘a’ – ‘z’ gl300 apn apn user name ap...

  • Page 17

    Gl300 @tracker air interface protocol 3.2.3. Backend server register information the command at+gtsri is used to configure the backend server information that the terminal reports to and the report mode that defines the communication method between the backend server and the terminal.  at+gtsri= ex...

  • Page 18

    Gl300 @tracker air interface protocol example: +ack:gtsri,1a0102,135790246811220,,0003,20100310172830,11f0$ parameter length (byte) range/format default protocol version 6 xx0000 – xxffff, x∈{'a'-'z','0'-'9'} unique id 15 imei device name 20 serial number 4 0000 – ffff send time 14 yyyymmddhhmmss co...

  • Page 19

    Gl300 @tracker air interface protocol 3.2.4. Global configuration the at+gtcfg command is used to configure the global parameters.  at+gtcfg= example: at+gtcfg=quectl,123456,,,,,,,,,,,,,,,,,,,,0004$ at+gtcfg=gl300,,gl300,0,0.0,0,7,0,0,,,,1,1,300,1,0,20491231235959,1,0,,0004$ parameter length (byte)...

  • Page 20

    Gl300 @tracker air interface protocol  gps on need>: whether to close gps chip after retrieving gps position information.  0: never close gps chip  1: close gps chip after retrieving gps information every time.  2: never close gps chip only in ignition on state or movement state.  3: never open...

  • Page 21

    Gl300 @tracker air interface protocol  1: allow the cells’ information report after failed to get gps position.  2: do not report the message +resp:gtgsm if no cell’s information is found.  3: allow the cells’ information report whatever it gets gps position or not  epb mode>: the mode of extern...

  • Page 22

    Gl300 @tracker air interface protocol unavoidable to cost some data traffic for the agps function. At present, it takes about 10 kb data traffic for the agps function each day. The acknowledgement message of at+gtcfg command:  +ack:gtcfg, example: +ack:gtcfg,1a0102,135790246811220,,0004,20100310172...

  • Page 23

    Gl300 @tracker air interface protocol  mode>: a hex numeric to determine how the function works. Each bit of the hex numeric indicate different behavior that device could do. If the corresponding bit is 1, the device will behave as the description. Otherwise, it won’t behave as the description. Bit...

  • Page 24

    Gl300 @tracker air interface protocol unique id 15 imei device name 20 serial number 4 0000 – ffff send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $ 3.2.6. Time adjustment the command at+gttma is used to adjust local time. If the gps fixing is successful, the local time wil...

  • Page 25

    Gl300 @tracker air interface protocol protocol version 6 xx0000 – xxffff, x∈{'a'-'z','0'-'9'} unique id 15 imei device name 20 serial number 4 0000 – ffff send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $ 3.2.7. Fixed report information the command at+gtfri is used to confi...

  • Page 26

    Gl300 @tracker air interface protocol  mode>: the working mode of the fixed report.  0: disable fixed report function.  1: enable the scheduled timing report.  2: enable the scheduled distance report. Report each time the straight length that the device moved has exceeded the specified distance....

  • Page 27

    Gl300 @tracker air interface protocol bit2(0004): altitude> bit3(0008): gsm lai and ci, including mcc>, mnc>, lac>, cellid> bit4(0010): send time>  distance>: the specified distance to send the position information when mode> is 2 and this is valid only in the case that gps chip keep opened always....

  • Page 28

    Gl300 @tracker air interface protocol  action time range  begin time> end time>: reports in the time period (begin time, end time) every day.  begin time> > end time>: reports starting from begin time> and stopping at end time> on the following day.  begin time> = end time>: reports on the whole...

  • Page 30

    Gl300 @tracker air interface protocol mode 1 0 – 3 0 longitude latitude (-)xx.Xxxxxx radius 50 – 6000000m 50 check interval 0

  • Page 31

    Gl300 @tracker air interface protocol reserved 0 reserved 0 reserved 0 reserved 0 serial number 4 0000 – ffff tail character 1 $ $  mode>: a numeric to indicate the working mode of speed alarm.  0: disable speed alarm.  1: enable speed alarm. If the current speed is within the speed range defined...

  • Page 33

    Gl300 @tracker air interface protocol  1: drive the motor vibration when the power key is long pressed to power off  function key ind>: a numeric to indicate the working mode of the motor for function key.  0: disable drive the motor when the function key is long pressed  1: drive the motor vibr...

  • Page 34

    Gl300 @tracker air interface protocol 1: (rtl): request the device to report its current position. 2: (read): request the device to report its entire configuration. 3: (reboot): reboot the device remotely. 4: (reset): reset all parameters to factory default except parameter of at+gtbsi, at+gtsri, at...

  • Page 36

    Gl300 @tracker air interface protocol protocol version 6 xx0000 – xxffff, x∈{'a'-'z','0'-'9'} unique id 15 imei device name 20 serial number 4 0000 – ffff send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $ note: it is necessary to make sure the total size of the command is n...

  • Page 37

    Gl300 @tracker air interface protocol should not include later.  mobile end>: a numeric to indicate the last index of the direct number to input. For example, if it is 2, it will update the direct number list until the 2nd one. If it is empty, it should not include later.  : a phone number list. I...

  • Page 38

    Gl300 @tracker air interface protocol  0: do not unlock sim-pin automatically.  1: each time the device powers on, it will detect whether the sim card is locked with a pin. If it is locked, the device will unlock the pin automatically for one time.  pin>: the pin code which is used when unlocks p...

  • Page 39

    Gl300 @tracker air interface protocol  mode>: a numeric to check whether to enable the digital input.  0: disable the digital input, i.E. Ignore the status changing of the digital input.  1: enable the digital input. If the status of the input change, the device will report the message +resp:gtdi...

  • Page 41

    Gl300 @tracker air interface protocol 3.2.17. Data transfer between uart and backend server the at+gtdat command is used to transfer the data between uart and the backend server.  at+gtdat= example: at+gtdat=gl300,0,,data needs to be sent,0,,,,0016$ at+gtdat=gl300,1,,config command to the can bus d...

  • Page 43

    Gl300 @tracker air interface protocol 3.2.19. Outside working hours to protect the privacy of the driver when they are off duty, the device could be configured to report empty location information during the outside working hours. The command at+gtowh is used to define the working hours and the work...

  • Page 44

    Gl300 @tracker air interface protocol disabled.  3: automatic mode. Under this mode, the device will ignore the status of the digital input. It will automatically check the current time against the working hours arrange. If it is outside of the working hours, the device will hide the location infor...

  • Page 46

    Gl300 @tracker air interface protocol serial number 4 0000 – ffff send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $ 3.2.21. Store command string the at+gtcmd command is used to store the commands which will be used by the command at+gtudf.  at+gtcmd= example: at+gtcmd=gl30...

  • Page 47

    Gl300 @tracker air interface protocol 3.2.22. User defined function the at+gtudf command is used to bind input event and the stored commands. The input events will trigger the corresponding stored commands..  at+gtudf= example: at+gtudf=gl300,1,1,ffffffff,30,,,ffffffff,1,,,,,0005$ parameter length ...

  • Page 48

    Gl300 @tracker air interface protocol 5 bit 4 the gprs network is not attached 6 bit 5 the gsm network registered 7 bit 6 the gsm network not registered 8 bit 7 network roaming 9 bit 8 network non roaming 10 bit 9 sim card is locked 11 bit 10 gps is opened 12 bit 11 gps is closed 13 bit 12 the devic...

  • Page 49

    Gl300 @tracker air interface protocol  stocmd ack>: a numeric to indicate whether to return acknowledgement message after the stored commands are executed.  0: do not send acknowledgement message when execute the stored command.  1: send acknowledgement message when execute the stored command. No...

  • Page 50

    Gl300 @tracker air interface protocol “gl300”.  max download retry>: specifies the maximum time of retrying to download the configuration file upon downloading failure.  download timeout>: specifies the expiration timeout of one single downloading. If the downloading expires, it is considered to b...

  • Page 52

    Gl300 @tracker air interface protocol quit jamming timer threshold> parameter to trigger the quit jamming event. The acknowledgment message of at+gtjdc command:  +ack:gtjdc example: +ack:gtjdc,0a0102,135790246811220,,0016,20090214093254,11f0$ parameter length(byte) range/format default protocol ver...

  • Page 53

    Gl300 @tracker air interface protocol 3.3. Report 3.3.1. Position related report 3.3.1.1. General position report  +resp:gtfri:report of at+gtfri  +resp:gtgeo: report of at+gtgeo  +resp:gtspd: report of at+gtspd  +resp:gtsos: report after long press the function if the function key is enabled an...

  • Page 54

    Gl300 @tracker air interface protocol +resp:gtnmr,1a0102,135790246811220,,0,0,1,1,4.3,92,70.0,121.354335,31.222073,2009 0214013254,0460,0000,18d8,6141,00,,20090214093254,11f0$ +resp:gtdis,1a0102,135790246811220,,0,0,1,1,4.3,92,70.0,121.354335,31.222073,20090 214013254,0460,0000,18d8,6141,00,,2009021...

  • Page 55

    Gl300 @tracker air interface protocol 1: this is a turning point.  for +resp:gtgeo 0: exit the corresponding geo-fence. 1: enter the corresponding geo-fence.  for +resp:gtspd 0: outside the speed range. 1: inside the speed range.  for +resp:gtnmr 0: the state of the device changed from motion to ...

  • Page 56

    Gl300 @tracker air interface protocol odo enable> was set as 0 in the command at+gtcfg, the field will be empty.  battery percentage>: the current volume of the battery in percentage. 3.3.1.2. Location by call report  +resp:gtlbc: example: +resp:gtlbc,1a0102,135790246811220,,+8613800000000,1,4.3,9...

  • Page 59

    Gl300 @tracker air interface protocol  battery voltage>: the voltage of the battery.  : whether the battery is charging when the external power supply is connected.  0: not charging  1: charging  led on>: the setting of led on> in at+gtcfg.  gps on need>: the setting of gps on need> in at+gtcf...

  • Page 60

    Gl300 @tracker air interface protocol example: +resp:gtall,1a0102,860599000000448,gl300,bsi,cmnet,,,,,,,sri,2,,1,116.228.146.250 ,8161,192.0.0.0,0,+8618600126107,5,0,,,,,cfg,gl300,gl300,1,0.8,0,5,003f,0,,0fff,0,1,1,30 0,1,0,20491231235959,1,0,,nmd,0,2,3,2,300,300,2,3,0,,,,,tmz,+0000,0,fri,3,0,,,0000...

  • Page 62

    Gl300 @tracker air interface protocol end time 4 hhmm 0000 check interval 5 – 86400sec 180 send interval 5 – 86400sec 180 ignition check interval 5 – 86400sec 180 ignition send interval 5 – 86400sec 180 report mask 0000 – ffff 1f distance 50 – 65535m 1000 mileage 50 – 65535m 1000 movement detect mod...

  • Page 68

    Gl300 @tracker air interface protocol example: +resp:gtcid,1a0102,135790246811220,,898600810906f8048812,20100214093254,11f0 $ parameter length (byte) range/format default protocol version 6 xx0000 – xxffff, x∈{'a'-'z','0'-'9'} unique id 15 imei device name 20 iccid 20 send time 14 yyyymmddhhmmss cou...

  • Page 69

    Gl300 @tracker air interface protocol tail character 1 $ $  device type>: a string represents the type of the device.  firmware version>: the firmware version. The first two characters point out the main version and the last two characters point out the subsidiary version. For example: 010a means ...

  • Page 70

    Gl300 @tracker air interface protocol tail character 1 $ $  +resp:gtals: the report for real time operation read,for example dis example: +resp:gtals,1a0102,135790246811220,gl300,dis,1,1,5,,,,,,20121119083156,10fb$ parameter length (byte) range/format default protocol version 6 xx0000 – xxffff, x∈{...

  • Page 71

    Gl300 @tracker air interface protocol sv_power 2 0-55 send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $  gps level>:four levels:  0: can not fix  1: hard to fix  2: a little hard fix  3: easy to fix  jamming indicator>: scaled (0 = no cw jamming, 255=strong cw jamming...

  • Page 72

    Gl300 @tracker air interface protocol example: +resp:gtpna,1a0102,135790246811220,,20100214093254,11f0$ parameter length (byte) range/format default protocol version 6 xx0000 – xxffff, x∈{'a'-'z','0'-'9'} unique id 15 imei device name 20 send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail ch...

  • Page 73

    Gl300 @tracker air interface protocol mnc 4 0xxx lac 4 xxxx cell id 4 xxxx odo mileage 9 0.0 – 4294967.0km send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $  last longitude>: the longitude of the last position. The format is “(-)xxx.Xxxxxx” and the value range is from “-18...

  • Page 74

    Gl300 @tracker air interface protocol example: +resp:gtbpl,1a0102,135790246811220,,3.53,0,4.3,92,70.0,121.354335,31.222073,20090 214013254,0460,0000,18d8,6141,00,20100214093254,11f0$ parameter length (byte) range/format default protocol version 6 xx0000 – xxffff, x∈{'a'-'z','0'-'9'} unique id 15 ime...

  • Page 75

    Gl300 @tracker air interface protocol mcc 4 0xxx mnc 4 0xxx lac 4 xxxx cell id 4 xxxx odo mileage 9 0.0 – 4294967.0km send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $  +resp:gtstc: example: +resp:gtstc,1a0102,135790246811220,,0,4.3,92,70.0,121.354335,31.222073,200902140 1...

  • Page 78

    Gl300 @tracker air interface protocol mnc 4 0xxx lac 4 xxxx cell id 4 xxxx odo mileage 9 0.0 – 4294967.0km send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $  duration of ignition off>: duration since last time the ignition is off. If greater than 999999 seconds, report as ...

  • Page 79

    Gl300 @tracker air interface protocol  +resp:gtgsm example: +resp:gtgsm,1a0102 , 011874000103767,fri,0460,0000,1878,0871,20,,0460,0000,1878,0 152,16,,,,,,,,,,,,,,,,,,,,,,,,,,0460,0000,1878,0873,57,00,20100712071540,0008$ parameter length(byte) range default protocol version 6 xx0000 – xxffff, x∈{'a...

  • Page 80

    Gl300 @tracker air interface protocol rxlevel6 2 0-63 reserved6 0 mcc 4 0xxx mnc 4 0xxx lac 4 cellid 4 rxlevel 2 0-63 ta 2 send time 14 yyyymmddhhmmss count num 4 tail character 1 $ $  fix type> : a string to indicate what kind of gps fixing this cell information is for.  "sos" this cell informati...

  • Page 83

    Gl300 @tracker air interface protocol longitude (–)xxx.Xxxxxx latitude (–)xx.Xxxxxx gps utc time 14 yyyymmddhhmmss mcc 4 0xxx mnc 4 0xxx lac 4 xxxx cell id 4 xxxx reserved 2 00 00 send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $  +resp:gtjds: example: +resp:gtjds,0a0102,1...

  • Page 84

    Gl300 @tracker air interface protocol cell id 4 xxxx reserved 2 00 00 send time 14 yyyymmddhhmmss count number 4 0000 – ffff tail character 1 $ $  jamming status>: the current jamming status of the device.  1: quit the jamming.  2: enter the jamming.  +resp:gtdat example: +resp:gtdat,1a0102,1357...

  • Page 85

    Gl300 @tracker air interface protocol via sms.  the buffered messages will be sent after the other normal messages sending if buffer mode> in at+gtsri is set to 1.  the buffered messages will be sent before the other normal messages sending if buffer mode> in at+gtsri is set to 2. The sos message ...

  • Page 86

    Gl300 @tracker air interface protocol 3.4. 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.  +a...

  • Page 87

    Gl300 @tracker air interface protocol tracgl300an001 - 86 - count number 4 0000 – ffff tail character 1 $ $  count number>: the backend server uses the count number> extracted from the received message as the count number> in the server acknowledgement. Queclink confidential.

  • Page 88

    Gl300 @tracker air interface protocol appendix: message index  command and ack at+gtqss +ack:gtqss at+gtbsi +ack:gtbsi at+gtsri +ack:gtsri at+gtcfg +ack:gtcfg at+gtnmd +ack:gtnmd at+gttma +ack:gttma at+gtfri +ack:gtfri at+gtgeo +ack:gtgeo at+gtspd +ack:gtspd at+gtfks +ack:gtfks at+gtrto +ack:gtrto ...

  • Page 89

    Gl300 @tracker air interface protocol at+gtcmd +ack:gtcmd at+gtupc +ack:gtupc at+gtjdc +ack:gtjdc  position related report +resp:gtfri +resp:gtgeo +resp:gtspd +resp:gtsos +resp:gtrtl +resp:gtlbc +resp:gtpnl +resp:gtnmr +resp:gtgcr +resp:gtdog +resp:gtigl  device information report +resp:gtinf  re...

  • Page 90

    Gl300 @tracker air interface protocol tracgl300an001 - 89 - +resp:gtign +resp:gtigf +resp:gtgsm +resp:gttem +resp:gtupc +resp:gtjdr +resp:gtjds  executive command report +resp:gtdat heartbeat +ack:gthbd +sack:gthbd  server acknowledgement +sack queclink confidential.