山西省交通监控软件接口协议联网Word格式.docx
《山西省交通监控软件接口协议联网Word格式.docx》由会员分享，可在线阅读，更多相关《山西省交通监控软件接口协议联网Word格式.docx（32页珍藏版）》请在冰豆网上搜索。
7.9.下发灭火设备命令19
7.10.下发防火门命令19
8.事件信息20
9.网络状态21
10.情报板playlist协议21
10.1.播放列表结构说明：
22
10.2.情报板入屏出屏协议23
10.3.示例23
11.诱导屏协议24
11.1.配置24
11.2.状态25
1.
概述
山西省高速公路监控系统，分为省中心、片区中心、路段中心，隧道管理站四级，级与级之间要进行联网，数据要进行同步。
本文档描述通信的具体方式及实现方法。
联网同步使用东方通中间件进行数据传输，传输内容为xml的文本信息。
通信时各级只和直接上级、直接下级通信，跨级的命令要逐级转发。
通信的数据包括：
高速基础信息及附属机构（如特大桥、隧道、服务区、收费站等）信息、机电设备的基本信息、机电设备实时的状态及采集到的数据、上级下发指令、事件的同步等。
其中基础信息及附属机构等数据通过集成中间件进行同步；
机电设备的基本信息采用上层请求、下层响应的方式由下层传给上层；
机电设备的状态等实时信息由下层主动上报到上级；
指令信息由上级发送下级执行；
事件信息由事件产生位置向其他相关单位推送。
2.中间件的配置
中间件软件包括：
集成中间件、集成中间件接口适配器、消息中间件。
各级监控管理机构的监控基础数据（片区、路段、隧道、特大桥、隧道、服务区、收费站等）同步采集使用集成中间件（以下简称TI），实现各级监控系统的资源整合、数据共享等功能，构建灵活可扩展的分布式企业应用。
在省监控中心配置安装TI，在各片区监控中心、隧道管理站（所）配置安装TI适配器，通过TI适配器的配置，实现从隧道管理站（所）、片区监控中心、省监控中心数据的逐级同步采集，形成省监控数据中心。
实时数据使用东方通的消息中间件（以下简称TLQ）进行数据传输。
要在各层上安装TLQ8.1。
各层上配置一个本地队列用于接收其他层的消息，配置多个发送队列用于向其他层发送消息。
中间件的消息默认大小为1000字节，过小，建议修改为102400。
两个服务进行同步时，要各自有一个接收队列，一个发送队列，并将自己的IP、端口、接收队列名告知对方。
中间件中发送消息时可以对每条数据设置优先级，默认优先级为4，取值范围为0到9，数字越大越优先。
程序要根据发送的数据的重要性指定优先级。
3.通信协议综述
通信使用XML文档进行通信，每条TLQ消息中存放一个XML文档。
文档使用GBK编码，根节点为MsgPackage。
文档内容分为4个节点：
identity、head、subPackage、returnState。
根节点中有属性version代表协议版本，目前为1.0。
identity节点中存放同步双方的标识
head节点包含本次数据的类型等信息
subPackage节点中存放主要的数据
returnState节点只在响应类消息中存在，存放处理的结果
例：
<
?
xmlversion=”1.0”encoding=”GBK”?
>
MsgPackageversion=”1.0”>
<
identity>
/identity>
head>
/head>
subPackage>
/subPackage>
returnState>
/returnState>
/MsgPackage>
3.1.identity
包含两个节点：
sourceid和targetid，是通信双方的编号。
省中心的编号为：
1400，片区中心的编号使用片区编号，路段中心的编号使用路段编号，隧道管理站的编号使用隧道编号。
具体的编号见附表。
sourceid：
消息发送方的标识
targetid：
消息的目标标识
sourceid>
xxx<
/sourceid>
targetid>
yyy<
/targetid>
3.2.head
包含三个节点：
businessno、prgversion、createtime、type
businessno：
业务编号，一次请求、响应应该使用相同的业务编号，业务编号不能重复。
由请求产生，响应消息直接使用收到的请求中的编号，请求方可以根据编号判断其对应的请求。
prgversion：
发送方的程序版本号
createtime：
本条消息创建的时间，格式为YYYY-MM-DDThh-mm-ss，例如2013-05-24T15:
13:
54表示2013年5月24日，15点13分54秒
type：
本次消息的类型，见下面的消息类型列表。
businessno>
12345678<
/businessno>
createtime>
2013-05-24T15:
54<
/createtime>
type>
MSG_DEVLIST<
/type>
消息类型列表：
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_COVI
CO/VI检测器
MSG_DEV_WS
风速风向检测器
MSG_DEV_LO
洞外光强检测
MSG_DEV_LI
洞内光强检测
MSG_DEV_EVENT
事件检测器
MSG_DEV_FIRE
火灾报警器
MSG_DEV_PUMP
消防水泵
MSG_DEV_FFE
灭火设备（自动喷淋等）
MSG_DEV_CAM
摄像机
MSG_DEV_VS
能见度
MSG_DEV_ET
紧急电话
MSG_DEV_BRO
有线广播
MSG_DEV_ATD
横洞防火门
数据上报
MSG_DATA_CMS
MSG_DATA_VD
MSG_DATA_WEATHER
MSG_DATA_LS
MSG_DATA_TS
MSG_DATA_SCLS
MSG_DATA_IMS
MSG_DATA_LIGHT
MSG_DATA_FAN
MSG_DATA_COVI
MSG_DATA_WS
MSG_DATA_LO
MSG_DATA_LI
MSG_DATA_EVENT
MSG_DATA_FIRE
MSG_DATA_PUMP
MSG_DATA_FFE
MSG_DATA_VS
MSG_DATA_ET
MSG_DATA_BRO
MSG_DATA_ATD
命令下发
MSG_CMD_CMS
下发情报板命令
MSG_CMD_LS
MSG_CMD_TS
MSG_CMD_SCLS
MSG_CMD_IMS
MSG_CMD_LIGHT
MSG_CMD_FAN
MSG_CMD_PUMP
MSG_CMD_FFE
MSG_CMD_ATD
事件信息
MSG_EVENT
事件
网络状态
MSG_NET_STATUS
查询网络状态
3.3.subPackage
消息的主要内容。
根据不同的type，这里内容会不同，将在下面根据具体消息分类描述。
3.4.returnState
返回结果，只有当消息是响应时才有。
两个节点：
returnCode、returnMessage
returnCode：
返回值，6位10进制数，000000表示成功，其他表示失败
returnMessage：
返回的内容描述，成功的命令不需要填
例（成功）：
returnCode>
000000<
/returnCode>
returnMessage>
成功<
/returnMessage>
例（失败）:
100000<
消息格式非法<
4.设备列表
对应的消息类型为MSG_DEVLIST。
上层向下层发起，请求指定类型的设备列表，请求中可以指定一个时间，下层只返回这个时间之后发生变化的设备列表。
subPackage中存放协议的主要内容：
节点type，可取REQUEST或RESPONSE，分别表示上层发出的请求和下层的回应。
4.1.请求
节点condition：
表示请求设备的条件
condition中有节点changetime、type
changetime：
下层将只返回这个时间之后发生变化的设备，如果不指定，返回所有的设备。
设备的变化分为基本信息的变化和实时数据的变化，本协议中不做区分。
下层将只返回指定类型的设备列表，如果不指定，返回所有类型的设备。
REQUEST<
condition>
<
changetime>
/changetime>
CMS<
/condition>
设备类型列表：
CMS
VD
WEATHER
LS
TS
SCLS
IMS
LIGHT
FAN
COVI
LO
LI
EVENT
FIRE
PUMP
FFE
灭火设备
CAM
VS
ET
BRO
ATD
4.2.响应
下层返回的响应中，有节点devices，其中有多个device，每个device表示一个设备。
device中有id、changetime，分别表示设备编号和设备的最后变化时间。
RESPONSE<
devices>
device>
id>
140xxx001<
/id>
/device>
140xxx002<
/type
55<
140xxx003<
/devices>
5.请求设备属性
通信由上级发起，上层指定设备编号，下层返回指定设备的所有属性。
head中的type为消息类型列表中的“设备信息”大类中的某个具体消息类型（MSG_DEV_开头）。
subPackage中存放协议的其他部分：
节点type，可取REQUEST或RESPONSE，分别表示上层发出的请求和下层的回应。
5.1.请求
表示请求设备的条件，有子节点id，表示设备编号
5.2.响应
节点device，包含一个设备的全部属性
设备通用属性：
属性
描述
id
设备的编号
description
设备的描述，应该使用中文
设备的类型
status
设备状态，0表示正常，1表示异常，2表示完全不可用
statusMessage
设备状态的描述，最好用中文，正常设备不填
mfrs
设备的生产厂家
model
设备的型号
longitude
设备的位置，经度
latitude
设备的位置，纬度
position
设备的位置，桩号，整形，单位米
direction
设备的方向，1:
上行，2:
下行
channel
车道，1表示最内侧车道，向右依次增大
road
设备所属的路段编号
tunnel
设备所属的隧道编号，如果不是隧道设备不填
……
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/s
windDirection
风向，0为正北，顺时针方向，单位度，取值0~360，例如正东为90
temperature
温度，单位：
摄氏度
humidity
相对湿度，单位：
百分比，取值：
0~100
visibility
能见度，单位米
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，分别表示红灯、黄灯、绿灯、转向、关闭
5.3.6.可变限速标志（SCLS）
speed
当前的限速值，单位：
km/h
5.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）
vi
5.3.10.风速风向检测器（WS）
ws
风速，单位：
m/s
wd
0表示顺风（顺车行方向），1表示逆风
5.3.11.洞外光强检测（LO）
lo
洞外光强值，单位：
cd/m2
5.3.12.洞内光强检测（LI）
li
lux
5.3.13.事件检测器（EVENT）
eventType
0:
表示没有事件，其他表示事件类型
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）
ffeValue
灭火设备状态，0表示停止，1表示工作
5.3.18.能见度（VS）
vs
5.3.19.紧急电话（ET）
et
正常、1：
摘机、2：
故障
5.3.20.有线广播（BRO）
bro
5.3.21.横洞防火门（ATD）
atd
关、1：
开、2：
6.设备数据上报
当设备采集到的数据发生变化，或者周期性采集设备达到一个采集周期后，要将设备采集到的数据逐级上报。
通信由下级发起，每条消息中包含一个设备的状态和数据，上级返回响应表示是否成功接收。
head中的type为消息类型列表中的“数据上报”大类中的某个具体消息类型（MSG_DATA_开头）。
请求的subPackage中存放具体的信息；
响应没有subPackage，在returnState中存放是否成功接收数据。
6.1.请求
subPackage中存放：
id、status、statusMessage和设备采集到的数据。
id：
设备编号。
status：
设备状态，同5.2中的status，0表示正常，1表示有异常，2表示不可用
statusMessage：
设备状态的描述，如果没有异常，留空。
剩余的内容就是设备采集到的数据，根据设备类型不同有不同的内容，见5.3。
例（这是一个车检器数据上报的例子）：
status>
0<
/status>
statusMessage>
/statusMessage>
upFlux>
15<
/upFlux>
upSpeed>
90<
/upSpeed>
upOcc>
12<
/upOcc>
downFlux>
19<
/downFlux>
downSpeed>
88<
/downSpeed>
downOcc>
/downOcc>
time>
10:
00<
/time>
6.2.响应
上级发回下级的响应中，只有returnState，如果下级没有收到上级的返回正常的响应，应该考虑重传。
7.命令下发
命令下发由上级发起，下级响应后返回成功或错误及错误原因。
head中的type为消息类型列表中的“命令下发”大类中的某个具体消息类型（MSG_CMD_开头）
7.1.下发情报板命令
上层向下层发送情报板命令，控制情报板显示的内容。
下发的内容在subPackage中，下层执行完命令后发送响应消息，响应中不需要subpackage，通过returnState返回执行结果。
情报板内容下发，分纯文本方式和播放列表方式，纯文本方式将内容放在content中，播放列表方式将内容放在playlist中，playlist的具体格式见下面的协议说明。
当内容和playlist都存在时，以playlist为准。
例（下发）：
content>
注意安全|小心驾驶<
/content>
例（响应）：
7.2.下发车道指示器命令
控制车道指示器的状态，content取值见5
升级会员 