• 4.64 MB
  • 99页

中国电信“我的e家”技术规范-e家终端与终端综合管理系统接口(v1.0)_20070427

  • 99页
  • 当前文档由用户上传发布,收益归属用户
  1. 1、本文档共5页,可阅读全部内容。
  2. 2、本文档内容版权归属内容提供方,所产生的收益全部归内容提供方所有。如果您对本文有版权争议,可选择认领,认领后既往收益都归您。
  3. 3、本文档由用户上传,本站不保证质量和数量令人满意,可能有诸多瑕疵,付费之前,请仔细先通过免费阅读内容等途径辨别内容交易风险。如存在严重挂羊头卖狗肉之情形,可联系本站下载客服投诉处理。
  4. 文档侵权举报电话:19940600175。
'中中中国国国电电电信信信“““我我我的的的eee家家家”””技技技术术术规规规范范范---eee家家家终终终端端端与与与终终终端端端综综综合合合管管管理理理系系系统统统接接接口口口(((VVV111...000)))中国电信集团公司2007年4月 e家终端与终端综合管理系统接口(V1.0)目录前言......................................................................................................................................................61、范围..............................................................................................................................................72、引用标准.....................................................................................................................................83、缩略语.........................................................................................................................................94、E家终端与ITMS接口总体概述......................................................................................104.1E家终端与ITMS接口在网络中的位置........................................................................104.2E家终端与ITMS接口主要内容.......................................................................................105、接口技术要求.........................................................................................................................115.1E家终端与ITMS接口框架................................................................................................115.1.1e家终端与ITMS接口描述图..................................................................................115.1.2e家终端与ITMS接口定义.......................................................................................115.1.3终端管理协议栈分层模型.....................................................................................125.2RPC方法概述........................................................................................................................135.3E家终端与ITMS接口安全................................................................................................145.3.1e家终端发起的安全连接流程...............................................................................155.3.2ITMS发起的安全连接流程....................................................................................155.4E家终端与设备认证注册接口(M1)........................................................................165.4.1M1接口描述图...........................................................................................................165.4.2首次连接设备认证接口(临时帐号).............................................................165.4.2.1接口场景描述...............................................................................................................165.4.2.2接口调用的RPC方法................................................................................................175.4.2.3接口时序.........................................................................................................................185.4.2.4接口交互内容...............................................................................................................215.4.3首次连接设备认证接口(非临时帐号)........................................................225.4.3.1接口场景描述...............................................................................................................225.4.3.2接口调用的RPC方法................................................................................................225.4.3.3接口时序.........................................................................................................................225.4.3.4接口交互内容...............................................................................................................255.4.4非首次连接设备认证接口.....................................................................................265.4.4.1接口场景描述...............................................................................................................265.4.4.2接口调用的RPC方法................................................................................................265.4.4.3接口时序.........................................................................................................................265.4.4.4接口交互内容...............................................................................................................275.5E家终端与参数监视接口模块(M2)........................................................................275.5.1M2接口描述图...........................................................................................................275.5.2参数模型获取接口...................................................................................................285.5.2.1接口场景描述...............................................................................................................285.5.2.2接口调用的RPC方法................................................................................................28 e家终端与终端综合管理系统接口(V1.0)5.5.2.3接口时序.........................................................................................................................285.5.2.4接口交互内容...............................................................................................................295.5.3参数查询接口.............................................................................................................295.5.3.1接口场景描述...............................................................................................................295.5.3.2接口调用的RPC方法................................................................................................295.5.3.3接口时序.........................................................................................................................305.5.3.4接口交互内容...............................................................................................................305.5.4参数变化上报接口...................................................................................................315.5.4.1接口场景描述...............................................................................................................315.5.4.2接口调用的RPC方法................................................................................................315.5.4.3接口时序.........................................................................................................................315.5.4.4接口交互内容...............................................................................................................325.6E家终端与参数配置接口模块(M3)........................................................................325.6.1M3接口描述图...........................................................................................................325.6.2参数属性上报接口...................................................................................................335.6.2.1接口场景描述...............................................................................................................335.6.2.2接口调用的RPC方法................................................................................................335.6.2.3接口时序.........................................................................................................................345.6.2.4接口交互内容...............................................................................................................345.6.3配置用户可写属性接口..........................................................................................355.6.3.1接口场景描述...............................................................................................................355.6.3.2接口调用的RPC方法................................................................................................355.6.3.3接口时序.........................................................................................................................355.6.3.4接口交互内容...............................................................................................................365.6.4参数实例配置接口(SetParameterValues)................................................365.6.4.1接口场景描述...............................................................................................................365.6.4.2接口调用的RPC方法................................................................................................365.6.4.3接口时序.........................................................................................................................375.6.4.4接口交互内容...............................................................................................................385.6.5实例删除配置接口...................................................................................................385.6.5.1接口场景描述...............................................................................................................385.6.5.2接口调用的RPC方法................................................................................................385.6.5.3接口时序.........................................................................................................................395.6.5.4接口交互内容...............................................................................................................395.6.6参数实例配置接口(配置文件).......................................................................405.6.6.1接口场景描述...............................................................................................................405.6.6.2接口调用的RPC方法................................................................................................405.6.6.3接口时序.........................................................................................................................405.6.6.4接口交互内容...............................................................................................................415.6.7上传配置文件接口...................................................................................................425.6.7.1接口场景描述...............................................................................................................425.6.7.2接口调用的RPC方法.................................................................................................425.6.7.3接口时序..........................................................................................................................425.6.7.4接口交互内容...............................................................................................................43 e家终端与终端综合管理系统接口(V1.0)5.6.8上传日志文件接口...................................................................................................435.6.8.1接口场景描述...............................................................................................................435.6.8.2接口调用的RPC方法................................................................................................445.6.8.3接口时序.........................................................................................................................445.6.8.4接口交互内容...............................................................................................................455.6.9配置电信维护帐号接口..........................................................................................455.6.9.1接口场景描述...............................................................................................................455.6.9.2接口调用的RPC方法................................................................................................455.6.9.3接口时序.........................................................................................................................465.6.9.4接口交互内容...............................................................................................................465.7E家终端与软件升级接口模块(M4)........................................................................475.7.1M4接口描述图...........................................................................................................475.7.2软件升级接口.............................................................................................................475.7.2.1接口场景描述...............................................................................................................475.7.2.2接口调用的RPC方法.................................................................................................475.7.2.3接口时序..........................................................................................................................485.7.2.4接口交互内容...............................................................................................................505.7.3软件版本查询接口....................................................................................................505.7.3.1接口场景描述...............................................................................................................505.7.3.2接口调用的RPC方法.................................................................................................505.7.3.3接口时序..........................................................................................................................515.7.3.4接口交互内容...............................................................................................................515.7.4软件升级配置备份接口..........................................................................................525.7.4.1接口场景描述...............................................................................................................525.7.4.2接口调用的RPC方法.................................................................................................525.7.4.3接口时序..........................................................................................................................525.7.4.4接口交互内容...............................................................................................................565.8E家终端与测试诊断接口模块(M5)........................................................................565.8.1M5接口描述图...........................................................................................................565.8.2PING测试接口............................................................................................................575.8.2.1接口场景描述...............................................................................................................575.8.2.2接口调用的RPC方法................................................................................................575.8.2.3接口时序.........................................................................................................................585.8.2.4接口交互内容...............................................................................................................595.8.3ATMF5Loop测试接口...............................................................................................605.8.3.1接口场景描述...............................................................................................................605.8.3.2接口调用的RPC方法................................................................................................605.8.3.3接口时序.........................................................................................................................615.8.3.4接口交互内容...............................................................................................................625.8.4重启接口......................................................................................................................635.8.4.1接口场景描述...............................................................................................................635.8.4.2接口调用的RPC方法................................................................................................635.8.4.3接口时序.........................................................................................................................635.8.4.4接口交互内容...............................................................................................................64 e家终端与终端综合管理系统接口(V1.0)5.8.5恢复出厂设置接口...................................................................................................645.8.5.1接口场景描述...............................................................................................................645.8.5.2接口调用的RPC方法................................................................................................645.8.5.3接口时序.........................................................................................................................655.8.5.4接口交互内容...............................................................................................................655.8.6DSL测试接口...............................................................................................................665.8.6.1接口场景描述...............................................................................................................665.8.6.2接口调用的RPC方法................................................................................................665.8.6.3接口时序.........................................................................................................................665.8.6.4接口交互内容...............................................................................................................68附录A(规范性附录)RPC方法定义..................................................................................69A.1Inform.....................................................................................................................................69附录B(规范性附录)RPCXMLSCHEMA描述...........................................................71B.1XMLSCHEMA文件头............................................................................................................71B.2SOAP信包头.........................................................................................................................71B.3SOAP错误代码.....................................................................................................................71B.4RPC参数类型定义..............................................................................................................71B.5RPC方法请求/响应............................................................................................................73附录C(规范性附录)业务配置描述...................................................................................76C.1业务配置逻辑图..................................................................................................................76C.2业务配置模板......................................................................................................................76C.2.1基础类配置模板........................................................................................................77C.2.1.1WAN连接.........................................................................................................................77C.2.1.2PPPoE代理功能............................................................................................................78C.2.1.3DDNS..................................................................................................................................78C.2.1.4WLAN.................................................................................................................................79C.2.1.5e家终端电信维护帐号管理..................................................................................79C.2.1.6TR-069..............................................................................................................................79C.2.1.7强制家庭门户管理....................................................................................................80C.2.1.8PORTFORWARDING...............................................................................................80C.2.1.9DHCPSERVER..............................................................................................................80C.2.1.10ALG功能开关..............................................................................................................81C.2.1.11断线重连功能............................................................................................................81C.2.1.12网络服务管理.............................................................................................................81C.2.2面向应用配置............................................................................................................82C.2.2.1VoIP....................................................................................................................................82C.2.2.2IPTV....................................................................................................................................83C.2.2.3多终端上网....................................................................................................................83附录D(资料性附录)对TR-069的扩展.........................................................................85D.1RPC方法..............................................................................................................................85D.2RPC方法修订清单...........................................................................................................86 e家终端与终端综合管理系统接口(V1.0)附录E(规范性附录)故障数据字典.....................................................................................87E.1故障编号规则......................................................................................................................87E.2故障信息列表......................................................................................................................87E.3用于故障检测的PC客户端代码定义..........................................................................90附录F(规范性附录)E家终端和ITMS交互约定细则.....................................................94F.1E家终端TR069参数树初始配置技术细则..................................................................94F.2桥连接建立流程...................................................................................................................94F.3路由连接建立流程..............................................................................................................95F.4E家终端和ITMS交互过程重启原则..............................................................................96F.5E家终端INFORM消息上报,参数列表扩充..................................................................96F.6ITMS与E家庭终端交互约定.............................................................................................97F.7ITMS异常流程.......................................................................................................................97F.8ITMS对E家终端远程升级流程(配置文件不兼容)..............................................98 e家终端与终端综合管理系统接口(V1.0)前言本规范是根据中国电信开展“我的e家”业务的实际情况而制定的,主要用于规范e家终端,终端综合管理系统及接口的功能、流程等内容。本规范是“我的e家”的系列技术标准之一,该系列标准目前包括如下(后续将根据实际情况扩充):(1)《中国电信“我的e家”技术规范-e家终端(e8)(V1.0)》(2)《中国电信“我的e家”技术规范-e家终端与终端综合管理系统接口(V1.0)》(3)《中国电信“我的e家”技术规范-终端综合管理系统(V1.0)》本规范由中国电信股份有限公司上海研究院起草。 e家终端与终端综合管理系统接口(V1.0)1、范围本规范规定了e家终端(适用于e8,e9形态)与终端综合管理系统的接口,包括接口的基本RPC方法调用,接口的安全性连接定义以及设备认证、参数监视、参数配置、软件升级及测试诊断模块的详细接口调用过程和字段内容。本规范适用于e家终端与终端综合管理系统之间的接口开发,为中国电信e家终端与终端综合管理系统进行互通性测试提供依据。 e家终端与终端综合管理系统接口(V1.0)2、引用标准下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件,其最新版本适用于本标准。TR-069:CPEWANManagementProtocolPD-069:TR-069withChangeTextfromWT-121TR-106:DataModelTemplateforTR-069-EnabledDevicesPD-128:InteroperabilityTestPlanforTR-069PlugfestsWT-121:TR-069ImplementationGuidelinesSOAP1.1:SimpleObjectAccessProtocol(SOAP)1.1SSL3.0:TheSSLProtocol,Version3.0RFC2616:HypertextTransferProtocol--HTTP/1.1RFC2617:HTTPAuthentication:BasicandDigestAccessAuthenticationRFC2246:TheTLSProtocol,Version1.0 e家终端与终端综合管理系统接口(V1.0)3、缩略语CPECustomerPremisesEquipment用户终端设备HGWHomeGateway家庭网关HTTPHypertextTransferProtocol超文本传输协议HTTPSHypertextTransferProtocolSecure安全超文本传输协议IPInternetProtocol互联网协议ITMSIntegratedTerminalManagementSystem终端综合管理系统RPCRemoteProcedureCall远程过程调用SOAPSimpleObjectAccessProtocol简单对象访问协议TCPTransmissionControlProtocol传输控制协议URLUniformResourceLocator统一资源定位符XMLExtensibleMarkupLanguage可扩展标记语言XSDXMLSchemaInfosetModelXML数据定义文件 e家终端与终端综合管理系统接口(V1.0)4、e家终端与ITMS接口总体概述4.1e家终端与ITMS接口在网络中的位置4.2e家终端与ITMS接口主要内容¾接口安全¾注册认证接口¾参数监视接口¾参数配置接口¾软件升级接口¾测试诊断接口 e家终端与终端综合管理系统接口(V1.0)5、接口技术要求5.1e家终端与ITMS接口框架5.1.1e家终端与ITMS接口描述图e家终端与ITMS接口(M)包含以下逻辑接口:1)注册认证接口(M1)2)参数监视接口(M2)3)参数配置接口(M3)4)软件升级接口(M4)5)测试诊断接口(M5)所有接口在系统中的位置,如图5-1所示:图5-1e家终端与ITMS接口5.1.2e家终端与ITMS接口定义1)设备注册认证接口(M1)设备注册认证接口主要完成e家终端注册认证功能,ITMS将依据e家终端信息,调用其它接口内容,完成软件升级、参数配置(包括设备和业务的参数)等操作。2)参数监视接口(M2)参数监视接口主要完成ITMS对e家终端参数模型的获取,实时数据、性能参数等的获取,以及参数变更上报的设置(Notification)及e家终端参数值变更后上报等功能。 e家终端与终端综合管理系统接口(V1.0)3)参数配置接口(M3)参数配置接口主要完成ITMS对e家终端的参数配置(必须支持SetParameterValues和配置文件方式),e家终端配置文件的上传,配置e家终端参数属性、及参数属性查询等功能。4)软件升级接口(M4)软件升级接口主要完成ITMS对e家终端的软件升级,配置文件的备份和下发,以及软件版本信息的查询。5)测试诊断接口(M5)测试诊断接口主要完成ITMS对e家终端的测试诊断任务,包括PING测试,ATMF5Loop测试,DSL测试等,以及e家终端重启,恢复出厂设置等功能。5.1.3终端管理协议栈分层模型图5-2描述了e家终端与终端管理通信接口协议栈的层次模型,其中SSL/TLS是安全相关的承载协议,SOAP及RPC方法是管理协议承载应用的主要方式。图5-2终端管理协议栈分层模型 e家终端与终端综合管理系统接口(V1.0)5.2RPC方法概述本章对接口流程中调用的RPC方法进行概要描述,详细的RPC方法定义请参见TR-069附录A,本文附录A仅定义在TR-069基础上本标准修订的RPC方法。方法名称e家终端要ITMS要求功能描述求e家终端方法应答调用GetRPCMethodsMM本方法可用于e家终端或ITMS来发现另一方所支持的方法集。SetParameterValuesMMITMS可用此方法来修改e家终端的一个或多个参数。GetParameterValuesMM本方法可用于ITMS来获取一个或多个e家终端参数的值。GetParameterNamesMM本方法可以由ITMS用来发现某一e家终端上的可访问的参数。SetParameterAttributesMM本方法可以由ITMS用来更改e家终端上的一个或多个参数的属性。在本标准中定义Notification属性为MAccessControl属性为OGetParameterAttributesMM本方法可以由ITMS用来读取e家终端上的一个或更多参数的属性。在本标准中定义Notification属性为MAccessControl属性为OAddObjectMM本方法可以由ITMS使用来建立一个多实例对象(multi-instanceobject)的新实例。DeleteObjectMM本方法用于删除一个对象的特定实例。RebootMM本方法令e家终端重新启动。DownloadMM本方法可以由ITMS使用来指示e家终端在指定的位置下载特定的文件。UploadMM服务器用本方法使e家终端向指定的位置上载一个特定的文件。FactoryResetMM本方法将重置e家终端到其出厂默认状态。GetQueuedTransfersOOITMS可以用本方法来确定前面的下载或上载请求的状态。ScheduleInformMMITMS可以用本方法请求e家终端在未来某时刻计划(与e家终端的定期调用Inform方法分离)一次性的Inform方法调用。SetVouchersOOITMS调用本方法来设置e家终端使用的一个或多个Vouchers(凭据)选项。GetOptionsOOITMS可以用本方法来获得e家 e家终端与终端综合管理系统接口(V1.0)方法名称e家终端要ITMS要求功能描述求e家终端方法应答调用终端目前设置的选项表,及其它相关状态信息。ITMS方法调用应答GetRPCMethodsOO本方法可用于e家终端或ITMS来发现另一方所支持的方法集。InformMM任何时刻要建立与ITMS的连接,e家终端必须调用Inform方法,来初始化一个传输序列。TransferCompleteMM本方法通知ITMS由以前的Download或Upload方法调用而引起的文件传输已经结束(不管成功还是失败)。RequestDownloadOO本方法允许e家终端向ITMS请示求一个文件下载。KickedOO任何时刻e家终端使用Web方式连接ITMS时被触发。5.3e家终端与ITMS接口安全本章中描述e家终端与ITMS安全连接的建立过程,后续所有流程均需满足本章中规定的安全连接方式。若今后采用专用通道来进行管理,则可以不使用此安全接口。e家终端与ITMS接口采用SSL/TLS加密和WWW-Authentication组合使用方式实现接口的安全.在SSL/TLS安全通道建立过程中,ITMS不需要通过证书对e家终端的合法性进行认证.e家终端应支持通过证书对ITMS合法性进行认证,或者忽略通过证书对ITMS的合法性进行认证两种方式. e家终端与终端综合管理系统接口(V1.0)5.3.1e家终端发起的安全连接流程图5-3e家终端发起的安全连接流程1、e家终端与ITMS建立SSL/TLS的安全通信通道;2、e家终端与ITMS使用WWW-Authentication进行认证,通过Inform发起认证的HttpRequest连接,认证采用Digest的方式。其中Digest方式应遵循RFC2617。5.3.2ITMS发起的安全连接流程图5-4ITMS发起的安全连接流程1、ITMS作为客户端向e家终端发起WWW-Authentication认证,使用Digest方 e家终端与终端综合管理系统接口(V1.0)式;2、认证通过后,e家终端与ITMS建立SSL/TLS的安全通信通道;3、再次进行WWW-Authentication对e家终端进行认证。5.4e家终端与设备认证注册接口(M1)5.4.1M1接口描述图设备注册认证接口包括三个子接口流程:1)首次连接设备认证(临时帐号)2)首次连接设备认证(非临时帐号)3)非首次连接设备认证图5-5e家终端与设备注册认证模块接口图5.4.2首次连接设备认证接口(临时帐号)5.4.2.1接口场景描述e家终端设备中预配置临时的宽带帐号,该帐号只能获得可访问ITMSURL的临时IP地址。通过该流程,ITMS将向用户提供可上公网的正式宽带帐号及其他的服务等级配置。 e家终端与终端综合管理系统接口(V1.0)5.4.2.2接口调用的RPC方法e家终端ITMSInformInformResponseGetParameterValuesResponseGetParameterValuesSetParameterValuesResponseSetParameterValuesDownloadResponseDownloadTransferCompleteTransferCompletResponse e家终端与终端综合管理系统接口(V1.0)5.4.2.3接口时序 e家终端与终端综合管理系统接口(V1.0) e家终端与终端综合管理系统接口(V1.0)图5-6首次连接设备认证接口(临时帐号)流程图1、e家终端发起Inform请求,Eventcode为BOOTSTRAP说明是首次连接ITMS;2、ITMS对e家终端进行认证,根据e家终端提供的OUI-SerialNumber查找匹配的宽带帐号和密码及终端用户相应的配置文件,返回InformResponse;3、e家终端发起一条空的HttpPost请求;4、ITMS发起GetParameterValues,要求检查e家终端的宽带帐号/密码(可以省略);5、e家终端回应GetParameterValuesResponse,携带宽带帐号(可以省略);6、根据宽带帐号及OUI-SerialNumber匹配,ITMS将根据一定算法自动生成双向的DIGEST认证帐号,并发起SetParameterValues的RPC,将新的帐号设置到e家终端上;7、e家终端回应SetParameterValuesResponse;8、根据宽带帐号及OUI-SerialNumber匹配,ITMS将根据一定算法自动生成e家终端电信维护帐号,并发起SetParameterValues的RPC,将新的电信维护帐号设置到e家终端上;9、e家终端回应SetParameterValuesResponse;10、根据宽带帐号及OUI-SerialNumber的判断,ITMS发起SetParameterValues的RPC,根据查找的结果设置e家终端新的宽带帐号和密码和相应业务配置;11、e家终端回应SetParameterValuesResponse;(10/11与12/13为互补步骤,如果以配置文件的方式下发参数,则10/11可以省略);12、ITMS发起Download的RPC,要求e家终端下载初始化的配置文件;13、e家终端回应DownloadResponse(10/11与12/13为互补步骤,如果以参数的方式下发配置并且不需要软件升级,则12/13可以省略);14、e家终端根据Download中提供的URL参数进行配置文件下载;15、结束Session,e家终端重新发起Inform,并至少携带EventCode“TRANSFERCOMPLETE”; e家终端与终端综合管理系统接口(V1.0)16、ITMS回应InformResponse;17、e家终端发起TransferComplete请求,报告下载的起始和结束时间,及成功或失败消息;18、ITMS回应TransferCompleteResponse;19、结束。5.4.2.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode为“0BOOTSTRAP”;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“7TRANSFERCOMPLETE”;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描述,设置的具体参数根据e家终端类型及用户开展业务的不同而改变,必须要设置的包括:认证帐号:参数名称InternetGatewayDevice.ManagementServer.UsernameInternetGatewayDevice.ManagementServer.PasswordInternetGatewayDevice.ManagementServer.ConnectionRequest-UsernameInternetGatewayDevice.ManagementServer.ConnectionRequest-Password电信维护帐号:参数名称InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.UserName e家终端与终端综合管理系统接口(V1.0)InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.Password宽带帐号:参数名称InternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANPPPConnection.{i}.UsernameInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANPPPConnection.{i}.PasswordDownload:参见PD-069附录A.3.2.8描述,其中FileType的属性:软件升级“1FirmwareUpgradeImage”配置文件“3VendorConfigurationFile”TransferComplete:参见PD-069附录A.3.3.2描述。5.4.3首次连接设备认证接口(非临时帐号)5.4.3.1接口场景描述e家终端设备中预配置宽带帐号。通过该流程,ITMS将向用户提供与其相匹配的服务等级配置。5.4.3.2接口调用的RPC方法e家终端ITMSInformInformResponseGetParameterValuesResponseGetParameterValuesSetParameterValuesResponseSetParameterValuesDownloadResponseDownloadTransferCompleteTransferCompletResponse5.4.3.3接口时序 e家终端与终端综合管理系统接口(V1.0) e家终端与终端综合管理系统接口(V1.0)图5-7首次连接设备认证接口(非临时帐号)流程图1、e家终端发起Inform请求,Eventcode为BOOTSTRAP说明是首次连接ITMS;2、ITMS对e家终端进行认证,返回InformResponse;3、e家终端发起一条空的HttpPost请求;4、ITMS发起GetParameterValues,要求检查e家终端的宽带帐号/密码;5、e家终端回应GetParameterValuesResponse,携带宽带帐号/密码(固定为空);6、根据宽带帐号及OUI-SerialNumber匹配,ITMS将根据一定算法自动生成双向的DIGEST认证帐号,并发起SetParameterValues的RPC,将新的帐号设置到e家终端上;7、e家终端回应SetParameterValuesResponse;8、根据宽带帐号及OUI-SerialNumber匹配,ITMS将根据一定算法自动生成e家终端电信维护帐号,并发起SetParameterValues的RPC,将新的电信维护帐号设置到e家终端上;9、e家终端回应SetParameterValuesResponse;10、根据宽带帐号,绑定设备信息OUI-SerialNumber及相关业务信息,ITMS发起SetParameterValues的RPC,根据查找的结果设置e家终端相应的业务配置;11、e家终端回应SetParameterValuesResponse;(6/7与8/9为互补步骤,如果以配置文件的方式下发参数,则6/7可以省略);12、ITMS发起Download的RPC,要求e家终端下载初始化的配置文件;13、e家终端回应DownloadResponse(6/7与8/9为互补步骤,如果以参数的方式下发配置并且不需要软件升级,则8/9可以省略);14、e家终端根据Download中提供的URL参数进行配置文件下载;15、结束Session,e家终端重新发起Inform,并至少携带EventCode“TRANSFERCOMPLETE”;16、ITMS回应InformResponse;17、e家终端发起TransferComplete请求,报告下载的起始和结束时间,及 e家终端与终端综合管理系统接口(V1.0)成功或失败消息;18、ITMS回应TransferCompleteResponse;19、结束。5.4.3.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode为“0BOOTSTRAP”第二次Inform:EventCode至少包含“7TRANSFERCOMPLETE”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描述,设置的具体参数根据e家终端类型及用户开展业务的不同而改变,必须要设置的包括:认证帐号:参数名称InternetGatewayDevice.ManagementServer.UsernameInternetGatewayDevice.ManagementServer.PasswordInternetGatewayDevice.ManagementServer.ConnectionRequest-UsernameInternetGatewayDevice.ManagementServer.ConnectionRequest-Password电信维护帐号:参数名称InternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.UserNameInternetGatewayDevice.DeviceInfo.X_CT-COM_TeleComAccount.Password宽带帐号: e家终端与终端综合管理系统接口(V1.0)参数名称InternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANPPPConnection.{i}.UsernameInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANPPPConnection.{i}.PasswordDownload:参见PD-069附录A.3.2.8描述,其中FileType的属性:软件升级“1FirmwareUpgradeImage”配置文件“3VendorConfigurationFile”TransferComplete:参见PD-069附录A.3.3.2描述。5.4.4非首次连接设备认证接口5.4.4.1接口场景描述e家终端上电,向ITMS发起注册,ITMS可发现并对e家终端进行认证。5.4.4.2接口调用的RPC方法e家终端ITMSInformInformResponse5.4.4.3接口时序 e家终端与终端综合管理系统接口(V1.0)图5-8非首次连接设备认证接口流程图1、e家终端发起Inform请求,Eventcode为BOOT说明是非首次连接ITMS;2、ITMS对e家终端进行认证,根据e家终端提供的OUI-SerialNumber查找匹配用户相应的配置文件,返回InformResponse;3、根据ITMS的计划任务,执行配置、Download等计划任务,可选步骤;4、结束。5.4.4.4接口交互内容Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“1BOOT”。5.5e家终端与参数监视接口模块(M2)5.5.1M2接口描述图参数监视接口包括三个子接口流程:1)参数模型获取接口2)参数查询接口3)参数变化上报接口图5-9e家终端与参数监视模块接口图 e家终端与终端综合管理系统接口(V1.0)5.5.2参数模型获取接口5.5.2.1接口场景描述ITMS获得某一e家终端所支持的TR069参数模型。5.5.2.2接口调用的RPC方法e家终端ITMSInformInformResponseGetParameterNamesResponseGetParameterNames5.5.2.3接口时序图5-10参数模型获取接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUEST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用GetParameterNamesRPC方法,要求获得e家终端的TR069参数模型,建议NextLevel=True; e家终端与终端综合管理系统接口(V1.0)5、e家终端回应TR069参数模型;(4、5的过程可多次)6、结束。5.5.2.4接口交互内容Inform:参见PD-069附录A.3.3.1描述;GetParameterNames:参见PD-069附录A.3.2.3描述,建议“NextLevel”为TRUE。5.5.3参数查询接口5.5.3.1接口场景描述ITMS获得某一e家终端特定的参数。5.5.3.2接口调用的RPC方法e家终端ITMSInformInformResponseGetParameterValuesResponseGetParameterValues e家终端与终端综合管理系统接口(V1.0)5.5.3.3接口时序图5-11参数查询接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUEST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用GetParameterValuesRPC方法,要求获得e家终端的特定参数;5、e家终端回应GetParameterValuesResponse;6、结束。5.5.3.4接口交互内容Inform:参见PD-069附录A.3.3.1描述;GetParmeterValues:参见PD-069附录A.3.2.2描述。 e家终端与终端综合管理系统接口(V1.0)5.5.4参数变化上报接口5.5.4.1接口场景描述ITMS获得某一e家终端特定的参数。5.5.4.2接口调用的RPC方法e家终端ITMSInformInformResponseSetParameterAttributesResponseSetParameterAttributes5.5.4.3接口时序图5-12参数变化上报接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUET; e家终端与终端综合管理系统接口(V1.0)2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用SetParameterAttributesRPC方法,设定参数值改变需要上报的参数属性;5、e家终端回应SetParameterAttributesResponse;6、回应或结束Session;7、参数值发生改变,e家终端自动发起Inform,EventCode为VALUECHANGE;8、ITMS回应InformResponse;9、结束。5.5.4.4接口交互内容Inform:参见PD-069附录A.3.3.1描述,“EventCode”至少要包含“VALUECHANGE”;SetParameterAttributes:参见PD-069附录A.3.2.4描述。5.6e家终端与参数配置接口模块(M3)5.6.1M3接口描述图参数配置接口包括八个子接口流程:1)参数属性上报2)配置LAN侧用户可写属性3)参数/实例配置(SetParameter)4)实例删除配置5)参数配置(配置文件)6)上传配置文件7)上传日志文件8)配置电信维护帐号 e家终端与终端综合管理系统接口(V1.0)图5-13e家终端与参数配置模块接口图5.6.2参数属性上报接口5.6.2.1接口场景描述ITMS获得特定e家终端一个或多个参数的属性值。5.6.2.2接口调用的RPC方法e家终端ITMSInformInformResponseGetParameterAttributesResponseGetParameterAttributes e家终端与终端综合管理系统接口(V1.0)5.6.2.3接口时序图5-14参数属性上报接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用GetParameterAttributesRPC方法,要求获得e家终端一个或多个参数属性;5、e家终端回应GetParameterAttributesResponse;6、结束。5.6.2.4接口交互内容Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“CONNECTIONREQUEST”;GetParameterAttributes:参见PD-069附录A.3.2.5描述。 e家终端与终端综合管理系统接口(V1.0)5.6.3配置用户可写属性接口5.6.3.1接口场景描述ITMS对e家终端配置某个参数是否有可写属性,实现对e家终端LAN侧用户访问这个参数的访问权限的远程控制。(如果此参数配置为只读属性,e家终端的WEB业务此参数项应该变灰)5.6.3.2接口调用的RPC方法e家终端ITMSInformInformResponseSetParameterAttributesResponseSetParameterAttributes5.6.3.3接口时序图5-15配置用户可写属性接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost; e家终端与终端综合管理系统接口(V1.0)4、ITMS调用SetParameterAttributesRPC方法,如果配置LAN侧用户具有可写属性,则配置AccessList属性为“Subscriber”,如果配置LAN侧用户具有只读属性,则在AccessList属性中删除“Subscriber”实体;5、e家终端回应GetParameterAttributesResponse;6、结束。5.6.3.4接口交互内容Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“CONNECTIONREQUEST”;SetParameterAttributes:参见PD-069附录A.3.2.4描述。5.6.4参数实例配置接口(SetParameterValues)5.6.4.1接口场景描述ITMS新增e家终端某一实例及配置相关参数。5.6.4.2接口调用的RPC方法e家终端ITMSInformInformResponseAddObjectResponseAddObjectSetParameterValuesResponseSetParameterValues e家终端与终端综合管理系统接口(V1.0)5.6.4.3接口时序图5-16参数实例配置接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;(其他如ScheduledInform情况也成立)2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用AddObjectRPC方法,为e家终端生成实例;5、e家终端回应AddObjectResponse;6、ITMS发起SetParameterValuesRPC方法,配置实例或其他参数;7、e家终端回应SetParameterValuesResponse;8、结束。 e家终端与终端综合管理系统接口(V1.0)5.6.4.4接口交互内容Inform:参见PD-069附录A.3.3.1描述,EventCode可包含“CONNECTIONREQUEST”等;AddObject:参见PD-069附录A.3.2.6描述;SetParameterValues:参见PD-069附录A.3.2.1描述。5.6.5实例删除配置接口5.6.5.1接口场景描述ITMS删除特定e家终端的一条实例。5.6.5.2接口调用的RPC方法e家终端ITMSInformInformResponseDeleteObjectResponseDeleteObject e家终端与终端综合管理系统接口(V1.0)5.6.5.3接口时序图5-17实例删除配置接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用DeleteObjectRPC方法,为e家终端删除一实例;5、e家终端回应DeleteObjectResponse;6、结束。5.6.5.4接口交互内容Inform:参见PD-069附录A.3.3.1描述,EventCode包含“CONNECTIONREQUEST”等;DeleteObject:参见PD-069附录A.3.2.7描述。 e家终端与终端综合管理系统接口(V1.0)5.6.6参数实例配置接口(配置文件)5.6.6.1接口场景描述ITMS以配置文件的方式下发参数配置。5.6.6.2接口调用的RPC方法e家终端ITMSInformInformResponseDownloadResponseDownloadTransferCompleteTransferCompleteResponse5.6.6.3接口时序图5-18参数实例配置接口(配置文件)流程图 e家终端与终端综合管理系统接口(V1.0)1、e家终端发起Inform,包含EventCodeCONNECTIONREQEUST;(其他如ScheduledInform情况也成立);2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用DownloadRPC方法,要求e家终端下载配置文件;(如果有多个配置文件,则需要发起多个Download过程)5、e家终端回应DownloadResponse;6、下载配置文件;7、结束Session,e家终端重新发起Inform,EventCode为“TRANSFERCOMPLETE”;8、ITMS回应InformResponse;9、e家终端发起TransferComplete,告知下载结果及开始/结束时间;10、ITMS回应TransferCompleteResponse;11、结束。5.6.6.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“CONNECTIONREQUEST”等;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“TRANSFERCOMPLETE”;Download:参见PD-069附录A.3.2.8描述,其中FileType的取值“VendorConfigurationFile”。 e家终端与终端综合管理系统接口(V1.0)5.6.7上传配置文件接口5.6.7.1接口场景描述ITMS要求e家终端上传特定的配置文件。5.6.7.2接口调用的RPC方法e家终端ITMSInformInformResponseUploadResponseUploadTransferCompleteTransferCompleteResponse5.6.7.3接口时序图5-19上传配置文件接口流程图 e家终端与终端综合管理系统接口(V1.0)1、e家终端发起Inform,包含EventCodeCONNECTIONREQEUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用UploadRPC方法,要求e家终端上传配置文件;5、e家终端回应UploadResponse;6、上传配置文件;7、结束Session,e家终端重新发起Inform,EventCode为“TRANSFERCOMPLETE”;8、ITMS回应InformResponse;9、e家终端发起TransferComplete,告知上传结果及开始/结束时间;10、ITMS回应TransferCompleteResponse;11、结束。5.6.7.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“CONNECTIONREQUEST”;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“TRANSFERCOMPLETE”;Upload:参见PD-069附录A.4.1.5描述。5.6.8上传日志文件接口5.6.8.1接口场景描述ITMS要求e家终端上传日志文件。 e家终端与终端综合管理系统接口(V1.0)5.6.8.2接口调用的RPC方法e家终端ITMSInformInformResponseUploadResponseUploadTransferCompleteTransferCompleteResponse5.6.8.3接口时序图5-20上传日志文件接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQEUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用UploadRPC方法,要求e家终端上传日志文件;5、e家终端回应UploadResponse; e家终端与终端综合管理系统接口(V1.0)6、上传日志文件;7、结束Session,e家终端重新发起Inform,EventCode为“TRANSFERCOMPLETE”;8、ITMS回应InformResponse;9、e家终端发起TransferComplete,告知上传结果及开始/结束时间;10、ITMS回应TransferCompleteResponse;11、结束。5.6.8.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“CONNECTIONREQUEST”;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“TRANSFERCOMPLETE”;Upload:参见PD-069附录A.4.1.5描述。5.6.9配置电信维护帐号接口5.6.9.1接口场景描述电信维护人员上门处理e家终端故障,在维护完成后通过e家终端界面的专门操作通知ITMS.5.6.9.2接口调用的RPC方法e家终端ITMSInformInformResponseSetParameterValuesResponseSetParameterValues e家终端与终端综合管理系统接口(V1.0)5.6.9.3接口时序图5-21电信维护帐号配置接口流程图1、e家终端发起Inform,包含EventCodeXCT-COMACCOUNTCHANGE;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS根据算法生成e家终端电信维护帐号,调用SetParameterValuesRPC方法,更新e家终端电信维护帐号;5、e家终端回应SetParameterValuesResponse;6、结束。5.6.9.4接口交互内容Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“XCT-COMACCOUNTCHANGE”;SetParameterValues:参见PD-069附录A.3.2.1描述。 e家终端与终端综合管理系统接口(V1.0)5.7e家终端与软件升级接口模块(M4)5.7.1M4接口描述图软件升级接口包括三个子接口流程:1)软件升级流程2)软件版本查询流程3)软件升级配置备份流程图5-22e家终端与软件升级模块接口图5.7.2软件升级接口5.7.2.1接口场景描述ITMS指定e家终端在特定的时刻进行软件升级或ITMS即时要求e家终端进行升级,e家终端能够正常完成升级操作。5.7.2.2接口调用的RPC方法e家终端ITMSInformInformResponseDownloadResponseDownloadTransferComplete(条件发起)TransferCompletResponse(条件响应) e家终端与终端综合管理系统接口(V1.0)5.7.2.3接口时序由于本流程具有条件发起,故先描述条件转移图:图5-23e家终端与软件升级模块接口图1、终端响应DownloadRPC方法;2、如果Download方法的返回值中的参数Status=0,说明下载并且应用下载成功,直接至6;3、如果Download方法的返回值中的参数Status=1,说明需要后续的步骤保证下载的成功;4、在符合3的条件下,如果不需要e家终端进行重启,则下载并应用成功后,通过TransferCompleteRPC方法通知ITMS本次下载过程的具体消息及结束,至6;5、在符合3的条件下,如果需要e家终端进行重启,则在重启后发送InformTRANSFERCOMPLETE告知ITMS本次下载结束,并调用TransferCompleteRPC方法通知ITMS下载过程的具体消息,至6;6、结束下载。 e家终端与终端综合管理系统接口(V1.0)图5-24软件升级接口流程图1、e家终端在任何可发送Inform的时刻发送携带响应EventCode的Inform消息,如BOOTSTRAP、CONNECTIONREQUEST、SCHEDULED等;2、ITMS回应InformResponse;3、e家终端发送空的HTTPPost请求;4、ITMS向e家终端发起DownloadRPC调用;5、e家终端相应DownloadResponse,若返回参数中的Status=0,则直接跳至9;6、至文件服务器下载软件;7、若Status=1,且e家终端在下载并使新软件生效时无需重启,则进入以下流程: e家终端与终端综合管理系统接口(V1.0)7.1e家终端发起TransferCompleteRPC,上报下载并应用成功,及升级的详细信息;7.2ITMS回应TransferComplete确认,跳至9;8、若Status=1,且e家终端在下载并使新软件生效时需重启,则进入以下流程:8.1e家终端重启,并发送Inform,EventCode为BOOT和TRANSFERCOMPLET,上报下载并应用成功;8.2ITMS响应Inform;8.3e家终端发起TransferCompleteRPC,上报下载并应用成功,及升级的详细信息;8.4ITMS回应TransferCompleteResponse确认,跳至9;9、结束。5.7.2.4接口交互内容Inform:参见PD-069附录A.3.3.1描述;Download:参见PD-069附录A.3.2.8描述;TransferComplete:参见PD-069附录A.3.3.2描述。5.7.3软件版本查询接口5.7.3.1接口场景描述ITMS指定特定e家终端上报软件版本,e家终端正常上报版本信息。5.7.3.2接口调用的RPC方法e家终端ITMSInformInformResponseGetParameterValuesResponseGetParameterVaues e家终端与终端综合管理系统接口(V1.0)5.7.3.3接口时序图5-25软件版本查询接口流程图1、e家终端发起Inform,EventCode需包含CONNECTIONREQUEST;2、ITMS响应InformResponse;3、e家终端发起空的HTTPPost请求;4、ITMS发起GetParameterValues要求获得设备的软件版本信息;5、e家终端回应GetParameterValuesResponse,发送设备版本信息;6、结束。5.7.3.4接口交互内容Inform:参见PD-069附录A.3.3.1描述;GetParameterValues:参见PD-069附录A.3.2.2描述,ParameterValues涉及以下特定参数的值:参数名称InternetGatewayDevice.DeviceInfo.SoftwareVersion e家终端与终端综合管理系统接口(V1.0)5.7.4软件升级配置备份接口5.7.4.1接口场景描述ITMS要求e家终端升级,并在升级前备份e家终端的配置文件,在升级后恢复e家终端的配置备份。5.7.4.2接口调用的RPC方法e家终端ITMSInformInformResponseGetParameterVauesResponseGetParameterValuesSetParameterValuesResponseSetParameterValuesDownloadResponseDownloadUploadResponseUploadTransferCompleteTransferCompleteResponse5.7.4.3接口时序方式一:通过上传和下载配置文件方式 e家终端与终端综合管理系统接口(V1.0)图5-26软件升级配置备份接口流程图(通过上传、下载方式)1、e家终端在任何可发送Inform的时刻发送携带响应EventCode的Inform消息,如BOOTSTRAP、CONNECTIONREQUEST、SCHEDULED等;2、ITMS回应InformResponse;3、e家终端发送空的HTTPPost请求;4、ITMS向e家终端发起UploadRPC调用; e家终端与终端综合管理系统接口(V1.0)5、e家终端相应UploadResponse;6、至文件服务器上传配置文件;7、发送Inform,EventCode为TRANSFERCOMPLET,上报上传成功;8、ITMS响应InformResponse;9、e家终端发起TransferCompleteRPC,上报上传成功,及上传的详细信息;10、ITMS回应TransferCompleteResponse确认;11、下载软件并升级,过程同5.7.2节中的定义,最后不用EndSession;12、e家终端发送空的HTTPPost;13、ITMS要求e家终端Download配置文件;14、e家终端回应DownloadResponse;15、e家终端至文件服务器下载文件;16、发送Inform,EventCode为TRANSFERCOMPLET,上报下载成功;17、ITMS响应InformResponse;18、e家终端发起TransferCompleteRPC,上报下载成功,及下载的详细信息;19、ITMS回应TransferCompleteResponse确认;20、结束。方式二:通过参数查询和参数设置的方式 e家终端与终端综合管理系统接口(V1.0)图5-27软件升级配置备份接口流程图(通过参数查询、设置方式)1、e家终端在任何可发送Inform的时刻发送携带响应EventCode的Inform消息,如BOOTSTRAP、CONNECTIONREQUEST、SCHEDULED等;2、ITMS响应InformResponse;3、e家终端发起空的HTTPPost请求;4、ITMS发起GetParameterValues要求获得e家终端配置的参数信息;5、e家终端回应GetParameterValuesResponse,发送e家终端配置参数信息;6、下载软件并升级,过程同5.7.2中的定义,最后不用EndSession;7、ITMS发起SetParameterValues要求配置e家终端参数;8、e家终端回应SetParameterValuesResponse,配置e家终端参数;9、结束。 e家终端与终端综合管理系统接口(V1.0)5.7.4.4接口交互内容Inform:参见PD-069附录A.3.3.1描述;Download:参见PD-069附录A.3.2.8描述,下载配置文件时参数为“3VendorConfigurationFile”;TransferComplete:参见PD-069附录A.3.3.2描述;Upload:参见PD-069附录A.3.4.1.5描述。GetParameterAttributes:参见PD-069附录A.3.2.5描述。SetParameterValues:参见PD-069附录A.3.2.1描述。5.8e家终端与测试诊断接口模块(M5)5.8.1M5接口描述图测试诊断接口包括五个子接口流程:1)PING测试2)ATMF5Loop测试3)重启4)恢复出厂设置5)DSL测试 e家终端与终端综合管理系统接口(V1.0)图5-28e家终端与测试诊断模块接口图5.8.2PING测试接口5.8.2.1接口场景描述ITMS指定特定e家终端进行PING连接性测试。5.8.2.2接口调用的RPC方法e家终端ITMSInformInformResponseSetParameterValuesResponseSetParameterValuesGetParameterValuesResponseGetParameterValues e家终端与终端综合管理系统接口(V1.0)5.8.2.3接口时序图5-29Ping测试接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用SetParameterValuesRPC方法,要求e家终端进行PING测试,并配置PING测试的参数;5、e家终端回应SetParameterValuesResponse;6、结束Session,开始PING测试;7、e家终端发起Inform,EventCode为“DIAGNOSTICSCOMPLETE”; e家终端与终端综合管理系统接口(V1.0)8、ITMS回应InformResponse;9、e家终端发起空的HttpPost;10、ITMS发起GetParameterValuesRPC,查询PING测试结果;11、e家终端响应GetParameterValuesResponse,返回PING测试的结果;12、结束。5.8.2.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“6CONNECTIONREQUEST”;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“8DIAGNOSTICSCOMPLETE”;SetParameterValues:参见PD-069附录A.3.2.1描述,请求的具体参数为参数名称InternetGatewayDevice.IPPingDiagnostics.DiagnosticsStateInternetGatewayDevice.IPPingDiagnostics.InterfaceInternetGatewayDevice.IPPingDiagnostics.HostInternetGatewayDevice.IPPingDiagnostics.NumberOfRepetitionsInternetGatewayDevice.IPPingDiagnostics.TimeoutInternetGatewayDevice.IPPingDiagnostics.DataBlockSizeInternetGatewayDevice.IPPingDiagnostics.DSCPGetParameterValues:参见PD-069附录A.3.2.2描述,响应的具体参数为参数名称InternetGatewayDevice.IPPingDiagnostics.SuccessCountInternetGatewayDevice.IPPingDiagnostics.FailureCountInternetGatewayDevice.IPPingDiagnostics.AverageResponseTimeInternetGatewayDevice.IPPingDiagnostics.MinimumResponseTimeInternetGatewayDevice.IPPingDiagnostics.MaximumResponseTime e家终端与终端综合管理系统接口(V1.0)5.8.3ATMF5Loop测试接口5.8.3.1接口场景描述ITMS指定特定e家终端进行ATMLoop测试。5.8.3.2接口调用的RPC方法e家终端ITMSInformInformResponseSetParameterValuesResponseSetParameterValuesGetParameterValuesResponseGetParameterValues e家终端与终端综合管理系统接口(V1.0)5.8.3.3接口时序图5-30ATMF5Loop测试接口流程图1.e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2.ITMS回应InformResponse;3.e家终端发起空的HTTPPost;4.ITMS调用SetParameterValuesRPC方法,要求e家终端进行ATMF5Loop测试,并配置Loop测试的参数;5.e家终端回应SetParameterValuesResponse;6.结束Session,开始Loop测试;7.e家终端发起Inform,EventCode为“DIAGNOSTICSCOMPLETE”;8.ITMS回应InformResponse; e家终端与终端综合管理系统接口(V1.0)9.e家终端发起空的HttpPost;10.ITMS发起GetParameterValuesRPC,查询ATMF5Loop测试结果;11.e家终端响应GetParameterValuesResponse,返回Loop测试的结果;12.结束。5.8.3.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“6CONNECTIONREQUEST”;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“8DIAGNOSTICSCOMPLETE”;SetParameterValues:参见PD-069附录A.3.2.1描述,请求的具体参数为参数名称InternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.DiagnosticsStateInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.NumberOfRepetionsInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.TimeoutGetParameterValues:参见PD-069附录A.3.2.2描述,响应的具体参数为参数名称InternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.SuccessCountInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.FailureCountInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.AverageResponseTimeInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.MinimumResponseTimeInternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANATMF5LoopbackDiagnostics.MaximumResponseTime e家终端与终端综合管理系统接口(V1.0)5.8.4重启接口5.8.4.1接口场景描述ITMS要求特定e家终端重启。5.8.4.2接口调用的RPC方法e家终端ITMSInformInformResponseRebootResponseReboot5.8.4.3接口时序图5-31重启接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2、ITMS回应Inform;3、e家终端发起空的HTTPPost;4、ITMS调用RebootRPC方法; e家终端与终端综合管理系统接口(V1.0)5、e家终端回应RebootResponse,并重启;6、e家终端发起Inform,EventCode至少包含“BOOT”和“MReboot”。5.8.4.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“6CONNECTIONREQUEST”等;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“1BOOT”和“MReboot”;Reboot:参见PD-069附录A.3.2.9描述。5.8.5恢复出厂设置接口5.8.5.1接口场景描述ITMS要求特定e家终端恢复出厂设置。5.8.5.2接口调用的RPC方法e家终端ITMSInformInformResponseFactoryResetResponseFactoryReset e家终端与终端综合管理系统接口(V1.0)5.8.5.3接口时序图5-32恢复出厂设置接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用FactoryResetRPC方法;5、e家终端回应FactoryResetResponse,并重启;6、e家终端发起Inform,EventCode为“BOOTSTRAP”。5.8.5.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“CONNECTIONREQUEST”等;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“BOOTSTRAP”等;FactoryReset:参见PD-069附录A.4.1.6描述。 e家终端与终端综合管理系统接口(V1.0)5.8.6DSL测试接口5.8.6.1接口场景描述ITMS指定特定e家终端进行DSL连接性测试。5.8.6.2接口调用的RPC方法e家终端ITMSInformInformResponseSetParameterValuesResponseSetParameterValuesGetParameterValuesResponseGetParameterValues5.8.6.3接口时序 e家终端与终端综合管理系统接口(V1.0)图5-33DSL测试接口流程图1、e家终端发起Inform,包含EventCodeCONNECTIONREQUST;2、ITMS回应InformResponse;3、e家终端发起空的HTTPPost;4、ITMS调用SetParameterValuesRPC方法,要求e家终端进行DSL测试,并配置DSL测试的参数;5、e家终端回应SetParameterValuesResponse;6、结束Session,开始DSL测试;7、e家终端发起Inform,EventCode为“DIAGNOSTICSCOMPLETE”; e家终端与终端综合管理系统接口(V1.0)8、ITMS回应InformResponse;9、e家终端发起空的HttpPost;10、ITMS发起GetParameterValuesRPC,查询DSL测试结果;11、e家终端响应GetParameterValuesResponse,返回DSL测试的结果;12、结束。5.8.6.4接口交互内容第一次Inform:参见PD-069附录A.3.3.1描述,EventCode包含“CONNECTIONREQUEST”;第二次Inform:参见PD-069附录A.3.3.1描述,EventCode至少包含“DIAGNOSTICSCOMPLETE”;SetParameterValues:参见PD-069附录A.3.2.1描述,请求的具体参数为参数名称InternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.LoopDiagnosticsStateGetParameterValues:参见PD-069附录A.3.2.2描述,响应的具体参数为参数名称InternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.ACTPSDdsInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.ACTPSDusInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.ACTATPdsInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.ACTATPusInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.HLINSCdsInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.HLINpsdsInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.QLNpsdsInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.SNRpsdsInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.BITSpsdsInternetGatewayDevice.WANDevice.{i}.WANDSLDiagnostics.GAINSpsds e家终端与终端综合管理系统接口(V1.0)附录A(规范性附录)RPC方法定义除本附录定义的RPC方法,其他RPC方法定义参见PD-069v5。A.1Inform任何时刻要建立与ITMS的连接,e家终端必须调用Inform方法,来初始化一个传输序列。该方法的调用参数在表A-1中定义,应答参数在表A-2中定义。表A-1Inform参数在PD-069v5第A.3节规定基础上扩展以下参数:序参数名称参数类型/长度参数说明号1X_OUI_AssocDeviceX_OUI_DeviceInfoStruct[]中国电信扩展参数,携带目前连接到e家终端上的可识别的家庭网络设备信息,以方便ITMS对e家终端进行相关参数设置,e家终端可以通过DHCPOption字段来发现家庭网络设备信息。表A-2InformResponse参数参见PD-069v5第A.3节表A-3EventStruct定义参见PD-069v5第A.3节表A-4DeviceIdStruct定义参见PD-069v5第A.3节表A-5EventStruct定义参见PD-069v5第A.3节 e家终端与终端综合管理系统接口(V1.0)表A-6X_OUI_DeviceInfoStruct定义如下(请参考TR-106)名称类型描述X_OUI_DeviceManufacturerOUIstring(6)设备制造商的组织唯一标识。用6位十六进制值表示,均为大写,并且包括任何的前置零。参数来源:Device.Info.ManufacturerOUIX_OUI_DeviceSerialNumberstring(64)对指定的产品类型和制造商,该标识可以唯一地确定该设备。参数来源:Device.Info.SerialNumberX_OUI_DeviceProductClassstring(64)序列号所使用的产品类型标识。也就是说,对指定的制造商,该参数是用于标识产品或产品类型,在该类型下,SerialNumber参数是唯一的。参数来源:Device.Info.ProductClass e家终端与终端综合管理系统接口(V1.0)附录B(规范性附录)RPCXMLSchema描述B.1XMLSchema文件头参见PD-069v5第A.6节B.2SOAP信包头参见PD-069v5第A.6节B.3SOAP错误代码参见PD-069v5第A.6节B.4RPC参数类型定义MethodList参见PD-069v5第A.6节FaultStruct参见PD-069v5第A.6节DeviceIdStruct参见PD-069v5第A.6节X_OUI_DeviceInfoStruct e家终端与终端综合管理系统接口(V1.0)EventStruct参见PD-069v5第A.6节EventList参见PD-069v5第A.6节ParameterValueStruct参见PD-069v5第A.6节ParameterValueList参见PD-069v5第A.6节ParameterInfoStruct参见PD-069v5第A.6节ParameterInfoList参见PD-069v5第A.6节ParameterNames参见PD-069v5第A.6节ParameterKeyType参见PD-069v5第A.6节AccessList参见PD-069v5第A.6节 e家终端与终端综合管理系统接口(V1.0)SetParameterAttributesStruct参见PD-069v5第A.6节ParameterAttributeList参见PD-069v5第A.6节TransferList参见PD-069v5第A.6节VoucherList参见PD-069v5第A.6节OptionStruct参见PD-069v5第A.6节OptionList参见PD-069v5第A.6节ArgStruct参见PD-069v5第A.6节CommandKeyType参见PD-069v5第A.6节ObjectNameType参见PD-069v5第A.6节B.5RPC方法请求/响应GetRPCMethods参见PD-069v5第A.6节SetParameterValues参见PD-069v5第A.6节GetParameterValues参见PD-069v5第A.6节GetParameterNames参见PD-069v5第A.6节 e家终端与终端综合管理系统接口(V1.0)SetParameterAttributes参见PD-069v5第A.6节GetParameterAttributes参见PD-069v5第A.6节AddObject参见PD-069v5第A.6节DeleteObject参见PD-069v5第A.6节Download参见PD-069v5第A.6节Reboot参见PD-069v5第A.6节GetQueuedTransfers参见PD-069v5第A.6节ScheduleInform参见PD-069v5第A.6节SetVouchers参见PD-069v5第A.6节GetOptions参见PD-069v5第A.6节Upload参见PD-069v5第A.6节FactoryReset参见PD-069v5第A.6节InformInformmessage-AppendixA e家终端与终端综合管理系统接口(V1.0)InformResponsemessage-AppendixAMaximumnumberofSOAPenvelopesinasingleHTTPpostthattheACSwillaccept.AvalueofzeroindicatesthatthereisnospecificlimitonthenumberofenvelopesTransferComplete参见PD-069v5第A.6节Kicked参见PD-069v5第A.6节RequestDownload参见PD-069v5第A.6节 e家终端与终端综合管理系统接口(V1.0)附录C(规范性附录)业务配置描述C.1业务配置逻辑图业务配置的逻辑主要分为基础类配置和应用类配置,其逻辑图如下图所示:图D-1业务配置的逻辑图C.2业务配置模板业务配置模版应该遵从TR098,TR104等协议规定的参数模型,以下主要描述需要扩充的部分。 e家终端与终端综合管理系统接口(V1.0)C.2.1基础类配置模板C.2.1.1WAN连接名称类型写读描述InternetGatewayDevice.WANDevice.{i}.WAN-objectRConnectionDevice.{i}.WANPPPConnection.{i}.X_CT-COM_LanInterfacestringRR和本WAN连接绑定的LAN侧节点索引列表,包括以太网端口,无线SSID等,以逗号分割,例如“Internet-GatewayDevice.LAN-Device.1.LAN-LANEthernetInterfaceConfig.2.,InternetGatewayDevice.-LANDevice.1.WLAN-Configuration.1.”X_CT-COM_ServiceListstringRR规定在本WAN连接承载的什么业务列表,以逗号分割,目前定义:参见e家终端技术规范6.1.3章节…当前节点下所有参数InternetGatewayDevice.WANDevice.{i}.WAN-objectRConnectionDevice.{i}.WANDSLLinkConfig.…当前节点下所有参数名称类型写读描述InternetGatewayDevice.WANDevice.{i}.WAN-objectRConnectionDevice.{i}.WANIPConnection.{i}.X_CT-COM_LanInterfacestringRR和本WAN连接绑定的LAN侧节点索引列表,包括以太网端口,无线SSID等,以逗号分割,例如“Internet-GatewayDevice.LAN-Device.1.LAN-LANEthernetInterfaceConfig.2.,InternetGatewayDevice.-LANDevice.1.WLAN-Configuration.1.”X_CT-COM_ServiceListstringRR规定在本WAN连接承载的什么业务列表,以逗号分割,目前定义:参见e家终端技术规范6.1.3章节…当前节点下所有参数InternetGatewayDevice.WANDevice.{i}.WAN-objectRConnectionDevice.{i}.WANDSLLinkConfig.…当前节点下所有参数 e家终端与终端综合管理系统接口(V1.0)C.2.1.2PPPoE代理功能名称类型写读描述InternetGatewayDevice.WANDevice.{i}.WAN-objectRConnectionDevice.{i}.WANPPPConnection.{i}.X_CT-COM_ProxyEnablebooleanRR是否启用PPPoE代理功能,缺省值:falseX_CT-COM_MAXUserunsignedIntRR可代理的最大用户数C.2.1.3DDNS名称类型写读描述InternetGatewayDevice.WANDevice.{i}.WANCoobjectRnnectionDevice.{i}.WANIPConnection.{i}.X_CT-COM_DDNSConfiguration.{i}DDNSCfgEnabledbooleanRR启动DDNS功能开关量,取值范围(true,false),缺省值:falseDDNSProviderString(256)RR服务提供商DDNSUsernameString(256)RRDDNS用户名DDNSPasswordString(256)RRDDNS密码ServicePortString(256)RR服务端口DDNSDomainNameString(256)RRDDNS域名DDNSHostNameString(256)RRDDNS主机名InternetGatewayDevice.WANDevice.{i}.WANCoobjectRnnectionDevice.{i}.WANPPPConnection.{i}.X_CT-COM_DDNSConfiguration.{i}DDNSCfgEnabledbooleanRR启动DDNS功能开关量,取值范围(true,false),缺省值:falseDDNSProviderString(256)RR服务提供商DDNSUsernameString(256)RRDDNS用户名DDNSPasswordstring(256)RRDDNS密码ServicePortstring(256)RR服务端口DDNSDomainNamestring(256)RRDDNS域名DDNSHostNamestring(256)RRDDNS主机名 e家终端与终端综合管理系统接口(V1.0)C.2.1.4WLAN名称类型写读描述InternetGatewayDevice.LANDevice.{i}.WLAN-objectRConfiguration.{i}.X_CT-COM_SSIDHidebooleanRRSSID是否隐藏,取值范围(true,false),缺省值:falseX_CT-COM_PowerlevelunsignedIntRR无线模块功率的级别,指无线模块,本参数在多实例中应该保持一致,取值范围:{1,2,3,4,5},分为5级,1为最大功率,依次下推,5级为最小功率,X_CT-COM_PowerValueunsignedIntR当前无线模块发射功率最大值(单位:dBm)…InternetGatewayDevice.LANDevice.{i}.WLAN-objectRConfiguration.{i}.AssociatedDevice.{i}.…当前节点下所有参数InternetGatewayDevice.LANDevice.{i}.WLAN-objectRConfiguration.{i}.WEPKey.{i}.…当前节点下所有参数InternetGatewayDevice.LANDevice.{i}.WLAN-objectRConfiguration.{i}.PreSharedKey.{i}.…当前节点下所有参数C.2.1.5e家终端电信维护帐号管理名称类型写读描述InternetGatewayDevice.DeviceInfo.X_CT-COM_objectRTeleComAccountEnablebooleanRR是否启用电信帐户,缺省值:truePasswordstring(256)RR电信帐户的密码C.2.1.6TR-069名称类型写读描述InternetGatewayDevice.ManagementServer.objectR…当前节点下所有参数 e家终端与终端综合管理系统接口(V1.0)C.2.1.7强制家庭门户管理名称类型写读描述InternetGatewayDevice.DeviceInfo.X_CT-COM_objectRPortalManagementEnablebooleanRR是否启用强制家庭门户,缺省值:falsePortalUrl-Computerstring(256)RRComputer上网强制URLPortalUrl-STBstring(256)RRSTB上网强制URLPortalUrl-Phonestring(256)RR手机上网强制URLC.2.1.8PORTFORWARDING名称类型写读描述InternetGatewayDevice.WANDevice.{i}.WAN-objectRConnectionDevice.{i}.WANIPConnection.{i}.-PortMapping.{i}.…当前节点下所有参数C.2.1.9DHCPSERVER名称类型写读描述InternetGatewayDevice.LANDevice.{i}.LAN-objectRHostConfigManagement.X_CT-COM_STB-MinAddressStringRR针对STB,LAN接口上DHCP服务器可以分配置的地址池中的第一个地址X_CT-COM_STB-MaxAddressstringRR针对STB,LAN接口上DHCP服务器可以分配置的地址池中的最后一个地址X_CT-COM_Phone-MinAddressStringRR针对Phone,LAN接口上DHCP服务器可以分配置的地址池中的第一个地址X_CT-COM_Phone-MaxAddressstringRR针对Phone,LAN接口上DHCP服务器可以分配置的地址池中的最后一个地址X_CT-COM_Camera-MinAddressStringRR针对Camera,LAN接口上DHCP服务器可以分配置的地址池中的第一个地址 e家终端与终端综合管理系统接口(V1.0)名称类型写读描述X_CT-COM_Camera-MaxAddressstringRR针对Camera,LAN接口上DHCP服务器可以分配置的地址池中的最后一个地址X_CT-COM_Computer-MinAddressStringRR针对Computer,LAN接口上DHCP服务器可以分配置的地址池中的第一个地址X_CT-COM_Computer-MaxAddressstringRR针对Computer,LAN接口上DHCP服务器可以分配置的地址池中的最后一个地址C.2.1.10ALG功能开关名称类型写读描述InternetGatewayDevice.DeviceInfo.X_CT-COM_objectRALGAbility.H323EnablebooleanRR在H.323下,是否启用ALG功能,缺省值:trueSIPEnablebooleanRR在SIP下,是否启用ALG功能,缺省值:falseRTSPEnablebooleanRR在RTSP下,是否启用ALG功能,缺省值:trueL2TPEnablebooleanRR在L2TP下,是否启用ALG功能,缺省值:trueIPSECEnablebooleanRR在IPSEC下,是否启用ALG功能,缺省值:trueC.2.1.11断线重连功能名称类型写读描述InternetGatewayDevice.DeviceInfo.X_CT-COM_objectRReConnect.EnablebooleanRR是否启用断线重连功能,缺省值:trueC.2.1.12网络服务管理名称类型写读描述InternetGatewayDevice.DeviceInfo.X_CT-COM_objectRServiceManage e家终端与终端综合管理系统接口(V1.0)名称类型写读描述FtpEnablebooleanRR终端ftp服务器是否启用。默认关闭FtpUserNameString(256)RR终端ftp服务器用户名FtpPasswordString(256)RR终端ftp服务器用户密码FtpPortintRR终端ftp服务器端口,默认为端口21TelnetEnablebooleanRR终端Telnet服务器是否启用。默认关闭TelnetUserNameString(256)RR终端Telnet服务器用户名TelnetPasswordString(256)RR终端Telnet服务器用户密码TelnetPortintRR终端Telnet服务器端口,默认为端口21C.2.2面向应用配置C.2.2.1VoIP名称类型写读描述.VoiceService.{i}.Capabilities.objectR…当前节点下所有参数.VoiceService.{i}.PhyInterface.{i}.objectR…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.SIP.objectR…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}objectR…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.SIP.objectR…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.FaxT38objectR…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.RTP.objectR…当前节点下所有参数.VoiceService.{i}.Capabilities.Codecs.{i}.objectR…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.Codec.objectR…当前节点下所有参数 e家终端与终端综合管理系统接口(V1.0).VoiceService.{i}.VoiceProfile.{i}.Line.{i}.Voice-objectRProcessing.…当前节点下所有参数.VoiceService.{i}.CallRouting.objectR…当前节点下所有参数.VoiceService.-{i}.-CallRouting.PSTNNumber.{i}objectR…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.-objectRNumberingPlan.…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.-objectRNumberingPlan.PrefixInfo.{i}.…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.Line.-objectR{i}.CallingFeatures.…当前节点下所有参数.VoiceService.{i}.VoiceProfile.{i}.Line.{i}.objectR…当前节点下所有参数C.2.2.2IPTV名称类型写读描述InternetGatewayDevice.Services.objectRX_CT-COM_IPTVIGMPEnablebooleanRRIGMP是否启用,取值范围(true,false),缺省值:falseSTBNumberunsignedIntRR机顶盒数目C.2.2.3多终端上网名称类型写读描述InternetGatewayDevice.Services.objectRX_CT-COM_MWBANDModeIntRR是否限制同时接入公网的终端数量,取值范围(0,1,2),0:代表此业务不启用,1:代表使用模式一,2:代表使用模式二,缺省值:1TotalTerminalNumberIntRR模式一:同时接入公网的终端的最大数量,缺省值:1 e家终端与终端综合管理系统接口(V1.0)名称类型写读描述STBRestrictEnablebooleanRR模式二:是否限制同时接入公网的STB终端数量,取值范围(true,false),缺省值:falseSTBNumberIntRR同时接入公网的STB终端的最大数量CameraRestrictEnablebooleanRR模式二:是否限制同时接入公网的Camera终端数量,取值范围(true,false),缺省值:falseCameraNumberIntRR同时接入公网的Camera终端的最大数量ComputerRestrictEnablebooleanRR模式二:是否限制同时接入公网的Computer终端数量,取值范围(true,false),缺省值:falseComputerNumberintRR同时接入公网的Computer终端的最大数量,缺省值:1PhoneRestrictEnablebooleanRR模式二:是否限制同时接入公网的Phone终端数量,取值范围(true,false),缺省值:falsePhoneNumberintRR同时接入公网的Phone终端的最大数量 e家终端与终端综合管理系统接口(V1.0)附录D(资料性附录)对TR-069的扩展以下列出本标准对TR-069协议的扩展之处。D.1RPC方法下表中对照了TR-069和本标准对RPC的要求,黄色格子是两者有区别的地方,仅供参考。方法名称本标准规定TR-069规定本标准注释e家终端要求ITMS要求e家终端需求服务器需求e家终端方法应答调用应答调用GetRPCMethodsMMMOSetParameterValuesMMMMGetParameterValuesMMMMGetParameterNamesMMMMSetParameterAttributesMMMONotification属性为MAccessControl属性为OGetParameterAttributesMMMONotification属性为MAccessControl属性为OAddObjectMMMODeleteObjectMMMORebootMMMODownloadMMMMUploadMMOOFactoryResetMMOOGetQueuedTransfersOOOOScheduleInformMMOOSetVouchersOOOOGetOptionsOOOOITMS方法调用应答调用应答GetRPCMethodsOOOMInformMMMMTransferCompleteMMMMRequestDownloadOOOOKickedOOOO e家终端与终端综合管理系统接口(V1.0)D.2RPC方法修订清单RPC方法名修订参考Inform附录A.1附录B扩展X_OUI_AssocDevice参数,它是X_OUI_DeviceInfoStruct[]类型,详细参见表A-6 e家终端与终端综合管理系统接口(V1.0)附录E(规范性附录)故障数据字典E.1故障编号规则编码规则故障代码用6位数表示,由“故障类别+故障码”表示,具体描述如下:故障代码:XXXXXX编码规则:||__________第3~6位:故障码|__________________第1~2位:故障类别E.2故障信息列表注:“说明”列里标注“Client”的表示,此故障可能可以由用户预先安装在PC上的检测客户端发现。故障类别故障码说明编码含义编码含义01物理故障主要指明显的设备外在故障0000指示灯故障0001指示灯不亮0002指示灯闪烁不停1000电源故障1001电源坏2000外壳故障2001外壳损坏3000连接线故障3001连接线断Client3002连接线接头坏4000端口故障4001以太网端口指示灯不亮9000其它故障02基本连接不涉及应用的故障连接类故障,基本连接是各类应用的基础 e家终端与终端综合管理系统接口(V1.0)0000线路故障0001掉线频繁1000PPPoE拨号1001用户名/密码错误Client1002拨号软件出错2000私网连接2001IP地址冲突Client2002DNS无法获取Client9000其它故障03设备应用用户使用设备故障中遇到的各种配置和连接问题,不涉及业务0000设备配置故障主要指e家终端、机顶盒等设备的配置0001登陆设备的用户名/密码错误0002用户配置权限受限1000WLAN故障1001WLAN信号不稳定1002设备无法连接WLANAPClient1003加密密码遗忘1004WLAN配置错误Client1005SSID设置错误Client1006搜索不到AP(即SSID)Client1007WLAN终端设备无法获取IPClient地址1008信道干扰1009AP与网卡配置不匹配2000蓝牙故障2001蓝牙信号不稳定2002设备无法连接蓝牙AP2003蓝牙配置错误3000视频设备故障3001无法连接监控设备Client3002监控设备无画面3003视频设备无法调整参数4000智能家电故障9000其它故障10上网应用主要面对浏览网页和下载两类应用1000网速问题 e家终端与终端综合管理系统接口(V1.0)1001网速慢,网页无法正常打开Client1002下载速度慢,未达到开户带宽9000其它故障11VoIP应用主要针对e家故障终端上的S口VoIP电话业务1000连接问题1001软交换注册不上Client2000使用问题2001无法呼出2002无法呼入2003拨打有振铃,但无法接听3000语音质量问题3001时延大3002明显回声3003声音断续9000其它故障12DDNS应主要针对e家用故障终端的动态域名服务1000域名访问故障1001域名无法访问Client1002DDNS配置错误9000其它故障13IPTV应用主要面对应用故障机顶盒使用的IPTV业务0000音画质量0001图像不稳定,明显马赛克现象0002图像声音不同步1000点播故障1001无法点播1002点播中断2000直播故障2001无节目单3000资讯类故障9000其它故障20电脑使用综合类故障,可故障能同时涉及设备和业务0000电脑故障0001中病毒Client0002IE无法打开 e家终端与终端综合管理系统接口(V1.0)IE代理不可用Client0003无法收发电子邮件Client0004无法使用MSN(部分)功能Client0005软Phone无法使用0006无法使用BT0007路由不可达Client0008域名解析失败Client9000其它故障99其他故障(待定)E.3用于故障检测的PC客户端代码定义客户端代码采用16位阿拉伯数字表示,具体含义如下:数字位数字位含义值和门限1主版本号客户端的主版本号2次版本号r客户端的次版本号值操作系统1WindowsME2Windows953Windows984WindowsNT5Windows20003操作系统6WindowsXP7Windows20038其它Windows操作系统9Linux10Unix11其它操作系统 e家终端与终端综合管理系统接口(V1.0)值CPU速率0<1.00GHz11.01–2.00GHz22.01–3.00GHz4CPU速率33.01–4.00GHz44.01–5.00GHz55.01–6.00GHz6>6.00GHz值内存0<64MB164-127MB2128-191MB3192-255MB5内存4256-319MB5320-383MB6384-447MB7448-511MB8>512MB值运行进程数0101202306运行进程数3404505606>70 e家终端与终端综合管理系统接口(V1.0)7当前Modem数量0~2558当前网卡数量0~8值缺省邮件客户端1MSOutlook2OutlookExpress9缺省邮件客户端3HotmailMail4Yahoo!Maill5NetscapeMail值邮件服务检查0POP失败-SMTP失败10邮件服务检查1POP成功-SMTP成功2POP失败-SMTP成功3POP成功-SMTP失败值TCP/IP网线连Ping绑定,接Loopback0成功成功成功1成功成功失败TCP/IP绑定,网11线连接,Ping2成功失败成功Loopback3成功失败失败4失败成功成功5失败成功失败6失败失败成功7失败失败失败 e家终端与终端综合管理系统接口(V1.0)值DHCP使能IP分配0是成功DHCP使能和IP121是失败分配2否成功3否失败1-PPPoE已连接,13PPPoE连接2–PPPoE未连接,ValueInstance0DNS及Web都失败DNS及Web检141DNS及Web都成功查2DNS成功、Website失败值缺省IE1IE6.015缺省IE2IE5.53其它16校验位1~15的异或值 e家终端与终端综合管理系统接口(V1.0)附录F(规范性附录)e家终端和ITMS交互约定细则F.1e家终端TR069参数树初始配置技术细则1.WAN侧参数出厂配置:在InternetGatewayDevice.WANDevice.1.下的子节点没有任何实例。2.LAN侧以太网参数出厂配置实例:InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.1.InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.2.InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.3.InternetGatewayDevice.LANDevice.1.LANEthernetInterfaceConfig.4(增加和以太网物理端口的对应关系)3.LAN侧无线参数出厂配置:InternetGatewayDevice.LANDevice.1.WLANConfiguration.1F.2桥连接建立流程1.增加InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}实例2.再增加InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}.WANPPPConnection.{i}实例3.设置WANConnectionDevice相关参数:InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}.WAN-DSLLinkConfig.LinkType=EoA;InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}.WAN-DSLLinkConfig.DestinationAddress=PVC:InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}.WAN-DSLLinkConfig.Enable=true;4.设置WANPPPConnection相关参数 e家终端与终端综合管理系统接口(V1.0)InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}.WANPPPConnection.{i}.ConnectionType=PPPoE_BridgedInternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}.WANPPPConnection.{i}.Name=(WAN连接名称)InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}..WANPPPConnection.{i}.X_CT-COM_LanInterface=(和LAN侧的绑定关系);InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}..WANPPPConnection.{i}.X_CT-COM_ServiceList=(业务绑定)InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}..WANPPPConnection.{i}.Enable=true;F.3路由连接建立流程1.增加InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}实例2.再增加InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}.WANPPPConnection.{i}实例3.设置WANConnectionDevice相关参数:InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}.WAN-DSLLinkConfig.LinkType=EoA;InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}.WAN-DSLLinkConfig.DestinationAddress=PVC:InternetGatewayDevice.WANDevice.1.WANConnectionDevice.{i}.WAN-DSLLinkConfig.Enable=true;4.设置WANPPPConnection相关参数InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}.WANPPPConnection.{i}.ConnectionType=IP_RoutedInternetGatewayDevice.WANDevice.1.WANConnectionDevice.- e家终端与终端综合管理系统接口(V1.0){i}.WANPPPConnection.{i}.Name=(WAN连接名称)InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}.WANPPPConnection.{i}.Username=(帐号)InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}.WANPPPConnection.{i}.Password=(帐号)InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}..WANPPPConnection.{i}.X_CT-COM_LanInterface=(和LAN侧的绑定关系);InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}..WANPPPConnection.{i}.X_CT-COM_ServiceList=(业务绑定)InternetGatewayDevice.WANDevice.1.WANConnectionDevice.-{i}..WANPPPConnection.{i}.Enable=true;F.4e家终端和ITMS交互过程重启原则1.在e家终端和ITMS交互过程中,原则上不允许自动重启(软件升级,配置文件下载除外)。2.在参数下发时,如果需要重启生效,需要通过TR069协议,通知ITMS,ITMS根据具体策略,对e家终端发起重启命令。3.原则上,所有TR069参数配置都不需要重启,三家芯片厂家提交参数列表,进行评估。F.5e家终端Inform消息上报,参数列表扩充e家终端Inform消息上报时,除了上报规定的参数之外,还要上报宽带上网用户名,如果有多个带有internet属性的WAN连接,需要都通过Inform消息上报到ITMS。 e家终端与终端综合管理系统接口(V1.0)F.6ITMS与e家庭终端交互约定1.ITMS在下发TR069布尔性参数时,true用1下发,false用0下发。2.在ITMS调用e家终端uploadRPC时,平台必须具备HTTPPUT,HTTPPOST等协议,终端必须支持HTTPPUT协议或者HTTPPOST协议。请参见rfc2616,rfc1867。3.在ITMS调用e家终端downloadRPC时,平台必须具备HTTPGET协议,终端必须支持HTTPGET协议。请参见rfc2616。4.e家终端在增加实例时,实例号生成规则应该是在当前实例下,分配实例号累加。5.e家终端周期Inform消息上报时间为12小时。F.7ITMS异常流程要求ITMS支持异常处理机制,在ITMS和e家终端交互过程中,在下发参数出现异常时,进入异常处理流程,针对不同的业务逻辑,对终端的业务相关参数进行预读,预判,针对终端是否已经配置业务相关参数进行判断,具体操作步骤如下:1.ITMS通过北向接口收到电子工单,并将业务信息,用户信息,设备信息绑定.2.ITMS通过下发策略,通过南向接口对e家终端下发参数.3.下发出现异常,ITMS转向异常处理流程1.4.ITMS根据业务逻辑,读取e家终端相关参数,并和从北向工单要下发的参数做比对,如果相同不下发,如果不同,则对e家终端下发参 e家终端与终端综合管理系统接口(V1.0)数.5.如果在步骤4,如果还是发现出现下发异常,转入异常处理流程26.对e家终端下发恢复出厂设置,ITMS对业务信息,用户信息,设备信息解绑定关系.7.e家终端重新上电,对ITMS实现首次连接注册流程.8.ITMS实现重新绑定,并将所有当前业务工单下发到e家终端侧.F.8ITMS对e家终端远程升级流程(配置文件不兼容)要求ITMS具有对e家终端远程割接处理流程机制(版本远程升级,配置文件远程更新).具体步骤如下:1.ITMS对e家终端远程升级;2.对e家终端下发恢复出厂设置,ITMS对业务信息,用户信息,设备信息解绑定关系.3.e家终端重新上电,对ITMS实现首次连接注册流程.4.ITMS实现重新绑定,并将所有当前业务工单下发到e家终端侧.'