TR-069 Device:1.2 and InternetGatewayDevice:1.3 Root Object definitiontr-143-1-0-2.xml |
|||
DATA MODEL DEFINITION |
License
Copyright (c) 2008-2017, Broadband Forum
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
- Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
- Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
- Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The above license is used as a license under copyright only. Please reference the Forum IPR Policy for patent licensing terms https://www.broadband-forum.org/ipr-policy.
Any moral rights which are necessary to exercise under the above license grant are also deemed granted under this license.
Data Types
The Parameters defined in this specification make use of a limited subset of the default SOAP data types [SOAP1.1]. These data types and the named data types used by this specification are described below.
Note: A Parameter that is defined to be one of the named data types is reported as such at the beginning of the Parameter’s description via a reference back to the associated data type definition (e.g. [MACAddress]). However, such parameters still indicate their SOAP data types.
Data Type | Base Type | Description |
---|---|---|
boolean | - | Boolean, where the allowed values are 0 or 1 (or equivalently, true or false). |
dateTime | - | The subset of the ISO 8601 date-time format defined by the SOAP dateTime type [SOAP1.1]. |
string | - | For strings, a minimum and maximum allowed length can be indicated using the form string(Min:Max), where Min and Max are the minimum and maximum string length in characters. If either Min or Max are missing, this indicates no limit, and if Min is missing the colon can also be omitted, as in string(Max). Multiple comma-separated ranges can be specified, in which case the string length will be in one of the ranges. |
unsignedInt | - | Unsigned integer in the range 0 to 4294967295, inclusive. For some unsignedInt types, a value range is given using the form unsignedInt(Min:Max) or unsigned(Min:Max step Step), where the Min and Max values are inclusive. If either Min or Max are missing, this indicates no limit. If Step is missing, this indicates a step of 1. Multiple comma-separated ranges can be specified, in which case the value will be in one of the ranges. |
IPAddress | string(:45) | IP address, i.e. IPv4 address (or IPv4 subnet mask) or IPv6 address. All IPv4 addresses and subnet masks MUST be represented as strings in IPv4 dotted-decimal notation. Here are some examples of valid IPv4 address textual representations:
All IPv6 addresses MUST be represented using any of the 3 standard textual representations defined in [RFC4291] Sections 2.2.1, 2.2.2 and 2.2.3. Both lower-case and upper-case letters can be used, but use of lower-case letters is RECOMMENDED. Here are some examples of valid IPv6 address textual representations:
IPv6 addresses MUST NOT include zone identifiers. Zone identifiers are discussed in [Section 6/RFC4007]. Unspecified or inapplicable addresses (or IPv4 subnet masks) MUST be represented as empty strings unless otherwise specified by the parameter definition. |
References
[IANA-uri-schemes] | IANA Uniform Resource Identifier (URI) Schemes Registry, Uniform Resource Identifier (URI) Schemes, IANA. |
[IEEE_EUI64] | Guidelines for 64-bit Global Identifier (EUI-64) Registration Authority, Guidelines for 64-bit Global Identifier (EUI-64) Registration Authority, IEEE, March 1997. |
[RFC2616] | RFC 2616, Hypertext Transfer Protocol - HTTP/1.1, IETF, 1999. |
[RFC3986] | RFC 3986, Uniform Resource Identifier (URI): Generic Syntax, IETF. |
[RFC4007] | RFC 4007, IPv6 Scoped Address Architecture, IETF. |
[RFC4122] | RFC 4122, A Universally Unique IDentifier (UUID) URN Namespace, IETF, 2005. |
[RFC4291] | RFC 4291, IP Version 6 Addressing Architecture, IETF, 2006. |
[RFC4632] | RFC 4632, Classless Inter-domain Routing (CIDR): The Internet Address Assignment and Aggregation Plan, IETF, 2006. |
[RFC7159] | RFC7159, The JavaScript Object Notation (JSON) Data Interchange Format, IETF, March 2014. |
[RFC7230] | RFC 7230, Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing, IETF, June 2014. |
[RFC7252] | RFC 7252, The Constrained Application Protocol (CoAP), IETF, June 2014. |
[RFC8141] | RFC 8141, Uniform Resource Names (URNs), IETF, April 2017. |
[RFC862] | RFC 862, Echo Protocol, IETF, 1983. |
[RFC959] | RFC 959, File Transfer Protocol, IETF, 1985. |
[SOAP1.1] | Simple Object Access Protocol (SOAP) 1.1, W3C. |
[TR-069] | TR-069 Amendment 6, CPE WAN Management Protocol, Broadband Forum, April 2018. |
[TR-143] | TR-143 Amendment 1 Corrigendum 1, Enabling Network Throughput Performance Tests and Statistical Monitoring, Broadband Forum, August 2015. |
[ZigBee2007] | ZigBee 2007 Specification, ZigBee 2007 Specification, ZigBee Alliance, October 2007. |
Legend
Object definition. |
Parameter definition. |
TR-143:1.0 Data Model
For a given implementation of this data model, the Agent MUST indicate support for the highest version number of any object or parameter that it supports. For example, even if the Agent supports only a single parameter that was introduced in version 1.4, then it will indicate support for version 1.4. The version number associated with each object and parameter is shown in the Version column.
Name | Type | Write | Description | Object Default | Version |
---|---|---|---|---|---|
Capabilities. | object | R | The capabilities of the device. This is a constant read-only object, meaning that only a firmware upgrade will cause these values to be altered. | - | 1.0 |
Capabilities.PerformanceDiagnostic. | object | R | The capabilities of the Performance Diagnostics (DownloadDiagnostics and UploadDiagnostics) for the device. | - | 1.0 |
DownloadTransports | string[] | R | Comma-separated list of strings. Supported DownloadDiagnostics transport protocols for a CPE device. Each list item is an enumeration of:
|
- | 1.0 |
UploadTransports | string[] | R | Comma-separated list of strings. Supported UploadDiagnostics transport protocols for a CPE device. Each list item is an enumeration of:
|
- | 1.0 |
DownloadDiagnostics. | object | R | This object defines the diagnostics configuration for a HTTP and FTP DownloadDiagnostics Test. Files received in the DownloadDiagnostics do not require file storage on the CPE device. | - | 1.0 |
DiagnosticsState | string | W | Indicate the availability of diagnostic data. Enumeration of:
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
Interface | string(:256) | W | The value MUST be the Path Name of the IP-layer interface over which the test is to be performed. The value of this parameter MUST be either a valid interface or an empty string. An attempt to set this parameter to a different value MUST be rejected as an invalid parameter value. If an empty string is specified, the CPE MUST use the default routing interface. | - | 1.0 |
DownloadURL | string(:256) | W | The URL, as defined in [RFC3986], for the CPE to perform the download on. This parameter MUST be in the form of a valid HTTP [RFC2616] or FTP [RFC959] URL.
|
- | 1.0 |
DownloadTransports | string[] | R | Comma-separated list of strings. Supported DownloadDiagnostics transport protocols for a CPE device. Each list item is an enumeration of:
|
- | 1.0 |
DSCP | unsignedInt(0:63) | W | The DiffServ code point for marking packets transmitted in the test. The default value SHOULD be zero. | - | 1.0 |
EthernetPriority | unsignedInt(0:7) | W | Ethernet priority code for marking packets transmitted in the test (if applicable). The default value SHOULD be zero. | - | 1.0 |
ROMTime | dateTime | R | Request time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
BOMTime | dateTime | R | Begin of transmission time in UTC, which MUST be specified to microsecond precision For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
EOMTime | dateTime | R | End of transmission in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TestBytesReceived | unsignedInt | R | The test traffic received in bytes during the FTP/HTTP transaction including FTP/HTTP headers, between BOMTime and EOMTime, Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TotalBytesReceived | unsignedInt | R | The total number of bytes received on the Interface between BOMTime and EOMTime. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TCPOpenRequestTime | dateTime | R | Request time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TCPOpenResponseTime | dateTime | R | Response time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
UploadDiagnostics. | object | R | This object defines the diagnostics configuration for a HTTP or FTP UploadDiagnostics test. Files sent by the UploadDiagnostics do not require file storage on the CPE device, and MAY be an arbitrary stream of bytes. | - | 1.0 |
DiagnosticsState | string | W | Indicate the availability of diagnostic data. Enumeration of:
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
Interface | string(:256) | W | The value MUST be the Path Name of the IP-layer interface over which the test is to be performed. The value of this parameter MUST be either a valid interface or an empty string. An attempt to set this parameter to a different value MUST be rejected as an invalid parameter value. If an empty string is specified, the CPE MUST use the default routing interface. | - | 1.0 |
UploadURL | string(:256) | W | The URL, as defined in [RFC3986], for the CPE to Upload to. This parameter MUST be in the form of a valid HTTP [RFC2616] or FTP [RFC959] URL.
|
- | 1.0 |
UploadTransports | string[] | R | Comma-separated list of strings. Supported UploadDiagnostics transport protocols for a CPE device. Each list item is an enumeration of:
|
- | 1.0 |
DSCP | unsignedInt(0:63) | W | DiffServ code point for marking packets transmitted in the test. The default value SHOULD be zero. | - | 1.0 |
EthernetPriority | unsignedInt(0:7) | W | Ethernet priority code for marking packets transmitted in the test (if applicable). The default value SHOULD be zero. | - | 1.0 |
TestFileLength | unsignedInt | W | The size of the file (in bytes) to be uploaded to the server. The CPE MUST insure the appropriate number of bytes are sent. | - | 1.0 |
ROMTime | dateTime | R | Request time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
BOMTime | dateTime | R | Begin of transmission time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
EOMTime | dateTime | R | End of transmission in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TotalBytesSent | unsignedInt | R | The total number of bytes sent on the Interface between BOMTime and EOMTime. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TCPOpenRequestTime | dateTime | R | Request time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TCPOpenResponseTime | dateTime | R | Response time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456
Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
UDPEchoConfig. | object | R | This object allows the CPE to be configured to perform the UDP Echo Service defined in [RFC862] and UDP Echo Plus Service defined in [Appendix A.1/TR-143]. | - | 1.0 |
Enable | boolean | W | MUST be enabled to receive UDP echo. When enabled from a disabled state all related timestamps, statistics and UDP Echo Plus counters are cleared. | - | 1.0 |
Interface | string(:256) | W | The value MUST be the Path Name of IP-layer interface over which the CPE MUST listen and receive UDP echo requests on. The value of this parameter MUST be either a valid interface or an empty string. An attempt to set this parameter to a different value MUST be rejected as an invalid parameter value. If an empty string is specified, the CPE MUST listen and receive UDP echo requests on all interfaces. Note: Interfaces behind a NAT MAY require port forwarding rules configured in the Gateway to enable receiving the UDP packets. | - | 1.0 |
SourceIPAddress | string(:45) | W | [IPAddress] The Source IP address of the UDP echo packet. The CPE MUST only respond to a UDP echo from this source IP address. | - | 1.0 |
UDPPort | unsignedInt | W | The UDP port on which the UDP server MUST listen and respond to UDP echo requests. | - | 1.0 |
EchoPlusEnabled | boolean | W | If true the CPE will perform necessary packet processing for UDP Echo Plus packets. | - | 1.0 |
EchoPlusSupported | boolean | R | true if UDP Echo Plus is supported. | - | 1.0 |
PacketsReceived | unsignedInt | R | Incremented upon each valid UDP echo packet received. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
PacketsResponded | unsignedInt | R | Incremented for each UDP echo response sent. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
BytesReceived | unsignedInt | R | The number of UDP received bytes including payload and UDP header after the UDPEchoConfig is enabled. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
BytesResponded | unsignedInt | R | The number of UDP responded bytes, including payload and UDP header sent after the UDPEchoConfig is enabled. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TimeFirstPacketReceived | dateTime | R | Time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456, The time that the server receives the first UDP echo packet after the UDPEchoConfig is enabled. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
TimeLastPacketReceived | dateTime | R | Time in UTC, which MUST be specified to microsecond precision. For example: 2008-04-09T15:01:05.123456 The time that the server receives the most recent UDP echo packet. Active Notification requests for this parameter MAY be denied. |
- | 1.0 |
Inform and Notification Requirements
Parameters for which Active Notification MAY be Denied
Profile Definitions
Notation
The following abbreviations are used to specify profile requirements:
Abbreviation | Description |
---|---|
R | Read support is REQUIRED. |
W | Both Read and Write support is REQUIRED. This MUST NOT be specified for a parameter that is defined as read-only. |
P | The object is REQUIRED to be present. |
C | Creation and deletion of instances of the object is REQUIRED. |
A | Creation of instances of the object is REQUIRED, but deletion is not REQUIRED. |
D | Deletion of instances of the object is REQUIRED, but creation is not REQUIRED. |
Download:1 Profile
This table defines the Download:1 profile for the TR-143:1 data model. The minimum REQUIRED version for this profile is TR-143:1.0.
Name | Requirement |
---|---|
Capabilities.PerformanceDiagnostic. | P1 |
DownloadTransports | R2 |
DownloadDiagnostics. | P |
DiagnosticsState | W |
Interface | W |
DownloadURL | W |
DSCP | W |
EthernetPriority | W |
ROMTime | R |
BOMTime | R |
EOMTime | R |
TestBytesReceived | R |
TotalBytesReceived | R |
DownloadTransports | R |
1 This object is DELETED.
2 This parameter is DELETED.
DownloadTCP:1 Profile
This table defines the DownloadTCP:1 profile for the TR-143:1 data model. The minimum REQUIRED version for this profile is TR-143:1.0.
Name | Requirement |
---|---|
DownloadDiagnostics. | P |
TCPOpenRequestTime | R |
TCPOpenResponseTime | R |
Upload:1 Profile
This table defines the Upload:1 profile for the TR-143:1 data model. The minimum REQUIRED version for this profile is TR-143:1.0.
Name | Requirement |
---|---|
Capabilities.PerformanceDiagnostic. | P1 |
UploadTransports | R2 |
UploadDiagnostics. | P |
DiagnosticsState | W |
Interface | W |
UploadURL | W |
DSCP | W |
EthernetPriority | W |
ROMTime | R |
BOMTime | R |
EOMTime | R |
TestFileLength | R |
TotalBytesSent | R |
UploadTransports | R |
1 This object is DELETED.
2 This parameter is DELETED.
UploadTCP:1 Profile
This table defines the UploadTCP:1 profile for the TR-143:1 data model. The minimum REQUIRED version for this profile is TR-143:1.0.
Name | Requirement |
---|---|
UploadDiagnostics. | P |
TCPOpenRequestTime | R |
TCPOpenResponseTime | R |
UDPEcho:1 Profile
This table defines the UDPEcho:1 profile for the TR-143:1 data model. The minimum REQUIRED version for this profile is TR-143:1.0.
Name | Requirement |
---|---|
UDPEchoConfig. | P |
Enable | W |
Interface | W |
SourceIPAddress | W |
UDPPort | W |
PacketsReceived | R |
PacketsResponded | R |
BytesReceived | R |
BytesResponded | R |
TimeFirstPacketReceived | R |
TimeLastPacketReceived | R |
EchoPlusSupported | R |
UDPEchoPlus:1 Profile
This table defines the UDPEchoPlus:1 profile for the TR-143:1 data model. The minimum REQUIRED version for this profile is TR-143:1.0.
Name | Requirement |
---|---|
UDPEchoConfig. | P |
EchoPlusEnabled | W |
Generated by Broadband Forum bbfreport v2.2.0 (2024-07-23 version) on 2024-09-04 at 10:47:42 UTC.
report.py –filter model=None –output