@matter/model 0.16.0-alpha.0-20251023-bb23617e5 → 0.16.0-alpha.0-20251029-bd92894d4

package/src/standard/resources/mounted-dimmable-load-control.resource.ts

@@ -10,10 +10,24 @@ import { Resource } from "#models/Resource.js";
 
 Resource.add({
     tag: "deviceType", name: "MountedDimmableLoadControl", classification: "simple", xref: "device§5.4",
-    details: "A Mounted Dimmable Load Control is a fixed device that provides power to another device that is " +
-        "plugged into it, and is capable of being switched on or off and have its level adjusted. The Mounted " +
-        "Dimmable Load Control is typically used to control a conventional non-communicating light through " +
-        "its mains connection using phase cutting.",
+
+    details: "A Mounted Dimmable Load Control is a fixed device that provides power to a load connected to it, and " +
+        "is capable of being switched on or off and have its level adjusted. The Mounted Dimmable Load " +
+        "Control is typically used to control a conventional non-communicating light through its mains " +
+        "connection using phase cutting." +
+        "\n" +
+        "This device type is intended for any wall-mounted or hardwired dimmer-capable load controller, while " +
+        "Dimmable Plug-In Unit is intended only for dimmer-capable smart plugs that are not permanently " +
+        "connected, and which can be unplugged from their power source." +
+        "\n" +
+        "> [!NOTE]" +
+        "\n" +
+        "> Since this device type was added in Matter 1.4, for endpoints using this device type" +
+        "\n" +
+        "it is recommended to add the subset device type Dimmable Plug-In Unit to the DeviceTypeList of the " +
+        "Descriptor cluster on the same endpoint for backward compatibility with existing clients." +
+        "\n" +
+        "See [ref_MountedDimmablePlugInUnitClientGuidance] for client guidance with these two device types.",
 
     children: [
         { tag: "requirement", name: "Identify", xref: "device§5.4.4" },

package/src/standard/resources/mounted-on-off-control.resource.ts

@@ -10,8 +10,21 @@ import { Resource } from "#models/Resource.js";
 
 Resource.add({
     tag: "deviceType", name: "MountedOnOffControl", classification: "simple", xref: "device§5.3",
-    details: "A Mounted On/Off Control is a fixed device that provides power to another device that is plugged " +
-        "into it, and is capable of switching that provided power on or off.",
+
+    details: "A Mounted On/Off Control is a fixed device that provides power to another device or power circuit " +
+        "that is connected to it, and is capable of switching that provided power on or off." +
+        "\n" +
+        "This device type is intended for any wall-mounted or hardwired load controller, while On/Off Plug-in " +
+        "Unit is intended only for smart plugs and other power switching devices that are not permanently " +
+        "connected, and which can be unplugged from their power source." +
+        "\n" +
+        "> [!NOTE]" +
+        "\n" +
+        "> Since this device type was added in Matter 1.4, for endpoints using this device type it is " +
+        "  recommended to add the subset device type On/Off Plug-in Unit to the DeviceTypeList of the " +
+        "  Descriptor cluster on the same endpoint for backward compatibility with existing clients." +
+        "\n" +
+        "See [ref_MountedOnOffClientGuidance] for client guidance with these two device types.",
 
     children: [
         { tag: "requirement", name: "Identify", xref: "device§5.3.4" },

package/src/standard/resources/namespace.resource.ts

@@ -9,14 +9,22 @@
 import { Resource } from "#models/Resource.js";
 
 Resource.add({
-    tag: "datatype", name: "namespace", description: "Namespace", xref: "core§7.19.2.43",
+    tag: "datatype", name: "namespace", description: "Namespace", xref: "core§7.19.2.47",
     details: "The Namespace type identifies the namespace used for a semantic tag.",
 
     children: [
         {
             tag: "field", name: "Closure",
+
             details: "The tags contained in this namespace may be used in any domain or context, to indicate an " +
-                "association with a feature of a Closure, e.g. the button to activate opening a garage door."
+                "association with a feature of a Closure, e.g. the button to activate opening a garage door." +
+                "\n" +
+                "> [!NOTE]" +
+                "\n" +
+                "> This namespace has been deprecated as of Matter 1.4.2." +
+                "\n" +
+                "Clients SHOULD still have support for these tags, since the tags could be used by a server certified " +
+                "on a previous revision of Matter."
         },
 
         {
@@ -75,7 +83,10 @@ Resource.add({
                 "If the Row or Column tags are used, the Label field in the same Semantic Tag structure shall be " +
                 "filled with a number comprised of Arabic numerals encoded as a string to indicate the row/column of " +
                 "the item. Number words (e.g. \"one\", \"two\", etc.) shall NOT be used to describe the position of the " +
-                "item. The first row/column shall use Label \"1\"."
+                "item. The first row/column shall use Label \"1\"." +
+                "\n" +
+                "The following example illustrates a compound device comprised of 9 endpoints arranged in a 3x3 grid. " +
+                "This example uses position tags to indicate position."
         },
 
         {
@@ -132,9 +143,9 @@ Resource.add({
                 "switch device to allow a client to make an optimized user interface which matches the actual device " +
                 "without requiring a-priori knowledge of the layout of each specific switch device." +
                 "\n" +
-                "Please see the rules for applying these and other tags for switch devices, e.g. from the Common " +
-                "Position Namespace and the Common Number Namespace in the Generic Switch device type section in the " +
-                "Device Library."
+                "See the rules for applying these and other tags for switch devices, e.g. from the Common Position " +
+                "Namespace and the Common Number Namespace in the Generic Switch device type section in the Device " +
+                "Library."
         }
     ]
 });

package/src/standard/resources/network-commissioning.resource.ts

@@ -69,7 +69,7 @@ Resource.add(
                 details: "Indicates the maximum duration taken, in seconds, by the network interface on this cluster server " +
                     "instance to provide scan results." +
                     "\n" +
-                    "See ScanNetworks for usage."
+                    "See Section 11.9.7.1, “ScanNetworks Command” for usage."
             },
 
             {
@@ -89,7 +89,8 @@ Resource.add(
                     "It is undefined what happens if InterfaceEnabled is written to false on the same interface as that " +
                     "which is used to write the value. In that case, it is possible that the Administrator would have to " +
                     "await expiry of the fail-safe, and associated recovery of network configuration to prior safe " +
-                    "values, before being able to communicate with the node again (see ArmFailSafe)." +
+                    "values, before being able to communicate with the node again (see Section 11.10.7.2, “ArmFailSafe " +
+                    "Command”)." +
                     "\n" +
                     "It may be possible to disable Ethernet interfaces but it is implementation-defined. If not " +
                     "supported, a write to this attribute with a value of false shall fail with a status of " +
@@ -172,7 +173,10 @@ Resource.add(
             {
                 tag: "command", name: "ScanNetworks", xref: "core§11.9.7.1",
 
-                details: "This command shall scan on the Cluster instance’s associated network interface for either of:" +
+                details: "This command is used to scan for available networks on the network interface associated with the " +
+                    "cluster instance." +
+                    "\n" +
+                    "This command shall scan on the Cluster instance’s associated network interface for either of:" +
                     "\n" +
                     "  • All available networks (non-directed scanning)" +
                     "\n" +
@@ -187,8 +191,9 @@ Resource.add(
                     "Wi-Fi SSID) is provided in the command arguments. Directed scanning shall restrict the result set to " +
                     "the specified network only." +
                     "\n" +
-                    "If this command is received without an armed fail-safe context (see ArmFailSafe), then this command " +
-                    "shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator." +
+                    "If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe " +
+                    "Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the " +
+                    "initiator." +
                     "\n" +
                     "The client shall NOT expect the server to be done scanning and have responded with " +
                     "ScanNetworksResponse before ScanMaxTimeSeconds seconds have elapsed. Enough transport time " +
@@ -233,7 +238,9 @@ Resource.add(
             {
                 tag: "command", name: "ScanNetworksResponse", xref: "core§11.9.7.2",
 
-                details: "This command shall contain the status of the last ScanNetworks command, and the associated scan " +
+                details: "This command is used to report the results of a ScanNetworks command." +
+                    "\n" +
+                    "This command shall contain the status of the last ScanNetworks command, and the associated scan " +
                     "results if the operation was successful." +
                     "\n" +
                     "Results are valid only if NetworkingStatus is Success." +
@@ -306,10 +313,13 @@ Resource.add(
             {
                 tag: "command", name: "AddOrUpdateWiFiNetwork", xref: "core§11.9.7.3",
 
-                details: "This command shall be used to add or modify Wi-Fi network configurations." +
+                details: "This command is used to add or update a Wi-Fi network configuration." +
+                    "\n" +
+                    "This command shall be used to add or modify Wi-Fi network configurations." +
                     "\n" +
-                    "If this command is received without an armed fail-safe context (see ArmFailSafe), then this command " +
-                    "shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator." +
+                    "If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe " +
+                    "Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the " +
+                    "initiator." +
                     "\n" +
                     "The Credentials associated with the network are not readable after execution of this command, as " +
                     "they do not appear in the Networks attribute, for security reasons." +
@@ -333,7 +343,7 @@ Resource.add(
                         details: "Credentials is the passphrase or PSK for the network (if any is needed)." +
                             "\n" +
                             "Security type, cipher and credential format (passphrase or PSK) shall be contextually auto-selected " +
-                            "during execution of the ConnectNetwork Command and during subsequent operational state network " +
+                            "during execution of the ConnectNetwork command and during subsequent operational state network " +
                             "connections, based on the most secure Wi-Fi security type available within beacons and probe " +
                             "responses for the set of all discovered BSSIDs for the configured SSID. The type of PSK or " +
                             "passphrase used shall be inferred based on the length and contents of the Credentials field " +
@@ -365,17 +375,23 @@ Resource.add(
                             "to achieve successful operation, or if all retry attempts fail."
                     },
 
-                    { tag: "field", name: "Breadcrumb", xref: "core§11.9.7.3.3", details: "See Breadcrumb for usage." }
+                    {
+                        tag: "field", name: "Breadcrumb", xref: "core§11.9.7.3.3",
+                        details: "See Section 11.9.7.1.2, “Breadcrumb Field” for usage."
+                    }
                 ]
             },
 
             {
                 tag: "command", name: "AddOrUpdateThreadNetwork", xref: "core§11.9.7.4",
 
-                details: "This command shall be used to add or modify Thread network configurations." +
+                details: "This command is used to add or update a Thread network configuration." +
+                    "\n" +
+                    "This command shall be used to add or modify Thread network configurations." +
                     "\n" +
-                    "If this command is received without an armed fail-safe context (see ArmFailSafe), then this command " +
-                    "shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator." +
+                    "If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe " +
+                    "Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the " +
+                    "initiator." +
                     "\n" +
                     "See Section 11.9.7.5, “Common processing of AddOrUpdateWiFiNetwork and AddOrUpdateThreadNetwork” for " +
                     "behavior of addition/update." +
@@ -397,19 +413,26 @@ Resource.add(
                             "shall pass the OperationalDataset as an opaque octet string."
                     },
 
-                    { tag: "field", name: "Breadcrumb", xref: "core§11.9.7.4.2", details: "See Breadcrumb for usage." }
+                    {
+                        tag: "field", name: "Breadcrumb", xref: "core§11.9.7.4.2",
+                        details: "See Section 11.9.7.1.2, “Breadcrumb Field” for usage."
+                    }
                 ]
             },
 
             {
                 tag: "command", name: "RemoveNetwork", xref: "core§11.9.7.6",
 
-                details: "This command shall remove the network configuration from the Cluster if there was already a network " +
+                details: "This command is used to remove a network configuration on the network interface associated with the " +
+                    "cluster instance." +
+                    "\n" +
+                    "This command shall remove the network configuration from the Cluster if there was already a network " +
                     "configuration with the same NetworkID. The relative order of the entries in the Networks attribute " +
                     "shall remain unchanged, except for the removal of the requested network configuration." +
                     "\n" +
-                    "If this command is received without an armed fail-safe context (see ArmFailSafe), then this command " +
-                    "shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator." +
+                    "If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe " +
+                    "Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the " +
+                    "initiator." +
                     "\n" +
                     "If the Networks attribute does not contain a matching entry, the command shall immediately respond " +
                     "with NetworkConfigResponse having NetworkingStatus status field set to NetworkIdNotFound." +
@@ -424,14 +447,20 @@ Resource.add(
                         details: "This field shall contain the NetworkID for the entry to remove: the SSID for Wi-Fi and XPAN ID for " +
                             "Thread."
                     },
-                    { tag: "field", name: "Breadcrumb", xref: "core§11.9.7.6.2", details: "See Breadcrumb for usage." }
+                    {
+                        tag: "field", name: "Breadcrumb", xref: "core§11.9.7.6.2",
+                        details: "See Section 11.9.7.1.2, “Breadcrumb Field” for usage."
+                    }
                 ]
             },
 
             {
                 tag: "command", name: "NetworkConfigResponse", xref: "core§11.9.7.7",
 
-                details: "This response command relates status information for some commands which require it as their " +
+                details: "This command is used to report the results of a network configuration command " +
+                    "(AddOrUpdateWiFiNetwork, AddOrUpdateThreadNetwork, or RemoveNetwork)." +
+                    "\n" +
+                    "This response command relates status information for some commands which require it as their " +
                     "response command. See each individual cluster server command for the situations that may cause a " +
                     "NetworkingStatus different than Success." +
                     "\n" +
@@ -461,13 +490,14 @@ Resource.add(
                             "  • UnknownError: An internal error occurred during the operation."
                     },
 
-                    { tag: "field", name: "DebugText", xref: "core§11.9.7.7.2", details: "See DebugText for usage." },
-
+                    {
+                        tag: "field", name: "DebugText", xref: "core§11.9.7.7.2",
+                        details: "See Section 11.9.7.2.2, “DebugText Field” for usage."
+                    },
                     {
                         tag: "field", name: "NetworkIndex", xref: "core§11.9.7.7.3",
-                        details: "When the NetworkingStatus is Success, this field shall be present. It shall contain the 0-based " +
-                            "index of the entry in the Networks attribute that was last added, updated or removed successfully by " +
-                            "the associated request command."
+                        details: "This field shall contain the 0-based index of the entry in the Networks attribute that was last " +
+                            "added, updated or removed successfully by the associated request command."
                     }
                 ]
             },
@@ -475,7 +505,10 @@ Resource.add(
             {
                 tag: "command", name: "ConnectNetwork", xref: "core§11.9.7.8",
 
-                details: "This command shall attempt to connect to a network whose configuration was previously added by " +
+                details: "This command is used to connect to a network on the network interface associated with the cluster " +
+                    "instance." +
+                    "\n" +
+                    "This command shall attempt to connect to a network whose configuration was previously added by " +
                     "either the AddOrUpdateWiFiNetwork or AddOrUpdateThreadNetwork commands. Network is identified by its " +
                     "NetworkID." +
                     "\n" +
@@ -483,8 +516,9 @@ Resource.add(
                     "unable to proceed with such an operation, such as if it is currently attempting to connect in the " +
                     "background, or is already proceeding with a prior ConnectNetwork." +
                     "\n" +
-                    "If this command is received without an armed fail-safe context (see ArmFailSafe), then this command " +
-                    "shall fail with a FAILSAFE_REQUIRED status code sent back to the initiator." +
+                    "If this command is received without an armed fail-safe context (see Section 11.10.7.2, “ArmFailSafe " +
+                    "Command”), then this command shall fail with a FAILSAFE_REQUIRED status code sent back to the " +
+                    "initiator." +
                     "\n" +
                     "Before connecting to the new network, the Node shall disconnect the operational network connections " +
                     "managed by any other Network Commissioning cluster instances (whether under the Root Node or a " +
@@ -518,8 +552,8 @@ Resource.add(
                     "attribute." +
                     "\n" +
                     "Even after successfully connecting to a network, the configuration shall revert to the prior state " +
-                    "of configuration if the CommissioningComplete command (see CommissioningComplete) is not " +
-                    "successfully invoked before expiry of the Fail-Safe timer." +
+                    "of configuration if the CommissioningComplete command (see Section 11.10.7.6, “CommissioningComplete " +
+                    "Command”) is not successfully invoked before expiry of the Fail-Safe timer." +
                     "\n" +
                     "When non-concurrent commissioning is being used by a Commissioner or Administrator, the " +
                     "ConnectNetworkResponse shall be sent with the NetworkingStatus field set to Success prior to closing " +
@@ -531,8 +565,8 @@ Resource.add(
                     "ConnectNetwork command, the client SHOULD re-invoke the Arm Fail-Safe command with a duration that " +
                     "meets the following:" +
                     "\n" +
-                    "  1. Sufficient time to meet the minimum required time (see ConnectMaxTimeSeconds) that may be taken " +
-                    "     by the server to connect to the desired network." +
+                    "  1. Sufficient time to meet the minimum required time (see Section 11.9.6.4, “ConnectMaxTimeSeconds " +
+                    "     Attribute”) that may be taken by the server to connect to the desired network." +
                     "\n" +
                     "  2. Sufficient time to account for possible message-layer retries when a response is requested." +
                     "\n" +
@@ -558,14 +592,19 @@ Resource.add(
                         details: "This field shall contain the NetworkID for the entry used to configure the connection: the SSID for " +
                             "Wi-Fi and XPAN ID for Thread."
                     },
-                    { tag: "field", name: "Breadcrumb", xref: "core§11.9.7.8.2", details: "See Breadcrumb for usage." }
+                    {
+                        tag: "field", name: "Breadcrumb", xref: "core§11.9.7.8.2",
+                        details: "See Section 11.9.7.1.2, “Breadcrumb Field” for usage."
+                    }
                 ]
             },
 
             {
                 tag: "command", name: "ConnectNetworkResponse", xref: "core§11.9.7.9",
 
-                details: "Before generating a ConnectNetworkResponse, the server shall:" +
+                details: "This command is used to report the results of a ConnectNetwork command." +
+                    "\n" +
+                    "Before generating a ConnectNetworkResponse, the server shall:" +
                     "\n" +
                     "  • Set the LastNetworkingStatus attribute value to the NetworkingStatus matching the response." +
                     "\n" +
@@ -600,7 +639,10 @@ Resource.add(
                             "    AuthFailure, UnsupportedSecurity, OtherConnectionFailure, IPV6Failed, IPBindFailed"
                     },
 
-                    { tag: "field", name: "DebugText", xref: "core§11.9.7.9.2", details: "See DebugText for usage." },
+                    {
+                        tag: "field", name: "DebugText", xref: "core§11.9.7.9.2",
+                        details: "See Section 11.9.7.2.2, “DebugText Field” for usage."
+                    },
 
                     {
                         tag: "field", name: "ErrorValue", xref: "core§11.9.7.9.3",
@@ -630,7 +672,9 @@ Resource.add(
 
             {
                 tag: "command", name: "ReorderNetwork", xref: "core§11.9.7.10",
-                details: "This command shall set the specific order of the network configuration selected by its NetworkID in " +
+                details: "This command is used to re-order the network configuration list." +
+                    "\n" +
+                    "This command shall set the specific order of the network configuration selected by its NetworkID in " +
                     "the Networks attribute to match the position given by NetworkIndex.",
 
                 children: [
@@ -648,7 +692,7 @@ Resource.add(
                     {
                         tag: "field", name: "Breadcrumb", xref: "core§11.9.7.10.3",
 
-                        details: "See Breadcrumb for usage." +
+                        details: "See Section 11.9.7.1.2, “Breadcrumb Field” for usage." +
                             "\n" +
                             "### Effect when received" +
                             "\n" +
@@ -716,13 +760,10 @@ Resource.add(
 
             {
                 tag: "datatype", name: "ThreadCapabilitiesBitmap", xref: "core§11.9.5.2",
-
                 details: "The ThreadCapabilitiesBitmap encodes the supported Thread features and capabilities of a " +
                     "Thread-enabled network interface." +
                     "\n" +
-                    "> [!NOTE]" +
-                    "\n" +
-                    "> The valid combinations of capabilities are restricted and dependent on Thread version.",
+                    "NOTE The valid combinations of capabilities are restricted and dependent on Thread version.",
 
                 children: [
                     {
@@ -778,7 +819,7 @@ Resource.add(
                     { tag: "field", name: "NetworkNotFound", description: "Cannot find AP: SSID Not found" },
                     {
                         tag: "field", name: "RegulatoryError",
-                        description: "Cannot find AP: Mismatch on band/channels/regulato ry domain / 2.4GHz vs 5GHz"
+                        description: "Cannot find AP: Mismatch on band/channels/regulatory domain/ 2.4GHz vs 5GHz"
                     },
                     { tag: "field", name: "AuthFailure", description: "Cannot associate due to authentication failure" },
                     {

package/src/standard/resources/network-infrastructure-manager.resource.ts

@@ -10,7 +10,7 @@ import { Resource } from "#models/Resource.js";
 
 Resource.add({
     tag: "deviceType", name: "NetworkInfrastructureManager", classification: "simple",
-    xref: "device§15.2",
+    xref: "device§15.3",
 
     details: "A Network Infrastructure Manager provides interfaces that allow for the management of the Wi-Fi, " +
         "Thread, and Ethernet networks underlying a Matter deployment, realizing the Star Network Topology " +
@@ -20,17 +20,18 @@ Resource.add({
         "include Wi-Fi gateway routers." +
         "\n" +
         "Relevant hardware and software requirements for Network Infrastructure Manager devices are defined " +
-        "in Section 15.2.6, “Other Requirements” and within the clusters mandated by this device type." +
+        "in Section 15.3.6, “Other Requirements” and within the clusters mandated by this device type." +
         "\n" +
         "A Network Infrastructure Manager device may be managed by a service associated with the device " +
         "vendor, for example, an Internet Service Provider. Sometimes this managing service will have " +
         "policies that require the use of the Managed Device feature of the Access Control Cluster (see " +
-        "Section 15.2.5.1, “Access Control MNGD Conformance”). Consequently, Commissioners of this device " +
+        "Section 15.3.5.1, “Access Control MNGD Conformance”). Consequently, Commissioners of this device " +
         "type should be aware of this feature and its use.",
 
     children: [
-        { tag: "requirement", name: "WiFiNetworkManagement", xref: "device§15.2.4" },
-        { tag: "requirement", name: "ThreadBorderRouterManagement", xref: "device§15.2.4" },
-        { tag: "requirement", name: "ThreadNetworkDirectory", xref: "device§15.2.4" }
+        { tag: "requirement", name: "WiFiNetworkManagement", xref: "device§15.3.4" },
+        { tag: "requirement", name: "ThreadBorderRouterManagement", xref: "device§15.3.4" },
+        { tag: "requirement", name: "ThreadNetworkDirectory", xref: "device§15.3.4" },
+        { tag: "requirement", name: "ThreadNetworkDiagnostics", xref: "device§15.3.4" }
     ]
 });

package/src/standard/resources/occupancy-sensing.resource.ts

@@ -28,11 +28,15 @@ Resource.add({
                 { tag: "field", name: "PHY", details: "Supports sensing using a physical contact" },
                 {
                     tag: "field", name: "AIR",
-                    details: "Supports sensing using Active InfraRed measurement (e.g. time-of-flight or transflective/reflec tive " +
+                    details: "Supports sensing using Active InfraRed measurement (e.g. time-of-flight or transflective/reflective " +
                         "IR sensing)"
                 },
                 { tag: "field", name: "RAD", details: "Supports sensing using radar waves (microwave)" },
-                { tag: "field", name: "RFS", details: "Supports sensing based on RF signal analysis" },
+                {
+                    tag: "field", name: "RFS",
+                    details: "Supports sensing using analysis of radio signals, e.g.: RSSI, CSI and/or any other metric from the " +
+                        "signal"
+                },
                 { tag: "field", name: "VIS", details: "Supports sensing based on analyzing images" }
             ]
         },
@@ -51,13 +55,11 @@ Resource.add({
             tag: "attribute", name: "HoldTime", xref: "cluster§2.7.6.3",
 
             details: "This attribute shall specify the time delay, in seconds, before the sensor changes to its unoccupied " +
-                "state after the last detection of occupancy in the sensed area. This is equivalent to the legacy" +
-                "\n" +
+                "state after the last detection of occupancy in the sensed area. This is equivalent to the legacy " +
                 "*OccupiedToUnoccupiedDelay attributes." +
                 "\n" +
-                "The value of HoldTime shall be within the limits provided in the HoldTimeLimits attribute, i.e. " +
-                "HoldTimeMin <= HoldTime <= HoldTimeMax Low values of HoldTime SHOULD be avoided since they could " +
-                "lead to many reporting messages. A value 0 for HoldTime shall NOT be used." +
+                "Low values of HoldTime SHOULD be avoided since they could lead to many reporting messages. A value 0 " +
+                "for HoldTime shall NOT be used." +
                 "\n" +
                 "The figure below illustrates this with an example of how this attribute is used for a PIR sensor. It " +
                 "uses threshold detection to generate an \"internal detection\" signal, which needs post-processing to " +

package/src/standard/resources/on-off-plug-in-unit.resource.ts

@@ -10,8 +10,20 @@ import { Resource } from "#models/Resource.js";
 
 Resource.add({
     tag: "deviceType", name: "OnOffPlugInUnit", classification: "simple", xref: "device§5.1",
+
     details: "An On/Off Plug-in Unit is a device that provides power to another device that is plugged into it, " +
-        "and is capable of switching that provided power on or off.",
+        "and is capable of switching that provided power on or off." +
+        "\n" +
+        "The Mounted On/Off Control (added in Matter 1.4) has identical cluster requirements as the On/Off " +
+        "Plug-In Unit, and is marked as superset of this device type (since Matter 1.4.2). For devices " +
+        "intended to be mounted permanently, the Mounted On/Off Control device type shall be used, with the " +
+        "On/Off Plug-In Unit device type optionally added in the DeviceTypeList of the Descriptor cluster in " +
+        "addition to the On/Off Plug-In Unit device type (see [ref_MountedOnOffControlServerGuidance])." +
+        "\n" +
+        "### Before Matter 1.4, mounted units typically used the On/Off Plug-In Unit device type. Clients can " +
+        "encounter devices which were made before or after these specification updates. Therefore, clients " +
+        "SHOULD use the following heuristic to distinguish the type of physical device based on the device " +
+        "type revision found on an endpoint (\"--\" means the device type is not listed).",
 
     children: [
         { tag: "requirement", name: "Identify", xref: "device§5.1.4" },