电子站牌协议

电子站牌协议一、公交平台接入通信协议1、协议概要本协议规定了公交平台与电子站牌系统之间的通信要求，及基本数据、参数格式。通信数据均为16进制格式字节流。2、操作流程基本通信流程为建立TCP连接验证用户ID和密码发送和接收数据。3、通信约定1）通信保持长连接；2）客户端负责维护长连接；3）断开后，客户端重新连接的时间间隔为30秒。4、数据类型定义类型说明HEX_STRING十六进制表示的数据字符串。定长时，位数不足时，左补齐0X30，特别规定除外。STRING字符串，GBK编码，定长时，位数不足时，右补齐（0X00），特别规定除外。BCDBCD码BYTES二进制流INT8有符号整型，1字节UINT8无符号整型，1字节INT16有符号整型，2字节UINT16无符号整型，2字节INT32有符号整型，4字节UINT32无符号整型，4字节说明多字节整数类型，高位在前，低位在后。5、数据包格式数据包包括包头、包体和包尾。包头和包尾采用定长方式，包体采用变长方式。如下包头包体包尾6、数据包头定义序号字段名类型长度说明1开始符UINT810XFE2消息IDUINT162详细定义，如下表消息ID定义3消息时间BCD6发包时间，格式YYMMDDHHMMSS4用户IDUINT162用户ID由公交电子站牌系统统一分配，一个用户ID对于一个公交平台。第一个字节为公交集团代码，巴士集团0，东部公交1，西部公交2，第二个字节为用户代码，从0X01开始。5包体长UINT162指包体内容的字节长度，从包体开始直到包体结束的长度，包体最大60K字节数据。61、消息ID定义说明GPS平台通信接口要求实现GPS平台的全部消息ID功能，调度平台通信接口要求同时实现GPS平台和调度平台的全部消息ID功能。611GPS平台的消息ID序号消息ID描述10X0001登录0X8101登录应答20X0003链路检测0X8103链路检测应答30X0005上传GPS数据40X8001下发指令0X0101下发指令应答612调度平台的消息ID序号消息ID描述10X0061车辆离站0X8161车辆离站应答20X0062车辆到站0X8162车辆到站应答30X0063车辆调整线路0X8163车辆调整线路应答40X0064车辆停运0X8164车辆停运应答50X0065车辆停运取消0X8165车辆停运取消应答60X0066车辆新增0X8166车辆新增应答70X0067车辆删除0X8167车辆删除应答80X0068车辆移动0X8168车辆移动应答7、数据包尾定义序号字段名类型长度说明1校验位UINT81从数据包包头开始，同后一字节异或，知道校验前一字节。2结束符UINT810X0D8、数据包体定义81登录消息ID0X0001序号字段名类型长度说明1密码BYTES16密码时间长度6位，经MD5单向加密所得。如123456（0X31,0X32,0X33,0X34,0X35,0X36），经MD5加密后为0XE1,0X0A,0XDC,0X39,0X49,0XBA,0X59,0XAB,0XBE,0X56,0XE0,0X57,0XF2,0X0F,0X88,0X3E2版本号UINT162第一字节为版本，第二字节为次版本3平台类型UINT81GPS平台1，调度平台2例用户0X0201密码123456版本号0X0102平台类型0X01时间101115102456数据包FE000110111510245602010013E10ADC3949BA59ABBE56E057F20F883E010201860D登录应答（消息ID值0X8101）序号字段名类型长度说明1应答码UINT810X00成功，0X01用户不存在，0X02密码错误，0X03版本太低例成功，时间101115135724FE81011011151357240201000100080D链路检测消息ID值0X0003序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码GPS数据传输消息ID值X0005序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES8公交平台内部编号3时间BCD6定位时间，格式YYMMDDHHMMSS4速度UINT162速度公里/小时乘1005定位UINT81定位0精确，1非精确6经度INT324经度乘1000000，/东/西经7纬度INT324经度乘1000000，/南/北纬8高度UINT162高度，单位米9方向UINT162正北为0，顺时针递增，范围0360例用户ID0X0201车牌号粤12345终端编号20002001定位时间20101116163230定位精确经度112345678纬度22345速度6035公里/小时方向280度高度500米FE000510111510245602010027D4C14231323334350000323030303230303110111616323017930006B2424E0164376801F40118270DGPS数据传输应答无下发指令消息ID值0X8001序号字段名类型长度说明1指令IDUINT162查询车辆资料0X01012指令参数长度UINT1623指令参数BYTESN对应指令参数结构下发指令应答消息ID值0X0101序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆离站消息ID值0X0061序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES83上下行标识UINT81上行1，下行24线路名称STRING205时间BCD6定位时间YYMMDDHHMMSS6站牌序号UINT81上行始发站为1，终点站为N下行终点站为1，始发站为N7下一站牌距离UINT324单位米8速度UINT162速度公里/小时乘1009定位UINT81定位精确0，非精确110经度INT324经度乘1000000，/东/西经11纬度INT324经度乘1000000，/南/北纬12高度UINT162高度，单位米车辆离站应答消息ID值0X8161序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆到站消息ID值0X0062序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES83上下行标识UINT81上行1，下行24线路名称STRING205时间BCD6定位时间YYMMDDHHMMSS6站牌序号UINT81上行始发站为1，终点站为N下行终点站为1，始发站为N车辆到站应答消息ID值0X8162序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆调整线路消息ID值0X0063序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES83原来线路名称STRING204新线路名称STRING20车辆调整线路应答0X8163序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆停运消息ID值0X0064序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES83停运原因编码UINT81车辆故障1，加油2，驾驶员不足3，自定义994停运原因STRING20车辆停运应答消息ID值0X8164序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆停运取消消息ID值0X0065序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES8车辆停运取消应答消息ID值0X8165序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆新增消息ID值0X0066序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES83线路名称STRING204新增时间BCD6格式YYMMDDHHMMSS车辆新增应答消息ID值0X8166序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆删除消息ID值0X0067序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES83删除时间BCD6格式YYMMDDHHMMSS车辆删除应答消息ID值0X8167序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码车辆移动消息ID值0X0068序号字段名类型长度说明1车牌号STRING10如“粤B12345”2终端编号BYTES83线路名称STRING204上下行标志UINT815时间BCD6格式YYMMDDHHMMSS6下一站牌序号UINT817上一站牌距离UINT324单位米8下一站牌距离UINT324单位米9速度UINT162速度（公里/小时）乘10010定位UINT81定位精确0，非精确111经度INT324经度乘1000000，/东/西经12纬度INT324经度乘1000000，/南/北纬13高度UINT162高度，单位米说明到站时，下一站牌序号为停靠站，下一站距离为0米车辆移动应答0X8168序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码二、内部管理服务器通信协议1、协议概述本协议规定了管理服务器与主控程序之间的通信要求，及基础数据、参数格式。通信数据均为对象字节流2、通信约定1）通信采用短链接，一次交易一次连接2）主控程序是TCP服务端3）管理服务器是客户端，负责建立连接，发送请求4）接收后应答，客户端断开连接3、数据类型类型说明HEX_STRING十六进制表示的数据字符串。定长时，位数不足时，左补齐0X30，特别规定除外。STRING字符串，GBK编码，定长时，位数不足时，右补齐（0X00），特别规定除外。BCDBCD码BYTES二进制流INT8有符号整型，1字节UINT8无符号整型，1字节INT16有符号整型，2字节UINT16无符号整型，2字节INT32有符号整型，4字节UINT32无符号整型，4字节说明多字节整数类型，高位在前，低位在后。4、数据包格式数据包包括包头、包体和包尾。包头和包尾采用定长方式，包体采用变长方式。如下包头包体包尾5、数据包头定义序号字段名类型长度说明1消息IDINTEGER4详细定义，如下表消息ID定义2消息时间BCD6发包时间，格式YYMMDDHHMMSS3包体长INTEGER4指包体内容的字节长度，从包体开始直到包体结束的长度，包体最大64K字节数据。消息ID取值定义如下序号消息ID值描述10X7201下发指令20X4301下发指令应答30X7203链路检测40X4303链路检测应答50X7205单发新增节目信息60X4305单发新增节目信息应答70X7206单发删除节目信息80X4306单发删除节目信息应答90X7207组发新增节目信息100X4307组发新增节目信息应答110X7208组发删除节目信息120X4308组发删除节目信息应答6、数据包尾定义无7、数据包体定义71、下发指令消息ID值0X7201序号字段名类型长度说明1站牌设备IDINTEGER42指令信息BYTES注参见电子站牌终端通信协议89下发控制指令下发指令应答消息ID值0X4301序号字段名类型长度说明1应答码BYTE172、链路检测（消息ID值0X7203）无链路检测应答（消息ID值0X4303）无73、单发新增节目信息消息ID值0X7205序号字段名类型长度说明1站牌设备IDINTEGER42信息IDINTEGER4节目信息ID唯一3信息级别BYTE1参见信息级别表4内容长度INTEGER4本信息内容长度，以字节为单位5信息内容STRINGN内容长度N6开始时间DATE信息有效开始时间7结束时间DATE信息有效结束时间8下发时间DATE信息级别表序号级别值描述10X01特级表示应急突发事件，电子站牌全屏显示20X02高级优先、高频率显示，如交通事故信息等30X03普通如天气预报、新闻等信息显示规则1、按级别由高到低2、同级别按顺序轮播3、特级独占全屏，高级播放频率是普通的2倍单发新增节目信息应答消息ID值0X4305序号字段名类型长度说明1应答码BYTE10X00成功，非0X00是错误码74、单发删除节目信息消息ID值0X7206序号字段名类型长度说明1站牌设备IDINTEGER42信息IDINTEGER43下发时间DATE单发删除节目信息应答消息ID值0X4306序号字段名类型长度说明1应答码BYTE10X00成功，非0X00是错误码75、组发新增节目信息消息ID值0X7207序号字段名类型长度说明1站牌设备组IDINTEGER42信息IDINTEGER4节目信息ID唯一3信息级别BYTE1参见信息级别表4内容长度INTEGER4本信息内容长度，以字节为单位5信息内容STRINGN内容长度N6开始时间DATE信息有效开始时间7结束时间DATE信息有效结束时间8下发时间DATE组发新增节目信息应答消息ID值0X4307序号字段名类型长度说明1应答码BYTE10X00成功，非0X00是错误码86、组发删除节目信息消息ID值0X7208序号字段名类型长度说明1站牌设备组IDINTEGER42信息IDINTEGER43下发时间DATE组发删除节目信息应答消息ID值0X4308序号字段名类型长度说明1应答码BYTE10X00成功，非0X00是错误码三、电子站牌终端通信协议1、协议概述本协议规定了电子站牌与系统的通信要求，及基本数据，参数格式。采用无线通信时，如果需要，可以采用ASCII码格式传输，将每个16进制数据拆分为2哥ASCII码数据。2、操作流程LED屏默认显示工作方式如下本次屏体采用16字宽，6行字高的结构3、通信约定通信保持长连接电子站牌LED控制板卡负责维护长连接，心跳每60秒发送一个链路检测消息；断开后，电子站牌LED控制板的重接的时间间隔为20秒。4、数据类型类型说明HEX_STRING十六进制表示的数据字符串。定长时，位数不足时，左补齐0X30，特别规定除外。STRING字符串，GBK编码，定长时，位数不足时，右补齐（0X00），特别规定除外。BCDBCD码BYTES二进制流INT8有符号整型，1字节UINT8无符号整型，1字节INT16有符号整型，2字节UINT16无符号整型，2字节INT32有符号整型，4字节UINT32无符号整型，4字节说明多字节整数类型，高位在前，低位在后。5、数据包结构定义数据包结构包括三部分，即包头，包体和包尾。包头和包尾采用定长方式，包体采用变长方式。如下6、数据包头定义序号字段名类型长度说明1开始符UINT810XFE2消息IDUINT162参见下表消息ID定义3消息时间BCD6YYMMDDHHMMSS4电子站牌设备IDUINT324电子站牌设备ID有站牌平台统一分配共7位。前6位区1站点号4站牌1。区的表示方法福田1，罗湖2，南山3，盐田4，宝安5，龙岗6最后一位为电子站牌设备个数。消息ID取值定义如下序号消息ID值方向描述10X1001上传电子站牌登录0X9101下发电子站牌登录应答20X1003上传链路检测0X9103下发链路检测应答30X1005上传取服务器时间0X9105下发取服务器时间应答40X1007上传取软件下载URL0X9107下发取软件下载URL应答50X9001下发下发公交信息60X9003下发下发新增节目信息0X1103上传下发新增节目信息应答70X9005下发下发删除节目信息0X1105上传下发删除节目信息应答80X9001下发下发线路车辆运行信息910分区指令110X3001下发划分显示区域，最多支持划分8个0X3101上传分区应答显示指令120X3003下发发送文字信息到指令分区0X3103上传收到文字信息应答130X3005下发收到文本文件到指定分区0X3105上传收到文本文件应答140X3007下发收到图像文件到指定分区0X3107上传收到图像文件应答控制指令150X5001下发清除所有分区的显示信息0X5101上传应答160X5002下发清除指定分区的显示信息0X5102上传应答170X5003下发删除指定信息0X5103上传应答180X5004下发定时开关屏0X5104上传应答190X5005下发强制开关屏0X5105上传应答200X5006下发控制卡复位0X5106上传应答210X5007下发设置屏体ID0X5107上传应答220X5008下发校时0X5108上传应答230X5009下发亮度控制0X5109上传应答240X5010下发发送备选节目单0X5110上传应答250X5011下发播放选择节目单0X5111上传应答260X5012下发同/异步屏设置0X5112上传应答270X5013下发格式化0X5113上传应答280X5014下发检测控制卡在线0X5114上传应答290X5015下发发送密码MD50X5115上传应答7、数据包尾定义序号字段名类型长度说明1校验位UINT81从包头开始，同后字节异或，直到校验前一个字节2结束符UINT810X0D8、数据包体定义81登录登录数据包体消息ID值0X1001序号字段名类型长度说明1密码BYTES16密码实际长度6位，经MD5单向加密所得2版本号UINT162电子站牌终端软件编号，第一字节为主版号，第二字节为次版号例电子站牌ID600121密码123456版本号0X0101时间101115102456FE1001101115102456000928390012E10ADC3949BA59ABBE56E057F20F883E0101880D登录应答消息ID值0X9101序号字段名类型长度说明1应答码UINT810X00成功，0X01终端软件有新版本，0X02有离线节目信息例成功，时间101115135724FE81011011152400092839000100130D82、链路检测消息ID值0X1003说明检测电子站牌与系统通信服务器之间的连接是否正常序号字段名类型长度说明链路检测应答消息ID值0X9103序号字段名类型长度说明1应答码UINT8183、取服务器时间（消息ID值0X1005）序号字段名类型长度说明取服务器时间应答（消息ID值0X9105）序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码2平台服务器时间BCD6平台当前时间，电子站牌与其同步时间84、取软件下载URL（消息ID值0X1007）序号字段名类型长度说明取软件下载URL应答（消息ID值0X9107）序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码2URLBCD30最新电子站牌软件FTP服务器的URL85、下发公交信息（消息ID值0X9001）序号字段名类型长度说明1线路名简称STRING10M2252首车牌号STRING10如“粤B12345”，无车为空。3首车距离UINT324离本站第一近车辆的距离，单位米。无车为1。4次车牌号STRING10如“粤B12345”，无车为空。5次车牌号UINT324离本站第二近车辆的距离，单位米。无车为1。6目的地STRING10下发公交信息应答无86、下发新增节目信息（消息ID值0X9003）序号字段名类型长度说明1信息IDUINT324节目信息唯一ID2信息级别UINT1见信息级别表3内容长度UINT162本信息内容长度，以字节为单位4信息内容STRINGN5开始时间BCD6信息有效开始时间6结束时间BCD6信息有效结束时间7下发时间BCD6格式YYMMDDHHMMSS信息级别表序号级别值描述10X01特级表示应急突发事件，电子站牌全屏显示20X02高级优先、高频率显示，如交通事故信息等30X03普通如天气预报、新闻等信息显示规则1、按级别由高到低2、同级别按顺序轮播3、特级独占全屏，高级播放频率是普通的2倍下发新增节目信息应答（消息ID值0X1103）序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码87、下发删除节目信息（消息ID值0X9005）序号字段名类型长度说明1信息IDUINT324节目信息ID唯一2下发时间BCD6格式YYMMDDHHMMSS下发删除节目信息应答（消息ID值0X1105）序号字段名类型长度说明1应答码UINT810X00成功，非0X00是错误码88、下发线路车辆运行信息（消息ID值0X9011,此消息为电子线路牌预留）序号字段名类型长度说明1线路IDUINT324参看下面一行5位数，第一位为类型，2下发时间BCD6格式YYMMDDHHMMSS3上下行UINT811上行，2下行4在线车辆数UINT162N个在线车辆5车牌号1STRING10如“粤B12345”6下一站序号UINT811，2，3N，起点1，终点N7车牌号2STRING10如“粤B12345”8下一站序号UINT811，2，3N，起点1，终点N车牌号NSTRING10如“粤B12345”下一站序号UINT811，2，3N，起点1，终点N9、控制相关数据包体定义91、显示单元分区划分上位机下发分区指令0X3001序号字段名类型长度说明1窗口数NUINT81划分的窗口数量，有效值182X1UINT82窗口1的X坐标，有效值0655353Y1UINT82窗口1的Y坐标，有效值0655354W1UINT82窗口1的宽度，有效值0655355H1UINT