2026-06-01: TR-181 Issue 2 Amendment 21

Data Model

• Added a CipherList parameter to configure permissible TLS Ciphers
• Added a few more datatypes, sensors and controls to IoT datamodel
• Added AFC Support to native Wi-Fi datamodel
• Added AllowedChannels parameter to Wi-Fi configuration
• Added Boot timing information
• Added certificate and repository provisioning support to Software Modules
• Added command and extended datamodel to support device shutdown
• Added ContentType and ResponseTopic parameters to MQTT Publish() command
• Added CountryCode and DeviceStatus parameters to DeviceInfo
• Added datamodel support for device hardware buttons
• Added Description parameter to network interfaces to allow user-friendly labelling
• Added DNS resolver statistics and resolving strategy configuration
• Added ForceSolicitPolicy parameter to DHCPv6
• Added InterruptRate parameter
• Added Kernel and Process fault information
• Added LastChange parameter to IPv6 RA
• Added MLD and IGMP enablement parameters to Bridge
• Added more commands to handle TLS certificates on the device
• Added more modes to STP configuration
• Added more TLS certificate components for easier reuse
• Added MQTT broker security configuration
• Added network hardware offloading support
• Added NetworkDiagnostic() command to Thread
• Added OnMessage! event to MQTT datamodel
• Added parameter to show available RAM
• Added RegisterTrustPaths parameter to limit which datamodel paths can be registered
• Added signature verification support to Software Modules
• Added solicitation timing parameters to Neighbor Discovery
• Added Status to the DHCPv4 lease information
• Added support for stopping QoS classification rules
• Added support for a list of known SFPs and the ability to disable certain modules
• Added support for controlled LEDs
• Added support for enforced DHCP options
• Added support for IPv6 Network Prefix Translation
• Added support for multiple MQTT Broker processes
• Added support for Software Modules managed locally on the device
• Added support for TUN/TAP interface configuration
• Added support for user HomeDirectory
• Added timestamp for last firmware release and update
• Clarified and harmonized some descriptions in Software Modules
• Clarified use of STA parameters in Data Elements
• Expanded the IEEE1905 data model
• Expanded interface Upstream parameter description with more examples
• Expanded IPSec IKEv2 configuration
• Extended Syslog datamodel with support for Unix domain sockets
• Improved and reworked the IPLayerCapacity test datamodel
• Moved AggregateScanDuration and ScanType to ChannelScan object
• Removed inappropriate character size limitations from lists
• Restructured Device.NeighborDiscovery object
• Unified country code parameters to be always exactly 2 uppercase characters
• Updated MoCA ACA Status with proper enumeration values and descriptions

TR-181 Document

• Added log rotate ToO
• Added MQTT ToO
• Added certificate management ToO

2025-12-01: TR-181 Issue 2 Amendment 20 Corrigendum 1

Data Model

• Fixed Cellular APN type to be compatible with the 5G Data Network Name
• Changed Cellular SIM Location parameter to be read-only
• Added additional bibrefs to PON power safe parameter
• Changed TrustedElement PIN from being a string with maximum size 4 to be a digit-only string with a size between 4 to 8
• Changed TrustedElement Status parameter to be read-only

TR-181 Document

• No changes

2025-11-11: TR-181 Issue 2 Amendment 20

Data Model

• Added support for periodic file uploads via Device.PeriodicFileTransfer.
• Added support for hardware specific information under Device.Hardware.
• Added support for configuring device internal connection monitoring mechanisms and automatic remedies under Device.ConnectionMonitoring.
• Various features allow to specify a Certificate and a CABundle for mutual TLS authentication
• Added support for low and high temperature events in Device.DeviceInfo.TemperatureStatus.TemperatureSensor.{i}.
• Added support for the Wi-Fi Data Elements feature "Wi-Fi Configuration Templates" under Device.WiFi.Templates.
• Added Device.DeviceInfo.Reboots.CurrentBootCycle
• Added peripheral power management for
  • Ethernet to Device.Ethernet.Interface.{i}.
  • USB to Device.USB.Port.{i}.
  • Wi-Fi to Device.WiFi.Radio.{i}.
  • Thread to Device.Thread.Radio.{i}.
  • XPON to Device.XPON.ONU.{i}.PowerManagement.
• Added USB device state reporting and the ability to configure which USB devices are allowed to connect via the Device.USB.USBHosts.AllowedDevice.{i}. table
• Added Type and Interface parameters to Device.HomePlug.Interface.{i}.
• Marked Wi-Fi commands FullScan(), ChannelScan(), Disassociate(), and BTMRequest() obsoleted
• Added antenna configuration to Device.WiFi.Radio.{i}.
• Added a full WireGuard VPN datamodel under Device.WireGuard.
• Added Device.WiFi.Radio.{i}.Capabilities. tree
• Added MTU parameter to Device.WiFi.SSID.{i}.
• Added IPLayerCapacityIncrementalResult! event to Device.IP.Diagnostics.
• Improved Device.Routing.Router.{i}. support and added Device.Routing.Policy.{i}.
• Added host table cleanup support to Device.Hosts.
• Added Device.DNS.RebindProtection.
• Added Release() command to Device.DHCPv4.Client.{i}. and Device.DHCPv6.Client.{i}.
• Added the configuration of the UPnP IGD service via Device.UPnP.Device.IGD.
• Added FloodLimit and BurstLimit parameters to Device.Firewall.Chain.{i}.Rule.{i}.
• Added support for GetCertificateURI() under Device.Security.Certificate.{i}.
• Added Role configuration to Device.SoftwareModules.ExecutionUnit.{i}.
• Added authentication to UDS MTP via Device.UnixDomainSockets.Authentication.{i}.
• Added interface stack and IP address support to Device.SessionManagement.Session.{i}.
• Added support for Device.IoTCapability.{i}.PulseControl. and Device.IoTCapability.{i}.Binding.{i}.
• Improved descriptions of some parameters with ranged types
• Added support for setting the transport mode in the MQTT Broker configuration
• Miscellaneous spelling corrections and markup improvements

TR-181 Document

• Recreate session management SVG images to match current state

2025-04-23: TR-181 Issue 2 Amendment 19 Corrigendum 1

Data Model

• Fix the order of some datamodel objects in the rendered HTML
• Explain permissions behaviour for Get messages
• Add missing spec attributes, messing up the diffs from future versions

TR-181 Document

• Re-export some SVG images to address rendering artefacts from invalid data
• Adjust the data model paths in the examples to match the recent data model changes

2025-04-10: TR-181 Issue 2 Amendment 19

TR-181 Document

• Improved firewall configuration appendix
• Introduced new 3GPP NAS Theory of Operation appendix
• Deprecated 5G Theory of Operation appendix in favor of the new appendix

Data Model

• Included LinkReadWrite component instead of Link component on all networking interfaces and automatically create most of the Parameters
• Added support for Cellular short message service
• Revamped Device.Cellular.Interface.
• Made previously USP-only Device.CollectionDevice. available to CWMP
• Added note about limited abilities of Device.SoftwareModules. in CWMP
• Addressed some versioning issues in the CWMP specific datamodel
• Added ability to rotate KernelFault and ProcessFault entries
• Added more features to DHCP configuration and Stats for DHCP use
• Added logging support for Firewall in Device.Firewall.Log.{i}.
• Added BlobSensor to IoT
• Added the latest IPLayerCapacity diagnostics features, including authentication, better status and results
• Added more LED control parameters
• Added ALPN support to MQTT
• Added SFP support via Device.SFPs.
• Added SFP support to Device.Optical.Interface.{i}.
• Deprecated Device.PDU.
• Added new 3GPP mobile network session management support via Device.SessionManagement.
• Added Radius security via Device.RadSecProxy.
• Added TLS support to SysLog
• Added support for the Thread protocol via Device.Thread.
• Added support for trusted elements (e.g. mobile SIM) via Device.TrustedElements.
• Added support for Wi-Fi DataElements r4
• Added support for Ethernet advertised link modes
• Changed writeOnceReadOnly Parameters to readOnly in CWMP
• Added support for power monitoring via Device.DeviceInfo.PowerStatus.
• Added selection of IPv4/IPv6 mode to NTP client
• Added new permission system for USP services
• Revamped Bitrate parameters into a component
• Revamped IPVersion parameters into a component
• Revamped DHCP client configuration into components
• Added some missing units to IoT
• Revamped client certificates into a component
• Added support for CA bundles in Device.Security.CABundle.{i}.
• Refactored Device.SoftwareModules. into its own file
• Added Privileged parameter to Device.SoftwareModules.ExecutionUnit.{i}.
• Added Device.Thread.MLE.{i}.AssociatedNode.{i}.Neighbor.{i}.
• Added RegisterTrustPaths parameter in InstallDU() and Update() commands and Device.USPServices.Trust.{i}.

2024-09-04: TR-181 Issue 2 Amendment 18 Corrigendum 1

Data Model

• Fixed newly introduced parameter name from IPv6PassTroughICMPEchoRequest to IPv6PassThroughICMPEchoRequest
• Replaced manual Alias definition by use of component
• Fixed invalid syntax in description of Device.DNS.Client.Server.{i}.Type

2024-07-23: TR-181 Issue 2 Amendment 18

TR-181 Document

• Fixed logical interface table
• Added ToO chapter about network interface MTU
• Manually resized diagrams to look nice
• Updated all generated diagrams

Data Model

• Added more counter types to IoT
• Improved MoCA network state parameter descriptions
• Added new parameter to support VLAN priority
• Added new parameter to indicate the used Ethernet duplex mode
• Improved example Ethernet PHY types by using more commonly used types
• Added new parameter to control the sending of ARP messages on an Ethernet link
• Corrected access type of multiple parameters
• Added new parameters for IP based access control in HTTP access
• Added new parameter to configure the MTU on an Ethernet link
• Added new parameter to link a USPService to an ExecutionUnit providing it
• Extended size of various QoS parameter types from 32 bits to 64 bits types
• Added new parameter to control filtering of ICMPv6 packets
• Changed one more missed parameter from hidden to secured
• Added new parameters to control DHCP retransmission/retry behavior
• Removed some dmr:fixedObject attributes from non-fixed objects
• Added Device.Schedules. mechanism to define time-based schedules for services to use
• Added new parameters indicate the reason for a device reboot
• Added new parameters to configure and check the Ethernet MDIX mode
• Deprecated a decent number of MultiAP commands and parameters due to being supported in DataElements
• Refactored many Interface and Link objects, parameters and commands into components for deduplication
• Refactored and improved the description of the NetworkConfig object
• Replaced outdated DHCPv6 bibref by latest RFC
• Added Reset() command to various interface stats objects
• Promoted some readOnly parameters to readWrite
• Added source and dest port ranges to more firewall objects
• Added success and failure counters to IEEE802.1x supplicant stats
• Added 3GPP-NAS auto configuration type to various enumerations
• Added RemainingLeastTime to port-mapping objects
• Demoted a few readWrite objects to readOnly since they were never meant to be the former
• Added histogram mode to PeriodicSampling mechanism
• Added more informational parameters and ShutdownDelay as well as user configuration to SMM DUs
• Added system capabilities configuration to Users
• Changed parameter type of some Wi-Fi timestamps from string to datetime
• Clarified the credentials allowed usages
• Added UUID, Version, and ExecEnvRef as output arguments to the InstallDU() command
• Adjusted indentation to fix rendering issues
• Added missing Alias keys throughout the data model
• Removed some inappropriate dmr:noUniqueKeys annotations

2024-01-18: TR-181 Issue 2 Amendment 17

TR-181 Document

• Refreshed some data model diagrams

Data Model

• Added new parameters for Multi-flow and Multi-server testing
  capability as defined in TR-471 Issue 4
• Updated MoCA data model with MoCA Alliance 2.5 specification
• Added Device.DNS.SD.Advertise object to to allow the configuration of
  DNS-SD services that need to be advertised by the device
• Added RDNSS and DNSSL options to the Device.RouterAdvertisement.InterfaceSetting.{i}. object
• Added missing parameters from the Data Elements R2.1 specification
• Added the Zone file concept to the Device.DNS. object
• Added DNS caching configurability to the Device.DNS.Relay. object, allowing for control
  over the cache settings, added a mechanism to allow the specification of the ingress (LAN side) interface(s)
  to be used by the DNS forwarders
• Added new InterfaceSetting object to Device.Firewall.
• Added ModuleVersion parameter to InstallDU() and Update() commands
• Added Origin parameter to PinHole, PortMapping and AccesssControl
• Added PhysAddresMask parameter to AccessControl
• Added LeaseDuration and RemainLeaseTime parameters to the DMZ and Pinhole objects
• Added Device.Firewall.ConnectionTracking. object tree to configure ALGs
• Added missing DSL xTU-C and xTU-R parameters to DSL objects
• Added Device.Syslog. object tree to configure a syslog service
• Added Support for password authentication in xPON
• Added MaxNumberOfPortMappings and MaxNumberOfPortTriggers parameters to indicate system limits
• Fixed the access of some UserInterface parameters and objects: Demoted Session and User to read-only, promoted Protocol to read-write
• Fixed the access of a SSH parameter: Promoted AutoDisableDuration to read-write
• Fixed the access of a USPServices parameter: Demoted Protocol to read-only
• Added UDSAgent:1 and UDSController:1 profiles
• Added Device.DeviceInfo.LogRotate.{i}. to setup a log rotation mechanism
• Clarified descriptions of parameters in Device.SoftwareModules.ExecutionUnit.{i}.AutoRestart.
• Added initial support for the 802.11be Wi-Fi 7 standard/mode in various places
• Added OnBoardingComplete parameter to Device.LocalAgent.Controller.{i}.
• Clarified suggested implementation of Device.PeriodicStatistics. concept
• Added support for passing environment variables to software modules
• Removed reference to an incorrect default port requirement from TR-471
• Added EEEStatus parameter to Device.Ethernet.Interface.{i}.
• Extended the key of Device.LocalAgent.Monitor.{i}.OnChange! ChangeSet.{i}.Parameter.{i}. output argument to include ChangeTime
• Added objects and parameters to align with the work-in-progress DataElements R3 specification
• Refactored scheduling related parameters into component for easier reuse and added Active and TimeLeft parameters
• Added Device.SoftwareModules.ExecutionUnit.{i}.NetworkConfig. object and parameters
• Added MaxSupportedDataDownlinkRate, MaxSupportedDataUplinkRate, SNR, and MaxSupportedBandwidth parameters to Device.WiFi.AccessPoint.{i}.AssociatedDevice.{i}.
• Replaced custom coded Order parameter type and descriptions with the new Order datatype and text template
• Changed the default WebSocket port from 5683 to 8443
• Added support for checksum reporting to TransferComplete! event

2023-06-14: TR-181 Issue 2 Amendment 16

TR-181 Document

• Refreshed all diagrams
• Added ToO appendix for logical interfaces concept
• Extended advanced firewall appendix
• Updated Wi-Fi theory of operation

Data Model

• Added Device.LocalAgent.Subscription.{i}.TriggerAction parameter to
  control the notification behavior
• Added SecuredRoles concept to the USP-specific ControllerTrust
• Turned a number of "hidden" parameters into "secured" parameters to
  allow USP Controllers with a secure role to read parameter values
• Added a few parameters to Device.Bridging.Bridge. and sub-objects to
  allow better control over bridges and STP behavior
• Made unique key type (functional vs non-functional) explicit rather
  than defaulting, and fixed incorrect choices
• Added ability to configure exclusions from BulkData reports
• Added Device.DeviceInfo.HostName parameter
• Unified description of Interface parameters
• Updated status according to our deprecation policy
• Extended some incorrect type restrictions
• Fixed/unified some units and their use in the description
• Added SupportedLinkModes parameter to ethernet interfaces
• Clarified the Device.Firewall. object and added support for
  firewall features DMZ, Services, Pinholing and Policies. Also added
  support for additional classifiers
• Introduced Device.GatewayInfo. into USP
• Extended the type of a few counters from unsignedInt to StatsCounter64
• Added new IPLayerCapacityDiagnostic parameters/arguments from the
  TR-471i3 document
• Added UDS (Unix Domain Socket) MTP and Device.UnixDomainSockets. objects
  for internal services
• Added Device.Logical. sub-tree to allow for definition of logical network
  interfaces
• Added Device.NAT.PortTrigger.
• Added USP notification mechanism to Device.PeriodicStatistics.
• Improved PPP LCPEcho description and added LCPEchoAdaptive parameter
• Vastly extended Device.QoS. features by adding Queues, Shapers and Schedulers
• Added new parameters to Device.Routing. and sub-objects to add more routing
  features
• Vastly extended SMM (Software Module Management) capabilities with support for
  ApplicationData, HostObject, ExecEnvClass and AutoRestart
• Added Device.SSH. to configure an SSH service
• Extended Device.Time. with support for NTP client and server configuration
• Added Device.UserInterface.HTTPAccess. to allow for local UI access control
• Added USP-specific Device.LocalAgent.Monitor. object to allow for efficient
  tracking of parameter value changes
• Added support for Device.USPServices. to manage internal services via USP
• Added Device.XPON. to model xPON interfaces
• Applied cleanup for Wi-Fi objects/parameters to line up with Wi-Fi Alliance
  documents
• Removed activeNotify="canDeny" attributes from some parameters
• Added PeriodicStatsAdv:2 and MQTTController:2 profiles
• Added USPServiceRef parameters to MTP referencing a service using it
• Disambiguated NTP vs. SNTP protocols
• Expanded/unified descriptions of parameters used for retries

2022-01-27: TR-181 Issue 2 Amendment 15

• Converted the document to markdown and extended the Wi-Fi Theory of Operation
• Split the XML into multiple smaller files (this is just housekeeping; it
  doesn't affect how the model is used)
• Added Device.USPAgent to the CWMP model to allow a CWMP ACS to configure a
  device for USP communications
• Allowed USP to access the EnableCWMP parameter (so a USP Controller can
  enable/disable CWMP access)
• Added Device.Routing.Babel for the RFC 8966 Babel routing protocol
• Added Device.DOCSIS for modeling DOCSIS 3.0 and 3.1 interfaces
• Added Device.Users.Group, Device.Users.Role and Device.Users.SupportedShell
  tables for modeling system users
• Improved the Wi-Fi data model by adding Data Elements R2 parameters,
  commands and events, moving MultiAP parameters and commands into the Data
  Elements structure, and by deprecating AIFSN, ECWMin, ECWMax and TxOpMax
• Clarified the LockoutPeriod and Retries ControllerTrust parameters that
  impact how the RequestChallenge() and ChallengeResponse() data model
  commands handle failed attempts
• Clarified bulk data profile, threshold and periodic statistics USP
  Controller permissions: only the USP Controller that created the profile
  will receive the corresponding events
• Added a bulk data profile ForceCollection() command
• Added support for a new bulk data collection mechanism that utilizes MQTT
  as the transport protocol
• Removed old bulk data collection protocols (Streaming and File) from the USP
  data model (they don't apply to USP)
• Updated the IPLayerCapacity() test to support TR-472 Issue 2
• Added an enumeration to indicate when a Boot! event was due to a factory
  reset
• Added an enumeration to distinguish encrypted and unencrypted USP MQTT
  WebSocket connections
• Added an Order parameter to provide guidance to USP Agents on which MTP to
  use when communicating with a Controller
• Clarified that Device.Optical is intended for generic optical interfaces
  and is not intended to model anything specific to IEEE or ITU-T PON
  technologies (objects specific to such technologies may be added in future
  versions of the data model)
• Clarified the meaning and usage of the Device.Ethernet.Interface and
  Device.Ethernet.Link objects (also allowed the Ethernet Link MACAddress
  parameter to be written)
• Improved (and made more consistent) the marking of (and explanation of)
  deprecated items, and how such items should progress from being deprecated
  to obsoleted to deleted
• Added a Baseline:4 profile that doesn't include Device.LANConfigSecurity
  (it relates to the now-deprecated TR-064 LAN management protocol)
• Many minor improvements to object, parameter, command and event descriptions
• Replaced the non-standard dmr:version attribute with the version attribute
  (which supports three levels of version)
• Switched to DMR (data model report) schema v1.0, which supports multi-line
  paragraphs, and wrapped all lines to 80 characters maximum