230 lines
7.7 KiB
Python
230 lines
7.7 KiB
Python
"""The Wallbox integration."""
|
|
from __future__ import annotations
|
|
|
|
from datetime import timedelta
|
|
from http import HTTPStatus
|
|
import logging
|
|
from typing import Any
|
|
|
|
import requests
|
|
from wallbox import Wallbox
|
|
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.const import CONF_PASSWORD, CONF_USERNAME, Platform
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.exceptions import ConfigEntryAuthFailed, HomeAssistantError
|
|
from homeassistant.helpers.update_coordinator import (
|
|
CoordinatorEntity,
|
|
DataUpdateCoordinator,
|
|
)
|
|
|
|
from ...helpers.entity import DeviceInfo
|
|
from .const import (
|
|
CHARGER_CURRENT_VERSION_KEY,
|
|
CHARGER_DATA_KEY,
|
|
CHARGER_LOCKED_UNLOCKED_KEY,
|
|
CHARGER_MAX_CHARGING_CURRENT_KEY,
|
|
CHARGER_NAME_KEY,
|
|
CHARGER_PART_NUMBER_KEY,
|
|
CHARGER_SERIAL_NUMBER_KEY,
|
|
CHARGER_SOFTWARE_KEY,
|
|
CHARGER_STATUS_DESCRIPTION_KEY,
|
|
CHARGER_STATUS_ID_KEY,
|
|
CONF_STATION,
|
|
DOMAIN,
|
|
)
|
|
|
|
_LOGGER = logging.getLogger(__name__)
|
|
|
|
PLATFORMS = [Platform.SENSOR, Platform.NUMBER, Platform.LOCK]
|
|
UPDATE_INTERVAL = 30
|
|
|
|
# Translation of StatusId based on Wallbox portal code:
|
|
# https://my.wallbox.com/src/utilities/charger/chargerStatuses.js
|
|
CHARGER_STATUS: dict[int, str] = {
|
|
0: "Disconnected",
|
|
14: "Error",
|
|
15: "Error",
|
|
161: "Ready",
|
|
162: "Ready",
|
|
163: "Disconnected",
|
|
164: "Waiting",
|
|
165: "Locked",
|
|
166: "Updating",
|
|
177: "Scheduled",
|
|
178: "Paused",
|
|
179: "Scheduled",
|
|
180: "Waiting for car demand",
|
|
181: "Waiting for car demand",
|
|
182: "Paused",
|
|
183: "Waiting in queue by Power Sharing",
|
|
184: "Waiting in queue by Power Sharing",
|
|
185: "Waiting in queue by Power Boost",
|
|
186: "Waiting in queue by Power Boost",
|
|
187: "Waiting MID failed",
|
|
188: "Waiting MID safety margin exceeded",
|
|
189: "Waiting in queue by Eco-Smart",
|
|
193: "Charging",
|
|
194: "Charging",
|
|
195: "Charging",
|
|
196: "Discharging",
|
|
209: "Locked",
|
|
210: "Locked",
|
|
}
|
|
|
|
|
|
class WallboxCoordinator(DataUpdateCoordinator[dict[str, Any]]):
|
|
"""Wallbox Coordinator class."""
|
|
|
|
def __init__(self, station: str, wallbox: Wallbox, hass: HomeAssistant) -> None:
|
|
"""Initialize."""
|
|
self._station = station
|
|
self._wallbox = wallbox
|
|
|
|
super().__init__(
|
|
hass,
|
|
_LOGGER,
|
|
name=DOMAIN,
|
|
update_interval=timedelta(seconds=UPDATE_INTERVAL),
|
|
)
|
|
|
|
def _authenticate(self) -> None:
|
|
"""Authenticate using Wallbox API."""
|
|
try:
|
|
self._wallbox.authenticate()
|
|
except requests.exceptions.HTTPError as wallbox_connection_error:
|
|
if wallbox_connection_error.response.status_code == HTTPStatus.FORBIDDEN:
|
|
raise ConfigEntryAuthFailed from wallbox_connection_error
|
|
raise ConnectionError from wallbox_connection_error
|
|
|
|
def _validate(self) -> None:
|
|
"""Authenticate using Wallbox API."""
|
|
try:
|
|
self._wallbox.authenticate()
|
|
except requests.exceptions.HTTPError as wallbox_connection_error:
|
|
if wallbox_connection_error.response.status_code == 403:
|
|
raise InvalidAuth from wallbox_connection_error
|
|
raise ConnectionError from wallbox_connection_error
|
|
|
|
async def async_validate_input(self) -> None:
|
|
"""Get new sensor data for Wallbox component."""
|
|
await self.hass.async_add_executor_job(self._validate)
|
|
|
|
def _get_data(self) -> dict[str, Any]:
|
|
"""Get new sensor data for Wallbox component."""
|
|
try:
|
|
self._authenticate()
|
|
data: dict[str, Any] = self._wallbox.getChargerStatus(self._station)
|
|
data[CHARGER_MAX_CHARGING_CURRENT_KEY] = data[CHARGER_DATA_KEY][
|
|
CHARGER_MAX_CHARGING_CURRENT_KEY
|
|
]
|
|
data[CHARGER_LOCKED_UNLOCKED_KEY] = data[CHARGER_DATA_KEY][
|
|
CHARGER_LOCKED_UNLOCKED_KEY
|
|
]
|
|
data[CHARGER_STATUS_DESCRIPTION_KEY] = CHARGER_STATUS.get(
|
|
data[CHARGER_STATUS_ID_KEY], "Unknown"
|
|
)
|
|
|
|
return data
|
|
|
|
except requests.exceptions.HTTPError as wallbox_connection_error:
|
|
raise ConnectionError from wallbox_connection_error
|
|
|
|
async def _async_update_data(self) -> dict[str, Any]:
|
|
"""Get new sensor data for Wallbox component."""
|
|
return await self.hass.async_add_executor_job(self._get_data)
|
|
|
|
def _set_charging_current(self, charging_current: float) -> None:
|
|
"""Set maximum charging current for Wallbox."""
|
|
try:
|
|
self._authenticate()
|
|
self._wallbox.setMaxChargingCurrent(self._station, charging_current)
|
|
except requests.exceptions.HTTPError as wallbox_connection_error:
|
|
if wallbox_connection_error.response.status_code == 403:
|
|
raise InvalidAuth from wallbox_connection_error
|
|
raise ConnectionError from wallbox_connection_error
|
|
|
|
async def async_set_charging_current(self, charging_current: float) -> None:
|
|
"""Set maximum charging current for Wallbox."""
|
|
await self.hass.async_add_executor_job(
|
|
self._set_charging_current, charging_current
|
|
)
|
|
await self.async_request_refresh()
|
|
|
|
def _set_lock_unlock(self, lock: bool) -> None:
|
|
"""Set wallbox to locked or unlocked."""
|
|
try:
|
|
self._authenticate()
|
|
if lock:
|
|
self._wallbox.lockCharger(self._station)
|
|
else:
|
|
self._wallbox.unlockCharger(self._station)
|
|
except requests.exceptions.HTTPError as wallbox_connection_error:
|
|
if wallbox_connection_error.response.status_code == 403:
|
|
raise InvalidAuth from wallbox_connection_error
|
|
raise ConnectionError from wallbox_connection_error
|
|
|
|
async def async_set_lock_unlock(self, lock: bool) -> None:
|
|
"""Set wallbox to locked or unlocked."""
|
|
await self.hass.async_add_executor_job(self._set_lock_unlock, lock)
|
|
await self.async_request_refresh()
|
|
|
|
|
|
async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
|
|
"""Set up Wallbox from a config entry."""
|
|
wallbox = Wallbox(entry.data[CONF_USERNAME], entry.data[CONF_PASSWORD])
|
|
wallbox_coordinator = WallboxCoordinator(
|
|
entry.data[CONF_STATION],
|
|
wallbox,
|
|
hass,
|
|
)
|
|
|
|
try:
|
|
await wallbox_coordinator.async_validate_input()
|
|
|
|
except InvalidAuth as ex:
|
|
raise ConfigEntryAuthFailed from ex
|
|
|
|
await wallbox_coordinator.async_config_entry_first_refresh()
|
|
|
|
hass.data.setdefault(DOMAIN, {})[entry.entry_id] = wallbox_coordinator
|
|
|
|
hass.config_entries.async_setup_platforms(entry, PLATFORMS)
|
|
|
|
return True
|
|
|
|
|
|
async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
|
|
"""Unload a config entry."""
|
|
unload_ok = await hass.config_entries.async_unload_platforms(entry, PLATFORMS)
|
|
if unload_ok:
|
|
hass.data[DOMAIN].pop(entry.entry_id)
|
|
|
|
return unload_ok
|
|
|
|
|
|
class InvalidAuth(HomeAssistantError):
|
|
"""Error to indicate there is invalid auth."""
|
|
|
|
|
|
class WallboxEntity(CoordinatorEntity[WallboxCoordinator]):
|
|
"""Defines a base Wallbox entity."""
|
|
|
|
@property
|
|
def device_info(self) -> DeviceInfo:
|
|
"""Return device information about this Wallbox device."""
|
|
return DeviceInfo(
|
|
identifiers={
|
|
(
|
|
DOMAIN,
|
|
self.coordinator.data[CHARGER_DATA_KEY][CHARGER_SERIAL_NUMBER_KEY],
|
|
)
|
|
},
|
|
name=f"Wallbox - {self.coordinator.data[CHARGER_NAME_KEY]}",
|
|
manufacturer="Wallbox",
|
|
model=self.coordinator.data[CHARGER_DATA_KEY][CHARGER_PART_NUMBER_KEY],
|
|
sw_version=self.coordinator.data[CHARGER_DATA_KEY][CHARGER_SOFTWARE_KEY][
|
|
CHARGER_CURRENT_VERSION_KEY
|
|
],
|
|
)
|