GY
中华人民共和国广播电视和网络视听行业标准
GY/T 410—2024
有线电视单向网关与 4K 超高清晰度插入式
微型机顶盒的交互协议规范
Specification of interaction protocol between the unidirectional gateway of cable
television and the 4K ultra high definition pluggable mini set-top box
2024 - 10 - 14 发布
2024 - 10 - 14 实施
国家广播电视总局 发 布
GY/T 410—2024
目 次
前言 ............................................................................... III
1 范围 .............................................................................. 1
2 规范性引用文件 .................................................................... 1
3 术语和定义 ........................................................................ 1
4 缩略语 ............................................................................ 1
5 通则 .............................................................................. 2
6 功能要求 .......................................................................... 3
概述 .......................................................................... 3
设备发现 ...................................................................... 3
节目搜索 ...................................................................... 3
清流节目播放 .................................................................. 3
加扰节目播放 .................................................................. 4
网关设备管理 .................................................................. 4
网关信息查询 .................................................................. 4
事件信息发送 .................................................................. 4
安全功能 ...................................................................... 4
7 接口要求 .......................................................................... 4
通则 .......................................................................... 4
设备发现 ...................................................................... 5
资源申请 ...................................................................... 9
锁频设置 ..................................................................... 11
PID 过滤设置 .................................................................. 12
信号质量查询 ................................................................. 13
卡状态查询 ................................................................... 14
卡复位 ....................................................................... 14
机卡通信 ..................................................................... 15
故障信息查询 ................................................................ 16
设备管理 .................................................................... 16
网关信息查询 ................................................................ 19
通信密钥协商 ................................................................ 21
设备身份认证 ................................................................ 21
消息报文 .................................................................... 23
基于以太网口的数据传输格式 .................................................. 24
基于 USB 口的数据传输格式 .................................................... 24
8 流程要求 ......................................................................... 25
设备发现 ..................................................................... 25
节目搜索 ..................................................................... 29
清流节目播放 ................................................................. 30
加扰节目播放 ................................................................. 31
网关升级 ..................................................................... 32
I
GY/T 410—2024
附录 A（资料性） 条件接收 ........................................................... 36
A.1 有卡 CA ....................................................................... 36
A.2 无卡 CA ....................................................................... 38
附录 B（规范性） 安全机制 ........................................................... 39
B.1 概述 ......................................................................... 39
B.2 设备认证 ..................................................................... 39
B.3 安全通信模式 ................................................................. 40
B.4 TS 再加密 ..................................................................... 42
参考文献 ............................................................................ 44
II
GY/T 410—2024
前
言
本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定
起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由全国广播电影电视标准化技术委员会（SAC/TC 239）归口。
本文件起草单位：国家广播电视总局广播电视科学研究院、中国广电网络股份有限公司、江苏省广
电有线信息网络股份有限公司、东方有线网络有限公司、北京歌华有线电视网络股份有限公司、深圳市
茁壮网络股份有限公司、国微集团（深圳）有限公司、苏州龙擎视芯集成电路有限公司、北京数码视讯
科技股份有限公司、北京永新视博数字技术有限公司、北京数字太和科技有限责任公司。
本文件主要起草人：赵翠、刘建国、解伟、万涛、王野秋、安亚超、姚辉军、王明敏、董原、朱里
越、陈宝霞、朱允斌、张辰、徐佳宏、刘若鋆、彭美意、谢天、梁涛、祁娟、刘荣军、吴英栋、廖凌、
田江明、田雪冰、李金库、郑力铮、廖凌。
III
GY/T 410—2024
有线电视单向网关与 4K 超高清晰度插入式
微型机顶盒的交互协议规范
1 范围
本文件规定了有线电视单向网关与4K超高清晰度插入式微型机顶盒应用软件之间的交互协议。
本文件适用于有线电视单向网关及其连接的客户端的应用软件的开发、联调与测试。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，
仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本
文件。
GY/Z 175—2001 数字电视广播条件接收系统规范
GY/T 408—2024 4K超高清晰度插入式微型机顶盒技术要求和测量方法
GY/T 409—2024 有线电视单向网关技术要求和测量方法
3 术语和定义
下列术语和定义适用于本文件。
安全通信模式 secure communication mode
在HTTP基础上通过传输加密和身份认证过程实现对有线电视单向网关部分接口进行安全访问的通
信机制。
SM3 算法 SM3 algorithm
一种密码杂凑算法，其输出为256bit。
SM4 算法 SM4 algorithm
一种分组密码算法，分组长度为128bit，密钥长度为128bit。
AES128 算法 AES128 algorithm
一种分组密码算法，分组长度为128bit，密钥长度为128bit。
BASE64 编码 BASE64 encoding
一种将二进制数据转换为ASCII字符的编码方法。
消息摘要 message digest
一种通过对消息进行哈希运算而生成的固定长度的数据摘要。
ECDH 密钥交换算法 ECDH key exchange algorithm
一种基于椭圆曲线的密钥交换协议。
4 缩略语
1
GY/T 410—2024
AES 高级加密标准（Advanced Encryption Standard）
APDU 应用协议数据单元（Application Protocol Data Unit）
APP 应用程序（Application）
ATR 复位应答（Answer To Reset）
CA 条件接收（Conditional Access）
CBC 密码分组链接（Cipher Block Chaining）
CW 控制字（Control Word）
DCAS 可条件接收系统（
Downloadable Conditional Access System）
DHCP 动态主机配置协议（Dynamic Host Configuration Protocol）
ECDH 椭圆曲线笛福-赫尔曼（Elliptic Curve Diffie-Hellman）
ECM 授权控制信息（Entitlement Control Message）
EMM 授权管理信息（Entitlement Management Message）
HFC 光纤-同轴电缆混合网（Hybrid Fiber Coaxial）
HKDF 基于HMAC的提取和扩展密钥派生函数（HMAC-based Extract-and-Expand Key Derivation
Function）
HTTP 超文本传输协议（Hyper Text Transfer Protocol）
ID 标识符（Identifier）
IP 互联网协议（Internet Protocol）
MAC 媒体访问控制（Media Access Control）
MD5 消息摘要5（Message Digest 5）
MEF 最大以太网帧个数（Maximum Ethernet Frames）
MTU 最大传输单元（Maximum Transmission Unit）
PID 包识别码（Packet Identifier）
PSI 节目特定信息（Program Specific Information）
QAM 正交幅度调制（Quadrature Amplitude Modulation）
RMACT 随机数-MAC地址-口令（Random-MAC-Token）
SECP 椭圆曲线密码学（Standards for Efficient Cryptography）
SHA 安全散列算法（Secure Hash Algorithm）
SI 业务信息（Service Information）
SSDP 简单服务发现协议（Simple Service Discovery Protocol）
TCP 传输控制协议（Transmission Control Protocol）
TS 传送流(Transport Stream)
UDP 用户数据报协议（User Datagram Protocol）
UPnP 通用即插即用（Universal Plug and Play）
URL 统一资源定位符（Uniform Resource Locator）
USB 通用串行总线（Universal Serial Bus）
UTC 协调世界时（Coordinated Universal Time）
UUID 通用唯一识别码（Universally Unique Identifier）
WAN 广域网（Wide Area Network）
5 通则
在采用HFC网络以数字电视广播方式传输直播业务的有线电视网络中，插入式微型机顶盒（以下简
称“机顶盒”）和有线电视单向网关（以下简称“网关”）配合使用，可以替代传统机顶盒，接收以广播
方式传输的有线电视直播节目。机顶盒应符合GY/T 408—2024的规定，网关应符合GY/T 409—2024的规
定。
网关接收以数字电视广播方式传输的有线电视节目，将这些节目以IP方式传送给机顶盒。机顶盒接
收来自网关以IP方式传输的节目内容，进行解码播放。
2
GY/T 410—2024
在功能上，网关实现对广播信号的接收、解调、解复用和解扰（可选）功能，机顶盒实现有线电视
PSI/SI的解析及频道节目信息的显示与处理，并实现节目信号的解码与显示等功能。机顶盒与网关配合
实现CA。
本文件规定机顶盒等终端设备的应用软件与网关之间的交互协议，分为协议交互和数据传输两部
分，见图1。协议交互主要通过网关提供的服务接口以及网关和机顶盒之间的消息报文来实现。数据传
输指网关根据机顶盒的设置将相应的媒体数据传送给机顶盒。通过与网关的协议交互和数据传输，机顶
盒从网关中获取到所需的节目报文，送到电视机上进行显示，满足用户的观看需求。
协议交互
应用软件 网关
数据传输
机顶盒等终端设备
图1 交互协议框架
机顶盒与网关的物理接口包括以太网接口和USB接口两种，应至少支持其中一种。物理接口决定了
网关和机顶盒之间的设备发现机制，同时决定了协议和数据报文的传输格式。网关和机顶盒之间的USB
口应采用USB2.0协议中规定的High-speed模式或USB2.0以上协议。
6 功能要求
概述
机顶盒与网关之间通过协议交互，实现的功能主要包括设备发现、节目搜索、清流节目播放、加扰
节目播放、网关设备管理、网关信息查询、事件信息发送和安全机制八类。
设备发现
设备发现指在同一局域网内机顶盒与网关之间建立连接的过程。机顶盒和网关都应支持设备发现
功能。设备发现协议取决于两者之间的物理接口。
对于以太网口的设备发现，应利用SSDP协议实现。机顶盒启动后应以5s为间隔发送搜索请求报文，
同时接收存续报文，与网关建立连接后，机顶盒停止发送搜索请求报文并停止接收存续报文；网关启动
后应以5s为间隔发送存续报文，并接收搜索请求报文，当与机顶盒建立连接后，网关应继续接收搜索请
求报文，并持续以5s为间隔发送存续报文。此外，本文件基于SSDP报文格式扩展定义广播存续报文，网
关启动后应以5s为间隔发送广播存续报文，机顶盒接收到广播存续报文应与网关建立连接。
对于USB口的设备发现，应包含基于USB协议枚举机制的设备识别和USB设备通信协商两个步骤。机
顶盒检测USB网关设备描述符，识别网关设备后与网关进行设备通信协商，双方获取对方的MAC地址且机
顶盒为网关设置IP地址，为后续通信做好准备。
节目搜索
节目搜索功能指通过频道节目的搜索，获取完整的频道列表数据。节目搜索为可选功能。在进行节
目搜索时，机顶盒调用网关提供的服务接口，实现资源申请、频点锁定、PSI/SI表数据过滤的PID设置。
网关根据机顶盒设置的PID过滤出PSI/SI表数据并发送给机顶盒，机顶盒接收并解析后生成频道列表数
据。机顶盒通过节目搜索获取频道列表数据并进行保存，为后续的直播频道播放做好准备。
清流节目播放
机顶盒通过与网关交互实现清流频道节目的播放。机顶盒通过读取节目搜索保存的频道列表数据
获得相应的频道节目信息，之后调用网关提供的服务接口，实现资源申请、频点的锁频、音视频数据过
3
GY/T 410—2024
滤的PID设置。网关根据机顶盒设置的PID过滤出清流频道节目的音视频TS数据并发送给机顶盒进行播
放。
加扰节目播放
机顶盒通过与网关交互实现加扰频道节目的播放，两者之间的交互流程取决于CA实现方式。
机顶盒和网关可根据业务需要集成CA模块和解扰模块，包括以下组合模式：
—— 机顶盒解扰：机顶盒集成 CA 模块和解扰模块，实现完整 CA 功能，宜支持无卡 CA；
—— 网关解扰：网关集成 CA 模块和解扰模块，实现完整 CA 功能，宜支持无卡 CA；
—— 基于拆分库的网关解扰：机顶盒集成 CA 主模块、网关集成 CA 子模块和解扰模块，具体规定
见附录 A；宜支持有卡 CA，符合 GY/Z 175—2001。
网关设备管理
机顶盒与网关交互实现对网关的管理和控制。网关应对外提供可管理配置的能力，具体功能包括系
统重启、恢复出厂设置、网关升级、加载CA程序、启用/停用无卡CA以及与安全通信模式有关的参数设
置等。
网关信息查询
机顶盒与网关交互实现对网关进行信息查询。网关应对外提供信息查询能力，包括网关的IP地址和
MAC地址、设备简要信息（如设备ID等）、资源信息（如调谐器数量等）、CA相关信息、故障信息以及
安全通信模式相关信息等。机顶盒基于查询到的网关信息，确定对调用网关接口时的请求参数以及是否
采用安全通信模式。
事件信息发送
网关设备对外主动发送消息，用于向机顶盒报告网关的状态信息，包括锁频状态、智能卡状态、故
障信息和系统升级等信息。
安全功能
分为用于控制终端接入的设备认证功能、用于接口访问的安全通信模式和用于视频流数据传输安
全的TS再加密功能，均为必选功能。机顶盒为安全功能的发起方。
设备认证功能用来实现机顶盒与网关两端设备的身份互相认证，保证通信两端的身份合法性。
安全通信模式是指，在HTTP基础上通过传输加密和身份认证过程实现对网关部分接口进行安全访
问的通信机制。在安全通信模式下，机顶盒应采用HTTP安全通信方式访问资源申请接口、机卡通信接口
和设备管理接口。
当网关具备CA解扰能力时，为保证解扰后的TS包在网关和机顶盒之间的传输安全，网关和机顶盒应
支持TS再加密功能，即网关对解扰的TS包进行再加密，机顶盒接收到加密数据后进行解密。TS再加密功
能仅作用于TS流中原本加扰并在网关上解扰的视频数据包，并非TS流中的所有数据包。
安全机制应符合附录B的规定。安全通信模式和TS再加密功能均要求网关和机顶盒要先进行密钥协
商。在本文件中，密钥协商和设备认证只是功能目标描述不同，实现过程完全一致，都是先利用通信密
钥协商进行密钥协商，再利用设备身份认证进行认证，只有认证通过后协商的密钥才有效，双方才可进
行后续正常通信。
7 接口要求
通则
机顶盒和网关之间定义1类接口协议、12个服务接口和1种消息格式，见表1。其中1类接口协议为设
备发现协议，分为基于SSDP协议的设备发现和基于USB接口的设备发现，机顶盒和网关都应支持设备发
现；12个服务接口为网关提供的服务接口，供机顶盒调用；1种消息格式为机顶盒与网关之间约定的消
息报文格式，用于网关主动推送消息及机顶盒实现消息接收。
4
GY/T 410—2024
表1 接口和消息定义
序号 名称 接口提供方
1 设备发现 —
2 资源申请接口 有线电视单向网关
3 锁频设置接口 有线电视单向网关
4 PID 过滤设置接口 有线电视单向网关
5 信号质量查询接口 有线电视单向网关
6 卡状态查询接口 有线电视单向网关
7 卡复位接口 有线电视单向网关
8 机卡通信接口 有线电视单向网关
9 故障信息查询接口 有线电视单向网关
10 设备管理接口 有线电视单向网关
11 网关信息查询接口 有线电视单向网关
12 通信密钥协商接口 有线电视单向网关
13 设备身份认证接口 有线电视单向网关
14 消息报文 —
网关的服务接口通过 HTTP 协议进行调用，其中资源申请接口、机卡通信接口和设备管理接口还支
持通过 HTTP 安全通信方式进行调用。当开启安全通信模式时，机顶盒应采用 HTTP 安全通信方式对资源
申请接口、机卡通信接口和设备管理接口进行调用，报文格式和交互流程应符合 B.2 的规定。
机顶盒调用接口时，若网关发现不支持该接口，网关应返回 HTTP 状态码 404，表示不支持该接口。
设备发现
7.2.1 基于以太网口
网关和机顶盒之间通过以太网口连接时，双方采用SSDP协议中规定的搜索请求报文和存续报文或
基于SSDP协议扩展定义的广播存续报文实现设备的发现。网关和机顶盒应根据所获取的IP地址类型发
送对应的设备发现报文。
SSDP组播地址应符合表2的定义。
表2 组播地址定义
序号 组播地址 端口号 描述
1 239.255.255.250 1900 IPv4
2 FF0x::C 1900 IPv6
搜索请求报文格式应符合表3的定义。
表3 搜索请求报文
序号 报文 内容 描述
1 M-SEARCH * HTTP/1.1 搜索请求报文
2 HOST 组播地址和端口号 指定了请求的目标主机和端口，取值固定，见表 2
3 ST urn:schemas-upnp-org:device:device- Type:version 指定搜索的目标，其中： device-Type 字 段 的 取 值 默 认 为
CableGatewayDevice，表明指定搜索的设备类型为 网关设备； version 字段的默认取值为 1，表明设备的版本
4 MAN "ssdp:discover" 搜索请求的标识符
5 MX N N 为设备等待响应时长，单位为秒（s）
搜索应答报文格式应符合表4的定义。
5
GY/T 410—2024
表4 搜索应答报文
序号 报文 内容 描述
1 HTTP/1.1 200 OK 请求成功
2 HOST 组播地址和端口号 指定组播地址和端口，取值固定，见表 2
3 Cache- Control max-age=N N 为指定通知消息存活时间，单位为秒（s）
4 Location http://ip:port/get_info 指定网关设备的地址和端口，其中 ip 为网关设备 的 IP 地址；port 为网关设备的端口号；get_info 表示可以从该接口获取网关信息
5 NT upnp:rootdevice UPnP 标识符，指示设备类型为根设备
6 USN uuid:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ::upnp:rootdevice 网 关 设 备 的 唯 一 标 识 符 ， 其 中 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 为网关设备的 UUID
存续报文格式应符合表5的定义。
表5 存续报文
序号 报文 内容 描述
1 NOTIFY * HTTP/1.1 设备通知报文
2 HOST 组播地址和端口号 指定组播地址和端口，取值固定，见表 2
3 Cache- Control max-age=N N 为指定通知消息存活时间，单位为秒（s）
4 Location http://ip:port/get_info 指定网关设备的地址和端口，其中 ip 为网关设 备的默认 IP 地址；port 为网关设备的端口号； get_info 表示可以从该接口获取网关信息
5 NT upnp:rootdevice UPnP 标识符，指示设备类型为根设备
6 NTS ssdp:alive 网关设备存在信息
7 USN uuid:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ::upnp:rootdevice 网 关 设 备 的 唯 一 标 识 符 ， 其 中 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 为网关设备 的 UUID
广播方式发送存续报文格式应符合表6的定义，该报文仅用于IPv4网络。
表6 广播存续报文
序号 报文 内容 描述
1 NOTIFY * HTTP/1.1 设备通知报文
2 HOST xxx.xxx.xxx.255:19000 指定设备所在局域网的广播地址和端口，取值固 定
3 Location http://ip:port/get_info 指定网关设备的地址和端口，其中ip为网关设备 的默认IP地址；port为网关设备的端口号； get_info表示可以从该接口获取网关信息
4 ST urn:schemas-upnp-org:device:device- Type:version 指定网关设备的标识，其中： device-Type字段的取值默认为 CableGatewayDevice，表明指定搜索的设备类型 为网关设备； version字段的默认取值为1，表明设备的版本
5 MX N N为设备等待响应时长，单位为秒（s）
下线报文格式应符合表7的定义。
6
GY/T 410—2024
表7 下线报文
序号 报文 内容 描述
1 NOTIFY * HTTP/1.1 设备通知报文
2 HOST 组播地址和端口号 指定组播地址和端口，取值固定，见表2
3 NTS ssdp:byebye 网关设备下线信息
4 USN uuid:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx: :upnp:rootdevice 网关设备的唯一标识符，其中 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx为网关设备的 UUID
7.2.2 基于 USB 口
7.2.2.1 概述
当网关与机顶盒通过USB口连接时，设备发现过程包含两个步骤，首先机顶盒与网关之间应完成USB
设备识别，然后机顶盒还应完成与网关设备的通信协商。只有成功完成通信协商，机顶盒和网关之间才
可以开始后续业务流程。
7.2.2.2 基于 USB 的设备识别
网关和机顶盒之间通过USB协议的枚举机制完成设备识别过程。机顶盒为主设备，网关为从设备。
应采用USB2.0协议第9.6.5规定的接口描述符描述网关设备，接口描述符中部分参数的取值应符合表8
的定义，同时该接口的字符串描述符应设为“Cable TV unidirectional gateway interface”。
表8 接口描述符参数取值
字段名称 长度/字节 取值 取值说明
bInterfaceClass 1 0xFFH 根据USB协议，取值为0xFFH，表示本接口为厂商定义
bInterfaceSubClass 1 0xC0 表示为有线电视单向网关
bInterfaceProtocol 1 0x01
机顶盒应根据接口子类码、协议码和接口字符串三个参数，识别出插入的USB设备为有线电视单向
网关设备。若机顶盒不支持字符串描述符，则根据接口子类码和协议码来进行识别。
网关和机顶盒之间的 USB 接口应包含两个端点，用于协议交互和数据传输。应采用 USB2.0 协议第
9.6.6 规定的端点描述符对端点进行描述。两个端点中，一个为批量传输入端点，端点描述符中部分参
数的取值应符合表 9 的定义；一个为批量传输出端点，端点描述符中部分参数的取值应符合表 10 的定
义。为保证传输效率，端点容量应至少为 512Byte。
表9 入端点的端点描述符参数取值
字段名称 长度/字节 取值 取值说明
bEndpointAddress 1 Bit7 = 1 Bit7：表示端点的数据传输方向，取值0b1代表入端点
bmAttributes 1 Bit1-0 = 10 Bit1-0：表示端点的传输类型，取值0b10代表批量传输
表10 出端点的端点描述符参数取值
字段名称 长度/字节 取值 取值说明
bEndpointAddress 1 Bit7 = 0 Bit7：表示端点的数据传输方向，取值0b0代表出端点
bmAttributes 1 Bit1-0 = 10 Bit1-0：表示端点的传输类型，取值0b10代表批量传输
7.2.2.3 基于 USB 的设备通信协商
在完成 USB 设备识别后，网关和机顶盒应先进行设备通信协商，即网关和机顶盒之间按序进行
MAC 地址查询和 IP 地址设置。协商完成后，双方均应具备有效的 MAC 地址和 IP 地址，并得到对方的
MAC/IP 地址信息。只有完成设备通信协商，才可以开始业务流程。
设备通信协商报文包括 MAC 地址信息查询报文、MAC 地址信息查询回复报文、IP 地址设置报文、
IP 地址设置回复报文，报文格式为以太网帧，应分别符合表 11～表 14 的定义。
7
GY/T 410—2024
在设备通信协商时，首先进行 MAC 地址信息查询，机顶盒应向网关发送 MAC 地址信息查询报文，
网关接收到报文后应返回 MAC 地址信息查询回复报文，其中应包含网关的实际 MAC 地址和网关支持的
业务通信协议；然后机顶盒为网关设置 IP 地址，机顶盒应发送 IP 地址设置报文，为网关设置通信的
IP 地址，网关接收到报文后应发送对应的回复报文，一旦机顶盒接收到回复报文，表明通信协商过程
完成。
表11 MAC 地址信息查询报文
字段名称 长度 取值/参数 描述
目的 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
源 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
数据类型 2Byte EA 86 固定值
数据负载 ＜1500Byte /query_macaddr_info 固定值，查询网关的 MAC 地址信息
表12 MAC 地址信息查询回复报文
字段名称 长度 取值/参数 描述
目的 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
源 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
数据类型 2Byte EA 86 固定值
数据负载 ＜1500Byte Reply 查询成功与否的标志，取值为： ok：成功； failed：失败
MAC 网关的 MAC 地址，十六进制表示并用“-”隔开
Data-Protocol 网关支持的通信协议类型，多个协议项之间用逗 号','隔开；网关应支持 IPv4、IPv6，可选支持 ARP、802.1Q 等
IP 网关的 IP 地址，没有时为空白
Reason 失败原因，只有请求失败时才返回
MEF 网关支持的一次 USB Bulk Transfer 中可封装的 以太网帧最大个数，不设置时默认为 1
表13 IP 地址设置报文
字段名称 长度 取值/参数 描述
目的 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
源 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
数据类型 2Byte EA 86 固定值
数据负载 ＜1500Byte /set_ip?ip=aaa.aaa.aaa.a aa(或 xxxx:xxxx:xxxx:xxxx:xxxx :xxxx:xxxx:xxxx)&mac=**- **-**-**-**- **&subnet=a&mef=b&vlan=c 参数说明如下： ip：对网关设置的 IP 地址； mac：上述网关的 MAC 地址，十六进制表示并用 “-”隔开； subnet：子网掩码的位宽，可选参数。对于 IPv4 地址，该参数不指定时默认为 24（即高 24bit）， 对于 IPv6 地址默认为 64； mef a：对网关设置一个 USB transfer 中最多可 负载的以太网帧数量； vlan：对所设置的 IP 地址指定以太网帧的 VLAN TAG 值，使用 802.1Q 以太帧格式，为可选参数
8
GY/T 410—2024
表 13（续）
字段名称 长度 取值/参数 描述
a 客户端根据自身和网关的支持能力，确定一个 USB transfer 中最多可负载的以太网帧数量后设置给网关。
表14 IP 地址设置回复报文
字段名称 长度 取值/参数 描述
目的 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
源 MAC 地址 6Byte FF:FF:FF:FF:FF:FF 固定值
数据类型 2Byte EA 86 固定值
数据负载 ＜1500Byte Reply 设置成功与否的标志，取值为： ok：成功； failed：失败
IP 网关的 IP 地址
MAC 网关的 MAC 地址，十六进制表示并用“-” 隔开
Location 资 源 快 速 访 问 路 径 ， 格 式 为 ： http://ip:port/get_info，其中 ip 为网关 的 IP 地址；port 为网关设备的端口号； get_info 表示可以访问网关信息查询接口
Reason 失败原因，请求失败的时候才返回
表12和表14中，数据负载的格式定义为Key: valuern，其中“:”为英文半角，与value之间应有
一个空格，结束行为rn。
表12的数据负载示例：
Reply: okrnMAC: 74-84-E1-07-7D-D0rnData-Protocol: IP,ARP,802.1QrnIP: 10.168.22.1rnrn
资源申请
机顶盒在使用网关资源之前，应先调用资源申请接口与网关协商资源操作口令并申请所需资源的
使用权，并在资源使用过程中，以5s为时间间隔调用此接口对使用权进行续期。网关应根据接口请求参
数中的clientuuid为调用该接口的机顶盒分配或保留相应资源，当超过10s未接收到资源续期时，网关
应将相应的资源回收，并停止数据的转发。若启用了安全通信模式，则本接口纳入管控。
接口URL：http://ip:port/reserve_resource。
接口协议：HTTP GET。
接口请求参数应符合表15的定义。
表15 资源申请接口请求参数
参数名称 类型 是否必选 描述
clientuuid 字符串 是 客户端 APP 的 UUID，为客户端 APP 的标识
clientip 字符串 是 客户端设备的 IP 地址
rtoken 字符串 是 资源操作口令，为随机字符串(a-zA-Z0-9)，长度不小于 8Byte
tuner 字符串 否 申请占用/保留的调谐器的数量，取值为： m：代表 m 个调谐器，m 为整数，取值应不超出从网关信息查询接口 的调谐器参数获取的可用调谐器的总数； all：代表全部调谐器
9
GY/T 410—2024
表 15（续）
参数名称 类型 是否必选 描述
descrambler 字符串 否 申请占用/保留的解扰器数量，取值为： n：代表 n 个解扰器，n 为整数，取值应不超出从网关信息查询接口 的 Descrambler 参数获取的可用解扰器的总数； all：代表全部解扰器
smartcard 字符串 否 申 请 占 用 / 保 留 智 能 卡 资 源 ， 应 先 从 网 关 信 息 查 询 接 口 的 Smartcard-Status 参数获取智能卡状态 all：代表申请占用/保留智能卡资源
submsg 字符串 否 指定要订阅的消息 default：订阅除故障信息外的消息； all：订阅所有消息； lock：订阅锁频状态消息； card：订阅卡插拔消息； malfunction：订阅故障信息
subport 字符串 是 指定接收订阅消息的 UDP 端口
调用者生成随机数作为令牌，申请占用所有资源，指定消息接收端口以及客户端的IP地址，资源申
请接口请求参数示例：
http://ip:port/reserve_resource?clientuuid=aff1dc1e7f3c43a0b14bd13f2c5026ac& rtoken=a3cbda7162&descrambler=all&smartcard=all&tuner=all&submsg=all&subport=50067&clientip=192.168.1 .101
调用者申请保留一个调谐器，不占有智能卡、解扰器等资源，监听锁频消息，指定消息接收端口和
客户端的IP地址，资源申请接口请求参数示例：
http://ip:port/reserve_resource?clientuuid=aff1dc1e7f3c43a0b14bd13f2c5026ac&rtoken=a3cbda7162&tuner=1 &submsg=lock&subport=50067&clientip=192.168.1.101
接口返回参数应符合表16的定义。
表16 资源申请接口返回参数
参数名称 类型 是否必选 描述
Reply 字符串 是 申请成功与否的标志，取值为： ok：成功； failed：失败
Tuner-Size 数值 是 分配的调谐器数量，取值为： x：代表已分配 x 个调谐器，x 为整数
Descrambler-Size 数值 是 分配的解扰器数量，取值为： y：代表已分配 y 个解扰器，y 为整数
Smartcard-Size 数值 是 分配智能卡资源（卡/卡槽）的结果，取值为： 0：代表未分配智能卡资源； 1：代表已分配智能卡资源
MSGNAT a 字符串 否 指示接收网络穿透报文的 IP 地址和端口号
Reason 字符串 否 失败原因，只在失败的时候返回，取值定义为： Bad parameter：请求参数错误； Res already reserved：资源被占用； 其他可自定义
a 参数取值不为空时，客户端设备应按照 7.16 的规定定期向网关发送穿透报文
请求成功时，资源申请接口返回参数示例：
10
GY/T 410—2024
Reply: ok Tuner-Size: 1 Descrambler-Size: 2 Smartcard-Size: 1 MSGNAT: 192.168.88.1:34621
请求失败时，资源申请接口返回参数示例：
Reply: failed Reason: Bad parameter
锁频设置
网关对外提供锁频设置接口，用于根据接口调用方设置的参数锁定对应频点。网关应根据接口参数
中的Userhandle对相应的调谐器进行频点设置。若启用了安全通信模式，则本接口纳入管控。
接口URL：http://ip:port/lock_delivery。
接口协议：HTTP GET。
接口请求参数应符合表17的定义。
表17 锁频设置接口请求参数
参数名称 类型 是否 必选 描述
userhandle 数值 是 客户端的上下文句柄，取值为客户端当前操作所对应的调谐器 资源的序号。客户端对申请保留的每个调谐器资源分配序号， 序号的取值从1开始，最大值为保留调谐器的数量。网关利用该 参数区分客户端的操作所对应的调谐器。
rtoken 字符串 是 资源操作口令，与调用资源申请接口时协商的口令一致
usertick 数值 是 计时时间戳，每次锁频时的客户端系统时间，毫秒值，整数， 取值为基于UTC 1970年01月01日00时00分00秒至当前时间的总 毫秒数
delivery 字符串 是 传输方式，取值定义为： DVB-C：有线； DTMB：地面无线
freq 字符串 是 频点的物理参数，格式为：频点.符号率.调制方式，其中频点 单位为Hz、符号率单位为baud、调制方式取值为QAM调制的阶 数
pids 字符串 是 PID 列表，多个 PID 以','隔开，例如 Pids=0,1,20,45，取值定 义为： -1：全通过滤； -2：无空包全通过滤； 0～8191：TS 中的 PID； PID列表为空：不接收任何TS流
target 字符串 是 TS 报文的接收方的 IP 地址和 UDP 端口
gwse 字符串 否 启用 TS 再加密，并设置 TS 再加密的算法和密钥 KT，设置格式 为（算法名称，Key-ID，“密钥 KT+初始向量 IV”的密文）
在表17中，参数gwse的设置格式分为三段，描述如下。
—— 算法名称：指 TS 再加密要采用的算法，取值见网关信息查询接口的返回参数 GWSE-Alg。
—— Key-ID：指通信密钥协商和设备身份认证确定的对称密钥的 Key-ID。
—— “密钥 KT+初始向量 IV”的密文：共 32Byte。其中密钥 KT 指用于 TS 再加密算法。“密钥
KT+初始向量 IV”的明文为随机生成的 32Byte 二进制数，其中前 16Byte 为密钥 KT，后
16Byte 为初始向量 IV；通过密钥协商的对称密钥算法及 Key-ID 所对应的对称密钥对密钥 KT
和初始向量 IV 进行加密后，再进行 BASE64 编码得到“密钥 KT+初始向量 IV”的密文。
11
GY/T 410—2024
锁频设置接口请求参数示例：
http://ip:port/lock_delivery?delivery=DVB-C&freq=411000000.6875.64QAM&pids=0,1& userhandle=1&rtoken=a3cbda7162&usertick=2312321&target=192.168.88.103:43221&gwse=AES128- CBC,Adfk1e3ia5Po,Igkfie1239Gaskdjfielasdkfje12894eboa34e6nw6==
接口返回参数应符合表18的定义。
表18 锁频设置接口返回参数
参数名称 类型 是否必选 描述
Reply 字符串 是 设置成功与否的标志，取值为： ok：成功； failed：失败； nat：子网穿透，需要客户端发送穿透报文
Target 字符串 否 目标客户端的 IP 地址与 UDP 端口，不穿透时应返回
NAT 字符串 否 穿透报文的目标地址和端口，需要子网穿透时返回
MX 数值 否 穿透报文的时间间隔，单位为秒（s），不设置时默认取值为 10， 需要子网穿透时返回
Reason 字符串 否 失败原因，只在失败时返回，取值定义为： Request parameter exception：请求参数错误； res reserved by other client：资源被占用； have not reserving resources：还没有申请占用资源； resource has expired：申请的资源已过期； Frequency locking failure：调用锁频接口返回失败； 其他可自定义
请求成功时，锁频设置接口返回参数示例：
Reply: ok Target: 192.168.88.103:43221
需要发送穿透报文的场景中，客户端锁频时，网关返回穿透报文的信息，锁频设置接口返回参数示
例：
Reply: nat NAT: 192.168.88.1:34621 MX: 10
PID 过滤设置
网关对外提供PID过滤设置接口，用于根据接口调用方设置的PID过滤对应的数据。
接口URL：http://ip:port/set_pids。
接口协议：HTTP GET。
接口请求参数应符合表19的定义。
表19 PID 过滤设置接口请求参数
参数名称 类型 是否必选 描述
userhandle 数值 是 客户端的上下文句柄，与表 18 中的描述相符合
rtoken 字符串 是 资源操作口令，与调用资源申请接口时协商的口令一致
usertick a 数值 是 客户端锁频时所发送的计时时间戳，毫秒值，整数，取值为基 于 UTC 1970 年 01 月 01 日 00 时 00 分 00 秒至当前时间的总毫 秒数
count 数值 是 客户端锁频后调用 PID 过滤设置接口进行计数，count 参数值 从 0 开始，每次递增 1
12