jeans/core
jeans/core
1
0
Fork 0
mirror of https://github.com/home-assistant/core.git synced 2025-07-27 15:17:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Matter Device Energy Management cluster ESAState attribute (#144430)

Browse Source 
* ESAState

* Update strings.json

* Add test
This commit is contained in:
Ludovic BOUÉ 2025-05-22 12:53:08 +02:00 committed by GitHub
parent 569aeff054
commit 9e6de48a22
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
4 changed files with 169 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
homeassistant/components/matter/sensor.py
View File

@ -83,6 +83,14 @@ BOOST_STATE_MAP = {
clusters.WaterHeaterManagement.Enums.BoostStateEnum.kUnknownEnumValue: None, clusters.WaterHeaterManagement.Enums.BoostStateEnum.kUnknownEnumValue: None,
} }
ESA_STATE_MAP = {
clusters.DeviceEnergyManagement.Enums.ESAStateEnum.kOffline: "offline",
clusters.DeviceEnergyManagement.Enums.ESAStateEnum.kOnline: "online",
clusters.DeviceEnergyManagement.Enums.ESAStateEnum.kFault: "fault",
clusters.DeviceEnergyManagement.Enums.ESAStateEnum.kPowerAdjustActive: "power_adjust_active",
clusters.DeviceEnergyManagement.Enums.ESAStateEnum.kPaused: "paused",
}
EVSE_FAULT_STATE_MAP = { EVSE_FAULT_STATE_MAP = {
clusters.EnergyEvse.Enums.FaultStateEnum.kNoError: "no_error", clusters.EnergyEvse.Enums.FaultStateEnum.kNoError: "no_error",
clusters.EnergyEvse.Enums.FaultStateEnum.kMeterFailure: "meter_failure", clusters.EnergyEvse.Enums.FaultStateEnum.kMeterFailure: "meter_failure",
@ -1097,4 +1105,17 @@ DISCOVERY_SCHEMAS = [
clusters.WaterHeaterManagement.Attributes.EstimatedHeatRequired, clusters.WaterHeaterManagement.Attributes.EstimatedHeatRequired,
), ),
), ),
MatterDiscoverySchema(
platform=Platform.SENSOR,
entity_description=MatterSensorEntityDescription(
key="ESAState",
translation_key="esa_state",
device_class=SensorDeviceClass.ENUM,
entity_category=EntityCategory.DIAGNOSTIC,
options=list(ESA_STATE_MAP.values()),
measurement_to_ha=ESA_STATE_MAP.get,
),
entity_class=MatterSensor,
required_attributes=(clusters.DeviceEnergyManagement.Attributes.ESAState,),
),
] ]

10
homeassistant/components/matter/strings.json
View File

@ -321,6 +321,16 @@
"energy_exported": { "energy_exported": {
"name": "Energy exported" "name": "Energy exported"
}, },
"esa_state": {
"name": "Appliance energy state",
"state": {
"offline": "Offline",
"online": "Online",
"fault": "[%key:common::state::fault%]",
"power_adjust_active": "Power adjust",
"paused": "[%key:common::state::paused%]"
}
},
"evse_fault_state": { "evse_fault_state": {
"name": "Fault state", "name": "Fault state",
"state": { "state": {

126
tests/components/matter/snapshots/test_sensor.ambr
View File

@ -3603,6 +3603,69 @@
'state': '120.0', 'state': '120.0',
}) })
# --- # ---
# name: test_sensors[silabs_evse_charging][sensor.evse_appliance_energy_state-entry]
EntityRegistryEntrySnapshot({
'aliases': set({
}),
'area_id': None,
'capabilities': dict({
'options': list([
'offline',
'online',
'fault',
'power_adjust_active',
'paused',
]),
}),
'config_entry_id': <ANY>,
'config_subentry_id': <ANY>,
'device_class': None,
'device_id': <ANY>,
'disabled_by': None,
'domain': 'sensor',
'entity_category': <EntityCategory.DIAGNOSTIC: 'diagnostic'>,
'entity_id': 'sensor.evse_appliance_energy_state',
'has_entity_name': True,
'hidden_by': None,
'icon': None,
'id': <ANY>,
'labels': set({
}),
'name': None,
'options': dict({
}),
'original_device_class': <SensorDeviceClass.ENUM: 'enum'>,
'original_icon': None,
'original_name': 'Appliance energy state',
'platform': 'matter',
'previous_unique_id': None,
'supported_features': 0,
'translation_key': 'esa_state',
'unique_id': '00000000000004D2-0000000000000017-MatterNodeDevice-1-ESAState-152-2',
'unit_of_measurement': None,
})
# ---
# name: test_sensors[silabs_evse_charging][sensor.evse_appliance_energy_state-state]
StateSnapshot({
'attributes': ReadOnlyDict({
'device_class': 'enum',
'friendly_name': 'evse Appliance energy state',
'options': list([
'offline',
'online',
'fault',
'power_adjust_active',
'paused',
]),
}),
'context': <ANY>,
'entity_id': 'sensor.evse_appliance_energy_state',
'last_changed': <ANY>,
'last_reported': <ANY>,
'last_updated': <ANY>,
'state': 'online',
})
# ---
# name: test_sensors[silabs_evse_charging][sensor.evse_circuit_capacity-entry] # name: test_sensors[silabs_evse_charging][sensor.evse_circuit_capacity-entry]
EntityRegistryEntrySnapshot({ EntityRegistryEntrySnapshot({
'aliases': set({ 'aliases': set({
@ -4272,6 +4335,69 @@
'state': '120.0', 'state': '120.0',
}) })
# --- # ---
# name: test_sensors[silabs_water_heater][sensor.water_heater_appliance_energy_state-entry]
EntityRegistryEntrySnapshot({
'aliases': set({
}),
'area_id': None,
'capabilities': dict({
'options': list([
'offline',
'online',
'fault',
'power_adjust_active',
'paused',
]),
}),
'config_entry_id': <ANY>,
'config_subentry_id': <ANY>,
'device_class': None,
'device_id': <ANY>,
'disabled_by': None,
'domain': 'sensor',
'entity_category': <EntityCategory.DIAGNOSTIC: 'diagnostic'>,
'entity_id': 'sensor.water_heater_appliance_energy_state',
'has_entity_name': True,
'hidden_by': None,
'icon': None,
'id': <ANY>,
'labels': set({
}),
'name': None,
'options': dict({
}),
'original_device_class': <SensorDeviceClass.ENUM: 'enum'>,
'original_icon': None,
'original_name': 'Appliance energy state',
'platform': 'matter',
'previous_unique_id': None,
'supported_features': 0,
'translation_key': 'esa_state',
'unique_id': '00000000000004D2-0000000000000019-MatterNodeDevice-2-ESAState-152-2',
'unit_of_measurement': None,
})
# ---
# name: test_sensors[silabs_water_heater][sensor.water_heater_appliance_energy_state-state]
StateSnapshot({
'attributes': ReadOnlyDict({
'device_class': 'enum',
'friendly_name': 'Water Heater Appliance energy state',
'options': list([
'offline',
'online',
'fault',
'power_adjust_active',
'paused',
]),
}),
'context': <ANY>,
'entity_id': 'sensor.water_heater_appliance_energy_state',
'last_changed': <ANY>,
'last_reported': <ANY>,
'last_updated': <ANY>,
'state': 'online',
})
# ---
# name: test_sensors[silabs_water_heater][sensor.water_heater_current-entry] # name: test_sensors[silabs_water_heater][sensor.water_heater_current-entry]
EntityRegistryEntrySnapshot({ EntityRegistryEntrySnapshot({
'aliases': set({ 'aliases': set({

12
tests/components/matter/test_sensor.py
View File

@ -511,3 +511,15 @@ async def test_water_heater(
state = hass.states.get("sensor.water_heater_hot_water_level") state = hass.states.get("sensor.water_heater_hot_water_level")
assert state assert state
assert state.state == "50" assert state.state == "50"
# DeviceEnergyManagement -> ESAState attribute
state = hass.states.get("sensor.water_heater_appliance_energy_state")
assert state
assert state.state == "online"
set_node_attribute(matter_node, 2, 152, 2, 0)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.water_heater_appliance_energy_state")
assert state
assert state.state == "offline"