电子站牌协议

1、电子站牌协议 一、 公交平台接入通信协议1、 协议概要本协议规定了公交平台与电子站牌系统之间的通信要求，及基本数据、参数格式。通信数据均为16进制格式字节流。2、 操作流程基本通信流程为：建立TCP连接验证用户ID和密码发送和接收数据。3、 通信约定1） 通信保持长连接；2） 客户端负责维护长连接；3） 断开后，客户端重新连接的时间间隔为30秒。4、 数据类型定义类型说明HEX_STRING十六进制表示的数据字符串。定长时，位数不足时，左补齐(0x30)，特别规定除外。STRING字符串，GBK编码，定长时，位数不足时，右补齐（0x00），特别规定除外。BCDBCD码BYTES二进制流INT8

2、有符号整型，1字节UINT8无符号整型，1字节INT16有符号整型，2字节UINT16无符号整型，2字节INT32有符号整型，4字节UINT32无符号整型，4字节说明：多字节整数类型，高位在前，低位在后。5、 数据包格式数据包包括：包头、包体和包尾。包头和包尾采用定长方式，包体采用变长方式。如下：包头包体包尾6、 数据包头定义序号字段名类型长度说明1开始符UINT810xFE2消息IDUINT162详细定义，如下表消息ID定义3消息时间BCD6发包时间，格式：yymmddhhmmss4用户IDUINT162用户ID由公交电子站牌系统统一分配，一个用户ID对于一个公交平台。第一个字节为公交集团代

3、码，巴士集团：0，东部公交：1，西部公交：2，第二个字节为用户代码，从0x01开始。5包体长UINT162指包体内容的字节长度，从包体开始直到包体结束的长度，包体最大60K字节数据。6.1、消息ID定义：说明：GPS平台通信接口要求实现GPS平台的全部消息ID功能，调度平台通信接口要求同时实现GPS平台和调度平台的全部消息ID功能。 GPS平台的消息ID：序号消息ID描述10x0001登录0x8101登录应答20x0003链路检测0x8103链路检测应答30x0005上传GPS数据40x8001下发指令0x0101下发指令应答 调度平台的消息ID序号消息ID描述10x0061车辆离站0x816

4、1车辆离站应答20x0062车辆到站0x8162车辆到站应答30x0063车辆调整线路0x8163车辆调整线路应答40x0064车辆停运0x8164车辆停运应答50x0065车辆停运取消0x8165车辆停运取消应答60x0066车辆新增0x8166车辆新增应答70x0067车辆删除0x8167车辆删除应答80x0068车辆移动0x8168车辆移动应答7、 数据包尾定义序号字段名类型长度说明1校验位UINT81从数据包包头开始，同后一字节异或，知道校验前一字节。2结束符UINT810x0D8、 数据包体定义8.1 登录( 消息ID：0x0001)序号字段名类型长度说明1密码BYTES16密码时间

5、长度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 时间：10-11-15 10:24:56数据包：FE 00 01 10 11 15 10 24 56 02 01 00

6、13 E1 0A DC 39 49 BA 59 AB BE 56 E0 57 F2 0F 88 3E 01 02 01 86 0D登录应答（消息ID值：0x8101）序号字段名类型长度说明1应答码UINT810x00 成功，0x01用户不存在，0x02密码错误，0x03版本太低例：成功，时间：10-11-15 13:57:24FE 81 01 10 11 15 13 57 24 02 01 00 01 00 08 0D链路检测(消息ID值：0x0003)序号字段名类型长度说明1应答码UINT810x00 成功，非0x00是错误码GPS数据传输(消息ID值：-x0005)序号字段名类型长度说明1

7、车牌号String10如“粤B12345”2终端编号Bytes8公交平台内部编号3时间BCD6定位时间，格式yymmddhhmmss4速度UINT162速度(公里/小时)乘1005定位UINT81定位：0精确，1非精确6经度INT324经度乘1000000，+/-：东/西经7纬度INT324经度乘1000000，+/-：南/北纬8高度UINT162高度，单位：米9方向UINT162正北为0，顺时针递增，范围：0-360例：用户ID：0x0201 车牌号：粤12345 终端编号：20002001 定位时间：2010-11-16 16:32:30 定位：精确 经度：112.345678 纬度：22

8、.345 速度：60.35 公里/小时 方向：280度 高度：500米FE 00 05 10 11 15 10 24 56 02 01 00 27 D4 C1 42 31 32 33 34 35 00 00 32 30 30 30 32 30 30 31 10 11 16 16 32 30 17 93 00 06 B2 42 4E 01 64 37 68 01 F4 01 18 27 0DGPS数据传输应答无下发指令( 消息ID值：0x8001)序号字段名类型长度说明1指令IDUINT162查询车辆资料：0x01012指令参数长度UINT1623指令参数BYTESN对应指令参数结构下发指令应答

9、(消息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，+/

10、-：东/西经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)序号字段名类型长

11、度说明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车辆停运应答(消息

12、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)序号字段名类

13、型长度说明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下一站牌序号UINT81

14、7上一站牌距离UINT324单位：米8下一站牌距离UINT324单位：米9速度UINT162速度（公里/小时）乘10010定位UINT81定位：精确 0， 非精确 111经度INT324经度乘1000000，+/-：东/西经12纬度INT324经度乘1000000，+/-：南/北纬13高度UINT162高度，单位：米说明：到站时，下一站牌序号为停靠站，下一站距离为0米车辆移动应答(0x8168)序号字段名类型长度说明1应答码UINT810x00 成功，非0x00是错误码二、内部管理服务器通信协议1、协议概述本协议规定了管理服务器与主控程序之间的通信要求，及基础数据、参数格式。通信数据均为对象字

15、节流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字节说明：多字节整数类型，高位在前，低位在

16、后。4、数据包格式数据包包括：包头、包体和包尾。包头和包尾采用定长方式，包体采用变长方式。如下：包头包体包尾5、数据包头定义序号字段名类型长度说明1消息IDInteger4详细定义，如下表消息ID定义2消息时间BCD6发包时间，格式：yymmddhhmmss3包体长Integer4指包体内容的字节长度，从包体开始直到包体结束的长度，包体最大64K字节数据。消息ID取值定义如下：序号消息ID值描述10x7201下发指令20x4301下发指令应答30x7203链路检测40x4303链路检测应答50x7205单发新增节目信息60x4305单发新增节目信息应答70x7206单发删除节目信息80x430

17、6单发删除节目信息应答90x7207组发新增节目信息100x4307组发新增节目信息应答110x7208组发删除节目信息120x4308组发删除节目信息应答6、数据包尾定义无7、数据包体定义7.1、下发指令(消息ID值：0x7201)序号字段名类型长度说明1站牌设备IDInteger42指令信息Bytes注：参见电子站牌终端通信协议8.9下发控制指令下发指令应答(消息ID值：0x4301)序号字段名类型长度说明1应答码Byte17.2、链路检测（消息ID值：0x7203） 无链路检测应答（消息ID值：0x4303）无7.3、单发新增节目信息(消息ID值：0x7205)序号字段名类型长度说明1站

18、牌设备IDInteger42信息IDInteger4节目信息ID唯一3信息级别Byte1参见：信息级别表4内容长度Integer4本信息内容长度，以字节为单位5信息内容StringN内容长度：N6开始时间Date信息有效开始时间7结束时间Date信息有效结束时间8下发时间Date信息级别表序号级别值描述10x01特级：表示应急突发事件，电子站牌全屏显示20x02高级：优先、高频率显示，如交通事故信息等30x03普通：如天气预报、新闻等信息显示规则：1、按级别由高到低2、同级别按顺序轮播3、特级独占全屏，高级播放频率是普通的2倍单发新增节目信息应答(消息ID值：0x4305)序号字段名类型长度说

19、明1应答码Byte10x00成功，非0x00是错误码7.4、单发删除节目信息(消息ID值：0x7206)序号字段名类型长度说明1站牌设备IDInteger42信息IDInteger43下发时间Date单发删除节目信息应答(消息ID值：0x4306)序号字段名类型长度说明1应答码Byte10x00成功，非0x00是错误码7.5、组发新增节目信息(消息ID值：0x7207)序号字段名类型长度说明1站牌设备组IDInteger42信息IDInteger4节目信息ID唯一3信息级别Byte1参见：信息级别表4内容长度Integer4本信息内容长度，以字节为单位5信息内容StringN内容长度：N6开始

20、时间Date信息有效开始时间7结束时间Date信息有效结束时间8下发时间Date组发新增节目信息应答(消息ID值：0x4307)序号字段名类型长度说明1应答码Byte10x00成功，非0x00是错误码8.6、组发删除节目信息(消息ID值：0x7208)序号字段名类型长度说明1站牌设备组IDInteger42信息IDInteger43下发时间Date组发删除节目信息应答(消息ID值：0x4308)序号字段名类型长度说明1应答码Byte10x00成功，非0x00是错误码三、电子站牌终端通信协议1、协议概述本协议规定了电子站牌与系统的通信要求，及基本数据，参数格式。采用无线通信时，如果需要，可以采用

21、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

22、有符号整型，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.最后一位为电

23、子站牌设备个数。消息ID取值定义如下：序号消息ID值方向描述10x1001上传电子站牌登录0x9101下发电子站牌登录应答20x1003上传链路检测0x9103下发链路检测应答30x1005上传取服务器时间0x9105下发取服务器时间应答40x1007上传取软件下载URL0x9107下发取软件下载URL应答50x9001下发下发公交信息60x9003下发下发新增节目信息0x1103上传下发新增节目信息应答70x9005下发下发删除节目信息0x1105上传下发删除节目信息应答80x9001下发下发线路车辆运行信息910分区指令110x3001下发划分显示区域，最多支持划分8个0x3101上传分区

24、应答显示指令120x3003下发发送文字信息到指令分区0x3103上传收到文字信息应答130x3005下发收到文本文件到指定分区0x3105上传收到文本文件应答140x3007下发收到图像文件到指定分区0x3107上传收到图像文件应答控制指令150x5001下发清除所有分区的显示信息0x5101上传应答160x5002下发清除指定分区的显示信息0x5102上传应答170x5003下发删除指定信息0x5103上传应答180x5004下发定时开关屏0x5104上传应答190x5005下发强制开关屏0x5105上传应答200x5006下发控制卡复位0x5106上传应答210x5007下发设置屏体ID

25、0x5107上传应答220x5008下发校时0x5108上传应答230x5009下发亮度控制0x5109上传应答240x5010下发发送备选节目单0x5110上传应答250x5011下发播放选择节目单0x5111上传应答260x5012下发同/异步屏设置0x5112上传应答270x5013下发格式化0x5113上传应答280x5014下发检测控制卡在线0x5114上传应答290x5015下发发送密码(MD5)0x5115上传应答7、数据包尾定义序号字段名类型长度说明1校验位UINT81从包头开始，同后字节异或，直到校验前一个字节2结束符UINT810x0D8.、数据包体定义8.1 登录登录数据

26、包体(消息ID值：0x1001)序号字段名类型长度说明1密码Bytes16密码实际长度6位，经MD5单向加密所得2版本号UINT162电子站牌终端软件编号，第一字节为主版号，第二字节为次版号例：电子站牌ID：600121 密码：123456 版本号：0x0101 时间：10-11-15 10:24:56FE 10 01 10 11 15 10 24 56 00 09 28 39 00 12 E1 0A DC 39 49 BA 59 AB BE 56 E0 57 F2 0F 88 3E 01 01 88 0D登录应答(消息ID值：0x9101)序号字段名类型长度说明1应答码UINT810x00成

27、功，0x01终端软件有新版本，0x02有离线节目信息例：成功，时间：10-11-15 13:57:24FE 81 01 10 11 15 24 00 09 28 39 00 01 00 13 0D8.2、链路检测(消息ID值：0x1003)说明：检测电子站牌与系统通信服务器之间的连接是否正常序号字段名类型长度说明链路检测应答(消息ID值：0x9103)序号字段名类型长度说明1应答码UINT81 8.3、取服务器时间（消息ID值：0x1005）序号字段名类型长度说明取服务器时间应答（消息ID值：0x9105）序号字段名类型长度说明1应答码UINT81 0x00成功，非0x00是错误码2平台服务器

28、时间BCD6平台当前时间，电子站牌与其同步时间8.4、取软件下载URL（消息ID值：0x1007）序号字段名类型长度说明取软件下载URL应答（消息ID值：0x9107）序号字段名类型长度说明1应答码UINT81 0x00成功，非0x00是错误码2URLBCD30最新电子站牌软件ftp服务器的URL8.5、下发公交信息（消息ID值：0x9001）序号字段名类型长度说明1线路名简称String10M2252首车牌号String10如：“粤B12345”，无车为空。3首车距离UINT324离本站第一近车辆的距离，单位：米。无车为-1。4次车牌号String10如：“粤B12345”，无车为空。5次车

29、牌号UINT324离本站第二近车辆的距离，单位：米。无车为-1。6目的地String10下发公交信息应答无8.6、下发新增节目信息（消息ID值：0x9003）序号字段名类型长度说明1信息IDUINT324节目信息唯一ID2信息级别UINT1见信息级别表3内容长度UINT162本信息内容长度，以字节为单位4信息内容StringN5开始时间BCD6信息有效开始时间6结束时间BCD6信息有效结束时间7下发时间BCD6格式：yymmddhhmmss信息级别表序号级别值描述10x01特级：表示应急突发事件，电子站牌全屏显示20x02高级：优先、高频率显示，如交通事故信息等30x03普通：如天气预报、新闻

30、等信息显示规则：1、按级别由高到低2、同级别按顺序轮播3、特级独占全屏，高级播放频率是普通的2倍下发新增节目信息应答（消息ID值：0x1103）序号字段名类型长度说明1应答码UINT81 0x00成功，非0x00是错误码8.7、下发删除节目信息（消息ID值：0x9005）序号字段名类型长度说明1信息IDUINT324节目信息ID唯一2下发时间BCD6格式：yymmddhhmmss下发删除节目信息应答（消息ID值：0x1105）序号字段名类型长度说明1应答码UINT81 0x00成功，非0x00是错误码8.8、下发线路车辆运行信息（消息ID值：0x9011,此消息为电子线路牌预留）序号字段名类型

31、长度说明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、控制相关数据包体定义9.1、显示单元分区划分上位机下发分区指令：0x3001序号字段名类型长度说明1窗口数NUINT81划分的窗口数量，有效值182X1UINT82窗口1的X坐标，有效值0655353Y1UINT82窗口1的Y坐标，有效值0655354W1UINT82窗口1的宽度，有效值0655355H1UINT82窗口1的高度，有效值065535。4n-2XnUI