Home Assistant Unofficial Reference 2024.12.1
binary_sensor.py
Go to the documentation of this file.
1 """Support for Freedompro binary_sensor."""
2 
3 from typing import Any
4 
6  BinarySensorDeviceClass,
7  BinarySensorEntity,
8 )
9 from homeassistant.config_entries import ConfigEntry
10 from homeassistant.core import HomeAssistant, callback
11 from homeassistant.helpers.device_registry import DeviceInfo
12 from homeassistant.helpers.entity_platform import AddEntitiesCallback
13 from homeassistant.helpers.update_coordinator import CoordinatorEntity
14 
15 from .const import DOMAIN
16 from .coordinator import FreedomproDataUpdateCoordinator
17 
18 DEVICE_CLASS_MAP = {
19  "smokeSensor": BinarySensorDeviceClass.SMOKE,
20  "occupancySensor": BinarySensorDeviceClass.OCCUPANCY,
21  "motionSensor": BinarySensorDeviceClass.MOTION,
22  "contactSensor": BinarySensorDeviceClass.OPENING,
23 }
24 
25 DEVICE_KEY_MAP = {
26  "smokeSensor": "smokeDetected",
27  "occupancySensor": "occupancyDetected",
28  "motionSensor": "motionDetected",
29  "contactSensor": "contactSensorState",
30 }
31 
32 SUPPORTED_SENSORS = {"smokeSensor", "occupancySensor", "motionSensor", "contactSensor"}
33 
34 
36  hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
37 ) -> None:
38  """Set up Freedompro binary_sensor."""
39  coordinator: FreedomproDataUpdateCoordinator = hass.data[DOMAIN][entry.entry_id]
41  Device(device, coordinator)
42  for device in coordinator.data
43  if device["type"] in SUPPORTED_SENSORS
44  )
45 
46 
47 class Device(CoordinatorEntity[FreedomproDataUpdateCoordinator], BinarySensorEntity):
48  """Representation of a Freedompro binary_sensor."""
49 
50  _attr_has_entity_name = True
51  _attr_name = None
52 
53  def __init__(
54  self, device: dict[str, Any], coordinator: FreedomproDataUpdateCoordinator
55  ) -> None:
56  """Initialize the Freedompro binary_sensor."""
57  super().__init__(coordinator)
58  self._attr_unique_id_attr_unique_id = device["uid"]
59  self._type_type = device["type"]
60  self._attr_device_info_attr_device_info = DeviceInfo(
61  identifiers={
62  (DOMAIN, device["uid"]),
63  },
64  manufacturer="Freedompro",
65  model=device["type"],
66  name=device["name"],
67  )
68  self._attr_device_class_attr_device_class = DEVICE_CLASS_MAP[device["type"]]
69 
70  @callback
71  def _handle_coordinator_update(self) -> None:
72  """Handle updated data from the coordinator."""
73  device = next(
74  (
75  device
76  for device in self.coordinator.data
77  if device["uid"] == self.unique_idunique_id
78  ),
79  None,
80  )
81  if device is not None and "state" in device:
82  state = device["state"]
83  self._attr_is_on_attr_is_on = state[DEVICE_KEY_MAP[self._type_type]]
85 
86  async def async_added_to_hass(self) -> None:
87  """When entity is added to hass."""
88  await super().async_added_to_hass()
89  self._handle_coordinator_update_handle_coordinator_update()
None __init__(self, dict[str, Any] device, FreedomproDataUpdateCoordinator coordinator)
None async_setup_entry(HomeAssistant hass, ConfigEntry entry, AddEntitiesCallback async_add_entities)