中国铁塔动环监控系统 统一互联B接口技术规范
（试行）
版本：V1.0
中国铁塔股份有限公司
2014年12月
中国铁塔动环监控系统统一互联B接口技术规范
目录
1．范围 ........................................................................................................................................ 4 2．规范性引用文件 .................................................................................................................... 4 3．定义 ........................................................................................................................................ 4
3.1集中监控中心－Supervision Center（SC) ................................................................... 4 3.2现场监控单元－Field supervision unit（FSU) ............................................................ 4 3.3通信协议 —Communication Protocol .......................................................................... 4 3.4 B接口—B Interface ...................................................................................................... 5 3.5监控对象—Supervision Object(SO) ............................................................................. 5 3.6监控点—Supervision Point(SP) .................................................................................... 5 3.7数据流接口 .................................................................................................................... 5 4．接口 ........................................................................................................................................ 5 5． B接口互联规范 .................................................................................................................. 6
5.1 B接口互联 .................................................................................................................... 6 5.2 B接口报文协议 ............................................................................................................ 6 6． FTP接口能力 .................................................................................................................... 43 7． FSU初始化能力 ............................................................................................................... 43 8． FSU自动升级能力 ........................................................................................................... 43 9． SC心跳功能 ...................................................................................................................... 44 10．门限值配置 ........................................................................................................................ 44
第2页共46页
中国铁塔动环监控系统统一互联B接口技术规范
前 言
为加强中国铁塔动力环境集中监控系统（以下简称动环监控系统）建设，实现集团监控中心对全国铁塔动力设备和环境的统一监控、统一派单的目标，特制定中国铁塔动环监控系统统一互联B接口技术规范。本规范明确了动环监控系统互联B接口互联规范、B接口定义、互联协议、报文协议及数据库协议。本规范作为动环监控系统的建设标准，同时也可作为接入中国铁塔动环监控系统平台的各动环厂家软、硬件技术设备的技术参考依据。
第3页共46页
中国铁塔动环监控系统统一互联B接口技术规范
1．范围
B接口规定了动环监控系统在监控中心（SC）与现场监控单元（FSU）互联的数据传输规范。
动力监控系统（SC）配置信息、实时数据、历史数据、实时报警、历史报警、控制结果实时数据请求、设备控制请求现场监控单元（FSU）
以上图中右侧单位称为“接出方”，左侧单位称为“接入方”。
2．规范性引用文件
下列文件对本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
YDT1363.2-2014通信局（站）电源、空调及环境集中监控管理系统 第2部分：互联协议
中国铁塔动环监控系统 统一编码及命名规范V1.0 中国铁塔动环监控系统 统一信号字典表V1.0
3．定义
下列术语和定义适用于本文件。
3.1 集中监控中心－Supervision Center（SC)
面向多FSU管理的高级监控层次，即集团监控平台，通过开放的数据协议，连接全国的FSU。
3.2 现场监控单元－Field supervision unit（FSU)
监控系统的最小子系统，由若干监控模块和其它辅助设备组成，面向直接的设备数据采集、处理的监控层次，可以包含采样、数据处理、数据中继等功能。 3.3 通信协议 —Communication Protocol
第4页共46页
中国铁塔动环监控系统统一互联B接口技术规范
规范两个实体之间进行标准通信的应用层的规约。 3.4 B接口—B Interface
为集中监控中心（SC）与现场监控单元（FSU）之间的接口。 3.5 监控对象—Supervision Object(SO)
被监控的各种电源、空调设备及机房环境。 3.6 监控点—Supervision Point(SP)
监控对象上某个特定的监控信号。 3.7 数据流接口
一种基于Soap+XML技术的接口。
4．接口
依据管理功能的不同将整个监控系统划分为几个网络管理层，各个管理层之间存在着相互通信，而且整个监控管理系统存在与综合网管之间的相互通信，这样为保证网络内部不同级别的管理层之间正常通信、监控系统与综合网管的正常通信，将不同管理层之间定义不同的接口，接口定义如图1所示。
集团监控中心B接口B接口B接口智能FSU智能FSU智能FSU
第5页共46页
中国铁塔动环监控系统统一互联B接口技术规范
图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 基本报文格式定义
类型 请求报文 一级节点 Request 二级节点 PK_Type Info PK_Type Info 定义 报文类型 报文内容 报文类型 报文内容 响应报文 Response 第6页共46页
中国铁塔动环监控系统统一互联B接口技术规范
5.2.4 对象模型
在监控中心下的对象模型参考如下：
监控中心区域区域FSUFSU设备设备设备监控点监控点监控点监控点监控点
图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/T 2260-2007)规范的代码，详见中华人民共和国行政区划代码（GB/T 2260-2007)规范）。
XXFSU有5位数字，可以考虑自动生成，生成后不再变动；也可预先编好。同一个区县的局站编码不得重复。
表2 局站类型编码表 局站类型编码 0 1 2 3 4 局站类型 特殊局站（自定义） A级局站 B级局站 C级局站 D级局站 第7页共46页
中国铁塔动环监控系统统一互联B接口技术规范 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/T 2260-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-遥调信号（AO） 7-8：设备类型：详见设备/系统类型编码表 9: 局站类型：详见局站类型编码表 10: 预留扩展，暂固定为0 具体可参见《中国铁塔动环监控系统 统一信号字典表》中信号量ID的定义。
h) 告警事件描述采用XML文件，XML格式如下：
第8页共46页
中国铁塔动环监控系统统一互联B接口技术规范
1) 告警序号：以10位数字表示，如0012345678(十进制)，不足10位前面补0，最大不能超过一个无符号长整型所表示的数字，即数字在0~4294967295之间。同时在FSC内告警序号唯一，告警结束时的告警序号与告警产生时的告警序号相同。 2) 设备ID：参考设备ID编码。
3) 时间描述：YYYY-MM-DD
8) 告警文本：40字节以内的告警内容描述。 例：
说明：例中46.1V为告警触发值，其中<(符>、<)符>为半角符号。对于遥信量告警，告警文本为“告警”、“熔断”等文字。 9) 所有文本描述中不能包含”<符” 、”>符”字符。
第9页共46页
中国铁塔动环监控系统统一互联B接口技术规范
i) 数据类型的字节数定义
表3 数据类型字节数定义
类型 Long Short Char Float 枚举类型 字节数 4字节 2字节 1字节 4字节 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服务端 Setup TCP link（1、4G/3G拨号；2、IPSec拨号，分配内网IP） 注册过程 LOGIN LOGIN_ACK 返回注册确认 工作过程 Login success LOGOUT 登出过程 LOGOUT_ACK 返回登出过程是否成功 Break out TCP link 图3 连接建立过程
WebService接口采用http+soap+xml的方式，工作过程如下：
第10页共46页
中国铁塔动环监控系统统一互联B接口技术规范
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客户端 LOGIN FSU注册过程 LOGIN_ACK 注册成功后，可以进行数据交流 LOGOUT SC登出过程 LOGOUT_ACK 返回登出过程是否成功
图4 用户注册过程
返回注册确认 SC服务端 5.2.6.2 上报告警信息
FSU做客户端，SC是服务端。FSU根据告警门限判断有告警需上报时，向SC上报告警信息，SC返回确认信息。
第11页共46页
中国铁塔动环监控系统统一互联B接口技术规范 SC服务端 FSU客户端 SEND_ALARM SEND_ALARM_ACK 接收到告警返回
上报告警信息
图5 用户请求告警数据过程
5.2.6.3 用户请求监控点数据
客户端向服务端发送所需数据的标识，服务端向客户端发送客户要求的监控点的当前状态信息。
SC客户端
GET_DATA 用户请求数据
GET_DATA_ACK
图6 用户请求监控点数据过程
FSU返还数据
FSU服务端
5.2.6.4 用户请求监控点历史数据
客户端向服务端发送所需数据的标识，服务端向客户端发送客户要求的时间段内的监控点的历史状态信息，按轮询周期（1小时），一个轮询周期只取1个点。
SC客户端
GET_HISDATA 用户请求数据
GET_HISDATA_ACK
图7 用户请求监控点历史数据过程
第12页共46页
FSU服务端
FSU返还数据
中国铁塔动环监控系统统一互联B接口技术规范
5.2.6.5 用户请求写监控点的设置值
客户端向服务端发送监控点的标识ID和新设置值，服务端设置监控点的新设置值并向客户端返回成功与否。
SC客户端 设置数据值
SET_POINT SET_POINT_ACK 返回设置成功与否标记
图8 用户请求写监控点的设置值过程
FSU服务端 5.2.6.6 用户请求监控点门限数据
客户端向服务端发送所需数据的标识，服务端向客户端发送客户要求的监控点的门限数据。
SC客户端
GET_THRESHOLD 用户请求数据
GET_THRESHOLD_ACK
图9 用户请求监控点门限数据
FSU返还数据
FSU服务端
5.2.6.7 用户请求写监控点门限数据
客户端向服务端发送监控点的标识ID和新门限数据，服务端设置监控点的新门限数据并向客户端返回成功与否。
SC客户端 设置门限数据
SET_THRESHOLD SET_THRESHOLD_ACK 返回设置成功与否标记
图10 用户请求写监控点门限数据
FSU服务端 5.2.6.8 用户获取FSU的注册数据
第13页共46页
中国铁塔动环监控系统统一互联B接口技术规范
客户端向服务端发送获取FSU向SC注册的数据（IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SC IP、DeviceID列表）的信息，服务端返回注册数据。
SC客户端 发起获取要求
GET_LOGININFO GET_LOGININFO_ACK 返回获取成功与否 FSU服务端
图11 获取注册数据过程
5.2.6.9 用户设置FSU的注册数据
客户端向服务端发送设置FSU向SC注册的数据（IPSec/L2TP用户、密码、IPSec/L2TP服务器IP、SC IP）的信息，服务端存储注册数据并返还成功标志。
SC客户端 发起设置要求
SET_LOGININFO SET_LOGININFO_ACK 返回设置成功与否 FSU服务端
图12 设置注册数据过程
5.2.6.10 用户获取FSU的FTP数据
客户端向服务端发送获取FTP用户、密码、数据的信息，服务端返回FTP数据。
SC客户端 发起获取要求
GET_FTP GET_FTP _ACK 返回获取成功与否 FSU服务端
图13 获取FTP数据过程
5.2.6.11 用户设置FSU的FTP数据
客户端向服务端发送设置FTP用户、密码数据的信息，服务端存储FTP数据并返还成功标志。
第14页共46页
中国铁塔动环监控系统统一互联B接口技术规范
SC客户端 发起设置要求
SET_FTP SET_FTP _ACK FSU服务端 返回设置成功与否
图14 设置FTP数据过程
5.2.6.12 时间同步
客户端向服务端发送标准时间信息，该信息在客户端启动与服务端连接时发送，也可以进行手动发送，FSU服务端按参数更新时间并返回成功标志。
SC客户端 发起对时要求
TIME_CHECK TIME_CHECK_ACK 返回对时成功与否 FSU服务端
图15 时间同步过程
5.2.6.13 用户获取FSU信息
客户端向服务端发送获取FSU信息的要求，服务端返回当前FSU状态参数。
SC客户端 发起获取要求
GET_FSUINFO GET_FSUINFO_ACK FSU服务端 返回FSU状态参数
图16 获取FSU信息过程
5.2.6.14 用户重启FSU
客户端向服务端发送重启要求，服务端返回成功标志后重启。（此报文用于FSU的升级等操作：SC侧先通过FTP将升级文件上传到FSU根目录，再发此报文使FSU重启后自动升级）。
第15页共46页
中国铁塔动环监控系统统一互联B接口技术规范
SC客户端 发起重启要求
SET_FSUREBOOT FSU服务端 返回确认 SET_FSUREBOOT_ACK
图17 重启FSU过程
5.2.7 常量定义
表4 常量定义 NAME_LENGTH USER_LENGTH PASSWORD_LEN EVENT_LENGTH ALARM_LENGTH LOGIN_LENGTH DES_LENGTH UNIT_LENGTH STATE_LENGTH VER_LENGTH AREACODE_LENGTH STATIONCODE_LENGTH NODECODE_LENGTH EVENT_LENGTH FSUID_LEN FSUCODE_LEN IP_LENGTH MAC_LENGTH IMSI_LENGTH NETWORKTYPE_LENGTH CARRIER_LENGTH NMVENDOR_LENGTH NMTYPE_LENGTH REG_MODE_LENGTH DEVICEID_LEN DEVICECODE_LEN ID_LENGTH SERIALNO_LEN TIME_LEN FSUVENDOR_LENGTH VERSION_LENGTH DICTVERSION_LENGTH 名字命名长度 用户名长度 口令长度 事件信息长度 告警事件信息长度 登录事件信息长度 描述信息长度 数据单位的长度 态值描述长度 版本描述的长度 区域编码长度 机房编码长度 监控信号编码 事件信息长度 FSU ID字符串长度 FSU编码字符串长度 IP串长度 MAC串长度 IMSI卡号 网络制式 运营商 上网模块厂商 上网模块型号 注册模式 设备ID长度 设备编码 监控点ID长度 告警序号长度 时间串长度 FSU厂商 版本串长度 信号字典版本长度 40字节 20字节 20字节 160字节 165字节 100字节 40字节 8字节 160字节 20字节 7字节 12字节 11字节 160字节 14字节 14字节 15字节 15字节 15字节 2字节 2字节 20字节 20字节 2字节 14字节 14字节 10字节 10字节 19字节 20字节 20字节 1字节 第16页共46页
中国铁塔动环监控系统统一互联B接口技术规范
5.2.8 枚举定义
表5 1.枚举定义
属性名称 属性描述 枚举类型 INVALID＝0 监控系统FSU向EnumRightMode SC提供的权限定义 LEVEL2＝2 FAILURE＝0 SUCCESS＝1 STATION＝0 DEVICE＝1 监控系统数据的种类 DI＝2 AI＝3 DO＝4 AO＝5 AREA＝9 NOALARM＝0 CRITICAL＝1 EnumAlarmLevel 告警的等级 MAJOR＝2 MINOR＝3 HINT＝4 EnumEnable 使能的属性 DISABLE＝0 ENABLE＝1 ASK_ANSWER＝0 EnumAcceSCMode 实时数据访问的方式 CHANGE_TRIGGER＝1 TIME_TRIGGER＝2 STOP＝3 NOALARM＝0 CRITICAL＝1 MAJOR＝2 EnumState 数据值的状态 MINOR＝3 HINT＝4 OPEVENT＝5 INVALID＝6 EnumFlag 告警标志 BEGIN END NOALARM＝0 EnumAlarmMode 告警等级设定的模式 CRITICAL＝1 MAJOR＝2 MINOR＝3 HINT＝4 EnumStationType 局站类型 0 第17页共46页 LEVEL1＝1 无权限 具备数据读的权限,当用户可以读某个数据，而无法写任何数据时返回这一权限值。 具备数据读、写的权限，当用户对某个数据具有读写权限时返回这一权限值。 失败 成功 局、站 设备 数字输入量（包含多态数字输入量） 模拟输入量 数字输出量 模拟输出量 区域 无告警 一级告警 二级告警 三级告警 四级告警 禁止/不能 开放/能 一问一答方式 改变时自动发送数据方式 定时发送数据方式 停止发送数据方式 正常数据 一级告警 二级告警 三级告警 四级告警 操作事件 无效数据 开始 结束 不做告警上报 一级告警上报 二级告警上报 三级告警上报 四级告警上报 特殊机房（自定义） 类型定义 EnumResult 报文返回结果 EnumType 中国铁塔动环监控系统统一互联B接口技术规范 1 2 3 4 5 6 7 8 9 ADDNONODES=0 EnumModifyType 对象属性修改类型 ADDINNODES=1 DELETE=2 MODIFYNONODES=3 MODIFYINNODES=4 1 2 3 4 5 6 7 8 9 10 11 12 13 14 EnumDeviceType 设备类型 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 第18页共46页
A级机房 B级机房 C级机房 D级机房 保留 保留 保留 保留 保留 新增（无子节点） 新增（含子节点） 删除 修改（仅修改本节点） 修改（涉及到子节点） 高压配电 低压配电 交流配电屏 直流配电屏 柴油发电机组 开关电源 蓄电池组 UPS设备 UPS配电屏 UPS电池 240V直流系统 专用空调(风冷) 中央空调(水冷) 专用空调（通冷冻水型） 普通空调 智能电表（交流） 门禁系统 机房/基站环境 监控设备 新能源供电系统（太阳能、风能） 燃气轮机发电机组 风力发电设备 智能通风系统 新风设备 热交换设备 热管设备 蓄电池温控柜 防雷设备/防雷箱 燃料电池 模块化UPS 中国铁塔动环监控系统统一互联B接口技术规范 31 32 33 34 35 36 37 38 39~99 EnumDeviceCode 设备编码 见设备编码表 240V电池 铁锂电池 逆变器 280V直流远供系统-局端升压 280V直流远供系统-远端降压 智能电表（直流） 铁塔 智能动环监控设备（FSU） 预留 见设备编码表
2.设备编码表 设备/系统类型设备/系统类型 序号 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 高压配电 低压配电 交流配电屏 直流配电屏 柴油发电机组 开关电源 蓄电池组 UPS设备 UPS配电屏 UPS电池 240V直流系统 专用空调(风冷) 中央空调(水冷) 专用空调（通冷冻水型） 普通空调 智能电表（交流） 门禁系统 机房/基站环境 监控设备 新能源供电系统（太阳能、风能） 燃气轮机发电机组 风力发电设备 智能通风系统 新风设备 热交换设备 热管设备 设备编码（EnumDeviceCode） A类局站 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 第19页共46页
B类局站 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 C类局站 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 D类局站 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 中国铁塔动环监控系统统一互联B接口技术规范 27 28 29 30 31 32 33 34 35 36 37 38 39~98 99 蓄电池温控柜 防雷设备/防雷箱 燃料电池 模块化UPS 240V电池 铁锂电池 逆变器 280V直流远供系统-局端升压 280V直流远供系统-远端降压 智能电表（直流） 铁塔 智能动环监控设备（FSU） 预留 非智能门禁 127 128 129 130 131 132 133 134 135 136 137 138 199 227 228 229 230 231 232 233 234 235 236 237 238 299 327 328 329 330 331 332 333 334 335 336 337 338 399 427 428 429 430 431 432 433 434 435 436 437 438 499 5.2.9 数据结构定义
表6 数据结构定义
结构名称 TTime 结构描述 时间的结构 属性名称 Years Month Day Hour Minute Second TSemaphore 信号量的值的结构 Type ID MeasuredVal SetupVal Status RecordTime short char char char char char EnumType char[ID_LENGTH] float float EnumState char [DES_LENGTH] 属性类型 年 月 日 时 分 秒 数据类型 监控点ID 实测值 设置值 状态 记录时间，YYYY-MM-DD
数据类型 监控点ID 门限值 绝对阀值 百分比阀值 状态 告警序号 类型定义 中国铁塔动环监控系统统一互联B接口技术规范 结构名称 结构描述 的结构 ID FSUID FsuCode DeviceID DeviceCode AlarmTime 属性名称 属性类型 char[ID_LENGTH] char[FSUID_LEN] char[FSUCODE_LEN] char[DEVICEID_LEN] char[DEVICEICODE_LEN] char [DES_LENGTH] 告警时间，YYYY-MM-DD
5.2.11 数据流格式定义
5.2.11.1 FSU向SC注册
动作：注册 发起：客户端
表8 FSU向SC注册请求报文 发起 客户端 第22页共46页
中国铁塔动环监控系统统一互联B接口技术规范 字段 PK_Type 上网模块型号Info 变量名称/报文定义 LOGIN UserName PaSCword FsuId FsuCode FsuIP MacId ImsiId NetworkType Carrier NMVendor NMType Reg_Mode 长度及类型 Sizeof(long) USER_LENGTH PASSWORD_LEN char[FSUID_LEN] char[FSUID_LEN] IP_LENGTH MAC_LENGTH IMSI_LENGTH NETWORK_TYPE_LENGTH CARRIER_LENGTH NMVENDOR_LENGTH NMTYPE_LENGTH REG_MODE_LENGTH 上网模块型号 注册模式（枚举值，1：原有注册模块，2：新的注册械），可为空，为空表示采用原有的注册模式，参考注册模式 FSUVendor Version DictVersion FSUVENDOR_LENGTH VERSION_LENGTH DICTVERSION_LENGTH FSU的软件版本 信号量字典版本（枚举值，1：标准版，适用3/4G信号的基站；2：精减版，适用2G信号的基站） FSU的厂家名称 运营商名称(枚举值，CT：电信，CM：移动，CU：联通) 上网模块厂商名称 登录命令 用户名 口令 FS ID号，资源系统的ID FSU编码 FSU的内网IP 无线模块的MAC地址（唯一标识） IMSI卡号 网络制式（2G、3G、4G） 描述 DeviceList n*DEVICEID_LEN DeviceID列表 XML样例
101
第23页共46页
中国铁塔动环监控系统统一互联B接口技术规范
响应：服务端
表9 FSU向SC注册请求应答报文 PK_Type Info 变量名称/报文定义 LOGIN_ACK RightLevel SCIP 长度及类型 Sizeof(long) EnumRightMode IP_LENGTH 登录命令相应 发回权限设置 返回采集机IP 描述 XML样例
102
动作：登出 发起：客户端
表10 FSU向SC登出请求报文
PK_Type Info 变量名称/报文定义 LOGOUT FsuId 长度及类型 Sizeof(long) char[FSUID_LEN] 登出命令 FSU ID号，资源系统的ID 描述 XML样例
103
第24页共46页
中国铁塔动环监控系统统一互联B接口技术规范
响应：服务端
表11 FSU向SC登出请求应答报文
PK_Type Info 变量名称/报文定义 LOGOUT_ACK Result 长度及类型 Sizeof(long) EnumResult 登出命令回应 登出成功/失败 描述 XML样例
104
5.2.11.2 上报告警信息
发起：客户端
表12 上报告警信息报文
PK_Type 变量名称/报文定义 SEND_ALARM Values 长度及类型 Sizeof(long) TAlarm 告警上报 告警信息 描述 XML样例
501
第25页共46页
中国铁塔动环监控系统统一互联B接口技术规范
表13 上报告警信息应答报文
PK_Type 变量名称/报文定义 SEND_ALARM_ACK Result 长度及类型 Sizeof(long) EnumResult 告警信息 返回设置结果 描述
XML样例
502
5.2.11.3 用户请求监控点数据
发起：客户端
表14 用户请求监控点数据报文
PK_Type Info 变量名称/报文定义 GET_DATA FsuId FsuCode Device ID 长度及类型 Sizeof(long) char[FSUCODE_LEN] char[FSUCODE_LEN] char[DEVICEID_LEN] 描述 用户请求监控点数据 FSU ID号，资源系统的ID FSU编码 资源系统的设备ID 第26页共46页
中国铁塔动环监控系统统一互联B接口技术规范 Code char[DEVICECODE_LEN] 设备编码。当为全9时（即“99999999999999”），则返回该FSU所监控的所有设备的监控点的值；这种情况下，忽略IDs参数（即监控点ID列表）。 IDs n*ID_LENGTH 相应的监控点ID号。当为全9时（即“9999999999”），则返回该设备的所有监控点的值。 XML样例
401
响应：服务端 表15 用户请求监控点数据应答报文 PK_Type Info 变量名称/报文定义 GET_DATA_ACK FsuId FsuCode Result Values 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] EnumResult Sizeof(TSemaphore) 请求数据成功与否的标志 对应5.2.8中的TSemaphore的数据结构定义 描述 用户请求监控点数据响应 FSU ID号，资源系统的ID FSU编码 XML样例 第27页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.4 用户请求监控点历史数据 发起：客户端 表16 用户请求监控点数据报文 PK_Type Info 变量名称/报文定义 GET_HISDATA FsuId FsuCode StartTime EndTime Device ID CODE 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] char[TIME_LEN] char[TIME_LEN] char[DEVICEID_LEN] char[DEVICECODE_LEN] 描述 用户请求监控点数据 FSU ID号，资源系统的ID FSU编码 开始时间 结束时间 资源系统的ID 设备ID。当为全9时（即“99999999999999”），则返回该FSU所监控的所有设备的监控点的值；这种情况下，忽略IDs参数（即监控点ID列表）。 IDs n*ID_LENGTH 相应的监控点ID号。当为全9时（即“9999999999”），则返回该设备的所有监控点的值。 XML样例 第28页共46页 中国铁塔动环监控系统统一互联B接口技术规范 响应：服务端 表17 用户请求监控点数据应答报文 PK_Type Info 变量名称/报文定义 GET_HISDATA_ACK FsuId FsuCode Result Values 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] EnumResult Sizeof(TSemaphore) 请求数据成功与否的标志 对应5.2.8中的TSemaphore的数据结构定义 描述 用户请求监控点数据响应 FSU ID号，资源系统的ID FSU编码 XML样例 第29页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.5 用户请求写监控点的设置值 发起：客户端 表18 用户请求写监控点的设置值报文 PK_Type Info 变量名称/报文定义 SET_POINT FsuId FsuCode n*Device m*Value m*Sizeof(TSemaphore) 长度及类型 Sizeof(long) char[FSUID_LEN] char[FsuCode_LEN] n*char[DEVICECODE_LEN] m个监控点的设置值，数据的值的类型由相应的数据结构决定 描述 用户请求写监控点的设置值 FSU ID号，资源系统的ID FSU编码 n个设备的列表 XML样例 第30页共46页 中国铁塔动环监控系统统一互联B接口技术规范 响应：服务端 表19 用户请求写监控点的设置值应答报文 PK_Type Info 变量名称/报文定义 SET_POINT_ACK FsuId FsuCode n*Device m*Id t*Id Result 长度及类型 Sizeof(long) char[FSUID_LEN] char[FsuCode_LEN] n*char[DEVICECODE_LEN] m*Sizeof(long) t*Sizeof(long) EnumResult m个控制或调节成功的ID的列表 t个控制或调节失败的ID的列表 写成功/失败（即控制的结果） 描述 用户请求写监控点的设置值回应 FSU ID号，资源系统的ID FSU编码 n个设备的列表 XML样例 第31页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.6 用户请求监控点门限数据 发起：客户端 表20 用户请求监控点门限数据报文 PK_Type Info 变量名称/报文定义 GET_THRESHOLD FsuId FsuCode Device ID Code 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] char[DEVICEID_LEN] char[DEVICECODE_LEN] 描述 用户请求监控点门限数据 FSU ID号，资源系统的ID FSU编码 资源系统的ID 设备ID。当为全9时（即“99999999999999”），则返回该FSU所监控的所有设备的监控点门限数据，这种情况下，忽略IDs参数（即监控点ID列表）。 IDs n*ID_LENGTH 相应的监控点ID号。当为全9时（即“9999999999”），则返回该设备的所有监控点的门限数据。 XML样例 第32页共46页 中国铁塔动环监控系统统一互联B接口技术规范 响应：服务端 表21 用户请求监控点门限数据应答报文 PK_Type Info 变量名称/报文定义 GET_THRESHOLD_ACK FsuId FsuCode Result Values 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] EnumResult Sizeof(TThreshold) 请求数据成功与否的标志 对应5.2.8中的TThreshold的数据结构定义 描述 用户请求监控点门限数据响应 FSU ID号，资源系统的ID FSU编码 XML样例 Status=\Status=\ Status=\Status=\ 5.2.11.7 用户请求写监控点门限数据 发起：客户端 表22 用户请求写监控点门限数据报文 第33页共46页 中国铁塔动环监控系统统一互联B接口技术规范 PK_Type Info 变量名称/报文定义 SET_THRESHOLD FsuId FsuCode n*Device m*Value 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] n*char[DEVICEID_LEN] m*Sizeof(TThreshold) 求 FSU ID号，资源系统的ID FSU编码 n个设备的列表 m个监控点门限值，数据的值的类型由相应的数据结构决定 描述 用户请求写监控点门限数据请XML样例 Status=\Status=\ Status=\Status=\ 响应：服务端 表23 用户请求写监控点门限数据应答报文 PK_Type Info 变量名称/报文定义 SET_THRESHOLD_ACK FsuId FsuCode n*Device 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] n*char[DEVICEID_LEN] 第34页共46页 应 FSU ID号，资源系统的ID FSU编码 n个设备ID的列表 描述 用户请求写监控点门限数据请求回中国铁塔动环监控系统统一互联B接口技术规范 m*Id t*Id Result m*Sizeof(long) t*Sizeof(long) EnumResult m个写成功的ID的列表 t个写失败的ID的列表 写成功/失败（即控制的结果） XML样例 5.2.11.8 用户获取FSU的注册信息 发起：客户端 表24 用户获取注册信息报文 PK_Type Info 变量名称/报文定义 GET_LOGININFO FsuId FsuCode 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] 第35页共46页 获取注册信息 FSU ID号，资源系统的ID FSU编码 描述 中国铁塔动环监控系统统一互联B接口技术规范 XML样例 响应：服务端 表25 用户获取注册信息响应报文 PK_Type Info 变量名称/报文定义 GET_LOGININFO_ACK FsuId FsuCode IPSecUser IPSecPWD IPSecIP SCIP Device Result 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] USER_LENGTH PASSWORD_LEN IP_LENGTH IP_LENGTH n*DEVICEID_LEN EnumResult IPSec用户名 IPSec密码 IPSec服务器IP SC IP DeviceID列表 成功/失败 描述 获注册信息响应 FSU ID号，资源系统的ID FSU编码 XML样例 第36页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.9 用户设置FSU的注册信息 发起：客户端 表26 用户设置注册信息报文 PK_Type Info 变量名称/报文定义 SET_ LOGININFO FsuId FsuCode IPSecUser IPSecPWD IPSecIP SCIP Device 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] USER_LENGTH PASSWORD_LEN IP_LENGTH IP_LENGTH n*DEVICEID_LEN IPSec用户名 IPSec密码 IPSec服务器IP SC IP DeviceID列表 设置注册信息 FSU ID号，资源系统的ID FSU编码 描述 XML样例 响应：服务端 表27 用户设置注册信息响应报文 PK_Type Info 变量名称/报文定义 SET_ LOGININFO_ACK FsuId FsuCode Result 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] EnumResult 描述 设置注册信息响应 FSU ID号，资源系统的ID FSU编码 设置成功/失败 XML样例 第37页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.10 用户获取FSU的FTP用户、密码 发起：客户端 表28 用户获取FTP用户、密码报文 PK_Type Info 变量名称/报文定义 GET_FTP FsuId FsuCode 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] 描述 获取FTP用户、密码 FSU ID号，资源系统的ID FSU编码 XML样例 响应：服务端 表29 用户获取FTP用户、密码响应报文 PK_Type Info 变量名称/报文定义 GET_FTP_ACK FsuId FsuCode UserName Password Result 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] USER_LENGTH PASSWORD_LEN EnumResult 用户登录名 密码 成功/失败 描述 获取FTP用户、密码响应 FSU ID号，资源系统的ID FSU编码 XML样例 第38页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.11 用户设置FSU的FTP用户、密码 发起：客户端 表30 用户设置FTP用户、密码报文 PK_Type Info 变量名称/报文定义 SET_FTP FsuId FsuCode UserName Password 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] USER_LENGTH PASSWORD_LEN 用户登录名 密码 描述 设置FTP用户、密码 FSU ID号，资源系统的ID FSU编码 XML样例 响应：服务端 表31 用户设置FTP用户、密码响应报文 PK_Type Info 变量名称/报文定义 SET_FTP_ACK FsuId FsuCode Result 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] EnumResult 描述 设置FTP用户、密码响应 FSU ID号，资源系统的ID FSU编码 设置成功/失败 XML样例 第39页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.12 时间同步 发起：客户端 表32 时间同步报文 PK_Type Info 变量名称/报文定义 TIME_CHECK Time 长度及类型 Sizeof(long) Sizeof(TTime) 时间同步报文 本机时间 描述 XML样例 响应：服务端 表33 时间同步应答报文 PK_Type Info 变量名称/报文定义 TIME_CHECK_ACK Result 长度及类型 Sizeof(long) EnumResult 时间同步回应 同步成功/失败 描述 XML样例 第40页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.13 用户获取FSU的状态信息 发起：客户端 表34 用户获取FSU状态信息报文 PK_Type Info 变量名称/报文定义 GET_FSUINFO FsuId FsuCode 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] 描述 获取FSU状态信息 FSU ID号，资源系统的ID 编码 XML样例 响应：服务端 表35 用户获取FSU状态信息响应报文 PK_Type Info 变量名称/报文定义 GET_FSUINFO_ACK FSUID FsuCode TFSUStatus Result 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] Sizeof（TFSUStatus） FSU状态 EnumResult 成功/失败 描述 获取FSU状态信息响应 FSU ID号，资源系统的ID 编码 XML样例 第41页共46页 中国铁塔动环监控系统统一互联B接口技术规范 5.2.11.14 用户重启FSU 发起：客户端 表36 用户重启FSU报文 PK_Type Info 变量名称/报文定义 SET_FSUREBOOT FSUID FsuCode 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] 描述 重启FSU信息 FSU ID号，资源系统的ID 编码 XML样例 响应：服务端 表37 用户重启FSU响应报文 PK_Type Info 变量名称/报文定义 SET_FSUREBOOT_ACK FsuId FsuCode Result 长度及类型 Sizeof(long) char[FSUID_LEN] char[FSUCODE_LEN] EnumResult 成功/失败 描述 重启FSU信息响应 FSU ID号，资源系统的ID FSU编码 XML样例 第42页共46页 中国铁塔动环监控系统统一互联B接口技术规范 6．FTP接口能力 FSU应提供FTP接口，通过FSU提供的FTP服务，SC定期登录后取回FSU存储的视频监控图像文件。 FSU做服务端，SC是客户端。 FSU存储的视频监控图像文件格式应为JPG、PNG之一，每个图片文件的大小不应超过200k。 图片文件的命名规则：FSUID_YYYYMMDD_hhmmss_XX.jpg（或png），YYYYMMDD为四位年、两位月、两位日，例如20140918；hhmmss为两位小时、两位分钟、两位秒，例如140523，“XX“为序号，当一秒内生成多张图像时，按顺序从01开始增1递增，如01、02、03等。 FSU应在根目录建立一级子目录\\PIC\\，用以存放视频监控图像文件，并将此子目录设置为FTP默认的用户目录，SC登录FTP后从此目录获取图像文件。FSU自行维护\\PIC\\目录下的文件数目和磁盘空间，当达到存储上限时，建议采用新文件覆盖最早文件的方式进行滚动更新。 7．FSU初始化能力 出厂初始化：FSU在出厂时应内置初始化文件并已进行初始化。 安装后初始化：FSU应提供USB接口和驱动，电脑可通过USB接口向FSU传输初始化配置文件，由FSU读取配置文件并完成FSU的初始化。 初始化文件采用以半角逗号（“,”）分割的cvs文件格式，命名为“init_list.cvs”。 FSU应提供初始化手段，如初始化按键，按了初始化按键后，自动搜寻init_list.cvs文件并解析文件内容进行参量初始化。 8．FSU自动升级能力 FSU应具有自动升级能力，当通过FTP或USB接口向FSU上传升级文件后，重启FSU能自动完成升级。 第43页共46页 中国铁塔动环监控系统统一互联B接口技术规范 9．SC心跳功能 SC需要通过Webservice定期获取FSU的状态信息，以便作为应用层的心跳线使用，FSU收到SC的心跳报文要对FSUID进行判断，若SC平台下发的心跳包报文的FSUID与FSU本身的ID一致则返回成功结果，否则返回失败结果。 10．门限值配置 门限值配置，参考中国铁塔动环监控系统 统一信号字典表 11．告警回差 基于告警门限值只是一个临界点，为了提高可用性，增加了一个波动回差值，以告警门限值为基准，设定上下可波动的幅度，将临界点转换为一个临界区间，此区间范围内的跳变不影响系统告警的判断。具体参考中国铁塔动环监控系统统一信号字典表中的回差参数。 12．告警延时和告警恢复延时 12.1 告警延时 当实测值超过告警门限值时，为防止由于传感器采集精度引起的数值在门限值附近跳变以及通信故障导致频繁的告警产生及恢复，FSU并不马上上报告警，而是延迟一段时间再上报。在延时的这段时间内告警若能自行恢复，则不再上报。原则上一级告警时延设置为60秒，二级告警时延设置为120秒，三级告警时延设置为180秒，四级告警时延设置为240秒，告警恢复延时统一调整为20秒。设置回差的告警因已考虑波动范围，不需要设置时延；门禁告警由于需要实时告警因此未设置延时。具体参考中国铁塔动环监控系统统一信号字典表的时延参数 12.2 告警恢复延时 当实测值恢复正常时，为防止由于传感器采集精度引起的数值在门限值附近跳变导致频繁的告警产生及恢复，FSU并不马上撤销告警，而是过一段时间再发送 第44页共46页 中国铁塔动环监控系统统一互联B接口技术规范 告警恢复信号，也可以防止遥测量短时间频繁跳变。告警恢复延时统一调整为20秒。具体参考中国铁塔动环监控系统统一信号字典表的告警恢复时延参数。 13．注册模式 13.1 原有注册模式 原有注册模式是FSU向SC平台的注册发起注册指令（指令代码101），SC平台向FSU返回成功信息（指令代码102）后再通过设置FSU注册信息指令（指令代码1503）向FSU下发采集机信息，FSU返回成功信息（指令代码1504），原有的注册模式中FSU与SC平台的通信分为两次交互过程，FSU与SC的注册流程示意图如下： 动环监控设备(FSU)SC平台注册机SC平台采集机1、FSU向平台发起注册指令（101）2、SC平台向FSU返回注册成功（102）3、由SC平台注册机统一分配采集机4、通知采集机，向采集机下发FSU的注册信息5、返回通知成功6、向FSU下发设置注册信息指令（1503）7、FSU返回成功（1504） 13.2 新的注册模式 原有注册模式是FSU向SC平台的注册发起注册指令（指令代码101），SC平台向FSU返回成功信息（指令代码102）同时将分配的采集机IP反馈给FSU，新的注册模式只有一次交互过程，FSU与SC的注册流程示意图如下： 第45页共46页 中国铁塔动环监控系统统一互联B接口技术规范 动环监控设备(FSU)SC平台注册机SC平台采集机1、FSU向平台发起注册指令（101）2、由SC平台注册机统一分配采集机3、通知采集机，向采集机下发FSU的注册信息4、返回通知成功5、SC平台向FSU返回注册成功信息（102）第46页共46页 402 403 404 1001 1002 1901 1902 2001 2002 1501 1502 1503 1504 1601 1602 1603 1604 1301 1302 1701 1702 1801 1802