新能源共享物流电动汽车4G车载TBOX智能信息终端E6S APIV12.docx
《新能源共享物流电动汽车4G车载TBOX智能信息终端E6S APIV12.docx》由会员分享,可在线阅读,更多相关《新能源共享物流电动汽车4G车载TBOX智能信息终端E6S APIV12.docx(42页珍藏版)》请在冰豆网上搜索。
新能源共享物流电动汽车4G车载TBOX智能信息终端E6SAPIV12
修订记录
版本
日期
作者
变更表述
1.0
2017-03-14
朱辉
修订版
1.1
2017-04-01
朱辉
1、删除36消息中操作类型为预约用车、取消预约、执行运维、结束运维、刷卡预约、刷卡运维的功能;
2、删除3A消息中当前状态、上一状态数据项;
3、删除设定终端当前状态指令及消息;
4、删除预约用车、取消预约、执行运维、结束运维功能;
1.11
2017-05-30
刘国琼
1、新能源商用电动物流车
目录
一、引言4
二、协议规范4
服务器端AT请求指令语法规范4
终端上传数据包格式规范4
三、终端主动上报消息格式定义6
35–上报刷卡消息(RFID版本专用)6
36–上报操作执行返回结果7
3A–实时数据消息8
四、终端系统设置指令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
B1-设备远程升级18
五、RFID版本接口21
CF-绑定管理员ID卡21
D1-解除绑定管理员ID卡21
D2-RFID电源控制22
D3-获取已存储ID卡列表23
D4-清空所有已存储ID卡23
六、蓝牙版本接口24
C9-重启蓝牙24
D5-设置蓝牙名称25
30/31/32-密钥更新26
七、车辆控制28
远程控制指令类型定义28
33-控制返回消息结果定义28
3E-开关动力控制29
服务器远程控制落锁/开锁/寻车30
APP蓝牙控制落锁/开锁/寻车/获取(蓝牙版本专用)31
用车32
还车33
八、附录-A错误代码详情34
九、附录-BSN号对应车型规则35
一、引言
该文档主要描述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----车窗未关闭
3A–实时数据消息
终端接入联网后,会定期上报实时数据消息包,定义如下:
组成
长度(byte)
内容
起始符
3
$E6
设备SN号
12
命令字
2
01
消息体长度
MAXLength:
1024
消息体
实时数据定义
结束符
2
回车换行符(0x0d0x0a)
$E6,E61600230001,3A,277,
2017-01-1015:
23:
00,01,1234567890,1,3,40,15535,14.2,
356.70,2.30,65,102,0,27,1,8,113.235646,22.125636,18.2,15.2,0,0,0\r\n
说明:
a)实时数据定义如下表:
数据序号
数据名称
单位
精度
数值范围
1
当前时间
YYYY-MM-DDhh:
mm:
ss
2
用户ID
有有用ID时,显示用户ID,无用户ID显示-1
3
钥匙状态
1----OFF
2----ON
0----未知(默认值)
4
车门状态
0----关闭
1----未关闭(默认值)
5
档位
1----P档
2----R档
3----N档
4----D档
0----未知(默认值)
6
车速
km/h
0~255
7
总里程
km
仪表盘总里程
默认值:
0
8
电瓶电压
V
0.0~28.0
默认值:
0
9
总电压
V
BMS总电压
默认值:
0.0
10
总电流
A
放电为+
充电为-
默认值:
0.0
11
剩余电量
%
0~100
默认值:
0
12
续航里程
km
0~255
默认值:
0
13
充电状态
1----充电
0----未充电(默认值)
14
网络信号值
dBm
0-31
15
定位状态
1----已定位
0----未定位(默认值)
16
卫星有效数量
0~36
17
定位经度
18
定位纬度
19
航向角度
20
海拔高度
21
预留
默认0
22
预留
默认0
23
预留
默认0
a)终端默认上报间隔时间为30秒,间隔时间可配置;
b)gps数据定位失败,上报经纬度为0;
c)gps经纬度格式为硬件坐标(WGS-84);
d)车门状态必须4个车门和后尾箱(若支持后尾箱信号)全部关闭,才为关闭,否则为未关闭。
终端系统设置指令
说明:
a)所有AT指令,必须大写,并且必须以回车换行符结束;
b)以下所有表格中,第一列表示为服务器端发送指令,第二、三、四列表示为终端返回的数据格式定义;
c)设置指令中,为设置的值,“<>”请不要输入;
81-请求终端设备信息
请求指令
数据
长度(byte)
内容
AT+SRI\r\n
起始符
3
终端序列号
12
命令字
2
81
消息体长度
消息体
设备序列号
E6硬件版本号
E6_firmware版本号
E6_IAP版本号
PLUS盒子固件版本号
PLUS盒子IAP版本号
蓝牙MAC地址
SIM卡IMEI号
结束符
2
回车换行(0x0d0x0a)
81-请求车辆信息
应用举例:
发送指令
>AT+SRI\r\n
接收
>$E6,0123456789AB,81,58,0123456789AB,V20140530,V1.2,V1.0,V1.3,V1.0,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)执行此指令,缓存数据将全部清空,其他参数设置不影响。
B1-设备远程升级
请求升级指令
数据
长度(byte)
内容
起始符
3
终端序列号
12
命令字
2
B1
消息体长度
消息体
请求标识
0001
E6主固件版本号
PLUS盒子固件版本号
结束符
2
回车换行(0x0d0x0a)
B1–远程设备升级
设置指令
数据
长度(byte)
内容
AT+SCFTPS=,,,
,,,\r\n
起始符
3
终端序列号
12
命令字
2
B1
消息体长度
消息体
0:
无需升级
1:
需要升级
升级文件类型
6----升级E6主固件
5----升级PLUS盒子主固件
Up_Address
升级地址(IP或者域名)
FTP账号用户名
FTP账号密码
升级程序文件名