DB21T 3098-2018 超短波监测管理服务接口规范

IDB21ServiceinterfacespecificationforVHFradiom辽宁省市场监督管理局发布I IV 1 1 1 1 1 2 2 2 3 4 5 7 8 8 9 9 9 11 11 12 12 12 13 13 14 14 14 15 15 15 16 16 17A.1结果返回方式 17A.2错误信息 17 17 18A.2.3错误示例 18 19 19 19 19 20 21 21 22 22 23 23 24B.1.11数字信号识别解调（B_DigSglRe 24 25 25B.1.14数字广播信号解调（B_DigBroad 26B.1.15专用通信系统信号解调（B_SpecCommSysSgl 26 26B.1.17生成中频频谱模板（B_GenIF 27B.1.18生成宽带频谱模板（B_GenWB 27B.1.19生成扫频频谱模板（B_GenFScanSp 28 28 29B.1.22扫频频谱信号截收（B_FSc 30 30 31 32 32B.1.27监测站/设备状态查询（B_QueryFaciDev 32B.1.28监测设备电源开关（B_SetDevi 32B.1.29监测设备天线连接指配（B_Link 32B.1.30监测设备信息查询（B_QueryDev 33B.1.31监测参数修改（B_TaskMod 33 33B.2.1动环设备信息查询（E_QueryDev 33B.2.2环境监控设备远程控制(E_Remote 34B.2.3环境监控信息查询（E_Quer 34 35C.1查询监测数据库信号样本表（D_Query 35C.2查询监测数据库频点信息统计表（D_QueryFreqSt 36C.3查询监测数据库电磁环境频段统计表（D_QueryEMEnvFSStatis 37C.4查询监测数据库电磁环境信号统计表（D_QueryEMEnvSignalStatis） 38C.5监测数据库比对查询（D_QueryDBMa 38C.6台站数据库比对查询（D_QueryDBMatc 39C.7查询监测设备列表（D_QueryD 39 40D.1监测设备列表查询（M_QueryDe 40D.2监测设施详细信息查询（M_QueryFacili 40D.3监测设备详细信息查询（M_QueryDev 41 41D.5监测设备状态查询（M_Quer 42 42 43 43 45本标准按照GB/T1.1-2009给1超短波监测管理一体化平台技术规范GB/T34084超短波频段无线电监测网数据库结构技术GB/T13622界定的以及下列术语、定义和缩略语适用于本文件。建的通用软件平台，包括物理资源，SOA中间件，通用支撑软件，数据处理平台等系列平台化软件，即令操作、监测数据共享等功能的超短波监测业务应超短波监测管控系统managementandcontrolsystemofVHF/UHFradiomonit2超短波监测服务VHF/UHFradiomonitorings子服务和动环设备服务）、超短波监测管控服务、超短波监测超短波设备操作服务operationserviceforVHF/UHFequi超短波监测管控服务managementandcontrolserviceforVHF/UHFradiomonit超短波监测数据服务dataservice超短波监测业务应用服务applicationserviceforVHF/UHFradiomonService-OrientedArchiInternationalTelecFileTransferProtocService-OrientedArchiTransmissionControlProtocol/InternetP4监测一体化平台总体架构设计4.1设计思路3作，为其他无线电管理业务提供超短波监测相关服4.2逻辑架构4.2.1平台总体逻辑架构应用系统N应用系统3应用系统N应用系统3应用系统2应用系统1应用系统1代理服务代理服务代理服务代理服务代理服务代理服务// 监测管控 监测设备动环设备 监测管控 监测设备动环设备监测设备原子服务(B服务)动环设备监测设备(B服务) 动环设备 监测数据 无线电管理一体化平台超短波监测管控系统监测站监测站监测站超短波监测数据库无线电管理一体化平台超短波监测管理一体化平台4.2.2管控系统监测设备/动环设备是指服务化封装的监测、测向、动环监控等功能。考虑设备有序、安全调用等因素，业务应用系统不允许直接对监测设备/动环设备进行控制，应由管控4.2.4超短波监测数据库45)存储管理信号发射参数，频点/频段占用4.3.1与一体化平台的关系统。管控系统、监测设备/动环设备、监测数据库以及应用系统之间的服务请求与响应，都应经过一体4.3.2与监测应用系统的关系监测应用系统是监测一体化平台的调用入口，所有监备的无差别操作及自动化监测等功能，获取的监测数据由监测应用系统自行实现分析及展4.3.3与其他无线电管理业务应用系统的关系4.3.4与数据中心的关系513N13N2无线电管理一体化平台数据仓库数据集市数据仓库结构化数据库非结构化数据库结构化数据库其他无线电管理一体化平台数据中心监测数据台站数据频率其他无线电管理一体化平台数据中心监测数据台站数据频率数据检测数据地理数据办公数据设备数据文档数据其他数据其他系统监测应用监测应用监测数监测数据库超短波监测管理一体化平台4.4互联互通设计4.4.1总体要求的互联互通。按照监测管理中心是否隶属于同一个一体化平台，可采用“单一体化平台”和“跨一体化4.4.2单一体化平台互联互通监测设备动环设备动环设备监测设备动环设备动环设备监测设备监测站监测站6应用系统N应用系统2应用系统1应用系统3 代理服务代理服务代理服务代理服务应用系统2应用系统1应用系统3 无线电管理一体化平台(服务治理)动环设备服务 监测管控服务 动环设备服务监测设备原子服务(B服务)监测设备原子服务动环设备动环设备服务 监测管控服务 动环设备服务监测设备原子服务(B服务)监测设备原子服务动环设备服务 监测设备原子服务监测站监测站监测管理中心M超短波监测管控系统动环设备服务监测设备原子服务(B服务)监测站监测站监测管理中心1无线电管理一体化平台超短波监测管理一体化平台单一体化平台内互联互通的典型应用场景为省级无线电监测机构建立1套管控系统，即各个地市监测站的原子服务直接挂载到省级一体化平台，地市监测站与4.4.3跨一体化平台互联互通……代理服务代理服务代理服务监测管控服务(M服务)监测管控服务(M服务)……代理服务代理服务无线电监测管理一体化A无线电监测管理一体化B应用系统N应用系统2应用系统1应用系统2应用系统N应用系统1无线电管理一体化平台(服务治理)无线电管理一体化平台(服务治理)平台对接动环设备服务(E服务)动环设备服务(E服务)监测设备原子服务(B服务)监测设备原子服务(B服务)动环设备服务(E服务)动环设备服务(E服务)监测设备原子服务(B服务)监测设备原子服务(B服务)监测设备超短波监测管控系统监测设备动环设备动环……代理服务代理服务代理服务监测管控服务(M服务)监测管控服务(M服务)……代理服务代理服务无线电监测管理一体化A无线电监测管理一体化B应用系统N应用系统2应用系统1应用系统2应用系统N应用系统1无线电管理一体化平台(服务治理)无线电管理一体化平台(服务治理)平台对接动环设备服务(E服务)动环设备服务(E服务)监测设备原子服务(B服务)监测设备原子服务(B服务)动环设备服务(E服务)动环设备服务(E服务)监测设备原子服务(B服务)监测设备原子服务(B服务)监测设备超短波监测管控系统监测设备动环设备动环设备超短波监测管控系统…………监测站监测站代理服务74.5物理部署架构4.5.1部署要求单个行政机构内部逻辑上应部署1套一体化平台，可采用集群和分布式部署方式，其部署方式应见4.5.2单一体化平台物理部署分布式部署管控系统分布式部署监测数据库监测应用分布式部署管控系统分布式部署监测数据库监测应用管控系统监测数据库无线电管理一体化平台分布式部署无线电管理一体化平台分布式部署无线电管理一体化平台无线电管理一体化平台无线电管理信息网及超短波监测网无线电管理信息网及超短波监测网B/E服务监测站B/E服务B/E服务监测站B/E服务监测站B/E服务监测站B/E服务监测站B/E服务监测站B/E服务监测站一体化平台发生故障时，下级监测业务应用系统仍能正常使4.5.3跨一体化平台物理部署8超短波监测管理一体化平台A一体化平台一体化平台无线电管理信息网及超短波监测网无线电管理信息网及超短波监测网对于跨一体化平台的物理部署，建议一体化平台与一体化平台之间采用高速物理链路（50Mbps以），5.1服务的调用 管控服务接口 管控服务接口原子服务接口业务应用层通过管控服务向监测设备发起服务请求，管控系统会依据业务层输入的监测设施编号（MFID）及监测设备编号（EQUID），在管控系统中完成对监测站5.3服务的调用过程可用设备列表查询服务治理可用设备列表可用设备列表查询服务治理服务治理功能服务调用原子服务设备使用设备应答服务治理服务治理功能服务调用原子服务设备使用设备应答服务治理监测设备服务治理服务治理原子服务设备使用监测数据服务调用监测数据监测设备服务治理服务治理原子服务设备使用监测数据服务调用监测数据监测设备调用释放设备服务服务应答服务治理服务治理原子服务设备释放设备应答监测设备调用释放设备服务服务应答服务治理服务治理原子服务设备释放设备应答监测设备2)调/调用功能服务：通过管控系统调用具体5.4数据流向图9④数据连接方式2:设备与监测应用直接建立数据连接(直传模式)④数据连接方式2:设备与监测应用直接建立数据连接(直传模式)应用系统控模块响应服务调用①调用管控控模块响应服务调用无线电管理一体化平台务响应管控模块调用③调用原子服务务响应管控模块调用③调用原子服务子服务④数据连接方式1:服务设备与管控模块建⑤数据连接方式1:管控模块与监测应用建立数据连接监测管控模块立数据连接(转发(转发模式)模式)2)监测应用通过一体化平台调用管控系统管控服务，将设备ID、任务参数等将监测数据保存在监测设备本地，然后再将数据上传到监测一体化平台监测数据模块的相调用的一体化平台已实现平台级互联互通。调用示意图如国家级无线电管理一体化平台平台设平台设备调用参数路由跨平台设备调用请求平台设备调用请求A省(市)级无线电管理一体化平台路由跨平台设备调用参数A省(市)级无线电管理一体化平台B省(市)级无线电管理一体化平台⑧返回跨平台设备调用参数⑧返回跨平台设备调用参数设备列表跨平台设备调用请求返回设备返回设备v列表查询设备设备调用台返回内返回平台内平台内内返回设备调设备调设备设备设备调管控系统A应用系统A管控系统B用参数用参数管控系统A应用系统A管控系统B⑨返回设备⑨返回设备⑨返回设备⑨返回设备流式数据流式数据流式数据家级一体化平台发起跨平台设备调用请求，国家级一体化平台将该跨平台设备调用请求路由转发到一体化平台B，由一体化平台B调用管控系统B，参见图中④。经由一体化平台B、国家级一体化平台发送回一体化平A，将调用返回结果通过一体化平台A传递给应用系统A，参见图中⑤、⑥1B2E3MMonitor4D服务名称采用的格式为：“服务类别代码_功能代码”。如“超短波单频测量服务”，其服务名称E_省简称_地市_站名E_辽_朝阳_师专站M_省简称_地市_服务接口名M_浙_杭州_监测设备列表查询D_省简称_地市_服务接口名设施ID编码：仅对监测设备原子服务和动环设备服务有效，见GB/T34084。:8013/Mon3:8081/Base/2113000111服务（QueryDeviceInfo）”，可得到每一个设备地图展示定位结果数据地图展示定位结果数据单频测向单频测向测量参数单频测向测量参数单频测向单频测向6.7.1设备、设施、任务和数据流标识设备编号和设施编号统一按照GB/T34084的定义。任务编号要求全局唯一，统一采用GUID（GloballyUnique数据流由stc（定义）标识，在任务期间应唯一确定。数据通道指定方式（output识给设备操作服务方，设备操作服务方根据唯一标识进行对监测数据设备管理、数据传输管理、异常处理、日志管理五管任务类型等相关信息，对全网实时任务按照优先级d)设备服务调用：管控系统需要实现对监测一体化平台设备原子服务和动环设备服务的服务调直传模式：设备与应用之间建立数据传输通路，进行实时监测设备实时数据传输方式可以有多种方式，同步方式主要有SOAP协议；异步方式有stream、FTP等，详见附录“数据返回方式”。监测设备原则至少要求支持stream（socket）、FTP两种方式，当实 A.1结果返回方式数据通道（outputchannelty1/2345/A.2错误信息A.2.1错误类型(errortypwaitA.2.2错误代码（errorcod12wait3BIZ-00002-item-not-fou4BIZ-00002-unsupported-servi5BIZ-00002-bad-reque6BIZ-00002-internal-server-error7BIZ-00002-auth-refu89A.2.3错误示例监测任务参数：指与监测任务标识相关的输入参数，具体描述及定义见表B.1。如无特别说明，表123456名称和值域确定。为避免节点名重复命名，具体控制指令参数通过调用监测设备信息查询（B_QueryDeviceInfo）服务取得。如无特别说明，设备控制指令参数均监测结果返回方式参数：返回结果方式可以由服务消费方指定，在输入参数outputchannel节点属性进行描述。监测设备原子服务应该至少实现socket和ftp两种监测结果返回模式，其他模式不做强制要求。如无特别说明，监测结果返回方式参数为必选123该服务调用具备单频测量功能的设备，按照ITU建议的测量内容对发射信号进行监测，对频率、场12345存在解调方式存在时，有效；如果此值不给出，则以中频带宽6789在射频前端开启衰减模式时，此值有效；单位：dB在射频工作模式开启增益模式或支持增益控制时有效；见附录mgcB.1.3宽带FFT频谱观测（B_12345存在解调方式存在时，有效；如果此值不给出，则以中频带宽6789在射频前端开启衰减模式时，此值有效；单位：dB在射频工作模式开启增益模式或支持增益控制时有效，见附录mgc123456789在射频工作模式开启增益模式或支持增益控制时有效；见附录mgc在射频前端开启衰减模式时，此值有效；单位：dB123456789在射频工作模式开启增益模式或支持增益控制时有效；见附录mgc在射频前端开启衰减模式时，此值有效；单位：dB1234567在射频工作模式开启增益模式或支持增益控制时有效；见附录8mgc9在射频前端开启衰减模式时，此值有效；单位：dB1234567在射频工作模式开启增益模式或支持增益控制时有效；见附录8mgc9在射频前端开启衰减模式时，此值有效；单位：dB表B.9宽带FFT测向（B_WBDF）可选控制指令参数12345678在射频工作模式开启增益模式或支持增益控制时有效；见附录9mgc在射频前端开启衰减模式时，此值有效；单位：dB123456789在射频工作模式开启增益模式或支持增益控制时有效；见附录mgc在射频前端开启衰减模式时，此值有效；单位：dB1234567在射频工作模式开启增益模式或支持增益控制时有效；见附录8mgc9在射频前端开启衰减模式时，此值有效；单位：dBB.1.11数字信号识别解调（B_DigSglRe12ITU测量数据开关345678在射频工作模式开启增益模式或支持增益控制时有效；见附录9mgc在射频前端开启衰减模式时，此值有效；单位：dBB.1.12模拟电视信号解调（B_A1234567指定被测量的信号的电视解调样式；包括PAB.1.13数字电视信号解调（B_D1234567B.1.14数字广播信号解调（B_DigBroad123456B.1.15专用通信系统信号解调（B_SpecCommSys12ITU测量数据开关345678912345678在指定的幅度门限之上，抬升的裕度；单位：dB9B.1.17生成中频频谱模板（B_GenIFSp入到模板文件，如果模板采集时间较长，可以考虑用最新的缓存数据定时覆盖文件内容。123456789在射频前端开启衰减模式时，此值有效；单位：dBmgcB.1.18生成宽带频谱模板（B_GenWBSp的数据写入到模板文件，如果模板采集时间较长，可以考虑用最新的缓存数据定时覆盖123456789在射频前端开启衰减模式时，此值有效；单位：dBmgcB.1.19生成扫频频谱模板（B_GenFScanSp的数据写入到模板文件，如果模板采集时间较长，可以考虑用最新的缓存数据定时覆盖123456789mgc在射频前端开启衰减模式时，此值有效；单位：dB123456当幅度门限类型为电磁环境模板(environment)时，由调用者确7当幅度门限类型为电磁环境模板(environment)时，由调用者确89在指定的幅度门限之上，抬升的裕度；单位：dB在射频前端开启衰减模式时，此值有效；单位：dBmgcB.1.21宽带频谱信号截收（B_WBS1234567在指定的幅度门限之上，抬升的裕度；单位：dB8当幅度门限类型为电磁环境模板(environment)时，由调用者确9当幅度门限类型为电磁环境模板(environment)时，由调用者确据；选择值范围：max(最大值)、average(平在射频前端开启衰减模式时，此值有效；单位：dBmgcB.1.22扫频频谱信号截收（B_FScanS123456789在指定的幅度门限之上，抬升的裕度；单位：dB当幅度门限类型为电磁环境模板(environment)时，由调用者确当幅度门限类型为电磁环境模板(environment)时，由调用者确选择值范围：max(最大值)、average(平在射频前端开启衰减模式时，此值有效；单位：dBmgcB.1.23TDOA测量（B_TD该服务调用具备TDOA测量功能的设备，按照ITU建议的测量内容对发射信号进行监测，对频率、场1选择天线名字（如果无此输入参数表示由接收机选择默认天23456789mgc在射频前端开启衰减模式时，此值有效；单位：dB该服务调用具备多路DDC测量功能的设备，同时对多个信号进行监测，对频率、场强、带宽、调制1选择天线名字（如果无此输入参数表示由接收机选择默认天23456mgc78在射频前端开启衰减模式时，此值有效；单位：dB9该服务输入参数包括必选参数mfid（监测设施编号）、equid（监测设备编号）和ta）；该服务输入参数包括必选参数mfid（监测设施编号）和equid（监测设备编号）；输出参数为必选B.1.27监测站/设备状态查询（B_QueryFaci该服务输入参数包括必选参数mfid（监测设施编号），可选参数equid（监测设备编号）；输出参数包括必选参数position（位置信息，包括经纬度等）、state（前端监测设备的运行），（移动方向）、altitude（高度）、compass（电B.1.28监测设备电源开关（B_SetDev该服务调用具有远程电源关闭功能的监测设备，用于控制监测设B.1.29监测设备天线连接指配（B_Link数为必选参数outputchannel（B.1.30监测设备信息查询（B_QueryDev监测服务列表和相应的输入输出参数，为服务的扩展机制提（设备操作服务代码，见附录C.1输出参数均为必选参数，123456789监测设备支持的设备操作服务的可以支持的输入可以支持的输入B.1.31监测参数修改（B_TaskModifi该服务输入参数包括必选参数mfid（监测设施编号）、equid（监测设备编号）、ta务编号）和ModifiedParamList（待修改参数列表输出参数为必选参数指令执行结果。B.2.1动环设备信息查询（E_QueryDe服务进行扩展实现，具体参数可根据实际情B.2.2环境监控设备远程控制(E_RemoteC）；B.2.3环境监控信息查询（E_QueryEn该服务输入参数包括必选参数mfid（监测设施编号输出参数见表3123456789MasterSwitchC.1查询监测数据库信号样本表（D_QueryDBSam按照监控中心编号查询某个地区的信号样按照监测设施编号查询某个监测设施的信号指定查询的测量区域；测量区域如为圆形和半径(单位：千米)；测量区域如为矩形经纬度（单位：°)和右下（东南）角经纬相关参数定义、取值单位等见GB/T34084波特率/正负频偏/相偏/C.2查询监测数据库频点信息统计表（D_QueryFreqS按照监控中心编号查询某个地区的信号样按照监测设施编号查询某个监测设施的信号指定查询的测量区域；测量区域如为圆形和半径(单位：千米)；测量区域如为矩形经纬度（单位：°)和右下（东南）角经纬相关参数定义、取值单位等见GB/T34084C.3查询监