logo资料库

TR069协议规范.doc

发布时间：2022-06-18 发布人：admin 分类：说明书 资料大小：9.82M 资料格式：doc 举报 版权申诉
第1页 / 共94页
第2页 / 共94页
第3页 / 共94页
第4页 / 共94页
第5页 / 共94页
第6页 / 共94页
第7页 / 共94页
第8页 / 共94页
资料共94页，剩余部分请下载后查看
    1、IPTV 机顶盒 与终端管理系统接口（S6接口）
    1.1 S6 接口概述
    1.2 机顶盒与终端管理系统的接口安全
    1.2.1 机顶盒主动发起的安全连接流程
    1.2.2 终端管理系统主动发起的安全连接流程
    1.3 机顶盒注册认证接口（S6-1）
    1.3.1 机顶盒首次开机认证注册
    1.3.1.1 业务流程描述
    1.3.1.2 接口协议内容
    1.3.2机顶盒非首次开机认证注册
    1.3.2.1 业务流程描述
    1.3.2.2 接口协议内容
    1.4 机顶盒业务与配置管理接口（S6-2）
    1.4.1 获取机顶盒业务信息
    1.4.1.1 业务流程描述
    1.4.1.1.1 业务信息改变时机顶盒的主动上报
    1.4.1.1.2 终端管理系统主动获取业务信息
    1.4.1.2 接口协议内容
    1.4.1.2.1 业务信息改变时机顶盒的主动上报
    1.4.1.2.2 终端管理系统主动获取业务信息
    1.4.2 获取机顶盒配置信息
    1.4.2.1 流程描述
    1.4.2.1.1 机顶盒配置信息变更时机顶盒主动的上报
    1.4.2.1.2 终端管理系统主动获取机顶盒配置信息
    1.4.2.2 接口协议内容
    1.4.2.2.1 机顶盒配置信息变更时机顶盒主动的上报
    1.4.2.2.2 终端管理系统主动获取机顶盒配置信息
    1.4.3 设置机顶盒业务与配置信息
    1.4.3.1 流程描述
    1.4.3.2 接口协议内容
    1.4.4 终端管理系统要求机顶盒重启
    1.4.4.1 流程描述
    1.4.4.2 接口协议内容
    1.4.5 终端管理系统要求机顶盒恢复出厂设置
    1.4.5.1 流程描述
    1.4.5.2 接口协议
    1.5 机顶盒版本管理接口（S6 - 3）
    1.5.1 机顶盒加电自动升级
    1.5.1.1 流程描述
    1.5.1.2 接口协议内容
    1.5.2 终端管理系统主动控制机顶盒升级
    1.5.2.1 流程描述
    1.5.2.2 接口协议内容
    1.6机顶盒状态性能管理接口（S6-4）
    1.6.1 状态性能参数实时上报
    1.6.1.1 流程描述
    1.6.1.1.1 协议方式上报
    1.6.1.1.2 文件方式上报（可选）
    1.6.1.2 接口协议内容
    1.6.1.2.1 协议方式上报
    1.6.1.2.2 文件方式上报
    1.6.2 状态性能参数定时上报
    1.6.2.1 流程描述
    1.6.2.1.1 协议方式上报（可选）
    1.6.2.1.2 文件方式上报
    1.6.2.2 接口协议内容
    1.6.2.2.1 协议方式上报（可选）
    1.6.2.2.2 文件方式上报
    1.7机顶盒故障诊断接口（S6-5）
    1.7.1 机顶盒 PING 故障诊断
    1.7.1.1本流程是由终端管理系统主动发起的要求机顶盒进行PING
    1.7.1.2接口协议内容
    1.7.2机顶盒 TRACERT 故障诊断
    1.7.2.1流程描述
    1.7.2.2接口协议内容
    附录 A（规范性附录） RPC XML Schema
    A.1 XML Schema 文件头
    A.2 SOAP 信包头
    A.3 SOAP 错误代码
    A.4 RPC 方法描述
    A.4.1 机顶盒 RPC 方法
    A.4.2 终端管理系统 RPC 方法
    A.5 RPC 方法参数类型定义
    A.6 RPC 方法请求/响应
    附录 B STBID 与 TR-069 对应规则
    B.1 STBID 定义
    B.2 STBID 结构说明
    B.3 STBID 与 TR-069 对应规则
    附录 C数据模型
    C.1 根节点
    C.2 通用数据模型
    C.3 机顶盒数据模型
    C.4 设备详细信息
    C.5 网管信息参数
    C.6 网关信息
    C.7 设备普通配置参数
    C.8 时间配置参数
    C.9 用户接口相关参数
    C.10 LAN 接口参数
    C.11 DHCP 参数配置
    C.12 LAN 状态参数
    C.13 Ping 诊断参数
    C.14 路由主机参数
    C.15 IPTV 扩展参数
    附录 D 状态性能参数文件说明
    IPTV 机顶盒与终端管理系统接口要求 中国电信集团上海市电信公司 2008 年 9 月 8 日 1、IPTV 机顶盒 与终端管理系统接口（S6 接口） 1.1 S6 接口概述 本章以 DSLForum TR-069 Amendment 2（CWMP V1.1）为基础，定义了机顶 盒与终端管理系统之间的接口，并参考 TR-106 Amendment 1 及 TR-135 给出数 据模型用于定义机顶盒的参数集。 本章根据具体业务需要给出终端管理系统各功能模块，并采用 TR-069 描述 的 RPC 方法，对其接口业务流程进行定义，所涉及所有 RPC 方法流程均与 TR-069 保持一致。 本章中描述的接口在 IPTV 端到端系统中的位置如下图中红框所示： 图 1-1-1 规范规定接口在端到端系统中的位置 如图所示，本章仅针对能够通过 WAN 方式直接访问的机顶盒与终端管理系 统连接的机顶盒进行接口定义，涉及 NAT 穿越的情况暂时不做描述。 规范中定义的机顶盒与终端管理系统之间的接口采用 DSLForum 的 TR-069 标准进行通信，机顶盒在开机后首先通过本规范定义的接口与终端管理系统连 PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    接，无论机顶盒是否通过终端管理系统的认证，都将继续访问业务认证系统进行 业务使用认证。本规范中定义的机顶盒与终端管理系统之间具有以下接口模块： 1) 注册认证接口（S6 - 1） 2) 业务与配置管理接口（S6 - 2） 3) 版本管理接口（S6 - 3） 4) 业务性能监测接口（S6 - 4） 5) 故障诊断接口（S6 - 5） 1) 注册认证接口（S6 - 1） 图 1-1-1 机顶盒与终端系统的接口框图 注册认证接口（S6 - 1）主要完成机顶盒首次开机注册认证及非首次开机 连接认证的功能，终端管理系统根据机顶盒信息，对机顶盒进行合法身份的 注册认证。 2) 业务与配置管理接口（S6 - 2） 终端管理系统通过 S6 - 2 接口实现对于机顶盒配置及业务能力的管理， 用于配合业务管理系统完成机顶盒的业务能力的查询和业务的适配。同时， S6-2 接口能够实现对机顶盒参数的配置，定义参数配置方式和分组方式。 3) 版本管理接口（S6 - 3） 版本管理接口（S6 – 3）接口用于终端管理系统对机顶盒软件、固件、硬件 版本等信息进行维护。 4) 状态、性能与统计管理接口（S6 - 4） 状态、性能与统计管理接口（S6 – 4）用于终端管理系统对机顶盒的设备信 息、状态参数及性能参数进行实时收集和管理，并将得到的状态及性能信息进行 统计。 PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    5) 故障诊断接口（S6 - 5） 故障诊断接口（S6 – 5）用于终端管理系统发起机顶盒自检或机顶盒故障上 报。 1.2 机顶盒与终端管理系统的接口安全 本节中描述机顶盒与终端管理系统安全连接的建立过程，后续所有流程均需 满足本节中规定的安全连接方式。 1.2.1 机顶盒主动发起的安全连接流程 图 1-2-1-1 机顶盒主动发起的安全连接流程 l 机顶盒主动想终端管理系统发起一个 HTTP 连接请求，终端管理系统会 要求进行 HTTP Digest Authentication 认证； C.5 中 的 l 机 顶 盒 连 接 终 端 管 理 系 统 的 认 证 地 址 由 附 录 C.5 中 的 Device.ManagementServer.URL 参数提供，认证采用的用户名及密码由附 录 及 Device.ManagementServer.Password 参数提供； Device.ManagementServer.Username l 终端管理系统地址及认证用户名、密码均在出厂时进行统一配置，。 l 连接不要求进行 SSL/TLS 加密； l 机顶盒在收到来自终端管理系统的 HTTP Digest 认证请求后，应该在之 后所有的 HTTP 请求中均带有认证头信息； l 无论机顶盒在之后的连接中是否带有认证头信息，终端管理系统均需要 1、机顶盒通过 HTTP Digest Authentication 发起与终端管理系统的认证连接， 连接方式遵循 RFC 2617 的规定。 在所有的带有认证请求； l 认证请求的响应遵循 RFC 2617 中的规定。 PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    1.2.2 终端管理系统主动发起的安全连接流程 机顶盒 终端管理系统 2、验证管理域身份 1、HTTP Digest Authentication 3、HTTP Digest Authentication 图 1-2-2-1 终端管理系统主动发起的安全连接流程 1、在终端管理系统主动发起对机顶盒的连接请求之前，要求机顶盒至少已 经与终端管理系统进行主动连接，并已获得机顶盒管理的连接地址、用户名和密 码。 l 机顶盒连接地址、用户名及密码在附录 C.4 中描述，并在之前机顶盒主 动发起的连接请求中通过 Inform 方法通知终端管理系统。 l 终端管理系统作为客户端向机顶盒发起遵循 RFC 2617 的 HTTP Digest Authentication 连接认证。 2、机顶盒在收到终端管理系统发起的 HTTP Digest Authentication 认证请求 后，根据连接中带有的用户名和密码对发起请求的终端管理系统进行身份认证； l 认证连接响应符合 RFC 2617 中的规定。 l 终端管理系统在连接中应带有认证请求； 3、机顶盒对于请求连接的终端管理系统进行身份认证。 4、机顶盒对终端管理系统认证通过后，要求机顶盒按照 1.2.1 节中描述的流 程重新对终端管理系统发起 HTTP Digest Authentication 认证请求。 PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    1.3 机顶盒注册认证接口（S6-1） 1.3.1 机顶盒首次开机认证注册 1.3.1.1 业务流程描述 机顶盒 终端管理系统 3、机顶盒认证 (根据OUI、ProductClass、 SerialNumber) 6、检查版本信息 步骤5-7也可用于机顶盒 零配置 步骤8 - 10用于更改机 顶盒连接用户名、密码 以及认证服务器地址 1、HTTP Digest Authentication 2、HTTP(s) POST, Inform Request 4、HTTP(s) Response, Inform Response 5、HTTP(s) POST, empty 7、检查并下载版本文件并更新 8、HTTP(s) POST, empty 9、HTTP(s) Response SetparameterValues Request 10、HTTP(s) Request SetparameterValues Response 11、HTTP(s) Response, empty 12、End Session 图 1-3-1-1-1 机顶盒首次开机认证注册流程 1) 机顶盒通过 1.2.1 中描述的安全认证流程与终端管理系统建立连接； 2) 机顶盒通过 HTTP Digest Authentication 认证通过后，调用终端管理系统的 Inform 方法与终端管理系统连接； l Inform 方法的 Eventcode 为”0 BOOTSTRAP”用于说明机顶盒首次网络连 接； l Inform 方法的 ParameterList 参数中带有机顶 盒软件版本描述信息 （Device.DeviceInfo.SoftwareVersion）； 3) 终端管理系统对机顶盒进行认证，并对合法机顶盒进行注册； l 终端管理系统通过 Inform 方法的 DeviceIdStruct 参数中带有的 OUI、 ProductClass 及 SerialNumber 对机顶盒进行认证（也可以通过 STBID 进 PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    行认证，STBID 定义参考附录 B）； 4) 终端管理系统返回 Inform 响应； 5) 机顶盒发起一条内容为空的 HTTP POST 请求； l 如果在步骤 3 中机顶盒注册认证失败，则终端管理系统将直接按照步骤 11 返回内容为空的 HTTP 响应，要求机顶盒关闭连接，不再进行以下步 骤此次业务失败； 6) 终端管理系统根据步骤 2 中机顶盒通过 Inform 方法上报的软件版本判断是否 需要对机顶盒进行升级； 7) 终端管理系统返回版本检查的结果； l 如果机顶盒需要进行软件版本升级，则机顶盒与终端管理系统通过 1.5.1 中描述的步骤 5-步骤 21 进行升级，并调用相关 RPC 方法； l 如果机顶盒不需要进行软件版本升级，则步骤 7 为可选； 8) 机顶盒发送一条内容为空的 HTTP POST 请求； 9)终端管理服务器调用 SetParamterValues 方法设置终端管理系统连接机顶盒的 用户名、密码以及用户业务认证接入信息，其中包括： l 附 录 C.5 中 描 述 的 终 端 管 理 系 统 连 接 机 顶 盒 的 用 户 名 及 密 码 、 Device.ManagementServer.ConnectionRequestUsername Device.ManagementServer.ConnectionRequestPassword 进行描述； l 在附录 C.15 中描述 的终 端业务 认证服 务 器地 址、 用户 名及密码 、 、 Device.X_CTC_IPTV.ServiceInfo.AuthURL Device.X_CTC_IPTV.ServiceInfo.UserID Device.X_CTC_IPTV.ServiceInfo.UserPassword; 10)机顶盒返回 SetParameterValues 方法更改终端管理服务器地址的操作结果，响 应符合 TR-069 规范； 11) 终端管理系统返回内容为空的 HTTP 响应； 12) 关闭连接； 1.3.1.2 接口协议内容 1、机顶盒首次开机注册认证的 Inform 方法 承载协议：HTTP+XML，SOAP 调用 接口方向：机顶盒 –〉终端管理系统 调用接口：http:// IptvManagementDomain/ Inform 接口功能：机顶盒调用 Inform 方法通知终端管理系统首次连接。 表 1-3-1-2-1 请求 Inform 参数列表 名称 说明 数据类型 长度（字节） 是否必选 DeviceId 用于标识 机顶盒的 DeviceIdStruct 参见 M PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    结构体 Event 上报信息 的类型结 构体 MaxEnvelop es 最大 SOAP 信封数， 在此只允 许设置为 “1” CurrentTime 机顶盒当前的 UTC 时 间 ， 采 用 SOAP DateTime 时间类型 RetryCount 连接重试次数，在每 次新 Session 发布时 必须重置为 0 ParameterLis t 根据数据模 型确定 的需要上 报的参数 列表 DeviceIdStr uct 说明 EventStruct[64] 参考 EventStruct 说明 4 Unsigned Int dateTime Unsigned int 4 ParameterValue 参考 Struct[] ParameterV alueStruct 说明 表 1-3-1-2-2 响应 Inform 参数 M M M M M 名称 MaxEnvelopes 说明 最大 SOAP 信封数，在 此只允许设置为“1” 响应错误码： 数据类型 长度（字节） 是否必选 Unsigned M 4 Int 终端管理系统 Response faultcode：8001, 8002, 8003, 8004, 8005。 注：faultcode 定义请参考附录 A.3 的定义 表 1-3-1-2-3 DeviceIdStruct 说明 PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    名称 Manufacturer OUI 机顶盒制造厂商 厂商的唯一标识，全大 写 16 进制表示，如不 足则添加前导零。 ProductClass 机顶盒类型 SerialNumber 机顶盒序列号 说明 数据类型 长度（字节） 是否必选 string string string string 256 6 64 64 M M M M 名称 EventCode CommandKey 表 1-3-1-2-4 EventStruct 定义 说明 数据类型 长度（字节） 是否必选 string string 64 32 M M 事务交互类型，大小写 敏感，参考附录 A 中 的说明 当前事务交互的内容， 当前版本中只支持以 下几种： • ScheduledInform method (EventCode = “M ScheduleInform”) • Reboot method (EventCode = “M Reboot”) • Download method (EventCode = “M Download”) • Upload method (EventCode = “M Upload”) 其余方法保留为空字 符串 表 1-3-1-2-5 ParameterValueStruct 定义 PDF 文件使用 "pdfFactory Pro" 试用版本创建 www.fineprint.cn
    分享到：
    赞 收藏

    相关推荐

    资料库

    信息化

    共收录1827份资料，累计6个分类，关注成员有19位，主要包括：管理软件,企业管理,电子商务,其它,IT管理,项目管理

    热门标签

    管理软件 企业管理 电子商务 其它 IT管理 项目管理

    最新资料