E6S商用汽油电动物流车4G智能信息车载TBOX终端API.docx

1、E6S商用汽油电动物流车4G智能信息车载TBOX终端API修订记录版本日期作者变更表述1.02017-03-14朱辉修订版1.12017-04-01朱辉1、 删除36消息中操作类型为预约用车、取消预约、执行运维、结束运维、刷卡预约、刷卡运维的功能；2、 删除3A消息中当前状态、上一状态数据项；3、 删除设定终端当前状态指令及消息；4、 删除预约用车、取消预约、执行运维、结束运维功能；1.22017-04-25朱辉1、 增加商用汽油车数据包； 2、 增加远程点火/熄火控制接口指令；3、 调整81消息数据项。1.212017-05-31朱辉1、增加商用电动物流车型及分类目录一、 引言 3二、 协议

2、规范 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-绑

3、定管理员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九、 附录-B SN号对应车型规则 31一、 引言该文

4、档主要描述E6S新能源汽车智能信息终端数据接收指令及参数详解。协议规范服务器端AT请求指令语法规范组成长度（byte）内容起始符2AT（必须大写）命令类型见AT指令列表结束符2回车换行（0x0d 0x0a）AT+SCZrn终端上传数据包格式规范组成长度（byte）内容起始符3$E6设备SN号12命令字2消息体长度消息体结束符2回车换行符（0x0d 0x0a）$E6,0123456789ABC,01,1024,(Message)rn指令列表AT指令命令字（HEX）功能指令说明主动上报35上报刷卡消息36上报功能执行结果消息37车身校验未通过消息3A实时数据消息AT+SCVOD36车辆预约AT+S

5、CVCOD36取消车辆预约AT+SCVBR36用车AT+SCVRT36还车AT+SCVOP36车辆运维AT+SCVCOP36结束运维AT+SCDPM38设定设备参数值AT+SRDPM39查询设备参数值AT+SCSTAT3D设定当前状态AT+SCENG3E控制开关动力AT+SRI81请求设备当前信息返回设备序列号、软件版本号、硬件版本号AT+SRRTC82请求终端当前时间AT+SCRTC83设置终端当前时间AT+SCWS8A重启设备AT+SCZ8B设备恢复出厂设置AT+SRGSM95请求GSM卡信息返回SIM卡IMEI、CCID、IMSI号AT+SRCTI97请求当前设置的连接信息返回连接类型、

6、IP、域名、端口号AT+SCCTI98设置终端连接服务器信息AT+SCFTPSB1设备远程升级AT+SCHISBE清除缓存记录AT+SCBDADFRIDCF绑定管理员ID卡AT+SCCLADRFIDD1解除绑定管理员ID卡AT+SCPRDON/AT+SCPRDOFF/AT+SCPRDRSTD2RFID电源控制开启/关闭/重启AT+SRADRFIDD3请求保存的管理员ID列表AT+SREPTADIDD4清空所有已保存管理员ID卡说明：a) AT指令全部为大写，并且均以回车换行字符（即ENTER键）结尾：rn(0x0D0x0A)；b) 命令字为16进制表示，供终端返回消息使用；c) 所有AT指令分

7、请求指令和配置指令，请求指令以AT+SR开头，设置指令以AT+SC开头； d) 错误的AT指令返回“?”；e) 本协议中的GPS定位点为硬件坐标（WGS-84）；f) 若不能识别的指令，终端统一返回消息：$E6,609465214943,FF,9,ERROR:901rn终端主动上报消息格式定义35上报刷卡消息（RFID版本专用）当车辆处于可租状态时，用户刷卡预约车辆，会上报刷卡消息至平台。组成长度（byte）内容起始符3$E6设备SN号12命令字235消息体长度消息体卡类型卡号刷卡时间结束符2回车换行符（0x0d 0x0a）$E6,E61600230001,35,32,1,1234567890

8、,2017-01-03 15:13:00rn 说明：a) 卡类型定义： 1 - 普通用户卡 2 管理运维卡；b) 触发上报刷卡消息情况有两种：第一种是普通用于预约，第二种是管理运维刷卡；c) 此协议为RFID版本设备专用，蓝牙版本不支持此协议。36上报操作执行返回结果当平台下发执行预约、用车、还车、取消预约、运维、结束运维指令时，终端会返回36消息， 告知平台功能操作的执行结果。定义如下： 组成长度（byte）内容起始符3$E6设备SN号12命令字236消息体长度消息体操作类型返回代码当前时间结束符2回车换行符（0x0d 0x0a）平台下发用车指令：AT+SCVBR=0123456789,96

9、5200rnTBOX执行成功后返回：$E6,E61600230001,36,25,2017-01-03 15:13:00,3,200rn 说明：a) 操作类型代码定义如下：3 - 用车4 - 还车b) 返回代码定义如下：200 - 成功203 - 卡号写入失败204 - 卡号擦除失败205 失败206 超时207 - 车速不为0208 - 手刹未拉起209 - 档位不为空挡210 - 钥匙不在线211 - 车门未关闭212 - 车窗未关闭213 - 车辆未熄火214 - 车灯未关闭215 - 后尾箱未关闭25-设备实时状态设备在车辆启动后，会每间隔10秒上报一包数据 ，车辆熄火后，会每间隔60

10、秒上报一包，具体定义如下：组成长度（byte）内容起始符3$E6终端序列号12命令字225消息体长度MAX Length：1024消息体设备实时状态结束符2回车换行（0x0d 0x0a）示例:$E6,0123456789AB,25,110,2017-04-12 11: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,0rn实时状态包含如下信息：数据序号数据名称单位精度数值范围1当前时间2用户ID有有用ID时，显示用户ID，无用户ID显示-13设

11、备状态0 - 工作模式（默认）1 - 节能模式2 - 待机模式3 - 休眠模式4 - 心跳模式（定时唤醒）4钥匙状态1 - OFF2 - ON0 - 未知（默认值）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、值）12电瓶电压V0.0 28.0默认值：0.0 13发动机转速rpm0 16383默认值：014车速km/h0 255默认值：015发动机冷却液温度0 255默认值：016总里程km仪表盘总里程默认值：017剩余油量%0 100默认值：018平均油耗100 km/L0.00 99.9默认值：0.019网络信号值dBm0 - 31默认值：020定位状态1 - 已定位0 - 未定位（默认值）21卫星有效数量0 36默认值：022定位经度23定位纬度24航向角度25海拔高度m0 6553526预留用0代替27预留用0代替说明：a) 设备上报时间间隔为熄火后60秒报一次，车辆启动后默认间隔10秒上报

13、一次；b) gps数据定位失败，上报经纬度为0；c) 车门状态必须4个车门全部关闭，才为关闭，否则为未关闭，车窗、车锁判定也一样；d) 此消息可通过蓝牙指令获取，获取指令为ATSTATrn；终端系统设置指令说明：a) 所有AT指令，必须大写，并且必须以回车换行符结束；b) 以下所有表格中，第一列表示为服务器端发送指令，第二、三、四列表示为终端返回的数据格式定义；c) 设置指令中，为设置的值，“”请不要输入； 81-请求终端设备信息请求指令数据长度(byte)内容AT+SRIrn起始符3终端序列号12命令字281消息体长度消息体E6硬件版本号E6_firmware版本号车架号蓝牙名称蓝牙MAC地

14、址SIM卡CCID号结束符2回车换行(0x0d 0x0a)81 - 请求终端设备信息应用举例：发送指令AT+SRIrn接收$E6,0123456789AB,81,76,V20140530,V1.2,LPC152EP1A0025634,UJ_2P3Q3_,23-12-DF-02-2D-98,863158020092930rn说明：a) 本消息在每次TCP建立之后，会自动上报一次。82-请求终端当前时间请求指令数据长度(byte)内容AT+SRRTCrn起始符3终端序列号12命令字282消息体长度消息体当前时间格式：YYYY-MM-DD hh:mm:ss结束符2回车换行(0x0d 0x0a)82

15、- 请求终端当前时间应用举例：发送指令AT+SRRTCrn接收$E6,0123456789AB,82,19,2014-05-27 10:02:28rn83-设置终端当前时间设置指令数据长度(byte)内容AT+SCRTC=rn起始符3终端序列号12命令字283消息体长度消息体返回结果OK:设置成功ERROR:101:失败或者参数设置不正确结束符2回车换行(0x0d 0x0a)83 - 设置终端当前时间应用举例：发送指令（设置当前日期为2014年4月13日 21时51分23秒）AT+SCRTC=20140413 215123rn接收如设置正确，则返回$E6,0123456789AB,83,2,O

16、Krn如设置出错，则返回：$E6,0123456789AB,83,9,ERROR:101rn说明：a) 时间格式必须为：YYYYMMDD hhmmss，否则返回错误信息；b) 设置错误或者参数设置不正确会返回一个3位数错误编号，相应的错误编号代码详情请参见附录A；95-请求当前GSM卡信息请求指令数据长度(byte)内容AT+SRGSMrn起始符3终端序列号12命令字295消息体长度消息体15IMEI号SIM卡唯一序列号20CCID号SIM卡识别标识15IMSI号国际移动台设备标识（15位）结束符2回车换行(0x0d 0x0a)95 请求当前GSM卡信息应用举例：发送指令AT+SRGSMrn接

17、收$E6,0123456789AB,95,52,863158020092930,89860041191302652714,460023141313920rn97-请求当前连接信息请求指令数据长度(byte)内容AT+SRCTIrn起始符3终端序列号12命令字297消息体长度消息体连接类型IP地址域名端口号结束符2回车换行(0x0d 0x0a)97 请求当前连接信息应用举例：发送指令AT+SRCTIrn接收$E6,0123456789AB,97,23,0,192.168.0.1,NULL,8899rn或者$E6,0123456789AB,97,28,1,NULL,8899rn说明：a) 连接类型

18、 0 - 未设置1 - IP地址连接2 - 域名连接如连接类型为1，则域名为NULL，为2，则IP地址为NULL；98-设置当前连接信息请求指令数据长度(byte)内容AT+SCCTI=,rn起始符3终端序列号12命令字298消息体长度消息体返回结果结束符2回车换行(0x0d 0x0a)98 设置当前连接信息应用举例：发送指令如设置IP连接，则发送AT+SCCTI=1,192.168.0.1,NULL,8899rn如设置域名连接，则发送AT+SCCTI=2,NULL,8899rn接收如设置正确，则返回：$E6,0123456789AB,98,2,OKrn如设置出错，则返回：$E6,012345

19、6789AB,98,9,ERROR:301rn38-设定设备参数值设置指令数据长度(byte)内容AT+SCDPM=,rn起始符3终端序列号12命令字238消息体长度消息体返回结果OK:设置成功ERROR:119:失败或者参数设置不正确结束符2回车换行(0x0d 0x0a)38 设定设备参数值应用举例：发送指令（设定SOC上下线阀值为20,30,预约时间值为900秒,启动上报时间间隔30秒,熄火上报时间间隔为120秒）AT+SCDPM =20,30,900,30,120rn接收如标定正确，则返回 $E6,E61600230001,38,2,OKrn如标定不正确（设定值不在指定范围），则返回 $

20、E6,E61600230001,38,9,ERROR:119rn说明：a) 参数,分别为SOC自动下线值和soc自动上线值，设定范围0 100，参数min_soc必须小于max_soc；b) 值默认为900，最小值为300，单位为秒；c) ,分别为3A消息启动上报时间间隔和熄火上报时间间隔，单位为秒，上报时间间隔最小值为10秒； 39查询设备参数值请求指令数据长度(byte)内容AT+SRDPMrn起始符3终端序列号12命令字239消息体长度消息体SOC自动下线阀值SOC自动上线阀值预约有效时间值启动上报时间间隔熄火上报时间间隔结束符2回车换行(0x0d 0x0a)39 查询设备参数值应用举例

21、：发送指令AT+SRDPMrn接收$E6,0123456789AB,39,3,20,30,900,30,120rn8B-恢复出厂设置设置指令数据长度(byte)内容AT+SCZrn起始符3终端序列号12命令字2消息体长度消息体返回结果结束符2回车换行(0x0d 0x0a)8B 恢复出厂设置设置应用举例：发送指令AT+SCZrn接收$E6,0123456789AB,8B,2,OKrn说明：a) 该指令在执行前会发送准备执行恢复出厂设置，然后断开所有连接，清零OBD模块保存的累计数据，加载默认的初始化数据（保存的远程连接信息不会清空），删除FLASH里面存储的数据，进入重启； 34-绑定盒子设置指

22、令数据长度(byte)内容AT+SCSNBIND=rn起始符3终端序列号12命令字234消息体长度消息体返回结果OK:设置成功ERROR:112/113:失败或者参数设置不正确结束符2回车换行(0x0d 0x0a)34 绑定PLUS盒子应用举例：发送指令（绑定盒子）AT+SCSNBIND=656154700125rn接收如绑定正确，则返回$E6,0123456789AB,34,2,OKrn如绑定错误，则返回$E6,0123456789AB,34,9,ERROR:113rn如E6盒子不在线，则返回$E6,0123456789AB,34,9,ERROR:112rn发送指令（解除绑定）AT+SCSN

23、BIND=0rn如解除绑定成功，则返回$E6,0123456789AB,34,2,OKrn如解除绑定错误，则返回$E6,0123456789AB,34,9,ERROR:113rn如E6盒子不在线，则返回$E6,0123456789AB,34,9,ERROR:112rn说明：a) 若执行绑定盒子，参数长度固定为12位长度； b) 若当前终端的SN号与绑定的SN号不一致，PLUS盒子的钥匙将无法控制车辆的开锁落锁功能。8A-重启终端设置指令数据长度(byte)内容AT+SCWSrn起始符3终端序列号12命令字28A消息体长度MAX Length：1024消息体返回结果结束符2回车换行(0x0d 0

24、x0a)8A - 重启终端应用举例：发送指令AT+SCWSrn接收$E6,0123456789AB,8A,2,OKrnBE-清除缓存记录设置指令数据长度(byte)内容AT+SCHISrn起始符3终端序列号12命令字2BE消息体长度MAX Length：1024消息体返回结果结束符2回车换行(0x0d 0x0a)BE - 清除缓存记录应用举例：发送指令AT+SCHISrn接收$E6,0123456789AB,BE,2,OKrn 说明：a) 执行此指令，缓存数据将全部清空，其他参数设置不影响。RFID版本接口 CF-绑定管理员ID卡说明：绑定的ID卡可通过RFID刷卡器感应开锁落锁。设置指令数据长度(byte)内容AT+SCBDADRFID=rn起始符3终端序列号12命令字