E6S商用汽油电动物流车4G智能信息车载TBOX终端API.docx
- 文档编号:5978867
- 上传时间:2023-01-02
- 格式:DOCX
- 页数:40
- 大小:29.76KB
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=
起始符
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=
起始符
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=
起始符
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)参数
b)
c)
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=
起始符
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)若执行绑定盒子,参数
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=
起始符
3
终端序列号
12
命令字
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- E6S 商用 汽油 电动 物流 智能 信息 车载 TBOX 终端 API