TR-069 is a Broadband Forum technical specification entitled CPE WAN Management Protocol.
TR-069 is a Broadband Forum technical specification entitled CPE WAN Management Protocol.

It defines an application layer protocol for remote management of end-user devices.
It defines an application layer protocol for remote management of end-user devices.

As a bidirectional SOAP/HTTP-based protocol, it provides the communication between customer-premises
As a bidirectional SOAP/HTTP-based protocol, it provides the communication between customer-premises

equipment and Auto Configuration Servers.
equipment and Auto Configuration Servers.

It includes both a safe auto configuration and the control of other CPE management functions
It includes both a safe auto configuration and the control of other CPE management functions

within an integrated framework.
within an integrated framework.

The protocol addressed the growing number of different Internet access devices such
The protocol addressed the growing number of different Internet access devices such

as modems, routers, gateways, set-top boxes, and VoIP-phones for the end-users.
as modems, routers, gateways, set-top boxes, and VoIP-phones for the end-users.

The TR-069 standard was developed for automatic configuration of these devices with Auto Configuration
The TR-069 standard was developed for automatic configuration of these devices with Auto Configuration

Servers.
Servers.

The technical specifications are managed and published by the Broadband Forum.
The technical specifications are managed and published by the Broadband Forum.

TR-069 was first published in May 2004, with amendments in 2006, 2007, 2010, July 2011
TR-069 was first published in May 2004, with amendments in 2006, 2007, 2010, July 2011

to version 1.3. and November 2013 to version 1.4
to version 1.3. and November 2013 to version 1.4

Other forums, such as the Home Gateway Initiative, Digital Video Broadcasting and WiMAX Forum
Other forums, such as the Home Gateway Initiative, Digital Video Broadcasting and WiMAX Forum

endorsed CWMP as the protocol for remote management of home network devices and terminals.
endorsed CWMP as the protocol for remote management of home network devices and terminals.

There is a growing trend to add TR-069 management functionality to home networking devices behind
There is a growing trend to add TR-069 management functionality to home networking devices behind

the gateway, as well as many other access devices like M2M, FTTH CPE/ONTs, WIMAX CPE
the gateway, as well as many other access devices like M2M, FTTH CPE/ONTs, WIMAX CPE

and other carrier access equipment.
and other carrier access equipment.

Communication between the device and ACS Transport details
Communication between the device and ACS Transport details

CWMP is a text based protocol.
CWMP is a text based protocol.

Orders sent between the device and auto configuration server are transported over HTTP.
Orders sent between the device and auto configuration server are transported over HTTP.

At this level CPE is behaving in the role of client and ACS in the role of HTTP server.
At this level CPE is behaving in the role of client and ACS in the role of HTTP server.

This essentially means that control over the flow of the provisioning session is the sole
This essentially means that control over the flow of the provisioning session is the sole

responsibility of the device.
responsibility of the device.

Provisioning session All communications and operations are performed
Provisioning session All communications and operations are performed

in the scope of the provisioning session.
in the scope of the provisioning session.

The session is always started by the device(CPE) and begins with the transmission of an Inform
The session is always started by the device(CPE) and begins with the transmission of an Inform

message.
message.

Its reception and readiness of the server for the session is indicated by an InformResponse
Its reception and readiness of the server for the session is indicated by an InformResponse

message.
message.

That concludes the session initialization stage.
That concludes the session initialization stage.

The order of the next two stages depends on the value of the flag HoldRequests.
The order of the next two stages depends on the value of the flag HoldRequests.

If the value is false the initialization stage is followed by the transmission of device
If the value is false the initialization stage is followed by the transmission of device

requests, otherwise ACS orders are transmitted first.
requests, otherwise ACS orders are transmitted first.

The following description assumes the value is false.
The following description assumes the value is false.

In the second stage, orders are transmitted from the device to the ACS.
In the second stage, orders are transmitted from the device to the ACS.

Even though the protocol defines multiple methods that may be invoked by the device
Even though the protocol defines multiple methods that may be invoked by the device

on the ACS, only one is commonly found - TransferComplete which is used to inform the ACS of the completion
on the ACS, only one is commonly found - TransferComplete which is used to inform the ACS of the completion

of a file transfer previously issued Download or Upload request.
of a file transfer previously issued Download or Upload request.

This stage is finalized by transmission of empty HTTP-request to the ACS.
This stage is finalized by transmission of empty HTTP-request to the ACS.

In the third stage the roles change on the CWMP level.
In the third stage the roles change on the CWMP level.

The HTTP-response for the empty HTTP-request by the device will contain a CWMP-request
The HTTP-response for the empty HTTP-request by the device will contain a CWMP-request

from the ACS.
from the ACS.

This will subsequently be followed by an HTTP-request containing a CWMP-response for the previous
This will subsequently be followed by an HTTP-request containing a CWMP-response for the previous

CWMP-request.
CWMP-request.

Multiple orders may be transmitted one-by-one.
Multiple orders may be transmitted one-by-one.

This stage is terminated by an empty HTTP-response from the ACS indicating that no more orders
This stage is terminated by an empty HTTP-response from the ACS indicating that no more orders

are pending.
are pending.

Security and authentication As vital data may be transmitted to CPE via
Security and authentication As vital data may be transmitted to CPE via

CWMP, it is essential to provide secure transport channel and always authenticate the CPE against
CWMP, it is essential to provide secure transport channel and always authenticate the CPE against

the ACS.
the ACS.

Secure transport and authentication of the ACS identity can easily be provided by usage
Secure transport and authentication of the ACS identity can easily be provided by usage

of HTTPS and verification of ACS certificate.
of HTTPS and verification of ACS certificate.

Authentication of the CPE is more problematic.
Authentication of the CPE is more problematic.

The identity of the device is verified based on a shared secret at the HTTP level.
The identity of the device is verified based on a shared secret at the HTTP level.

Passwords may be negotiated between the parties at every provisioning session.
Passwords may be negotiated between the parties at every provisioning session.

When the device contacts the ACS for the first time default passwords are used.
When the device contacts the ACS for the first time default passwords are used.

In large networks it is the responsibility of the procurement to ensure each device is
In large networks it is the responsibility of the procurement to ensure each device is

using unique credentials, their list is delivered with the devices themselves and secured.
using unique credentials, their list is delivered with the devices themselves and secured.

Connection request Because initialization and control of the
Connection request Because initialization and control of the

provisioning session flow is the sole responsibility of the device, it is necessary for the ACS
provisioning session flow is the sole responsibility of the device, it is necessary for the ACS

to be able to request a session start from the device.
to be able to request a session start from the device.

The connection request mechanism is also based on HTTP.
The connection request mechanism is also based on HTTP.

In this case the device is put in the role of HTTP-server.
In this case the device is put in the role of HTTP-server.

The ACS requests a connection from the device by visiting a negotiated URL and performing
The ACS requests a connection from the device by visiting a negotiated URL and performing

HTTP Authentication.
HTTP Authentication.

A shared secret is also negotiated with the device in advance to prevent the usage of
A shared secret is also negotiated with the device in advance to prevent the usage of

CPEs for DDoS attacks on the provisioning server.
CPEs for DDoS attacks on the provisioning server.

After confirmation is sent by the device the provisioning session should be started as
After confirmation is sent by the device the provisioning session should be started as

soon as possible and not later than 30 seconds after confirmation is transmitted.
soon as possible and not later than 30 seconds after confirmation is transmitted.

CR over NAT The CWMP protocol also defines a mechanism
CR over NAT The CWMP protocol also defines a mechanism

for reaching the devices that are connected behind NAT.
for reaching the devices that are connected behind NAT.

This mechanism, based on STUN and UDP NAT traversal, is defined in document TR-069 Annex
This mechanism, based on STUN and UDP NAT traversal, is defined in document TR-069 Annex

G. Amendment 5 of the protocol introduces alternative
G. Amendment 5 of the protocol introduces alternative

method of executing Connection Request via NAT based on XMPP.
method of executing Connection Request via NAT based on XMPP.

Data model Most of the configuration and diagnostics
Data model Most of the configuration and diagnostics

is performed through setting and retrieving the value of the device parameters.
is performed through setting and retrieving the value of the device parameters.

These are organized in a well defined hierarchical structure that is more or less common to all
These are organized in a well defined hierarchical structure that is more or less common to all

device models and manufacturers.
device models and manufacturers.

Broadband Forum publishes its data model standards in two formats - XML files containing a detailed
Broadband Forum publishes its data model standards in two formats - XML files containing a detailed

specification of each subsequent data model and all of the changes between their versions
specification of each subsequent data model and all of the changes between their versions

and PDF files containing human-readable details.
and PDF files containing human-readable details.

Supported standards and extensions should be clearly marked in the device data model.
Supported standards and extensions should be clearly marked in the device data model.

This should be in the field Device.DeviceSummary or InternetGatewayDevice.DeviceSummary which
This should be in the field Device.DeviceSummary or InternetGatewayDevice.DeviceSummary which

is required starting from Device:1.0 and InternetGatewayDevice:1.1 respectively.
is required starting from Device:1.0 and InternetGatewayDevice:1.1 respectively.

If the field is not found InternetGatewayDevice:1.0 is implied.
If the field is not found InternetGatewayDevice:1.0 is implied.

As of Device:1.4 and InternetGatewayDevice:1.6 new field for supported standard specification
As of Device:1.4 and InternetGatewayDevice:1.6 new field for supported standard specification

was introduced.
was introduced.

The model is always rooted in the single key named Device or InternetGatewayDevice depending
The model is always rooted in the single key named Device or InternetGatewayDevice depending

on the manufacturer's choice.
on the manufacturer's choice.

At each level of the structure objects and parameters are allowed.
At each level of the structure objects and parameters are allowed.

Keys are constructed by concatenating the names of objects and parameter using '.'(dot)
Keys are constructed by concatenating the names of objects and parameter using '.'(dot)

as a separator, e.g. InternetGatewayDevice.Time.NTPServer1 .
as a separator, e.g. InternetGatewayDevice.Time.NTPServer1 .

Each of the parameters may be marked as writable or non-writable.
Each of the parameters may be marked as writable or non-writable.

This is reported by the device in GetParameterNamesResponse message.
This is reported by the device in GetParameterNamesResponse message.

The device should not permit the change of any parameter marked as read-only.
The device should not permit the change of any parameter marked as read-only.

Data model specifications and extensions clearly mark required status of most of the parameters.
Data model specifications and extensions clearly mark required status of most of the parameters.

Values applicable for the parameter, their type and meaning are also precisely defined
Values applicable for the parameter, their type and meaning are also precisely defined

by the standard.
by the standard.

Multi-instance objects Some parts of the data model require the existence
Multi-instance objects Some parts of the data model require the existence

of multiple copies of the subtree.
of multiple copies of the subtree.

The best examples are those describing tables, e.g. Port Forwarding Table.
The best examples are those describing tables, e.g. Port Forwarding Table.

An object representing an array will only have instance numbers or alias names as its
An object representing an array will only have instance numbers or alias names as its

children.
children.

A multi-instance object may be writable or read-only depending on the data represented.
A multi-instance object may be writable or read-only depending on the data represented.

If for example the object represents four physical ports on a switch it should not be
If for example the object represents four physical ports on a switch it should not be

possible to add or remove them from the data model.
possible to add or remove them from the data model.

If an instance is added to an object an identifier is assigned.
If an instance is added to an object an identifier is assigned.

After being assigned, identifiers may not change during the life-cycle of the device
After being assigned, identifiers may not change during the life-cycle of the device

except for factory-reset.
except for factory-reset.

Common problems Even though the list of the parameters and
Common problems Even though the list of the parameters and

their attributes is well defined most of the devices do not follow standards completely.
their attributes is well defined most of the devices do not follow standards completely.

Most common problems include missing parameters, omitted instance identifiers, wrong parameter
Most common problems include missing parameters, omitted instance identifiers, wrong parameter

access level and correctly using only defined valid values.
access level and correctly using only defined valid values.

For example, for the field that indicates supported standard of WLAN protocols, the
For example, for the field that indicates supported standard of WLAN protocols, the

value 'g' should indicate support of 802.11b and 802.11g, and 'g-only' support only of
value 'g' should indicate support of 802.11b and 802.11g, and 'g-only' support only of

802.11g.
802.11g.

Even though values such as 'bg' or 'b/g' are not legal according to the Broadband Forum
Even though values such as 'bg' or 'b/g' are not legal according to the Broadband Forum

standards, they are very commonly found in device data models.
standards, they are very commonly found in device data models.

Common operations The whole provisioning is built on top of
Common operations The whole provisioning is built on top of

a defined set of simple operations.
a defined set of simple operations.

Each order is considered atomic, though there is no support of transactions.
Each order is considered atomic, though there is no support of transactions.

If the device cannot fulfil the order a proper error needs to be returned to the ACS - the
If the device cannot fulfil the order a proper error needs to be returned to the ACS - the

device should never break the provisioning session.
device should never break the provisioning session.

High-level operations possible through Technical Report-069
High-level operations possible through Technical Report-069

Service activation and reconfiguration Initial configuration of the service as part
Service activation and reconfiguration Initial configuration of the service as part

of zero-touch or one-touch configuration process Service re-establishment
of zero-touch or one-touch configuration process Service re-establishment

Remote Subscriber Support Verification of the device status and functionality
Remote Subscriber Support Verification of the device status and functionality

Manual reconfiguration
Manual reconfiguration

Firmware and Configuration Management Firmware upgrade/downgrade
Firmware and Configuration Management Firmware upgrade/downgrade

Configuration backup/restore
Configuration backup/restore

Diagnostics and monitoring Throughput and connectivity diagnostics
Diagnostics and monitoring Throughput and connectivity diagnostics

Parameter value retrieval Log file retrieval
Parameter value retrieval Log file retrieval

See also Wireless router
See also Wireless router

References
References

External links TR-069 Issue 1 Amendment 5 CPE WAN Management
External links TR-069 Issue 1 Amendment 5 CPE WAN Management

Protocol v1.4 CPE WAN Management Protocol CWMP XML Schemas
Protocol v1.4 CPE WAN Management Protocol CWMP XML Schemas

and Data Model Definitions Marketing Report TR-069 Deployment Scenarios,
and Data Model Definitions Marketing Report TR-069 Deployment Scenarios,

Issue: 1, August 2010
Issue: 1, August 2010