Home Assistant Unofficial Reference 2024.12.1
coordinator.py
Go to the documentation of this file.
1 """The coordinator for APsystems local API integration."""
2 
3 from __future__ import annotations
4 
5 from dataclasses import dataclass
6 from datetime import timedelta
7 
8 from APsystemsEZ1 import (
9  APsystemsEZ1M,
10  InverterReturnedError,
11  ReturnAlarmInfo,
12  ReturnOutputData,
13 )
14 
15 from homeassistant.core import HomeAssistant
16 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator, UpdateFailed
17 
18 from .const import DOMAIN, LOGGER
19 
20 
21 @dataclass
23  """Representing different Apsystems sensor data."""
24 
25  output_data: ReturnOutputData
26  alarm_info: ReturnAlarmInfo
27 
28 
29 class ApSystemsDataCoordinator(DataUpdateCoordinator[ApSystemsSensorData]):
30  """Coordinator used for all sensors."""
31 
32  def __init__(self, hass: HomeAssistant, api: APsystemsEZ1M) -> None:
33  """Initialize my coordinator."""
34  super().__init__(
35  hass,
36  LOGGER,
37  name="APSystems Data",
38  update_interval=timedelta(seconds=12),
39  )
40  self.apiapi = api
41 
42  async def _async_setup(self) -> None:
43  try:
44  device_info = await self.apiapi.get_device_info()
45  except (ConnectionError, TimeoutError):
46  raise UpdateFailed from None
47  self.apiapi.max_power = device_info.maxPower
48  self.apiapi.min_power = device_info.minPower
49 
50  async def _async_update_data(self) -> ApSystemsSensorData:
51  try:
52  output_data = await self.apiapi.get_output_data()
53  alarm_info = await self.apiapi.get_alarm_info()
54  except InverterReturnedError:
55  raise UpdateFailed(
56  translation_domain=DOMAIN, translation_key="inverter_error"
57  ) from None
58  return ApSystemsSensorData(output_data=output_data, alarm_info=alarm_info)
None __init__(self, HomeAssistant hass, APsystemsEZ1M api)
Definition: coordinator.py:32
DeviceInfo get_device_info(str coordinates, str name)
Definition: __init__.py:156