e家终端远程诊断能力.doc

1. e家终端远程诊断能力
通过ITMS远程查询e家终端相关状态，进行状态诊断，查询内容包括：
ü ADSL线路协商速率、上下行流量
ü LAN侧的设备连接状态
ü 各SSID的连接设备数目
表35 – EventStruct定义
每个值包括一个标识字符随后是对应原因的文字描述。几项原因值列示在下面，同时也定义了厂商自定制原因的语法。
值
原因
"0 BOOTSTRAP"
表明会话发起原因是CPE首次安装或ACS的URL发生变化。
"1 BOOT"
表明会话发起原因是CPE加电或重置，包括系统首次启动，以及因任何原因而引起的重启，包括使用Reboot方法。
"2 PERIODIC"
表明会话发起原因是定期的Inform引起。
"3 SCHEDULED"
表明会话发起原因是调用了ScheduleInform方法。
"4 VALUE CHANGE"
表明会话发起原因是一个或多个参数值的变化。该参数值包括在Inform方法的调用中。例如CPE分配了新的IP地址。
"5 KICKED"
表明会话发起原因是为了web标识管理（见附录D），及在本会话中将会调用Kicked方法（见A.4.2.1节）。
"6 CONNECTION REQUEST"
表明会话发起原因是3.2节中定义的源自服务器的Connection Request notification。
"7 TRANSFER COMPLETE"
表明会话的发起是为了表明以前请求的下载或上载（不管是否成功）已经结束，在此会话中将要调用一次或多次TransferComplete方法。
"8 DIAGNOSTICS COMPLETE"
当完成由ACS发起的诊断测试结束后，重新与ACS建立连接时使用。如DSL环路诊断（见附录B）。
"M "<method name>
如果这是另一方法的结果，值“M”后紧接着一个空格和方法的名称。例如：
“M Reboot”
“X “<OUI> <event>
厂商自定义事件。在“X”后的OUI和空格是组织唯一标识符，表示为6位十六进制值，均使用大写，并包括任何前置零。该值必须是在[9]中定义的有效OUI。对<event>的值与解释是厂商自定义的。例如：
“X 00D09E MyEvent”

如果是因定义了一个CommandKey而产生了Inform结构，该元素必须CommandKey的值。在其它情况下，该元素的值为空字符串。
对本规范的这一版本而言，对以下方法的调用会造成CommandKey值的改变：
l ScheduledInform方法
l Reboot方法
l Download方法
l Upload方法
1.1　 RPC方法概述
本章对接口流程中调用的RPC方法进行概要描述，详细的RPC方法定义请参见TR-069附录A，本文附录A仅定义在TR-069基础上本标准修订的RPC方法。
方法名称
普及型家庭网关要求
ITMS要求
功能描述
普及型家庭网关方法
应答
调用

GetRPCMethods
M
M
本方法可用于普及型家庭网关或ITMS来发现另一方所支持的方法集。
SetParameterValues
M
M
ITMS可用此方法来修改普及型家庭网关的一个或多个参数。
GetParameterValues
M
M
本方法可用于ITMS来获取一个或多个普及型家庭网关参数的值。
GetParameterNames
M
M
本方法可以由ITMS用来发现某一普及型家庭网关上的可访问的参数。
SetParameterAttributes
M
M
本方法可以由ITMS用来更改普及型家庭网关上的一个或多个参数的属性。在本标准中定义
Notification属性为M，
Access Control属性为O 。
GetParameterAttributes
M
M
本方法可以由ITMS用来读取普及型家庭网关上的一个或更多参数的属性。在本标准中定义
Notification属性为M，
Access Control属性为O。
AddObject
M
M
本方法可以由ITMS使用来建立一个多实例对象（multi-instance object）的新实例。
DeleteObject
M
M
本方法用于删除一个对象的特定实例。
Reboot
M
M
本方法令普及型家庭网关重新启动。
Download
M
M
本方法可以由ITMS使用来指示普及型家庭网关在指定的位置下载特定的文件。
Upload
M
M
服务器用本方法使普及型家庭网关向指定的位置上载一个特定的文件。
FactoryReset
M
M
本方法将重置普及型家庭网关到其出厂默认状态。
GetQueuedTransfers
O
O
ITMS可以用本方法来确定前面的下载或上载请求的状态。
ScheduleInform
M
M
ITMS可以用本方法请求普及型家庭网关在未来某时刻计划（与普及型家庭网关的定期调用Inform方法分离）一次性的Inform方法调用。
SetVouchers
O
O
ITMS调用本方法来设置普及型家庭网关使用的一个或多个Vouchers（凭据）选项。
GetOptions
O
O
ITMS可以用本方法来获得普及型家庭网关目前设置的选项表，及其它相关状态信息。
ITMS方法
调用
应答

GetRPCMethods
O
O
本方法可用于普及型家庭网关或ITMS来发现另一方所支持的方法集。
Inform
M
M
任何时刻要建立与ITMS的连接，普及型家庭网关必须调用Inform方法，来初始化一个传输序列。
TransferComplete
M
M
本方法通知ITMS由以前的Download或Upload方法调用而引起的文件传输已经结束（不管成功还是失败）。
RequestDownload
O
O
本方法允许普及型家庭网关向ITMS请求一个文件下载。
Kicked
O
O
任何时刻普及型家庭网关使用Web方式连接ITMS时被触发。