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

35.100.70M

10DB21 DB21/T

3098—2018超短波监测管理服务接口规范Service

interface

辽宁省市场监督管理局 发

布DB21/T

3098—2018 前 言

.............................................................................IV超短波监测管理一体化平台技术规范

...................................................... 11

范围

................................................................................12

规范性引用文件

...................................................................... 13

术语、定义和缩略语

.................................................................. 13.1

术语和定义

...................................................................... 13.2

缩略语

.......................................................................... 24

监测一体化平台总体架构设计

.......................................................... 24.1

设计思路

........................................................................ 24.2

逻辑架构

........................................................................ 34.3

关联关系

........................................................................ 44.4

.................................................................... 54.5

....................................................................75

服务的调用

..........................................................................85.1

服务的调用

...................................................................... 85.2

................................................................ 95.3

服务的调用过程

.................................................................. 95.4

数据流向图

...................................................................... 96

相关方职责与规则定义

............................................................... 116.1

相关方职责

..................................................................... 116.2

服务接口命名

................................................................... 126.3

代理服务发布命名及封装要求

..................................................... 126.4

服务终结点编码规则

............................................................. 126.5

服务扩展机制

................................................................... 136.6

应用服务组合机制

............................................................... 136.7

其他约定

....................................................................... 147

管控系统架构

....................................................................... 147.1

组成模块

....................................................................... 147.2

全网设备管理

................................................................... 157.3

................................................................... 157.4

数据传输管理

................................................................... 157.5

异常处理机制

................................................................... 167.6

日志管理

....................................................................... 16附 录 A

相关定义

...................................................17A.1

结果返回方式

..................................................................... 17A.2

错误信息

......................................................................... 17DB21/T

3098—2018A.2.1

错误类型(error

......................................................... 17A.2.2

错误代码（error

code）

....................................................... 18A.2.3

错误示例

..................................................................... 18附 录 B

设备操作服务接口定义

.......................................................19B.1

................................................................. 19B.1.1

接口参数的组成

............................................................... 19B.1.2

单频测量（B_SglFreqMeas）

.................................................... 19B.1.3

FFT

频谱观测（B_WBFFTMon）

............................................... 20B.1.4

频率扫描频谱观测（B_FScan）

.................................................. 21B.1.5

全景扫描频谱观测（B_PScan）

.................................................. 21B.1.6

存储频率列表扫描（B_MScan）

.................................................. 22B.1.7

单频测向（）

...................................................... 22B.1.8

FFT

测向（）

....................................................... 23B.1.9

扫频测向（）

........................................................ 23B.1.10

频率表扫描测向（B_MScanDF）

................................................. 24B.1.11

B_DigSglRecDecode）

....................................... 24B.1.12

B_AnaTVDem）

.............................................. 25B.1.13

B_DigTVDem）

..............................................25B.1.14

B_DigBroadcastDem）

....................................... 26B.1.15

专用通信系统信号解调（）

................................. 26B.1.16

占用度测量（B_OccuMeas）

.................................................... 26B.1.17

B_GenIFSpecTemp）

......................................... 27B.1.18

B_GenWBSpecTemp）

......................................... 27B.1.19

B_GenFScanSpecTemp）

...................................... 28B.1.20

B_IFSglInte）

............................................. 28B.1.21

B_WBSglInte）

............................................. 29B.1.22

B_FScanSglInte）

.......................................... 30B.1.23

TDOA

测量（B_TDOAqMeas）..................................................... 30B.1.24

多路通道监测（）

................................................... 31B.1.25

停止测量任务（）

..................................................32B.1.26

监测设备自检（）

.................................................. 32B.1.27

监测站/设备状态查询（）

................................... 32B.1.28

B_SetDevicePower）

........................................ 32B.1.29

监测设备天线连接指配（B_LinkAnteDev）

....................................... 32B.1.30

B_QueryDeviceInfo）

....................................... 33B.1.31

监测参数修改（）

.......................................... 33B.2

动环设备原子服务

................................................................. 33B.2.1

动环设备信息查询（E_QueryDeviceInfo）

........................................33B.2.2

环境监控设备远程控制(E_RemoteControl)

........................................ 34B.2.3

环境监控信息查询（E_QueryEnviInfo）

.......................................... 34附

录 C

数据服务接口定义

...........................................................35C.1

查询监测数据库信号样本表（）

...................................... 35IIDB21/T

3098—2018C.2

查询监测数据库频点信息统计表（D_QueryFreqStatis）

................................ 36C.3

查询监测数据库电磁环境频段统计表（D_QueryEMEnvFSStatis）

......................... 37C.4

查询监测数据库电磁环境信号统计表（D_QueryEMEnvSignalStatis）

..................... 38C.5

监测数据库比对查询（D_QueryDBMatchSignal）

....................................... 38C.6

台站数据库比对查询（D_QueryDBMatchStation）

...................................... 39C.7

查询监测设备列表（D_QueryDBEquipments）

.......................................... 39附 录 D

管控服务接口定义

...........................................................40D.1

监测设备列表查询（M_QueryDeviceInfos）

........................................... 40D.2

监测设施详细信息查询（）

...................................... 40D.3

监测设备详细信息查询（M_QueryDeviceInfo）

........................................ 41D.4

监测设备状态推送（M_PutEquStatus）

............................................... 41D.5

监测设备状态查询（M_QueryEquStatus）

............................................. 42D.6

发起设备操作（M_RequestEquip）

...................................................42D.7

监测任务信息查询（M_QueryTasks）

................................................. 43D.8

监测设备注册（M_RegisterEquip）

.................................................. 43参 考 文 献

.......................................................................45IIIDB21/T

3098—20181 范围责、设备操作服务、数据服务、管控系统架构及接口定义等。本标准适用于超短波监测管理一体化平台,行。2规范性引用文件件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T

13622

GB/T

34084

超短波频段无线电监测网数据库结构技术要求3术语、定义和缩略语GB/T

13622界定的以及下列术语、定义和缩略语适用于本文件。3.1 术语和定义3.1.1无线电管理一体化平台

integration

platform

radio

+建的通用软件平台，包括物理资源，中间件，通用支撑软件，数据处理平台等系列平台化软件，即一体化平台是一体化战略的信息化具体实现。3.1.2超短波监测管理一体化平台

integration

platform

for

radio

monitoring

andregulation令操作、监测数据共享等功能的超短波监测业务应用系统。3.1.3超短波监测管控系统

management

and

control

of

VHF/UHF

radio

独立于监测设备和监测应用系统，可调用监测设备并可供监测应用系统调用的的公共管控模块。3.1.4DB21/T

3098—2018超短波监测服务

VHF/UHF

radio

monitoring

子服务和动环设备服务）、超短波监测管控服务、超短波监测数据服务、超短波监测业务应用服务。3.1.5超短波设备操作服务

operation

service

for

equipment环设备服务。3.1.6超短波监测管控服务

management

and

control

radio

monitoring由超短波监测管控系统封装，用于应用系统进行设备操作的服务。3.1.7超短波监测数据服务

data

service

monitoring的服务。3.1.8超短波监测业务应用服务

application

VHF/UHF

radio

务、数据服务等组合而成。3.2缩略语下列缩略语适用于本文件：SOA面向服务的体系结构Service-Oriented

ArchitectureITU 国际电信联盟 International

Telecommunication

UnionFTP 文件传输协议 File

Transfer

ProtocolSOA 面向服务的体系结构 Service-Oriented

ArchitectureTCP/IP

传输控制协议/互联网络协议 Transmission

XML 可扩展标记语言 eXtensible

Markup

LanguageIQ 同相正交 in-phase

4 监测一体化平台总体架构设计4.1 设计思路技术架构构建监测一体化平台，实现对超短波监测业务和监测数据的统一管理。具体需求分析如下：a) 域分布广泛等带来的设备协同、复用困难的问题；DB21/T

3098—2018b) 作，为其他无线电管理业务提供超短波监测相关服务支撑；c) 掘分析利用；d) 减少系统的重复建设，充分利用现有资源，同时灵活适应未来的业务发展变化。4.2 逻辑架构4.2.1 平台总体逻辑架构超短波监测管理一体化平台总体逻辑架构如图1/动环设备和超短波监测数据库三部分组成。

代理服务代理服务代理服务代理服务无线电管理一体化平台监测管控服务(M服务)

监测设备原子服务(B服务)

动环设备服务(E服务)

监测设备原子服务(B服务)

动环设备服务(E服务)

监测设备原子服务(B服务)

动环设备服务(E服务)

监测数据服务(D服务)

监测

监测

动环设备

设备监测站

监测

动环设备

设备监测站

动环设备

设备监测站

一体化平台 无线电管理一体化平台

超短波监测管理一体化平台图1

监测一体化平台逻辑架构图4.2.2 管控系统等问题。管控系统是监测一体化平台的核心模块。4.2.3 监测设备/动环设备监测设备/动环设备是指服务化封装的监测、测向、动环监控等功能。考虑设备有序、安全调用等因素，业务应用系统不允许直接对监测设备/动环设备进行控制，应由管控系统通过调用一体化平台中的监测设备原子服务和动环设备服务的代理服务，实现对异构厂家设备的无差别操作。4.2.4 超短波监测数据库无线电管理数据中心的重要组成部分。其主要功能设计要求如下：1) 存放监测管理数据，包括监测设施、设备信息等；DB21/T

3098—20182) 为监测数据分析系统提供(实时或批量的)数据；3) 集成频率资源管理、台站管理等系统的业务数据；4) 管理数据字典和数据库结构等元数据；5) 存储管理信号发射参数，频点/频段占用度等各类统计数据；6)

IQ

据同步和共享、数据加工和挖掘等。4.3关联关系4.3.1 与一体化平台的关系统。管控系统、监测设备/动环设备、监测数据库以及应用系统之间的服务请求与响应，都应经过一体化平台进行交互。据维护都应满足一体化平台服务治理系统的相关要求。程、安全等方面的功能支撑。4.3.2 与监测应用系统的关系监测应用系统是监测一体化平台的调用入口，所有监测任务的发起均由监测应用系统完成。备的无差别操作及自动化监测等功能，获取的监测数据由监测应用系统自行实现分析及展示功能。4.3.3 与其他无线电管理业务应用系统的关系监测一体化平台为其他无线电管理业务应用系统提供所需的超短波监测相关数据服务和业务服务，例如： 超短波监测信号样本数据查询服务、超短波频点监测信息查询、电磁环境信号统计查询、电磁环境频段统计查询等监测数据服务 频率资源监管、频谱专项监测、干扰源查找、目标信号监测定位等监测业务服务 同时监测一体化平台也需要其他无线电管理业务应用系统提供相关数据服务和业务服务4.3.4 与数据中心的关系心的数据交换平台、数据加工平台、数据管理平台和数据分析平台，实现国家与省级无线电管理机构、工、挖掘分析利用等。DB21/T

3098—20183

3

……

业务应用1

业务应用2

业务应用

N无线电管理一体化平台数据存储平台 数据加工平台统一数据库

数据中心

数据质量平台

数据交换平台其他无线电管理一体化平台数据中心

频率

检测

超短波监测管理一体化平台

图2监测一体化平台与数据中心关系图4.4 互联互通设计4.4.1总体要求的互联互通。按照监测管理中心是否隶属于同一个一体化平台，可采用“单一体化平台”和“跨一体化平台”两种互联互通模式。4.4.2 单一体化平台互联互通点，由1套管控系统实现互联互通，其架构如图3DB21/T

3098—2018

代理服务 代理服务代理服务代理服务监测管控服务(M服务)

监测设备原子服务(B服务)监测设备

动环设备服务(E服务)动环设备

监测设备原子服务(B服务)监测设备

动环设备服务(E服务)动环设备

监测设备原子服务(B服务)监测设备

动环设备服务(E服务)动环设备

监测设备原子服务(B服务)监测设备

动环设备服务(E服务)动环设备监测站

监测站

监测站

监测站

一体化平台 无线电管理一体化平台

超短波监测管理一体化平台图3 单一体化平台内互联互通逻辑架构图单一体化平台内互联互通的典型应用场景为省级无线电监测机构建立1套管控系统，即各个地市监测站的原子服务直接挂载到省级一体化平台，地市监测站与省级无线电监测机构共用1套管控系统。4.4.3 跨一体化平台互联互通逻辑架构图如图4所示：

图4跨一体化平台互联互通逻辑架构图的监控管理，从而达到不同一体化平台之间设备互联互通的目标。跨省监测设备互联互通。DB21/T

3098—20184.5 物理部署架构4.5.1 部署要求监测一体化平台的部署应以独立行政机构为单位进行。单个行政机构内部逻辑上应部署1套一体化平台，可采用集群和分布式部署方式，其部署方式应见《无线电管理一体化平台体系架构与应用规范》。单个行政机构内部逻辑上应部署1套监测一体化平台，可采用集群和分布式部署方式。单个行政机构内部逻辑上应部署1套监测数据库，可采用集群和分布式部署方式。封装后的监测设备/动环设备应由唯一的1套管控系统进行，避免跨管控系统管理。4.5.2 单一体化平台物理部署单一体化平台物理部署架构如图5所示：监测应用管控系统

分布式部署管控系统

分布式部署监测数据库B/E监测站

B/E监测站

B/E监测站

B/E监测站

B/E监测站图5 单一体化平台物理部署架构图一体化平台发生故障时，下级监测业务应用系统仍能正常使用。4.5.3跨一体化平台物理部署跨一体化平台的物理部署架构如图6所示：DB21/T

3098—2018超短波监测管理一体化平台A 超短波监测管理一体化平台B监测应用

监测应用管控系统

监测数据库

分布式部署管控系统

分布式部署监测数据库

管控系统

监测数据库

分布式部署管控系统

分布式部署监测数据库无线电管理一体化平台 无线电管理一体化平台分布式部署

无线电管理一体化平台

无线电管理一体化平台分布式部署一体化平台互联无线电管理信息网及超短波监测网

无线电管理信息网及超短波监测网B/E服务监测站

B/E服务监测站

B/E服务监测站

B/E服务监测站

B/E服务监测站

B/E服务监测站

B/E服务监测站

B/E服务监测站

B/E服务监测站

B/E服务监测站图6 跨一体化平台物理部署架构图对于跨一体化平台的物理部署，建议一体化平台与一体化平台之间采用高速物理链路（50Mbps以上），同时设立独立防火墙，既有效加强安全管控，又方便网络配置管理。5 服务的调用5.1 服务的调用管控服务监测中心无线电管理一体化平台

业务应用原子服务监测设备图7 服务的调用示意图服务的调用包括：1）管控服务的调用：由解析应用层发起，调用管控系统的服务；DB21/T

3098—20182）设备操作服务的调用：由管控系统调用监测设备和动环设备的服务。5.2 设备的寻址与路由业务应用层通过管控服务向监测设备发起服务请求，管控系统会依据业务层输入的监测设施编号（MFID）及监测设备编号（EQUID），在管控系统中完成对监测站、监测设备服务寻址映射，即访问的路由：1MFIDEQUID备的唯一网络寻址；2）设备路由：通过

MFID

与

EQUID

组成的联合索引，从监测设备注册信息库中获得监测设备的

IP管辖范围内，则路由到设备所在的管控平台，再进行服务的调用。5.3服务的调用过程监测一体化平台服务请求调用过程如图8：查

管控服务监测一体化平台应用系统调用放

应用系统应用系统应用系统

管控服务监测一体化平台管控服务监测一体化平台管控服务监测一体化平台

原子服务监测设备原子服务监测设备原子服务监测设备图8 管控服务调用示意图1)查/设备列表查询：通过管控系统发布的服务，获取经授权的设备服务列表；2)调/调用功能服务：通过管控系统调用具体监测设备的指定功能服务；3) 用/使用监测数据：管控系统协调控制设备后，由监测设备返回相关监测任务数据；4) 放/释放设备：释放掉此次监测任务对设备的占用。5.4数据流向图5.4.1 平台内设备服务调用DB21/T

3098—2018机构直辖范围内的监测设备时，调用示意图如图9：

测任务

服务调用

模块调用

③调用原子服务

子服务

立数据连接

图9平台内设备服务调用示意图具体的调用步骤与方式描述如下：1)监测数据传输方式等。2)监测应用通过一体化平台调用管控系统管控服务，将设备

ID、任务参数等信息传递给管控系统，管控系统解析服务参数，并根据设备

ID

判断设备原子服务路由，在确定属于平接模式等一系列工作之后，将监测任务参数传递给监测设备。3)

Source\Sink

中的一种方式）和转发模式。4)

将监测数据保存在监测设备本地，然后再将数据上传到监测一体化平台监测数据模块的FTP

服务器。5.4.2 跨平台设备服务调用相调用的一体化平台已实现平台级互联互通。调用示意图如图10：按服务使用者的要求实施服务的具体编排DB21/T

3098—2018家级线电管理一体化平台⑦路由跨平台设备调用参数

④路由跨平台设备调用请求

④路由跨平台设备调用请求

⑦路由跨平台设备调用参数

线电管理一体化平台

线电管理一体化平台①查询设备列表

②返回设备列表

③设备调用请求

返回跨平台设备调用参数

①查询设备列表

②返回设备列表

③设备调用请求

⑧返回跨平台设备调用参数

⑦跨平台返回设备调用参数

④跨平台设备调用请求

④跨平台设备调用请求

⑦跨平台返回设备调用参数

⑥平台内返回设备调用参数

⑤平台内设备调用

⑤平台内设备调用

⑥平台内返回设备调用参数应用系统

返回设备

管控系统

返回设备

管控系统

返回设备

原子服务B流式数据

流式数据

流式数据图10 跨平台设备服务调用示意图图4具体的场景为监测一体化平台AB管辖的监测设备，具体调用步骤与方式描述如下：1) 应用系统

A

通过一体化平台

A

调用查询设备列表服务并取得可用设备列表，参见图中①、②。2) 应用系统

A

根据取得的可用设备列表选定设备并通过一体化平台

A

体化平台

A

调用管控系统

A

处理该设备调用请求，参见图中③。3) 管控系统

A

确认应用系统

A

所调用的设备在监测一体化平台

B

A

向国家级一体化平台发起跨平台设备调用请求，国家级一体化平台将该跨平台设备调用请求路由转发到一体化平台

B，由一体化平台

B

调用管控系统

B，参见图中④。4) 管控系统

B

通过一体化平台

B

B

B

经由一体化平台

B、国家级一体化平台发送回一体化平台

A，一体化平台

A

调用管控系统A，将调用返回结果通过一体化平台

A

传递给应用系统

A，参见图中⑤、⑥、⑦、⑧。5) 原子服务

B

B

B

与管控系统

A

A

将设备返回数据发送给应用系统

A中⑨。6 相关方职责与规则定义6.1 相关方职责相关方职责描述见表1。表1 相关方职责表11BaseEnvironmentMonitorDataB_B_E_E_M_M_D_D_DB21/T

3098—20186.2服务接口命名服务接口使用“服务类别代码”、“功能代码”两个信息元素构成超短波监测服务标准名称：1)服务类别代码见表

2。表2服务类别代码表2) 2) 功能代码见本标准附录

B、C、D

部分。为“B_SglFreqMeasure服务参数的代码规则应按照W3C的XML语法规则，统一格式为：<参数名>参数值</参数名>6.3 代理服务发布命名及封装要求6.3.1 代理服务发布命名规则代理服务发布命名规则及示例见表3。表3 代理服务发布命名规则及示例表3 代理服务发布命名规则及示例管控服务和数据服务应进行独立封装，避免出现一个服务多个方法的情况。6.4 服务终结点编码规则服务终结点（endpoint）是标识服务寄宿位置的寻址信息，是一个URL地址文本串：1）服务地址编码规则：URL

服务类别/[设施

ID

/]其中：——scheme http：超文本传输协议资源 https：用安全套接字层传送的超文本传输协议DB21/T

3098—2018host：服务寄宿的主机

地址或域名port据服务默认端口分别为

，8012，8013，8014服务类别：见表

2。设施

编码：仅对监测设备原子服务和动环设备服务有效，见

GB/T

34084。2）服务终结点范例：——管控服务因管控系统具备路由寻址功能，所以其代理服务可直接对外，监测管控服务终结点是：:8013/Monitor——设备操作服务211300

为

点是：3:8081/Base/211300011100016.5 服务扩展机制服务（）”，可得到每一个设备操作服务的输入参数，确保每个监测设备特有的功能和性能不受影响。6.6应用服务组合机制例：1）多站监测定位服务据测向结果调用测向定位的算法，将交会定位的结果通过调用地图服务进行展示，服务逻辑如图

所示。

图11多站监测定位服务逻辑2）自动信号普查服务定位，并记录定位结果。服务逻辑如图

所示。13DB21/T

3098—2018图12 自动信号普查服务逻辑6.7 其他约定6.7.1 设备、设施、任务和数据流标识生成规定设备编号和设施编号统一按照

GB/T

34084

的定义。任务编号要求全局唯一，统一采用

GUID（Globally

Unique

Identifier）。数据流由

stc（定义）标识，在任务期间应唯一确定。数据通道指定方式（outputchannelmode）为

source

模式下

值由服务端赋值。字符串的编码应统一使用“UTF-86.7.2关于监测数据异步

传输协议说明在每个任务建立第一次

数据传输之前，服务消费方应与服务提供方执行一次握手连接，在握手消息中，设备将任务

ID

信息传递给

消费方，以正确区分不同任务的数据流。具体实施方案：source

socket

识给设备操作服务方，设备操作服务方根据唯一标识进行对监测数据的发送。sink

唯一标识给服务消费者，服务消费者根据该标识对监测数据进行接收。7 管控系统架构7.1 组成模块DB21/T

3098—201813设备管理、数据传输管理、异常处理、日志管理五个模块组成。

数据传输管理图13

管控系统架构示意图

7.2 全网设备管理通过管控系统统一实现对全网设备及权限的管理，具体包含如下功能：a) ID

及

放设备注册接口，以实现设备自动注册。b) 设备信息修改及删除等。c) 行状态管理，以服务方式供上层应用调用。d)现不同用户具备不同监测设备控制权限功能。7.3 任务调度管理一体化平台有关设备操作的各项监测任务。a) 任务优先级排序：管控系统可根据监测应用输入的有关任务优先级参数如用户

ID、应用

、任务类型等相关信息，对全网实时任务按照优先级排序，实现全网设备资源有序调度。b) 等，便于对应用和服务信息的追溯、维护和管理。c)数据流是否异常等。d) 设备服务调用：管控系统需要实现对监测一体化平台设备原子服务和动环设备服务的服务调用。7.4 数据传输管理15DB21/T

3098—20187.4.1 数据传输模式分为直传模式和转发模式。直传模式：设备与应用之间建立数据传输通路，进行实时数据传输。进行数据传输。管控系统需具备实时数据连接模式配置功能，以实现数据传输模式的切换。7.4.2 数据传输方式监测设备实时数据传输方式可以有多种方式，同步方式主要有SOAP协议；异步方式有stream、等，详见附录“数据返回方式”。监测设备原则至少要求支持stream（）、两种方式，当实时数据采用streamsinkstream（的source模式返回。7.5 异常处理机制平台系统集成规范》的异常处理方式。7.6 日志管理日志，监测数据流日志记录经过平台的数据流及消费数据流的IP地址和任务等信息。XML

stream

IP

TCP/IP

stream

sourceURL

IP

URLUniform

FTP

IP

file：文件全路径，包括文件名称

databaseDB21/T

3098—2018附

录 A（规范性附录）相关定义A.1 结果返回方式返回结果方式可以由服务提供方指定，也可以由服务消费方指定，应在通道信息中给出标注：——sink：服务消费方指定。——source：服务提供方指定。数据通道（outputchanneltype

A.1表A.1 数据通道类型streamstreamA.2.1 错误类型(error

type)错误类型见表。表A.2 表

A.2

错误类型表 17BIZ-00002-conflictcancelBIZ-00002-gonewaitBIZ-00002-item-not-foundcancelBIZ-00002-unsupported-servicemodifyBIZ-00002-bad-requestmodifyBIZ-00002-internal-server-errorcancelBIZ-00002-auth-refusecancelSMP-20001systemError“代理服务编号”为空SMP-20002systemError“业务服务编号”为空10SMP-20003systemError11SMP-20004systemError12SMP-20005systemError13SMP-20006systemError“业务服务调用地址”为空14SMP-20007soap:Client15SMP-20008soap:Server16BIZ-0000017BIZ-0000118BIZ-0000319BIZ-00004cancelwaitmodifysystemErrosoap:Clientsoap:Server服务提供方的其它异常DB21/T

3098—2018A.2.2 错误代码（error

code）错误代码见表。表A.3 表表A.3 表

A.3

错误代码<error><errortype>错误类型</errortype><errorcode>错误编码</errorcode><text>详细的错误描述</error>mfid监测设施编号

监测设备编号

ID

，整数，数值越小优先级越高，

调用者平台编号outputchannel

taskidDB21/T

3098—2018附录B设备操作服务接口定义B.1监测设备原子服务B.1.1 接口参数的组成分组成。监测任务参数：指与监测任务标识相关的输入参数，具体描述及定义见表。如无特别说明，表B.1中所列监测任务参数均为各个监测设备原子服务必选参数。表

B.1

监测设备原子服务接口监测任务参数定义名称和值域确定。为避免节点名重复命名，具体控制指令参数通过调用监测设备信息查询（B_QueryDeviceInfo）服务取得。如无特别说明，设备控制指令参数均为可选参数。监测结果返回方式参数：返回结果方式可以由服务消费方指定，在输入参数outputchannel节点属性进行描述。监测设备原子服务应该至少实现和ftp两种监测结果返回模式，其他模式不做强制要求。如无特别说明，监测结果返回方式参数为必选参数。监测设备原子服务接口输出参数具体描述见表B.25中所列输出参数均为必选参数。表

B.2

监测设备原子服务接口输出参数B.1.2单频测量（B_SglFreqMeas）该服务调用具备单频测量功能的设备，按照建议的测量内容对发射信号进行监测，对频率、场强、带宽、调制参数等进行测量。19antennaselectfrequencyifbwdemodmode

demodbw存在解调方式存在时，有效；如果此值不给出，则以中频带ifbwspan中频带宽≤

Hzdetector

ITUSwitch

C.17

C.1810audiotype

C.1911IQSwitchIQ

C.2012bwmeasuremode

C.1013bwmeasurevalue带宽测量值与带宽测量模式模式对应14rfmode

C.1115rfattenuation16rfattvaluedB17gain在射频工作模式开启增益模式或支持增益控制时有；见附C.1218mgc

dBantennaselectfrequencyifbwdemodmode

demodbw存在解调方式存在时，有效；如果此值不给出，则以中频带ifbwspan中频带宽≤

Hzdetector

ITUSwitch

C.17

C.18DB21/T

3098—2018该服务可选控制指令参数见表B.3。表

B.3

单频测量（B_SglFreqMeas）可选控制指令参数B.1.3宽带频谱观测（）

带宽拼接的频谱。该服务可选控制指令参数见表B.4。表

B.4

FFT

频谱观测（B_WBFFTMon）可选控制指令参数antennaselectsegment

startfreqstopfreqstepifbw

step

的中频测量带宽holdtimedetector

rfmode

C.1110gain在射频工作模式开启增益模式或支持增益控制时有；见附C.1211mgc

dB12rfattenuation13rfattvaluedB10audiotype

C.1911IQSwitchIQ

C.2012bwmeasuremode

C.1013带宽测量值与带宽测量模式对应14rfmode

C.1115rfattenuation16rfattvaluedB17gain在射频工作模式开启增益模式或支持增益控制时有效，见附C.1218mgc

dBantennaselectDB21/T

3098—2018B.1.4 频率扫描频谱观测（）该服务调用具备

态频谱或其他需要频谱数据。该服务可选控制指令参数见表B.5。表

B.5

频率扫描频谱观测（B_FScan）可选控制指令参数B.1.5 全景扫描频谱观测（）该服务调用具备

态频谱或其他需要频谱数据的业务。该服务可选控制指令参数见表B.6。表

B.6

全景扫描频谱观测（B_PScan）可选控制指令参数21segment

startfreqstopfreq指定被测量频段的终止频率stepifbw

step

holdtimedetector

rfmode

C.1110gain在射频工作模式开启增益模式或支持增益控制时有；见附B.1211mgc

dB12rfattenuation13rfattvaluedBantennaselectfrequencyifbw

step

holdtimedetector

rfmode

B.11gain在射频工作模式开启增益模式或支持增益控制时有；见附B.12mgc

dBrfattenuation10rfattvaluedBantennaselectfrequency指定被测量频率，被测频率从属于一个频率列表。DB21/T

3098—2018B.1.6 存储频率列表扫描（）统计的业务。该服务可选控制指令参数见表B.7。表

B.7

存储频率列表扫描（B_MScan）可选控制指令参数B.1.7单频测向（B_SglFreqDF）要示向度数据的业务。该服务可选控制指令参数见表。表

B.8

单频测向（）可选控制指令参数antennaselectfrequencyspan中频带宽≤

Hzstep

C.18detector

rfmode

C.11gain在射频工作模式开启增益模式或支持增益控制时有；见附C.12mgc

dB10rfattenuationON

OFF11rfattvaluedBifbw

step

holdtimedetector

rfmode

B.11gain在射频工作模式开启增益模式或支持增益控制时有；见附B.12mgc

dBrfattenuation10rfattvalue在射频前端开启衰减模式时，此值有效；单位：dBantennaselectstartfreq指定被测量频段的起始频率stopfreqstepDB21/T

3098—2018B.1.8 宽带测向（）该服务调用具备宽带FFTFFT实时带宽内包含示向度信息的宽带频谱数据，可用于需要示向度数据的业务。该服务可选控制指令参数见表。表

B.9

FFT

测向（）可选控制指令参数B.1.9 扫频测向（B_FScanDF）测定，可用于需要示向度数据的业务。该服务可选控制指令参数见表B.10。表

B.10

扫频测向（）可选控制指令参数23antennaselectfrequencydfbwholdtimedetector

rfmode

C.11gain在射频工作模式开启增益模式或支持增益控制时有；见附C.12mgc在增益模式为

dBrfattenuation10rfattvaluedB11输出示向度的测向质

C.18dfbw

step

holdtimedetector

rfmode

C.1110gain在射频工作模式开启增益模式或支持增益控制时有；见附C.1211mgc

dB12rfattenuation13rfattvaluedBantennaselectITUSwitch

C.17

C.18audiotype

C.19DB21/T

3098—2018B.1.10 频率表扫描测向（）向测量或统计的业务。该服务可选控制指令参数见表B.11。表

B.11

频率表扫描测向（B_MScanDF）可选控制指令参数B.1.11 数字信号识别解调（B_DigSglRecDecode）该服务调用具备数字信号识别解码的设备，针对固定频点进行数字信号的特征识别和解码结果。该服务可选控制指令参数见表B.12。表

B.12

B_DigSglRecDecode）可选控制指令参数frequencydfbwrfmode

C.11gain在射频工作模式开启增益模式或支持增益控制时有；见附C.12mgc

dB10rfattenuation11rfattvaluedB12recmodulation

no13reccomsystem

no14要求测量通信波特率；取值

antennaselect

C.18audiotype

C.19IQSwitchIQ

C.20videoswitchfrequencydemodmode

NTSCantennaselect

C.18audiotype

C.19IQSwitchIQ

C.20videoswitchfrequencydemodmodeDB21/T

3098—2018B.1.12模拟电视信号解调（B_AnaTVDem）8MHz信道进行各制式模拟电视信号的解调，可用于观察模拟电视信号的内容。该服务可选控制指令参数见表B.13。表

B.13

B_AnaTVDem）可选控制指令参数B.1.13 数字电视信号解调（B_DigTVDem）式的数字电视信号的解调，可用于观察数字电视信号的内容。该服务可选控制指令参数见表B.14。表

B.14

B_DigTVDem）可选控制指令参数25antennaselectITUSwitch

C.17

C.18audiotype

C.19IQSwitchIQ

C.20videoswitchfrequencyifbwHzbadratebit/s10commsystemantennaselect选择天线名字（如果无此输入参数表示由接收机选择默认天线）

C.18audiotype

C.19IQSwitchIQ

C.20frequencydemodmodeDB21/T

3098—2018B.1.14数字广播信号解调（B_DigBroadcastDem）式的数字广播信号的解调，可用于观察数字广播信号的内容。该服务可选控制指令参数见表B.15。表

B.15

B_DigBroadcastDem）可选控制指令参数B.1.15 专用通信系统信号解调（B_SpecCommSysSglDem）通信内容。该服务可选控制指令参数见表B.16。表

B.16

专用通信系统信号解调（）可选控制指令参数B.1.16占用度测量（B_OccuMeas）该服务可选控制指令参数见表B.17。表

B.17

占用度测量（B_OccuMeas）可选控制指令参数 antennaselect

C.18frequencyifbwspan中频带宽≤

Hzrbwdetector

fftsamples

rfmode

C.1110rfattenuation11rfattvaluedB12gainC.1213mgc

dBantennaselectstartfreqstopfreqstepifbw

step

thresholdtype

C.16thresholdthresholdmargindB

C.18DB21/T

3098—2018B.1.17生成中频频谱模板（B_GenIFSpecTemp）入到模板文件，如果模板采集时间较长，可以考虑用最新的缓存数据定时覆盖文件内容。该服务可选控制指令参数见表B.18。表

B.18

B_GenIFSpecTemp）可选控制指令参数B.1.18生成宽带频谱模板（B_GenWBSpecTemp）该服务用于控制具有宽带的数据写入到模板文件，如果模板采集时间较长，可以考虑用最新的缓存数据定时覆盖文件内容。该服务可选控制指令参数见表B.19。表

B.19

B_GenWBSpecTemp）可选控制指令参数 27antennaselect

C.18startfreqstopfreqstepifbw

step

holdtimedetector

rfmode

C.1110gainC.1211mgc

dB12rfattenuation13rfattvaluedBantennaselect

C.18frequencyspan中频带宽≤

Hzrbwdetector

rfmode

C.11rfattenuationrfattvaluedB10gainC.1211mgc