最新中国铁塔动环监控系统统一互联B接口技术规范资料Word文件下载.docx

1、RequestPK_Type报文类型Info报文内容响应报文Response对象模型在监控中心下的对象模型参考如下：图2监控中心的对象模型注：可根据实际情况，在监控中心和FSU间可以没有区域。基本定义a） 当前告警：当前未结束的告警信息。b） 实时数据：最靠近当前时间的有效数据。c） FSUID： 数字串ID，从资源系统获取的唯一ID。d） FSU编码：14位字符串，编码方式如下：FSU编码借鉴中华人民共和国行政区划代码（GB/T 2260-2007）规范编码作为基础。将FSU做为一种设备管理，设备类型为33。FSU编码：由XX省（2位数字）+XX区县（4位数字）+局站类型与设备类型组合（3位

2、数字,设备类型固定为33）+XXFSU（5位数字）。XX省（2位数字）+XX区县（4位数字）的编码建议借鉴中华人民共和国行政区划代码（GB/T 2260-2007）规范的代码，详见中华人民共和国行政区划代码（GB/T 2260-2007）规范）。XXFSU有5位数字，可以考虑自动生成，生成后不再变动；也可预先编好。同一个区县的局站编码不得重复。表2局站类型编码表局站类型编码局站类型特殊局站（自定义）1A级局站2B级局站3C级局站4D级局站59保留比如，一个A类局站FSU名称为跑马场FSU，可以编为10001；一个D类局站FSU名称为牛头山FSU，可以编为40001。e） 设备ID，从资源系统获

3、取的设备唯一ID。f） 设备编码设备编码：设备编码借鉴中华人民共和国行政区划代码（GB/T 2260-2007）规范编码作为基础。由XX省（2位数字）+XX区县（4位数字）+局站类型与设备类型组合（3位数字）+XX设备（5位数字）。XX设备有5位数字，可以考虑自动生成，生成后不再变动；同一个区县的设备编码不得重复。g） 监控点ID：设备上的监测点的ID，10位数字。监控点在FSU内的标识号唯一。信号ID共10位，按照从低位到高位的顺序，具体定义如下：【0987654321】1-3：同类信号的顺序号，如整流模块、单体电池序号、输入电压路序号、负载熔丝序号、压缩机序号等，参考【信号字典表】4-5：

4、设备中具体信号的流水号，从00至99。（各省自行增加的信号请从70开始开始往上定义）6： 0-遥信信号（DI），1-遥测信号（AI），2-遥控信号（DO），3-遥调信号（AO）7-8：设备类型：详见设备/系统类型编码表9: 局站类型：详见局站类型编码表10: 预留扩展，暂固定为0具体可参见中国铁塔动环监控系统 统一信号字典表中信号量ID的定义。h） 告警事件描述采用XML文件，XML格式如下： 告警序号DeviceId设备IDDeviceCode/DeviceCode AlarmTime告警时间FsuIdFSUIDFsuCode/ FsuCodeId监控点IDAlarmLevel告警级别Ala

5、rmFlag告警标志AlarmDesc告警文本/TAlarm1） 告警序号：以10位数字表示，如0012345678（十进制），不足10位前面补0，最大不能超过一个无符号长整型所表示的数字，即数字在04294967295之间。同时在FSC内告警序号唯一，告警结束时的告警序号与告警产生时的告警序号相同。2） 设备ID：参考设备ID编码。3） 时间描述：YYYY-MM-DDhh:mm:ss（采用24小时的时间制式）。4） FSU ID：11位字符串表示。5） 监控点ID：参考监控点ID。6） 告警级别：一级/二级/三级/四级。7） 告警标志描述：开始/结束。8） 告警文本：40字节以内的告警内容描

6、述。例：001234567811010110100001/DeviceCode2006-09-04 12:01:31100240430101001二级开始欠压告警（46.1V） 说明：例中46.1V为告警触发值，其中、为半角符号。对于遥信量告警，告警文本为“告警”、“熔断”等文字。9） 所有文本描述中不能包含”符”字符。i） 数据类型的字节数定义表3数据类型字节数定义字节数Long4字节Short2字节Char1字节Float枚举类型j） FSU向SC注册的信息： IPSec/L2TP拨号参数：FSU向IPSec/L2TP服务器建立IPSec/L2TP隧道所须参数，包括IPSec/L2TP服务

7、器IP、用户名、密码； SC IP：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客户端的合法用户

8、名，并且报文必须携带在第一步所获得的内网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上报告警

9、信息，SC返回确认信息。图5用户请求告警数据过程用户请求监控点数据客户端向服务端发送所需数据的标识，服务端向客户端发送客户要求的监控点的当前状态信息。图6用户请求监控点数据过程用户请求监控点历史数据客户端向服务端发送所需数据的标识，服务端向客户端发送客户要求的时间段内的监控点的历史状态信息，按轮询周期（1小时），一个轮询周期只取1个点。图7用户请求监控点历史数据过程用户请求写监控点的设置值客户端向服务端发送监控点的标识ID和新设置值，服务端设置监控点的新设置值并向客户端返回成功与否。图8用户请求写监控点的设置值过程用户请求监控点门限数据客户端向服务端发送所需数据的标识，服务端向客户端发送客户要

10、求的监控点的门限数据。图9用户请求监控点门限数据用户请求写监控点门限数据客户端向服务端发送监控点的标识ID和新门限数据，服务端设置监控点的新门限数据并向客户端返回成功与否。图10用户请求写监控点门限数据用户获取FSU的注册数据客户端向服务端发送获取FSU向SC注册的数据（IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SC IP、DeviceID列表）的信息，服务端返回注册数据。图11获取注册数据过程用户设置FSU的注册数据客户端向服务端发送设置FSU向SC注册的数据（IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SC IP）的信息，服务端存储注册数据并返还成

11、功标志。图12设置注册数据过程用户获取FSU的FTP数据客户端向服务端发送获取FTP用户、密码、数据的信息，服务端返回FTP数据。图13获取FTP数据过程用户设置FSU的FTP数据客户端向服务端发送设置FTP用户、密码数据的信息，服务端存储FTP数据并返还成功标志。图14设置FTP数据过程时间同步客户端向服务端发送标准时间信息，该信息在客户端启动与服务端连接时发送，也可以进行手动发送，FSU服务端按参数更新时间并返回成功标志。图15时间同步过程用户获取FSU信息客户端向服务端发送获取FSU信息的要求，服务端返回当前FSU状态参数。图16获取FSU信息过程用户重启FSU客户端向服务端发送重启要求

12、，服务端返回成功标志后重启。（此报文用于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版本描述的长度AREACO

13、DE_LENGTH区域编码长度7字节STATIONCODE_LENGTH机房编码长度12字节NODECODE_LENGTH监控信号编码11字节FSUID_LENFSU ID字符串长度14字节FSUCODE_LENFSU编码字符串长度IP_LENGTHIP串长度15字节DEVICEID_LEN设备ID长度DEVICECODE_LEN设备编码ID_LENGTH监控点ID长度10字节SERIALNO_LEN告警序号长度TIME_LEN时间串长度19字节枚举定义表51.枚举定义属性名称属性描述类型定义EnumRightMode监控系统FSU向SC提供的权限定义INVALID0无权限LEVEL11具备数

14、据读的权限,当用户可以读某个数据，而无法写任何数据时返回这一权限值。LEVEL22具备数据读、写的权限，当用户对某个数据具有读写权限时返回这一权限值。EnumResult报文返回结果FAILURE0失败SUCCESS1成功EnumType监控系统数据的种类STATION0局、站DEVICE1设备DI2数字输入量（包含多态数字输入量）AI3模拟输入量DO4数字输出量AO5模拟输出量AREA9区域EnumAlarmLevel告警的等级NOALARM0无告警CRITICAL1一级告警MAJOR2二级告警MINOR3三级告警HINT4四级告警EnumEnable使能的属性DISABLE0禁止/不能EN

15、ABLE1开放/能EnumAcceSCMode 实时数据访问的方式ASK_ANSWER0一问一答方式CHANGE_TRIGGER1改变时自动发送数据方式TIME_TRIGGER2定时发送数据方式STOP3停止发送数据方式EnumState数据值的状态正常数据OPEVENT5操作事件INVALID6无效数据EnumFlag告警标志BEGIN开始END结束EnumAlarmMode告警等级设定的模式不做告警上报一级告警上报二级告警上报三级告警上报四级告警上报EnumStationType特殊机房（自定义）A级机房B级机房C级机房D级机房56789EnumModifyType对象属性修改类型ADDN

16、ONODES=0新增（无子节点）ADDINNODES=1新增（含子节点）DELETE=2删除MODIFYNONODES=3修改（仅修改本节点）MODIFYINNODES=4修改（涉及到子节点）EnumDeviceType设备类型高压配电低压配电交流配电屏直流配电屏柴油发电机组开关电源蓄电池组UPS设备UPS配电屏10UPS电池11240V直流系统12专用空调（风冷）13中央空调（水冷）14专用空调（通冷冻水型）15普通空调16智能电表17门禁系统18机房/基站环境19监控设备20太阳能/风能设备21燃气轮机发电机组22风力发电设备23智能通风系统24新风设备25热交换设备26热管设备27蓄电池

17、温控柜28防雷设备/防雷箱29燃料电池30模块化UPS31240V电池32铁塔33FSU9499预留EnumDeviceCode见设备编码表2.设备编码表 设备/系统类型序号设备/系统类型设备编码（EnumDeviceCode）A类局站B类局站C类局站 D类局站101201301401低压配电 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配电

18、屏 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

19、 风力发电设备 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 129229 329 429 130230The 鐗祫 Zhu 涘簲鏂 Gui 紡330The 鍥 lies the 檯 Lu 繍 Xi 悊430The Qi 冭繘 Xian 侀? 鑰 ?The Chen 綔 Jin?The 鍒濇 閰嶉?131Does the 鏇 save the 鎬帶鍒 ?231331431The Lu 墿鍒嗚 32132Gan sentence the 細鎬 Hui Hai 鍝 ?232332The 鍒敤鏈熼檺432The 铏氭嫙 Xi 撳簱FSU13323333343334-99数据结构定义表6数据结构定义结构名称结构描述属性类型TTime时间的结构Yearsshort年Monthchar月Day日Hour时Minute分Second秒TSemaphore信号量的值的结构Type数据类型IDcharID_LENGTH监控点IDMeasur