mirror of
https://github.com/home-assistant/core.git
synced 2026-09-14 20:48:32 +01:00
932838840b
Co-authored-by: Ludovic BOUÉ <lboue@users.noreply.github.com> Co-authored-by: Ludovic BOUÉ <938089+lboue@users.noreply.github.com> Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
455 lines
15 KiB
Python
455 lines
15 KiB
Python
"""Test Matter switches."""
|
|
|
|
import asyncio
|
|
from unittest.mock import MagicMock, call
|
|
|
|
from chip.clusters import Objects as clusters
|
|
from chip.clusters.Objects import NullValue
|
|
from matter_server.client.models.node import MatterNode
|
|
from matter_server.common.errors import MatterError
|
|
from matter_server.common.helpers.util import create_attribute_path_from_attribute
|
|
import pytest
|
|
from syrupy.assertion import SnapshotAssertion
|
|
|
|
from homeassistant.const import Platform
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.exceptions import HomeAssistantError
|
|
from homeassistant.helpers import entity_registry as er
|
|
|
|
from .common import (
|
|
set_node_attribute,
|
|
snapshot_matter_entities,
|
|
trigger_subscription_callback,
|
|
)
|
|
|
|
|
|
@pytest.mark.usefixtures("matter_devices")
|
|
async def test_switches(
|
|
hass: HomeAssistant,
|
|
entity_registry: er.EntityRegistry,
|
|
snapshot: SnapshotAssertion,
|
|
) -> None:
|
|
"""Test switches."""
|
|
snapshot_matter_entities(hass, entity_registry, snapshot, Platform.SWITCH)
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["mock_on_off_plugin_unit"])
|
|
async def test_turn_on(
|
|
hass: HomeAssistant,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
) -> None:
|
|
"""Test turning on a switch."""
|
|
state = hass.states.get("switch.mock_onoffpluginunit")
|
|
assert state
|
|
assert state.state == "off"
|
|
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_on",
|
|
{
|
|
"entity_id": "switch.mock_onoffpluginunit",
|
|
},
|
|
blocking=True,
|
|
)
|
|
|
|
assert matter_client.send_device_command.call_count == 1
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.OnOff.Commands.On(),
|
|
)
|
|
|
|
set_node_attribute(matter_node, 1, 6, 0, True)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
|
|
state = hass.states.get("switch.mock_onoffpluginunit")
|
|
assert state
|
|
assert state.state == "on"
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["mock_on_off_plugin_unit"])
|
|
async def test_turn_off(
|
|
hass: HomeAssistant,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
) -> None:
|
|
"""Test turning off a switch."""
|
|
state = hass.states.get("switch.mock_onoffpluginunit")
|
|
assert state
|
|
assert state.state == "off"
|
|
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_off",
|
|
{
|
|
"entity_id": "switch.mock_onoffpluginunit",
|
|
},
|
|
blocking=True,
|
|
)
|
|
|
|
assert matter_client.send_device_command.call_count == 1
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.OnOff.Commands.Off(),
|
|
)
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["mock_switch_unit"])
|
|
async def test_switch_unit(hass: HomeAssistant, matter_node: MatterNode) -> None:
|
|
"""Test switch entity discovered from any (non-light) OnOff device."""
|
|
# A switch entity should be discovered as fallback for ANY Matter device (endpoint)
|
|
# that has the OnOff cluster and does not fall into an explicit discovery schema
|
|
# by another platform (e.g. light, lock etc.).
|
|
state = hass.states.get("switch.mock_switchunit")
|
|
assert state
|
|
assert state.state == "off"
|
|
assert state.attributes["friendly_name"] == "Mock SwitchUnit"
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["mock_room_airconditioner"])
|
|
async def test_power_switch(hass: HomeAssistant, matter_node: MatterNode) -> None:
|
|
"""Test if a Power switch entity is created for a device that supports that."""
|
|
state = hass.states.get("switch.room_airconditioner_power")
|
|
assert state
|
|
assert state.state == "off"
|
|
assert state.attributes["friendly_name"] == "Room AirConditioner Power"
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["eve_thermo_v4"])
|
|
async def test_numeric_switch(
|
|
hass: HomeAssistant,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
) -> None:
|
|
"""Test numeric switch entity using an Eve Thermo fixture."""
|
|
state = hass.states.get("switch.eve_thermo_20ebp1701_child_lock")
|
|
assert state
|
|
assert state.state == "off"
|
|
# name should be derived from description attribute
|
|
assert state.attributes["friendly_name"] == "Eve Thermo 20EBP1701 Child lock"
|
|
# test attribute changes
|
|
set_node_attribute(matter_node, 1, 516, 1, 1)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
state = hass.states.get("switch.eve_thermo_20ebp1701_child_lock")
|
|
assert state.state == "on"
|
|
set_node_attribute(matter_node, 1, 516, 1, 0)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
state = hass.states.get("switch.eve_thermo_20ebp1701_child_lock")
|
|
assert state.state == "off"
|
|
# test switch service
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_on",
|
|
{"entity_id": "switch.eve_thermo_20ebp1701_child_lock"},
|
|
blocking=True,
|
|
)
|
|
assert matter_client.write_attribute.call_count == 1
|
|
assert matter_client.write_attribute.call_args_list[0] == call(
|
|
node_id=matter_node.node_id,
|
|
attribute_path=create_attribute_path_from_attribute(
|
|
endpoint_id=1,
|
|
attribute=clusters.ThermostatUserInterfaceConfiguration.Attributes.KeypadLockout,
|
|
),
|
|
value=1,
|
|
)
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_off",
|
|
{"entity_id": "switch.eve_thermo_20ebp1701_child_lock"},
|
|
blocking=True,
|
|
)
|
|
assert matter_client.write_attribute.call_count == 2
|
|
assert matter_client.write_attribute.call_args_list[1] == call(
|
|
node_id=matter_node.node_id,
|
|
attribute_path=create_attribute_path_from_attribute(
|
|
endpoint_id=1,
|
|
attribute=clusters.ThermostatUserInterfaceConfiguration.Attributes.KeypadLockout,
|
|
),
|
|
value=0,
|
|
)
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["mock_on_off_plugin_unit"])
|
|
async def test_matter_exception_on_command(
|
|
hass: HomeAssistant,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
) -> None:
|
|
"""Test MatterError converts to HomeAssistantError for switch."""
|
|
state = hass.states.get("switch.mock_onoffpluginunit")
|
|
assert state
|
|
matter_client.send_device_command.side_effect = MatterError("Boom")
|
|
with pytest.raises(HomeAssistantError):
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_on",
|
|
{
|
|
"entity_id": "switch.mock_onoffpluginunit",
|
|
},
|
|
blocking=True,
|
|
)
|
|
|
|
|
|
@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."""
|
|
state = hass.states.get("switch.evse_enable_charging")
|
|
assert state
|
|
assert state.state == "on"
|
|
# test switch service
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_off",
|
|
{"entity_id": "switch.evse_enable_charging"},
|
|
blocking=True,
|
|
)
|
|
assert matter_client.send_device_command.call_count == 1
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.EnergyEvse.Commands.Disable(),
|
|
timed_request_timeout_ms=3000,
|
|
)
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_on",
|
|
{"entity_id": "switch.evse_enable_charging"},
|
|
blocking=True,
|
|
)
|
|
assert matter_client.send_device_command.call_count == 2
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.EnergyEvse.Commands.EnableCharging(
|
|
chargingEnabledUntil=NullValue,
|
|
minimumChargeCurrent=0,
|
|
maximumChargeCurrent=0,
|
|
),
|
|
timed_request_timeout_ms=3000,
|
|
)
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["ikea_klippbok_water_leak"])
|
|
async def test_boolean_state_configuration_alarm_enabled_switches(
|
|
hass: HomeAssistant,
|
|
entity_registry: er.EntityRegistry,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
snapshot: SnapshotAssertion,
|
|
) -> None:
|
|
"""Test Boolean State Configuration alarm enabled switches."""
|
|
|
|
visual_entity_id = "switch.klippbok_water_leak_sensor_visual_alarm_enabled"
|
|
audible_entity_id = "switch.klippbok_water_leak_sensor_audible_alarm_enabled"
|
|
visual_entry = entity_registry.async_get(visual_entity_id)
|
|
audible_entry = entity_registry.async_get(audible_entity_id)
|
|
assert visual_entry
|
|
assert audible_entry
|
|
|
|
visual_state = hass.states.get(visual_entity_id)
|
|
audible_state = hass.states.get(audible_entity_id)
|
|
assert visual_state
|
|
assert audible_state
|
|
assert visual_entry == snapshot(name=f"{visual_entity_id}-entry")
|
|
assert visual_state == snapshot(name=f"{visual_entity_id}-state")
|
|
assert audible_entry == snapshot(name=f"{audible_entity_id}-entry")
|
|
assert audible_state == snapshot(name=f"{audible_entity_id}-state")
|
|
assert visual_state.state == "on"
|
|
assert audible_state.state == "on"
|
|
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_off",
|
|
{"entity_id": visual_entity_id},
|
|
blocking=True,
|
|
)
|
|
|
|
assert matter_client.send_device_command.call_count == 1
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.BooleanStateConfiguration.Commands.EnableDisableAlarm(
|
|
alarmsToEnableDisable=2,
|
|
),
|
|
)
|
|
|
|
set_node_attribute(matter_node, 1, 128, 5, 2)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
|
|
visual_state = hass.states.get(visual_entity_id)
|
|
audible_state = hass.states.get(audible_entity_id)
|
|
assert visual_state
|
|
assert audible_state
|
|
assert visual_state.state == "off"
|
|
assert audible_state.state == "on"
|
|
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_on",
|
|
{"entity_id": visual_entity_id},
|
|
blocking=True,
|
|
)
|
|
|
|
assert matter_client.send_device_command.call_count == 2
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.BooleanStateConfiguration.Commands.EnableDisableAlarm(
|
|
alarmsToEnableDisable=3,
|
|
),
|
|
)
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["ikea_klippbok_water_leak"])
|
|
async def test_boolean_state_configuration_alarm_enabled_switches_are_serialized(
|
|
hass: HomeAssistant,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
) -> None:
|
|
"""Test alarm switch changes to the shared bitmap are serialized."""
|
|
visual_entity_id = "switch.klippbok_water_leak_sensor_visual_alarm_enabled"
|
|
audible_entity_id = "switch.klippbok_water_leak_sensor_audible_alarm_enabled"
|
|
command_started = asyncio.Event()
|
|
allow_commands = asyncio.Event()
|
|
|
|
async def send_device_command(*args: object, **kwargs: object) -> None:
|
|
command_started.set()
|
|
await allow_commands.wait()
|
|
|
|
matter_client.send_device_command.side_effect = send_device_command
|
|
task = hass.async_create_task(
|
|
hass.services.async_call(
|
|
"switch",
|
|
"turn_off",
|
|
{"entity_id": [visual_entity_id, audible_entity_id]},
|
|
blocking=True,
|
|
)
|
|
)
|
|
await command_started.wait()
|
|
await asyncio.sleep(0)
|
|
|
|
assert matter_client.send_device_command.call_count == 1
|
|
|
|
allow_commands.set()
|
|
await task
|
|
|
|
assert matter_client.send_device_command.call_count == 2
|
|
assert matter_client.send_device_command.call_args_list[-1] == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.BooleanStateConfiguration.Commands.EnableDisableAlarm(
|
|
alarmsToEnableDisable=0,
|
|
),
|
|
)
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["mock_speaker"])
|
|
async def test_speaker_mute_uses_onoff_commands(
|
|
hass: HomeAssistant,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
) -> None:
|
|
"""Test speaker mute switch uses On/Off commands instead of attribute writes."""
|
|
|
|
state = hass.states.get("switch.mock_speaker_mute")
|
|
assert state
|
|
assert state.state == "off"
|
|
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_on",
|
|
{"entity_id": "switch.mock_speaker_mute"},
|
|
blocking=True,
|
|
)
|
|
|
|
assert matter_client.send_device_command.call_count == 1
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.OnOff.Commands.Off(),
|
|
)
|
|
|
|
set_node_attribute(matter_node, 1, 6, 0, False)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
state = hass.states.get("switch.mock_speaker_mute")
|
|
assert state
|
|
assert state.state == "on"
|
|
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_off",
|
|
{"entity_id": "switch.mock_speaker_mute"},
|
|
blocking=True,
|
|
)
|
|
|
|
assert matter_client.send_device_command.call_count == 2
|
|
assert matter_client.send_device_command.call_args == call(
|
|
node_id=matter_node.node_id,
|
|
endpoint_id=1,
|
|
command=clusters.OnOff.Commands.On(),
|
|
)
|
|
|
|
set_node_attribute(matter_node, 1, 6, 0, True)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
state = hass.states.get("switch.mock_speaker_mute")
|
|
assert state
|
|
assert state.state == "off"
|
|
|
|
|
|
@pytest.mark.parametrize("node_fixture", ["eve_energy_plug"])
|
|
async def test_eve_child_lock(
|
|
hass: HomeAssistant,
|
|
matter_client: MagicMock,
|
|
matter_node: MatterNode,
|
|
) -> None:
|
|
"""Test the Eve child lock switch entity."""
|
|
state = hass.states.get("switch.eve_energy_plug_child_lock")
|
|
assert state
|
|
assert state.state == "off"
|
|
# test attribute changes
|
|
set_node_attribute(matter_node, 1, 319486977, 319422481, True)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
state = hass.states.get("switch.eve_energy_plug_child_lock")
|
|
assert state.state == "on"
|
|
set_node_attribute(matter_node, 1, 319486977, 319422481, False)
|
|
await trigger_subscription_callback(hass, matter_client)
|
|
state = hass.states.get("switch.eve_energy_plug_child_lock")
|
|
assert state.state == "off"
|
|
# test switch service
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_on",
|
|
{"entity_id": "switch.eve_energy_plug_child_lock"},
|
|
blocking=True,
|
|
)
|
|
assert matter_client.write_attribute.call_count == 1
|
|
assert matter_client.write_attribute.call_args_list[0] == call(
|
|
node_id=matter_node.node_id,
|
|
attribute_path=create_attribute_path_from_attribute(
|
|
endpoint_id=1,
|
|
attribute=clusters.EveCluster.Attributes.ChildLock,
|
|
),
|
|
value=True,
|
|
)
|
|
await hass.services.async_call(
|
|
"switch",
|
|
"turn_off",
|
|
{"entity_id": "switch.eve_energy_plug_child_lock"},
|
|
blocking=True,
|
|
)
|
|
assert matter_client.write_attribute.call_count == 2
|
|
assert matter_client.write_attribute.call_args_list[1] == call(
|
|
node_id=matter_node.node_id,
|
|
attribute_path=create_attribute_path_from_attribute(
|
|
endpoint_id=1,
|
|
attribute=clusters.EveCluster.Attributes.ChildLock,
|
|
),
|
|
value=False,
|
|
)
|