Tr069协议参数模型报告
TR069协议简明教程
TR069协议简明教程1.为什么需要TR069随着VoIP、IPTV等越来越多IP终端设备的普及（尤其在家庭中的普及），大量设备的配置和维护变得越来越困难，大大提高了网络产品运营商的成本，传统的基于SNMP的网管系统面对众多的终端设备时显得力不从心，限制了宽带接入市场的发展速度和规模。
TR069定义了一套全新的网管体系结构，包括“管理模型”，“交互接口”，“管理参数”，在很大程度上减少了网络产品的运维成本。
2.什么是TR069协议TR069是数字用户线（DSL）论坛（已改名为Broadband Forum）制定的一个面向终端设备的网管协议，称为“用户终端设备广域网管理协议（CWMP）”，DSL论坛的文档编号为TR069。
3.TR069协议发展现状自2004年5月DSL论坛推出该协议以来，各大运营商纷纷部署基于TR069的终端设备。
但从协议的发展情况看，TR069仍然处于不断完善的过程中。
4.TR069协议网络架构ACS为自动配置服务器，负责对终端设备CPE进行管理。
ACS与CPE间的接口为南向接口，ACS与管理系统间的接口为北向接口。
TR069协议主要定义了南向接口。
5.TR069的实现（协议栈）（1）TR069协议基于TCP层；（2）ACS与CPE间的消息传输使用HTTP1.1，ACS为HTTP服务器，CPE为HTTP 客户端；（3）消息的具体内容使用SOAP包进行封装，SOAP包是一个包含SOAP Head（SOAP 头）和SOAP Body（SOAP体）组成的XML文档（4）ACS的管理方法就是对CPE上的管理函数进行远程调用，因此需要向CPE传输要调用的函数名及参数，这些内容包含在SOAP体中。
ACS并不直接对设备本身的接口进行调用，ACS所使用的函数为TR069的标准函数（称作TR-069 RPC Methods），CPE需要通过一个设备上的中间层解析出RPC方法，再由这个中间层调用设备自身的接口，这个中间层就是TR069 Agent。
TR069协议中文版
TR069 修正版 1 CPE WAN Management Protocol
CPE 广域网管理协议
2006 年 12 月
编辑
Jeff Bernstein, 2Wire Heather Kirksey, Motive Tim Spets, Westell William Lupton, 2Wire
hz.chenkejin.study@
第 4 页 共 41 页
CPE 广域网管理协议修正版
连接上正常处理。
c) 允许一个或多个 ACS 为一个 CPE 组服务，这些 CPE 可以根据一个或多个业务供应商信 息关联在一起。
本协议支持 ACS 和 CPE 的 discovery 和 association：
每一个参数包括一个“名-值”对。名字标识了特定的参数，并且拥有一个类似于文件目录的 分级结构，每一级之间用一个点‘.’分隔开。参数的值可能是多种已定义的数据类型中的一 种。
参数可以被设置成只读或只写。只读参数可以让ACS用于确定特定CPE的特征，观察CPE的当 前状态，或者收集统计信息。可写参数可以让ACS去定制各种CPE操作。所有可写参数必须是 可读的，虽然那些包含用于机密性信息，例如密码，可能会在读时返回一个空值（在数据响 应规范里面有描述）。一些可写的参数能够被那些不同于本规范定义的接口所独立的更改（例 如，一些参数也可以通过LAN侧的自动配置协议所修改）。
b) 保证 CPE 和 ACS 之间事务处理的机密性。
c) 运行为每一种事务处理提供适当的鉴权。
d) 阻止对服务的窃取。
1.4 架构目标
本协议对连通模型上有很好的灵活性：
a) CPE 和 ACS 都可以发起建连，避免在 CPE 和 ACS 之间维护一个长期的连接。
TR069_0.3
目录
1.TR-069协议概述 2.TR-069基本功能 3.TR-069协议框架 4.TR-069具体实现
1.背景
随着信息产业的飞速发展，广域网上承
载的业务种类和业务量在不断增大，规模也不
CPE向新的ACS发起连接请求。
断在扩大，大量的终端接入设备被广泛应用，
接的信息。ACS会返回给一个Inform response作为确认连接。标准的Inform方法的参数如表 1所示。
参数名称参数说明 DeviceID
Event MaxEnvelopes
CurrentTime RetryCount ParameterList
数据结构标识CPE 标识此次Inform发起的原因 HTTP Response可携带SOAP信封数
序列号（SerialNumber）、硬件版本号（HardwareVersion）、软件版本号（SoftwareVersion）、
在这样的背景下，DSL论坛（Digital Subscriber Line数字用户环路，现已更名为Broadband 论坛）推出CWMP（CPEWAN Management Protocol）协议，由于是以技术报告（TECHNICAL REPORT）的形式提供，文档编号为069,所以又被称为TR069协议。TR069协议和其他相关协议 提供了对下一代网络中家庭网络设备进行管理配置的通用框架、消息规范、管理方法和数据模 型。
如果当前会话没有结束，但是连接异常中断，而且CPE自动重新连接的次数还没 有达到上限，此时，CPE也会自动建立连接。 ACS可以在任何时候自动向CPE发起连接请求（Connect Request），通过CPE的认证 （即匹配CPEURL、CPE用户名、CPE密码）后，可以与CPE建立连接。
ZXITMS介绍(TR069)
ITMS介绍—功能介绍
ITMS功能层次模型
CPE终端的特点:
智能(配置/业务复杂) 量大(数量/维护量巨大) 面广(网络环境复杂) 放置在用户侧
业务发放接口
分组管理 资 源 管 理 配 置 管 理
业务管理层 网络管理层
诊断测试接口
安全管理 诊 断 测 试 版 本 管 理 告警监控 业 务 发 放
用户可以无偿享用超出其订购内容的业务，造成资费流失
现网安全状况—业务系统框架
业务网络
用户 终端
ห้องสมุดไป่ตู้
ITMS OSS
业务系统安全－保证用户和业务的对应关系 OSS建立了用户、终端和业务的对应关系 ITMS是OSS和终端的纽带，保持终端配臵和业务订购的一致
安全措施一
保证管理员账户和用户账户的安全性： 管理员账户（电信维护账户）拥有管理员权限
CPE支持负担 目前的困难 未来的方向
协议简单，负担小 EOC的阻碍 抛弃EOC，进一步完善MIB
ITMS介绍—功能介绍
系统在网络中的位置
业务开通 故障处理 设备监测、性能统计、告警处理
112系统 电信2000 I3
综合网管 I4
I2
ITMS
业务网络
I1
I1：南向接口，ITMS和终端的接口
终端
RPC Methods
CPE/ACS Management Application RPC Methods SOAP HTTP SSL/TLS
CPE和ACS间应用程序 在TR-069中不作规定。 远程过程调用方法，在 TR-069标准附录A中有 明确规定，在附录B中规 定了具体参数。 标准的基于XML的语 法，这里用于对RPCs编 码。要求支持SOAP 1.1 版本 要求支持HTTP 1.1版本. 标准的Internet 传输层安 全协议使用 SSL/TLS是 可选要求. 标准 TCP/IP.
TR069配置参数文档
TR069配置参
部门
扱制
审核
批准
2016年06月日
目录
1 WAN连接节点参数4
2WLAN节点参数8
3 VOIP节自参数10
4IPTV节点参数17
5维护管理节点参数17
6用户信息管理节直参数18
7状态监视节点参数18
8多终端上网节点参数19
9ALG功能开关节点参数20
10自检参数节点参数20
11 ping诊断节点参数21
12TR069连接节点参数22
13 IPv6 fl能启用节点参数23
14 LAN 口节点参数23
15下挂主机信息参数24
16性能上报相关TR069节点参数25 17GP0N上行节点参S 31
18 EPON ±fi节点参数33
19DDNS节自参数34
1 WAN连接节点参数
2WLAN节点参数
3VOIP节点参数
4IPTV节点参数
5维护管理节点参数
6用户信息管理节点参数
7状盗监視节点参数
8多终端上网节点参数
9 ALGJft能开关节点参数
10自检参数节点参数
11 Ping欢断节点参数
12TR069连接节点参数
13 IPv6功能启用节点参数
14 LAN 口节点参数
15下挂主机信息参数
16性能上报相关TR069节点参数
17GP0N±1T节点参数
18 EPON 节点参数
19DDNS节点参数。
TR069报文解析
3.1 通讯交互流程3.1.1 SOAP报文空报文POST / HTTP/1.1Host: 127.0.0.1:8659Content-Type: text/xmlConnection: keep-aliveContent-Length: 0非空报文HTTP/1.1 200 OKContent-Type: text/xml; charset=utf-8Content-Length: 123Connection: Keep-Alive<SOAP-ENV:Envelopexmlns:SOAP-ENC="/soap/encoding/" xmlns:xsi="/2001/XMLSchema-instance" xmlns:xsd="/2001/XMLSchema"xmlns:cwmp="urn:dslforum-org:cwmp-1-1"xmlns:SOAP-ENV="/soap/envelope/"> <SOAP-ENV:Header><cwmp:ID>1</cwmp:ID></SOAP-ENV:Header><SOAP-ENV:Body>…</SOAP-ENV:Body>3.1.2 CPE主动上报事件流程1）Inform协议报文<cwmp:Inform><DeviceId><Manufacturer></Manufacturer><OUI></OUI><ProductClass></ProductClass><SerialNumber></SerialNumber></DeviceId><Event SOAP-ENC:arrayType="cwmp:EventStruct[1]"> <EventStruct><EventCode></EventCode><CommandKey></CommandKey></EventStruct>……</Event><MaxEnvelopes></MaxEnvelopes><CurrentTime></CurrentTime><RetryCount></RetryCount><ParameterList ><ParameterValueStruct><Name>xxx</Name><Value>***</Value></ParameterValueStruct></ParameterList></cwmp:Inform>Response<cwmp:InformResponse><MaxEnvelopes>1</MaxEnvelopes></cwmp:InformResponse>3.1.3 OMC主动请求流程1）UDP协议报文ACS-→CPE 请求GET / HTTP/1.1Host: 192.168.99.167:3074Content-Type: text/xml; charset=utf-8 Content-Length: 0Connection: Keep-AliveCPE-→ACS 响应200 OKCPE心跳POST / UDP/1.0I:BC-30-5B-B8-D7-67-10000T:1999-01-01 08:00:003.2 会话流程3.2.1 CPE主动上报会话1）注册boot协议报文<cwmp:Inform><DeviceId><Manufacturer>Star-Net</Manufacturer><OUI>00DAEB</OUI><ProductClass>SVG6004</ProductClass><SerialNumber>BC-30-5B-B8-D7-67-10000</SerialNumber></DeviceId><Event SOAP-ENV:arrayType="cwmp:EventStruct[1]"><EventStruct><EventCode>1 BOOT</EventCode><CommandKey></CommandKey></EventStruct></Event><MaxEnvelopes>1</MaxEnvelopes><CurrentTime>2014-04-28 16:19:58</CurrentTime><RetryCount>0</RetryCount><ParameterList SOAP-ENV:arrayType="cwmp:ParameterValueStruct[6]"> <ParameterValueStruct><Name>InternetGatewayDevice.DeviceSummary</Name><Value>Device:1.0[](Baseline:1),VoiceService:1.0[1](Baseline:1)</Value></ParameterValueStruct><ParameterValueStruct><Name>InternetGatewayDevice.DeviceInfo.HardwareVersion</Name> <Value>4.0.0</Value></ParameterValueStruct><ParameterValueStruct><Name>InternetGatewayDevice.DeviceInfo.SoftwareVersion</Name> <Value>1.8.0.7</Value></ParameterValueStruct><ParameterValueStruct><Name>InternetGatewayDevice.ManagementServer.ConnectionRequestURL</Na me><Value>http://127.0.0.1:0</Value></ParameterValueStruct><ParameterValueStruct><Name>InternetGatewayDevice.ManagementServer.ParameterKey</Name><Value></Value></ParameterValueStruct><ParameterValueStruct><Name>InternetGatewayDevice.WANDevice.1.WANConnectionDevice.1.WANIPCo nnection.1.ExternalIPAddress</Name><Value>127.0.0.1</Value></ParameterValueStruct></ParameterList></cwmp:Inform>Response<cwmp:InformResponse><MaxEnvelopes>1</MaxEnvelopes></cwmp:InformResponse>参数说明GetParameterValues参数ParameterList 参数列表,包含n个参数名称Device.DeviceInfo. X_00D0F8_OfficialVersion IAD：真实设备软件版本Response参数说明SetParameterValues参数ParamterList 参数列表,包含n个ParameterValueStruct Device.ManagementServer.STUNServerAddress 心跳IPDevice.ManagementServer.STUNServerPort 心跳端口Device.ManagementServer.STUNEnable 心跳是否允许Device.ManagementServer.PeriodicInformEnable 心跳周期3.2.2 OMC主动请求会话参数说明Inform参数EventCode 6 CONNECTION REQUEST1）获取设备参数值GetParameterValues协议报文<cwmp:GetParameterValues><ParameterNames arrayType="xsd:string[1]"> <string>xxxx</string></ParameterNames></cwmp:GetParameterValues>Response<cwmp:GetParameterValuesResponse><ParameterList xsi:type="SOAP-ENC:Array"SOAP-ENC:arrayType="cwmp:ParameterValueStruct[1]"> <ParameterValueStruct><Name>xxxx</Name><Value>**</Value></ParameterValueStruct></ParameterList></cwmp:GetParameterValuesResponse>2）设置设备参数值SetParameterValues协议报文<cwmp:SetParameterValues><ParameterList arrayType="cwmp:ParameterValueStruct[1]"> <ParameterValueStruct><Name>xxxx</Name><Value type="xsd:string">11000</Value></ParameterValueStruct></ParameterList></cwmp:SetParameterValues>Response<cwmp:SetParameterValuesResponse><Status>0</Status></cwmp:SetParameterValuesResponse>3）下载 Download（用作配置加载）协议报文<cwmp:Download><CommandKey></CommandKey><FileType></FileType><URL></URL><Username></Username><Password></Password><FileSize>0</FileSize><TargetFileName></TargetFileName> <DelaySeconds>0</DelaySeconds><SuccessURL></SuccessURL><FailureURL></FailureURL></cwmp:Download>Response<cwmp:DownloadResponse><Status>0</Status><StartTime></StartTime><CompleteTime></CompleteTime></cwmp:DownloadResponse>4）上传 Upload（用作配置备份）协议报文<cwmp:Upload><CommandKey></CommandKey><FileType></FileType><URL></URL><Username></Username><Password></Password><DelaySeconds>0</DelaySeconds> </cwmp:Upload>Response<cwmp:UploadResponse><Status>0</Status><StartTime></StartTime><CompleteTime></CompleteTime> </cwmp:UploadResponse>值。
TR069协议CPE资料文档
CPE WAN Management Protocol(TR-069)/definition/acronym.cgi?what+is+TR69=CPE+WAN+ Management+Protocol&id=11533528261、介绍本文档描述的是为客户端设备(CPE,Customer Premises Equipment)和自动配置服务器(ACS,Auto-Configuration Server)之间通讯/交互而设计的客户端设备广域网远程管理协议(CPE广域网管理协议, CPE WAN Management Protocol,俗称TR-069协议)。
TR-069协议定义了一种机制，这个机制包含安全的CPE自动配置功能，并且将其他的CPE管理功能一并纳入到一个统一的框架（公共框架）内。
1.1、功能组成TR-069协议支持很多的功能以便能够管理好数目庞大的CPE，包含的主要功能如下：(1)、自动配置和动态服务(集中/统一)配置/设置(2)、软件和固件的镜像管理(3)、状态和性能监控(4)、诊断1.1.1、自动配置和动态服务设置TR-069协议允许ACS配置一台或多台基于各种标准的CPE。
配置机制包括特定的配置参数和符合卖主需要的配置功能的通用机制。
配置机制允许CPE既可以在宽带网络初始化连接时获取配置，也可以在连接以后的任何时候去重新获取配置。
配置机制支持在异步模式下ACS重新初始化和配置每一台CPE.TR-069协议包含了身份识别机制，这个机制允许每一台特定需求的CPE或者其他基于相同标准/规则(比如，卖主，型号，软件版本等)的CPE获取配置。
TR-069协议还提供了一系列的工具去管理那些CPE特定的可选的并且需要实行额外安全等级的应用服务功能(模块)，比如付费业务。
关于采用数字符号签证来控制这些操作的机制信息请参考附录C。
这种配置机制允许将来更简单的扩展，允许能够为本规范未包括的服务功能进行配置的扩展。
H3C MSR(ICG)TR069方案介绍
2 DHCP Server
34 5
1 ACS
1 将需要更新的配置放到ACS的相应目录下 2 在DHCP server上配置TR-069扩展属性:
ACS URL，用户名，密码等信息 3 启动CPE(零配置)设备，设备通过auto-
config功能，使能DHCP地址获取
4 CPE从DHCP Server获取IP及ACS信息
5 CPE利用获取的ACS信息连接ACS，自 动下载配置
CPE
CPE
TR-069分支批量升级方案
1
2
ACS
3
总部
MSR (使能TR-069)
分支
1 将需要升级的版本，配置放到ACS的相应目录下 2 在ACS上向需要升级版本，配置的分支路由器发送文件下载命令 3 分支设备从ACS上自动下载版本，配置
TR-069是由DSL论坛（）所开发的技术规范之一，其全称为“CPE广 域网管理协议”, DSL论坛的文档编号为TR069。
TR069定义了一套全新的网管体系结构，包括管理模型、交互接口及基本的管理参数。用 于从网络侧对企业或家庭网络中的网关、路由器、机顶盒等设备进行远程集中管理。
HTTPS下的SSL可以加密CPE与ACS的通讯过程，避免了送往CPE的配置数据被窃听。并 且，证书验证等的强大的验证系统都会普遍用到以确保整个通讯过程的安全性。
TR-069技术标准虽然由DSL论坛定义，但其不仅可用于管理xDSL终 端设备，也可用于管理路由器，防火墙等其它网络设备！
TR-069介绍-3
• 从大的功能特性上看，TR-069要比BIMS更完备，基本可以看做为 BIMS+SNMP。但是由于SNMP网管的存在，目前其类BIMS功能更多的被 使用。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
1参数定义
定义终端的TR-069 参数模型主要参考两个文档TR-106 和TR-135 ，TR-106 定义了基于TR-069管理的设备的通用数据模型，TR-135 定义了STB 的特定数据模型。
由于目前针对STB 的数据管理没有提出具体要求，因此暂不实现TR-135中定义的数据模型。
在数据模型中，凡参数中有X_STB字样的，均有扩展参数。
读写属性的值(wrie, Read) ,如果为“R”，则该参数是可读或可写的，如果为”-“，则该参数是不可读或不可写的。
若必选属性的值为”M”,则该参数是必须实现的，若为”O”，则该参数的实现是可选的。
1.1数据模型
红色表示暂不实现
1.2CA卡的相关信息 Device.CA
1.3设备详细信息 Device. DeviceInfo
HardwareVersion为终端设备的版本/型号
SoftwareVersion为终端上主系统软件的版本,在eBox上为”主框架”的版本号.
1.4网管信息参数 Device.ManagementServer
1.5设备普通配置参数 Device.Config
1.6网关信息 Device.GatewayInfo
1.7时间配置参数 Device.Time
1.8用户接口相关参数 erInterface
1.9LAN接口参数N
1.9.1DHCP参数配置N.DHCPOption.{i}
1.9.2LAN状态参数 N.Stats
1.9.3Ping诊断参数N.IPPingDiagnostics
1.9.4路由主机参数N.TraceRouteDiagnostics
1.10D evice.Services（暂时不实现）
1.11终端配置参数 Device.X_STB_Config
1.12终端运行状态参数 Device.X_STB_Stats
1.13用户收视率采集参数Device. X_STB_ AudienceStats
RequestRecord=true表示采集工作开始，CPE将采集到数据保存到文件，=false的时候，将文件上传到服务器，上传完成后，删除CPE端的文件并发送Inform
1.14软件管理参数 Device. X_STB_SoftwareConfig
iPanel暂时不实现UpdateSoftwareList参数,但eBox需要实现
CurrentSoftwareList表示当前所有模块的版本信息,格式为”模块名称:版本号,模块名称:版本号…”UpdateSoftwareList表示需要更新的模块的版本信息，如果为空，则表示不需要对模块进行升级，格式为“模块名称:版本号:升级标志:文件全路径,模块名称:版本号:升级标志:文件全路径…”，CPE检测到这个参数有内容后，确认升级内容（与用户交互），然后在后台通过FTP下载升级包，升级完成Inform上报并修改CurrentSoftwareList，UpdateSoftwareList。
其中“升级标志”为1（强制升级）2（按需升级）UpgradeParameters针对cab方式的升级，这个参数默认为空，当ACS设置这个参数，CPE进行升级，升级完成后修改内容。
1.15告警参数 Device. X_STB_Alarm
保存最近一次告警的信息。