Sie sind auf Seite 1von 38

Doc.

Title Author Page of Pages

Device Communication Guide SE. Park 1 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

Table of Contents
1. Status Report .................................................................................................................................. 2
1.1 Zip (HEX, fixed length) .................................................................................................................................... 2
1.2 Normal (ASCII, variable length) ....................................................................................................................... 6
2. Alert Report ................................................................................................................................... 10
2.1 Zip (HEX, fixed length) .................................................................................................................................. 10
2.2 Normal (ASCII, variable length) ..................................................................................................................... 14
2.3 Alert ID Table................................................................................................................................................. 18
3. Keep-Alive Report ......................................................................................................................... 21
3.1 Zip (HEX, fixed length) .................................................................................................................................. 21
3.2 Normal (ASCII, variable length) ..................................................................................................................... 21
4. External Serial Device Data Report (RS232) ............................................................................... 22
4.1 Zip (HEX, fixed length) .................................................................................................................................. 22
4.2 Normal (ASCII, variable length)..................................................................................................................... 24
5. Transfer Data to External Serial ................................................................................................... 26
5.1 Send Format .................................................................................................................................................. 26
5.2 Response Format .......................................................................................................................................... 26
6. Travel Report................................................................................................................................. 27
6.1 Zip (HEX, fixed length) .................................................................................................................................. 27
6.2 Normal (ASCII, variable length) ..................................................................................................................... 30
7. Acknowledgment Message .......................................................................................................... 32
7.1 Zip (HEX, fixed length) .................................................................................................................................. 32
7.2 Normal (ASCII, variable length)..................................................................................................................... 33
8. Crash Reconstruction Report (Optional) .................................................................................... 34
8.1 Send Format .................................................................................................................................................. 34
9. Maintenance Report...................................................................................................................... 35
10. Small Assign Headers ................................................................................................................ 36
11. Medium Assign Headers ............................................................................................................ 37
12. Large Assign Headers ................................................................................................................ 37
Revisions .............................................................................................................................................. 38

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 2 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 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 31 60 00 00 00 01 3F 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 01 02 01 EC
HDR PKT_LEN DEV_ID STT_RPT_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 31 Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
Device ID , BCD Format
DEV_ID 60 00 00 00 01 HEX
If the Device ID is 6000000001, this field will be filled
with 0x60, 0x00, 0x00 0x00 and 0x01.
Map of the headers that are included in the report
Bit 0: STT_RPT_MAP
Bit 1: MODEL
STT_RPT_MAP Bit 2: SW_VER
3F FF FF HEX -> BIN
(Map Bit 0) ….
Bit 21: MSG_NUM
Bit 22: reserved
Bit 23: ASSIGN_MAP
Value: 30
MODEL Device Model (According to table model).
1E HEX -> DEC
(Map Bit 1)
Model Identification Table
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 3 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

Model ID
ST600 26
ST4300 30
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 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 07 90 27 93 HEX -> DEC
 0 = positive
(Map Bit 12)
To convert take HEX(07902793) and convert to
Decimal value of 126,887,827 then divide by
1,000,000
Value: 062.03
SPD HEX(18 3B) = Decimal 6,203
18 3B HEX -> DEC
(Map Bit 13) Take the decimal value and divide by 100 to get
62.03km/h
CRS 19 8F HEX -> DEC Value: 65.43
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 4 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

(Map Bit 14) HEX(19 8F) = Decimal 6,543


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’
(Map Bit 16)
01 HEX -> DEC
 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

OUT_STATE RSV RSV RSV Out5 Out4 Out3 Out2 Out1


08 HEX -> BIN
(Map Bit 18)
Out: 1 (Active), 0 (Inactive).

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
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

ASSIGN_MAP HEX -> BIN


Bit 0: S_ASSIGN1 (2 Bytes)
(Map Bit 23) Bit 1: S_ASSIGN2 (2 Bytes)
….
Bit 14: S_ASSIGN15 (2 Bytes)
Bit 15: M_ASSIGN1 (4 Bytes)
….
Bit 22: M_ASSIGN8 (4 Bytes)
Bit 23: L_ASSIGN1 (8 Bytes)
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 5 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019


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
(Assign_Map Bit 14)
M_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 15)  See options in table 5 below
Custom Medium Assignable Header (4 Bytes in
M_ASSIGN2 length)
(Assign_Map Bit 16)
 See options in table 6 below
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)
Custom Medium Assignable Header (4 Bytes in
M_ASSIGN8 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)

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 6 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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


80 1F 06 02 D9 50 39 F8 39 01 10 0B 11 08 25 27 02 B3 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
80 1C 06 02 D9 50 01 10 0B 11 08 25 27 02 B3 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
80 3D 06 02 D9 50 BF FF FF 1A 00 0A 01 10 0B 11 08 25 27 0000004F 01 C2 00 00 00 0E 14 02 B3 E3 9B 07
90 27 93 18 3B 19 8F 0A 01 05 08 01 02 01 EC 00 80 00 03 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
80 39 06 02 D9 50 3F FF FF 1A 00 0A 01 10 0B 11 08 25 27 0000004F 01 C2 00 00 00 0E 14 02 B3 E3 9B 07
90 27 93 18 3B 19 8F 0A 01 05 08 01 02 01 EC 24 04 AA 50 00 00 19 3E 0C CD 01

1.2 Normal (ASCII, variable length)

Example Raw Zip Data:


81 00 31 60 00 00 00 01 3F 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 01 02 01 EC
Example Normal Data (ASCII):
STT;6000000001;3FFFFF;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;1;2;0492
HDR DEV_ID STT_RPT_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

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 7 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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 6000000001 10 char Device ID.
Map of the headers that are included in the report
Bit 0: STT_RPT_MAP
Bit 1: MODEL
STT_RPT_MAP Bit 2: SW_VER
3FFFFF 6 char
(Map Bit 0) ….
Bit 21: MSG_NUM
Bit 22: reserved
Bit 23: ASSIGN_MAP
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
(Map Bit 6)
2G 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.
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 8 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

(Map Bit 15)


Fix Status
FIX ‘1’ or ‘0’
1 1 char  1 => GPS is fixed
(Map Bit 16)
 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

OUT_STATE RSV RSV RSV Out5 Out4 Out3 Out2 Out1


(Map Bit 18)
00001000 String
Out: 1 (Active), 0 (Inactive).

Mode the Device is in:


 0 = Parking
 1 = Driving
MODE 1 1 char  2 = Idle
(Map Bit 19)
 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
Message number.
MSG_NUM 0492 4 char After “9999” is reported, message number returns to
(Map Bit 21)
“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
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 9 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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
(Assign_Map Bit 14)
M_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 15)  See options in table 5 below
M_ASSIGN2 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 16)  See options in table 6 below
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)

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 10 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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;100850000;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;100850000;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


 S_ASSIGN1 = BCK_VOLT, S_ASSIGN2 = PWR_VOLT, L_ASSIGN1 = DID
STT;100850000;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;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;100850000;3FFFFF;26;010;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.0
3;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 32 60 00 00 00 01 3F 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 4B 03 02 00 DF
HDR PKT_LEN DEV_ID ALT_RPT_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)

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 11 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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 Alert Report.
HDR 82  82: No ACK response required
 92: Required ACK response
PKT_LEN 00 32 Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
DEV_ID 60 00 00 00 01 HEX
Device ID
Map of the headers that are included in the report
Bit 0: ALT_RPT_MAP
Bit 1: MODEL
ALT_RPT_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: 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

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 12 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

Value: +126.887827
Bit 31:
 1 = negative
LON 07 90 27 93 HEX -> DEC
 0 = positive
(Map Bit 12)
To convert take HEX(07902793) and convert to
Decimal value of 126,887,827 then divide by
1,000,000
Value: 062.03
SPD HEX(18 3B) = Decimal 6,203
18 3B HEX -> DEC
(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’
(Map Bit 16)
01 HEX -> DEC
 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
OUT_STATE 08 HEX -> BIN RSV RSV RSV Out5 Out4 Out3 Out2 Out1
(Map Bit 18)

Out: 1 (Active), 0 (Inactive).


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


ALERT_DATA  RFID tag number
00 DF HEX -> DEC
(Map Bit 21)  Driver ID number
 Temperature Data
reserved Reserved field (reports with FF if enabled)
(Map Bit 22)
ASSIGN_MAP HEX -> BIN Map of the custom assignable headers that can be
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 13 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

(Map Bit 23) 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)
….
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
(Assign_Map Bit 14)
M_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 15)  See options in table 5 below
Custom Medium Assignable Header (4 Bytes in
M_ASSIGN2 length)
(Assign_Map Bit 16)
 See options in table 6 below
M_ASSIGN3
(Assign_Map Bit 17)
M_ASSIGN4
(Assign_Map Bit 18)
M_ASSIGN5
(Assign_Map Bit 19)
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 14 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

M_ASSIGN6
(Assign_Map Bit 20)
M_ASSIGN7
(Assign_Map Bit 21)
Custom Medium Assignable Header (4 Bytes in
M_ASSIGN8 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


80 1C 06 02 D9 50 39 98 39 01 10 0B 11 08 25 27 02 B3 E3 9B 07 90 27 93 0A 01 01 02 01 EC

CASE 2: Minimal Data Alert ID Report Example & Status Report Map Removed
80 19 06 02 D9 50 01 10 0B 11 08 25 27 02 B3 E3 9B 07 90 27 93 0A 01 01 02 01 EC

CASE 3: Standard Alert ID Report Example with added assign options below
 S_ASSIGN3 = ADC_1, S_ASSIGN8 = TEMP_1, L_ASSIGN3 = TEMPID_1
80 3D 06 02 D9 50 BF FF FF 1A 00 0A 01 10 0B 11 08 25 27 0000004F 01 C2 00 00 00 0E 14 02 B3 E3 9B 07
90 27 93 18 3B 19 8F 0A 01 05 08 01 02 01 EC 00 40 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
80 39 06 02 D9 50 3F FF FF 1A 00 0A 01 10 0B 11 08 25 27 0000004F 01 C2 00 00 00 0E 14 02 B3 E3 9B 07
90 27 93 18 3B 19 8F 0A 01 05 08 01 02 01 EC 02 F8 01 14 15 00 00 00 45 0F B8 42

2.2 Normal (ASCII, variable length)


Example Zip Data:
82 00 32 60 00 00 00 01 3F 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 4B 03 02 00 DF
Example Normal Data (ASCII):

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 15 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

ALT;6000000001;3FFFFF;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;75;3;+22.3
HDR DEV_ID STT_RPT_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 Status Report.
HDR ALT 3-4 char  ALT: No ACK response required
 AALT: Required ACK response
DEV_ID 6000000001 10 char Device ID.
Map of the headers that are included in the report
Bit 0: ALT_RPT_MAP
Bit 1: MODEL
Bit 2: SW_VER
ALT_RPT_MAP 3FFFFF 6 char
….
Bit 21: ALERT_DATA
Bit 22: reserved
Bit 23: ASSIGN_MAP
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
(Map Bit 6)
2G 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
RX_LVL 1: -110 to -019 dBm
20 String
(Map Bit 10) ……
62: -49 to -48 dBm
63: greater than -48 dBm

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 16 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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 Status
FIX ‘1’ or ‘0’
(Map Bit 16)
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
(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

OUT_STATE RSV RSV RSV Out5 Out4 Out3 Out2 Out1


(Map Bit 18)
00001000 String
Out: 1 (Active), 0 (Inactive).

ALERT_ID Alert ID Number:


75 1 char
(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
ALERT_MOD
 Input that triggers Alert ID of Input High or Input
(Map Bit 20)
3 String Low

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


below.

Contains Data for certain Alert IDs


ALERT_DATA  RFID tag number
+22.3 String
(Map Bit 21)  Driver ID number
 Temperature Data
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.
ASSIGN_MAP HEX -> BIN
(Map Bit 23)
See Tables for Small, Medium, and Large Assign option
below for more information
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 17 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

Bit 0: S_ASSIGN1 (2 Bytes)


Bit 1: S_ASSIGN2 (2 Bytes)
….
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
(Assign_Map Bit 14)
M_ASSIGN1 Custom Small Assignable Header (2 Bytes in length)
(Assign_Map Bit 15)  See options in table 5 below
M_ASSIGN2 Custom Medium Assignable Header (4 Bytes in length)
(Assign_Map Bit 16)  See options in table 6 below
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)
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 18 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

(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;100850000;399839;1;20161117;08:37:39;+37.479323;+126.887827;10;1;1;2;0492

CASE 2: Minimal Data Report Example & Status Report Map Removed
STT;100850000;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
STT;100850000;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
STT;100850000;3FFFFF;26;010;1;20161117;08:37:39;0000004F;450;0;0014;20;+37.479323;+126.887827;62.0
3;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 - -
defined speed 1 threshold (Parameter #1621)
Alert is sent when the vehicle transitions back
Under Speed under the defined speed 1 threshold (Parameter 2 - -
#1621)
GPS Antenna Alert is sent when the external GPS antenna has
3 - -
Disconnected become disconnected
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 19 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

GPS Antenna Alert is sent when the external GPS antenna has
4 - -
Connected been connected
Alert is sent when the vehicle exits a defined Geo- Geo-Fence ID
Exit Geo-Fence Fence 5 (1-255) -
ZIP (1BYTE)
Alert is sent when the vehicle enters a defined Geo-Fence ID
Enter Geo-Fence Geo-Fence 6 (1-255) -
ZIP(1BYTE)
GPS Antenna Alert is sent if a short is detected on the external
8 - -
Shorted GPS antenna
Alert is sent when device is going into Sleep 1 = Deep Sleep
Mode 2 = Sleep
Enter Sleep 9 -
ZIP(1BYTE)
Alert is sent when the device is coming out of
Exit Sleep 10 - -
Sleep Mode
Alert is sent when the input is pulled high # of the Input
Input High 11 Line -
ZIP(1BYTE)
Alert is sent when the input is pulled low to ground # of the Input
Input Low 12 Line -
ZIP(1BYTE)
Alert is sent due to one of the reason that
described below.
Battery Error * backup-battery temperature is too high. 13 - -
* backup-battery voltage is too high.
* backup-battery charging fail.
Alert is sent when vehicle battery voltage drops
Battery Low 14 - -
below the ‘Low Battery Threshold’ in Power.
Alert is sent when the device detect the impact
that stronger than the ‘Shock threshold’ in
Shocked Accelerometer. It happens after time passes 15 - -
amount of shock detection delay from the parking
state starts.
Alert is sent when the device detect the impact
Crash Detected that stronger than the ‘Collision threshold’ in 16 - -
Accelerometer.
Ignition On Alert is sent when the Ignition Input is pulled high 33 - -
Ignition Off Alert is sent when the Ignition Input is pulled low 34 - -
Alert is sent when main power has been
Power Connected 40 - -
connected to the device
Alert is sent when main power had been
Power Disconnected 41 - -
disconnected from the device
Alert is sent when the Back-Up Battery has been
Battery Connected 44 - -
connected
Alert is sent when the Back-Up Battery has been
Battery Disconnected 45 - -
disconnected
Alert is sent when the vehicle exits a defined Poly Geo-Fence ID
Exit PolyGeo-Fence Geo-Fence 74 (1-30) -
ZIP (1BYTE)
Alert is sent when the vehicle enters a defined Geo-Fence ID
Enter PolyGeo-Fence Poly Geo-Fence 79 (1-30) -
ZIP(1BYTE)

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 46 - -
controlled by the Driver Pattern settings
Harsh Braking Alert is sent when a harsh braking event is 47 - -
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 20 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

detected. Harsh braking detection is controlled by


the Driver Pattern settings
Alert is sent when a sharp turn left event is
Sharp Turn Left detected. Sharp turn left detection is controlled by 48 -
the Driver Pattern settings.
Alert is sent when a sharp turn right event is
Sharp Turn Right detected. Sharp turn right detection is controlled 49 -
by the Driver Pattern settings.
Alert is sent when the Driver Pattern Behaviour
DPA Calibrated 86 - -
settings have finished calibrating
Jamming Detected Alert is sent when Jamming has been detected. 50 - -
Alert is sent when the iButton key has been State of
placed on the iButton Reader. iButton ID’s
registration
iButton Format Example:
iButton ID
iButton Read  [CRC] [SERIAL #] [FAMILY CODE] 59 0: Not ZIP(8BYTE)
 [1 byte] [6 bytes] [1 byte] Registered
 FE 00 00 12 B9 FB 8B 01 1: Registered

ZIP(1BYTE)
Alert is sent when the vehicle is entering Drive Mode Device is
Enter Drive Mode 29 -
Mode Exiting:
Alert is sent when the vehicle is entering Park
Enter Park Mode 31 -
Mode 0 = Parking
Alert is sent when the vehicle is entering Idle 1 = Driving
Enter Idle Mode 68 2 = Idle -
Mode
Alert is sent when the vehicle is entering Speed 3 = Speeding
Mode 4 = Park Mode
Entry Delay
5 = Drive Mode
Enter Speed Mode 36 Entry Delay -
6 = Towing

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

Alert is sent when the vehicle is entering Tow


Enter Tow 58 - -
Mode
Power Up An alert is sent when the device is turned on 99 - -
when the 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
Temperature
sensor readings goes above the high temperature that went above
Reading
Temp. High threshold 75 the threshold
ZIP(2BYTE)
ZIP(1BYTE)
Alert is sent when one of the 1-Wire temperature # of Temp Probe
Temperature
sensor readings goes below the low temperature that went below
Temp. Low 76 Reading
threshold the threshold
ZIP(2BYTE)
ZIP(1BYTE)
Alert is sent when one of the 1-Wire temperature # of Temp Probe
Temperature
sensor readings returns to a temperature reading that returned
Temp. Return 77 Reading
that is between the low temperature threshold and between the low
ZIP(2BYTE)
high temperature threshold and high
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 21 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

thresholds
ZIP(1BYTE)
Alert is sent when an RFID tag has been read RFID Tag
RFID Read from the RS232 serial interface 93 - Number
ZIP(5BYTE)
Low Back-up Battery Alert is sent when the Back-Up Battery is low. 43 - -

Note)
- In case of the ZIP, "ALERT_DATA" & “ALERT_MODE” field is filled with an "FF" for unsupported ALERTs.
- 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 60 00 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 60 00 00 00 01 HEX
Device ID:

3.2 Normal (ASCII, variable length)


Example Zip Data:
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 22 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

83 00 05 60 00 00 00 01
Example Normal Data (ASCII):
ALV;6000000001
HDR DEV_ID

Field Data Max Length Description


HDR ALV 3 char Header of Status Report.
DEV_ID 6000000001 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 48 60 00 00 00 01 3F 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 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 UEX_RPT_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 48 Length of zip data excluding HDR and PKT_LEN
Value: 6000000001
DEV_ID 60 00 00 00 01 HEX
Device ID

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 23 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

Map of the headers that are included in the report


Bit 0: UEX_RPT_MAP
Bit 1: MODEL
UEX_RPT_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: 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 07 90 27 93 HEX -> DEC
 0 = positive
(Map Bit 12)
To convert take HEX(07902793) and convert to
Decimal value of 126,887,827 then divide by
1,000,000
Value: 062.03
SPD HEX(18 3B) = Decimal 6,203
18 3B HEX -> DEC
(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

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 24 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

SATT 0A HEX -> DEC Number of GPS Satellites


(Map Bit 15)
Fix Status
FIX ‘1’ or ‘0’
(Map Bit 16)
01 HEX -> DEC
 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).
In: 1 (Ground, Shorted), 0 (Opened).
Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
OUT_STATE 08 HEX -> BIN
(Map Bit 18) RSV RSV RSV Out5 Out4 Out3 Out2 Out1
Out: 1 (Active), 0 (Inactive).
LEN Value: 25
00 19 HEX -> DEC
(Map Bit 19) Length of Data.
57 65 6C 63 6F 6D 65 Value: Welcome to Suntech World!
DATA 20 74 6F 20 53 75 6E Data from external RS232 device:
(Map Bit 20) 74 65 63 68 20 57 6F Up to 500 bytes.
72 6C 64 21
Value:
CHK_SUM 12 HEX -> DEC 8bit Checksum. Lower than8 bit of the summation of
(Map Bit 21)
DATA field.
Reserved
(Map Bit 22)
Reserved
(Map Bit 23)

4.2 Normal (ASCII, variable length)


Example Zip Data:
83 00 48 60 00 00 00 01 3F 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 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;6000000001;3FFFFF;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; Welcome to Suntech World!;12
HDR DEV_ID STT_RPT_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 6000000001 10 char Device ID.
Map of the headers that are included in the report
UEX_RPT_MAP Bit 0: UEX_RPT_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 25 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

….
Bit 21: CHK_SUM
Bit 22: reserved
Bit 23: reserved
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
(Map Bit 6)
2G 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
(Map Bit 10)
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).
(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’
(Map Bit 16)
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
(Map Bit 17)
Ignition: 1 (ON), 0 (OFF).
In: 1 (Ground, Shorted), 0 (Opened).
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 26 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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

OUT_STATE RSV RSV RSV Out5 Out4 Out3 Out2 Out1


(Map Bit 18)
00001000 String
Out: 1 (Active), 0 (Inactive).

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.
Value: 12
CHK_SUM 12 String 8bit Checksum. Lower than8 bit of the summation of
(Map Bit 21)
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;6000000001;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 6000000001 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

5.2 Response Format


Example Normal Data (ASCII):
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 27 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

RES;DEX;6000000001;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 6000000001 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 54 60 00 00 00 01 00 00 00 00 00 1E 01 00 0E 01 10 0B 11 08 25 27 02 B3 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

HDR PKT_LEN DEV_ID TRV_RPT_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_METE IDLE_TIME IDLE_EVENTS SPD_TIME SPD_EVENTS MAX_SPD


(4 Bytes) R (4 Bytes) (4 Bytes) (2 Byte) (4 Bytes) (2 Byte) (2 Bytes)

AVG_SPD GPS_ODOM
reserved reserved reserved reserved reserved
(2 Byte) (4 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 54 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 28 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 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: TRV_RPT_MAP
Bit 1: MODEL
TRV_RPT_MAP 00 00 00 00 00 HEX -> BIN Bit 2: SW_VER
(Map Bit 0)
….
Bit 38: reserved
Bit 39: reserved
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: +37.479323
Latitude of location where the trip started (Ignition On)
Bit 31:
LAT_TRV_ST  1 = negative
02 B3 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 02 4B 25 DB HEX -> DEC  1 = negative
(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
LON_TRV_FI Off)
07 9F 69 D3 HEX -> DEC Bit 31:
(Map Bit 9)
 1 = negative
 0 = positive

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 29 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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 Driver ID
HEX -> DEC
(Map Bit 10) CD 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
(Map Bit 14)
Ignition 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
Maximum Speed as calculated from GPS data
MAX_SPD 28 13 HEX -> DEC HEX(28 13) = Decimal 10,259
(Map Bit 17)
Take the decimal value and divide by 100 to get
102.59km/h
Value: 038.29 km/h
Average Speed as calculated from GPS data
AVG_SPD 0E F5 HEX -> DEC HEX(0E F5) = Decimal 3,829
(Map Bit 18)
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
Reserved
(Map Bit 20)
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
(Map Bit 28)
Reserved
(Map Bit 29)
Reserved
(Map Bit 30)
Reserved
Suntech International Ltd. Confidential Document
Doc. Title Author Page of Pages

Device Communication Guide SE. Park 30 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

(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 54 60 00 00 00 01 00 00 00 00 00 1E 01 00 0E 01 10 0B 11 08 25 27 02 B3 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

Example Normal Data (ASCII):


TRV;6000000001;07FFFFF;30;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

HDR DEV_ID TRV_RPT_MAP MODEL SW_VER MSG_TYPE DATE


TIME LAT_TRV_ST LON_TRV_ST LAT_TRV_FI LON_TRV_FI DRIVER_ID TRV_DIST
TRV_H_METER IDLE_TIME IDLE_EVENTS SPD_TIME SPD_EVENTS MAX_SPD AVG_SPD
GPS_ODOM reserved reserved reserved reserved reserved reserved
reserved reserved reserved reserved reserved reserved reserved
reserved reserved reserved reserved reserved reserved reserved

Field Data Conversion Description


Header of Travel Report.
HDR TRV 3-4 char  TRV: No ACK response required
 ATRV: Required ACK response
DEV_ID 6000000001 10 char Device ID.
Map of the headers that are included in the report
Bit 0: TRV_RPT_MAP
Bit 1: MODEL
TRV_RPT_MAP 0007FFFFFF 10 char Bit 2: SW_VER
(Map Bit 0)
….
Bit 38: reserved
Bit 39: reserved
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).

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 31 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

(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)
LAT_TRV_ST Latitude (+/-xx.xxxxxx) of location where the trip
+37.479323 String
(Map Bit 6) started (Ignition On)
LON_TRV_ST Longitude (+/-xx.xxxxxx) of location where the trip
+126.887827 String
(Map Bit 7) started (Ignition On)
LAT_TRV_FI Latitude (+/-xx.xxxxxx) of location where the trip
+38.479323 String
(Map Bit 8) 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 10800 String Driving Time meter in seconds for current trip
(Map Bit 12)
IDLE_TIME Time spent in Idle Mode for the entire trip in seconds
436 String
(Map Bit 13) (Ignition On to Ignition Off)
IDLE_EVENTS Number of Idle events during 1 trip (Ignition On to
2 String
(Map Bit 14) Ignition Off)
SPD_TIME 947 String Time spent in Speed Mode in seconds
(Map Bit 15)
SPD_EVENTS Number of times Speed Mode was entered from Drive
7 String
(Map Bit 16) Mode
MAX_SPD Maximum Speed as calculated from GPS data
102.59 String
(Map Bit 17) o Units in km/h
AVG_SPD Average Speed as calculated from GPS data
38.29 String
(Map Bit 18) o Units in km/h
GPS_ODOM 78245 String Odometer as calculated from GPS data
(Map Bit 19)
Reserved
(Map Bit 20)
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 32 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 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 07 60 00 00 00 01 91 62
HDR PKT_LEN DEV_ID ACK_RPT CHK_SUM
(1 Byte) (2 Bytes) (5 Bytes) (1 Byte) (1 Byte)

Field Data Conversion Description


HDR 90 Header of Acknowledge Message.
PKT_LEN 00 07 Length of zip data excluding HDR and PKT_LEN
Value: 100850000
DEV_ID 60 00 00 00 01 HEX
Device ID
Report in which the platform is Acknowledging
 91 = Status (requires ack)
 92 = Alert
 94 = UEX
ACK_RPT 91
 95 = Travel Report
 96 = OBDII Travel Report
 97 = Speed & Histogram Report
 98 = OBDII Report
The device will add the bytes of the original message
that come after the device ID, and the CHK_SUM
CHK_SUM 62 HEX -> DEC value in the Acknowledge report will be the first byte:

Example Report to Platform: 81 00 0B 60 00 00 00


0100 00 07 1A 00 0A 01

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 33 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

 When adding each byte value together,


starting with the blue highlighted field, the
total is HEX(02 62)  CHK_SUM would be 62

7.2 Normal (ASCII, variable length)


Example Zip Data:
90 00 07 60 00 00 00 01 91 62

Example Normal Data (ASCII):


ACK;6000000001;ASTT;02
HDR DEV_ID ACK_RPT CHK_SUM

Field Data Max Length Description


HDR ACK 8 char Header of Acknowledge Message.
DEV_ID 6000000001 10 char Device ID.
Report in which the platform is Acknowledging
 ASTT = Status (requires ack)
 AALT = Alert (requires ack)
 AUEX = UEX (requires ack)
ACK_RPT ASTT 4 char
 ATRV = Travel (requires ack)
 AOTR = OBDII Travel (requires ack)
 ASPR = Speed Histogram (requires ack)
 AOBD = OBDII (requires ack)
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.

Example Report to Platform:


Normal: STT;6000000001;000007;26;010;1
CHK_SUM 02 HEX -> DEC
Raw: 53 54 54 3B 31 30 30 38 35 30 30 30 30 30 3B 30
30 30 30 30 37 3B 32 36 3B 30 31 30 3B 31
 To calculate the CHK_SUM value add each byte
value together following the Device ID.
In this example these bytes would be added:
30 30 30 30 30 37 3B 32 36 3B 30 31 30 3B 31
The total value when added would be:
HEX(03 02)  CHK_SUM would be 02

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 34 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

8. Crash Reconstruction Report (Optional)

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.

8.1 Send Format


Example Normal Data (ASCII and Binary):
DEX;6000000001;LEN;DATA;CHK_SUM;0001-1
HDR DEV_ID LEN DATA CHK_SUM MSG_NO

Max
Field Data Description
Length
HDR DEX 3 char Header of Transfer Data to External Serial Message
DEV_ID 6000000001 10 char Device ID.
LEN 1024 4 char Length of the data being sent to the external serial device
1024 char
DATA Binary Data Crash Reconstruction Data
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 Crash
Reconstruction Data.
Message number: “main number – sub number”
MSG_NO 0001-01 6 char Main number is same as collision alert message number.
Sub number is series number of crash report packet.

<note>
Sub Message Number : 1
Data packet
Time : 6bytes
Year 1byte : Integer
Month 1byte : Integer
Day 1byte : Integer
Hour 1byte : Integer
Minute 1byte : Integer
Second 1byte : Integer
Crash Reconstruction Data : 34bytes * 30 = 1020 bytes
Latitude 4bytes : integer part of double float : 4bytes
Longitude 4bytes : integer part of double float : 4bytes
Speed 4bytes : integer (1:0.1km/h) : 2bytes
4Hz 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(3) : integer : 2bytes
Accelerometer Y-Axis(3) : integer : 2bytes
Accelerometer Z-Axis(3) : integer : 2bytes
Accelerometer X-Axis(4) : integer : 2bytes
Accelerometer Y-Axis(4) : integer : 2bytes
Accelerometer Z-Axis(4) : integer : 2bytes

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 35 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

Sub Message Number : 2~5


Data packet : It is 800hz Accelerometer data.
Crash Reconstruction Data : 6bytes * 200 = 1200 bytes
800Hz Accelerometer Data
Accelerometer X-Axis(n*) : integer : 2bytes
Accelerometer Y-Axis(n*) : integer : 2bytes
Accelerometer Z-Axis(n*) : integer : 2bytes

*n: 0~800

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

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;6000000001;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 6000000001 10 char Device ID.
SW_VER 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
PROF_VER 001 3 char
SyncTrak. 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

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 36 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

10. 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.
TEMP_1 03 01 14 +27.6 For -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.
TEMP_2 04 01 14 +27.6 For -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.
TEMP_3 05 01 14 +27.6 For -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.
TEMP_4 06 01 14 +27.6 For -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.
TEMP_5 07 01 14 +27.6 For -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.
 Zip: If Binary bit 15 is set, then the value is negative.
TEMP_6 08 01 14 +27.6 For -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 7 in the chain.
 Zip: If Binary bit 15 is set, then the value is negative.
TEMP_7 09 01 14 +27.6 For -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.
TEMP_8 0A 01 14 +27.6 For -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

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 37 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

11. 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


Calculated Odometer in meters using GPS location
GPS_ODOM 01 00 01 31 A5 78245
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.

12. 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 Driver ID
DID 01 500000193E0CCD01
3E 0C CD 01
15 00 00 00 Temperature Sensor ID number 1 in chain
TEMP_ID1 02 15000000450FB842
45 0F B8 42
15 00 00 00 Temperature Sensor ID number 2 in chain
TEMP_ID2 03 15000000450FB842
45 0F B8 42
15 00 00 00 Temperature Sensor ID number 3 in chain
TEMP_ID3 04 15000000450FB842
45 0F B8 42
15 00 00 00 Temperature Sensor ID number 4 in chain
TEMP_ID4 05 15000000450FB842
45 0F B8 42
15 00 00 00 Temperature Sensor ID number 5 in chain
TEMP_ID5 06 15000000450FB842
45 0F B8 42
15 00 00 00 Temperature Sensor ID number 6 in chain
TEMP_ID6 07 15000000450FB842
45 0F B8 42
15 00 00 00 Temperature Sensor ID number 7 in chain
TEMP_ID7 08 15000000450FB842
45 0F B8 42
15 00 00 00 Temperature Sensor ID number 8 in chain
TEMP_ID8 09 15000000450FB842
45 0F B8 42

Suntech International Ltd. Confidential Document


Doc. Title Author Page of Pages

Device Communication Guide SE. Park 38 of 38


Concerning Doc. No. Rev. Date

Suntech Messages to Back-End Server 1.14 13 Feb. 2019

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) SE 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. SE 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)’ SE 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.
Rev. 1.05 2018-10-22 Added Low Back-up Battery Alert 43 SE 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

Suntech International Ltd. Confidential Document

Das könnte Ihnen auch gefallen