112 lines
4.0 KiB
Python
112 lines
4.0 KiB
Python
"""Elmax sensor platform."""
|
|
from __future__ import annotations
|
|
|
|
from elmax_api.model.alarm_status import AlarmArmStatus, AlarmStatus
|
|
from elmax_api.model.command import AreaCommand
|
|
from elmax_api.model.panel import PanelStatus
|
|
|
|
from homeassistant.components.alarm_control_panel import (
|
|
AlarmControlPanelEntity,
|
|
AlarmControlPanelEntityFeature,
|
|
CodeFormat,
|
|
)
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.const import STATE_ALARM_ARMED_AWAY, STATE_ALARM_DISARMED
|
|
from homeassistant.core import HomeAssistant, callback
|
|
from homeassistant.exceptions import InvalidStateError
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from . import ElmaxCoordinator
|
|
from .common import ElmaxEntity
|
|
from .const import DOMAIN
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Set up the Elmax area platform."""
|
|
coordinator: ElmaxCoordinator = hass.data[DOMAIN][config_entry.entry_id]
|
|
known_devices = set()
|
|
|
|
def _discover_new_devices():
|
|
panel_status: PanelStatus = coordinator.data
|
|
# In case the panel is offline, its status will be None. In that case, simply do nothing
|
|
if panel_status is None:
|
|
return
|
|
|
|
# Otherwise, add all the entities we found
|
|
entities = [
|
|
ElmaxArea(
|
|
panel=coordinator.panel_entry,
|
|
elmax_device=area,
|
|
panel_version=panel_status.release,
|
|
coordinator=coordinator,
|
|
)
|
|
for area in panel_status.areas
|
|
if area.endpoint_id not in known_devices
|
|
]
|
|
|
|
if entities:
|
|
async_add_entities(entities)
|
|
known_devices.update([e.unique_id for e in entities])
|
|
|
|
# Register a listener for the discovery of new devices
|
|
config_entry.async_on_unload(coordinator.async_add_listener(_discover_new_devices))
|
|
|
|
# Immediately run a discovery, so we don't need to wait for the next update
|
|
_discover_new_devices()
|
|
|
|
|
|
class ElmaxArea(ElmaxEntity, AlarmControlPanelEntity):
|
|
"""Elmax Area entity implementation."""
|
|
|
|
_attr_code_format = CodeFormat.NUMBER
|
|
_attr_code_arm_required = False
|
|
_attr_has_entity_name = True
|
|
_attr_supported_features = AlarmControlPanelEntityFeature.ARM_AWAY
|
|
|
|
async def async_alarm_arm_away(self, code: str | None = None) -> None:
|
|
"""Send arm away command."""
|
|
if self._attr_state == AlarmStatus.NOT_ARMED_NOT_ARMABLE:
|
|
raise InvalidStateError(
|
|
f"Cannot arm {self.name}: please check for open windows/doors first"
|
|
)
|
|
|
|
await self.coordinator.http_client.execute_command(
|
|
endpoint_id=self._device.endpoint_id,
|
|
command=AreaCommand.ARM_TOTALLY,
|
|
extra_payload={"code": code},
|
|
)
|
|
await self.coordinator.async_refresh()
|
|
|
|
async def async_alarm_disarm(self, code: str | None = None) -> None:
|
|
"""Send disarm command."""
|
|
# Elmax alarm panels do always require a code to be passed for disarm operations
|
|
if code is None or code == "":
|
|
raise ValueError("Please input the disarm code.")
|
|
await self.coordinator.http_client.execute_command(
|
|
endpoint_id=self._device.endpoint_id,
|
|
command=AreaCommand.DISARM,
|
|
extra_payload={"code": code},
|
|
)
|
|
await self.coordinator.async_refresh()
|
|
|
|
@callback
|
|
def _handle_coordinator_update(self) -> None:
|
|
"""Handle updated data from the coordinator."""
|
|
self._attr_state = ALARM_STATE_TO_HA.get(
|
|
self.coordinator.get_area_state(self._device.endpoint_id).armed_status
|
|
)
|
|
super()._handle_coordinator_update()
|
|
|
|
|
|
ALARM_STATE_TO_HA = {
|
|
AlarmArmStatus.ARMED_TOTALLY: STATE_ALARM_ARMED_AWAY,
|
|
AlarmArmStatus.ARMED_P1_P2: STATE_ALARM_ARMED_AWAY,
|
|
AlarmArmStatus.ARMED_P2: STATE_ALARM_ARMED_AWAY,
|
|
AlarmArmStatus.ARMED_P1: STATE_ALARM_ARMED_AWAY,
|
|
AlarmArmStatus.NOT_ARMED: STATE_ALARM_DISARMED,
|
|
}
|