Broadband Forum CPE WAN Management Protocol (CWMP) Data Models

2024-01-18: TR-106 Amendment 13 and TR-181 Issue 2 Amendment 17

Introduction

The Broadband Forum defines several data models for use with the CPE WAN Management Protocol (TR-069 Amendment 6). These data models contain objects and parameters that describe the many different functions and capabilities available to devices and services that are manageable via CWMP.

CWMP data models are divided into two types: Root and Service. The root data model, Device1, is used to describe the major functions of a network aware device, including interfaces, software/firmware, diagnostics, components common to CWMP and other services, and the basic device information necessary to CWMP.

Service data models describe modular functionality that allow the extension of the root data model on a device (under Device.Services.) to provide particular services, such as a voice service, set top box service, network attached storage, etc.

Each data model is defined by a Name:Version syntax. A device defines its data model by defining a device type, an XML document that maps to (imports) BBF official data model objects and/or vendor specific objects. A full explanation of how to develop compliant CWMP data models can be found in TR-154.

Note: All the files below are directly reachable via: https://www.broadband-forum.org/cwmp/<filename>.

Use the CWMP data model files to define and implement what exists in your solution’s Supported Data Model. This will help the ACS to learn what your CPE is capable of. The data models will also describe how your CPE’s Instantiated Data Model will behave during operation.

These data models are the basis for the Broadband Forum’s data models for the User Services Platform (USP).

The source files used to build the complete CWMP data model can be found on GitHub.

A ZIP file containing all the latest data models can be downloaded from here.


  1. Early versions of the CWMP data model defined two root data models, InternetGatewayDevice and Device. Version 2 of the Device root data model (Device:2) deprecates InternetGatewayDevice and Device:1 in favor of a single root data model.