Vous êtes sur la page 1sur 60

Doc.

Title Author Page of Pages

Device Communication Guide SE. Park 1 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Table of Contents
1. Status Report .................................................................................................................................. 3
1.1 Zip (HEX, fixed length) .................................................................................................................................... 3
1.2 Normal (ASCII, variable length) ....................................................................................................................... 8
2. Alert Report ................................................................................................................................... 12
2.1 Zip (HEX, fixed length) .................................................................................................................................. 12
2.2 Normal (ASCII, variable length) ..................................................................................................................... 17
2.3 Alert ID Table................................................................................................................................................. 21
3. Keep-Alive Report ......................................................................................................................... 26
3.1 Zip (HEX, fixed length) .................................................................................................................................. 26
3.2 Normal (ASCII, variable length) ..................................................................................................................... 26
4. External Serial Device Data Report (RS232) ............................................................................... 27
4.1 Zip (HEX, fixed length) .................................................................................................................................. 27
4.2 Normal (ASCII, variable length) ..................................................................................................................... 29
5. Transfer Data to External Serial ................................................................................................... 31
5.1 Send Format .................................................................................................................................................. 31
5.2 Response Format .......................................................................................................................................... 32
6. Travel Report................................................................................................................................. 32
6.1 Zip (HEX, fixed length) .................................................................................................................................. 32
6.2 Normal (ASCII, variable length) ..................................................................................................................... 35
7. Acknowledgment Message .......................................................................................................... 38
7.1 Zip (HEX, fixed length) .................................................................................................................................. 38
7.2 Normal (ASCII, variable length) ..................................................................................................................... 38
8. Crash Reconstruction Report (Optional) .................................................................................... 39
8.1 Send Format .................................................................................................................................................. 39
9. Maintenance Report...................................................................................................................... 41
10. Report for RF event .................................................................................................................... 41
10.1 Zip (HEX, fixed length) ................................................................................................................................ 41
10.2 Normal (ASCII, variable length) ................................................................................................................... 44
10.3 RF EVENT ID Table .................................................................................................................................... 46
11. CAM Report ................................................................................................................................. 46
11.1 Zip (HEX, fixed length) ................................................................................................................................ 46
11.2 Normal (ASCII, variable length) ................................................................................................................... 48
12. GED Report ................................................................................................................................. 50
13. Parameter Report ........................................................................................................................ 52
14. Small Assign Headers ................................................................................................................ 53
15. Medium Assign Headers ............................................................................................................ 55
16. Large Assign Headers ................................................................................................................ 57
Revisions .............................................................................................................................................. 58

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 2 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Suntech International Ltd.

CONFIDENTIAL DOCUMENT
This document belongs to intellectual property of Suntech International
Ltd. and shall neither be copied nor be given to any 3rd parties without
prior written consent from the company.
DO NOT MAKE ANY COPIES

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 3 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

1. Status Report

This report (‘Status Report’) is sent to the server periodically as defined by user to configure ‘status report’ if conditions for
issuing the report are met. The following two (2) tables show how one reporting can be made in 2 different types such as in
‘normal’ (string) and in ‘zip’.

1.1 Zip (HEX, fixed length)

Example (raw data):

81 00 32 03 60 00 00 01 3F FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27 93
18 3B 19 8F 0A 01 05 08 01 02 01 EC
HDR PKT_LEN DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE
(1 Byte) (2 Bytes) (5 Bytes) (3 Bytes) (1 Byte) (3 Bytes) (1 Byte)
DATE TIME CELL_ID MCC MNC LAC RX_LVL
(3 Bytes) (3 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (1 Byte)
LAT LON SPD CRS SATT FIX IN_STATE
(4 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (1 Byte) (1 Byte) (1 Byte)

OUT_STATE MODE STT_RPT_TYPE MSG_NUM reserved ASSIGN_MAP S_ASSIGN1


(1 Byte) (1 Byte) (1 Byte) (2 Bytes) (1byte) (4 Bytes) (2 Bytes)

S_ASSIGN2 S_ASSIGN3 S_ASSIGN4 S_ASSIGN5 S_ASSIGN6 S_ASSIGN7 S_ASSIGN8


(2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes)
S_ASSIGN9 S_ASSIGN10 S_ASSIGN11 S_ASSIGN12 S_ASSIGN13 S_ASSIGN14 S_ASSIGN15
(2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes)
M_ASSIGN1 M_ASSIGN2 M_ASSIGN3 M_ASSIGN4 M_ASSIGN5 M_ASSIGN6 M_ASSIGN7
(4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes)
M_ASSIGN8 L_ASSIGN1 L_ASSIGN2 L_ASSIGN3 L_ASSIGN4 L_ASSIGN5 L_ASSIGN6
(4 Bytes) (8 Bytes) (8 Bytes) (8 Bytes) (8 Bytes) (8 Bytes) (8 Bytes)
L_ASSIGN7 L_ASSIGN8
reserved
(8 Bytes) (8 Bytes)

Field Data Conversion Description


Header of Status Report.
HDR 81  81: No ACK response required
 91: Required ACK response
PKT_LEN 00 32 Length of zip data excluding HDR and PKT_LEN
Value: 0360000001
Device ID , BCD Format
DEV_ID 03 60 00 00 01 HEX
If the Device ID is 0360000001, this field will be filled with
0x03, 0x60, 0x00, 0x00 and 0x01.
Map of the headers that are included in the report
Bit 0: REPORT_MAP
Bit 1: MODEL
REPORT_MAP Bit 2: SW_VER
3F FF FF HEX -> BIN
(Map Bit 0) ….
Bit 21: MSG_NUM
Bit 22: reserved
Bit 23: ASSIGN_MAP
MODEL 24 HEX -> DEC
Value: 36
(Map Bit 1)
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 4 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Device Model (According to table model).

Model Identification Table


Model ID
ST4300 36
ST4500 46
ST4340 47
ST4340R 49
ST4340LC 52

SW_VER Value: 1.0.14


01 00 0E HEX -> DEC
(Map Bit 2) Software Version.
MSG_TYPE 01 HEX -> DEC
Real Time (1) Or Stored (0) Message
(Map Bit 3)
Value: 20161117
GPS Date (Year + Month + Day)
DATE 10 0B 11 HEX -> DEC Ex)
(Map Bit 4)
16 : 0x10
11 : 0x0B
17 : 0x11
Value: 08:37:39
Time (Hour + Minute + Second).
TIME 08 25 27 HEX -> DEC Ex)
(Map Bit 5)
08: 0x08
37: 0x25
39: 0x27
Value: 0000004F
CELL_ID Unique Id of Serving Cell.
00 00 00 4F HEX
(Map Bit 6) First 2 bytes are always 0 when the device connected to 2G
network.
MCC Value: 450
01 C2 HEX -> DEC
(Map Bit 7) Mobile Country Code
MNC Value: 0
00 00 HEX -> DEC
(Map Bit 8) Mobile Network Code
LAC Value: 0014
00 0E HEX -> DEC
(Map Bit 9) Location Area Code
RX_LVL Value: 20
14 HEX -> DEC
(Map Bit 10) Signal Strength (See table in Normal report above)
Value: +37.479323
Bit 31:
 1 = negative
LAT
(Map Bit 11)
02 3B E3 9B HEX -> DEC  0 = positive

To convert take HEX(02B3E39B) and convert to Decimal


value of 37,479,323 then divide by 1,000,000
LON Value: +126.887827
07 90 27 93 HEX -> DEC
(Map Bit 12) Bit 31:
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 5 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

 1 = negative
 0 = positive

To convert take HEX(07902793) and convert to Decimal


value of 126,887,827 then divide by 1,000,000
Value: 062.03
SPD 18 3B HEX -> DEC HEX(18 3B) = Decimal 6,203
(Map Bit 13)
Take the decimal value and divide by 100 to get 62.03km/h
Value: 65.43
CRS HEX(19 8F) = Decimal 6,543
19 8F HEX -> DEC
(Map Bit 14) Take the decimal value and divide by 100 to get 65.43
degrees
SATT 0A HEX -> DEC
Number of GPS Satellites
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
01 HEX -> DEC
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
In7 In6 In5 In4 In3 In2 In1 IGN
IN_STATE 05 HEX -> BIN
(Map Bit 17) Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1

The Output State is indicated according to the Output Active


setting and the Output Active State.
OUT_STATE 08 HEX -> BIN
(Map Bit 18)
Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent


in the Active state.
Mode the Device is in:
 0 = Parking
 1 = Driving
MODE 01 HEX -> DEC  2 = Idle
(Map Bit 19)
 3=Speeding
 4=Tow

Type of Report
 0 = Response by CMD request
STT_RPT_TYPE 02 HEX -> DEC  1 = Time
(Map Bit 20)
 2 = Distance
 3 = Angle/Heading
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 6 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Value: 0492
MSG_NUM 01 EC HEX -> DEC Message number.
(Map Bit 21)
After 9999, message number returns to 0.
reserved Reserved field (reports with FF if enabled)
(Map Bit 22)
Map of the custom assignable headers that can be included
at the end of the standard report format.

See Tables for Small, Medium, and Large Assign option


below for more information

Bit 0: S_ASSIGN1 (2 Bytes)


Bit 1: S_ASSIGN2 (2 Bytes)
ASSIGN_MAP HEX -> BIN ….
(Map Bit 23)
Bit 14: S_ASSIGN15 (2 Bytes)
Bit 15: M_ASSIGN1 (4 Bytes)
….
Bit 22: M_ASSIGN8 (4 Bytes)
Bit 23: L_ASSIGN1 (8 Bytes)

Bit 30: L_ASSIGN8 (8 Bytes)
Bit 31: reserved
S_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 0)  See options in table 5 below
S_ASSIGN2
(Assign_Map Bit 1)
S_ASSIGN3
(Assign_Map Bit 2)
S_ASSIGN4
(Assign_Map Bit 3)
S_ASSIGN5
(Assign_Map Bit 4)
S_ASSIGN6
(Assign_Map Bit 5)
S_ASSIGN7
(Assign_Map Bit 6)
S_ASSIGN8
(Assign_Map Bit 7)
S_ASSIGN9
(Assign_Map Bit 8)
S_ASSIGN10
(Assign_Map Bit 9)
S_ASSIGN11
(Assign_Map Bit 10)
S_ASSIGN12
(Assign_Map Bit 11)
S_ASSIGN13
(Assign_Map Bit 12)
S_ASSIGN14
(Assign_Map Bit 13)
S_ASSIGN15 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 14)  See options in table 5 below
M_ASSIGN1 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 15)
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 7 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

 See options in table 6 below


M_ASSIGN2
(Assign_Map Bit 16)
M_ASSIGN3
(Assign_Map Bit 17)
M_ASSIGN4
(Assign_Map Bit 18)
M_ASSIGN5
(Assign_Map Bit 19)
M_ASSIGN6
(Assign_Map Bit 20)
M_ASSIGN7
(Assign_Map Bit 21)
M_ASSIGN8 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 22)  See options in table 6 below
L_ASSIGN1 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 23)  See options in table 7 below
L_ASSIGN2
(Assign_Map Bit 24)
L_ASSIGN3
(Assign_Map Bit 25)
L_ASSIGN4
(Assign_Map Bit 26)
L_ASSIGN5
(Assign_Map Bit 27)
L_ASSIGN6
(Assign_Map Bit 28)
L_ASSIGN7
(Assign_Map Bit 29)
L_ASSIGN8 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 30)  See options in table 7 below
reserved reserved

<Examples> (When a MAP header is included it will be underlined)

CASE 1: Minimal Data Status Report Example


81 00 21 03 60 00 00 01 39 F8 39 01 10 0B 11 08 25 27 02 3B E3 9B 07 90 27 93 18 3B 19 8F 0A 01 01 02 01 EC

CASE 2: Minimal Data Status Report Example & Status Report Map Removed
81 00 1E 03 60 00 00 01 01 10 0B 11 08 25 27 02 3B E3 9B 07 90 27 93 18 3B 19 8F 0A 01 01 02 01 EC

CASE 3: Standard Status Report Example with added assign options below
 S_ASSIGN1 = BCK_VOLT, S_ASSIGN2 = PWR_VOLT, L_ASSIGN1 = DID
81 00 42 03 60 00 00 01 BF FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27
93 18 3B 19 8F 0A 01 05 08 01 02 01 EC 00 80 00 03 00 24 04 AA 50 00 00 19 3E 0C CD 01

CASE 4: Standard Status Report Example with added assign options below
 S_ASSIGN1 = BCK_VOLT, S_ASSIGN2 = PWR_VOLT, L_ASSIGN1 = DID
 ASSIGN_MAP removed from report
81 00 3E 03 60 00 00 01 3F FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27
93 18 3B 19 8F 0A 01 05 08 01 02 01 EC 00 24 04 AA 50 00 00 19 3E 0C CD 01

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 8 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

1.2 Normal (ASCII, variable length)

Example Raw Zip Data:


81 00 32 03 60 00 00 01 3F FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27 93
18 3B 19 8F 0A 01 05 08 01 02 01 EC
Example Normal Data (ASCII):
STT;0360000001;3FFFFF;36;1.0.14;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10;
1;00000101;00001000;1;2;0492
HDR DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE DATE
TIME CELL_ID MCC MNC LAC RX_LVL LAT
LON SPD CRS SATT FIX IN_STATE OUT_STATE
MODE STT_RPT_TYPE MSG_NUM reserved ASSIGN_MAP S_ASSIGN1 S_ASSIGN2
S_ASSIGN3 S_ASSIGN4 S_ASSIGN5 S_ASSIGN6 S_ASSIGN7 S_ASSIGN8 S_ASSIGN9
S_ASSIGN10 S_ASSIGN11 S_ASSIGN12 S_ASSIGN13 S_ASSIGN14 S_ASSIGN15 M_ASSIGN1
M_ASSIGN2 M_ASSIGN3 M_ASSIGN4 M_ASSIGN5 M_ASSIGN6 M_ASSIGN7 M_ASSIGN8
L_ASSIGN1 L_ASSIGN2 L_ASSIGN3 L_ASSIGN4 L_ASSIGN5 L_ASSIGN6 L_ASSIGN7
L_ASSIGN8 reserved

Field Data Max Length Description


Header of Status Report.
HDR STT 3-4 char  STT: No ACK response required
 ASTT: Required ACK response
DEV_ID 0360000001 10 char Device ID.
Map of the headers that are included in the report
Bit 0: REPORT_MAP
Bit 1: MODEL
REPORT_MAP Bit 2: SW_VER
3FFFFF 6 char
(Map Bit 0) ….
Bit 21: MSG_NUM
Bit 22: reserved
Bit 23: ASSIGN_MAP
MODEL 36 2 char Device Model (According to table model).
(Map Bit 1)
SW_VER 1.0.14 String Number of the released Software Version.
(Map Bit 2)
MSG_TYPE 1 1 char Report is real time (1); Report is storage (0).
(Map Bit 3)
DATE 20161117 8 char GPS date yyyymmdd or (Year + Month + Day)
(Map Bit 4)
TIME 08:37:39 8 char GPS time hh:mm:ss or (Hour : Minute : Second)
(Map Bit 5)
Unique ID of Serving Cell. 8 digit hex
CELL_ID 0000004F 8 char First 4 digits are always 0 when the device connected to 2G
(Map Bit 6)
network.
MCC 450 String Mobile Country Code. 0 ~ 65535
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 9 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(Map Bit 7)
MNC 0 String Mobile Network Code. 0 ~ 65535
(Map Bit 8)
LAC 0014 4 char Location Area Code. 4 digits hex
(Map Bit 9)
Signal Strength.
0 ~ 63 in 2G.
0: less than -110 dBm
1: -110 to -019 dBm
……
62: -49 to -48 dBm
RX_LVL 63: greater than -48 dBm
20 String
(Map Bit 10)
0 ~ 65 in 3G/4G.
0: less than -105 dBm
1: -104 to -103 dBm
……
64: -41 to -40 dBm
65: greater than -40 dBm
LAT +37.479323 String Latitude (+/-xx.xxxxxx).
(Map Bit 11)
LON +126.887827 String Longitude (+/-xxx.xxxxxx).
(Map Bit 12)
SPD 62.03 String Speed in km/h. (1 km/h = 0.621371 mph)
(Map Bit 13)
CRS 65.43 String Course on the ground in degree.
(Map Bit 14)
SATT 10 String Number of GPS satellites.
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
1 1 char
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
In7 In6 In5 In4 In3 In2 In1 IGN
IN_STATE 00000101 String
(Map Bit 17)
Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1

The Output State is indicated according to the Output Active


setting and the Output Active State.
OUT_STATE 00001000 String
(Map Bit 18)
Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent in the
Active state.
MODE 1 1 char Mode the Device is in:

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 10 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(Map Bit 19)  0 = Parking


 1 = Driving
 2 = Idle
 3=Speeding
 4=Towing

Type of Report:
 0 = Response by CMD request
STT_RPT_TYPE 2 1 char  1 = Time
(Map Bit 20)
 2 = Distance
 3 = Angle/Heading
MSG_NUM Message number.
0492 4 char
(Map Bit 21) After “9999” is reported, message number returns to “0000”
reserved Reserved field (reports blank if enabled)
(Map Bit 22)
Map of the custom assignable headers that can be included at
the end of the standard report format.

See Tables for Small, Medium, and Large Assign option below for
more information

Bit 0: S_ASSIGN1 (2 Bytes)


Bit 1: S_ASSIGN2 (2 Bytes)
ASSIGN_MAP HEX -> BIN ….
(Map Bit 23)
Bit 14: S_ASSIGN15 (2 Bytes)
Bit 15: M_ASSIGN1 (4 Bytes)
….
Bit 22: M_ASSIGN8 (4 Bytes)
Bit 23: L_ASSIGN1 (8 Bytes)

Bit 30: L_ASSIGN8 (8 Bytes)
Bit 31: reserved
S_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 0)  See options in table 5 below
S_ASSIGN2
(Assign_Map Bit 1)
S_ASSIGN3
(Assign_Map Bit 2)
S_ASSIGN4
(Assign_Map Bit 3)
S_ASSIGN5
(Assign_Map Bit 4)
S_ASSIGN6
(Assign_Map Bit 5)
S_ASSIGN7
(Assign_Map Bit 6)
S_ASSIGN8
(Assign_Map Bit 7)
S_ASSIGN9
(Assign_Map Bit 8)
S_ASSIGN10
(Assign_Map Bit 9)
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 11 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

S_ASSIGN11
(Assign_Map Bit 10)
S_ASSIGN12
(Assign_Map Bit 11)
S_ASSIGN13
(Assign_Map Bit 12)
S_ASSIGN14
(Assign_Map Bit 13)
S_ASSIGN15 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 14)  See options in table 5 below
M_ASSIGN1 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 15)  See options in table 6 below
M_ASSIGN2
(Assign_Map Bit 16)
M_ASSIGN3
(Assign_Map Bit 17)
M_ASSIGN4
(Assign_Map Bit 18)
M_ASSIGN5
(Assign_Map Bit 19)
M_ASSIGN6
(Assign_Map Bit 20)
M_ASSIGN7
(Assign_Map Bit 21)
M_ASSIGN8 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 22)  See options in table 6 below
L_ASSIGN1 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 23)  See options in table 7 below
L_ASSIGN2
(Assign_Map Bit 24)
L_ASSIGN3
(Assign_Map Bit 25)
L_ASSIGN4
(Assign_Map Bit 26)
L_ASSIGN5
(Assign_Map Bit 27)
L_ASSIGN6
(Assign_Map Bit 28)
L_ASSIGN7
(Assign_Map Bit 29)
L_ASSIGN8 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 30)  See options in table 7 below
reserved reserved

<Examples> (When a MAP header is included it will be underlined)

CASE 1: Minimal Data Report Example


STT;0360000001;39F839;1;20161117;08:37:39;+37.479323;+126.887827;62.03;65.43;10;1;1;2;0492

CASE 2: Minimal Data Report Example & Status Report Map Removed
STT;0360000001;1;20161117;08:37:39;+37.479323;+126.887827;62.03;65.43;10;1;1;2;0492

CASE 3: Standard Report Example with added assign options below

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 12 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

 S_ASSIGN1 = BCK_VOLT, S_ASSIGN2 = PWR_VOLT, L_ASSIGN1 = DID


STT;0360000001;BFFFFF;36;010;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10
;1;00000101;00001000;1;2;0492;800003;3.6;11.94;500000193E0CCD01

CASE 4: Standard Report Example with added assign options below


 S_ASSIGN1 = BCK_VOLT, S_ASSIGN2 = PWR_VOLT, L_ASSIGN1 = DID
 ASSIGN_MAP removed from report
STT;0360000001;3FFFFF;36;010;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10;
1;00000101;00001000;1;2;0492;3.6;11.94;500000193E0CCD01

2. Alert Report
Device sends ‘Alert’ to the server as defined by user in the course of setting the relevant parameters. Most of cases that
requiring an alert to be issued means that the vehicle or asset or its driver is in danger or is almost in danger that should be
notified by device to the server and/or the cellular phone (If communication via SMS has been configured) for warning.

Have a close look at the fields from the following table for more information on when and what alerts are triggered.

2.1 Zip (HEX, fixed length)


Example (raw data):
82 00 33 03 60 00 00 01 3F FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27 93
18 3B 19 8F 0A 01 05 08 4B 03 02 00 DF
HDR PKT_LEN DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE
(1 Byte) (2 Bytes) (5 Bytes) (3 Bytes) (1 Byte) (3 Bytes) (1 Byte)
DATE TIME CELL_ID MCC MNC LAC RX_LVL
(3 Bytes) (3 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (1 Byte)
LAT LON SPD CRS SATT FIX IN_STATE
(4 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (1 Byte) (1 Byte) (1 Byte)

OUT_STATE ALERT_ID ALERT_MOD reserved ASSIGN_MAP


ALERT_DATA S_ASSIGN1
(1 Byte) (1 Byte) (2 Bytes) (1byte) (4 Bytes)

S_ASSIGN2 S_ASSIGN3 S_ASSIGN4 S_ASSIGN5 S_ASSIGN6 S_ASSIGN7 S_ASSIGN8


(2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes)
S_ASSIGN9 S_ASSIGN10 S_ASSIGN11 S_ASSIGN12 S_ASSIGN13 S_ASSIGN14 S_ASSIGN15
(2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (2 Bytes)
M_ASSIGN1 M_ASSIGN2 M_ASSIGN3 M_ASSIGN4 M_ASSIGN5 M_ASSIGN6 M_ASSIGN7
(4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes)
M_ASSIGN8 L_ASSIGN1 L_ASSIGN2 L_ASSIGN3 L_ASSIGN4 L_ASSIGN5 L_ASSIGN6
(4 Bytes) (8 Bytes) (8 Bytes) (8 Bytes) (8 Bytes) (8 Bytes) (8 Bytes)
L_ASSIGN7 L_ASSIGN8
reserved
(8 Bytes) (8 Bytes)

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 13 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Field Data Conversion Description


Header of Alert Report.
HDR 82  82: No ACK response required
 92: Required ACK response
PKT_LEN 00 33 Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
DEV_ID 03 60 00 00 01 HEX
Device ID
Map of the headers that are included in the report
Bit 0: REPORT_MAP
Bit 1: MODEL
REPORT_MAP Bit 2: SW_VER
3F FF FF HEX -> BIN
(Map Bit 0) ….
Bit 21: ALERT_DATA
Bit 22: reserved
Bit 23: ASSIGN_MAP
MODEL Value: 36
24 HEX -> DEC
(Map Bit 1) Device Model (According to table model).
SW_VER Value: 1.0.14
01 00 0E HEX -> DEC
(Map Bit 2) Software Version.
MSG_TYPE 01 HEX -> DEC
Real Time (1) Or Stored (0) Message
(Map Bit 3)
DATE Value: 20161117
10 0B 11 HEX -> DEC
(Map Bit 4) GPS Date (Year + Month + Day).
TIME Value: 08:37:39
08 25 27 HEX -> DEC
(Map Bit 5) Time (Hour + Minute + Second).
Value: 0000004F
CELL_ID Unique Id of Serving Cell.
00 00 00 4F HEX
(Map Bit 6) First 2 bytes are always 0 when the device connected to 2G
network.
MCC Value: 450
01 C2 HEX -> DEC
(Map Bit 7) Mobile Country Code
MNC Value: 0
00 00 HEX -> DEC
(Map Bit 8) Mobile Network Code
LAC Value: 0014
00 0E HEX -> DEC
(Map Bit 9) Location Area Code
RX_LVL Value: 20
14 HEX -> DEC
(Map Bit 10) Signal Strength (See table in Normal report above)
Value: +37.479323
Bit 31:
 1 = negative
LAT
(Map Bit 11)
02 3B E3 9B HEX -> DEC  0 = positive

To convert take HEX(02B3E39B) and convert to Decimal


value of 37,479,323 then divide by 1,000,000
Value: +126.887827
Bit 31:
LON  1 = negative
07 90 27 93 HEX -> DEC
(Map Bit 12)  0 = positive

To convert take HEX(07902793) and convert to Decimal

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 14 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

value of 126,887,827 then divide by 1,000,000


Value: 062.03
SPD 18 3B HEX -> DEC HEX(18 3B) = Decimal 6,203
(Map Bit 13)
Take the decimal value and divide by 100 to get 62.03km/h
Value: 65.43
CRS HEX(19 8F) = Decimal 6,543
19 8F HEX -> DEC
(Map Bit 14) Take the decimal value and divide by 100 to get 65.43
degrees
SATT 0A HEX -> DEC
Number of GPS Satellites
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
01 HEX -> DEC
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
In7 In6 In5 In4 In3 In2 In1 IGN
IN_STATE 05 HEX -> BIN
(Map Bit 17)
Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1

The Output State is indicated according to the Output Active


setting and the Output Active State.
OUT_STATE 08 HEX -> BIN
(Map Bit 18)
Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent


in the Active state.
Value: 75
ALERT_ID 4B HEX -> DEC Alert ID Number:
(Map Bit 19)
 See Alert ID Table
Contains Modifier for certain Alert IDs
 First Byte: Contains Number 1-8 of Temp
sensor that triggered Alert ID 75, 76, or 77,
Input that that triggers Alert ID of Input High
ALERT_MOD 03 02 HEX -> DEC or Input Low, etc.
(Map Bit 20)  Second Byte: Length of the ALT_DATA

Note) For details on data of other IDs, refer to Chapter 2.3


below.

Contains Data for certain Alert IDs


 RFID tag number
ALERT_DATA
(Map Bit 21)
00 DF HEX -> DEC  Driver ID number
 Temperature Data

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 15 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Note) For details on data of other IDs, refer to Chapter 2.3


below.

reserved Reserved field (reports with FF if enabled)


(Map Bit 22)
Map of the custom assignable headers that can be included
at the end of the standard report format.

See Tables for Small, Medium, and Large Assign option


below for more information

Bit 0: S_ASSIGN1 (2 Bytes)


Bit 1: S_ASSIGN2 (2 Bytes)
ASSIGN_MAP HEX -> BIN ….
(Map Bit 23)
Bit 14: S_ASSIGN15 (2 Bytes)
Bit 15: M_ASSIGN1 (4 Bytes)
….
Bit 22: M_ASSIGN8 (4 Bytes)
Bit 23: L_ASSIGN1 (8 Bytes)

Bit 30: L_ASSIGN8 (8 Bytes)
Bit 31: reserved
S_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 0)  See options in table 5 below
S_ASSIGN2
(Assign_Map Bit 1)
S_ASSIGN3
(Assign_Map Bit 2)
S_ASSIGN4
(Assign_Map Bit 3)
S_ASSIGN5
(Assign_Map Bit 4)
S_ASSIGN6
(Assign_Map Bit 5)
S_ASSIGN7
(Assign_Map Bit 6)
S_ASSIGN8
(Assign_Map Bit 7)
S_ASSIGN9
(Assign_Map Bit 8)
S_ASSIGN10
(Assign_Map Bit 9)
S_ASSIGN11
(Assign_Map Bit 10)
S_ASSIGN12
(Assign_Map Bit 11)
S_ASSIGN13
(Assign_Map Bit 12)
S_ASSIGN14
(Assign_Map Bit 13)
S_ASSIGN15 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 14) See options in table 5 below
M_ASSIGN1 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 15)

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 16 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

 See options in table 6 below


M_ASSIGN2
(Assign_Map Bit 16)
M_ASSIGN3
(Assign_Map Bit 17)
M_ASSIGN4
(Assign_Map Bit 18)
M_ASSIGN5
(Assign_Map Bit 19)
M_ASSIGN6
(Assign_Map Bit 20)
M_ASSIGN7
(Assign_Map Bit 21)
M_ASSIGN8 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 22)  See options in table 6 below
L_ASSIGN1 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 23)  See options in table 7 below
L_ASSIGN2
(Assign_Map Bit 24)
L_ASSIGN3
(Assign_Map Bit 25)
L_ASSIGN4
(Assign_Map Bit 26)
L_ASSIGN5
(Assign_Map Bit 27)
L_ASSIGN6
(Assign_Map Bit 28)
L_ASSIGN7
(Assign_Map Bit 29)
L_ASSIGN8 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 30)  See options in table 7 below
reserved reserved

<Examples> (When a MAP header is included it will be underlined)

CASE 1: Minimal Data Alert ID Report Example


82 00 1E 03 60 00 00 01 39 98 39 01 10 0B 11 08 25 27 02 3B E3 9B 07 90 27 93 0A 01 4B 03 02 00 DF

CASE 2: Minimal Data Alert ID Report Example & Status Report Map Removed
82 00 1B 03 60 00 00 01 01 10 0B 11 08 25 27 02 3B E3 9B 07 90 27 93 0A 01 4B 03 02 00 DF

CASE 3: Standard Alert ID Report Example with added assign options below
 S_ASSIGN3 = ADC_1, S_ASSIGN8 = TEMP_1, L_ASSIGN3 = TEMPID_1
82 00 43 03 60 00 00 01 BF FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27
93 18 3B 19 8F 0A 01 05 08 4B 03 02 00 DF 02 00 00 84 02 F8 01 14 15 00 00 00 45 0F B8 42

CASE 4: Standard Alert ID Report Example with added assign options below
 S_ASSIGN3 = ADC_1, S_ASSIGN8 = TEMP_1, L_ASSIGN3 = TEMPID_1
 ASSIGN_MAP removed from report
82 00 3F 03 60 00 00 01 BF FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27
93 18 3B 19 8F 0A 01 05 08 4B 03 02 00 DF 02 F8 01 14 15 00 00 00 45 0F B8 42

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 17 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

2.2 Normal (ASCII, variable length)


Example Zip Data:
82 00 33 03 60 00 00 01 3F FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27 93
18 3B 19 8F 0A 01 05 08 4B 03 02 00 DF
Example Normal Data (ASCII):
ALT;0360000001;3FFFFF;36;1.0.14;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10;
1;00000101;00001000;75;3;+22.3
HDR DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE DATE
TIME CELL_ID MCC MNC LAC RX_LVL LAT
LON SPD CRS SATT FIX IN_STATE OUT_STATE
ALERT_ID ALERT_MOD ALERT_DATA reserved ASSIGN_MAP S_ASSIGN1 S_ASSIGN2
S_ASSIGN3 S_ASSIGN4 S_ASSIGN5 S_ASSIGN6 S_ASSIGN7 S_ASSIGN8 S_ASSIGN9
S_ASSIGN10 S_ASSIGN11 S_ASSIGN12 S_ASSIGN13 S_ASSIGN14 S_ASSIGN15 M_ASSIGN1
M_ASSIGN2 M_ASSIGN3 M_ASSIGN4 M_ASSIGN5 M_ASSIGN6 M_ASSIGN7 M_ASSIGN8
L_ASSIGN1 L_ASSIGN2 L_ASSIGN3 L_ASSIGN4 L_ASSIGN5 L_ASSIGN6 L_ASSIGN7
L_ASSIGN8 reserved

Field Data Max Length Description


Header of Alert Report.
HDR ALT 3-4 char  ALT: No ACK response required
 AALT: Required ACK response
DEV_ID 0360000001 10 char Device ID.
Map of the headers that are included in the report
Bit 0: REPORT_MAP
Bit 1: MODEL
Bit 2: SW_VER
REPORT_MAP 3FFFFF 6 char
….
Bit 21: ALERT_DATA
Bit 22: reserved
Bit 23: ASSIGN_MAP
MODEL 36 2 char Device Model (According to table model).
(Map Bit 1)
SW_VER 1.0.14 String Number of the released Software Version.
(Map Bit 2)
MSG_TYPE 1 1 char Report is real time (1); Report is storage (0).
(Map Bit 3)
DATE 20161117 8 char GPS date yyyymmdd or (Year + Month + Day)
(Map Bit 4)
TIME 08:37:39 8 char GPS time hh:mm:ss or (Hour : Minute : Second)
(Map Bit 5)
Unique ID of Serving Cell. 8 digit hex
CELL_ID 0000004F 8 char First 4 digits are always 0 when the device connected to 2G
(Map Bit 6)
network.
MCC 450 String Mobile Country Code. 0 ~ 65535

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 18 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(Map Bit 7)
MNC 0 String Mobile Network Code. 0 ~ 65535
(Map Bit 8)
LAC 0014 4 char Location Area Code. 4 digits hex
(Map Bit 9)
Signal Strength.
0 ~ 63 in 2G.
0: less than -110 dBm
1: -110 to -019 dBm
……
62: -49 to -48 dBm
RX_LVL 63: greater than -48 dBm
20 String
(Map Bit 10)
0 ~ 65 in 3G/4G.
0: less than -105 dBm
1: -104 to -103 dBm
……
64: -41 to -40 dBm
65: greater than -40 dBm
LAT +37.479323 String Latitude (+/-xx.xxxxxx).
(Map Bit 11)
LON +126.887827 String Longitude (+/-xxx.xxxxxx).
(Map Bit 12)
SPD 62.03 String Speed in km/h. (1 km/h = 0.621371 mph)
(Map Bit 13)
CRS 65.43 String Course on the ground in degree.
(Map Bit 14)
SATT 10 String Number of GPS satellites.
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
1 1 char
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
In7 In6 In5 In4 In3 In2 In1 IGN
IN_STATE 00000101 String
(Map Bit 17)
Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1

The Output State is indicated according to the Output Active


setting and the Output Active State.
OUT_STATE 00001000 String
(Map Bit 18)
Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent in the
Active state.
ALERT_ID 75 1 char Alert ID Number:

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 19 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(Map Bit 19)  See Alert ID Table


Contains Modifier for certain Alert IDs
 Number 1-8 of Temp sensor that triggered Alert ID
75, 76, or 77
 Input that triggers Alert ID of Input High or Input
ALERT_MOD 3 String
(Map Bit 20) Low

Note) For details on data of other IDs, refer to Chapter 2.3


below.

Contains Data for certain Alert IDs


 RFID tag number
 Driver ID number
ALERT_DATA +22.3 String  Temperature Data
(Map Bit 21) 
Note) For details on data of other IDs, refer to Chapter 2.3
below.

reserved Reserved field (reports blank if enabled)


(Map Bit 22)
Map of the custom assignable headers that can be included at
the end of the standard report format.

See Tables for Small, Medium, and Large Assign option below for
more information

Bit 0: S_ASSIGN1 (2 Bytes)


Bit 1: S_ASSIGN2 (2 Bytes)
ASSIGN_MAP HEX -> BIN ….
(Map Bit 23)
Bit 14: S_ASSIGN15 (2 Bytes)
Bit 15: M_ASSIGN1 (4 Bytes)
….
Bit 22: M_ASSIGN8 (4 Bytes)
Bit 23: L_ASSIGN1 (8 Bytes)

Bit 30: L_ASSIGN8 (8 Bytes)
Bit 31: reserved
S_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 0)  See options in table 5 below
S_ASSIGN2
(Assign_Map Bit 1)
S_ASSIGN3
(Assign_Map Bit 2)
S_ASSIGN4
(Assign_Map Bit 3)
S_ASSIGN5
(Assign_Map Bit 4)
S_ASSIGN6
(Assign_Map Bit 5)
S_ASSIGN7
(Assign_Map Bit 6)

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 20 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

S_ASSIGN8
(Assign_Map Bit 7)
S_ASSIGN9
(Assign_Map Bit 8)
S_ASSIGN10
(Assign_Map Bit 9)
S_ASSIGN11
(Assign_Map Bit 10)
S_ASSIGN12
(Assign_Map Bit 11)
S_ASSIGN13
(Assign_Map Bit 12)
S_ASSIGN14
(Assign_Map Bit 13)
S_ASSIGN15 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 14) See options in table 5 below
M_ASSIGN1 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 15)  See options in table 6 below
M_ASSIGN2
(Assign_Map Bit 16)
M_ASSIGN3
(Assign_Map Bit 17)
M_ASSIGN4
(Assign_Map Bit 18)
M_ASSIGN5
(Assign_Map Bit 19)
M_ASSIGN6
(Assign_Map Bit 20)
M_ASSIGN7
(Assign_Map Bit 21)
M_ASSIGN8 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 22)  See options in table 6 below
L_ASSIGN1 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 23)  See options in table 7 below
L_ASSIGN2
(Assign_Map Bit 24)
L_ASSIGN3
(Assign_Map Bit 25)
L_ASSIGN4
(Assign_Map Bit 26)
L_ASSIGN5
(Assign_Map Bit 27)
L_ASSIGN6
(Assign_Map Bit 28)
L_ASSIGN7
(Assign_Map Bit 29)
L_ASSIGN8 Custom Large Assignable Header (8 Bytes in length)
(Assign_Map Bit 30)  See options in table 7 below
reserved reserved

<Examples> (When a MAP header is included it will be underlined)

CASE 1: Minimal Data Report Example


ALT;0360000001;399839;1;20161117;08:37:39;+37.479323;+126.887827;10;1;1;2;0492
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 21 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

CASE 2: Minimal Data Report Example & Status Report Map Removed
ALT;0360000001;1;20161117;08:37:39;+37.479323;+126.887827;10;1;1;2;0492

CASE 3: Standard Report Example with added assign options below


 MINI_ASSIGN_3 = ADC_1, MINI_ASSIGN_8 = TEMP_1, ASSIGN_3 = TEMPID_1
ALT;0360000001;BFFFFF;26;010;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10
;1;00000101;00001000;1;2;0492;400084;7.60;+27.6;15000000450FB842

CASE 4: Standard Report Example with added assign options below


 MINI_ASSIGN_3 = ADC_1, MINI_ASSIGN_8 = TEMP_1, ASSIGN_3 = TEMPID_1
 ASSIGN_MAP removed from report
ALT;0360000001;3FFFFF;26;010;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10
;1;00000101;00001000;1;2;0492;7.60;+27.6;15000000450FB842

2.3 Alert ID Table


Name Description Alert ID Alert Mod Alert Data
(default)
Alert is sent when the vehicle is traveling over the
Over Speed 1 FF 00 -
defined speed 1 threshold (Parameter #1621)
Alert is sent when the vehicle transitions back under
Under Speed 2 FF 00 -
the defined speed 1 threshold (Parameter #1621)
GPS Antenna Alert is sent when the external GPS antenna has
3 FF 00 -
Disconnected become disconnected
GPS Antenna Alert is sent when the external GPS antenna has been
4 FF 00 -
Connected connected
Alert is sent when the vehicle exits a defined Geo- Geo-Fence ID
Fence (1-255)
Exit Geo-Fence 5 ZIP (1BYTE) + 00 -

Ex) 1A 00
Alert is sent when the vehicle enters a defined Geo- Geo-Fence ID
Fence (1-255)
Enter Geo-Fence 6 ZIP(1BYTE) + 00 -

Ex) 1A 00
Alert is sent if a short is detected on the external GPS
GPS Antenna Shorted 8 FF 00 -
antenna
Alert is sent when device is going into Sleep Mode 1 = Deep Sleep
2 = Sleep
Enter Sleep 9 -
ZIP(1BYTE)) + 00

Ex) 01 00
Alert is sent when the device is coming out of Sleep
Exit Sleep 10 FF 00 -
Mode
Input High Alert is sent when the input is pulled high 11 # of the Input Line -
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 22 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

11 : ST25T Input 1
12 : ST25T Input 2

ZIP(1BYTE) + 00

Ex) 02 00
Alert is sent when the input is pulled low to ground # of the Input Line

11 : ST25T Input 1
12 : ST25T Input 2
Input Low 12 -
ZIP(1BYTE) + 00

Ex) 02 00
Alert is sent due to one of the reason that described
below.
Battery Error * backup-battery temperature is too high. 13 FF 00 -
* backup-battery voltage is too high.
* backup-battery charging fail.
Alert is sent when vehicle battery voltage drops below
Battery Low 14 FF 00 -
the ‘Low Battery Threshold’ in Power.
Alert is sent when the device detect the impact that
stronger than the ‘Shock threshold’ in Accelerometer.
Shocked 15 FF 00 -
It happens after time passes amount of shock
detection delay from the parking state starts.
Alert is sent when the device detect the impact that
Crash Detected stronger than the ‘Collision threshold’ in 16 FF 00 -
Accelerometer.
Ignition On Alert is sent when the Ignition Input is pulled high 33 FF 00 -
Ignition Off Alert is sent when the Ignition Input is pulled low 34 FF 00 -
Alert is sent when main power has been connected to
Power Connected 40 FF 00 -
the device
Alert is sent when main power had been disconnected
Power Disconnected 41 FF 00 -
from the device
Alert is sent when the Back-Up Battery has been
Battery Connected 44 FF 00 -
connected
Alert is sent when the Back-Up Battery has been
Battery Disconnected 45 FF 00 -
disconnected
Engine Exceed Speed Alert is sent when Engine Exceed Speed 61 FF 00 -
Engine Vehicle Speed Alert is sent when Engine Vehicle Speed
62 FF 00 -
Violation Violation
Engine Coolant Alert is sent when Engine Coolant
63 FF 00 -
Temperature Violation Temperature Violation
Engine Oil Pressure Alert is sent when Engine Oil Pressure Violation
64 FF 00 -
Violation
Engine RPM Violation Alert is sent when RPM Violation 65 FF 00 -
Engine Error Code DTC Alert is sent when Error Code DTC 66 FF 00 -
ST25T Connect Alert is sent when ST25T is connected 85 FF 00 -
ST25T Disconnect Alert is sent when ST25T is disconnected 86 FF 00 -
RS232 Fuel Net Address Alert is sent when RS232 Fuel Net Address Scan Fail Fuel Sensor
87
Scan Fail Number
Alert is sent when RS232 Fuel Max Level Excess
0:RS232 1 -
RS232 Fuel Max Level
88 1:RS232 2
Excess
ZIP(1BYTE) + 00
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 23 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Ex) 01 00
Fuel Connect Alert is sent when Fuel is connected 89 Fuel Sensor
Fuel Disconnect Alert is sent when Fuel is disconnected 90 Number
Fuel Level Lower Alert is sent when Fuel level is lower 91
Alert is sent when Fuel level is upper 0:RS232 1
1:RS232 2
2:RS485 1
3:RS485 2
4:RS485 3
Fuel Level Upper 92
5:RS485 4

ZIP(1BYTE) + 00

Ex) 05 00
Alert is sent when ST20M is connected
ST20M Connect 70 FF 00 -

Alert is sent when ST20M is disconnected


ST20M Disconnect 71 FF 00 -
Alert is sent when the vehicle exits a defined Poly Geo- Geo-Fence ID
Fence (1-30)
Exit PolyGeo-Fence 74 ZIP (1BYTE) + 00 -

Ex) 1A 00
Alert is sent when the vehicle enters a defined Poly Geo-Fence ID
Geo-Fence (1-30)
Enter PolyGeo-Fence 79 ZIP(1BYTE) + 00 -

Ex) 1A 00
Alert is sent when the speed is over a defined Poly Geo- Geo-Fence ID
Fence (1-30)
Over Speed PolyGeo-
100 ZIP (1BYTE) + 00 -
Fence
Ex) 1A 00
Alert is sent when the speed is under a defined Poly Geo-Fence ID
Geo-Fence (1-30)
Under Speed PolyGeo-
101 ZIP(1BYTE) + 00 -
Fence
Ex) 1A 00

Name Description Alert ID Alert Mod Alert Data


(default)
Alert is sent when a harsh acceleration event is
Harsh Acceleration detected. Harsh acceleration detection is controlled 46 FF 00 -
by the Driver Pattern settings
Alert is sent when a harsh braking event is detected.
Harsh Braking Harsh braking detection is controlled by the Driver 47 FF 00 -
Pattern settings
Alert is sent when a sharp turn left event is detected.
Sharp Turn Left Sharp turn left detection is controlled by the Driver 48 FF 00 -
Pattern settings.
Alert is sent when a sharp turn right event is detected.
Sharp Turn Right Sharp turn right detection is controlled by the Driver 49 FF 00 -
Pattern settings.
Alert is sent when the Driver Pattern Behaviour
DPA Calibrated 86 FF 00 -
settings have finished calibrating

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 24 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Jamming Detected Alert is sent when Jamming has been detected. 50 FF 00 -


Alert is sent when the iButton key has been placed on State of iButton
the iButton Reader. ID’s registration

iButton Format Example: 0: Not Registered iButton ID


iButton Read  [CRC] [SERIAL #] [FAMILY CODE] 59 1: Registered ZIP(8BYTE)
 [1 byte] [6 bytes] [1 byte]
 FE 00 00 12 B9 FB 8B 01 ZIP(1BYTE) + 08

Ex) 01 08
Enter Drive Mode Alert is sent when the vehicle is entering Drive Mode 29 Mode Device is -
Enter Park Mode Alert is sent when the vehicle is entering Park Mode 31 Exitin`g: -
Enter Idle Mode Alert is sent when the vehicle is entering Idle Mode 68 -
Alert is sent when the vehicle is entering Speed Mode 0 = Parking
1 = Driving
2 = Idle
3 = Speeding
4 = Park Mode
Entry Delay
Enter Speed Mode 36 5 = Drive Mode -
Entry Delay
6 = Towing

ZIP(1BYTE) + 00

Ex) 05 00
Alert is sent when the vehicle is in Idle Mode, and has 1=Excess Idle 1
exceeded the defined excess idle time threshold 2=Excess Idle 2
3=Excess Idle 3
Excess Idle 35 -
ZIP(1BYTE) + 00

Ex) 02 00
Enter Tow Alert is sent when the vehicle is entering Tow Mode 58 FF 00 -
Power Up An alert is sent when the device is turned on when the 99 FF 00 -
device is powered off.

Name Description Alert ID Alert Mod Alert Data


(default)
Alert is sent when one of the 1-Wire temperature # of Temp Probe
sensor readings goes above the high temperature that went above
Temperature
threshold the threshold
Reading
Temp. High 75
ZIP(1BYTE) + 02
ZIP(2BYTE)
Ex) 02 02
Alert is sent when one of the 1-Wire temperature # of Temp Probe
sensor readings goes below the low temperature that went below
threshold the threshold Temperature
Temp. Low 76 Reading
ZIP(1BYTE) + 02 ZIP(2BYTE)

Ex) 02 02
Alert is sent when one of the 1-Wire temperature # of Temp Probe
Temperature
sensor readings returns to a temperature reading that that returned
Temp. Return 77 Reading
is between the low temperature threshold and high between the low
ZIP(2BYTE)
temperature threshold and high
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 25 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

thresholds

ZIP(1BYTE) + 02

Ex) 02 02
Alert is sent when an RFID tag has been read from the RFID Tag Number
RFID Read 93 FF 05
RS232 serial interface ZIP(5BYTE)
Low Back-up Battery Alert is sent when the Back-Up Battery is low. 43 FF 00 -
Sim Card Removed Alert is sent when a sim-card is removed. 72 FF 00 -
Alert is sent when GPS is fixed or not.
GPS Fix Status
‘1’ or ‘0’
GPS Fix Alert 97 ZIP(1BYTE) + 00 -
1 => GPS is fixed
0 => GPS is not fixed
Ex) 01 00
Alert is sent when Voice Call is connected, released or 1. if ’+’ exists or
failed. not in the phone
number.(bit63)
0  ‘’(null string)
1  ‘+’

2.phone number
length.
(bit62~bit56)

3.phone
number.(bit55~bi
t0)
Voice Call State
Example)
0: Connected
phone number :
1: Released
+05281769012
Voice Call 67 2: Failed
bit63 : 1 ( ‘+’)
ZIP(1BYTE) + 08
bit62~bit55:
Ex) 00 08
000 1011 
len:11

bit55~bit0:
05281769012 
0000013AD1663
4
(Hex)

Conclusion)
8B0000013AD16
634
(Hex)

Alert is sent when RS232 is connected or disconnected RS232 Status


in specific time.
User asks for ‘SttReq’ command. ‘0’ or ‘1’
RS232 Alert 69 -
0 => connect
1 => disconnect

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 26 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

ZIP(1BYTE) + 00

Ex) 00 00

Note)
- In case of the Normal,"ALERT_DATA" & “ALERT_MODE” field is filled with blank for unsupported ALERTs.

- Enter Tow Alert (58)


Device is able to check if the vehicle moves away from the pre-defined parking boundary or starts moving without having a mode of
the ignition on.
In case the device recognizes such an unauthorized moving or driving, it sends an Enter Tow Alert immediately.

If IGNITION is set to ‘0’, the device doesn’t check driving or parking state of the vehicle.
It always reports status string under parking mode, and cannot support Tow Alert.

3. Keep-Alive Report

A typical GPRS/HSPA service provider in any countries has its own corporate policy restricting connection time of device with
the GPRS/HSPA networks only at an interval if device does not communicate with its server for a long time, which is 1 hour, for
instance. The time length varies depending upon such service provider. Please check it by asking your GPRS/HSPA service
provider this question in your country.

In a case that there has not been any communication between a device and its server for such a time period, the GPRS/HSPA
service provider would not provide GPRS/HSPA service for the device temporarily. To avoid such a case, device sends the server
this ‘Keep-Alive’ Report at an interval, ‘T4’ (‘Keep-Alive’ interval named in ‘SyncTrak’ and in this document), which is shorter
than the 60 minutes. User of the device may adjust the value of ‘T4’ as desired.

This report is intended to mean that the device is still alive and ready for any possible communications with the server for that
long time (‘T4’) even though the device does not interact temporarily with the server.

3.1 Zip (HEX, fixed length)


Example Zip (raw data):
83 00 05 03 60 00 00 01
HDR PKT_LEN DEV_ID
(1 Byte) (2 Bytes) (5 Bytes)

Field Data Conversion Description


HDR 83 Header of Keep Alive Report.
PKT_LEN 00 05 Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
DEV_ID 03 60 00 00 01 HEX
Device ID:

3.2 Normal (ASCII, variable length)


Example Zip Data:
83 00 05 03 60 00 00 01

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 27 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Example Normal Data (ASCII):


ALV;0360000001
HDR DEV_ID

Field Data Max Length Description


HDR ALV 3 char Header of Status Report.
DEV_ID 0360000001 10 char Device ID.

4. External Serial Device Data Report (RS232)

If device is connected with an external appliance via RS232, it receives data from the appliance and sends the data to the server.
Data transfer is made with the string below.

(note)
In Sleep mode, the first data packet sent to RS232 is discarded because the device is used to wake up from sleep mode.
Subsequently, the received data from RS232 is reported to the server in UEX format.
If you want to send UEX report of all data received from RS232, please set the sleep mode to disable.

4.1 Zip (HEX, fixed length)


Example (raw data):
84 00 4A 03 60 00 00 01 3F FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27 93
18 3B 19 8F 0A 01 05 08 00 18 57 65 6C 63 6F 6D 65 20 74 6F 20 53 75 6E 74 65 63 68 20 57 6F 72 6C 64 21 12
HDR PKT_LEN DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE
(1 Byte) (2 Bytes) (5 Bytes) (3 Bytes) (1 Byte) (3 Bytes) (1 Byte)
DATE TIME CELL_ID MCC MNC LAC RX_LVL
(3 Bytes) (3 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (1 Byte)
LAT LON SPD CRS SATT FIX IN_STATE
(4 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (1 Byte) (1 Byte) (1 Byte)

OUT_STATE LEN CHK_SUM reserved reserved


DATA
(1 Byte) (2 Bytes) (1 Byte) (1byte) (1byte)

Field Data Conversion Description


Header of External Serial Report.
HDR 84  84: No ACK response required
 94: Required ACK response
PKT_LEN 00 4A Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
DEV_ID 03 60 00 00 01 HEX
Device ID
Map of the headers that are included in the report
Bit 0: REPORT_MAP
Bit 1: MODEL
REPORT_MAP Bit 2: SW_VER
3F FF FF HEX -> BIN
(Map Bit 0) ….
Bit 21: CHK_SUM
Bit 22: reserved
Bit 23: reserved
MODEL Value: 36
24 HEX -> DEC
(Map Bit 1) Device Model (According to table model).

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 28 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

SW_VER Value: 1.0.14


01 00 0E HEX -> DEC
(Map Bit 2) Software Version.
MSG_TYPE 01 HEX -> DEC
Real Time (1) Or Stored (0) Message
(Map Bit 3)
DATE Value: 20161117
10 0B 11 HEX -> DEC
(Map Bit 4) GPS Date (Year + Month + Day).
TIME Value: 08:37:39
08 25 27 HEX -> DEC
(Map Bit 5) Time (Hour + Minute + Second).
Value: 0000004F
CELL_ID Unique Id of Serving Cell.
00 00 00 4F HEX
(Map Bit 6) First 2 bytes are always 0 when the device connected to 2G
network.
MCC Value: 450
01 C2 HEX -> DEC
(Map Bit 7) Mobile Country Code
MNC Value: 0
00 00 HEX -> DEC
(Map Bit 8) Mobile Network Code
LAC Value: 0014
00 0E HEX -> DEC
(Map Bit 9) Location Area Code
RX_LVL Value: 20
14 HEX -> DEC
(Map Bit 10) Signal Strength (See table in Normal report above)
Value: +37.479323
Bit 31:
 1 = negative
LAT
(Map Bit 11)
02 3B E3 9B HEX -> DEC  0 = positive

To convert take HEX(02B3E39B) and convert to Decimal


value of 37,479,323 then divide by 1,000,000
Value: +126.887827
Bit 31:
 1 = negative
LON
(Map Bit 12)
07 90 27 93 HEX -> DEC  0 = positive

To convert take HEX(07902793) and convert to Decimal


value of 126,887,827 then divide by 1,000,000
Value: 062.03
SPD 18 3B HEX -> DEC HEX(18 3B) = Decimal 6,203
(Map Bit 13)
Take the decimal value and divide by 100 to get 62.03km/h
Value: 65.43
CRS HEX(19 8F) = Decimal 6,543
19 8F HEX -> DEC
(Map Bit 14) Take the decimal value and divide by 100 to get 65.43
degrees
SATT 0A HEX -> DEC
Number of GPS Satellites
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
01 HEX -> DEC
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
IN_STATE 05 HEX -> BIN In7 In6 In5 In4 In3 In2 In1 IGN
(Map Bit 17)
Ignition: 1 (ON), 0 (OFF).

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 29 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1
The Output State is indicated according to the Output Active
setting and the Output Active State.
OUT_STATE 08 HEX -> BIN
(Map Bit 18) Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent


in the Active state.
LEN Value: 25
00 19 HEX -> DEC
(Map Bit 19) Length of Data.
57 65 6C 63 6F 6D 65 20 Value: Welcome to Suntech World!
DATA 74 6F 20 53 75 6E 74 65 Data from external RS232 device:
(Map Bit 20) 63 68 20 57 6F 72 6C 64 Up to 500 bytes.
21
Value:
CHK_SUM 12 HEX -> DEC 8bit Checksum. Lower than8 bit of the summation of DATA
(Map Bit 21)
field.
Reserved
(Map Bit 22)
Reserved
(Map Bit 23)

4.2 Normal (ASCII, variable length)


Example Zip Data:
83 00 4A 03 60 00 00 01 3F FF FF 24 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 3B E3 9B 07 90 27 93
18 3B 19 8F 0A 01 05 08 00 19 57 65 6C 63 6F 6D 65 20 74 6F 20 53 75 6E 74 65 63 68 20 57 6F 72 6C 64 21 12
Example Normal Data (ASCII):
UEX;0360000001;3FFFFF;36;1.0.14;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10;
1;00000101;00001000;25; Welcome to Suntech World!;12
HDR DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE DATE
TIME CELL_ID MCC MNC LAC RX_LVL LAT
LON SPD CRS SATT FIX IN_STATE OUT_STATE
LEN DATA CHK_SUM reserved reserved

Field Data Max Length Description


Header of External Serial Device Data Report.
HDR UEX 3-4 char  UEX: No ACK response required
 AUEX: Required ACK response
DEV_ID 0360000001 10 char Device ID.
Map of the headers that are included in the report
REPORT_MAP Bit 0: REPORT_MAP
3FFFFF 6 char
(Map Bit 0) Bit 1: MODEL
Bit 2: SW_VER
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 30 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

….
Bit 21: CHK_SUM
Bit 22: reserved
Bit 23: reserved
MODEL 36 2 char Device Model (According to table model).
(Map Bit 1)
SW_VER 1.0.14 String Number of the released Software Version.
(Map Bit 2)
MSG_TYPE 1 1 char Report is real time (1); Report is storage (0).
(Map Bit 3)
DATE 20161117 8 char GPS date yyyymmdd or (Year + Month + Day)
(Map Bit 4)
TIME 08:37:39 8 char GPS time hh:mm:ss or (Hour : Minute : Second)
(Map Bit 5)
Unique ID of Serving Cell. 8 digit hex
CELL_ID 0000004F 8 char First 4 digits are always 0 when the device connected to 2G
(Map Bit 6)
network.
MCC 450 String Mobile Country Code. 0 ~ 65535
(Map Bit 7)
MNC 0 String Mobile Network Code. 0 ~ 65535
(Map Bit 8)
LAC 0014 4 char Location Area Code. 4 digits hex
(Map Bit 9)
Signal Strength.
0 ~ 63 in 2G.
0: less than -110 dBm
1: -110 to -019 dBm
……
62: -49 to -48 dBm
RX_LVL 63: greater than -48 dBm
20 String
(Map Bit 10)
0 ~ 65 in 3G/4G.
0: less than -105 dBm
1: -104 to -103 dBm
……
64: -41 to -40 dBm
65: greater than -40 dBm
LAT +37.479323 String Latitude (+/-xx.xxxxxx).
(Map Bit 11)
LON +126.887827 String Longitude (+/-xxx.xxxxxx).
(Map Bit 12)
SPD 62.03 String Speed in km/h. (1 km/h = 0.621371 mph)
(Map Bit 13)
CRS 65.43 String Course on the ground in degree.
(Map Bit 14)
SATT 10 String Number of GPS satellites.
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
1 1 char
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
IN_STATE Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
00000101 String
(Map Bit 17) In7 In6 In5 In4 In3 In2 In1 IGN

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 31 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Ignition: 1 (ON), 0 (OFF).


In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1

The Output State is indicated according to the Output Active


setting and the Output Active State.
OUT_STATE 00001000 String
(Map Bit 18)
Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent in the
Active state.
LEN 25 1 char Length of Data.
(Map Bit 19)
DATA Welcome to Data from external RS232 device:
String
(Map Bit 20) Suntech World! Up to 500 bytes.
CHK_SUM Value: 12
12 String
(Map Bit 21) 8bit Checksum. Lower than8 bit of the summation of DATA field.
Reserved
(Map Bit 22)
Reserved
(Map Bit 23)

5. Transfer Data to External Serial

If the device has an external serial accessory connected, a message can be sent to this external accessory by sending a command
to the Suntech device with the format shown below.

5.1 Send Format


Example Normal Data (ASCII):
DEX;0360000001;0024;Welcome to Suntech World;F1
HDR DEV_ID LEN DATA CHK_SUM

Field Data Max Length Description


HDR DEX 3 char Header of Transfer Data to External Serial Message
DEV_ID 0360000001 10 char Device ID.
LEN 0024 4 char Length of the data being sent to the external serial device
Welcome to 500 char
DATA Serial data to send to the device
Suntech World maximum
Check Sum to be used by the device to verify the data was
correctly received.
CHK_SUM F1 2 char
Device will calculate CHK_SUM from DATA received and verify it
matches the value given by the Platform before passing the data
on to the external serial device

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 32 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

5.2 Response Format


Example Normal Data (ASCII):
RES;DEX;0360000001;F1
RES HDR DEV_ID CHK_SUM

Field Data Max Length Description


RES RES 3 char Response Header for command sent to Suntech device
HDR DEX 3 char Header of Transfer Data to External Serial Message
DEV_ID 0360000001 10 char Device ID.
DATA F1 2 char Check Sum as calculated by the device

6. Travel Report

6.1 Zip (HEX, fixed length)


Example (raw data):
85 00 87 03 60 00 00 01 00 00 00 00 00 24 01 00 0E 01 10 0B 11 08 25 27 02 3B E3 9B 07 90 27 93 02 4B 25 DB 07 9F 69 D3 50
00 00 19 3E 0C CD 01 00 00 5D 10 00 00 2A 30 01 B4 00 02 03 B3 00 07 28 13 0E F5 00 01 31 A5 01 3F 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

HDR PKT_LEN DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE


(1 Byte) (2 Bytes) (5 Bytes) (5 Bytes) (1 Byte) (3 Bytes) (1 Byte)
DATE TIME LAT_TRV_ST LON_TRV_ST LAT_TRV_FI LON_TRV_FI DRIVER_ID
(3 Bytes) (3 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (4 Bytes) (8 Bytes)
TRV_DIST TRV_H_METER (4 IDLE_TIME IDLE_EVENTS SPD_TIME SPD_EVENTS MAX_SPD
(4 Bytes) Bytes) (4 Bytes) (2 Byte) (4 Bytes) (2 Byte) (2 Bytes)
SPEED_HISTOGR
AVG_SPD GPS_ODOM
AM reserved reserved reserved reserved
(2 Byte) (4 Byte)
(42 Byte)
reserved reserved reserved reserved reserved reserved reserved
reserved reserved reserved reserved reserved reserved reserved
reserved

Field Data Conversion Description


Header of Travel Report.
HDR 85  85: No ACK response required
 95: Required ACK response
PKT_LEN 00 45 Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
DEV_ID 03 60 00 00 01 HEX
Device ID
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 33 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Map of the headers that are included in the report


Bit 0: REPORT_MAP
Bit 1: MODEL
REPORT_MAP 00 00 00 00 00 HEX -> BIN Bit 2: SW_VER
(Map Bit 0)
….
Bit 38: reserved
Bit 39: reserved
MODEL Value: 36
24 HEX -> DEC
(Map Bit 1) Device Model (According to table model).
SW_VER Value: 1.0.14
01 00 0E HEX -> DEC
(Map Bit 2) Software Version.
MSG_TYPE 01 HEX -> DEC
Real Time (1) Or Stored (0) Message
(Map Bit 3)
DATE Value: 20161117
10 0B 11 HEX -> DEC
(Map Bit 4) GPS Date (Year + Month + Day).
TIME Value: 08:37:39
08 25 27 HEX -> DEC
(Map Bit 5) Time (Hour + Minute + Second).
Value: +37.479323
Latitude of location where the trip started (Ignition On)
Bit 31:
LAT_TRV_ST  1 = negative
02 3B E3 9B HEX -> DEC
(Map Bit 6)  0 = positive

To convert take HEX(02B3E39B) and convert to Decimal


value of 37,479,323 then divide by 1,000,000
Value: +126.887827
Longitude of location where the trip started (Ignition On)
Bit 31:
LON_TRV_ST  1 = negative
07 90 27 93 HEX -> DEC
(Map Bit 7)  0 = positive

To convert take HEX(07902793) and convert to Decimal


value of 126,887,827 then divide by 1,000,000
Value: +38.479323
Latitude of location where the trip finished (Ignition Off)
Bit 31:
LAT_TRV_FI  1 = negative
02 4B 25 DB HEX -> DEC
(Map Bit 8)  0 = positive

To convert take HEX(02B3E39B) and convert to Decimal


value of 37,479,323 then divide by 1,000,000
Value: +127.887827
Longitude of location where the trip finished (Ignition Off)
Bit 31:
LON_TRV_FI  1 = negative
07 9F 69 D3 HEX -> DEC
(Map Bit 9)  0 = positive

To convert take HEX(07902793) and convert to Decimal


value of 126,887,827 then divide by 1,000,000
DRIVER_ID 50 00 00 19 3E 0C CD HEX -> DEC Driver ID
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 34 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(Map Bit 10) 01


TRV_DIST Value: 23,824 meters
00 00 5D 10 HEX -> DEC
(Map Bit 11) Distance traveled in meters
TRV_H_METER Value: 10800 seconds
00 00 2A 30 HEX -> DEC
(Map Bit 12) Driving Time meter in seconds for current trip
Value: 436 seconds
IDLE_TIME 00 00 01 B4 HEX -> DEC Time spent in Idle Mode for the entire trip in seconds
(Map Bit 13)
(Ignition On to Ignition Off)
Value: 2
IDLE_EVENTS 00 02 HEX -> DEC Number of Idle events during 1 trip (Ignition On to Ignition
(Map Bit 14)
Off)
SPD_TIME Value: 947 seconds
00 00 03 B3 HEX -> DEC
(Map Bit 15) Time spent in Speed Mode in seconds
Value: 7
SPD_EVENTS 00 07 HEX -> DEC Number of times Speed Mode was entered from Drive
(Map Bit 16)
Mode
Value: 102.59 km/h
MAX_SPD Maximum Speed as calculated from GPS data
28 13 HEX -> DEC
(Map Bit 17) HEX(28 13) = Decimal 10,259
Take the decimal value and divide by 100 to get 102.59km/h
Value: 038.29 km/h
AVG_SPD Average Speed as calculated from GPS data
0E F5 HEX -> DEC
(Map Bit 18) HEX(0E F5) = Decimal 3,829
Take the decimal value and divide by 100 to get 38.29km/h
GPS_ODOM Value: 78,245 meters
00 01 31 A5 HEX -> DEC
(Map Bit 19) Odometer as calculated from GPS data
Histogram of speed Section
 00km/h ~ 09km/h
 10km/h ~ 19km/h
 20km/h ~ 29km/h
 30km/h ~ 39km/h
 40km/h ~ 49km/h
 50km/h ~ 59km/h
 60km/h ~ 69km/h
01 3F 00 00 00 00 00 00  70km/h ~ 79km/h
00 00 00 00 00 00 00  80km/h ~ 89km/h
SPEED_HISTOGRAM 00 00 00 00 00 00 00  90km/h ~ 99km/h
HEX -> DEC
(Map Bit 20) 00 00 00 00 00 00 00  100km/h ~ 109km/h
00 00 00 00 00 00 00  110km/h ~ 119km/h
00 00 00 00 00 00  120km/h ~ 129km/h
 130km/h ~ 139km/h
 140km/h ~ 149km/h
 150km/h ~ 159km/h
 160km/h ~ 169km/h
 170km/h ~ 179km/h
 180km/h ~ 189km/h
 190km/h ~ 199km/h
 Over 200km/h
Reserved
(Map Bit 21)

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 35 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Reserved
(Map Bit 22)
Reserved
(Map Bit 23)
Reserved
(Map Bit 24)
Reserved
(Map Bit 25)
Reserved
(Map Bit 26)
Reserved
(Map Bit 27)
Reserved
(Map Bit 28)
Reserved
(Map Bit 29)
Reserved
(Map Bit 30)
Reserved
(Map Bit 31)
Reserved
(Map Bit 32)
Reserved
(Map Bit 33)
Reserved
(Map Bit 34)
Reserved
(Map Bit 35)
Reserved
(Map Bit 36)
Reserved
(Map Bit 37)
Reserved
(Map Bit 38)
Reserved
(Map Bit 39)

6.2 Normal (ASCII, variable length)


Example Zip Data:
85 00 87 03 60 00 00 01 00 00 00 00 00 24 01 00 0E 01 10 0B 11 08 25 27 02 3B E3 9B 07 90 27 93 02 4B 25 DB 07 9F 69 D3 50
00 00 19 3E 0C CD 01 00 00 5D 10 00 00 2A 30 01 B4 02 03 B3 03 28 13 0E F5 00 01 31 A5 01 3F 00 00 00 00 00 00 00 00 00
00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00

Example Normal Data (ASCII):


TRV;0360000001;07FFFFF;36;1.0.14;1;20161117;08:37:39;+37.479323;+126.887827;+38.479323;+127.887827;
500000193E0CCD01;23824;10800;436;2;;325;3;102.59;38.29; 78245; 319;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0

HDR DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE DATE


TIME LAT_TRV_ST LON_TRV_ST LAT_TRV_FI LON_TRV_FI DRIVER_ID TRV_DIST

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 36 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

TRV_H_METER IDLE_TIME IDLE_EVENTS SPD_TIME SPD_EVENTS MAX_SPD AVG_SPD


SPEED_HISTOGR reserved reserved reserved reserved
GPS_ODOM reserved
AM
reserved reserved reserved reserved reserved reserved reserved
reserved reserved reserved reserved reserved reserved reserved

Field Data Conversion Description


Header of Travel Report.
 TRV: No ACK response
HDR TRV 3-4 char
required
 ATRV: Required ACK response
DEV_ID 0360000001 10 char Device ID.
Map of the headers that are included in
the report
Bit 0: REPORT_MAP
REPORT_MAP Bit 1: MODEL
0007FFFFFF 10 char
(Map Bit 0) Bit 2: SW_VER
….
Bit 38: reserved
Bit 39: reserved
MODEL 36 2 char Device Model (According to table model).
(Map Bit 1)
SW_VER 1.0.14 String Number of the released Software Version.
(Map Bit 2)
MSG_TYPE Report is real time (1); Report is storage
1 1 char
(Map Bit 3) (0).
DATE GPS date yyyymmdd or (Year + Month +
20161117 8 char
(Map Bit 4) Day)
TIME GPS time hh:mm:ss or (Hour : Minute :
08:37:39 8 char
(Map Bit 5) Second)
LAT_TRV_ST Latitude (+/-xx.xxxxxx) of location where
+37.479323 String
(Map Bit 6) the trip started (Ignition On)
LON_TRV_ST Longitude (+/-xx.xxxxxx) of location where
+126.887827 String
(Map Bit 7) the trip started (Ignition On)
LAT_TRV_FI Latitude (+/-xx.xxxxxx) of location where
+38.479323 String
(Map Bit 8) the trip finished (Ignition Off)
Value: +127.887827
Bit 31:
 1 = negative
LON_TRV_FI +127.887827 String
 0 = positive
(Map Bit 9)
To convert take HEX(07902793) and
convert to Decimal value of 126,887,827
then divide by 1,000,000
DRIVER_ID 500000193E0CCD01 16 char Driver ID
(Map Bit 10)
TRV_DIST 23824 String Distance traveled in meters
(Map Bit 11)
TRV_H_METER Driving Time meter in seconds for current
10800 String
(Map Bit 12) trip
IDLE_TIME 436 String Time spent in Idle Mode for the entire trip
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 37 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(Map Bit 13) in seconds (Ignition On to Ignition Off)


IDLE_EVENTS Number of Idle events during 1 trip
2 String
(Map Bit 14) (Ignition On to Ignition Off)
SPD_TIME 947 String Time spent in Speed Mode in seconds
(Map Bit 15)
SPD_EVENTS Number of times Speed Mode was
7 String
(Map Bit 16) entered from Drive Mode
Maximum Speed as calculated from GPS
MAX_SPD 102.59 String data
(Map Bit 17)
o Units in km/h
Average Speed as calculated from GPS
AVG_SPD 38.29 String data
(Map Bit 18)
o Units in km/h
GPS_ODOM 78245 String Odometer as calculated from GPS data
(Map Bit 19)
Histogram of speed Section
 00km/h ~ 09km/h
 10km/h ~ 19km/h
 20km/h ~ 29km/h
 30km/h ~ 39km/h
 40km/h ~ 49km/h
 50km/h ~ 59km/h
 60km/h ~ 69km/h
 70km/h ~ 79km/h
 80km/h ~ 89km/h
SPEED_HISTOGRAM  90km/h ~ 99km/h
319;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0 String
(Map Bit 20)  100km/h ~ 109km/h
 110km/h ~ 119km/h
 120km/h ~ 129km/h
 130km/h ~ 139km/h
 140km/h ~ 149km/h
 150km/h ~ 159km/h
 160km/h ~ 169km/h
 170km/h ~ 179km/h
 180km/h ~ 189km/h
 190km/h ~ 199km/h
 Over 200km/h
Reserved
(Map Bit 21)
Reserved
(Map Bit 22)
Reserved
(Map Bit 23)
Reserved
(Map Bit 24)
Reserved
(Map Bit 25)
Reserved
(Map Bit 26)
Reserved
(Map Bit 27)
Reserved
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 38 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(Map Bit 28)


Reserved
(Map Bit 29)
Reserved
(Map Bit 30)
Reserved
(Map Bit 31)
Reserved
(Map Bit 32)
Reserved
(Map Bit 33)
Reserved
(Map Bit 34)
Reserved
(Map Bit 35)
Reserved
(Map Bit 36)
Reserved
(Map Bit 37)
Reserved
(Map Bit 38)
Reserved
(Map Bit 39)

7. Acknowledgment Message
The acknowledgment message can be configured on the device to be required for the specified reports.

7.1 Zip (HEX, fixed length)

Example Zip (raw data):


90 00 06 03 60 00 00 01 2C
HDR PKT_LEN DEV_ID CHK_SUM
(1 Byte) (2 Bytes) (5 Bytes) (1 Byte)

Field Data Conversion Description


HDR 90 Header of Acknowledge Message.
PKT_LEN 00 06 Length of zip data excluding HDR and PKT_LEN
DEV_ID 03 60 00 00 01 HEX Device ID
CHK_SUM is the checksum of the total report packet.

Example Report to Platform: 91 00 0B 03 60 00 00 01 00 00


CHK_SUM 2C HEX -> DEC
07 1A 00 0A 01
The total value when added would be:
HEX(01 2C)  CHK_SUM would be 2C

7.2 Normal (ASCII, variable length)

Example Normal Data (ASCII):


ACK;0360000001;5D
HDR DEV_ID CHK_SUM

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 39 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Field Data Max Length Description


HDR ACK 8 char Header of Acknowledge Message.
DEV_ID 0360000001 10 char Device ID.
The device will add the bytes of the original message that come
after the Device ID, and the CHK_SUM value will be used for
Acknowledge messages to verify the server has received all of
the information correctly. The server must send the ACK
message correctly to the device before any more reports will be
sent by the device. CHK_SUM is the checksum of the total report
packet.
CHK_SUM 5D HEX -> DEC

Example Report to Platform:


Normal: STT;0360000001;000007;26;010;1
Raw: 53 54 54 3B 30 33 36 30 30 30 30 30 30 31 3B 30 30 30 30
30 37 3B 32 36 3B 30 31 30 3B 31
The total value when added would be:
HEX(06 5D)  CHK_SUM would be 5D

8. Crash Reconstruction Report (Optional)

If a collision occurs, The Suntech device will send Crash Reconstruction Report (CRR) after sending a collision alert report. This
report contains time, latitude, longitude, speed, course, and accelerometer data for occurring collision before and after. User
can customize the accelerometer data sampling rate (4/100/800 Hz, default: 100Hz), before collision occurring time, and after
collision occurring time (from 1 to 15 sec, default: <before: 3sec. / after: 1sec.>). These parameters effect to CRR packet number and
data size. The device will split the data for maximum data size of packet. Each packet will be sent ‘CUR_IDX’ value from 1 until
reach the ‘TOTAL_IDX’. Therefore before parsing data, you need to collect data to make a whole in one. The device reports
data with the format shown below.

8.1 Send Format


Example Normal Data (ASCII and Binary):
CRR;0360000001;1;26;1300;7+‘ã;™'•···×¼Bp¬îu‹¼íÅ÷6ç‘á=°ot+n"k¼rZ;B4
HDR DEV_ID CUR_INDX TOTAL_IDX LEN DATA CHK_SUM

Field Data Max Length Description


HDR CRR 3 char Header of Crash Reconstruction Report.
DEV_ID 0360000001 10 char Device ID.
CUR_IDX 1 2 char Index of current packet to receive.
TOTAL_IDX 26 2 char Index of total packet to receive.
LEN 1300 4 char Length of the Crash Reconstruction Data.
Crash Reconstruction Data. It contains time, latitude, longitude,
7+‘ã;™'•···×¼Bp¬îu‹¼íÅ
DATA 1300 bytes speed, course, and accelerometer data. Refer to <note> below
÷6ç‘á=°ot+n"k¼rZ
this table.
Check Sum to be used by the device to verify the data was
CHK_SUM B4 2 char correctly received.
Device will calculate CHK_SUM from Crash Reconstruction Data.

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 40 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

<note>
‘DATA’ Field
: It must be parsed after merging all data fields. The data size depends on the setting of accelerometer value on SyncTrak.
The structure of shown below assume you receive data with default setting.
<Default> Sampling Rate: 100 Hz / Before collision: 3 Sec. / After collision: 1 Sec
Total Data size = 6 bytes + 2448 bytes = 2454 bytes (1/2: 1300 bytes, 2/2: 1154 bytes)

Time: 6 bytes
Year (Integer): 1 byte
Month (Integer): 1 byte
Day (Integer): 1 byte
Hour (Integer): 1 byte
Minute (Integer): 1 byte
Second (Integer): 1 byte
Crash Reconstruction Data: (12 bytes + 6 bytes * 100 Hz) * (3 Sec. + 1 Sec.) = 2448 bytes
Latitude (integer): 4 bytes
Longitude (integer): 4 bytes
Speed (integer): 2 bytes (Resolution: 1:0.01km/h)
Course (integer): 2 bytes (Unit: Degree)
100Hz Accelerometer Data
Accelerometer X-Axis_1 (integer): 2bytes
Accelerometer Y-Axis_1 (integer): 2bytes
Accelerometer Z-Axis_1 (integer): 2bytes

Accelerometer X-Axis_2 (integer): 2bytes


Accelerometer Y-Axis_2 (integer): 2bytes
Accelerometer Z-Axis_2 (integer): 2bytes

……

Accelerometer X-Axis_99 (integer): 2bytes


Accelerometer Y-Axis_99 (integer): 2bytes
Accelerometer Z-Axis_99 (integer): 2bytes

Accelerometer X-Axis_100 (integer): 2bytes


Accelerometer Y-Axis_100 (integer): 2bytes
Accelerometer Z-Axis_100 (integer): 2bytes

REMARKS:
X/Y/Z acceleration already oriented to vehicle’s axis.

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 41 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

9. Maintenance Report
The Suntech device will send this report every time it powers up for the first time, and then on a defined interval to check in
with the Suntech maintenance server SCUTI.

Example Normal Data (ASCII):


MNT;0360000001; STG.58.1.0.14;20161117;08:37:39;001;NoData;NA;C
HDR DEV_ID SW_VER DATE TIME PROF_VER PHONE#
ANT BAT

Field Data Max Length Description


HDR MNT 3 char Header of Maintenance Report.
DEV_ID 0360000001 10 char Device ID.
DEVICE_FW_VER STG.58.1.0.14 String Number of the released Software Version.
GPS date
DATE 20161117 8 char
 yyyymmdd or (Year + Month + Day)
GPS time
TIME 08:37:39 8 char
 hh:mm:ss or (Hour : Minute : Second)
This is the last downloaded profile version by OTA or SyncTrak.
PROF_VER 001 3 char
Factory default value is 001.
PHONE# NoData String Current Phone Number
GPS Antenna Check
 C = Connected
 NC = Disconnected
ANT NA String  SH = Short
 NA = Not available
o When using a device with an internal GPS
antenna
Battery Check
 C = Connected
BAT C String
 NC = Disconnected
 ER = Error

10. Report for RF event


Device sends report to the server when RF events are occurred.
This is available only for RF devices.

Have a close look at the fields from the following table for more information on when and what events are triggered.

10.1 Zip (HEX, fixed length)


Example (raw data):
FA 00 3B 05 04 31 01 23 50 01 00 01 01 13 05 02 08 19 18 00 6B 6C 1F 01 C2 00 05 07 75 41 02 3B E3 9B 07 90 27 93 18 3B 19
8F 0A 01 05 08 02 00 07 00 01 23 01 00 00 00 00 00 00 00 00 01 04 CE 00

HDR PKT_LEN DEV_ID MODEL SW_VER MSG_TYPE DATE

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 42 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

(1 Byte) (2 Bytes) (5 Bytes) (1 Byte) (3 Bytes) (1 Byte) (3 Bytes)


TIME CELL_ID MCC MNC LAC RX_LVL LAT
(3 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (1 Byte) (1 Byte)
LON SPD CRS SATT FIX IN_STATE OUT_STATE
(4 Bytes) (2 Bytes) (2 Bytes) (1 Byte) (1 Byte) (1 Byte) (1 Byte)
EVT_ID RF_SERIAL RF_MSG_TYPE RF_LAT RF_LON RF_STAT RF_VOLT
(1 Byte) (5 Bytes) (1 Byte) (4 Bytes) (4 Bytes) (1 Byte) (2 Bytes)
RF_RSSI
(1 Byte)

Field Data Conversion Description


Header of RF report
HDR FA  FA: No ACK response required
 EA: Required ACK response
PKT_LEN 00 3B Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
DEV_ID 05 04 31 01 23 HEX
Device ID
MODEL Value: 36
50 HEX -> DEC
(Map Bit 1) Device Model (According to table model).
SW_VER Value: 1.0.14
01 00 01 HEX -> DEC
(Map Bit 2) Software Version.
MSG_TYPE 01 HEX -> DEC
Real Time (1) Or Stored (0) Message
(Map Bit 3)
DATE Value: 20161117
13 05 02 HEX -> DEC
(Map Bit 4) GPS Date (Year + Month + Day).
TIME Value: 08:37:39
08 19 18 HEX -> DEC
(Map Bit 5) Time (Hour + Minute + Second).
Value: 0000004F
CELL_ID Unique Id of Serving Cell.
00 6B 6C 1F HEX
(Map Bit 6) First 2 bytes are always 0 when the device connected to 2G
network.
MCC Value: 450
01 C2 HEX -> DEC
(Map Bit 7) Mobile Country Code
MNC Value: 0
00 05 HEX -> DEC
(Map Bit 8) Mobile Network Code
LAC Value: 0014
07 75 HEX -> DEC
(Map Bit 9) Location Area Code
RX_LVL Value: 20
41 HEX -> DEC
(Map Bit 10) Signal Strength (See table in Normal report above)
Value: +37.479323
Bit 31:
 1 = negative
LAT
(Map Bit 11)
02 3B E3 9B HEX -> DEC  0 = positive

To convert take HEX(02B3E39B) and convert to Decimal value of


37,479,323 then divide by 1,000,000
Value: +126.887827
LON Bit 31:
07 90 27 93 HEX -> DEC
(Map Bit 12)  1 = negative
 0 = positive
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 43 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

To convert take HEX(07902793) and convert to Decimal value of


126,887,827 then divide by 1,000,000
Value: 062.03
SPD 18 3B HEX -> DEC HEX(18 3B) = Decimal 6,203
(Map Bit 13)
Take the decimal value and divide by 100 to get 62.03km/h
Value: 65.43
CRS 19 8F HEX -> DEC HEX(19 8F) = Decimal 6,543
(Map Bit 14)
Take the decimal value and divide by 100 to get 65.43 degrees
SATT 0A HEX -> DEC
Number of GPS Satellites
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
01 HEX -> DEC
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
In7 In6 In5 In4 In3 In2 In1 IGN
IN_STATE 05 HEX -> BIN
(Map Bit 17)
Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1

The Output State is indicated according to the Output Active


setting and the Output Active State.
OUT_STATE 08 HEX -> BIN
(Map Bit 18)
Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent in the
Active state.
RF EVENT ID Number:
EVT_ID 2 HEX -> DEC
 See RF EVENT ID Table
RF_SERIAL 0007000123 HEX Serial number of RF device which triggered RF Event
Type of RF message
RF_MSG_TYPE 1 HEX -> DEC 1: RF message without GPS
2: RF message with GPS
Latitude of RF device which triggered RF Event
Value: +37.479323
Bit 31:
 1 = negative
RF_LAT 00 00 00 00 HEX -> DEC
 0 = positive

To convert take HEX(02B3E39B) and convert to Decimal value of


37,479,323 then divide by 1,000,000
RF_LON 00 00 00 00 HEX -> DEC Longitude of RF device which triggered RF Event
Status of sensors or signals in the device.
RF_STAT 01 HEX -> DEC
Each digit consist of ‘0’ or ‘1’

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 44 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Bit 7 6 5 4 3 2 1 0
Sensor/Signal Reserved for GPS Battery Box
future use Fix Sensor

 Box Sensor: 0=box is opened, 1=box is closed


 Battery: 0=internal battery, 1=vehicle battery
 GPS Fix: 0=not fixed, 1=fixed

Battery voltage of RF device


RF_VOLT 04 CE HEX -> DEC
To convert take HEX(04CE) and convert to Decimal value of 1230
then divide by 100
RSSI indBm received from RF device.
RF_RSSI 00 HEX -> DEC
-255 means RSSI is not available.

10.2 Normal (ASCII, variable length)


Example Zip Data:
FA 00 33 05 04 31 01 23 50 01 00 01 01 13 05 02 08 19 18 00 6B 6C 1F 01 C2 00 05 07 75 41 02 3B E3 9B 07 90 27 93 18 3B 19
8F 0A 01 05 08 02 00 07 00 01 23 01 00 00 00 00 00 00 00 00 01 04 CE 00
Example Normal Data (ASCII):
RFA;0504310123;50;1.0.1;1;20190502;08:19:18;006B6C1F;450;5;1909;63;+37.479323;+126.887827;0.00;0.00;10;1;00000101
;00000000;2;007000123;0;+0.000000;+0.000000;00000001;12.3;0
HDR DEV_ID MODEL SW_VER MSG_TYPE DATE TIME
CELL_ID MCC MNC LAC RX_LVL LAT LON
SPD CRS SATT FIX IN_STATE OUT_STATE EVT_ID
RF_SERIAL RF_MSG_TYPE RF_LAT RF_LON RF_STAT RF_VOLT RF_RSSI

Field Data Max Length Description


Header of RF Report.
HDR RFA 3 char  RFA: No ACK response required
 ARFA: Required ACK response
DEV_ID 0504310123 10 char Device ID.
MODEL 50 2 char Device Model (According to table model).
SW_VER 1.0.1 String Number of the released Software Version.
MSG_TYPE 1 1 char Report is real time (1); Report is storage (0).
DATE 20190502 8 char GPS date yyyymmdd or (Year + Month + Day)
TIME 08:19:18 8 char GPS time hh:mm:ss or (Hour : Minute : Second)
Unique ID of Serving Cell. 8 digit hex
CELL_ID 006B6C1F 8 char First 4 digits are always 0 when the device connected to 2G
network.
MCC 450 String Mobile Country Code. 0 ~ 65535
MNC 5 String Mobile Network Code. 0 ~ 65535
LAC 1909 4 char Location Area Code. 4 digits hex
RX_LVL 65 String Signal Strength.
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 45 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

0 ~ 63 in 2G.
0: less than -110 dBm
1: -110 to -019 dBm
……
62: -49 to -48 dBm
63: greater than -48 dBm

0 ~ 65 in 3G/4G.
0: less than -105 dBm
1: -104 to -103 dBm
……
64: -41 to -40 dBm
65: greater than -40 dBm
LAT +37.479323 String Latitude (+/-xx.xxxxxx).
(Map Bit 11)
LON +126.887827 String Longitude (+/-xxx.xxxxxx).
(Map Bit 12)
SPD 62.03 String Speed in km/h. (1 km/h = 0.621371 mph)
(Map Bit 13)
CRS 65.43 String Course on the ground in degree.
(Map Bit 14)
SATT 10 String Number of GPS satellites.
(Map Bit 15)
Fix Status
‘1’ or ‘0’
FIX 1 1 char
 1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
In7 In6 In5 In4 In3 In2 In1 IGN
IN_STATE 00000101 String
Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1

The Output State is indicated according to the Output Active


setting and the Output Active State.
OUT_STATE 00000000 String
Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent in the
Active state.
RF EVENT ID Number:
EVT_ID 2 1 char
 See RF EVENT ID Table
RF_SERIAL 0007000123 10 char Serial number of RF device which triggered RF Event
Type of RF message
RF_MSG_TYPE 1 1 char 1: RF message without GPS
2: RF message with GPS

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 46 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

RF_LAT +0.000000 String Latitude of RF device which triggered RF Event


RF_LON +0.000000 String Longitude of RF device which triggered RF Event
Status of sensors or signals in the device.
Each digit consist of ‘0’ or ‘1’

Bit 7 6 5 4 3 2 1 0
Sensor/Signal Reserved for GPS Battery Box
RF_STAT 1 String future use Fix Sensor

 Box Sensor: 0=box is opened, 1=box is closed


 Battery: 0=internal battery, 1=vehicle battery
 GPS Fix: 0=not fixed, 1=fixed

RF_VOLT 12.3 String Battery voltage of RF device


RSSI indBm received from RF device.
RF_RSSI 0 String
-255 means RSSI is not available.

10.3 RF EVENT ID Table


Description RF EVENT ID
Received Emergency or Position Message from other RF
1
device in ERB mode
Presence device is not present 2
Missed presence device is recovered 3

11. CAM Report

11.1 Zip (HEX, fixed length)


Example (raw data):
86 00 48 60 00 00 00 01 7F FF FF 1E 01 00 0E 01 10 0B 11 08 25 27 00 00 00 4F 01 C2 00 00 00 0E 14 02 B3 E3 9B 07 90 27 93
18 3B 19 8F 0A 01 05 08 00 19 00 19 00 19 55 46 57 65 6C 63 6F 6D 65 20 74 6F 20 53 75 6E 74 65 63 68 20 57 6F 72 6C 64 21

HDR PKT_LEN DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE


(1 Byte) (2 Bytes) (5 Bytes) (3 Bytes) (1 Byte) (3 Bytes) (1 Byte)

DATE TIME CELL_ID MCC MNC LAC RX_LVL


(3 Bytes) (3 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (2 Bytes) (1 Byte)
LAT LON SPD CRS SATT FIX IN_STATE
(4 Bytes) (4 Bytes) (2 Bytes) (2 Bytes) (1 Byte) (1 Byte) (1 Byte)

OUT_STATE PACK_NUM TOTAL_PACK_NUM PACK_SIZE PACK_DATA


(1 Byte) (2 Bytes) (2 Bytes) (2 Byte) (521byte)

Field Data Conversion Description


Header of Camera Report.
HDR 86  87: No ACK response required
 97: Required ACK response
PKT_LEN 00 48 Length of zip data excluding HDR and PKT_LEN

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 47 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Value: 6000000001
DEV_ID 60 00 00 00 01 HEX
Device ID
Map of the headers that are included in the report
Bit 0: REPORT_MAP
Bit 1: MODEL
REPORT_MAP 7F FF FF 6 char Bit 2: SW_VER
(Map Bit 0)
….
Bit 21: PACK_SIZE
Bit 22: PACK_DATA
MODEL Value: 30
1E HEX -> DEC
(Map Bit 1) Device Model (According to table model).
SW_VER Value: 1.0.14
01 00 0E HEX -> DEC
(Map Bit 2) Software Version.
MSG_TYPE 01 HEX -> DEC
Real Time (1) Or Stored (0) Message
(Map Bit 3)
DATE Value: 20161117
10 0B 11 HEX -> DEC
(Map Bit 4) GPS Date (Year + Month + Day).
TIME Value: 08:37:39
08 25 27 HEX -> DEC
(Map Bit 5) Time (Hour + Minute + Second).
Value: 0000004F
CELL_ID Unique Id of Serving Cell.
00 00 00 4F HEX
(Map Bit 6) First 2 bytes are always 0 when the device connected to 2G
network.
MCC Value: 450
01 C2 HEX -> DEC
(Map Bit 7) Mobile Country Code
MNC Value: 0
00 00 HEX -> DEC
(Map Bit 8) Mobile Network Code
LAC Value: 0014
00 0E HEX -> DEC
(Map Bit 9) Location Area Code
RX_LVL Value: 20
14 HEX -> DEC
(Map Bit 10) Signal Strength (See table in Normal report above)
Value: +37.479323
Bit 31:
 1 = negative
LAT
(Map Bit 11)
02 B3 E3 9B HEX -> DEC  0 = positive

To convert take HEX(02B3E39B) and convert to Decimal value of


37,479,323 then divide by 1,000,000
Value: +126.887827
Bit 31:
 1 = negative
LON
(Map Bit 12)
07 90 27 93 HEX -> DEC  0 = positive

To convert take HEX(07902793) and convert to Decimal value of


126,887,827 then divide by 1,000,000
Value: 062.03
SPD 18 3B HEX -> DEC HEX(18 3B) = Decimal 6,203
(Map Bit 13)
Take the decimal value and divide by 100 to get 62.03km/h
Value: 65.43
CRS 19 8F HEX -> DEC HEX(19 8F) = Decimal 6,543
(Map Bit 14)
Take the decimal value and divide by 100 to get 65.43 degrees
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 48 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

SATT 0A HEX -> DEC


Number of GPS Satellites
(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
01 HEX -> DEC
(Map Bit 16)  1 => GPS is fixed
 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
IN_STATE In7 In6 In5 In4 In3 In2 In1 IGN
05 HEX -> BIN
(Map Bit 17) Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1
The Output State is indicated according to the Output Active
setting and the Output Active State.
OUT_STATE 08 HEX -> BIN
(Map Bit 18) Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent in the
Active state.
PACK_NUM Value: 25
00 19 HEX -> DEC
(Map Bit 19)  Number of camera packet
TOTAL_PACK_ Value: 25
NUM 00 19 HEX -> DEC
Total number of camera packet
(Map Bit 20)
PACK_SIZE Value: 25
00 19 HEX -> DEC
(Map Bit 21) Camera packet data size
55 46 57 65 6C 63 6F
PACK_DATA 6D 65 20 74 6F 20 53 Camera packet data
(Map Bit 22) 75 6E 74 65 63 68 20 Up to 521 bytes.
57 6F 72 6C 64 21

11.2 Normal (ASCII, variable length)


Example Normal Data (ASCII):
CAM;6000000001;7FFFFF;30;1.0.14;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10
;1;00000101;00001000;25;25;25;554657656C636F6D6520746F2053756E7465636820576F726C6421
HDR DEV_ID REPORT_MAP MODEL SW_VER MSG_TYPE DATE
TIME CELL_ID MCC MNC LAC RX_LVL LAT
LON SPD CRS SATT FIX IN_STATE OUT_STATE
PACK_NUM TOTAL_PACK_NUM PACK_SIZE PACK_DATA

Field Data Max Length Description


Header of Camera Report.
HDR CAM 3 char  CAM: No ACK response required
 A CAM: Required ACK response
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 49 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

DEV_ID 6000000001 10 char Device ID.


Map of the headers that are included in the report
Bit 0: REPORT_MAP
Bit 1: MODEL
REPORT_MAP 7FFFFF 6 char Bit 2: SW_VER
(Map Bit 0)
….
Bit 21: PACK_SIZE
Bit 22: PACK_DATA
MODEL 30 2 char Device Model (According to table model).
(Map Bit 1)
SW_VER 1.0.14 String Number of the released Software Version.
(Map Bit 2)
MSG_TYPE 1 1 char Report is real time (1); Report is storage (0).
(Map Bit 3)
DATE 20161117 8 char GPS date yyyymmdd or (Year + Month + Day)
(Map Bit 4)
TIME 08:37:39 8 char GPS time hh:mm:ss or (Hour : Minute : Second)
(Map Bit 5)
Unique ID of Serving Cell. 8 digit hex
CELL_ID 0000004F 8 char First 4 digits are always 0 when the device connected to 2G
(Map Bit 6)
network.
MCC 450 String Mobile Country Code. 0 ~ 65535
(Map Bit 7)
MNC 0 String Mobile Network Code. 0 ~ 65535
(Map Bit 8)
LAC 0014 4 char Location Area Code. 4 digits hex
(Map Bit 9)
Signal Strength.
0 ~ 63 in 2G.
0: less than -110 dBm
1: -110 to -019 dBm
……
62: -49 to -48 dBm
RX_LVL 63: greater than -48 dBm
20 String
(Map Bit 10)
0 ~ 65 in 4G.
0: less than -105 dBm
1: -104 to -103 dBm
……
64: -41 to -40 dBm
65: greater than -40 dBm
LAT +37.479323 String Latitude (+/-xx.xxxxxx).
(Map Bit 11)
LON +126.887827 String Longitude (+/-xxx.xxxxxx).
(Map Bit 12)
SPD 62.03 String Speed in km/h. (1 km/h = 0.621371 mph)
(Map Bit 13)
CRS 65.43 String Course on the ground in degree.
(Map Bit 14)
SATT 10 String Number of GPS satellites.
(Map Bit 15)
FIX Fix Status
1 1 char
(Map Bit 16) ‘1’ or ‘0’

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 50 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

 1 => GPS is fixed


 0 => GPS is not fixed
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
IN_STATE In7 In6 In5 In4 In3 In2 In1 IGN
00000101 String
(Map Bit 17) Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1
The Output State is indicated according to the Output Active
setting and the Output Active State.
OUT_STATE 00001000 String
(Map Bit 18) Open Ground
Active 0 1
Inactive 1 0

When the output is in the blinking state, the report is sent in the
Active state.
PACK_NUM
(Map Bit 19)
25 String  Number of camera packet
TOTAL_PACK_
NUM 25 String Total number of camera packet
(Map Bit 20)
PACK_SIZE 25 String Camera packet data size
(Map Bit 21)
55 46 57 65 6C 63
6F 6D 65 20 74 6F
PACK_DATA Camera packet data
20 53 75 6E 74 65 HEX
(Map Bit 22) Up to 521 bytes.
63 68 20 57 6F 72
6C 64 21

12. GED Report


Example Normal Data (ASCII):
GED;Res;6000000001;30; 1.0.14;1; 20161117; 08:37:39;0000004F450;0;0014;20;+37.479323;+126.887827;62.03;65.43;10;1;
23824;11.94;00000101; 00001000; 234.12;181312.00; 1.23; 4.74;60;12;40.99;17.00;1; 0014BA78;3.45;19.42;181312.00;
127.25

HDR DEV_ID MODEL SW_VER MSG_TYPE DATE TIME


CELL_ID MCC MNC LAC RX_LVL LAT LON
SPD CRS SATT FIX DIST PWR_VOLT IN_STATE
ENGINE_TEMPER
OUT_STATE ODOMETER TOTAL_USED_FUEL VEH_SPD IDLE_FUEL OIL_PRESSURE
ATURE
ENGINE_RPM TOTAL_CRUISE DTC ENGINE_IDLE_TIME FUEL_ECONOMY TRIP_FUEL ENGINE_LOAD

Field Data Max Length Description


Header of GED Report.
HDR GED;Res 7 char
DEV_ID 6000000001 10 char Device ID.
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 51 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

MODEL 30 2 char Device Model (According to table model).


SW_VER 1.0.14 String Number of the released Software Version.
MSG_TYPE 1 1 char Report is real time (1); Report is storage (0).
DATE 20161117 8 char GPS date yyyymmdd or (Year + Month + Day)
TIME 08:37:39 8 char GPS time hh:mm:ss or (Hour : Minute : Second)
Unique ID of Serving Cell. 8 digit hex
CELL_ID 0000004F 8 char First 4 digits are always 0 when the device connected to 2G
network.
MCC 450 String Mobile Country Code. 0 ~ 65535
MNC 0 String Mobile Network Code. 0 ~ 65535
LAC 0014 4 char Location Area Code. 4 digits hex
Signal Strength.
0 ~ 63 in 2G.
0: less than -110 dBm
1: -110 to -019 dBm
……
62: -49 to -48 dBm
63: greater than -48 dBm
RX_LVL 20 String
0 ~ 65 in 4G.
0: less than -105 dBm
1: -104 to -103 dBm
……
64: -41 to -40 dBm
65: greater than -40 dBm
LAT +37.479323 String Latitude (+/-xx.xxxxxx).
LON +126.887827 String Longitude (+/-xxx.xxxxxx).
SPD 62.03 String Speed in km/h. (1 km/h = 0.621371 mph)
CRS 65.43 String Course on the ground in degree.
SATT 10 String Number of GPS satellites.
Fix Status
‘1’ or ‘0’
FIX 1 1 char
 1 => GPS is fixed
 0 => GPS is not fixed
DIST 23824 String Distance traveled in meters
PWR_VOLT 11.94 Current Main Power Voltage
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
In7 In6 In5 In4 In3 In2 In1 IGN
IN_STATE 00000101 String
Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).

Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0


RSV RSV RSV Out5 Out4 Out3 Out2 Out1
The Output State is indicated according to the Output Active
setting and the Output Active State.
OUT_STATE 00001000 String
Open Ground
Active 0 1
Inactive 1 0

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 52 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

When the output is in the blinking state, the report is sent in


the Active state.
ODOMETER 234.12 String Odometer in Km/h
String Total fuel used in Lts (liters)
TOTAL_USED_FUEL 181312.00
String Vehicle Speed In Km/h
VEH_SPD 1.23
String Idle Fuel in Hr
IDLE_FUEL 4.74
String Engine Coolant Temperature in C
ENGINE_TEMPERATURE 60
String Oil Pressure in kPa
OIL_PRESSURE 12
String Engine RPM
ENGINE_RPM 40.99
String Total Cruise Active time in sec.
TOTAL_CRUISE 17.00
String Vehicle Prototype
 0 => unknown
VEH_PROT 1  1 => J1939
 2 => J1708
 3 => ISO15765
String DTC code

If DTC is 0, empty.

J1939 or J1708 (8 characters)


- High byte: active error code
DTC 0014BA78
- Low byte: Previous active error code.
- It is a hex code, not decimal

ISO15765 (5 characters)
- Alphabet letter(1) + HEX(4)
- P0100, C0A00
String Engine Idle time in sec
ENGINE_IDLE_TIME 3.45
Fuel Economy in km/L
FUEL_ECONOMY 19.42 String
TRIP_FUEL 181312.00 String Used fuel in this trip (liters)
ENGINE_LOAD 127.25 String Percent Engine Load (percent)

13. Parameter Report

“Parameter Report” is sent by device for informing with device IP address to server.
This report is sent when UDP session is established and device IP is changed by PDP.

Example Normal Data (ASCII):


PRM;6000000001; 30; 1.0.14;IP:10.158.133.173
HDR DEV_ID MODEL SW_VER IP_INFO

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 53 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Field Data Max Length Description


HDR PRM 3 char Header of PRM Report.
DEV_ID 6000000001 10 char Device ID.
MODEL 30 2 char Device Model (According to table model).
SW_VER 1.0.14 String Number of the released Software Version.
IP_INFO IP:10.158.133.173 String IP:xxx.xxx.xxx.xxx

14. Small Assign Headers


These headers can be assigned to the standard report structure headers S_ASSIGNX. The Mini Assign Header is limited to 2
Bytes of data for the zip format, and all headers that require more bytes to represent can be found in the Assign Header
section. Even if the EMPTY field is checked, it is not displayed in ZIP mode.

Mini Header ID Zip Ex Normal Description


Ex
Current Backup Battery Voltage
BCK_VOLT 01 00 24 3.6  Convert zip to VDC by converting HEX(24) to DEC(36)
then divide by 10
Current Main Power Voltage
PWR_VOLT 02 04 AA 11.94  Convert zip to VDC by converting HEX(04 AA) to
DEC(1,194) then divide by 100
Temperature Sensor 1 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative. For
TEMP_1 03 01 14 +27.6 -27.6 the Zip value would be (81 14)
 Convert zip to Celsius by converting HEX(01 14) to
DEC(276) then divide by 10
Temperature Sensor 2 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative. For
TEMP_2 04 01 14 +27.6 -27.6 the Zip value would be (81 14)
 Convert zip to Celsius by converting HEX(01 14) to
DEC(276) then divide by 10
Temperature Sensor 3 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative. For
TEMP_3 05 01 14 +27.6 -27.6 the Zip value would be (81 14)
 Convert zip to Celsius by converting HEX(01 14) to
DEC(276) then divide by 10
Temperature Sensor 4 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative. For
TEMP_4 06 01 14 +27.6 -27.6 the Zip value would be (81 14)
 Convert zip to Celsius by converting HEX(01 14) to
DEC(276) then divide by 10
Temperature Sensor 5 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative. For
TEMP_5 07 01 14 +27.6 -27.6 the Zip value would be (81 14)
 Convert zip to Celsius by converting HEX(01 14) to
DEC(276) then divide by 10
Temperature Sensor 6 in the chain.
TEMP_6 08 01 14 +27.6  Zip: If Binary bit 15 is set, then the value is negative. For
-27.6 the Zip value would be (81 14)
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 54 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

 Convert zip to Celsius by converting HEX(01 14) to


DEC(276) then divide by 10
Temperature Sensor 7 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative. For
TEMP_7 09 01 14 +27.6 -27.6 the Zip value would be (81 14)
 Convert zip to Celsius by converting HEX(01 14) to
DEC(276) then divide by 10
Temperature Sensor 8 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative. For
TEMP_8 0A 01 14 +27.6 -27.6 the Zip value would be (81 14)
 Convert zip to Celsius by converting HEX(01 14) to
DEC(276) then divide by 10
Acceleration X-Axis value.
ACC_X 0B 00 11 17  Convert zip to g-force by converting HEX(00 11) to
DEC(17) then divide by 256.
Acceleration Y-Axis value.
ACC_Y 0C 00 4F 79  Convert zip to g-force by converting HEX(00 4F) to
DEC(79) then divide by 256.
Acceleration Z-Axis value.
ACC_Z 0D 00 EA 234  Convert zip to g-force by converting HEX(00 EA) to
DEC(234) then divide by 256.
Altitude (meter)
 Convert zip to altitude by converting HEX(00 4F) to
DEC(79).
ALTITUDE 0E 00 4F 79
 Convert zip to altitude by converting HEX(FF B1) to
DEC(-79).
 Must convert hex to Int16
Network Status
 1 => Connected with Server
 2 => Disconnected with Server
 3 => Disconnected GPRS Bearer
 4 => No Network
NET_STAUS 0F 00 01 1  5 => Sim Blocked
 6 => Network Error (Limited Service )
 7 => No Sim
 8 => Jammer detected
 255 => Initial State

ST25T ADC 1 Voltage


ST25T_ADC_1 10 04 AA 11.94
Convert zip to VDC by converting HEX(04 AA) to DEC(1,194) then
divide by 100
ST25T ADC 1 Voltage
ST25T_ADC_2 11 04 AA 11.94
Convert zip to VDC by converting HEX(04 AA) to DEC(1,194) then
divide by 100
ST25T INPUT 1, 2 State
ST25T_INPUT 12 00 0F 1111
Bit3 Bit2 Bit 1 Bit 0

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 55 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Input 2 Input 2 Input 1 Input 1


Status Edge Status Edge

Input 1 Status : 1 (Used), 0 (Not Used)


Input 2 Status : 1 (Used), 0 (Not Used)

Input1 ~ Input2 Edge :


1 (Ground, Shorted), 0 (Opened).

Engine Coolant Temperature in C


 Convert zip to altitude by converting HEX(00 4F) to
DEC(79).
ENGINE_TEMPERATURE 11 00 4F 79  Convert zip to altitude by converting HEX(FF B1) to
DEC(-79).
 Must convert hex to Int16
※ You could check this value when ST20M device is connected.
Oil Pressure in kPa
OIL_PRESSURE 12 00 0C 12
※ You could check this value when ST20M device is connected.
Vehicle Prototype
 0 => unknown
 1 => J1939
VEH_PROT 17 00 01 1  2 => J1708
 3 => ISO15765
※ You could check this value when ST20M device is connected.
15. Medium Assign Headers
These headers can be assigned to the standard report structure headers M_ASSIGNX. The Assign Header is 4 Bytes of data for
the zip format. Even if the EMPTY field is checked, it is not displayed in ZIP mode.

Header ID Zip Ex Normal Ex Description


GPS_ODOM 01 00 01 31 A5 78245 Calculated Odometer in meters using GPS location data
Distance traveled on current trip in meters
TRIP_DIST 02 00 00 5D 10 23824  Trip is considered to be the distance from
Ignition On to Ignition Off
Time the device has spent in Idle Mode since coming to a
stop [seconds]
IDLE_TIME 03 00 00 03 84 900  Resets to 0 when leaving Idle Mode.

Records time for each individual idle event.


Time the device has spent in Speed Mode since going
above speed threshold
SPEED_TIME 04 00 00 02 16 534  Resets to 0 when leaving Speed Mode.

Records time for each individual Speed event.[seconds]


Driving Hour meter in seconds for current trip
TRIP_H_METER 05 00 00 2A 30 10800  Trip is considered to be the distance from
Ignition On to Ignition Off
H_METER 06 00 00 02 16 534 Total Vehicle driving hour-meter in minute.
ST25T_RS232_FUE ST25T RS232 Fuel 1 Status/Level
07 00 00 1F FF 1FFF
L1
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 56 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Byte 1 Byte 0
Bit 4 Bit 0 ~ 3 Fuel level
Fuel Fuel level (0xFF)
Status (0xF)
(0x0, 0x1)
ST25T RS232 Fuel 2 Status/Level

Byte 1 Byte 0
ST25T_RS232_FUE
08 00 00 1F FF 1FFF Bit 4 Bit 0 ~ 3 Fuel level
L2
Fuel Fuel level (0xFF)
Status (0xF)
(0x0, 0x1)
ST25T RS485 Fuel 1 Status/Level

Byte 1 Byte 0
ST25T_RS485_FUE
09 00 00 1F FF 1FFF Bit 4 Bit 0 ~ 3 Fuel level
L1
Fuel Fuel level (0xFF)
Status (0xF)
(0x0, 0x1)
ST25T RS485 Fuel 2 Status/Level

Byte 1 Byte 0
ST25T_RS485_FUE
0A 00 00 1F FF 1FFF Bit 4 Bit 0 ~ 3 Fuel level
L2
Fuel Fuel level (0xFF)
Status (0xF)
(0x0, 0x1)
ST25T RS485 Fuel 3 Status/Level

Byte 1 Byte 0
ST25T_RS485_FUE
0B 00 00 1F FF 1FFF Bit 4 Bit 0 ~ 3 Fuel level
L3
Fuel Fuel level (0xFF)
Status (0xF)
(0x0, 0x1)
ST25T RS485 Fuel 4 Status/Level

Byte 1 Byte 0
ST25T_RS485_FUE
0C 00 00 1F FF 1FFF Bit 4 Bit 0 ~ 3 Fuel level
L4
Fuel Fuel level (0xFF)
Status (0xF)
(0x0, 0x1)
Vehicle Speed In Km/h.
 Convert speed by converting HEX(7B) to
VEH_SPD 12 00 00 00 7B 1.23 DEC(123) then divide by 100.
※ You could check this value when ST20M device is
connected.
Engine RPM
 Convert rpm by converting HEX(1003) to
ENGINE_RPM 13 00 00 10 03 40.99 DEC(4099) then divide by 100.
※ You could check this value when ST20M device is
connected.
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 57 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

DTC code

J1939 or J1708
- High byte: active error code
- Low byte: Previous active error code.
- It is a hex code, not decimal
DTC 14 00 14 BA 78 0014BA78
ISO15765
- P0100  00 50(‘P’) 01 00
- C0A00  00 43(‘C’) 0A 00

※ You could check this value when ST20M device is


connected.
Fuel Economy in km/L
 Convert fuel by converting HEX(796) to
FUEL_ECONOMY 15 00 00 07 96 19.42 DEC(1942) then divide by 100.
※ You could check this value when ST20M device is
connected.

16. Large Assign Headers


These headers can be assigned to the standard report structure headers L_ASSIGNX. The Assign Header is 8 Bytes of data for
the zip format. Even if the EMPTY field is checked, it is not displayed in ZIP mode.

Header ID Zip Ex Normal Ex Description


50 00 00 19 3E Driver ID
DID 01 500000193E0CCD01
0C CD 01
15 00 00 00 45 Temperature Sensor ID number 1 in chain
TEMP_ID1 02 15000000450FB842
0F B8 42
15 00 00 00 45 Temperature Sensor ID number 2 in chain
TEMP_ID2 03 15000000450FB842
0F B8 42
15 00 00 00 45 Temperature Sensor ID number 3 in chain
TEMP_ID3 04 15000000450FB842
0F B8 42
15 00 00 00 45 Temperature Sensor ID number 4 in chain
TEMP_ID4 05 15000000450FB842
0F B8 42
15 00 00 00 45 Temperature Sensor ID number 5 in chain
TEMP_ID5 06 15000000450FB842
0F B8 42
15 00 00 00 45 Temperature Sensor ID number 6 in chain
TEMP_ID6 07 15000000450FB842
0F B8 42
15 00 00 00 45 Temperature Sensor ID number 7 in chain
TEMP_ID7 08 15000000450FB842
0F B8 42
15 00 00 00 45 Temperature Sensor ID number 8 in chain
TEMP_ID8 09 15000000450FB842
0F B8 42
Odometer in Km/h
 Convert odometer by converting HEX(5B74)
00 00 00 00 00 to DEC(23412) then divide by 100.
ODOMETER 0F 234.12
00 5B 74
※ You could check this value when ST20M device is
connected.
TOTAL_USED_FUEL Total fuel used in Lts (liters)
00 00 00 00 01
10 181312.00  Convert fuel by converting HEX(114A900) to
14 A9 00
DEC(18131200) then divide by 100.
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 58 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

※ You could check this value when ST20M device is


connected.
IDLE_FUEL Idle Fuel in Hr
 Convert fuel by converting HEX(01DA) to
00 00 00 00 00 DEC(474) then divide by 100.
11 4.74
00 01 DA
※ You could check this value when ST20M device is
connected.
TOTAL_CRUISE Total Cruise Active time in sec.
 Convert cruise by converting HEX(06A4) to
00 00 00 00 00 DEC(1700) then divide by 100.
12 17.00
00 06 A4
※ You could check this value when ST20M device is
connected.
ENGINE_IDLE_TIME Engine Idle time in sec
 Convert time by converting HEX(0159) to
00 00 00 00 00 DEC(345) then divide by 100.
13 3.45
00 01 59
※ You could check this value when ST20M device is
connected.
TRIP_FUEL Used fuel in this trip (liters)
 Convert fuel by converting HEX(114A900) to
00 00 00 00 01 DEC(18131200) then divide by 100.
14 181312.00
14 A9 00
※ You could check this value when ST20M device is
connected.
ENGINE_LOAD Percent Engine Load (percent)
 Convert percent by converting HEX(31B5) to
00 00 00 00 00 DEC(12725) then divide by 100.
15 127.25
00 31 B5
※ You could check this value when ST20M device is
connected.

REVISIONS
Rev. No. Date Modifications were made on: Writer
Rev. 1.00 2016-11-30 Draft M.Hieda
Rev. 1.01 2018-01-27 Added missing ALERT ID. (46,47) S.E PARK
Added description of ‘Enter Two Alert (58)’
Rev. 1.02 2018-01-30 1. Fixed a description error for "DEV_ID" in “ZIP" mode. S.E PARK
01 65 A0 BC 01 => 60 00 00 00 01
2. Moving "SMALL ASSIGN" item to "MEDIUM ASSIGN"
Rev. 1.03 2018-01-30 Added description of ‘Power Up Alert (99)’ S.E PARK

Rev. 1.04 2018-09-21 1. Added description of ‘Crash Reconstruction Report’ HS PARK


2. Split Alert ID 48 ‘Sharp Turn’ into Alert ID 48 ‘Sharp Turn Left’ and Alert ID
49 ‘Sharp Turn Right’
3. Change "IDLE/SPEED Time" range from 2byte to 4byte in field of Travel
Report.
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 59 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Rev. 1.05 2018-10-22 Added Low Back-up Battery Alert 43 S.E PARK
Rev. 1.06 2018-10-23 Fixed CELL_ID report data, Removed CR Report KJH
Rev. 1.09 2018-11-13 Fixed Rx_Lvl for 4G network KJH
Rev. 1.10 2018-11-14 Added Profile version description KJH
Rev. 1.11 2018-11-26 Changed software version field KJH
Rev. 1.12 2018-12-12 Fixed Alert 14 vehicle battery low KJH
Rev. 1.13 2019-2-8 Added Crash Reconstruction Report Data KJH
Rev. 1.14 2019-2-13 Added a note about UEX report in sleep mode KJH
Rev. 1.15 2019-3-26 Supplementing the explanation of checksum calculation. S.E Park
-Chapter 7.1 Zip (HEX, fixed length)
-Chapter 7.2 Normal (ASCII, variable length)
Rev. 1.16 2019-4-2 Fixed Rx_Lvl for 3G/4G network KJH
Rev. 1.17 2019-4-2 Added Fine Tracking Report SJSONG
Rev. 1.18 2019-4-30 Fixed examples KJH
Rev. 1.19 2019-4-30 Corrected “the length of zip format, wrong HDR, Wrong description of HGPARK
M_Assign.etc.
Rev. 1.20 2019-5-11 Changed Alert ID Tables KSH
Rev. 1.21 2019-5-14 Added Acceleration X, Y, Z in description of Small Assign Header. HS PARK
Rev. 1.22 2019-6-11 UDP ACK simplification KJH
Rev. 1.23 2019-7-3 Add Small Assign : Altitude, Net Status KSH
Add Alert ID : SIM extraction, GPS Fix, Voice Call, RS232 connect/disconnect
Rev. 1.24 2019-7-9 Modify Small Assign : Altitude KSH
Float -> Integer
Rev. 1.25 2019-07-10 Add RF event report (for only RF devices) JH KIM
Add Debug Information Report (for only LATAM)
Rev. 1.26 2019-07-12 Add Alert_ID(ST25T, ST20M) KSH
Add CAM, GED Report
Add Small, Middle Assign(ST25T)
Rev. 1.27 2019-07-26 MNT, SW_VER  DEVICE_FW_VER KSH
TRV, Add Histogram Speed Section
Rev. 1.28 2019-07-29 Added OUT_STATE Description SJSONG
Rev. 1.29 2019-08-02 Change the CRR description and parsing structure. HSPark
Rev. 1.30 2019-08-05 Changed the explanation of NET_STATUS KSH
Added PRM Report
Rev. 1.31 2019-08-07 Remove Fine Tracking Report KSH
Rev. 1.32 2019-08-08 Added explanation of RFA ACK, Changed OUT_STATE Description KSH
Rev. 1.33 2019-08-13 Changed explanation of PRM KSH
Changed explanation of GED
Rev. 1.34 2019-08-16 Add Assign(S/M/L) of GED KSH
Add Alert ID Over_Speed/Under_Speed in Poly Geofence
Rev. 1.35 2019-08-19 Changed the descriptions of RPT_MAP. KSH
STT_RPT_MAP, ALT_RPT_MAP, …, CAM_RPT_MAP  REPORT_MAP
Rev. 1.36 2019-08-20 Remove Debug Information Report. JH KIM
It is moved to Universal Engineering Commands

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 60 of 60


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.39 4 Sep. 2019

Rev. 1.37 2019-08-21 Changed explanation of GED(VEH_PROT/TRIP_FUEL/ENGINE_LOAD) KSH


Changed CAM ZIP HDR(0x87, 0x97)
Rev. 1.38 2019-08-27 Changed explanation of ZIP(ALTITUDE, ENGINE_TEMPERATURE). KSH
Rev. 1.39 2019-09-04 Add Alert ID Engine KSH

Suntech International Ltd. Confidential Document

Vous aimerez peut-être aussi