Home Assistant Unofficial Reference 2024.12.1
alarm_control_panel.py
Go to the documentation of this file.
1 """Support for Prosegur alarm control panels."""
2 
3 from __future__ import annotations
4 
5 import logging
6 
7 from pyprosegur.auth import Auth
8 from pyprosegur.installation import Installation, Status
9 
11  AlarmControlPanelEntity,
12  AlarmControlPanelEntityFeature,
13  AlarmControlPanelState,
14 )
15 from homeassistant.config_entries import ConfigEntry
16 from homeassistant.core import HomeAssistant
17 from homeassistant.helpers.device_registry import DeviceInfo
18 from homeassistant.helpers.entity_platform import AddEntitiesCallback
19 
20 from . import DOMAIN
21 
22 _LOGGER = logging.getLogger(__name__)
23 
24 STATE_MAPPING = {
25  Status.DISARMED: AlarmControlPanelState.DISARMED,
26  Status.ARMED: AlarmControlPanelState.ARMED_AWAY,
27  Status.PARTIALLY: AlarmControlPanelState.ARMED_HOME,
28  Status.ERROR_PARTIALLY: AlarmControlPanelState.ARMED_HOME,
29 }
30 
31 
33  hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
34 ) -> None:
35  """Set up the Prosegur alarm control panel platform."""
37  [ProsegurAlarm(entry.data["contract"], hass.data[DOMAIN][entry.entry_id])],
38  update_before_add=True,
39  )
40 
41 
43  """Representation of a Prosegur alarm status."""
44 
45  _attr_supported_features = (
46  AlarmControlPanelEntityFeature.ARM_AWAY
47  | AlarmControlPanelEntityFeature.ARM_HOME
48  )
49  _attr_has_entity_name = True
50  _attr_name = None
51  _installation: Installation
52 
53  def __init__(self, contract: str, auth: Auth) -> None:
54  """Initialize the Prosegur alarm panel."""
55  self._changed_by_changed_by = None
56 
57  self.contractcontract = contract
58  self._auth_auth = auth
59 
60  self._attr_code_arm_required_attr_code_arm_required = False
61  self._attr_unique_id_attr_unique_id = contract
62 
63  self._attr_device_info_attr_device_info = DeviceInfo(
64  name=f"Contract {contract}",
65  manufacturer="Prosegur",
66  model="smart",
67  identifiers={(DOMAIN, contract)},
68  configuration_url="https://smart.prosegur.com",
69  )
70 
71  async def async_update(self) -> None:
72  """Update alarm status."""
73 
74  try:
75  self._installation_installation = await Installation.retrieve(self._auth_auth, self.contractcontract)
76  except ConnectionError as err:
77  _LOGGER.error(err)
78  self._attr_available_attr_available = False
79  return
80 
81  self._attr_alarm_state_attr_alarm_state = STATE_MAPPING.get(self._installation_installation.status)
82  self._attr_available_attr_available = True
83 
84  async def async_alarm_disarm(self, code: str | None = None) -> None:
85  """Send disarm command."""
86  await self._installation_installation.disarm(self._auth_auth)
87 
88  async def async_alarm_arm_home(self, code: str | None = None) -> None:
89  """Send arm away command."""
90  await self._installation_installation.arm_partially(self._auth_auth)
91 
92  async def async_alarm_arm_away(self, code: str | None = None) -> None:
93  """Send arm away command."""
94  await self._installation_installation.arm(self._auth_auth)
None async_setup_entry(HomeAssistant hass, ConfigEntry entry, AddEntitiesCallback async_add_entities)