2023年铁塔动环监控系统统一互联B接口技术规范培训资料

中国铁塔动环监控系统

统一互联B接口技术规范

（试行）

版本：V1.0

中国铁塔股份有限公司

2014年12月

目录

1.范围......................................................................4

2.规范性引用文件............................................................4

3.定义.......................................................................4

3.1集中监控中心一SupervisionCenter(SC).......................................................................4

3.2现场监控单元一Fieldsupervisionunit(FSU)............................................................4

3.3通信协议一CommunicationProtocol...........................................................................5

3.4B接口一BInterface.........................................................................................................5

3.5监控对象一SupervisionObject(SO)..............................................................................5

3.6监控点一SupervisionPoint(SP)......................................................................................5

3.7数据流接口............................................................5

4.接口......................................................................5

5.B接口互联规范............................................................6

5.1B接口互联............................................................6

5.2B接口报文协议.......................................................6

6.FTP接口能力.............................................................41

7.FSU初始化能力..........................................................42

8.FSU自动升级能力........................................................42

9.SC心跳功能..............................................................42

10.门限值配置..............................................................42

前言

为加强中国铁塔动力环境集中监控系统（以下简称动环监控系统）建设，实现集团监控

中心对全国铁塔动力设备和环境的统一监控、统一派单的目标，特制定中国铁塔动环监控系

统统一互联B接口技术规范。本规范明确了动环监控系统互联B接口互联规范、B接口定义、

互联协议、报文协议及数据库协议。本规范作为动环监控系统的建设标准，同时也可作为接

入中国铁塔动环监控系统平台的各动环厂家软、硬件技术设备的技术参考依据。

1.范围

B接口规定了动环监控系统在监控中心（SC）与现场监控单元（FSU）互联的

数据传输规范。

以上图中右侧单位称为“接出方”，左侧单位称为“接入方”。

2.规范性引用文件

下列文件对本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期

的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改

单）适用于本文件。

YDT1363.2-2014通信局（站）电源、空调及环境集中监控管理系统第2部

分：互联协议

中国铁塔动环监控系统统一编码及命名规范VI.0

中国铁塔动环监控系统统一信号字典表VI.0

3.定义

下列术语和定义适用于本文件。

3.1集中监控中心一SupervisionCenter（SC）

面向多FSU管理的高级监控层次，即集团监控平台，通过开放的数据协议，连

接全国的FSU。

3.2现场监控单元一Fieldsupervisionunit（FSU）

监控系统的最小子系统，由若干监控模块和其它辅助设备组成，面向直接的

设备数据采集、处理的监控层次，可以包含采样、数据处理、数据中继等功能。

3.3通信协议一CommunicationProtocol

规范两个实体之间进行标准通信的应用层的规约。

3.4B接口一BInterface

为集中监控中心(SC)与现场监控单元(FSU)之间的接口。

3.5监控对象一SupervisionObject(SO)

被监控的各种电源、空调设备及机房环境。

3.6监控点—SupervisionPoint(SP)

监控对象上某个特定的监控信号。

3.7数据流接口

一种基于Soap+XML技术的接口。

4.接口

依据管理功能的不同将整个监控系统划分为几个网络管理层，各个管理层之

间存在着相互通信，而且整个监控管理系统存在与综合网管之间的相互通信，这

样为保证网络内部不同级别的管理层之间正常通信、监控系统与综合网管的正常

通信，将不同管理层之间定义不同的接口，接口定义如图1所示。

电团端中，R

B接【B接口B接口

智能FSU智能FSU智能FSU

图1接口定义示意图

本互联接口指B接口，后面的描述简称为B接口。

5.B接口互联规范

5.1B接口互联

5.1.1接口方式

FSU与SC之间通过WebService和FTP方式互联，二者同时形成完整的B接口协议

标准。

5.1.2接入双方要求

SC轮询FSU获取数据（慢数据）：温湿度、电压、电流、电量、频率、开关状态

等。此时FSU为服务端，SC为客户端；

慢数据里的视频图像文件，采用FTP方式获取。此时FSU为FTP服务端，SC为客

户端；

FSU主动上报设备事件数据（快数据）：告警、状态切换等。此时，FSU为客

户端,SC为服务端。

5.2B接口报文协议

5.2.1报文原则

SC与FSU之间的接口基于WebService技术，消息协议采用XML格式。

5.2.2WSDL定义

SC提供的Webservice接口的WSDL定义见附件

SCScrvicc.vndl

FSU接口的Webservice接口的WSDL定义见附件

FSUScrrice.w»dl

5.2.3基本报文格式定义

表1基本报文格式定义

类型一级节点二级节点定义

PK_Type报文类型

请求报文Request

Info报文内容

PK_Type报文类型

响应报文Response

Info报文内容

5.2.4对象模型

在监控中心下的对象模型参考如下:

图2监控中心的对象模型

注：可根据实际情况，在监控中心和FSU间可以没有区域。

5.2.5基本定义

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/T

2260-2007）规范）o

XXFSU有5位数字，可以考虑自动生成，生成后不再变动；也可预先编好。同

一个区县的局站编码不得重复。

表2局站类型编码表

局站类型编码局站类型

0特殊局站（自定义）

1A级局站

2B级局站

3C级局站

4D级局站

5~9保留

比如，一个A类局站FSU名称为跑马场FSU,可以编为10001；一个D类局站

FSU名称为牛头山FSU,可以编为40001。

e）设备ID,从资源系统获取的设备唯一ID。

f）设备编码

设备编码：设备编码借鉴中华人民共和国行政区划代码（GB/T2260-2007）规

范编码作为基础。FSU编码：由XX省（2位数字）+XX区县（4位数字）+局站类

型与设备类型组合（3位数字）+XX设备（5位数字）。

XX省（2位数字）+XX区县（4位数字）的编码建议借鉴中华人民共和国行政

区划代码（GB/T2260-2007）规范的代码，详见中华人民共和国行政区划代码（GB/T

2260-2007）规范）。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-遥调

信号（A0）_________________________________________________________

7-8：设备类型：详见设备/系统类型编码表一

9:局站类型：详见局站类型编码表

10：预留扩展，暂固定为0

具体可参见《中国铁塔动环监控系统统一信号字典表》中信号量ID的定

义。

h）告警事件描述采用XML文件，XML格式如下：

<TAlarm>

〈SerialNo>告警序号</SerialNo>

<DeviceId>设备ID</Deviceld>

〈DeviceCode〉设备ID〈/DeviceCode>

<AlarmTime>告警时间〈/AlarmTime〉

<FsuId>FSUID</FsuId>

<FsuCode>FSUID</FsuCode>

<Id>监控点ID〈/Id>

<A1armLeve1>告警级别</AlarmLeve1>

<AlarmFlag>告警标志</AlarmFlag>

<AlarmDesc>告警文本</AlannDesc>

</TAlarm>

1）告警序号：以10位数字表示，如0012345678（十进制），不足10位前面

补0,最大不能超过一个无符号长整型所表示的数字，即数字在

0~4294967295之间。同时在FSC内告警序号唯一，告警结束时的告警序

号与告警产生时的告警序号相同。

2）设备ID：参考设备ID编码。

3）时间描述：YYYY-MM-DDVSPACE键〉hh:mm:ss（采用24小时的时间制式）。

4）FSUID：11位字符串表示。

5）监控点ID：参考监控点ID。

6）告警级别：一级/二级/三级/四级。

7）告警标志描述：开始/结束。

8）告警文本：40字节以内的告警内容描述。

例：

<TAlarm>

<SerialNo>0012345678</SerialNo>

<DeviceID>11010110100001</DeviceID>

<DeviceCode>l1010110100001</DeviceCode>

<AlarmTime>2006-09-0412:01:31</AlarmTime>

<FsuId>10024</FsuId>

<FsuCode>1101011010000K/FsuCode>

<Id>0430101001</Id>

。121'0±6丫01>二级〈/人必1'11±6丫61>

（AlarmFlag>开始</AlarmFlag>

<AlarmDesc>欠压告警（46.IV）</AlarmDesc>

</TAlarm>

说明：例中46.IV为告警触发值，其中〈（符〉、<）符〉为半角符号。对于

遥信量告警，告警文本为“告警”、“熔断”等文字。

9）所有文本描述中不能包含"<符"、">符"字符。

i）数据类型的字节数定义

表3数据类型字节数定义

类型字节数

Long4字节

Short2字节

Char1字节

Float4字节

枚举类型4字节

j)FSU向SC注册的信息：

•IPSec/L2Tp拨号参数：FSU向IPSec/L2Tp服务器建立IPSec/L2Tp隧道所

须参数，包括IPSec/L2Tp服务器IP、用户名、密码；

•SCIP：SC前置机或采集机的IP,FSU向其发起注册和工作过程中数据

交互的目的IP。

k)SC、FSU根据下图所示，建立连接:

FSU客户端SC服务端

SetupTCPlink（k4G/3G拨号；

2、IPSec拨号,分配内网IP）

->

注册过程LOGIN返回注册确认

----------------------------

LOGINACK

工作过程Losinsuccess

LOGOUT

>

登出过程返回登出过

--------------程是否成功

LOGOUTACK

BreakoutTCPlink

图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.1FSU向SC注册

客户端向服务端传送用户名、口令、内网IP;服务端向客户端发送注册确认。

同一个FSU两次注册之间的最小时间间隔不小于120秒。

FSU各厂端图4用户注册过程SC服务端

LOGIN

5・2.的各注礴霜警信返回注册确认

LOGIN_ACK

FSU做客户端，SC是服篦麻田斜艮靛皤场喘毅梦有告瞥需上报时，向SC上

报告警信息，SC返回硝认信息：……

LOGOUT

SC登出过程SC服序端FSU客户端上出过程

是否成功

5.2.6.3用户请求监控点数据

客户端向服务端发送所靠部抵।隙褂，服务端向客户湍发送客户要求的监控

-----------------上报告警信息

点的当前状态信息。

SENDALARMACK

接收到告警返

服务端

回SC另户端图6用户请求监控点数据过程FSI

5.2.6.4用户请求监控点历史数据

客户端向服务端2W送所需数相的桶济A服务端向客户箍发送客户要求的时间

段内朋搬艘史状态信息，按轮询周期（1小时），一的仑询周期只取1个点。

FSU返还数据

SC客1^耀7用曲谓宏激播点就史数据过FSU服务端

监控点的设警在HISDATA.

5.2.6.5用户请求写

FSU返还数据

培好请岫臊务端发送监控点的标识ID和新设置值，服务端设置监控点的新设

置值并向客户端返回成功与否。GET_HISDATA_ACK

SC客周瑞用户请求写监控点的设置值过FSU服务端

5.2.6.苦置南蜂SET.POINT

求监空点门限数据

返回设置成功

客户端向服务端为两襦数据1怫快手服务端向客户端发送窿商要求的监控

点的门限数据。

FSU服务端

sc客户端

GETTHRESHOLD

~>

用户请求数据FSU返还数据

----------------------'

GET_THRESHOLD_ACK

图9用户请求监控点门限数据

5.2.6.7用户请求写监控点门限数据

客户端向服务端发送监控点的标识ID和新门限数据，服务端设置监控点的新

门限数据并向客户端返回成功与否。

SC客户图10用户请求写监控点门限数扼FSU服务端

5.2.6.g置用隈取FStrt丽邦史里也

客户端向服务端:安送获取「SU向"汪朋的数据HPS^/瑶鞭泰成股码、

SET_THRESHOLD_ACK

IPSec/L2Tp服务器IP、SCIP、DevicelD列表）的信息，服务端返回注册数据。

SC客户端图1I获取注册数据过程FSU服务端

发起获取要求GET_LOGININFO

5.2.6.9用户设置FS『的注册数据一》返回获取

客户端向服务端:受送设置FED向加注册的数据（IPS右/成财防、密码、

IPSec/L2Tp服务器IP、SCIP）的信息，服务端存储注册数4并返还成功标志。

SC客户端图I?设置注册数据过程FSU服务端

5.2.6.炖［通镰取FSU6明谶据NINFO

客户端向服务端发送获取FTP用户、密码、数据的信息.才克舞端遨圃FTP数据。

<SET_LOGININFO_ACK成功与否

SC客户端图13获取FTP数据过程FSU服务端

发起获取耍求GETFTP

5.2.6.11用户设置F苑的FTP数据一►返回获取

客户端向服务端为：铁设鬟KI砰阴泌c密码数据的信息,7（舞端酶FTP数据并

返还成功标志。

SC客户端图14设置FTP数据过程FSU服务端

发起设置要求SETFTP

5.2.6.12时间同步-------------->返回设置

<SET_FTP_ACK成功与否

客户端向服务端发送标准时间信息，该信息在客户端启动与服务端连接时发

送，也可以进行手动发送，FSU服务端按参数更新时间并返回成功标志。

SC客户端图15时间同步过程FSU服务端

5.2.6.烧曲应赚取FSU1Wl<4E_CHECK

客户端向服务端为:送获取FSU信息的要求，服务端i反I司2I褥勖栈悠参数。

<TIME_CHECK_ACKI成功与否

SC4沪端图16获取FSU信息过程FSU服务端

52L秉启F§L_GET-FSUINFQ________________|

客户端向服务端为:送重启要求，服务端返回成功标志脚昼，々此报文用于

i先幽H牛坍软维h传至UFSU根目

FSU的升级等操作：SC。录，再发此报文使FSU

重启后自动升级）。

SC客户端图I?重启FSU过程FSU服务端

发起重启要求SETJSUREBOOT

5.2.7常量定义------->返回确认

<SETFS徽EB藕

NAMEJ,ENGTH名字命名长度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_LENFSUID字符串长度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枚举定义

表51.枚举定义

属性名称属性描述枚举类型类型定义

INVALID=0无权限

具备数据读的权限，当用户可以读某个

监控系统FSU向

LEVEL1=1数据，而无法写任何数据时返回这一权

EnumRightModeSC提供的权限定

限值。

义

具备数据读、写的权限，当用户对某个

LEVEL2=2

数据具有读写权限时返回这一权限值.

FAILURE=0失败

EnumResult报文返回结果

SUCCESS=1成功

STATION=0局、站

DEVICE=1设备

Dl=2数字输入量（包含多态数字输入量）

监控系统数据的

EnumType模拟输入量

种类AI=3

DO=4数字输出量

AO=5模拟输出量

AREA=9区域

NOALARM=0无告警

CRITICAL=1一级告警

EnumAlarmLevel告警的等级MAJOR=2二级告警

MINOR=3:级告警

HINT=4四级告警

DISABLE=0禁止/不能

EnumEnable使能的属性

ENABLE=1开放/能

ASK_ANSWER=0一问一答方式

实时数据访问的CHANGE_TRIGGER=1改变时自动发送数据方式

EnumAcceSCMode

方式T1ME_TRIGGER=2定时发送数据方式

STOP=3停止发送数据方式

NOALARM=0正常数据

CRITICAL=1一级告警

MAJOR=2二级告警

EnumState数据值的状态

MINOR=3三级告警

HINT=4四级告警

OPEVENT=5操作事件

INVALID=6无效数据

BEGIN汗始

EnumFlag告警标志

END结束

NOALARM=0不做告警上报

CRITICAL=1一级告警上报

告警等级设定的

EnumAlarmModeMAJOR=2二级告警上报

模式

MINOR=3三级告警上报

HINT=4四级告警上报

0特殊机房（自定义）

1A级机房

2B级机房

3C级机房

4D级机房

EnumStationType局站类型

5保留

6保留

7保留

8保留

9保留

ADDNONODES=()新增（无子节点）

ADDINNODES=1新增（含子节点）

对象属性修改类

EnumModifyTypeDELETE=2删除

型

MODIFYNONODES=3修改（仅修改本节点）

MODIFYINNODES=4修改（涉及到子节点）

1高压配电

2低压配电

3交流配电屏

4直流配电屏

5柴油发电机组

6开关电源

7蓄电池组

8UPS设备

9UPS配电屏

10UPS电池

EnumDeviceType设备类型11240V直流系统

12专用空调（风冷）

13中央空调（水冷）

14专用空调（通冷冻水型）

15普通空调

16智能电表（交流）

17门禁系统

18机房/基站环境

19监控设备

20新能源供电系统（太阳能、风能）

21燃气轮机发电机组

22风力发电设备

23智能通风系统

24新风设备

25热交换设备

26热管设备

27蓄电池温控柜

28防雷设备/防雷箱

29燃料电池

30模块化UPS

31240V电池

32铁锂电池

33逆变器

34280V直流远供系统一局端升压

35280V直流远供系统-远端降压

36智能电表（直流）

37铁塔

38智能动环监控设备（FSU）

39-99预留

EnumDeviceCode设备编码见设备编码表见设备编码表

2.设备编码表

设备编码(EnumDeviceCode)

设备/系统类型设备/系统类型

序号A类局站B类局站C类局站D类局站

1高压配电101201301401

2低压配电102202302402

3交流配电屏103203303403

4直流配电屏104204304404

5柴油发电机组105205305405

6开关电源106206306406

7蓄电池组107207307407

8UPS设备108208308408

9UPS配电屏109209309409

10UPS电池110210310410

11240V直流系统111211311411

12专用空调（风冷）112212312412

13中央空调（水冷）113213313413

专用空调（通冷冻水

14114214314414

型）

15普通空调115215315415

16智能电表（交流）116216316416

17门禁系统117217317417

18机房/基站环境118218318118

19监控设备119219319419

新能源供电系统（太阳

20120220320420

能、风能）

21燃气轮机发电机组121221321421

22风力发电设备122222322422

23智能通风系统123223323423

24新风设备124224324424

25热交换设备125225325425

26