Grandstream TR-069 User Manual

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 HTT P 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 vendor’s proprietary mechanisms
for provisioning/management.

TYPICAL SCENARIO:

Grandstream Networks, Inc. TR-069 White Paper Page 2 of 7

Last Updated: 11/2010

Previous graph shows a common customer installation. Whe re CPEs (Grand stream 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-provisi oning
before sending unit to end user. However, Grandstream provides a redi rection/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
GetParameterNames

GetParameterValues

GetAttributeValues

SetParameterValues

SetAttributeValues

AddObject
DeleteObject
Reboot
Download

Sent by the ACS to find out about the methods supported by the device.
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 obtain the value of one or more CPE
Parameters.

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

Grandstream Networks, Inc. TR-069 White Paper Page 3 of 7

Last Updated: 11/2010