Matter TemperatureNumber feature from TemperatureControl cluster

homeassistant/components/matter/climate.py

@@ -157,6 +157,7 @@
 SystemModeEnum = clusters.Thermostat.Enums.SystemModeEnum
 ControlSequenceEnum = clusters.Thermostat.Enums.ControlSequenceOfOperationEnum
 ThermostatFeature = clusters.Thermostat.Bitmaps.Feature
+TemperatureControlFeature = clusters.TemperatureControl.Bitmaps.Feature
 
 
 class ThermostatRunningState(IntEnum):
@@ -420,6 +421,91 @@ def _get_temperature_in_degrees(
         return None
 
 
+class MatterTemperatureControlClimate(MatterEntity, ClimateEntity):
+    """Representation of a climate entity from the Matter TemperatureControl cluster."""
+
+    _attr_temperature_unit: str = UnitOfTemperature.CELSIUS
+    _attr_hvac_mode: HVACMode = HVACMode.HEAT_COOL
+    _attr_hvac_modes: list[HVACMode] = [HVACMode.HEAT_COOL]
+    _attr_target_temperature_step: float | None
+    _feature_map: int | None = None
+
+    _platform_translation_key = "thermostat"
+
+    async def async_set_temperature(self, **kwargs: Any) -> None:
+        """Set new target temperature."""
+        target_hvac_mode: HVACMode | None = kwargs.get(ATTR_HVAC_MODE)
+        target_temperature: float | None = kwargs.get(ATTR_TEMPERATURE)
+
+        if target_hvac_mode is not None:
+            await self.async_set_hvac_mode(target_hvac_mode)
+
+        if target_temperature is not None:
+            # single setpoint control
+            if self.target_temperature != target_temperature:
+                await self.matter_client.send_device_command(
+                    node_id=self._endpoint.node.node_id,
+                    endpoint_id=self._endpoint.endpoint_id,
+                    command=clusters.TemperatureControl.Commands.SetTemperature(
+                        targetTemperature=int(
+                            target_temperature * TEMPERATURE_SCALING_FACTOR
+                        )
+                    ),
+                )
+            return
+
+    @callback
+    def _update_from_device(self) -> None:
+        """Update from device."""
+        self._calculate_features()
+        self._attr_hvac_action = None
+        # update target_temperature
+        self._attr_target_temperature = self._get_temperature_in_degrees(
+            clusters.TemperatureControl.Attributes.TemperatureSetpoint
+        )
+        # update min_temp
+        attribute = clusters.TemperatureControl.Attributes.MinTemperature
+        if (value := self._get_temperature_in_degrees(attribute)) is not None:
+            self._attr_min_temp = value
+        # update max_temp
+        attribute = clusters.TemperatureControl.Attributes.MaxTemperature
+        if (value := self._get_temperature_in_degrees(attribute)) is not None:
+            self._attr_max_temp = value
+
+    @callback
+    def _calculate_features(
+        self,
+    ) -> None:
+        """Calculate features for HA Thermostat platform from Matter FeatureMap."""
+        feature_map = int(
+            self.get_matter_attribute_value(
+                clusters.TemperatureControl.Attributes.FeatureMap
+            )
+        )
+        # NOTE: the featuremap can dynamically change, so we need to update the
+        # supported features if the featuremap changes.
+        # work out supported features and presets from matter featuremap
+        if self._feature_map == feature_map:
+            return
+        self._feature_map = feature_map
+        self._attr_hvac_modes: list[HVACMode] = [HVACMode.HEAT_COOL]
+        if feature_map & TemperatureControlFeature.kTemperatureNumber:
+            self._attr_supported_features = ClimateEntityFeature.TARGET_TEMPERATURE
+        if feature_map & TemperatureControlFeature.kTemperatureStep:
+            self._attr_target_temperature_step = self._get_temperature_in_degrees(
+                clusters.TemperatureControl.Attributes.Step
+            )
+
+    @callback
+    def _get_temperature_in_degrees(
+        self, attribute: type[clusters.ClusterAttributeDescriptor]
+    ) -> float | None:
+        """Return the scaled temperature value for the given attribute."""
+        if value := self.get_matter_attribute_value(attribute):
+            return float(value) / TEMPERATURE_SCALING_FACTOR
+        return None
+
+
 # Discovery schema(s) to map Matter Attributes to HA entities
 DISCOVERY_SCHEMAS = [
     MatterDiscoverySchema(
@@ -446,4 +532,19 @@ def _get_temperature_in_degrees(
         ),
         device_type=(device_types.Thermostat, device_types.RoomAirConditioner),
     ),
+    MatterDiscoverySchema(
+        platform=Platform.CLIMATE,
+        entity_description=ClimateEntityDescription(
+            key="MatterTemperatureControl",
+            name=None,
+        ),
+        entity_class=MatterTemperatureControlClimate,
+        required_attributes=(
+            clusters.TemperatureControl.Attributes.TemperatureSetpoint,
+            clusters.TemperatureControl.Attributes.FeatureMap,
+            clusters.TemperatureControl.Attributes.MinTemperature,
+            clusters.TemperatureControl.Attributes.MaxTemperature,
+        ),
+        optional_attributes=(clusters.TemperatureControl.Attributes.Step,),
+    ),
 ]

tests/components/matter/conftest.py

@@ -105,6 +105,7 @@ async def integration_fixture(
         "room_airconditioner",
         "silabs_dishwasher",
         "silabs_laundrywasher",
+        "silabs_refrigerator",
         "smoke_detector",
         "switch_unit",
         "temperature_sensor",