Home Assistant Unofficial Reference 2024.12.1
__init__.py
Go to the documentation of this file.
1 """SwitchBot via API integration."""
2 
3 from asyncio import gather
4 from dataclasses import dataclass, field
5 from logging import getLogger
6 
7 from switchbot_api import CannotConnect, Device, InvalidAuth, Remote, SwitchBotAPI
8 
9 from homeassistant.config_entries import ConfigEntry
10 from homeassistant.const import CONF_API_KEY, CONF_API_TOKEN, Platform
11 from homeassistant.core import HomeAssistant, callback
12 from homeassistant.exceptions import ConfigEntryNotReady
13 
14 from .const import DOMAIN
15 from .coordinator import SwitchBotCoordinator
16 
17 _LOGGER = getLogger(__name__)
18 PLATFORMS: list[Platform] = [
19  Platform.CLIMATE,
20  Platform.LOCK,
21  Platform.SENSOR,
22  Platform.SWITCH,
23  Platform.VACUUM,
24 ]
25 
26 
27 @dataclass
29  """Switchbot devices data."""
30 
31  climates: list[Remote] = field(default_factory=list)
32  switches: list[Device | Remote] = field(default_factory=list)
33  sensors: list[Device] = field(default_factory=list)
34  vacuums: list[Device] = field(default_factory=list)
35  locks: list[Device] = field(default_factory=list)
36 
37 
38 @dataclass
40  """Data to use in platforms."""
41 
42  api: SwitchBotAPI
43  devices: SwitchbotDevices
44 
45 
46 @callback
48  hass: HomeAssistant,
49  api: SwitchBotAPI,
50  device: Device | Remote,
51  coordinators_by_id: dict[str, SwitchBotCoordinator],
52 ) -> tuple[Device | Remote, SwitchBotCoordinator]:
53  """Instantiate coordinator and adds to list for gathering."""
54  coordinator = coordinators_by_id.setdefault(
55  device.device_id, SwitchBotCoordinator(hass, api, device)
56  )
57  return (device, coordinator)
58 
59 
60 @callback
62  hass: HomeAssistant,
63  api: SwitchBotAPI,
64  devices: list[Device | Remote],
65  coordinators_by_id: dict[str, SwitchBotCoordinator],
66 ) -> SwitchbotDevices:
67  """Make device data."""
68  devices_data = SwitchbotDevices()
69  for device in devices:
70  if isinstance(device, Remote) and device.device_type.endswith(
71  "Air Conditioner"
72  ):
73  devices_data.climates.append(
74  prepare_device(hass, api, device, coordinators_by_id)
75  )
76  if (
77  isinstance(device, Device)
78  and device.device_type.startswith("Plug")
79  or isinstance(device, Remote)
80  ):
81  devices_data.switches.append(
82  prepare_device(hass, api, device, coordinators_by_id)
83  )
84  if isinstance(device, Device) and device.device_type in [
85  "Meter",
86  "MeterPlus",
87  "WoIOSensor",
88  "Hub 2",
89  "MeterPro",
90  "MeterPro(CO2)",
91  ]:
92  devices_data.sensors.append(
93  prepare_device(hass, api, device, coordinators_by_id)
94  )
95  if isinstance(device, Device) and device.device_type in [
96  "K10+",
97  "K10+ Pro",
98  "Robot Vacuum Cleaner S1",
99  "Robot Vacuum Cleaner S1 Plus",
100  ]:
101  devices_data.vacuums.append(
102  prepare_device(hass, api, device, coordinators_by_id)
103  )
104 
105  if isinstance(device, Device) and device.device_type.startswith("Smart Lock"):
106  devices_data.locks.append(
107  prepare_device(hass, api, device, coordinators_by_id)
108  )
109  return devices_data
110 
111 
112 async def async_setup_entry(hass: HomeAssistant, config: ConfigEntry) -> bool:
113  """Set up SwitchBot via API from a config entry."""
114  token = config.data[CONF_API_TOKEN]
115  secret = config.data[CONF_API_KEY]
116 
117  api = SwitchBotAPI(token=token, secret=secret)
118  try:
119  devices = await api.list_devices()
120  except InvalidAuth as ex:
121  _LOGGER.error(
122  "Invalid authentication while connecting to SwitchBot API: %s", ex
123  )
124  return False
125  except CannotConnect as ex:
126  raise ConfigEntryNotReady from ex
127  _LOGGER.debug("Devices: %s", devices)
128  coordinators_by_id: dict[str, SwitchBotCoordinator] = {}
129  hass.data.setdefault(DOMAIN, {})
130  hass.data[DOMAIN][config.entry_id] = SwitchbotCloudData(
131  api=api, devices=make_device_data(hass, api, devices, coordinators_by_id)
132  )
133  await hass.config_entries.async_forward_entry_setups(config, PLATFORMS)
134  await gather(
135  *[coordinator.async_refresh() for coordinator in coordinators_by_id.values()]
136  )
137  return True
138 
139 
140 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
141  """Unload a config entry."""
142  if unload_ok := await hass.config_entries.async_unload_platforms(entry, PLATFORMS):
143  hass.data[DOMAIN].pop(entry.entry_id)
144 
145  return unload_ok
SwitchbotDevices make_device_data(HomeAssistant hass, SwitchBotAPI api, list[Device|Remote] devices, dict[str, SwitchBotCoordinator] coordinators_by_id)
Definition: __init__.py:66
bool async_unload_entry(HomeAssistant hass, ConfigEntry entry)
Definition: __init__.py:140
tuple[Device|Remote, SwitchBotCoordinator] prepare_device(HomeAssistant hass, SwitchBotAPI api, Device|Remote device, dict[str, SwitchBotCoordinator] coordinators_by_id)
Definition: __init__.py:52
bool async_setup_entry(HomeAssistant hass, ConfigEntry config)
Definition: __init__.py:112