128 lines
4.4 KiB
Python
128 lines
4.4 KiB
Python
"""Support for ISY select entities."""
|
|
from __future__ import annotations
|
|
|
|
from typing import cast
|
|
|
|
from pyisy.constants import (
|
|
COMMAND_FRIENDLY_NAME,
|
|
INSTEON_RAMP_RATES,
|
|
ISY_VALUE_UNKNOWN,
|
|
PROP_RAMP_RATE,
|
|
UOM_TO_STATES,
|
|
)
|
|
from pyisy.helpers import NodeProperty
|
|
|
|
from homeassistant.components.select import SelectEntity, SelectEntityDescription
|
|
from homeassistant.config_entries import ConfigEntry
|
|
from homeassistant.const import Platform, UnitOfTime
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.helpers.entity import EntityCategory
|
|
from homeassistant.helpers.entity_platform import AddEntitiesCallback
|
|
|
|
from .const import _LOGGER, DOMAIN, UOM_INDEX
|
|
from .entity import ISYAuxControlEntity
|
|
from .models import IsyData
|
|
|
|
|
|
def time_string(i: int) -> str:
|
|
"""Return a formatted ramp rate time string."""
|
|
if i >= 60:
|
|
return f"{(float(i)/60):.1f} {UnitOfTime.MINUTES}"
|
|
return f"{i} {UnitOfTime.SECONDS}"
|
|
|
|
|
|
RAMP_RATE_OPTIONS = [time_string(rate) for rate in INSTEON_RAMP_RATES.values()]
|
|
|
|
|
|
async def async_setup_entry(
|
|
hass: HomeAssistant,
|
|
config_entry: ConfigEntry,
|
|
async_add_entities: AddEntitiesCallback,
|
|
) -> None:
|
|
"""Set up ISY/IoX select entities from config entry."""
|
|
isy_data: IsyData = hass.data[DOMAIN][config_entry.entry_id]
|
|
isy = isy_data.root
|
|
device_info = isy_data.devices
|
|
entities: list[ISYAuxControlIndexSelectEntity | ISYRampRateSelectEntity] = []
|
|
|
|
for node, control in isy_data.aux_properties[Platform.SELECT]:
|
|
name = COMMAND_FRIENDLY_NAME.get(control, control).replace("_", " ").title()
|
|
if node.address != node.primary_node:
|
|
name = f"{node.name} {name}"
|
|
|
|
node_prop: NodeProperty = node.aux_properties[control]
|
|
|
|
options = []
|
|
if control == PROP_RAMP_RATE:
|
|
options = RAMP_RATE_OPTIONS
|
|
if node_prop.uom == UOM_INDEX:
|
|
if options_dict := UOM_TO_STATES.get(node_prop.uom):
|
|
options = list(options_dict.values())
|
|
|
|
description = SelectEntityDescription(
|
|
key=f"{node.address}_{control}",
|
|
name=name,
|
|
entity_category=EntityCategory.CONFIG,
|
|
options=options,
|
|
)
|
|
entity_detail = {
|
|
"node": node,
|
|
"control": control,
|
|
"unique_id": f"{isy.uuid}_{node.address}_{control}",
|
|
"description": description,
|
|
"device_info": device_info.get(node.primary_node),
|
|
}
|
|
|
|
if control == PROP_RAMP_RATE:
|
|
entities.append(ISYRampRateSelectEntity(**entity_detail))
|
|
continue
|
|
if node.uom == UOM_INDEX and options:
|
|
entities.append(ISYAuxControlIndexSelectEntity(**entity_detail))
|
|
continue
|
|
# Future: support Node Server custom index UOMs
|
|
_LOGGER.debug(
|
|
"ISY missing node index unit definitions for %s: %s", node.name, name
|
|
)
|
|
async_add_entities(entities)
|
|
|
|
|
|
class ISYRampRateSelectEntity(ISYAuxControlEntity, SelectEntity):
|
|
"""Representation of a ISY/IoX Aux Control Ramp Rate Select entity."""
|
|
|
|
@property
|
|
def current_option(self) -> str | None:
|
|
"""Return the selected entity option to represent the entity state."""
|
|
node_prop: NodeProperty = self._node.aux_properties[self._control]
|
|
if node_prop.value == ISY_VALUE_UNKNOWN:
|
|
return None
|
|
|
|
return RAMP_RATE_OPTIONS[int(node_prop.value)]
|
|
|
|
async def async_select_option(self, option: str) -> None:
|
|
"""Change the selected option."""
|
|
|
|
await self._node.set_ramp_rate(RAMP_RATE_OPTIONS.index(option))
|
|
|
|
|
|
class ISYAuxControlIndexSelectEntity(ISYAuxControlEntity, SelectEntity):
|
|
"""Representation of a ISY/IoX Aux Control Index Select entity."""
|
|
|
|
@property
|
|
def current_option(self) -> str | None:
|
|
"""Return the selected entity option to represent the entity state."""
|
|
node_prop: NodeProperty = self._node.aux_properties[self._control]
|
|
if node_prop.value == ISY_VALUE_UNKNOWN:
|
|
return None
|
|
|
|
if options_dict := UOM_TO_STATES.get(node_prop.uom):
|
|
return cast(str, options_dict.get(node_prop.value, node_prop.value))
|
|
return cast(str, node_prop.formatted)
|
|
|
|
async def async_select_option(self, option: str) -> None:
|
|
"""Change the selected option."""
|
|
node_prop: NodeProperty = self._node.aux_properties[self._control]
|
|
|
|
await self._node.send_cmd(
|
|
self._control, val=self.options.index(option), uom=node_prop.uom
|
|
)
|