@matter/model 0.13.0-alpha.0-20250304-d4a7592a4 → 0.13.0-alpha.0-20250311-3eb0af5f2

package/src/standard/elements/DoorLockControllerDT.ts

@@ -24,7 +24,7 @@ export const DoorLockControllerDt = DeviceType(
         xref: { document: "device", section: "8.2.4" }
     }),
     Requirement({
-        name: "ScenesManagement", id: 0x5, conformance: "P, O", element: "clientCluster",
+        name: "ScenesManagement", id: 0x62, conformance: "P, O", element: "clientCluster",
         xref: { document: "device", section: "8.2.4" }
     }),
     Requirement({

package/src/standard/elements/DoorLockDT.ts

@@ -30,7 +30,7 @@ export const DoorLockDt = DeviceType(
         xref: { document: "device", section: "8.1.4" }
     }),
     Requirement({
-        name: "ScenesManagement", id: 0x5, conformance: "X", element: "serverCluster",
+        name: "ScenesManagement", id: 0x62, conformance: "X", element: "serverCluster",
         xref: { document: "device", section: "8.1.4" }
     }),
 
@@ -39,7 +39,7 @@ export const DoorLockDt = DeviceType(
             name: "DoorLock", id: 0x101, conformance: "M", element: "serverCluster",
             xref: { document: "device", section: "8.1.4" }
         },
-        Requirement({ name: "USER", conformance: "Matter & (PIN | RID | FPG | FACE)", element: "feature" }),
+        Requirement({ name: "USER", conformance: "Matter & (PIN | RID | FPG | FACE | ALIRO)", element: "feature" }),
         Requirement({ name: "RFIDCREDENTIAL", conformance: "P, O", element: "feature" }),
         Requirement({ name: "AlarmMask", conformance: "[Alarms]", element: "attribute" })
     )

package/src/standard/elements/EcosystemInformation.ts

@@ -0,0 +1,191 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { MatterDefinition } from "../MatterDefinition.js";
+import {
+    ClusterElement as Cluster,
+    AttributeElement as Attribute,
+    DatatypeElement as Datatype,
+    FieldElement as Field
+} from "../../elements/index.js";
+
+export const EcosystemInformation = Cluster(
+    {
+        name: "EcosystemInformation", id: 0x750, classification: "endpoint", pics: "ECOINFO",
+
+        details: "The Ecosystem Information Cluster provides extended device information for all the logical devices " +
+            "represented by a Bridged Node. The Ecosystem Information Cluster presents the view of device name " +
+            "and location metadata for presentation by a client of the cluster to a user. This cluster is " +
+            "intended to support Fabric Synchronization and be present on an endpoint with the BridgedNode " +
+            "device type listed in the DeviceTypeList of the endpoint’s Descriptor cluster." +
+            "\n" +
+            "This augments the Bridged Device Basic Information Cluster in the following ways:" +
+            "\n" +
+            "  • The Ecosystem Information Cluster adds support for providing a name and location for individual " +
+            "    endpoints. (The endpoints do not need to be present on the Bridge for their name and location " +
+            "    information to be present.)" +
+            "\n" +
+            "  • The Ecosystem Information Cluster adds metadata to support conflict resolution between multiple " +
+            "    sources of the name and location data." +
+            "\n" +
+            "  • The Ecosystem Information Cluster supports user control for the presence of the name and " +
+            "    location information by specifying more restricted access." +
+            "\n" +
+            "A client SHOULD use the information provided by the Ecosystem Information Cluster to help the user " +
+            "organize and interact with their devices. Some examples may include:" +
+            "\n" +
+            "  • Directly organizing and labeling the devices in a client’s user interface." +
+            "\n" +
+            "  • Providing hints in the user interface, which can assist the user in organizing and labeling " +
+            "    their devices." +
+            "\n" +
+            "For the purposes of the Ecosystem Information Cluster section, an instance of the Ecosystem " +
+            "Information Cluster will be referred to as an \"instance\".",
+
+        xref: { document: "core", section: "9.18" }
+    },
+
+    Attribute({ name: "ClusterRevision", id: 0xfffd, type: "ClusterRevision", default: 1 }),
+
+    Datatype(
+        { name: "EcosystemDeviceStruct", type: "struct", xref: { document: "core", section: "9.18.4.1" } },
+
+        Field({
+            name: "DeviceName", id: 0x0, type: "string", access: "S", conformance: "O", constraint: "max 64",
+            details: "This field shall indicate the device’s name, which is provided externally if the user consents. " +
+                "(For example, provided by the user in an ecosystem specific interface.)",
+            xref: { document: "core", section: "9.18.4.1.1" }
+        }),
+
+        Field({
+            name: "DeviceNameLastEdit", id: 0x1, type: "epoch-us", access: "S", conformance: "desc", default: 0,
+            details: "This field shall be present and set if the DeviceName field is present." +
+                "\n" +
+                "This field shall indicate the timestamp of when the DeviceName was last modified.",
+            xref: { document: "core", section: "9.18.4.1.2" }
+        }),
+
+        Field({
+            name: "BridgedEndpoint", id: 0x2, type: "endpoint-no", access: "S", conformance: "desc",
+            constraint: "desc",
+            details: "This field shall indicate the endpoint this EcosystemDeviceStruct is associated with on this Bridge." +
+                "\n" +
+                "This field shall be present and set to a valid endpoint if the device is accessible through the " +
+                "bridge.",
+            xref: { document: "core", section: "9.18.4.1.3" }
+        }),
+
+        Field({
+            name: "OriginalEndpoint", id: 0x3, type: "endpoint-no", access: "S", conformance: "desc",
+            constraint: "desc",
+            details: "This field shall indicate the endpoint this EcosystemDeviceStruct is associated with on the " +
+                "original device represented by this bridge’s Bridged Node. If this bridge is receiving the device " +
+                "from another bridge, then the OriginalEndpoint field value would be the same on both bridges. This " +
+                "field shall be present and set to a valid endpoint on the original device if that device is a " +
+                "Matter device.",
+            xref: { document: "core", section: "9.18.4.1.4" }
+        }),
+
+        Field(
+            {
+                name: "DeviceTypes", id: 0x4, type: "list", access: "S", conformance: "M", constraint: "desc",
+                details: "This field shall indicate all of the DeviceTypes within the DeviceTypeList in the Descriptor " +
+                    "Cluster associated with this EcosystemDeviceStruct entry." +
+                    "\n" +
+                    "This field shall contain a list of valid device type ids.",
+                xref: { document: "core", section: "9.18.4.1.5" }
+            },
+
+            Field({ name: "entry", type: "Descriptor.DeviceTypeStruct" })
+        ),
+
+        Field(
+            {
+                name: "UniqueLocationIDs", id: 0x5, type: "list", access: "S", conformance: "M",
+                constraint: "max 64[max 64]",
+                details: "This field shall specify the EcosystemLocationStruct entries in the LocationDirectory attribute " +
+                    "associated with this EcosystemDeviceStruct.",
+                xref: { document: "core", section: "9.18.4.1.6" }
+            },
+
+            Field({ name: "entry", type: "string" })
+        ),
+
+        Field({
+            name: "UniqueLocationIDsLastEdit", id: 0x6, type: "epoch-us", access: "S", conformance: "M",
+            default: 0,
+
+            details: "This field shall indicate the timestamp of when the UniqueLocationIDs was last modified." +
+                "\n" +
+                "NOTE" +
+                "\n" +
+                "If multiple server instances update the UniqueLocationIDs field at the same time, it is possible " +
+                "one of the updates will be missed. This is considered an acceptable limitation to reduce the " +
+                "complexity of the design. Since this is meant to be provided from user input, it is unlikely these " +
+                "signals would be happening at one time.",
+
+            xref: { document: "core", section: "9.18.4.1.7" }
+        }),
+
+        Field({ name: "FabricIndex", id: 0xfe, type: "FabricIndex" })
+    ),
+
+    Datatype(
+        { name: "EcosystemLocationStruct", type: "struct", xref: { document: "core", section: "9.18.4.2" } },
+
+        Field({
+            name: "UniqueLocationId", id: 0x0, type: "string", access: "S", conformance: "M",
+            constraint: "max 64",
+
+            details: "This field shall indicate a unique identifier for a specific Ecosystem Information Cluster server " +
+                "instance representing the location independent of its LocationDescriptor field." +
+                "\n" +
+                "UniqueLocationID can be used by the client to determine if the change is a relocation of the device " +
+                "or just a renaming of the location." +
+                "\n" +
+                "No guarantees are given for consistency of the ID between server instances. The same location may " +
+                "be represented by different IDs on different Ecosystem Information Cluster server instances, so " +
+                "only the history from a single server instance should be considered when evaluating a change." +
+                "\n" +
+                "UniqueLocationID shall be changed when the LocationDescriptor changes from one existing location to " +
+                "another location as a result of an external interaction. (For example, the user changes the " +
+                "location assignment.)" +
+                "\n" +
+                "UniqueLocationID shall NOT be changed when the LocationDescriptor changes name, but still " +
+                "represents the same location. (For example, the user renames a room.)" +
+                "\n" +
+                "UniqueLocationID shall be changed when LocationDescriptor changes as a result of another Ecosystem " +
+                "Information Cluster server instance changing and the UniqueLocationID on the remote server instance " +
+                "also changes." +
+                "\n" +
+                "UniqueLocationID shall NOT be changed when LocationDescriptor changes as a result of another " +
+                "Ecosystem Information Cluster server instance changing and the UniqueLocationID on the remote " +
+                "server instance does not change.",
+
+            xref: { document: "core", section: "9.18.4.2.1" }
+        }),
+
+        Field({
+            name: "LocationDescriptor", id: 0x1, type: "locationdesc", access: "S", conformance: "M",
+
+            details: "This field shall indicate the location (e.g. living room, driveway) and associated metadata that is " +
+                "provided externally if the user consents. (For example, provided by the user in an ecosystem " +
+                "specific interface.)" +
+                "\n" +
+                "\"Location\" in this context is typically used by the user’s grouping into rooms, areas or other " +
+                "logical groupings of how devices are used. So a device might be part of multiple such \"Locations\"s.",
+
+            xref: { document: "core", section: "9.18.4.2.2" }
+        }),
+
+        Field({ name: "LocationDescriptorLastEdit", id: 0x2, type: "epoch-us", access: "S", conformance: "M", default: 0 }),
+        Field({ name: "FabricIndex", id: 0xfe, type: "FabricIndex" })
+    )
+);
+
+MatterDefinition.children.push(EcosystemInformation);

package/src/standard/elements/ElectricalEnergyMeasurement.ts

@@ -157,7 +157,7 @@ export const ElectricalEnergyMeasurement = Cluster(
 
     Event(
         {
-            name: "CumulativeEnergyMeasured", id: 0x0, access: "R V", conformance: "CUME", priority: "info",
+            name: "CumulativeEnergyMeasured", id: 0x0, access: "V", conformance: "CUME", priority: "info",
             details: "This event shall be generated when the server takes a snapshot of the cumulative energy imported by " +
                 "the server, exported from the server, or both, but not more frequently than the rate mentioned in " +
                 "the description above of the related attribute.",
@@ -181,7 +181,7 @@ export const ElectricalEnergyMeasurement = Cluster(
 
     Event(
         {
-            name: "PeriodicEnergyMeasured", id: 0x1, access: "R V", conformance: "PERE", priority: "info",
+            name: "PeriodicEnergyMeasured", id: 0x1, access: "V", conformance: "PERE", priority: "info",
             details: "This event shall be generated when the server reaches the end of a reporting period for imported " +
                 "energy, exported energy, or both.",
             xref: { document: "cluster", section: "2.12.7.2" }
@@ -220,7 +220,7 @@ export const ElectricalEnergyMeasurement = Cluster(
         },
 
         Field({
-            name: "Energy", id: 0x0, type: "energy-mWh", access: "R V", conformance: "M", constraint: "min 0",
+            name: "Energy", id: 0x0, type: "energy-mWh", conformance: "M", constraint: "min 0",
 
             details: "This field shall be the reported energy." +
                 "\n" +
@@ -236,7 +236,7 @@ export const ElectricalEnergyMeasurement = Cluster(
         }),
 
         Field({
-            name: "StartTimestamp", id: 0x1, type: "epoch-s", access: "R V", conformance: "desc",
+            name: "StartTimestamp", id: 0x1, type: "epoch-s", conformance: "desc",
 
             details: "This field shall indicate the timestamp in UTC of the beginning of the period during which the " +
                 "value of the Energy field was measured." +
@@ -254,8 +254,8 @@ export const ElectricalEnergyMeasurement = Cluster(
         }),
 
         Field({
-            name: "EndTimestamp", id: 0x2, type: "epoch-s", access: "R V", conformance: "desc",
-            constraint: "min startTimestamp1",
+            name: "EndTimestamp", id: 0x2, type: "epoch-s", conformance: "desc",
+            constraint: "min startTimestamp + 1",
 
             details: "This field shall indicate the timestamp in UTC of the end of the period during which the value of " +
                 "the Energy field was measured." +
@@ -270,37 +270,37 @@ export const ElectricalEnergyMeasurement = Cluster(
         }),
 
         Field({
-            name: "StartSystime", id: 0x3, type: "systime-ms", access: "R V", conformance: "desc",
+            name: "StartSystime", id: 0x3, type: "systime-ms", conformance: "desc",
 
-            details: "This field shall indicate the seconds since boot at the beginning of the period during which the " +
-                "value of the Energy field was measured." +
+            details: "This field shall indicate the time elapsed since boot at the beginning of the period during which " +
+                "the value of the Energy field was measured." +
                 "\n" +
-                "If this EnergyMeasurementStruct represents cumulative energy, this field shall be omitted." +
+                "If this EnergyMeasurementStruct represents cumulative energy, this field shall be omitted. " +
+                "Otherwise, if the server had not yet determined the time in UTC at the start of the measurement" +
                 "\n" +
-                "Otherwise, if the server had not yet determined the time in UTC at the start of the measurement " +
                 "period, or does not have the capability of determining the time in UTC, this field shall be " +
                 "indicated." +
                 "\n" +
                 "Otherwise, if the server had determined the time in UTC at or before the beginning of the " +
-                "measurement period, this field may be omitted; if it is indicated, its value shall be the seconds " +
-                "since boot at the UTC time indicated in StartTimestamp.",
+                "measurement period, this field may be omitted; if it is indicated, its value shall be the time " +
+                "elapsed since boot at the UTC time indicated in StartTimestamp.",
 
             xref: { document: "cluster", section: "2.12.5.1.4" }
         }),
 
         Field({
-            name: "EndSystime", id: 0x4, type: "systime-ms", access: "R V", conformance: "desc",
-            constraint: "min startSystime1",
+            name: "EndSystime", id: 0x4, type: "systime-ms", conformance: "desc",
+            constraint: "min startSystime + 1",
 
-            details: "This field shall indicate the seconds since boot at the end of the period during which the value of " +
-                "the Energy field was measured." +
+            details: "This field shall indicate the time elapsed since boot at the end of the period during which the " +
+                "value of the Energy field was measured." +
                 "\n" +
                 "If the server had not yet determined the time in UTC by the end of the measurement period, or does " +
                 "not have the capability of determining the time in UTC, this field shall be indicated." +
                 "\n" +
                 "Otherwise, if the server had determined the time in UTC by the end of the measurement period, this " +
-                "field may be omitted; if it is indicated, its value shall be the seconds since boot at the UTC time " +
-                "indicated in EndTimestamp.",
+                "field may be omitted; if it is indicated, its value shall be the time elapsed since boot at the UTC " +
+                "time indicated in EndTimestamp.",
 
             xref: { document: "cluster", section: "2.12.5.1.5" }
         })
@@ -315,8 +315,8 @@ export const ElectricalEnergyMeasurement = Cluster(
         },
 
         Field({
-            name: "ImportedResetTimestamp", id: 0x0, type: "epoch-s", access: "R V", conformance: "[IMPE]",
-            default: null, quality: "X",
+            name: "ImportedResetTimestamp", id: 0x0, type: "epoch-s", conformance: "[IMPE]", default: null,
+            quality: "X",
 
             details: "This field shall indicate the timestamp in UTC when the value of the Energy field on the " +
                 "CumulativeEnergyImported attribute was most recently zero." +
@@ -335,15 +335,14 @@ export const ElectricalEnergyMeasurement = Cluster(
         }),
 
         Field({
-            name: "ExportedResetTimestamp", id: 0x1, type: "epoch-s", access: "R V", conformance: "[EXPE]",
-            default: null, quality: "X",
+            name: "ExportedResetTimestamp", id: 0x1, type: "epoch-s", conformance: "[EXPE]", default: null,
+            quality: "X",
 
             details: "This field shall indicate the timestamp in UTC when the value of the Energy field on the " +
                 "CumulativeEnergyExported attribute was most recently zero." +
                 "\n" +
-                "If the server had determined the time in UTC when the value of the Energy field on the Cumula" +
-                "\n" +
-                "tiveEnergyExported attribute was most recently zero, this field shall be indicated." +
+                "If the server had determined the time in UTC when the value of the Energy field on the " +
+                "CumulativeEnergyExported attribute was most recently zero, this field shall be indicated." +
                 "\n" +
                 "Otherwise, if the server had not yet determined the time in UTC when the value of the Energy field " +
                 "on the CumulativeEnergyExported attribute was most recently zero, or does not have the capability " +
@@ -356,10 +355,10 @@ export const ElectricalEnergyMeasurement = Cluster(
         }),
 
         Field({
-            name: "ImportedResetSystime", id: 0x2, type: "systime-ms", access: "R V", conformance: "[IMPE]",
-            default: null, quality: "X",
+            name: "ImportedResetSystime", id: 0x2, type: "systime-ms", conformance: "[IMPE]", default: null,
+            quality: "X",
 
-            details: "This field shall indicate the seconds since boot when the value of the Energy field on the " +
+            details: "This field shall indicate the time elapsed since boot when the value of the Energy field on the " +
                 "CumulativeEnergyImported attribute was most recently zero." +
                 "\n" +
                 "If the server had not yet determined the time in UTC when the value of the Energy field on the " +
@@ -368,17 +367,17 @@ export const ElectricalEnergyMeasurement = Cluster(
                 "\n" +
                 "Otherwise, if the server had determined the time in UTC when the value of the Energy field on the " +
                 "CumulativeEnergyImported attribute was most recently zero, this field may be omitted; if it is " +
-                "indicated, its value shall be the seconds since boot at the UTC time indicated in " +
+                "indicated, its value shall be the time elapsed since boot at the UTC time indicated in " +
                 "ImportedResetTimestamp.",
 
             xref: { document: "cluster", section: "2.12.5.2.3" }
         }),
 
         Field({
-            name: "ExportedResetSystime", id: 0x3, type: "systime-ms", access: "R V", conformance: "[EXPE]",
-            default: null, quality: "X",
+            name: "ExportedResetSystime", id: 0x3, type: "systime-ms", conformance: "[EXPE]", default: null,
+            quality: "X",
 
-            details: "This field shall indicate the seconds since boot when the value of the Energy field on the " +
+            details: "This field shall indicate the time elapsed since boot when the value of the Energy field on the " +
                 "CumulativeEnergyExported attribute was most recently zero." +
                 "\n" +
                 "If the server had not yet determined the time in UTC when the value of the Energy field on the " +
@@ -387,7 +386,7 @@ export const ElectricalEnergyMeasurement = Cluster(
                 "\n" +
                 "Otherwise, if the server had determined the time in UTC when the value of the Energy field on the " +
                 "CumulativeEnergyExported attribute was most recently zero, this field may be omitted; if it is " +
-                "indicated, its value shall be the seconds since boot at the UTC time indicated in " +
+                "indicated, its value shall be the time elapsed since boot at the UTC time indicated in " +
                 "ImportedResetTimestamp.",
 
             xref: { document: "cluster", section: "2.12.5.2.4" }

package/src/standard/elements/ElectricalMeasurementNS.ts

@@ -17,7 +17,7 @@ export const ElectricalMeasurementNs = SemanticNamespace(
         name: "ElectricalMeasurement", id: 0xa,
         details: "The tags contained in this namespace are restricted for use in the electrical measurement domain " +
             "and shall NOT be used in any other domain or context.",
-        xref: { document: "namespace", section: "10" }
+        xref: { document: "namespace", section: "12" }
     },
 
     SemanticTag({ name: "DC", id: 0x0, description: "Indicates values measured for a DC load" }),

package/src/standard/elements/ElectricalPowerMeasurement.ts

@@ -443,7 +443,7 @@ export const ElectricalPowerMeasurement = Cluster(
 
     Event(
         {
-            name: "MeasurementPeriodRanges", id: 0x0, access: "R V", conformance: "Ranges", priority: "info",
+            name: "MeasurementPeriodRanges", id: 0x0, access: "V", conformance: "Ranges", priority: "info",
             details: "If supported, this event shall be generated at the end of a measurement period. The start and end " +
                 "times for measurement periods shall be determined by the server, and may represent overlapping " +
                 "periods.",
@@ -518,7 +518,7 @@ export const ElectricalPowerMeasurement = Cluster(
 
         Field({
             name: "EndTimestamp", id: 0x4, type: "epoch-s", conformance: "desc",
-            constraint: "min startTimestamp1",
+            constraint: "min startTimestamp + 1",
             details: "This field shall be the timestamp in UTC of the end of the measurement period." +
                 "\n" +
                 "If the server had not yet determined the time in UTC at or before the beginning of the measurement " +
@@ -537,7 +537,7 @@ export const ElectricalPowerMeasurement = Cluster(
 
         Field({
             name: "MaxTimestamp", id: 0x6, type: "epoch-s", conformance: "EndTimestamp",
-            constraint: "min minTimestamp1",
+            constraint: "min minTimestamp + 1",
             details: "This field shall be the most recent timestamp in UTC of the value in the Max field. This field " +
                 "shall be greater than or equal to the value of the StartTimestamp field. This field shall be less " +
                 "than or equal to the value of the EndTimestamp field.",
@@ -555,7 +555,7 @@ export const ElectricalPowerMeasurement = Cluster(
 
         Field({
             name: "EndSystime", id: 0x8, type: "systime-ms", conformance: "desc",
-            constraint: "min startSystime1",
+            constraint: "min startSystime + 1",
             details: "This field shall be the time since boot of the end of the measurement period." +
                 "\n" +
                 "If the server had determined the time in UTC at the end of the measurement period, this field may " +
@@ -574,7 +574,7 @@ export const ElectricalPowerMeasurement = Cluster(
 
         Field({
             name: "MaxSystime", id: 0xa, type: "systime-ms", conformance: "EndSystime",
-            constraint: "min minSystime1",
+            constraint: "min minSystime + 1",
             details: "This field shall be the measurement time since boot of the value in the Max field. This field shall " +
                 "be greater than or equal to the value of the StartSystime field." +
                 "\n" +