中国电信家庭网关与ITMS接口技术要求.doc

中国电信集团公司 20092009 年年 3 3 月月 保密等级：公开发放 中国电信集团公司技术标准 Q/CT 2271-2010 中国电信家庭网关（e8）与终端综合管理 系统（ITMS）接口技术要求 （V3.0） 2010-07 发布2010-07 实施 中国电信集团公司 发布 目目 录录 前前 言言.IV 1 范围.1 2 规范性引用文件.1 3 缩略语.1 4 家庭网关与 ITMS 接口总体概述.2 4.1 家庭网关与 ITMS 接口在网络中的位置 2 4.2 家庭网关与 ITMS 接口主要内容 3 5 接口技术要求.3 5.1 家庭网关与 ITMS 接口框架 3 5.1.1 家庭网关与 ITMS 接口描述图.3 5.1.2 家庭网关与 ITMS 接口定义.4 5.1.3 终端管理协议栈分层模型4 5.2 RPC 方法概述.5 5.3 家庭网关与 ITMS 接口安全 6 5.3.1 家庭网关发起的安全连接流程7 5.3.2 ITMS 发起的安全连接流程.7 5.4 家庭网关与设备认证注册接口（M1） 8 5.4.1 M1 接口描述图 8 5.4.2 首次连接设备认证接口（基于物理 ID）.8 5.4.3 首次连接设备认证接口（基于逻辑 ID）.11 5.4.4 非首次连接设备认证接口15 5.5 家庭网关与参数监视接口模块（M2）.16 5.5.1 M2 接口描述图 16 5.5.2 参数模型获取接口16 5.5.3 参数查询接口17 5.5.4 参数变化上报接口18 5.6 家庭网关与参数配置接口模块（M3） 20 5.6.1 M3 接口描述图 20 5.6.2 参数属性上报接口20 5.6.3 配置用户可写属性接口21 5.6.4 参数实例配置接口（SetParameterValues）.22 5.6.5 实例删除配置接口24 5.6.6 参数实例配置接口（配置文件）25 5.6.7 上传配置文件接口26 5.6.8 上传日志文件接口28 5.6.9 配置电信维护帐号接口29 5.6.10 设备告警接口30 5.6.11 设备监控接口32 5.7 家庭网关与软件升级接口模块（M4） 33 5.7.1 M4 接口描述图 33 5.7.2 软件升级接口34 5.7.3 软件版本查询接口36 5.7.4 软件升级配置备份接口37 5.8 家庭网关与测试诊断接口模块（M5） 42 5.8.1 M5 接口描述图.42 5.8.2 PING 测试接口.42 5.8.3 ATMF5Loop 测试接口.44 5.8.4 重启接口46 5.8.5 恢复出厂设置接口47 5.8.6 DSL 测试接口.48 5.8.7 IAD 模块测试接口.50 附录 A（规范性附录） RPC 方法定义52 A.1 Inform52 附录 B（规范性附录） RPC XML SCHEMA描述54 B.1 XML Schema 文件头 .54 B.2 SOAP 信包头54 B.3 SOAP 错误代码54 B.4 RPC 参数类型定义.54 B.5 RPC 方法请求/响应 .56 附录 C（规范性附录） 业务配置描述59 C.1 业务配置逻辑图.59 C.2 业务配置模板59 C.2.1 基础类配置模板.60 C.2.2 面向应用配置 77 附录 D（资料性附录） 对 TR-069 的扩展.83 D.1 RPC 方法83 D.2 RPC 方法修订清单84 附录 E（规范性附录）故障数据字典 .84 E.1 故障编号规则 84 E.2 故障信息列表 85 E.3 用于故障检测的 PC 客户端代码定义87 附录 F (规范性附录) 家庭网关和 ITMS 交互约定细则.91 F.1 家庭网关 TR069 参数树初始配置技术细则.91 F.2 ADSL 上联桥连接建立流程.92 F.3 ADSL 上联路由连接建立流程.92 F.4 以太网上联桥连接建立流程93 F.5 以太网上联路由连接建立流程94 F.6 家庭网关和 ITMS 交互过程重启原则94 F.7 家庭网关 Inform 消息上报，参数列表扩充.95 F.8 ITMS 与家庭网关交互约定.95 F.9 ITMS 异常流程.95 F.10 ITMS 对家庭网关远程升级流程（配置文件不兼容）.96 F.11 平台业务下发逻辑判断.96 F.12 VOIP 业务发放流程.97 F.13 无线加密建立流程.98 F.14 端口映射建立流程.99 F.15 QOS 出厂配置模版.100 F.16 QOS 建立流程.102 F.17 ADSL 上联 DHCP 方式建立流程.103 F.18 以太网上联 DHCP 方式建立流程103 F.19 ADSL 上联 Static IP 方式建立流程.104 F.20 以太网上联 Static IP 方式建立流程105 F.21 ITMS 与家庭网关通信超时控制建议.106 F.22 基于逻辑 ID 的设备首次认证流程108 F.23 基于 DSCP 数据标识优先级队列方式的 QoS 保障建立流程（示例）.108 F.24 基于目的 IP 优先级队列方式的 QoS 保障建立流程（示例）.109 F.25 基于业务发现优先级队列方式的 QoS 保障建立流程 1（示例）109 F.26 基于业务发现优先级队列方式的 QoS 保障建立流程 2（示例）110 F.27 EPON 上联桥连接建立流程.111 F.28 EPON 上联路由连接建立流程.111 F.29 EPON 上联 DHCP 方式建立流程.112 F.30 EPON 上联 Static IP 方式建立流程.113 F.31 ITMS 下发业务模板示例.114 F.32 VDSL2 上联桥连接建立流程.114 F.33 VDSL2 上联路由连接建立流程.115 F.34 VDSL2 上联 DHCP 方式建立流程.116 F.35 VDSL2 上联 Static IP 方式建立流程.116 F.36 GPON 上联桥连接建立流程.117 F.37 GPON 上联路由连接建立流程.118 F.38 G GPON 上联 DHCP 方式建立流程.119 F.39 G GPON 上联 Static IP 方式建立流程.120 前前 言言 本标准是根据中国电信开展“天翼宽带”业务的实际情况而制定的，主要 用于规范家庭网关与终端综合管理系统接口的功能、流程等内容。 本标准的附录 A、附录 B、附录 C、附录 E、附录 F 为规范性附录，附录 D 为资料性附录。 本标准由中国电信集团公司组织制定，上海研究院起草。 本标准为中国电信企业秘密，仅限于本标准为中国电信企业秘密，仅限于“天翼宽带天翼宽带”合作厂商使用。合作厂商使用。 中国电信家庭网关（e8）与终端综合管理 系统（ITMS）接口技术要求 1 范围 本标准规定了家庭网关与终端综合管理系统的接口，包括接口的基本 RPC 方法调用， 接口的安全性连接定义以及设备认证、参数监视、参数配置、软件升级及测试诊断模块的 详细接口调用过程和字段内容。 本标准适用于家庭网关（e8）与终端综合管理系统之间的接口开发，为中国电信家庭 网关与终端综合管理系统进行互通性测试提供依据。 2 规范性引用文件 下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件， 其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据 本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件， 其最新版本适用于本标准。 RFC2616Hypertext Transfer Protocol - HTTP/1.1 RFC2617HTTP Authentication: Basic and Digest Access Authentication RFC2246The TLS Protocol, Version 1.0 SOAP1.1 Simple Object Access Protocol (SOAP) 1.1 SSL3.0 The SSL Protocol, Version 3.0 TR-069CPE WAN Management Protocol TR-098Gateway Device Version 1.1 Data Model for TR-069 TR-104Provisioning Parameters for VoIP CPE TR-142Framework for TR-069 Enabled PON Devices 3 缩略语 ADSLAsymmetric Digital Subscriber Line不对称数字用户线 CPECustomer Premise Equipment用户侧设备 CWMPCPE WAN Management Protocol用户侧设备广域网管 理协议 DDNSDynamic Domain Name Server动态域名解析 DHCPDynamic Host Configuration Protocol动态主机配置协议 DSCPDifferentiated Services Codepoint差分业务编码 EPONEthernet Passive Optical Networks以太网无源光网络 FTPFile Transfer Protocol文件传送协议 HTTPHypertext Transfer Protocol超文本传输协议 HTTPS Hypertext Transfer Protocol Secure安全超文本传输协议 IPInternet Protocol互联网协议 ITMSIntegrated Terminal Management System 终端综合管理系统 OUIOrganizationally Unique Identifiers组织唯一标识 PPPoEPPP over Ethernet以太网上传送PPP协议 PVCPermanent Virtual Circuit永久虚电路 QoSQuality of Service服务质量 RPCRemote Procedure Call远程过程调用 SIPSession Initiation Protocol初始会话协议 SNTPSimple Network Time Protocol简单网络时间协议 SSIDService Set Identifier服务集标志符 SOAPSimple Object Access Protocol简单对象访问协议 TOSType of Service服务类型 URLUniform Resource Locator统一资源定位符 VoIPVoice over Internet ProtocolIP电话 WANWide Area Network广域网 WEPWired Equivalent Privacy有线等效加密 WLANWireless LAN无线局域网 WPAWiFi Protected AccessWiFi网络安全存取 WPSWiFi Protected Setup无线安全设置 XML Extensible Markup Language可扩展标记语言 XSD XML Schema Infoset ModeXML数据定义文件 4 家庭网关与 ITMS 接口总体概述 4.1 家庭网关与 ITMS 接口在网络中的位置 家庭网关与ITMS接口见图4-1中的M接口 图 4-1 家庭网关与 ITMS 接口在网络中的位置 4.2 家庭网关与 ITMS 接口主要内容 接口安全 注册认证接口 参数监视接口 参数配置接口 软件升级接口 测试诊断接口 5 接口技术要求 5.1 家庭网关与 ITMS 接口框架 5.1.1 家庭网关与 ITMS 接口描述图 家庭网关与 ITMS 接口（M）包含以下逻辑接口： a)注册认证接口（M1） b)参数监视接口（M2） c)参数配置接口（M3） d)软件升级接口（M4） e)测试诊断接口（M5） 所有接口在系统中的位置，如图 5-1 所示： 图 51 家庭网关与 ITMS 接口 5.1.2 家庭网关与 ITMS 接口定义 a)设备注册认证接口（M1） 设备注册认证接口主要完成家庭网关注册认证功能，ITMS 将依据家庭网关信息，调 用其它接口内容，完成软件升级、参数配置（包括设备和业务的参数）等操作。 b)参数监视接口（M2） 参数监视接口主要完成 ITMS 对家庭网关参数模型的获取，实时数据、性能参数等的 获取，以及参数变更上报的设置（Notification）及家庭网关参数值变更后上报等功能。 c)参数配置接口（M3） 参数配置接口主要完成 ITMS 对家庭网关的参数配置（必须支持 SetParameterValues 和 配置文件方式） ，家庭网关配置文件的上传，配置家庭网关参数属性、及参数属性查询等功 能。 d)软件升级接口（M4） 软件升级接口主要完成 ITMS 对家庭网关的软件升级，配置文件的备份和下发，以及 软件版本信息的查询。 e)测试诊断接口（M5） 测试诊断接口主要完成 ITMS 对家庭网关的测试诊断任务（包括 PING 测试、ATM F5 Loop 测试、DSL 测试等） ，以及家庭网关重启，恢复出厂设置等功能。 5.1.3 终端管理协议栈分层模型 图 5-2 描述了家庭网关与终端管理通信接口协议栈的层次模型，其中 SSL/TLS 是安全 相关的承载协议，SOAP 及 RPC 方法是管理协议承载应用的主要方式。 图 52 终端管理协议栈分层模型 5.2 RPC 方法概述 本章对接口流程中调用的 RPC 方法进行概要描述，详细的 RPC 方法定义请参见 TR- 069 附录 A，本文附录 A 仅定义在 TR-069 基础上本标准修订的 RPC 方法。 GetRPCMethodsMM本方法可用于家庭网关或 ITMS 来发现另一方所支持 的方法集。 SetParameterValuesMMITMS 可用此方法来修改家 庭网关的一个或多个参数。 GetParameterValuesMM本方法可用于 ITMS 来获 取一个或多个家庭网关参 数的值。 GetParameterNamesMM本方法可以由 ITMS 用来 发现某一家庭网关上的可 访问的参数。 SetParameterAttributesMM本方法可以由 ITMS 用来 更改家庭网关上的一个或 多个参数的属性。在本标 准中定义 Notification 属性为 M， Access Control 属性为 O 。 GetParameterAttributesMM本方法可以由 ITMS 用来 读取家庭网关上的一个或 更多参数的属性。在本标 准中定义 Notification 属性为 M， Access Control 属性为 O。 AddObjectMM本方法可以由 ITMS 使用 来建立一个多实例对象 （multi-instance object）的 新实例。 DeleteObjectMM本方法用于删除一个对象 的特定实例。 RebootMM本方法令家庭网关重新启 动。 DownloadMM本方法可以由 ITMS 使用 来指示家庭网关在指定的 位置下载特定的文件。 UploadMM服务器用本方法使家庭网 关向指定的位置上载一个 特定的文件。 FactoryResetMM本方法将重置家庭网关到 其出厂默认状态。 GetQueuedTransfersOOITMS 可以用本方法来确定 前面的下载或上载请求的 状态。 ScheduleInformMMITMS 可以用本方法请求家 庭网关在未来某时刻计划 （与家庭网关的定期调用 Inform 方法分离）一次性 的 Inform 方法调用。 SetVouchersOOITMS 调用本方法来设置家 庭网关使用的一个或多个 Vouchers（凭据）选项。 GetOptionsOOITMS 可以用本方法来获得 家庭网关目前设置的选项 表，及其它相关状态信息。 GetRPCMethodsOO本方法可用于家庭网关或 ITMS 来发现另一方所支持 的方法集。 InformMM任何时刻要建立与 ITMS 的连接，家庭网关必须调 用 Inform 方法，来初始化 一个传输序列。 TransferCompleteMM本方法通知 ITMS 由以前 的 Download 或 Upload 方 法调用而引起的文件传输 已经结束（不管成功还是 失败） 。 RequestDownloadOO本方法允许家庭网关向 ITMS 请求一个文件下载。 KickedOO任何时刻家庭网关使用 Web 方式连接 ITMS 时被 触发。 5.3 家庭网关与 ITMS 接口安全 本章中描述家庭网关与 ITMS 安全连接的建立过程，后续所有流程均需满足本章中规 定的安全连接方式。若今后采用专用通道来进行管理，则可以不使用此安全接口。 家庭网关与 ITMS 接口采用 SSL/TLS 加密和 WWW-Authentication 组合使用方式实现 接口的安全。 在 SSL/TLS 安全通道建立过程中，ITMS 不需要通过证书对家庭网关的合法性进行认 证。家庭网关应支持通过证书对 ITMS 合法性进行认证，或者忽略通过证书对 ITMS 的合 法性进行认证两种方式。 5.3.1 家庭网关发起的安全连接流程 图 53 家庭网关发起的安全连接流程 a)家庭网关与 ITMS 建立 SSL/TLS 的安全通信通道； b)家庭网关与 ITMS 使用 WWW-Authentication 进行认证，通过 Inform 发起认证的 Http Request 连接，认证采用 Digest 的方式，其中 Digest 方式应遵循 RFC2617。 5.3.2 ITMS 发起的安全连接流程 图 54 ITMS 发起的安全连接流程 a)ITMS 作为客户端向家庭网关发起 WWW-Authentication 认证，使用 Digest 方式； b)认证通过后，家庭网关与 ITMS 建立 SSL/TLS 的安全通信通道； c)再次进行 WWW-Authentication 对家庭网关进行认证。 5.4 家庭网关与设备认证注册接口（M1） 5.4.1 M1 接口描述图 设备注册认证接口包括三个子接口流程： a)首次连接设备认证（基于物理 ID） b)首次连接设备认证（基于逻辑 ID） c)非首次连接设备认证 图 55 家庭网关与设备注册认证模块接口图 5.4.2 首次连接设备认证接口（基于物理 ID） 接口场景描述 家庭网关通过预配置专门的管理通道，访问 ITMS。通过该流程，ITMS 通过家庭网关 上报的物理 ID（如：设备序列号）进行认证后，向终端下发业务参数配置。 接口调用的 RPC 方法 InformInformResponse GetParameterValuesResponseGetParameterValues SetParameterValuesResponseSetParameterValues DownloadResponseDownload TransferCompleteTransferCompletResponse 接口时序 图 56 首次连接设备认证接口（基于物理 ID）流程图 a)家庭网关发起 Inform 请求，Eventcode 为 BOOTSTRAP，说明是首次连接 ITMS； b)ITMS 对家庭网关进行认证，根据家庭网关提供的 OUI-SerialNumber 查找匹配的 宽带帐号和密码及终端用户相应的配置文件，返回 InformResponse； c)家庭网关发起一条空的 Http Post 请求； d)ITMS 发起 GetParameterValues，要求检查家庭网关的宽带帐号/密码(可以省略)； e)家庭网关回应 GetParameterValuesResponse，携带宽带帐号（可以省略） ； f)根据宽带帐号及 OUI-SerialNumber 匹配，ITMS 将根据一定算法自动生成双向的 DIGEST 认证帐号，并发起 SetParameterValues 的 RPC，将新的帐号设置到家庭 网关上； g)家庭网关回应 SetParameterValuesResponse； h)根据宽带帐号及 OUI-SerialNumber 匹配，ITMS 将根据一定算法自动生成家庭网 关电信维护帐号，并发起 SetParameterValues 的 RPC，将新的电信维护帐号设置 到家庭网关上； i)家庭网关回应 SetParameterValuesResponse； j)根据宽带帐号及 OUI-SerialNumber 的判断，ITMS 发起 SetParameterValues 的 RPC，根据查找的结果设置家庭网关新的宽带帐号、密码以及相应的业务配置； k)家庭网关回应 SetParameterValuesResponse；（j/k 与 l/m 为互补步骤，如果以配 置文件的方式下发参数，则 j/k 可以省略） ； l)ITMS 发起 Download 的 RPC，要求家庭网关下载初始化的配置文件； m)家庭网关回应 DownloadResponse（j/k 与 l/m 为互补步骤，如果以参数的方式下 发配置并且不需要软件升级，则 l/m 可以省略） ； n)家庭网关根据 Download 中提供的 URL 参数进行配置文件下载； o)结束 Session，家庭网关重新发起 Inform，并至少携带 EventCode“TRANSFERCOMPLETE” ； p)ITMS 回应 InformResponse； q)家庭网关发起 TransferComplete 请求，报告下载的起始和结束时间，及成功或失 败消息； r)ITMS 回应 TransferCompleteResponse； s)结束。 接口交互内容 a)第一次 Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 为 “0 BOOTSTRAP” ； b)第二次 Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 至少包含“7 TRANSFERCOMPLETE” ； c)GetParmeterValues：参见 TR-069 附录 A.3.2.2 描述，请求的具体参数为： InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i . WANPPPConnection.i.Username InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i . WANPPPConnection.i.Password d)SetParameterValues：参见 TR-069 附录 A.3.2.1 描述，设置的具体参数根据家庭 网关类型及用户开展业务的不同而改变，必须要设置的参数包括： 认证帐号： InternetGatewayDevice.ManagementServer. Username InternetGatewayDevice.ManagementServer. Password InternetGatewayDevice.ManagementServer. ConnectionRequest- Username InternetGatewayDevice.ManagementServer. ConnectionRequest- Password 电信维护帐号： InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.UserName InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.Password 宽带帐号： InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i . WANPPPConnection.i.Username InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i . WANPPPConnection.i.Password e)Download：参见 TR-069 附录 A.3.2.8 描述，其中 FileType 的属性： 软件升级“1 Firmware Upgrade Image” 配置文件“3 Vendor Configuration File” f)TransferComplete：参见 TR-069 附录 A.3.3.2 描述。 5.4.3 首次连接设备认证接口（基于逻辑 ID） 接口场景描述 家庭网关通过预配置专门的管理通道将客户输入的逻辑 ID（如宽带账号）上报给 ITMS，ITMS 认证后，向终端下发业务参数配置。 接口调用的 RPC 方法 InformInformResponse GetParameterValuesResponseGetParameterValues SetParameterValuesResponseSetParameterValues DownloadResponseDownload TransferCompleteTransferCompletResponse 接口时序 图 57 首次连接设备认证接口（基于逻辑 ID）流程图 a)家庭网关发起 Inform 请求，Eventcode 至少包括：X CT-COM BIND，说明是首 次连接 ITMS，并要求 ITMS 通过宽带帐号和用户 ID 等信息进行绑定； b)ITMS 对家庭网关进行认证，返回 InformResponse； c)家庭网关发起一条空的 Http Post 请求； d)ITMS 通过宽带帐号和用户 ID 绑定用户信息、设备信息和业务信息，并发起 SetParameterValues，通知家庭网关是否绑定成功； e)家庭网关回应 SetParameterValuesResponse，如果绑定成功，ITMS 继续下面流程， 如果绑定不成功，直接跳转 s； f)ITMS 将根据一定算法自动生成双向的 DIGEST 认证帐号，并发起 SetParameterValues 的 RPC，将新的帐号设置到家庭网关上； g)家庭网关回应 SetParameterValuesResponse； h)ITMS 将根据一定算法自动生成家庭网关电信维护帐号，并发起 SetParameterValues 的 RPC，将新的电信维护帐号设置到家庭网关上； i)家庭网关回应 SetParameterValuesResponse； j)根据宽带帐号、绑定的设备信息及相关业务信息，ITMS 发起 SetParameterValues 的 RPC，设置家庭网关相应的业务配置； k)家庭网关回应 SetParameterValuesResponse；（j/k 与 l/m 为互补步骤，如果以配 置文件的方式下发参数，则 j/k 可以省略） ； l)ITMS 发起 Download 的 RPC，要求家庭网关下载初始化的配置文件； m)家庭网关回应 DownloadResponse（j/k 与 l/m 为互补步骤，如果以参数的方式下 发配置并且不需要软件升级，则 l/m 可以省略） ； n)家庭网关根据 Download 中提供的 URL 参数进行配置文件下载； o)结束 Session，家庭网关重新发起 Inform，并至少携带 EventCode“TRANSFERCOMPLETE” ； p)ITMS 回应 InformResponse； q)家庭网关发起 TransferComplete 请求，报告下载的起始和结束时间，及成功或失 败消息； r)ITMS 回应 TransferCompleteResponse； s)结束。 接口交互内容 a)第一次 Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 为 “X CT-COM BIND” b)第二次 Inform：EventCode 至少包含“7 TRANSFERCOMPLETE” c)SetParameterValues：参见 TR-069 附录 A.3.2.1 描述，设置的具体参数根据家庭 网关类型及用户开展业务的不同而改变，必须要设置的包括： 认证用户信息： InternetGatewayDevice. X_CT-COM_ UserInfo. Status 认证帐号： InternetGatewayDevice.ManagementServer. Username InternetGatewayDevice.ManagementServer. Password InternetGatewayDevice.ManagementServer. ConnectionRequest- Username InternetGatewayDevice.ManagementServer. ConnectionRequest- Password 电信维护帐号： InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.UserName InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.Password 宽带帐号： InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i . WANPPPConnection.i.Username InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i . WANPPPConnection.i.Password d)Download：参见 TR-069 附录 A.3.2.8 描述，其中 FileType 的属性： 软件升级“1 Firmware Upgrade Image” 配置文件“3 Vendor Configuration File” e)TransferComplete：参见 TR-069 附录 A.3.3.2 描述。 5.4.4 非首次连接设备认证接口 接口场景描述 家庭网关上电，向 ITMS 发起注册，ITMS 可发现并对家庭网关进行认证。 接口调用的 RPC 方法 InformInformResponse 接口时序 图 58 非首次连接设备认证接口流程图 a)家庭网关发起 Inform 请求，Eventcode 为 BOOT，说明是非首次连接 ITMS； b)ITMS 对家庭网关进行认证，根据家庭网关提供的 OUI-SerialNumber 查找匹配用 户相应的配置文件，返回 InformResponse； c)根据 ITMS 的计划任务，执行配置、Download 等计划任务（可选步骤） ； d)结束。 接口交互内容 a)Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 至少包含 “1 BOOT” 。 5.5 家庭网关与参数监视接口模块（M2） 5.5.1 M2 接口描述图 参数监视接口包括三个子接口流程： a)参数模型获取接口 b)参数查询接口 c)参数变化上报接口 图 59 家庭网关与参数监视模块接口图 5.5.2 参数模型获取接口 接口场景描述 ITMS 获得某一家庭网关所支持的 TR069 参数模型。 接口调用的 RPC 方法 InformInformResponse GetParameterNamesResponseGetParameterNames 接口时序 图 510 参数模型获取接口流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQUEST； b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 GetParameterNames RPC 方法，要求获得家庭网关的 TR069 参数模型， 建议 NextLevel=True； e)家庭网关回应 TR069 参数模型；（4、5 的过程可多次） f)结束。 接口交互内容 a)Inform：参见 TR-069 附录 A.3.3.1 描述； b)GetParameterNames：参见 TR-069 附录 A.3.2.3 描述，建议“NextLevel”为 TRUE。 5.5.3 参数查询接口 接口场景描述 ITMS 获得某一家庭网关特定的参数。 接口调用的 RPC 方法 InformInformResponse GetParameterValuesResponseGetParameterValues 接口时序 图 511 参数查询接口流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQUEST； b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 GetParameterValues RPC 方法，要求获得家庭网关的特定参数； e)家庭网关回应 GetParameterValuesResponse； f)结束。 接口交互内容 a)Inform：参见 TR-069 附录 A.3.3.1 描述； b)GetParmeterValues：参见 TR-069 附录 A.3.2.2 描述。 5.5.4 参数变化上报接口 接口场景描述 ITMS 获得某一家庭网关特定的参数。 接口调用的 RPC 方法 InformInformResponse SetParameterAttributesResponseSetParameterAttributes 接口时序 图 512 参数变化上报接口流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQUET； b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 SetParameterAttributes RPC 方法，设定参数值改变需要上报的参数属 性； e)家庭网关回应 SetParameterAttributesResponse； f)回应或结束 Session； g)参数值发生改变，家庭网关自动发起 Inform，EventCode 为 VALUE CHANGE； h)ITMS 回应 InformResponse； i)结束。 接口交互内容 a)Inform：参见 TR-069 附录 A.3.3.1 描述， “EventCode”至少要包含“VALUE CHANGE” ； b)SetParameterAttributes：参见 TR-069 附录 A.3.2.4 描述。 5.6 家庭网关与参数配置接口模块（M3） 5.6.1 M3 接口描述图 参数配置接口包括十个子接口流程： a)参数属性上报 b)配置 LAN 侧用户可写属性 c)参数/实例配置（SetParameter） d)实例删除配置 e)参数配置（配置文件） f)上传配置文件 g)上传日志文件 h)配置电信维护帐号 i)设备告警 j)设备状态监控 图 513 家庭网关与参数配置模块接口图 5.6.2 参数属性上报接口 接口场景描述 ITMS 获得特定家庭网关一个或多个参数的属性值。 接口调用的 RPC 方法 InformInformResponse GetParameterAttributesResponseGetParameterAttributes 接口时序 图 514 参数属性上报接口流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQUST； b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 GetParameterAttributes RPC 方法，要求获得家庭网关一个或多个参数 属性； e)家庭网关回应 GetParameterAttributesResponse； f)结束。 接口交互内容 a)Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 至少包含 “CONNECTIONREQUEST” ； b)GetParameterAttributes：参见 TR-069 附录 A.3.2.5 描述。 5.6.3 配置用户可写属性接口 接口场景描述 ITMS 对家庭网关配置某个参数是否有可写属性，实现对家庭网关 LAN 侧用户访问这 个参数的访问权限的远程控制。 （如果此参数配置为只读属性，家庭网关的 WEB 业务此参 数项应该变灰） 接口调用的 RPC 方法 InformInformResponse SetParameterAttributesResponseSetParameterAttributes 接口时序 图 515 配置用户可写属性接口流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQUST； b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 SetParameterAttributes RPC 方法，如果配置 LAN 侧用户具有可写属 性，则配置 AccessList 属性为“Subscriber” ，如果配置 LAN 侧用户具有只读 属性，则在 AccessList 属性中删除“Subscriber”实体； e)家庭网关回应 GetParameterAttributesResponse； f)结束。 接口交互内容 a)Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 至少包含 “CONNECTIONREQUEST” ； b)SetParameterAttributes：参见 TR-069 附录 A.3.2.4 描述。 5.6.4 参数实例配置接口（SetParameterValues） 接口场景描述 ITMS 新增家庭网关某一实例及配置相关参数。 接口调用的 RPC 方法 InformInformResponse AddObjectResponseAddObject SetParameterValuesResponseSetParameterValues 接口时序 图 516 参数实例配置接口流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQUST；（其他如 Scheduled Inform 情况也成立） b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 AddObject RPC 方法，为家庭网关生成实例； e)家庭网关回应 AddObjectResponse； f)ITMS 发起 SetParameterValues RPC 方法，配置实例或其他参数； g)家庭网关回应 SetParameterValuesResponse； h)结束。 接口交互内容 1、 Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 可包含 “CONNECTIONREQUEST”等； 2、 AddObject：参见 TR-069 附录 A.3.2.6 描述； 3、 SetParameterValues：参见 TR-069 附录 A.3.2.1 描述。 5.6.5 实例删除配置接口 接口场景描述 ITMS 删除特定家庭网关的一条实例。 接口调用的 RPC 方法 InformInformResponse DeleteObjectResponseDeleteObject 接口时序 图 517 实例删除配置接口流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQUST； b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 DeleteObject RPC 方法，为家庭网关删除一实例； e)家庭网关回应 DeleteObjectResponse； f)结束。 接口交互内容 a)Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 包含“ CONNECTIONREQUEST”等； b)DeleteObject：参见 TR-069 附录 A.3.2.7 描述。 5.6.6 参数实例配置接口（配置文件） 接口场景描述 ITMS 以配置文件的方式下发参数配置。 接口调用的 RPC 方法 InformInformResponse DownloadResponseDownload TransferComplete TransferCompleteResponse 接口时序 图 518 参数实例配置接口（配置文件）流程图 a)家庭网关发起 Inform，包含 EventCode CONNECTIONREQEUST；（其他如 Scheduled Inform 情况也成立） ； b)ITMS 回应 InformResponse； c)家庭网关发起空的 HTTP Post； d)ITMS 调用 Download RPC 方法，要求家庭网关下载配置文件；（如果有多个配 置文件，则需要发起多个 Download 过程） e)家庭网关回应 DownloadResponse； f)下载配置文件； g)结束 Session，家庭网关重新发起 Inform，EventCode 为“ TRANSFERCOMPLETE” ； h)ITMS 回应 InformResponse； i)家庭网关发起 TransferComplete，告知下载结果及开始/结束时间； j)ITMS 回应 TransferCompleteResponse； k)结束。 接口交互内容 a)第一次 Inform：参见 TR-069 附录 A.3.3.1 描述，EventCode 包含“