中国电信家庭网关与终端综合管理系统接口技术要求.ppt

中国电信家庭网关与终端综合,管理系统接口技术要求,（暂行）,中国电信集团公司,中国电信家庭网关与终端综合管理系统接口技术要求,中国电信家庭网关与终端综合管理系统接口技术要求,中国电信集团公司,-i-,目,录,前 言.11、范围.22、引用标准.33、缩略语.44、HGW 与 ITMS 接口框架.54.1 HGW 与 ITMS 接口描述图.54.2 HGW 与 ITMS 接口概述.54.3 终端管理协议栈分层模型.65、RPC 方法概述.86、HGW 与 ITMS 接口安全.106.1 HGW 发起的安全连接流程.106.2 ITMS 发起的安全连接流程.117、HGW 与设备认证注册接口（GM1）.127.1 GM1 接口描述图.127.2 首次连接设备认证接口（临时帐号）（GM11）.12,7.2.17.2.27.2.37.2.4,接口场景描述.12接口调用的 RPC 方法.12接口时序.13接口交互内容.14,7.3 首次连接设备认证接口（非临时帐号）（GM12）.15,7.3.17.3.27.3.37.3.4,接口场景描述.15接口调用的 RPC 方法.15接口时序.16接口交互内容.17,7.4 非首次连接设备认证接口（GM13）.18,7.4.17.4.27.4.37.4.4,接口场景描述.18接口调用的 RPC 方法.18接口时序.18接口交互内容.19,8、HGW 与参数监视接口模块（GM2）.208.1 GM2 接口描述图.208.2 参数模型获取接口（GM21）.20,8.2.18.2.28.2.38.2.4,接口场景描述.20接口调用的 RPC 方法.20接口时序.21接口交互内容.21,中国电信集团公司,-ii-,中国电信家庭网关与终端综合管理系统接口技术要求8.3 参数查询接口（GM22）.22,8.3.18.3.28.3.38.3.4,接口场景描述.22接口调用的 RPC 方法.22接口时序.22接口交互内容.23,8.4 参数变化上报接口（GM23）.23,8.4.18.4.28.4.38.4.4,接口场景描述.23接口调用的 RPC 方法.23接口时序.24接口交互内容.25,9、HGW 与参数配置接口模块（GM3）.269.1 GM3 接口描述图.269.2 参数属性上报接口（GM31）.26,9.2.19.2.29.2.39.2.4,接口场景描述.26接口调用的 RPC 方法.27接口时序.27接口交互内容.28,9.3 配置用户可写属性接口（GM32）.28,9.3.19.3.29.3.39.3.4,接口场景描述.28接口调用的 RPC 方法.28接口时序.29接口交互内容.29,9.4 参数实例配置接口（SETPARAMETERVALUES）（GM33）.30,9.4.19.4.29.4.39.4.4,接口场景描述.30接口调用的 RPC 方法.30接口时序.30接口交互内容.31,9.5 实例删除配置接口（GM34）.31,9.5.19.5.29.5.39.5.4,接口场景描述.31接口调用的 RPC 方法.31接口时序.32接口交互内容.32,9.6 参数实例配置接口（配置文件）（GM35）.33,9.6.19.6.29.6.39.6.4,接口场景描述.33接口调用的 RPC 方法.33接口时序.33接口交互内容.34,9.7 上传配置文件接口（GM36）.35,9.7.19.7.29.7.39.7.4,接口场景描述.35接口调用的 RPC 方法.35接口时序.35接口交互内容.36,10、HGW 与软件升级接口模块（GM4）.37,中国电信集团公司,-iii-,中国电信家庭网关与终端综合管理系统接口技术要求10.1 GM4 接口描述图.3710.2 软件升级接口（GM41）.37,10.2.110.2.210.2.310.2.4,接口场景描述.37接口调用的 RPC 方法.37接口时序.38接口交互内容.40,10.3 软件版本查询接口（GM42）.40,10.3.110.3.210.3.310.3.4,接口场景描述.40接口调用的 RPC 方法.40接口时序.41接口交互内容.41,10.4 软件升级配置备份接口（GM43）.42,10.4.110.4.210.4.310.4.4,接口场景描述.42接口调用的 RPC 方法.42接口时序.42接口交互内容.45,11、HGW 与测试诊断接口模块（GM5）.4711.1 GM5 接口描述图.4711.2 PING 测试接口（GM51）.47,11.2.111.2.211.2.311.2.4,接口场景描述.47接口调用的 RPC 方法.47接口时序.48接口交互内容.49,11.3 ATMF5LOOP 测试接口（GM52）.50,11.3.111.3.211.3.311.3.4,接口场景描述.50接口调用的 RPC 方法.50接口时序.50接口交互内容.51,11.4 重启接口（GM53）.52,11.4.111.4.211.4.311.4.4,接口场景描述.52接口调用的 RPC 方法.52接口时序.53接口交互内容.53,11.5 恢复出厂设置接口（GM54）.54,11.5.111.5.211.5.311.5.4,接口场景描述.54接口调用的 RPC 方法.54接口时序.54接口交互内容.55,11.6 DSL 测试接口（GM55）.55,11.6.111.6.211.6.311.6.4,接口场景描述.55接口调用的 RPC 方法.55接口时序.55接口交互内容.57,中国电信集团公司,-iv-,中国电信家庭网关与终端综合管理系统接口技术要求12、HGW 与代理接口模块（GM6）.58,12.112.212.312.4,接口场景描述.58接口调用的 RPC 方法.58接口时序.58接口交互内容.59,附录 A（规范性附录）RPC 方法定义.60附录 B（规范性附录）RPC XML SCHEMA 描述.62B.1 XML SCHEMA 文件头.62B.2 SOAP 信包头.62B.3 SOAP 错误代码.62B.4 RPC 参数类型定义.62B.5 RPC 方法请求/响应.64附录 C（规范性附录）业务配置描述.66C.1 业务配置逻辑图.66C.2 业务配置模板.67C.2.1 基础类配置模板.67C.2.2 面向应用配置.70附录 D（资料性附录）对 TR-069 的扩展.76D.1 RPC 方法.76D.2 RPC 方法修订清单.77,中国电信集团公司,-1-,中国电信家庭网关与终端综合管理系统接口技术要求前 言本标准是根据中国电信开展家庭网络业务的实际情况而制定的，主要用于规范家庭网关与终端综合管理系统对接的功能、流程和接口内容技术要求。本标准是中国电信家庭网络的系列标准之一，该系列标准的名称如下：(1)中国电信家庭网关技术要求总体要求(2)中国电信家庭网关技术要求基于 Triple-play 业务的家庭网关(3)中国电信家庭网关与终端综合管理系统接口技术要求(4)中国电信终端综合管理系统技术要求本标准的附录 A、B、C 是规范性附录，附录 D 是资料性附录。本标准由中国电信集团公司技术部组织、中国电信股份有限公司上海研究院起草。,中国电信集团公司,-2-,中国电信家庭网关与终端综合管理系统接口技术要求1、范围本标准规定了家庭网关（以下简称为 HGW）与终端综合管理系统（以下简称为 ITMS）的接口，包括接口的基本 RPC 方法调用，接口的安全性连接定义以及设备认证、参数监视、参数配置、软件升级及测试诊断模块的详细接口调用过程和字段内容。本标准适用于家庭网关与终端综合管理系统之间的接口开发，为中国电信HGW 与 ITMS 进行互通性测试提供依据。,中国电信家庭网关与终端综合管理系统接口技术要求2、引用标准下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。,TR-069:PD-069:TR-106:PD-128:WT-121:SOAP1.1:SSL3.0:RFC 2616:RFC 2617:RFC 2246:中国电信集团公司,CPE WAN Management ProtocolTR-069 with Change Text from WT-121Data Model Templatefor TR-069-Enabled DevicesInteroperability Test Plan for TR-069 PlugfestsTR-069 Implementation GuidelinesSimple Object Access Protocol(SOAP)1.1The SSL Protocol,Version 3.0Hypertext Transfer Protocol-HTTP/1.1HTTP Authentication:Basic and Digest Access AuthenticationThe TLS Protocol,Version 1.0-3-,中国电信集团公司,-4-,中国电信家庭网关与终端综合管理系统接口技术要求3、缩略语,CPEHGWHTTPHTTPSIP,Customer Premises EquipmentHome GatewayHypertext Transfer ProtocolHypertext Transfer Protocol SecureInternet Protocol,用户终端设备家庭网关超文本传输协议安全超文本传输协议互联网协议,ITMS,Integrated Terminal Management System 终端综合管理系统,RPCSOAPTCPURLXMLXSD,Remote Procedure CallSimple Object Access ProtocolTransmission Control ProtocolUniform Resource LocatorExtensible Markup LanguageXML Schema Infoset Model,远程过程调用简单对象访问协议传输控制协议统一资源定位符可扩展标记语言XML 数据定义文件,GM,1,5,GM,GM,6,GM,中国电信集团公司,-5-,中国电信家庭网关与终端综合管理系统接口技术要求4、HGW 与 ITMS 接口框架4.1 HGW 与 ITMS 接口描述图HGW 与 ITMS 接口（GM）包含以下逻辑接口：1）终端注册认证接口（GM1）2）参数监视接口（GM2）3）参数配置接口（GM3）4）软件升级接口（GM4）5）测试诊断接口（GM5）6）代理接口（GM6）所有接口在系统中的位置，如图 4-1 所示：ITMS2GM3,4,GM,HGW图 4-1 HGW 与 ITMS 接口概述4.2 HGW 与 ITMS 接口概述1）设备注册认证接口（GM1）设备注册认证接口主要完成 HGW 注册认证功能，ITMS 将依据 HGW 信息，调用其它接口内容，完成软件升级、参数配置（包括设备和业务的参数）等操作。,中国电信集团公司,-6-,中国电信家庭网关与终端综合管理系统接口技术要求2）参数监视接口（GM2）参数监视接口主要完成 ITMS 对 HGW 参数模型的获取，实时数据、性能参数等的获取，以及参数变更上报的设置（Notification）及 HGW 参数值变更后上报等功能。3）参数配置接口（GM3）参 数 配 置 接 口 主 要 完 成 ITMS 对 HGW 的 参 数 配 置（必 须 支 持SetParameterValues 和配置文件方式），HGW 配置文件的上传，配置 HGW 参数属性、及参数属性查询等功能。4）软件升级接口（GM4）软件升级接口主要完成 ITMS 对 HGW 的软件升级，配置文件的备份和下发，以及软件版本信息的查询。5）测试诊断接口（GM5）测试诊断接口主要完成 ITMS 对 HGW 的测试诊断任务，包括 PING 测试，ATM F5 Loop 测试，DSL 测试等，以及 HGW 重启，恢复出厂设置等功能。6）代理接口（GM6）代理接口主要完成把 ITMS 可识别的但无法管理的其他终端的数据进行代理转发功能。4.3 终端管理协议栈分层模型图 4-2 描述了 HGW 与终端管理通信接口协议栈的层次模型，其中 SSL/TLS是安全相关的承载协议，SOAP 及 RPC 方法是管理协议承载应用的主要方式。,中国电信集团公司,-7-,中国电信家庭网关与终端综合管理系统接口技术要求H G W/IT M S 管 理 应 用RPC 方 法SOAPHTTPS S L/T L ST C P/I P图 4-2 终端管理协议栈分层模型,中国电信集团公司,-8-,中国电信家庭网关与终端综合管理系统接口技术要求5、RPC 方法概述本章对接口流程中调用的 RPC 方法进行概要描述，详细的 RPC 方法定义请参见 TR-069 附录 A，本文附录 A 仅定义在 TR-069 基础上本标准修订的 RPC 方法。表 5-1 接口 RPC 方法,中国电信家庭网关与终端综合管理系统接口技术要求,中国电信集团公司,-9-,功能描述,方法名称HGW 方法,HGW 要求应答,ITMS 要求调用,据）选项。,GetOptions,O,O,ITMS 可以用本方法来获得 HGW,目前设置的选项表，及其它相关状态信息。,ITMS 方法,调用,应答,GetRPCMethods,O,O,本方法可用于 HGW 或 ITMS 来,发现另一方所支持的方法集。,M,M,Inform,任何时刻要建立与 ITMS 的连,接，HGW 必须调用 Inform 方法，来初始化一个传输序列。,TransferComplete,M,M,本方法通知 ITMS 由以前的,Download 或 Upload 方法调用而引起的文件传输已经结束（不管成功还是失败）。,RequestDownload,O,O,本方法允许 HGW 向 ITMS 请示,求一个文件下载。,Kicked,O,O,任何时刻 HGW 使用 Web 方式连,接 ITMS 时被触发。,中国电信集团公司,-10-,中国电信家庭网关与终端综合管理系统接口技术要求6、HGW 与 ITMS 接口安全本章中描述 HGW 与 ITMS 安全连接的建立过程，后续所有流程均需满足本章中规定的安全连接方式。若今后采用专用通道来进行管理，则可以不使用此安全接口。6.1 HGW 发起的安全连接流程图 6-1 HGW 发起的安全连接流程1、HGW 与 ITMS 建立 SSL/TLS 的安全通信通道；2、HGW 与 ITMS 使用 WWW-Authentication 进行认证，通过 Inform 发起认证的Http Request 连接，Basic 和 Digest 的方式由会话的响应方决定。其中 Basic和 Digest 方式应遵循 RFC2617。如果在 SSL/TLS 连接过程中，ITMS 已通过证书方式对 HGW 进行了认证，则步骤 2 不存在，直接通过 Inform 建立通信连接。,中国电信集团公司,-11-,中国电信家庭网关与终端综合管理系统接口技术要求6.2 ITMS 发起的安全连接流程,HGW,ITMS,1、WWW-Authentication，Digest2、SSL/TLS连接过程3、WWW-Authentication（可选），Basic/Digest图 6-2 ITMS 发起的安全连接流程1、ITMS 作为客户端向 HGW 发起 WWW-Authentication 认证，必须使用 Digest方式；2、认证通过后，HGW 与 ITMS 建立 SSL/TLS 的安全通信通道；3、可选再次进行 WWW-Authentication 对 HGW 进行认证。如果在 SSL/TLS 连接过程中，ITMS 已通过证书方式对 HGW 进行了认证，则步骤 3 不存在，直接通过 Inform 建立通信连接。,中国电信集团公司,-12-,中国电信家庭网关与终端综合管理系统接口技术要求7、HGW 与设备认证注册接口（GM1）7.1 GM1 接口描述图设备注册认证接口包括三个子接口流程：1）首次连接设备认证（临时帐号）（GM11）2）首次连接设备认证（非临时帐号）（GM12）3）非首次连接设备认证（GM13）图 7-1 HGW 与设备注册认证模块接口图7.2 首次连接设备认证接口（临时帐号）（GM11）7.2.1 接口场景描述HGW 设备中预配置临时的宽带帐号，该帐号只能获得可访问 ITMSURL 的临时 IP 地址。通过该流程，ITMS 将向用户提供可上公网的正式宽带帐号及其他的服务等级配置。7.2.2 接口调用的 RPC 方法,-13-,中国电信家庭网关与终端综合管理系统接口技术要求7.2.3 接口时序,HGW中国电信集团公司,ITMSHGW15 End Session图 7-2 首次连接设备认证接口（临时帐号）流程图,中国电信集团公司,-14-,中国电信家庭网关与终端综合管理系统接口技术要求1、HGW 发起 Inform 请求，Eventcode 为 BOOTSTRAP 说明是首次连接ITMS；2、ITMS 对 HGW 进行认证，根据 HGW 提供的 OUI-SerialNumber 查找匹配的宽带帐号和密码及终端用户相应的配置文件，返回 InformResponse；3、HGW 发起一条空的 Http Post 请求；4、ITMS 发起 GetParameterValues，要求检查 HGW 的宽带帐号/密码；5、HGW 回应 GetParameterValues，携带宽带帐号/密码（固定为空）；6、根据宽带帐号及用户信息的判断，ITMS 发起 SetParameterValues 的 RPC，根据查找的结果设置 HGW 新的宽带帐号和密码；7、HGW 回应 SetParameterValuesResponse；（6/7 与 8/9 为互补步骤，如果以配置文件的方式下发参数，则 6/7 可以省略）；8、ITMS 发起 Download 的 RPC，要求 HGW 下载初始化的配置文件；9、HGW 回应 Download（6/7 与 8/9 为互补步骤，如果以参数的方式下发配置并且不需要软件升级，则 8/9 可以省略）；,10、11、,HGW 根据 Download 中提供的 URL 参数进行配置文件下载；结 束 Session，HGW 重 新 发 起 Inform，并 至 少 携 带 EventCode,“TRANSFERCOMPLETE”；（具体分支情况，请参见 GM4 中的定义）,12、13、,ITMS 回应 Inform；HGW 发起 TransferComplete 请求，报告下载的起始和结束时间，及,成功或失败消息；,14、15、,ITMS 回应 TransferCompleteResponse；结束。,7.2.4 接口交互内容第 一 次 Inform：参 见 PD-069 附 录 A.3.3.1 描 述，EventCode 为“0BOOTSTRAP”；第二次 Inform：参见 PD-069 附录 A.3.3.1 描述，EventCode 至少包含“7 TRANSFERCOMPLETE”；,中国电信集团公司,-15-,中国电信家庭网关与终端综合管理系统接口技术要求GetParmeterValues：参见 PD-069 附录 A.3.2.2 描述，请求的具体参数为：参数名称InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.UsernameInternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.PasswordSetParameterValues：参见 PD-069 附录 A.3.2.1 描述，请求的具体参数为：参数名称InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.UsernameInternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.PasswordDownload：参见 PD-069 附录 A.3.2.8 描述，其中 FileType 的属性：软件升级“1 Firmware Upgrade Image”配置文件“3 Vendor Configuration File”TransferComplete：参见 PD-069 附录 A.3.3.2 描述。7.3 首次连接设备认证接口（非临时帐号）（GM12）7.3.1 接口场景描述HGW 设备中预配置宽带帐号。通过该流程，ITMS 将向用户提供与其相匹配的服务等级配置。7.3.2 接口调用的 RPC 方法,中国电信集团公司,-16-,中国电信家庭网关与终端综合管理系统接口技术要求7.3.3 接口时序图 7-3 首次连接设备认证接口（非临时帐号）流程图1、HGW 发起 Inform 请求，Eventcode 为 BOOTSTRAP 说明是首次连接ITMS；2、ITMS 对 HGW 进行认证，根据 HGW 提供的 OUI-SerialNumber 查找匹配的宽带帐号和密码及终端用户相应的配置文件，返回 InformResponse；3、HGW 发起一条空的 Http Post 请求；,中国电信集团公司,-17-,中国电信家庭网关与终端综合管理系统接口技术要求4、ITMS 发起 GetParameterValues，要求检查 HGW 的宽带帐号/密码；5、HGW 回应 GetParameterValues，携带宽带帐号/密码（固定为空）；6、根据宽带帐号及用户信息的判断，ITMS 发起 SetParameterValues 的 RPC，根据查找的结果设置 HGW 相应的服务等级配置；7、HGW 回应 SetParameterValuesResponse；（6/7 与 8/9 为互补步骤，如果以配置文件的方式下发参数，则 6/7 可以省略）；8、ITMS 发起 Download 的 RPC，要求 HGW 下载初始化的配置文件；9、HGW 回应 Download（6/7 与 8/9 为互补步骤，如果以参数的方式下发配置并且不需要软件升级，则 8/9 可以省略）；,10、11、,HGW 根据 Download 中提供的 URL 参数进行配置文件下载；结 束 Session，HGW 重 新 发 起 Inform，并 至 少 携 带 EventCode,“TRANSFERCOMPLETE”；（具体分支情况，请参见 GM4 中的定义）,12、13、,ITMS 回应 Inform；HGW 发起 TransferComplete 请求，报告下载的起始和结束时间，及,成功或失败消息；,14、15、,ITMS 回应 TransferCompleteResponse；结束。,7.3.4 接口交互内容第 一 次 Inform：参 见 PD-069 附 录 A.3.3.1 描 述，EventCode 为“0BOOTSTRAP”第二次 Inform：EventCode 至少包含“7 TRANSFERCOMPLETE”GetParmeterValues：参见 PD-069 附录 A.3.2.2 描述，请求的具体参数为：参数名称InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.UsernameInternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.PasswordSetParameterValues：参见 PD-069 附录 A.3.2.1 描述，请求的具体参数根据 HGW,中国电信集团公司,-18-,中国电信家庭网关与终端综合管理系统接口技术要求类型及用户开展业务的不同而改变；Download：参见 PD-069 附录 A.3.2.8 描述，其中 FileType 的属性：软件升级“1 Firmware Upgrade Image”配置文件“3 Vendor Configuration File”TransferComplete：参见 PD-069 附录 A.3.3.2 描述。7.4 非首次连接设备认证接口（GM13）7.4.1 接口场景描述HGW 上电，向 ITMS 发起注册，ITMS 可发现并对 HGW 进行认证。7.4.2 接口调用的 RPC 方法7.4.3 接口时序,HGW,ITMS,HGW4 End Session图 7-4 非首次连接设备认证接口流程图1、HGW 发起 Inform 请求，Eventcode 为 BOOT 说明是非首次连接 ITMS；,中国电信集团公司,-19-,中国电信家庭网关与终端综合管理系统接口技术要求2、ITMS 对 HGW 进行认证，根据 HGW 提供的 OUI-SerialNumber 查找匹配用户相应的配置文件，返回 InformResponse；3、根据 ITMS 的计划任务，执行配置、Download 等计划任务，可选步骤；4、结束。7.4.4 接口交互内容Inform：参见 PD-069 附录 A.3.3.1 描述，EventCode 至少包含“1 BOOT”。,中国电信集团公司,-20-,中国电信家庭网关与终端综合管理系统接口技术要求8、HGW 与参数监视接口模块（GM2）8.1 GM2 接口描述图参数监视接口包括三个子接口流程：1）参数模型获取接口（GM21）2）参数查询接口（GM22）3）参数变化上报接口（GM23）图 8-1 HGW 与参数监视模块接口图8.2 参数模型获取接口（GM21）8.2.1 接口场景描述ITMS 获得某一 HGW 所支持的 TR069 参数模型。8.2.2 接口调用的 RPC 方法,中国电信集团公司,-21-,中国电信家庭网关与终端综合管理系统接口技术要求8.2.3 接口时序图 8-2 参数模型获取接口流程图1、HGW 发起 Inform，包含 EventCode CONNECTIONREQUEST；2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；4、ITMS 调用 GetParameterNames RPC 方法，要求获得 HGW 的 TR069 参数模型，建议 NextLevel=TRUE；5、HGW 回应 TR069 参数模型；（4、5 的过程可多次）6、结束。8.2.4 接口交互内容Inform：参见 PD-069 附录 A.3.3.1 描述；GetParameterNames：参见 PD-069 附录 A.3.2.3 描述，建议“NextLevel”为TRUE。,中国电信集团公司,-22-,中国电信家庭网关与终端综合管理系统接口技术要求8.3 参数查询接口（GM22）8.3.1 接口场景描述ITMS 获得某一 HGW 特定的参数。8.3.2 接口调用的 RPC 方法8.3.3 接口时序图 8-3 参数查询接口流程图1、HGW 发起 Inform，包含 EventCode CONNECTIONREQUEST；2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；,中国电信集团公司,-23-,中国电信家庭网关与终端综合管理系统接口技术要求4、ITMS 调用 GetParameterValues RPC 方法，要求获得 HGW 的特定参数；5、HGW 回应 GetParameterValues；6、结束。8.3.4 接口交互内容Inform：参见 PD-069 附录 A.3.3.1 描述；GetParmeterValues：参见 PD-069 附录 A.3.2.2 描述。8.4 参数变化上报接口（GM23）8.4.1 接口场景描述ITMS 获得某一 HGW 特定的参数。8.4.2 接口调用的 RPC 方法,中国电信集团公司,-24-,中国电信家庭网关与终端综合管理系统接口技术要求8.4.3 接口时序,HGW,ITMS,9 End Session图 8-4 参数变化上报接口流程图1、HGW 发起 Inform，包含 EventCode CONNECTIONREQUET；2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；4、ITMS 调用 SetParameterAttributes RPC 方法，设定参数值改变需要上报的参数属性；5、HGW 回应 SetParameterAttributes；6、回应或结束 Session；7、参数值发生改变，HGW 自动发起 Inform，EventCode 为 VALUE CHANGE；8、ITMS 回应 Inform；9、结束。,中国电信集团公司,-25-,中国电信家庭网关与终端综合管理系统接口技术要求8.4.4 接口交互内容Inform：参见 PD-069 附录 A.3.3.1 描述，“EventCode”至少要包含“VALUECHANGE”；SetParameterAttributes：参见 PD-069 附录 A.3.2.4 描述。,中国电信集团公司,-26-,中国电信家庭网关与终端综合管理系统接口技术要求9、HGW 与参数配置接口模块（GM3）9.1 GM3 接口描述图参数配置接口包括六个子接口流程：1）参数属性上报（GM31）2）配置 LAN 侧用户可写属性（GM32）3）参数/实例配置（SetParameter）（GM33）4）实例删除配置（GM34）5）参数配置（配置文件）（GM35）6）上传配置文件（GM36）图 9-1 HGW 与参数配置模块接口图9.2 参数属性上报接口（GM31）9.2.1 接口场景描述ITMS 获得特定 HGW 一个或多个参数的属性值。,中国电信集团公司,-27-,中国电信家庭网关与终端综合管理系统接口技术要求9.2.2 接口调用的 RPC 方法9.2.3 接口时序图 9-2 参数属性上报接口流程图1、HGW 发起 Inform，包含 EventCode CONNECTIONREQUST；2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；4、ITMS 调用 GetParameterAttributes RPC 方法，要求获得 HGW 一个或多个参数属性；5、HGW 回应 GetParameterAttributes；6、结束；,中国电信集团公司,-28-,中国电信家庭网关与终端综合管理系统接口技术要求9.2.4 接口交互内容Inform：参 见 PD-069 附 录 A.3.3.1 描 述，EventCode 至 少 包 含“CONNECTIONREQUEST”；GetParameterAttributes：参见 PD-069 附录 A.3.2.5 描述。9.3 配置用户可写属性接口（GM32）9.3.1 接口场景描述ITMS 对特定 HGW 配置一个或多个参数的用户（指公众用户，非 ITMS 操作员）是否可写属性。9.3.2 接口调用的 RPC 方法,中国电信集团公司,-29-,中国电信家庭网关与终端综合管理系统接口技术要求9.3.3 接口时序图 9-3 配置用户可写属性接口流程图1、HGW 发起 Inform，包含 EventCode CONNECTIONREQUST；2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；4、ITMS 调 用 SetParameterAttributes RPC 方 法，配 置 AccessList 属 性 为“Subscriber”；5、HGW 回应 GetParameterAttributes；6、结束。9.3.4 接口交互内容Inform：参 见 PD-069 附 录 A.3.3.1 描 述，EventCode 至 少 包 含“CONNECTIONREQUEST”；SetParameterAttributes：参见 PD-069 附录 A.3.2.4 描述。,中国电信集团公司,-30-,中国电信家庭网关与终端综合管理系统接口技术要求9.4 参数实例配置接口（SetParameterValues）（GM33）9.4.1 接口场景描述ITMS 新增 HGW 某一实例及配置相关参数。9.4.2 接口调用的 RPC 方法9.4.3 接口时序,HGW,ITMS,8 End Session图 9-4 参数实例配置接口流程图1、HGW 发 起 Inform，包 含 EventCode CONNECTIONREQUST；（其 他 如,中国电信集团公司,-31-,中国电信家庭网关与终端综合管理系统接口技术要求Scheduled Inform 情况也成立）2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；4、ITMS 调用 AddObject RPC 方法，为 HGW 生成实例；5、HGW 回应 AddObject；6、ITMS 发起 SetParameterValues RPC 方法，配置实例或其他参数；7、HGW 回应 SetParameterValues；8、结束。9.4.4 接口交互内容Inform：参 见 PD-069 附 录 A.3.3.1 描 述，EventCode 可 包 含“6CONNECTIONREQUEST”等；AddObject：参见 PD-069 附录 A.3.2.6 描述；SetParameterValues：参见 PD-069 附录 A.3.2.1 描述。9.5 实例删除配置接口（GM34）9.5.1 接口场景描述ITMS 删除特定 HGW 的一条实例。9.5.2 接口调用的 RPC 方法,中国电信集团公司,-32-,中国电信家庭网关与终端综合管理系统接口技术要求9.5.3 接口时序,HGW,ITMS,6 End Session图 9-5 实例删除配置接口流程图1、HGW 发起 Inform，包含 EventCode CONNECTIONREQUST；2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；4、ITMS 调用 DeleteObject RPC 方法，为 HGW 删除一实例；5、HGW 回应 DeleteObject；6、结束。9.5.4 接口交互内容Inform：参 见 PD-069 附 录 A.3.3.1 描 述，EventCode 包 含“6CONNECTIONREQUEST”等；DeleteObject：参见 PD-069 附录 A.3.2.7 描述。,中国电信家庭网关与终端综合管理系统接口技术要求9.6 参数实例配置接口（配置文件）（GM35）9.6.1 接口场景描述ITMS 以配置文件的方式下发参数配置。9.6.2 接口调用的 RPC 方法9.6.3 接口时序,HGW中国电信集团公司,文件服务器-33-,ITMS11 End Session图 9-6 参数实例配置接口（配置文件）流程图,中国电信集团公司,-34-,中国电信家庭网关与终端综合管理系统接口技术要求1、HGW 发起 Inform，包含 EventCode CONNECTIONREQEUST；（其他计划配置的 Inform 情况下也成立）；2、ITMS 回应 Inform；3、HGW 发起空的 HTTP Post；4、ITMS 调用 Download RPC 方法，要求 HGW 下载配置文件；（如果有多个配置文件，则需要发起多个 Download 过