Professional Documents
Culture Documents
E3 Communication Protocol V3.7.2
E3 Communication Protocol V3.7.2
E3 family
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 2/20
Ver.: 3.7.2
E3 homologation protocol
Summary
Part one: GPRS protocol data structure .................................................................................................................. 3
Part two. Device status codes.................................................................................................................................. 3
Part three. Command list......................................................................................................................................... 5
Commands detail description .................................................................................................................................. 6
3.1 Registration - RG (Apply username and password from server) ............................................................... 6
3.2 Heartbeat data – HB (device send data to server to report status) ............................................................. 6
3.3 Tracking and monitoring – GZ .................................................................................................................. 7
3.4 Alarm mode setup and output control - FD ............................................................................................... 8
3.5 Alarm – AM ............................................................................................................................................... 9
3.6 Square geo fence – FE ............................................................................................................................... 9
3.7 Device send data to server to query UDP channel information – UP ...................................................... 10
3.8 Query service password from device - PW .............................................................................................. 10
3.9 Query device password from server – MM...............................................................................................11
3.10 To get detail address information - DW ..................................................................................................11
3.11 Over speed alarm set up - OD .................................................................................................................11
3.12 Device send data to server to advice it is online – TX ........................................................................... 12
3.13 Send SMS content from server - DX ..................................................................................................... 12
3.14 Modify IP and port – IP ......................................................................................................................... 12
3.15 Mileage correction – LC ........................................................................................................................... 13
3.16 Sleep mode period - SP .......................................................................................................................... 13
3.17 Period of working time till device goes to sleep mode after engine power off - AC ............................. 13
3.18 Motion sensor sensitivity – ZD .............................................................................................................. 14
3.19 Heart beat time interval set up - HT ....................................................................................................... 14
3.20 Power saving mode - PM ....................................................................................................................... 14
3.21 Set main monitoring number - ZH ..................................................................................................... 15
3.22 Secondary monitoring number set up - FH ........................................................................................ 15
3.23 Time zone set up - SQ ............................................................................................................................ 16
3.24 SMS language set up - LG ..................................................................................................................... 16
3.25 Round Geo-fence set up - WL ............................................................................................................... 16
3.27 SMS reply on and off - MG ................................................................................................................... 17
3.28 Device restart - CQ ................................................................................................................................ 17
3.29 Send SMS command from server - KS .................................................................................................. 18
3.30 Check device status - CX ....................................................................................................................... 18
3.31 Locate by cell tower - JZ........................................................................................................................ 19
3.32 ACC record - CC ................................................................................................................................... 19
3.33 Upload data stored while no GSM – MQ............................................................................................... 19
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 3/20
Ver.: 3.7.2
E3 homologation protocol
Network Communication Protocol (UDP/TCP)
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 4/20
Ver.: 3.7.2
E3 homologation protocol
Table for the status code:
Alarm mode 01000000
alarm against enter platform geo-fence(Square shape) 02000000
alarm against exit platform geo-fence(Square shape) 04000000
low voltage of backup battery 08000000
GPS malfunction 10000000
Vibration alarm 20000000
Car is driving 40000000
Over-speed alarm 80000000
SOS alarm 00010000
Movement alarm 00020000
Alarm against external power cut 00040000
Cut off engine power (output #1 on) 00080000
Output #2 on 00100000
Alarm of other car anti-theft device (input #2 on) 00200000
Power saving mode 00400000
ACC (ignition) on (input #1) 00800000
alarm against enter geo-fence 1 (Round shape) 00000100
alarm against exit geo-fence 1 (Round shape) 00000200
alarm against enter geo-fence 2 (Round shape) 00000400
alarm against exit geo-fence 2 (Round shape) 00000800
alarm against enter geo-fence 3 (Round shape) 00001000
alarm against exit geo-fence 3 (Round shape) 00002000
ADC alarm 00004000
Temperature alarm 00008000
harsh acceleration 00000001
harsh brake 00000002
urgent brake 00000004
Example:
ACC on and movement alarm is 40020000, over speed and sense of motion is A0000000
Note:
1. When ACC on (00800000), there will be status code 40000000 (car is driving). If ignition is off but sensed
continuous vibration, car is also regarded as driving
2. Only when alarm mode is on (01000000), there will be vibration alarm (20000000) or movement alarm
(00020000).
3. *letters in red color, needs extra wiring or devices to support
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 5/20
Ver.: 3.7.2
E3 homologation protocol
Part three. Command list
↑means data sent from device to server
↓means data sent from server to device
No.# CMD Description
1 RG ↑ The command to register device on server and apply username & password to log in.
2 HB ↑ The command to send HB data content. When car speed is 0, the data is sent each 10
minutes, and when car is driving, the data is sent each 20 seconds.
3 GZ ↓ The command for live tracking. After device received this command, it stops sending
HB, and send DW according to demand. Server will not reply
4 FD ↓ The command to set alarm mode and control outputs (e.g.: connect relay to control
engine power).
Only after activate alarm mode, there will be vibration alarm and movement alarm
5 AM ↑ The command to send alarm message.
6 FE ↓ The command of server to set square geo-fence.
7 UP ↑ The command to keep device in online status under UDP mode. It is sent each 5
minutes, and server need to reply in time, otherwise device will keep sending UP each
30 seconds. If server still not reply device after device sending 9 UP data, device will
restart.
8 PW ↑ The command to query service password from device.
9 MM ↓ The command to query device password from server.
10 DW ↑ The command to get position information. It is to query the detail address of device.
11 OD ↓ The command to set over-speed limit.
12 TX ↑ if HB interval is set too long, the device will lost contact with server. Therefore TX is
used here to keep contact with server. (TX data is sent each 3 minutes, and server should
reply it. If no reply, device will send this data each 30 seconds.)
13 DX ↓ The command to send SMS content.
14 IP ↓ IP set up.
15 LC ↓ The command to correct mileage.
16 SP ↓ The period of sleep time till device wake up automatically.
17 AC ↓ The period of working time till device goes to sleep mode after ignition off and no sense
of vibration
18 ZD ↓ Motion sensor sensitivity set up
19 HT ↓ Heart beat time interval set up
20 PM ↓ Power saving mode set up
21 ZH ↓ Set main monitoring number
22 FH ↓ Set secondary monitoring number
23 SQ ↓ Time zone set up
24 LG ↓ Set SMS language
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 6/20
Ver.: 3.7.2
E3 homologation protocol
25 WL ↓ Set round geo-fence
27 MG ↓ SMS reply on and off
28 CQ ↓ Restart device
29 KS ↓ The command to send SMS command from server
30 CX ↓ Check device status
31 JZ ↑ Locate by cell tower ID when GPS signal is weak
32 CC ↑ ACC on record
33 MQ ↑ Upload data which is stored while no GSM
Server replies:
*ET,SN,RG,msg#
Msg Uni_Str It is to tell users the status of registration.
E.g.:
*ET,135790246811221,RG,6CE8518C6210529FFF015BC67801662F003000310032003300340035FF01#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 7/20
Ver.: 3.7.2
E3 homologation protocol
Longitude Hex. Longitude of GPS data, 8 bytes, in hexadecimal. If it is west longitude, the first digit of the
hexadecimal is 8, and 8 should be taken out, then convert to decimal, and divide 600000.
e.g.:
0410A640, convert to decimal is 68200000, then divide 600000 is 113.666667 degrees east
81AA7A7A, take out first byte 8, is 1AA7A7A, convert to decimal is 27949690, then divide
600000, is 46.5828167 west
Speed Hex. Unit is one hundredth of one byte, is a 2-bytes short integer.
E.g.: speed is 12.6, multiply 100, equal as 1260, convert: 04EC, insufficient bits with 0 supplement
Course Hex. azimuth angle., north for 0 degree, clockwise, Unit is one hundredth byte, is 2-bytes short integer.
Eg: azimuth angle 30.5 degrees, multiplied by 100, get 3050, then convert to 0BEA, insufficient bits
with 0 supplements.
Status Hex. Device status code. Consist of 4 bytes. The values are in below table.
Signal Dec. GSM signal intensity, value from 0-32
Power Dec. Percentage of power supply, value range from 1 to 100 percent
Fuel Hex. Fuel capacity.
Mileage Hex. mileage, correct to 0.1 km, e.g., the uploaded data is 00F123, convert to decimal is 61731, and then
divide by 10, is the actual mileage 6173.1 KM
Altitude Dec. Altitude. Value is by meter. It is a 2 bytes integral. Example: Altitude=100 means 100 meters.
GPSdata Num_Str Consist of 5 satellite data, in decimal, without partition. Example, 4845423835, means 48, 45, 42,
38, 35
[RFID] Num_Str RFID card number
[Temperature] Hex. If 28.85 degrees C, first multiply by 100, then converted to 0B45
voltage Dec. ADC read power voltage.
Sat Dec. Number of satellites.
E.g.:
*ET,135790246811221,HB,A,050915,0C2A27,00CE5954,04132263,0000,F000,01000000,20,4,0000,00F123,1
00, 4845423835,0091564212,0B45,10.00,9#
This command requires device send data by “interval”, send “count” pieces of HB data. The utmost
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 8/20
Ver.: 3.7.2
E3 homologation protocol
frequency time is 65534. After device received this command, it will send HB data to server according to the
“interval” and “count”. If “count” is 65535, means device will keep sending data until receive command to stop.
If “count” is 1, then “interval” is invalid, means only send 1 piece of positioning data.
e.g.:
*ET,135790246811221,GZ,0001,0005,211.154.136.151,141e,1#
E.g.:
*ET, 135790246811221,GZ,0001,0005#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 9/20
Ver.: 3.7.2
E3 homologation protocol
y Result. 0 means fail to execute; 1 means execute successfully.
E.g.: F10 means fail to set up anti-theft mode, F21 means successfully cancelled anti-theft mode
Note:
1.Each command is optional, you just need to send code of command
2.While device execute the command, the sequence is from left to right
Example:
Server send command to activate anti-theft mode (F1), output #1 off (Y2)
*ET,135790246811221,FD,F1Y2#
Device replies:
*ET,135790246811221,FD,F11,Y21#
3.5 Alarm – AM
Format sent from device:
*ET,SN,AM,A/V,YYMMDD,HHMMSS,Latitude,Longitude,Speed,Course,Status,Signal,Power,Fuel,Mileage,Al
titude,voltage,Sat #
The data is sent from to server, to report alarm to server. The cause of alarm depends on the status string in
GPRS protocol data.
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 10/20
Ver.: 3.7.2
E3 homologation protocol
Remark:
Every GPRS protocol data should send multiple fence records. Between Every positioning record should be
separated by semicolon “;”
e.g.:
Server sends:
*ET,135790246811221,FE,0,02,00,0,015f5ff3,03c9658c,018d94a7,042df2b0;0,018e6fb4,045bc136,0174c433,0
4809fa1#
Device replies:
*ET,135790246811221,FE,1,01#
Server replies:
*ET,SN,UP#
*ET,135790246811221,UP#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 11/20
Ver.: 3.7.2
E3 homologation protocol
Server replies:
*ET,SN,PW,msg#
Msg Uni_Str The SMS content including service password.
Device replies:
*ET,SN,MM,PassWord#
PassWord Num_Str Device password
E.g.:
*ET,135790246811221,DW,A,050915,0C2A27,00CE5954,04132263,0000,F000,01000000,20,4,0000,001254,1
00,10.00,9#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 12/20
Ver.: 3.7.2
E3 homologation protocol
*ET,SN,OD,Speed#
Speed Hex. value of over speed (km/h)
Device replies:
*ET,SN,OD,Speed#
E.g.:
Device sends: *ET,135790246811221,TX,V,0c0101,011002#
Server replies: *ET,135790246811221,TX,V,0c0101,011002#
Device replies:
*ET,SN,DX#
Page: 13/20
Ver.: 3.7.2
E3 homologation protocol
*ET,001234561234567,IP,2,0B21374D,54D#
example:*ET,135790246811221,SP,00FF#
Device replies:
*ET,135790246811221,SP,00FF#
After set, device will wake up from sleep after 255 minutes
3.17 Period of working time till device goes to sleep mode after engine power off - AC
Format sent from server:
*ET,SN,AC,TIME,ON#
TIME Hex. the period till go to sleep: 0----FFFF minutes
ON 0/1 when connect ACC, it will send alarm. 1 means send, 0 means not send
example:*ET,135790246811221,AC,0005,1#
Device replies:
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 14/20
Ver.: 3.7.2
E3 homologation protocol
*ET,135790246811221,AC,0005,1 #
After set this, when device in power saving mode, if ignition is off for 5 minutes, device will go to sleep. And if
detected ignition, it will send alarm
Device replies:
*ET,135790246811221,ZD,05 #
TIME0 Hex. data transmission interval while car is driving: 0005 ~ FFFF seconds
TIME1 Hex. data transmission interval while car is parking: 0005 ~ FFFF seconds
Example: *ET,135790246811221,HT,05,0A #
Device replies:
*ET,135790246811221,HT,05,0A#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 15/20
Ver.: 3.7.2
E3 homologation protocol
Device replies:
*ET,135790246811221,PM,01#
Device replies:
*ET,135790246811221,ZH,008615859881788#
Device replies:
*ET,135790246811221,FH,result#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 16/20
Ver.: 3.7.2
E3 homologation protocol
Result=00 means delete failed,
Result =01 means delete successfully.
Device replies:
*ET,135790246811221,SQ,8.0#
Example: *ET,135790246811221,LG,01#
Device replies:
*ET,135790246811221,LG,01#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 17/20
Ver.: 3.7.2
E3 homologation protocol
fences
mode Fence mode:
1 alarm against exit fence
2 alarm against entering fence
3 alarm by both
num Number of fences: maximum can set 3. Each is marked by: 1, 2, 3
rad Hex. Radius: 01F4---FFFF (500 to 65535) meters
Latitude Hex. Center latitude
Longitude Hex. Center longitude
Note:
Every GPRS protocol data should send more fence records. Between Every positioning record should be
separated by semicolon “;”
Example:
*ET,135790246811221,WL,000A,03,01,01,01F4,015f5ff3,03c9658c;03,02,01F4,018e6fb4,045bc136 ;02,03,01F
4,018e6fb4,045bc136#
Device replies:
*ET,SN,FE,Result,RealCount#
Result 0/1 Fence receive result, “0” failure, “1” success
RealCount Hex. Actual received fence amount
Example:*ET,135790246811221,MG,01#
Device reply:
*ET,135790246811221,MG,01#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 18/20
Ver.: 3.7.2
E3 homologation protocol
*ET,SN,CQ#
Example :*ET,135790246811221,CQ#
Device reply:
*ET,135790246811221,CQ#
Example: send the SMS command from server, and need get SMS reply
*ET,135790246811221,KS,DW,15814021151#
If no need get SMS reply:
*ET,135790246811221,KS,DW,#
Device reply:
If successful:
*ET,135790246811221,KS,01#
If fail:
*ET,135790246811221,KS,00#
Example:*ET,135790246811221,CX#
Device reply:
*ET,135790246811221,CX,message#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 19/20
Ver.: 3.7.2
E3 homologation protocol
3.31 Locate by cell tower - JZ
When there is no GPS signal, device will upload this data
Format sent from device:
*ET,SN,JZ,RESULT,CELL_ID,LAC,MCC,MNC#
Server reply:
*ET,135790246811221,JZ,Msg#
Msg Uni_Str. Address text from server.
Server reply:
*ET,SN,MQ#
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com
Circular Nº: 06/2020
Page: 20/20
Ver.: 3.7.2
E3 homologation protocol
Num_Str: number string
Uni_Str: unicode string
Hex.: hexadecimal
Dec.: decimal
Char_Str.: character string
BWS IoT
Praça das Tulipas, 26 - Alphaville Comercial/Centro comercial, Barueri – SP
Tel.: +55 11 4191 – 7482 / 4193 – 1475/ 94017-4266
suporte@bwsiot.com
bwsiot.com