E6S商用汽油电动物流车4G智能信息车载TBOX终端API.docx
《E6S商用汽油电动物流车4G智能信息车载TBOX终端API.docx》由会员分享，可在线阅读，更多相关《E6S商用汽油电动物流车4G智能信息车载TBOX终端API.docx（40页珍藏版）》请在冰豆网上搜索。
E6S商用汽油电动物流车4G智能信息车载TBOX终端API
修订记录
版本
日期
作者
变更表述
1.0
2017-03-14
朱辉
修订版
1.1
2017-04-01
朱辉
1、删除36消息中操作类型为预约用车、取消预约、执行运维、结束运维、刷卡预约、刷卡运维的功能；
2、删除3A消息中当前状态、上一状态数据项；
3、删除设定终端当前状态指令及消息；
4、删除预约用车、取消预约、执行运维、结束运维功能；
1.2
2017-04-25
朱辉
1、增加商用汽油车数据包；
2、增加远程点火/熄火控制接口指令；
3、调整81消息数据项。
1.21
2017-05-31
朱辉
1、增加商用电动物流车型及分类
目录
一、引言3
二、协议规范3
服务器端AT请求指令语法规范3
终端上传数据包格式规范3
三、终端主动上报消息格式定义5
35–上报刷卡消息（RFID版本专用）5
36–上报操作执行返回结果6
25-设备实时状态7
四、终端系统设置指令10
81-请求终端设备信息10
82-请求终端当前时间11
83-设置终端当前时间11
95-请求当前GSM卡信息12
97-请求当前连接信息12
98-设置当前连接信息13
38-设定设备参数值14
39–查询设备参数值15
8B-恢复出厂设置15
34-绑定盒子16
8A-重启终端17
BE-清除缓存记录17
五、RFID版本接口18
CF-绑定管理员ID卡18
D1-解除绑定管理员ID卡18
D2-RFID电源控制19
D3-获取已存储ID卡列表20
D4-清空所有已存储ID卡20
六、蓝牙版本接口21
C9-重启蓝牙21
D5-设置蓝牙名称22
30/31/32-密钥更新23
七、车辆控制25
远程控制指令类型定义25
33-控制返回消息结果定义25
3E-开关动力控制26
服务器远程控制落锁/开锁/寻车/点火/熄火27
APP蓝牙控制落锁/开锁/寻车/点火/熄火（蓝牙版本专用）28
用车29
还车29
八、附录-A错误代码详情30
九、附录-BSN号对应车型规则31
一、引言
该文档主要描述E6S新能源汽车智能信息终端数据接收指令及参数详解。
协议规范
服务器端AT请求指令语法规范
组成
长度（byte）
内容
起始符
2
AT（必须大写）
命令类型
见AT指令列表
结束符
2
回车换行（0x0d0x0a）
AT+SCZ\r\n
终端上传数据包格式规范
组成
长度（byte）
内容
起始符
3
$E6
设备SN号
12
命令字
2
消息体长度
消息体
结束符
2
回车换行符（0x0d0x0a）
$E6,0123456789ABC,01,1024,（Message）\r\n
指令列表
AT指令
命令字（HEX）
功能
指令说明
主动上报
35
上报刷卡消息
36
上报功能执行结果消息
37
车身校验未通过消息
3A
实时数据消息
AT+SCVOD
36
车辆预约
AT+SCVCOD
36
取消车辆预约
AT+SCVBR
36
用车
AT+SCVRT
36
还车
AT+SCVOP
36
车辆运维
AT+SCVCOP
36
结束运维
AT+SCDPM
38
设定设备参数值
AT+SRDPM
39
查询设备参数值
AT+SCSTAT
3D
设定当前状态
AT+SCENG
3E
控制开关动力
AT+SRI
81
请求设备当前信息
返回设备序列号、软件版本号、硬件版本号
AT+SRRTC
82
请求终端当前时间
AT+SCRTC
83
设置终端当前时间
AT+SCWS
8A
重启设备
AT+SCZ
8B
设备恢复出厂设置
AT+SRGSM
95
请求GSM卡信息
返回SIM卡IMEI、CCID、IMSI号
AT+SRCTI
97
请求当前设置的连接信息
返回连接类型、IP、域名、端口号
AT+SCCTI
98
设置终端连接服务器信息
AT+SCFTPS
B1
设备远程升级
AT+SCHIS
BE
清除缓存记录
AT+SCBDADFRID
CF
绑定管理员ID卡
AT+SCCLADRFID
D1
解除绑定管理员ID卡
AT+SCPRDON/
AT+SCPRDOFF/
AT+SCPRDRST
D2
RFID电源控制开启/关闭/重启
AT+SRADRFID
D3
请求保存的管理员ID列表
AT+SREPTADID
D4
清空所有已保存管理员ID卡
说明：
a）AT指令全部为大写，并且均以回车换行字符（即ENTER键）结尾：
\r\n（0x0D0x0A）；
b）命令字为16进制表示，供终端返回消息使用；
c）所有AT指令分请求指令和配置指令，请求指令以AT+SR开头，设置指令以AT+SC开头；
d）错误的AT指令返回“?
”；
e）本协议中的GPS定位点为硬件坐标（WGS-84）；
f）若不能识别的指令，终端统一返回消息：
>$E6,609465214943,FF,9,ERROR:
901\r\n
终端主动上报消息格式定义
35–上报刷卡消息（RFID版本专用）
当车辆处于可租状态时，用户刷卡预约车辆，会上报刷卡消息至平台。
组成
长度（byte）
内容
起始符
3
$E6
设备SN号
12
命令字
2
35
消息体长度
消息体
卡类型
卡号
刷卡时间
结束符
2
回车换行符（0x0d0x0a）
$E6,E61600230001,35,32,1,1234567890,2017-01-0315:
13:
00\r\n
说明：
a）卡类型定义：
1--普通用户卡2–管理运维卡；
b）触发上报刷卡消息情况有两种：
第一种是普通用于预约，第二种是管理运维刷卡；
c）此协议为RFID版本设备专用，蓝牙版本不支持此协议。
36–上报操作执行返回结果
当平台下发执行预约、用车、还车、取消预约、运维、结束运维指令时，终端会返回36消息，
告知平台功能操作的执行结果。
定义如下：
组成
长度（byte）
内容
起始符
3
$E6
设备SN号
12
命令字
2
36
消息体长度
消息体
操作类型
返回代码
当前时间
结束符
2
回车换行符（0x0d0x0a）
平台下发用车指令：
>AT+SCVBR=0123456789,965200\r\n
TBOX执行成功后返回：
>$E6,E61600230001,36,25,2017-01-0315:
13:
00,3,200\r\n
说明：
a）操作类型代码定义如下：
3----用车
4----还车
b）返回代码定义如下：
200-成功
203-卡号写入失败
204-卡号擦除失败
205–失败
206–超时
207----车速不为0
208----手刹未拉起
209----档位不为空挡
210----钥匙不在线
211----车门未关闭
212----车窗未关闭
213----车辆未熄火
214----车灯未关闭
215----后尾箱未关闭
25-设备实时状态
设备在车辆启动后，会每间隔10秒上报一包数据，车辆熄火后，会每间隔60秒上报一包，具体定义如下：
组成
长度（byte）
内容
起始符
3
$E6
终端序列号
12
命令字
2
25
消息体长度
MAXLength：
1024
消息体
设备实时状态
结束符
2
回车换行（0x0d0x0a）
示例:
$E6,0123456789AB,25,110,2017-04-1211:
22:
00,1125360,
2,1,1,1,1,0,1,1,13.6,1125,45,76,11253,53,8.3,25,1,7,113.253641,23.123456,156.3,12.3,0,0\r\n
实时状态包含如下信息：
数据序号
数据名称
单位
精度
数值范围
1
当前时间
2
用户ID
有有用ID时，显示用户ID，无用户ID显示-1
3
设备状态
0----工作模式（默认）
1----节能模式
2----待机模式
3----休眠模式
4----心跳模式（定时唤醒）
4
钥匙状态
1----OFF
2----ON
0----未知（默认值）
5
车门状态
1----关闭
0----未关闭（默认值）
6
后尾箱状态
1----关闭
0----未关闭（默认值）
7
车门锁状态
1----已锁
0----未锁（默认值）
8
车窗状态
1----关闭
0----未关闭（默认值）
9
车灯状态
1----关闭
0----未关闭（默认值）
10
档位
1----P档
2----R档
3----N档
4----D档
5----M1档
6----M2档
7----M3档
8----M4档
9----M5档
10----M6档
0----未知（默认值）
11
驻车制动
1----拉起
0----放下（默认值）
12
电瓶电压
V
0.0~28.0
默认值：
0.0
13
发动机转速
rpm
0~16383
默认值：
0
14
车速
km/h
0~255
默认值：
0
15
发动机冷却液温度
℃
0~255
默认值：
0
16
总里程
km
仪表盘总里程
默认值：
0
17
剩余油量
%
0~100
默认值：
0
18
平均油耗
100km/L
0.00~99.9
默认值：
0.0
19
网络信号值
dBm
0-31
默认值：
0
20
定位状态
1----已定位
0----未定位（默认值）
21
卫星有效数量
0~36
默认值：
0
22
定位经度
23
定位纬度
24
航向角度
°
25
海拔高度
m
0~65535
26
预留
用0代替
27
预留
用0代替
说明：
a）设备上报时间间隔为熄火后60秒报一次，车辆启动后默认间隔10秒上报一次；
b）gps数据定位失败，上报经纬度为0；
c）车门状态必须4个车门全部关闭，才为关闭，否则为未关闭，车窗、车锁判定也一样；
d）此消息可通过蓝牙指令获取，获取指令为ATSTAT\r\n；
终端系统设置指令
说明：
a）所有AT指令，必须大写，并且必须以回车换行符结束；
b）以下所有表格中，第一列表示为服务器端发送指令，第二、三、四列表示为终端返回的数据格式定义；
c）设置指令中，为设置的值，“<>”请不要输入；
81-请求终端设备信息
请求指令
数据
长度（byte）
内容
AT+SRI\r\n
起始符
3
终端序列号
12
命令字
2
81
消息体长度
消息体
E6硬件版本号
E6_firmware版本号
车架号
蓝牙名称
蓝牙MAC地址
SIM卡CCID号
结束符
2
回车换行（0x0d0x0a）
81-请求终端设备信息
应用举例：
发送指令
>AT+SRI\r\n
接收
>$E6,0123456789AB,81,76,V20140530,V1.2,LPC152EP1A0025634,UJ_2P3Q3_,23-12-DF-02-2D-98,863158020092930\r\n
说明：
a）本消息在每次TCP建立之后，会自动上报一次。
82-请求终端当前时间
请求指令
数据
长度（byte）
内容
AT+SRRTC\r\n
起始符
3
终端序列号
12
命令字
2
82
消息体长度
消息体
当前时间
格式：
YYYY-MM-DDhh:
mm:
ss
结束符
2
回车换行（0x0d0x0a）
82-请求终端当前时间
应用举例：
发送指令
>AT+SRRTC\r\n
接收
>$E6,0123456789AB,82,19,2014-05-2710:
02:
28\r\n
83-设置终端当前时间
设置指令
数据
长度（byte）
内容
AT+SCRTC=\r\n
起始符
3
终端序列号
12
命令字
2
83
消息体长度
消息体
返回结果
OK:
设置成功
ERROR:
101:
失败或者参数设置不正确
结束符
2
回车换行（0x0d0x0a）
83-设置终端当前时间
应用举例：
发送指令（设置当前日期为2014年4月13日21时51分23秒）
>AT+SCRTC=20140413215123\r\n
接收
如设置正确，则返回
>$E6,0123456789AB,83,2,OK\r\n
如设置出错，则返回：
>$E6,0123456789AB,83,9,ERROR:
101\r\n
说明：
a）时间格式必须为：
YYYYMMDDhhmmss，否则返回错误信息；
b）设置错误或者参数设置不正确会返回一个3位数错误编号，相应的错误编号代码详情请参见附录A；
95-请求当前GSM卡信息
请求指令
数据
长度（byte）
内容
AT+SRGSM\r\n
起始符
3
终端序列号
12
命令字
2
95
消息体长度
消息体
15
IMEI号
SIM卡唯一序列号
20
CCID号
SIM卡识别标识
15
IMSI号
国际移动台设备标识（15位）
结束符
2
回车换行（0x0d0x0a）
95–请求当前GSM卡信息
应用举例：
发送指令
>AT+SRGSM\r\n
接收
>$E6,0123456789AB,95,52,863158020092930,89860041191302652714,460023141313920\r\n
97-请求当前连接信息
请求指令
数据
长度（byte）
内容
AT+SRCTI\r\n
起始符
3
终端序列号
12
命令字
2
97
消息体长度
消息体
连接类型
IP地址
域名
端口号
结束符
2
回车换行（0x0d0x0a）
97–请求当前连接信息
应用举例：
发送指令
>AT+SRCTI\r\n
接收
>$E6,0123456789AB,97,23,0,192.168.0.1,NULL,8899\r\n
或者
>$E6,0123456789AB,97,28,1,NULL,,8899\r\n
说明：
a）连接类型
0------未设置
1------IP地址连接
2------域名连接
如连接类型为1，则域名为NULL，为2，则IP地址为NULL；
98-设置当前连接信息
请求指令
数据
长度（byte）
内容
AT+SCCTI=,,
,\r\n
起始符
3
终端序列号
12
命令字
2
98
消息体长度
消息体
返回结果
结束符
2
回车换行（0x0d0x0a）
98–设置当前连接信息
应用举例：
发送指令
如设置IP连接，则发送
>AT+SCCTI=1,192.168.0.1,NULL,8899\r\n
如设置域名连接，则发送
>AT+SCCTI=2,NULL,,8899\r\n
接收
如设置正确，则返回：
>$E6,0123456789AB,98,2,OK\r\n
如设置出错，则返回：
>$E6,0123456789AB,98,9,ERROR:
301\r\n
38-设定设备参数值
设置指令
数据
长度（byte）
内容
AT+SCDPM=,,
,,
\r\n
起始符
3
终端序列号
12
命令字
2
38
消息体长度
消息体
返回结果
OK:
设置成功
ERROR:
119:
失败或者参数设置不正确
结束符
2
回车换行（0x0d0x0a）
38–设定设备参数值
应用举例：
发送指令（设定SOC上下线阀值为20,30,预约时间值为900秒,启动上报时间间隔30秒,熄火上报时间间隔为120秒）
>AT+SCDPM=20,30,900,30,120\r\n
接收
如标定正确，则返回
>$E6,E61600230001,38,2,OK\r\n
如标定不正确（设定值不在指定范围），则返回
>$E6,E61600230001,38,9,ERROR:
119\r\n
说明：
a）参数,分别为SOC自动下线值和soc自动上线值，设定范围0~100，参数[min_soc]必须小于[max_soc]；
b）值默认为900，最小值为300，单位为秒；
c）,分别为3A消息启动上报时间间隔和熄火上报时间间隔，单位为秒，上报时间间隔最小值为10秒；
39–查询设备参数值
请求指令
数据
长度（byte）
内容
AT+SRDPM\r\n
起始符
3
终端序列号
12
命令字
2
39
消息体长度
消息体
SOC自动下线阀值
SOC自动上线阀值
预约有效时间值
启动上报时间间隔
熄火上报时间间隔
结束符
2
回车换行（0x0d0x0a）
39–查询设备参数值
应用举例：
发送指令
>AT+SRDPM\r\n
接收
>$E6,0123456789AB,39,3,20,30,900,30,120\r\n
8B-恢复出厂设置
设置指令
数据
长度（byte）
内容
AT+SCZ\r\n
起始符
3
终端序列号
12
命令字
2
消息体长度
消息体
返回结果
结束符
2
回车换行（0x0d0x0a）
8B–恢复出厂设置设置
应用举例：
发送指令
>AT+SCZ\r\n
接收
>$E6,0123456789AB,8B,2,OK\r\n
说明：
a）该指令在执行前会发送准备执行恢复出厂设置，然后断开所有连接，清零OBD模块保存的累计数据，加载默认的初始化数据（保存的远程连接信息不会清空），删除FLASH里面存储的数据，进入重启；
34-绑定盒子
设置指令
数据
长度（byte）
内容
AT+SCSNBIND=\r\n
起始符
3
终端序列号
12
命令字
2
34
消息体长度
消息体
返回结果
OK:
设置成功
ERROR:
112/113:
失败或者参数设置不正确
结束符
2
回车换行（0x0d0x0a）
34–绑定PLUS盒子
应用举例：
发送指令（绑定盒子）
>AT+SCSNBIND=656154700125\r\n
接收
如绑定正确，则返回
>$E6,0123456789AB,34,2,OK\r\n
如绑定错误，则返回
>$E6,0123456789AB,34,9,ERROR:
113\r\n
如E6盒子不在线，则返回
>$E6,0123456789AB,34,9,ERROR:
112\r\n
发送指令（解除绑定）
>AT+SCSNBIND=0\r\n
如解除绑定成功，则返回
>$E6,0123456789AB,34,2,OK\r\n
如解除绑定错误，则返回
>$E6,0123456789AB,34,9,ERROR:
113\r\n
如E6盒子不在线，则返回
>$E6,0123456789AB,34,9,ERROR:
112\r\n
说明：
a）若执行绑定盒子，参数长度固定为12位长度；
b）若当前终端的SN号与绑定的SN号不一致，PLUS盒子的钥匙将无法控制车辆的开锁落锁功能。
8A-重启终端
设置指令
数据
长度（byte）
内容
AT+SCWS\r\n
起始符
3
终端序列号
12
命令字
2
8A
消息体长度
MAXLength：
1024
消息体
返回结果
结束符
2
回车换行（0x0d0x0a）
8A-重启终端
应用举例：
发送指令
>AT+SCWS\r\n
接收
>$E6,0123456789AB,8A,2,OK\r\n
BE-清除缓存记录
设置指令
数据
长度（byte）
内容
AT+SCHIS\r\n
起始符
3
终端序列号
12
命令字
2
BE
消息体长度
MAXLength：
1024
消息体
返回结果
结束符
2
回车换行（0x0d0x0a）
BE-清除缓存记录
应用举例：
发送指令
>AT+SCHIS\r\n
接收
>$E6,0123456789AB,BE,2,OK\r\n
说明：
a）执行此指令，缓存数据将全部清空，其他参数设置不影响。
RFID版本接口
CF-绑定管理员ID卡
说明：
绑定的ID卡可通过RFID刷卡器感应开锁落锁。
设置指令
数据
长度（byte）
内容
AT+SCBDADRFID=\r\n
起始符
3
终端序列号
12
命令字
升级会员 