@matter/model 0.12.6-alpha.0-20250304-03716637c → 0.13.0-alpha.0-20250307-ebf84a05a

package/src/standard/elements/OperationalState.ts

@@ -43,7 +43,7 @@ export const OperationalState = Cluster(
         xref: { document: "cluster", section: "1.14" }
     },
 
-    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 2 }),
+    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 3 }),
 
     Attribute(
         {
@@ -69,7 +69,8 @@ export const OperationalState = Cluster(
         quality: "X",
 
         details: "This attribute represents the current phase of operation being performed by the server. This shall " +
-            "be the positional index representing the value from the set provided in the PhaseList Attribute, " +
+            "be the positional index representing the value from the set provided in the PhaseList Attribute," +
+            "\n" +
             "where the first item in that list is an index of 0. Thus, this attribute shall have a maximum value " +
             "that is \"length(PhaseList) - 1\"." +
             "\n" +
@@ -80,18 +81,36 @@ export const OperationalState = Cluster(
 
     Attribute({
         name: "CountdownTime", id: 0x2, type: "elapsed-s", access: "R V", conformance: "O",
-        constraint: "max 259200", default: null, quality: "X C",
+        constraint: "max 259200", default: null, quality: "X Q",
 
-        details: "Indicates the estimated time left before the operation is completed, in seconds. Changes to this " +
-            "value shall NOT be reported in a subscription (note the C Quality). A Client implementation may " +
-            "periodically poll this value to ensure alignment of any local rendering of the CountdownTime with " +
-            "the device provided value." +
+        details: "Indicates the estimated time left before the operation is completed, in seconds." +
+            "\n" +
+            "A value of 0 (zero) means that the operation has completed." +
+            "\n" +
+            "A value of null represents that there is no time currently defined until operation completion. This " +
+            "may happen, for example, because no operation is in progress or because the completion time is " +
+            "unknown." +
+            "\n" +
+            "Changes to this attribute shall only be marked as reportable in the following cases:" +
+            "\n" +
+            "  • If it has changed due to a change in the CurrentPhase or OperationalState attributes, or" +
+            "\n" +
+            "  • When it changes from 0 to any other value and vice versa, or" +
             "\n" +
-            "A value of 0 means that the operation has completed." +
+            "  • When it changes from null to any other value and vice versa, or" +
             "\n" +
-            "When this attribute is null, that represents that there is no time currently defined until " +
-            "operation completion. This may happen, for example, because no operation is in progress or because " +
-            "the completion time is unknown.",
+            "  • When it increases, or" +
+            "\n" +
+            "  • When there is any increase or decrease in the estimated time remaining that was due to " +
+            "    progressing insight of the server’s control logic, or" +
+            "\n" +
+            "  • When it changes at a rate significantly different from one unit per second." +
+            "\n" +
+            "Changes to this attribute merely due to the normal passage of time with no other dynamic change of " +
+            "device state shall NOT be reported." +
+            "\n" +
+            "As this attribute is not being reported during a regular countdown, clients SHOULD NOT rely on the " +
+            "reporting of this attribute in order to keep track of the remaining duration.",
 
         xref: { document: "cluster", section: "1.14.5.3" }
     }),
@@ -149,12 +168,18 @@ export const OperationalState = Cluster(
 
     Event(
         {
-            name: "OperationCompletion", id: 0x1, access: "V", conformance: "P, O", priority: "info",
-            details: "This event is generated when the overall operation ends, successfully or otherwise. For example, " +
-                "the completion of a cleaning operation in a Robot Vacuum Cleaner, or the completion of a wash cycle " +
-                "in a Washing Machine." +
+            name: "OperationCompletion", id: 0x1, access: "V", conformance: "O", priority: "info",
+
+            details: "This event SHOULD be generated when the overall operation ends, successfully or otherwise. For " +
+                "example, the completion of a cleaning operation in a Robot Vacuum Cleaner, or the completion of a " +
+                "wash cycle in a Washing Machine." +
+                "\n" +
+                "It is highly recommended that appliances device types employing the Operational State cluster " +
+                "support this event, even if it is optional. This assists clients in executing automations or " +
+                "issuing notifications at critical points in the device operation cycles." +
                 "\n" +
                 "This event shall contain the following fields:",
+
             xref: { document: "cluster", section: "1.14.7.2" }
         },
 
@@ -168,10 +193,14 @@ export const OperationalState = Cluster(
 
         Field({
             name: "TotalOperationalTime", id: 0x1, type: "elapsed-s", conformance: "O", quality: "X",
+
             details: "The total operational time, in seconds, from when the operation was started via an initial Start " +
-                "command or manual action, until the operation completed. This includes any time spent while paused. " +
-                "There may be cases whereby the total operational time exceeds the maximum value that can be " +
-                "conveyed by this attribute, in such instances, this attribute shall be populated with null.",
+                "command or autonomous/manual starting action, until the operation completed. This includes any time" +
+                "\n" +
+                "spent while paused. There may be cases whereby the total operational time exceeds the maximum value " +
+                "that can be conveyed by this attribute, in such instances, this attribute shall be populated with " +
+                "null.",
+
             xref: { document: "cluster", section: "1.14.7.2.2" }
         }),
 
@@ -357,29 +386,36 @@ export const OperationalState = Cluster(
         })
     ),
 
-    Datatype({
-        name: "OperationalStateEnum", type: "enum8",
+    Datatype(
+        {
+            name: "OperationalStateEnum", type: "enum8",
 
-        details: "This type defines the set of known operational state values, and is derived from enum8. The " +
-            "following table defines the applicable ranges for values that are defined within this type. All " +
-            "values that are undefined shall be treated as reserved. As shown by the table, states that may be " +
-            "specific to a certain Device Type or other modality shall be defined in a derived cluster of this " +
-            "cluster." +
-            "\n" +
-            "The derived cluster-specific state definitions shall NOT duplicate any general state definitions. " +
-            "That is, a derived cluster specification of this cluster cannot define states with the same " +
-            "semantics as the general states defined below." +
-            "\n" +
-            "A manufacturer-specific state definition shall NOT duplicate the general state definitions or " +
-            "derived cluster state definitions. That is, a manufacturer-defined state defined for this cluster " +
-            "or a derived cluster thereof cannot define a state with the same semantics as the general states " +
-            "defined below or states defined in a derived cluster. Such manufacturer-specific state definitions " +
-            "shall be scoped in the context of the Vendor ID present in the Basic Information cluster." +
-            "\n" +
-            "The following table defines the generally applicable states.",
+            details: "This type defines the set of known operational state values, and is derived from enum8. The " +
+                "following table defines the applicable ranges for values that are defined within this type. All " +
+                "values that are undefined shall be treated as reserved. As shown by the table, states that may be " +
+                "specific to a certain Device Type or other modality shall be defined in a derived cluster of this " +
+                "cluster." +
+                "\n" +
+                "The derived cluster-specific state definitions shall NOT duplicate any general state definitions. " +
+                "That is, a derived cluster specification of this cluster cannot define states with the same " +
+                "semantics as the general states defined below." +
+                "\n" +
+                "A manufacturer-specific state definition shall NOT duplicate the general state definitions or " +
+                "derived cluster state definitions. That is, a manufacturer-defined state defined for this cluster " +
+                "or a derived cluster thereof cannot define a state with the same semantics as the general states " +
+                "defined below or states defined in a derived cluster. Such manufacturer-specific state definitions " +
+                "shall be scoped in the context of the Vendor ID present in the Basic Information cluster." +
+                "\n" +
+                "The following table defines the generally applicable states.",
 
-        xref: { document: "cluster", section: "1.14.4.1" }
-    }),
+            xref: { document: "cluster", section: "1.14.4.1" }
+        },
+
+        Field({ name: "Stopped", id: 0x0, conformance: "M", description: "The device is stopped" }),
+        Field({ name: "Running", id: 0x1, conformance: "M", description: "The device is operating" }),
+        Field({ name: "Paused", id: 0x2, conformance: "M", description: "The device is paused during an operation" }),
+        Field({ name: "Error", id: 0x3, conformance: "M", description: "The device is in an error state" })
+    ),
 
     Datatype(
         {
@@ -402,39 +438,34 @@ export const OperationalState = Cluster(
         })
     ),
 
-    Datatype({
-        name: "ErrorStateEnum", type: "enum8",
-
-        details: "This type defines the set of known operational error values, and is derived from enum8. The " +
-            "following table defines the applicable ranges for values that are defined within this type. All " +
-            "values that" +
-            "\n" +
-            "are undefined shall be treated as reserved. As shown by the table, errors that may be specific to a " +
-            "certain Device Type or other modality shall be defined in a derived cluster of this cluster." +
-            "\n" +
-            "The derived cluster-specific error definitions shall NOT duplicate the general error definitions. " +
-            "That is, a derived cluster specification of this cluster cannot define errors with the same " +
-            "semantics as the general errors defined below." +
-            "\n" +
-            "The manufacturer-specific error definitions shall NOT duplicate the general error definitions or " +
-            "derived cluster-specific error definitions. That is, a manufacturer-defined error defined for this " +
-            "cluster or a derived cluster thereof cannot define errors with the same semantics as the general " +
-            "errors defined below or errors defined in a derived cluster. Such manufacturer-specific error " +
-            "definitions shall be scoped in the context of the Vendor ID present in the Basic Information " +
-            "cluster." +
-            "\n" +
-            "The set of ErrorStateID field values defined in each of the generic or derived Operational State " +
-            "cluster specifications is called ErrorState.",
-
-        xref: { document: "cluster", section: "1.14.4.3" }
-    }),
-
     Datatype(
         {
-            name: "GeneralErrorStateEnum", type: "enum8",
-            details: "The following table defines the generally applicable ErrorState values.",
-            xref: { document: "cluster", section: "1.14.4.3.1" }
+            name: "ErrorStateEnum", type: "enum8",
+
+            details: "This type defines the set of known operational error values, and is derived from enum8. The " +
+                "following table defines the applicable ranges for values that are defined within this type. All " +
+                "values that are undefined shall be treated as reserved. As shown by the table, errors that may be " +
+                "specific to a certain Device Type or other modality shall be defined in a derived cluster of this " +
+                "cluster." +
+                "\n" +
+                "The derived cluster-specific error definitions shall NOT duplicate the general error definitions." +
+                "\n" +
+                "That is, a derived cluster specification of this cluster cannot define errors with the same " +
+                "semantics as the general errors defined below." +
+                "\n" +
+                "The manufacturer-specific error definitions shall NOT duplicate the general error definitions or " +
+                "derived cluster-specific error definitions. That is, a manufacturer-defined error defined for this " +
+                "cluster or a derived cluster thereof cannot define errors with the same semantics as the general " +
+                "errors defined below or errors defined in a derived cluster. Such manufacturer-specific error " +
+                "definitions shall be scoped in the context of the Vendor ID present in the Basic Information " +
+                "cluster." +
+                "\n" +
+                "The set of ErrorStateID field values defined in each of the generic or derived Operational State " +
+                "cluster specifications is called ErrorState.",
+
+            xref: { document: "cluster", section: "1.14.4.3" }
         },
+
         Field({ name: "NoError", id: 0x0, conformance: "M", description: "The device is not in an error state" }),
         Field({
             name: "UnableToStartOrResume", id: 0x1, conformance: "M",

package/src/standard/elements/OtaSoftwareUpdateProvider.ts

@@ -86,7 +86,8 @@ export const OtaSoftwareUpdateProvider = Cluster(
 
         Field({
             name: "Location", id: 0x5, type: "string", conformance: "O", constraint: "2",
-            details: "The location, if present, shall provide the same value as the Basic Information Cluster Location " +
+            details: "The location, if present, shall provide the same value as the Basic Information Cluster Location" +
+                "\n" +
                 "attribute for the OTA Requestor as configured. This may be used by the OTA Provider logic to allow " +
                 "per-region selection of the Software Image.",
             xref: { document: "core", section: "11.20.6.5.1.6" }
@@ -194,29 +195,28 @@ export const OtaSoftwareUpdateProvider = Cluster(
                     "\n" +
                     "    a. The Operational Node ID in the host field shall match the NodeID of the OTA Provider " +
                     "       responding with the QueryImageResponse. The usage of a different Node ID than that of the " +
-                    "       provider is reserved for future use. This constraint reduces the number of independent" +
-                    "\n" +
-                    "CASE secure channel sessions that have to be maintained to proceed with OTA software updates, thus " +
-                    "reducing energy and resource utilization for the software update process." +
+                    "       provider is reserved for future use. This constraint reduces the number of independent CASE " +
+                    "       secure channel sessions that have to be maintained to proceed with OTA software updates, " +
+                    "       thus reducing energy and resource utilization for the software update process." +
                     "\n" +
-                    "4. The user section of the authority field shall be absent, as there are no \"users\" to be " +
-                    "considered." +
+                    "  4. The user section of the authority field shall be absent, as there are no \"users\" to be " +
+                    "     considered." +
                     "\n" +
-                    "5. The port section of the authority field shall be absent, as the port for transport shall be " +
-                    "determined through Operational Discovery of the target Node." +
+                    "  5. The port section of the authority field shall be absent, as the port for transport shall be " +
+                    "     determined through Operational Discovery of the target Node." +
                     "\n" +
-                    "6. The URI shall not contain a query field." +
+                    "  6. The URI shall NOT contain a query field." +
                     "\n" +
-                    "7. The URI shall not contain a fragment field." +
+                    "  7. The URI shall NOT contain a fragment field." +
                     "\n" +
-                    "8. The path field shall employ absolute path representation and shall contain the file designator " +
-                    "of the software image to download at the BDX server. When used with the BDX server, the leading / " +
-                    "separating the URI authority from the path shall be omitted. When contacting the BDX server, " +
-                    "further processing of the file designator shall NOT be done, including handling of URL-encoded " +
-                    "escape sequences. Rather, the exact octets of the path, as received shall be the values used by " +
-                    "both client and server in handling the file designator." +
+                    "  8. The path field shall employ absolute path representation and shall contain the file designator " +
+                    "     of the software image to download at the BDX server. When used with the BDX server, the " +
+                    "     leading / separating the URI authority from the path shall be omitted. When contacting the BDX " +
+                    "     server, further processing of the file designator shall NOT be done, including handling of " +
+                    "     URL-encoded escape sequences. Rather, the exact octets of the path, as received shall be the " +
+                    "     values used by both client and server in handling the file designator." +
                     "\n" +
-                    "  a. The path shall only contain valid URI characters." +
+                    "    a. The path shall only contain valid URI characters." +
                     "\n" +
                     "These rules above for BDX URIs simplify parsing for OTA Requestors receiving Image URIs. The " +
                     "following example procedure shows how the format constraints simplify the extraction of the " +
@@ -454,7 +454,7 @@ export const OtaSoftwareUpdateProvider = Cluster(
                 "or a critical malfunction), an OTA Provider shall NOT expect every OTA Requestor to invoke this " +
                 "command for correct operation of the OTA Provider." +
                 "\n" +
-                "This command shall be considered optional and shall not result in reduced availability of the OTA " +
+                "This command shall be considered optional and shall NOT result in reduced availability of the OTA " +
                 "Provider functionality if OTA Requestors never invoke this command." +
                 "\n" +
                 "Effect on Receipt" +
@@ -496,8 +496,7 @@ export const OtaSoftwareUpdateProvider = Cluster(
         {
             name: "ApplyUpdateActionEnum", type: "enum8",
             details: "See Section 11.20.3.6, “Applying a software update” for the semantics of the values. This " +
-                "enumeration is used in the Action field of the ApplyUpdateResponse command. See (Section " +
-                "11.20.6.5.4.1, “Action Field”).",
+                "enumeration is used in the Action field of the ApplyUpdateResponse command. See (Action).",
             xref: { document: "core", section: "11.20.6.4.2" }
         },
 
@@ -512,9 +511,8 @@ export const OtaSoftwareUpdateProvider = Cluster(
     Datatype(
         {
             name: "DownloadProtocolEnum", type: "enum8",
-            details: "Note that only HTTP over TLS (HTTPS) is supported (see RFC 7230). Using HTTP without TLS shall" +
-                "\n" +
-                "NOT be supported, as there is no way to authenticate the involved participants.",
+            details: "Note that only HTTP over TLS (HTTPS) is supported (see RFC 7230). Using HTTP without TLS shall NOT " +
+                "be supported, as there is no way to authenticate the involved participants.",
             xref: { document: "core", section: "11.20.6.4.3" }
         },
 

package/src/standard/elements/OtaSoftwareUpdateRequestor.ts

@@ -26,7 +26,7 @@ export const OtaSoftwareUpdateRequestor = Cluster(
     Attribute(
         {
             name: "DefaultOtaProviders", id: 0x0, type: "list", access: "RW F VA", conformance: "M",
-            constraint: "desc", default: [],
+            constraint: "desc", default: [], quality: "N",
 
             details: "This field is a list of ProviderLocation whose entries shall be set by Administrators, either " +
                 "during Commissioning or at a later time, to set the ProviderLocation for the default OTA Provider " +
@@ -450,8 +450,7 @@ export const OtaSoftwareUpdateRequestor = Cluster(
 
         Field({
             name: "Endpoint", id: 0x2, type: "endpoint-no", access: "F", conformance: "M",
-            details: "This field shall contain the endpoint number which has the OTA Provider device type and OTA" +
-                "\n" +
+            details: "This field shall contain the endpoint number which has the OTA Provider device type and OTA " +
                 "Software Update Provider cluster server on the ProviderNodeID. This is provided to avoid having to " +
                 "do discovery of the location of that endpoint by walking over all endpoints and checking their " +
                 "Descriptor Cluster.",

package/src/standard/elements/OvenCavityOperationalState.ts

@@ -7,17 +7,27 @@
 /*** THIS FILE IS GENERATED, DO NOT EDIT ***/
 
 import { MatterDefinition } from "../MatterDefinition.js";
-import { ClusterElement as Cluster, AttributeElement as Attribute } from "../../elements/index.js";
+import {
+    ClusterElement as Cluster,
+    AttributeElement as Attribute,
+    CommandElement as Command
+} from "../../elements/index.js";
 
 export const OvenCavityOperationalState = Cluster(
     {
         name: "OvenCavityOperationalState", id: 0x48, type: "OperationalState",
         classification: "application", pics: "OVENOPSTATE",
-        details: "This cluster provides an interface for monitoring the operational state of an oven.",
+        details: "This cluster is derived from the Operational State cluster and provides an interface for monitoring " +
+            "the operational state of an oven.",
         xref: { document: "cluster", section: "8.10" }
     },
 
-    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 1 })
+    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 2 }),
+    Command({ name: "Pause", id: 0x0, conformance: "X", xref: { document: "cluster", section: "8.10.5" } }),
+    Command({ name: "Stop", id: 0x1, xref: { document: "cluster", section: "8.10.5" } }),
+    Command({ name: "Start", id: 0x2, xref: { document: "cluster", section: "8.10.5" } }),
+    Command({ name: "Resume", id: 0x3, conformance: "X", xref: { document: "cluster", section: "8.10.5" } }),
+    Command({ name: "OperationalCommandResponse", id: 0x4, xref: { document: "cluster", section: "8.10.5" } })
 )
 
 MatterDefinition.children.push(OvenCavityOperationalState);

package/src/standard/elements/OvenDT.ts

@@ -20,7 +20,7 @@ export const OvenDt = DeviceType(
 
     Requirement(
         { name: "Descriptor", id: 0x1d, element: "serverCluster" },
-        Requirement({ name: "DeviceTypeList", default: [ { deviceType: 123, revision: 1 } ], element: "attribute" })
+        Requirement({ name: "DeviceTypeList", default: [ { deviceType: 123, revision: 2 } ], element: "attribute" })
     ),
     Requirement({
         name: "Identify", id: 0x3, conformance: "O", element: "serverCluster",

package/src/standard/elements/OvenMode.ts

@@ -10,65 +10,101 @@ import { MatterDefinition } from "../MatterDefinition.js";
 import {
     ClusterElement as Cluster,
     AttributeElement as Attribute,
-    DatatypeElement as Datatype,
-    FieldElement as Field
+    FieldElement as Field,
+    DatatypeElement as Datatype
 } from "../../elements/index.js";
 
 export const OvenMode = Cluster(
     {
         name: "OvenMode", id: 0x49, type: "ModeBase", classification: "application", pics: "OTCCM",
-        details: "This cluster is derived from the Mode Base cluster, defining additional mode tags and namespaced " +
+        details: "This cluster is derived from the Mode Base cluster and defines additional mode tags and namespaced " +
             "enumerated values for oven devices.",
         xref: { document: "cluster", section: "8.11" }
     },
 
-    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 1 }),
+    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 2 }),
+
+    Attribute(
+        { name: "FeatureMap", id: 0xfffc, type: "FeatureMap", xref: { document: "cluster", section: "8.11.4" } },
+        Field({
+            name: "DEPONOFF", conformance: "X", constraint: "0", description: "OnOff",
+            details: "Dependency with the OnOff cluster"
+        })
+    ),
+
+    Attribute({
+        name: "SupportedModes", id: 0x0,
+        details: "At least one entry in the SupportedModes attribute shall include the Bake mode tag in the ModeTags " +
+            "field list.",
+        xref: { document: "cluster", section: "8.11.6.1" }
+    }),
+
+    Attribute({ name: "CurrentMode", id: 0x1, xref: { document: "cluster", section: "8.11.6" } }),
+    Attribute({ name: "StartUpMode", id: 0x2, conformance: "X", xref: { document: "cluster", section: "8.11.6" } }),
+    Attribute({ name: "OnMode", id: 0x3, conformance: "X", xref: { document: "cluster", section: "8.11.6" } }),
+
+    Datatype({
+        name: "ModeOptionStruct", type: "ModeOptionStruct",
+        details: "The table below lists the changes relative to the Mode Base cluster for the fields of the " +
+            "ModeOptionStruct type. A blank field indicates no change.",
+        xref: { document: "cluster", section: "8.11.5.1" }
+    }),
 
     Datatype(
         { name: "ModeTag", type: "enum16" },
+        Field({ name: "Auto", id: 0x0, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "Quick", id: 0x1, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "Quiet", id: 0x2, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "LowNoise", id: 0x3, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "LowEnergy", id: 0x4, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "Vacation", id: 0x5, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "Min", id: 0x6, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "Max", id: 0x7, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "Night", id: 0x8, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "Day", id: 0x9, xref: { document: "cluster", section: "8.11.7.1" } }),
         Field({
             name: "Bake", id: 0x4000,
             details: "This mode sets the device into baking mode for baking food items.",
-            xref: { document: "cluster", section: "8.11.4.1.1" }
+            xref: { document: "cluster", section: "8.11.7.1.1" }
         }),
 
         Field({
             name: "Convection", id: 0x4001,
             details: "This mode sets the device into convection mode which creates an airflow within the device during " +
                 "the cooking duration.",
-            xref: { document: "cluster", section: "8.11.4.1.2" }
+            xref: { document: "cluster", section: "8.11.7.1.2" }
         }),
 
         Field({
             name: "Grill", id: 0x4002,
             details: "This mode sets the device into grill mode for grilling food items. This is the same as Broil for " +
                 "many regions.",
-            xref: { document: "cluster", section: "8.11.4.1.3" }
+            xref: { document: "cluster", section: "8.11.7.1.3" }
         }),
 
         Field({
             name: "Roast", id: 0x4003,
             details: "This mode sets the device into roast mode for roasting food items.",
-            xref: { document: "cluster", section: "8.11.4.1.4" }
+            xref: { document: "cluster", section: "8.11.7.1.4" }
         }),
         Field({
             name: "Clean", id: 0x4004,
             details: "This mode sets the device into cleaning mode to clean the internal components of the appliance.",
-            xref: { document: "cluster", section: "8.11.4.1.5" }
+            xref: { document: "cluster", section: "8.11.7.1.5" }
         }),
-        Field({ name: "ConvectionBake", id: 0x4005, xref: { document: "cluster", section: "8.11.4.1" } }),
-        Field({ name: "ConvectionRoast", id: 0x4006, xref: { document: "cluster", section: "8.11.4.1" } }),
+        Field({ name: "ConvectionBake", id: 0x4005, xref: { document: "cluster", section: "8.11.7.1" } }),
+        Field({ name: "ConvectionRoast", id: 0x4006, xref: { document: "cluster", section: "8.11.7.1" } }),
         Field({
             name: "Warming", id: 0x4007,
             details: "This mode sets the device into a warming mode which begins warming the cavity.",
-            xref: { document: "cluster", section: "8.11.4.1.8" }
+            xref: { document: "cluster", section: "8.11.7.1.8" }
         }),
         Field({
             name: "Proofing", id: 0x4008,
             details: "This mode sets the device into proofing mode which creates an environment ready for proofing.",
-            xref: { document: "cluster", section: "8.11.4.1.9" }
+            xref: { document: "cluster", section: "8.11.7.1.9" }
         }),
-        Field({ name: "Steam", id: 0x4009, xref: { document: "cluster", section: "8.11.4.1" } })
+        Field({ name: "Steam", id: 0x4009, xref: { document: "cluster", section: "8.11.7.1" } })
     )
 );
 

package/src/standard/elements/PowerSource.ts

@@ -20,17 +20,17 @@ export const PowerSource = Cluster(
         name: "PowerSource", id: 0x2f, classification: "node", pics: "PS",
         details: "This cluster is used to describe the configuration and capabilities of a physical power source that " +
             "provides power to one or more endpoints on a node. In case the node has multiple power sources, " +
-            "each is described by its own cluster instance. Each instance of this cluster may be associated with " +
-            "one or more endpoints or the entire node.",
+            "each shall be described by its own cluster instance. Each instance of this cluster may be " +
+            "associated with one or more endpoints or the entire node.",
         xref: { document: "core", section: "11.7" }
     },
 
-    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 2 }),
+    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 3 }),
 
     Attribute(
         { name: "FeatureMap", id: 0xfffc, type: "FeatureMap", xref: { document: "core", section: "11.7.4" } },
-        Field({ name: "WIRED", conformance: "O", constraint: "0", description: "Wired", details: "A wired power source" }),
-        Field({ name: "BAT", conformance: "O", constraint: "1", description: "Battery", details: "A battery power source" }),
+        Field({ name: "WIRED", conformance: "O.a", constraint: "0", description: "Wired", details: "A wired power source" }),
+        Field({ name: "BAT", conformance: "O.a", constraint: "1", description: "Battery", details: "A battery power source" }),
         Field({
             name: "RECHG", conformance: "[BAT]", constraint: "2", description: "Rechargeable",
             details: "A rechargeable battery power source"
@@ -161,19 +161,39 @@ export const PowerSource = Cluster(
 
     Attribute({
         name: "BatPercentRemaining", id: 0xc, type: "uint8", access: "R V", conformance: "[BAT]",
-        constraint: "0 to 200", quality: "X C",
+        constraint: "max 200", quality: "X Q",
+
         details: "Indicates the estimated percentage of battery charge remaining until the battery will no longer be " +
             "able to provide power to the Node. Values are expressed in half percent units, ranging from 0 to " +
             "200. E.g. a value of 48 is equivalent to 24%. A value of NULL shall indicate the Node is currently " +
-            "unable to assess the value.",
+            "unable to assess the value." +
+            "\n" +
+            "Changes to this attribute shall only be marked as reportable in the following cases:" +
+            "\n" +
+            "  • At most once every 10 seconds, or" +
+            "\n" +
+            "  • When it changes from null to any other value and vice versa." +
+            "\n" +
+            "Since reporting consumes power, devices SHOULD be careful not to over-report.",
+
         xref: { document: "core", section: "11.7.7.13" }
     }),
 
     Attribute({
         name: "BatTimeRemaining", id: 0xd, type: "uint32", access: "R V", conformance: "[BAT]",
-        quality: "X C",
+        quality: "X Q",
+
         details: "Indicates the estimated time in seconds before the battery will no longer be able to provide power " +
-            "to the Node. A value of NULL shall indicate the Node is currently unable to assess the value.",
+            "to the Node. A value of NULL shall indicate the Node is currently unable to assess the value." +
+            "\n" +
+            "Changes to this attribute shall only be marked as reportable in the following cases:" +
+            "\n" +
+            "  • At most once every 10 seconds, or" +
+            "\n" +
+            "  • When it changes from null to any other value and vice versa." +
+            "\n" +
+            "Since reporting consumes power, devices SHOULD be careful not to over-report.",
+
         xref: { document: "core", section: "11.7.7.14" }
     }),
 
@@ -218,7 +238,9 @@ export const PowerSource = Cluster(
                 "detects all conditions contributing to a fault have been cleared, the corresponding BatFaultEnum " +
                 "value shall be removed from this list. An empty list shall indicate there are currently no active " +
                 "faults. The order of this list SHOULD have no significance. Clients interested in monitoring " +
-                "changes in active faults may subscribe to this attribute, or they may subscribe to BatFaultChange.",
+                "changes in active faults may subscribe to this attribute, or they may subscribe to Bat" +
+                "\n" +
+                "FaultChange.",
 
             xref: { document: "core", section: "11.7.7.19" }
         },
@@ -290,9 +312,19 @@ export const PowerSource = Cluster(
 
     Attribute({
         name: "BatTimeToFullCharge", id: 0x1b, type: "uint32", access: "R V", conformance: "[RECHG]",
-        quality: "X C",
+        quality: "X Q",
+
         details: "Indicates the estimated time in seconds before the battery source will be at full charge. A value " +
-            "of NULL shall indicate the Node is currently unable to assess the value.",
+            "of NULL shall indicate the Node is currently unable to assess the value." +
+            "\n" +
+            "Changes to this attribute shall only be marked as reportable in the following cases:" +
+            "\n" +
+            "  • At most once every 10 seconds, or" +
+            "\n" +
+            "  • When it changes from null to any other value and vice versa." +
+            "\n" +
+            "Since reporting consumes power, devices SHOULD be careful not to over-report.",
+
         xref: { document: "core", section: "11.7.7.28" }
     }),