中国铁塔动环监控系统统一互联B接口技术规范培训资料.docx

中国铁塔动环监控系统统一互联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(采用24小时的时间制式)。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两次注册之间的最小时间间隔不小于120秒。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 用户获取FSU的FTP数据客户端向服务端发送获取FTP用户、密码、数据的信息,服务端返回FTP数据。SC客户端FSU服务端GET_FTPGET_ FTP _ACK发起获取要求返回获取成功与否图13 获取FTP数据过程5.2.6.11 用户设置FSU的FTP数据客户端向服务端发送设置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字节MAC_LENGTHMAC串长度15字节IMSI_LENGTHIMSI卡号15字节NETWORKTYPE_LENGTH网络制式2字节CARRIER_LENGTH运营商2字节NMVENDOR_LENGTH上网模块厂商20字节NMTYPE_LENGTH上网模块型号20字节REG_MODE_LENGTH注册模式2字节DEVICEID_LEN设备ID长度14字节DEVICECODE_LEN设备编码14字节ID_LENGTH监控点ID长度10字节SERIALNO_LEN告警序号长度10字节TIME_LEN时间串长度19字节FSUVENDOR_LENGTHFSU厂商20字节VERSION_LENGTH版本串长度20字节DICTVERSION_LENGTH信号字典版本长度1字节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铁锂电池33逆变器34280V直流远供系统-局端升压35280V直流远供系统-远端降压36智能电表(直流)37铁塔38智能动环监控设备(FSU)3999预留EnumDeviceCode设备编码见设备编码表见设备编码表2.设备编码表 设备/系统类型序号设备/系统类型设备编码(EnumDeviceCode)A类局站B类局站C类局站D类局站1高压配电1012013014012低压配电1022023024023交流配电屏1032033034034直流配电屏1042043044045柴油发电机组1052053054056开关电源1062063064067蓄电池组1072073074078UPS设备1082083084089UPS配电屏10920930940910UPS电池11021031041011240V直流系统11121131141112专用空调(风冷)11221231241213中央空调(水冷)11321331341314专用空调(通冷冻水型)11421431441415普通空调11521531541516智能电表(交流)11621631641617门禁系统11721731741718机房/基站环境11821831841819监控设备11921931941920新能源供电系统(太阳能、风能)12022032042021燃气轮机发电机组12122132142122风力发电设备12222232242223智能通风系统12322332342324新风设备12422432442425热交换设备12522532542526热管设备12622632642627蓄电池温控柜12722732742728防雷设备/防雷箱12822832842829燃料电池12922932942930模块化UPS13023033043031240V电池13123133143132铁锂电池13223233243233逆变器13323333343334280V直流远供系统-局端升压13423433443435280V直流远供系统-远端降压13523533543536智能电表(直流)13623633643637铁塔13723733743738智能动环监控设备(FSU)1382383384383998预留99非智能门禁1992993994995.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(采用24小时的时间制式),取历史数据时的记录时间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(采用24小时的时间制式)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获取FSU的FTP用户、密码数据响应SCFSUSET_FTP1603设置FSU的FTP用户、密码数据响应SCFSUGET_FSUINFO1701获取FSU的状态参数响应SCFSUSET_FSUREBOOT1801重启FSU响应SCFSUGET_THRESHOLD1901用户请求监控点门限数据响应SCFSUSET_THRESHOLD 用户请求写监控点门限数据响应SCFSUSET_THRESHOLD_ACK 5.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的内网IPMacIdMAC_LENGTH无线模块的MAC地址(唯一标识)ImsiIdIMSI_LENGTHIMSI卡号NetworkTypeNETWORK_TYPE_LENGTH网络制式(2G、3G、4G)CarrierCARRIER_LENGTH运营商名称(枚举值,CT:电信,CM:移动,CU:联通)NMVendorNMVENDOR_LENGTH上网模块厂商名称NMTypeNMTYPE_LENGTH上网模块型号Reg_ModeREG_MODE_LENGTH注册模式(枚举值,1:原有注册模块,2:新的注册械),可为空,为空表示采用原有的注册模式,参考注册模式FSUVendorFSUVENDOR_LENGTHFS