DB34T 4662-2024广播电视发射台运维监管平台数据接口规范

34SpecificationsofdatainterfaceforradioandtelevisiontransmittingstationoperatiandmaintenanceregulatoI III 7.1通用类型编码 8.2错误码定义 C.5正在告警（未解除）信息应答消息示例 D.3控制指令执行过程与结果主动上报示例 E.1设备运行图配置下发请求示例 E.2设备运行图配置请求回复示例 E.3设备告警配置下发请求示例 E.4配置请求回复示例 II F.1设备控制指令下发请求示例 F.2控制指令下发回复示例 III请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件主要起草单位：安徽省广播电视科研所、安徽1广播电视发射台运维监管平台数据接口规范中心监管平台centersupervision分管平台sub-centersupervisionandmanagem受中心监管平台统一管理，并提供数据服务与指令转发服），2按节目播出时间顺序排列，规定发射机在一天中所承担的播出4缩略语5系统架构及总体要求对请求方或应答方应具有一致的数据表达、数据组织以及传输方5.2中心监管平台与分管平台之间、分管平台与台站数据网关之间以及中心监管平台与台站数据网关3中心监管平台智慧台站智慧台站智慧台站铁塔安全监测系统天馈监测系统安防监测系统信号空收监测系统节传链路监测系统动力环境监测系统发射机监控系统铁塔安全监测系统天馈监测系统安防监测系统信号空收监测系统节传链路监测系统动力环境监测系统发射机监控系统铁塔安全监测系统天馈监测系统安防监测系统信号空收监测系统节传链路监测系统动力环境监测系统发射机监控系统注1:中心监管平台数据接口层：由中心监管平台与数据通讯接口层(JSONoverHTTPS)组成，即中心监管平台需建立符合本文件的通讯组件，完成与下级平台的标准化信息交互。注2:分管平台数据接口层：由分管平台与数据通讯接口层(JSONoverHTTPS)组成，即要求分管平台需建立符合本文件的通讯组件，完成与上下级平台的标准化信息交互。注3:智慧台站数据接口层：由台站数据网关(SDSG)、数据通讯接口层(JSONoverHTTPS)以及台站监控系统组成，要求台站数据网关需建立符合本文件的通讯组件，完成与上级平台的标准化信息交互，同时需对接、适配智慧台站各监控子系统通讯协议规范(协议缺乏统一性)并与本文件建立数据映射关系。6.1.1HTTPS协议本身是无状态连接协议，通讯双方应采用“请求一应答”模式进行信息交互，请求应答应采用POST方法发送，应答方接收到请求后应立刻响应接收状态，待指令执行或数据组织完毕后 Request(请求):Content-Type:application/json;chaUser-Token:8a5da52ed126447d359e70c05721a84...（请求正文）...（响应正文）表1请求/应答字段说明请求/应答6.3.2中心监管平台或分管平台在下发控制指令、获取配置信息、修改配置参数时应进行身份验证与6.3.3请求方首次请求应向应答方申请有效令牌并保存，在后续数据请求中应将令牌字符串填充到），效令牌。5DB34/T4662—20246.3.4请求方应采用SM3算法对消息体及其他关键信息加密生成一串签名特征码(生成规则涉及数据安全，本文件不做具体说明)与当前时间戳分别填充到HTTPS消息报文的“User-Sign”和“User-TimeStamp”字段，应答方通过双方约定的生成规则进行签名校验，若验证失败应通过HTTPS响应方式返回错误码“403Forbidden”Request(数据请求)Request(白名单验证失败)Response(发放新令牌或返回已有令牌)+令牌)(白名单验证失败)+令牌)Response(令牌失效或非法)+令牌)Response(SM3签名校验失Response(返回数据结果)6XX0000平台角色缩写平台实体编码应用场景中涉及的设备应进行统一定义和编码，用以唯一标识设备实34001110001000000省份代码设备属地编码设备类型编码设备序号编码7取安徽省行政区划代码前两个字符（参属地类别[0-9]：依据定义应用场景中涉及的设备所属类型应进行统一定义和编码，规定设备类型编码由主类与子类两10001主类子类89应通过规定模块编码、模块类型与模块子号来对设备运行指标的语与发射机整机的相同指标，且仍需保留发射机与功放的隶属关系故引入“模块”概0123456789应用场景内的设备状态及运行指标类型应进行统一编码，状态量使用byte格式，模拟量使用float平台信息查询类型编码与定义见表6。Security_BaseExisting_Alarm中心监管平台或分管平台下运行图、告警配置消息的编码与定义见表8。{"version":"1.0","receiver":"DG0000","type":"xx_Msg","rpl_id":"1000","url":"https://x.x.x.x:yyyy/","msg_type":"tttt","err_code":0,"data":[]}}version发送端识别码：参见7.1.1receiver接收端识别码：参见7.1.1rpl_id“-1”url应答方回复数据的目标地址：标准url,以‘/’结尾，无参，由数据请例：“3:8000/cp/”“”“”错误类型进行编码，参见8.2。0[]0123url格式错误456789 分管平台（Response）中心监管平台（Request分管平台（Response）中心监管平台（Request）台站数据网关（Response）中心监管平台中心监管平台version是是见7.1.1receiver是见7.1.1是是rpl_id是是url是应答方回复数据的目标地址：标准url,以例：“3:8000/cp/”是“Devices_Base”参见7.2.1“Transmitter_Base”参见7.2.1参见7.2.1参见7.2.1“Link_Base”参见7.2.1“Security_Base”参见7.2.1参见7.2.1参见7.2.1参见7.2.1参见7.2.1“Existing_Alarm”参见7.2.1“Other_Base”参见7.2.1是“”表13查询应答Response消息version是是见7.1.1receiver是见7.1.1是是rpl_id是是url是“”是“Devices_Base”参见7.2.1“Transmitter_Base”参见7.2.1参见7.2.1参见7.2.1“Link_Base”参见7.2.1“Security_Base”参见7.2.1参见7.2.1参见7.2.1“Other_Base”参见7.2.1是obj_id是见7.1.2是见是是channel_info是为1时默认：[]是是否默认：-1否否否是是是是install_date是是默认：[]是是是transmitter_type是是是link_type是Security_security_type是否外形结构：自立式、拉线式、塔楼否塔高，单位“米”design_life否否否授时类型:“0”:未定义否version是是见7.1.1receiver是见7.1.1是是rpl_id是“msg_id”是url是“”是参见7.2.1是是obj_list是是是是0:按周，1:按月，2:按天是是是start_time是是是运行图设置项自动失效，待deadline是是schedule_ctl是0:按周，1:按月，2:按天是是是是是参见7.2.4是运行图设置项自动失效，待deadline是是version是是见7.1.1receiver是见7.1.1是是rpl_id是“msg_id”是url是“”是参见7.2.1是是obj_id是见7.1.2是见7.1.5是见7.1.3是limit_type是limit_value是是是是正在告警（未解除）信息应答消息version是是7.1.1receiver是7.1.1是是rpl_id是是url是“”是“Existing_Alarm”参见7.2.1是是object_id是是是alarm_id是是见7.1.4是见7.1.3是value是是是见7.1.5是HTTPS应答HTTPS应答分管平台分管平台（Response）HTTPS应答HTTPS应答台站数据网关（Request）version是是参见7.1.1receiver是参见7.1.1是是rpl_id是是url是“”是参见7.2.2是参见8.2是obj_id是是设备通道标识[0～99]是value_list(监测值数组)是参见7.1.4是参见7.1.3是value是value_unit否version是是7.1.1receiver是7.1.1是是rpl_id是是url是“”是参见7.2.2是参见8.2是控制指令执行过程与结果主动上报version是是见7.1.1receiver是见7.1.1是是rpl_id是是本次消息生成时间.url是“”是参见7.2.2是参见8.2是obj_id是是设备通道标识[0～99]是参见7.2.4role是是是execute_result是是version是是见7.1.1receiver是见7.1.1是是rpl_id是是本次消息生成时间.url是“”是参见7.2.1是错误码：对查询和上报消息的结果发生参见8.2是obj_list是对象（设备）唯一标识集合，所含对象（设备）具是是（Response）（Response）（Request）（Response）（Request）（Response）（Request）version是是7.1.1receiver是7.1.1是是rpl_id是是url是“3:8000/cp/”是参见7.2.3是参见8.2是version是是参见7.1.1receiver是参见7.1.1是是rpl_id是“msg_id”是url是“”是参见7.2.3是错误码：对查询和上报消息的结果发生的错参见8.2是obj_list是是设备通道标识[0～99]result是result_desc是version是是参见7.1.1receiver是参见7.1.1是是rpl_id是是url是应答方回复数据的目标地址：标准url,以‘/’结尾，无参，由数据请求方填充。例：“3:8000/cp/”是参见7.2.3是错误码：对查询和上报消息的结果发生的错误参见8.2是录E。version是是见7.1.1receiver是见7.1.1是是rpl_id是“msg_id”是url是“”是参见7.2.3是错误码：对查询和上报消息的结果发生参见8.2是obj_list是对象（设备）唯一标识集合，所含对象（设result是result_desc是HTTPS应答分管平台（Response）HTTPS应答分管平台（Response）中心监管平台（Request）HTTPS应答台站数据网关（Response）HTTPS应答台站数据网关（Response）中心监管平台（Request）HTTPS应答台站数据网关（Response）HTTPS应答台站数据网关（Response）分管平台（Request）version是是见7.1.1receiver是见7.1.1是是rpl_id是是url是应答方回复数据的目标地址：标准url,以‘/’例：“3:8000/cp/”是参见7.2.4是错误码：对查询和上报消息的结果发生的错误类参见8.2object_list是是设备通道标识[0～99]是set_value是否否否set_value可忽略，默认：0可忽略，默认：0功率步进值，无则忽略可忽略，默认：0功率步进值，无则忽略可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0可忽略，默认：0“20”,单位：℃可忽略，默认：0可忽略，默认：0.4控制指令下发回复消息内容应对控制指令接收状态与执行条件状态进行回复，不代表控制执行结果返馈，控制指令执行过程和结果见。通用属version是是receiver是见7.1.1是是rpl_id是“msg_id”是url是“”是参见7.2.4是错误码：对查询和上报消息的结果发生的参见8.2是object_list是对象（设备）唯一标识集合，所含对象（设备）具有是result是result_desc是设备范围所有设模块类型所有模AVW℃发射机相关指标设备范围：(模块类型整机、AVW℃WWW%VVVVVVVVVVVVVV机动力设备相关指标模块类型整机、市电、输入、输出、输出、备电源输入、备电源输出、系统、AVW℃VAVA同A相VA同A相V VV同A相同A相%%%%%%%%VA℃℃%r/S转/秒模块类型整机、℃度3333氨33333333节传链路相关指标模块类型整机、AVW℃%式%%模块类型整机、AVW℃铁塔及天馈相关指模块类型整机、AVW℃度度值WWΩ压V流A模块类型整机、AVW℃知：（0123456789出、发电机、逆变、旁路、主电源节传链路相关告警类型（1100~{"version":"1.0","receiver":"DG0000","rpl_id":"-1","url":":8000/rq/",}{"version":"1.0","receiver":"CP0000","rpl_id":"12315","url":"","err_code":0,"data":[{"obj_type":"10001","channel_info":[{"id":0,"name":"通道1"}],"standby":0,"group":[{"group_id":"100","group_name":"主链路信号","node_id":"3","manufacturer":"上海明珠","install_date":"2016-07-05",{"name":"frequency","value":""},{"name":"transmitter_type","value":"4"}],"remark":""}]}}{"version":"1.0","receiver":"CP0000","rpl_id":"12315","url":"","err_code":0,"data":[{"channel_id":0,{"date_type":0,"day":2,"start_time":"02:05:05","end_time":"23:30:00","tmp_flag":0,"enable":1},{"mode":0,"date_type":0,"day":2,"week":3,"month":3,"enable":"1","start_time":"01:16:20","end_time":"23:59:59","tmp_flag":1,"deadline":"2021-06-0223:59:59"}],"schedule_ctl":[{"date_type":0,"day":2,"execute_time":"01:15:20","tmp_flag":0,,"deadline":"","enable":1}]}]}}{"version":"1.0","receiver":"CP0000","rpl_id":"12315","url":"","err_code":0,"data":[{"alarm_type":"200","module_id":"","limit_type":0,"limit_value":"","alarm_delay":10,"enable":1},{"alarm_type":"200","module_id":"0","limit_type":0,"limit_value":"","alarm_delay":10,"enable":0}]}}C.5正在告警（未解除）信息应答消{"version":"1.0","receiver":"CP0000","rpl_id":"12315","url":":8000/re/","msg_type":"Existing_Alarm","err_code":0,"data":[{"channel_id":0,"index":"200","module_id":"0","value":"925","alarm_type":"200","alarm_reason":"入射功率跃下限！"}]}}{"version":"1.0","receiver":"CP0000","rpl_id":"-1","url":":8000/rp/","err_code":0,"data":[{"channel_id":0,"value_list":[{"index":"200","module_id":"0","value":"925","value_unit":""},{"index":"4","module_id":"0","value":"0","value_unit":""}]}]}}{"version":"1.0","receiver":"CP0000","rpl_id":"-1","url":"","err_code":0,"data":[{"channel_id":0,"index":"200","module_id":"0","value":"925","alarm_type":"200","alarm_reason":"入射功率跃下限！"}]}}{"version":"1.0","receiver":"CP0000","rpl_id":"-1","url":"","err_code":0,"data":[{"channel_id":0,"operator":{"role":"user",},"execute_result":1,"step_desc":"正在切换天线"}]}}{"version":"1.0","receiver":"CP0000","rpl_id":"-1","url":"","err_code":0,"data":[{"channel_id":0,}]}}{"version":"1.0","rpl_id":"-1","url":":8000/rq/","err_code":0,"data":[{"channel_id":0,{"date_type":0,"day":2,"start_time":"02:05:05","end_time":"23:30:00","tmp_flag":0,"deadline":"","enable":1},{"mode":0,"date_type":0,"day":2,"week":3,"month":3,"enable":1,"start_time":"01:16:20","end_time":"23:59:59","tmp_flag":1,"deadline":"2021-06-0223:59:59"}],"schedule_ctl":[{"date_type":0,"day":2,