山西省交通监控软件接口协议联网Word格式.docx

1、7.9. 下发灭火设备命令 197.10. 下发防火门命令 198. 事件信息 209. 网络状态 2110. 情报板playlist协议 2110.1. 播放列表结构说明： 2210.2. 情报板入屏出屏协议 2310.3. 示例 2311. 诱导屏协议 2411.1. 配置 2411.2. 状态 251. 概述山西省高速公路监控系统，分为省中心、片区中心、路段中心，隧道管理站四级，级与级之间要进行联网，数据要进行同步。本文档描述通信的具体方式及实现方法。联网同步使用东方通中间件进行数据传输，传输内容为xml的文本信息。通信时各级只和直接上级、直接下级通信，跨级的命令要逐级转发。通信的数据包

2、括：高速基础信息及附属机构（如特大桥、隧道、服务区、收费站等）信息、机电设备的基本信息、机电设备实时的状态及采集到的数据、上级下发指令、事件的同步等。其中基础信息及附属机构等数据通过集成中间件进行同步；机电设备的基本信息采用上层请求、下层响应的方式由下层传给上层；机电设备的状态等实时信息由下层主动上报到上级；指令信息由上级发送下级执行；事件信息由事件产生位置向其他相关单位推送。2. 中间件的配置 中间件软件包括：集成中间件、集成中间件接口适配器、消息中间件。 各级监控管理机构的监控基础数据（片区、路段、隧道、特大桥、隧道、服务区、收费站等）同步采集使用集成中间件（以下简称TI），实现各级监控系

3、统的资源整合、数据共享等功能，构建灵活可扩展的分布式企业应用。 在省监控中心配置安装TI，在各片区监控中心、隧道管理站（所）配置安装TI适配器，通过TI适配器的配置，实现从隧道管理站（所）、片区监控中心、省监控中心数据的逐级同步采集，形成省监控数据中心。 实时数据使用东方通的消息中间件（以下简称TLQ）进行数据传输。要在各层上安装TLQ8.1。 各层上配置一个本地队列用于接收其他层的消息，配置多个发送队列用于向其他层发送消息。 中间件的消息默认大小为1000字节，过小，建议修改为102400。 两个服务进行同步时，要各自有一个接收队列，一个发送队列，并将自己的IP、端口、接收队列名告知对方。

4、中间件中发送消息时可以对每条数据设置优先级，默认优先级为4，取值范围为0到9，数字越大越优先。程序要根据发送的数据的重要性指定优先级。3. 通信协议综述 通信使用XML文档进行通信，每条TLQ消息中存放一个XML文档。文档使用GBK编码，根节点为MsgPackage。文档内容分为4个节点：identity、head、subPackage、returnState。根节点中有属性version代表协议版本，目前为1.0。identity节点中存放同步双方的标识head节点包含本次数据的类型等信息subPackage节点中存放主要的数据returnState节点只在响应类消息中存在，存放处理的结果例

5、：MsgPackage version=”1.0” /identityhead/headsubPackage/subPackagereturnState/returnState/MsgPackage3.1. identity包含两个节点：sourceid和targetid，是通信双方的编号。省中心的编号为：1400，片区中心的编号使用片区编号，路段中心的编号使用路段编号，隧道管理站的编号使用隧道编号。具体的编号见附表。sourceid：消息发送方的标识targetid：消息的目标标识sourceidxxxtargetidyyy3.2. head包含三个节点：businessno、prgvers

6、ion、createtime、typebusinessno：业务编号，一次请求、响应应该使用相同的业务编号，业务编号不能重复。由请求产生，响应消息直接使用收到的请求中的编号，请求方可以根据编号判断其对应的请求。prgversion：发送方的程序版本号createtime：本条消息创建的时间，格式为YYYY-MM-DDThh-mm-ss，例如2013-05-24T15:13:54 表示2013年5月24日，15点13分54秒type：本次消息的类型，见下面的消息类型列表。businessno12345678createtime2013-05-24T15:54type MSG_DEVLIST 消息

7、类型列表：type说明设备信息MSG_DEVLIST设备列表MSG_DEV_CMS情报板MSG_DEV_VD车检器MSG_DEV_WEATHER气象站MSG_DEV_LS车道指示器MSG_DEV_TS交通信号灯MSG_DEV_SCLS可变限速标志MSG_DEV_IMS诱导屏MSG_DEV_LIGHT照明灯MSG_DEV_FAN风机MSG_DEV_COVICO/VI检测器MSG_DEV_WS风速风向检测器MSG_DEV_LO洞外光强检测MSG_DEV_LI洞内光强检测MSG_DEV_EVENT事件检测器MSG_DEV_FIRE火灾报警器MSG_DEV_PUMP消防水泵MSG_DEV_FFE灭火设

8、备（自动喷淋等）MSG_DEV_CAM摄像机MSG_DEV_VS能见度MSG_DEV_ET紧急电话MSG_DEV_BRO有线广播MSG_DEV_ATD横洞防火门数据上报MSG_DATA_CMSMSG_DATA_VDMSG_DATA_WEATHERMSG_DATA_LSMSG_DATA_TSMSG_DATA_SCLSMSG_DATA_IMSMSG_DATA_LIGHTMSG_DATA_FANMSG_DATA_COVIMSG_DATA_WSMSG_DATA_LOMSG_DATA_LIMSG_DATA_EVENTMSG_DATA_FIREMSG_DATA_PUMPMSG_DATA_FFEMSG_DA

9、TA_VSMSG_DATA_ETMSG_DATA_BROMSG_DATA_ATD命令下发MSG_CMD_CMS下发情报板命令MSG_CMD_LSMSG_CMD_TSMSG_CMD_SCLSMSG_CMD_IMSMSG_CMD_LIGHTMSG_CMD_FANMSG_CMD_PUMPMSG_CMD_FFEMSG_CMD_ATD事件信息MSG_EVENT事件网络状态MSG_NET_STATUS查询网络状态3.3. subPackage 消息的主要内容。根据不同的type，这里内容会不同，将在下面根据具体消息分类描述。3.4. returnState返回结果，只有当消息是响应时才有。两个节点：ret

10、urnCode、returnMessagereturnCode：返回值，6位10进制数，000000表示成功，其他表示失败returnMessage：返回的内容描述，成功的命令不需要填例（成功）：returnCode000000returnMessage成功例（失败）:100000消息格式非法4. 设备列表 对应的消息类型为MSG_DEVLIST。上层向下层发起，请求指定类型的设备列表，请求中可以指定一个时间，下层只返回这个时间之后发生变化的设备列表。 subPackage中存放协议的主要内容： 节点type，可取REQUEST或RESPONSE，分别表示上层发出的请求和下层的回应。4.1.

11、请求节点condition：表示请求设备的条件condition中有节点changetime、typechangetime：下层将只返回这个时间之后发生变化的设备，如果不指定，返回所有的设备。设备的变化分为基本信息的变化和实时数据的变化，本协议中不做区分。下层将只返回指定类型的设备列表，如果不指定，返回所有类型的设备。REQUEST /changetimeCMS设备类型列表：CMSVDWEATHERLSTSSCLSIMSLIGHTFANCOVILOLIEVENTFIREPUMPFFE灭火设备CAMVSETBROATD4.2. 响应下层返回的响应中，有节点devices，其中有多个device，

12、每个device表示一个设备。device中有id、changetime，分别表示设备编号和设备的最后变化时间。RESPONSEdeviceid140xxx001/device140xxx002/type55140xxx0035. 请求设备属性 通信由上级发起，上层指定设备编号，下层返回指定设备的所有属性。head中的type为消息类型列表中的“设备信息”大类中的某个具体消息类型（MSG_DEV_开头）。 subPackage中存放协议的其他部分：节点type，可取REQUEST或RESPONSE，分别表示上层发出的请求和下层的回应。5.1. 请求表示请求设备的条件，有子节点id，表示设备编号

13、5.2. 响应节点device，包含一个设备的全部属性设备通用属性：属性描述id设备的编号description设备的描述，应该使用中文设备的类型status设备状态，0表示正常，1表示异常，2表示完全不可用statusMessage设备状态的描述，最好用中文，正常设备不填mfrs设备的生产厂家model设备的型号longitude设备的位置，经度latitude设备的位置，纬度position设备的位置，桩号，整形，单位米direction设备的方向，1:上行，2:下行channel车道，1表示最内侧车道，向右依次增大 road设备所属的路段编号tunnel设备所属的隧道编号，如果不是隧道设

14、备不填 5.3. 设备的特有属性下面分别描述各中设备特殊的属性5.3.1. 情报板（CMS）width情报板宽度，单位像素height情报板高度，单位像素content情报板正在显示的内容，各屏直接使用“|”分隔playlist情报板正在显示的内容，playlist的具体格式见后面的“情报板playlist协议”5.3.2. 车检（VD）time本次数据的采集时间upFLux上行车流量upSpeed上行平均车速upOcc上行占有率downFlux下行车流量downSpeed下行平均车速downOcc下行占有率5.3.3. 气象站（WEATHER）windSpeed风速，单位m/swindDir

15、ection风向，0为正北，顺时针方向，单位度，取值0360，例如正东为90temperature温度，单位：摄氏度humidity相对湿度，单位：百分比，取值：0100visibility能见度，单位米rain降雨量，单位毫米surface路面状况：0：干，1：潮，2：湿，3：潮并有化学品，4：湿并有化学品，5：霜，6：雪，7：冰5.3.4. 车道指示器（LS）当前状态，可取front/back/left/right/stop/close，分别表示正向行驶、逆向行驶、左转、右转、停止、关闭5.3.5. 交通信号灯（TS）当前状态，可取red/yellow/green/turn/close，分

16、别表示红灯、黄灯、绿灯、转向、关闭5.3.6. 可变限速标志（SCLS）speed当前的限速值，单位：km/h5.3.7. 照明灯（LIGHT）0表示关灯，1表示开灯brightness亮度，从1到100表示从最暗到最亮，0表示自动亮度或亮度不可变5.3.8. 风机（FAN）front/back/stop 分别表示风向为行车方向、反向、停止5.3.9. CO/VI检测器（COVI）co一氧化碳浓度，单位10-6（ppm）vi5.3.10. 风速风向检测器（WS）ws风速，单位：m/swd0表示顺风（顺车行方向），1表示逆风5.3.11. 洞外光强检测（LO）lo洞外光强值，单位：cd/m25.

17、3.12. 洞内光强检测（LI）lilux5.3.13. 事件检测器（EVENT）eventType0:表示没有事件，其他表示事件类型eventMessage事件的汉字描述5.3.14. 火灾报警器（FIRE）fireValue正常，1:火灾5.3.15. 诱导屏（IMS）imsConfig诱导屏的配置（见后面诱导屏协议）imsValue诱导屏的值（见后面诱导屏协议）5.3.16. 消防水泵（PUMP）pumpValue水泵状态，0表示停止，1表示工作poolValueHigh高水池液位高度，单位毫米poolValueLow低水池液位高度，单位毫米5.3.17. 灭火设备（FFE）ffeVal

18、ue灭火设备状态，0表示停止，1表示工作5.3.18. 能见度（VS）vs5.3.19. 紧急电话（ET）et正常、1：摘机、2：故障5.3.20. 有线广播（BRO）bro5.3.21. 横洞防火门（ATD）atd关、1：开、2：6. 设备数据上报 当设备采集到的数据发生变化，或者周期性采集设备达到一个采集周期后，要将设备采集到的数据逐级上报。 通信由下级发起，每条消息中包含一个设备的状态和数据，上级返回响应表示是否成功接收。 head中的type为消息类型列表中的“数据上报”大类中的某个具体消息类型（MSG_DATA_开头）。请求的subPackage中存放具体的信息；响应没有subPac

19、kage，在returnState中存放是否成功接收数据。6.1. 请求subPackage中存放：id、status、statusMessage和设备采集到的数据。id：设备编号。status：设备状态，同5.2中的status，0表示正常，1表示有异常，2表示不可用statusMessage：设备状态的描述，如果没有异常，留空。剩余的内容就是设备采集到的数据，根据设备类型不同有不同的内容，见5.3。例（这是一个车检器数据上报的例子）：status0statusMessage/statusMessageupFlux15upSpeed90upOcc12downFlux19downSpeed88

20、downOcc/downOcctime10:006.2. 响应上级发回下级的响应中，只有returnState，如果下级没有收到上级的返回正常的响应，应该考虑重传。7. 命令下发 命令下发由上级发起，下级响应后返回成功或错误及错误原因。 head中的type为消息类型列表中的“命令下发”大类中的某个具体消息类型（MSG_CMD_开头）7.1. 下发情报板命令 上层向下层发送情报板命令，控制情报板显示的内容。下发的内容在subPackage中，下层执行完命令后发送响应消息，响应中不需要subpackage，通过returnState返回执行结果。情报板内容下发，分纯文本方式和播放列表方式，纯文本方式将内容放在content中，播放列表方式将内容放在playlist 中，playlist的具体格式见下面的协议说明。当内容和playlist都存在时，以playlist为准。例（下发）：content注意安全|小心驾驶例（响应）：7.2. 下发车道指示器命令控制车道指示器的状态，content取值见5