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 auth过程
TR-069是一种远程管理协议，用于管理互联网服务提供商（ISP）的设备，比如路由器、调制解调器等。

TR-069认证过程包括以下步骤：
1. 连接建立，设备向Auto Configuration Server (ACS)发起连接请求，ACS验证设备的身份并建立连接。

2. 设备身份验证，设备发送其身份信息给ACS，通常是设备的序列号或其他唯一标识符。

ACS验证设备身份，确保其合法性。

3. 安全认证，设备和ACS之间进行安全认证，通常使用
TLS/SSL等加密协议来确保通信的安全性。

4. 参数查询和配置，一旦设备通过身份验证和安全认证，ACS 可以查询设备的参数和配置信息，并对设备进行远程配置和管理。

5. 会话保持，设备和ACS之间保持连接，以便在需要时进行参数更新、故障排除或固件升级等操作。

TR-069认证过程确保了设备和ACS之间的安全通信，同时也确保了设备被正确配置和管理。

这些步骤保证了整个远程管理过程的安全性和可靠性。

TR069_VOIP+INTERNET HG8240页面配置指导一，登陆设备：1，配置维护PC机的IP地址为192.168.100.100/255.255.255.0（注：ONT 的本地维护IP地址缺省为192.168.100.1/255.255.255.0），使用网线将维护PC机上的网口与ONT 的任一网口连接起来，并确保在维护PC机上可以PING通ONT 的维护IP地址。

2，通过IE页面登陆；输入管理员用户名telecomadmin，密码admintelecom，并选择中文网页，点击Login登录二，设置端口工作模式在LAN目录，LAN口工作模式里选择所有端口，完成后点击应用，如下图三，WAN口配置：1，配置PPPOE拨号上网—新建WAN1连接在WAN目录下WAN配置页面中选择新建WAN连接，并对相应选项设置（1）,点击使能WAN连接；（2）,服务列表选择INTERNET；（3）,连接方式选择路由；（4）,vlan填写 41（5）,802.1Q默认0；（6）,获取IP方式选择PPPOE; （7）,使能NAT；（8）,输入宽带拨号用户名及密码；（9）,绑定 1 3 4 三个口,用户电脑直接自动获取地址即可上网使用设置完成后点击应用确认2，配置TR069_VOIP DHCP获取地址WAN2连接在WAN目录下WAN配置页面中选择新建WAN连接，并对相应选项设置（1）,点击使能WAN连接；（2）,服务列表选择TR069_VOIP；（3）,连接方式选择路由；（4）,vlan填写 46（5）,802.1Q默认0；（6）,获取IP方式选择DHCP;其余部分无需设置，点击应用确认3，IPTV业务配置：在WAN目录下WAN配置页面中选择新建WAN连接，并对相应选项设置（1）,点击使能WAN连接；（2）,服务列表选择INTERNET；（3）,连接方式选择桥接；（4）,vlan填写 45（5）,绑定第二个口,用机顶盒直接接到2口即可拨号看电视四，语音配置部分：1，设备SIP服务器：点击语音VOPI界面配置，输入SIP主服务器及备用服务器地址即可，信令接口名选择“2_TR069__VOIP__R_VID_46”其余不用修改梧州TR069方式SIP服务主备用地址都为：172.63.255.12, 设置VOIP用户：点击语音选项VOIP用户配置页面使能相应语音端口并配置逻辑语音号码即可（注意要加区号），密码梧州地区为：111111；注意不要向用户泄露五，配置默认路由：在路由默认路由配置页面选择对应W AN2连接即可六，保存数据（很重要，一定要记得保存数据）在系统工具配文件页面，选择保存配置即可七，完成所有配置后重启设备，配置生效八，设备重启完成后查看设备连接状态：点击状态目录下W AN信息及VOIP信息页面分别查看，如下图：。

TR069_VOIP+INTERNET HG8240页面配置指导一，登陆设备：1，配置维护PC机的IP地址为192.168.100.100/255.255.255.0（注：ONT 的本地维护IP地址缺省为192.168.100.1/255.255.255.0），使用网线将维护PC机上的网口与ONT 的任一网口连接起来，并确保在维护PC机上可以PING通ONT 的维护IP地址。

2，通过IE页面登陆；输入管理员用户名telecomadmin，密码admintelecom，并选择中文网页，点击Login登录二，设置端口工作模式在LAN目录，LAN口工作模式里选择一、三、四三个口，二口默认作为IPTV二层拨号使用，完成后点击应用，如下图三，WAN口配置：1，配置PPPOE拨号上网—新建WAN1连接在WAN目录下WAN配置页面中选择新建WAN连接，并对相应选项设置（1）,点击使能WAN连接；（2）,服务列表选择INTERNET；（3）,连接方式选择路由；（4）,vlan填写 41（5）,802.1Q默认0；（6）,获取IP方式选择PPPOE; （7）,使能NAT；（8）,输入宽带拨号用户名及密码；（9）,绑定 1 3 4 三个口,用户电脑直接自动获取地址即可上网使用设置完成后点击应用确认2，配置TR069_VOIP DHCP获取地址WAN2连接在WAN目录下WAN配置页面中选择新建WAN连接，并对相应选项设置（1）,点击使能WAN连接；（2）,服务列表选择TR069_VOIP；（3）,连接方式选择路由；（4）,vlan填写 46（5）,802.1Q默认0；（6）,获取IP方式选择DHCP;其余部分无需设置，点击应用确认四，语音配置部分：1，设备SIP服务器：点击语音VOPI界面配置，输入SIP主服务器及备用服务器地址即可，信令接口名选择“2_TR069__VOIP__R_VID_46”其余不用修改梧州TR069方式SIP服务主备用地址都为：222.217.173.1862, 设置VOIP用户：点击语音选项VOIP用户配置页面使能相应语音端口并配置逻辑语音号码即可（注意要加区号），密码梧州地区为：111111；注意不要向用户泄露五，配置默认路由：在路由默认路由配置页面选择对应W AN1连接即可六，保存数据（很重要，一定要记得保存数据）在系统工具配文件页面，选择保存配置即可七，完成所有配置后重启设备，配置生效八，设备重启完成后查看设备连接状态：点击状态目录下W AN信息及VOIP信息页面分别查看，如下图：。

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头）和SOAPBody （SOAP体）组成的XML文档（4）ACS的管理方法就是对CPE上的管理函数进行远程调用，因此需要向CPE传输要调用的函数名及参数，这些内容包含在SOAP体中。

ACS并不直接对设备本身的接口进行调用，ACS所使用的函数为TR069的标准函数（称作TR-069 RPC Methods），CPE需要通过一个设备上的中间层解析出RPC方法，再由这个中间层调用设备自身的接口，这个中间层就是TR069 Agent。

TR069模拟测试环境搭建指南1 背景TR069 是数字用户线论坛（DSL Forum）制订的一个面向终端设备的网管协议，实际上是终端与接入开通网关进行交换的一种接口，（南向接口）。

另外接入开通网关北向接BOSS，以完成以完成业务开通、配置更改和软件升级等一系列工作，其组网环境如下图1-1。

图1-1 TR069测试组网环境图（有NA T环境）作为终端厂家，由于不具备接入开通网关设备，因此不能搭建实际的测试组网环境。

为解决这一问题，引入模拟测试工具Simulation 和ACS模拟器，模拟接入开通网关与终端进行交互。

虽然模拟环境与真实环境有一定的差距，但是能测试解决大多数问题，尤其是报文交互问题。

2 测试知识必备2.1 测试组网环境知识测试组网环境分有NAT环境和无NAT环境，有NAT环境指的是接入开通网关在NAT后，接入开通网关起2个服务，一个用于业务通道，另外一个用于管理通道（移动规定端口是8070），管理通道是1个长连接，终端定时向接入开通网关发送心跳进行保活，一般周期为3分钟，接入开通网关通过发送反向请求触发终端上报 6 CONNECTION Request请求下发业务参数；无NAT环境指的是接入开通网关在NAT前，接入开通网关只起一个服务用于业务通道，管理通道是终端做Server，服务端口由终端指定，终端注册时会把IP 和服务端口上报给接入开通网关，接入开通网关连上Server后发反向连接进行业务请求下发。

也就是说，有NAT与无NAT环境业务通道是一样的，只是管理通道不同谁做Server的问题。

有NAT情况参考《中国移动CM-IMS企业用户接入设备开通网关设备规范-V8.doc》中8.4长连接要求，其中反向请求报文如下示例（用16进制表示）：01 00 00 00 06 74 65 6c 70 6f 31 /*其中74 65 6c 70 6f 31代表的是设备用户名telpo1, 00telpo1的长度4个字节，01表示请求消息*/00 00 06表示的是下面介绍管理通道反向请求包，无NAT反向请求报文示例如下，其中192.168.0.93:12345是终端注册时上报给接入开通网关的：GET /cpe?id=8 HTTP/1.1User-Agent: Jakarta Commons-HttpClient/3.1Host: 192.168.0.93:123452.2 南向节点参数介绍业务功能包括开户、修改、查询和销户，各业务功能调用的RPC 如表2-1所示：表2-1 各业务功能调用RPC南向节点所有参数如下图2-1，各参数的具体含义参考《附件5：中国移动CM-IMS接入设备业务开通功能及接口要求规范-V9.doc》中的“6 接口参数”：图2-1 南向节点参数3 测试环境搭建3.1 有NAT测试环境搭建有NA T模拟测试环境采用Simulation测试工具，创建管理通道为8070的服务器作为示例：设置:8070,选择TCP Server, 点[Connect]后,左下角显示Create server success表示创建成功.图3-1-1创建管理通道端口8070服务器当收到设备管理口连接后,可看到xxx.xxx.x.xxconneced,选择Hex;输入框填01 00 00 00 05 74 65 6c 70 6f /*其中74 65 6c 70 6f 31代表的是设备用户名telpo, 00 00 00 05表示的是telpo的长度5个字节，01表示业务请求消息*/ ,点[Send]后, ACS模拟器就会看到设备发起业务请求连接图3-1-2下发反向请求包ACS模拟器收到请求包后,下面的操作就跟无NA T测试操作一致图3-1-3平台收到反向请求包3.2 无NAT测试环境搭建无NAT测试环境搭建采用ACS模拟器，与simulation测试工具不同的是，ACS模拟器通过脚本下发来完成业务的配置。

TR-069协议完整的通信过程TR-069协议完整的通信过程以下为设备重启到挂上TR069⽹管的报⽂流程解析(1) 设备启动；根据配置的ACS(⾃动配置服务器)地址，建⽴安全的HTTP连接以后，每次连接CPE都必须⾸先对ACS发出⼀个Inform的RPC调⽤请求来向ACS汇报本次连接的信息。

ACS会返回给⼀个Inform response作为确认连接。

标准的Inform⽅法的参数如表所⽰参数名称参数说明DeviceID数据结构标识CPEEvent标识此次Inform发起的原因MaxEnvelopes HTTP Response可携带SOAP信封数CurrentTime CPE当前的时间RetryCount这次Session最⼤的重复连接次数ParameterList这次Inform所需携带的参数POST /service.tr069 HTTP/1.1Host: 183.62.12.23:8012User-Agent: cwmpContent-Type: text/xml; charset=utf-8Connection: keep-aliveContent-Length: 1730<SOAP-ENV:Envelopexmlns:SOAP-ENV="/soap/envelope/"xmlns:SOAP-ENC="/soap/encoding/"xmlns:xsd="/2001/XMLSchema"xmlns:cwmp="urn:dslforum-org:cwmp-1-0">xmlns:cwmp="urn:dslforum-org:cwmp-1-0"><SOAP-ENV:Header><cwmp:ID SOAP-ENV:mustUnderstand="1">946684824</cwmp:ID></SOAP-ENV:Header><SOAP-ENV:Body><!-- inform⽅法任何时刻要建⽴与ACS的连接，都必须调⽤Inform⽅法--><!-- 来初始化⼀个传输序列,向ACS服务器上报⼀些事件，具体事件就携带在EventCode --><cwmp:Inform><!-- 设备描述信息 --><DeviceId><!-- 设备⼚商 --><Manufacturer>star-net</Manufacturer><!-- 设备制造商的唯⼀标⽰ --><OUI>00D0F8</OUI><!-- 设备类型 --><ProductClass>SVP3000_V5_SIP_CN</ProductClass><!-- 设备序列号 --><SerialNumber>00100400RJ0100100000001AA9800003</SerialNumber></DeviceId><!-- 引起此次会话建⽴的具体事件 --><Event SOAP-ENC:arrayType="cwmp:EventStruct[1]"><EventStruct><!-- 上报BOOT事件，也就是告诉ACS要发起CWMP连接了 --><!-- 1 boot表明发起会话的原因是设备上电(⾸次启动或者其他原因引起的设备重启) --><EventCode>1 BOOT</EventCode><CommandKey></CommandKey></EventStruct></Event><!-- 接收响应的允许SOAP信包数⽬，0表⽰⽆限制 --><MaxEnvelopes>1</MaxEnvelopes><!-- cpe当前的时间 --><CurrentTime>2000-01-01T08:00:23</CurrentTime><!-- 完成inform调⽤前尝试的次数每次加1 --><RetryCount>0</RetryCount><!-- CPE设备参数列表--><ParameterList SOAP-ENC:arrayType="cwmp:ParameterValueStruct[6]"><ParameterValueStruct><!-- 设备描述信息 --><Name>Device.DeviceSummary</Name><Value>Device:1.0[](Baseline:1), VoiceService:1.0[1](Baseline:1)</Value></ParameterValueStruct><ParameterValueStruct><!-- 设备的硬件版本信息 --><Name>Device.DeviceInfo.HardwareVersion</Name><Value>5.0</Value></ParameterValueStruct><ParameterValueStruct><!-- 设备的软件版本信息 --><Name>Device.DeviceInfo.SoftwareVersion</Name><Value>AIM1.3.10.8</Value></ParameterValueStruct><ParameterValueStruct><!-- 请求URL(设备联系地址) --><Name>Device.ManagementServer.ConnectionRequestURL</Name><Value>http://192.168.99.17:7547/</Value></ParameterValueStruct><ParameterValueStruct><!-- 对某些⽅法的调⽤会导致该值的该改变如 Scheduled Inform、reboot、download、upload⽅法 --> <!-- 除此以外的调⽤该值均为空，此消息中设备只调⽤了 inform⽅法，故该值应该置为空 --><Name>Device.ManagementServer.ParameterKey</Name><Value></Value></ParameterValueStruct><ParameterValueStruct><!-- 设备ip地址 --><Name>N.IPAddress</Name><Value>192.168.99.17</Value><Value>192.168.99.17</Value></ParameterValueStruct></ParameterList></cwmp:Inform></SOAP-ENV:Body></SOAP-ENV:Envelope>(2) ACS服务器接受到设备端(CPE端)发出的inform消息之后，会给予⼀个 informresponse响应机cwmp连接创建成功HTTP/1.1 200 OKDate: Tue, 02 Aug 2011 03:20:53 GMTServer: Microsoft-IIS/6.0X-Powered-By: X-AspNet-Version: 2.0.50727Set-Cookie: SerialNumber=00100400RJ0100100000001AA9800003; path=/Cache-Control: privateContent-Type: text/xml;charset=UTF-8Content-Length: 522<!-- 对设备端inform消息的响应即接受连接请求 --><soap:Envelopexmlns:soap="/soap/envelope/"xmlns:cwmp="urn:dslforum-org:cwmp-1-0"xmlns:xsd="/2001/XMLSchema"xmlns:xsi="/2001/XMLSchema-instance"xmlns:SOAP-ENC="/soap/encoding/"><soap:Header><cwmp:ID soap:mustUnderstand="1">946684824</cwmp:ID><cwmp:HoldRequests soap:mustUnderstand="1">0</cwmp:HoldRequests></soap:Header><soap:Body><!-- ACS接受设备端(cpe)端的inform请求(即创建cwmp连接的请求) --><cwmp:InformResponse><MaxEnvelopes>1</MaxEnvelopes></cwmp:InformResponse></soap:Body></soap:Envelope>(3) 设备端发送空消息，表⽰没有后续的请求POST /service.tr069 HTTP/1.1Host: 183.62.12.23:8012User-Agent: cwmpContent-Type: text/xml; charset=utf-8Connection: keep-aliveCookie: SerialNumber=00100400RJ0100100000001AA9800003;path=/Content-Length: 0<!-- Host: ACS(⾃动配置服务器)地址 --><!-- Cookie: 设置在设备的序列号--><!-- Content-Length: 消息内容长度为0代表空消息-->(4) ACS服务器收到空消息后，根据空消息中携带的序列号对设备进⾏合法性验证，若验证通过则进⾏后续操作，若不通过则下发消息提⽰设备⾮法。

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。