最新中国铁塔动环监控系统统一互联B接口技术规范资料Word文件下载.docx
《最新中国铁塔动环监控系统统一互联B接口技术规范资料Word文件下载.docx》由会员分享,可在线阅读,更多相关《最新中国铁塔动环监控系统统一互联B接口技术规范资料Word文件下载.docx(63页珍藏版)》请在冰豆网上搜索。
Request
PK_Type
报文类型
Info
报文内容
响应报文
Response
对象模型
在监控中心下的对象模型参考如下:
图2 监控中心的对象模型
注:
可根据实际情况,在监控中心和FSU间可以没有区域。
基本定义
a)当前告警:
当前未结束的告警信息。
b)实时数据:
最靠近当前时间的有效数据。
c)FSUID:
数字串ID,从资源系统获取的唯一ID。
d)FSU编码:
14位字符串,编码方式如下:
FSU编码借鉴中华人民共和国行政区划代码(GB/T2260-2007)规范编码作为基础。
将FSU做为一种设备管理,设备类型为33。
FSU编码:
由XX省(2位数字)+XX区县(4位数字)+局站类型与设备类型组合(3位数字,设备类型固定为33)+XXFSU(5位数字)。
XX省(2位数字)+XX区县(4位数字)的编码建议借鉴中华人民共和国行政区划代码(GB/T2260-2007)规范的代码,详见中华人民共和国行政区划代码(GB/T2260-2007)规范)。
XXFSU有5位数字,可以考虑自动生成,生成后不再变动;
也可预先编好。
同一个区县的局站编码不得重复。
表2 局站类型编码表
局站类型编码
局站类型
特殊局站(自定义)
1
A级局站
2
B级局站
3
C级局站
4
D级局站
5~9
保留
比如,一个A类局站FSU名称为跑马场FSU,可以编为10001;
一个D类局站FSU名称为牛头山FSU,可以编为40001。
e)设备ID,从资源系统获取的设备唯一ID。
f)设备编码
设备编码:
设备编码借鉴中华人民共和国行政区划代码(GB/T2260-2007)规范编码作为基础。
由XX省(2位数字)+XX区县(4位数字)+局站类型与设备类型组合(3位数字)+XX设备(5位数字)。
XX设备有5位数字,可以考虑自动生成,生成后不再变动;
同一个区县的设备编码不得重复。
g)监控点ID:
设备上的监测点的ID,10位数字。
监控点在FSU内的标识号唯一。
信号ID共10位,按照从低位到高位的顺序,具体定义如下:
【0987654321】
1-3:
同类信号的顺序号,如整流模块、单体电池序号、输入电压路序号、负载熔丝序号、压缩机序号等,参考【信号字典表】
4-5:
设备中具体信号的流水号,从00至99。
(各省自行增加的信号请从70开始开始往上定义)
6:
0-遥信信号(DI),1-遥测信号(AI),2-遥控信号(DO),3-遥调信号(AO)
7-8:
设备类型:
详见设备/系统类型编码表
9:
局站类型:
详见局站类型编码表
10:
预留扩展,暂固定为0
具体可参见《中国铁塔动环监控系统统一信号字典表》中信号量ID的定义。
h)告警事件描述采用XML文件,XML格式如下:
<
TAlarm>
<
SerialNo>
告警序号<
/SerialNo>
DeviceId>
设备ID<
/DeviceId>
DeviceCode>
/DeviceCode>
AlarmTime>
告警时间<
/AlarmTime>
FsuId>
FSUID<
/FsuId>
FsuCode>
/FsuCode>
Id>
监控点ID<
/Id>
AlarmLevel>
告警级别<
/AlarmLevel>
AlarmFlag>
告警标志<
/AlarmFlag>
AlarmDesc>
告警文本<
/AlarmDesc>
/TAlarm>
1)告警序号:
以10位数字表示,如0012345678(十进制),不足10位前面补0,最大不能超过一个无符号长整型所表示的数字,即数字在0~4294967295之间。
同时在FSC内告警序号唯一,告警结束时的告警序号与告警产生时的告警序号相同。
2)设备ID:
参考设备ID编码。
3)时间描述:
YYYY-MM-DD<
SPACE键>
hh:
mm:
ss(采用24小时的时间制式)。
4)FSUID:
11位字符串表示。
5)监控点ID:
参考监控点ID。
6)告警级别:
一级/二级/三级/四级。
7)告警标志描述:
开始/结束。
8)告警文本:
40字节以内的告警内容描述。
例:
0012345678<
DeviceID>
11010110100001<
/DeviceID>
/DeviceCode>
2006-09-0412:
01:
31<
10024<
/FsuCode>
0430101001<
二级<
开始<
欠压告警(46.1V)<
说明:
例中46.1V为告警触发值,其中<
(符>
、<
)符>
为半角符号。
对于遥信量告警,告警文本为“告警”、“熔断”等文字。
9)所有文本描述中不能包含”<
符”、”>
符”字符。
i)数据类型的字节数定义
表3 数据类型字节数定义
字节数
Long
4字节
Short
2字节
Char
1字节
Float
枚举类型
j)FSU向SC注册的信息:
•IPSec/L2TP拨号参数:
FSU向IPSec/L2TP服务器建立IPSec/L2TP隧道所须参数,包括IPSec/L2TP服务器IP、用户名、密码;
•SCIP:
SC前置机或采集机的IP,FSU向其发起注册和工作过程中数据交互的目的IP。
k)SC、FSU根据下图所示,建立连接:
图3 连接建立过程
WebService接口采用http+soap+xml的方式,工作过程如下:
1)建立IPSec/L2TP隧道连接:
FSU客户端先进行4G/3G拨号上网,成功后向IPSec/L2TP服务器进行IPSec/L2TP拨号,建立IPSec/L2TP隧道,获取内网IP。
2)建立IPSec/L2TP隧道连接成功后,FSU向SC传送login,login_ack报文;
报文使用的用户名必须为SC服务端提供给FSU客户端的合法用户名,并且报文必须携带在第一步所获得的内网IP、FSU能力(即FSU所接设备的设备ID列表),由服务端进行认证。
3)如果登录成功,则B接口协议通过这个连接通讯。
4)当FSU与SC之间的连接意外中断后,FSU必须重新进行上述连接和注册过程。
5)当logout,logout_ack报文在此IPSec/L2TP隧道连接上传送,成功登出之后,FSU客户端主动拆除IPSec/L2TP隧道连接。
数据流方式
FSU向SC注册
客户端向服务端传送用户名、口令、内网IP;
服务端向客户端发送注册确认。
图4 用户注册过程
上报告警信息
FSU做客户端,SC是服务端。
FSU根据告警门限判断有告警需上报时,向SC上报告警信息,SC返回确认信息。
图5 用户请求告警数据过程
用户请求监控点数据
客户端向服务端发送所需数据的标识,服务端向客户端发送客户要求的监控点的当前状态信息。
图6 用户请求监控点数据过程
用户请求监控点历史数据
客户端向服务端发送所需数据的标识,服务端向客户端发送客户要求的时间段内的监控点的历史状态信息,按轮询周期(1小时),一个轮询周期只取1个点。
图7 用户请求监控点历史数据过程
用户请求写监控点的设置值
客户端向服务端发送监控点的标识ID和新设置值,服务端设置监控点的新设置值并向客户端返回成功与否。
图8 用户请求写监控点的设置值过程
用户请求监控点门限数据
客户端向服务端发送所需数据的标识,服务端向客户端发送客户要求的监控点的门限数据。
图9 用户请求监控点门限数据
用户请求写监控点门限数据
客户端向服务端发送监控点的标识ID和新门限数据,服务端设置监控点的新门限数据并向客户端返回成功与否。
图10 用户请求写监控点门限数据
用户获取FSU的注册数据
客户端向服务端发送获取FSU向SC注册的数据(IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SCIP、DeviceID列表)的信息,服务端返回注册数据。
图11 获取注册数据过程
用户设置FSU的注册数据
客户端向服务端发送设置FSU向SC注册的数据(IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SCIP)的信息,服务端存储注册数据并返还成功标志。
图12 设置注册数据过程
用户获取FSU的FTP数据
客户端向服务端发送获取FTP用户、密码、数据的信息,服务端返回FTP数据。
图13 获取FTP数据过程
用户设置FSU的FTP数据
客户端向服务端发送设置FTP用户、密码数据的信息,服务端存储FTP数据并返还成功标志。
图14 设置FTP数据过程
时间同步
客户端向服务端发送标准时间信息,该信息在客户端启动与服务端连接时发送,也可以进行手动发送,FSU服务端按参数更新时间并返回成功标志。
图15 时间同步过程
用户获取FSU信息
客户端向服务端发送获取FSU信息的要求,服务端返回当前FSU状态参数。
图16 获取FSU信息过程
用户重启FSU
客户端向服务端发送重启要求,服务端返回成功标志后重启。
(此报文用于FSU的升级等操作:
SC侧先通过FTP将升级文件上传到FSU根目录,再发此报文使FSU重启后自动升级)。
图17 重启FSU过程
常量定义
表4 常量定义
NAME_LENGTH
名字命名长度
40字节
USER_LENGTH
用户名长度
20字节
PASSWORD_LEN
口令长度
EVENT_LENGTH
事件信息长度
160字节
ALARM_LENGTH
告警事件信息长度
165字节
LOGIN_LENGTH
登录事件信息长度
100字节
DES_LENGTH
描述信息长度
UNIT_LENGTH
数据单位的长度
8字节
STATE_LENGTH
态值描述长度
VER_LENGTH
版本描述的长度
AREACODE_LENGTH
区域编码长度
7字节
STATIONCODE_LENGTH
机房编码长度
12字节
NODECODE_LENGTH
监控信号编码
11字节
FSUID_LEN
FSUID字符串长度
14字节
FSUCODE_LEN
FSU编码字符串长度
IP_LENGTH
IP串长度
15字节
DEVICEID_LEN
设备ID长度
DEVICECODE_LEN
设备编码
ID_LENGTH
监控点ID长度
10字节
SERIALNO_LEN
告警序号长度
TIME_LEN
时间串长度
19字节
枚举定义
表5 1.枚举定义
属性名称
属性描述
类型定义
EnumRightMode
监控系统FSU向SC提供的权限定义
INVALID=0
无权限
LEVEL1=1
具备数据读的权限,当用户可以读某个数据,而无法写任何数据时返回这一权限值。
LEVEL2=2
具备数据读、写的权限,当用户对某个数据具有读写权限时返回这一权限值。
EnumResult
报文返回结果
FAILURE=0
失败
SUCCESS=1
成功
EnumType
监控系统数据的种类
STATION=0
局、站
DEVICE=1
设备
DI=2
数字输入量(包含多态数字输入量)
AI=3
模拟输入量
DO=4
数字输出量
AO=5
模拟输出量
AREA=9
区域
EnumAlarmLevel
告警的等级
NOALARM=0
无告警
CRITICAL=1
一级告警
MAJOR=2
二级告警
MINOR=3
三级告警
HINT=4
四级告警
EnumEnable
使能的属性
DISABLE=0
禁止/不能
ENABLE=1
开放/能
EnumAcceSCMode
实时数据访问的方式
ASK_ANSWER=0
一问一答方式
CHANGE_TRIGGER=1
改变时自动发送数据方式
TIME_TRIGGER=2
定时发送数据方式
STOP=3
停止发送数据方式
EnumState
数据值的状态
正常数据
OPEVENT=5
操作事件
INVALID=6
无效数据
EnumFlag
告警标志
BEGIN
开始
END
结束
EnumAlarmMode
告警等级设定的模式
不做告警上报
一级告警上报
二级告警上报
三级告警上报
四级告警上报
EnumStationType
特殊机房(自定义)
A级机房
B级机房
C级机房
D级机房
5
6
7
8
9
EnumModifyType
对象属性修改类型
ADDNONODES=0
新增(无子节点)
ADDINNODES=1
新增(含子节点)
DELETE=2
删除
MODIFYNONODES=3
修改(仅修改本节点)
MODIFYINNODES=4
修改(涉及到子节点)
EnumDeviceType
设备类型
高压配电
低压配电
交流配电屏
直流配电屏
柴油发电机组
开关电源
蓄电池组
UPS设备
UPS配电屏
10
UPS电池
11
240V直流系统
12
专用空调(风冷)
13
中央空调(水冷)
14
专用空调(通冷冻水型)
15
普通空调
16
智能电表
17
门禁系统
18
机房/基站环境
19
监控设备
20
太阳能/风能设备
21
燃气轮机发电机组
22
风力发电设备
23
智能通风系统
24
新风设备
25
热交换设备
26
热管设备
27
蓄电池温控柜
28
防雷设备/防雷箱
29
燃料电池
30
模块化UPS
31
240V电池
32
铁塔
33
FSU
94~99
预留
EnumDeviceCode
见设备编码表
2.设备编码表
设备/系统类型序号
设备/系统类型
设备编码(EnumDeviceCode)
A类局站
B类局站
C类局站
D类局站
101
201
301
401
低压配电
102
202
302
402
交流配电屏
103
203
303
403
直流配电屏
104
204
304
404
柴油发电机组
105
205
305
405
开关电源
106
206
306
406
蓄电池组
107
207
307
407
UPS设备
108
208
308
408
UPS配电屏
109
209
309
409
UPS电池
110
210
310
410
240V直流系统
111
211
311
411
专用空调(风冷)
112
212
312
412
中央空调(水冷)
113
213
313
413
专用空调(通冷冻水型)
114
214
314
414
普通空调
115
215
315
415
智能电表
116
216
316
416
门禁系统
117
217
317
417
机房/基站环境
118
218
318
418
监控设备
119
219
319
419
太阳能/风能设备
120
220
320
420
燃气轮机发电机组
121
221
321
421
风力发电设备
122
222
322
422
智能通风系统
123
223
323
423
新风设备
124
224
324
424
热交换设备
125
225
325
425
热管设备
126
226
326
426
蓄电池温控柜
127
227
327
427
防雷设备/防雷箱
128
228
328
428
129
229
329
429
130
230
The鐗╄祫Zhu涘簲鏂Gui紡330
The鍥liesthe檯Luц繍Xig悊430
TheQi冭繘Xian侀€?
鑰?
TheChenヤ綔Jin?
The鍒濇閰嶉€?
131
Doesthe鏇savethe鎬ф帶鍒?
231
331
431
TheLuх墿鍒嗚32
132
Gansentencethe細鎬HuiHai鍝?
232
332
The鍒╃敤鏈熼檺432
The铏氭嫙Xi撳簱FSU
133
233
333
433
34-99
数据结构定义
表6 数据结构定义
结构名称
结构描述
属性类型
TTime
时间的结构
Years
short
年
Month
char
月
Day
日
Hour
时
Minute
分
Second
秒
TSemaphore
信号量的值的结构
Type
数据类型
ID
char[ID_LENGTH]
监控点ID
Measur