tr69 Doc 0

Grandstream Networks, Inc.
Grandstream TR-069 information.
www.grandstream.com
WHAT IS TR069?
It is a protocol for communication between CPE (Customer Premise Equipment) and an ACS (Auto
Configuration Server) that provides secure auto-configuration as well as other CPE management
functions within a common framework.
TR-069 stands for a technical report defined by the Broadband Forum that specifies the CWMP CPE
WAN Management Protocol. It commonly uses HTTP or HTTPS as transport for communication between
CPE and the ACS. The message exchange is using SOAP (XML_RPC) for configuration and
management of the device.
Last published version of the standard is amendment 2 (CWMP1.1). The core defines the protocol,
session establishment, message exchange structure, and Remote Procedure Calls.
WHY USE TR069?

Service Providers, using TR-069, can have one common platform to manage all Grandstream devices
and other CPEs, no matter neither the device type nor the manufacturer.
This common application was not easily achieved before due to CPE vendors proprietary mechanisms
for provisioning/management.
TYPICAL SCENARIO:
TR-069 White Paper
Page 2 of 7
Last Updated: 11/2010
Previous graph shows a common customer installation. Where CPEs (Grandstream devices) are behind a
router/gateway and they connect to the ACS via TR-069 so they can get manage remotely.
Normally TR069 provisioning/management will be used by service providers in large scale deployments.
Therefore, units need to be initially provision with the ACS connection parameters before being able to
connect with the server. There are several ways to work this initial configuration as per-provisioning
before sending unit to end user. However, Grandstream provides a redirection/provisioning service called
GAPS that can take care of initial ACS parameters setup.
RPC METHODS:
The following table provides a description of supported TR-069 RPC methods by Grandstream devices.
Some models may have some extra methods (vendor-specific methods) that are not shown in the table
below. Please contact Grandstream for more information.
Methods
Description
GetRPCMethods
Sent by the ACS to find out about the methods supported by the device.
GetParameterValues
This method is used by an ACS to obtain the value of one or more CPE
Parameters.
GetParameterNames
GetAttributeValues
SetParameterValues
SetAttributeValues
AddObject
DeleteObject
Reboot
Download
This method is used by an ACS to discover the device supported parameters.

When called this method return a list of parameter names on the device.
Depending on the method parameters this can be called for complete and partial
parameter paths on the device.
This method is used by an ACS to read the attributes associated with one or
more CPE Parameter.
This method is used by an ACS to modify the value of one or more of the
device's Parameters.
Changes the attributes (modifiers) of the specified path. The path can be
complete or partial.
Adds a new instance of an object defined on the device.
Deletes an instance of an object defined on the device.
Reboots the device.
This method is used by the ACS to cause the CPE to download a specified file
from the designated location. Filetype supported by Grandstream devices are:
1 Firmware Upgrade Image

3 Vendor Configuration File
TR-069 White Paper
Page 3 of 7
TR104 DATA MODEL:

This technical report defines the data model for provisioning of VoIP devices by an ACS using the
mechanism defined in TR-069.
All Grandstream devices are only SIP compatible, for this reason, only objects and parameters related to
SIP are implemented from the Datamodel.
TR-069 White Paper
Page 4 of 7
WHAT IS THE SCOPE OF THE REMOTE MANAGEMENT?
Auto-Configuration: This mechanism allows the Grandstream device auto-provisioning at the time
of initial connection, and the ability to re-provision at any subsequent time. For initial ACS
parameters provisioning please refer to the GAPS redirection service.
Firmware Management: TR-069 provides tools to manage downloading of CPE software/firmware

image files. The protocol provides mechanisms for version identification, file download initiation
(ACS initiated downloads and optional CPE initiated downloads), and notification of the ACS of
the success or failure of a file download.
Configuration or environment variables changes notification:TR-069 provides support for a CPE

to make available information that the ACS may use to monitor the CPEs status and performance
statistics. This is done by defining the conditions under which a CPE should actively/passively
notify the ACS of changes.
Enabling / disabling features remotely: For example, VoIP accounts can be easily activated by
sending a TR-069 RPC. Additionally other more advance applications as pushing contents or
customizing the GUI can be done by using vendor parameters.
Reboot: Grandstream devices can be rebooted by using the mechanisms established by TR-069.
SUPPORTED PHONES AND FIRMWARE VERSIONS:
HT50X, GXW40XX (1.0.3.10 or higher)
GXP21XX (1.0.1.26 or higher)
GXV3140 (1.0.6.12 or higher)
INTEROPERABILITY AND DEPLOYMENT:
Service provider contacts Grandstream sales department to establish initial relationship and
provide both parties technical contact information.
Service provider sends to Grandstream the requirement list and/or expected provisioning flow
chart.
Grandstream works together with service provider and ACS vendor to get the test cases and
testing accounts.
Testing and corrections.
Initial deployment and verification.
TR-069 White Paper
Page 5 of 7
WEBUI CONFIGURATION:
Normally ACS configuration settings are pre-provisioned by the service provider or the Grandstream
device is redirected by our GAPS to the location where the service provider has each device configuration
file. However, we still have a graphic interface for easy testing and debugging.
The TR-069 related parameters are:
ACS URL: URL of the TR-069 ACS, Grandstream device will try to connect and send messages
to this server.
ACS Username: Username used for the HTTP authentication against the ACS.
ACS Password: Password used for the HTTP authentication against the ACS.
Periodic Inform Interval: time in seconds where the CPE will initiate a new session against the
ACS.
Periodic Inform Enable: Set the Grandstream device to start a new session after Periodic Inform
Interval
Connection Request Username: Username to authenticate incoming connection requests.

Connection Request Password: Password to authenticate incoming connection requests.
TR-069 White Paper
Page 6 of 7
STANDARDS COMPLIANCE
Currently Grandstream CPEs support the list of standards shown below. For further information about this
technical documents, please refer to Broadband Forum website.
TR-069 Amendment 2 (partially compliant)
TR-111 (Compliant)
TR-104 (Compliant with SIP)
ACS INFORMATION:
Grandstream has worked or it is currently working with the following ACS vendors:
Finepoint
ASISco Geremias
Alcatel/Motive ACS
For more info regarding interoperability with these vendors or other ACS vendors, please contact
Grandstream technical support.
CONTACT US
For any additional inquire, please visit our website http://www.grandstream.com/contactus.html and we
will be more than glad to help and provide you specific information regarding Grandstream devices.
TR-069 White Paper
Page 7 of 7

tr69 Doc 0

Uploaded by

Copyright:

Available Formats

tr69 Doc 0

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

tr69 Doc 0

Uploaded by

Copyright:

Available Formats

What is TR-069 and what does it stand for?

What is TR-069 and what does it stand for?

What are some benefits of using TR-069 for service providers?

What are some benefits of using TR-069 for service providers?

Grandstream Networks, Inc.

Grandstream TR-069 information.

WHY USE TR069?

Grandstream Networks, Inc.

TR-069 White Paper

This method is used by an ACS to discover the device supported parameters.

Grandstream Networks, Inc.

1 Firmware Upgrade Image

TR-069 White Paper

TR104 DATA MODEL:

Grandstream Networks, Inc.

TR-069 White Paper

WHAT IS THE SCOPE OF THE REMOTE MANAGEMENT?

Firmware Management: TR-069 provides tools to manage downloading of CPE software/firmware

Configuration or environment variables changes notification:TR-069 provides support for a CPE

SUPPORTED PHONES AND FIRMWARE VERSIONS:

HT50X, GXW40XX (1.0.3.10 or higher)

GXP21XX (1.0.1.26 or higher)

GXV3140 (1.0.6.12 or higher)

INTEROPERABILITY AND DEPLOYMENT:

Testing and corrections.

Initial deployment and verification.

Grandstream Networks, Inc.

TR-069 White Paper

Connection Request Username: Username to authenticate incoming connection requests.

Grandstream Networks, Inc.

TR-069 White Paper

TR-069 Amendment 2 (partially compliant)

TR-104 (Compliant with SIP)

Grandstream Networks, Inc.

TR-069 White Paper

You might also like