TR-069协议RPC方法说明
前言
概述
本文档介绍了ACS对第三方厂商CPE设备的管理能力。
读者对象
本文档主要适用于以下工程师:
软件测试工程师。
数通技术支持工程师。
通信技术支持工程师。
等。
一、TR-069协议规范
管理规范遵从TR-069协议规范,CPE必须提供表B-1中描述的必须的RPC方法,ACS必须提供表B-2中描述的必须的RPC方法。
表B-1 CPE提供RPC方:
RPC 方法 | 功能描述 | 必须(是/否) |
---|---|---|
GetRPCMethods | 获取CPE支持的RPC方法 | 是 |
SetParameterValues | 设置指定参数的值 | 是 |
GetParameterValues | 获取指定参数的值 | 是 |
GetParameterNames | 获取设备参数名 | 是 |
SetParameterAttributes | 设置参数的特性 | 是 |
GetParameterAttributes | 获取参数特性 | 是 |
AddObject | 新增参数 | 是 |
DeleteObject | 删除参数 | 是 |
Reboot | 重启设备 | 是 |
Download | ACS调用该接口引导CPE从服务器下载文件 | 是 |
ScheduleDownload | 同Download,可以指定时间下载 | 否 |
Upload | ACS调用该接口引导CPE从服务器上传文件 | 是 |
FactoryReset | 恢复出厂设置 | 是 |
GetQueuedTransfers(已弃用) | ACS调用该接口获取所有上传下载的任务状态 | 否 |
GetAllQueuedTransfers | ACS调用该接口获取所有上传下载的任务状态 | 否 |
CancelTransfer | ACS通知CPE取消之前的上传或下载。取消成功后,CPE不会再调用 TransferComplete | 否 |
ScheduleInform | ACS通知CPE定时上报,可用来做心跳和监控 | 否 |
ChangeDUState | ACS使用此方法来修改DU的状态。 | 否 |
SetVouchers(已弃用) | ACS在CPE中设置一个或多个Vouchers | 否 |
GetOptions(已弃用) | ACS获取CPE当前设置的选项及其相关状态信息 | 否 |
表B-2 ACS提供RPC方法:
ACS 方法 | 功能描述 | 必须(是/否) |
---|---|---|
GetRPCMethods | 获取ACS支持的RPC方法 | 否 |
Inform | CPE信息上报 | 是 |
TransferComplete | 上传/下载完成通知 | 是 |
AutonomousTransferComplete | 上传/下载完成通知(CPE主动发起的上传或下载) | 否 |
DUStateChangeComplete | DU状态变更完成通知 | 否 |
AutonomousDUStateChangeComplete | DU状态变更完成通知(CPE主动发起修改DU状态) | 否 |
RequestDownload | CPE调用申请从ACS下载文件,ACS收到请求后验证是否支持下载,如果支持则ACS调用CPE的Download方法通知CPE下载地址 | 否 |
Kicked(已弃用) | 目的是建立会话用于网页验证 | 否 |
二、Inform报文格式
表B-3 Inform报文字段:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
DeviceID | DeviceIdStruct | 是 | 设备唯一标识对象,参考表B-4。 |
Event | EventStruct | 是 | 事件码,标识此次Inform发起的原因,参考表B-5。 |
MaxEnvelopes | unsignedInt | 是 | HTTP Response可携带SOAP最大信封数。若为0则没有限制。 |
CurrentTime | dateTime | 是 | CPE当前的时间。 |
RetryCount | unsignedInt | 是 | Inform消息上报成功前重复尝试次数。Inform发送成功并应答后重置为0。 |
ParameterList | ParameterValueStruct[] | 是 | 本次Inform请求中所需携带的参数信息表。每个参数都是ParameterValueStruct对象。 |
表B-4 Tabel DeviceIdStructs:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
Manufacturer | string(64) | 是 | 厂商 |
OUI | string(32) | 是 | 厂商OUI |
ProductClass | string(64) | 是 | 设备型号 |
SerialNumber | string(64) | 是 | CPE终端SN |
…… | …… | …… | …… |
表B-5 Tabel EventStruct:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
EventCode | string (64) | 是 | 事件码 |
CommandKey | string (32) | 以下事件必须:●M ScheduleInform ●M Reboot ●M Download ●M ScheduleDownload ●M ChangeDUState ●M Upload | 操作关键字 |
表B-6 Tabel ParameterValueStruct:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
Name | string(256) | 是 | 参数名 |
Value | 任意数据类型 | 是 | 参数值 |
表B-7 网关保密信息查询服务类接口方法定义:
方法 | 参数 | 返回值 | 描述 |
---|---|---|---|
getDeviceManufacturerOUI | void | String | 获取设备OUI:InternetGatewayDevice.DeviceInfo.ManufacturerOUI |
getDeviceSerialNumber | void | String | 获取设备序列号“InternetGatewayDevice.DeviceInfo.SerialNumber |
getDeviceDefaultWebPassword | void | String | 获取设备初始Web普通用户密码 |
getDeviceDefaultSSID1Name | void | String | 获取设备初始WLANSSID1的名称 |
getDeviceDefaultSSID1Password | void | String | 获取设备初始的WLAN SSID1的密码 |
getDevicePassword | void | String | 获取设备的认证Password |
三、Inform报文示例:
1、CPE Inform Request
报文如下(示例):
{
"HTTP_HOST": "192.168.90.70:9090",
"HTTP_USER_AGENT": "gSOAP/2.7",
"HTTP_CONNECTION": "keep-alive",
"HTTP_AUTHORIZATION": "Digest username=\"cpe\", realm=\"rms\", nonce=\"a342284c399a4c4f867e1c21d2edef5d\", uri=\"/acs\", qop=\"auth\", nc=00000001, cnonce=\"66e55f65ca629d95ebad\", response=\"bb152e70ab0b0d27020c8404176e7931\"",
"HTTP_COOKIE": "$Version=0;acs_session_id=e7bb9243432545259ead96449a1d91ed;$Domain=\"192.168.90.70\"",
"HTTP_SOAPACTION": ""
}
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">14</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:Inform>
<DeviceId>
<Manufacturer>CCOM</Manufacturer>
<OUI>40E11C</OUI>
<ProductClass>HX7741X-CM</ProductClass>
<SerialNumber>CCOM1C0115B6</SerialNumber>
</DeviceId>
<Event SOAP-ENC:arrayType="cwmp:EventStruct[1]">
<EventStruct>
<EventCode>4 VALUE CHANGE</EventCode>
<CommandKey></CommandKey>
</EventStruct>
</Event>
<MaxEnvelopes>1</MaxEnvelopes>
<CurrentTime>2024-09-14T18:03:17</CurrentTime>
<RetryCount>0</RetryCount>
<ParameterList SOAP-ENC:arrayType="cwmp:ParameterValueStruct[12]">
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceSummary</Name>
<Value xsi:type="xsd:string">InternetGatewayDevice:1.4[](Baseline:2,EthernetLAN:2,WiFiLAN:2,WiFiWPS:1,Time:2,IPPing:1,TraceRoute:1,Download:1,DownloadTCP:1,Upload:1,UploadTCP:1,UDPEcho:1,UDPEchoPlus:1,DeviceAssociation:2,DHCPCondServing:1,DHCPOption:1)</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SpecVersion</Name>
<Value xsi:type="xsd:string">1.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.HardwareVersion</Name>
<Value xsi:type="xsd:string">V1.0.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SoftwareVersion</Name>
<Value xsi:type="xsd:string">V1.0.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.ProvisioningCode</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestURL</Name>
<Value xsi:type="xsd:string">http://192.168.46.174:7547/tr069</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ParameterKey</Name>
<Value xsi:type="xsd:string">2024-09-12 19:37:52.001324+00:00</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.ExternalIPAddress</Name>
<Value xsi:type="xsd:string">192.168.46.174</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.MACAddress</Name>
<Value xsi:type="xsd:string">40:e1:1c:01:15:b7</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANPPPConnection.1.Username</Name>
<Value xsi:type="xsd:string">105</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.LANDevice.1.Hosts.HostNumberOfEntries</Name>
<Value xsi:type="xsd:unsignedInt">1</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.X_CMCC_DeviceType</Name>
<Value xsi:type="xsd:string">Model3</Value>
</ParameterValueStruct>
</ParameterList>
</cwmp:Inform>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
2、ACS InformResponse
报文如下(示例):
<?xml version='1.0' encoding='utf-8'?>
<soap-env:Envelope
xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<soap-env:Header>
<cwmp:ID soap-env:mustUnderstand="1">14</cwmp:ID>
</soap-env:Header>
<soap-env:Body>
<cwmp:InformResponse>
<MaxEnvelopes>1</MaxEnvelopes>
</cwmp:InformResponse>
</soap-env:Body>
</soap-env:Envelope>
四、Inform事件码
表B-8 Inform事件码:
事件码 | 描述 |
---|---|
0 BOOTSTRAP | 第一次接入或是ACS的URL改变而引起会话建立’。注意:BOOTSTRAP事件可能会和其它事件一起上报。比如:出厂首次连接,CPE会发送BOOTSTRAP和BOOT两个事件,或者更多 |
1 BOOT | 给电或是复位时引起的会话建立,包括初始系统启动、其他原因的重启(Reboot),不包括从待机状态醒来 |
2 PERIODIC | 定期上报事件 |
3 SCHEDULED | 由于调用ScheduleInform方法的会话建立 |
4 VALUE CHANGE | 从上次成功的Inform后,具有Passive和Active通知属性的一个或多个参数的值发生了改变 |
5 KICKED | 由于网页验证而引起的会话建立,并且Kicked方法会在这个会话中调用一次或多次 |
6 CONNECTION REQUEST | 当ACS发起连接请求后,CPE Inform接口上报的事件码 |
7 TRANSFER COMPLETE | 上传下载完成事件 |
8 DIAGNOSTICS COMPLETE | 诊断完成事件 |
9 REQUEST DOWNLOAD | 请求下载事件 |
10 WAKEUP | 设备唤醒事件 |
11 HEARTBEAT | 心跳事件 |
M Reboot | 由于ACS调用了Reboot,使CPE重新启动,重叠的事件会引起“1 BOOT”事件代码 |
M ScheduleInform | ACS请求了一个安排通知 |
M Download | ACS请求下载 |
M ScheduleDownload | ACS请求计划下载 |
M Upload | ACS请求上传 |
M ChangeDUState | ACS用ChangeDUState方法请求DU状态改变 |
M [X vendor specific method] | 厂商特定方法操作完成后,CPE的响应 |
X [VENDOR] [event] | 厂商特定事件 |
五、SetParameterValues报文格式
- SetParameterValues报文字段:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
ParameterList | ParameterValueStruct[] | 是 | 参数数组 |
ParameterKey | string(32) | 是 | 操作记录编号,操作成功后,CPE更新该值 |
- Tabel ParameterValueStruct:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
Name | string(256) | 是 | 参数名 |
Value | 任意数据类型 | 是 | 参数值 |
SetParameterValues报文示例:
1、ACS SetParameterValues Request
报文如下(示例):
<?xml version='1.0' encoding='utf-8'?>
<soap-env:Envelope
xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<soap-env:Header>
<cwmp:ID soap-env:mustUnderstand="1">4c421f04b28c4a4b93deeb40bea27168</cwmp:ID>
</soap-env:Header>
<soap-env:Body>
<cwmp:SetParameterValues>
<ParameterList soap-enc:arrayType="cwmp:ParameterValueStruct[1]">
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestUsername</Name>
<Value xsi:type="xsd:string">ccom</Value>
</ParameterValueStruct>
</ParameterList>
<ParameterKey>2024-09-12 19:37:52.001324+00:00</ParameterKey>
</cwmp:SetParameterValues>
</soap-env:Body>
</soap-env:Envelope>
2、CPE SetParameterValuesResponse
报文如下(示例):
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">4c421f04b28c4a4b93deeb40bea27168</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:SetParameterValuesResponse>
<Status>0</Status>
</cwmp:SetParameterValuesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
六、GetParameterValues报文格式
GetParameterValues报文字段:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
ParameterNames | string(256)[] | 是 | 参数名数组 |
GetParameterValues报文示例:
1、ACS GetParameterValues Request
报文如下(示例):
<?xml version='1.0' encoding='utf-8'?>
<soap-env:Envelope
xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<soap-env:Header>
<cwmp:ID soap-env:mustUnderstand="1">3a73a0b82e354de8875a084acb7ad39d</cwmp:ID>
</soap-env:Header>
<soap-env:Body>
<cwmp:GetParameterValues>
<ParameterNames soap-enc:arrayType="xsd:string[1]">
<string>InternetGatewayDevice.ManagementServer.</string>
</ParameterNames>
</cwmp:GetParameterValues>
</soap-env:Body>
</soap-env:Envelope>
2、CPE GetParameterValuesResponse
报文如下(示例):
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">3a73a0b82e354de8875a084acb7ad39d</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:GetParameterValuesResponse>
<ParameterList SOAP-ENC:arrayType="cwmp:ParameterValueStruct[24]">
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.EnableCWMP</Name>
<Value xsi:type="xsd:boolean">TRUE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.URL</Name>
<Value xsi:type="xsd:string">http://192.168.90.70:9090/acs</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.Username</Name>
<Value xsi:type="xsd:string">cpe</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.Password</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformEnable</Name>
<Value xsi:type="xsd:boolean">TRUE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformInterval</Name>
<Value xsi:type="xsd:unsignedInt">3600</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformTime</Name>
<Value xsi:type="xsd:dateTime">0001-01-01T00:00:00Z</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ParameterKey</Name>
<Value xsi:type="xsd:string">2024-09-12 19:37:52.001324+00:00</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestURL</Name>
<Value xsi:type="xsd:string">http://192.168.46.174:7547/tr069</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestUsername</Name>
<Value xsi:type="xsd:string">rms</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestPassword</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.UpgradesManaged</Name>
<Value xsi:type="xsd:boolean">TRUE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.KickURL</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.DownloadProgressURL</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.AliasBasedAddressing</Name>
<Value xsi:type="xsd:boolean">FALSE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.InstanceMode</Name>
<Value xsi:type="xsd:string">InstanceNumber</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.AutoCreateInstances</Name>
<Value xsi:type="xsd:boolean">FALSE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.DefaultActiveNotificationThrottle</Name>
<Value xsi:type="xsd:unsignedInt">0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ManageableDeviceNumberOfEntries</Name>
<Value xsi:type="xsd:unsignedInt">0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ManageableDeviceNotificationLimit</Name>
<Value xsi:type="xsd:unsignedInt">0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.CWMPRetryMinimumWaitInterval</Name>
<Value xsi:type="xsd:unsignedInt">5</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.CWMPRetryIntervalMultiplier</Name>
<Value xsi:type="xsd:unsignedInt">2000</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.X_CMCC_JSON.IP</Name>
<Value xsi:type="xsd:string">1.2.3.4</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.X_CMCC_JSON.Port</Name>
<Value xsi:type="xsd:string">19123</Value>
</ParameterValueStruct>
</ParameterList>
</cwmp:GetParameterValuesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
七、Reboot报文格式
Reboot报文字段:
字段名称 | 字段类型 | 必须 | 参数说明 |
---|---|---|---|
CommandKey | string(32) | Y | 操作关键字 |
1、Reboot报文示例:
ACS Reboot Request:
<?xml version='1.0' encoding='utf-8'?>
<soap-env:Envelope
xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<soap-env:Header>
<cwmp:ID soap-env:mustUnderstand="1">6d91960c3f9f4dc5b06bcaeec05fe2e0</cwmp:ID>
</soap-env:Header>
<soap-env:Body>
<cwmp:Reboot>
<CommandKey>AcsQueueJob#193171</CommandKey>
</cwmp:Reboot>
</soap-env:Body>
</soap-env:Envelope>
CPE RebootResponse
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">6d91960c3f9f4dc5b06bcaeec05fe2e0</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:RebootResponse></cwmp:RebootResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
2、重启后Inform报文如下(示例):
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">2</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:Inform>
<DeviceId>
<Manufacturer>CCOM</Manufacturer>
<OUI>40E11C</OUI>
<ProductClass>HX7741X-CM</ProductClass>
<SerialNumber>CCOM1C0115B6</SerialNumber>
</DeviceId>
<Event SOAP-ENC:arrayType="cwmp:EventStruct[3]">
<EventStruct>
<EventCode>1 BOOT</EventCode>
<CommandKey></CommandKey>
</EventStruct>
<EventStruct>
<EventCode>M Reboot</EventCode>
<CommandKey>AcsQueueJob#193171</CommandKey>
</EventStruct>
<EventStruct>
<EventCode>X CMCC ALARM</EventCode>
<CommandKey></CommandKey>
</EventStruct>
</Event>
<MaxEnvelopes>1</MaxEnvelopes>
<CurrentTime>2024-09-25T14:40:09</CurrentTime>
<RetryCount>0</RetryCount>
<ParameterList SOAP-ENC:arrayType="cwmp:ParameterValueStruct[12]">
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceSummary</Name>
<Value xsi:type="xsd:string">InternetGatewayDevice:1.4[](Baseline:2,EthernetLAN:2,WiFiLAN:2,WiFiWPS:1,Time:2,IPPing:1,TraceRoute:1,Download:1,DownloadTCP:1,Upload:1,UploadTCP:1,UDPEcho:1,UDPEchoPlus:1,DeviceAssociation:2,DHCPCondServing:1,DHCPOption:1)</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SpecVersion</Name>
<Value xsi:type="xsd:string">1.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.HardwareVersion</Name>
<Value xsi:type="xsd:string">V1.0.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SoftwareVersion</Name>
<Value xsi:type="xsd:string">V1.0.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.ProvisioningCode</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestURL</Name>
<Value xsi:type="xsd:string">http://192.168.46.174:7547/tr069</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ParameterKey</Name>
<Value xsi:type="xsd:string">2024-09-24 15:30:27.954544+00:00</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.ExternalIPAddress</Name>
<Value xsi:type="xsd:string">192.168.46.174</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.MACAddress</Name>
<Value xsi:type="xsd:string">40:e1:1c:01:15:b7</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANPPPConnection.1.Username</Name>
<Value xsi:type="xsd:string">105</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.X_CMCC_DeviceType</Name>
<Value xsi:type="xsd:string">Model3</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.X_CMCC_Alarm.AlarmNumber</Name>
<Value xsi:type="xsd:string">104001,104006</Value>
</ParameterValueStruct>
</ParameterList>
</cwmp:Inform>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
八、CPE基本信息管理
需要从CPE上报的Inform报文中获取设备基本信息内容。要求CPE上报Inform时,在满足接口基本要求之外(参见Inform报文格式),必须包含表5-2所示的设备基本信息内容。
名称 | 参数 | 必选(是/否) |
---|---|---|
设备IP | InternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANIPConnection.{i}.ExternalIPAddress | 是 |
厂商 | InternetGatewayDevice.DeviceInfo.Manufacturer | 是 |
厂商OUI | InternetGatewayDevice.DeviceInfo.ManufacturerOUI | 是 |
设备型号 | InternetGatewayDevice.DeviceInfo.ProductClass | 是 |
设备序列号 | InternetGatewayDevice.DeviceInfo.SerialNumber | 是 |
软件版本 | InternetGatewayDevice.DeviceInfo.SoftwareVersion | 是 |
硬件版本 | InternetGatewayDevice.DeviceInfo.HardwareVersion | 是 |
省份编码 | InternetGatewayDevice.DeviceInfo.ProvisioningCode | 否 |
设备回连地址 | InternetGatewayDevice.ManagementServer.ConnectionRequestURL | 是 |
管理员账号 | InternetGatewayDevice.DeviceInfo.X_CMCC_TeleComAccount.Username | 否 |
管理员密码 | InternetGatewayDevice.DeviceInfo.X_CMCC_TeleComAccount.Password | 否 |
Telnet账号 | InternetGatewayDevice.DeviceInfo.X_CMCC_ServiceManage.TelnetUserName | 否 |
Telnet密码 | InternetGatewayDevice.DeviceInfo.X_CMCC_ServiceManage.TelnetPassword | 否 |
1、CPE Inform Request
报文如下(示例):
< SOAP - ENV: Envelope
xmlns: SOAP - ENV = "http://schemas.xmlsoap.org/soap/envelope/"
xmlns: SOAP - ENC = "http://schemas.xmlsoap.org/soap/encoding/"
xmlns: xsi = "http://www.w3.org/2001/XMLSchema-instance"
xmlns: xsd = "http://www.w3.org/2001/XMLSchema"
xmlns: cwmp = "urn:dslforum-org:cwmp-1-0" >
<SOAP - ENV: Header >
<cwmp: ID SOAP - ENV: mustUnderstand = "1" > 16 < /cwmp:ID>
</SOAP - ENV: Header >
<SOAP - ENV: Body >
<cwmp: Inform >
<DeviceId >
<Manufacturer > CCOM < /Manufacturer>
<OUI>40E11C</OUI >
<ProductClass > HX7741X - CM < /ProductClass>
<SerialNumber>CCOM1C0115B6</SerialNumber >
</DeviceId>
<Event SOAP-ENC:arrayType="cwmp:EventStruct[1]">
<EventStruct>
<EventCode>4 VALUE CHANGE</EventCode >
<CommandKey ></CommandKey>
</EventStruct >
</Event>
<MaxEnvelopes>1</MaxEnvelopes >
<CurrentTime > 2024 - 09 - 19T15: 40 : 03 < /CurrentTime>
<RetryCount>0</RetryCount >
<ParameterList SOAP - ENC: arrayType = "cwmp:ParameterValueStruct[12]" >
<ParameterValueStruct >
<Name > InternetGatewayDevice.DeviceSummary < /Name>
<Value xsi:type="xsd:string">InternetGatewayDevice:1.4[](Baseline:2,EthernetLAN:2,WiFiLAN:2,WiFiWPS:1,Time:2,IPPing:1,TraceRoute:1,Download:1,DownloadTCP:1,Upload:1,UploadTCP:1,UDPEcho:1,UDPEchoPlus:1,DeviceAssociation:2,DHCPCondServing:1,DHCPOption:1)</Value >
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SpecVersion</Name >
<Value xsi: type = "xsd:string" > 1.0 < /Value>
</ParameterValueStruct >
<ParameterValueStruct >
<Name > InternetGatewayDevice.DeviceInfo.HardwareVersion < /Name>
<Value xsi:type="xsd:string">V1.0.0</Value >
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SoftwareVersion</Name >
<Value xsi: type = "xsd:string" > V1.0.0 < /Value>
</ParameterValueStruct >
<ParameterValueStruct >
<Name > InternetGatewayDevice.DeviceInfo.ProvisioningCode < /Name>
<Value xsi:type="xsd:string"></Value >
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestURL</Name >
<Value xsi: type = "xsd:string" > http: //192.168.46.174:7547/tr069</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ParameterKey</Name>
<Value xsi:type="xsd:string">2024-09-12 19:37:52.001324+00:00</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.ExternalIPAddress</Name>
<Value xsi:type="xsd:string">192.168.46.174</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.MACAddress</Name>
<Value xsi:type="xsd:string">40:e1:1c:01:15:b7</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANPPPConnection.1.Username</Name>
<Value xsi:type="xsd:string">105</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.LANDevice.1.Hosts.HostNumberOfEntries</Name>
<Value xsi:type="xsd:unsignedInt">0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.X_CMCC_DeviceType</Name>
<Value xsi:type="xsd:string">Model3</Value>
</ParameterValueStruct>
</ParameterList>
</cwmp:Inform>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>< ?xml version = '1.0'encoding = 'utf-8' ? >
<soap - env: Envelope
xmlns: soap - env = "http://schemas.xmlsoap.org/soap/envelope/"
xmlns: soap - enc = "http://schemas.xmlsoap.org/soap/encoding/"
xmlns: xsd = "http://www.w3.org/2001/XMLSchema"
xmlns: xsi = "http://www.w3.org/2001/XMLSchema-instance"
xmlns: cwmp = "urn:dslforum-org:cwmp-1-0" >
<soap - env: Header >
<cwmp: ID soap - env: mustUnderstand = "1" > 16 < /cwmp:ID>
</soap - env: Header >
<soap - env: Body >
<cwmp: InformResponse >
<MaxEnvelopes > 1 < /MaxEnvelopes>
</cwmp: InformResponse >
</soap-env:Body>
</soap - env: Envelope >
2、ACS InformResponse
报文如下(示例):
<?xml version='1.0' encoding='utf-8'?>
<soap-env:Envelope
xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<soap-env:Header>
<cwmp:ID soap-env:mustUnderstand="1">16</cwmp:ID>
</soap-env:Header>
<soap-env:Body>
<cwmp:InformResponse>
<MaxEnvelopes>1</MaxEnvelopes>
</cwmp:InformResponse>
</soap-env:Body>
</soap-env:Envelope>
九、CPE设备状态监控
根据CPE心跳对设备在线离线状态进行监控,CPE需按照心跳周期定期向ACS发送心跳报文。当超过3个心跳周期ACS仍未收到CPE报文则认为设备离线。
对CPE设备要求:
支持心跳使能和心跳周期配置,详细请参考CPE心跳配置;
支持按心跳周期发送Inform报文,事件码为“2 PERIODIC”。
心跳报文如下(示例):
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">6</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:Inform>
<DeviceId>
<Manufacturer>CCOM</Manufacturer>
<OUI>40E11C</OUI>
<ProductClass>HX7741X-CM</ProductClass>
<SerialNumber>CCOM1C0115B6</SerialNumber>
</DeviceId>
<Event SOAP-ENC:arrayType="cwmp:EventStruct[1]">
<EventStruct>
<EventCode>2 PERIODIC</EventCode>
<CommandKey></CommandKey>
</EventStruct>
</Event>
<MaxEnvelopes>1</MaxEnvelopes>
<CurrentTime>2024-09-19T15:03:01</CurrentTime>
<RetryCount>0</RetryCount>
<ParameterList SOAP-ENC:arrayType="cwmp:ParameterValueStruct[11]">
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceSummary</Name>
<Value xsi:type="xsd:string">InternetGatewayDevice:1.4[](Baseline:2,EthernetLAN:2,WiFiLAN:2,WiFiWPS:1,Time:2,IPPing:1,TraceRoute:1,Download:1,DownloadTCP:1,Upload:1,UploadTCP:1,UDPEcho:1,UDPEchoPlus:1,DeviceAssociation:2,DHCPCondServing:1,DHCPOption:1)</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SpecVersion</Name>
<Value xsi:type="xsd:string">1.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.HardwareVersion</Name>
<Value xsi:type="xsd:string">V1.0.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.SoftwareVersion</Name>
<Value xsi:type="xsd:string">V1.0.0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.ProvisioningCode</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestURL</Name>
<Value xsi:type="xsd:string">http://192.168.46.174:7547/tr069</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ParameterKey</Name>
<Value xsi:type="xsd:string">2024-09-12 19:37:52.001324+00:00</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.ExternalIPAddress</Name>
<Value xsi:type="xsd:string">192.168.46.174</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.MACAddress</Name>
<Value xsi:type="xsd:string">40:e1:1c:01:15:b7</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANPPPConnection.1.Username</Name>
<Value xsi:type="xsd:string">105</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.DeviceInfo.X_CMCC_DeviceType</Name>
<Value xsi:type="xsd:string">Model3</Value>
</ParameterValueStruct>
</ParameterList>
</cwmp:Inform>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
十、配置管理
1、远程重启
ACS 支持对单个设备进行远程重启。TR-069协议规范中规定,CPE提供Reboot方法作为重启命令接口,Reboot报文参考Reboot报文格式,CPE重启流程如下图所示:
图T-1 CPE重启流程:
- ACS 选择指定设备,调用CPE的Reboot方法。
- CPE收到消息,自动重启设备。
- CPE重启完成后上报Inform消息,并携带事件码:1 BOOT 或 M BOOT。
远程重启所需Reboot方法如下:
字段名称 | 字段类型 | 参数说明 | 必须 |
---|---|---|---|
CommandKey | string(32) | 操作关键字 | 是 |
2、CPE回连用户名密码修改
ACS 支持对CPE设备的回连用户名和密码进行修改。通过TR-069协议中SetParameterValues命令向CPE配置CPE回连用户名和密码。SetParameterValues交互流程参考SetParameterValues报文格式。
主动配置CPE设备回连用户名密码的接口要求如下:
参数名称 | 参数全路径 | 读写 | 必须 |
---|---|---|---|
CPE回连认证用户名 | InternetGatewayDevice.ManagementServer.ConnectionRequestUsername | W | 是 |
CPE回连认证密码 | InternetGatewayDevice.ManagementServer.ConnectionRequestPassword | W | 是 |
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">bdce2650b2684a30b29922a9b596e585</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:GetParameterValuesResponse>
<ParameterList SOAP-ENC:arrayType="cwmp:ParameterValueStruct[24]">
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.EnableCWMP</Name>
<Value xsi:type="xsd:boolean">TRUE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.URL</Name>
<Value xsi:type="xsd:string">http://192.168.90.70:9090/acs</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.Username</Name>
<Value xsi:type="xsd:string">cpe</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.Password</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformEnable</Name>
<Value xsi:type="xsd:boolean">TRUE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformInterval</Name>
<Value xsi:type="xsd:unsignedInt">3600</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformTime</Name>
<Value xsi:type="xsd:dateTime">0001-01-01T00:00:00Z</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ParameterKey</Name>
<Value xsi:type="xsd:string">2024-09-12 19:37:52.001324+00:00</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestURL</Name>
<Value xsi:type="xsd:string">http://192.168.46.174:7547/tr069</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestUsername</Name>
<Value xsi:type="xsd:string">rms</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ConnectionRequestPassword</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.UpgradesManaged</Name>
<Value xsi:type="xsd:boolean">TRUE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.KickURL</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.DownloadProgressURL</Name>
<Value xsi:type="xsd:string"></Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.AliasBasedAddressing</Name>
<Value xsi:type="xsd:boolean">FALSE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.InstanceMode</Name>
<Value xsi:type="xsd:string">InstanceNumber</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.AutoCreateInstances</Name>
<Value xsi:type="xsd:boolean">FALSE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.DefaultActiveNotificationThrottle</Name>
<Value xsi:type="xsd:unsignedInt">0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ManageableDeviceNumberOfEntries</Name>
<Value xsi:type="xsd:unsignedInt">0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.ManageableDeviceNotificationLimit</Name>
<Value xsi:type="xsd:unsignedInt">0</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.CWMPRetryMinimumWaitInterval</Name>
<Value xsi:type="xsd:unsignedInt">5</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.CWMPRetryIntervalMultiplier</Name>
<Value xsi:type="xsd:unsignedInt">2000</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.X_CMCC_JSON.IP</Name>
<Value xsi:type="xsd:string">1.2.3.4</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.X_CMCC_JSON.Port</Name>
<Value xsi:type="xsd:string">19123</Value>
</ParameterValueStruct>
</ParameterList>
</cwmp:GetParameterValuesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
3、CPE心跳配置
ACS 根据CPE心跳对设备在线离线状态进行监控,CPE需按照心跳周期定期向 ACS 发送心跳报文。当超过3个心跳周期 ACS 仍未收到CPE报文则认为设备离线。 ACS 通过TR-069协议中SetParameterValues命令(SetParameterValues报文格式参见SetParameterValues报文格式)向CPE配置心跳。配置CPE设备心跳的接口要求如下:
参数名称 | 参数全路径 | 值 | 读写 | 必须 |
---|---|---|---|---|
周期上报开关 | InternetGatewayDevice.ManagementServer.PeriodicInformEnable | 0或1 | W | 是 |
周期上报间隔(秒) | InternetGatewayDevice.ManagementServer.PeriodicInformInterval | Int整型 | W | 是 |
ACS SetParameterValues Request:
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1">89</cwmp:ID>
</SOAP-ENV:Header>
<soapenv:Body>
<cwmp:SetParameterValues>
<ParameterList SOAP-ENC:arrayType="cwmp:ParameterValueStruct[4]">
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformEnable</Name>
<Value>TRUE</Value>
</ParameterValueStruct>
<ParameterValueStruct>
<Name>InternetGatewayDevice.ManagementServer.PeriodicInformInterval</Name>
<Value>60</Value>
</ParameterValueStruct>
</ParameterList>
<ParameterKey/>
</cwmp:SetParameterValues>
</soapenv:Body>
</soapenv:Envelope>
CPE SetParameterValuesRespons:
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cwmp="urn:dslforum-org:cwmp-1-0">
<SOAP-ENV:Header>
<cwmp:ID SOAP-ENV:mustUnderstand="1"/>89</cwmp:ID>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<cwmp:SetParameterValuesResponse>
<Status>0</Status>
</cwmp:SetParameterValuesResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>