What is TR-069

TR-069 is a BroadBand Forum (former DSL Forum) technical specification which defines an application layer protocol for remote management of customer-premises equipment (CPE).

For more information see TR-069: CPE WAN Management Protocol.

Why do you need TR-069 support

• Centralized scalable management system
• Possibility to manage a wide variety of residential gateways and other network devices (STB, NAS etc.) in the same way
• CPE devices located behind NAT
• Ability to track changes on CPE devices
• Unified and scalable method of software upgrade

• Vendor-specific management methods and configuration parameters For more information see MR-230: TR-069 Deployment Scenarios.

TROL

TROL is a product which includes:

• TR-069-compliant client application
• Set of libraries to simplify integration with customer software and hardware
• Tools for data model description files handling

Complied standards

• TR-069: CPE WAN Management Protocol v1.1
• TR-098: Internet Gateway Device Version 1.1 (Data Model for TR-069)
• TR-104: Provisioning Parameters for VoIP CPE
• TR-106: Data Model Template for TR-069-Enabled Devices
• TR-111: Applying TR-069 to Remote Management of Home Networking Devices
• TR-135: Data Model for a TR-069 Enabled STB
• TR-140: TR-069 Data Model for Storage Service Enabled Devices
• TR-142: Framework for TR-069 enabled PON devices
• TR-143: Enabling Network Throughput Performance Tests and Statistical Monitoring
• TR-157: Component Objects for CWMP
• TR-181: Device Data Model for TR-069

TR-069 features in TROL

• Software update (firmware download)
• CPE RPC Methods
  • GetRPCMethods
  • GetParameterNames
  • GetParameterValues, SetParameterValues
  • GetParameterAttributes, SetParameterAttributes
  • AddObject, DeleteObject
  • Upload, Download, GetAllQueuedTransfers
  • Reboot, FactoryReset
• ACS RPC Methods
  • Inform
  • TransferComplete
• Vendor-specific parameters definition and access
• TCP/UDP Connection requests, integrated STUN
• SSL connections
• HTTP/HTTPS/FTP file transfer
• Diagnostics

TROL benefits

• Design flexibility; no efforts needed to add customer-specific features
• Tunable footprint and RAM usage
• Modularity
  • Multiple data providers each responsible for management of certain hardware or software component
  • Flexible logic allows to combine data providers and shape a customer device data model
  • Data providers can be reused across customer product line
• Internal memory management to speed up allocations and secure memory usage
• Debug mode with run-time validation of all data structures
• Both ACS and providers data validation according to the datamodel specification (type checking, value range, size)
• Run-time modules addition/removal
• Active and passive notifications, diagnostics, periodic Informs
• Integrated file transfer support (HTTP, HTTPS, FTP)
• Strong debug capabilities including CLI interface for precise client control
• Uses Broadband Forum XML data model description
• Ready-to-use data provider for constant values

Components

• Application Core is responsible for application initialization, shutdown, configuration files processing, internal events and commands dispatch
• HTTP Server handles TCP/UDP Connection Requests
• CWMP Session manager provides support for CWMP protocol, RPC, Events and periodic Informs
• Transfer Manager performs files upload and download
• IPC Manager provides debug interface for communication with external applications such as CLI
• Data Providers are responsible for interaction with customer hardware or software; each is responsible for a set of TR-069 management variables or subtrees
• Data Model Manager performs communication with data providers, generates notifications and performs providers data validation
• Persistent Storage Manager reads and stores software/firmware images and configuration files into persistent memory, e. g. flash

Portability

• Written in ANSI C
• Single-threaded
• Build system is based on GNU autotools
• Utilize POSIX API (sockets, file access)
• Can run on Linux, FreeBSD, NetBSD, MacOS X, QNX
• Dependencies are gSOAP, libc (uClibc, glibc), OpenSSL (optional), libfetch or libcurl, expat

Provided services

• TROL porting to customer platforms
• Integration of TROL with customer’s software
• Validation of customer product for compliance with TR-069 standard

Roadmap

• Replace gSOAP with optimized HTTP/SOAP library
• Support TR-069 Amendment 4 features
• SFTP and TFTP file transfer
• Multicast file transfer

Deployment

The TROL TR-069 Client is used in all new gateways of Tilgin and has demonstrated good interworking with ACS used by Tilgin’s partners and clients.

Download the TROL leaflet