Envelopexmlns:
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-1"xmlns:
SOAP-ENV="http:
//schemas.xmlsoap.org/soap/envelope/">
Header>ID>1
ID>
Header>
Body>
…
Body>
3.1.2CPE主动上报事件流程
1)Inform协议报文
Inform>
arrayType="cwmp:
EventStruct[1]">
……
xxx
***
Inform>
Response
InformResponse>
1
InformResponse>
2)Inform参数说明
参数
说明
DeviceId
唯一标识设备的结构,包含以下4个属性
Manufacturer
设备制造商标识
OUI
默认取值:
00FD80
ProductClass
设备类型号
SerialNumber
设备的唯一标识
Event
说明引发事件的一个或多个事件,包含n个EventStruct
EventStruct
包含下面2个属性
EventCode
取值范围如下:
0BOOTSTARP
1BOOT
8DIAGNOSTICSCOMPLETE
6CONNECTIONREQUEST
X***
M***
CommandKey
取值为空
MaxEnvlopes
接受的一个HTTP回复中的最大SOAP信包数目。
为0则表式在次信包的数目上并没有特别的限定要求
CurrentTime
当前日期和时间(UTC)
RetryCount
在成功调用Inform方法前,已经进行的调用尝试次数。
另外,RetryCount值会在失败时+1。
失败包括:
设备登录失败(收到错误应答404或服务器无响应)。
在发送Inform报文,并且接收到完成应答”200OK”之后,RetryCount置零。
ParamterList
参数列表,包含n个ParameterValueStruct
根据不同的EventCode,有不同的值
3.1.3OMC主动请求流程
1)UDP协议报文
ACS-CPE请求
GET/HTTP/1.1
Host:
192.168.99.167:
3074
Content-Type:
text/xml;charset=utf-8
Content-Length:
0
Connection:
Keep-Alive
CPE-ACS响应
200OK
CPE心跳
POST/UDP/1.0
I:
BC-30-5B-B8-D7-67-10000
T:
1999-01-0108:
00:
00
3.2会话流程
3.2.1CPE主动上报会话
1)注册boot
协议报文
Inform>
Star-Net
00DAEB
SVG6004
BC-30-5B-B8-D7-67-10000
arrayType="cwmp:
EventStruct[1]">
1BOOT
1
2014-04-2816:
19:
58
0
arrayType="cwmp:
ParameterValueStruct[6]">
InternetGatewayDevice.DeviceSummary
Device:
1.0[](Baseline:
1),VoiceService:
1.0[1](Baseline:
1)
InternetGatewayDevice.DeviceInfo.HardwareVersion
4.0.0
InternetGatewayDevice.DeviceInfo.SoftwareVersion
1.8.0.7
InternetGatewayDevice.ManagementServer.ConnectionRequestURL
http:
//127.0.0.1:
0
InternetGatewayDevice.ManagementServer.ParameterKey
InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPConnection.1.ExternalIPAddress
127.0.0.1
Inform>
Response
InformResponse>
1
InformResponse>
参数说明
参数
说明
Inform参数
EventCode
1BOOT
ParameterList
Device.DeviceSummary
Device.DeviceInfo.HardwareVersion
设备硬件版本
Device.DeviceInfo.SoftwareVersion
设备软件版本
IAD:
不变的版本
IPPBX:
真实设备软件版本
Device.ManagementServer.ConnectionRequestURL
设备监听的httpurl
Device.ManagementServer.ParameterKey
Device.LAN.IPAddress
设备IP地址
Device.DeviceInfo.OfficialVersion
IPPBX:
不变的版本
参数
说明
GetParameterValues参数
ParameterList
参数列表,包含n个参数名称
Device.DeviceInfo.X_00D0F8_OfficialVersion
IAD:
真实设备软件版本
Response
参数
说明
SetParameterValues参数
ParamterList
参数列表,包含n个ParameterValueStruct
Device.ManagementServer.STUNServerAddress
心跳IP
Device.ManagementServer.STUNServerPort
心跳端口
Device.ManagementServer.STUNEnable
心跳是否允许
Device.ManagementServer.PeriodicInformEnable
心跳周期
3.2.2OMC主动请求会话
参数
说明
Inform参数
EventCode
6CONNECTIONREQUEST
1)获取设备参数值GetParameterValues
协议报文
GetParameterValues>
string[1]">
xxxx
GetParameterValues>
Response
GetParameterValuesResponse>
type="SOAP-ENC:
Array"
SOAP-ENC:
arrayType="cwmp:
ParameterValueStruct[1]">
xxxx
**
GetParameterValuesResponse>
参数说明
参数
说明
GetParameterValues参数
ParameterNames
参数列表,包含n个参数名称
ParameterValueStruct
一个名值对结构
2)设置设备参数值SetParameterValues
协议报文
SetParameterValues>
ParameterValueStruct[1]">
xxxx
string">11000
SetParameterValues>
Response
SetParameterValuesResponse>
0
SetParameterValuesResponse>
参数说明
参数
说明
SetParameterValues参数
ParameterValueStruct
一个名值对结构
Status
结果状态0:
成功其他:
失败
3)下载Download(用作配置加载)
协议报文
Download>
0
0
Download>
Response
DownloadResponse>
0
DownloadResponse>
参数说明
参数
说明
CommandKey
用于指订特定的下载字符串
FileType
值为一个整数,紧接着是一个空格,再然后是文件类型说明。
当前FileType参数只定义了如下值:
"1FirmwareUpgradeImage"
"2WebContent"
"3VendorConfigurationFile"
下列格式用于定义唯一的厂商自定义文件类型:
"Xidentifier>"
其中,用6位十六进制数字(组织唯一标
识),在这之中所有字母都使用大写,包括其中所有的前置0。
URL
URL说明源文件的位置
Username
用来认证文件服务器方用户名。
若无需认证,字符串为空。
Password
用来认证服务器的密码文件。
若无需认证,字符串为空。
FileSize
表示待传输文件的大小(按字节为单位)。
CPE设备可以根据该值来判断自身是拥有足够的内存空间下载容纳该文件,否则需要释放空间来容纳该文件。
TargetFileName
在指定文件系统端中应该使用的文件名。
1)如果指定文件名可以根据下载的文件名来提取,或可以根据下载的URL参数来提取,或下载任务不需要指定文件名,这个参数的值可以为空。
DelaySeconds
收到下载请求到开始下载之间的时间间隔。
若值为0表示不需要延迟。
若值非零,则下载应该使用与该事物不同的另一会话
SuccessURL
现在无用
FailureURL
现在无用
Response
参数
说明
Staus
对该方法的成功应答返回一个整型值
定义如下:
0=下载结束并已实际应用。
1=下载过程还未结束(例如,下载文件需要设备重新启动后才可执行)。
若参数值非零,则设备需要在该会话的后续时间段或这之后的会话事件中调用
TransferComplete方法用来表明该次下载完成的状态(成功或是失败)。
StartTime
下载任务开始的日期及时间。
只有当下载结束后才需要填写该值。
CompleteTime
下载任务完全结束并且将该任务应用完毕的日期及时间。
只有当下载结束后才需要填写该值。
4)上传Upload(用作配置备份)
协议报文
Upload>
0
Upload>
Response
UploadResponse>
0
UploadResponse>
参数说明
参数
说明
CommandKey
用于指订特定的下载字符串
FileType
值为一个整数,紧接着是一个空格,再然后是文件类型说明。
当前FileType参数只定义了如下值:
"1FirmwareUpgradeImage"
"2WebContent"
"3VendorConfigurationFile"
下列格式用于定义唯一的厂商自定义文件类型:
"Xidentifier>"
其中,用6位十六进制数字(组织唯一标
识),在这之中所有字母都使用大写,包括其中所有的前置0。
URL
URL说明源文件的位置
Username
用来认证文件服务器方用户名。
若无需认证,字符串为空。
Password
用来认证服务器的密码文件。
若无需认证,字符串为空。
DelaySeconds
收到下载请求到开始下载之间的时间间隔。
若值为0表示不需要延迟。
若值非零,则下载应该使用与该事物不同的另一会话。
Response
参数
说明
Staus
对该方法的成功应答返回一个整型值
定义如下:
0=下载结束并已实际应用。
1=下载过程还未结束(例如,下载文件需要设备重新启动后才可执行)。
如果该参数的值非零,则设备需要在该会话的后续时间段,或在其后的会话事件中调用
TransferComplete方法用来表明该次下载完成的状态(成功或是失败)。
StartTime
下载任务开始的日期及时间(UTC)。
只有当下载结束后才需要填写该值。
CompleteTime
下载任务完全结束并将该任务应用完毕时的日期及时间(UTC)。
只有当下载结束后才需要填写该值。
5)重启Reboot
协议报文
Reboot>
123456
Reboot>
参数说明
参数
说明
CommandKey
设备重启后用于上报
6)恢复出厂FactoryReset
协议报文
FactoryReset/>
7)OMC端获取CPE端的可被访问参数GetParameterNames
协议报文
GetParameterNames>
InternetGatewayDevice.
true
GetParameterNames>
Response
GetParameterNamesResponse>
arrayType="cwmp:
ParameterInfoStruct[8]">
Device.
0
Device.DeviceInfo.
0
Device.LAN.
0
Device.X_00D0F8_System.
0
Device.WANDevice.
0
Device.Time.
0
Device.ManagementServer.
0
Device.Services.
0
GetParameterNamesResponse>
参数说明
参数
说明
ParameterPath
一个字符串,其中包含完整的参数名或着只有部分的路径名。
若为中间路径名则需要在层次的最后节点名后面加上“.”用作结尾。
完整路径:
InternetGatewayDevice.DeviceSummary
部分路径:
InternetGatewayDevice.
NextLevel
1)value为true:
CPE返回的消息包括所有ParameterPath参数中指定字符串相关参数的完全路径名以及它的子节点的路径名。
2)value为false:
CPE返回的消息包括所有ParameterPath参数中指定字符串开始参数的完全路径名。
Response
参数
说明
ParameterList
{
Name;//参数名称
Writable;/