山西省交通监控软件接口协议联网.docx
- 文档编号:9581110
- 上传时间:2023-02-05
- 格式:DOCX
- 页数:32
- 大小:148.52KB
山西省交通监控软件接口协议联网.docx
《山西省交通监控软件接口协议联网.docx》由会员分享,可在线阅读,更多相关《山西省交通监控软件接口协议联网.docx(32页珍藏版)》请在冰豆网上搜索。
山西省交通监控软件接口协议联网
交通监控软件接口协议
(实施初稿)
目录
1.概述4
2.中间件的配置4
2.1.集成中间件与集成中间件接口适配器的配置:
4
2.2.消息中间件的配置:
4
3.通信协议综述5
3.1.identity5
3.2.head6
3.3.subPackage7
3.4.returnState8
4.设备列表8
4.1.请求8
4.2.响应9
5.请求设备属性10
5.1.请求10
5.2.响应11
5.3.设备的特有属性11
5.3.1.情报板(CMS)11
5.3.2.车检(VD)12
5.3.3.气象站(WEATHER)12
5.3.4.车道指示器(LS)12
5.3.5.交通信号灯(TS)13
5.3.6.可变限速标志(SCLS)13
5.3.7.照明灯(LIGHT)13
5.3.8.风机(FAN)13
5.3.9.CO/VI检测器(COVI)13
5.3.10.风速风向检测器(WS)14
5.3.11.洞外光强检测(LO)14
5.3.12.洞内光强检测(LI)14
5.3.13.事件检测器(EVENT)14
5.3.14.火灾报警器(FIRE)14
5.3.15.诱导屏(IMS)14
5.3.16.消防水泵(PUMP)15
5.3.17.灭火设备(FFE)15
5.3.18.能见度(VS)15
5.3.19.紧急电话(ET)15
5.3.20.有线广播(BRO)15
5.3.21.横洞防火门(ATD)16
6.设备数据上报16
6.1.请求16
6.2.响应17
7.命令下发17
7.1.下发情报板命令17
7.2.下发车道指示器命令17
7.3.下发交通信号灯命令18
7.4.下发可变限速标志命令18
7.5.下发照明命令18
7.6.下发通风命令18
7.7.下发诱导屏命令19
7.8.下发消防水泵命令19
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.中间件的配置
中间件软件包括:
集成中间件、集成中间件接口适配器、消息中间件。
2.1.集成中间件与集成中间件接口适配器的配置:
各级监控管理机构的监控基础数据(片区、路段、隧道、特大桥、隧道、服务区、收费站等)同步采集使用集成中间件(以下简称TI),实现各级监控系统的资源整合、数据共享等功能,构建灵活可扩展的分布式企业应用。
在省监控中心配置安装TI,在各片区监控中心、隧道管理站(所)配置安装TI适配器,通过TI适配器的配置,实现从隧道管理站(所)、片区监控中心、省监控中心数据的逐级同步采集,形成省监控数据中心。
2.2.消息中间件的配置:
实时数据使用东方通的消息中间件(以下简称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”?
>
3.1.identity
包含两个节点:
sourceid和targetid,是通信双方的编号。
省中心的编号为:
1400,片区中心的编号使用片区编号,路段中心的编号使用路段编号,隧道管理站的编号使用隧道编号。
具体的编号见附表。
sourceid:
消息发送方的标识
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:
本次消息的类型,见下面的消息类型列表。
例:
13:
54
消息类型列表:
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:
返回的内容描述,成功的命令不需要填
例(成功):
例(失败):
4.设备列表
对应的消息类型为MSG_DEVLIST。
上层向下层发起,请求指定类型的设备列表,请求中可以指定一个时间,下层只返回这个时间之后发生变化的设备列表。
subPackage中存放协议的主要内容:
节点type,可取REQUEST或RESPONSE,分别表示上层发出的请求和下层的回应。
4.1.请求
节点condition:
表示请求设备的条件
condition中有节点changetime、type
changetime:
下层将只返回这个时间之后发生变化的设备,如果不指定,返回所有的设备。
设备的变化分为基本信息的变化和实时数据的变化,本协议中不做区分。
type:
下层将只返回指定类型的设备列表,如果不指定,返回所有类型的设备。
例:
13:
54
设备类型列表:
type
说明
CMS
情报板
VD
车检器
WEATHER
气象站
LS
车道指示器
TS
交通信号灯
SCLS
可变限速标志
IMS
诱导屏
LIGHT
照明灯
FAN
风机
COVI
CO/VI检测器
LO
洞外光强检测
LI
洞内光强检测
EVENT
事件检测器
FIRE
火灾报警器
PUMP
消防水泵
FFE
灭火设备
CAM
摄像机
VS
能见度
ET
紧急电话
BRO
有线广播
ATD
横洞防火门
4.2.响应
下层返回的响应中,有节点devices,其中有多个device,每个device表示一个设备。
device中有id、changetime,分别表示设备编号和设备的最后变化时间。
例:
13:
54
13:
55
13:
55
5.请求设备属性
通信由上级发起,上层指定设备编号,下层返回指定设备的所有属性。
head中的type为消息类型列表中的“设备信息”大类中的某个具体消息类型(MSG_DEV_开头)。
subPackage中存放协议的其他部分:
节点type,可取REQUEST或RESPONSE,分别表示上层发出的请求和下层的回应。
5.1.请求
节点condition:
表示请求设备的条件,有子节点id,表示设备编号
例:
5.2.响应
节点device,包含一个设备的全部属性
设备通用属性:
属性
描述
id
设备的编号
description
设备的描述,应该使用中文
type
设备的类型
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)
属性
描述
content
当前状态,可取front/back/left/right/stop/close,分别表示正向行驶、逆向行驶、左转、右转、停止、关闭
5.3.5.交通信号灯(TS)
属性
描述
content
当前状态,可取red/yellow/green/turn/close,分别表示红灯、黄灯、绿灯、转向、关闭
5.3.6.可变限速标志(SCLS)
属性
描述
speed
当前的限速值,单位:
km/h
5.3.7.照明灯(LIGHT)
属性
描述
content
0表示关灯,1表示开灯
brightness
亮度,从1到100表示从最暗到最亮,0表示自动亮度或亮度不可变
5.3.8.风机(FAN)
属性
描述
content
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
0:
正常,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
0:
正常、1:
摘机、2:
故障
5.3.20.有线广播(BRO)
属性
描述
bro
0:
正常、1:
摘机、2:
故障
5.3.21.横洞防火门(ATD)
属性
描述
atd
0:
关、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。
例(这是一个车检器数据上报的例子):
10:
00
6.2.响应
上级发回下级的响应中,只有returnState,如果下级没有收到上级的返回正常的响应,应该考虑重传。
例:
7.命令下发
命令下发由上级发起,下级响应后返回成功或错误及错误原因。
head中的type为消息类型列表中的“命令下发”大类中的某个具体消息类型(MSG_CMD_开头)
7.1.下发情报板命令
上层向下层发送情报板命令,控制情报板显示的内容。
下发的内容在subPackage中,下层执行完命令后发送响应消息,响应中不需要subpackage,通过returnState返回执行结果。
情报板内容下发,分纯文本方式和播放列表方式,纯文本方式将内容放在content中,播放列表方式将内容放在playlist中,playlist的具体格式见下面的协议说明。
当内容和playlist都存在时,以playlist为准。
例(下发):
例(响应):
7.2.下发车道指示器命令
控制车道指示器的状态,content取值见5
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 山西省 交通 监控 软件 接口 协议 联网