洛阳营运车辆GPS数据交换规范V1.3.doc

洛阳市营运车辆GPS数据交换规范洛阳市营运车辆GPS数据交换规范（LY GDEP）文件状态： 草稿 正式发布 正在修改文件标识：当前版本：1.3编制单位：洛阳市鹰眼科技有限公司完成日期：2011-021 适用范围本规范适用于任何接入到洛阳市运管局GPS监控平台的第三方系统。本规范规定了第三方接入程序与总中心通信控制中心的通信协议的技术细节。2 传输协议说明1) 传输协议采用TCP/IP协议。2) 总中心通信控制中心（简称SERVER）为服务端，第三方系统接入程序（简称CLIENT）为客户端。3) 在接受和发送命令之前，客户端必须要绑定连接到服务端。4) 各个字段之间没有分隔符，未使用的字段，依据类型必须设置为0x00或者为空。5) 协议双方应该按照收到的请求顺序(序列号)，给对方返回响应。6) 链路维护命令由CLIENT主动发送，时间间隔3060秒，超过3次无回复包，视为虚拟连接断开。3消息列表3.1 CLIENT到SERVER的消息命令命令ID描述BIND0x01CLIENT要求绑定到SERVERLINKTEST0x02CLIENT发送链路到SERVERLOCATIOIN0X04GPS数据EXTEND_DATA0x05扩展数据，如图片、文本信息DELIVER_CMD_RESP0xAA设置命令的回应DELIVER_DATA_RESP0xAC通知信息的回应3.2 SERVER到CLIENT的消息命令命令ID描述BIND_RESP0xA1绑定的回应LINKTEST_RESP0xA2链路测试的回应DELIVER_CMD0x0A终端设置命令DELIVER_GPSNUM0x0BGPS数据的接收数量DELIVER_DATA0x0C通知信息（含询岗功能）EXTEND_DATA_RESP0xA5扩展数据的回应5消息定义5.1协议结构定义协议以头标识、消息头和消息体组成，定义如下：Message HeadFlag协议头标识，2个字节 $ (0x24 0x24)Message Header消息头Message Body消息体字段类型定义如下：BYTE单字节BYTES定长字符串，位数不足时、右补二进制0x00，汉字采用GB2312编码STRING不定长字符串，以0x00结束WORD无符号整型，2字节，网络字节序DWORD无符号整型，4字节，网络字节序5.2消息头定义消息头共6个字节，无分隔符，结构如下：字段类型长度描述CommandLengthWORD2报文开始符之后的内容长度，2个字节CommandIDBYTE1消息类型，1个字节SeqNOWORD2消息序号，2个字节，从1开始，循环使用CommandStatusBYTE1状态字，1个字节，默认为05.3消息体语法消息体每个字节均要进行xor加密，加密因子为CommandID。BIND命令此命令在CLIENT和SERVER之间产生虚连接，该命令主动由CLIENT发起。字段类型长度描述system_idSTRING最大20接口ID passwordSTRING最大20密码system_typeBYTE1CLIENT类型 默认填写：1ReserveSTRING最大200保留，默认填写0x00BIND_ RESP语法字段类型长度描述ReserveSTRING最大200保留，默认填写0x00LINKTEST命令此命令用于CLIENT和SERVER之间的链路维护。CLIENT发送一条LINKTEST命令，SERVER响应一条LINKTEST_RESP命令，表示CLIENT和SERVER之间的连接存在，连续3次SERVER无响应，可视为连接断开。无消息体。LINKTEST_RESP语法无消息体LOCATION命令此命令用于CLIENT实时上传GPS数据到SERVER。该命令无需回复。字段类型长度描述LICENSE_PLATESTRING最大20车牌号（车牌号为GB2312编码）PLATECOLORBYTE1车牌颜色（车牌颜色编码规则详细参见5.4）DATATYPEBYTE1数据类型（0：实时数据；130:历史补传数据）GPSTIMEBYTES7GPS时间 格式：YYYYMMDDHHMMSS (北京时间)，BCD编码longitudeDWORD4经度，单位为0.000001度latitudeDWORD4纬度，单位为0.000001度GPSFlagBYTE1定位标志，详细参见5.4SpeedBYTE1速度，整数，单位：公里/小时Speed_recordBYTE1行驶记录仪速度，整数，单位：公里/小时DirectionWORD2方向，整数 ，单位：度（0360度）HeightWORD2海拔高度，整数，单位：米MileageDWORD4里程，整数，单位：米Comm_typeBYTE1通信方式，详细参见5.4OilvalueWORD2当前油箱剩余油量百分值，单位为0.1，如805表示剩余油量80.5%MDTStatusBYTE1终端状态，详细参见5.4MDTAlarmBYTE1终端报警类型，详细参见5.4BYTESN当DATATYPE1时该字段继续按顺序填写GPS记录内容（紫色字体部分），每条GPS记录固定占用31字节。EXTEND_DATA命令此命令用于CLIENT提交扩展数据包到SERVER。字段类型长度描述LICENSE_PLATESTRING最大20车牌号（车牌号为GB2312编码）PLATECOLORBYTE1车牌颜色（车牌颜色编码规则详细参见5.4）DATATYPEBYTE1数据类型（0：文本信息gb2312，1：图片数据）GPSTimeBYTES7GPS时间 格式：YYYYMMDDHHMMSS (北京时间)，BCD编码Data_LengthWORD2扩展内容长度Data_contentBYTESLength扩展内容,最大长度不超过64K字节EXTEND_DATA_RESP语法无消息体。DELIVER_GPSNUM命令SERVER接收GPS数据累计到一定数量(默认为1024条)时，主动下发接收数量通知命令。该命令无需回复。字段类型长度描述BegintimeBYTES7开始时间（格式：YYYYMMDDHHMMSS）(北京时间) ,BCD编码EndtimeBYTES7截止时间（格式：YYYYMMDDHHMMSS）(北京时间) ,BCD编码VehicleNumWORD2该时间段内在线车辆的数量GpsNumWORD2该时间段内有效GPS数据的数量DELIVER_CMD命令此命令用于SERVER提交终端命令到CLIENT，由CLIENT将命令转发给终端，命令发送通信方式默认为数据通道（GPRS或者CDMA），由CLIENT自行确定。字段类型长度描述LICENSE_PLATESTRING最大20车牌号（车牌号为GB2312编码）PLATECOLORBYTE1车牌颜色（车牌颜色编码规则详细参见5.4）Cmd_IDWORD2命令ID，循环增加，用于识别命令发送内容和对象Cmd_propertyBYTE1命令类型，详细参见5.4Data_lengthWORD2命令内容长度Cmd_DataSTRINGlength命令内容，最大长度不超过8000字节DELIVER_CMD_RESP语法字段类型长度描述Cmd_IDWORD2命令ID，用于识别命令发送内容和对象ResultBYTE1命令下发结果（0：成功；1：失败，原因参见remark）RemarkSTRING最大100发送失败的原因描述DELIVER_DATA命令此命令用于SERVER下发数据或者通知消息到CLIENT，包括询岗消息。字段类型长度描述Msg_TypeBYTE1信息类型，详见5.4Msg_SeqNOSTRING15消息序列号Msg_lengthWORD2信息内容长度Msg_ContentSTRINGlength信息内容，最大长度不超过8000字节,GB2312DELIVER_DATA_RESP语法字段类型长度描述Msg_SeqNOSTRING15消息序列号，不能为空Result_lengthWORD2回复内容长度Result_ContentSTRINGlength回复内容，最大长度不超过8000字节,GB23125.4 消息体参数说明n Data_property 命令类型0：文本通知消息（GB2312编码）1：更改上传时间间隔(Cmd_Content：时间间隔数值)（单位：秒)2：更改超速报警上限（Cmd_Content：速度上限，持续时间）（速度：公里/小时，时间：秒）3：启动通话（喊话）功能（Cmd_Content：电话号码）4：启动监听功能（Cmd_Content：电话号码）255: 终端设置命令（Cmd_Content：原始协议内容，直接转发至终端） n Comm_type 通讯方式0：短信1：TCP（2.5G/3G）2：UDP(2.5G/3G)3：卫星信号（北斗） 4: 终端来电n Msg_type 通知消息类型0：通知信息（回复内容必须为空）1：询岗信息（回复内容不可为空，要求CLIENT根据消息内容作出相应回复）2：数据质量报告（保留）n MDTStatus 终端状态字BIT0=1，ACC开BIT1=1，车门开BIT2=1，重车（已载客、装货） n MDTAlarm 终端报警字 BIT0=1，劫警（求助）BIT1=1，超速报警BIT2=1，疲劳驾驶BIT3=1，偏离路线报警BIT4=1，停车时间超长 BIT5=1，停车时间不足 BIT6=1，GPS天线故障BIT7=1，掉电报警 n GPSFlag 定位标志0：西经、南纬、定位1：西经、南纬、非定位2：西经、北纬、定位3：西经、北纬、非定位4：东经、南纬、定位5：东经、南纬、非定位6：东经、北纬、定位7：东经、北纬、非定位n 车牌颜色编码编码依据JT/T4152006标准5.4.12车牌颜色编制，采用一位数字编码。1：蓝色2：黄色3：黑色4：白色9：其他5.5 状态（Command_status）定义错误代码错误名称描述0x00E_SUCCESS成功0x01E_OTHERERR其他错误0x02E_INVLDLICENSEPLATE车牌号错误0x03E_INVLDSIMNOSIM卡号错误0x04E_INVLDTERMINALID终端编号错误0x0AE_MSGLENERR消息长度错误0x0BE_CMDL