中国铁塔动环监控系统统一互联B接口关键技术标准规范.docx

专题：铁塔集团、B接口规范、铁塔B接口规范中国铁塔动环监控系统统一互联B接口技术规范（试行）版本：V1.0中国铁塔股份12月目录1 范围42 规范性引用文件43 定义43.1 集中监控中心Supervision Center（SC)43.2 现场监控单元Field supervision unit（FSU)43.3 通信协议 Communication Protocol43.4 B接口B Interface53.5 监控对象Supervision Object(SO)53.6 监控点Supervision Point(SP)53.7 数据流接口54 接口55 B接口互联规范65.1 B接口互联65.2 B接口报文协议66 FTP接口能力427 FSU初始化能力438 FSU自动升级能力439 SC心跳功效4310 门限值配置43前言为加强中国铁塔动力环境集中监控系统（以下简称动环监控系统）建设，实现集团监控中心对全国铁塔动力设备和环境统一监控、统一派单目标，特制订中国铁塔动环监控系统统一互联B接口技术规范。本规范明确了动环监控系统互联B接口互联规范、B接口定义、互联协议、报文协议及数据库协议。本规范作为动环监控系统建设标准，同时也可作为接入中国铁塔动环监控系统平台各动环厂家软、硬件技术设备技术参考依据。1 范围B接口要求了动环监控系统在监控中心（SC）和现场监控单元（FSU）互联数据传输规范。以上图中右侧单位称为“接出方”，左侧单位称为“接入方”。2 规范性引用文件下列文件对本文件应用是必不可少。通常注日期引用文件，仅注日期版本适适用于本文件。通常不注日期引用文件，其最新版本（包含全部修改单）适适用于本文件。YDT1363.2- 通信局（站）电源、空调及环境集中监控管理系统 第2部分：互联协议中国铁塔动环监控系统 统一编码及命名规范V1.0中国铁塔动环监控系统 统一信号字典表V1.03 定义 下列术语和定义适适用于本文件。3.1 集中监控中心Supervision Center（SC)面向多FSU管理高级监控层次，即集团监控平台，经过开放数据协议，连接全国FSU。3.2 现场监控单元Field supervision unit（FSU)监控系统最小子系统，由若干监控模块和其它辅助设备组成，面向直接设备数据采集、处理监控层次，能够包含采样、数据处理、数据中继等功效。3.3 通信协议 Communication Protocol规范两个实体之间进行标准通信应用层规约。3.4 B接口B Interface为集中监控中心（SC）和现场监控单元（FSU）之间接口。3.5 监控对象Supervision Object(SO)被监控多种电源、空调设备及机房环境。3.6 监控点Supervision Point(SP)监控对象上某个特定监控信号。3.7 数据流接口一个基于Soap+XML技术接口。4 接口依据管理功效不一样将整个监控系统划分为多个网络管理层，各个管理层之间存在着相互通信，而且整个监控管理系统存在和综合网管之间相互通信，这么为确保网络内部不一样等级管理层之间正常通信、监控系统和综合网管正常通信，将不一样管理层之间定义不一样接口，接口定义图1所表示。图1 接口定义示意图本互联接口指B接口，后面描述简称为B接口。5 B接口互联规范5.1 B接口互联5.1.1 接口方法FSU和SC之间经过WebService和FTP方法互联，二者同时形成完整B接口协议标准。5.1.2 接入双方要求SC轮询FSU获取数据(慢数据)：温湿度、电压、电流、电量、频率、开关状态等。此时FSU为服务端，SC为用户端；慢数据里视频图像文件，采取FTP方法获取。此时FSU为FTP服务端，SC为用户端；FSU主动上报设备事件数据（快数据）：告警、状态切换等。此时，FSU为用户端，SC为服务端。5.2 B接口报文协议5.2.1 报文标准SC和FSU之间接口基于WebService技术，消息协议采取XML格式。5.2.2 WSDL定义SC提供Webservice接口WSDL定义见附件FSU接口Webservice接口WSDL定义见附件5.2.3 基础报文格式定义表1 基础报文格式定义类型一级节点二级节点定义请求报文RequestPK_Type报文类型Info报文内容响应报文ResponsePK_Type报文类型Info报文内容5.2.4 对象模型在监控中心下对象模型参考以下：图2 监控中心对象模型注：可依据实际情况，在监控中心和FSU间能够没有区域。5.2.5 基础定义a) 目前告警：目前未结束告警信息。b) 实时数据：最靠近目前时间有效数据。c) FSUID： 数字串ID，从资源系统获取唯一ID。d) FSU编码：14位字符串，编码方法以下：FSU编码借鉴中国行政区划代码（GB/T 2260-)规范编码作为基础。将FSU做为一个设备管理，设备类型为33。FSU编码：由XX省（2位数字）+XX区县（4位数字）+局站类型和设备类型组合（3位数字,设备类型固定为33）+XXFSU（5位数字）。XX省（2位数字）+XX区县（4位数字）编码提议借鉴中国行政区划代码（GB/T 2260-)规范代码，详见中国行政区划代码（GB/T 2260-)规范）。XXFSU有5位数字，能够考虑自动生成，生成后不再变动；也可预先编好。同一个区县局站编码不得反复。表2 局站类型编码表局站类型编码局站类型0特殊局站（自定义）1A级局站2B级局站3C级局站4D级局站59保留比如，一个A类局站FSU名称为跑马场FSU，能够编为10001；一个D类局站FSU名称为牛头山FSU，能够编为40001。e) 设备ID，从资源系统获取设备唯一ID。f) 设备编码设备编码：设备编码借鉴中国行政区划代码（GB/T 2260-)规范编码作为基础。FSU编码：由XX省（2位数字）+XX区县（4位数字）+局站类型和设备类型组合（3位数字）+XX设备（5位数字）。XX省（2位数字）+XX区县（4位数字）编码提议借鉴中国行政区划代码（GB/T 2260-)规范代码，详见中国行政区划代码（GB/T 2260-)规范）。XX设备有5位数字，能够考虑自动生成，生成后不再变动；也可预先编好。同一个区县设备编码不得反复。g) 监控点ID：设备上监测点ID，10位数字。监控点在FSU内标识号唯一。信号ID共10位，根据从低位到高位次序，具体定义以下：【】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格式以下：告警序号设备ID设备ID告警时间FSUIDFSUID监控点ID告警等级告警标志告警文本1) 告警序号：以10位数字表示，如(十进制)，不足10位前面补0，最大不能超出一个无符号长整型所表示数字，即数字在0之间。同时在FSC内告警序号唯一，告警结束时告警序号和告警产生时告警序号相同。2) 设备ID：参考设备ID编码。3) 时间描述：YYYY-MM-DDhh:mm:ss（采取二十四小时时间制式）。4) FSU ID：11位字符串表示。5) 监控点ID：参考监控点ID。6) 告警等级：一级/二级/三级/四级。7) 告警标志描述：开始/结束。8) 告警文本：40字节以内告警内容描述。例：0101-09-04 12:01:311002401二级开始欠压告警(46.1V) 说明：例中46.1V为告警触发值，其中、为半角符号。对于遥信量告警，告警文本为“告警”、“熔断”等文字。9) 全部文本描述中不能包含”符”字符。i) 数据类型字节数定义表3 数据类型字节数定义类型字节数Long4字节Short2字节Char1字节Float4字节枚举类型4字节j) FSU向SC注册信息： IPSec/L2TP拨号参数：FSU向IPSec/L2TP服务器建立IPSec/L2TP隧道所须参数，包含IPSec/L2TP服务器IP、用户名、密码； SC IP：SC前置机或采集机IP，FSU向其提议注册和工作过程中数据交互目标IP。k) SC、FSU依据下图所表示，建立连接：FSU用户端SC服务端LOGINLOGIN_ACK注册过程登出过程LOGOUTLOGOUT_ACK返回注册确定返回登出过程是否成功Setup TCP link（1、4G/3G拨号；2、IPSec拨号，分配内网IP）Login successBreak out TCP link工作过程图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隧道连接。5.2.6 数据流方法5.2.6.1 FSU向SC注册用户端向服务端传送用户名、口令、内网IP；服务端向用户端发送注册确定。FSU用户端SC服务端LOGINLOGIN_ACKFSU注册过程SC登出过程LOGOUTLOGOUT_ACK注册成功后，能够进行数据交流返回注册确定返回登出过程是否成功图4 用户注册过程5.2.6.2 上汇报警信息FSU做用户端，SC是服务端。FSU依据告警门限判定有告警需上报时，向SC上汇报警信息，SC返回确定信息。SC服务端FSU用户端上汇报警信息SEND_ALARMSEND_ALARM_ACK接收到告警返回图5 用户请求告警数据过程5.2.6.3 用户请求监控点数据用户端向服务端发送所需数据标识，服务端向用户端发送用户要求监控点目前状态信息。SC用户端FSU服务端GET_DATAGET_DATA_ACKFSU返还数据用户请求数据图6 用户请求监控点数据过程5.2.6.4 用户请求监控点历史数据用户端向服务端发送所需数据标识，服务端向用户端发送用户要求时间段内监控点历史状态信息，按轮询周期（1小时），一个轮询周期只取1个点。SC用户端FSU服务端GET_HISDATAGET_HISDATA_ACKFSU返还数据用户请求数据图7 用户请求监控点历史数据过程5.2.6.5 用户请求写监控点设置值用户端向服务端发送监控点标识ID和新设置值，服务端设置监控点新设置值并向用户端返回成功是否。SC用户端FSU服务端SET_POINTSET_POINT_ACK设置数据值返回设置成功是否标识图8 用户请求写监控点设置值过程5.2.6.6 用户请求监控点门限数据用户端向服务端发送所需数据标识，服务端向用户端发送用户要求监控点门限数据。SC用户端FSU服务端GET_THRESHOLDGET_THRESHOLD_ACKFSU返还数据用户请求数据图9 用户请求监控点门限数据5.2.6.7 用户请求写监控点门限数据用户端向服务端发送监控点标识ID和新门限数据，服务端设置监控点新门限数据并向用户端返回成功是否。SC用户端FSU服务端SET_THRESHOLDSET_THRESHOLD_ACK设置门限数据返回设置成功是否标识图10 用户请求写监控点门限数据5.2.6.8 用户获取FSU注册数据用户端向服务端发送获取FSU向SC注册数据（IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SC IP、DeviceID列表）信息，服务端返回注册数据。SC用户端FSU服务端GET_LOGININFOGET_ LOGININFO_ACK提议获取要求返回获取成功是否图11 获取注册数据过程5.2.6.9 用户设置FSU注册数据用户端向服务端发送设置FSU向SC注册数据（IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SC IP）信息，服务端存放注册数据并返还成功标志。SC用户端FSU服务端SET_LOGININFOSET_LOGININFO_ACK提议设置要求返回设置成功是否图12 设置注册数据过程5.2.6.10 用户获取FSUFTP数据用户端向服务端发送获取FTP用户、密码、数据信息，服务端返回FTP数据。SC用户端FSU服务端GET_FTPGET_ FTP _ACK提议获取要求返回获取成功是否图13 获取FTP数据过程5.2.6.11 用户设置FSUFTP数据用户端向服务端发送设置FTP用户、密码数据信息，服务端存放FTP数据并返还成功标志。SC用户端FSU服务端SET_ FTPSET_ FTP _ACK提议设置要求返回设置成功是否图14 设置FTP数据过程5.2.6.12 时间同时用户端向服务端发送标按时间信息，该信息在用户端开启和服务端连接时发送，也能够进行手动发送，FSU服务端按参数更新时间并返回成功标志。SC用户端FSU服务端TIME_CHECKTIME_CHECK_ACK提议对时要求返回对时成功是否图15 时间同时过程5.2.6.13 用户获取FSU信息用户端向服务端发送获取FSU信息要求，服务端返回目前FSU状态参数。SC用户端FSU服务端GET_FSUINFOGET_FSUINFO_ACK提议获取要求返回FSU状态参数图16 获取FSU信息过程5.2.6.14 用户重启FSU用户端向服务端发送重启要求，服务端返回成功标志后重启。（此报文用于FSU升级等操作：SC侧先经过FTP将升级文件上传到FSU根目录，再发此报文使FSU重启后自动升级）。SC用户端FSU服务端SET_FSUREBOOTSET_FSUREBOOT_ACK提议重启要求返回确定图17 重启FSU过程5.2.7 常量定义表4 常量定义NAME_LENGTH名字命名长度40字节USER_LENGTH用户名长度20字节PASSWORD_LEN口令长度20字节EVENT_LENGTH事件信息长度160字节ALARM_LENGTH告警事件信息长度165字节LOGIN_LENGTH登录事件信息长度100字节DES_LENGTH描述信息长度40字节UNIT_LENGTH数据单位长度8字节STATE_LENGTH态值描述长度160字节VER_LENGTH版本描述长度20字节AREACODE_LENGTH区域编码长度7字节STATIONCODE_LENGTH机房编码长度12字节NODECODE_LENGTH监控信号编码11字节EVENT_LENGTH事件信息长度160字节FSUID_LENFSU ID字符串长度14字节FSUCODE_LENFSU编码字符串长度14字节IP_LENGTHIP串长度15字节DEVICEID_LEN设备ID长度14字节DEVICECODE_LEN设备编码14字节ID_LENGTH监控点ID长度10字节SERIALNO_LEN告警序号长度10字节TIME_LEN时间串长度19字节5.2.8 枚举定义表5 1.枚举定义属性名称属性描述枚举类型类型定义EnumRightMode监控系统FSU向SC提供权限定义INVALID0无权限LEVEL11含有数据读权限,当用户能够读某个数据，而无法写任何数据时返回这一权限值。LEVEL22含有数据读、写权限，当用户对某个数据含有读写权限时返回这一权限值。EnumResult报文返回结果FAILURE0失败SUCCESS1成功EnumType监控系统数据种类STATION0局、站DEVICE1设备DI2数字输入量（包含多态数字输入量）AI3模拟输入量DO4数字输出量AO5模拟输出量AREA9区域EnumAlarmLevel告警等级NOALARM0无告警CRITICAL1一级告警MAJOR2二级告警MINOR3三级告警HINT4四级告警EnumEnable使能属性DISABLE0严禁/不能ENABLE1开放/能EnumAcceSCMode 实时数据访问方法ASK_ANSWER0一问一答方法CHANGE_TRIGGER1改变时自动发送数据方法TIME_TRIGGER2定时发送数据方法STOP3停止发送数据方法EnumState数据值状态NOALARM0正常数据CRITICAL1一级告警MAJOR2二级告警MINOR3三级告警HINT4四级告警OPEVENT5操作事件INVALID6无效数据EnumFlag告警标志BEGIN开始END结束EnumAlarmMode告警等级设定模式NOALARM0不做告警上报CRITICAL1一级告警上报MAJOR2二级告警上报MINOR3三级告警上报HINT4四级告警上报EnumStationType局站类型0特殊机房（自定义）1A级机房2B级机房3C级机房4D级机房5保留6保留7保留8保留9保留EnumModifyType对象属性修改类型ADDNONODES=0新增（无子节点）ADDINNODES=1新增（含子节点）DELETE=2删除MODIFYNONODES=3修改（仅修改本节点）MODIFYINNODES=4修改（包含到子节点）EnumDeviceType设备类型1高压配电2低压配电3交流配电屏4直流配电屏5柴油发电机组6开关电源7蓄电池组8UPS设备9UPS配电屏10UPS电池11240V直流系统12专用空调(风冷)13中央空调(水冷)14专用空调（通冷冻水型）15一般空调16智能电表17门禁系统18机房/基站环境19监控设备20太阳能/风能设备21燃气轮机发电机组22风力发电设备23智能通风系统24新风设备25热交换设备26热管设备27蓄电池温控柜28防雷设备/防雷箱29燃料电池30模块化UPS31240V电池32铁塔33FSU9499预留EnumDeviceCode设备编码见设备编码表见设备编码表2.设备编码表 设备/系统类型序号设备/系统类型设备编码（EnumDeviceCode）A类局站B类局站C类局站 D类局站1高压配电1012013014012低压配电 102 202 302 402 3交流配电屏 103 203 303 403 4直流配电屏 104 204 304 404 5柴油发电机组 105 205 305 405 6开关电源 106 206 306 406 7蓄电池组 107 207 307 407 8UPS设备 108 208 308 408 9UPS配电屏 109 209 309 409 10UPS电池 110 210 310 410 11240V直流系统 111 211 311 411 12专用空调(风冷) 112 212 312 412 13中央空调(水冷) 113 213 313 413 14专用空调（通冷冻水型） 114 214 314 414 15一般空调 115 215 315 415 16智能电表 116 216 316 416 17门禁系统 117 217 317 417 18机房/基站环境 118 218 318 418 19监控设备 119 219 319 419 20太阳能/风能设备 120 220 320 420 21燃气轮机发电机组 121 221 321 421 22风力发电设备 122 222 322 422 23智能通风系统 123 223 323 423 24新风设备 124 224 324 424 25热交换设备 125 225 325 425 26热管设备 126 226 326 426 27蓄电池温控柜 127 227 327 427 28防雷设备/防雷箱 128 228 328 428 29燃料电池129229 329 429 30模块化UPS13023033043031240V电池13123133143132铁塔13223233243233FSU13323333343334-99预留5.2.9 数据结构定义表6 数据结构定义结构名称结构描述属性名称属性类型类型定义TTime时间结构Yearsshort年Monthchar月Daychar日Hourchar时Minutechar分Secondchar秒TSemaphore信号量值结构TypeEnumType数据类型IDcharID_LENGTH监控点IDMeasuredValfloat实测值SetupValfloat设置值StatusEnumState状态RecordTimechar DES_LENGTH统计时间，YYYY-MM-DDhh:mm:ss（采取二十四小时时间制式），取历史数据时统计时间TThreshold信号量门限值结构TypeEnumType数据类型IDcharID_LENGTH监控点IDThresholdfloat门限值AbsoluteValfloat绝对阀值RelativeValfloat百分比阀值StatusEnumState状态TAlarm目前告警值结构SerialNocharSERIALNO_LEN告警序号IDcharID_LENGTH监控点IDFSUIDcharFSUID_LENFSU ID号，资源系统IDFsuCodecharFSUCODE_LENFSU 编码DeviceIDcharDEVICEID_LEN设备IDDeviceCodecharDEVICEICODE_LEN设备编码AlarmTimechar DES_LENGTH告警时间，YYYY-MM-DDhh:mm:ss（采取二十四小时时间制式）AlarmLevelEnumState告警等级AlarmFlagEnumFlag告警标志AlarmDescchar DES_LENGTH告警事件描述TGPSGPS数据结构FSUIDlongFSU IDLagfloat经度Latfloat纬度TFSUStatusFSU状态参数CPUUsagefloatCPU使用率MEMUsagefloat内存使用率5.2.10 报文类型定义表7 报文类型定义报文类型报文动作数据流方向类型名称类型代号FSU向SC注册注册SCFSULOGIN_ACK102登出SCFSULOGOUT_ACK104用户请求监控点数据用户请求监控点数据SCFSUGET_DATA401用户请求监控点数据响应SCFSUGET_HISDATA403用户请求监控点历史数据响应SCFSUGET_HISDATA_ACK404上汇报警信息实时告警发送SCFSUSEND_ALARM_ACK502用户请求写监控点设置值写数据请求SCFSUSET_POINT1001写数据响应SCFSUTIME_CHECK1301时钟同时响应SCFSUGET_LOGININFO1501获取注册信息（IPSec用户、密码、IPSec服务器IP、SC IP数据）响应SCFSUSET_LOGININFO1503设置注册信息（IPSec用户、密码、IPSec服务器IP、SC IP数据）响应SCFSUGET_FTP1601获取FSUFTP用户、密码数据响应SCFSUSET_FTP1603设置FSUFTP用户、密码数据响应SCFSUGET_FSUINFO1701获取FSU状态参数响应SCFSUSET_FSUREBOOT1801重启FSU响应SCFSUGET_THRESHOLD1901用户请求监控点门限数据响应SCFSUSET_THRESHOLD用户请求写监控点门限数据响应SCFSUSET_THRESHOLD_ACK5.2.11 数据流格式定义5.2.11.1 FSU向SC注册动作：注册提议：用户端表8 FSU向SC注册请求报文提议用户端字段变量名称/报文定义长度及类型描述PK_TypeLOGINSizeof(long)登录命令InfoUserNameUSER_LENGTH用户名PaSCwordPASSWORD_LEN口令FsuIdcharFSUID_LENFS ID号，资源系统IDFsuCodecharFSUID_LENFSU编码FsuIPIP_LENGTHFSU内网IPDeviceListn*DEVICEID_LENDeviceID列表XML样例LOGIN101cntowercntower响应：服务端表9 FSU向SC注册请求应答报文变量名称/报文定义长度及类型描述PK_TypeLOGIN_ACKSizeof(long)登录命令对应InfoRightLevelEnumRightMode发回权限设置XML样例LOGIN_ACK102动作：登出提议：用户端表10 FSU向SC登出请求报文变量名称/报文定义长度及类型描述PK_TypeLOGOUTSizeof(long)登出命令InfoFsuIdcharFSUID_LENFSU ID号，资源系统IDXML样例LOGOUT103