TR-203 is a tracker that can track the location of the elderly, children, pets, and
vehicles.
It can apply for fleet management, looking for lost children, elderly care, and
lost pets.
This document describes the communication protocol between TR-203 tracker
and server, the built-in behavior modes of TR-203, and the function of each
parameter.
It can help system integration developer to develop back-end system in the
shortest time.
3
2 Protocol Summary
2.1 General Format
GSx,IMEI,[T,S,]Field1,Field2,……,FieldN*Checksum!
Format Description Note
GSx ”GSS” :Write setting
”GSs” :Report setting
”GSG” :Write Geo-fence parameter
”GSg” :Report Geo-fence parameter
”GSC” :Action command
”GSr” :Position and status report (format 0)
”GSh” :Position and status report (format 1)
IMEI(The IMEI number) GSM device ID
T ‘0’ : Middle of message
‘1’ : Start of message
‘2’ : End of message
‘3’ : Start and End of message, i.e., only one
packet for message
S ‘0’,’1’,’2’,’3’,…,’9’,’10’,’11’,…,’99’ Sequence number
FieldField1 ~ FieldN Refer to “TR-203
Command head
Message packet
control
configure
parameters” for
detail definition
** End of field
ChecksumThe checksum value is derived by the same
method of NMEA standard. It is calculated by
‘exclusive OR’ the 8 data bits of each character
before “*” in the sentence, but excluding “*”.
The hexadecimal value of the most significant
and least significant 4 bits of the result are
converted to two ASCII characters (0-9, A-F) for
transmission. The most significant character is
transmitted first.
2=get out of area
3=cross over the boundary
4=stay in area
5=stay out of area
upper_left_Lon,upper_left_L
at,right_bottom_Lon,right_b
ottom_Lat
gxxx Optional field for describing this
startTime,endTime,weekdayOptional field which specify the
Coordinate of specified area
area belong to area group xxx.
effective time frame of this
geo-fence area. startTime and
endTime are in seconds. Weekday
is in hex-digit format which
specifies applicable day in a week,
where bit 0 represents Sunday,
bit1 represents Monday, etc.
2.4 Command Format
GSC,IMEI,c1(option1),c2(option2),……….*checksum!
c1,c2…are code words of commands.
option1, option2… are their respective parameters. Please refer to 2.7.
6
2.5 Report Messages Format
There are two types of report message format, “format 0” and “format 1”.
(Refer to “11. Report” for detail definition)
Example:
TR-203 -> Server (format 0)
GSr,IMEI,Device_Mode,Report_Type,Alarm_Status,Geofence_st
atus,GPS_Fix,UTC_Date,UTC_Time,Longitude,Latitude,Altitude
,Speed,Heading,Number_of_Satellites,HDOP,Battery_capacity*
checksum!
TR-203 -> Server (format 1)
GSh, IMEI,Alarm_Status,GPS_Fix,Battery_capacity*checksum!
7
2.6 Parameters of Report Messages
Parameters of Report Message
Codeword Parameters Description
A GPS fixing mode 1=not fix
2=2D fix
3=3D fix
B UTC Date, Time ddmmyy,hhmmss
C Local Date, Time ddmmyy,hhmmss
1 Longitude (E or W)ddd.dddddd
2 Longitude (E or W)dddmm.mmmm
3 Longitude (+ or -)ddddddddd
unit: 0.000001 degree
6 Latitude (N or S)dd.dddddd
7 Latitude (N or S)ddmm.mmmm
8 Latitude (+ or -)dddddddd
unit: 0.000001 degree
G Altitude xxxxx.x
Unit: meter
H Speed xxx.xx
unit: knots (1.852km/hr)
I Speed xxx
unit: km/hr
J Speed xxx
unit: mile/hr
K Heading xxx
unit: degree
L Number of satellite in usexx
M HDOP xx.x
N Battery capacity xx
unit: percent capacity
O Operation mode 1=Sleeping
2=Periodic
3=On-line
4=Motion
8
6=Parking
7=Standby
8=Off
P Alarm status xx(hex digits)
bit0=SOS alarm
bit1=Parking alarm
bit2=Sleeping alarm
bit4=Geo-fence alarm
bit5=Speed alarm
bit7=Battery low alarm
Z Geo-fence status Empty field: no geo-fence alarm
Ixxx: get in area xxx
Oxxx: get out area xxx
IGxxx: get in group xxx
OGxxx: get out group xxx
Q Report Media xx(hex digits)
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Acton[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
R Report type 1=Ping report
2=Periodic mode report
3=On-line mode report
4=Motion mode static report
5=Motion mode moving report
6=Motion mode static to moving report
7=Motion mode moving to static report
C=Parking mode report
D=Parking mode alarm report
E=Sleeping mode report
9
F=Sleeping mode alarm report
G=Geo-fence alarm report
H=Autonomous Geo-fence alarm report
I=SOS alarm report
J=Low battery alarm report
K=Speed alarm report
L=Timer 0 report
M=Timer 1 report
N=Timer 2 report
O=Timer 3 report
P=L4 report
S IMEI
T Device ID
U Checksum The checksum value is derived by the
same method of NMEA standard. It is
calculated by ‘exclusive OR’ the 8 data
bits of each character before “*” in the
sentence, but excluding “*”. The
hexadecimal value of the most significant
and least significant 4 bits of the result
are converted to two ASCII characters
(0-9, A-F) for transmission. The most
significant character is transmitted first.
p Temperature degree Celsius
#
*
?
! ! Message delimiter
10
2.7 Configuration Parameters
Most behaviors of TR-203 could be changed by Configuration Parameters. You
could change the setting of configuration parameters by the following methods.
1. Connect TR-203 to personal computer via USB cable and then set the
configuration parameters by “TR203 Config Tool.”
2. Send the “GSS,….!” setting with the configuration parameters to TR-203
3. Send the “GSC,….!” command with the configuration parameters to TR-203
All the settings or commands could be sent by SMS or TCP or UDP.
You could also send L1 command to read the present setting of TR-203.
Configure Parameters
Main
Device
SIM
Code
Parameters Type Description
words
O5 Device ID char(16)
O7 Firmware Version char(28) Read only
O6 Time Zone Offset
Power on operating
O4
mode
B0 PIN code char(4)
Phone number of SIM
B1
card
s32, in
-43200 ~ 46800
seconds
1=Sleeping
2=Periodic
3=On-line
u8
4=Motion
6=Parking
7=Standby
char(20)
Vibrator
B2 IMEI number char(16) Read only
I2
Enable/ disable TR-203
to vibrate after
pressing SOS key
1/0
11
0=disable
1=enable
J0
The power capacity for
sending out battery
low alarm report
u8,
15 ~ 100
percent
Battery
J1
J6
J7
J8
The power capacity for
power off TR-203
Battery low alarm
report Media
The power capacity for
clear battery low alarm
flag
Enable/disable TR-203
to automatically power
on when power
capacity is charged to
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
u8,
10 ~ 100
percent
0=disable
1/0
1=enable
Data logger
O2 Data logger interval
OH Data logger distance
O1
Other setting
O3 Report format 0 char(32) Default=SORPZAB27GHKLMN*U!
ON Report format 1 char(32) Default=SARN*U!
OG
O8 Enable/ disable TR-203 1/0 Default=0.
the capacity of J1
Motion sensor
sensitivity
Enable/ disable data
buffer function
u16, in
seconds
u32, in
meters
0 ~ 65535
0=disable
0 ~ 4Giga
0=disable
u16 0 ~ 100
1/0 Default=1
12
to report “cell ID” if it
The report format will
does not get GPS fix
automatically switch from format
0 to format 2 when TR-203 does
not get GPS fix.
bit1=TCP
bit2=UDP
bit6=Action[0]
OO
Report media for
Media type
reading configuration
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
0=disable
1=enable
C0 GPS always on 1/0
Applicable to all modes except
Sleeping and Off mode
The time for starting to
GPS
GPS
C1
C2
C3
C7
get GPS fix before the
next report time if
TR-203 does not get
GPS fix in last report,
or got GPS fix for 1
hour ago
The time for starting to
get GPS fix before the
next report time if
TR-203 got GPS fix
within 1 hour
GPS fix time before
sending out the first
report
Choose to use C8 or
C9+CA
u16, in
seconds
u16, in
seconds
u16, in
seconds
1/0
60 ~ 600
Note: TR-203 will send out the
report whether it gets GPS fix or
not when C1 time ends.
10 ~ 120
Note: TR-203 will send out the
report whether it gets GPS fix or
not when C2 time ends.
0 ~ 600
If "C3"=0, disable first report
message.
0=use C8
1=use C9+CA
Applicable for standby, periodic
and on-line mode
Interval for starting to
u16, in
0 ~ 65535
C8
get GPS fix
seconds
13
Applicable if C7=0
C9
Interval for starting to
get GPS fix when
speed is lower than 10
KM/H
u16, in
0 ~ 65535
Applicable if C7=1 and speed<10
seconds
Km/H
0 ~ 4Giga
Applicable if C7=1 and
CA
D1 APN char(32)
D2 User Name char(32)
D3 Password char(32)
D4 DNS 1 char(32)
D5 DNS 2 char(32)
D8
Communication
GPRS
OR
Interval for starting to
get GPS fix when
speed is higher than
10 KM/H
GPRS mode for L4
command
Shortly click SOS key
to make TR-203
connect to server
u32
Media type
1/0
speed>=10 Km/H
You have to take the value to
divide the speed to get the
interval. For example, if you set
the value as 54000 and the speed
is 60 KM/H. The interval will be
54000/60=900 seconds
02=TCP
04=UDP
0=disable
1=enable
SMS
E0
char(32)
name 1
E1 Host Port number 1 u16
Host IP or domain
Host IP or domain
E2
char(32)
name 2
E3 Host Port number 2 u16
E9 GSM operating band u8
SMS return phone
F0
char(20)
number
14
0=auto, 1=900/1800, 2=850/1900,
3=1800, 4=1900
A0
Send confirmation to
server after receiving
command from server
0=disable
1=enable
1/0
Confirmation
message="ACK\r\n"
A1
Wait confirmation from
server after sending
message to server
1/0
0=disable
1=enable
Confirmation message="ACK\r"
Timeout of waiting
A2
A3
confirmation from
server
Device Ack with ID
string
u8 0~255
0=disable
1/0
1=enable
0=Device id
ID string is IMEI or
A4
1/0
1=IMEI
device ID
Available when A3=1
A5
OM
Enable Simple
1/0
Command
Enable voice call to
1/0
connect to server
0=disable
1=enable
0=disable
1=enable
Security
SOS
G0 SMS Phone number 1 char(20)
G1 SMS Phone number 2 char(20)
G2 SMS Phone number 3 char(20)
G3 SMS Phone number 4 char(20)
G4 SMS Phone number 5 char(20)
G5 SMS Phone number 6 char(20)
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
H1 Report number u16 0 ~ 65535
15
SMSÆ 0 or 1=1 SOS alarm
report;2~65535=2~65535 SOS
alarm report
GPRSÆ 0 =1 SOS alarm report
;1~65535= continue send SOS
alarm report till receive stop
command
H2 report interval
V0
V1
Voice Monitor
V4
V5
Call out SOS phone
number 1 when SOS
alarm
Allowed interval for
call in TR-203 after
SOS alarm happens
Voice Monitor call
in/out phone number
for voice monitor
command
Allowed interval for
call in TR-203 after
receiving voice
u16, in
seconds
1/0
u16, in
seconds
char(20)
u16, in
seconds
0 ~ 65535
0=disable
1=enable
0 ~ 65535
Available when V0=0
G0~G5 are also call in phone
number for voice monitor
command
0 ~ 65535
Available when V6=0
Alert
Parking
monitor command
Call in or call out for
0=Call in
V6
voice monitor
1/0
1=Call out
command
T0
Report interval in alert
state
Report interval in
T1
alarm state
u32, in
0 ~ 4Giga
seconds
u32, in
0 ~ 4Giga
seconds
T2 Report Media Media typebit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
16
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
Sleeping
Traveled distance for
u32, in
T3
sending report
Report interval in alert
meters
u32, in
U0
state
Report interval in
seconds
u32, in
U1
alarm state
seconds
U2 Report Media Media type
0 ~ 4Giga
0=disable
0 ~ 4Giga
0 ~ 4Giga
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
Upper limit of speed
u8, in
0 ~ 255
OI
alarm
Lower limit of speed
Km/h
u8, in
0=disable
0 ~ 255
OJ
alarm
Hysteresis for speed
OP
Speed Limit
alarm
Km/h
u8, in
Km/h
0=disable
0 ~ 255
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
OL
Report Media for
Media type
speed alarm
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
17
K0 Geo-fence enable 1/0
0=disable
1=enable
bit0=SMS
bit1=TCP
bit2=UDP
Geo-fence
K3
Geo-fence alarm report
Media type
Media
bit6=Action[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
0~65535
For N1 & L4 command. If OS=0,
GPS fix time=C3
0 ~ 4Giga
P2 Report Media Media typebit0=SMS
bit1=TCP
18
bit2=UDP
bit6=Action[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
On-line
Traveled distance for
u32, in
P3
sending report
meters
u32, in
Q0 Report interval
seconds
Q2 Report Media Media type
Traveled distance for
u32, in
Q3
sending report
meters
0 ~4Giga
0=disable
0 ~ 4Giga
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
0 ~ 4Giga
0=disable
Interval in on-line state
u16, in
E4
for disconnecting and
0=disable
seconds
then re-connecting
Interval for checking if
GPRS connection is
on-line. If GPRS
u16, in
E5
connection is cut,
0=disable
seconds
TR-203 will try to
connect to server for
one time.
Enable/disable TR-203
0=disable
to send “OK” to server
E6
1/0
1=enable
after GPRS connection
Available when E5 is not 0
is re-built.
19
Report interval in
u32, in
R0
static state
Report interval in
seconds
u32, in
R1
motion state
seconds
R2 Report Media Media type
Traveled distance for
u32, in
R3
sending report
meters
0 ~ 4Giga
0 ~ 4Giga
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
0 ~ 4Giga
0=disable
Motion
R7
R9
RA
RB
RC
E4
Automatic change
from motion mode to
on-line mode
Minimum distance to
be judged as moving
state
Turn off GSM module
in static state
Keep GPRS on-line in
static state
Keep GPRS on-line in
moving state
Interval in on-line state
for disconnecting and
then re-connecting
1/0
u16, in
meters
1/0
1/0
1/0
u16, in
seconds
0=disable
1=enable
0 ~ 65535
0=turn on GSM module
1=turn off GSM module
Available when RA=0
0=disable
1=enable
0=disable
1=enable
0=disable
E5 Interval for checking if
GPRS connection is
u16, in
seconds
0=disable
on-line. If GPRS
connection is cut,
20
TR-203 will try to
connect to server for
one time.
E6
RD
RE
RF
RG
Enable/disable TR-203
to send “OK” to server
after GPRS connection
is re-built.
Interval for switching
from validation to
static state
if no motion detected
Traveled distance to
be judged as keep in
moving state
Interval for switching
from moving to static
state
if no motion detected
Check GPS off time
setting (C7, C8, C9, CA
1/0
u16, in
seconds
u16,
Unit: meter
u16, in
seconds
1/0
0=disable
1=enable
Available when E5 is not 0
0=Interval is the same with R1
0=Interval is the same with R1
0=disable
1=enable
RH
GPS always on in
1/0
moving state
0=disable
1=enable
u32, in
W0 Start time
0 ~ 86400
seconds
u32, in
W1 End time
0 ~ 86400
seconds
u16, in
W2 Report interval
1 ~ 65535
seconds
Timer
Timer 0
00 ~ 7f
Weekday is in hex-digit format
u8, xx(hex
which specifies applicable day in
W3 Weekday mask
digits)
a week, where bit 0 represents
Sunday, bit1 represents Monday,
etc.
W4 Report Media Media typebit0=SMS
bit1=TCP
21
bit2=UDP
bit6=Action[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
Timer 1
X0 Start time
u32, in
seconds
u32, in
X1 End time
seconds
u16, in
X2 Report interval
seconds
u8, xx(hex
X3 Weekday mask
digits)
X4 Report Media Media type
0 ~ 86400
0 ~86400
1 ~ 65535
00 ~ 7f
Weekday is in hex-digit format
which specifies applicable day in
a week, where bit 0 represents
Sunday, bit1 represents Monday,
etc.
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
bit7=Action[1]
Timer 2
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
u32, in
Y0 Start time
0 ~ 86400
seconds
u32, in
Y1 End time
0 ~ 86400
seconds
u16, in
Y2 Report interval
1 ~ 65535
seconds
Y3 Weekday mask u8, xx(hex 00 ~ 7f
22
digits) Weekday is in hex-digit format
which specifies applicable day in
a week, where bit 0 represents
Sunday, bit1 represents Monday,
etc.
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
Timer 3
Y4 Report Media Media type
u32, in
Z0 Start time
seconds
u32, in
Z1 End time
seconds
u16, in
Z2 Report interval
seconds
u8, xx(hex
Z3 Weekday mask
digits)
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
0 ~ 86400
0 ~ 86400
1 ~ 65535
00 ~ 7f
Weekday is in hex-digit format
which specifies applicable day in
a week, where bit 0 represents
Sunday, bit1 represents Monday,
etc.
bit0=SMS
bit1=TCP
bit2=UDP
bit6=Action[0]
bit7=Action[1]
Z4 Report Media Media type
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
23
2.8 Command’s Codeword
Command’s Codeword
Codeword Parameters Description
M7 Set Standby Mode
M2 Set Periodic Mode
M3 Set On-Line mode
M4 Set Motion mode
M6 Set Parking mode
M1 Set Sleeping mode
M8 Set Off mode
N0 Set Timer
N1 Ping device
N4 Enable Voice Monitor
N6 Enable Geo-fence
N7 Disable Geo-fence
N8 Enable Data logger
N9 Disable Data logger
Na Dismiss SOS alarm
Nb Dismiss parking alarm
Nc Dismiss sleeping alarm
Ne Dismiss Geo-fence alarm
Nh Dismiss low battery alarm
Ni Dismiss All alarm
L1 Read Configuration
L3 Read Geo-fence
Make TR-203 connect to
L4
Server
Adding up to 1-5 parameters.
If parameter=(ALL), then all user
configuration data will be reported.
L5 Disconnect from Server
LA Restore default configuration
24
Restore all parameters to factory
value
LC Clear data logger
LH Re-Set device
(W)for writing current configuration
to default setting.
(phone_number,"00SMS
message")
LJ Send SMS message
SMS message are enclosed by
quotation marks. (“00” should be
added prior to the SMS message)
25
2.9 Report Media
Report media is the method that TR-203 sends report. No matter you send the
command by SMS or TCP or UDP, TR-203 will send the report via the report media.
bit0=SMS
bit1=TCP
bit2=UDP
bit5=USB
Report Media Media type
Action Media Type
bit 7 6 5=USB4 3 2=UDP 1=TCP 0=SMS
Ex 1
TCP
Ex 2
UDP
Ex 3
GPS
on
0 0 0 0 0 0 1 0
0 1 0 0 0 1 0 0
1 0 0 0 0 0 0 0
bit6=Action[0]
bit7=Action[1]
Action=00: report format 0
Action=01: report format 1
Action=10: GPS on
Action=11:
Example 1: Ask TR-203 to send on-line report with report interval of 5 minutes
(Q0=300) and report format 0 to TCP server (Q2=02).
GSC,011412000010789,M3(Q0=300,Q2=02)*07!
Example 2: Ask TR-203 to enter motion mode with static report interval of 7
minutes (R0=420) and moving report interval of 40 seconds (R1=40), report format
1 to UDP server (R2=44).
GSC,011412000010789,M4(R0=420,R1=40,R2=44)*71!
Example 3: Set Timer 1 to turn on GPS without sending report (X4=80), Start time:
26
09:00 AM (X0=32400), End time: 06:00 PM (X1=64800), Report interval: 1 hour
(X2=3600), Report day: from Monday ~Friday (X3=3E)
GSS,011412000012789,3,0,X0=32400,X1=64800,X2=3600,X3=3E,X4=80*53!
27
Loading...
+ 63 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.