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协议简介
© 2006, ZTE Corporation. All rights reserved.
© 2006, ZTE Corporation. All rights reserved.
TR069 协议简介
TR069协议栈
图2 TR069协议栈
© 2006, ZTE Corporation. All rights reserved.
TR069 协议简介
层
CPE/ACS Application （CPE/ACS应用） PRC Methods （RPC方法）
表2 RPC方法列表
© 2006, ZTE Corporation. All rights reserved.
CPE与ACS的交互
ACS方法
GetRPCMethods
Inform
本方法可用于CPE或ACS来发现另一 方所支持的方法集。
任何时刻要建立与ACS的连接，CPE 必须调用Inform方法，来初始化一个 传输序列。
CPE与ACS的交互
认证流程
☺ 如果CPE没有经SSL/TLS进行认证，ACS必须通过HTTP对CPE 进行认证。如果SSL/TLS用于加密，ACS可以使用基本或摘要认证。 如果没有使用SSL/TLS，则ACS必须使用摘要认证。
☺ 在首次HTTP事务中，ACS可以进行一次认证，并且在整个TCP 连接中不需再进行认证。
© 2006, ZTE Corporation. All rights reserved.
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建立连接。
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。
这种配置机制允许将来更简单的扩展，允许能够为本规范未包括的服务功能进行配置的扩展。
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/IP；2)标准的Internet传输安全协议，SSL3.0 OR TLS1.0 ，使用SSL/TLS并不强制要求，确保CPE和ACS之间基于证书的鉴权3)ACS与CPE间的消息传输使用HTTP1.14)消息的具体内容使用SOAP包进行封装，SOAP包是一个包含SOAP Head（SOAP头）和SOAP Body （SOAP体）组成的XML文档5)ACS与CPE之间通过TR069协议特有的RPC方法进行互操作。
ACS远程调用CPE上的RPC函数，用来对CPE进行管理如：设置CPE参数、获取CPE 参数、硬件升级、重启设备等；因此需要向CPE传输要调用的函数名及参数，这些内容包含在SOAP体中。
tr069
第一章CPE WAN Management Protocol(DSL Forum TR-069)该协议描述了，在一个公共架构中CPE和自动配置服务器(ACS)之间的通讯，并包括了自动配置的安全性以及其它的一些CPE管理功能。
1.介绍该文档描述了在CPE和自动配置服务器(ACS)之间的通讯过程中使用的CPE广域网管理协议。
CPE广域网管理协议定义了一种机制，包括CPE自动配置的安全性，以及将其他一些CPE管理功能和并到同一个公共架构下。
1.1功能组成CPE广域网管理协议支持大量的功能以支持管理大量的CPE，包括下面一些最初始的功能:@自动配置和动态提供服务@软件/固件的镜像管理@状态和性能监控@诊断1.1.1自动配置和动态提供服务CPE广域网管理协议允许自动配置服务器(ACS)为一台CPE或大量基于各种标准的大量CPE提供服务。
设备机制包括配置指定参数和根据卖主的需求指定参数的通用机制。
设备机制允许CPE既可以在初始化连接到宽带存取网络的时候，也可以在以后任何时候发起设备。
这可以支持在异步状况下，ACS重新发起对CPE设备的配置。
这个协议中包含了鉴权机制，允许为每一台指定的CPE,或者基于相同的vendor,型号，软件版本的CPE集群提供服务。
The protocol also provides optional tools to manage the CPE-specific components of optional applications or services for which an additional level of security is required to control, such as those involving payments. The mechanism for control of such Options using digitally signed Vouchers is defined in Appendix C.这种设备机制允许将来更简单的扩展，扩展能够为本规范未包括的设备提供服务。
tr069通用参数
tr069通用参数
TR069是一种网络管理协议，主要用于自动配置和监控家庭或企业网络中的设备。
它定义了设备之间的通信方式，以便远程管理设备。
TR069协议主要定义了ACS（自动配置服务器）和CPE（用户端设备）间的南向接口。
它包含一些该协议特有的组件，同时也使用了一些标准协议，如SSL/TLS、TCP/IP等。
在TR069协议中，CPE和ACS之间的通信涉及到一些通用参数，这些参数主要用于配置和监控CPE设备。
一些重要的通用参数包括：
1. 设备标识符：用于唯一标识一个CPE设备。
2. 设备版本：表示CPE设备的软件或固件版本。
3. 设备状态：表示CPE设备的当前状态，例如在线、离线、故障等。
4. 配置参数：用于设置和修改CPE设备的配置，例如IP地址、网关、DNS 服务器等。
5. 性能数据：用于收集和报告CPE设备的性能数据，例如带宽使用情况、丢包率、延迟等。
6. 事件通知：用于触发警报或通知，例如设备故障、配置变更等。
这些通用参数可以帮助管理员远程管理和监控CPE设备，提高网络管理的效率和便利性。
具体参数可能会根据不同的CPE设备和厂商有所不同，因此在实际应用中需要根据具体情况进行配置和管理。
- 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
保存最近一次告警的信息。