远程控制通讯协议

远程控制通讯协议V1.02深圳市航天无线通信技术有限公司修订记录序号版本号修订内容修订日期1V1.0初版2015-12-22V1.0增加定单指令2015/12/223V1.01对消息ID重新编号，同时增加了蓝牙部分的协议2015/12/254V1.022016/2/17目录TOC\o"1-3"\u1. 范围 52. 术语和定义、缩略语 52.1. 术语和定义 52.2. 缩略语 53. 协议基础 53.1. 通信方式 53.2. 数据类型 53.3. 传输规则 63.4. 消息的组成 64. 消息列表 85.数据交互 95.1登录 95.2注销 95.3心跳 95.4工况数据 95.5汽车故障 115.6终端通用应答 115.7参数查询应答 115.8工况数据查询应答 125.9车辆故障查询应答 145.10参数设置 145.11参数查询 165.12工况数据查询 165.13车辆查询故障 165.14平台通用应答 165.15登录应答 166.控制交互 176.1定单执行结果上报 176.2远程控制 176.3定单预定 176.4定单取消 186.5远程控制应答 186.6定单预定应答 186.7定单取消应答 197.蓝牙交互 197.1定单执行请求 197.2执行结果应答 198.升级 208.1升级请求 208.2升级请求应答 209短信控制命令 219.1工况数据查询 219.2终端参数查询 219.3终端参数设置 219.4远程控制 229.5远程唤醒 229.6远程睡眠 22终端通讯协议及数据格式范围本规范适用于车载终端和平台之间的通信。术语和定义、缩略语术语和定义下列术语和定义适用于本文件。311数据通信链路异常abnormaldatacommunicationlink无线通信链路断开，或暂时挂起(通话过程中)。313注销unregister缩略语下列缩略语适用于本文件。APN——接点名称(accesspointname)GZIP——个GNU自由件的文件压缩程序(GNUzip)SMS——短息服务(shortmessageservice)TCP——传控制协议(transmissioncontrolprotocol)TTS——文到语音(texttospeech)VSS——车速度传感器(vehiclespeedsensor)协议基础通信方式通信协议采用TCP或UDP平作为服务器端，终端作为客户端。当数据通信链路异常时，终端可以采用SMS消息方式进行通信。数据类型协议消息中使用的数据类型见表：表1数据型数据类型描述及要求BYTE无符号单字节整型（字节，8位）WORD无符号双字节整型（字，16位）DWORD无符号四字节整型（双字，32位）BYTE[n]n字节BCD[n]8421码，n字节STRINGGBK编码，若无数据，置空INT16有符号双字节整型（16位）INT32有符号四字节整型（32位）TIMEBYTE[7]：B0B1:年,如2016(0x07e0)年，则为B0:0xe0,B1:0x07,B2：月，B3：日,B4：时，B5：分，B6：秒如无特别说明，本协议中的时间均是格林威治时间传输规则协议采用小端模式(little-endian)的网字节序来传递字和双字。约定如下：——字节(BYTE的传输约定：按照字节流的方式传输；——字(WORD)的传输约定：先传递低8位，再传递高8位；——双字(DWORD)的传输约定：先传递低8，然后传递高位，传递高16位，最后传递高24位。消息的组成3.4.1 消息结构每条消息由标识位、消息头、消息体和校验码组成，消息结构图如图1所示：标识位消息头消息体检验码标识位图1 消息结构图3.4.2 标识位采用07e示若校验码消息头以及消息体中出现07则要进行转义处理转义规则定义如下：0x7e<———>0x7d后紧跟一个0x02；0x7d<———>0x7d后紧跟一个0x01。转义处理过程如下：发送消息时：消息体加密（如果需要）——>消息封装——>计算并填充校验码——>转义；接收消息时：转义还原——>验证校验码——>消息体解密（如果需要）——>解析消息。示例：发送一包内容为0x300x7e0x080x7d0x55的数据包，则经过封装如下：0x7e0x307d0x020x080x7d0x010x550x7e。3.4.3 消息头消息头内容详见表2：表2消息头内容起始字节字段数据类型描述及要求0消息IDWORD2消息体属性WORD消息体属性格式结构图见图24终端手机/标志号BCD[10]可以根据安装后终端自身的手机号转换。手机号不足20位，则在前补充数字0。也可以是终端的序列号转换。14消息流水号WORD按发送顺序从0开始循环累加16附加字段DWORD消息体属性格式结构图如图2所示：1514131211109876543210保留保留加密方式消息体长度图2 消息体属性格式结构加密方式：Bit12-bit10：=000b：表示不加密，=001b：IDEA加密，其他：待定3.4.4 校验码校验码指从消息头开始，同后一字节异或，直到校验码前一个字节，占用一个字节。附加字段：一般情况下，附加字段固定为0，但蓝牙定单执行请求（0xD001）中，附加字段为定单ID，消息列表表3：指令列表指令类型发起方响应方方向协议类型指令含义方向协议类型指令含义数据交互上行0x0001登录下行0x8102登录响应上行0x0002注销下行0x8101平台通用应答上行0x0003心跳下行0x8101平台通用应答上行0x0004工况数据下行0x8101平台通用应答上行0x0005车辆故障下行0x8101平台通用应答下行0x8001参数设置上行0x0101终端通用应答下行0x8002参数查询上行0x0102参数查询应答下行0x8003工况数据查询上行0x0103工况数据查询应答下行0x8004车辆故障查询上行0x0104车辆故障查询应答控制交互上行0x1001定单执行结果下行0x8101平台通用应答下行0x9001远程控制上行0x1101远程控制应答下行0x9002定单预定上行0x1102定单预定应答下行0x9003定单取消上行0x1103定单取消应答蓝牙交互下行0xD001定单执行请求上行0x5101执行结果应答升级交互上行0x7001升级请求下行0xF101请求应答说明：指令类型分为：数据类、控制类、蓝牙类、及升级类，共4类；数据的方向定义为：上行是指终端（车机）发出，接收端为平台或蓝牙；无论是哪端发送数据，接收端都要作应答，如果没有可应答的数据，则用通用应答，终端的通用应答的消息ID为0x0101，平台的通用应答的消息ID为0x8101,蓝牙与终端交互没有通用应答；蓝牙与终端交互的数据格式和平台与终端交互的数据格式是一样的，加密方式也是一样的，仅仅是消息ID不一样而已，蓝牙与终端通讯无需登陆、注销、心跳包；5、以下消息的说明仅列出了消息体字段的说明，消息中的其他字段都是一样的，不再说明。5.数据交互5.1登录消息I：0x01。终端登录消息体为空。当终端与平台断开连接，终端准备发送数据之前，则需要发送登录包与平台建立连接。5.2注销消息I：0x02。终端注销消息体为空。终端通过注销包与平台断开连接。5.3心跳消息ID：0x0003。终端心跳消息体为空。当终端与平台持续2分钟没有数据交互，则终端应主动发送心跳数据包，以便维持与平台的连接，同时平台应采用通用应答。5.4工况数据消息ID：0x0004。数据格式见表4。在行程中（点火状态下）或熄火定时上传期间，终端会主动上传工况数据，上传间隔由平台设置，默认为1分钟。表4消息体数据格式起始字节字段数据类型描述及要求0行程IDWORD用于标识行程的一个ID号，通常该ID是从1循环累加的，即下一行程ID是上一行程ID加1，但不是绝对的，也有可能行程之间的ID不是连续的，在熄火下上传的工况数据中的行程ID固定为0.2时间戳TIME当前终端时间9总里程DWORD单位：米13小计里程DWORD单位：米，熄火下上传的小计里程为017总油耗DWORD单位：0.1L,21小计油耗DWORD单位：0.1L，熄火下上传的小计油耗为025剩余油量BYTE单位：%，26剩余电量BYTE单位：%，27电池电压WORD单位：0.1V29车速BYTE单位：KM/H30转速WORD单位：RPM/M32冷却液温度INT8单位：摄氏度33瞬时油耗WORD单位：0.1L/H35发动机负荷BYTE单位：%36环境温度INT8单位：摄氏度37门窗状态DWORD[2]DWORD[0]:Bit0-Bit1：左前门状态00b：OFF，01b：ON，11b：未知Bit2-Bit3：右前门状态00b：OFF，01b：ON，11b：未知Bit4-Bit5：左后门状态00b：OFF，01b：ON，11b：未知Bit6-Bit7：右后门状态00b：OFF，01b：ON，11b：未知Bit8-Bit9：门锁状态00b：上锁，01b：开锁，11b：未知Bit10-Bit11：车辆防盗状态00b：解除设防，01b：设防状态，10b：报警状态，11b:未知Bit12-Bit13：后备箱状态00b：OFF，01b：ON，11b：未知Bit14-Bit15：引擎盖状态00b：OFF，01b：ON，11b：未知Bit16-Bit17：手刹状态00b：放下，01b：拉起，11b：未知Bit18-Bit19：脚刹状态00b：松开，01b：踩下，11b：未知Bit20-Bit21：左转向灯00b：OFF，01b：ON，11b：未知Bit22-Bit23：右转向灯00b：OFF，01b：ON，11b：未知Bit24-Bit25：小灯00b：OFF，01b：ON，11b：未知Bit26-Bit27：大灯00b：OFF，01b：ON，11b：未知Bit28-Bit29：雨刮状态00b：OFF，01b：ON，11b：未知Bit30-Bit31：点火状态00b：OFF，01b：ON，11b：未知DWORD[1]:Bit0-Bit1：发动机状态00b：熄火，01b：点火，11b：未知Bit2-Bit3：空调状态00b：关，01b：开，11b：未知45GPS数据BYTE[17]纬度：DWORD，0.000001度，当前位置的纬度值经度：DWORD，0.000001度，当前位置的经度值高度：WORD，0.1米，当前位置海拔速度：WORD，0.1km/h，当前GPS速度方向：WORD，0.1度，当前行驶方向定位标志：BYTEBit01—东经，0—西经。Bit11—北纬，0—南纬。Bit2-300未定位012D定位113D定位Bit4-7定位星数PDOP：WORD，0.01，位置精度强弱度62BYTE[16]保留，作用待定。5.5汽车故障消息ID：0x0005。数据格式见表5,在行驶中如果有故障会终端主动上报。表5消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前终端时间7故障数量NBYTE故障的个数8故障码表BYTE[4*N]每个故障占4字节5.6终端通用应答消息I：0x11。终端通用应答消息体数格式见表6。表6消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的平台消息的流水号2应答IDWORD对应的平台消息的ID4结果BYTE0：成功/确认；1：失败；2：消息有误；3：不支持5.7参数查询应答消息ID：0x0102。数据格式见表7。当平台发送了参数查询命令（0x8002）时，终端用参数查询应答（0x0102）响应。表7消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的平台参数查询消息的流水号2应答参数个数BYTE3参数项列表参数项格式和定义见表115.8工况数据查询应答消息ID：0x0103。当平台发送了工况数据查询命令（0x8003）时，终端用参数查询应答（0x0103）响应,应答的消息体字段与工况数据上传（0x0004）除了应答的流水号外，其他相同。表8消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的平台消息的流水号2行程IDWORD用于标识行程的一个ID号，通常该ID是从1循环累加的，即下一行程ID是上一行程ID加1，但不是绝对的，也有可能行程之间的ID不是连续的，在熄火下上传的工况数据中的行程ID固定为0.4时间戳TIME当前终端时间11总里程DWORD单位：米15小计里程DWORD单位：米，熄火下上传的小计里程为019总油耗DWORD单位：0.1L,23小计油耗DWORD单位：0.1L，熄火下上传的小计油耗为027剩余油量BYTE单位：%，28剩余电量BYTE单位：%，29电池电压WORD单位：0.1V31车速BYTE单位：KM/H32转速WORD单位：RPM/M34冷却液温度INT8单位：摄氏度35瞬时油耗WORD单位：0.1L/H37发动机负荷BYTE单位：%38环境温度INT8单位：摄氏度39门窗状态DWORD[2]DWORD[0]:Bit0-Bit1：左前门状态00b：OFF，01b：ON，11b：未知Bit2-Bit3：右前门状态00b：OFF，01b：ON，11b：未知Bit4-Bit5：左后门状态00b：OFF，01b：ON，11b：未知Bit6-Bit7：右后门状态00b：OFF，01b：ON，11b：未知Bit8-Bit9：门锁状态00b：上锁，01b：开锁，11b：未知Bit10-Bit11：车辆防盗状态00b：解除设防，01b：设防状态，10b：报警状态，11b:未知Bit12-Bit13：后备箱状态00b：OFF，01b：ON，11b：未知Bit14-Bit15：引擎盖状态00b：OFF，01b：ON，11b：未知Bit16-Bit17：手刹状态00b：放下，01b：拉起，11b：未知Bit18-Bit19：脚刹状态00b：松开，01b：踩下，11b：未知Bit20-Bit21：左转向灯00b：OFF，01b：ON，11b：未知Bit22-Bit23：右转向灯00b：OFF，01b：ON，11b：未知Bit24-Bit25：小灯00b：OFF，01b：ON，11b：未知Bit26-Bit27：大灯00b：OFF，01b：ON，11b：未知Bit28-Bit29：雨刮状态00b：OFF，01b：ON，11b：未知Bit30-Bit31：点火状态00b：OFF，01b：ON，11b：未知DWORD[1]:Bit0-Bit1：发动机状态00b：熄火，01b：点火，11b：未知Bit2-Bit3：空调状态00b：关，01b：开，11b：未知47GPS数据BYTE[17]纬度：DWORD，0.000001度，当前位置的纬度值经度：DWORD，0.000001度，当前位置的经度值高度：WORD，0.1米，当前位置海拔速度：WORD，0.1km/h，当前GPS速度方向：WORD，0.1度，当前行驶方向定位标志：BYTEBit01—东经，0—西经。Bit11—北纬，0—南纬。Bit2-300未定位012D定位113D定位Bit4-7定位星数PDOP：WORD，0.01，位置精度强弱度64BYTE[16]保留，作用待定。5.9车辆故障查询应答消息ID：0x0104。当平台发送了车辆故障查询命令（0x8004）时，终端用车辆故障查询应答（0x0104）响应,应答的消息体字段与车辆故障上传（0x0005）除了应答的流水号外，其他相同。表9消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的平台消息的流水号2时间戳TIME当前终端时间9故障数量NBYTE故障的个数10故障码表BYTE[4*N]每个故障占4字节5.10参数设置消息ID0x8001。数据格式见表10。终端用通用应答回应。表10消息体数据格式起始字节字段数据类型描述及要求0参数总数BYTE1参数项列表参数项格式见表11表终端数项数据格式字段数据类型描述及要求参数IDWORD参数ID定义及说明见表12参数长度BYTE参数值若为多值参数，则消息中使用多个相同ID的参数项，如调度中心电话号码表12终端数设置各参数项定义及说明参数ID数据类型描述及要求0x0010STRING主服务器APN，无线通信拨号访问点。若网络制式为CDMA，则该处为PPP拨号号码0x0011STRING主服务器无线通信拨号用户名0x0012STRING主服务器无线通信拨号密码0x0013STRING主服务器地址,IP或域名0x0018WORD服务器TCP端口0x0029WORD工况数据上传（ID为0x0005）间隔，单位：秒,=0:不上传0xF105BYTE[23*N]接收SMS文本报警号码，SMS控制查询功能号码：超始字节字段数据类型描述及要求0序号BYTE范围0～4。1设置模式BYTEBit0:接收警情，0：NO,1:OKBit1:参数查询及设置0：NO，1：OKBit2:短信及拨号控制及唤醒，0：NO，1：OK2电话号码BYTE[21]ASCII编码。不足21位后补0x00。如果全为0x00,表示清除对应序号的电话号码。0xF106BYTE[6]短信密码,GBK编码。用于SMS控制、查询功能时密码验证。0xF107BYTE短信报警功能开关。0x00=关闭;0x01=开启。0xF108BYTE终端SMS语言类型。0x00=English;0x01=简体中文;0xF109BCD[10]终端序列号，BCD8421编码。不足20位数字前面补0。仅用于查询。不做设置。0xF10ASTRING产品型号，仅用于查询。不做设置。0xF10BSTRING软件版本，仅用于查询。不做设置。0xF10CTIME系统时间0xF10DWORD[2]睡眠上传参数WORD[0]：睡眠上传间隔，单位：分钟，缺省：60分钟WORD[1]：睡眠上传持续时间，单位：分钟，缺省：5分钟5.11参数查询消息I：0x002。数据格式见表13。终端用参数查询应答（0x0102）。表13消息体数据格式起始字节字段数据类型描述及要求0参数总数BYTE参数总数为n1参数ID列表WORD[n]参数ID定义见表12。5.12工况数据查询消息ID0x8003。消息体为空。当平台发送查询工况数据命令（0x8003）时，终端用消息ID为0x0103的消息回复。5.13车辆查询故障消息ID0x8004。消息体为空。当平台发送查询故障数据命令（0x8004）时，终端用消息ID为0x0104的消息回复。5.14平台通用应答消息I：0x11。数据格式见表14。平台通用应答消息体。表14平台用应答消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的终端消息的流水号2应答IDWORD对应的终端消息的ID4结果BYTE0：成功/确认；1：失败；2：消息有误；3：不支持；4：报警处理确认；5.15登录应答消息ID：0x8102。数据格式见表15。当终端发送了登录请求（0x0001）时，平台判断终端的合法性，如果合法，则用登录响应（0x8102）回复。 表15消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的控制命令的流水号2平台时间TIME终端根据平台下发的这个时间来校正终端的时间。6.控制交互6.1定单执行结果上报消息ID：0x1001。数据格式见表16。当终端接收到手机通过蓝牙或其他近场通讯设备发送的定单请求命令时，判断该次命令的有效性并执行相应的动作，并上报平台执行结果，平台采用通用应答。表16消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前终端时间7定单IDDWORD定单ID11用户IDDWORD用户ID15动作类型BYTE0：开门1：关门=16执行结果BYTE0：成功，1：失败，2：不支持。6.2远程控制消息ID0x9001。数据格式见表17。终端用远程控制应答（0x1101）。表17消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前平台时间7控制命令BYTE=1：开门=2：关门=6.3定单预定消息ID0x9002。数据格式见表18。当平台接收到客户的车辆预定时，平台向终端下发预定命令,同时终端返回预定结果（0x1102）。表18消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前平台时间7定单IDDWORD定单ID11用户IDDWORD用户ID15预定起始时间TIME预定起始时间22预定终止时间TIME预定终止时间29密钥BYTE[16]采用IDEA加密，用于这次定单手机蓝牙与终端的通讯的数据体的加解密6.4定单取消消息ID0x9003。数据格式见表19。当平台获知该定单已执行完毕或其他原因需要取消该定单时，平台向终端下发取消命令,同时终端返回结果（0x1103）。表19消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前平台时间7定单IDDWORD定单ID11用户IDDWORD用户ID6.5远程控制应答消息ID：0x1101。数据格式见表20。当平台发送了远程控制命令（0x9001）时，终端用远程控制应答（0x1101）响应。表20消息体数据格式起始字节字段数据类型描述及要求0应答流水号WORD对应的平台控制命令的流水号2控制命令BYTE平台下发的控制命令3结果BYTE0：控制成功，1：失败，2：不支持。如果在行使中不便响应命令时回复失败。6.6定单预定应答消息ID：0x1102。数据格式见表21。当平台发送了定单预定命令（0x9002）时，终端用定单预定应答（0x1102）响应。表21消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前终端时间7定单IDDWORD定单ID11用户IDDWORD用户ID15预定起始时间TIME预定起始时间22预定终止时间TIME预定终止时间29预定结果BYTE0：成功，1：失败6.7定单取消应答消息ID：0x1103。数据格式见表22。当平台发送了定单取消命令（0x9003）时，终端用定单取消应答（0x1103）响应。表22消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前终端时间7定单IDDWORD定单ID11用户IDDWORD用户ID15取消结果BYTE0：成功，1：失败7.蓝牙交互7.1定单执行请求消息I：0x01。数据格式见表23。当客户通过手机的蓝牙向终端发送定单执行请求命令（0xD001）时，终端把执行结果返回给手机端（0x5101）,同时把结果返回给平台（0x1001）,表23消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前手机端时间7定单IDDWORD定单ID11用户IDDWORD用户ID15动作类型BYTE0：开门1：关门=7.2执行结果应答消息ID：0x5101。数据格式见表24。当客户通过手机发送了定单执行请求（0xD001）时，终端判断其合法性，如果合法，则执行相应的动作，并把结果返回给手机。表24消息体数据格式起始字节字段数据类型描述及要求0时间戳TIME当前终端时间7定单IDDWORD定单ID11用户IDDWORD用户ID15动作类型BYTE0：开门1：关门=16执行结果BYTE0：成功，1：失败，2：不支持。8.升级终端的升级采用FTP服务器下载固件的方式来实现，终端与平台建立连接后随时可以上传升级请求命令（请求ID为0x7001），由平台来决定是否需要升级，同时下发请求应答到终端（应答ID为0xF101）,终端收到平台的允许升级的回应后，可以决定在空闲或其他时间升级。8.1升级请