Add smoke-co-alarm-cluster.xml

src/app/zap-templates/zcl/data-model/all.xml

@@ -22,8 +22,8 @@
    <xi:include href="chip/diagnostic-logs-cluster.xml" />
    <xi:include href="chip/door-lock-cluster.xml" />
    <xi:include href="chip/ethernet-network-diagnostics-cluster.xml" />
-   <xi:include href="chip/fan-control-cluster.xml" />   
-   <xi:include href="chip/fault-injection-cluster.xml" />   
+   <xi:include href="chip/fan-control-cluster.xml" />
+   <xi:include href="chip/fault-injection-cluster.xml" />
    <xi:include href="chip/fixed-label-cluster.xml" />
    <xi:include href="chip/flow-measurement-cluster.xml" />
    <xi:include href="chip/general-commissioning-cluster.xml" />
@@ -54,6 +54,7 @@
    <xi:include href="chip/pwm-cluster.xml" />
    <xi:include href="chip/relative-humidity-measurement-cluster.xml" />
    <xi:include href="chip/scene.xml" />
+   <xi:include href="chip/smoke-co-alarm-cluster.xml" />
    <xi:include href="chip/software-diagnostics-cluster.xml" />
    <xi:include href="chip/switch-cluster.xml" />
    <xi:include href="chip/target-navigator-cluster.xml" />

src/app/zap-templates/zcl/data-model/chip/smoke-co-alarm-cluster.xml

@@ -0,0 +1,153 @@
+<?xml version="1.0"?>
+<!--
+Copyright (c) 2023 Project CHIP Authors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<configurator>
+  <domain name="CHIP" />
+
+  <cluster>
+    <domain>Closures</domain>
+    <name>Smoke CO Alarm</name>
+    <code>0x005C</code>
+    <define>SMOKE_CO_ALARM_CLUSTER</define>
+    <description>This cluster provides an interface for observing and managing the state of smoke and CO alarms.</description>
+
+    <!-- Abbreviations used in descriptions -->
+    <tag name="SMOKE" description="Smoke Alarm" />
+    <tag name="CO" description="CO Alarm" />
+
+    <client tick="false" init="false">true</client>
+    <server tick="false" init="false">true</server>
+
+    <!-- Current cluster version -->
+    <globalAttribute side="either" code="0xFFFD" value="1" />
+    <!-- Cluster feature map -->
+    <globalAttribute side="server" code="0xFFFC" type="SmokeCOFeature" value="1" />
+
+    <!-- Attributes -->
+    <attribute side="server" code="0x0000" define="EXPRESSED_STATE" type="ExpressedStateEnum" writable="false" optional="false">ExpressedState</attribute>
+    <attribute side="server" code="0x0001" define="SMOKE_STATE" type="AlarmStateEnum" writable="false" optional="true">SmokeState</attribute>
+    <attribute side="server" code="0x0002" define="CO_STATE" type="AlarmStateEnum" writable="false" optional="true">COState</attribute>
+    <attribute side="server" code="0x0003" define="BATTERY_ALERT" type="AlarmStateEnum" writable="false" optional="false">BatteryAlert</attribute>
+    <attribute side="server" code="0x0004" define="DEVICE_MUTED" type="MuteStateEnum" writable="false" optional="true">DeviceMuted</attribute>
+    <attribute side="server" code="0x0005" define="TEST_IN_PROGRESS" type="boolean" writable="false" optional="false">TestInProgress</attribute>
+    <attribute side="server" code="0x0006" define="HARDWARE_FAULTALERT" type="boolean" writable="false" optional="false">HardwareFaultAlert</attribute>
+    <attribute side="server" code="0x0007" define="END_OF_SERVICEALERT" type="EndOfServiceEnum" writable="false" optional="false">EndOfServiceAlert</attribute>
+    <attribute side="server" code="0x0008" define="INTERCONNECT_SMOKE_ALARM" type="AlarmStateEnum" writable="false" optional="true">InterconnectSmokeAlarm</attribute>
+    <attribute side="server" code="0x0009" define="INTERCONNECT_CO_ALARM" type="AlarmStateEnum" writable="false" optional="true">InterconnectCOAlarm</attribute>
+    <attribute side="server" code="0x000A" define="CONTAMINATION_STATE" type="ContaminationStateEnum" writable="false" optional="true">ContaminationState</attribute>
+    <attribute side="server" code="0x000B" define="SENSITIVITY_LEVEL" type="SensitivityEnum" min="0" max="2" writable="true" optional="true">SensitivityLevel</attribute>
+    <!-- TODO: Date type encoding not defined -->
+    <!-- <attribute side="server" code="0x000C" define="EXPIRY_DATE" type="Date" writable="false" optional="true">ExpiryDate</attribute> -->
+
+    <!-- Commands -->
+    <command source="client" code="0x00" name="SelfTestRequest" optional="true">
+      <description>This command SHALL initiate a device self-test.</description>
+    </command>
+
+    <!-- Events -->
+    <event side="server" code="0x00" name="SmokeAlarm" priority="info" optional="true">
+      <description>This event SHALL be generated when SmokeState attribute changes to either Warning or Critical state.</description>
+    </event>
+    <event side="server" code="0x01" name="COAlarm" priority="info" optional="true">
+      <description>This event SHALL be generated when COState attribute changes to either Warning or Critical state.</description>
+    </event>
+    <event side="server" code="0x02" name="LowBattery" priority="info" optional="false">
+      <description>This event SHALL be generated when BatteryAlert attribute changes to either Warning or Critical state.</description>
+    </event>
+    <event side="server" code="0x03" name="HardwareFault" priority="info" optional="false">
+      <description>This event SHALL be generated when the device detects a hardware fault that leads to setting HardwareFaultAlert to True.</description>
+    </event>
+    <event side="server" code="0x04" name="EndOfService" priority="info" optional="false">
+      <description>This event SHALL be generated when the EndOfServiceAlert is set to True.</description>
+    </event>
+    <event side="server" code="0x05" name="SelfTestComplete" priority="info" optional="false">
+      <description>This event SHALL be generated when the SelfTest completes, and the attribute TestInProgress changes to False.</description>
+    </event>
+    <event side="server" code="0x06" name="AlarmMuted" priority="info" optional="true">
+      <description>This event SHALL be generated when the DeviceMuted attribute changes to True.</description>
+    </event>
+    <event side="server" code="0x07" name="MuteEnded" priority="info" optional="true">
+      <description>This event SHALL be generated when DeviceMuted attribute changes to False.</description>
+    </event>
+    <event side="server" code="0x08" name="InterconnectSmokeAlarm" priority="info" optional="true">
+      <description>This event SHALL be generated when the device hosting the cluster receives a remote smoke alarm.</description>
+    </event>
+    <event side="server" code="0x09" name="InterconnectCOAlarm" priority="info" optional="true">
+      <description>This event SHALL be generated when the device hosting the cluster receives a remote CO alarm.</description>
+    </event>
+    <event side="server" code="0x0A" name="AllClear" priority="info" optional="false">
+      <description>This event SHALL be generated when ExpressedState attribute returns to Normal state.</description>
+    </event>
+  </cluster>
+
+  <!-- Cluster data types -->
+  <enum name="AlarmStateEnum" type="ENUM8">
+    <cluster code="0x005C" />
+    <item value="0" name="Unknown" />
+    <item value="1" name="Normal" />
+    <item value="2" name="Warning" />
+    <item value="3" name="Critical" />
+  </enum>
+
+  <enum name="SensitivityEnum" type="ENUM8">
+    <cluster code="0x005C" />
+    <item value="0" name="High" />
+    <item value="1" name="Standard" />
+    <item value="2" name="Low" />
+  </enum>
+
+  <enum name="ExpressedStateEnum" type="ENUM8">
+    <cluster code="0x005C" />
+    <item value="0" name="Normal" />
+    <item value="1" name="SmokeAlarm" />
+    <item value="2" name="COAlarm" />
+    <item value="3" name="BatteryAlert" />
+    <item value="4" name="Testing" />
+    <item value="5" name="HardwareFault" />
+    <item value="6" name="EndOfService" />
+    <item value="7" name="InterconnectSmoke" />
+    <item value="8" name="InterconnectCO" />
+  </enum>
+
+  <enum name="MuteStateEnum" type="ENUM8">
+    <cluster code="0x005C" />
+    <item value="0" name="Unknown" />
+    <item value="1" name="NotMuted" />
+    <item value="2" name="Muted" />
+  </enum>
+
+  <enum name="EndOfServiceEnum" type="ENUM8">
+    <cluster code="0x005C" />
+    <item value="0" name="Unknown" />
+    <item value="1" name="Expired" />
+    <item value="2" name="Normal" />
+  </enum>
+
+  <enum name="ContaminationStateEnum" type="ENUM8">
+    <cluster code="0x005C" />
+    <item value="0" name="Unknown" />
+    <item value="1" name="Normal" />
+    <item value="2" name="Low" />
+    <item value="3" name="Warning" />
+    <item value="4" name="Critical" />
+  </enum>
+
+  <bitmap name="SmokeCOFeature" type="BITMAP32">
+    <cluster code="0x005C" />
+    <field name="SMOKE" mask="0x01" />
+    <field name="CO" mask="0x02" />
+  </bitmap>
+</configurator>

src/app/zap-templates/zcl/zcl-with-test-extensions.json

@@ -72,6 +72,7 @@
         "pwm-cluster.xml",
         "relative-humidity-measurement-cluster.xml",
         "scene.xml",
+        "smoke-co-alarm-cluster.xml",
         "software-diagnostics-cluster.xml",
         "switch-cluster.xml",
         "target-navigator-cluster.xml",

src/app/zap-templates/zcl/zcl.json

@@ -70,6 +70,7 @@
         "pwm-cluster.xml",
         "relative-humidity-measurement-cluster.xml",
         "scene.xml",
+        "smoke-co-alarm-cluster.xml",
         "software-diagnostics-cluster.xml",
         "switch-cluster.xml",
         "target-navigator-cluster.xml",

src/app/zap_cluster_list.json

@@ -67,6 +67,7 @@
         "PWM_CLUSTER": [],
         "RELATIVE_HUMIDITY_MEASUREMENT_CLUSTER": [],
         "SCENES_CLUSTER": [],
+        "SMOKE_CO_ALARM_CLUSTER": [],
         "SOFTWARE_DIAGNOSTICS_CLUSTER": [],
         "SWITCH_CLUSTER": [],
         "TARGET_NAVIGATOR_CLUSTER": [],
@@ -164,6 +165,7 @@
         "PWM_CLUSTER": [],
         "RELATIVE_HUMIDITY_MEASUREMENT_CLUSTER": [],
         "SCENES_CLUSTER": ["scenes"],
+        "SMOKE_CO_ALARM_CLUSTER": [],
         "SOFTWARE_DIAGNOSTICS_CLUSTER": ["software-diagnostics-server"],
         "SWITCH_CLUSTER": ["switch-server"],
         "TARGET_NAVIGATOR_CLUSTER": ["target-navigator-server"],

src/controller/data_model/BUILD.gn

@@ -174,6 +174,8 @@ if (current_os == "android" || build_java_matter_controller) {
       "jni/ElectricalMeasurementClient-InvokeSubscribeImpl.cpp",
       "jni/UnitTestingClient-ReadImpl.cpp",
       "jni/UnitTestingClient-InvokeSubscribeImpl.cpp",
+      "jni/SmokeCoAlarmClient-ReadImpl.cpp",
+      "jni/SmokeCoAlarmClient-InvokeSubscribeImpl.cpp",
 
       # Disable CM cluster table tests until update is done
       # https://github.com/project-chip/connectedhomeip/issues/24425

src/controller/data_model/controller-clusters.matter

@@ -2536,6 +2536,114 @@ client cluster ModeSelect = 80 {
   command ChangeToMode(ChangeToModeRequest): DefaultSuccess = 0;
 }
 
+/** This cluster provides an interface for observing and managing the state of smoke and CO alarms. */
+client cluster SmokeCoAlarm = 92 {
+  enum AlarmStateEnum : ENUM8 {
+    kUnknown = 0;
+    kNormal = 1;
+    kWarning = 2;
+    kCritical = 3;
+  }
+
+  enum ContaminationStateEnum : ENUM8 {
+    kUnknown = 0;
+    kNormal = 1;
+    kLow = 2;
+    kWarning = 3;
+    kCritical = 4;
+  }
+
+  enum EndOfServiceEnum : ENUM8 {
+    kUnknown = 0;
+    kExpired = 1;
+    kNormal = 2;
+  }
+
+  enum ExpressedStateEnum : ENUM8 {
+    kNormal = 0;
+    kSmokeAlarm = 1;
+    kCOAlarm = 2;
+    kBatteryAlert = 3;
+    kTesting = 4;
+    kHardwareFault = 5;
+    kEndOfService = 6;
+    kInterconnectSmoke = 7;
+    kInterconnectCO = 8;
+  }
+
+  enum MuteStateEnum : ENUM8 {
+    kUnknown = 0;
+    kNotMuted = 1;
+    kMuted = 2;
+  }
+
+  enum SensitivityEnum : ENUM8 {
+    kHigh = 0;
+    kStandard = 1;
+    kLow = 2;
+  }
+
+  bitmap SmokeCOFeature : BITMAP32 {
+    kSmoke = 0x1;
+    kCo = 0x2;
+  }
+
+  info event SmokeAlarm = 0 {
+  }
+
+  info event COAlarm = 1 {
+  }
+
+  info event LowBattery = 2 {
+  }
+
+  info event HardwareFault = 3 {
+  }
+
+  info event EndOfService = 4 {
+  }
+
+  info event SelfTestComplete = 5 {
+  }
+
+  info event AlarmMuted = 6 {
+  }
+
+  info event MuteEnded = 7 {
+  }
+
+  info event InterconnectSmokeAlarm = 8 {
+  }
+
+  info event InterconnectCOAlarm = 9 {
+  }
+
+  info event AllClear = 10 {
+  }
+
+  readonly attribute ExpressedStateEnum expressedState = 0;
+  readonly attribute optional AlarmStateEnum smokeState = 1;
+  readonly attribute optional AlarmStateEnum COState = 2;
+  readonly attribute AlarmStateEnum batteryAlert = 3;
+  readonly attribute optional MuteStateEnum deviceMuted = 4;
+  readonly attribute boolean testInProgress = 5;
+  readonly attribute boolean hardwareFaultAlert = 6;
+  readonly attribute EndOfServiceEnum endOfServiceAlert = 7;
+  readonly attribute optional AlarmStateEnum interconnectSmokeAlarm = 8;
+  readonly attribute optional AlarmStateEnum interconnectCOAlarm = 9;
+  readonly attribute optional ContaminationStateEnum contaminationState = 10;
+  attribute optional SensitivityEnum sensitivityLevel = 11;
+  readonly attribute command_id generatedCommandList[] = 65528;
+  readonly attribute command_id acceptedCommandList[] = 65529;
+  readonly attribute event_id eventList[] = 65530;
+  readonly attribute attrib_id attributeList[] = 65531;
+  readonly attribute bitmap32 featureMap = 65532;
+  readonly attribute int16u clusterRevision = 65533;
+
+  /** This command SHALL initiate a device self-test. */
+  command SelfTestRequest(): DefaultSuccess = 0;
+}
+
 /** An interface to a generic way to secure a door */
 client cluster DoorLock = 257 {
   enum AlarmCodeEnum : ENUM8 {
@@ -5454,6 +5562,7 @@ endpoint 1 {
   binding cluster UserLabel;
   binding cluster BooleanState;
   binding cluster ModeSelect;
+  binding cluster SmokeCoAlarm;
   binding cluster DoorLock;
   binding cluster WindowCovering;
   binding cluster BarrierControl;