USP Device:2.15 Root Object definition (changes)tr-181-2-15-0-usp.xml |
|||
DATA MODEL DEFINITION |
License
Copyright (c) 2010-2022, Broadband Forum
The undersigned members have elected to grant the copyright to
their contributed material used in this software:
Copyright (c) 2017-2019, 2021 ARRIS Enterprises, LLC.
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 |
---|---|---|
base64 | - | Base64 encoded binary (no line-length limitation). A minimum and maximum allowed length can be indicated using the form base64(Min:Max), where Min and Max are the minimum and maximum length in characters before Base64 encoding. If either Min or Max are missing, this indicates no limit, and if Min is missing the colon can also be omitted, as in base64(Max). Multiple comma-separate ranges can be specified, in which case the length MUST be in one of the ranges. |
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]. |
decimal | - | Decimal number, with optional sign and optional fractional part. For some decimal types, a value range is given using the form decimal(Min:Max) or decimal(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.0. Multiple comma-separated ranges can be specified, in which case the value will be in one of the ranges. |
hexBinary | - | Hex encoded binary. A minimum and maximum allowed length can be indicated using the form hexBinary(Min:Max), where Min and Max are the minimum and maximum length in characters before Hex Binary encoding. If either Min or Max are missing, this indicates no limit, and if Min is missing the colon can also be omitted, as in hexBinary(Max). Multiple comma-separated ranges can be specified, in which case the length MUST be in one of the ranges. |
int | - | Integer in the range -2147483648 to +2147483647, inclusive. For some int types, a value range is given using the form int(Min:Max) or int(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. |
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. |
unsignedLong | - | Unsigned long integer in the range 0 to 18446744073709551615, inclusive. For some unsignedLong types, a value range is given using the form unsignedLong(Min:Max) or unsignedLong(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. |
Alias | string(:64) | A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
|
AmplitudeData | hexBinary(0,2:4116) | This data type represents a sequence of spectral amplitudes. Each spectral amplitude value corresponds to a bin. The format of the bin measurement is as follows. Sequence of: 4 bytes: ChCenterFreq The center frequency of the upstream channel. 4 bytes: FreqSpan The width in Hz of the band across which the spectral amplitudes characterizing the channel are measured. 4 bytes: NumberOfBins The number of data points or bins that compose the spectral data. The leftmost bin corresponds to the lower band edge, the rightmost bin corresponds to the upper band edge, and the middle bin center is aligned with the center frequency of the analysis span. 4 bytes: BinSpacing The frequency separation between adjacent bin centers. It is derived from the frequency span and the number of bins or data points. The bin spacing is computed as: BinSpacing = FrequencySpan/(NumberOfBins -1) The larger the number of bins the finer the resolution. 4 bytes: ResolutionBW The resolution bandwidth or equivalent noise bandwidth of each bin. If spectral windowing is used (based on vendor implementation), the bin spacing and resolution bandwidth would not generally be the same. n bytes: Amplitude (2 bytes * NumberOfBins) A sequence of two byte elements. Each element represents the spectral amplitudes in relation to the expected received signal power of a bin, in units of 0.01dB. That is, a test CMTS input signal with square-root raised-cosine spectrum, bandwidth equal to the expected received signal bandwidth, and power equal to the expected received signal power, which is present for the entire spectrum sampling period, will exhibit a spectrum measurement of 0 dB average power in each bin of the signal passband. Each bin element amplitude value format is 2’s complement which provides a range of -327.68 dB to 327.67 dB amplitude value for the bin measurement. |
CmRegState | string | This data type defines the CM connectivity state as reported by the CM. Enumeration of:
See [CM-SP-MULPIv3.0], Cable Modem - CMTS Interaction. |
Dbm1000 | int | The value is measured in dBm/1000, i.e. the value divided by 1000 is dB relative to 1 mW. For example, -12345 means -12.345 dBm, 0 means 0 dBm (1 mW) and 12345 means 12.345 dBm. |
DocsEqualizerData | hexBinary(0,36:260) | This data type represents the equalizer data as measured at the receiver interface. The format of the equalizer follows the structure of the Transmit Equalization Adjust RNG-RSP TLV of DOCSIS RFI v2.0. The equalizer coefficients are considered signed 16-bit integers in the range from -32768 (0x8000) to 32767 (0x7FFF). DOCSIS specifications require up to a maximum of 64 equalizer taps (n + m); therefore, this object size can be up to 260 bytes (4 + 4x64). The minimum object size (other than zero) for a t-spaced tap with a minimum of 8 symbols will be 36 (4 + 4x8). See [Figure 8-23/CM-SP-RFIv2.0]. |
DocsisUpstreamType | string | Indicates the DOCSIS Upstream Channel Type. Enumeration of:
|
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. |
IPPrefix | string(:49) | IPv4 or IPv6 routing prefix in Classless Inter-Domain Routing (CIDR) notation [RFC4632]. This is specified as an IP address followed by an appended “/n” suffix, where n (the prefix size) is an integer in the range 0-32 (for IPv4) or 0-128 (for IPv6) that indicates the number of (leftmost) ‘1’ bits of the routing prefix.
This notation can also represent individual addresses by specifying all bits.
If the IP address part is unspecified or inapplicable, it MUST be an empty string unless otherwise specified by the parameter definition. In this case the IP prefix will be of the form “/n”. If the entire IP prefix is unspecified or inapplicable, it MUST be an empty string unless otherwise specified by the parameter definition. |
IPv6Address | IPAddress(:45) | IPv6 address. Can be any IPv6 address that is permitted by the IPAddress data type. |
MACAddress | string(:17) | All MAC addresses are represented as strings of 12 hexadecimal digits (digits 0-9, letters A-F or a-f) displayed as six pairs of digits separated by colons. Unspecified or inapplicable MAC addresses MUST be represented as empty strings unless otherwise specified by the parameter definition. Possible patterns:
|
RangingState | string | This data type defines the CM ranging state as reported by the CMTS. The enumerated values associated with the RangingState are: Enumeration of:
See [CM-SP-MULPIv3.0], Cable Modem - CMTS Interaction. |
SpectrumAnalysisWindowFunction | string | This object controls the windowing function which will be used when performing the discrete Fourier transform for the analysis. Note that all window functions may not be supported by all devices. If an attempt is made to set the object to an unsupported window function, an error of inconsistentValue will be returned. Enumeration of:
|
StatsCounter32 | unsignedInt | A 32-bit statistics parameter, e.g. a byte counter. This data type SHOULD NOT be used for statistics parameters whose values might become greater than the maximum value that can be represented as an unsignedInt (i.e. 0xffffffff, referred to below as maxval). StatsCounter64 SHOULD be used for such parameters. The value maxval indicates that no data is available for this parameter. In the unlikely event that the actual value of the statistic is maxval, the CPE SHOULD return maxval - 1. The actual value of the statistic might be greater than maxval. Such values SHOULD wrap around through zero. The term packet is to be interpreted as the transmission unit appropriate to the protocol layer in question, e.g. an IP packet or an Ethernet frame. |
StatsCounter64 | unsignedLong | A 64-bit statistics parameter, e.g. a byte counter. This data type SHOULD be used for all statistics parameters whose values might become greater than the maximum value that can be represented as an unsignedInt. The maximum value that can be represented as an unsignedLong (i.e. 0xffffffffffffffff) indicates that no data is available for this parameter. The term packet is to be interpreted as the transmission unit appropriate to the protocol layer in question, e.g. an IP packet or an Ethernet frame. |
TLV8 | hexBinary(0,2:255) | This data type represents a single TLV encoding. This first octet represents the Type of the TLV. The second octet represents an unsigned 8-bit Length of the subsequent Value part of the TLV. The remaining octets represent the value. The Value could be an atomic value or a sequence of one or more sub-TLVs. See [CM-SP-MULPIv3.0], Common Radio Frequency Interface Encodings Annex. |
TenthdB | int | This data type represents power levels that are normally expressed in dB. Units are in tenths of a dB; for example, 5.1 dB will be represented as 51. |
TenthdBmV | int | This data type represents power levels that are normally expressed in dBmV. Units are in tenths of a dBmV; for example, 5.1 dBmV will be represented as 51. |
URL | URI(:2048) | Uniform Resource Locator. See [RFC3986] (URI), [IANA-uri-schemes], and individual URI scheme RFCs such as [RFC7252] (coap, coaps) and [RFC7230] (http, https). |
References
[3GPP-TS.23.501] | 3GPP TS 23.501, System architecture for the 5G System (5GS); Stage 2, 3GPP SA WG2. |
[3GPP-TS.24.301] | 3GPP TS 24.301, Non-Access-Stratum (NAS) protocol for Evolved Packet System (EPS); Stage 3, 3GPP CT WG1. |
[3GPP-TS.24.501] | 3GPP TS 24.501, Non-Access-Stratum (NAS) protocol for 5G System (5GS); Stage 3, 3GPP CT WG1. |
[802.11-2016] | IEEE Std 802.11-2016, Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications, IEEE, December 2016. |
[802.11-2020] | IEEE Std 802.11-2020, Wireless LAN Medium Access Control (MAC) and Physical Layer (PHY) Specifications, IEEE, December 2020. |
[802.11a-1999] | IEEE Std 802.11a-1999, High-speed Physical Layer in the 5 GHz band, IEEE, 1999. |
[802.11ac-2013] | IEEE Std 802.11ac-2013, Enhancements for Very High Throughput for Operation in Bands below 6 GHz, IEEE, December 2013. |
[802.11ax] | IEEE Std 802.11ax, Enhancements for High Efficiency WLAN, IEEE, May 2021. |
[802.11b-1999] | IEEE Std 802.11b-1999, Higher Speed Physical Layer Extension in the 2.4 GHz band, IEEE, 1999. |
[802.11g-2003] | IEEE Std 802.11g-2003, Further Higher Data Rate Extension in the 2.4 GHz Band, IEEE, 2003. |
[802.11k] | IEEE Std 802.11k, Radio Resource Measurement of Wireless LANs, IEEE, May 2008. |
[802.11n-2009] | IEEE Std 802.11n-2009, Amendment 5: Enhancements for Higher Throughput, IEEE, 2009. |
[802.1ad-2005] | IEEE Std 802.1ad-2005, Virtual Bridged Local Area Networks Amendment 4: Provider Bridges, IEEE, May 2005. |
[802.1D-2004] | IEEE Std 802.1D-2004, Media Access Control (MAC) Bridges, IEEE, 2004. |
[802.1Q-2005] | IEEE Std 802.1Q-2005, Virtual Bridged Local Area Networks, IEEE, 2006. |
[802.1Q-2011] | IEEE Std 802.1Q-2011, MAC Bridges and Virtual Bridge Local Area Networks, IEEE, 2011. |
[AMB] | Agile MultiBand Specification, Wi-Fi Agile MultiBand Specification, December 2018. |
[CM-SP-CM-OSSIv3.1] | CM-SP-CM-OSSIv3.1, Cable Modem Operations Support System Interface Specification, CableLabs, October 2020. |
[CM-SP-MULPIv3.0] | CM-SP-MULPIv3.0, DOCSIS 3.0 MAC and Upper Layer Protocols Interface Specification, CableLabs, December 2017. |
[CM-SP-OSSIv3.0] | CM-SP-OSSIv3.0, DOCSIS 3.0 Operations Support System Interface Specification, CableLabs, December 2017. |
[CM-SP-RFIv2.0] | CM-SP-RFIv2.0, Data-Over-Cable Service Interface Specifications: Radio Frequency Interface Specification, CableLabs, April 2009. |
[EasyConnect] | Wi-Fi Easy Connect Specification, Wi-Fi Easy Connect Specification, Wi-Fi Alliance, December 2020. |
[EasyMesh] | EasyMesh Specification, Wi-Fi EasyMesh Specification, Wi-Fi Alliance, December 2021. |
[G.988] | G.988, ONU management and control interface (OMCI) specification, ITU-T, 2010. |
[G.9954] | G.9954, Phoneline networking transceivers - Enhanced physical, media access, and link layer specifications (HPNA 3.0 and 3.1), ITU-T, 2007. |
[G.996.2] | G.996.2, Single-ended line testing for digital subscriber lines (DSL), ITU-T. |
[G.9960] | G.9960, Unified high-speed wire-line based home networking transceivers - System architecture and physical layer specification, ITU-T. |
[G.9961] | G.9961, Unified high-speed wire-line based home networking transceivers - Data link layer specification, ITU-T. |
[G.9964] | G.9964, Unified high-speed wire-line based home networking transceivers - Power spectral density specification, ITU-T. |
[G.997.1] | G.997.1, Physical layer management for digital subscriber line (DSL) transceivers, ITU-T. |
[G.998.1] | G.998.1, ATM-based Multi-Pair Bonding, ITU-T, 2005. |
[G.998.2] | G.998.2, Ethernet-based Multi-Pair Bonding, ITU-T, 2005. |
[G.998.3] | G.998.3, Multi-Pair Bonding Using Time-Division Inverse Multiplexing, ITU-T, 2005. |
[HPAV1.1] | HomePlug™ AV Specification, Version 1.1, HomePlug Alliance, 2007. |
[IANA-uri-schemes] | IANA Uniform Resource Identifier (URI) Schemes Registry, Uniform Resource Identifier (URI) Schemes, IANA. |
[ICSA-Baseline] | ICSA Baseline Modular Firewall Certification Criteria, Baseline module - version 4.1, ICSA Labs, 2008. |
[IEEE1905.1a] | IEEE 1905.1a, IEEE Std 1905.1a, Convergent Digital Home Network for Heterogeneous Technologies Amendment 1: Support of new MAC/PHYs and enhancements, IEEE, December 2014., IEEE, December 2014. |
[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. |
[IPDR-FTP] | IPDR File Transfer Protocol, IPDR/File Transfer Protocol, TM Forum. |
[IPDR-SP] | IPDR Streaming Protocol, IPDR Streaming Protocol (IPDR/SP) Specification, TM Forum. |
[ISO3166-1] | ISO 3166-1, Codes for the representation of names of countries and their subdivisions - Part 1: Country codes, ISO, 2006. |
[LIBPCAP] | Libpcap, Libpcap File Format, Wireshark, 2015. |
[LMAPIFM] | RFC 8193, Information Model for Large-Scale Measurement Platforms (LMAPs), IETF, August 2017. |
[MQTT31] | MQTT v3.1, MQ Telemetry Transport (MQTT) V3.1 Protocol Specification, 2010. |
[MQTT311] | MQTT Version 3.1.1, MQTT v3.1.1, OASIS Message Queuing Telemetry Transport (MQTT) TC, October 2014. |
[MQTT50] | MQTT Version 5.0, MQTT Version 5.0, Candidate OASIS Standard 02., OASIS Message Queuing Telemetry Transport (MQTT) TC, February 2019. |
[OUI] | Organizationally Unique Identifiers (OUIs). |
[RFC1661] | RFC 1661, The Point-to-Point Protocol (PPP), IETF, 1994. |
[RFC2104] | RFC 2104, HMAC: Keyed-Hashing for Message Authentication, IETF, 1997. |
[RFC2131] | RFC 2131, Dynamic Host Configuration Protocol, IETF. |
[RFC2616] | RFC 2616, Hypertext Transfer Protocol - HTTP/1.1, IETF, 1999. |
[RFC2863] | RFC 2863, The Interfaces Group MIB, IETF, 2000. |
[RFC3339] | RFC 3339, Date and Time on the Internet: Timestamps, IETF, July, 2002. |
[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. |
[RFC4546] | RFC 4546, Radio Frequency (RF) Interface Management Information Base for Data over Cable Service Interface Specifications (DOCSIS) 2.0 Compliant RF Interfaces, IETF, June 2006. |
[RFC4632] | RFC 4632, Classless Inter-domain Routing (CIDR): The Internet Address Assignment and Aggregation Plan, IETF, 2006. |
[RFC4868] | RFC 4868, Using HMAC-SHA-256, HMAC-SHA-384, and HMAC-SHA-512 with IPsec, IETF, 2007. |
[RFC5280] | RFC 5280, Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile, IETF, May 2008. |
[RFC5625] | RFC 5625, DNS Proxy Implementation Guidelines, IETF, 2009. |
[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. |
[RFC7468] | RFC 7468, Textual Encoding of PKIX, PKCS, and CMS Structures, IETF, April 2015. |
[RFC7594] | RFC 7594, A Framework for Large-Scale Measurement of Broadband Performance (LMAP), IETF, September 2015. |
[RFC7597] | RFC 7597, Mapping of Address and Port with Encapsulation (MAP), IETF, July 2015. |
[RFC7598] | RFC 7598, DHCPv6 Options for configuration of Softwire Address and Port Mapped Clients, IETF, July 2015. |
[RFC7599] | RFC 7599, Mapping of Address and Port using Translation (MAP-T), IETF, July 2015. |
[RFC7693] | RFC 7693, The BLAKE2 Cryptographic Hash and Message Authentication Code (MAC), IETF, November 2015. |
[RFC8141] | RFC 8141, Uniform Resource Names (URNs), IETF, April 2017. |
[RFC8325] | RFC 8325, Mapping Diffserv to IEEE 802.11, IETF, February 2018. |
[RFC862] | RFC 862, Echo Protocol, IETF, 1983. |
[RFC8966] | RFC 8966, The Babel Routing Protocol, IETF, January 2021. |
[RFC8967] | RFC 8967, MAC Authentication for the Babel Routing Protocol, IETF, January 2021. |
[RFC8968] | RFC 8968, Babel Routing Protocol over Datagram Transport Layer Security, IETF, January 2021. |
[RFC9046] | RFC 9046, Babel Information Model, IETF, June 2021. |
[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-106] | TR-106 Amendment 8, Data Model Template for CWMP Endpoints and USP Agents, Broadband Forum, May 2018. |
[TR-143] | TR-143 Amendment 1 Corrigendum 1, Enabling Network Throughput Performance Tests and Statistical Monitoring, Broadband Forum, August 2015. |
[TR-159] | TR-159, Management Framework for xDSL Bonding, Broadband Forum, December 2008. |
[TR-181i2] | TR-181 Issue 2 Amendment 15, Device Data Model, Broadband Forum, January 2022. |
[TR-232] | TR-232, Bulk Data Collection, Broadband Forum, May 2012. |
[TR-262] | TR-262, Femto Component Objects, Broadband Forum, November 2011. |
[TR-369] | TR-369 Issue 1 Amendment 2, User Services Platform, Broadband Forum, January 2022. |
[TR-471] | TR-471, Maximum IP-Layer Capacity Metric, Related Metrics, and Measurements, Broadband Forum, December 2023. |
[UPA-PLC] | Universal Powerline Association, UPA. |
[UPnP-DAv1] | UPnP Device Architecture, UPnP Device Architecture 1.0, UPnP Forum, April 2008. |
[WMM] | Wi-Fi Multimedia Technical Specification, Wi-Fi Multimedia Technical Specification, Wi-Fi Alliance, May 2012. |
[WPS 2.0] | WSC 2.0, Wi-Fi Simple Configuration Technical Specification Version 2.0.x, Wi-Fi Alliance. |
[WPSv1.0] | Wi-Fi Protected Setup Specification Version 1.0h, Wi-Fi Alliance, 2006. |
[ZigBee2007] | ZigBee 2007 Specification, ZigBee 2007 Specification, ZigBee Alliance, October 2007. |
Legend
Object definition. |
Mount point definition. |
Parameter definition. |
Command or Event definition. |
Command Input / Output Arguments container. |
Command or Event Object Input / Output Argument definition. |
Command or Event Parameter Input / Output Argument definition. |
Device:2.15 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.
Changes in 2.15:
- Changed name = Device:2.14 ⇒ Device:2.15
Name | Type | Write | Description | Object Default | Version |
---|---|---|---|---|---|
Device. | object | R | The top-level object for a Device.
Changes in 2.15:
|
- | 2.0 |
Boot! | event | - | Boot event indicating that the Device was rebooted. | - | 2.12 |
⇒ Cause | string | R | The cause of the boot. Enumeration of:
Changes in 2.15:
|
- | 2.12 |
PacketCaptureDiagnostics() | command | - | [ASYNC] This diagnostic command is used to record packet capture data on a valid (layer 2 or above) interface in libpcap or pcapng format. | - | 2.13 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Password | string(:256) | W | Password to be used by the Agent to authenticate with the file location. This string is set to an empty string if no authentication is required. When read, this parameter returns an empty string, regardless of the actual value. When read, this parameter returns an empty string, regardless of the actual value. |
- | 2.13 |
Device.DeviceInfo. | object | R | This object contains general device information. | - | 2.12 |
SoftwareVersion | string(:64) | R | A string identifying the software version currently installed in the CPE (i.e. version of the overall CPE firmware). To allow version comparisons, this element SHOULD be in the form of dot-delimited integers, where each successive integer represents a more minor category of variation. For example, 3.0.21 where the components mean: Major.Minor.Build. For CPEs that support multiple firmware images, the value for this parameter MUST be the software version of the active firmware image. | - | 2.12 |
DeviceImageNumberOfEntries | unsignedInt | R | {{numentries: not associated with a table}}
Changes in 2.15:
|
- | 2.11 |
Device.DeviceInfo.VendorConfigFile.{i}. | object(0:) | R | Every instance of this object is a Vendor Configuration File, and contains parameters associated with the Vendor Configuration File. This table of Vendor Configuration Files is for information only and does not allow the Controller to operate on these files in any way. Whenever the CPE successfully downloads a configuration file as a result of the Download RPC with the FileType argument of 3 Vendor Configuration File, the CPE MUST update this table. {{template: non-existent VENDORCONFIGFILE-DESC}} At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.0 |
Name | string(:64) | R | Name of the vendor configuration file. If the CPE is able to obtain the name of the configuration file from the file itself, then the value of this parameter MUST be set to that name. Otherwise, if the CPE can extract the file name from the URL used to download the configuration file, then the value of this parameter MUST be set to that name. Otherwise, the value of this parameter MUST be set to the value of the TargetFileName argument of the Download RPC used to download this configuration file. {{template: non-existent VENDORCONFIGFILE-NAME}} |
- | 2.0 |
Device.DeviceInfo.MemoryStatus. | object | R | Status of the device’s volatile physical memory.
Changes in 2.15:
|
- | 2.0 |
Total | unsignedInt | R | The total physical volatile RAM, in KiB, installed on the device.
Changes in 2.15:
|
- | 2.0 |
Free | unsignedInt | R | The free physical volatile RAM, in KiB, currently available on the device. Value Change Notification requests for this parameter MAY be denied. Changes in 2.15:
|
- | 2.0 |
TotalPersistent | unsignedInt | R | The sum total physical Non-Volatile Memory (NVM), in KiB, installed on the device. This memory persists across reboots and can be used by the system, applications, or users. | - | 2.15 |
FreePersistent | unsignedInt | R | The sum total free physical Non-Volatile Memory (NVM), in KiB, currently available on the device. This memory persists across reboots and is available for use by the system, applications, or users. Value Change Notification requests for this parameter MAY be denied. |
- | 2.15 |
Device.DeviceInfo.ProcessStatus. | object | R | Status of the processes on the device. | - | 2.0 |
Device.DeviceInfo.ProcessStatus.Process.{i}. | object(0:) | R | List of all processes running on the device. At most one entry in this table can exist with a given value for PID. |
- | 2.0 |
Size | unsignedInt | R | The size in KiB of the memory occupied by the process. Value Change Notification requests for this parameter MAY be denied. Changes in 2.15:
|
- | 2.0 |
Device.DeviceInfo.TemperatureStatus. | object | R | Status of the temperature of the device. | - | 2.0 |
Device.DeviceInfo.TemperatureStatus.TemperatureSensor.{i}. | object(0:) | R | This object represents information that the device has obtained via sampling an internal temperature sensor. At most one entry in this table can exist with a given value for Name, or with a given value for Alias. |
- | 2.0 |
ResetTime | dateTime | R | The time at which this temperature sensor was reset. Reset can be caused by: * Status transition from Disabled to Enabled * **{{param: non-existent **{{template: non-existent}}****Reset}} set to true. * An internal reset of the temperature sensor (including a reboot of the device). The Unknown Time value, as defined in [TR-106], indicates that this temperature sensor has never been reset, which can only happen if it has never been enabled. | - | 2.0 |
Device.DeviceInfo.FirmwareImage.{i}. | object(0:) | R | Top-level object for mapping firmware images. This is a static table – the number of object instances in this table is defined by the firmware that is currently running. At most one entry in this table can exist with a given value for Alias. |
- | 2.12 |
Name | string(:64) | R | Firmware/software image name. Descriptive text of the image or filename. The value of Name is an empty string if Status is anything other than **{{enum: non-existent {{inserted: unexpected argument Status after: Active}}, **{{enum: parameter Name doesn’t define any values}}Available}}, InstallationFailed, or ActivationFailed. | - | 2.12 |
Device.Time. | object | R | This object contains parameters relating an NTP or SNTP time client in the CPE. | - | 2.0 |
LocalTimeZone | string(:256) | W | The local time zone definition, encoded according to IEEE 1003.1 (POSIX). The following is an example value: EST+5 EDT,M4.1.0/2,M10.5.0/2 |
- | 2.0 |
Device.DSL. | object | R | This object models DSL lines, DSL channels, DSL bonding, and DSL diagnostics. The specific interface objects defined here are Line, Channel, and BondingGroup. Each Line models a layer 1 DSL Line interface, and each Channel models a layer 1 DSL Channel interface where multiple channels can run over a DSL line. In the case where bonding is configured, it is expected that BondingGroup is stacked above the Channel instances within its group. | - | 2.0 |
Device.DSL.Line.{i}. | object(0:) | R | DSL Line table (a stackable interface object as described in [Section 4.2/TR-181i2]). This table models physical DSL lines. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.0 |
StandardsSupported | string[] | R | Comma-separated list of strings. List items indicate which DSL standards and recommendations are supported by the Line instance. Each list item is an enumeration of:
This parameter was DEPRECATED in 2.8.because its entries are out-of-date; **{{param: non-existent StandardsSupportedXTSE}}** points to a current list. Therefore its value MAY be an empty string if (and only if) **{{param: non-existent StandardsSupportedXTSE}}** is supported. This parameter is OBSOLETED in 2.14.supported This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
StandardUsed | string | R | The value MUST be a member of the list reported by the StandardsSupported parameter. Indicates the standard that the Line instance is using for the connection. Note: In G.997.1, this parameter is called “xDSL Transmission system”. See ITU-T Recommendation [G.997.1]. This parameter was DEPRECATED
This parameter was DEPRECATED in 2.8.because its entries are out-of-date; **{{param: non-existent StandardUsedXTSE}}** points to a current list. Therefore its value MAY be an empty string if (and only if) **{{param: non-existent StandardUsedXTSUsed}}** is supported. This parameter is OBSOLETED in 2.14. This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
AllowedProfiles | string[] | R | Comma-separated list of strings. List items indicate which VDSL2 profiles are allowed on the line. Each list item is an enumeration of:
This enumeration was DELETED in 2.12 because the value is not defined in G997.1. Changes in 2.15:
)
|
- | 2.0 |
Device.DSL.BondingGroup.{i}. | object(0:) | R | DSL bonding group table (a stackable interface object as described in [Section 4.2/TR-181i2]). Each instance is a bonding group, and is expected to be stacked above a DSL.Channel instance or a FAST.Line instance for each bonded channel in the group. Many of the parameters within this object, including LowerLayers, are read-only because bonding is not expected to be configured by a Controller. The DSL bonding data model is closely aligned with [TR-159]. Corresponds to [TR-159] oBondingGroup. At most one entry in this table can exist with a given value for Alias, or with a given value for Name, or with a given value for GroupID. |
- | 2.0 |
BondSchemesSupported | string[] | R | Comma-separated list of strings. Supported DSL bonding schemes. Each list item is an enumeration of:
[G.998.1] ATM-based bonding Changes in 2.15:
)
[G.998.3] TDIM-based bonding Changes in 2.15:
) Corresponds to [TR-159] oBondingGroup.aGroupBondSchemesSupported. |
- | 2.0 |
Device.DSL.BondingGroup.{i}.BondedChannel.{i}. | object(0:) | R | DSL bonded channel table. Each table entry represents a bonded channel within the bonding group, and is associated with exactly one DSL.Channel instance or one FAST.Line instance. There MUST be an instance of BondedChannel for each DSL channel or FAST line that is bonded. When a DSL.Channel or FAST.Line is no longer bonded, then the CPE MUST delete the corresponding BondedChannel instance. However, when a bonded DSL.Channel or FAST.Line becomes disabled, the channel remains bonded and so the corresponding BondedChannel instance MUST NOT be deleted. At most one entry in this table can exist with a given value for Alias, or with a given value for Channel. |
- | 2.0 |
Device.DSL.BondingGroup.{i}.BondedChannel.{i}.Ethernet. | object | R | Per-channel [G.998.2] Ethernet-based bonding parameters. This object MUST be present if, and only if, BondScheme is Ethernet. | - | 2.0 |
Device.DSL.BondingGroup.{i}.Ethernet. | object(0:1) | R | Ethernet-based bonding parameters [G.998.2]. This object MUST be present if, and only if, BondScheme is Ethernet. This object MUST be present if, and only if, BondScheme is Ethernet. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.0 |
Device.DSL.Diagnostics. | object | R | The DSL Diagnostics object. | - | 2.0 |
SELTP() | command | - | [ASYNC] This command performs a DSL Single-Ended Line Test - Processed (SELT-P). This command is for the CPE, aka the Transmission Unit - Remote end (TU-R). Reference: ITU-T Recommendation [G.996.2]. | - | 2.13 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ LoopTermination | string | R | Loop termination indicator. Enumeration of:
|
- | 2.13 |
Device.Optical. | object | R | This object models a generic optical interface technologies.interface. It defines an Interface object that models a layer 1 optical interface that is capable of transporting Ethernet packets. TheFor historical reasons, the data model definition is based on parts of [G.988]. However, it is not intended to model anything specific to IEEE PON or ITU-T PON technologies. Note that this object is not intended to model the optical transceiver either. |
- | 2.4 |
Device.Optical.Interface.{i}. | object(0:) | R | Optical interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). This table models physical optical interfaces. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.4 |
LowerOpticalThreshold | int | R | Optical level that is used to declare the downstream low received optical power alarm. [Dbm1000] ::: hide
The value is measured in dBm/1000, i.e. the value divided by 1000 is
dB relative to 1 mW. For example, -12345 means -12.345 dBm, 0 means 0 dBm
(1 mW) and 12345 means 12.345 dBm.
::: Valid values are -127.5 dBm (coded as -127500) to 0 dBm (coded as 0) in 0.5 dB increments. The value -127500 indicates the device’s internal policy. This parameter is based on Lower optical threshold from [Section 9.2.1/G.988].
This parameter was DEPRECATED in 2.15 because it is not intended for the device to raise an optical power alarm. Changes in 2.15:
|
- | 2.4 |
UpperOpticalThreshold | int | R | Optical level that is used to declare the downstream high received optical power alarm. [Dbm1000] ::: hide
The value is measured in dBm/1000, i.e. the value divided by 1000 is
dB relative to 1 mW. For example, -12345 means -12.345 dBm, 0 means 0 dBm
(1 mW) and 12345 means 12.345 dBm.
::: Valid values are -127.5 dBm (coded as -127500) to 0 dBm (coded as 0) in 0.5 dB increments. The value -127500 indicates the device’s internal policy. This parameter is based on Upper optical threshold from [Section 9.2.1/G.988].
This parameter was DEPRECATED in 2.15 because it is not intended for the device to raise an optical power alarm. Changes in 2.15:
|
- | 2.4 |
LowerTransmitPowerThreshold | int | R | Minimum mean optical launch power that is used to declare the low transmit optical power alarm. [Dbm1000] ::: hide
The value is measured in dBm/1000, i.e. the value divided by 1000 is
dB relative to 1 mW. For example, -12345 means -12.345 dBm, 0 means 0 dBm
(1 mW) and 12345 means 12.345 dBm.
::: Valid values are -63.5 dBm (coded as -63500) to +63.5 dBm (coded as 63500) in 0.5 dB increments. The value -63500 indicates the device’s internal policy. This parameter is based on Lower transmit power threshold from [Section 9.2.1/G.988].
This parameter was DEPRECATED in 2.15 because it is not intended for the device to raise an optical power alarm. Changes in 2.15:
|
- | 2.4 |
UpperTransmitPowerThreshold | int | R | Maximum mean optical launch power that is used to declare the high transmit optical power alarm. [Dbm1000] ::: hide
The value is measured in dBm/1000, i.e. the value divided by 1000 is
dB relative to 1 mW. For example, -12345 means -12.345 dBm, 0 means 0 dBm
(1 mW) and 12345 means 12.345 dBm.
::: Valid values are -63.5 dBm (coded as -63500) to +63.5 dBm (coded as 63500) in 0.5 dB increments. The value -63500 indicates the device’s internal policy. This parameter is based on Upper transmit power threshold from [Section 9.2.1/G.988].
This parameter was DEPRECATED in 2.15 because it is not intended for the device to raise an optical power alarm. Changes in 2.15:
|
- | 2.4 |
Device.ATM. | object | R | Asynchronous Transfer Mode (ATM) object that contains the Link interface and {{object: referenced Diagnostics.F5Loopback() is command, not object}} diagnostics. | - | 2.0 |
Device.ATM.Link.{i}. | object(0:) | W | ATM link-layer table (a stackable interface object as described in [Section 4.2/TR-181i2]). Models an ATM PVC virtual circuit and the ATM Adaption Layer (AAL). An ATM Link entry is typically stacked on top of either a DSL.Channel. or a DSL.BondingGroup. object. When an ATM Link interface is used, a lower-layer DSL.Channel interface MUST be configured with ATM encapsulation (see DSL.Channel.{i}.LinkEncapsulationUsed). At most one entry in this table can exist with a given value for Alias, or with a given value for Name. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Name such that the new entry does not conflict with any existing entries. |
- | 2.0 |
VCSearchList | string[](:256) | W | Comma-separated list (maximum number of characters 256) of strings. Ordered list of VPI/VCI pairs to search if a link using the DestinationAddress cannot be established. In the form “VPI1/VCI1, VPI2/VCI2, …”. Each list item matches one of:
0/35, 8/35, 1/35 |
- | 2.0 |
Device.ATM.Diagnostics. | object | R | The ATM Diagnostics object. | - | 2.0 |
F5Loopback() | command | - | [ASYNC] This command provides access to an ATM-layer F5 OAM loopback test. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Interface | string(:256) | W | [MANDATORY] The value MUST be the Path Name of a row in the ATM.Link. table. This is the interface over which the test is to be
performed.
Changes in 2.15:
|
- | 2.12 |
⇒ NumberOfRepetitions | unsignedInt(1:) | W | [MANDATORY] Number of repetitions of the ping test to perform before reporting the
results.
Changes in 2.15:
|
- | 2.12 |
⇒ Timeout | unsignedInt(1:) | W | [MANDATORY] Timeout in milliseconds for the ping test.
Changes in 2.15:
|
- | 2.12 |
Device.DOCSIS. | object | R | DOCSIS object. This object models the DOCSIS 3.x cable interface objects. | - | 2.15 |
CapabilitiesReq | hexBinary(0,2:255) | R | [docsIf3CmCapabilitiesReq/1.3.6.1.4.1.4491.2.1.20.1.21.1] [TLV8] This attribute contains the TLV encoding for TLV-5 sent in a REG-REQ. The first byte of this encoding is expected to be 0x05. See [CM-SP-MULPIv3.0], Modem Capabilities Encoding in the Common Radio Frequency Interface Encodings Annex. |
- | 2.15 |
CapabilitiesRsp | hexBinary(0,2:255) | R | [docsIf3CmCapabilitiesRsp/1.3.6.1.4.1.4491.2.1.20.1.21.2] [TLV8] This attribute contains the TLV encoding for TLV-5 received in a REG-RSP. The first byte of this encoding is expected to be 0x05. See [CM-SP-MULPIv3.0], Modem Capabilities Encoding in the Common Radio Frequency Interface Encodings Annex. |
- | 2.15 |
DownstreamNumberOfEntries | unsignedInt | R | The number of entries in the Downstream table. | - | 2.15 |
UpstreamNumberOfEntries | unsignedInt | R | The number of entries in the Upstream table. | - | 2.15 |
DownstreamChannelNumberOfEntries | unsignedInt | R | The number of entries in the DownstreamChannel table. | - | 2.15 |
UpstreamChannelNumberOfEntries | unsignedInt | R | The number of entries in the UpstreamChannel table. | - | 2.15 |
InterfaceNumberOfEntries | unsignedInt | R | The number of entries in the Interface table. | - | 2.15 |
Device.DOCSIS.Downstream.{i}. | object(0:) | R | DOCSIS Downstream interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). This table models the PHY DOCSIS Downstream interface. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.0 |
Enable | boolean | W | Enables or disables the interface. This parameter is based on ifAdminStatus from [RFC2863]. |
- | 2.0 |
Status | string | R | The current operational state of the interface (see [Section 4.2.2/TR-181i2]). Enumeration of:
When Enable is false then Status SHOULD normally be Down (or NotPresent or Error if there is a fault condition on the interface). When Enable is changed to true then Status SHOULD change to Up if and only if the interface is able to transmit and receive network traffic; it SHOULD change to Dormant if and only if the interface is operable but is waiting for external actions before it can transmit and receive network traffic (and subsequently change to Up if still operable when the expected actions have completed); it SHOULD change to LowerLayerDown if and only if the interface is prevented from entering the Up state because one or more of the interfaces beneath it is down; it SHOULD remain in the Error state if there is an error or other fault condition detected on the interface; it SHOULD remain in the NotPresent state if the interface has missing (typically hardware) components; it SHOULD change to Unknown if the state of the interface can not be determined for some reason. This parameter is based on ifOperStatus from [RFC2863]. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Name | string(:64) | R | The textual name of the interface as assigned by the CPE. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. |
- | 2.0 |
LastChange | unsignedInt | R | The accumulated time in seconds since the interface entered its current operational state. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
LowerLayers | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of an interface object that is stacked immediately below this interface object, or an empty string. See [Section 4.2.1/TR-181i2]. Note: Since Downstream is a layer 1 interface, it is expected that LowerLayers will not be used. |
- | 2.0 |
Upstream | boolean | R | Indicates whether the interface points towards the Internet (true) or towards End Devices (false). For example:
|
- | 2.0 |
MaxBitRate | int(-1:) | W | The maximum upstream and downstream PHY bit rate supported by this interface (expressed in Mbps). A value of -1 indicates automatic selection of the maximum bit rate. |
- | 2.0 |
CurrentBitRate | unsignedInt | R | The current upstream and downstream PHY bit rate on this interface (expressed in Mbps). A value of 0 indicates that the current bit rate is unknown. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DownstreamChannelList | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of a row in the DOCSIS.DownstreamChannel. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Downstream Channels associated with this Downstream interface. | - | 2.0 |
Device.DOCSIS.Downstream.{i}.Stats. | object | R | Throughput statistics for this interface. The CPE MUST reset the interface’s Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interface becomes operationally down due to a previous administrative down (i.e. the interface’s Status parameter transitions to a down state after the interface is disabled) or when the interface becomes administratively up (i.e. the interface’s Enable parameter transitions from false to true). Administrative and operational interface status is discussed in [Section 4.2.2/TR-181i2]. |
- | 2.0 |
BytesSent | unsignedLong | R | [StatsCounter64] The total number of bytes transmitted out of the interface, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BytesReceived | unsignedLong | R | [StatsCounter64] The total number of bytes received on the interface, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets transmitted out of the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsReceived | unsignedLong | R | [StatsCounter64] The total number of packets received on the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsSent | unsignedInt | R | [StatsCounter32] The total number of outbound packets that could not be transmitted because of errors. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsReceived | unsignedInt | R | [StatsCounter32] The total number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets requested for transmission which were not addressed to a multicast or broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were not addressed to a multicast or broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsSent | unsignedInt | R | [StatsCounter32] The total number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsReceived | unsignedInt | R | [StatsCounter32] The total number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets that higher-level protocols requested for transmission and which were addressed to a multicast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were addressed to a multicast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets that higher-level protocols requested for transmission and which were addressed to a broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were addressed to a broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnknownProtoPacketsReceived | unsignedInt | R | [StatsCounter32] The total number of packets received via the interface which were discarded because of an unknown or unsupported protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Device.DOCSIS.Upstream.{i}. | object(0:) | R | DOCSIS Upstream interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). This table models the PHY DOCSIS Upstream interface. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.0 |
Enable | boolean | W | Enables or disables the interface. This parameter is based on ifAdminStatus from [RFC2863]. |
- | 2.0 |
Status | string | R | The current operational state of the interface (see [Section 4.2.2/TR-181i2]). Enumeration of:
When Enable is false then Status SHOULD normally be Down (or NotPresent or Error if there is a fault condition on the interface). When Enable is changed to true then Status SHOULD change to Up if and only if the interface is able to transmit and receive network traffic; it SHOULD change to Dormant if and only if the interface is operable but is waiting for external actions before it can transmit and receive network traffic (and subsequently change to Up if still operable when the expected actions have completed); it SHOULD change to LowerLayerDown if and only if the interface is prevented from entering the Up state because one or more of the interfaces beneath it is down; it SHOULD remain in the Error state if there is an error or other fault condition detected on the interface; it SHOULD remain in the NotPresent state if the interface has missing (typically hardware) components; it SHOULD change to Unknown if the state of the interface can not be determined for some reason. This parameter is based on ifOperStatus from [RFC2863]. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Name | string(:64) | R | The textual name of the interface as assigned by the CPE. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. |
- | 2.0 |
LastChange | unsignedInt | R | The accumulated time in seconds since the interface entered its current operational state. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
LowerLayers | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of an interface object that is stacked immediately below this interface object, or an empty string. See [Section 4.2.1/TR-181i2]. Note: Since Upstream is a layer 1 interface, it is expected that LowerLayers will not be used. |
- | 2.0 |
Upstream | boolean | R | Indicates whether the interface points towards the Internet (true) or towards End Devices (false). For example:
|
- | 2.0 |
MaxBitRate | int(-1:) | W | The maximum upstream and downstream PHY bit rate supported by this interface (expressed in Mbps). A value of -1 indicates automatic selection of the maximum bit rate. |
- | 2.0 |
CurrentBitRate | unsignedInt | R | The current upstream and downstream PHY bit rate on this interface (expressed in Mbps). A value of 0 indicates that the current bit rate is unknown. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UpstreamChannelList | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of a row in the DOCSIS.UpstreamChannel. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Upstream Channels associated with this Upstream interface. | - | 2.0 |
Device.DOCSIS.Upstream.{i}.Stats. | object | R | Throughput statistics for this interface. The CPE MUST reset the interface’s Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interface becomes operationally down due to a previous administrative down (i.e. the interface’s Status parameter transitions to a down state after the interface is disabled) or when the interface becomes administratively up (i.e. the interface’s Enable parameter transitions from false to true). Administrative and operational interface status is discussed in [Section 4.2.2/TR-181i2]. |
- | 2.0 |
BytesSent | unsignedLong | R | [StatsCounter64] The total number of bytes transmitted out of the interface, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BytesReceived | unsignedLong | R | [StatsCounter64] The total number of bytes received on the interface, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets transmitted out of the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsReceived | unsignedLong | R | [StatsCounter64] The total number of packets received on the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsSent | unsignedInt | R | [StatsCounter32] The total number of outbound packets that could not be transmitted because of errors. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsReceived | unsignedInt | R | [StatsCounter32] The total number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets requested for transmission which were not addressed to a multicast or broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were not addressed to a multicast or broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsSent | unsignedInt | R | [StatsCounter32] The total number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsReceived | unsignedInt | R | [StatsCounter32] The total number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets that higher-level protocols requested for transmission and which were addressed to a multicast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were addressed to a multicast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets that higher-level protocols requested for transmission and which were addressed to a broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were addressed to a broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnknownProtoPacketsReceived | unsignedInt | R | [StatsCounter32] The total number of packets received via the interface which were discarded because of an unknown or unsupported protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Device.DOCSIS.DownstreamChannel.{i}. | object(0:) | R | [docsIfDownstreamChannelTable/1.3.6.1.2.1.10.127.1.1.1.1] This table describes the attributes of downstream channels (frequency bands). See [Tables 6-16, and 6-17/CM-SP-RFIv2.0]. At most one entry in this table can exist with a given value for Alias. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ID | unsignedInt(0:255) | R | [docsIfDownChannelId/1.3.6.1.2.1.10.127.1.1.1.1.1] The Cable Modem Termination System identification of the downstream channel within this particular MAC interface. if the interface is down, the object returns the most current value. If the downstream channel ID is unknown, this object returns a value of 0. | - | 2.0 |
Frequency | int(0:1000000000) | R | [docsIfDownChannelFrequency/1.3.6.1.2.1.10.127.1.1.1.1.2] The center of the downstream frequency associated with this channel. This object will return the current tuner frequency. See [Section 6.3.3/CM-SP-RFIv2.0]. |
- | 2.0 |
Width | int(0:16000000) | R | [docsIfDownChannelWidth/1.3.6.1.2.1.10.127.1.1.1.1.3] The bandwidth of this downstream channel. Most implementations are expected to support a channel width of 6 MHz (North America) and/or 8 MHz (Europe). See [Table 6-17/CM-SP-RFIv2.0]. |
- | 2.0 |
Modulation | string | R | [docsIfDownChannelModulation/1.3.6.1.2.1.10.127.1.1.1.1.4] The modulation type associated with this downstream channel. If the interface is down, this object either returns the configured value (from the CMTS), the most current value (from the CM), or the value of Unknown. See the reference for specifics on the modulation profiles implied by QAM64 and QAM256. Enumeration of:
|
- | 2.0 |
Interleave | string | R | [docsIfDownChannelInterleave/1.3.6.1.2.1.10.127.1.1.1.1.5] The Forward Error Correction (FEC) interleaving used for this downstream channel. The value Taps12increment17 is supported by EuroDOCSIS cable systems only, and the others by DOCSIS cable systems. If the interface is down, this object either returns the configured value (from the CMTS), the most current value (from the CM), or the value of Unknown. The value of Other is returned if the interleave is known but not defined in the above list. See the reference for the FEC configuration described by the setting of this object. Enumeration of:
See [Table 6-15/CM-SP-RFIv2.0]. |
- | 2.0 |
Power | int | R | [docsIfDownChannelPower/1.3.6.1.2.1.10.127.1.1.1.1.6] [TenthdBmV] The received power level. If the interface is down, this object either returns the configured value (from the CMTS), the most current value (from the CM) or the value of 0. See the reference for recommended and required power levels. |
- | 2.0 |
Annex | string | R | [docsIfDownChannelAnnex/1.3.6.1.2.1.10.127.1.1.1.1.7] The value of this object indicates the conformance of the implementation to important regional cable standards. Enumeration of:
|
- | 2.0 |
Device.DOCSIS.DownstreamChannel.{i}.SignalQuality. | object | R | [docsIfSignalQualityTable/1.3.6.1.2.1.10.127.1.1.4.1] Describes the PHY signal quality of downstream channels. | - | 2.0 |
SignalNoise | int | R | [docsIfSigQSignalNoise/1.3.6.1.2.1.10.127.1.1.4.1.5] [TenthdB] Signal/Noise ratio as perceived for this channel. Describes the Signal/Noise of the downstream channel. |
- | 2.0 |
Microreflections | int(0:255) | R | [docsIfSigQMicroreflections/1.3.6.1.2.1.10.127.1.1.4.1.6] Microreflections, including in-channel response as perceived on this interface, measured in dBc below the signal level. This object is not assumed to return an absolutely accurate value, but it gives a rough indication of microreflections received on this interface. It is up to the implementer to provide information as accurately as possible. |
- | 2.0 |
EqualizationData | hexBinary(0,36:260) | R | [docsIfSigQEqualizationData/1.3.6.1.2.1.10.127.1.1.4.1.7] [DocsEqualizerData] Returns the equalization data for the downstream channel.
See [Figure 6-23/CM-SP-RFIv2.0]. |
- | 2.0 |
ExtUnerroreds | unsignedLong | R | [docsIfSigQExtUnerroreds/1.3.6.1.2.1.10.127.1.1.4.1.8] [StatsCounter64] Codewords received on this channel without error. This includes all codewords, whether or not they were part of frames destined for this device. Discontinuities in the value of this counter can occur at reinitialization of the managed system. |
- | 2.0 |
ExtCorrecteds | unsignedLong | R | [docsIfSigQExtCorrecteds/1.3.6.1.2.1.10.127.1.1.4.1.9] [StatsCounter64] Codewords received on this channel with correctable errors. This includes all codewords, whether or not they were part of frames destined for this device. Discontinuities in the value of this counter can occur at reinitialization of the managed system. |
- | 2.0 |
ExtUncorrectables | unsignedLong | R | [docsIfSigQExtUncorrectables/1.3.6.1.2.1.10.127.1.1.4.1.10] [StatsCounter64] Codewords received on this channel with uncorrectable errors. This includes all codewords, whether or not they were part of frames destined for this device. Discontinuities in the value of this counter can occur at reinitialization of the managed system. |
- | 2.0 |
Device.DOCSIS.DownstreamChannel.{i}.SignalQualityExt. | object | R | [docsIf3SignalQualityExtTable/1.3.6.1.4.1.4491.2.1.20.1.24.1] Describes the received modulation error ratio of each downstream channel. | - | 2.0 |
RxMER | int | R | [docsIf3SignalQualityExtRxMER/1.3.6.1.4.1.4491.2.1.20.1.24.1.1] [TenthdB] RxMER provides an in-channel received Modulation Error Ratio (MER). RxMER is defined as an estimate, provided by the demodulator, of the ratio: (average constellation energy with equally likely symbols) / (average squared magnitude of error vector) RxMER is measured just prior to FEC (trellis/Reed-Solomon) decoding. RxMER includes the effects of the HFC channel as well as implementation effects of the modulator and demodulator. Error vector estimation may vary among demodulator implementations. In the case of S-CDMA mode, RxMER is measured on the de-spread signal. |
- | 2.0 |
RxMerSamples | unsignedInt | R | [docsIf3SignalQualityExtRxMerSamples/1.3.6.1.4.1.4491.2.1.20.1.24.1.2] RxMerSamples is a statistically significant number of symbols processed to arrive at the RxMER value. | - | 2.0 |
FbeNormalizationCoefficient | int | R | [docsIf3SignalQualityExtFbeNormalizationCoefficient/1.3.6.1.4.1.4491.2.1.20.1.24.1.3] The Downstream Adaptive Decision Feedback Equalizer (DFE) is implemented as a Feedforward Equalizer (FFE) and a Feedback Equalizer (FBE). In order to evaluate the composite DFE response it is necessary to normalize the FBE coefficients to 1 and then evaluate the FFT(hffe)/FFT(1,hfbe), where the hfbe coefficients have been normalized to 1 using FbeNormalizationCoefficient. The complex data representing the hffe and hfbe coefficients is contained in the EqualizationData MIB. It is possible to implement the DFE such that the response is evaluated as FFT(hffe)/FFT(1,-hfbe). In this case the FbeNormalizationCoefficient will be reported as a negative number and the response will be evaluated as FFT(hffe)/FFT(1,hfbe). | - | 2.0 |
Device.DOCSIS.UpstreamChannel.{i}. | object(0:) | W | [docsIfUpstreamChannelTable/1.3.6.1.2.1.10.127.1.1.2.1] This table describes the attributes of attached upstream channels. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ID | int(0:255) | R | [docsIfUpChannelId/1.3.6.1.2.1.10.127.1.1.2.1.1] The CMTS identification of the upstream channel. | - | 2.0 |
Frequency | int(0:1000000000) | R | [docsIfUpChannelFrequency/1.3.6.1.2.1.10.127.1.1.2.1.2] The center of the frequency band associated with this upstream interface. This object returns 0 if the frequency is undefined or unknown. Minimum permitted upstream frequency is 5,000,000 Hz for current technology. See [Table 4-2/CM-SP-RFIv2.0]. |
- | 2.0 |
Width | int(0:64000000) | R | [docsIfUpChannelWidth/1.3.6.1.2.1.10.127.1.1.2.1.3] The bandwidth of this upstream interface. This object returns 0 if the interface width is undefined or unknown. Minimum permitted interface width is currently 200,000 Hz. See [Table 6-5/CM-SP-RFIv2.0]. |
- | 2.0 |
SlotSize | unsignedInt | R | [docsIfUpChannelSlotSize/1.3.6.1.2.1.10.127.1.1.2.1.5] Applicable to TDMA and ATDMA channel types only. The number of 6.25 microsecond ticks in each upstream mini-slot. Returns zero if the value is undefined or unknown or in case of an SCDMA channel. |
- | 2.0 |
TxTimingOffset | unsignedInt | R | [docsIfUpChannelTxTimingOffset/1.3.6.1.2.1.10.127.1.1.2.1.6] A measure of the current round trip time obtained from the ranging offset (initial ranging offset + ranging offset adjustments). Used for timing of CM upstream transmissions to ensure synchronized arrivals at the CMTS. Units are one 64th fraction of 6.25 microseconds. See [Section 6.2.19/CM-SP-RFIv2.0]. |
- | 2.0 |
RangingBackoffStart | int(0:16) | R | [docsIfUpChannelRangingBackoffStart/1.3.6.1.2.1.10.127.1.1.2.1.7] The initial random backoff window to use when retrying Ranging Requests. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. |
- | 2.0 |
RangingBackoffEnd | int(0:16) | R | [docsIfUpChannelRangingBackoffEnd/1.3.6.1.2.1.10.127.1.1.2.1.8] The final random backoff window to use when retrying Ranging Requests. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. |
- | 2.0 |
TxBackoffStart | int(0:16) | R | [docsIfUpChannelTxBackoffStart/1.3.6.1.2.1.10.127.1.1.2.1.9] The initial random backoff window to use when retrying transmissions. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. |
- | 2.0 |
TxBackoffEnd | int(0:16) | R | [docsIfUpChannelTxBackoffEnd/1.3.6.1.2.1.10.127.1.1.2.1.10] The final random backoff window to use when retrying transmissions. Expressed as a power of 2. A value of 16 at the CMTS indicates that a proprietary adaptive retry mechanism is to be used. |
- | 2.0 |
Device.DOCSIS.UpstreamChannel.{i}.Status. | object | R | [docsIf3CmStatusUsTable/1.3.6.1.4.1.4491.2.1.20.1.2.1] This object provides Upstream channel information previously available in the SNMP table docsIfCmStatusTable. | - | 2.0 |
TxPower | int | R | [docsIf3CmStatusUsTxPower/1.3.6.1.4.1.4491.2.1.20.1.2.1.1] [TenthdBmV] This attribute represents the operational CM transmit power for this SC-QAM upstream channel. In order for this attribute to provide consistent information under all circumstances, a 3.1 CM will report the average total power for the SC-QAM channel the same as was done for DOCSIS 3.0, regardless of whether it is operating with a 3.1 or a 3.0 CMTS. The value that is reported was referred to as Pr in the DOCSIS 3.0 PHY Spec. | - | 2.0 |
T3Timeouts | unsignedInt | R | [docsIf3CmStatusUsT3Timeouts/1.3.6.1.4.1.4491.2.1.20.1.2.1.2] [StatsCounter32] This attribute denotes the number of times counter T3 expired in the CM for this upstream channel. Discontinuities in the value of this counter can occur at re-initialization of the managed system. See [RFC2863]. |
- | 2.0 |
T4Timeouts | unsignedInt | R | [docsIf3CmStatusUsT4Timeouts/1.3.6.1.4.1.4491.2.1.20.1.2.1.3] [StatsCounter32] This attribute denotes the number of times counter T4 expired in the CM for this upstream channel. Discontinuities in the value of this counter can occur at re-initialization of the managed system. See [RFC2863]. |
- | 2.0 |
RangingAborteds | unsignedInt | R | [docsIf3CmStatusUsRangingAborteds/1.3.6.1.4.1.4491.2.1.20.1.2.1.4] [StatsCounter32] This attribute denotes the number of times the ranging process was aborted by the CMTS. Discontinuities in the value of this counter can occur at re-initialization of the managed system. See [RFC2863]. |
- | 2.0 |
ModulationType | string | R | [docsIf3CmStatusUsModulationType/1.3.6.1.4.1.4491.2.1.20.1.2.1.5] [DocsisUpstreamType] This attribute indicates modulation type status currently used by the CM for this upstream channel. Since this object specifically identifies PHY Layer mode, the shared upstream channel type “tdmaAndAtdma” is not permitted. See [RFC2863]. |
- | 2.0 |
EqData | hexBinary(0,36:260) | R | [docsIf3CmStatusUsEqData/1.3.6.1.4.1.4491.2.1.20.1.2.1.6] [DocsEqualizerData] This attribute indicates the pre-equalization data for the specified upstream Channel on this CM after convolution with data indicated in the RNG-RSP. This data is valid when docsIfUpChannelPreEqEnable RFC 4546 is set to true. |
- | 2.0 |
T3Exceededs | unsignedInt | R | [docsIf3CmStatusUsT3Exceededs/1.3.6.1.4.1.4491.2.1.20.1.2.1.7] [StatsCounter32] This attribute denotes the number of times for excessive T3 timeouts. Discontinuities in the value of this counter can occur at re-initialization of the managed system. See [RFC2863]. |
- | 2.0 |
IsMuted | boolean | R | [docsIf3CmStatusUsIsMuted/1.3.6.1.4.1.4491.2.1.20.1.2.1.8] This attribute denotes whether the upstream channel is muted. See [CM-SP-MULPIv3.0], Media Access Control specification. |
- | 2.0 |
RangingStatus | string | R | [docsIf3CmStatusUsRangingStatus/1.3.6.1.4.1.4491.2.1.20.1.2.1.9] [RangingState] This attribute denotes the ranging state of the CM. See [CM-SP-MULPIv3.0], Media Access Control specification. |
- | 2.0 |
Device.DOCSIS.Interface.{i}. | object(0:) | R | DOCSIS Layer 2 (MAC) interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). This table models the MAC level DOCSIS interface. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.0 |
Enable | boolean | W | Enables or disables the interface. This parameter is based on ifAdminStatus from [RFC2863]. |
- | 2.0 |
Status | string | R | The current operational state of the interface (see [Section 4.2.2/TR-181i2]). Enumeration of:
When Enable is false then Status SHOULD normally be Down (or NotPresent or Error if there is a fault condition on the interface). When Enable is changed to true then Status SHOULD change to Up if and only if the interface is able to transmit and receive network traffic; it SHOULD change to Dormant if and only if the interface is operable but is waiting for external actions before it can transmit and receive network traffic (and subsequently change to Up if still operable when the expected actions have completed); it SHOULD change to LowerLayerDown if and only if the interface is prevented from entering the Up state because one or more of the interfaces beneath it is down; it SHOULD remain in the Error state if there is an error or other fault condition detected on the interface; it SHOULD remain in the NotPresent state if the interface has missing (typically hardware) components; it SHOULD change to Unknown if the state of the interface can not be determined for some reason. This parameter is based on ifOperStatus from [RFC2863]. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Name | string(:64) | R | The textual name of the interface as assigned by the CPE. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. |
- | 2.0 |
LastChange | unsignedInt | R | The accumulated time in seconds since the interface entered its current operational state. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
LowerLayers | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of an interface object that is stacked immediately below this interface object, or an empty string. See [Section 4.2.1/TR-181i2]. | - | 2.0 |
MACAddress | string | R | The MAC Address of the interface. | - | 2.0 |
CMTSAddress | string(:17) | R | [docsIfCmCmtsAddress/1.3.6.1.2.1.10.127.1.2.1.1.1] [MACAddress] Identifies the CMTS that is believed to control this MAC domain. This will be the source address from SYNC, MAP, and other MAC-layer messages. If the CMTS is unknown, returns 00-00-00-00-00-00. See [Section 8.2.2/CM-SP-RFIv2.0]. |
- | 2.0 |
Capabilities | string[] | R | [docsIfCmCapabilities/1.3.6.1.2.1.10.127.1.2.1.1.2] Comma-separated list of strings. Identifies the capabilities of the MAC implementation at this interface. Note that packet transmission is always supported. Therefore, there is no specific bit required to explicitly indicate this capability. Each list item is an enumeration of:
|
- | 2.0 |
FirmwareVersion | string(:64) | R | A string identifying the version of the modem firmware currently installed for this interface. This is applicable only when the modem firmware is separable from the overall CPE software. | - | 2.0 |
DOCSISVersion | string | R | [docsIfDocsisBaseCapability/1.3.6.1.2.1.10.127.1.1.5] Indication of the DOCSIS capability of the device. See [Annex G/CM-SP-RFIv2.0]. Enumeration of:
|
- | 2.0 |
MdCfgIpProvMode | string | R | [docsIf3CmMdCfgIpProvMode/1.3.6.1.4.1.4491.2.1.20.1.31.1.1] MdCfgIpProvMode specifies how the IP provisioning mode is configured. The CM relies upon the CMTS to facilitate the successful IP address acquisition independently of the MDD. Enumeration of:
See [CM-SP-MULPIv3.0], IP Initialization Parameters TLV Section. |
- | 2.0 |
Device.DOCSIS.Interface.{i}.Stats. | object | R | Throughput statistics for this interface. The CPE MUST reset the interface’s Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interface becomes operationally down due to a previous administrative down (i.e. the interface’s Status parameter transitions to a down state after the interface is disabled) or when the interface becomes administratively up (i.e. the interface’s Enable parameter transitions from false to true). Administrative and operational interface status is discussed in [Section 4.2.2/TR-181i2]. |
- | 2.0 |
BytesSent | unsignedLong | R | [StatsCounter64] The total number of bytes transmitted out of the interface, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BytesReceived | unsignedLong | R | [StatsCounter64] The total number of bytes received on the interface, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets transmitted out of the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsReceived | unsignedLong | R | [StatsCounter64] The total number of packets received on the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsSent | unsignedInt | R | [StatsCounter32] The total number of outbound packets that could not be transmitted because of errors. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsReceived | unsignedInt | R | [StatsCounter32] The total number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets requested for transmission which were not addressed to a multicast or broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were not addressed to a multicast or broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsSent | unsignedLong | R | [StatsCounter64] The total number of outbound packets which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of inbound packets which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets that higher-level protocols requested for transmission and which were addressed to a multicast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were addressed to a multicast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets that higher-level protocols requested for transmission and which were addressed to a broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of received packets, delivered by this layer to a higher layer, which were addressed to a broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnknownProtoPacketsReceived | unsignedLong | R | [StatsCounter64] The total number of packets received via the interface which were discarded because of an unknown or unsupported protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Device.DOCSIS.Interface.{i}.ConnectivityStatus. | object | R | [docsIf3CmStatusTable/1.3.6.1.4.1.4491.2.1.20.1.1.1] This object defines attributes of the CM connectivity status. This object provides CM connectivity status information of the CM previously available in the SNMP table docsIfCmStatusTable. See [RFC4546]. |
- | 2.0 |
Value | string | R | [docsIf3CmStatusValue/1.3.6.1.4.1.4491.2.1.20.1.1.1.1] [CmRegState] This attribute denotes the current CM connectivity state. For the case of IP acquisition related states, this attribute reflects states for the current CM provisioning mode, not the Other DHCP process associated with dual stack operation. See [CM-SP-MULPIv3.0], Establishing IP Connectivity. |
- | 2.0 |
StatusCode | string(0,5:7) | R | [docsIf3CmStatusCode/1.3.6.1.4.1.4491.2.1.20.1.1.1.2] This attribute denotes the status code for CM as defined in the OSSI Specification. The status code consists of a single character indicating error groups, followed by a two-or three-digit number indicating the status condition, followed by a decimal. An example of a returned value could be “T101.0”. The zero-length hex string indicates no status code yet registered. See [CM-SP-OSSIv3.0], Format and Content for Event, Syslog, and SNMP Notification Annex. |
- | 2.0 |
Resets | unsignedInt | R | [docsIf3CmStatusResets/1.3.6.1.4.1.4491.2.1.20.1.1.1.3] [StatsCounter32] This attribute denotes the number of times the CM reset or initialized this interface. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
LostSyncs | unsignedInt | R | [docsIf3CmStatusLostSyncs/1.3.6.1.4.1.4491.2.1.20.1.1.1.4] [StatsCounter32] This attribute denotes the number of times the CM lost synchronization with the downstream channel. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
InvalidMaps | unsignedInt | R | [docsIf3CmStatusInvalidMaps/1.3.6.1.4.1.4491.2.1.20.1.1.1.5] [StatsCounter32] This attribute denotes the number of times the CM received invalid MAP messages. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
InvalidUcds | unsignedInt | R | [docsIf3CmStatusInvalidUcds/1.3.6.1.4.1.4491.2.1.20.1.1.1.6] [StatsCounter32] This attribute denotes the number of times the CM received invalid UCD messages. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
InvalidRangingRsps | unsignedInt | R | [docsIf3CmStatusInvalidRangingRsps/1.3.6.1.4.1.4491.2.1.20.1.1.1.7] [StatsCounter32] This attribute denotes the number of times the CM received invalid ranging response messages. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
InvalidRegRsps | unsignedInt | R | [docsIf3CmStatusInvalidRegRsps/1.3.6.1.4.1.4491.2.1.20.1.1.1.8] [StatsCounter32] This attribute denotes the number of times the CM received invalid registration response messages. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
T1Timeouts | unsignedInt | R | [docsIf3CmStatusT1Timeouts/1.3.6.1.4.1.4491.2.1.20.1.1.1.9] [StatsCounter32] This attribute denotes the number of times counter T1 expired in the CM. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
T2Timeouts | unsignedInt | R | [docsIf3CmStatusT2Timeouts/1.3.6.1.4.1.4491.2.1.20.1.1.1.10] [StatsCounter32] This attribute denotes the number of times counter T2 expired in the CM. Discontinuities in the value of this counter can occur at re-initialization of the managed system, and at other times as indicated by the value of ifCounterDiscontinuityTime for the CM MAC Domain interface. See [RFC2863]. |
- | 2.0 |
Device.DOCSIS.SpectrumAnalysis. | object | R | - | 2.0 | |
Enable | boolean | W | [docsIf3CmSpectrumAnalysisCtrlCmdEnable/1.3.6.1.4.1.4491.2.1.20.1.34.1] This attribute is used to enable or disable the spectrum analyzer feature. Setting this attribute to true triggers the CM to initiate measurements for the spectrum analyzer feature based on the other configuration attributes for the feature. By default, the feature is disabled unless explicitly enabled. Note that the feature may be disabled by the system under certain circumstances if the spectrum analyzer would affect critical services. In such a case, the attribute will return false when read, and will reject sets to true with an error. Once the feature is enabled, any change to this object’s configuration might not be effective until the feature is re-enabled again. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be false. |
- | 2.0 |
InactivityTimeout | int(0:86400) | W | [docsIf3CmSpectrumAnalysisCtrlCmdInactivityTimeout/1.3.6.1.4.1.4491.2.1.20.1.34.2] This attribute controls the length of time after the last spectrum analysis measurement before the feature is automatically disabled. If set to a value of 0, the feature will remain enabled until it is explicitly disabled. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be 300. |
- | 2.0 |
FirstSegmentCenterFrequency | unsignedInt | W | [docsIf3CmSpectrumAnalysisCtrlCmdFirstSegmentCenterFrequency/1.3.6.1.4.1.4491.2.1.20.1.34.3] This attribute controls the center frequency of the first segment for the spectrum analysis measurement. The frequency bins for this segment lie symmetrically to the left and right of this center frequency. If the number of bins in a segment is odd, the segment center frequency lies directly on the center bin. If the number of bins in a segment is even, the segment center frequency lies halfway between two bins. Changing the value of this attribute may result in changes to the Result table. Note that if this parameter is set to an invalid value, the device may return an error, or may adjust the value of the parameter to the closest valid value. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be 93000000. |
- | 2.0 |
LastSegmentCenterFrequency | unsignedInt | W | [docsIf3CmSpectrumAnalysisCtrlCmdLastSegmentCenterFrequency/1.3.6.1.4.1.4491.2.1.20.1.34.4] This attribute controls the center frequency of the last segment of the spectrum analysis measurement. The frequency bins for this segment lie symmetrically to the left and right of this center frequency. If the number of bins in a segment is odd, the segment center frequency lies directly on the center bin. If the number of bins in a segment is even, the segment center frequency lies halfway between two bins. The value of the LastSegmentCenterFrequency should be equal to the FirstSegmentCenterFrequency plus and integer number of segment spans as determined by the SegmentFrequencySpan. Changing the value of this attribute may result in changes to the Result table. Note that if this parameter is set to an invalid value, the device may return an error, or may adjust the value of the parameter to the closest valid value. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be 993000000. |
- | 2.0 |
SegmentFrequencySpan | unsignedInt(1000000:900000000) | W | [docsIf3CmSpectrumAnalysisCtrlCmdSegmentFrequencySpan/1.3.6.1.4.1.4491.2.1.20.1.34.5] This attribute controls the frequency span of each segment (instance) of the Result.{i} table. If set to a value of 0, then a default span will be chosen based on the hardware capabilities of the device. Segments are contiguous from the FirstSegmentCenterFrequency to the LastSegmentCenterFrequency and the center frequency for each successive segment is incremented by the SegmentFrequencySpan. The number of segments is (LastSegmentCenterFrequency - FirstSegmentCenterFrequency)/SegmentFrequencySpan + 1. A segment is equivalent to an instance in the Result table. The chosen SegmentFrequencySpan affects the number of entries in Result table. A more granular SegmentFrequencySpan may adversely affect the amount of time needed to query the table entries in addition to possibly increasing the acquisition time. Changing the value of this attribute may result in changes to Result table. Note that if this parameter is set to an invalid value, the device may return an error, or may adjust the value of the parameter to the closest valid value. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be 7500000. |
- | 2.0 |
NumBinsPerSegment | unsignedInt(2:2048) | W | [docsIf3CmSpectrumAnalysisCtrlCmdNumBinsPerSegment/1.3.6.1.4.1.4491.2.1.20.1.34.6] This parameter controls the number of bins collected by the measurement performed for each segment (instance) in the Result table. Note that if this parameter is set to an invalid value, the device may return an error, or may adjust the value of the parameter to the closest valid value. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be 256. |
- | 2.0 |
EquivalentNoiseBandwidth | unsignedInt(50:500) | W | [docsIf3CmSpectrumAnalysisCtrlCmdEquivalentNoiseBandwidth/1.3.6.1.4.1.4491.2.1.20.1.34.7] This parameter allows the user to request an equivalent noise bandwidth for the resolution bandwidth filter used in the spectrum analysis. This corresponds to the spectral width of the window function used when performing a discrete Fourier transform for the analysis. The window function which corresponds to a value written to this parameter may be obtained by reading the value of WindowFunction. If an unsupported value is requested, the device may return an error, or choose the closest valid value to the one which is requested. If the closest value is chosen, then a subsequent read of this parameter will return the actual value which is in use. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be 150. |
- | 2.0 |
WindowFunction | string | W | [docsIf3CmSpectrumAnalysisCtrlCmdWindowFunction/1.3.6.1.4.1.4491.2.1.20.1.34.8] [SpectrumAnalysisWindowFunction] This parameter controls or indicates the windowing function which will be used when performing the discrete Fourier transform for the analysis. The WindowFunction and the Equivalent Noise Bandwidth are related. If a particular WindowFunction is selected, then the EquivalentNoiseBandwidth for the function which is in use, will be reported by the EquivalentNoiseBandwidth parameter. Alternatively if an EquivalentNoiseBandwidth value is chosen then if a WindowFunction function representing that EquivalentNoiseBandwidth is defined in the CM, that value will be reported in WindowFunction, or a value of Other will be reported. Use of “modern” windowing functions not yet defined will likely be reported as Other. Enumeration of:
Note that all window functions may not be supported by all devices. If an attempt is made to set the object to an unsupported window function, or if writing of the WindowFunction is not supported, an error will be returned. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. |
- | 2.0 |
NumberOfAverages | unsignedInt(1:1000) | W | [docsIf3CmSpectrumAnalysisCtrlCmdNumberOfAverages/1.3.6.1.4.1.4491.2.1.20.1.34.9] This parameter controls the number of averages that will be performed on spectral bins. The average will be computed using the ‘leaky integrator’ method, where: reported bin value = alpha*accumulated bin values + (1-alpha)*current bin value. Alpha is one minus the reciprocal of the number of averages. For example, if N=25, then alpha = 0.96. A value of 1 indicates no averaging. Re-writing the number of averages will restart the averaging process. If there are no accumulated values, the accumulators are made equal to the first measured bin amplitudes. If an attempt is made to set the parameter to an unsupported number of averages, an error will be returned. See [CM-SP-CM-OSSIv3.1], Proactive Network Maintenance Information Model. The factory default value MUST be 1. |
- | 2.0 |
ResultNumberOfEntries | unsignedInt | R | The number of entries in the Result table. | - | 2.0 |
Device.DOCSIS.SpectrumAnalysis.Result.{i}. | object(0:) | R | [docsIf3CmSpectrumAnalysisMeasTable/1.3.6.1.4.1.4491.2.1.20.1.35.1] This table provides a list of spectral analysis measurements as performed across a range of center frequencies. The table is capable of representing a full scan of the spectrum. Each Result instance represents the spectral analysis around a single center frequency point in the spectrum. At most one entry in this table can exist with a given value for Frequency. |
- | 2.0 |
Frequency | int(-2147483648:2147483647) | R | [docsIf3CmSpectrumAnalysisMeasFrequency/1.3.6.1.4.1.4491.2.1.20.1.35.1.1] The center frequency of the spectral analysis span which is represented by this instance. | - | 2.0 |
AmplitudeData | hexBinary(0,2:4116) | R | [docsIf3CmSpectrumAnalysisMeasAmplitudeData/1.3.6.1.4.1.4491.2.1.20.1.35.1.2] [AmplitudeData] This parameter provides a list of the spectral amplitudes as measured at the center frequency specified by the Frequency. The frequency bins are ordered from lowest to highest frequencies covering the frequency span. Information about the center frequency, frequency span, number of bins and resolution bandwidth are included to provide context to the measurement point. |
- | 2.0 |
TotalSegmentPower | int | R | [docsIf3CmSpectrumAnalysisMeasTotalSegmentPower/1.3.6.1.4.1.4491.2.1.20.1.35.1.3] [TenthdB] This parameter provides the total RF power present in the segment with the center frequency equal to the Frequency and the span equal to the SegmentFrequencySpan. The value represents the sum of the spectrum power in all of the associated bins. The value is computed by summing power (not dB) values and converting the final sum to TenthdB. | - | 2.0 |
Device.Ethernet. | object | R | Ethernet object. This object models several Ethernet interface objects, each representing a different stack layer, including: Interface, Link, and VLANTermination. Interface is media-specific and models a port, the PHY layer, and the Channel Access Method (CAM) part of the MAC layer. Link is media-independent and models the Logical Link Control (LLC) layer. An “outer” VLANTermination, when present, is expected to be stacked on top of Link objects to receive and send frames with a configured VLANID. | - | 2.0 |
Device.Ethernet.Interface.{i}. | object(0:) | R | Ethernet interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). This table models physical Ethernet ports, but in terms of the interface stack it alsoonly models the PHY and MACConnection levelAccess Method of the Ethernet interface.interface MAC. A {{object: argument unnecessary when referring to current object}} is also required to model a full Ethernet device. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.0 |
MACAddress | string(:17) | R | [MACAddress] The MACunique Addressmanufacturer-assigned Ethernet hardware address of the interface.interface, also referred to as burned-in MAC address.Note: This is not necessarily the same as the Ethernet header source or destination MAC address,address used for higher-level protocols, which is associated with the IP interface and is modeled via the Ethernet.Link.{i}.MACAddress parameter. Its main purpose is the identification of a specific Ethernet interface; the information can also can be used to perform Wake on LAN. | - | 2.0 |
Device.Ethernet.Interface.{i}.Stats. | object | R | Throughput statistics for this interface. The CPE MUST reset the interface’s Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interface becomes operationally down due to a previous administrative down (i.e. the interface’s Status parameter transitions to a down state after the interface is disabled) or when the interface becomes administratively up (i.e. the interface’s Enable parameter transitions from false to true). Administrative and operational interface status is discussed in [Section 4.2.2/TR-181i2]. | - | 2.0 |
PacketsSent | unsignedLong | R | The total number of packetsEthernet frames transmitted out of the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsReceived | unsignedLong | R | The total number of packetsEthernet frames received on the interface. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsSent | unsignedInt | R | The total number of outbound packetsEthernet frames that could not be transmitted because of errors. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsReceived | unsignedInt | R | The total number of inbound packetsEthernet frames that contained errors preventing them from being delivered to a higher-layer protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsSent | unsignedLong | R | The total number of packetsEthernet frames requested for transmission which were not addressed to a multicast or broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsReceived | unsignedLong | R | The total number of receivedEthernet frames packets, delivered by this layer to a higher layer, which were not addressed to a multicast or broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsSent | unsignedInt | R | The total number of outbound packetsEthernet frames which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsReceived | unsignedInt | R | The total number of inbound packetsEthernet frames which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsSent | unsignedLong | R | The total number of packetsEthernet frames that higher-level protocols requested for transmission and which were addressed to a multicast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsReceived | unsignedLong | R | The total number of received packets,Ethernet frames, delivered by this layer to a higher layer, which were addressed to a multicast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsSent | unsignedLong | R | The total number of packetsEthernet frames that higher-level protocols requested for transmission and which were addressed to a broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsReceived | unsignedLong | R | The total number of received packets,Ethernet frames, delivered by this layer to a higher layer, which were addressed to a broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnknownProtoPacketsReceived | unsignedInt | R | The total number of packetsEthernet frames received via the interface which were discarded because of an unknown or unsupported protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Device.Ethernet.Link.{i}. | object(0:) | W | Ethernet link layer table (a stackable interface object as described in [Section 4.2/TR-181i2]). Table entries model the Logical Link Control (LLC) layer. It is expected that an Ethernet Link interface can be stacked above any lower-layer interface object capable of carrying Ethernet frames. At most one entry in this table can exist with a given value for Alias, or with a given value for Name, or with a given value for MACAddress. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias, Name and MACAddress such that the new entry does not conflict with any existing entries. |
- | 2.0 |
MACAddress | string(:17) | W | [MACAddress] The MAC address used for packets sent via this interface. Provides the source MAC address for outgoing traffic and the destination MAC address for incoming traffic. If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. Changes in 2.15:
|
- | 2.0 |
Device.Ethernet.Link.{i}.Stats. | object | R | Throughput statistics for this interface. link.The CPE MUST reset the interface’slink’s Stats parameters (unless otherwise stated in individual object or parameter descriptions) either when the interfacelink becomes operationally down due to a previous administrative down (i.e. the interface’slink’s Status parameter transitions to a down state after the interfacelink is disabled) or when the interfacelink becomes administratively up (i.e. the interface’slink’s Enable parameter transitions from false to true). Administrative and operational interfacelink status is discussed in [Section 4.2.2/TR-181i2]. | - | 2.0 |
BytesSent | unsignedLong | R | The total number of bytes transmitted out of the interface,link, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BytesReceived | unsignedLong | R | The total number of bytes received on the interface,link, including framing characters. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsSent | unsignedLong | R | The total number of packetsEthernet frames transmitted out of the interface.link. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
PacketsReceived | unsignedLong | R | The total number of packetsEthernet frames received on the interface.link. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsSent | unsignedInt | R | The total number of outbound packetsEthernet frames that could not be transmitted because of errors. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
ErrorsReceived | unsignedInt | R | The total number of inbound packetsEthernet frames that contained errors preventing them from being delivered to a higher-layer protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsSent | unsignedLong | R | The total number of packetsEthernet frames requested for transmission which were not addressed to a multicast or broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnicastPacketsReceived | unsignedLong | R | The total number of received packets,Ethernet frames, delivered by this layer to a higher layer, which were not addressed to a multicast or broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsSent | unsignedInt | R | The total number of outbound packetsEthernet frames which were chosen to be discarded even though no errors had been detected to prevent their being transmitted. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DiscardPacketsReceived | unsignedInt | R | The total number of inbound packetsEthernet frames which were chosen to be discarded even though no errors had been detected to prevent their being delivered. One possible reason for discarding such a packet could be to free up buffer space. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsSent | unsignedLong | R | The total number of packetsEthernet frames that higher-level protocols requested for transmission and which were addressed to a multicast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
MulticastPacketsReceived | unsignedLong | R | The total number of received packets,Ethernet frames, delivered by this layer to a higher layer, which were addressed to a multicast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsSent | unsignedLong | R | The total number of packetsEthernet frames that higher-level protocols requested for transmission and which were addressed to a broadcast address at this layer, including those that were discarded or not sent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
BroadcastPacketsReceived | unsignedLong | R | The total number of received packets,Ethernet frames, delivered by this layer to a higher layer, which were addressed to a broadcast address at this layer. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
UnknownProtoPacketsReceived | unsignedInt | R | The total number of packetsEthernet frames received via the interfacelink which were discarded because of an unknown or unsupported protocol. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Device.HPNA. | object | R | HPNA object that contains the Interface and Diagnostics objects. The HPNA (also known as HomePNA) industry standard [G.9954] defines peer to peer communication for home networking over existing coax cables and telephone wiring within the home. | - | 2.0 |
Device.HPNA.Diagnostics. | object | R | The HPNA Diagnostics object. | - | 2.0 |
PHYThroughput() | command | - | [ASYNC] HPNA PHY throughput diagnostics configuration and results. When diagnostics are requested, all HPNA nodes for which the Interface.{i}.AssociatedDevice.{i}.PHYDiagnosticsEnable parameter is set enter PHY diagnostics mode. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Interface | string(:256) | W | [MANDATORY] The value MUST be the Path Name of a row in the HPNA.Interface. table. This is the interface over which the test is to be
performed.
Changes in 2.15:
|
- | 2.12 |
⇒ NumPacketsInBurst | unsignedInt | W | [MANDATORY] Number of test packet in burst to be send during PHY diagnostics test
from each HPNA device to other HPNA device in the HPNA network.
Changes in 2.15:
|
- | 2.12 |
⇒ BurstInterval | unsignedInt | W | [MANDATORY] Test packet burst interval length (expressed in milliseconds).
Changes in 2.15:
|
- | 2.12 |
⇒ TestPacketPayloadLength | unsignedInt(0:1480) | W | [MANDATORY] Payload length in the test packets.
Changes in 2.15:
|
- | 2.12 |
⇒ PayloadEncoding | unsignedInt | W | [MANDATORY] HPNA payload encoding in PHY diagnostics. 0 is used for negotiated
payload between devices according to line conditions.
Changes in 2.15:
|
- | 2.12 |
⇒ PayloadDataGen | unsignedInt | W | [MANDATORY] Test packets payload data generator value.
Changes in 2.15:
|
- | 2.12 |
⇒ PayloadType | string | W | [MANDATORY] Test packets payload type. Enumeration of:
Changes in 2.15:
|
- | 2.12 |
⇒ PriorityLevel | unsignedInt(0:7) | W | [MANDATORY] Priority level of PHY diagnostics packets (0 lowest -7 highest).
Changes in 2.15:
|
- | 2.12 |
PerformanceMonitoring() | command | - | [ASYNC] HPNA performance monitoring configuration and results. Performance monitoring results are sampled from all nodes in the HPNA network. All packet related counters are sampled synchronized at all nodes in the HPNA network in order to derive packet loss calculations in the HPNA network. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Interface | string(:256) | W | [MANDATORY] The value MUST be the Path Name of a row in the HPNA.Interface. table. This is the interface over which the test is to be
performed.
Changes in 2.15:
|
- | 2.12 |
⇒ SampleInterval | unsignedInt | W | [MANDATORY] Time in seconds between automatic collection of performance monitoring data. A value of zero disables automatic collection of data. The CPE MAY impose a minimum sample interval, in which case an attempt to set a (non-zero) interval that is less than this minimum MUST set the interval to the minimum and MUST NOT be regarded as an error. If SampleInterval is a simple fraction of a day, e.g. 900 (a quarter of an hour) or 3600 (an hour), the CPE MAY choose to align sample intervals with time of day, but is not required to do so.
Changes in 2.15:
|
- | 2.12 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Nodes. | object | R | Per-node HPNA performance monitoring results. When automatic collection is enabled, i.e. SampleInterval is non-zero, the “current” interval is defined by the most recent automatic sample and the most recent subsequent manual sample, if any. When automatic collection is disabled, i.e. SampleInterval is zero, the “current” interval is defined by the three most recent manual samples. Note: Packets in statistics counters are Ethernet packets.
Changes in 2.15:
|
- | 2.12 |
⇐ Channels. | object | R | Per-channel HPNA performance monitoring results. Note: channels are unidirectional.
Changes in 2.15:
|
- | 2.12 |
Device.Ghn. | object | R | G.hn object that contains an Interface table for G.hn supported CPE. The ITU-T G.hn specifications [G.9960] and [G.9961] define Physical and MAC Layers for communication between two or more G.hn nodes in the home network over multiple wired media such as power line, phone line and coaxial cable. | - | 2.4 |
Device.Ghn.Interface.{i}. | object(0:) | R | G.hn interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). Each table entry models the PHY [G.9960] and MAC [G.9961] layers of a G.hn interface. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.4 |
ConnectionType | string | R | This parameter was DEPRECATED This parameter was DEPRECATED in 2.8.because it has been replaced by **{{param: non-existent ConnectionTypeMediumType}}**. This parameter is OBSOLETED in 2.14.
This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Enumeration of:
Changes in 2.15:
|
- | 2.4 |
Device.Ghn.Diagnostics. | object | R | The G.hn Diagnostics object. | - | 2.8 |
PHYThroughput() | command | - | [ASYNC] G.hn PHY throughput diagnostics configuration and results. When diagnostics are requested, all G.hn nodes for which the Interface.{i}.PHYThroughputDiagnosticsEnable parameter is set enter PHY diagnostics mode. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Interface | string | W | [MANDATORY] The value MUST be the Path Name of a row in the Ghn.Interface. table. The interface over which the test is to be performed.
Changes in 2.15:
|
- | 2.12 |
⇒ DiagnoseMACAddress | string(:17) | W | [MANDATORY] [MACAddress] The MAC address of the originating G.hn interface of the link that is being diagnosed. Note: This MAC address might belong to another node of the domain.
Changes in 2.15:
|
- | 2.12 |
PerformanceMonitoring() | command | - | [ASYNC] G.hn Performance Monitoring diagnostics configuration and results. When diagnostics are requested, all G.hn nodes for which the Interface.{i}.PerformanceMonitoringDiagnosticsEnable parameter is set enter PHY diagnostics mode. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Interface | string | W | [MANDATORY] The value MUST be the Path Name of a row in the Ghn.Interface. table. The interface over which the test is to be performed.
Changes in 2.15:
|
- | 2.12 |
⇒ DiagnoseMACAddress | string(:17) | W | [MANDATORY] [MACAddress] The MAC address of the originating G.hn interface of the link that is being diagnosed. Note: This MAC address might belong to another node of the domain.
Changes in 2.15:
|
- | 2.12 |
⇒ SampleInterval | unsignedInt | W | [MANDATORY] Time in seconds between automatic collection of performance monitoring data. A value of zero disables automatic collection of data. The node MAY impose a minimum sample interval, in which case an attempt to set a (non-zero) interval that is less than this minimum MUST set the interval to the minimum and MUST NOT be regarded as an error. If SampleInterval is a simple fraction of a day, e.g. 900 (a quarter of an hour) or 3600 (an hour), the device MAY choose to align sample intervals with time of day, but is not required to do so.
Changes in 2.15:
|
- | 2.12 |
⇒ SNRGroupLength | unsignedInt(1,2,4,8,16,32,64,128,256) | W | [MANDATORY] The number of sub-carriers in a group to be used for averaging SNR
values when providing SNR information for a channel.
Changes in 2.15:
|
- | 2.12 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Nodes. | object | R | Per-node G.hn performance monitoring results. When automatic collection is enabled, i.e. SampleInterval is non-zero, the “current” interval is defined by the most recent automatic sample and the most recent subsequent manual sample, if any. When automatic collection is disabled, i.e. SampleInterval is zero, the “current” interval is defined by the three most recent manual samples. Note: Packets in statistics counters are Ethernet packets.
Changes in 2.15:
|
- | 2.12 |
⇐ Channels. | object | R | Per-channel G.hn performance monitoring results. Note: channels are unidirectional.
Changes in 2.15:
|
- | 2.12 |
Device.HomePlug. | object | R | HomePlug object that contains the Interface table. The HomePlug industry standard [HPAV1.1] defines peer to peer communication over powerline medium. | - | 2.0 |
Device.HomePlug.Interface.{i}. | object(0:) | R | HomePlug interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). Each table entry models the PHY and MAC levels of a HomePlug interface [HPAV1.1]. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.0 |
Version | string(:16) | R | Indicates the HomePlug version of the interface. This element SHOULD be in the form of dot-delimited integers, where each successive integer represents a more minor category of variation. For example: “1.0” “1.1” |
- | 2.0 |
OtherNetworksPresent | string[](:64) | R | Comma-separated list (maximum number of characters 64) of strings. Indicates whether any other HomePlug networks are currently visible via this interface. Examples of valid list items include, but are not limited to: “HomePlugAV” “HomePlug1.0” “Other” |
- | 2.0 |
Device.UPA. | object | R | Universal Powerline Association [UPA-PLC]. This object contains the Interface and Diagnostics objects. | - | 2.0 |
Device.UPA.Diagnostics. | object | R | The UPA Diagnostics object. | - | 2.0 |
InterfaceMeasurement() | command | - | [ASYNC] This command provides access to either a Signal-to-Noise-Ratio (SNR) Port Measurement test or a Channel Frequency Response (CFR) Port Measurement test. The Type parameter is used to select which type of test to perform. CFR and SNR measurements are done between a two UPA devices (a local interface and a remote device belonging to the same network). | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Type | string | W | [MANDATORY] Indicates the type of port measurement test to be carried out. Enumeration of:
Changes in 2.15:
|
- | 2.12 |
⇒ Interface | string(:256) | W | [MANDATORY] The value MUST be the Path Name of a row in the UPA.Interface. table. This is the local UPA interface from which the test is to
be performed.
Changes in 2.15:
|
- | 2.12 |
⇒ Port | unsignedInt(0:65535) | W | [MANDATORY] PLC port being measured. This identifies which PLC connection to
measure between the local interface (indicated by Interface)
and the remote device (implied by Port).
Changes in 2.15:
|
- | 2.12 |
Device.WiFi. | object | R | The WiFi object is based on the WiFi AllianceIEEE 802.11 specifications ({{bibref: non-existent 802.11-2020}}). It defines interface objects (Radio and SSID), and application objects (AccessPoint and EndPoint). | - | 2.7 |
NeighboringWiFiDiagnostic() | command | - | [ASYNC] This command defines access to other WiFi SSIDs that this device is able to receive. | - | 2.12 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Result.{i}. | object(0:) | R | Neighboring SSID table. This table models the other WiFi SSIDs that this device is able to receive. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for BSSID. |
- | 2.12 |
⇐ DTIMPeriod | unsignedInt | R | The number of beacon intervals that elapse between transmission of Beacon frames containing a TIM element whose DTIM count field is 0. This value is transmitted in the DTIM Period field of beacon frames. {{bibref: non-existent 802.11-2020}} | - | 2.12 |
Reset() | command | - | This parametercommand represents a request to reset or reboot the WiFiWi-Fi sub-system without resetting or rebooting the device. | - | 2.12 |
Device.WiFi.MultiAP. | object | R | This object describes a Wi-Fi network containing 1 or more Access Point devices. This object is related to a Wi-Fi network that contains multiple Access Points (Multi-AP) and utilizes software logic to optimize that Wi-Fi network (typically via steering STAs, also known as Associated Devices, to the best Access Point). This object exposes the view of the Wi-Fi netwtork from the perspective of the Multi-AP Controller. The Wi-Fi Alliance EasyMesh solution is one example of managing a Multi-AP network.
This object and all sub-objects have been moved to new objects.
This object was DEPRECATED in 2.15 because it has moved to WiFi.DataElements.Network MultiAP objects. Changes in 2.15:
|
- | 2.13 |
Device.WiFi.DataElements. | object | R | This object represents the Wi-Fi Alliance Data Elements as defined in {{bibref: non-existent DataElements}}. with extended capabilities in additional objects whose names begin with MultiAP.
Changes in 2.15:
|
- | 2.13 |
Device.WiFi.DataElements.Network. | object | R | This object describes a Wi-Fi network containing 1 or more Access Point (AP) devices.
Changes in 2.15:
|
- | 2.15 |
ID | string | R | A unique identifier for this particular Wi-Fi network.
Changes in 2.15:
|
- | 2.15 |
TimeStamp | string | R | The time this group was collected. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
ControllerID | string | R | A unique identifier for a Multi-AP controller.
Changes in 2.15:
|
- | 2.15 |
MSCSDisallowedStaList | string(:17)[] | R | [MACAddress] Comma-separated list of MAC Addresses. List of STAs for which Mirrored Stream Classification Service (MSCS) operation is disallowed. | - | 2.15 |
SCSDisallowedStaList | string(:17)[] | R | [MACAddress] Comma-separated list of MAC Addresses. List of STAs for which Stream Classification Service (SCS) operation is disallowed. | - | 2.15 |
SSIDNumberOfEntries | unsignedInt | R | The number of entries in the SSID table. | - | 2.15 |
SetTrafficSeparation() | command | - | [ASYNC] This command allows or disallows EasyMesh traffic separation [Section 19.1/EasyMesh]. If Enable is true then the parameters defining traffic separation details can also be input with this command. This command applies to all EasyMesh Agent devices in the Wi-Fi network. This command can configure Device.{i}.SSIDtoVIDMapping.{i}. and Device.{i}.TrafficSeparationAllowed. Status is to be returned after implementation or failed implementation on all agents/devices/APs in this Multi-AP network. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Enable | boolean | W | [MANDATORY] : true: EasyMesh traffic separation is allowed. false: EasyMesh traffic separation is not allowed. |
- | 2.15 |
⇒ SSIDtoVIDMapping.{i}. | object(0:) | W | The Service Set Identifier (SSID) to VLAN ID (VID) mapping for EasyMesh traffic separation [EasyMesh]. Consists of a table of pairs of SSID and corresponding VID. If this input is not provided, then existing Device.{i}.SSIDtoVIDMapping.{i}. apply. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for SSID. |
- | 2.15 |
⇒ SSID | string | W | The SSID name. | - | 2.15 |
⇒ VID | unsignedInt(:4095) | W | The VLAN ID (VID). | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to allow or disallow EasyMesh traffic separation. Enumeration of:
|
- | 2.15 |
SetServicePrioritization() | command | - | [ASYNC] This command allows or disallows EasyMesh service prioritization [Section 20/EasyMesh]. If Enable is true then the parameters defining service prioritization details can also be input with this command. This command can configure Device.{i}.SPRule.{i}., Device.{i}.DSCPMap and Device.{i}.ServicePrioritizationAllowed. This command applies to all EasyMesh Agent devices in the Wi-Fi network. Status is to be returned after implementation or failed implementation on all agents/devices/APs in this Multi-AP network. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Enable | boolean | W | [MANDATORY] : true: EasyMesh service prioritization is allowed. false: EasyMesh service prioritization is not allowed. |
- | 2.15 |
⇒ DSCPMap | hexBinary(:64) | W | A hexadecimal string of 64 PCP values (one octet per value) corresponding to the DSCP markings 0x00 to 0x3F, ordered by increasing DSCP value. Each octet is in the range 0x00 – 0x07. This is used to select a PCP value if a Service Prioritization Rule specifies Rule Output: 0x08. If this input is not provided, then the existing Device.{i}.DSCPMap applies. |
- | 2.15 |
⇒ SPRule.{i}. | object(0:) | W | This object describes a list of service prioritization (SP) rules [EasyMesh]. If this input is not provided, then existing Device.{i}.SPRule.{i}. apply. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for ID. |
- | 2.15 |
⇒ ID | unsignedInt | W | Service prioritization rule Identifier. | - | 2.15 |
⇒ Precedence | unsignedInt(:254) | W | Rule Precedence – higher number means higher priority. | - | 2.15 |
⇒ Output | unsignedInt(:9) | W | Rule Output. The value of, or method used to select the 802.1Q C-TAG Priority Code Point (PCP) output value. | - | 2.15 |
⇒ AlwaysMatch | boolean | W | Indicates if the rule always matches. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to allow or disallow EasyMesh service prioritization. Enumeration of:
|
- | 2.15 |
SetPreferredBackhauls() | command | - | [ASYNC] This command sets preferred backhaul links for EasyMesh [EasyMesh] backhaul. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ PreferredBackhauls.{i}. | object(1:) | W | Indicates preferred backhaul links for EasyMesh [EasyMesh] backhaul. Consists of a table of pairs of MAC addresses. For a WI-Fi connection pair, an entry contains the BSSID and bSTA MAC address. For a wired connection pair, an entry contains the interface MAC addresses. This command applies to all EasyMesh Agent devices in the Wi-Fi network. Status is to be returned after implementation or failed implementation on all agents/devices/APs in this Multi-AP network. This table MUST contain at least 1 entry. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for BackhaulMACAddress. |
- | 2.15 |
⇒ BackhaulMACAddress | string(:17) | W | [MANDATORY] [MACAddress] The MAC address of the BSS, or similar Ethernet interface, on this preferred backhaul link. | - | 2.15 |
⇒ bSTAMACAddress | string(:17) | W | [MANDATORY] [MACAddress] The MAC address of the backhaul STA (bSTA), or similar Ethernet interface, on this preferred backhaul link. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to set preferred backhaul links. Enumeration of:
|
- | 2.15 |
SetSSID() | command | - | [ASYNC] This command specifies an SSID for fronthaul use across this Wi-Fi Multi-AP network, or on this single-AP. Also specifies the PassPhrase, whether to add or remove this SSID, and specifies the Band for each SSID. This command applies to all EasyMesh Agent devices in the Wi-Fi network, or to this AP in the single-AP case. This command can be used to set only PassPhrase if SSID matches an existing SSID.{i}.SSID for this Band for fronthaul use across this Wi-Fi Multi-AP network. This command can configure SSID.{i}. Status is to be returned after implementation or failed implementation on all agents/devices/APs in this Multi-AP network. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ SSID | string | W | [MANDATORY] The SSID for fronthaul use across this Wi-Fi Multi-AP network. | - | 2.15 |
⇒ AddRemove | string | W | [MANDATORY] Indicates whether to add or remove this SSID. true: add this SSID, false: remove this SSID. Status is to be returned after implementation or failed implementation on all agents/devices/APs in this Multi-AP network. If set to true, and this SSID already exists for this Band, then there is no change to the SSID, but the PassPhrase is set. |
- | 2.15 |
⇒ PassPhrase | string | W | The WPA2 Passphrase and/or SAE password for this SSID. | - | 2.15 |
⇒ Band | string[] | W | Comma-separated list of strings. The band(s) for which this SSID applies. Each list item is an enumeration of:
If this input is not provided, then a value of All applies. |
- | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to set the SSID. Enumeration of:
|
- | 2.15 |
SetMSCSDisallowed() | command | - | [ASYNC] This command disallows Mirrored Stream Classification Service (MSCS) service prioritization to particular STA(s). [EasyMesh] This command applies to all EasyMesh Agent devices in the Wi-Fi network. This command configures MSCSDisallowedStaList. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ MSCSDisallowedStaList | string(:17)[] | W | [MANDATORY] [MACAddress] Comma-separated list of MAC Addresses. List of STAs for which MSCS operation is disallowed. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to disallow MSCS service prioritization to particular STA(s) Enumeration of:
|
- | 2.15 |
SetSCSDisallowed() | command | - | [ASYNC] This command disallows Stream Classification Service (SCS) service prioritization to particular STA(s). [EasyMesh] This command applies to all EasyMesh Agent devices in the Wi-Fi network. This command can configure SCSDisallowedStaList. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ SCSDisallowedStaList | string(:17)[] | W | [MANDATORY] [MACAddress] Comma-separated list of MAC Addresses. List of STAs for which SCS operation is disallowed. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to disallow SCS service prioritization to particular STA(s). Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.SSID.{i}. | object(0:) | R | This object specifies SSIDs for fronthaul use across all agents in this Wi-Fi Multi-AP network, or on this single-AP. Also specifies the Band for each SSID. At most one entry in this table can exist with a given value for SSID. |
- | 2.15 |
SSID | string(:64) | R | The SSID for fronthaul use across this Wi-Fi Multi-AP network. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. |
- | 2.15 |
Band | string[] | R | Comma-separated list of strings. The band(s) (GHz) for which this SSID applies. Each list item is an enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.MultiAPSteeringSummaryStats. | object | R | The summary of statistics related to Multi-AP Steering for the Wi-Fi network. The counters contained in MultiAPSteeringSummaryStats are all reset on reboot. |
- | 2.15 |
NoCandidateAPFailures | unsignedLong | R | [StatsCounter64] Number of times Associated Devices should have been steered but weren’t because a better candidate AP couldn’t be found. | - | 2.15 |
BlacklistAttempts | unsignedLong | R | [StatsCounter64] Number of times a Blacklist steer was attempted. | - | 2.15 |
BlacklistSuccesses | unsignedLong | R | [StatsCounter64] Number of times an attempted Blacklist steer succeeded. | - | 2.15 |
BlacklistFailures | unsignedLong | R | [StatsCounter64] Number of times an attempted Blacklist steer failed. | - | 2.15 |
BTMAttempts | unsignedLong | R | [StatsCounter64] Number of times a BTM (BSS Transition Management; [802.11k]) steer was attempted. | - | 2.15 |
BTMSuccesses | unsignedLong | R | [StatsCounter64] Number of times an attempted BTM (BSS Transition Management; [802.11k]) steer succeeded. | - | 2.15 |
BTMFailures | unsignedLong | R | [StatsCounter64] Number of times an attempted BTM (BSS Transition Management; [802.11k]) steer failed. | - | 2.15 |
BTMQueryResponses | unsignedLong | R | [StatsCounter64] Number of asynchronous BTM (BSS Transition Management; [802.11k]) Queries for which a BTM Request was issued. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}. | object(1:) | R | Each instance of this object represents an individual Access Point device in the Wi-Fi network. This table MUST contain at least 1 entry. At most one entry in this table can exist with a given value for ID. Changes in 2.15:
|
- | 2.15 |
ID | string(:17) | R | [MACAddress] A unique identifier for this particular device within the Wi-Fi network as defined in {{bibref: non-existent DataElements}}. | - | 2.15 |
MultiAPCapabilities | base64(1) | R | The Multi-AP capabilities supported by this device as defined by the APCapability TLV in {{bibref: non-existent EasyMesh}}. | - | 2.15 |
ReportUnsuccessfulAssociations | boolean | W | Indicates whether the Multi-AP Agent or the single AP reports unsuccessful association attempts of client Stations (STAs) to the Multi-AP Controller. | - | 2.15 |
MaxReportingRate | unsignedInt | R | Maximum rate for reporting unsuccessful association attempts in attempts per minute. | - | 2.15 |
APMetricsReportingInterval | unsignedInt(:255) | W | AP Metrics Reporting Interval. 0: Do not report AP Metrics periodically; 1 – 255: AP Metrics reporting interval in seconds. |
- | 2.15 |
Manufacturer | string | R | Identifier of the manufacturer of the device. | - | 2.15 |
SerialNumber | string | R | Identifier of the particular Access Point device that is unique for the indicated model and manufacturer. This value MUST remain fixed over the lifetime of the device, including across firmware updates. |
- | 2.15 |
ManufacturerModel | string | R | Identifier of the manufacturer model to help the user more easily identify a particular piece of equipment. | - | 2.15 |
SoftwareVersion | string | R | Identifier of the software version currently installed in the Access Point device (i.e. version of the overall firmware). | - | 2.15 |
ExecutionEnv | string | R | Identifier of the execution environment (operating system) in the device. This parameter can be an entry in the table Device.SoftwareModules.ExecEnv.{i}.. | - | 2.15 |
DSCPMap | hexBinary(:64) | R | A hexadecimal string of 64 Priority Code Point (PCP) values (one octet per value) corresponding to the Differentiated Services Code Point (DSCP) markings 0x00 to 0x3F, ordered by increasing DSCP value. Each octet is in the range 0x00 – 0x07. This is used to select a PCP value if a Service Prioritization Rule specifies Rule Output: 0x08 | - | 2.15 |
MaxPrioritizationRules | unsignedInt(:255) | R | The maximum total number of service prioritization rules supported by the Agent. | - | 2.15 |
PrioritizationSupport | boolean | R | Indicates support for Service Prioritization. | - | 2.15 |
MaxVIDs | unsignedInt | R | Max Total Number of unique VLAN IDs (VIDs) the Multi-AP Agent supports. | - | 2.15 |
APMetricsWiFi6 | boolean | R | Associated Wi-Fi6 STA Status Inclusion Policy. true: Include Associated Wi-Fi6 STA Status TLV in AP Metrics Response. false: Do not include Associated Wi-Fi6 STA Status TLV [3] in AP Metrics Response. |
- | 2.15 |
CountryCode | string(2) | R | Two-character country code in which the Multi-AP Agent is operating according to [ISO3166-1]. The characters are encoded as UTF-8. | - | 2.15 |
LocalSteeringDisallowedSTAList | string(:17)[] | W | [MACAddress] Comma-separated list of MAC Addresses. The STAs for which local steering is disallowed. | - | 2.15 |
BTMSteeringDisallowedSTAList | string(:17)[] | W | [MACAddress] Comma-separated list of MAC Addresses. The STAs for which BSS Transition Management (BTM) steering is disallowed. | - | 2.15 |
DFSEnable | boolean | R | Indicates if Dynamic Frequency Selection (DFS) is enabled or disabled. | - | 2.15 |
ReportIndependentScans | boolean | W | Channel Scan Reporting Policy, Report Independent Channel Scans true: report Independent Channel Scans, false: do not report Independent Channel Scans unless explicitly requested in a Channel Scan Request. |
- | 2.15 |
AssociatedSTAinAPMetricsWiFi6 | boolean | W | For EasyMesh [EasyMesh], this is the Associated Wi-Fi6 STA Status Inclusion Policy. true: Include Associated Wi-Fi6 STA Status TLV in AP Metrics Response; false: Do not include Associated Wi-Fi6 STA Status TLV in AP Metrics Response. |
- | 2.15 |
MaxUnsuccessfulAssociationReportingRate | unsignedInt | W | For EasyMesh [EasyMesh], this is the maximum rate for reporting unsuccessful association attempts (in attempts per minutes). | - | 2.15 |
STASteeringState | boolean | R | Indicates if EasyMesh [EasyMesh] controller-initiated station steering is disallowed or allowed on this device. true: EasyMesh controller-initiated station steering disallowed; false: EasyMesh controller-initiated station steering allowed. |
- | 2.15 |
CoordinatedCACAllowed | boolean | W | Allow or disallow the use of EasyMesh [EasyMesh] Coordinated Channel Availability Check (CAC) on this device. true: allowed; false: disallowed. |
- | 2.15 |
TrafficSeparationAllowed | boolean | R | This parameter indicates if EasyMesh traffic separation [Section 19.1/EasyMesh] is allowed or disallowed. | - | 2.15 |
ServicePrioritizationAllowed | boolean | R | This parameter indicates if EasyMesh service prioritization [Section 20/EasyMesh] is allowed or disallowed. | - | 2.15 |
Default8021QNumberOfEntries | unsignedInt | R | The number of entries in the Default8021Q table. | - | 2.15 |
SSIDtoVIDMappingNumberOfEntries | unsignedInt | R | The number of entries in the SSIDtoVIDMapping table. | - | 2.15 |
CACStatusNumberOfEntries | unsignedInt | R | The number of entries in the CACStatus table. | - | 2.15 |
IEEE1905SecurityNumberOfEntries | unsignedInt | R | The number of entries in the IEEE1905Security table. | - | 2.15 |
SPRuleNumberOfEntries | unsignedInt | R | The number of entries in the SPRule table. | - | 2.15 |
AnticipatedChannelsNumberOfEntries | unsignedInt | R | The number of entries in the AnticipatedChannels table. | - | 2.15 |
AnticipatedChannelUsageNumberOfEntries | unsignedInt | R | The number of entries in the AnticipatedChannelUsage table. | - | 2.15 |
SetSTASteeringState() | command | - | [ASYNC] Disallow or allow EasyMesh [EasyMesh] controller-initiated station (STA) steering on this device. This command can configure STASteeringState. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Disallowed | boolean | W | [MANDATORY] : true: EasyMesh controller-initiated station steering disallowed; false: EasyMesh controller-initiated station steering allowed. |
- | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to allow or disallow EasyMesh controller-initiated station steering. Enumeration of:
|
- | 2.15 |
SetDFSState() | command | - | [ASYNC] Enables/disables the use of Dynamic Frequency Selection (DFS) channels on this device. This command can configure DFSEnable. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DFSEnable | boolean | W | [MANDATORY] : true: the use of Dynamic Frequency Selection (DFS) channels is allowed; false: the use of Dynamic Frequency Selection (DFS) channels is disallowed; |
- | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to allow or disallow the use of Dynamic Frequency Selection (DFS) channels. Enumeration of:
|
- | 2.15 |
SetAnticipatedChannelPreference() | command | - | [ASYNC] This command requests to set the Anticipated Channel Preference. The operating classes, and list of channels for each operating class, are input. For 2.4GHz and 5GHz bands, only 20MHz operating classes are valid inputs. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ OpClass | unsignedInt(:255) | W | [MANDATORY] The Operating Class per [Table E-4/802.11-2020] For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the operating class identifies the band and channel width. |
- | 2.15 |
⇒ ChannelList | unsignedInt(:255)[] | W | [MANDATORY] Comma-separated list of unsigned integers (up to 255). The channel numbers in this Operating Class for which the capability is being described. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to set the anticipated channel preference. Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Default8021Q.{i}. | object(0:) | W | The default 802.1Q settings for EasyMesh service prioritization [EasyMesh]. At most one entry in this table can exist with a given value for PrimaryVID. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for PrimaryVID such that the new entry does not conflict with any existing entries. |
- | 2.15 |
Enable | boolean | W | Enables or disables default 802.1Q settings. | false | 2.15 |
PrimaryVID | unsignedInt(:4095) | W | The primary 802.1Q C-TAG (VLAN ID). If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. |
- | 2.15 |
DefaultPCP | unsignedInt(:7) | W | The default Priority Code Point (PCP). | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.SSIDtoVIDMapping.{i}. | object(0:) | R | The Service Set Identifier (SSID) to VLAN ID mapping for EasyMesh traffic separation [EasyMesh]. At most one entry in this table can exist with a given value for SSID. |
- | 2.15 |
SSID | string(:64) | R | The SSID. | - | 2.15 |
VID | unsignedInt(:4095) | R | The VLAN ID (VID). | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.CACStatus.{i}. | object(0:) | R | Latest Channel Availability Check (CAC) Status Report from the device. At most one entry in this table can exist with a given value for TimeStamp. |
- | 2.15 |
TimeStamp | dateTime | R | The time this group was collected. | - | 2.15 |
CACAvailableChannelNumberOfEntries | unsignedInt | R | The number of entries in the CACAvailableChannel table. | - | 2.15 |
CACNonOccupancyChannelNumberOfEntries | unsignedInt | R | The number of entries in the CACNonOccupancyChannel table. | - | 2.15 |
CACActiveChannelNumberOfEntries | unsignedInt | R | The number of entries in the CACActiveChannel table. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.CACStatus.{i}.CACAvailableChannel.{i}. | object(0:) | R | This object describes available channels identified by Channel Availability Check (CAC). At most one entry in this table can exist with a given value for OpClass. |
- | 2.15 |
OpClass | unsignedInt(:255) | R | Operating class of an available channel, from [Table E-4/802.11-2020]. | - | 2.15 |
Channel | unsignedInt(:255) | R | Single channel number of an available channel in the given operating class. | - | 2.15 |
Minutes | unsignedInt(:65535) | R | Minutes since CAC was completed identifying available channel. Equals zero for non-DFS channels. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.CACStatus.{i}.CACNonOccupancyChannel.{i}. | object(0:) | R | This object describes channels identified by Channel Availability Check (CAC) that may not be occupied. At most one entry in this table can exist with a given value for OpClass. |
- | 2.15 |
OpClass | unsignedInt(:255) | R | Operating class of a channel that is in the non-occupancy list, from [Table E-4/802.11-2020]. | - | 2.15 |
Channel | unsignedInt(:255) | R | Single channel number in the operating class on which the radar was detected. | - | 2.15 |
Seconds | unsignedInt(:65535) | R | Seconds remaining in the non-occupancy duration for the channel specified by the operating class and channel pair. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.CACStatus.{i}.CACActiveChannel.{i}. | object(0:) | R | This object describes channels with ongoing Channel Availability Check (CAC). At most one entry in this table can exist with a given value for OpClass. |
- | 2.15 |
OpClass | unsignedInt(:255) | R | Operating class of a channel that has ongoing CAC, from [Table E-4/802.11-2020]. | - | 2.15 |
Channel | unsignedInt(:255) | R | Single channel number in the operating class that has an ongoing CAC. | - | 2.15 |
Countdown | unsignedInt | R | Seconds remaining to complete the CAC. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.SPRule.{i}. | object(0:) | R | This object describes a list of service prioritization (SP) rules [EasyMesh]. At most one entry in this table can exist with a given value for ID. |
- | 2.15 |
ID | unsignedInt | R | Service prioritization rule Identifier. | - | 2.15 |
Precedence | unsignedInt(:254) | R | Rule Precedence – higher number means higher priority. | - | 2.15 |
Output | unsignedInt(:9) | R | Rule Output. The value of, or method used to select, the 802.1Q C-TAG Priority Code Point (PCP) output value. | - | 2.15 |
AlwaysMatch | boolean | R | Indicates if the rule always matches. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.IEEE1905Security.{i}. | object(0:) | R | This object describes the IEEE 1905 security capabilities. At most one entry in this table can exist with a given value for OnboardingProtocol. |
- | 2.15 |
OnboardingProtocol | unsignedInt | R | Onboarding protocols supported; 0: 1905 Device. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. |
- | 2.15 |
IntegrityAlgorithm | unsignedInt | R | Message integrity algorithms supported. 0: HMAC-SHA256. |
- | 2.15 |
EncryptionAlgorithm | unsignedInt | R | Message encryption algorithms supported. 0: AES-SIV. |
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.AnticipatedChannels.{i}. | object(0:) | R | This object contains a table of Wi-Fi 6 [802.11ax] operating classes, and channels within those operating classes, which have anticipated channel preference. Operating Class contains an enumerated value from [Table E-4/802.11-2020]}. At most one entry in this table can exist with a given value for OpClass. |
- | 2.15 |
OpClass | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020]. Note that the operating class identifies the band and channel width. This changed from readOnly to readWrite in version 2.15. |
- | 2.15 |
ChannelList | unsignedInt(:255)[] | R | Comma-separated list of unsigned integers (up to 255). The channel numbers in this Operating Class. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.AnticipatedChannelUsage.{i}. | object(0:) | R | This object reports Wi-Fi 6 [802.11ax] anticipated medium usage on channels (and subsets of those channels) on which the device is operating. At most one entry in this table can exist with a given value for OpClass. |
- | 2.15 |
OpClass | unsignedInt(:255) | R | The operating class per [Table E-4/802.11-2020]. | - | 2.15 |
Channel | unsignedInt(:255) | R | The channel number in the given operating class of the channel on which the anticipated channel usage is reported. | - | 2.15 |
ReferenceBSSID | string(:17) | R | [MACAddress] Reference BSSID. Start Time values in this object are referenced to the Time Sync Function (TSF) timer value indicated in the Timestamp field in Beacon frames transmitted by this BSSID on the channel. | - | 2.15 |
EntryNumberOfEntries | unsignedInt | R | The number of entries in the Entry table. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.AnticipatedChannelUsage.{i}.Entry.{i}. | object(0:) | R | This object reports an entry for anticipated channel usage [802.11ax]. At most one entry in this table can exist with a given value for BurstStartTime. |
- | 2.15 |
BurstStartTime | hexBinary(4) | R | Least significant 4 octets of the TSF timer of the Reference BSSID, at the start of the anticipated first burst of channel usage. Note: a burst is a continuous or quasi-continuous period of channel usage. For IEEE 802.11 transmissions, a burst might comprise only one PPDU, or multiple closely spaced PPDUs. |
- | 2.15 |
BurstLength | unsignedInt | R | Duration of each burst of channel usage in microseconds. | - | 2.15 |
Repetitions | unsignedInt | R | Number of repetitions of the burst of channel usage; 0 = single burst, 2^32-1 = indefinite/unknown. |
- | 2.15 |
BurstInterval | unsignedInt | R | Interval between two successive bursts of channel usage in microseconds; set to zero if Repetitions is zero. | - | 2.15 |
RUBitmask | hexBinary(2:10) | R | Bitmask of 26-tone Resource Units (RUs) defined in [Section 27.3.2.2/802.11ax], where the (i-1)th bit position is set to one if the nominal bandwidth of the channel usage corresponding to this entry fully or partially overlaps with the RUi, and is otherwise set to zero. | - | 2.15 |
TransmitterIdentifier | string(:17) | R | [MACAddress] One of: MAC address: if the entry corresponds to channel usage by a single client STA associated to an AP of the Agent; BSSID: if the entry corresponds to channel usage by multiple or unspecified client STAs associated to an AP of the Agent; BSS Color: (first 42-bits are zero) if the channel usage is caused by a source external to the BSSs operated by the Agent and the BSSID can’t be decoded (since frame sent at high MCS) but the BSS Color in the PHY headers could still be identified; Zero: if the channel usage is caused by a source external to the BSSs operated by the Agent. |
- | 2.15 |
PowerLevel | int | R | Indicates maximum transmit power during each channel usage burst in dBm; equal to 255 when unknown or when the entry corresponds to multiple transmitters with different transmit powers | - | 2.15 |
ChannelUsageReason | string | R | The reason for this anticipated channel usage. Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.MultiAPDevice. | object | R | This object represents an individual Access Point device. | - | 2.15 |
ManufacturerOUI | string(6) | R | Organizationally unique identifier of the Access Point device manufacturer. Represented as a six hexadecimal-digit value using all upper-case letters and including any leading zeros. Possible patterns:
The value MUST be a valid OUI as defined in [OUI]. This value MUST remain fixed over the lifetime of the device, including across firmware updates. |
- | 2.15 |
LastContactTime | dateTime | R | The last time that the Access Point device was contacted via the Multi-AP control protocol. | - | 2.15 |
AssocIEEE1905DeviceRef | string | R | The value MUST be the Path Name of a row in the IEEE1905.AL.NetworkTopology.IEEE1905Device. table. If the referenced object is deleted, the parameter value MUST be set to an empty string. AssocIEEE1905DeviceRef is a reference to the IEEE 1905.1 Network Topology Device. Since IEEE 1905.1 is a common protocol used by Multi-AP Controllers for communications, this parameter allows the MultiAP portion of the data model to reference the associated IEEE 1905.1 portion of the data model. | - | 2.15 |
EasyMeshControllerOperationMode | string | R | This parameter represents the status of Wi-Fi CERTIFIED EasyMeshTM controller functionality. Enumeration of:
|
- | 2.15 |
EasyMeshAgentOperationMode | string | R | This parameter represents the status of Wi-Fi CERTIFIED EasyMeshTM agent functionality. Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.MultiAPDevice.Backhaul. | object | R | This object represents an individual Access Point device’s Backhaul and unique aspects in the Wi-Fi network. The endpoints of the backhaul interface are represented by the (Device’s ID and interface MAC Address). This object represents the upward view of the backhaul interface. The two endpoints of the backhaul interface are - (BackhaulDeviceID, BackhaulMACAddress) of the uplinked Backhaul Device - MACAddress of this Access Point Device BackhaulDeviceID / BackhaulMACAddress <– LinkType — < MACAddress an empty string is reserved for the Backhaul instance that represents the Multi-AP Controller. |
- | 2.15 |
LinkType | string | R | The medium being used to backhaul this Access Point Device to the Backhaul Access Point Device. The None value is reserved for the Backhaul instance that represents the Multi-AP Controller. Enumeration of:
|
- | 2.15 |
BackhaulMACAddress | string(:17) | R | [MACAddress] The MAC Address at the far end of the backhaul link of the interface on the network that is providing a backhaul for this Access Point Device. This along with BackhaulDeviceID, helps to identfy the backhaul interface endpoint. An empty string is reserved for the Backhaul instance that represents the Multi-AP Controller. |
- | 2.15 |
BackhaulDeviceID | string(:17) | R | [MACAddress] The Device’s ID of the Device on the network that is providing a Backhaul Link for this Access Point Device. | - | 2.15 |
MACAddress | string(:17) | R | [MACAddress] The MAC Address at the near end of the backhaul link of this Access Point Device’s backhaul interface that is connecting via LinkType to BackhaulMACAddress of the Backhaul Device identified by BackhaulDeviceID. | - | 2.15 |
CurrentOperatingClassProfileNumberOfEntries | unsignedInt | R | The number of entries in the CurrentOperatingClassProfile table. | - | 2.15 |
SteerWiFiBackhaul() | command | - | [ASYNC] This command requests the Wi-Fi backhaul link to be steered to associate to a different BSS when the device is working as a bridge in a mesh network. The device needs to already have the necessary credentials for the switch to happen. The TargetBSS should be an instance of a Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.BSSID. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ TargetBSS | string(:17) | W | [MANDATORY] [MACAddress] Basic Service Set Identifier (BSSID) of the target BSS which the associated device(s) is to be associated to. | - | 2.15 |
⇒ Channel | unsignedInt | W | The number of the Wi-Fi channel the backhaul BSS is to be associated to. If Channel is not specified, then the radio is to determine which channel to use to associate to the requested SSID. | - | 2.15 |
⇒ TimeOut | unsignedInt | W | [MANDATORY] The maximum timeout for this backhaul steering to occur in milliseconds. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the response to the Wi-Fi backhaul steering request. Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.MultiAPDevice.Backhaul.CurrentOperatingClassProfile.{i}. | object(0:) | R | Describes one of the current Operating Classes in use by this Radio. One Opeating Class is indicated for each current Operating Channel Bandwidth. The Channel indicated for the 20 MHz Operating Class is equal to the current primary channel. At most one entry in this table can exist with a given value for Class. |
- | 2.15 |
Class | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020] that this radio is currently operating on. | - | 2.15 |
Channel | unsignedInt(:255) | R | This Channel number in the Operating Class that this Radio is currently operating on. | - | 2.15 |
TxPower | int(-127:127) | R | Nominal Transmit Power EIRP that this radio is currently using for the current Channel in the Opeating Class. Represented as 2’s complement signed integer in units of decibels relative to 1 mW (dBm). |
- | 2.15 |
TimeStamp | dateTime | R | The time this group was collected. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.MultiAPDevice.Backhaul.Stats. | object | R | This object represents the statistics of the backhaul interface view from the current Device’s ID | - | 2.15 |
BytesSent | unsignedLong | R | [StatsCounter64] The total number of bytes transmitted across the backhaul medium (as identified by the value of the LinkType parameter), including framing characters. | - | 2.15 |
BytesReceived | unsignedLong | R | [StatsCounter64] The total number of bytes received across the backhaul medium (as identified by the value of the LinkType parameter), including framing characters. | - | 2.15 |
PacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets transmitted across the backhaul medium (as identified by the value of the LinkType parameter), including framing characters. | - | 2.15 |
PacketsReceived | unsignedLong | R | [StatsCounter64] The total number of packets received across the backhaul medium (as identified by the value of the LinkType parameter), including framing characters. | - | 2.15 |
ErrorsSent | unsignedLong | R | [StatsCounter64] The total number of outbound packets that could not be transmitted because of errors. | - | 2.15 |
ErrorsReceived | unsignedLong | R | [StatsCounter64] The total number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol. | - | 2.15 |
LinkUtilization | unsignedInt(:100) | R | Current utilization (expressed in %) of the medium (as identified by the value of the LinkType parameter) being used to backhaul this Access Point device to the Multi-AP Controller. A value of 0 is used for the Stats instance that represents the Access Point on the Multi-AP Controller. | - | 2.15 |
SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength of the backhaul link of the Access Point (AP) to the Multi-AP Controller, measured in dBm. RCPI threshold is encoded per [Table 9-176/802.11-2020]. The value of this parameter is indeterminate if the value of the LinkType parameter is anything other than Wi-Fi. | - | 2.15 |
LastDataDownlinkRate | unsignedInt | R | The data transmit rate in kbps that was most recently used for transmission of data from the access point to the associated device. | - | 2.15 |
LastDataUplinkRate | unsignedInt | R | The data transmit rate in kbps that was most recently used for transmission of data from the associated device to the access point. | - | 2.15 |
TimeStamp | dateTime | R | The time this group was collected. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}. | object(1:) | R | This object represents all of the individual Radios contained within the identified Access Point device known to the controller. This table MUST contain at least 1 entry. At most one entry in this table can exist with a given value for ID. Changes in 2.15:
|
- | 2.15 |
ID | base64(6) | R | A unique identifier for this particular Radio within the identified Access Point as defined in {{bibref: non-existent DataElements}}. | - | 2.15 |
Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power measured for the primary operating channel. Encoded as defined for ANPI in {{bibref: non-existent 802.11-2020}}. | - | 2.15 |
Utilization | unsignedInt(0:255) | R | (Total Channel Utililzation) The percentage of time (linearly scaled with 255 representing 100%) that the Access Point device sensed the medium was busy, as indicated by either the physical or virtual carier sense (CS) mechanism. This is essentially the amount of time spent transmiting (both successful and failed transmissions), receiving (both local and non-local transmissions), and processing noise.noise [Section 9.4.2.27/802.11-2020].When more than one channel is in use for the BSS operating on the radio, the Utilization value is calculated only for the primary channel. | - | 2.15 |
TrafficSeparationCombinedFronthaul | boolean | R | Indicates traffic separation on combined fronthaul and Profile-1 backhaul support [EasyMesh]. | - | 2.15 |
TrafficSeparationCombinedBackhaul | boolean | R | Indicates traffic separation on combined Profile-1 backhaul and Profile-2 backhaul support [EasyMesh]. | - | 2.15 |
SteeringPolicy | unsignedInt(:2) | W | Steering Policy: 0: Agent Initiated Steering Disallowed; 1: Agent Initiated Receive Channel Power Indicator (RCPI)-based Steering Mandated; 2: Agent Initiated RCPI-based Steering Allowed. |
- | 2.15 |
ChannelUtilizationThreshold | unsignedInt(:255) | W | Channel Utilization Threshold (defined per Basic Service Set (BSS) Load element [Section 9.4.2.27/802.11-2020].). | - | 2.15 |
RCPISteeringThreshold | unsignedInt(:220) | W | RCPI Steering Threshold (encoded per [Table 9-176/802.11-2020]). | - | 2.15 |
STAReportingRCPIThreshold | unsignedInt(:220) | W | Station (STA) Metrics Reporting RCPI Threshold. 0: Do not report STA Metrics based on RCPI threshold. 1 – 220: RCPI threshold (encoded per [Table 9-176/802.11-2020]). |
- | 2.15 |
STAReportingRCPIHysteresisMarginOverride | unsignedInt | W | STA Metrics Reporting RCPI Hysteresis Margin Override. 0: Use Agent’s implementation-specific default RCPI Hysteresis margin; 0: RCPI hysteresis margin value. This field is coded as an unsigned integer in units of decibels (dB). |
- | 2.15 |
ChannelUtilizationReportingThreshold | unsignedInt | W | AP Metrics Channel Utilization Reporting Threshold. 0: Do not report AP Metrics based on Channel utilization threshold; 0: AP Metrics Channel Utilization Reporting Threshold (similar to channel utilization measurement in [Section 9.4.2.27/802.11-2020]). |
- | 2.15 |
AssociatedSTATrafficStatsInclusionPolicy | boolean | W | Associated STA Traffic Stats Inclusion Policy. true: Include Associated STA Traffic Stats TLV in AP Metrics Response. false: Do not include Associated STA Traffic Stats Type-Length-Value (TLV) in AP Metrics Response; |
- | 2.15 |
AssociatedSTALinkMetricsInclusionPolicy | boolean | W | Associated STA Link Metrics Inclusion Policy. true: Include Associated STA Link Metrics TLV in AP Metrics Response. false: Do not include Associated STA Link Metrics TLV in AP Metrics Response; |
- | 2.15 |
ChipsetVendor | string | R | A string identifying the Wi-Fi chip vendor of this radio in the device. | - | 2.15 |
APMetricsWiFi6 | boolean | R | Associated Wi-Fi6 STA Status Inclusion Policy. true: include Associated Wi-Fi6 STA Status TLV in AP Metrics Response. false: do not include Associated Wi-Fi6 STA Status TLV [3] in AP Metrics Response. |
- | 2.15 |
DisAllowedOpClassChannelsNumberOfEntries | unsignedInt | R | The number of entries in the DisAllowedOpClassChannels table. | - | 2.15 |
ChannelScanRequest() | command | - | [ASYNC] Request to initiate a channel scan. The operating classes, and list of channels for each operating class, are input. For 2.4GHz and 5GHz bands, only 20MHz operating classes are valid inputs. This command should result in updating Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ OpClass | unsignedInt(:255) | W | [MANDATORY] The Operating Class per [Table E-4/802.11-2020] For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the operating class identifies the band and channel width. |
- | 2.15 |
⇒ ChannelList | unsignedInt(:255)[] | W | [MANDATORY] Comma-separated list of unsigned integers (up to 255). The channel numbers in this Operating Class for which the capability is being described. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to initiate a channel scan. Enumeration of:
|
- | 2.15 |
RadioEnable() | command | - | [ASYNC] Request to enable or disable this radio. This command can result in updating Enabled. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Enable | boolean | W | [MANDATORY] : true: this radio is to be enabled. false: this radio is to be disabled. |
- | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to enable or disable this radio. Enumeration of:
|
- | 2.15 |
SetTxPowerLimit() | command | - | [ASYNC] This command sets the upper limit on transmit power TransmitPowerLimit for this radio and OperatingClass. This command can configure CurrentOperatingClassProfile.{i}.TransmitPowerLimit. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ TransmitPowerLimit | int(-128:127) | W | [MANDATORY] This is the upper limit on nominal transmit Equivalent Isotropically Radiated Power (EIRP) that this radio can use for the OperatingClass. In units of decibels relative to 1 mW dBm. | - | 2.15 |
⇒ OperatingClass | unsignedInt(:255) | W | [MANDATORY] The Operating Class per [Table E-4/802.11-2020] of the radio. Note that the Operating Class identifies the band and channel width. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to set a transmit power limit. Enumeration of:
|
- | 2.15 |
SetSpatialReuse() | command | - | [ASYNC] This command sets the spatial reuse configuration of this radio. Applies only to Wi-Fi 6 and possibly later generations of radios. Acronyms: Spatial Reuse Group (SRG), Overlapping Basic Service Set (OBSS), Preamble Detection (PD). This command can configure SpatialReuse.. If some input parameter(s) are not provided, then the corresponding existing parameter in SpatialReuse. applies. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ BSSColor | unsignedInt | W | The value of the BSS Color subfield of the HEOperations.BSSColorInformation field being transmitted by BSSs operating on this radio. (EasyMesh TLV Field: BSS Color) | - | 2.15 |
⇒ HESIGASpatialReuseValue15Allowed | boolean | W | Indicates if the Agent is allowed to set HESIGA.SpatialReuse field to value 15 (PSR_AND_NON_SRG_OBSS_PD_PROHIBITED) in HE PPDU transmissions of this radio. (EasyMesh TLV Field: HESIGA_Spatial_reuse_value15_allowed) true: allowed; false: disallowed. |
- | 2.15 |
⇒ SRGInformationValid | boolean | W | This field indicates whether the SRG Information fields (SRG OBSS PD Min Offset, SRG OBSS PD Max Offset, SRG BSS Color Bitmap and SRG Partial BSSID Bitmap) in this command are valid. (EasyMesh TLV Field: SRG Information Valid) true: SRG Information fields valid; false: SRG Information fields not valid. |
- | 2.15 |
⇒ NonSRGOffsetValid | boolean | W | This field indicates whether the Non-SRG OBSSPD Max Offset field in this command is valid. (EasyMesh TLV Field: Non-SRG Offset Valid) true: Non-SRG Max Offset field valid; false: Non-SRG Max Offset field not valid. |
- | 2.15 |
⇒ PSRDisallowed | boolean | W | Indicates if the Agent is disallowed to use Parameterized Spatial Reuse (PSR)-based Spatial Reuse for transmissions by the specified radio. (EasyMesh TLV Field: PSR Disallowed) true: PSR disallowed; false: PSR allowed. |
- | 2.15 |
⇒ NonSRGOBSSPDMaxOffset | unsignedInt | W | The value of dot11NonSRGAPOBSSPDMaxOffset (i.e the Non-SRG OBSSPD Max Offset value being used to control the transmissions of the specified radio). (EasyMesh TLV Field: Non-SRG OBSSPD Max Offset) This field is valid only if NonSRGOffsetValid is true. |
- | 2.15 |
⇒ SRGOBSSPDMinOffset | unsignedInt | W | The value of dot11SRGAPOBSSPDMinOffset (i.e. the SRG OBSSPD Min Offset value being used to control the transmissions of the specified radio). (EasyMesh TLV Field: SRG OBSSPD Min Offset) This field is valid only if SRGInformationValid is true. |
- | 2.15 |
⇒ SRGOBSSPDMaxOffset | unsignedInt | W | The value of dot11SRGAPOBSSPDMaxOffset (i.e. the SRG OBSSPD Max Offset value being used to control the transmissions of the specified radio). (EasyMesh TLV Field: SRG OBSSPD Max Offset) This field is valid only if SRGInformationValid is true. |
- | 2.15 |
⇒ SRGBSSColorBitmap | hexBinary(8) | W | The value of dot11SRGAPBSSColorBitmap (i.e. the SRG BSS Color Bitmap being used to control the tranmissions of the specified radio). (EasyMesh TLV Field: SRG BSS Color Bitmap) This field is valid only if SRGInformationValid is true. |
- | 2.15 |
⇒ SRGPartialBSSIDBitmap | hexBinary(8) | W | The value of dot11SRGAPBSSIDBitmap (i.e. the SRG Partial BSSID Color Bitmap being used to control the transmissions of the specified radio). (EasyMesh TLV Field: SRG Partial BSSID Bitmap) This field is valid only if SRGInformationValid is true. Note: See rules in section 26.10.2.3 of [17] regarding the members of an SRG. |
- | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to set the spatial reuse configuration of this radio. Enumeration of:
|
- | 2.15 |
WiFiRestart() | command | - | [ASYNC] Request a restart of the Wi-Fi subsystem. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to restart the Wi-Fi subsystem. Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult.{i}. | object(0:) | R | The list of neighboring Access Points discovered by a Radio organized per Operating Class and Channel tuple. | - | 2.14 |
TimeStamp | string | R | The timestamp of the last scan. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.14 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult.{i}.OpClassScan.{i}. | object(0:) | R | The Operating Class of neighboring Access Points discovered by a Radio during a channel scan. At most one entry in this table can exist with a given value for OperatingClass. |
- | 2.14 |
OperatingClass | unsignedInt(:255) | R | The Operating Class per [802.11-2020]Table E-4 in **{{bibref: non-existent 802.11-2016 of the OpClass and Channel tuple scanned by the Radio. For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the Operating Class identifies the band and channel width.}}** | - | 2.14 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}. | object(0:) | R | The Channel associated with an Operating Class of neighboring Access Points discovered by a Radio during a channel scan. At most one entry in this table can exist with a given value for Channel. |
- | 2.14 |
TimeStamp | string | R | The timestamp of the last scan of the channel. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.14 |
Utilization | unsignedInt(:255) | R | The current Channel Utilization measured by the Radio on the scanned 20MHz channel, as defined by {{bibref: non-existent 802.11-2020}}. | - | 2.14 |
Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power measured for the primary operating channel. Encoded as defined for ANPI in {{bibref: non-existent 802.11-2020}}. | - | 2.14 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}.NeighborBSS.{i}. | object(0:) | R | The neighboring BSS discovered by a Radio during a channel scan. At most one entry in this table can exist with a given value for BSSID. |
- | 2.14 |
SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength (RSSI) of the Beacon or Probe Response frames of the neighboring BSS as received by the radio measured in dBm. (RSSI is encoded per [802.11-2020]Table 9-154 of **{{bibref: non-existent 802.11-20169-176). Reserved: 221 - 255. NOTE: The underlying WFA specification is in the process of being reviewed for possible clarification. Please refer to that specification for more details.}}** | - | 2.14 |
ChannelUtilization | unsignedInt(:255) | R | The channel utilization reported by the neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames, as defined by [802.11-2020]Section 9.4.2.28 in **{{bibref: non-existent 802.11-20169.4.2.27.}}** | - | 2.14 |
StationCount | unsignedInt | R | The number of Associated Devices (STA) reported by this neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames as defined by {{bibref: non-existent 802.11-2020}}. | - | 2.14 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BackhaulSta. | object | R | Contains the MACAddressMedium Access Control (MAC) address of the STA on this radio providing Wi-Fi backhaul to this device. | - | 2.13 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanCapability. | object | R | This object describes the channel scan capabilities of a radio. | - | 2.15 |
OnBootOnly | boolean | R | “On boot only” flag, Indicates whether the specified radio is capable only of “On boot” scans. | - | 2.15 |
Impact | unsignedInt(:3) | R | Scan Impact of using this radio to perform a scan. 1: No impact, 2: Reduced number of spatial streams, 3: Time slicing impairment, 4: Radio unavailable for >= 2 seconds. |
- | 2.15 |
MinimumInterval | unsignedInt | R | Minimum Scan Interval, the minimum interval in seconds between the start of two consecutive channel scans on this radio. | - | 2.15 |
OpClassChannelsNumberOfEntries | unsignedInt | R | The number of entries in the OpClassChannels table. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanCapability.OpClassChannels.{i}. | object(1:) | R | Table of the operating classes (selected from [Table E-4/802.11-2020]) and channel numbers in each operating class that the radio is capable of scanning. This table MUST contain at least 1 entry. At most one entry in this table can exist with a given value for OpClass. |
- | 2.15 |
OpClass | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020] For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the operating class identifies the band and channel width. |
- | 2.15 |
ChannelList | unsignedInt(:255)[] | R | Comma-separated list of unsigned integers (up to 255). The channel numbers in this Operating Class for which the capability is being described. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.CACCapability. | object | R | This object describes the Channel Availability Check (CAC) capabilities of a radio. | - | 2.15 |
CACMethodNumberOfEntries | unsignedInt | R | The number of entries in the CACMethod table. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.CACCapability.CACMethod.{i}. | object(0:4) | R | List of Channel Availability Check (CAC) method information for each type of CAC that the radio can perform. Each type is defined by a method and time to complete. For each type, the classes and channels allowed are enumerated. This table MUST contain at least 0 and at most 4 entries. At most one entry in this table can exist with a given value for Method. |
- | 2.15 |
Method | unsignedInt | R | CAC method supported; 0: Continuous CAC, 1: Continuous with dedicated radio, 2: Multi-Input Multi-Output (MIMO) dimension reduced, 3: Time sliced CAC. |
- | 2.15 |
NumberOfSeconds | unsignedInt | R | Number of seconds required to complete this method of CAC. | - | 2.15 |
OpClassChannelsNumberOfEntries | unsignedInt | R | The number of entries in the OpClassChannels table. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.CACCapability.CACMethod.{i}.OpClassChannels.{i}. | object(1:) | R | Table of the operating classes (selected from [Table E-4/802.11-2020]) and channel numbers in each operating class supported for this method of CAC. This table MUST contain at least 1 entry. At most one entry in this table can exist with a given value for OpClass. |
- | 2.15 |
OpClass | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020] For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the operating class identifies the band and channel width. |
- | 2.15 |
ChannelList | unsignedInt(:255)[] | R | Comma-separated list of unsigned integers (up to 255). The channel numbers in this Operating Class for which the capability is being described. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.Capabilities. | object | R | This object represents the capabilities of the radio which may be
different from the current operational configuration.
Changes in 2.15:
|
- | 2.13 |
HTCapabilities | base64(1) | R | Describes the HT capabilities of the radio as defined by the HTCapabilities TLV {{bibref: non-existent EasyMesh}}. | - | 2.13 |
VHTCapabilities | base64(2:6) | R | Describes the VHT capabilities of the radio as defined by the VHTCapabilities TLV {{bibref: non-existent EasyMesh}}. | - | 2.13 |
HECapabilities | base64(4:14) | R | Describes the HE capabilities of the radio as defined by the HECapabilities TLV {{bibref: non-existent EasyMesh}}.
This parameter was DEPRECATED in 2.15 because it is superseded by **{{object: non-existent #.WiFi6APRole** and {{object: non-existent #.WiFi6bSTARole}}}}. Changes in 2.15:
|
- | 2.13 |
AKMFrontHaulNumberOfEntries | unsignedInt | R | The number of entries in the AKMFrontHaul table. | - | 2.15 |
AKMBackhaulNumberOfEntries | unsignedInt | R | The number of entries in the AKMBackhaul table. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.Capabilities.WiFi6APRole. | object | R | Describes the Wi-Fi 6 capabilities for the AP role. | - | 2.15 |
HE160 | boolean | R | Indicates support for High Efficiency (HE) 160 MHz. | - | 2.15 |
HE8080 | boolean | R | Indicates support for HE 80+80 MHz. | - | 2.15 |
MCSNSS | base64(4:12) | R | Supported High Efficiency-Modulation and Coding Scheme (HE-MCS) and Number of Spatial Streams (NSS) Set field as defined in [Figure 9-788d/802.11ax] Supported HE-MCS And NSS Set field format. HE-MCS And NSS Set field for 160MHz is present if 160MHz is supported. HE-MCS And NSS Set field for 80+80MHz is present if 80+80MHz is supported. | - | 2.15 |
SUBeamformer | boolean | R | Indicates support for Single-User (SU) Beamformer. | - | 2.15 |
SUBeamformee | boolean | R | Indicates support for SU Beamformee. | - | 2.15 |
MUBeamformer | boolean | R | Indicates support for Multi-User (MU) Beamformer. | - | 2.15 |
Beamformee80orLess | boolean | R | Indicates support for Beamformee Space-Time Stream (STS) ≤ 80 MHz. | - | 2.15 |
BeamformeeAbove80 | boolean | R | Indicates support for Beamformee STS > 80 MHz. | - | 2.15 |
ULMUMIMO | boolean | R | Indicates support for Uplink (UL) Multi-User Multiple Input, Multiple Output (MU-MIMO). | - | 2.15 |
ULOFDMA | boolean | R | Indicates support for UL Orthogonal Frequency Division Multiplexing (OFDMA). | - | 2.15 |
MaxDLMUMIMO | unsignedInt(:255) | R | Max number of users supported per DL MU-MIMO Transmitter (TX) in an AP role. | - | 2.15 |
MaxULMUMIMO | unsignedInt(:255) | R | Max number of users supported per UL MU-MIMO Receiver (RX) in an AP role. | - | 2.15 |
MaxDLOFDMA | unsignedInt(:255) | R | Max number of users supported per Downlink (DL) OFDMA TX in an AP role. | - | 2.15 |
MaxULOFDMA | unsignedInt(:255) | R | Max number of users supported per UL OFDMA RX in an AP role. | - | 2.15 |
RTS | boolean | R | Indicates support for Request To Send (RTS). | - | 2.15 |
MURTS | boolean | R | Indicates support for MU RTS. | - | 2.15 |
MultiBSSID | boolean | R | Indicates support for Multi-Basic Service Set Identifier (BSSID). | - | 2.15 |
MUEDCA | boolean | R | Indicates support for MU Enhanced distributed channel access (EDCA). | - | 2.15 |
TWTRequestor | boolean | R | Indicates support for Target Wake Time (TWT) Requestor. | - | 2.15 |
TWTResponder | boolean | R | Indicates support for TWT Responder. | - | 2.15 |
SpatialReuse | boolean | R | Indicates support for EasyMesh configuration and reporting of BSS Color and Spatial Reuse. | - | 2.15 |
AnticipatedChannelUsage | boolean | R | Indicates support for Anticipated Channel Usage (ACU) reporting. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.Capabilities.WiFi6bSTARole. | object | R | Describes the Wi-Fi 6 capabilities for the backhaul Station (bSTA) role. | - | 2.15 |
HE160 | boolean | R | Indicates support for High Efficiency (HE) 160 MHz. | - | 2.15 |
HE8080 | boolean | R | Indicates support for HE 80+80 MHz. | - | 2.15 |
MCSNSS | base64(4:12) | R | Supported High Efficiency-Modulation and Coding Scheme (HE-MCS) and Number of Spatial Streams (NSS) Set field as defined in [Figure 9-788d/802.11ax] Supported HE-MCS And NSS Set field format. HE-MCS And NSS Set field for 160MHz is present if 160MHz is supported. HE-MCS And NSS Set field for 80+80MHz is present if 80+80MHz is supported. | - | 2.15 |
SUBeamformer | boolean | R | Indicates support for Single-User (SU) Beamformer. | - | 2.15 |
SUBeamformee | boolean | R | Indicates support for SU Beamformee. | - | 2.15 |
MUBeamformer | boolean | R | Indicates support for Multi-User (MU) Beamformer. | - | 2.15 |
Beamformee80orLess | boolean | R | Indicates support for Beamformee Space-Time Stream (STS) ≤ 80 MHz. | - | 2.15 |
BeamformeeAbove80 | boolean | R | Indicates support for Beamformee STS > 80 MHz. | - | 2.15 |
ULMUMIMO | boolean | R | Indicates support for Uplink (UL) Multi-User Multiple Input, Multiple Output (MU-MIMO). | - | 2.15 |
ULOFDMA | boolean | R | Indicates support for UL Orthogonal Frequency Division Multiplexing (OFDMA). | - | 2.15 |
MaxDLMUMIMO | unsignedInt(:255) | R | Max number of users supported per DL MU-MIMO Transmitter (TX) in an AP role. | - | 2.15 |
MaxULMUMIMO | unsignedInt(:255) | R | Max number of users supported per UL MU-MIMO Receiver (RX) in an AP role. | - | 2.15 |
MaxDLOFDMA | unsignedInt(:255) | R | Max number of users supported per Downlink (DL) OFDMA TX in an AP role. | - | 2.15 |
MaxULOFDMA | unsignedInt(:255) | R | Max number of users supported per UL OFDMA RX in an AP role. | - | 2.15 |
RTS | boolean | R | Indicates support for Request To Send (RTS). | - | 2.15 |
MURTS | boolean | R | Indicates support for MU RTS. | - | 2.15 |
MultiBSSID | boolean | R | Indicates support for Multi-Basic Service Set Identifier (BSSID). | - | 2.15 |
MUEDCA | boolean | R | Indicates support for MU Enhanced distributed channel access (EDCA). | - | 2.15 |
TWTRequestor | boolean | R | Indicates support for Target Wake Time (TWT) Requestor. | - | 2.15 |
TWTResponder | boolean | R | Indicates support for TWT Responder. | - | 2.15 |
SpatialReuse | boolean | R | Indicates support for EasyMesh configuration and reporting of BSS Color and Spatial Reuse. | - | 2.15 |
AnticipatedChannelUsage | boolean | R | Indicates support for Anticipated Channel Usage (ACU) reporting. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.Capabilities.AKMFrontHaul.{i}. | object(0:) | R | Authentication and Key Management (AKM) Suite (security mode) capabilities for the fronthaul BSS. At most one entry in this table can exist with a given value for OUI. |
- | 2.15 |
OUI | base64 | R | Any Organizationally Unique Identifier (OUI) value specified in [Table 9-151/802.11-2020]). | - | 2.15 |
Type | unsignedInt(:255) | R | Any suite type value specified in [Table 9-151/802.11-2020]. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.Capabilities.AKMBackhaul.{i}. | object(0:) | R | Authentication and Key Management (AKM) Suite (security mode) capabilities for the backhaul BSS. At most one entry in this table can exist with a given value for OUI. |
- | 2.15 |
OUI | base64 | R | Any Organizationally Unique Identifier (OUI) value specified in [Table 9-151/802.11-2020]). | - | 2.15 |
Type | unsignedInt(:255) | R | Any suite type value specified in [Table 9-151/802.11-2020]. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.Capabilities.CapableOperatingClassProfile.{i}. | object(0:) | R | Describes one of the possible Operating Classes supported by this Radio. At most one entry in this table can exist with a given value for Class. |
- | 2.13 |
Class | unsignedInt(:255) | R | The Operating Class per [802.11-2020]Table E-4 in **{{bibref: non-existent 802.11-2016 that this radio is capable of operating on.}}** | - | 2.13 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.CurrentOperatingClassProfile.{i}. | object(0:) | R | Describes one of the current Operating Classes in use by this Radio. One OpeatingOperating Class is indicated for each current Operating Channel Bandwidth. The Channel indicated for the 20 MHz Operating Class is equal to the current primary channel. At most one entry in this table can exist with a given value for Class. Changes in 2.15:
|
- | 2.13 |
Class | unsignedInt(:255) | R | The Operating Class per [802.11-2020]Table E-4 in **{{bibref: non-existent 802.11-2016 that this radio is currently operating on.}}** | - | 2.13 |
TransmitPowerLimit | int(-128:127) | R | {{div: unexpected argument Class after: [classes()], [‘This is the upper limit on nominal transmit Equivalent Isotropically’, nl(), ‘Radiated Power (EIRP) that this radio is allowed to use for the’, nl(), ‘current {param’]}}. In units of decibels relative to 1 mW dBm.}} | - | 2.15 |
TimeStamp | string | R | The time this group was collected. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.13 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.DisAllowedOpClassChannels.{i}. | object(0:) | W | The operating classes, and list of channels for each operating class, which are not allowed to be used on this radio. At most one entry in this table can exist with a given value for OpClass. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for OpClass such that the new entry does not conflict with any existing entries. |
- | 2.15 |
Enable | boolean | W | Enables or disables disallowed operating classes and channels. | false | 2.15 |
OpClass | unsignedInt(:255) | W | The Operating Class per [Table E-4/802.11-2020] For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the operating class identifies the band and channel width. If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. |
- | 2.15 |
ChannelList | unsignedInt(:255)[] | W | Comma-separated list of unsigned integers (up to 255). The channel numbers in this Operating Class for which the capability is being described. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.SpatialReuse. | object | R | The spatial reuse configuration of this radio. Applies only to Wi-Fi 6 [802.11ax] and possibly later generations of radios. Acronyms: Spatial Reuse Group (SRG), Overlapping Basic Service Set (OBSS), Preamble Detection (PD). |
- | 2.15 |
PartialBSSColor | unsignedInt | R | The value of the Partial Basic Service Set (BSS) Color subfield of the HEOperations.BSSColorInformation field being transmitted by BSSs operating on this radio. (EasyMesh TLV Field: Partial BSS Color) | - | 2.15 |
BSSColor | unsignedInt | R | The value of the BSS Color subfield of the HEOperations.BSSColorInformation field being transmitted by BSSs operating on this radio. (EasyMesh TLV Field: BSS Color) | - | 2.15 |
HESIGASpatialReuseValue15Allowed | boolean | R | Indicates if the Agent is allowed to set HESIGA.SpatialReuse field to value 15 (PSR_AND_NON_SRG_OBSS_PD_PROHIBITED) in HE PPDU transmissions of this radio. (EasyMesh TLV Field: HESIGA_Spatial_reuse_value15_allowed) true: allowed; false: disallowed. |
- | 2.15 |
SRGInformationValid | boolean | R | This field indicates whether the SRG Information fields (SRG OBSS PD Min Offset, SRG OBSS PD Max Offset, SRG BSS Color Bitmap and SRG Partial BSSID Bitmap) in this command are valid. (EasyMesh TLV Field: SRG Information Valid) true: SRG Information fields valid; false: SRG Information fields not valid. |
- | 2.15 |
NonSRGOffsetValid | boolean | R | This field indicates whether the Non-SRG OBSSPD Max Offset field in this command is valid. (EasyMesh TLV Field: Non-SRG Offset Valid) true: Non-SRG Max Offset field valid; false: Non-SRG Max Offset field not valid. |
- | 2.15 |
PSRDisallowed | boolean | R | Indicates if the Agent is disallowed to use Parameterized Spatial Reuse (PSR)-based Spatial Reuse for transmissions by the specified radio. (EasyMesh TLV Field: PSR Disallowed) true: PSR disallowed; false: PSR allowed. |
- | 2.15 |
NonSRGOBSSPDMaxOffset | unsignedInt | R | The value of dot11NonSRGAPOBSSPDMaxOffset (i.e the Non-SRG OBSSPD Max Offset value being used to control the transmissions of the specified radio). (EasyMesh TLV Field: Non-SRG OBSSPD Max Offset) This field is valid only if NonSRGOffsetValid is true. |
- | 2.15 |
SRGOBSSPDMinOffset | unsignedInt | R | The value of dot11SRGAPOBSSPDMinOffset (i.e. the SRG OBSSPD Min Offset value being used to control the transmissions of the specified radio). (EasyMesh TLV Field: SRG OBSSPD Min Offset) This field is valid only if SRGInformationValid is true. |
- | 2.15 |
SRGOBSSPDMaxOffset | unsignedInt | R | The value of dot11SRGAPOBSSPDMaxOffset (i.e. the SRG OBSSPD Max Offset value being used to control the transmissions of the specified radio). (EasyMesh TLV Field: SRG OBSSPD Max Offset) This field is valid only if SRGInformationValid is true. |
- | 2.15 |
SRGBSSColorBitmap | hexBinary(8) | R | The value of dot11SRGAPBSSColorBitmap (i.e. the SRG BSS Color Bitmap being used to control the tranmissions of the specified radio). (EasyMesh TLV Field: SRG BSS Color Bitmap) This field is valid only if SRGInformationValid is true. |
- | 2.15 |
SRGPartialBSSIDBitmap | hexBinary(8) | R | The value of dot11SRGAPBSSIDBitmap (i.e. the SRG Partial BSSID Color Bitmap being used to control the transmissions of the specified radio). (EasyMesh TLV Field: SRG Partial BSSID Bitmap) This field is valid only if SRGInformationValid is true. Note: See rules in section 26.10.2.3 of [17] regarding the members of an SRG. |
- | 2.15 |
NeighborBSSColorInUseBitmap | hexBinary(8) | R | Bitmap of BSS colors of Overlapping BSSs (OBSSs) that the High-Efficiency (HE) AP has identified by itself or via the autonomous BSS Color collision reports received from associated non-AP HE STAs. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}. | object(1:) | R | A single logical BSS operating on this radio. This table MUST contain at least 1 entry. At most one entry in this table can exist with a given value for BSSID. Changes in 2.15:
|
- | 2.15 |
TimeStamp | string | R | The time this group was collected. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
ByteCounterUnits | unsignedInt(1:2) | R | Byte Counter Units. 1: kibibytes (KiB) 2: mebibytes (MiB). |
- | 2.15 |
Profile1bSTAsDisallowed | boolean | R | Profile-1 Backhaul STA association disallowed. true: Backhaul STA association disallowed; false: Backhaul STA association allowed. |
- | 2.15 |
Profile2bSTAsDisallowed | boolean | R | Profile-2 Backhaul STA association disallowed. true: Profile 2 bSTA disallowed; false: Profile 2 bSTA allowed. |
- | 2.15 |
AssociationAllowanceStatus | unsignedInt(0:1) | R | The status of allowance of new client device associations on this BSS. 0: No more associations allowed, 1: Associations allowed. |
- | 2.15 |
EstServiceParametersBE | base64(0:3) | R | Estimated Service Parameters information field for AC=BE, defined per [802.11-2020]Figure 9-588 in **{{bibref: non-existent 802.11-20169-637 and referenced in {{bibref: non-existent EasyMesh}}**. | - | 2.15 |
EstServiceParametersBK | base64(0:3) | R | Estimated Service Parameters information field for AC=BK, defined per [802.11-2020]Figure 9-588 in **{{bibref: non-existent 802.11-20169-637 and referenced in {{bibref: non-existent EasyMesh}}**. | - | 2.15 |
EstServiceParametersVI | base64(0:3) | R | Estimated Service Parameters information field for AC=VI, defined per [802.11-2020]Figure 9-588 in **{{bibref: non-existent 802.11-20169-637 and referenced in {{bibref: non-existent EasyMesh}}**. | - | 2.15 |
EstServiceParametersVO | base64(0:3) | R | Estimated Service Parameters information field for AC=VO, defined per [802.11-2020]Figure 9-588 in **{{bibref: non-existent 802.11-20169-637 and referenced in {{bibref: non-existent EasyMesh}}**. | - | 2.15 |
BackhaulUse | boolean | R | Indicates that this BSS is in use as a backhaul BSS; true: backhaul BSS in use, false: backhaul BSS not in use. In [EasyMesh] 0 is in use and 1 is not in use. |
- | 2.15 |
FronthaulUse | boolean | R | Indicates that this BSS is in use as a fronthaul BSS; true: fronthaul BSS in use, false: fronthaul BSS not in use. In [EasyMesh] 0 is in use and 1 is not in use. |
- | 2.15 |
R1disallowed | boolean | R | Multi-AP Profile-1 [3] (R1) disallowed status. true: disallowed, false: allowed. In [EasyMesh] 0 is allowed and 1 is disallowed. |
- | 2.15 |
R2disallowed | boolean | R | Multi-AP Profile-2 [3] (R2) disallowed status. true: disallowed, false: allowed. In [EasyMesh] 0 is allowed and 1 is disallowed. |
- | 2.15 |
MultiBSSID | boolean | R | Multiple BSSID Set; true: configured, false: not-configured. In [EasyMesh], 1 is configured and 0 is not-configured. |
- | 2.15 |
TransmittedBSSID | boolean | R | Transmitted BSSID; true: transmitted, false: non-transmitted. In [EasyMesh], 1 is transmitted and 0 is non-transmitted. |
- | 2.15 |
FronthaulAKMsAllowed | string[] | W | Comma-separated list of strings. List items indicate Authentication and Key Management (AKM) suites/security modes allowed at this BSS for fronthaul. Each list item is an enumeration of:
|
- | 2.15 |
BackhaulAKMsAllowed | string[] | W | Comma-separated list of strings. List items indicate Authentication and Key Management (AKM) suites/security modes allowed at this BSS for backhaul. Each list item is an enumeration of:
|
- | 2.15 |
QMDescriptorNumberOfEntries | unsignedInt | R | The number of entries in the QMDescriptor table. | - | 2.15 |
SetQMDescriptors() | command | - | [ASYNC] This command configures each of the descriptor elements for Mirrored Stream Classification Service (MSCS), Stream Classification Service (SCS), or QoS Management. [EasyMesh]. This command can configure QMDescriptor.{i}.. If QMDescriptor.{i}.DescriptorElement is for SCS or MSCS, the AP adds/changes/removes the rule according to the descriptor element request type. If a QMDescriptor.{i}.DescriptorElement is a QoS Management DSCP Policy, the AP sends it to the STA identified by the QMDescriptor.{i}.ClientMAC. |
- | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ QMDescriptor.{i}. | object(1:) | W | This object contains a table of DescriptorElement. This table MUST contain at least 1 entry. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for ClientMAC. |
- | 2.15 |
⇒ ClientMAC | string(:17) | W | [MANDATORY] [MACAddress] MAC address of the Station (STA) for which this descriptor applies. | - | 2.15 |
⇒ DescriptorElement | hexBinary | W | [MANDATORY] The descriptor element. One of: MSCS descriptor element (as described in [Section 9.4.2.243/802.11-2020], or SCS descriptor element (as described in [Section 9.4.2.121/802.11-2020], or QoS Management DSCP policy element (as described in [Section 5.3/RFC8325]). |
- | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to configure descriptor elements. Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.QMDescriptor.{i}. | object(0:) | R | This object contains a table of DescriptorElement. At most one entry in this table can exist with a given value for ClientMAC. |
- | 2.15 |
ClientMAC | string(:17) | R | [MACAddress] MAC address of STA for which this descriptor applies. | - | 2.15 |
DescriptorElement | hexBinary | R | The descriptor element. One of: MSCS descriptor element (as described in [Section 9.4.2.243/802.11-2020], or SCS descriptor element (as described in [Section 9.4.2.121/802.11-2020], or QoS Management DSCP policy element (as described in [Section 5.3/RFC8325]). |
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.MultiAPSteering. | object | R | A single logical Access Point operating on this radio. | - | 2.15 |
BlacklistAttempts | unsignedLong | R | [StatsCounter64] Number of times a Blacklist steer was attempted for this Access Point. Blacklist steering is the process of forcing a connected STA to move to another Access Point by temporarily blocking its access to the current Access Point. |
- | 2.15 |
BTMAttempts | unsignedLong | R | [StatsCounter64] Number of times a BTM (BSS Transition Management; [802.11k]) steer was attempted for this Access Point. | - | 2.15 |
BTMQueryResponses | unsignedLong | R | [StatsCounter64] Number of asynchronous BTM (BSS Transition Management; [802.11k]) Queries for which a BTM Request was issued by this Access Point. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}. | object(0:) | R | Object describing a single Associated Device (STA). At most one entry in this table can exist with a given value for MACAddress. Changes in 2.15:
|
- | 2.13 |
TimeStamp | string | R | The time this group was collected. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.13 |
HECapabilities | base64(4:14) | R | Describes the HE capabilities of the Associated Device (STA).
This parameter was DEPRECATED in 2.15 because it is superseded by **{{object: non-existent #.WiFi6Capabilities**}}. Changes in 2.15:
|
- | 2.13 |
ClientCapabilities | base64 | R | The frame body of the most recently received (Re)Association Request frame from this client (STA), as defined in Table 9-34 and Table 9-36 of [802.11-2020] in the order of the underlying referenced standard. | - | 2.15 |
EstMACDataRateDownlink | unsignedInt | R | Estimate of the MAC layer throughput in Mbps achievable in the downlink direction if 100% of channel airtime and BSS operating bandwidth were available, as defined in {{bibref: non-existent EasyMesh}}. | - | 2.13 |
EstMACDataRateUplink | unsignedInt | R | Estimate of the MAC layer throughput in Mbps achievable in the uplink direction if 100% of channel airtime and BSS operating bandwidth were available, as defined in {{bibref: non-existent EasyMesh}}. | - | 2.13 |
SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength of the uplink from the associated STA to the access point - measured in dBm. RCPI threshold (encoded per [802.11-2020]Table 9-154 of **{{bibref: non-existent 802.11-20169-176,}, and described in [Section /EasyMesh]10.3.1 of **{{bibref: non-existent MAPv1.0). Reserved: 221 - 255. NOTE: The underlying WFA specification is in the process of being reviewed for possible clarification. Please refer to that specification for more details.}}}} | - | 2.13 |
MeasurementReport | base64[] | R | Comma-separated list of Base64s. Measurement Report element(s) received from the Associated Device (STA) that constitute the latest Beacon report as defined in [802.11-2020]Figure 9-199 of **{{bibref: non-existent 802.11-20169-230.}}** | - | 2.13 |
CellularDataPreference | string | W | This is the Cellular Data Preference for a Agile Multiband (AMB) capable STA This specifies the use of the cellular data connection. [AMB] Enumeration of:
|
- | 2.15 |
ReAssociationDelay | unsignedInt(:65535) | W | Re-association Delay [AMB]. The time, in seconds, after a BTM steer from AP1 to AP2 during which the station cannot go back and re-associate with AP1. | - | 2.15 |
TIDQueueSizesNumberOfEntries | unsignedInt | R | The number of entries in the TIDQueueSizes table. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}.MultiAPSTA. | object | R | The summary of statistics and operations for an individual STA on the Wi-Fi network. The counters contained in MultiAPSTA are all reset on reboot. |
- | 2.15 |
AssociationTime | dateTime | R | Date and time in UTC when the device was associated. | - | 2.15 |
Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power measured on the uplink from the Associated Device (STA) to the Access Point (AP). Encoded as defined for ANPI in [Section 11.10.9.4/802.11-2020]. |
- | 2.15 |
SteeringHistoryNumberOfEntries | unsignedInt | R | The number of entries in the SteeringHistory table. | - | 2.15 |
Disassociate() | command | - | [ASYNC] This command represents a request to disassociate this associated device. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DisassociationTimer | unsignedInt | W | [MANDATORY] The time for which the associated device is to be disassociated in minutes. If set to 0, then the associated device is blocked indefinately. | - | 2.15 |
⇒ ReasonCode | unsignedInt | W | [MANDATORY] The reason code for the request for the associated device to be disassociated, as defined in [Table 9-49/802.11-2020]. | - | 2.15 |
⇒ Silent | boolean | W | An optional input, if true then this is a request for a Silent Disassociate, whereby the AP is to remove the station from its list of associated devices without sending a message to the station. If this input in not provided, then a value of false is assumed. |
- | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the response to the request to disassociate an associated device. Enumeration of:
|
- | 2.15 |
BTMRequest() | command | - | [ASYNC] This command requests initiation of a BSS Transition Management (BTM) request to influence this client’s roaming behavior to another BSS as defined in [Section 9.6.13.9/802.11-2020]. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DisassociationImminent | boolean | W | [MANDATORY] Indicates if the disassociation is imminent, as defined in [Section 9.6.13.9/802.11-2020]. | - | 2.15 |
⇒ DisassociationTimer | unsignedInt | W | [MANDATORY] The number of beacon transmission times until the AP sends a disassociation frame to this station. If DisassociationTimer=0 then DisassociationTimer is not used. | - | 2.15 |
⇒ BSSTerminationDuration | unsignedInt | W | [MANDATORY] The number of minutes for which the BSS is not present. If BSSTerminationDuration=0 or if this input in not provided, then BSSTerminationDuration is not used. | - | 2.15 |
⇒ ValidityInterval | unsignedInt | W | The amount of time in beacon intervals that the BTMRequest() is valid for. If ValidityInterval=0 or if this input in not provided, then ValidityInterval is not used. | - | 2.15 |
⇒ SteeringTimer | unsignedInt | W | The amount of time in beacon intervals that this associated device is not allowed to return to the original BSS. If SteeringTimer=0 or if this input in not provided, then SteeringTimer is not used. | - | 2.15 |
⇒ TargetBSS | string(:17) | W | [MANDATORY] [MACAddress] BSSID of the target BSS which the associated device(s) is to be associated to. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the response to the BSS Transition Management (BTM) request. Enumeration of:
|
- | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}.MultiAPSTA.SteeringSummaryStats. | object | R | The summary of statistics related to Multi-AP Steering for this STA on the Wi-Fi network. The counters contained in SteeringSummaryStats are all reset on reboot. |
- | 2.0 |
NoCandidateAPFailures | unsignedLong | R | [StatsCounter64] Number of times this Associated Device should have been steered but wasn’t because a better candidate AP couldn’t be found. | - | 2.0 |
BlacklistAttempts | unsignedLong | R | [StatsCounter64] Number of times a Blacklist steer was attempted on this Associated Device. | - | 2.0 |
BlacklistSuccesses | unsignedLong | R | [StatsCounter64] Number of times an attempted Blacklist steer succeeded for this Associated Device. | - | 2.0 |
BlacklistFailures | unsignedLong | R | [StatsCounter64] Number of times an attempted Blacklist steer failed for this Associated Device. | - | 2.0 |
BTMAttempts | unsignedLong | R | [StatsCounter64] Number of times a BTM (BSS Transition Management; [802.11k]) steer was attempted on this Associated Device. | - | 2.0 |
BTMSuccesses | unsignedLong | R | [StatsCounter64] Number of times an attempted BTM (BSS Transition Management; [802.11k]) steer succeeded for this Associated Device. | - | 2.0 |
BTMFailures | unsignedLong | R | [StatsCounter64] Number of times an attempted BTM (BSS Transition Management; [802.11k]) steer failed for this Associated Device. | - | 2.0 |
BTMQueryResponses | unsignedLong | R | [StatsCounter64] Number of asynchronous BTM (BSS Transition Management; [802.11k]) Queries for which a BTM Request was issued to this Associated Device. | - | 2.0 |
LastSteerTime | unsignedInt | R | The number of seconds since this Associated Device was last attempted to be steered. | - | 2.0 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}.MultiAPSTA.SteeringHistory.{i}. | object(0:) | R | The history of Multi-AP Steering for this STA on the Wi-Fi network. The contents of this multi-instance object are reset on reboot. At most one entry in this table can exist with the same values for all of Time, APOrigin and APDestination. |
- | 2.0 |
Time | dateTime | R | The date/time when steering was initiated for the Associated Device. | - | 2.0 |
APOrigin | string | R | The BSSID of the Access Point that initiated the steering. | - | 2.0 |
TriggerEvent | string | R | The type of event that caused the steering to be initiaited. Enumeration of:
NOTE: This might be Unknown for BTM Query Response steers. |
- | 2.0 |
SteeringApproach | string | R | The type of steering that was attempted. Enumeration of:
|
- | 2.0 |
APDestination | string | R | The BSSID of the destination Access Point of a successful steer. A failed steering attempt will leave this parameter an empty string. |
- | 2.0 |
SteeringDuration | unsignedInt | R | The amount of time in seconds required for the steer to complete successfully. A failed steering attempt will leave this parameter 0. |
- | 2.0 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}.WiFi6Capabilities. | object | R | Describes the Wi-Fi 6 capabilities of the Associated Device (STA). | - | 2.15 |
HE160 | boolean | R | Indicates support for High Efficiency (HE) 160 MHz. | - | 2.15 |
HE8080 | boolean | R | Indicates support for HE 80+80 MHz. | - | 2.15 |
MCSNSS | base64(4:12) | R | Supported High Efficiency-Modulation and Coding Scheme (HE-MCS) and Number of Spatial Streams (NSS) Set field as defined in [Figure 9-788d/802.11ax] Supported HE-MCS And NSS Set field format. HE-MCS And NSS Set field for 160MHz is present if 160MHz is supported. HE-MCS And NSS Set field for 80+80MHz is present if 80+80MHz is supported. | - | 2.15 |
SUBeamformer | boolean | R | Indicates support for Single-User (SU) Beamformer. | - | 2.15 |
SUBeamformee | boolean | R | Indicates support for SU Beamformee. | - | 2.15 |
MUBeamformer | boolean | R | Indicates support for Multi-User (MU) Beamformer. | - | 2.15 |
Beamformee80orLess | boolean | R | Indicates support for Beamformee Space-Time Stream (STS) ≤ 80 MHz. | - | 2.15 |
BeamformeeAbove80 | boolean | R | Indicates support for Beamformee STS > 80 MHz. | - | 2.15 |
ULMUMIMO | boolean | R | Indicates support for Uplink (UL) Multi-User Multiple Input, Multiple Output (MU-MIMO). | - | 2.15 |
ULOFDMA | boolean | R | Indicates support for UL Orthogonal Frequency Division Multiplexing (OFDMA). | - | 2.15 |
MaxDLMUMIMO | unsignedInt(:255) | R | Max number of users supported per DL MU-MIMO Transmitter (TX) in an AP role. | - | 2.15 |
MaxULMUMIMO | unsignedInt(:255) | R | Max number of users supported per UL MU-MIMO Receiver (RX) in an AP role. | - | 2.15 |
MaxDLOFDMA | unsignedInt(:255) | R | Max number of users supported per Downlink (DL) OFDMA TX in an AP role. | - | 2.15 |
MaxULOFDMA | unsignedInt(:255) | R | Max number of users supported per UL OFDMA RX in an AP role. | - | 2.15 |
RTS | boolean | R | Indicates support for Request To Send (RTS). | - | 2.15 |
MURTS | boolean | R | Indicates support for MU RTS. | - | 2.15 |
MultiBSSID | boolean | R | Indicates support for Multi-Basic Service Set Identifier (BSSID). | - | 2.15 |
MUEDCA | boolean | R | Indicates support for MU Enhanced distributed channel access (EDCA). | - | 2.15 |
TWTRequestor | boolean | R | Indicates support for Target Wake Time (TWT) Requestor. | - | 2.15 |
TWTResponder | boolean | R | Indicates support for TWT Responder. | - | 2.15 |
SpatialReuse | boolean | R | Indicates support for EasyMesh configuration and reporting of BSS Color and Spatial Reuse. | - | 2.15 |
AnticipatedChannelUsage | boolean | R | Indicates support for Anticipated Channel Usage (ACU) reporting. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}.TIDQueueSizes.{i}. | object(0:) | R | Object describing Traffic Identifiers (TIDs), and Queue Size for each TID, for this Associated Device (STA). At most one entry in this table can exist with a given value for TID. |
- | 2.15 |
TID | unsignedInt(:255) | R | The TID of the corresponding Queue Size field. | - | 2.15 |
Size | unsignedInt(:255) | R | Queue Size for this TID. Its format is defined in Table 9-10-QoS Control field [802.11-2020]. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.MultiAPRadio. | object | R | This object represents an individual Access Point Radio in the Wi-Fi network. | - | 2.15 |
RadarDetections | unsignedInt[](:1024) | R | Comma-separated list (maximum number of characters 1024) of unsigned integers. List items represent channels in the non-occupancy list due to radars detected by Dynamic Frequency Selection (DFS) Channel Availability Check (CAC). | - | 2.15 |
FullScan() | command | - | [ASYNC] This parameter represents a request to initiate a full scan on this radio, including all channels supported by this radio, for a specific DwellTime and HomeTime. This command will result in updating Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DwellTime | unsignedInt | W | [MANDATORY] The duration of the time to scan each channel in milliseconds. A value of 50 milliseconds is suggested. | - | 2.15 |
⇒ DFSDwellTime | unsignedInt | W | [MANDATORY] The duration of time to scan each Dynamic Frequency Selection (DFS) channel in milliseconds. A value of at least one beacon interval, typically 100 milliseconds, is suggested. | - | 2.15 |
⇒ HomeTime | unsignedInt | W | The time in milliseconds after which the driver has to go back to the original channel before scanning the next channel to avoid disruption. If this is omitted, or is not supported by the device, then it should be ignored. | - | 2.15 |
⇒ SSID | string | W | The Service Set Identifier (SSID) to scan. If omitted, then all SSIDs are scanned. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to initiate a full band scan. Enumeration of:
|
- | 2.15 |
⇐ ScanResult.{i}. | object(0:) | R | The list of neighboring Access Points discovered by a Radio organized per Operating Class and Channel tuple. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}. | object(0:) | R | The Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for OperatingClass. |
- | 2.15 |
⇐ OperatingClass | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020] of the OpClass and Channel tuple scanned by the Radio. For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the Operating Class identifies the band and channel width. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}. | object(0:) | R | The Channel associated with an Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for Channel. |
- | 2.15 |
⇐ Channel | unsignedInt(:255) | R | The channel number of the Channel scanned by the Radio given the Operating Class. | - | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan of the channel. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ Utilization | unsignedInt(:255) | R | The current Channel Utilization measured by the Radio on the scanned 20MHz channel, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power measured for the primary operating channel. Encoded as defined for ANPI in [Section 11.10.9.4/802.11-2020]. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}.NeighborBSS.{i}. | object(0:) | R | The neighboring BSS discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for BSSID. |
- | 2.15 |
⇐ BSSID | string(:17) | R | [MACAddress] The BSSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SSID | string | R | The SSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength (RSSI) of the Beacon or Probe Response frames of the neighboring BSS as received by the radio measured in dBm. (RSSI is encoded per [Table 9-176/802.11-2020]). Reserved: 221 - 255. NOTE: The underlying WFA specification is in the process of being reviewed for possible clarification. Please refer to that specification for more details. |
- | 2.15 |
⇐ ChannelBandwidth | string | R | Indicates the maximum bandwidth at which the neighboring BSS is operating. e.g. “20” or “40” or “80” or “80+80” or “160” MHz. | - | 2.15 |
⇐ ChannelUtilization | unsignedInt(:255) | R | The channel utilization reported by the neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ StationCount | unsignedInt | R | The number of Associated Devices (STA) reported by this neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ SecurityModeEnabled | string | R | The type of encryption the neighboring WiFi SSID advertises. The WEP value indicates either WEP-64 or WEP-128. The WPA value is the same as WPA-Personal. The WPA2 value is the same as WPA2-Personal. The WPA-WPA2 value is the same as WPA-WPA2-Personal. The WPA3-SAE value is the same as WPA3-Personal. The WPA2-PSK-WPA3-SAE value is the same as WPA3-Personal-Transition. Enumeration of:
|
- | 2.15 |
⇐ EncryptionMode | string[] | R | Comma-separated list of strings. The type of encryption the neighboring WiFi SSID advertises. When SecurityModeEnabled is one of WPA3-SAE, WPA2-PSK-WPA3-SAE, or WPA3-Enterprise, TKIP is not valid, and should not be in the list. Each list item is an enumeration of:
|
- | 2.15 |
⇐ SupportedStandards | string[] | R | Comma-separated list of strings. List items indicate which IEEE 802.11 standards this NeighborBSS instance can support simultaneously, in the frequency band specified by {{param: non-existent ##.Channel}}. Each list item is an enumeration of:
Each value indicates support for the indicated standard. |
- | 2.15 |
⇐ OperatingStandards | string[] | R | Each list item MUST be a member of the list reported by the SupportedStandards parameter. Comma-separated list of strings. List items indicate which IEEE 802.11 standard that is detected for this NeighborBSS. Each value indicates support for the indicated standard. For example, a value of “g,b” (or “b,g” - order is not important) means that the 802.11g standard [802.11g-2003] is used with a backwards-compatible mode for 802.11b [802.11b-1999]. A value of “g” means that only the 802.11g standard can be used. |
- | 2.15 |
⇐ BasicDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Basic data transmit rates (in Mbps) for the SSID. For example, if BasicDataTransferRates is “1,2”, this indicates that the SSID is operating with basic rates of 1 Mbps and 2 Mbps. | - | 2.15 |
⇐ SupportedDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Data transmit rates (in Mbps) for unicast frames at which the SSID will permit a station to connect. For example, if SupportedDataTransferRates is “1,2,5.5”, this indicates that the SSID will only permit connections at 1 Mbps, 2 Mbps and 5.5 Mbps. | - | 2.15 |
⇐ SupportedNSS | unsignedInt | R | The maximum number of spatial streams (NSS) that can be supported. | - | 2.15 |
⇐ DTIMPeriod | unsignedInt | R | The number of beacon intervals that elapse between transmission of Beacon frames containing a TIM element whose DTIM count field is 0. This value is transmitted in the DTIM Period field of beacon frames. [802.11-2020] | - | 2.15 |
⇐ BeaconPeriod | unsignedInt | R | Time interval (in ms) between transmitting beacons. | - | 2.15 |
ChannelScan() | command | - | [ASYNC] This parameter represents a request to initiate a channel scan on this radio on the given channel using a specific DwellTime. This command should result in updating Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DwellTime | unsignedInt | W | [MANDATORY] The duration of the time to scan each channel in milliseconds. A value of 50 milliseconds is suggested. | - | 2.15 |
⇒ DFSDwellTime | unsignedInt | W | [MANDATORY] The duration of time to scan each Dynamic Frequency Selection (DFS) channel in milliseconds. A value of at least one beacon interval, typically 100 milliseconds, is suggested. | - | 2.15 |
⇒ HomeTime | unsignedInt | W | The time in milliseconds after which the driver has to go back to the original channel before scanning the next channel to avoid disruption. If this is omitted, or is not supported by the device, then it should be ignored. | - | 2.15 |
⇒ SSID | string | W | The Service Set Identifier (SSID) to scan. If omitted, then all SSIDs are scanned. | - | 2.15 |
⇒ OpClass.{i}. | object(0:) | W | The Operating Classes for which this channel scan is requested. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇒ OperatingClass | unsignedInt(:255) | W | [MANDATORY] The Operating Class per [Table E-4/802.11-2020] of the OpClass and Channel tuple scanned by the Radio. Note that the Operating Class identifies the band and channel width. For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. | - | 2.15 |
⇒ OpClass.{i}.Channel.{i}. | object(0:) | W | The Channels for which this channel scan is requested. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇒ Channel | unsignedInt(:255) | W | [MANDATORY] The Channel number of the Channel that is requested to be scanned. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to initiate a channel scan. Enumeration of:
|
- | 2.15 |
⇐ ScanResult.{i}. | object(0:) | R | The list of neighboring Access Points discovered by a Radio organized per Operating Class and Channel tuple. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}. | object(0:) | R | The Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for OperatingClass. |
- | 2.15 |
⇐ OperatingClass | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020] of the OpClass and Channel tuple scanned by the Radio. For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the Operating Class identifies the band and channel width. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}. | object(0:) | R | The Channel associated with an Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for Channel. |
- | 2.15 |
⇐ Channel | unsignedInt(:255) | R | The channel number of the Channel scanned by the Radio given the Operating Class. | - | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan of the channel. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ Utilization | unsignedInt(:255) | R | The current Channel Utilization measured by the Radio on the scanned 20MHz channel, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power measured for the primary operating channel. Encoded as defined for ANPI in [Section 11.10.9.4/802.11-2020]. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}.NeighborBSS.{i}. | object(0:) | R | The neighboring BSS discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for BSSID. |
- | 2.15 |
⇐ BSSID | string(:17) | R | [MACAddress] The BSSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SSID | string | R | The SSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength (RSSI) of the Beacon or Probe Response frames of the neighboring BSS as received by the radio measured in dBm. (RSSI is encoded per [Table 9-176/802.11-2020]). Reserved: 221 - 255. NOTE: The underlying WFA specification is in the process of being reviewed for possible clarification. Please refer to that specification for more details. |
- | 2.15 |
⇐ ChannelBandwidth | string | R | Indicates the maximum bandwidth at which the neighboring BSS is operating. e.g. “20” or “40” or “80” or “80+80” or “160” MHz. | - | 2.15 |
⇐ ChannelUtilization | unsignedInt(:255) | R | The channel utilization reported by the neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ StationCount | unsignedInt | R | The number of Associated Devices (STA) reported by this neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ SecurityModeEnabled | string | R | The type of encryption the neighboring WiFi SSID advertises. The WEP value indicates either WEP-64 or WEP-128. The WPA value is the same as WPA-Personal. The WPA2 value is the same as WPA2-Personal. The WPA-WPA2 value is the same as WPA-WPA2-Personal. The WPA3-SAE value is the same as WPA3-Personal. The WPA2-PSK-WPA3-SAE value is the same as WPA3-Personal-Transition. Enumeration of:
|
- | 2.15 |
⇐ EncryptionMode | string[] | R | Comma-separated list of strings. The type of encryption the neighboring WiFi SSID advertises. When SecurityModeEnabled is one of WPA3-SAE, WPA2-PSK-WPA3-SAE, or WPA3-Enterprise, TKIP is not valid, and should not be in the list. Each list item is an enumeration of:
|
- | 2.15 |
⇐ SupportedStandards | string[] | R | Comma-separated list of strings. List items indicate which IEEE 802.11 standards this NeighborBSS instance can support simultaneously, in the frequency band specified by {{param: non-existent ##.Channel}}. Each list item is an enumeration of:
Each value indicates support for the indicated standard. |
- | 2.15 |
⇐ OperatingStandards | string[] | R | Each list item MUST be a member of the list reported by the SupportedStandards parameter. Comma-separated list of strings. List items indicate which IEEE 802.11 standard that is detected for this NeighborBSS. Each value indicates support for the indicated standard. For example, a value of “g,b” (or “b,g” - order is not important) means that the 802.11g standard [802.11g-2003] is used with a backwards-compatible mode for 802.11b [802.11b-1999]. A value of “g” means that only the 802.11g standard can be used. |
- | 2.15 |
⇐ BasicDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Basic data transmit rates (in Mbps) for the SSID. For example, if BasicDataTransferRates is “1,2”, this indicates that the SSID is operating with basic rates of 1 Mbps and 2 Mbps. | - | 2.15 |
⇐ SupportedDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Data transmit rates (in Mbps) for unicast frames at which the SSID will permit a station to connect. For example, if SupportedDataTransferRates is “1,2,5.5”, this indicates that the SSID will only permit connections at 1 Mbps, 2 Mbps and 5.5 Mbps. | - | 2.15 |
⇐ SupportedNSS | unsignedInt | R | The maximum number of spatial streams (NSS) that can be supported. | - | 2.15 |
⇐ DTIMPeriod | unsignedInt | R | The number of beacon intervals that elapse between transmission of Beacon frames containing a TIM element whose DTIM count field is 0. This value is transmitted in the DTIM Period field of beacon frames. [802.11-2020] | - | 2.15 |
⇐ BeaconPeriod | unsignedInt | R | Time interval (in ms) between transmitting beacons. | - | 2.15 |
Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.UnassociatedSTA.{i}. | object(0:) | R | Each instance represents a Non-AP STA that has been discovered by the Radio but is not associated to any of the BSS operating on the Radio. At most one entry in this table can exist with a given value for MACAddress. |
- | 2.13 |
SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength (RCPI) of the uplink from the Non-AP STA - measured in dBm. (RCPI threshold is encoded per [802.11-2020]Table 9-154 of **{{bibref: non-existent 802.11-20169-176, and described in 103.2[Section/EasyMesh] of **{{bibref: non-existent MAPv1.010.3.2). Reserved: 221 - 255. NOTE: The underlying WFA specification is in the process of being reviewed for possible clarification. Please refer to that specification for more details.}}}} | - | 2.13 |
Device.WiFi.DataElements.AssociationEvent. | object | R | This object contains the events generated when a STA associates to a
BSS.
Changes in 2.15:
|
- | 2.13 |
Associated! | event | - | The event is generated when an Associated Device (STA) associates to a BSS. | - | 2.15 |
⇒ BSSID | string(:17) | R | [MACAddress] The MAC Address of the logical BSS (BSSID) which is reporting the Association Event. | - | 2.15 |
⇒ MACAddress | string(:17) | R | [MACAddress] The MAC Address of the Associated Device (STA). | - | 2.15 |
⇒ StatusCode | unsignedInt | R | The status code sent to the Associated Device (STA) in the Association Response frame as defined by [Table 9-50/802.11-2020]. | - | 2.15 |
⇒ HTCapabilities | base64(1) | R | Describes the HT capabilities of the Associated Device (STA). | - | 2.15 |
⇒ VHTCapabilities | base64(2:6) | R | Describes the VHT capabilities of the Associated Device (STA). | - | 2.15 |
⇒ HECapabilities | base64(4:14) | R | Describes the HE capabilities of the Associated Device (STA). | - | 2.15 |
⇒ TimeStamp | string | R | The time this event happened. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
Device.WiFi.DataElements.AssociationEvent.AssociationEventData.{i}. | object(0:) | R | The events generated when an Associated Device (STA) associates to a
BSS.
Changes in 2.15:
|
- | 2.13 |
BSSID | string(:17) | R | [MACAddress] The MAC Address of the logical BSS ( BSSID)(BSSID) which is reporting the Association Event. | - | 2.13 |
StatusCode | unsignedInt | R | The status code sent to the Associated Device (STA) in the Association Response frame as defined by [802.11-2020]Table 9-46 in **{{bibref: non-existent 802.11-20169-50.}}** | - | 2.13 |
TimeStamp | string | R | The time this event washappened. collected.Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.13 |
Device.WiFi.DataElements.AssociationEvent.AssociationEventData.{i}.WiFi6Capabilities. | object | R | Describes the Wi-Fi 6 capabilities of the Associated Device (STA). | - | 2.15 |
HE160 | boolean | R | Indicates support for High Efficiency (HE) 160 MHz. | - | 2.15 |
HE8080 | boolean | R | Indicates support for HE 80+80 MHz. | - | 2.15 |
MCSNSS | base64(4:12) | R | Supported High Efficiency-Modulation and Coding Scheme (HE-MCS) and Number of Spatial Streams (NSS) Set field as defined in [Figure 9-788d/802.11ax] Supported HE-MCS And NSS Set field format. HE-MCS And NSS Set field for 160MHz is present if 160MHz is supported. HE-MCS And NSS Set field for 80+80MHz is present if 80+80MHz is supported. | - | 2.15 |
SUBeamformer | boolean | R | Indicates support for Single-User (SU) Beamformer. | - | 2.15 |
SUBeamformee | boolean | R | Indicates support for SU Beamformee. | - | 2.15 |
MUBeamformer | boolean | R | Indicates support for Multi-User (MU) Beamformer. | - | 2.15 |
Beamformee80orLess | boolean | R | Indicates support for Beamformee Space-Time Stream (STS) ≤ 80 MHz. | - | 2.15 |
BeamformeeAbove80 | boolean | R | Indicates support for Beamformee STS > 80 MHz. | - | 2.15 |
ULMUMIMO | boolean | R | Indicates support for Uplink (UL) Multi-User Multiple Input, Multiple Output (MU-MIMO). | - | 2.15 |
ULOFDMA | boolean | R | Indicates support for UL Orthogonal Frequency Division Multiplexing (OFDMA). | - | 2.15 |
MaxDLMUMIMO | unsignedInt(:255) | R | Max number of users supported per DL MU-MIMO Transmitter (TX) in an AP role. | - | 2.15 |
MaxULMUMIMO | unsignedInt(:255) | R | Max number of users supported per UL MU-MIMO Receiver (RX) in an AP role. | - | 2.15 |
MaxDLOFDMA | unsignedInt(:255) | R | Max number of users supported per Downlink (DL) OFDMA TX in an AP role. | - | 2.15 |
MaxULOFDMA | unsignedInt(:255) | R | Max number of users supported per UL OFDMA RX in an AP role. | - | 2.15 |
RTS | boolean | R | Indicates support for Request To Send (RTS). | - | 2.15 |
MURTS | boolean | R | Indicates support for MU RTS. | - | 2.15 |
MultiBSSID | boolean | R | Indicates support for Multi-Basic Service Set Identifier (BSSID). | - | 2.15 |
MUEDCA | boolean | R | Indicates support for MU Enhanced distributed channel access (EDCA). | - | 2.15 |
TWTRequestor | boolean | R | Indicates support for Target Wake Time (TWT) Requestor. | - | 2.15 |
TWTResponder | boolean | R | Indicates support for TWT Responder. | - | 2.15 |
SpatialReuse | boolean | R | Indicates support for EasyMesh configuration and reporting of BSS Color and Spatial Reuse. | - | 2.15 |
AnticipatedChannelUsage | boolean | R | Indicates support for Anticipated Channel Usage (ACU) reporting. | - | 2.15 |
Device.WiFi.DataElements.DisassociationEvent. | object | R | This object contains the events generated when an Associated Device
(STA) disassociates from a BSS.
Changes in 2.15:
|
- | 2.13 |
Disassociated! | event | - | The event is generated when an Associated Device (STA) disassociates from a BSS. | - | 2.15 |
⇒ BSSID | string(:17) | R | [MACAddress] The MAC Address of the logical BSS ( BSSID) which is reporting the Disassociation Event. | - | 2.15 |
⇒ MACAddress | string(:17) | R | [MACAddress] The MAC Address of the Associated Device (STA). | - | 2.15 |
⇒ ReasonCode | unsignedInt | R | The Reason Code received by the AP from the Associated Device (STA) in the most recent Disassociation or Deauthentication frame or sent by the AP to the Associated Device (STA) in the most recent Disassociation or Deauthentication frame as defined in [Table 9-49/802.11-2020]. | - | 2.15 |
⇒ BytesSent | unsignedLong | R | [StatsCounter64] The total number of bytes transmitted to the Associated Device (STA). | - | 2.15 |
⇒ BytesReceived | unsignedLong | R | [StatsCounter64] The total number of bytes received from the Associated Device (STA). | - | 2.15 |
⇒ PacketsSent | unsignedLong | R | [StatsCounter64] The total number of packets transmitted to the Associated Device (STA). | - | 2.15 |
⇒ PacketsReceived | unsignedLong | R | [StatsCounter64] The total number of packets received from the Associated Device (STA). | - | 2.15 |
⇒ ErrorsSent | unsignedInt | R | [StatsCounter32] The total number of outbound packets that could not be transmitted to the Associated Device (STA) because of errors. These might be due to the number of retransmissions exceeding the retry limit or from other causes. | - | 2.15 |
⇒ ErrorsReceived | unsignedInt | R | [StatsCounter32] The total number of inbound packets from the Associated Device (STA) that contained errors preventing them from being delivered to a higher-layer protocol. | - | 2.15 |
⇒ RetransCount | unsignedInt | R | [StatsCounter32] The total number of transmitted packets to the Associated Device (STA) which were retransmissions. N retransmissions of the same packet results in this counter incrementing by N. |
- | 2.15 |
⇒ TimeStamp | string | R | The time this event happened. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
Device.WiFi.DataElements.DisassociationEvent.DisassociationEventData.{i}. | object(0:) | R | The events generated when an Associated Device (STA) disassociates from a BSS. | - | 2.13 |
MACAddress | string(:17) | R | [MACAddress] The MAC addressAddress of the Associated Device (STA). | - | 2.13 |
ReasonCode | unsignedInt | R | The Reason Code received by the AP from the Associated Device (STA) in the most recent Disassociation or Deauthentication frame or sent by the AP to the Associated Device (STA) in the most recent Disassociation or DeauthenticaitonDeauthentication frame as defined in [802.11-2020]Table 9-45 in **{{bibref: non-existent 802.11-20169-49.}}** | - | 2.13 |
TimeStamp | string | R | The time this event washappened. collected.Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.13 |
Device.WiFi.DataElements.FailedConnectionEvent. | object | R | This object contains the events generated when a Station (STA) fails to connect to a Basic Service Set (BSS). | - | 2.15 |
FailedConnectionEventDataNumberOfEntries | unsignedInt | R | The number of entries in the FailedConnectionEventData table. | - | 2.15 |
FailedConnection! | event | - | The event is generated when an Associated Device (STA) fails to connect to a BSS. | - | 2.15 |
⇒ MACAddress | string(:17) | R | [MACAddress] STA MAC Address identifying the client that has attempted to connect. | - | 2.15 |
⇒ StatusCode | unsignedInt | R | Status Code set to a non-zero value that indicates the reason for association or authentication failure as defined in [Table 9-50/802.11-2020], or Status Code set to zero and ReasonCode provided. | - | 2.15 |
⇒ ReasonCode | unsignedInt | R | Reason Code indicating the reason the STA was disassociated or deauthenticated as defined in [Table 9-49/802.11-2020]. | - | 2.15 |
⇒ TimeStamp | string | R | The time this event happened. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
Device.WiFi.DataElements.FailedConnectionEvent.FailedConnectionEventData.{i}. | object(0:) | R | This object describes the data provided with a failed connection event | - | 2.0 |
MACAddress | string(:17) | R | [MACAddress] STA MAC Address identifying the client that has attempted to connect. | - | 2.0 |
StatusCode | unsignedInt | R | Status Code set to a non-zero value that indicates the reason for association or authentication failure as defined in [Table 9-50/802.11-2020], or Status Code set to zero and ReasonCode provided. | - | 2.0 |
ReasonCode | unsignedInt | R | Reason Code indicating the reason the STA was disassociated or deauthenticated as defined in [Table 9-49/802.11-2020]. | - | 2.0 |
TimeStamp | string | R | The time this event happened. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.0 |
Device.WiFi.Radio.{i}. | object(0:) | R | This object models an 802.11 wireless radio on a device (a stackable interface object as described in [Section 4.2/TR-181i2]). If the device can establish more than one connection simultaneously (e.g. a dual radio device), a separate Radio instance MUST be used for each physical radio of the device. See [Appendix III.1/TR-181i2] for additional information. Note: A dual-band single-radio device (e.g. an 802.11a/b/g radio) can be configured to operate at 2.4 or 5 GHz frequency bands, but only a single frequency band is used to transmit/receive at a given time. Therefore, a single Radio instance is used even for a dual-band radio. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. Changes in 2.15:
|
- | 2.0 |
Upstream | boolean | R | Indicates whether the interface points towards the Internet (true) or towards End Devices (false). For example: * For an Internet Gateway Device, Upstream will be true for all WAN interfaces and false for all LAN interfaces. * For a standalone WiFi Access Point that is connected via Ethernet to an Internet Gateway Device, Upstream will be true for the Ethernet interface and false for the WiFi Radio interface. * For an End Device, Upstream will be true for all interfaces. An interface might have some SSIDs pointing towards the Internet and other SSIDs pointing towards End Devices. This parameter was DEPRECATED because it gives a wrong indication for multiple SSIDs. Use theis indicated by the associated SSID.{i}.Upstream parameters. This interface’s Upstream parameter instead. is set to true if any of the associated SSID.{i}.Upstream parameters are true, and is set to false otherwise.This parameter iswas DEPRECATED in 2.12 (and then OBSOLETED in 2.14.}}2.14) because it couldn’t describe all multi-SSID use cases. It has now been restored, and its multi-SSID behavior has been clarified. Changes in 2.15:
|
- | 2.0 |
CenterFrequencySegement0 | unsignedInt | W | When operating in 80+80MHz, this parameter determines the Center Frequency Segment 0 for the first 80 MHz channel. See [Section 9.4.2.161/802.11-2016] and Table 9-252. This parameter is DEPRECATED in
**{{deprecated: missing reason argument}}2.14{{replaced: unexpected argument [] after: , []}}**due to a typo. Use **{{param: non-existent CenterFrequencySegement0CenterFrequencySegment0}}** instead.instead |
- | 2.13 |
CenterFrequencySegement1 | unsignedInt | W | When operating in 80+80MHz, this parameter determines the Center Frequency Segment 1 for the second 80 MHz channel. See [Section 9.4.2.161/802.11-2016] and Table 9-252. This parameter is DEPRECATED in
**{{deprecated: missing reason argument}}2.14{{replaced: unexpected argument [] after: , []}}**due to a typo. Use **{{param: non-existent CenterFrequencySegement1CenterFrequencySegment1}}** instead.instead |
- | 2.13 |
DTIMPeriod | unsignedInt | W | This specifies the number of beacon intervals that elapse between transmission of Beacon frames containing a TIM element whose DTIM Count field is 0. This parameter is based on dot11DTIMPeriod from {{bibref: non-existent 802.11-2020}}. | - | 2.8 |
EnableRRM | boolean | W | Enables or disables 802.11k [802.11k] Radio Resource Management (RRM). | - | 2.14 |
ManagementPacketRate | unsignedInt | W | The rate of Wi-Fi management frames (expressed in kbps). | - | 2.15 |
RemoteMeasurementRequest() | command | - | [ASYNC] This command requests initiation of a Remote Measurement request to retrieve measurement data from a BSS on this radio. Upon receipt of this request, this radio is to initiate a measurement of the output SignalStrength and Noise for the indicated input. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ TargetBSS | string(:17) | W | [MANDATORY] [MACAddress] The BSSID of the remote BSS. | - | 2.15 |
⇒ Timeout | unsignedInt | W | [MANDATORY] The duration after which the request is timed out in seconds. | - | 2.15 |
⇒ OperatingClass | unsignedInt(:255) | W | [MANDATORY] The Operating Class in [Table E-4/802.11-2020] for which the measurement is requested. | - | 2.15 |
⇒ Channel | unsignedInt | W | [MANDATORY] The number of the channel for which the measurement is requested. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ SignalStrength | unsignedInt(:255) | R | The received signal strength (RSSI) as received by the radio measured in dBm. RSSI is encoded as per [Table 9-176/802.11-2020]. Reserved: 221 - 255. | - | 2.15 |
⇐ Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power as received by the radio. Encoded as defined for ANPI in [Section 11.10.9.4/802.11-2020]. | - | 2.15 |
⇐ Status | string | R | Indicates the response to the Remote Measurement request. Enumeration of:
|
- | 2.15 |
InitiateCCAMeasurement() | command | - | [ASYNC] This command represents a request to initiate a Clear Channel Assessment (CCA) measurement scan on this radio on the given channel using a specific DwellTime. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Channel | unsignedInt | W | [MANDATORY] The number of the Wi-Fi channel the clear channel assessment (CCA) measurement is run on. | - | 2.15 |
⇒ DwellTime | unsignedInt | W | [MANDATORY] The duration of the CCA measurement in milliseconds. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ CCAReport | hexBinary(12) | R | The clear channel assessment (CCA) report in the format specified in [Section 9.4.2.21.3/802.11-2020]. When read, the value of this parameter MUST correspond to Channel. How this is achieved is a local matter to the CPE. |
- | 2.15 |
⇐ Status | string | R | Indicates the response to the request to initiate a Clear Channel Assessment (CCA) measurement. Enumeration of:
|
- | 2.15 |
FullScan() | command | - | [ASYNC] This parameter represents a request to initiate a full scan on this radio, including all channels supported by this radio, for a specific DwellTime and HomeTime. This command will result in updating Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DwellTime | unsignedInt | W | [MANDATORY] The duration of the time to scan each channel in milliseconds. A value of 50 milliseconds is suggested. | - | 2.15 |
⇒ DFSDwellTime | unsignedInt | W | [MANDATORY] The duration of time to scan each Dynamic Frequency Selection (DFS) channel in milliseconds. A value of at least one beacon interval, typically 100 milliseconds, is suggested. | - | 2.15 |
⇒ HomeTime | unsignedInt | W | The time in milliseconds after which the driver has to go back to the original channel before scanning the next channel to avoid disruption. If this is omitted, or is not supported by the device, then it should be ignored. | - | 2.15 |
⇒ SSID | string | W | The Service Set Identifier (SSID) to scan. If omitted, then all SSIDs are scanned. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to initiate a full band scan. Enumeration of:
|
- | 2.15 |
⇐ ScanResult.{i}. | object(0:) | R | The list of neighboring Access Points discovered by a Radio organized per Operating Class and Channel tuple. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}. | object(0:) | R | The Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for OperatingClass. |
- | 2.15 |
⇐ OperatingClass | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020] of the OpClass and Channel tuple scanned by the Radio. For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the Operating Class identifies the band and channel width. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}. | object(0:) | R | The Channel associated with an Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for Channel. |
- | 2.15 |
⇐ Channel | unsignedInt(:255) | R | The channel number of the Channel scanned by the Radio given the Operating Class. | - | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan of the channel. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ Utilization | unsignedInt(:255) | R | The current Channel Utilization measured by the Radio on the scanned 20MHz channel, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power measured for the primary operating channel. Encoded as defined for ANPI in [Section 11.10.9.4/802.11-2020]. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}.NeighborBSS.{i}. | object(0:) | R | The neighboring BSS discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for BSSID. |
- | 2.15 |
⇐ BSSID | string(:17) | R | [MACAddress] The BSSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SSID | string | R | The SSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength (RSSI) of the Beacon or Probe Response frames of the neighboring BSS as received by the radio measured in dBm. (RSSI is encoded per [Table 9-176/802.11-2020]). Reserved: 221 - 255. NOTE: The underlying WFA specification is in the process of being reviewed for possible clarification. Please refer to that specification for more details. |
- | 2.15 |
⇐ ChannelBandwidth | string | R | Indicates the maximum bandwidth at which the neighboring BSS is operating. e.g. “20” or “40” or “80” or “80+80” or “160” MHz. | - | 2.15 |
⇐ ChannelUtilization | unsignedInt(:255) | R | The channel utilization reported by the neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ StationCount | unsignedInt | R | The number of Associated Devices (STA) reported by this neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ SecurityModeEnabled | string | R | The type of encryption the neighboring WiFi SSID advertises. The WEP value indicates either WEP-64 or WEP-128. The WPA value is the same as WPA-Personal. The WPA2 value is the same as WPA2-Personal. The WPA-WPA2 value is the same as WPA-WPA2-Personal. The WPA3-SAE value is the same as WPA3-Personal. The WPA2-PSK-WPA3-SAE value is the same as WPA3-Personal-Transition. Enumeration of:
|
- | 2.15 |
⇐ EncryptionMode | string[] | R | Comma-separated list of strings. The type of encryption the neighboring WiFi SSID advertises. When SecurityModeEnabled is one of WPA3-SAE, WPA2-PSK-WPA3-SAE, or WPA3-Enterprise, TKIP is not valid, and should not be in the list. Each list item is an enumeration of:
|
- | 2.15 |
⇐ SupportedStandards | string[] | R | Comma-separated list of strings. List items indicate which IEEE 802.11 standards this NeighborBSS instance can support simultaneously, in the frequency band specified by {{param: non-existent ##.Channel}}. Each list item is an enumeration of:
Each value indicates support for the indicated standard. |
- | 2.15 |
⇐ OperatingStandards | string[] | R | Each list item MUST be a member of the list reported by the SupportedStandards parameter. Comma-separated list of strings. List items indicate which IEEE 802.11 standard that is detected for this NeighborBSS. Each value indicates support for the indicated standard. For example, a value of “g,b” (or “b,g” - order is not important) means that the 802.11g standard [802.11g-2003] is used with a backwards-compatible mode for 802.11b [802.11b-1999]. A value of “g” means that only the 802.11g standard can be used. |
- | 2.15 |
⇐ BasicDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Basic data transmit rates (in Mbps) for the SSID. For example, if BasicDataTransferRates is “1,2”, this indicates that the SSID is operating with basic rates of 1 Mbps and 2 Mbps. | - | 2.15 |
⇐ SupportedDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Data transmit rates (in Mbps) for unicast frames at which the SSID will permit a station to connect. For example, if SupportedDataTransferRates is “1,2,5.5”, this indicates that the SSID will only permit connections at 1 Mbps, 2 Mbps and 5.5 Mbps. | - | 2.15 |
⇐ SupportedNSS | unsignedInt | R | The maximum number of spatial streams (NSS) that can be supported. | - | 2.15 |
⇐ DTIMPeriod | unsignedInt | R | The number of beacon intervals that elapse between transmission of Beacon frames containing a TIM element whose DTIM count field is 0. This value is transmitted in the DTIM Period field of beacon frames. [802.11-2020] | - | 2.15 |
⇐ BeaconPeriod | unsignedInt | R | Time interval (in ms) between transmitting beacons. | - | 2.15 |
ChannelScan() | command | - | [ASYNC] This parameter represents a request to initiate a channel scan on this radio on the given channel using a specific DwellTime. This command should result in updating Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.ScanResult. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DwellTime | unsignedInt | W | [MANDATORY] The duration of the time to scan each channel in milliseconds. A value of 50 milliseconds is suggested. | - | 2.15 |
⇒ DFSDwellTime | unsignedInt | W | [MANDATORY] The duration of time to scan each Dynamic Frequency Selection (DFS) channel in milliseconds. A value of at least one beacon interval, typically 100 milliseconds, is suggested. | - | 2.15 |
⇒ HomeTime | unsignedInt | W | The time in milliseconds after which the driver has to go back to the original channel before scanning the next channel to avoid disruption. If this is omitted, or is not supported by the device, then it should be ignored. | - | 2.15 |
⇒ SSID | string | W | The Service Set Identifier (SSID) to scan. If omitted, then all SSIDs are scanned. | - | 2.15 |
⇒ OpClass.{i}. | object(0:) | W | The Operating Classes for which this channel scan is requested. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇒ OperatingClass | unsignedInt(:255) | W | [MANDATORY] The Operating Class per [Table E-4/802.11-2020] of the OpClass and Channel tuple scanned by the Radio. Note that the Operating Class identifies the band and channel width. For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. | - | 2.15 |
⇒ OpClass.{i}.Channel.{i}. | object(0:) | W | The Channels for which this channel scan is requested. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇒ Channel | unsignedInt(:255) | W | [MANDATORY] The Channel number of the Channel that is requested to be scanned. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the type of outcome of the request to initiate a channel scan. Enumeration of:
|
- | 2.15 |
⇐ ScanResult.{i}. | object(0:) | R | The list of neighboring Access Points discovered by a Radio organized per Operating Class and Channel tuple. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}. | object(0:) | R | The Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for OperatingClass. |
- | 2.15 |
⇐ OperatingClass | unsignedInt(:255) | R | The Operating Class per [Table E-4/802.11-2020] of the OpClass and Channel tuple scanned by the Radio. For 2.4GHz and 5GHz bands, only 20MHz Operating Classes are valid. Note that the Operating Class identifies the band and channel width. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}. | object(0:) | R | The Channel associated with an Operating Class of neighboring Access Points discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for Channel. |
- | 2.15 |
⇐ Channel | unsignedInt(:255) | R | The channel number of the Channel scanned by the Radio given the Operating Class. | - | 2.15 |
⇐ TimeStamp | string | R | The timestamp of the last scan of the channel. Formatted with the date-and-time string format as defined in [Section 3/RFC3339]. | - | 2.15 |
⇐ Utilization | unsignedInt(:255) | R | The current Channel Utilization measured by the Radio on the scanned 20MHz channel, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ Noise | unsignedInt(:255) | R | An indicator of the average radio noise plus interference power measured for the primary operating channel. Encoded as defined for ANPI in [Section 11.10.9.4/802.11-2020]. |
- | 2.15 |
⇐ ScanResult.{i}.OpClassScan.{i}.ChannelScan.{i}.NeighborBSS.{i}. | object(0:) | R | The neighboring BSS discovered by a Radio during a channel scan. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). At most one entry in this table can exist with a given value for BSSID. |
- | 2.15 |
⇐ BSSID | string(:17) | R | [MACAddress] The BSSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SSID | string | R | The SSID indicated by the neighboring BSS. | - | 2.15 |
⇐ SignalStrength | unsignedInt(:255) | R | An indicator of radio signal strength (RSSI) of the Beacon or Probe Response frames of the neighboring BSS as received by the radio measured in dBm. (RSSI is encoded per [Table 9-176/802.11-2020]). Reserved: 221 - 255. NOTE: The underlying WFA specification is in the process of being reviewed for possible clarification. Please refer to that specification for more details. |
- | 2.15 |
⇐ ChannelBandwidth | string | R | Indicates the maximum bandwidth at which the neighboring BSS is operating. e.g. “20” or “40” or “80” or “80+80” or “160” MHz. | - | 2.15 |
⇐ ChannelUtilization | unsignedInt(:255) | R | The channel utilization reported by the neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames, as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ StationCount | unsignedInt | R | The number of Associated Devices (STA) reported by this neighboring BSS per the BSS Load element if present in Beacon or Probe Response frames as defined by [Section 9.4.2.27/802.11-2020]. | - | 2.15 |
⇐ SecurityModeEnabled | string | R | The type of encryption the neighboring WiFi SSID advertises. The WEP value indicates either WEP-64 or WEP-128. The WPA value is the same as WPA-Personal. The WPA2 value is the same as WPA2-Personal. The WPA-WPA2 value is the same as WPA-WPA2-Personal. The WPA3-SAE value is the same as WPA3-Personal. The WPA2-PSK-WPA3-SAE value is the same as WPA3-Personal-Transition. Enumeration of:
|
- | 2.15 |
⇐ EncryptionMode | string[] | R | Comma-separated list of strings. The type of encryption the neighboring WiFi SSID advertises. When SecurityModeEnabled is one of WPA3-SAE, WPA2-PSK-WPA3-SAE, or WPA3-Enterprise, TKIP is not valid, and should not be in the list. Each list item is an enumeration of:
|
- | 2.15 |
⇐ SupportedStandards | string[] | R | Comma-separated list of strings. List items indicate which IEEE 802.11 standards this NeighborBSS instance can support simultaneously, in the frequency band specified by {{param: non-existent ##.Channel}}. Each list item is an enumeration of:
Each value indicates support for the indicated standard. |
- | 2.15 |
⇐ OperatingStandards | string[] | R | Each list item MUST be a member of the list reported by the SupportedStandards parameter. Comma-separated list of strings. List items indicate which IEEE 802.11 standard that is detected for this NeighborBSS. Each value indicates support for the indicated standard. For example, a value of “g,b” (or “b,g” - order is not important) means that the 802.11g standard [802.11g-2003] is used with a backwards-compatible mode for 802.11b [802.11b-1999]. A value of “g” means that only the 802.11g standard can be used. |
- | 2.15 |
⇐ BasicDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Basic data transmit rates (in Mbps) for the SSID. For example, if BasicDataTransferRates is “1,2”, this indicates that the SSID is operating with basic rates of 1 Mbps and 2 Mbps. | - | 2.15 |
⇐ SupportedDataTransferRates | string[](:256) | R | Comma-separated list (maximum number of characters 256) of strings. Data transmit rates (in Mbps) for unicast frames at which the SSID will permit a station to connect. For example, if SupportedDataTransferRates is “1,2,5.5”, this indicates that the SSID will only permit connections at 1 Mbps, 2 Mbps and 5.5 Mbps. | - | 2.15 |
⇐ SupportedNSS | unsignedInt | R | The maximum number of spatial streams (NSS) that can be supported. | - | 2.15 |
⇐ DTIMPeriod | unsignedInt | R | The number of beacon intervals that elapse between transmission of Beacon frames containing a TIM element whose DTIM count field is 0. This value is transmitted in the DTIM Period field of beacon frames. [802.11-2020] | - | 2.15 |
⇐ BeaconPeriod | unsignedInt | R | Time interval (in ms) between transmitting beacons. | - | 2.15 |
Device.WiFi.SSID.{i}. | object(0:) | W | WiFi SSID table (a stackable interface object as described in [Section 4.2/TR-181i2]), where table entries model the MAC layer. A WiFi SSID entry is typically stacked on top of a Radio object. WiFi SSID is also a multiplexing layer, i.e. more than one SSID can be stacked above a single Radio. At most one entry in this table can exist with a given value for Alias, or with a given value for Name, or with a given value for BSSID. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias, Name and BSSID such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Upstream | boolean | R | Indicates whether the interface points towards the Internet (true) or towards End Devices (false). For example: * For an Internet Gateway Device, Upstream will be true for all WAN interfaces and false for all LAN interfaces. * For a standalone WiFi Access Point that is connected via Ethernet to an Internet Gateway Device, Upstream will be true for the Ethernet interface and false for the WiFi Radio interface. * For an End Device, Upstream will be true for all interfaces. This parameter supersedes the deprecated See Radio.{i}.Upstream parameter. If both exist, the parameter Radio.{i}.Upstream is ignored.}}for details of how the two Upstream parameters interact. |
- | 2.12 |
Device.WiFi.AccessPoint.{i}. | object(0:) | W | This object models an 802.11 connection from the perspective of a wireless access point. Each AccessPoint entry is associated with a particular SSID interface instance via the SSIDReference parameter. For enabled table entries, if SSIDReference is not a valid reference then the table entry is inoperable and the CPE MUST set Status to Error_Misconfigured. Note: The AccessPoint table includes a unique key parameter that is a strong reference. If a strongly referenced object is deleted, the CPE will set the referencing parameter to an empty string. However, doing so under these circumstances might cause the updated AccessPoint row to then violate the table’s unique key constraint; if this occurs, the CPE MUST set Status to Error_Misconfigured and disable the offending AccessPoint row. At most one entry in this table can exist with a given value for Alias, or with a given value for SSIDReference. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
RetryLimit | unsignedInt(0:7) | W | The maximum number of retransmission for a packet. This corresponds to IEEE 802.11 parameter dot11ShortRetryLimit. This parameter was DEPRECATED
This parameter was DEPRECATED in 2.11.because it is really a **{{object: non-existent AccessPoint#.Radio}}** attribute. Use **{{param: non-existent RetryLimit#.Radio.{i}.RetryLimit}}**. This parameter is OBSOLETED in 2.14. This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
WMMCapability | boolean | R | Indicates whether this access point supports WiFi Multimedia (WMM) Access Categories (AC).(AC) [WMM]. | - | 2.0 |
MaxAssociatedDevices | unsignedInt | W | The maximum number of devices that can simultaneously be connected to the access point. A value of 0 means that there is no specific limit. This parameter has been DEPRECATED
This parameter was DEPRECATED in 2.13.in favor of **{{param: non-existent MaxAssociatedDevicesMaxAllowedAssociations}}**. This parameter is OBSOLETED in 2.14. This parameter was OBSOLETED in 2.14-2.15. |
0 | 2.4 |
Device.WiFi.AccessPoint.{i}.WPS. | object | R | {{div: unexpected argument WPSv2.0 after: [classes()], [‘This object contains parameters related to Wi-Fi Protected Setup for’, nl(), ’this access point (as specified in ‘, bibref(WPSv1.0), ’ or’, nl(), ‘{bibref’]}}).}}
Changes in 2.15:
|
- | 2.0 |
InitiateWPSPBC() | command | - | [ASYNC] Initiates a Wi-Fi Protected Setup (WPS) Push Button Configuration (PBC) process as defined in [WPS 2.0] . | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the response to the request to start Wi-Fi Protected Setup (WPS) Push Button Configuration (PBC). Enumeration of:
|
- | 2.15 |
Device.WiFi.AccessPoint.{i}.AC.{i}. | object(4:4) | R | This object contains parameters related to WiFi QoS for different 802.11e access categories (priorities). Access categories are: BE, BK, VI, and VO. These parameters can help control and monitor 802.11e Enhanced distributed channel access (EDCA). The size of this table is fixed, with four entries which are identified by the AccessCategory parameter as follows: * BE (Best Effort) * BK (Background) * VI (Video) * VO (Voice) This table MUST contain exactly 4 entries. At most one entry in this table can exist with a given value for AccessCategory. |
- | 2.8 |
AIFSN | unsignedInt(2:15) | W | Arbitration Inter Frame Spacing (Number). This is the number of time slots in the arbitration interframe space.
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
ECWMin | unsignedInt(0:15) | W | Exponent of Contention Window (Minimum). This encodes the values of CWMin as an exponent: CWMin = 2ECWMin - 1. For example, if ECWMin is 8, then CWMin is 28 - 1, or 255, (expressed in microseconds).
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
ECWMax | unsignedInt(0:15) | W | Exponent of Contention Window (Maximum). This encodes the values of CWMax as an exponent: CWMax = 2ECWMax - 1. For example, if ECWMax is 8, then CWMax is 28 - 1, or 255, (expressed in microseconds).
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
TxOpMax | unsignedInt(0:255) | W | Maximum transmit opportunity, in multiples of 32 microseconds. A TXOP time interval of 0 means it is limited to a single MAC protocol data unit (MPDU).
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
Device.WiFi.EndPoint.{i}. | object(0:) | W | This object models an 802.11 connection from the perspective of a wireless end point. Each EndPoint entry is associated with a particular SSID interface instance via the SSIDReference parameter, and an associated active Profile instance via the ProfileReference parameter. The active profile is responsible for specifying the actual SSID and security settings used by the end point. For enabled table entries, if SSIDReference or ProfileReference is not a valid reference then the table entry is inoperable and the CPE MUST set Status to Error_Misconfigured. Note: The EndPoint table includes a unique key parameter that is a strong reference. If a strongly referenced object is deleted, the CPE will set the referencing parameter to an empty string. However, doing so under these circumstances might cause the updated EndPoint row to then violate the table’s unique key constraint; if this occurs, the CPE MUST set Status to Error_Misconfigured and disable the offending EndPoint row. At most one entry in this table can exist with a given value for Alias, or with a given value for SSIDReference. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Device.WiFi.EndPoint.{i}.AC.{i}. | object(4:4) | R | This object contains parameters related to WiFi QoS for different 802.11e access categories (priorities). Access categories are: BE, BK, VI, and VO. These parameters can help control and monitor 802.11e Enhanced distributed channel access (EDCA). The size of this table is fixed, with four entries which are identified by the AccessCategory parameter as follows: * BE (Best Effort) * BK (Background) * VI (Video) * VO (Voice) This table MUST contain exactly 4 entries. At most one entry in this table can exist with a given value for AccessCategory. |
- | 2.8 |
AIFSN | unsignedInt(2:15) | W | Arbitration Inter Frame Spacing (Number). This is the number of time slots in the arbitration interframe space.
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
ECWMin | unsignedInt(0:15) | W | Exponent of Contention Window (Minimum). This encodes the values of CWMin as an exponent: CWMin = 2ECWMin - 1. For example, if ECWMin is 8, then CWMin is 28 - 1, or 255, (expressed in microseconds).
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
ECWMax | unsignedInt(0:15) | W | Exponent of Contention Window (Maximum). This encodes the values of CWMax as an exponent: CWMax = 2ECWMax - 1. For example, if ECWMax is 8, then CWMax is 28 - 1, or 255, (expressed in microseconds).
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
TxOpMax | unsignedInt(0:255) | W | Maximum transmit opportunity, in multiples of 32 microseconds. A TXOP time interval of 0 means it is limited to a single MAC protocol data unit (MPDU).
This parameter was DEPRECATED in 2.15 because it is superseded by the WMM Specification. Changes in 2.15:
|
- | 2.8 |
Device.ZigBee. | object | R | Top level object for ZigBee capabilities based on the [ZigBee2007] specification. | - | 2.7 |
Device.ZigBee.ZDO.{i}. | object(0:) | R | ZigBee Device Object (ZDO) provides management capabilities of the ZigBee Application Support (APS) and Network (NWK) layers of a ZigBee Device as defined in [Section 2.5/ZigBee2007]. At most one entry in this table can exist with the same values for both IEEEAddress and NetworkAddress. It is possible that instances of this object have the same key value when the value of IEEEAddress parameter is “FF:FF:FF:FF:FF:FF:FF:FF” and the ZigBee Coordinators on two or more separate area networks assign the same value for the NetworkAddress. This is because the ZigBee specification describes only intra-area network topologies [Section 1.1.4 Network Topology/ZigBee2007]. As such if two or more ZDO instances have the same key value the implemenation is undefined | - | 2.7 |
BindingTableNumberOfEntries | unsignedInt | R | {{numentries: not associated with a table}}
Changes in 2.15:
|
- | 2.7 |
Device.Bridging. | object | R | Layer 2 bridging configuration. Specifies bridges between different layer 2 interfaces. Bridges can be defined to include layer 2 filter criteria to selectively bridge traffic between interfaces. This object can be used to configure both 802.1D [802.1D-2004] and 802.1Q [802.1Q-2011] bridges. Not all 802.1D and 802.1Q features are modeled, and some additional features not present in either 802.1D or 802.1Q are modeled. 802.1Q [802.1Q-2011] bridges incorporate 802.1Q [802.1Q-2005] customer and 802.1ad [802.1ad-2005] provider bridges. | - | 2.0 |
Device.Bridging.Bridge.{i}. | object(0:) | W | Bridge table. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Device.Bridging.Bridge.{i}.Port.{i}. | object(0:) | W | Bridge Port table, which MUST contain an entry for each bridge port (a stackable interface object as described in [Section 4.2/TR-181i2]). There are two types of bridge ports: management (upward facing) and non-management (downward facing). This is determined by configuring the Boolean ManagementPort parameter. The CPE will automatically configure each management bridge port to appear in the interface stack above all non-management bridge ports that share the same Bridge instance. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Name such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Device.Bridging.Bridge.{i}.Port.{i}.PriorityCodePoint. | object | R | PriorityCodePoint provides the management control for the processing of the Priority Code Point (PCP) field for the 802.1Q header as defined in [Section 6.9.3 Priority Code Point Encoding/802.1Q-2011]. The object is applicable to deployments of Bridging.ProviderBridge where the Bridge instance is referenced by Bridging.ProviderBridge.{i}.SVLANcomponent or Bridging.ProviderBridge.{i}.CVLANcomponents parameters. | - | 2.7 |
PCPEncoding | string(31)[4:4]() | W | Comma-separated list (4 items) (length ) of strings (length 31). This parameter provides the management control for the processing of the encoding of the Priority Code Point (PCP) field for the 802.1Q header as defined in [Section 6.9.3 Priority Code Point Encoding/802.1Q-2011] and [Table 6-3/802.1Q-2011]. The list is an ordered list that contains entries for the following 4 PCP Values: “8P0D”,“7P1D”, “6P2D” “5P3D”. Each list entry matches the following pattern: Each list item matches one of:
[7,7,6,6,5,5,4,4,3,3,2,2,1,1,0,0],[7,7,6,6,5,4,5,4,3,3,2,2,1,1,0,0],[7,7,6,6,5,4,5,4,3,2,3,2,1,1,0,0],[7,7,6,6,5,4,5,4,3,2,3,2,1,0,1,0] |
- | 2.7 |
PCPDecoding | string(15)[4:4]() | W | Comma-separated list (4 items) (length ) of strings (length 15). This parameter provides the management control for the processing of the decoding of the Priority Code Point (PCP) field for the 802.1Q header as defined in [Section 6.9.3 Priority Code Point Encoding/802.1Q-2011] and [Table 6-4/802.1Q-2011]. The list is an ordered list that contains entries for the following 4 PCP Values: “8P0D”,“7P1D”, “6P2D” “5P3D”. Each list entry matches the following pattern: Each list item matches one of:
[7,0,6,0,5,0,4,0,3,0,2,0,1,0,0,0],[7,0,6,0,4,0,4,1,3,0,2,0,1,0,0,0],[7,0,6,0,4,0,4,1,2,0,2,1,1,0,0,0],[7,0,6,0,4,0,4,1,2,0,2,1,0,0,0,1] |
- | 2.7 |
Device.PPP. | object | R | Point-to-Point Protocol [RFC1661]. This object contains the Interface table. | - | 2.0 |
Device.PPP.Interface.{i}. | object(0:) | W | PPP interface table (a stackable interface object as described in [Section 4.2/TR-181i2]). At most one entry in this table can exist with a given value for Alias, or with a given value for Name. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Name such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Device.PPP.Interface.{i}.PPPoE. | object(0:1) | R | PPPoE object that functionally groups PPPoE related parameters. PPPoE is only applicable when the lower layer provides Ethernet frames, e.g. ATM with EoA, PTM, or anything else that supports an Ethernet MAC. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.0 |
Device.PPP.Interface.{i}.PPPoA. | object(0:1) | R | PPPoA object that functionally groups PPPoA related parameters. This object is OBSOLETED
This object was DEPRECATED in 2.12.because it contains no standard parameters and its existence causes confusion.confusion This object was OBSOLETED in 2.12.
This object was DELETED in 2.15. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time.
Changes in 2.15:
|
- | 2.2 |
Device.IP. | object | R | IP object that contains the Interface, ActivePort, and Diagnostics objects. | - | 2.0 |
Device.IP.Diagnostics. | object | R | The IP Diagnostics object.
Changes in 2.15:
|
- | 2.0 |
IPPing() | command | - | [ASYNC] This command provides access to an IP-layer ping test. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ ProtocolVersion | string | W | [MANDATORY] Indicates the IP protocol to be used. Enumeration of:
Changes in 2.15:
|
- | 2.12 |
⇒ Host | string(:256) | W | [MANDATORY] Host name or address of the host to ping. In the case where Host is specified by name, and the name resolves to more than one address, it is up to the device implementation to choose which address to use.
Changes in 2.15:
|
- | 2.12 |
⇒ NumberOfRepetitions | unsignedInt(1:) | W | [MANDATORY] Number of repetitions of the ping test to perform before reporting the
results.
Changes in 2.15:
|
- | 2.12 |
⇒ Timeout | unsignedInt(1:) | W | [MANDATORY] Timeout in milliseconds for the ping test.
Changes in 2.15:
|
- | 2.12 |
⇒ DataBlockSize | unsignedInt(1:65535) | W | [MANDATORY] Size of the data block in bytes to be sent for each ping.
Changes in 2.15:
|
- | 2.12 |
TraceRoute() | command | - | [ASYNC] This command defines access to an IP-layer trace-route test for the specified IP interface. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ ProtocolVersion | string | W | [MANDATORY] Indicates the IP protocol to be used. Enumeration of:
Changes in 2.15:
|
- | 2.12 |
⇒ Host | string(:256) | W | [MANDATORY] Host name or address of the host to find a route to. In the case where Host is specified by name, and the name resolves to more than one address, it is up to the device implementation to choose which address to use.
Changes in 2.15:
|
- | 2.12 |
DownloadDiagnosticsMaxIncrementalResult | unsignedInt(1:) | R | The maximum number of rowsinstances in DownloadDiagnostics().IncrementalResult that the CPEimplementation will store.return. | - | 2.9 |
DownloadDiagnostics() | command | - | [ASYNC] This command 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. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ DownloadURL | string(:2048) | W | [MANDATORY] The [URL] for the CPE to perform the download on. This parameter MUST be in the form of a valid HTTP [RFC2616] or FTP [RFC959] URL. * When using FTP transport, FTP binary transfer MUST be used. * When using HTTP transport, persistent connections MUST be used and pipelining MUST NOT be used. * When using HTTP transport the HTTP Authentication MUST NOT be used. Note: For time based tests (TimeBasedTestDuration > 0) the Controller MAY add a hint to duration of the test to the URL. See [Section 4.3/TR-143] for more details.
Changes in 2.15:
|
- | 2.12 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ TotalBytesReceived | unsignedInt | R | The total number of bytes (at the IP layer) received on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at BOMTime and at EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesSent | unsignedInt | R | The total number of bytes (at the IP layer) sent on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at BOMTime and at EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesReceivedUnderFullLoading | unsignedInt | R | The total number of bytes (at the IP layer) received in between the latest PerConnectionResult.{i}.BOMTime and the earliest PerConnectionResult.{i}.EOMTime. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at the latest PerConnectionResult.{i}.BOMTime and at the earliest PerConnectionResult.{i}.EOMTime and subtracting. | - | 2.12 |
⇐ TotalBytesSentUnderFullLoading | unsignedInt | R | The total number of bytes (at the IP layer) sent between the latest PerConnectionResult.{i}.BOMTime and the earliest PerConnectionResult.{i}.EOMTime. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at the latest PerConnectionResult.{i}.BOMTime and at the earliest PerConnectionResult.{i}.EOMTime and subtracting. | - | 2.12 |
⇐ PerConnectionResult.{i}. | object(0:) | R | Results for individual connections. This table is only populated when EnablePerConnectionResults is true. A new object is created for each connection specified in NumberOfConnections. Instance numbers MUST start at 1 and sequentially increment as new instances are created. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.12 |
⇐ TotalBytesReceived | unsignedInt | R | The total number of bytes (at the IP layer) received on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at BOMTime and at EOMTime and subtracting. | - | 2.12 |
⇐ TotalBytesSent | unsignedInt | R | The total number of bytes (at the IP layer) sent on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at BOMTime and at EOMTime and subtracting. | - | 2.12 |
⇐ IncrementalResult.{i}. | object(0:) | R | Results for time segmented tests (tests where TimeBasedTestDuration > 0 and TimeBasedTestMeasurementInterval > 0). This data is totaled across all connections in the test. A new object is created every TimeBasedTestMeasurementInterval after that interval has completed. Instance numbers MUST start at 1 and sequentially increment as new instances are created. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.12 |
⇐ TotalBytesReceived | unsignedInt | R | The total number of bytes (at the IP layer) received on the Interface between StartTime and EndTime. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at StartTime and at EndTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesSent | unsignedInt | R | The total number of bytes (at the IP layer) sent on the Interface between StartTime and EndTime. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at StartTime and at EndTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
UploadDiagnosticsMaxIncrementalResult | unsignedInt(1:) | R | The maximum number of rowsinstances in UploadDiagnostics().IncrementalResult that the CPEimplementation will store.return. | - | 2.9 |
UploadDiagnostics() | command | - | [ASYNC] This command 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. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ UploadURL | string(:2048) | W | [MANDATORY] The [URL] for the CPE to Upload to. This parameter MUST be in the form of a valid HTTP [RFC2616] or FTP [RFC959] URL. * When using FTP transport, FTP binary transfer MUST be used. * When using HTTP transport, persistent connections MUST be used and pipelining MUST NOT be used. * When using HTTP transport the HTTP Authentication MUST NOT be used.
Changes in 2.15:
|
- | 2.12 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ TotalBytesReceived | unsignedInt | R | The total number of bytes (at the IP layer) received on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at BOMTime and at EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesSent | unsignedInt | R | The total number of bytes (at the IP layer) sent on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at BOMTime and at EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesReceivedUnderFullLoading | unsignedInt | R | The total number of bytes (at the IP layer) received between the latest PerConnectionResult.{i}.BOMTime and the earliest PerConnectionResult.{i}.EOMTime across all connections in the test. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at the latest PerConnectionResult.{i}.BOMTime and at the earliest PerConnectionResult.{i}.EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesSentUnderFullLoading | unsignedInt | R | The total number of bytes (at the IP layer) sent between the latest PerConnectionResult.{i}.BOMTime and the earliest PerConnectionResult.{i}.EOMTime across all connections in the test. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at the latest PerConnectionResult.{i}.BOMTime and at the earliest PerConnectionResult.{i}.EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ PerConnectionResult.{i}. | object(0:) | R | Results for individual connections. This table is only populated when EnablePerConnectionResults is true. A new object is created for each connection specified in NumberOfConnections. Instance numbers MUST start at 1 and sequentially increment as new instances are created. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.12 |
⇐ TotalBytesReceived | unsignedInt | R | The total number of bytes (at the IP layer) received on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at BOMTime and at EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesSent | unsignedInt | R | The total number of bytes (at the IP layer) sent on the Interface between BOMTime and EOMTime. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at BOMTime and at EOMTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ IncrementalResult.{i}. | object(0:) | R | Results for time segmented tests (tests where TimeBasedTestDuration > 0 and TimeBasedTestMeasurementInterval > 0). This data is totaled across all connections in the test. A new object is created every TimeBasedTestMeasurementInterval after that interval has completed. Instance numbers MUST start at 1 and sequentially increment as new instances are created. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.12 |
⇐ TotalBytesReceived | unsignedInt | R | The total number of bytes (at the IP layer) received on the Interface between StartTime and EndTime. This MAY be calculated by sampling Stats.bytesReceivedStats.BytesReceived on the Interface object at StartTime and at EndTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
⇐ TotalBytesSent | unsignedInt | R | The total number of bytes (at the IP layer) sent on the Interface between StartTime and EndTime. This MAY be calculated by sampling Stats.bytesSentStats.BytesSent on the Interface object at StartTime and at EndTime and subtracting. If Interface is an empty string, this parameter cannot be determined and SHOULD be 0. | - | 2.12 |
UDPEchoDiagnostics() | command | - | [ASYNC] This command defines the diagnostics configuration for a UDP Echo test [Appendix A.1/TR-143] defined in [RFC862] or a UDP Echo Plus test defined in [Appendix A.1/TR-143]. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Host | string(:256) | W | [MANDATORY] Host name or address of the host to perform tests to.
Changes in 2.15:
|
- | 2.12 |
⇒ Port | unsignedInt(1:65535) | W | [MANDATORY] Port on the host to perform tests to.
Changes in 2.15:
|
- | 2.12 |
⇒ Timeout | unsignedInt(1:) | W | [MANDATORY] Timeout in milliseconds for the test. That is, the amount of time to wait
for the return of a packet that was sent to the Host.
Changes in 2.15:
|
- | 2.12 |
IPLayerMaxIncrementalResult | unsignedInt(1:) | R | The maximum number of rowsinstances in IPLayerCapacity().IncrementalResult that the deviceimplementation will store.return. | - | 2.14 |
IPLayerCapSupportedSoftwareVersion | string(:64) | R | Indicates the installed version of the test software. The software version string will be implementation-dependent, and SHOULD identify both the implementation and the version (e.g., UDPST-7.2.1). | - | 2.15 |
IPLayerCapSupportedControlProtocolVersion | string(:64) | R | Indicates the control protocol version supported by the test software. Refer to [TR-471] for more information. | - | 2.15 |
IPLayerCapSupportedMetrics | string[] | R | Comma-separated list of strings. Indicates the test metrics from [Section 5.2/TR-471] that are supported by the device. Note that [TR-471] mandates support for and use of IPLR and Sampled RTT. Each list item is an enumeration of:
Changes in 2.15:
|
- | 2.14 |
IPLayerCapacity() | command | - | [ASYNC] This command defines the IP Layer Capacity measurement configuration. IP Layer Capacity measurement is specified in [TR-471]. Data received in the IP Layer Capacity measurement do not require storage on the device.
Changes in 2.15:
|
- | 2.14 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Interface | string(:256) | W | Note that [TR-471] mandates support for and use of IPLR and Sampled RTT. The value MUST be the Path Name of a table row. The IP-layer interface over which the test is to be performed. Example: Device.IP.Interface.1 If an empty string is specified, the device MUST use the interface as directed by its routing policy (Forwarding table entries) to determine the appropriate interface. | - | 2.14 |
⇒ JumboFramesPermitted | boolean | W | If true, jumbo frames are allowed.allowed Defaultabove 1 Gbps. The default value SHOULD be falsetrue. | - | 2.14 |
⇒ UDPPayloadMin | unsignedInt(35:8972) | W | Minimum reference size of UDP payload in octets. No default. The
implementation will algorithmically determine a value if none is
configured. The value SHOULD be set to a value that avoids
fragmentation (i.e., using path MTU discovery).
Changes in 2.15:
|
- | 2.14 |
⇒ UDPPayloadMax | unsignedInt(35:8972) | W | Maximum reference size of UDP payload in octets. No default. The implementation will algorithmically determine a value if none is configured. The value SHOULD be set to the largest value that avoids fragmentation (i.e., using path MTU discovery). If JumboFramesPermitted is false, the maximum value MUST be 1472 octets. If JumboFramesPermitted is true, this value can be as large as 90008972 octets. UDPPayloadMax MUST be greater than or equal to UDPPayloadMin.
Changes in 2.15:
|
- | 2.14 |
⇒ UDPPayloadContent | string | W | UDP Payload Content Type, If there is payload compression in the path and tests intend to characterize a possible advantage due to compression, then payload content SHOULD be supplied by a pseudo-random sequence generator, by using part of a compressed file, or by other means. Payload may also contain the test protocol PDUs. The default value SHOULD be zeroes. Enumeration of:
|
- | 2.15 |
⇒ PortMin | unsignedInt(49152:65535) | W | Starting value for range of Dynamic Ports supported for test traffic and status feedback messages. PortMin MUST be less than or equal to PortMax, if specified. If PortMin and PortMax are not specified, the full range of Ports in the Dynamic Ports range (49152-65535) that have been specifically set aside by IANA MAY be used.
Changes in 2.15:
|
- | 2.14 |
⇒ PortMax | unsignedInt(49152:65535) | W | Indicates the upper bound of the supported Dynamic Port range, where PortMin indicates the starting port number. PortMax MUST be greater than or equal to PortMin., if specified. If PortMin and PortMax are not specified, the full range of Ports in the Dynamic Ports range (49152-65535) that have been specifically set aside by IANA MAY be used.
Changes in 2.15:
|
- | 2.14 |
⇒ IPDVEnable | boolean | W | Enables one-way IPDV (IP packetPacket Delay Variation) metric.metric Defaultfor load rate adjustment algorithm. When true (enabled), one-way delay variation is used, otherwise round-trip delay variation is used. The default value SHOULD be false. | - | 2.14 |
⇒ IPRREnable | boolean | W | Enables IPRR (IP packet Reordering Ratio) metric. DefaultThe default value SHOULD be false. | - | 2.14 |
⇒ RIPREnable | boolean | W | Enables RIPRR (Replicated IP Packet Ratio) metric. The default value SHOULD be false. | - | 2.15 |
⇒ StartSendingRate | unsignedInt(500:10000000) | W | The Sending Rate for a Fixed test or the initial Sending Rate value for a Search test. Value specified in kbps. The default value SHOULD be 500 kbps.
Changes in 2.15:
|
- | 2.14 |
⇒ NumberFirstModeTestSubIntervals | unsignedInt(0:100) | W | When the value >= 1, bimodal test mode is requested and the value represents the number of sub-intervals to be included in the first capacity test mode. The remaining sub-intervals of NumberTestSubIntervals are for the second capacity test mode. Value = 0 indicates that bimodal testing is disabled. The value MUST NOT be greater than NumberTestSubIntervals. The default value SHOULD be 0. | - | 2.15 |
⇒ StatusFeedbackInterval | unsignedInt(5:250) | W | Period of status feedback message (receiver of offered load returns messages to the sender with results of measured metrics). Value specified in milliseconds. The default value SHOULD be 50 milliseconds. | - | 2.14 |
⇒ TimeoutNoTraffic | unsignedInt(5:30) | W | Timeout value. Value specified in seconds. The default value SHOULD be 5 seconds. This parameter was DEPRECATED in 2.15 because it is superseded by TimeoutNoTestTraffic due to new precision requirement. Refer to [TR-471] for details.
Changes in 2.15:
|
- | 2.14 |
⇒ TimeoutNoTestTraffic | unsignedInt(500:1000) | W | Timeout value. If no test traffic packets are received for TimeoutNoTestTraffic milliseconds, test will timeout. Value specified in milliseconds. The default value SHOULD be 1000 milliseconds. | - | 2.15 |
⇒ TimeoutNoStatusMessage | unsignedInt(500:1000) | W | Timeout value. If no status message packets are received for TimeoutNoStatusMessage milliseconds, test will timeout. Value specified in milliseconds. The default value SHOULD be 1000 milliseconds. | - | 2.15 |
⇒ Tmax | unsignedInt(50:3000) | W | Maximum waiting time for packets to arrive. Value specified in milliseconds. The default value SHOULD be 1000 milliseconds. | - | 2.14 |
⇒ TmaxRTT | unsignedInt(50:3000) | W | Maximum Round Trip Time waiting time for packets to arrive. Value specified in milliseconds. The default value SHOULD be 3000 milliseconds. | - | 2.14 |
⇒ TimestampResolution | unsignedInt(1:1000) | W | Indicates the requested precision of timestamp values. The test implementation will determine the actual precision to use based on the implemented resolution capabilities of the protocols used and this requested value. If the implemented resolution capabilities of the IPLayerCapSupportedMetrics protocols being used are able to provide the requested resolution, this resolution SHOULD be provided. Value specified in microseconds. The default value SHOULD be 1 microseconds. | - | 2.14 |
⇒ SeqErrThresh | unsignedInt(0:100) | W | This parameter is only meaningful if TestType is Search. Threshold for Loss or Reordering or Replication impairments measured (events where received packet sequence number did not increase by one). The default value SHOULD be 10. | - | 2.15 |
⇒ ReordDupIgnoreEnable | boolean | W | This parameter is only meaningful if TestType is Search. When true (enabled) only Loss counts toward received packet sequence number errors, and reordering and Duplication impairments are ignored. When false (disabled), Loss, Reordering and Duplication are all counted as sequence number errors. The default value SHOULD be false (disabled). | - | 2.15 |
⇒ LowerThresh | unsignedInt(5:250) | W | This parameter is only meaningful if TestType is Search. The lower threshold on the range of Round Trip Time (RTT) variation. Value specified in milliseconds. The default value SHOULD be 30 milliseconds. | - | 2.14 |
⇒ UpperThresh | unsignedInt(5:250) | W | This parameter is only meaningful if TestType is Search. The upper threshold on the range of Round Trip Time (RTT) variation. Value specified in milliseconds. The default value SHOULD be 90 milliseconds. | - | 2.14 |
⇒ HighSpeedDelta | unsignedInt(2:) | W | This parameter is only meaningful if TestType is Search. The number of rows to move in a single adjustment when initially increasing offered load (to ramp up quickly). The default value SHOULD be 10. | - | 2.14 |
⇒ SlowAdjThresh | unsignedInt(2:) | W | This parameter is only meaningful if TestType is Search. Threshold on the measured number of consecutive status reports indicating loss and/or delay variation above UpperThresh (SlowAdjCount). The default value SHOULD be 2.3. | - | 2.14 |
⇒ HSpeedThresh | unsignedInt(1:) | W | This parameter is only meaningful if TestType is Search. Threshold for transition between low and high sending rate step sizes (such as 1Mbps and 100 Mbps). If JumboFramesPermitted is true this may result in use of jumbo frames. The default value SHOULD be 1 Gbps. | - | 2.14 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ MaxIPLayerCapacity | decimal | R | The maximum IP-Layer Capacity metric from among all IncrementalResult.{i}.IPLayerCapacity values measured between BOMTime and EOMTime across all connections for this test. This is calculated according to [TR-471] Equation 1. Result is expressed in Mbps with 32 digits beyond the decimal. 10^6 bits/second = 1 Mbps.Mbps. | - | 2.14 |
⇐ MaxETHCapacityNoFCS | decimal | R | Results of measurements using the Maximum IP-Layer Capacity metric, according to [TR-471] Equation 1, and calculations to estimate the capacity at Layer 2 with Preamble and Inter-frame gap, but no ETH Frame Check Sequence. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6 bits/second = 1 Mbps. | - | 2.15 |
⇐ MaxETHCapacityWithFCS | decimal | R | Results of measurements using the Maximum IP-Layer Capacity metric, according to [TR-471] Equation 1, and calculations to estimate the capacity at Layer 2 with ETH Frame Check Sequence. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6bits/second = 1 Mbps. | - | 2.15 |
⇐ MaxETHCapacityWithFCSVLAN | decimal | R | Results of measurements using the Maximum IP-Layer Capacity metric, according to [TR-471] Equation 1, and calculations to estimate the capacity at Layer 2 with ETH Frame Check Sequence and VLAN tag. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6bits/second = 1 Mbps. | - | 2.15 |
⇐ ReplicatedRatioAtMax | decimal | R | Ratio of replicated packets to total packets during the sub-interval of MaxIPLayerCapacity. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ InterfaceEthMbpsAtMax | decimal | R | The number of bits observed on the Interface during an IP-Layer Capacity test for time interval of duration TestSubInterval ending at IncrementalResult.{i}.TimeOfSubInterval corresponding to the MaxIPLayerCapacity, divided by the duration of TestSubInterval. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6 bits/second = 1 Mbps. This is primarily a diagnostic measurement. Measurement direction follows the Role. | - | 2.15 |
⇐ IPLayerCapacitySummary | decimal | R | The IP-Layer Capacity metric from among all IncrementalResult.{i}.IPLayerCapacity values measured between BOMTime and EOMTime across all connections for this test. This is calculated according to [TR-471] Equation 1. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6 bits/second = 1 Mbps. | - | 2.15 |
⇐ LossRatioSummary | decimal | R | Ratio of lost packets to total packets during the complete TestInterval. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ RTTRangeSummary | decimal | R | The range of measured Round Trip Time (RTT) during the complete TestInterval. This value is expressed in seconds, as a decimal to 9 decimal digits. | - | 2.15 |
⇐ PDVRangeSummary | decimal | R | The range of Packet Delay Variation (PDV) during the complete TestInterval. This value is expressed in seconds, as a decimal to 9 decimal digits. | - | 2.15 |
⇐ MinOnewayDelaySummary | decimal | R | The minimum one-way delay during the complete TestInterval. This value is expressed in seconds, as a decimal to 9 decimal digits. | - | 2.15 |
⇐ MinRTTSummary | decimal | R | The minimum RTT during the complete TestInterval. This value is expressed in seconds, as a decimal to 9 decimal digits. | - | 2.15 |
⇐ ReorderedRatioSummary | decimal | R | Ratio of reordered packets to total packets during the complete TestInterval. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ ReplicatedRatioSummary | decimal | R | Ratio of replicated packets to total packets during the complete TestInterval. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ InterfaceEthMbpsSummary | decimal | R | The number of bits observed on the Interface during an IP-Layer Capacity test for the entire time interval of duration TestInterval, divided by the duration of TestInterval. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6 bits/second = 1 Mbps. This is primarily a diagnostic measurement. Measurement direction follows the Role. | - | 2.15 |
⇐ TimestampResolutionUsed | unsignedInt | R | Indicates the timestamp resolution of reported results. This is a function of the measurement protocol, and it is usually determined once the protocol chosen. Value specified in microseconds. | - | 2.14 |
⇐ ModalResult.{i}. | object(1:) | R | Modal test results. Only returned when bimodal test mode is enabled (NumberFirstModeTestSubIntervals >=1). If returned, it MUST contain 1 or more entries, with instance number 1 corresponding to the second mode and instance number 2 corresponding to the third mode. Results for the Maximum in each mode/instance are calculated based on IncrementalResult.{i}. data within the boundary of its corresponding mode. This table MUST contain at least 1 entry. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). |
- | 2.15 |
⇐ MaxIPLayerCapacity | decimal | R | The maximum IP-Layer Capacity metric from among all IncrementalResult.{i}.IPLayerCapacity values within corresponding mode across all connections for this test. This is calculated according to [TR-471] Equation 1. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6bits/second = 1 Mbps. | - | 2.15 |
⇐ TimeOfMax | dateTime | R | Time in UTC of end of the sub-interval when MaxIPLayerCapacity was measured. If the value of MaxIPLayerCapacity occurred in multiple sub-intervals, this MUST be the earliest of these sub-intervals. Value MUST be specified to TimestampResolution precision. For example: 2008-04-09T15:01:05.123456Z | - | 2.15 |
⇐ MaxETHCapacityNoFCS | decimal | R | Results of measurements using the Maximum IP-Layer Capacity metric, according to [TR-471] Equation 1, and calculations to estimate the capacity at Layer 2 with Preamble and Inter-frame gap, but no ETH Frame Check Sequence. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6bits/second = 1 Mbps. | - | 2.15 |
⇐ MaxETHCapacityWithFCS | decimal | R | Results of measurements using the Maximum IP-Layer Capacity metric, according to [TR-471] Equation 1, and calculations to estimate the capacity at Layer 2 with ETH Frame Check Sequence. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6bits/second = 1 Mbps. | - | 2.15 |
⇐ MaxETHCapacityWithFCSVLAN | decimal | R | Results of measurements using the Maximum IP-Layer Capacity metric, according to [TR-471] Equation 1, and calculations to estimate the capacity at Layer 2 with ETH Frame Check Sequence and VLAN tag. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6bits/second = 1 Mbps. | - | 2.15 |
⇐ LossRatioAtMax | decimal | R | Ratio of lost packets to total packets during sub-interval of MaxIPLayerCapacity. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ RTTRangeAtMax | decimal | R | The range of Round Trip Time (RTT) during sub-interval of MaxIPLayerCapacity. This value is expressed in seconds. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ PDVRangeAtMax | decimal | R | The range of Packet Delay Variation (PDV) during sub-interval of MaxIPLayerCapacity. This value is expressed in seconds. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ MinOnewayDelayAtMax | decimal | R | The minimum one-way delay during the sub-interval of MaxIPLayerCapacity. The minimum one-way delay is calculated at the conclusion of the test and SHALL be calculated using the conditional distribution of all packets with a finite one-way delay value (undefined delays are excluded). This value is expressed in seconds. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ ReorderedRatioAtMax | decimal | R | Ratio of reordered packets to total packets during the sub-interval of MaxIPLayerCapacity. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ ReplicatedRatioAtMax | decimal | R | Ratio of replicated packets to total packets during the sub-interval of MaxIPLayerCapacity. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ InterfaceEthMbpsAtMax | decimal | R | The number of bits observed on the Interface during an IP-Layer Capacity test for time interval of duration TestSubInterval ending at IncrementalResult.{i}.TimeOfSubInterval corresponding to the MaxIPLayerCapacity, divided by the duration of TestSubInterval. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6 bits/second = 1 Mbps. This is primarily a diagnostic measurement. Measurement direction follows the Role. | - | 2.15 |
⇐ IncrementalResult.{i}. | object(0:) | R | Results for time segmented tests (tests where NumberTestSubIntervals > 1). This data is calculated across all connections in the test. A new object is created every TestSubInterval after that interval has completed. Instance numbers MUST start at 1 and sequentially increment as new instances are created. All instances are removed when new test is started or results are otherwise cleared. This table’s Instance Numbers MUST be 1, 2, 3… (assigned sequentially without gaps). Changes in 2.15:
|
- | 2.14 |
⇐ IPLayerCapacity | decimal | R | Results of measurements using the maximum IP-Layer Capacity metric calculation for a single interval from [TR-471] Equation 1, for time interval of duration TestSubInterval ending at TimeOfSubInterval across all connections for this test. Result is expressed in Mbps with 32 digits beyond the decimal. 10^6 bits/second = 1 Mbps.Mbps. | - | 2.14 |
⇐ ReplicatedRatio | decimal | R | Ratio of replicated packets to total packets, for time interval of duration TestSubInterval ending at TimeOfSubInterval across all connections for this test. This value is expressed as a decimal to 9 decimal digits. | - | 2.15 |
⇐ InterfaceEthMbps | decimal | R | The number of bits observed on the Interface during an IP-Layer Capacity test for time interval of duration TestSubInterval ending at TimeOfSubInterval, divided by the duration of TestSubInterval. Result is expressed in Mbps with 2 digits beyond the decimal. 10^6 bits/second = 1 Mbps. This is primarily a diagnostic measurement. Measurement direction follows the Role. | - | 2.15 |
ServerSelectionDiagnostics() | command | - | [ASYNC] This command provides access to a diagnostics test that performs either an ICMP Ping or UDP Echo ping against multiple hosts determining which one has the smallest average response time. There MUST be a ping response to the transmitted ping, or timeout, before the next ping is sent out. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ ProtocolVersion | string | W | [MANDATORY] Indicates the IP protocol version to be used. Enumeration of:
The default value MUST be Any. Changes in 2.15:
|
- | 2.12 |
⇒ Protocol | string | W | [MANDATORY] The protocol over which the test is to be performed. Enumeration of:
Changes in 2.15:
|
- | 2.12 |
⇒ HostList | string(:256)[:10]() | W | [MANDATORY] Comma-separated list (up to 10 items) (length ) of strings (maximum number of characters per item 256). Each entry is a Host name or address of a host to ping.
Changes in 2.15:
|
- | 2.12 |
⇒ NumberOfRepetitions | unsignedInt(1:) | W | [MANDATORY] Number of repetitions of the ping test to perform for each
HostList entry before reporting the results.
Changes in 2.15:
|
- | 2.12 |
⇒ Timeout | unsignedInt(1:) | W | [MANDATORY] Timeout in milliseconds for each iteration of the ping test where the
total number of iterations is the value of
NumberOfRepetitions times the number of entities in the
HostList Parameter.
Changes in 2.15:
|
- | 2.12 |
Device.MAP. | object | R | The Mapping of Address and Port (MAP) object [RFC7597] [RFC7599] [RFC7598]. This object applies only to gateway devices that support IPv4 on the LAN side, include a NAT, and typically have only IPv6 connectivity on the WAN side. See the MAP Theory of Operation [Appendix XV/TR-181i2] for a description of the working of this MAP data model. | - | 2.8 |
Device.MAP.Domain.{i}. | object(0:) | W | MAP domain settings [RFC7597] [RFC7599]. Each instance models a MAP domain. MAP supports two transport modes, both of which use NAPT44 (modified to use a restricted port range): * MAP-E (TransportMode = Encapsulation) uses an IPv4-in-IPv6 tunnel. * MAP-T (TransportMode = Translation) uses stateless NAT64. Note: There is an n:1 relationship between a MAP domain and the associated WANInterface, i.e. in theory multiple MAP domains can be associated with a single WAN IP interface (each domain would have its own End-user IPv6 prefix and MAP IPv6 address). Note: The Domain table includes unique key parameters that are strong references. If a strongly referenced object is deleted, the CPE will set the referencing parameter to an empty string. However, doing so under these circumstances might cause the updated Domain row to then violate the table’s unique key constraint; if this occurs, the CPE MUST set Status to Error_Misconfigured and disable the offending Domain row. At most one entry in this table can exist with a given value for Alias, or with the same values for both WANInterface and IPv6Prefix. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias, WANInterface and IPv6Prefix such that the new entry does not conflict with any existing entries. |
- | 2.8 |
PSIDOffset | unsignedInt(0:15) | W | Port-set ID (PSID) offset in bits. The number of Port-sets is 2^PSIDOffset. Corresponds to the [RFC7598] S46_PORTPARAMS (Port Parameters) option’s offset field. This parameter was DEPRECATED
This parameter was DEPRECATED in 2.12.because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the **{{object: non-existent DomainRule.{i}.}}** object. This parameter is OBSOLETED in 2.14.object This parameter was OBSOLETED in 2.14-2.15. |
6 | 2.8 |
PSIDLength | unsignedInt(0:16) | W | The length in bits of the Port-set id (PSID) configured in the PSID parameter. Corresponds to the [RFC7598] S46_PORTPARAMS (Port Parameters) option’s PSID-len field. This parameter was DEPRECATED
This parameter was DEPRECATED in 2.12.because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the **{{object: non-existent DomainRule.{i}.}}** object. This parameter is OBSOLETED in 2.14.object This parameter was OBSOLETED in 2.14-2.15. |
0 | 2.8 |
PSID | unsignedInt(0:65535) | W | Port-set ID (PSID) to use in preference to the value extracted from the Embedded Address (EA) bits. Only the high order PSIDLength bits of the PSID value are used, so the parameter is ignored when PSIDLength is zero. Corresponds to the [RFC7598] S46_PORTPARAMS (Port Parameters) option’s PSID field. This parameter was DEPRECATED
This parameter was DEPRECATED in 2.12.because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the **{{object: non-existent DomainRule.{i}.}}** object. This parameter is OBSOLETED in 2.14.object This parameter was OBSOLETED in 2.14-2.15. |
0 | 2.8 |
IncludeSystemPorts | boolean | W | Whether to include low-numbered (system) ports in the Port-sets. Normally ports in the range [0:2^(16-{{param: non-existent PSIDOffset{{inserted: unexpected argument obsoleted after: []}}}})-1] are excluded, e.g. for the default {{param: non-existent PSIDOffset{{inserted: unexpected argument obsoleted after: []}}}} value of 4, ports [0:4095]6, ports [0:1023] are not included in the Port-sets. This parameter is related to [RFC7597]’s N, which is defined as the number of ports (e.g., 1024) excluded from the lower end of the range. The parameter is relevant only when {{param: non-existent PSIDOffset{{inserted: unexpected argument obsoleted after: []}}}} is 0; false corresponds to N=1024 and true corresponds to N=0.
This parameter was DEPRECATED in 2.15 because details changed between drafting this data model and the RFC being published. This parameter has been moved to the proper location within the Rule.{i}. object. Changes in 2.15:
|
false | 2.8 |
Device.MAP.Domain.{i}.Rule.{i}. | object(0:) | W | The MAP domain’s Mapping Rules [RFC7597]. The rule with the longest match between its IPv6Prefix and the end-user IPv6Prefix is the Basic Mapping Rule (BMR). Any of the rules (including the BMR) can be a Forwarding Mapping Rule. At most one entry in this table can exist with a given value for Alias, or with a given value for IPv6Prefix, or with a given value for IPv4Prefix. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. Changes in 2.15:
|
- | 2.8 |
IncludeSystemPorts | boolean | W | Whether to include low-numbered (system) ports in the Port-sets. Normally ports in the range [0:2^(16-PSIDOffset)-1] are excluded, e.g. for the default PSIDOffset value of 6, ports [0:1023] are not included in the Port-sets. This parameter is related to [RFC7597]’s N, which is defined as the number of ports (e.g., 1024) excluded from the lower end of the range. The parameter is relevant only when PSIDOffset is 0; false corresponds to N=1024 and true corresponds to N=0. |
false | 2.15 |
Device.CaptivePortal. | object | R | This object contains parameters relating to the captive portal configuration on the CPE. The captive portal configuration defines the CPE’s upstream HTTP (port 80) traffic redirect behavior. When the captive portal is disabled, upstream HTTP (port 80) traffic MUST be permitted to all destinations. When the captive portal is enabled, upstream HTTP (port 80) traffic MUST be permitted only to destinations listed in the AllowedList; traffic to all other destinations MUST be redirected to the URL. | - | 2.0 |
AllowedList | string[:10000]() | W | Comma-separated list (up to 10000 items) (length ) of strings. List items represent Fully Qualified Domain Names (FQDNs) or IP addresses to which HTTP (port 80) traffic MUST always be permitted, regardless of whether the captive portal is enabled. Each entry in the list MUST be either an FQDN, IP address, or an IP prefix specified using Classless Inter-Domain Routing (CIDR) notation [RFC4632]. An IP prefix is specified as an IP address followed (with no intervening white space) by “/n”, where n (the prefix size) is an integer in the range 0-32 (for IPv4) or 0-128 (for IPv6) that indicates the number of (leftmost) ‘1’ bits of the prefix. IPv4 example: * 1.2.3.4 specifies a single IPv4 address, and 1.2.3.4/24 specifies a class C subnet with subnet mask 255.255.255.0. * 1.2.0.0/22 represents the 1024 IPv4 addresses from 1.2.0.0 to 1.2.3.255. IPv6 example: * fec0::220:edff:fe6a:f76 specifies a single IPv6 address. * 2001:edff:fe6a:f76::/64 represents the IPv6 addresses from 2001:edff:fe6a:f76:0:0:0:0 to 2001:edff:fe6a:f76:ffff:ffff:ffff:ffff.
Changes in 2.15:
|
- | 2.0 |
Device.Routing. | object | R | Routing object that contains the Router table and
RIP protocol object.
Changes in 2.15:
|
- | 2.0 |
Device.Routing.Babel. | object | R | This object provides parameters for configuration, troubleshooting, and monitoring of the Babel routing protocol [RFC8966]. This data model is based on the Babel information model defined in [RFC9046]. | - | 2.15 |
Enable | boolean | W | Enables or disables Babel on the device. | - | 2.15 |
Status | string | R | The status of this entry. Enumeration of:
The Error_Misconfigured value indicates that a necessary configuration value is undefined or invalid. The Error value MAY be used by the device to indicate a locally defined error condition. |
- | 2.15 |
ImplementationVersion | string(:32) | R | The name and version of this implementation of the Babel protocol. This is not the same as the version of the Babel protocol that has been implemented. The method of naming and identifying implementation versions will be specific to the implementation. | - | 2.15 |
SelfRouterID | hexBinary | R | The router-id used by this instance of the Babel protocol to identify itself. [RFC8966] describes this as an arbitrary string of 8 octets. | - | 2.15 |
SelfSeqno | unsignedInt(:65535) | R | The current sequence number included in route updates for routes originated by this node. | - | 2.15 |
SupportedMetricCompAlgorithms | string[] | R | Comma-separated list of strings. Supported cost computation algorithms. Each list item is an enumeration of:
|
- | 2.15 |
SupportedSecurityMechanisms | string[] | R | Comma-separated list of strings. Supported security mechanisms. Each list item is an enumeration of: |
- | 2.15 |
SupportedMACAlgorithms | string[] | R | Comma-separated list of strings. Supported MAC computation algorithms. Each list item is an enumeration of: |
- | 2.15 |
SupportedDTLSCertTypes | string[] | R | Comma-separated list of strings. Supported DTLS certificate types. Each list item is an enumeration of: |
- | 2.15 |
StatsEnable | boolean | W | Enables or disables collection of statistics on all InterfaceSetting. instances. Statistics are provided in InterfaceSetting.{i}.Stats.. When enabled, existing statistics values are not cleared and will be incremented as new packets are counted. | - | 2.15 |
InterfaceSettingNumberOfEntries | unsignedInt | R | The number of entries in the InterfaceSetting table. | - | 2.15 |
RouteNumberOfEntries | unsignedInt | R | The number of entries in the Route table. | - | 2.15 |
MACKeySetNumberOfEntries | unsignedInt | R | The number of entries in the MACKeySet table. | - | 2.15 |
DTLSCertSetNumberOfEntries | unsignedInt | R | The number of entries in the DTLSCertSet table. | - | 2.15 |
StatsReset() | command | - | This command represents a request to reset all statistics counters to zero. Statistics are provided in InterfaceSetting.{i}.Stats.. | - | 2.15 |
Device.Routing.Babel.Constants. | object | R | This object represents the constants used by the Babel protocol. | - | 2.0 |
UDPPort | unsignedInt(1:65535) | W | The UDP port number used by the Babel implementation to send and receive Babel packets. The UDP port number assigned by IANA is 6696. | - | 2.0 |
MulticastGroup | string(:45) | W | [IPv6Address] The multicast group for sending and listening to multicast announcements on IPv6. The multicast group assigned by IANA is ff02::1:6. | - | 2.0 |
Device.Routing.Babel.InterfaceSetting.{i}. | object(0:) | W | This object provides parameters related to the interfaces the Babel protocol is operating over and can act as a routing protocol for. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Enable | boolean | W | Enables or disables Babel on this interface. | - | 2.0 |
Status | string | R | The status of this entry. Enumeration of:
|
Disabled | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
InterfaceReference | string | R | The value MUST be the Path Name of a row in the Device.IP.Interface. table. If the referenced object is deleted, the parameter value MUST be set to an empty string. The Device.IP.Interface. object instance this Babel implementation is running over. The referenced interface object MUST have Device.IP.Interface.{i}.IPv6Enable set to true. | - | 2.0 |
InterfaceMetricAlgorithm | string | R | The value MUST be a member of the list reported by the SupportedMetricCompAlgorithms parameter. Indicates the metric computation algorithm used on this interface, from among the supported metric computation algorithms listed in SupportedMetricCompAlgorithms. | - | 2.0 |
SplitHorizonEnabled | boolean | W | Enables or disables the use of split horizon optimization when calculating metrics on this interface. Split horizon optimization is described in [Section 3.7.4/RFC8966]. | - | 2.0 |
McastHelloSeqno | unsignedInt(:65535) | R | The current sequence number in use for multicast Hellos sent on this interface. | - | 2.0 |
McastHelloInterval | unsignedInt(:65535) | R | The current interval (time in centiseconds) used for multicast Hellos sent on this interface. | - | 2.0 |
UpdateInterval | unsignedInt(:65535) | R | The current interval (time in centiseconds) used for all updates (multicast or unicast) sent on this interface. | - | 2.0 |
MACEnabled | boolean | W | Enables or disables the MAC security mechanism. | - | 2.0 |
InterfaceMACKeySets | string[] | W | Comma-separated list of strings. Each list item MUST be the Path Name of a row in the MACKeySet. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. MACKeySet. instances that apply to this InterfaceSetting instance. When an InterfaceSetting is created, all MACKeySet. instances with MACKeySet.{i}.DefaultApply of true will be included in this list. | - | 2.0 |
MACVerify | boolean | W | A Boolean flag indicating whether MACs in incoming Babel packets are required to be present and are verified. If this parameter is true, incoming packets are required to have a valid MAC. | - | 2.0 |
DTLSEnabled | boolean | W | Enables or disables the DTLS security mechanism. | - | 2.0 |
InterfaceDTLSCertSets | string[] | W | Comma-separated list of strings. Each list item MUST be the Path Name of a row in the DTLSCertSet. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. DTLSCertSet. instances that apply to this InterfaceSetting instance. When an InterfaceSetting is created, all DTLSCertSet. instances with DTLSCertSet.{i}.DefaultApply of true will be included in this list. | - | 2.0 |
CachedInfoEnabled | boolean | W | A Boolean flag indicating whether the cached_info extension is included in ClientHello and ServerHello packets (see [Appendix A/RFC8968]. The extension is included if true. | - | 2.0 |
DTLSCertPrefer | string | W | The value MUST be a member of the list reported by the SupportedDTLSCertTypes parameter. Supported certificate types (from SupportedDTLSCertTypes), listed in order of preference. This list is used to populate the server_certificate_type extension in a ClientHello (see [Appendix A/RFC8968]). Values that are present with a non-empty DTLSCertSet.{i}.DTLSCert.{i}.CertPrivateKey in at least one instance of DTLSCertSet.{i}.DTLSCert. included in a DTLSCertSet. instance referenced by InterfaceDTLSCertSets will be used to populate the client_certificate_type extension in a Client Hello. | - | 2.0 |
PacketLogEnable | boolean | W | Enables or disables the logging of Babel packets into the PacketLog on this interface. | - | 2.0 |
PacketLog | string | R | The value MUST be the Path Name of a row in the Device.DeviceInfo.VendorLogFile. table. If the referenced object is deleted, the parameter value MUST be set to an empty string. A reference to a DeviceInfo.VendorLogFile instance that contains a timestamped log of packets received and sent on Constants.UDPPort on this interface. The [LIBPCAP] file format with .pcap file extension SHOULD be supported for packet log files. Logging is enabled/disabled by PacketLogEnable. | - | 2.0 |
NeighborNumberOfEntries | unsignedInt | R | The number of entries in the Neighbor table. | - | 2.0 |
Device.Routing.Babel.InterfaceSetting.{i}.Stats. | object | R | This object provides statistics parameters for this interface. | - | 2.0 |
SentMcastHello | unsignedLong | R | [StatsCounter64] A count of the number of multicast Hello packets sent on this interface. | - | 2.0 |
SentMcastUpdate | unsignedLong | R | [StatsCounter64] A count of the number of multicast update packets sent on this interface. | - | 2.0 |
SentUcastHello | unsignedLong | R | [StatsCounter64] A count of the number of unicast Hello packets sent on this interface. | - | 2.0 |
SentUcastUpdate | unsignedLong | R | [StatsCounter64] A count of the number of unicast update packets sent on this interface. | - | 2.0 |
SentIHU | unsignedLong | R | [StatsCounter64] A count of the number of IHU (“I Heard You”) packets sent on this interface. | - | 2.0 |
ReceivedPackets | unsignedLong | R | [StatsCounter64] A count of the number of Babel packets received on this interface. | - | 2.0 |
Device.Routing.Babel.InterfaceSetting.{i}.Neighbor.{i}. | object(0:) | R | This object provides parameters related to neighbor devices that Babel packets are received from and sent to. At most one entry in this table can exist with a given value for NeighborAddress. |
- | 2.0 |
NeighborAddress | string(:45) | R | [IPAddress] IP address the neighbor sends packets from. | - | 2.0 |
HelloMCastHistory | hexBinary | R | The multicast Hello history of whether or not the multicast Hello packets prior to ExpectedMCastHelloSeqno were received. This is a binary sequence where the most recently received Hello is expressed as a “1” placed in the left-most bit, with prior bits shifted right (and “0” bits placed between prior Hello bits and the most recent Hello bit for any not-received Hellos). This value is displayed using hex digits. See [Section A.1/RFC8966]. | - | 2.0 |
HelloUCastHistory | hexBinary | R | The unicast Hello history of whether or not the unicast Hello packets prior to ExpectedUCastHelloSeqno were received. This is a binary sequence where the most recently received Hello is expressed as a “1” placed in the left-most bit, with prior bits shifted right (and “0” bits placed between prior Hello bitss and the most recent Hello bit for any not-received Hellos). This value is displayed using hex digits. See [Section A.1/RFC8966]. | - | 2.0 |
TXCost | unsignedInt(:65535) | R | Transmission cost value from the last IHU (“I Heard You”) packet received from this neighbor, or maximum value (as defined in [Section 3.4.2/RFC8966]) to indicate the IHU hold timer for this neighbor has expired. | - | 2.0 |
ExpectedMCastHelloSeqno | int(-1:65535) | R | Expected multicast Hello sequence number of next Hello to be received from this neighbor. If multicast Hello packets are not expected, or processing of multicast packets is not enabled, this MUST be -1. Note [RFC9046] specifies a 16-bit unsigned integer with NULL value to represent no processed or expected multicast Hello packets. | - | 2.0 |
ExpectedUCastHelloSeqno | int(-1:65535) | R | Expected unicast Hello sequence number of next Hello to be received from this neighbor. If unicast Hello packets are not expected, or processing of unicast packets is not enabled, this MUST be -1. | - | 2.0 |
UnicastHelloSeqno | int(-1:65535) | R | The current sequence number in use for unicast Hellos sent to this neighbor. If unicast Hello packets are not being sent, this MUST be -1. | - | 2.0 |
UnicastHelloInterval | unsignedInt(:65535) | R | The current interval in centiseconds used for unicast Hellos sent to this neighbor. | - | 2.0 |
RXCost | unsignedInt(:65535) | R | Reception cost calculated for this neighbor. This value is usually derived from the Hello history, which may be combined with other data, such as statistics maintained by the link layer. The RXCost is sent to a neighbor in each IHU (“I Heard You”) packet. See [Section 3.4.3/RFC8966]. | - | 2.0 |
Cost | unsignedInt(:65535) | R | Link cost is computed from the values maintained by a Babel implementation in its neighbor table as defined in [Section3.2.4/RFC8966]: the statistics kept about the reception of Hellos and the transmission cost computed from received IHU packets. See [Section 3.4.3/RFC8966]. | - | 2.0 |
Device.Routing.Babel.Route.{i}. | object(0:) | R | This object provides parameters for routes recieved from neighbors and internal routes. At most one entry in this table can exist with the same values for both RoutePrefix and SourceRouterID. |
- | 2.0 |
RoutePrefix | string(:49) | R | [IPPrefix] IP prefix for which this route is advertised. | - | 2.0 |
SourceRouterID | hexBinary | R | Router-id of the router that originated this route. | - | 2.0 |
Neighbor | string | R | The value MUST be the Path Name of a row in the InterfaceSetting.{i}.Neighbor. table. If the referenced object is deleted, the parameter value MUST be set to an empty string. Reference to the InterfaceSetting.{i}.Neighbor entry for the neighbor that advertised this route. | - | 2.0 |
ReceivedMetric | int(-1:65535) | R | The metric with which this route was advertised by the neighbor, or maximum value (as defined in [RFC8966]) to indicate the route was recently retracted and is temporarily unreachable (see [Section 3.5.5/RFC8966]). This metric will be -1 if the route was not received from a neighbor but was generated through other means. At least one of ReceivedMetric and CalculatedMetric MUST have a value other than -1. Having both be other than -1 is expected for a route that is received and subsequently advertised. | - | 2.0 |
CalculatedMetric | int(-1:65535) | R | A calculated metric for this route. How the metric is calculated is implementation-specific. Maximum value (as defined in [RFC8966]) indicates the route was recently retracted and is temporarily unreachable ([Section 3.5.5/RFC8966]). At least one of ReceivedMetric and CalculatedMetric MUST have a value other than -1. Having both be other than -1 is expected for a route that is received and subsequently advertised. | - | 2.0 |
RouteSeqno | unsignedInt(:65535) | R | The sequence number with which this route was advertised. | - | 2.0 |
NextHop | string(:45) | R | [IPAddress] The next-hop address of this route. This will be empty if this route has no next-hop address. | - | 2.0 |
RouteFeasible | boolean | R | A Boolean flag indicating whether this route is feasible, as defined in [Section 3.5.1/RFC8966]. | - | 2.0 |
RouteSelected | boolean | R | A Boolean flag indicating whether this route is selected (i.e., whether it is currently being used for forwarding and is being advertised). | - | 2.0 |
Device.Routing.Babel.MACKeySet.{i}. | object(0:) | W | This object provides parameters related to use of the HMAC security mechanism [RFC8967] to sign and verify Babel packets. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DefaultApply | boolean | W | A Boolean flag indicating whether this MACKeySet instance is to be applied to all new InterfaceSetting. instances. If true, this MACKeySet instance applies to all new InterfaceSetting. instances at the time they are created and a reference to this MACKeySet is included in the InterfaceSetting.{i}.InterfaceMACKeySets parameter. If false, this MACKeySet is not applied to new InterfaceSetting. instances when they are created. | - | 2.0 |
MACKeyNumberOfEntries | unsignedInt | R | The number of entries in the MACKey table. | - | 2.0 |
Device.Routing.Babel.MACKeySet.{i}.MACKey.{i}. | object(0:) | W | This object provides the MAC keys used to calculate MACs for verification and sending by the MACKeySet instance. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
KeyUseSend | boolean | W | Indicates whether this KeyValue is used to compute a MAC and include that MAC in the sent Babel packet. A MAC for sent packets is computed using this key if the value is true. If the value is false, this key is not used to compute a MAC to include in sent Babel packets. | - | 2.0 |
KeyUseVerify | boolean | W | Indicates whether the KeyValue is used to verify incoming Babel packets. Incoming packets are verified using this key if true. If false no MAC is computed from KeyValue for comparing with the MAC in an incoming Babel packet. | - | 2.0 |
KeyValue | hexBinary | WO | The value of the MAC key. This value is immutable, once written. This value is of a length suitable for the associated MACKeyAlgorithm. If the algorithm is based on the HMAC construction [RFC2104], the length MUST be between 0 and an upper limit that is at least the size of the output length (where “HMAC-SHA256” output length is 32 octets as described in [RFC4868]). Longer lengths MAY be supported but are not necessary if the management system has the ability to generate a suitably random value (e.g., by randomly generating a value or by using a key derivation technique as recommended in [Security Considerations/RFC8967]). If the algorithm is “BLAKE2s-128”, the length MUST be between 0 and 32 bytes inclusive, as specified in [RFC7693]. Once it’s been set, this parameter is immutable. When read, this parameter returns an empty string, regardless of the actual value. |
- | 2.0 |
MACKeyAlgorithm | string | W | The value MUST be a member of the list reported by the SupportedMACAlgorithms parameter. The name of the MAC algorithm used with this key. The value MUST be the same as one of the enumerations listed in the SupportedMACAlgorithms parameter. | - | 2.0 |
MACTest() | command | - | This command allows the MAC key and MAC algorithm to be tested to see if they produce an expected outcome. The command calculates a MAC for InputString using the KeyValue and MACKeyAlgorithm and compares that to the value of InputMAC. If the values match, the output Match is true. | - | 2.0 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ InputString | hexBinary | W | [MANDATORY] The command calculates a MAC of InputString using the KeyValue and MACKeyAlgorithm. | - | 2.0 |
⇒ InputMAC | hexBinary | W | [MANDATORY] The command compares the calculated MAC to InputMAC. | - | 2.0 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Match | boolean | R | Match is true if the calculated MAC and InputMAC are the same. | - | 2.0 |
Device.Routing.Babel.DTLSCertSet.{i}. | object(0:) | W | This object provides parameters related to use of the DTLS security mechanism [RFC8968] to encrypt Babel packets. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DefaultApply | boolean | W | A Boolean flag indicating whether this DTLSCertSet instance is to be applied to all new InterfaceSetting. instances. If true, this DTLSCertSet instance applies to all new InterfaceSetting. instances at the time they are created and a reference to this DTLSCertSet is included in the InterfaceSetting.{i}.InterfaceDTLSCertSets parameter. If false, this DTLSCertSet is not applied to new InterfaceSetting. instances when they are created. | - | 2.0 |
DTLSCertNumberOfEntries | unsignedInt | R | The number of entries in the DTLSCert table. | - | 2.0 |
Device.Routing.Babel.DTLSCertSet.{i}.DTLSCert.{i}. | object(0:) | W | This object provides the certificates used for verification and signing by the DTLSCertSet instance with DTLS. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
CertValue | string(:256) | WO | The DTLS certificate in PEM format [RFC7468]. This value is immutable, once written. Once it’s been set, this parameter is immutable. |
- | 2.0 |
CertType | string | W | The value MUST be a member of the list reported by the SupportedDTLSCertTypes parameter. The certificate type of CertValue (from among the supported types in SupportedDTLSCertTypes). This value is immutable, once written. | - | 2.0 |
CertPrivateKey | hexBinary | WO | The private key of the certificate. CertPrivateKey is only given a value if the certificate belongs to this device. If CertPrivateKey is non-empty, this certificate can be supplied during DTLS handshaking. This value is immutable, once written. Once it’s been set, this parameter is immutable. When read, this parameter returns an empty string, regardless of the actual value. |
- | 2.0 |
Device.Hosts. | object | R | This object provides information about each of the hosts on the LAN, including those whose IP address was allocated by the CPE using DHCP as well as hosts with statically allocated IP addresses. It can also include non-IP hosts. | - | 2.0 |
Device.Hosts.Host.{i}. | object(0:) | R | Host table. At most one entry in this table can exist with a given value for PhysAddress. Changes in 2.15:
|
- | 2.0 |
Alias | string(:64) | W | [Alias] ::: hide
A non-volatile unique key used to reference this instance. Alias provides
a mechanism for a Controller to label this instance for future reference.
The following mandatory constraints MUST be enforced:
This parameter was DEPRECATED in 2.11.because Host is a transient object. This parameter is OBSOLETED in 2.14.object This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
AddressSource | string | R | Indicates whether the IP address of the host was allocated by the CPE using DHCP, was assigned to the host statically, or was assigned using automatic IP address allocation. Enumeration of:
This parameter was DEPRECATED in 2.11.because only **{{enum: non-existent **{{enum: only valid as argument}}****None}} and **{{enum: non-existent **{{enum: only valid as argument}}****DHCP}} made sense (the CPE doesn’t know whether the address is **{{enum: non-existent **{{enum: only valid as argument}}****Static}} or **{{enum: non-existent **{{enum: only valid as argument}}****AutoIP}}). The **{{enum: non-existent **{{enum: only valid as argument}}****DHCP}} case is now handled via the **{{param: non-existent AddressSourceDHCPClient}}** reference. This parameter is OBSOLETED in 2.14.reference This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
LeaseTimeRemaining | int(-1:) | R | DHCP lease time remaining in seconds. A value of -1 indicates an infinite lease. The value MUST be 0 (zero) if the AddressSource is not DHCP. This parameter was DEPRECATED
This parameter was DEPRECATED in 2.11.because DHCP lease/lifetime information can be accessed via the **{{param: non-existent LeaseTimeRemainingDHCPClient}}** reference. This parameter is OBSOLETED in 2.14.reference This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
VendorClassID | string(:255) | R | Vendor Class Identifier DHCP option (Option 60) of the host. This is a normal string, e.g. “abc” is represented as “abc” and not say “616263” hex. However, if the value includes non-printing characters then such characters have to be represented using XML escapes, e.g. #x0a for line-feed. It MAY be defined when AddressSource is DHCP. An empty string indicates this option is not used. Note: DHCPv4 Option values are limited to a length of 255, while DHCPv6 Option values can have a maximum length of 65535. This parameter was DEPRECATED This parameter was DEPRECATED in 2.11.because host-supplied DHCP options can be accessed via the **{{param: non-existent VendorClassIDDHCPClient}}** reference. This parameter is OBSOLETED in 2.14.}} reference
This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
ClientID | hexBinary(:65535) | R | A hexbinary string, Client Identifier DHCP option (Option 61) for the specific IP connection of the client. The option value is binary, so an exact match is REQUIRED. It MAY be defined when AddressSource is DHCP. An empty string indicates this option is not used. Note: DHCPv4 Option values are limited to a length of 255, while DHCPv6 Option values can have a maximum length of 65535. This parameter was DEPRECATED
This parameter was DEPRECATED in 2.11.because host-supplied DHCP options can be accessed via the **{{param: non-existent ClientIDDHCPClient}}** reference. This parameter is OBSOLETED in 2.14.reference This parameter was OBSOLETED in 2.14.
This parameter was DELETED in 2.15. Changes in 2.15:
|
- | 2.0 |
UserClassID | hexBinary(:65535) | R | A hexbinary string, User Class Identifier DHCP option (Option 77) of the host. It MAY be defined when {{param: non-existent AddressSource{{inserted: unexpected argument deleted after: []}}}} is {{enum: reference to deleted enumeration Device.Hosts.Host.{i}.AddressSource.DHCP}}. An empty string indicates this option is not used. Note: DHCPv4 Option values are limited to a length of 255, while DHCPv6 Option values can have a maximum length of 65535. This parameter is DEPRECATED
This parameter was DEPRECATED in 2.11.because host-supplied DHCP options can be accessed via the **{{param: non-existent UserClassIDDHCPClient}}** reference.reference This parameter was OBSOLETED in 2.15. |
- | 2.0 |
Device.Hosts.AccessControl.{i}. | object(0:) | W | Every instance of this object provides access control for a LAN device. Access is allowed if no instance of AccessControl is defined for a device. If access is not allowed, then the LAN device cannot access the broadband network. At most one entry in this table can exist with a given value for Alias, or with a given value for PhysAddress. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and PhysAddress such that the new entry does not conflict with any existing entries. |
- | 2.14 |
Device.Hosts.AccessControl.{i}.Schedule.{i}. | object(0:) | W | Each instance of this object provides a schedule where access is enabled. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.14 |
Day | string[] | W | Comma-separated list ofComma-separated list of strings, the. days for which access is enabled.enabled Each list item is an enumeration of:
|
- | 2.14 |
Device.DNS. | object | R | Properties for Domain Name Service (DNS). | - | 2.0 |
Device.DNS.Client. | object | R | Client properties for Domain Name Service (DNS). The DNS client resolves FQDN on behalf of device internal (client) applications. | - | 2.0 |
Device.DNS.Client.Server.{i}. | object(0:) | W | This table contains the DNS Server IP address to be used by the DHCPDNS Client (it does not model a DNS Server). Entries are either automatically created as result of DHCP (v4 or v6), IPCP, or RA received DNS server information, or are statically configured by the Controller. At most one entry in this table can exist with a given value for DNSServer, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for DNSServer and Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Type | string | R | Method used to assign the DNSServer address. Enumeration of:
|
Static | 2.0 |
Device.DNS.Relay. | object | R | DNS Relay object. The DNS proxy (or relay) function allows the forwarding of local network DNS queries to local or external DNS server(s) [RFC5625]. | - | 2.0 |
ForwardNumberOfEntries | unsignedInt | R | The number of entries in the Forwarding table.
Changes in 2.15:
|
- | 2.0 |
Device.DNS.Relay.Forwarding.{i}. | object(0:) | W | DNS Server forwarding policy to be used by the DNS Relay. Entries are either automatically created as result of DHCP (v4 or v6), IPCP, or RA received DNS server information, or are statically configured by the Controller. Note: Management of re-directing queries to the device embedded DNS server is not defined in this version of the specification. At most one entry in this table can exist with a given value for DNSServer, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for DNSServer and Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Type | string | R | Method used to assign the DNSServer address. Enumeration of:
|
Static | 2.0 |
Device.DNS.Diagnostics. | object | R | The DNS Diagnostics object containing the {{object: referenced NSLookupDiagnostics() is command, not object}} test. | - | 2.0 |
NSLookupDiagnostics() | command | - | [ASYNC] This command defines access to an IP-layer NS Lookup test for the specified IP interface. When initiated, the NS Lookup test will contact DNSServer and look up HostName NumberOfRepetitions times. There will be a Result instance for each time the device performs a DNS lookup, which is determined by the value of NumberOfRepetitions. Any previous Result instances are removed when a new test is initiated. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ HostName | string(:256) | W | [MANDATORY] Specifies the Host Name that NS Lookup is to look for. The current
domain name MUST be used unless the name is a fully qualified name.
Changes in 2.15:
|
- | 2.12 |
⇒ Timeout | unsignedInt | W | [MANDATORY] Timeout in milliseconds that indicates that a request has failed.
Changes in 2.15:
|
- | 2.12 |
⇒ NumberOfRepetitions | unsignedInt | W | [MANDATORY] The number of times the device SHOULD repeat the execution of the NSLookup using the same input parameters. If the diagnostics test fails the CPE MAY terminate the test without completing the full number of repetitions. Each repetition will use a Result instance to hold the NSLookup result data.
Changes in 2.15:
|
- | 2.12 |
Device.DHCPv4. | object | R | The Dynamic Host Configuration Protocol (DHCP) IPv4 object [RFC2131]. This entire object applies to IPv4 only. It contains the Client, Server, and Relay objects. | - | 2.0 |
Device.DHCPv4.Server. | object | R | DHCP server configuration. | - | 2.0 |
Device.DHCPv4.Server.Pool.{i}. | object(0:) | W | DHCP conditional serving pool table. Each instance of this object defines a DHCP conditional serving pool. Client requests are associated with pools based on criteria such as source interface, supplied DHCP options, and MAC address. Overlapping pool ranges MUST be supported. For enabled table entries, if Interface is not a valid reference, or MinAddress, MaxAddress, or SubnetMask is not a valid value, then the table entry is inoperable and the CPE MUST set Status to Error_Misconfigured. At most one entry in this table can exist with a given value for Alias, or with a given value for Order. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Order such that the new entry does not conflict with any existing entries. Changes in 2.15:
|
- | 2.0 |
Device.Users. | object | R | Users object that contains the User, table.Group, and Role tables.
Changes in 2.15:
|
- | 2.0 |
GroupNumberOfEntries | unsignedInt | R | The number of entries in the Group table. | - | 2.0 |
RoleNumberOfEntries | unsignedInt | R | The number of entries in the Role table. | - | 2.0 |
SupportedShellNumberOfEntries | unsignedInt | R | The number of entries in the SupportedShell table. | - | 2.0 |
CheckCredentialsDiagnostics() | command | - | [ASYNC] Checks whether the input Username and Password are valid for allowing access to the user interface on the device. If not valid, then an indication of why they are not valid is output. | - | 2.15 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ Username | string | W | The user name for logging in to the user interface on the device. | - | 2.15 |
⇒ Password | string | W | The password for logging in to the user interface on the device. | - | 2.15 |
⇐ Output. | arguments | - | Output arguments. | - | |
⇐ Status | string | R | Indicates the response to request to check whether the credentials are valid and, if not, why not. Enumeration of:
|
- | 2.15 |
Device.Users.User.{i}. | object(0:) | W | This object contains parameters relating to the user characteristics. At most one entry in this table can exist with a given value for Username, or with a given value for Alias, or with a given value for UserID. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and UserID such that the new entry does not conflict with any existing entries. Changes in 2.15:
|
- | 2.0 |
UserID | unsignedInt | W | Unique Identifier of the user. Depending on the implementation this can be the unique identifier assigned by the underlying system. If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. |
- | 2.15 |
GroupParticipation | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of a row in the Group. table. The Groups of which this User is a member. | <Empty> | 2.0 |
RoleParticipation | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of a row in the Role. table. The Roles which are assigned to this User. | <Empty> | 2.0 |
StaticUser | boolean | R | A static user is a fixed user that is always available in the system. When set to true, the user cannot be removed. | false | 2.0 |
Shell | string | W | The value MUST be the Path Name of a row in the SupportedShell. table. An empty string means Shell access disabled. | <Empty> | 2.0 |
Device.Users.Group.{i}. | object(0:) | W | This object contains parameters relating to the characteristics of a user group. At most one entry in this table can exist with a given value for Groupname, or with a given value for Alias, or with a given value for GroupID. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and GroupID such that the new entry does not conflict with any existing entries. |
- | 2.15 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.15 |
Enable | boolean | W | Enables/disables this group object instance. If any User which belongs to a Group which becomes disabled is currently accessing the device then the effect on that User should be as if the Group were removed from that User’s GroupParticipation list. |
false | 2.15 |
GroupID | unsignedInt | W | Unique Identifier of the group. Depending on the implementation this can be the unique identifier assigned by the underlying system. If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. |
- | 2.15 |
Groupname | string(:64) | W | Name of the Group. MUST NOT be an empty string for an enabled entry. | <Empty> | 2.15 |
RoleParticipation | string[](:1024) | W | Comma-separated list (maximum number of characters 1024) of strings. Each list item MUST be the Path Name of a row in the Role. table. These Roles are assigned to any User which is member of this Group, for so long as they remain a member of the Group. | <Empty> | 2.15 |
StaticGroup | boolean | R | A static group is a fixed group that is always available in the system. When set to true, the group cannot be removed. | false | 2.15 |
Device.Users.SupportedShell.{i}. | object(0:) | W | This table provides a list of user accessible shells which can be used as a reference in Users.User.{i}.Shell At most one entry in this table can exist with a given value for Alias, or with a given value for Name. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Name such that the new entry does not conflict with any existing entries. |
- | 2.15 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.15 |
Enable | boolean | W | Enables/disables this SupportedShell object instance. | false | 2.15 |
Name | string(:64) | R | Name of the Shell If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. |
- | 2.15 |
Device.Users.Role.{i}. | object(0:) | W | This object contains parameters relating to the role characteristics. At most one entry in this table can exist with a given value for RoleName, or with a given value for Alias, or with a given value for RoleID. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and RoleID such that the new entry does not conflict with any existing entries. |
- | 2.15 |
Alias | string(:64) | W | [Alias] A non-volatile unique key used to reference this instance. Alias provides a mechanism for a Controller to label this instance for future reference. The following mandatory constraints MUST be enforced:
If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. This is a non-functional key and its value MUST NOT change once it’s been assigned by the Controller or set internally by the Agent. Value Change Notification requests for this parameter MAY be denied. |
- | 2.15 |
Enable | boolean | W | Enables/disables this role object instance. | false | 2.15 |
RoleID | unsignedInt | W | Unique Identifier of the role. Depending on the implementation this can be the unique identifier assigned by the underlying system. If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. |
- | 2.15 |
RoleName | string(:64) | W | Name of the current Role. MUST NOT be an empty string for an enabled entry. | <Empty> | 2.15 |
StaticRole | boolean | R | A static role is a fixed role that is always available in the system. When set to true, the role cannot be removed. | false | 2.15 |
Device.SmartCardReaders. | object | R | SmartCardReaders object that contains the SmartCardReader table. | - | 2.0 |
Device.SmartCardReaders.SmartCardReader.{i}. | object(0:) | R | This object describes the characteristics of the smart card reader. At most one entry in this table can exist with a given value for Name, or with a given value for Alias. |
- | 2.0 |
ResetTime | dateTime | R | The time at which this SmartCard Reader was reset. Reset can be caused by: * Status transition from Disabled to Enabled * **{{param: non-existent **{{template: non-existent}}****Reset}} set to true. * An internal reset of the SmartCard Reader (including a reboot of the device). Unknown Time value indicates that this SmartCard Reader has never been reset, which can only happen if it has never been enabled. | - | 2.0 |
DecryptionFailedCounter | unsignedInt | R | Counter incremented once each time decryption cannot be carried out. This counter relates to the smart card reader, not to the smart card itself, i.e. it is reset when the **{{param: non-existent **{{template: non-existent}}****Reset}} parameter is used and not when a Smart Card is inserted or removed. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
DecryptionFailedNoKeyCounter | unsignedInt | R | Counter incremented once each time the key is not available to decrypt it. This is a subset of the more general DecryptionFailedCounter within the same object and thus will always be less than that parameter. This counter relates to the smart card reader, not to the smart card itself, i.e. it is reset when the **{{param: non-existent **{{template: non-existent}}****Reset}} parameter is used and not when a Smart Card is inserted or removed. Value Change Notification requests for this parameter MAY be denied. |
- | 2.0 |
Device.UPnP. | object | R | This object contains all UPnP related objects and parameters including Device and Discovery related objects and parameters. | - | 2.0 |
Device.UPnP.Discovery. | object | R | UPnP [UPnP-DAv1] SSDP discovered root devices, embedded devices and embedded services. The CPE MAY, but need not, retain some or all of the information in this object across reboots. | - | 2.0 |
Device.UPnP.Discovery.RootDevice.{i}. | object(0:) | R | UPnP root device table. This table contains an entry for each UPnP root device that has been discovered via SSDP. At most one entry in this table can exist with a given value for UUID. |
- | 2.0 |
UUID | string(:36) | R | This UPnP root device’s UUID (Universally Unique IDentifier) [RFC4122], extracted from any of its USN (Unique Service Name) headers. This is a 36-byte string that uniquely identifies the device, the following is an example: 02c29d2a-dbfd-2d91-99c9-306d537e9856 Possible patterns:
|
- | 2.0 |
USN | string(:256) | R | The value of the USN (Unique Service Name) header for this UPnP root device. Three discovery messages are sent for root devices, and this SHOULD be the value of the USN header of the following form: uuid:device-UUID::urn:domain-name:device:deviceType:v SSDP is an unreliable protocol and it is possible that no discovery message containing the USN header of the above form was ever received. If so, one of the other two forms MAY be used: uuid:device-UUID::upnp:rootdevice uuid:device-UUID (for root device UUID) |
- | 2.0 |
Server | string(:256) | R | The value of the SERVER header for this UPnP root device, which is a string of the following form: OS/version UPnP/udaversion product/version where UPnP is a literal string, udaversion is the version of the UPnP Device Architecture. |
- | 2.0 |
Device.UPnP.Discovery.Device.{i}. | object(0:) | R | UPnP embedded device table. This table contains an entry for each UPnP embedded device that has been discovered via SSDP. At most one entry in this table can exist with a given value for UUID. |
- | 2.0 |
UUID | string(:36) | R | This UPnP embedded device’s UUID (Universally Unique IDentifier) [RFC4122], extracted from any of its USN (Unique Service Name) headers. This is a 36-byte string that uniquely identifies the device, the following is an example: 02c29d2a-dbfd-2d91-99c9-306d537e9856 Possible patterns:
|
- | 2.0 |
USN | string(:256) | R | The value of the USN (Unique Service Name) header for this UPnP embedded device. Two discovery messages are sent for embedded devices, and this SHOULD be the value of the USN header of the following form: uuid:device-UUID::urn:domain-name:device:deviceType:v SSDP is an unreliable protocol and it is possible that no discovery message containing the USN header of the above form was ever received. If so, the other form MAY be used: uuid:device-UUID |
- | 2.0 |
Server | string(:256) | R | The value of the SERVER header for this UPnP embedded device, which is a string of the following form: OS/version UPnP/udaversion product/version where UPnP is a literal string, udaversion is the version of the UPnP Device Architecture. |
- | 2.0 |
Device.UPnP.Discovery.Service.{i}. | object(0:) | R | UPnP embedded service table. This table contains an entry for each UPnP embedded service that has been discovered via SSDP. At most one entry in this table can exist with a given value for USN. |
- | 2.0 |
USN | string(:256) | R | The value of the USN (Unique Service Name) header for this UPnP embedded service. This is of the following form: uuid:device-UUID::urn:domain-name:service:serviceType:v |
- | 2.0 |
Server | string(:256) | R | The value of the SERVER header for this UPnP embedded service, which is a string of the following form: OS/version UPnP/udaversion product/version where UPnP is a literal string, udaversion is the version of the UPnP Device Architecture. |
- | 2.0 |
Device.Firewall. | object | R | Firewall configuration object. The Config parameter enables and disables the Firewall, and can select either a predefined configuration (High or Low) or an explicitly-defined Advanced configuration. For an Advanced configuration, AdvancedLevel controls the currently active Firewall Level, and the Firewall Levels are defined in the Level, Chain and Chain.{i}.Rule tables. The Firewall rules modeled by this object operate only on the forwarding path. This means that they affect only routed traffic, and do not affect traffic that is destined for or generated by the CPE. Note that any NAT processing on the ingress packet occurs before Firewall rules are applied so, for example, the Firewall rules will see the translated destination IP address and port in a downstream packet that has passed through the NAT. See [Appendix VIII/TR-181i2] for an example Advanced configuration. | - | 2.0 |
Config | string | W | How this firewall is configured. Enumeration of:
|
- | 2.0 |
Device.PeriodicStatistics. | object | R | This object configures collection of periodic statistics for the device. Periodic statistics are measured over a sample interval (which can be aligned with absolute time) and are made available to the Controller as a comma-separated list of the most recent |
- | 2.0 |
Device.PeriodicStatistics.SampleSet.{i}. | object(0:) | W | Periodic statistics sample set table. Each sample set has its own sample interval etc. At most one entry in this table can exist with a given value for Name, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. Changes in 2.15:
|
- | 2.0 |
Controller | string | R | The value MUST be the Path Name of the Device.LocalAgent.Controller. instance that created SampleSet. If the referenced object is deleted, this instance MUST also be deleted (so the parameter value will never be an empty string). The value of this parameter is automatically populated by the USP Agent upon SampleSet creation using the reference to the USP Controller that created the instance. The USP Controller referenced by this parameter defines the set of permissions to use when updating the Device.PeriodicStatistics.SampleSet.{i}.Parameter.{i}. table. Furthermore, only the USP Controller referenced by this parameter will have access to the Parameter.{i}.Values, Parameter.{i}.SampleSeconds, Parameter.{i}.SuspectData and Parameter.{i}.Failures parameters. |
- | 2.15 |
FetchSamples | unsignedInt | W | The number of sample intervals to be collected before transitioning Status from Enabled to Trigger to Enabled. If this SampleSet is enabled and FetchSamples is in the range [1:ReportSamples] then Status MUST transition from Enabled to Trigger to Enabled on completion of every FetchSamples sample intervals. Otherwise, the transition MUST NOT occur. For example, if ReportSamples is 25 and FetchSamples is 24, then the CPE will store 25 values for each monitored parameter and the above Status transition will occur as the CPE stores each 24th of 25 sample intervals, which means that the Controller could delay for up to two sample intervals before reading the stored values and would still not miss any samples (see also {{param: non-existent ForceSample}}Device.PeriodicStatistics.SampleSet.{i}.ForceSample()). To disable this trigger mechanism and still collect sampled statistics, FetchSamples can be set to either 0 or a value greater than ReportSamples. | 0 | 2.0 |
ReportEndTime | dateTime | R | The absolute time at which the sample interval for the last stored sample (for each statistic) ended. If {{param: non-existent ForceSample}}Device.PeriodicStatistics.SampleSet.{i}.ForceSample() has been used to force statistics for the current sample to be calculated and updated in the data model, then ReportEndTime MUST be updated to reflect the actual time over which stored data was collected. | <Empty> | 2.0 |
SampleSeconds | unsignedInt[] | R | Comma-separated list of unsigned integers. Each entry indicates the number of seconds during which data was collected during the sample interval. Individual SampleSeconds values can be less than SampleInterval, for several reasons, including: TimeReference has been set to a time other than the Unknown Time and the current sample interval started part of the way through a scheduled sample interval. {{param: non-existent ForceSample}}Device.PeriodicStatistics.SampleSet.{i}.ForceSample() has been used to force statistics for the current sample to be calculated and updated in the data model. Value Change Notification requests for this parameter MAY be denied. |
<Empty> | 2.0 |
Device.PeriodicStatistics.SampleSet.{i}.Parameter.{i}. | object(0:) | W | Periodic statistics parameter table for this sample set. This table contains entries for parameters whose values are to be sampled. Note that the comma-separated lists in this object (SampleSeconds, SuspectData and Values) only ever change (a) when first enabled, (b) when ForceSampleDevice.PeriodicStatistics.SampleSet.{i}.ForceSample() is set to true (a “sneak preview” of the current sample), or (c) at the end of the sample interval. At most one entry in this table can exist with a given value for Reference, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
SampleSeconds | unsignedInt[] | R | Comma-separated list of unsigned integers. Each entry indicates the number of seconds during which data was collected for this parameter during the sample interval. Individual SampleSeconds values can be less than PeriodicStatistics.SampleSet.{i}.SampleInterval, for several reasons, including: Any of the reasons for which PeriodicStatistics.SampleSet.{i}.SampleSeconds values might be less than PeriodicStatistics.SampleSet.{i}.SampleInterval. The parameter doesn’t exist, or was created or deleted during a sample interval. Value Change Notification requests for this parameter MAY be denied. |
<Empty> | 2.0 |
Values | string[] | R | Comma-separated list of strings. Each entry indicates the value of the referenced parameter, as determined by SampleMode, during the sample interval. The statistics values in this comma-separated listslist MUST be in time order, with the oldest one first and the most recent one last. If the SampleMode parameter is not present, or is inappropriate for the referenced parameter, the statistics values MUST be collected in Current mode. Value Change Notification requests for this parameter MAY be denied. |
<Empty> | 2.0 |
Device.FAP. | object | R | This object is the container for all Femto related component objects, to prevent pollution of the so-called global namespace of the BBF with FAP specific objects. | - | 2.4 |
Device.FAP.GPS. | object | R | This object contains the parameters relating to the GPS scan. | - | 2.4 |
LastSuccessfulScanTime | dateTime | R | Specifies the date and time, when the GPS scan last completed successfully. This value is retained across reboot and is only reset after another scan completes successfully or {{param: non-existent GPSReset}} is set to true. This value is retained across reboots and is only reset after another scan completes successfully or GPSReset() is invoked.The values for LockedLatitude, LockedLongitude and NumberOfSatellites correspond to this time. If a scan has never succeeded before, the value will be the Unknown Time value, as defined in [Section 3.2/TR-106]. Value Change Notification requests for this parameter MAY be denied. |
- | 2.4 |
LockedLatitude | int(-90000000:90000000) | R | This parameter specifies the latitude of the device’s position in degrees, multiplied by 1 million. The positive value signifies the direction, north of the equator. The negative value signifies the direction, south of the equator. Range is from: 90d00.00’ South (-90,000,000) to 90d00.00’ North (90,000,000). Example: A latitude of 13d19.43’ N would be represented as 13,323,833, derived as (131,000,000)+((19.431,000,000)/60). Latitude of 50d00.00’ S would be represented as value -50,000,000. This value is retained across reboots and is only reset after another scan completes successfully or {{param: non-existent GPSReset}} is set to true. This value is retained across reboots and is only reset after another scan completes successfully or GPSReset() is invoked.If a scan has never succeeded before, the value 0 is reported. Value Change Notification requests for this parameter MAY be denied. |
- | 2.4 |
LockedLongitude | int(-180000000:180000000) | R | This parameter specifies the longitude of the device’s position in degrees, multiplied by 1 million. The positive value signifies the direction, east of the prime meridian. The negative value signifies the direction, west of the prime meridian. Range is from: 180d00.00’ West (-180,000,000) to 180d00.00’ East (180,000,000). Example: A longitude of 13d19.43’ E would be represented as 13,323,833, derived as (131,000,000)+((19.431,000,000)/60). A longitude of 50d00.00’ W would be represented as value -50,000,000. This value is retained across reboots and is only reset after another scan completes successfully or {{param: non-existent GPSReset}} is set to true. This value is retained across reboots and is only reset after another scan completes successfully or GPSReset() is invoked.If a scan has never succeeded before, the value 0 is reported. Value Change Notification requests for this parameter MAY be denied. |
- | 2.4 |
NumberOfSatellites | unsignedInt | R | The number of satellites that were locked during the test execution. The greater the number of satellites the better the precision of the results. This value is retained across reboots and is only reset after another scan completes successfully or {{param: non-existent GPSReset}} is set to true. This value is retained across reboots and is only reset after another scan completes successfully or GPSReset() is invoked.If a scan has never succeeded before, the value 0 is reported. Value Change Notification requests for this parameter MAY be denied. |
- | 2.4 |
Device.FAP.ApplicationPlatform. | object | R | This object defines the data model for the following Femtozone APIs. * Femto Awareness * SMS * MMS * Terminal Location Femto Awareness, SMS, MMS, and Terminal Location APIs are defined in the Release 1 API Specifications of the Service SIG in the Femto Forum (non public document). [Appendix I/TR-262] provides the “Theory of Operation” for the usage of this object. | - | 2.4 |
Device.FAP.ApplicationPlatform.Capabilities. | object | R | This object contains parameters related to the capabilities of the Femtozone Application Platform and the Femtozone APIs. | - | 2.4 |
AuthenticationMethodsSupported | string[] | R | Comma-separated list of strings. Specifies the supported methods that 3rd Party Applications can use to authenticate with the Femto Application Platform at initialization. Comma separated list of strings. Each list item is an enumeration of:
|
- | 2.4 |
Device.BulkData. | object | R | This object provides bulk data collection capabilities and global collection settings that affect the entire device. Bulk Data utilizes various solutions (e.g., IPDR, HTTP) to collect data from devices and transfer the data to a collection server. The IPDR solution is based on a service specification described in [TR-232]. The HTTP solution is based on transfer mechanisms described in [Annex A/TR-369]. The USPEventNotif solution is based on sending a Profile.{i}.Push! Event Notification via USP [TR-369]. The Bulk Data Collection Profiles are measured over a reporting interval (which can be aligned with absolute time) and are made available to the collection server. | - | 2.5 |
Protocols | string[] | R | Comma-separated list of strings. Represents the IPDR and transport protocols that this device is capable of supporting. Each list item is an enumeration of:
IPDR Streaming Protocol [IPDR-SP] This enumeration was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
)
IPDR File Transfer Protocol [IPDR-FTP] This enumeration was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
)
Changes in 2.15:
|
- | 2.5 |
EncodingTypes | string[] | R | Comma-separated list of strings. Represents the Encoding Types for the protocols that this device is capable of supporting. Each list item is an enumeration of:
Used with the IPDR Streaming and File Protocols. [IPDR-XML] This enumeration was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
)
Used with the IPDR Streaming and File Protocols. [IPDR-XDR] This enumeration was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
) |
- | 2.5 |
Device.BulkData.Profile.{i}. | object(0:) | W | A set of Bulk Data Collection profiles. Each profile represents a bulk data report, including its own timing configuration, communications configuration, and set of parameters. This allows the Controller to configure multiple reports to be generated at different times for different sets of data. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. Changes in 2.15:
|
- | 2.5 |
Controller | string | R | The value MUST be the Path Name of the Device.LocalAgent.Controller. instance that created {{replaced: unexpected argument delete after: or last updated, [object()]}}. If the referenced object is deleted, the parameter value MUST be set to an empty string. The value of this parameter is automatically populated by the USP Agent upon Profile}} The value of this parameter is automatically populated by the USP Agent upon Profile creation using the reference to the USP Controller that created the instance. The value of this parameter is automatically updated by the USP Agent upon Profile alteration using the reference to the USP Controller that changed the instance. The USP Controller referenced by this parameter also defines the set of permissions to use when generating the Bulk Data report. Furthermore, only the USP Controller referenced by this parameter will receive a Push! Event (assuming it has an associated Subscription) when the Profile has Protocol configured to USPEventNotif, even if another USP Controller has an associated Subscription. |
- | 2.12 |
ReportingInterval | unsignedInt(1:) | W | The reporting interval in seconds. Each report is generated based on this interval and TimeReference. The CPE MAY reject a request to set ReportingInterval to less than MinReportingInterval. Reporting intervals MUST begin every ReportingInterval seconds. If ReportingInterval is changed while collection is enabled, the first reporting interval begins immediately. For example, if ReportingInterval is 86400 (a day) and if TimeReference is set to UTC midnight on some day (in the past, present, or future) then the CPE will generate (and transmit, if the Protocol parameter is set to {{enum: reference to deprecated enumeration Device.BulkData.Protocols.Streaming}})transmit) its report at midnight every 24 hours. | 86400 | 2.5 |
StreamingHost | string(:256) | W | This is the host name or IP Address of the IPDR Collector to be used by the CPE to stream bulk data records if this collection profile is configured for the IPDR Streaming Protocol [IPDR-SP] (the Protocol parameter has a value of Streaming).
This parameter was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
|
- | 2.5 |
StreamingPort | unsignedInt(0:65535) | W | This is the port number of the IPDR Collector to be used by the CPE to stream bulk data records if this collection profile is configured for the IPDR Streaming Protocol [IPDR-SP] (the Protocol parameter has a value of Streaming).
This parameter was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
|
4737 | 2.5 |
StreamingSessionID | unsignedInt(48:57,65:90) | W | This is the unique identification of an IPDR Session to be used when this collection profile is configured for the IPDR Streaming Protocol [IPDR-SP] (the Protocol parameter has a value of Streaming). A Controller MUST NOT configure multiple IPDR Streaming Protocol collection profiles with the same StreamingSessionID. Doing so MUST cause the CPE to fail the SetParameterValues. Within the IPDR Streaming Protocol specification the Session ID has a type of a single ‘char’, but we are restricting the range even further (ASCII values of ‘0’ - ‘9’ and ‘A’ - ‘Z’.}}‘Z’).
This parameter was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
|
- | 2.5 |
FileTransferURL | string(:2048) | W | This is the [URL] within the CPE that is used by an IPDR Collector to retrieve the IPDRDocs when this collection profile is configured for the IPDR File Transfer Protocol [IPDR-FTP] (the Protocol parameter has a value of File).
This parameter was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
|
- | 2.5 |
FileTransferUsername | string(:64) | W | Username used for authentication of the FileTransferURL. This is the FileTransferUsername that the IPDR Collector uses to access the CPE when this collection profile is configured for the IPDR File Transfer Protocol [IPDR-FTP] (the Protocol parameter has a value of File).
This parameter was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
|
- | 2.5 |
FileTransferPassword | string(:64) | W | Password used for authentication of the FileTransferURL. This is the FileTransferPassword that the IPDR Collector uses to access the CPE when this collection profile is configured for the IPDR File Transfer Protocol [IPDR-FTP] (the Protocol parameter has a value of File).
This parameter was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. When read, this parameter returns an empty string, regardless of the actual value.
Changes in 2.15:
|
- | 2.5 |
ControlFileFormat | string(:128) | W | If this collection profile is configured for the IPDR File Transfer Protocol [IPDR-FTP] (the Protocol parameter has a value of File) then the control file names will be of the following format:
This parameter was DEPRECATED in 2.15 because IPDR Bulk Data Collection is not supported in USP. Changes in 2.15:
|
- | 2.5 |
ForceCollection() | command | - | Start the bulk data collection and transmission as defined in this profile immediately, regardless of the current values of the Enable and ReportingInterval parameters. This command can be used for testing of the bulk data collection mechanism and profile but also to preempt any regular schedule without affecting it. |
- | 2.15 |
Device.BulkData.Profile.{i}.Parameter.{i}. | object(0:) | W | Bulk data parameter table. Each entry in this table represents a parameter (or set of parameters if a partial path is provided) to be collected and reported. | - | 2.5 |
Reference | string(:256) | W | Represents the parameter(s) that are part of this Bulk Data collection profile. The value MUST be a path name of a parameter or an object. When the ParameterWildCardSupported parameter has a value of true, patterns for instance identifiers are permitted with wildcards (an “*” character) in place of instance identifiers; any attempt to set the value otherwise MUST be rejected by the CPE. In the case where a partial parameter pathan Object Path is specified, the sub-objects of the resolved pattern and contained parameters will be part of the bulk data collected and reported. If the path name refers to an object then it MUST end with a ‘.’.
Changes in 2.15:
|
<Empty> | 2.5 |
Device.BulkData.Profile.{i}.CSVEncoding. | object | R | This object defines the properties to be used when the Profile object’s EncodingType parameter value is CSV. | - | 2.10 |
RowSeparator | string | W | Row separator to use when encoding CSV data.
Changes in 2.15:
|
<Empty> | 2.10 |
Device.BulkData.Profile.{i}.MQTT. | object | R | This object defines the properties to be used when transporting bulk data using the MQTT protocol. This object is used when the Protocol parameter has a value of MQTT. | - | 2.15 |
Reference | string | W | The value MUST be the Path Name of a row in the MQTT.Client. table. A reference to the MQTT Client used by this Bulk Data Collection Profile when communicating via the MQTT Protocol. | <Empty> | 2.15 |
PublishTopic | string(:65535) | W | The topic name the Agent MUST use when sending the Bulk Data report. | - | 2.15 |
PublishQoS | unsignedInt(0:2) | W | The Agent MUST use this QoS value when sending the Bulk Data report. If the referenced MQTT Client uses MQTT 5.0 and the MQTT server only indicates support for a QoS value in the CONNACK Maximum QoS property lower than this QoS value, the Agent MUST use the highest QoS value that is supported by the server. |
- | 2.15 |
PublishRetain | boolean | W | If set to true the Agent MUST set the RETAIN flag in MQTT PUBLISH messages carrying the Bulk Data report to 1, unless the MQTT server sent Retain Available = 0 (MQTT 5.0) in its CONNACK (in which case, the Agent MUST set the RETAIN flag to 0). | false | 2.15 |
Device.IEEE1905. | object | R | This object represents the management functions for the 1905 capabilities as defined in [IEEE1905.1a]. | - | 2.9 |
Device.IEEE1905.AL. | object | R | This object represents the management functions for the 1905 Abstraction Layer as defined in [Section 4.4 Abstraction Layer/IEEE1905.1a]. | - | 2.9 |
Device.IEEE1905.AL.NetworkTopology. | object | R | This object represents the 1905 Network Topology capabilities of this device. | - | 2.9 |
Device.IEEE1905.AL.NetworkTopology.IEEE1905Device.{i}. | object(0:) | R | This object represents an instance of discovered 1905 Devices in the network (received Topology discovery message as defined in [Clause 6.3.1/IEEE1905.1a]). At most one entry in this table can exist with a given value for IEEE1905Id. |
- | 2.9 |
AssocWiFiNetworkDeviceRef | string | R | The value MUST be the Path Name of a row in the WiFi.MultiAP.APDevice. or WiFi.DataElements.Network.Device. tables. If the referenced object is deleted, the parameter value MUST be set to an empty string.AssocWiFiNetworkDeviceRef is a reference to thea MultiAP.Device or Wi-Fi Network “APDevice”.Data Elements Device. Since IEEE 1905.1 is the protocol used by the Wi-Fi Alliance’s EasyMesh specification for communications, this parameter allows the IEEE 1905.1 portion of the data model to reference the associated EasyMesh portion of the data model. | - | 2.13 |
Device.MQTT. | object | R | MQTT Base object describing all MQTT related parameters and objects. | - | 2.10 |
Device.MQTT.Capabilities. | object | R | Indicates the MQTT capabilities of the device. | - | 2.10 |
ProtocolVersionsSupported | string[] | R | Comma-separated list of strings. Indicates the supported protocol versions. Each list item is an enumeration of: |
- | 2.10 |
TransportProtocolSupported | string[] | R | Comma-separated list of strings. Indicates the supported transport protocols. Each list item is an enumeration of:
Unencrypted MQTT connection Changes in 2.15:
)
TLS encrypted MQTT connection Changes in 2.15:
)
Unencrypted MQTT connection over a WebSocket transport Changes in 2.15:
)
Changes in 2.15:
|
- | 2.10 |
Device.MQTT.Client.{i}. | object(0:) | W | MQTT client table. Contains a list of configured MQTT clients. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Name such that the new entry does not conflict with any existing entries. |
- | 2.10 |
Enable | boolean | W | Allows to enable or disable the MQTT client. If a MQTT client gets enabled then the MQTT client has first to establish a MQTT broker session and then subscribe for all enabled topics in the Subscription. table. If the ProtocolVersion is set to 3.1 or 3.1.1 and CleanSession is set to false a subscription MUST only be sent for topics which haven’t been subscribed before (see {{bibref: non-existent MQTT311}}). If the ProtocolVersion is set to 5.0 and CleanStart is set to false a subscription MUST only be sent for topics which haven’t been subscribed before (see [Section 3.1.2.4/MQTT50]). If a connected MQTT client gets disabled (Status is either Connecting or Connected) then the MQTT client has to send a MQTT DISCONNECT packet to disconnect from the MQTT broker ((see {{bibref: non-existent MQTT311}},[Section 3.14/MQTT31]) or [Section 3.14/MQTT50]), before setting the Status to Disabled. | - | 2.10 |
EnableEncryption | boolean | W | When true, encryption MUST be used for this MQTT Client instance.
This parameter was DEPRECATED in 2.15 because it duplicates the functionality already handled by the TransportProtocol parameter. Changes in 2.15:
|
true | 2.14 |
CleanSession | boolean | W | The value of the MQTT clean session flag in the MQTT CONNECT packet (see {{bibref: non-existent MQTT311}} and {{bibref: non-existent MQTT311}}). If this flag is set to true (default), the MQTT broker will delete all subscription information after a Disconnect. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If the change needs to be applied immediately, the command ForceReconnect() has to be executed. This parameter only applies if ProtocolVersion is set to 3.1 or 3.1.1. | true | 2.10 |
WillEnable | boolean | W | Enables or disables the will handling (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.2.5/MQTT50]). If the connection gets enabled and this parameter is set to true and either the parameter WillTopic or WillValue are an empty string, the CPE MUST set the Status to Error_Misconfigured. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If the change needs to be applied immediately, the command ForceReconnect() has to be executed.. | - | 2.10 |
WillQoS | unsignedInt(0:2) | W | The MQTT QoS level assigned with the will message (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.2.6/MQTT50]). This parameter is only used if WillEnable is set to true. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If will handling is enabled (Parameter WillEnable is set to true) and the change needs to be applied immediately, the command ForceReconnect() has to be executed. |
- | 2.10 |
WillRetain | boolean | W | Indicate to the MQTT broker to retain the Will over a Disconnect (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.2.7/MQTT50]). This parameter is only used if WillEnable is set to true. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If will handling is enabled (Parameter WillEnable is set to true) and the change needs to be applied immediately, the command ForceReconnect() has to be executed. |
- | 2.10 |
KeepAliveTime | unsignedInt(:65535) | W | Keep Alive Time in seconds defines the maximum wait time after which a packet has to be sent to the MQTT broker (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.2.10/MQTT50]). If no regular packet can be sent a MQTT PINGREQ packet is sent. A value of zero (0) means no keep alive packets are sent and the MQTT client is not disconnected by the server. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If the change needs to be applied immediately, the command ForceReconnect() has to be executed. | 60 | 2.10 |
ClientID | string(0:65535) | W | The MQTT client identifier used in the MQTT CONNECT packet (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.3.1/MQTT50]). If ProtocolVersion is set to 3.1 or 3.1.1, this parameter MUST NOT be an empty string. If ProtocolVersion is set to 5.0, an empty string is allowed. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If the change needs to be applied immediately, the command ForceReconnect() has to be executed. | - | 2.10 |
WillTopic | string(:65535) | W | The Topic sent in the Will Message (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.3.3/MQTT50]). This parameter is only used if WillEnable is set to true. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If will handling is enabled (Parameter WillEnable is set to true) and the change needs to be applied immediately, the command ForceReconnect() has to be executed. |
- | 2.10 |
WillValue | string(:65535) | W | The value sent in the Will Message (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.3.4/MQTT50]). This parameter is only used if WillEnable is set to true. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If will handling is enabled (Parameter WillEnable is set to true) and the change needs to be applied immediately, the command ForceReconnect() has to be executed. |
- | 2.10 |
Username | string(:256) | W | {{div: unexpected argument [removed(section 3.1}} recommends that the user name has 12 characters or fewer, but this is not required. ), ’If this parameter is ‘, empty(), ’ no authentication parameters are sent in the MQTT CONNECT packet.’] after: [classes()], [’Username used to authenticate the MQTT client when making a connection to the MQTT broker. The value is sent in the MQTT CONNECT packet (see ’, bibref([replaced(MQTT31, MQTT311)], section 3.1), ’, ’, bibref([replaced(MQTT31, MQTT311)], section 3.1.3.4), ’ or ’, bibref(MQTT50, section 3.1.3.5), ‘).’, replaced( For MQTT 3.1 {{bibref|MQTT31, []), div([classes()])]}} | - | 2.10 |
Password | string(:256) | W | Password used to authenticate the MQTT client when making a connection to the MQTT broker. The value is sent in the MQTT CONNECT packet (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}} or [Section 3.1.3.6/MQTT50]). This password is only sent in the MQTT CONNECT packet if Username is not an empty string. When read, this parameter returns an empty string, regardless of the actual value. |
- | 2.10 |
MessageRetryTime | unsignedInt(1:) | W | Message retry time in seconds defines the wait time before a MQTT message that expects a response (QoS value of message is > 0, or PUBLISH, PUBREL, SUBSCRIBE, UNSUBSCRIBE message) is resent, because the response is not received (see {{bibref: non-existent MQTT311}}). This parameter only applies if ProtocolVersion is set to 3.1. | 5 | 2.10 |
Device.MQTT.Client.{i}.Subscription.{i}. | object(0:) | W | List of MQTT subscriptions handled by the MQTT client. The MQTT client MUST subscribe with the MQTT broker for all subscription instances, whose parameter Enable is set to true, when it establishes a new connection to the MQTT broker. Disabled subscription instances with Enable set to false will be ignored during connection establishment. At most one entry in this table can exist with a given value for Alias, or with a given value for Topic. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Topic such that the new entry does not conflict with any existing entries. |
- | 2.10 |
Status | string | R | Indicates the status of this subscription. Enumeration of:
|
- | 2.10 |
Topic | string(:65535) | W | Name of the subscribed topic. Topic names may contain wildcards according to the rules specified in {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}} or [Section 4.7/MQTT50]. If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that doesn’t conflict with any existing entries. |
- | 2.10 |
QoS | unsignedInt(0:2) | W | The MQTT QoS level assigned with the subscription (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 4.3/MQTT50]. | - | 2.10 |
Device.MQTT.Broker.{i}. | object(0:) | W | MQTT broker table. Contains a list of configured MQTT brokers. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Name such that the new entry does not conflict with any existing entries. |
- | 2.10 |
Device.MQTT.Broker.{i}.Bridge.{i}. | object(0:) | W | Configures MQTT bridges, which are used to communicate with other MQTT brokers. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Name such that the new entry does not conflict with any existing entries. |
- | 2.10 |
Status | string | R | Indicates the status of this MQTT Bridge. Enumeration of:
This enumeration was DELETED in 2.11 because it’s covered by Connecting and Connected. Changes in 2.15:
)
|
- | 2.10 |
CleanSession | boolean | W | The value of the MQTT clean session flag in the MQTT CONNECT packet (see {{bibref: non-existent MQTT311}} and {{bibref: non-existent MQTT311}}) to establish a MQTT bridge connection. If this flag is set to true (default), the remote MQTT broker will delete all subscription information after a Disconnect. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If the change needs to be applied immediately, the command ForceReconnect() has to be executed. This parameter only applies if ProtocolVersion is set to 3.1 or 3.1.1. | true | 2.10 |
KeepAliveTime | unsignedInt(:65535) | W | Keep Alive Time in seconds defines the maximum wait time after which a packet has to be sent to the remote MQTT broker (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.2.10/MQTT50]). If no regular packet can be sent a MQTT PINGREQ packet is sent. A value of zero (0) means no keep alive packets are sent and the bridge is not disconnected by the server. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If the change needs to be applied immediately, the command ForceReconnect() has to be executed. | 60 | 2.10 |
ClientID | string(0:65535) | W | The MQTT client identifier used in the CONNECT packet (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 3.1.3.1/MQTT50]). If ProtocolVersion is set to 3.1 or 3.1.1, this parameter MUST NOT be an empty string. If ProtocolVersion is set to 5.0, an empty string is allowed. A change of this parameter is only communicated to the MQTT server with the next MQTT CONNECT packet. If the change needs to be applied immediately, the command ForceReconnect() has to be executed. | - | 2.10 |
Username | string(:256) | W | {{div: unexpected argument [removed(section 3.1}} recommends that the user name has 12 characters or fewer, but this is not required. ), ’If this parameter is ‘, empty(), ’ no authentication parameters are sent in the MQTT CONNECT packet.’] after: [classes()], [’User name used to authenticate the MQTT broker when making a connection over the MQTT bridge. The value is sent in the MQTT CONNECT packet (see ’, bibref([replaced(MQTT31, MQTT311)], section 3.1), ’, ’, bibref([replaced(MQTT31, MQTT311)], section 3.1.3.4), ’ or ’, bibref(MQTT50, section 3.1.3.5), ‘).’, replaced( For MQTT 3.1 {{bibref|MQTT31, []), div([classes()])]}} | - | 2.10 |
Password | string(:256) | W | Password used to authenticate the MQTT broker when making a connection over the MQTT bridge. The value is sent in the MQTT CONNECT packet (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}} or [Section 3.1.3.6/MQTT50]). This password is only sent in the MQTT CONNECT packet if Username is not an empty string. When read, this parameter returns an empty string, regardless of the actual value. |
- | 2.10 |
MessageRetryTime | unsignedInt(1:) | W | Message retry time in seconds defines the wait time before a MQTT message that expects a response (QoS value of message is > 0, or PUBLISH, PUBREL, SUBSCRIBE, UNSUBSCRIBE message) is resent, because the response is not received (see {{bibref: non-existent MQTT311}}. This parameter only applies if ProtocolVersion is set to 3.1. | 5 | 2.10 |
Device.MQTT.Broker.{i}.Bridge.{i}.Subscription.{i}. | object(0:) | W | List of MQTT subscriptions handled over the bridge. At most one entry in this table can exist with a given value for Alias, or with the same values for both Topic and Direction. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias, Topic and Direction such that the new entry does not conflict with any existing entries. |
- | 2.10 |
Topic | string(:65535) | W | Name of the subscribed topic. Topic names may contain wildcards according to the rules specified in {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}} or [Section 4.7/MQTT50]. If the value isn’t assigned by the Controller on creation, the Agent MUST choose an initial value that (together with Direction) doesn’t conflict with any existing entries. |
- | 2.10 |
QoS | unsignedInt(0:2) | W | The MQTT QoS level assigned with the subscription (see {{bibref: non-existent MQTT311}}, {{bibref: non-existent MQTT311}}) or [Section 4.3/MQTT50]. | - | 2.10 |
LocalPrefix | string(:256) | W | The local prefix is used for remapping received topics to the local topics of the MQTT broker and to select the topics to be sent over bridge to the remote MQTT broker. * In incoming direction (Direction is either in or both): For remote topics received over the bridge the MQTT broker adds the LocalPrefix in front of the received topic, before processing it.
Topic is “/bus/+”, LocalPrefix is “/local”, Direction is “in” MQTT broker receives message with topic “/bus/tr181” over bridge => MQTT broker uses topic “/local/bus/tr181” for internal processing * In outgoing direction (Direction is either out or both): For selection of the topics to be sent over the bridge the MQTT broker uses the combination of LocalPrefix and Topic to match the topics to be sent over bridge, and removes the LocalPrefix from the selected topic before sending it over the bridge.
Topic is “/bus/+”, LocalPrefix is “/local”, Direction is “out” MQTT broker receives message with topic “/local/bus/tr181” from a MQTT client => MQTT broker sends topic “/bus/tr181” to remote MQTT broker |
- | 2.10 |
RemotePrefix | string(:256) | W | The remote prefix is used for remapping topics to the remote MQTT broker topic lists. * In incoming direction (Direction is either in or both): For remote topics received over the bridge the MQTT broker removes the remote prefix topic from the received topic (before handling the LocalPrefix), before processing it.
Topic is “/bus/+”, LocalPrefix is “/local”, RemotePrefix is “/remote”, Direction is “in” MQTT broker receives message with topic “/remote/bus/tr181” over bridge => MQTT broker uses topic “/local/bus/tr181” for internal processing During activation of the bridge, the MQTT broker prepends the Topic with RemotePrefix topic and subscribes to the remote MQTT broker with it, in order to receive all applicable remote topics.
Topic is “/bus/+”, RemotePrefix is “/remote”, Direction is “in” MQTT broker sends a subscription to the remote MQTT broker with the topic “/remote/bus/+”. * In outgoing direction (Direction is either out or both): For all topics to be sent over the bridge (Direction is either out or both), the RemotePrefix will be prepended to the topic after the LocalPrefix has been processed and before sending the message over the bridge.
Topic is “/bus/+”, LocalPrefix is “/local”, RemotePrefix is “/remote” Direction is “out” MQTT broker receives message with topic “/local/bus/tr181” from a MQTT client => MQTT broker sends topic “/remote/bus/tr181” to remote MQTT broker |
- | 2.10 |
Device.LMAP. | object | R | This object represents the objects necessary to manage and control the functionality for Large-Scale Measurement of Broadband Performance[RFC7594] as defined in by [LMAPIFM]. | - | 2.12 |
Device.LMAP.MeasurementAgent.{i}. | object(0:) | W | This object represents the measurement agent that performs measurement tasks and reporting functions defined in [RFC7594]. At most one entry in this table can exist with a given value for Alias, or with a given value for Identifier. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Alias and Identifier such that the new entry does not conflict with any existing entries. |
- | 2.12 |
Device.LMAP.MeasurementAgent.{i}.TaskCapability.{i}. | object(0:) | R | This object represents a capabilities, in the context of a task, that are supported by the measurement agent. Types of capabilities include: Report tasks, Configuration Tasks and Instruction Tasks. At most one entry in this table can exist with a given value for Name. |
- | 2.12 |
TaskCapabilityRegistryNumberOfEntries | unsignedInt | R | {{numentries: not associated with a table}}
Changes in 2.15:
|
- | 2.12 |
Device.LMAP.Report.{i}. | object(0:) | R | This Report object instance represents a report that is generated by a reporting task where the reporting task is defined as a MeasurementAgent.{i}.Task.{i} and executed as a scheduled action (MeasurementAgent.{i}.Schedule.{i}.Action.{i}). The Report replicates the MeasurementAgent.{i} object instance’s data at the time of the action exection. When a BulkData.Profile.{i} object instance is used to communicate a Report instance, the CPE adds a BulkData.Profile.{i}.Parameter.{i} object instance referring to this Report object instance. | - | 2.12 |
Device.LMAP.Report.{i}.Result.{i}. | object(0:) | R | The Result object provides the meta-data of the result report of a single executed action that produced the result. At most one entry in this table can exist with the same values for all of ScheduleName, ActionName and StartTime. |
- | 2.12 |
CycleNumber | string | R | The cycle number derived from the EventTime. The cycle number is the time, in UTC, closest to the EventTime that is a multiple of the cycle interval of the event that triggered the execution of the schedule. The value is valid if the event that triggered the execution of the schedule has a defined cycle interval. An an empty string value representrepresents an invalid CycleNumber. Possible patterns:
|
- | 2.12 |
ResultConflictNumberOfEntries | unsignedInt | R | {{numentries: not associated with a table}}
Changes in 2.15:
|
- | 2.12 |
ResultReportTableNumberOfEntries | unsignedInt | R | The number of entries in the ReportTable table.
Changes in 2.15:
|
- | 2.12 |
Device.LMAP.Report.{i}.Result.{i}.ReportTable.{i}. | object(0:) | R | This ReportTable object instances represents a row of results. | - | 2.12 |
ResultReportRowNumberOfEntries | unsignedInt | R | {{numentries: not associated with a table}}
Changes in 2.15:
|
- | 2.12 |
Device.PDU. | object | R | The logical connection between the 5G-RG and data network is the Protocol Data Unit (PDU). The Device.PDU subtree describes each PDU sessions properties together with the QoS rules specific to that PDU session. | - | 2.14 |
Device.PDU.Session.{i}. | object(0:) | R | Contains all the properties of a PDU session instance, ranging from maximum bitrate through to assigned network slice. This object contains the Session table. At most one entry in this table can exist with a given value for Alias, or with a given value for SessionID. |
- | 2.14 |
PDUIPv6InterfaceIdentifier | string | R | The interface identifier for the IPv6 link local address allocated to
the PDU session by the SMF. This parameter is only valid if
SessionType has a value of IPv6 or
IPv4v6. See [Clause
9.11.4.10/3GPP-TS.24.501].
Changes in 2.15:
|
- | 2.14 |
Device.PDU.Session.{i}.QoSFlow.{i}. | object(0:) | R | Table of all QoS Flow Indicators (QFI) and their properties supported by the access network for this particular PDU. For example: * A QoS Flow with a QFI of 1 used for general traffic has the following parameters. * FiveQI=8 * A QoS Flow with a QFI of 32 used for voice traffic with a guaranteed bitrate of 150k has the following parameters. * FiveQI=1 * GFBRUplink=150 * GFBRDownlink=150 At most one entry in this table can exist with a given value for Alias, or with a given value for QFI. |
- | 2.14 |
EPSBearer | unsignedInt | R | EPS Bearer Identity. See [Clause 9.3.2/3GPP-TS.24.301].
Changes in 2.15:
|
- | 2.14 |
Device.LocalAgent. | object | R | This object contains general information about the USP Agent itself. For information related to the Device that hosts the Agent, please reference the DeviceInfo object. NOTE: The Vendor Log File table (DeviceInfo.VendorLogFile) details are located on the DeviceInfo object. | - | 2.12 |
SupportedProtocols | string[1:] | R | Comma-separated list (at least 1 item) of strings. USP Message Transfer Protocols supported by this USP Agent. The USP Agent MUST support at least one Protocol. Each list item is an enumeration of:
See [RFC7252]. This enumeration was DEPRECATED in 2.15 because the CoAP MTP was deprecated in USP 1.2. Changes in 2.15:
) |
- | 2.12 |
Device.LocalAgent.MTP.{i}. | object(0:) | W | Each instance of this table represents a MTP used by the local Agent. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Protocol | string | W | The value MUST be a member of the list reported by the SupportedProtocols parameter. The Message Transport Protocol (MTP) to be used for communications by a USP Endpoint. This parameter discriminates between the CoAP, STOMP, WebSocket, MQTT union objects. Changes in 2.15:
|
WebSocket | 2.0 |
Device.LocalAgent.MTP.{i}.CoAP. | object(0:1) | R | If the USP Endpoint uses the CoAP Message Transport Protocol (MTP), then this object contains CoAP specific configuration parameters.
This object was DEPRECATED in 2.15 because the CoAP MTP was deprecated in USP 1.2. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time.
Changes in 2.15:
|
- | 2.0 |
Device.LocalAgent.MTP.{i}.STOMP. | object(0:1) | R | If the USP Endpoint uses the STOMP Message Transport Protocol (MTP), then this object contains STOMP Client specific configuration parameters related to how the Agent communicates with the STOMP Server. This object MUST be present if, and only if, Protocol is STOMP. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.0 |
Device.LocalAgent.MTP.{i}.WebSocket. | object(0:1) | R | If the USP Endpoint uses the WebSocket Message Transport Protocol (MTP) as a WebSocket server, then this object contains WebSocket specific configuration parameters. This object MUST be present if, and only if, Protocol is WebSocket. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.0 |
Path | string | W | The service path that is usedprovided by the WebSocket Server in order to receiveexchange USP messages. The value MUST be used as defined in [Section 3.3/RFC3986]. | - | 2.0 |
KeepAliveInterval | unsignedInt(1:) | W | The duration in seconds between when WebSocket ping control frames are transmitted by the Agent’s WebSocket server to the Controller’s WebSocket client. | - | 2.15 |
Device.LocalAgent.MTP.{i}.MQTT. | object(0:1) | R | If the USP Endpoint uses the MQTT Message Transport Protocol (MTP), then this object contains MQTT Client specific configuration parameters related to how the Agent communicates with the MQTT broker. This object MUST be present if, and only if, Protocol is MQTT. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.13 |
Device.LocalAgent.Threshold.{i}. | object(0:) | W | Each Threshold instance of this table represents a Threshold Event. ThresholdParam is monitored to determine if it has met the ThresholdOperator condition against ThresholdValue, when it meets the condition a Triggered! Event is sent. ThresholdParam may only reference integer parameters and ThresholdValue only usese integer values. For example: ReferencePath: Device.Ethernet.Interface.[Enable==“1”].Stats. ThresholdParam: BytesSent ThresholdOperator: Rise ThresholdValue: 100000 This would trigger a Triggered! Event whenever a value of a parameter matching Device.Ethernet.Interface.[Enable==1].Stats.BytesSent rises from below to above 100000. When creating a Threshold, if the ReferencePath, ThresholdParam or ThresholdValue are invalid (not in the supported Data Model), the object will not be created. If the concatenation of ReferencePath and ThresholdParam reference a parameter that isn’t in the instantiated data model, then there will be no Triggered! Event. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. Changes in 2.15:
|
- | 2.13 |
Controller | string | R | The value MUST be the Path Name of the Device.LocalAgent.Controller. instance that created Threshold. If the referenced object is deleted, this instance MUST also be deleted (so the parameter value will never be an empty string). The value of this parameter is automatically populated by the USP Agent upon Threshold creation using the reference to the USP Controller that created the instance. The USP Controller referenced by this parameter also defines the set of permissions to use when evaluating the threshold. Furthermore, only the USP Controller referenced by this parameter will receive a Triggered! Event (assuming it has an associated Subscription), even if another USP Controller has an associated Subscription. |
- | 2.15 |
Device.LocalAgent.Controller.{i}. | object(0:) | W | Each instance of this table represents a USP Controller that has access to this USP Agent. On the deletion of an entry from this table, the Agent MUST send the ObjectDeletion notification to all subscribed recipients, even if the recipient is the deleted Controller itself. This notification is the last notification sent to this Controller. At most one entry in this table can exist with a given value for EndpointID, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.12 |
AssignedRole | string[] | W | Each list item MUST be the Path Name of a row in the ControllerTrust.Role. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Comma-separated list of strings, each entry is a Role that has been assigned to this Controller instance by means other than the {{param: non-existent #.ControllerTrust.Credential.{i}.Role}} parameter. | - | 2.12 |
InheritedRole | string[] | R | Each list item MUST be the Path Name of a row in the ControllerTrust.Role. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Comma-separated list of strings, each entry is a Role that has been assigned to this Controller instance from the {{param: non-existent #.ControllerTrust.Credential.{i}.Role}} parameter associated with the CA credential ({{param: non-existent #.ControllerTrust.Credential.{i}.Credential}}) used to validate the Controller certificate. | - | 2.12 |
PeriodicNotifInterval | unsignedInt(1:) | W | If a Periodic Event Notification SubscriptionSubscription instance is associated with this USP Controller, then this is the duration in seconds of the interval for which the USP Agent MUST attempt to issue a Periodic Notification to the USP Controller. | - | 2.12 |
PeriodicNotifTime | dateTime | W | If a Periodic Event Notification SubscriptionSubscription instance is associated with this USP Controller, then this is an absolute time reference in UTC to determine when the USP Agent will issue a Periodic Notification. Each Periodic Notification MUST occur at this reference time plus or minus an integer multiple of the PeriodicNotifInterval. PeriodicNotifTime is used only to set the phase of the Periodic Event Notifications. The actual value of PeriodicNotifTime can be arbitrarily far into the past or future. For example, if PeriodicNotifInterval is 86400 (a day) and if PeriodicNotifTime is set to UTC midnight on some day (in the past, present, or future) then Periodic Notifications will be sent every day at UTC midnight. These MUST begin on the very next midnight, even if PeriodicNotifTime refers to a day in the future. The Unknown Time value defined in [Section 3.2/TR-106] indicates that no particular time reference is specified. That is, the USP Agent MAY locally choose the time reference, and needs only to adhere to the specified PeriodicNotifInterval. If absolute time is not available to the USP Agent, its Periodic Notification behavior MUST be the same as if the PeriodicNotifTime parameter was set to the Unknown Time value. | - | 2.12 |
ScheduleTimer() | command | - | Schedule a Timer! event on the associated Controller. This command is DEPRECATED
This command was DEPRECATED in 2.14.because it was replaced by a more flexible asynchronous **{{command: non-existent *ScheduleTimer()*Device.ScheduleTimer()}}** in 2.14. |
- | 2.12 |
Timer! | event | - | Timer event requested via a ScheduleTimer() command invoked on the same Controller instance via an Operate USP message. This event is DEPRECATED This event was DEPRECATED in 2.14.because the associated **{{command: non-existent **{{command: empty ref only valid in command descriptions}}****ScheduleTimer()}} was replaced by a more flexible asynchronous **{{command: non-existent **{{command: empty ref only valid in command descriptions}}****Device.ScheduleTimer()}} in 2.14. |
- | 2.12 |
Device.LocalAgent.Controller.{i}.MTP.{i}. | object(0:) | W | Each instance of this table represents a MTP used by this Controller. At most one entry in this table can exist with a given value for Protocol, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. Changes in 2.15:
|
- | 2.0 |
Protocol | string | W | The value MUST be a member of the list reported by the SupportedProtocols parameter. The Message Transport Protocol (MTP) to be used for communications by a USP Endpoint. This parameter discriminates between the CoAP, STOMP, WebSocket, MQTT union objects. Changes in 2.15:
|
WebSocket | 2.0 |
Order | unsignedInt(1:) | W | The order (relative priority) to use when determining which MTP to use for communicating to the Controller. A value of 1 indicates the highest precedence. For each configured MTP, the instance with the lowest value is attempted first. When more than one MTP instance has the same value, then each instance with the same value SHOULD be attempted at the same time. The value of Order on creation of a MTP table entry MUST be one greater than the largest current value (initially assigned the lowest precedence). |
- | 2.15 |
Device.LocalAgent.Controller.{i}.MTP.{i}.CoAP. | object(0:1) | R | If the USP Endpoint uses the CoAP Message Transport Protocol (MTP), then this object contains CoAP specific configuration parameters.
This object was DEPRECATED in 2.15 because the CoAP MTP was deprecated in USP 1.2. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time.
Changes in 2.15:
|
- | 2.0 |
Device.LocalAgent.Controller.{i}.MTP.{i}.STOMP. | object(0:1) | R | If the USP Endpoint uses the STOMP Message Transport Protocol (MTP), then this object contains STOMP Client specific configuration parameters related to how this Controller communicates with the STOMP Server. This object MUST be present if, and only if, Protocol is STOMP. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.0 |
Device.LocalAgent.Controller.{i}.MTP.{i}.WebSocket. | object(0:1) | R | If the USP Endpoint uses the WebSocket Message Transport Protocol (MTP) as a WebSocket client, then this object contains WebSocket specific configuration parameters. This object MUST be present if, and only if, Protocol is WebSocket. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.0 |
Path | string | W | The service path that is usedprovided by the Controller’s WebSocket server in order to receiveexchange USP messages. The value MUST be used as defined in [Section 3.3/RFC3986]. | - | 2.0 |
IsEncrypted | boolean | R | This parameter represents whether or not communications that utilize this WebSocket object instance are encrypted. This parameter is DEPRECATED,
This parameter was DEPRECATED in 2.14.because the **{{param: non-existent IsEncryptedEnableEncryption}}** parameter will dictate whether this WebSocket is or is not encrypted.encrypted |
- | 2.0 |
KeepAliveInterval | unsignedInt(1:) | W | The the duration in seconds between when WebSocket ping control frames are transmitted by the AgentAgent’s WebSocket client to the Controller’s WebSocket server for the USP Controller.server. | - | 2.0 |
Device.LocalAgent.Controller.{i}.MTP.{i}.MQTT. | object(0:1) | R | If the USP Endpoint uses the MQTT Message Transport Protocol (MTP), then this object contains MQTT Client specific configuration parameters related to how this Controller communicates with the MQTT broker. This object MUST be present if, and only if, Protocol is MQTT. This object is a member of a union, i.e., it is a member of a group of objects of which only one can exist at a given time. Changes in 2.15:
|
- | 2.13 |
Device.LocalAgent.Controller.{i}.E2ESession. | object | R | The E2ESession object represents the End to End (E2E) Session Context
functionality for this Controller.{i} object instance.
Changes in 2.15:
|
- | 2.12 |
Enable | boolean | W | Enable/Disable this E2ESession instance. When true, Session Context is used when exchanging USP Records with the remote endpoint represented by this Controller.{i} object instance. When false, Session Context is not used when exchanging USP Records with the remote endpoint represented by this Controller.{i} object instance.
This parameter was DEPRECATED in 2.15 because it is replaced by SessionMode. Changes in 2.15:
|
false | 2.12 |
SessionMode | string | W | The desired usage mode of an End-to-End Session Context with this particular Controller. Enumeration of:
|
- | 2.15 |
Status | string | R | The current status of the Session Context. Enumeration of:
|
- | 2.12 |
Device.LocalAgent.Certificate.{i}. | object(0:) | R | Each instance of this table represents information related to a X.509 certificate (see [RFC5280]) of a Controller or Certificate Authority. Instances are referenced from {{param: non-existent #.Controller.{i}.Credential}} and {{param: non-existent #.ControllerTrust.Credential.{i}.Credential}}. At most one entry in this table can exist with the same values for both SerialNumber and Issuer, or with a given value for Alias. |
- | 2.12 |
Device.LocalAgent.ControllerTrust. | object | R | This object contains information that an Agent applies when establishing a trust relationship with a Controller. | - | 2.12 |
UntrustedRole | string[:1] | W | Each list item MUST be the Path Name of a row in the Role. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Comma-separated list (up to 1 item) of strings, each entry is a Role that is associated with Controllers whose identity cannot be authenticated. The value of the UntrustedRole parameter is appended to the {{param: non-existent #.Controller.{i}.AssignedRole}} parameter. In some instances, this policy is set by the Agent and cannot be modified by Controllers. If the Agent does not allow modification of this parameter, the Agent MUST respond with an error to the request to set this parameter. | - | 2.12 |
BannedRole | string | W | The value MUST be the Path Name of a row in the Role. table. If the referenced object is deleted, the parameter value MUST be set to an empty string. The Role that is associated with Controllers indicate banned access. When assigned to a Controller or associated with an entry in the Credential table, this MUST be the only value of the BannedRole parameter of the {{param: non-existent #.Controller.{i}.AssignedRole}} parameter. The Agent SHOULD refuse to accept USP messages from, or send USP messages to, any Controller that has this Role. | - | 2.12 |
Device.LocalAgent.ControllerTrust.Role.{i}. | object(0:) | W | Each instance of this table represents a Role that can be assigned to or inherited by a Controller via the Controller Trust mechanism. The Role contains a set of permissions that determine how the Controller can interact with the data model. If multiple permission entries associated with this table contain a Target that evaluates to the same instantiated Object/Parameter for multiple Roles, then the permissions to be used are a union of the identified permissions. At most one entry in this table can exist with a given value for Name, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Name and Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Device.LocalAgent.ControllerTrust.Role.{i}.Permission.{i}. | object(0:) | W | Each instance of this table represents the permissions that are extended to a set of Targets for a specified Role. If there are multiple entries in this table for a specific Role where the Targets overlap, the permissions for the entry with the highest value takes priority over all others. At most one entry in this table can exist with a given value for Order, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Targets | string[] | W | Comma-separated list of strings, each entry is a target to which the value of the permissions parameters are assigned. When an entry is a value of a Partial Path, the permissions are associated to that Object and any child Object/Parameter. When the value of an entry is an Object instance then the permissions are associated to all Parameters of the Object instance. When an entry is a value of a Search Path as defined in [TR-369] that resolves to zero or more Parameter Paths, then all Parameter Paths that result from the evaluation of the Search Path are subject to the permissions assigned by this Permission instance.
Changes in 2.15:
|
<Empty> | 2.0 |
Device.LocalAgent.ControllerTrust.Credential.{i}. | object(0:) | W | Each instance of this table represents a trusted credential. The credential can be that of a certificate authority (CA) for a Controller whose EndpointID is unknown. When a credential is supplied to the Agent by a Controller during authentication, the credentials in this table are used to determine if any of the supplied certificates (including those in the chain of trust) are considered “trusted”. If the Controller authenticated via an entry in this table is not previously known to the Agent, the associated Role entry is automatically applied to the Controller. At most one entry in this table can exist with a given value for Credential, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Credential and Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Role | string[] | W | Each list item MUST be the Path Name of a row in the Role. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Comma-separated list of strings, the (set of) Role(s) applied to a Controller authenticated through this Credential instance. The roles are added to the Controller’s current list of Roles by replacing the value of the {{param: non-existent ##.Controller.{i}.InheritedRole}} parameter. If the Controller is already known to the Agent, with an associated Role, this parameter has no impact. | - | 2.0 |
Device.LocalAgent.ControllerTrust.Challenge.{i}. | object(0:) | W | Each instance of this table represents information that is used to challenge a Controller in order to assign a Role to the Controller or to determine the authenticity of a Certificate. The Controller requests a type of challenge from an Agent using the RequestChallenge command. The Agent returns the value of the Instruction for that type of challenge to the Controller which the Controller then provides a third-party. The third-party responds to the Instruction which the Controller then sends to the Agent using the ChallengeResponse command. The Agent verifies the response to the Challenges and executes an implementation specific Agent logic in order to establish trust with the Controller. This could include (but is not limited to): *Assignment of roles to the Controller is done by appending the non-duplicate roles of the Role parameter to the value of the {{param: non-existent ##.Controller.{i}.AssignedRole}} parameter. *Use the Controller’s certificate to which the challenge response was received in order to authenticate the identity of the Controller. At most one entry in this table can exist with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose an initial value for Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
Role | string[] | W | Each list item MUST be the Path Name of a row in the Role. table. If the referenced object is deleted, the corresponding item MUST be removed from the list. Comma-separated list of strings, the (set of) role(s) appended (non-duplicate values only) to the value of the {{param: non-existent ##.Controller.{i}.AssignedRole}} parameter. | - | 2.0 |
Retries | unsignedInt | W | The number of timesconsecutive failed ChallengeResponse() attempts against this Challenge instance (as determined by the RequestChallenge().ChallengeRef associated with ChallengeResponse().ChallengeID parameters) that are allowed before a challengeLockoutPeriod is retriedstarted beforefor this Challenge instance. Counts of failed attempts for a Challenge instance are reset after a successful ChallengeResponse() for the challengeChallenge procedureinstance isor terminated.after a started LockoutPeriod expires. | - | 2.0 |
LockoutPeriod | int(0:) | W | The time, in seconds that a Controller that has failed the challenge is locked out (based on the value ofOnce the Retries parameter) priorvalue has been reached by failed ChallengeResponse() attempts against this Challenge instance (as determined by the RequestChallenge().ChallengeRef associated with ChallengeResponse().ChallengeID parameters), the value of this parameter represents the amount of time (in seconds) that the Agent will prevent any ChallengeResponse() or RequestChallenge() against this Challenge instance from succeeding. Any attempt to being provided the challenge again. issue a RequestChallenge() or ChallengeResponse() command where the associated RequestChallenge().ChallengeRef points to this Challenge instance during the lockout period will result in an Error response with 7002 as the error code. When a started lockout period has expired, the count of failed attempts for this Challenge instance will be reset. If the Agent chooses to delete ChallengeResponse().ChallengeID values for a locked out Challenge, the Agent can send the 7004 error code for values it does not recognize.A value of zero means that a LockoutPeriodlockout period doesn’t apply and the challengeRequestChallenge() command can be provided indefinitely.attempted without the need to wait between failed challenges. | 30 | 2.0 |
Device.SoftwareModules. | object | R | Top level object for dynamically managed software applications. | - | 2.1 |
DUStateChange! | event | - | This event informs a Controller of the completion (successful or unsuccessful) of a DU state change. When used, this event MUST be issued after the device has completed any file transfers and carried out all operations related to the DU State Change. This event MAY contain the results from multiple DU state changes; it is implementation specific how the device chooses to aggregate the DU state changes, although the device MUST notify the Controller of any DU state changes within 24 hours of the time the operations were completed by the device. The device SHOULD make every attempt to aggregate, as much as possible, the DU State Change notifications to the Controller in the interest of scalability. | - | 2.12 |
⇒ Fault. | object | R | Fault Structure. If the operation was successful, the FaultCode MUST be zero. Otherwise a non-zero FaultCode is specified along with a FaultString indicating the failure reason. | - | 2.12 |
⇒ FaultCode | unsignedInt | R | The numerical fault code. Valid values are: *If the operation was successful, the fault code is 0. *If the device cannot complete the operation for some unknown reason, it SHOULD reject the operation with a 90017002 (Request Denied) fault code. *If the device detects the presence of the “userinfo” component in the file source URL, it SHOULD reject the operation with a 90037004 (Invalid Arguments) fault code. *If the device cannot find the Execution Environment specified in the Install or Update command, it SHOULD reject the operation with a 90237223 (Unknown Execution Environment) fault code. *If the device determines that the Deployment Unit being installed does not match either the Execution Environment specified or any Execution Environment on the device, it SHOULD reject the operation with a 90257225 (Deployment Unit to Execution Environment Mismatch) fault code *If the device detects that the Deployment Unit being installed already has the same version as one already installed on the same Execution Environment, it SHOULD reject the operation with a 90267226 (Duplicate Deployment Unit) fault code. *If the device detects that that there are no more system resources (disk space, memory, etc.) to perform the Install or Update of a Deployment Unit, it SHOULD reject the operation with a 90277227 (System Resources Exceeded) fault code. *If a requested operation attempts to alter the State of a Deployment Unit in a manner that conflicts with the Deployment Unit State Machine Diagram [Appendix I “Software Module Management”/TR-369], it SHOULD reject the operation with a 90297229 (Invalid Deployment Unit State) fault code. *If a requested operation attempts to Uninstall a DU that caused an EE to come into existence, where that EE has at least 1 installed DU or at least 1 child EE, then the device SHOULD reject the operation with a 90297229 (Invalid Deployment Unit State) fault code. | - | 2.12 |
Device.SoftwareModules.ExecEnv.{i}. | object(0:) | R | The Execution Environments that are available on the device, along with their properties and configurable settings. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.1 |
AllocatedDiskSpace | int(-1:) | R | The amount of disk space measured in KiB allocated to this
ExecEnv. A value of -1 MUST be used for ExecEnv instances where
this parameter is not applicable.
Changes in 2.15:
|
- | 2.1 |
AvailableDiskSpace | int(-1:) | R | The amount of disk space measured in KiB currently available to
this ExecEnv. This value changes as the ExecutionUnit
instances associated with this ExecEnv consumes disk space. A
value of -1 MUST be used for ExecEnv instances where this
parameter is not applicable.
Changes in 2.15:
|
- | 2.1 |
AllocatedMemory | int(-1:) | R | The amount of physical RAM measured in KiB allocated to this
ExecEnv. A value of -1 MUST be used for ExecEnv instances where
this parameter is not applicable.
Changes in 2.15:
|
- | 2.1 |
AvailableMemory | int(-1:) | R | The amount of physical RAM measured in KiB currently available
to this ExecEnv. This value changes as the
ExecutionUnit instances associated with this ExecEnv
are started/stopped and consume the physical RAM. A value of -1 MUST
be used for ExecEnv instances where this parameter is not
applicable.
Changes in 2.15:
|
- | 2.1 |
SetRunLevel() | command | - | Provides a mechanism to remotely manipulate the run level of this ExecEnv, meaning that altering this comand will change the value of the CurrentRunLevel. Run levels dictate which Execution Units will be started. Execution Units will be started if CurrentRunLevel is greater than or equal to ExecutionUnit.{i}.RunLevel and ExecutionUnit.{i}.AutoStart is true. | - | 2.12 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ RequestedRunLevel | int(-1:65535) | W | [MANDATORY] This parameter will request to change the value of the CurrentRunLevel to the value of this parameter. Setting this value when CurrentRunLevel is -1 has no impact to the Run Level of this instance of the SoftwareModules object.
Changes in 2.15:
|
- | 2.12 |
Device.SoftwareModules.ExecutionUnit.{i}. | object(0:) | R | This table serves as the Execution Unit inventory and contains both status information about each Execution Unit as well as configurable parameters for each Execution Unit. Each DeploymentUnit that is installed can have zero or more Execution Units. Once a Deployment Unit is installed it populates this table with its contained Execution Units. When the Deployment Unit (that caused this ExecutionUnit to come into existence) is updated, this instance MAY be removed and new instances MAY come into existence. While the Deployment Unit (that caused this ExecutionUnit to come into existence) is being updated, all ExecutionUnit instances associated with the Deployment Unit will be stopped until the update is complete at which time they will be restored to the state that they were in before the update started. When the Deployment Unit (that caused this ExecutionUnit to come into existence) is uninstalled, this instance is removed. Each ExecutionUnit MAY also contain a set of vendor specific parameters displaying status and maintaining configuration that reside under the Extensions object. At most one entry in this table can exist with a given value for EUID, or with a given value for Alias. |
- | 2.1 |
DiskSpaceInUse | int(-1:) | R | The amount of disk space measured in KiB currently being used
by this ExecutionUnit. A value of -1 MUST be used for ExecutionUnit
instances where this parameter is not applicable.
Changes in 2.15:
|
- | 2.1 |
MemoryInUse | int(-1:) | R | The amount of physical RAM measured in KiB currently being used
by this ExecutionUnit. A value of -1 MUST be used for ExecutionUnit
instances where this parameter is not applicable.
Changes in 2.15:
|
- | 2.1 |
SetRequestedState() | command | - | Set the state transition that the Controller is requesting for this instance of the ExecutionUnit object. If this instance of the ExecutionUnit object is associated with an Execution Environment that is disabled and an attempt is made to alter this value, then a error message MUST be generated. | - | 2.1 |
⇒ Input. | arguments | - | Input arguments. | - | |
⇒ RequestedState | string | W | [MANDATORY] Indicates the requested state to transition this instance of the SoftwareModules object. Enumeration of:
Changes in 2.15:
|
- | 2.12 |
Device.CWMPManagementServer. | object | R | - | 2.15 | |
EnableCWMP | boolean | W | Enables and disables the CPE’s support for CWMP. false means that CWMP support in the CPE is disabled, in which case the device MUST NOT send any Inform messages to the ACS or accept any Connection Request notifications from the ACS. true means that CWMP support on the CPE is enabled. The subscriber can re-enable the CPE’s CWMP support either by performing a factory reset or by using a LAN-side protocol to change the value of this parameter back to true. The factory default value MUST be true. |
- | 2.15 |
Device.STOMP. | object | R | The STOMP represents the STOMP capabilities of the device as described in [TR-369]. | - | 2.12 |
Device.STOMP.Connection.{i}. | object(0:) | W | The Connection represents a STOMP connection between the Agent and a STOMP server. At most one entry in this table can exist with the same values for all of Host, Username and VirtualHost, or with a given value for Alias. On creation of a new table entry, the Agent MUST (if not supplied by the Controller on creation) choose initial values for Host, Username and Alias such that the new entry does not conflict with any existing entries. |
- | 2.0 |
OutgoingHeartbeat | unsignedInt | W | Represents the Outgoing heart-beat timing (in milliseconds) of the STOMP Heart-beating mechanism as described in STOMP (for this Connection). The Outgoing heart-beat represents what the sender of the frame can do. A value of 0 means that it cannot send heart-beats. Any changes to this parameter will not take effect until the next connection. | 0 | 2.0 |
IncomingHeartbeat | unsignedInt | W | Represents the Incoming heart-beat timing (in milliseconds) of the STOMP Heart-beating mechanism as described in STOMP (for this Connection). The Incoming heart-beat represents what the sender of the frame would like to get. A value of 0 means that it does not want to receive heart-beats. Any changes to this parameter will not take effect until the next connection. | 0 | 2.0 |
IsEncrypted | boolean | R | This parameter represents whether or not communications that utilize this Connection object instance are encrypted. This parameter is DEPRECATED,
This parameter was DEPRECATED in 2.14.because the **{{param: non-existent IsEncryptedEnableEncryption}}** parameter will dictate whether all connections for this STOMP instance are or are not encrypted.encrypted |
- | 2.0 |
Device.IoTCapability.{i}. | object(0:) | R | This list of IoT capability objects. At most one entry in this table can exist with a given value for Alias, or with a given value for Name. |
- | 2.13 |
Device.IoTCapability.{i}.LevelControl. | object | R | LevelController is used to model a control with a range of continuous states. These values are configurable via Value and measured in Unit and are restricted between a Min and Max values. Intensity profile - Value of intensity and ability to update that level through {{param: non-existent StepUp}}StepUp() and {{param: non-existent StepDown}}StepDown() commands with a configurable StepValue. | - | 2.13 |
StepValue | decimal | W | Number of Unit changes of each {{param: non-existent StepUp}}StepUp() and {{param: non-existent StepDown}}StepDown() command. | - | 2.13 |
Generated by Broadband Forum bbfreport v2.2.0 (2024-07-23 version) on 2024-09-04 at 09:56:06 UTC.
report.py –include ../../install/cwmp –output