• AT command Reference

Download the ebook

 
AT command Reference
TT8850AT001
TT8850
AT Command Reference
Revision 1.04
5/06/2011
Confidential and Proprietary Information – © 2011 Skypatrol, LLC.
Do not duplicate without express permission from Skypatrol, LLC
SkyPatrol TT8850
 
Document Title  TT8850 AT Command Reference 
Version  1.04 
Date  2011‐05‐06 
Status  Release 
Document Control ID  TT8850AT001 
 
 
 
General Notes 
 
SkyPatrol LLC offers this information as a service to its customers, to support application and 
engineering  efforts  that  use  the  products  designed  by  SkyPatrol  LLC.  The  information 
provided is based upon requirements specifically provided to SkyPatrol LLC by the customers. 
SkyPatrol  LLC  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  SkyPatrol  LLC  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 SkyPatrol 
LLC.  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 the registration 
of a utility model or design. All specification supplied herein are subject to change without 
notice at any time. 
 
Copyright © SkyPatrol LLC, 2011 
 
 
 
 
 
 
 
 
 
TT8850AT001 -1-
SkyPatrol TT8850
 
Contents 
Contents ............................................................................................................................................ 2
Table Index ........................................................................................................................................ 4
Figure Index....................................................................................................................................... 5
0. Revision history ............................................................................................................................. 6
1. Overview ....................................................................................................................................... 8
1.1. Scope ................................................................................................................................... 8
1.2. Terms and Abbreviations ..................................................................................................... 8
2. System Architecture ...................................................................................................................... 9
3. Message Description ................................................................................................................... 10
3.1. Message Format ................................................................................................................ 10
3.2. Command and Acknowledgement .................................................................................... 12
3.2.1. Quick Start Setting ............................................................................................... 12
3.2.2. Bearer Setting Information .................................................................................. 15
3.2.3. Backend Server Register Information .................................................................. 16
3.2.4. Global Configuration ............................................................................................ 17
3.2.5. Non movement detection .................................................................................... 20
3.2.6. Time Adjustment ................................................................................................. 22
3.2.7. Fixed Report Information ..................................................................................... 23
3.2.8. Geo‐Fence Information ........................................................................................ 26
3.2.9. Speed Alarm ......................................................................................................... 28
3.2.10. Function Key Setting ............................................................................................ 30
3.2.11. Real Time Operation ............................................................................................ 32
3.2.12. White Call List Configuration ............................................................................... 34
3.2.13. Start FOTA ............................................................................................................ 36
3.2.14. Stop FOTA ............................................................................................................. 37
3.3. Report ................................................................................................................................ 38
3.3.1. Position and Event Report ................................................................................... 38
3.3.2. Device Information Report .................................................................................. 44
3.3.3. Report for Querying ............................................................................................. 48
3.3.4. Buffer Report ....................................................................................................... 56
3.3.5. Report Google Maps hyperlink ............................................................................ 56
3.3.6. FOTA report .......................................................................................................... 56
3.4. Heartbeat .......................................................................................................................... 59
3.5. Sever Acknowledgement ................................................................................................... 61
4. FOTA Process ............................................................................................................................... 62
4.1. Fota Process Introduction.................................................................................................. 62
4.1.1. Initiation of the FOTA process .............................................................................. 62
4.1.2. Confirmation of FOTA process ............................................................................. 62
4.1.3. Downloading of the update package ................................................................... 62
TT8850AT001 -2-
SkyPatrol TT8850
4.1.4. Updating of the firmware .................................................................................... 63
4.2. An example of successful FOTA ......................................................................................... 64
5. LED Indication.............................................................................................................................. 65
Appendix: Message Index ............................................................................................................... 66
 
TT8850AT001 -3-
SkyPatrol TT8850
Table Index 
TABLE 1: TERMS AND ABBREVIATIONS .................................................................................................. 8 
 
TT8850AT001 -4-
SkyPatrol TT8850
Figure Index 
FIGURE 1: SYSTEM ARCHITECTURE ....................................................................................................... 9 
FIGURE 2: @TRACKER PROTOCOL MESSAGES FLOW ........................................................................... 10 
 
TT8850AT001 -5-
SkyPatrol TT8850
0. Revision history 
Revision  Date  Author  Description of change 
1.00  2011‐04‐19  Ramiro Sanchez  SkyPatrol release 
1.01  2011‐04‐21  Ramiro Sanchez  1. Add the parameters of the command AT+GTWLT 
in the message GTALL. 
2.  Correct  the  length  of  the  parameter   to 2 in HEX format of event report. 
3. Add the description of the command for FOTA 
4. Add the report message about FOTA 
5. Add the description about FOTA process 
1.03 2011‐04‐21  Ramiro Sanchez  1. Modify the definition of the parameter  for other messages except GEO related 
messages in HEX format of event report.   
2.  Correct  the  definition  of  the  situation  when 
 is 2. It keeps GPS opened always in 
movement state as well as in ignition on state. 
3.  Correct    and    in  the 
command AT+GTFRI to use local time. 
4. Correct the range of  to 0|1|2 in 
the report message GTGPS. 
5.  Correct  the  range  of    to  0|1|2  in  the 
report message GTBAT. 
6.  The  sub  command  4(RESET)  do  not  reset  the 
parameters set by the command AT+GTTMA. 
7. Delete the header "+RESP:". 
8. Correct the description of  in the 
Report Google Maps hyperlink. 
9.  Modify  the  minimum  value  of  the  parameter 
 and  to 50
TT8850AT001 -6-
SkyPatrol TT8850
1.04  2011‐05‐06  Ramiro Sanchez  1. Remove the two reserved fields between Device 
name and GPS on need in GTALL message 
2. Add new fields  and   in  the  report  messages,  for  both  ASCII 
format and HEX format. 
3.  In  both  ASCII  format  and  HEX  format  of  the 
message GTANT, use the parameter  to 
indicate which GPS antenna is being used, internal 
antenna or external antenna. 
4.  Modify  the  default  value  of  the  parameter 
  as  0x5F  to  allow  protocol 
version appear by default. 
5.  Add  the  specification  for  the  coding  conversion 
of report message for sending report via SMS. 
 
TT8850AT001 -7-
SkyPatrol TT8850
1. Overview 
1.1. Scope 
The Air Interface Protocol is a digital communication interface 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 Air 
Interface Protocol. 
1.2. Terms and Abbreviations 
Table 1: Terms and abbreviations 
Abbreviation  Description 
APN    Access Point Network   
ASCII  American National Standard Code for Information Interchange 
FOTA  Update the Firmware Over The Air 
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 
TCP  Transmission Control Protocol 
UDP  User Datagram Protocol 
UTC  Coordinated Universal Time 
 
TT8850AT001 -8-
SkyPatrol TT8850
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 
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. 
 
TT8850AT001 -9-
SkyPatrol TT8850
3. Message Description 
3.1. Message Format 
The protocol command and acknowledgement are composed of printable ASCII characters as the 
following format: 
Message format  Message type 
AT+GTXXX=,,…$  Command 
+ACK:GTXXX,,,…$  Acknowledgement 
The entire message string ends with character ‘$’. 
The characters ‘XXX’ identify the deferent message. 
The  “,,…”  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’.   
And the report from the terminal to the backend server could be ASCII format or HEX format. 
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: 
 
Command
Acknowledgement
Terminal Backend
Server
Report
Report
Report
 
Figure 2: @Tracker protocol messages flow 
TT8850AT001 - 10 -
SkyPatrol TT8850
 
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+GTFRI=TT8850,1,1,,,0000,2359,60,60,,,1F,0,,,,,,,,0007$AT+GTGEO=TT8850,0,3,101.412248,21
.187891,1000,600,,,,,,,,,0008$AT+GTSPD=TT8850,1,5,40,30,60,,,,,,,,,0009$ 
 
It includes three commands (AT+GTFRI, AT+GTGEO and AT+GTSPD) 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:GTFRI,020100,135790246811220,,0,,0007,20100310172830,11F0$ 
 
+ACK:GTGEO,020100,135790246811220,,0,0,0008,20100310172900,11F1$ 
 
+ACK:GTSPD,020100,135790246811220,,0,,0009,20100310172930,11F2$ 
 
TT8850AT001 - 11 -
SkyPatrol TT8850
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=TT8850,cmnet,,,4,,116.226.44.17,9001,116.226.44.16,9002,+8613812341234,0,1,
,,0001$ 
Parameter  Length (byte)  Range/Format  Default 
Password  4 – 6  ‘0’ – ‘9’, ‘a’ – ‘z’, ‘A’ – ‘Z’  TT8850 
APN 


Use: 0.3509