1
0
mirror of https://github.com/home-assistant/core.git synced 2026-06-30 11:16:05 +01:00
Files
core/tests/components/matter/test_sensor.py
T
markvp 8e19fd280e Add Thread and Wi-Fi RSSI diagnostic sensors to Matter integration (#167853)
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-06-01 19:31:15 +02:00

1110 lines
35 KiB
Python

"""Test Matter sensors."""
from unittest.mock import MagicMock
from chip.clusters import Objects as clusters
from chip.clusters.ClusterObjects import ClusterAttributeDescriptor
from matter_server.client.models.node import MatterNode
import pytest
from syrupy.assertion import SnapshotAssertion
from homeassistant.const import STATE_UNAVAILABLE, EntityCategory, Platform
from homeassistant.core import HomeAssistant
from homeassistant.helpers import entity_registry as er
from .common import (
set_node_attribute,
snapshot_matter_entities,
trigger_subscription_callback,
)
@pytest.mark.freeze_time("2025-01-01T14:00:00+00:00")
@pytest.mark.usefixtures("entity_registry_enabled_by_default", "matter_devices")
async def test_sensors(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
snapshot: SnapshotAssertion,
) -> None:
"""Test sensors."""
snapshot_matter_entities(hass, entity_registry, snapshot, Platform.SENSOR)
@pytest.mark.parametrize("node_fixture", ["mock_flow_sensor"])
async def test_sensor_null_value(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test flow sensor."""
state = hass.states.get("sensor.mock_flow_sensor_flow")
assert state
assert state.state == "0.0"
set_node_attribute(matter_node, 1, 1028, 0, None)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_flow_sensor_flow")
assert state
assert state.state == "unknown"
@pytest.mark.parametrize("node_fixture", ["mock_flow_sensor"])
async def test_flow_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test flow sensor."""
state = hass.states.get("sensor.mock_flow_sensor_flow")
assert state
assert state.state == "0.0"
set_node_attribute(matter_node, 1, 1028, 0, 20)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_flow_sensor_flow")
assert state
assert state.state == "2.0"
@pytest.mark.parametrize("node_fixture", ["mock_humidity_sensor"])
async def test_humidity_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test humidity sensor."""
state = hass.states.get("sensor.mock_humidity_sensor_humidity")
assert state
assert state.state == "0.0"
set_node_attribute(matter_node, 1, 1029, 0, 4000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_humidity_sensor_humidity")
assert state
assert state.state == "40.0"
@pytest.mark.parametrize("node_fixture", ["mock_soil_sensor"])
async def test_soil_moisture_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test soil moisture sensor."""
state = hass.states.get("sensor.mock_soil_sensor_moisture")
assert state
assert state.state == "50"
set_node_attribute(matter_node, 1, 1072, 1, 75)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_soil_sensor_moisture")
assert state
assert state.state == "75"
@pytest.mark.parametrize("node_fixture", ["mock_light_sensor"])
async def test_light_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test light sensor."""
state = hass.states.get("sensor.mock_light_sensor_illuminance")
assert state
assert state.state == "1.3"
set_node_attribute(matter_node, 1, 1024, 0, 3000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_light_sensor_illuminance")
assert state
assert state.state == "2.0"
@pytest.mark.parametrize("node_fixture", ["mock_temperature_sensor"])
async def test_temperature_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test temperature sensor."""
state = hass.states.get("sensor.mock_temperature_sensor_temperature")
assert state
assert state.state == "21.0"
set_node_attribute(matter_node, 1, 1026, 0, 2500)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_temperature_sensor_temperature")
assert state
assert state.state == "25.0"
@pytest.mark.parametrize("node_fixture", ["eve_contact_sensor"])
async def test_battery_sensor(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test battery sensor."""
entity_id = "sensor.eve_door_battery"
state = hass.states.get(entity_id)
assert state
assert state.state == "100"
set_node_attribute(matter_node, 1, 47, 12, 100)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get(entity_id)
assert state
assert state.state == "50"
entry = entity_registry.async_get(entity_id)
assert entry
assert entry.entity_category == EntityCategory.DIAGNOSTIC
@pytest.mark.parametrize("node_fixture", ["eve_contact_sensor"])
async def test_battery_sensor_voltage(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test battery voltage sensor."""
entity_id = "sensor.eve_door_battery_voltage"
state = hass.states.get(entity_id)
assert state
assert state.state == "3.558"
set_node_attribute(matter_node, 1, 47, 11, 4234)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get(entity_id)
assert state
assert state.state == "4.234"
entry = entity_registry.async_get(entity_id)
assert entry
assert entry.entity_category == EntityCategory.DIAGNOSTIC
@pytest.mark.parametrize("node_fixture", ["heiman_smoke_detector"])
async def test_battery_sensor_description(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test battery replacement description sensor."""
state = hass.states.get("sensor.smoke_sensor_battery_type")
assert state
assert state.state == "CR123A"
set_node_attribute(matter_node, 1, 47, 19, "CR2032")
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.smoke_sensor_battery_type")
assert state
assert state.state == "CR2032"
# case with a empty string to check if the attribute is indeed ignored
set_node_attribute(matter_node, 1, 47, 19, "")
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.smoke_sensor_battery_type") is None
@pytest.mark.parametrize("node_fixture", ["eve_thermo_v4"])
async def test_eve_thermo_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test Eve Thermo."""
# Valve position
state = hass.states.get("sensor.eve_thermo_20ebp1701_valve_position")
assert state
assert state.state == "10"
set_node_attribute(matter_node, 1, 319486977, 319422488, 0)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.eve_thermo_20ebp1701_valve_position")
assert state
assert state.state == "0"
# LocalTemperature
state = hass.states.get("sensor.eve_thermo_20ebp1701_temperature")
assert state
assert state.state == "21.0"
set_node_attribute(matter_node, 1, 513, 0, 1800)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.eve_thermo_20ebp1701_temperature")
assert state
assert state.state == "18.0"
@pytest.mark.parametrize("node_fixture", ["longan_link_thermostat"])
async def test_thermostat_outdoor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test OutdoorTemperature."""
# OutdoorTemperature
state = hass.states.get("sensor.longan_link_hvac_outdoor_temperature")
assert state
assert state.state == "12.5"
set_node_attribute(matter_node, 1, 513, 1, -550)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.longan_link_hvac_outdoor_temperature")
assert state
assert state.state == "-5.5"
@pytest.mark.parametrize("node_fixture", ["mock_pressure_sensor"])
async def test_pressure_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test pressure sensor."""
state = hass.states.get("sensor.mock_pressure_sensor_pressure")
assert state
assert state.state == "0.0"
set_node_attribute(matter_node, 1, 1027, 0, 1010)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_pressure_sensor_pressure")
assert state
assert state.state == "101.0"
@pytest.mark.parametrize("node_fixture", ["eve_weather_sensor"])
async def test_eve_weather_sensor_custom_cluster(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test weather sensor created from (Eve) custom cluster."""
# pressure sensor on Eve custom cluster
state = hass.states.get("sensor.eve_weather_pressure")
assert state
assert state.state == "1008.5"
set_node_attribute(matter_node, 1, 319486977, 319422484, 800)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.eve_weather_pressure")
assert state
assert state.state == "800.0"
@pytest.mark.parametrize("node_fixture", ["air_quality_sensor"])
async def test_air_quality_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test air quality sensor."""
# Carbon Dioxide
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_carbon_dioxide")
assert state
assert state.state == "678.0"
set_node_attribute(matter_node, 1, 1037, 0, 789)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_carbon_dioxide")
assert state
assert state.state == "789.0"
# Nitrogen Dioxide
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_nitrogen_dioxide")
assert state
assert state.state == "0.0"
assert state.attributes["device_class"] == "nitrogen_dioxide"
set_node_attribute(matter_node, 1, 1043, 0, 12.5)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_nitrogen_dioxide")
assert state
assert state.state == "12.5"
# PM1
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_pm1")
assert state
assert state.state == "3.0"
set_node_attribute(matter_node, 1, 1068, 0, 50)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_pm1")
assert state
assert state.state == "50.0"
# PM2.5
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_pm2_5")
assert state
assert state.state == "3.0"
set_node_attribute(matter_node, 1, 1066, 0, 50)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_pm2_5")
assert state
assert state.state == "50.0"
# PM10
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_pm10")
assert state
assert state.state == "3.0"
set_node_attribute(matter_node, 1, 1069, 0, 50)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_pm10")
assert state
assert state.state == "50.0"
# Radon
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_radon_concentration")
assert state
assert state.state == "60.0"
set_node_attribute(matter_node, 1, 1071, 0, 50)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.lightfi_aq1_air_quality_sensor_radon_concentration")
assert state
assert state.state == "50.0"
@pytest.mark.parametrize("node_fixture", ["mock_air_purifier"])
async def test_tvoc_level_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test TVOC level sensor (LevelIndication feature)."""
# TVOC Level - initial state is low (attribute 10 = 1 in fixture)
state = hass.states.get("sensor.mock_air_purifier_tvoc_level")
assert state
assert state.state == "low"
assert state.attributes["device_class"] == "enum"
assert state.attributes["options"] == ["low", "medium", "high", "critical"]
# Test changing to medium level (2)
set_node_attribute(matter_node, 2, 1070, 10, 2)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_air_purifier_tvoc_level")
assert state
assert state.state == "medium"
# Test changing to high level (3)
set_node_attribute(matter_node, 2, 1070, 10, 3)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_air_purifier_tvoc_level")
assert state
assert state.state == "high"
# Test changing to critical level (4)
set_node_attribute(matter_node, 2, 1070, 10, 4)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_air_purifier_tvoc_level")
assert state
assert state.state == "critical"
# Test changing to unknown level (0)
set_node_attribute(matter_node, 2, 1070, 10, 0)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_air_purifier_tvoc_level")
assert state
assert state.state == "unknown"
@pytest.mark.parametrize("node_fixture", ["silabs_dishwasher"])
async def test_operational_state_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test Operational State sensor, using a dishwasher fixture."""
# OperationalState Cluster / OperationalState attribute (1/96/4)
state = hass.states.get("sensor.dishwasher_operational_state")
assert state
assert state.state == "stopped"
assert state.attributes["options"] == [
"stopped",
"running",
"paused",
"error",
"extra_state",
]
set_node_attribute(matter_node, 1, 96, 4, 8)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.dishwasher_operational_state")
assert state
assert state.state == "extra_state"
@pytest.mark.parametrize("node_fixture", ["silabs_dishwasher"])
async def test_operational_error_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test Operational Error sensor, using a dishwasher fixture."""
# OperationalState Cluster / OperationalError attribute (1/96/5)
state = hass.states.get("sensor.dishwasher_operational_error")
assert state
assert state.state == "no_error"
assert state.attributes["options"] == [
"no_error",
"unable_to_start_or_resume",
"unable_to_complete_operation",
"command_invalid_in_state",
]
set_node_attribute(matter_node, 1, 96, 5, {0: 1})
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.dishwasher_operational_error")
assert state
assert state.state == "unable_to_start_or_resume"
@pytest.mark.parametrize("node_fixture", ["yandex_smart_socket"])
async def test_draft_electrical_measurement_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test Draft Electrical Measurement sensors with Yandex Smart Socket."""
state = hass.states.get("sensor.yndx_00540_power")
assert state
assert state.state == "70.0"
# AcPowerDivisor
set_node_attribute(matter_node, 1, 2820, 1541, 0)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.yndx_00540_power")
assert state
assert state.state == "unknown"
# ActivePower
set_node_attribute(matter_node, 1, 2820, 1291, None)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.yndx_00540_power")
assert state
assert state.state == "unknown"
@pytest.mark.freeze_time("2025-01-01T14:00:00+00:00")
@pytest.mark.parametrize("node_fixture", ["mock_microwave_oven"])
async def test_countdown_time_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test CountdownTime sensor."""
# OperationalState Cluster / CountdownTime (1/96/2)
state = hass.states.get("sensor.mock_microwave_oven_estimated_end_time")
assert state
# 1/96/2 = 30 seconds, so 30 s should be added to the current time.
assert state.state == "2025-01-01T14:00:30+00:00"
@pytest.mark.parametrize("node_fixture", ["silabs_laundrywasher"])
async def test_list_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test Matter List sensor."""
# OperationalState Cluster / CurrentPhase attribute (1/96/1)
state = hass.states.get("sensor.laundrywasher_current_phase")
assert state
assert state.state == "pre-soak"
set_node_attribute(matter_node, 1, 96, 1, 1)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.laundrywasher_current_phase")
assert state
assert state.state == "rinse"
@pytest.mark.parametrize("node_fixture", ["silabs_evse_charging"])
async def test_evse_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test evse sensors."""
# EnergyEvseFaultState
state = hass.states.get("sensor.evse_fault_state")
assert state
assert state.state == "no_error"
set_node_attribute(matter_node, 1, 153, 2, 4)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.evse_fault_state")
assert state
assert state.state == "over_current"
# EnergyEvseCircuitCapacity
state = hass.states.get("sensor.evse_circuit_capacity")
assert state
assert state.state == "32.0"
set_node_attribute(matter_node, 1, 153, 5, 63000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.evse_circuit_capacity")
assert state
assert state.state == "63.0"
# EnergyEvseMinimumChargeCurrent
state = hass.states.get("sensor.evse_min_charge_current")
assert state
assert state.state == "2.0"
set_node_attribute(matter_node, 1, 153, 6, 5000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.evse_min_charge_current")
assert state
assert state.state == "5.0"
# EnergyEvseMaximumChargeCurrent
state = hass.states.get("sensor.evse_max_charge_current")
assert state
assert state.state == "30.0"
set_node_attribute(matter_node, 1, 153, 7, 20000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.evse_max_charge_current")
assert state
assert state.state == "20.0"
# EnergyEvseUserMaximumChargeCurrent
state = hass.states.get("sensor.evse_user_max_charge_current")
assert state
assert state.state == "32.0"
set_node_attribute(matter_node, 1, 153, 9, 63000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.evse_user_max_charge_current")
assert state
assert state.state == "63.0"
@pytest.mark.parametrize("node_fixture", ["silabs_water_heater"])
async def test_water_heater(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test water heater sensor."""
# TankVolume
state = hass.states.get("sensor.water_heater_tank_volume")
assert state
assert state.state == "200"
set_node_attribute(matter_node, 2, 148, 2, 100)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.water_heater_tank_volume")
assert state
assert state.state == "100"
# EstimatedHeatRequired
state = hass.states.get("sensor.water_heater_required_heating_energy")
assert state
assert state.state == "4.0"
set_node_attribute(matter_node, 2, 148, 3, 1000000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.water_heater_required_heating_energy")
assert state
assert state.state == "1.0"
# TankPercentage
state = hass.states.get("sensor.water_heater_hot_water_level")
assert state
assert state.state == "40"
set_node_attribute(matter_node, 2, 148, 4, 50)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.water_heater_hot_water_level")
assert state
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"
# DeviceEnergyManagement -> OptOutState attribute
state = hass.states.get("sensor.water_heater_energy_optimization_opt_out")
assert state
assert state.state == "no_opt_out"
set_node_attribute(matter_node, 2, 152, 7, 3)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.water_heater_energy_optimization_opt_out")
assert state
assert state.state == "opt_out"
@pytest.mark.parametrize("node_fixture", ["mock_pump"])
async def test_pump(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test pump sensors."""
# ControlMode
state = hass.states.get("sensor.mock_pump_control_mode")
assert state
assert state.state == "constant_temperature"
set_node_attribute(matter_node, 1, 512, 33, 7)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_pump_control_mode")
assert state
assert state.state == "automatic"
# Speed
state = hass.states.get("sensor.mock_pump_rotation_speed")
assert state
assert state.state == "1000"
set_node_attribute(matter_node, 1, 512, 20, 500)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_pump_rotation_speed")
assert state
assert state.state == "500"
@pytest.mark.parametrize("node_fixture", ["mock_vacuum_cleaner"])
async def test_vacuum_actions(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test vacuum sensors."""
# EstimatedEndTime
state = hass.states.get("sensor.mock_vacuum_estimated_end_time")
assert state
assert state.state == "2025-08-29T21:00:00+00:00"
set_node_attribute(matter_node, 1, 336, 4, 809817200)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_vacuum_estimated_end_time")
assert state
assert state.state == "2025-08-29T21:13:20+00:00"
@pytest.mark.parametrize("node_fixture", ["mock_vacuum_cleaner"])
async def test_vacuum_operational_error_sensor(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test RVC Operational Error sensor, using a vacuum cleaner fixture."""
# RvcOperationalState Cluster / OperationalError attribute (1/97/5)
state = hass.states.get("sensor.mock_vacuum_operational_error")
assert state
assert state.state == "no_error"
assert state.attributes["options"] == [
"no_error",
"unable_to_start_or_resume",
"unable_to_complete_operation",
"command_invalid_in_state",
"failed_to_find_charging_dock",
"stuck",
"dust_bin_missing",
"dust_bin_full",
"water_tank_empty",
"water_tank_missing",
"water_tank_lid_open",
"mop_cleaning_pad_missing",
"low_battery",
"cannot_reach_target_area",
"dirty_water_tank_full",
"dirty_water_tank_missing",
"wheels_jammed",
"brush_jammed",
"navigation_sensor_obscured",
]
# test Rvc error
set_node_attribute(matter_node, 1, 97, 5, {0: 66})
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_vacuum_operational_error")
assert state
assert state.state == "dust_bin_missing"
# test unknown errorStateID == 192 (0xC0)
set_node_attribute(matter_node, 1, 97, 5, {0: 192})
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_vacuum_operational_error")
assert state
assert state.state == "unknown"
@pytest.mark.usefixtures("entity_registry_enabled_by_default")
@pytest.mark.parametrize("node_fixture", ["mock_lock"])
async def test_optional_door_event_sensors_from_featuremap(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test discovery of optional door event sensors in doorlock featuremap."""
entity_id_open = "sensor.mock_lock_door_open_events"
entity_id_closed = "sensor.mock_lock_door_closed_events"
# Check that the entities are created
state = hass.states.get(entity_id_open)
assert state
assert state.state == "5"
state = hass.states.get(entity_id_closed)
assert state
assert state.state == "3"
# Test updating the sensor values
set_node_attribute(matter_node, 1, 257, 4, 10)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get(entity_id_open)
assert state
assert state.state == "10"
set_node_attribute(matter_node, 1, 257, 5, 8)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get(entity_id_closed)
assert state
assert state.state == "8"
@pytest.mark.parametrize("node_fixture", ["mock_valve"])
async def test_valve(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test valve AutoCloseTime sensor with Matter epoch microseconds conversion."""
# ValveConfigurationAndControl Cluster / AutoCloseTime attribute (1/129/2)
# Initial value is 789004800000000 microseconds = 2025-01-01 00:00:00 UTC
state = hass.states.get("sensor.mock_valve_auto_close_time")
assert state
assert state.state == "2025-01-01T00:00:00+00:00"
# Set to another timestamp: 820540800000000 microseconds
# = 820540800 seconds since 2000-01-01 = 1767225600 Unix epoch
# = 2026-01-01 00:00:00 UTC
set_node_attribute(matter_node, 1, 129, 2, 820540800000000)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_valve_auto_close_time")
assert state
assert state.state == "2026-01-01T00:00:00+00:00"
# Test setting to 0 (invalid/null) - should result in unknown state
set_node_attribute(matter_node, 1, 129, 2, 0)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.mock_valve_auto_close_time")
assert state
assert state.state == "unknown"
@pytest.mark.parametrize("node_fixture", ["aqara_thermostat_w500"])
async def test_aqara_thermostat_w500_entity_exists_and_unknown(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Ensure the Aqara W500 entity is created and its state is unknown.
This test helps prevent regressions if allow_none_value=True is removed.
"""
state = hass.states.get("sensor.floor_heating_thermostat_active_current")
assert state is not None
assert state.state == "unknown"
@pytest.mark.parametrize("node_fixture", ["atios_knx_bridge"])
async def test_bridged_device_reachable_updates_availability(
hass: HomeAssistant,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test bridged endpoint availability follows Reachable updates."""
entity_ids = (
"sensor.electricity_monitor_ac_energy",
"sensor.electricity_monitor_ac_power",
)
for entity_id in entity_ids:
state = hass.states.get(entity_id)
assert state
assert state.state != STATE_UNAVAILABLE
set_node_attribute(matter_node, 29, 57, 17, False)
await trigger_subscription_callback(hass, matter_client)
for entity_id in entity_ids:
state = hass.states.get(entity_id)
assert state
assert state.state == STATE_UNAVAILABLE
set_node_attribute(matter_node, 29, 57, 17, True)
await trigger_subscription_callback(hass, matter_client)
for entity_id in entity_ids:
state = hass.states.get(entity_id)
assert state
assert state.state != STATE_UNAVAILABLE
@pytest.mark.usefixtures("entity_registry_enabled_by_default")
@pytest.mark.parametrize("node_fixture", ["device_diagnostics"])
async def test_wifi_rssi_sensor(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test WiFiNetworkDiagnostics RSSI sensor."""
# RSSI = -56
state = hass.states.get("sensor.m5stamp_lighting_app_wi_fi_rssi")
assert state
assert state.state == "-56"
set_node_attribute(
matter_node,
0,
clusters.WiFiNetworkDiagnostics.id,
clusters.WiFiNetworkDiagnostics.Attributes.Rssi.attribute_id,
-72,
)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.m5stamp_lighting_app_wi_fi_rssi")
assert state
assert state.state == "-72"
entry = entity_registry.async_get("sensor.m5stamp_lighting_app_wi_fi_rssi")
assert entry
assert entry.entity_category == EntityCategory.DIAGNOSTIC
@pytest.mark.usefixtures("entity_registry_enabled_by_default")
@pytest.mark.parametrize(
("entity_id", "attribute", "initial_state", "updated_value", "updated_state"),
[
(
"sensor.multi_state_sensor_p100_thread_channel",
clusters.ThreadNetworkDiagnostics.Attributes.Channel,
"25",
20,
"20",
),
(
"sensor.multi_state_sensor_p100_thread_network_name",
clusters.ThreadNetworkDiagnostics.Attributes.NetworkName,
"MyHome1895415629",
"OtherNet",
"OtherNet",
),
],
)
@pytest.mark.parametrize("node_fixture", ["aqara_multi_state_p100"])
async def test_thread_diagnostic_sensors(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
entity_id: str,
attribute: ClusterAttributeDescriptor,
initial_state: str,
updated_value: int | str,
updated_state: str,
) -> None:
"""Test ThreadNetworkDiagnostics Channel and NetworkName sensors."""
state = hass.states.get(entity_id)
assert state
assert state.state == initial_state
set_node_attribute(
matter_node, 0, attribute.cluster_id, attribute.attribute_id, updated_value
)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get(entity_id)
assert state
assert state.state == updated_state
entry = entity_registry.async_get(entity_id)
assert entry
assert entry.entity_category == EntityCategory.DIAGNOSTIC
@pytest.mark.usefixtures("entity_registry_enabled_by_default")
@pytest.mark.parametrize(
("routing_role_value", "expected_state"),
[
(0, "unspecified"),
(1, "unassigned"),
(2, "sleepy_end_device"),
(3, "end_device"),
(4, "reed"),
(5, "router"),
(6, "leader"),
],
)
@pytest.mark.parametrize("node_fixture", ["aqara_multi_state_p100"])
async def test_thread_routing_role_enum_mapping(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
routing_role_value: int,
expected_state: str,
) -> None:
"""Test ThreadNetworkDiagnostics RoutingRole enum maps every value to a translatable state."""
entity_id = "sensor.multi_state_sensor_p100_thread_routing_role"
set_node_attribute(
matter_node,
0,
clusters.ThreadNetworkDiagnostics.id,
clusters.ThreadNetworkDiagnostics.Attributes.RoutingRole.attribute_id,
routing_role_value,
)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get(entity_id)
assert state
assert state.state == expected_state
entry = entity_registry.async_get(entity_id)
assert entry
assert entry.entity_category == EntityCategory.DIAGNOSTIC
assert entry.capabilities is not None
assert expected_state in entry.capabilities["options"]
@pytest.mark.freeze_time("2025-01-01T14:00:00+00:00")
@pytest.mark.usefixtures("entity_registry_enabled_by_default")
@pytest.mark.parametrize("node_fixture", ["device_diagnostics"])
async def test_general_diagnostics_sensors(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test GeneralDiagnostics cluster sensors."""
# RebootCount (cluster 51, attr 1) = 3
state = hass.states.get("sensor.m5stamp_lighting_app_reboot_count")
assert state
assert state.state == "3"
set_node_attribute(matter_node, 0, 51, 1, 5)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.m5stamp_lighting_app_reboot_count")
assert state
assert state.state == "5"
entry = entity_registry.async_get("sensor.m5stamp_lighting_app_reboot_count")
assert entry
assert entry.entity_category == EntityCategory.DIAGNOSTIC
# UpTime (cluster 51, attr 2) = 213 seconds → boot at now - 213s
state = hass.states.get("sensor.m5stamp_lighting_app_uptime")
assert state
assert state.state == "2025-01-01T13:56:27+00:00"
set_node_attribute(matter_node, 0, 51, 2, 3600)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.m5stamp_lighting_app_uptime")
assert state
assert state.state == "2025-01-01T13:00:00+00:00"
# BootReason (cluster 51, attr 4) = 1 (PowerOnReboot)
state = hass.states.get("sensor.m5stamp_lighting_app_boot_reason")
assert state
assert state.state == "power_on_reboot"
set_node_attribute(matter_node, 0, 51, 4, 6)
await trigger_subscription_callback(hass, matter_client)
state = hass.states.get("sensor.m5stamp_lighting_app_boot_reason")
assert state
assert state.state == "software_reset"
entry = entity_registry.async_get("sensor.m5stamp_lighting_app_boot_reason")
assert entry
assert entry.entity_category == EntityCategory.DIAGNOSTIC
@pytest.mark.parametrize("node_fixture", ["device_diagnostics"])
async def test_general_diagnostics_sensors_disabled_by_default(
hass: HomeAssistant,
entity_registry: er.EntityRegistry,
matter_client: MagicMock,
matter_node: MatterNode,
) -> None:
"""Test GeneralDiagnostics sensors are disabled by default."""
for entity_id in (
"sensor.m5stamp_lighting_app_reboot_count",
"sensor.m5stamp_lighting_app_uptime",
"sensor.m5stamp_lighting_app_boot_reason",
):
entry = entity_registry.async_get(entity_id)
assert entry, f"Expected {entity_id} to be registered"
assert entry.disabled_by is er.RegistryEntryDisabler.INTEGRATION