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

《中国电信家庭网关与ITMS接口技术要求》由会员分享，可在线阅读，更多相关《中国电信家庭网关与ITMS接口技术要求（127页珍藏版）》请在装配图网上搜索。

1、保密等级：公开发放中国电信集团公司技术标准Q/CT2271-2010中国电信家庭网关（e8）与终端综合管理系统（ITMS）接口技术要求（V3.0）中国电信集团公司2009年3月2010-07发布2010-07实施中国电信集团公司 发布目 录前 言IV1 范围12 规范性引用文件13 缩略语14 家庭网关与ITMS接口总体概述24.1 家庭网关与ITMS接口在网络中的位置24.2 家庭网关与ITMS接口主要内容35 接口技术要求35.1 家庭网关与ITMS接口框架3 家庭网关与ITMS接口描述图3 家庭网关与ITMS接口定义4 终端管理协议栈分层模型45.2 RPC方法概述55.3 家庭网关与I

2、TMS接口安全6 家庭网关发起的安全连接流程7 ITMS发起的安全连接流程75.4 家庭网关与设备认证注册接口（M1）8 M1接口描述图8 首次连接设备认证接口（基于物理ID）8 首次连接设备认证接口（基于逻辑ID）11 非首次连接设备认证接口155.5 家庭网关与参数监视接口模块（M2）16 M2接口描述图16 参数模型获取接口16 参数查询接口17 参数变化上报接口185.6 家庭网关与参数配置接口模块（M3）20 M3接口描述图20 参数属性上报接口20 配置用户可写属性接口21 参数实例配置接口（SetParameterValues）22 实例删除配置接口24 参数实例配置接口（配置文

3、件）25 上传配置文件接口26 上传日志文件接口28 配置电信维护帐号接口29 设备告警接口30 设备监控接口325.7 家庭网关与软件升级接口模块（M4）33 M4接口描述图33 软件升级接口34 软件版本查询接口36 软件升级配置备份接口375.8 家庭网关与测试诊断接口模块（M5）42 M5接口描述图42 PING测试接口42 ATMF5Loop测试接口44 重启接口46 恢复出厂设置接口47 DSL测试接口48 IAD模块测试接口50附录A（规范性附录） RPC方法定义52A.1 Inform52附录B（规范性附录） RPC XML Schema描述54B.1 XML Schema文件

4、头54B.2 SOAP信包头54B.3 SOAP错误代码54B.4 RPC参数类型定义54B.5 RPC方法请求/响应56附录C（规范性附录） 业务配置描述59C.1业务配置逻辑图59C.2 业务配置模板59C.2.1 基础类配置模板60 面向应用配置77附录D（资料性附录） 对TR-069的扩展83D.1 RPC方法83D.2 RPC方法修订清单84附录E（规范性附录）故障数据字典84E.1 故障编号规则84E.2 故障信息列表85E.3 用于故障检测的PC客户端代码定义87附录F (规范性附录) 家庭网关和ITMS交互约定细则91F.1家庭网关TR069参数树初始配置技术细则91F.2 A

5、DSL上联桥连接建立流程92F.3 ADSL上联路由连接建立流程92F.4 以太网上联桥连接建立流程93F.5 以太网上联路由连接建立流程94F.6 家庭网关和ITMS交互过程重启原则94F.7家庭网关Inform消息上报，参数列表扩充95F.8 ITMS与家庭网关交互约定95F.9 ITMS异常流程95F.10 ITMS对家庭网关远程升级流程（配置文件不兼容）96F.11平台业务下发逻辑判断96F.12 VOIP业务发放流程97F.13无线加密建立流程98F.14端口映射建立流程99F.15 QOS出厂配置模版100F.16 QOS建立流程102F.17 ADSL上联DHCP方式建立流程10

6、3F.18 以太网上联DHCP方式建立流程103F.19 ADSL上联Static IP方式建立流程104F.20 以太网上联Static IP方式建立流程105F.21 ITMS与家庭网关通信超时控制建议106F.22 基于逻辑ID的设备首次认证流程108F.23基于DSCP数据标识优先级队列方式的QoS保障建立流程（示例）108F.24基于目的IP优先级队列方式的QoS保障建立流程（示例）109F.25基于业务发现优先级队列方式的QoS保障建立流程1（示例）109F.26基于业务发现优先级队列方式的QoS保障建立流程2（示例）110F.27 EPON上联桥连接建立流程111F.28 EPO

7、N上联路由连接建立流程111F.29 EPON上联DHCP方式建立流程112F.30 EPON上联Static IP方式建立流程113F.31 ITMS下发业务模板示例114F.32 VDSL2上联桥连接建立流程114F.33 VDSL2上联路由连接建立流程115F.34 VDSL2上联DHCP方式建立流程116F.35 VDSL2上联Static IP方式建立流程116F.36 GPON上联桥连接建立流程117F.37 GPON上联路由连接建立流程118F.38 GPON上联DHCP方式建立流程119F.39 GPON上联Static IP方式建立流程120前 言本标准是根据中国电信开展“天

8、翼宽带”业务的实际情况而制定的，主要用于规范家庭网关与终端综合管理系统接口的功能、流程等内容。本标准的附录A、附录B、附录C、附录E、附录F为规范性附录，附录D为资料性附录。本标准由中国电信集团公司组织制定，上海研究院起草。本标准为中国电信企业秘密，仅限于“天翼宽带”合作厂商使用。中国电信家庭网关（e8）与终端综合管理系统（ITMS）接口技术要求1 范围本标准规定了家庭网关与终端综合管理系统的接口，包括接口的基本RPC方法调用，接口的安全性连接定义以及设备认证、参数监视、参数配置、软件升级及测试诊断模块的详细接口调用过程和字段内容。本标准适用于家庭网关（e8）与终端综合管理系统之间的接口开发，

9、为中国电信家庭网关与终端综合管理系统进行互通性测试提供依据。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。RFC2616Hypertext Transfer Protocol - HTTP/1.1RFC2617HTTP Authentication: Basic and Digest Access AuthenticationRFC2246The TLS Protocol

10、, Version 1.0SOAP1.1Simple Object Access Protocol (SOAP) 1.1SSL3.0The SSL Protocol, Version 3.0TR-069CPE WAN Management ProtocolTR-098Gateway Device Version 1.1 Data Model for TR-069TR-104Provisioning Parameters for VoIP CPETR-142Framework for TR-069 Enabled PON Devices 3 缩略语ADSLAsymmetric Digital S

11、ubscriber 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文件传送协

12、议HTTPHypertext Transfer Protocol超文本传输协议HTTPSHypertext Transfer Protocol Secure安全超文本传输协议IPInternet Protocol互联网协议ITMSIntegrated Terminal Management System终端综合管理系统OUIOrganizationally Unique Identifiers组织唯一标识PPPoEPPP over Ethernet以太网上传送PPP协议PVCPermanent Virtual Circuit永久虚电路QoSQuality of Service服务质量RPCRe

13、mote 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 Eq

14、uivalent Privacy有线等效加密WLANWireless LAN无线局域网WPAWiFi Protected AccessWiFi网络安全存取WPSWiFi Protected Setup无线安全设置XMLExtensible Markup Language可扩展标记语言XSDXML Schema Infoset ModeXML数据定义文件4 家庭网关与ITMS接口总体概述4.1 家庭网关与ITMS接口在网络中的位置家庭网关与ITMS接口见图4-1中的M接口图4-1家庭网关与ITMS接口在网络中的位置4.2 家庭网关与ITMS接口主要内容 接口安全 注册认证接口 参数监视接口 参数

15、配置接口 软件升级接口 测试诊断接口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) 参数监

16、视接口（M2）参数监视接口主要完成ITMS对家庭网关参数模型的获取，实时数据、性能参数等的获取，以及参数变更上报的设置（Notification）及家庭网关参数值变更后上报等功能。c) 参数配置接口（M3）参数配置接口主要完成ITMS对家庭网关的参数配置（必须支持SetParameterValues和配置文件方式），家庭网关配置文件的上传，配置家庭网关参数属性、及参数属性查询等功能。d) 软件升级接口（M4）软件升级接口主要完成ITMS对家庭网关的软件升级，配置文件的备份和下发，以及软件版本信息的查询。e) 测试诊断接口（M5）测试诊断接口主要完成ITMS对家庭网关的测试诊断任务（包括PING

17、测试、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方法。方法名称家庭网关要求ITMS要求功能描述家庭网关方法应答调用GetRPCMethodsMM本方法可用于家庭网关或ITMS来发现

18、另一方所支持的方法集。SetParameterValuesMMITMS可用此方法来修改家庭网关的一个或多个参数。GetParameterValuesMM本方法可用于ITMS来获取一个或多个家庭网关参数的值。GetParameterNamesMM本方法可以由ITMS用来发现某一家庭网关上的可访问的参数。SetParameterAttributesMM本方法可以由ITMS用来更改家庭网关上的一个或多个参数的属性。在本标准中定义Notification属性为M， Access Control属性为O 。GetParameterAttributesMM本方法可以由ITMS用来读取家庭网关上的一个或更多

19、参数的属性。在本标准中定义Notification属性为M， Access Control属性为O。AddObjectMM本方法可以由ITMS使用来建立一个多实例对象（multi-instance object）的新实例。DeleteObjectMM本方法用于删除一个对象的特定实例。RebootMM本方法令家庭网关重新启动。DownloadMM本方法可以由ITMS使用来指示家庭网关在指定的位置下载特定的文件。UploadMM服务器用本方法使家庭网关向指定的位置上载一个特定的文件。FactoryResetMM本方法将重置家庭网关到其出厂默认状态。GetQueuedTransfersOOITMS可

20、以用本方法来确定前面的下载或上载请求的状态。ScheduleInformMMITMS可以用本方法请求家庭网关在未来某时刻计划（与家庭网关的定期调用Inform方法分离）一次性的Inform方法调用。SetVouchersOOITMS调用本方法来设置家庭网关使用的一个或多个Vouchers（凭据）选项。GetOptionsOOITMS可以用本方法来获得家庭网关目前设置的选项表，及其它相关状态信息。ITMS方法调用应答GetRPCMethodsOO本方法可用于家庭网关或ITMS来发现另一方所支持的方法集。InformMM任何时刻要建立与ITMS的连接，家庭网关必须调用Inform方法，来初始化一个

21、传输序列。TransferCompleteMM本方法通知ITMS由以前的Download或Upload方法调用而引起的文件传输已经结束（不管成功还是失败）。RequestDownloadOO本方法允许家庭网关向ITMS请求一个文件下载。KickedOO任何时刻家庭网关使用Web方式连接ITMS时被触发。5.3 家庭网关与ITMS接口安全本章中描述家庭网关与ITMS安全连接的建立过程，后续所有流程均需满足本章中规定的安全连接方式。若今后采用专用通道来进行管理，则可以不使用此安全接口。家庭网关与ITMS接口采用SSL/TLS加密和 WWW-Authentication组合使用方式实现接口的安全。在

22、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) IT

23、MS作为客户端向家庭网关发起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）5.4.2.1 接口场景描述家庭网关通过预配置专门的管理通道，访问ITMS

24、。通过该流程，ITMS通过家庭网关上报的物理ID（如：设备序列号）进行认证后，向终端下发业务参数配置。5.4.2.2 接口调用的RPC方法家庭网关ITMSInformInformResponseGetParameterValuesResponseGetParameterValuesSetParameterValuesResponseSetParameterValuesDownloadResponseDownloadTransferCompleteTransferCompletResponse5.4.2.3 接口时序图 56首次连接设备认证接口（基于物理ID）流程图a) 家庭网关发起Inform

25、请求，Eventcode为BOOTSTRAP，说明是首次连接ITMS；b) ITMS对家庭网关进行认证，根据家庭网关提供的OUI-SerialNumber查找匹配的宽带帐号和密码及终端用户相应的配置文件，返回InformResponse；c) 家庭网关发起一条空的Http Post请求；d) ITMS发起GetParameterValues，要求检查家庭网关的宽带帐号/密码(可以省略)；e) 家庭网关回应GetParameterValuesResponse，携带宽带帐号（可以省略）；f) 根据宽带帐号及OUI-SerialNumber匹配，ITMS将根据一定算法自动生成双向的DIGEST认证帐

26、号，并发起SetParameterValues的RPC，将新的帐号设置到家庭网关上；g) 家庭网关回应SetParameterValuesResponse；h) 根据宽带帐号及OUI-SerialNumber匹配，ITMS将根据一定算法自动生成家庭网关电信维护帐号，并发起SetParameterValues的RPC，将新的电信维护帐号设置到家庭网关上；i) 家庭网关回应SetParameterValuesResponse；j) 根据宽带帐号及OUI-SerialNumber的判断，ITMS发起SetParameterValues的RPC，根据查找的结果设置家庭网关新的宽带帐号、密码以及相应的业

27、务配置；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回应Infor

28、mResponse；q) 家庭网关发起TransferComplete请求，报告下载的起始和结束时间，及成功或失败消息；r) ITMS回应TransferCompleteResponse；s) 结束。5.4.2.4 接口交互内容a) 第一次Inform：参见TR-069附录描述，EventCode 为 “0 BOOTSTRAP” ；b) 第二次Inform：参见TR-069附录描述，EventCode至少包含“7 TRANSFERCOMPLETE” ；c) GetParmeterValues：参见TR-069附录描述，请求的具体参数为：参数名称InternetGatewayDevice.WAN

29、Device.i.WANConnectionDevice.i.WANPPPConnection.i.UsernameInternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.Passwordd) SetParameterValues：参见TR-069附录描述，设置的具体参数根据家庭网关类型及用户开展业务的不同而改变，必须要设置的参数包括：认证帐号：参数名称InternetGatewayDevice.ManagementServer. UsernameInternetGatewayDevice.Manag

30、ementServer. PasswordInternetGatewayDevice.ManagementServer. ConnectionRequestUsernameInternetGatewayDevice.ManagementServer. ConnectionRequestPassword电信维护帐号：参数名称InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.UserNameInternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.Password宽带帐号：参数名

31、称InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.UsernameInternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.Passworde) Download：参见TR-069附录描述，其中FileType的属性：软件升级“1 Firmware Upgrade Image”配置文件“3 Vendor Configuration File”f) TransferComplete：参见TR-069附录描

32、述。5.4.3 首次连接设备认证接口（基于逻辑ID）5.4.3.1 接口场景描述家庭网关通过预配置专门的管理通道将客户输入的逻辑ID（如宽带账号）上报给ITMS，ITMS认证后，向终端下发业务参数配置。5.4.3.2 接口调用的RPC方法家庭网关ITMSInformInformResponseGetParameterValuesResponseGetParameterValuesSetParameterValuesResponseSetParameterValuesDownloadResponseDownloadTransferCompleteTransferCompletResponse5.

33、4.3.3 接口时序 图 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继续下面

34、流程，如果绑定不成功，直接跳转s；f) ITMS将根据一定算法自动生成双向的DIGEST认证帐号，并发起SetParameterValues的RPC，将新的帐号设置到家庭网关上；g) 家庭网关回应SetParameterValuesResponse；h) ITMS将根据一定算法自动生成家庭网关电信维护帐号，并发起SetParameterValues的RPC，将新的电信维护帐号设置到家庭网关上；i) 家庭网关回应SetParameterValuesResponse； j) 根据宽带帐号、绑定的设备信息及相关业务信息，ITMS发起SetParameterValues的RPC，设置家庭网关相应的业务

35、配置；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回应Infor

36、mResponse；q) 家庭网关发起TransferComplete请求，报告下载的起始和结束时间，及成功或失败消息；r) ITMS回应TransferCompleteResponse；s) 结束。5.4.3.4 接口交互内容a) 第一次Inform：参见TR-069附录描述，EventCode 为 “X CT-COM BIND”b) 第二次Inform：EventCode至少包含“7 TRANSFERCOMPLETE”c) SetParameterValues：参见TR-069附录描述，设置的具体参数根据家庭网关类型及用户开展业务的不同而改变，必须要设置的包括：认证用户信息：参数名称Int

37、ernetGatewayDevice. X_CT-COM_ UserInfo. Status认证帐号：参数名称InternetGatewayDevice.ManagementServer. UsernameInternetGatewayDevice.ManagementServer. PasswordInternetGatewayDevice.ManagementServer. ConnectionRequestUsernameInternetGatewayDevice.ManagementServer. ConnectionRequestPassword电信维护帐号：参数名称Internet

38、GatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.UserNameInternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.Password宽带帐号：参数名称InternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.UsernameInternetGatewayDevice.WANDevice.i.WANConnectionDevice.i.WANPPPConnection.i.Passwordd)

39、Download：参见TR-069附录描述，其中FileType的属性：软件升级“1 Firmware Upgrade Image”配置文件“3 Vendor Configuration File”e) TransferComplete：参见TR-069附录描述。5.4.4 非首次连接设备认证接口5.4.4.1 接口场景描述家庭网关上电，向ITMS发起注册，ITMS可发现并对家庭网关进行认证。5.4.4.2 接口调用的RPC方法家庭网关ITMSInformInformResponse5.4.4.3 接口时序图 58非首次连接设备认证接口流程图a) 家庭网关发起Inform请求，Eventcod

40、e为BOOT，说明是非首次连接ITMS；b) ITMS对家庭网关进行认证，根据家庭网关提供的OUI-SerialNumber查找匹配用户相应的配置文件，返回InformResponse；c) 根据ITMS的计划任务，执行配置、Download等计划任务（可选步骤）；d) 结束。5.4.4.4 接口交互内容a) Inform：参见TR-069附录描述，EventCode 至少包含 “1 BOOT” 。5.5 家庭网关与参数监视接口模块（M2）5.5.1 M2接口描述图参数监视接口包括三个子接口流程：a) 参数模型获取接口b) 参数查询接口c) 参数变化上报接口图 59 家庭网关与参数监视模块接口

41、图5.5.2 参数模型获取接口5.5.2.1 接口场景描述ITMS获得某一家庭网关所支持的TR069参数模型。5.5.2.2 接口调用的RPC方法家庭网关ITMSInformInformResponseGetParameterNamesResponseGetParameterNames5.5.2.3 接口时序图 510 参数模型获取接口流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQUEST；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用GetParameterNames RPC方法，要求获得

42、家庭网关的TR069参数模型，建议NextLevel=True；e) 家庭网关回应TR069参数模型；（4、5的过程可多次）f) 结束。5.5.2.4 接口交互内容a) Inform：参见TR-069附录描述；b) GetParameterNames：参见TR-069附录描述，建议“NextLevel”为TRUE。5.5.3 参数查询接口5.5.3.1 接口场景描述ITMS获得某一家庭网关特定的参数。5.5.3.2 接口调用的RPC方法家庭网关ITMSInformInformResponseGetParameterValuesResponseGetParameterValues5.5.3.3

43、接口时序图 511参数查询接口流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQUEST；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用GetParameterValues RPC方法，要求获得家庭网关的特定参数；e) 家庭网关回应GetParameterValuesResponse；f) 结束。5.5.3.4 接口交互内容a) Inform：参见TR-069附录描述；b) GetParmeterValues：参见TR-069附录描述。5.5.4 参数变化上报接口5.5.4.1 接口场景描述IT

44、MS获得某一家庭网关特定的参数。5.5.4.2 接口调用的RPC方法家庭网关ITMSInformInformResponseSetParameterAttributesResponseSetParameterAttributes5.5.4.3 接口时序图 512 参数变化上报接口流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQUET；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用SetParameterAttributes RPC方法，设定参数值改变需要上报的参数属性；e) 家庭网关回应Set

45、ParameterAttributesResponse；f) 回应或结束Session；g) 参数值发生改变，家庭网关自动发起Inform，EventCode为VALUE CHANGE；h) ITMS回应InformResponse；i) 结束。5.5.4.4 接口交互内容a) Inform：参见TR-069附录描述，“EventCode”至少要包含“VALUE CHANGE” ；b) SetParameterAttributes：参见TR-069附录描述。5.6 家庭网关与参数配置接口模块（M3）5.6.1 M3接口描述图参数配置接口包括十个子接口流程：a) 参数属性上报b) 配置LAN侧用

46、户可写属性c) 参数/实例配置（SetParameter）d) 实例删除配置e) 参数配置（配置文件）f) 上传配置文件g) 上传日志文件h) 配置电信维护帐号i) 设备告警j) 设备状态监控图 513 家庭网关与参数配置模块接口图5.6.2 参数属性上报接口5.6.2.1 接口场景描述ITMS获得特定家庭网关一个或多个参数的属性值。5.6.2.2 接口调用的RPC方法家庭网关ITMSInformInformResponseGetParameterAttributesResponseGetParameterAttributes5.6.2.3 接口时序图 514 参数属性上报接口流程图a) 家庭

47、网关发起Inform，包含EventCode CONNECTIONREQUST；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用GetParameterAttributes RPC方法，要求获得家庭网关一个或多个参数属性；e) 家庭网关回应GetParameterAttributesResponse；f) 结束。5.6.2.4 接口交互内容a) Inform：参见TR-069附录描述，EventCode至少包含“CONNECTIONREQUEST” ；b) GetParameterAttributes：参见TR-069附录描述。5.6

48、.3 配置用户可写属性接口5.6.3.1 接口场景描述ITMS对家庭网关配置某个参数是否有可写属性，实现对家庭网关LAN侧用户访问这个参数的访问权限的远程控制。（如果此参数配置为只读属性，家庭网关的WEB业务此参数项应该变灰）5.6.3.2 接口调用的RPC方法家庭网关ITMSInformInformResponseSetParameterAttributesResponseSetParameterAttributes5.6.3.3 接口时序图 515 配置用户可写属性接口流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQUST；b) ITMS回应Info

49、rmResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用SetParameterAttributes RPC方法，如果配置LAN侧用户具有可写属性，则配置AccessList属性为“Subscriber” ，如果配置LAN侧用户具有只读属性，则在AccessList属性中删除“Subscriber”实体；e) 家庭网关回应GetParameterAttributesResponse；f) 结束。5.6.3.4 接口交互内容a) Inform：参见TR-069附录描述，EventCode至少包含“CONNECTIONREQUEST” ；b) SetParameterAt

50、tributes：参见TR-069附录描述。5.6.4 参数实例配置接口（SetParameterValues）5.6.4.1 接口场景描述ITMS新增家庭网关某一实例及配置相关参数。5.6.4.2 接口调用的RPC方法家庭网关ITMSInformInformResponseAddObjectResponseAddObjectSetParameterValuesResponseSetParameterValues5.6.4.3 接口时序图 516参数实例配置接口流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQUST；（其他如Scheduled Infor

51、m情况也成立）b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用AddObject RPC方法，为家庭网关生成实例；e) 家庭网关回应AddObjectResponse；f) ITMS发起SetParameterValues RPC方法，配置实例或其他参数；g) 家庭网关回应SetParameterValuesResponse；h) 结束。5.6.4.4 接口交互内容1、 Inform：参见TR-069附录描述，EventCode可包含“CONNECTIONREQUEST”等；2、 AddObject：参见TR-069附录描述；3、 S

52、etParameterValues：参见TR-069附录描述。5.6.5 实例删除配置接口5.6.5.1 接口场景描述ITMS删除特定家庭网关的一条实例。5.6.5.2 接口调用的RPC方法家庭网关ITMSInformInformResponseDeleteObjectResponseDeleteObject5.6.5.3 接口时序图 517实例删除配置接口流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQUST；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用DeleteObject RPC方法

53、，为家庭网关删除一实例；e) 家庭网关回应DeleteObjectResponse；f) 结束。5.6.5.4 接口交互内容a) Inform：参见TR-069附录描述，EventCode包含“ CONNECTIONREQUEST”等；b) DeleteObject：参见TR-069附录描述。5.6.6 参数实例配置接口（配置文件）5.6.6.1 接口场景描述ITMS以配置文件的方式下发参数配置。5.6.6.2 接口调用的RPC方法家庭网关ITMSInformInformResponseDownloadResponseDownloadTransferComplete TransferCompl

54、eteResponse5.6.6.3 接口时序图 518 参数实例配置接口（配置文件）流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQEUST；（其他如Scheduled Inform情况也成立）；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用Download RPC方法，要求家庭网关下载配置文件；（如果有多个配置文件，则需要发起多个Download过程）e) 家庭网关回应DownloadResponse；f) 下载配置文件；g) 结束Session，家庭网关重新发起Inform，EventC

55、ode为“ TRANSFERCOMPLETE” ；h) ITMS回应InformResponse；i) 家庭网关发起TransferComplete，告知下载结果及开始/结束时间；j) ITMS回应TransferCompleteResponse；k) 结束。5.6.6.4 接口交互内容a) 第一次Inform：参见TR-069附录描述，EventCode包含“ CONNECTIONREQUEST”等；b) 第二次Inform：参见TR-069附录描述，EventCode至少包含“ TRANSFERCOMPLETE” ；c) Download：参见TR-069附录描述，其中FileType的取

56、值 “Vendor Configuration File” 。5.6.7 上传配置文件接口5.6.7.1 接口场景描述ITMS要求家庭网关上传特定的配置文件。5.6.7.2 接口调用的RPC方法家庭网关ITMSInformInformResponseUploadResponseUploadTransferCompleteTransferCompleteResponse5.6.7.3 接口时序图 519上传配置文件接口流程图a) 家庭网关发起Inform，包含EventCode CONNECTIONREQEUST；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP P

57、ost；d) ITMS调用Upload RPC方法，要求家庭网关上传配置文件；e) 家庭网关回应UploadResponse；f) 上传配置文件；g) 结束Session，家庭网关重新发起Inform，EventCode为“ TRANSFERCOMPLETE” ；h) ITMS回应InformResponse；i) 家庭网关发起TransferComplete，告知上传结果及开始/结束时间；j) ITMS回应TransferCompleteResponse；k) 结束。5.6.7.4 接口交互内容a) 第一次Inform：参见TR-069附录描述，EventCode包含“ CONNECTION

58、REQUEST”；b) 第二次Inform：参见TR-069附录描述，EventCode至少包含“ TRANSFERCOMPLETE”；c) Upload：参见TR-069附录描述。5.6.8 上传日志文件接口5.6.8.1 接口场景描述ITMS要求家庭网关上传日志文件。5.6.8.2 接口调用的RPC方法家庭网关ITMSInformInformResponseUploadResponseUploadTransferCompleteTransferCompleteResponse5.6.8.3 接口时序图 520上传日志文件接口流程图a) 家庭网关发起Inform，包含EventCode CO

59、NNECTIONREQEUST；b) ITMS回应InformResponse；c) 家庭网关发起空的HTTP Post；d) ITMS调用Upload RPC方法，要求家庭网关上传日志文件；e) 家庭网关回应UploadResponse；f) 上传日志文件；g) 结束Session，家庭网关重新发起Inform，EventCode为“ TRANSFERCOMPLETE” ；h) ITMS回应InformResponse；i) 家庭网关发起TransferComplete，告知上传结果及开始/结束时间；j) ITMS回应TransferCompleteResponse；k) 结束。5.6.8.4 接口交互内容a) 第一次Inform：参见TR-069附录描述，EventCode包含“ CONNECTIONREQUEST”