Home-Assistant
/
core
mirror of https://github.com/home-assistant/core.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
core/homeassistant/components/tuya/select.py

426 lines
14 KiB
Python
Raw Blame History

"""Support for Tuya select."""
from __future__ import annotations
from tuya_iot import TuyaDevice, TuyaDeviceManager
from homeassistant.components.select import SelectEntity, SelectEntityDescription
from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant, callback
from homeassistant.helpers.dispatcher import async_dispatcher_connect
from homeassistant.helpers.entity import EntityCategory
from homeassistant.helpers.entity_platform import AddEntitiesCallback
from . import HomeAssistantTuyaData
from .base import TuyaEntity
from .const import DOMAIN, TUYA_DISCOVERY_NEW, DPCode, DPType, TuyaDeviceClass
# All descriptions can be found here. Mostly the Enum data types in the
# default instructions set of each category end up being a select.
# https://developer.tuya.com/en/docs/iot/standarddescription?id=K9i5ql6waswzq
SELECTS: dict[str, tuple[SelectEntityDescription, ...]] = {
# Multi-functional Sensor
# https://developer.tuya.com/en/docs/iot/categorydgnbj?id=Kaiuz3yorvzg3
"dgnbj": (
SelectEntityDescription(
key=DPCode.ALARM_VOLUME,
name="Volume",
entity_category=EntityCategory.CONFIG,
),
),
# Coffee maker
# https://developer.tuya.com/en/docs/iot/categorykfj?id=Kaiuz2p12pc7f
"kfj": (
SelectEntityDescription(
key=DPCode.CUP_NUMBER,
name="Cups",
icon="mdi:numeric",
),
SelectEntityDescription(
key=DPCode.CONCENTRATION_SET,
name="Concentration",
icon="mdi:altimeter",
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.MATERIAL,
name="Material",
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.MODE,
name="Mode",
icon="mdi:coffee",
),
),
# Switch
# https://developer.tuya.com/en/docs/iot/s?id=K9gf7o5prgf7s
"kg": (
SelectEntityDescription(
key=DPCode.RELAY_STATUS,
name="Power on Behavior",
device_class=TuyaDeviceClass.RELAY_STATUS,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.LIGHT_MODE,
name="Indicator Light Mode",
device_class=TuyaDeviceClass.LIGHT_MODE,
entity_category=EntityCategory.CONFIG,
),
),
# Heater
# https://developer.tuya.com/en/docs/iot/categoryqn?id=Kaiuz18kih0sm
"qn": (
SelectEntityDescription(
key=DPCode.LEVEL,
name="Temperature Level",
icon="mdi:thermometer-lines",
),
),
# Siren Alarm
# https://developer.tuya.com/en/docs/iot/categorysgbj?id=Kaiuz37tlpbnu
"sgbj": (
SelectEntityDescription(
key=DPCode.ALARM_VOLUME,
name="Volume",
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.BRIGHT_STATE,
name="Brightness",
entity_category=EntityCategory.CONFIG,
),
),
# Smart Camera
# https://developer.tuya.com/en/docs/iot/categorysp?id=Kaiuz35leyo12
"sp": (
SelectEntityDescription(
key=DPCode.IPC_WORK_MODE,
name="IPC Mode",
device_class=TuyaDeviceClass.IPC_WORK_MODE,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.DECIBEL_SENSITIVITY,
name="Sound Detection Sensitivity",
icon="mdi:volume-vibrate",
device_class=TuyaDeviceClass.DECIBEL_SENSITIVITY,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.RECORD_MODE,
name="Record Mode",
icon="mdi:record-rec",
device_class=TuyaDeviceClass.RECORD_MODE,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.BASIC_NIGHTVISION,
name="Night Vision",
icon="mdi:theme-light-dark",
device_class=TuyaDeviceClass.BASIC_NIGHTVISION,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.BASIC_ANTI_FLICKER,
name="Anti-flicker",
icon="mdi:image-outline",
device_class=TuyaDeviceClass.BASIC_ANTI_FLICKR,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.MOTION_SENSITIVITY,
name="Motion Detection Sensitivity",
icon="mdi:motion-sensor",
device_class=TuyaDeviceClass.MOTION_SENSITIVITY,
entity_category=EntityCategory.CONFIG,
),
),
# IoT Switch?
# Note: Undocumented
"tdq": (
SelectEntityDescription(
key=DPCode.RELAY_STATUS,
name="Power on Behavior",
device_class=TuyaDeviceClass.RELAY_STATUS,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.LIGHT_MODE,
name="Indicator Light Mode",
device_class=TuyaDeviceClass.LIGHT_MODE,
entity_category=EntityCategory.CONFIG,
),
),
# Dimmer Switch
# https://developer.tuya.com/en/docs/iot/categorytgkg?id=Kaiuz0ktx7m0o
"tgkg": (
SelectEntityDescription(
key=DPCode.RELAY_STATUS,
name="Power on Behavior",
device_class=TuyaDeviceClass.RELAY_STATUS,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.LIGHT_MODE,
name="Indicator Light Mode",
device_class=TuyaDeviceClass.LIGHT_MODE,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.LED_TYPE_1,
name="Light Source Type",
device_class=TuyaDeviceClass.LED_TYPE,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.LED_TYPE_2,
name="Light 2 Source Type",
device_class=TuyaDeviceClass.LED_TYPE,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.LED_TYPE_3,
name="Light 3 Source Type",
device_class=TuyaDeviceClass.LED_TYPE,
entity_category=EntityCategory.CONFIG,
),
),
# Dimmer
# https://developer.tuya.com/en/docs/iot/tgq?id=Kaof8ke9il4k4
"tgq": (
SelectEntityDescription(
key=DPCode.LED_TYPE_1,
name="Light Source Type",
device_class=TuyaDeviceClass.LED_TYPE,
entity_category=EntityCategory.CONFIG,
),
SelectEntityDescription(
key=DPCode.LED_TYPE_2,
name="Light 2 Source Type",
device_class=TuyaDeviceClass.LED_TYPE,
entity_category=EntityCategory.CONFIG,
),
),
# Fingerbot
"szjqr": (
SelectEntityDescription(
key=DPCode.MODE,
name="Mode",
device_class=TuyaDeviceClass.FINGERBOT_MODE,
entity_category=EntityCategory.CONFIG,
),
),
# Robot Vacuum
# https://developer.tuya.com/en/docs/iot/fsd?id=K9gf487ck1tlo
"sd": (
SelectEntityDescription(
key=DPCode.CISTERN,
name="Water Tank Adjustment",
entity_category=EntityCategory.CONFIG,
device_class=TuyaDeviceClass.VACUUM_CISTERN,
icon="mdi:water-opacity",
),
SelectEntityDescription(
key=DPCode.COLLECTION_MODE,
name="Dust Collection Mode",
entity_category=EntityCategory.CONFIG,
device_class=TuyaDeviceClass.VACUUM_COLLECTION,
icon="mdi:air-filter",
),
SelectEntityDescription(
key=DPCode.MODE,
name="Mode",
entity_category=EntityCategory.CONFIG,
device_class=TuyaDeviceClass.VACUUM_MODE,
icon="mdi:layers-outline",
),
),
# Fan
# https://developer.tuya.com/en/docs/iot/f?id=K9gf45vs7vkge
"fs": (
SelectEntityDescription(
key=DPCode.FAN_VERTICAL,
name="Vertical Swing Flap Angle",
device_class=TuyaDeviceClass.FAN_ANGLE,
entity_category=EntityCategory.CONFIG,
icon="mdi:format-vertical-align-center",
),
SelectEntityDescription(
key=DPCode.FAN_HORIZONTAL,
name="Horizontal Swing Flap Angle",
device_class=TuyaDeviceClass.FAN_ANGLE,
entity_category=EntityCategory.CONFIG,
icon="mdi:format-horizontal-align-center",
),
SelectEntityDescription(
key=DPCode.COUNTDOWN,
name="Countdown",
device_class=TuyaDeviceClass.COUNTDOWN,
entity_category=EntityCategory.CONFIG,
icon="mdi:timer-cog-outline",
),
SelectEntityDescription(
key=DPCode.COUNTDOWN_SET,
name="Countdown",
device_class=TuyaDeviceClass.COUNTDOWN,
entity_category=EntityCategory.CONFIG,
icon="mdi:timer-cog-outline",
),
),
# Curtain
# https://developer.tuya.com/en/docs/iot/f?id=K9gf46o5mtfyc
"cl": (
SelectEntityDescription(
key=DPCode.CONTROL_BACK_MODE,
name="Motor Mode",
device_class=TuyaDeviceClass.CURTAIN_MOTOR_MODE,
entity_category=EntityCategory.CONFIG,
icon="mdi:swap-horizontal",
),
SelectEntityDescription(
key=DPCode.MODE,
name="Mode",
device_class=TuyaDeviceClass.CURTAIN_MODE,
entity_category=EntityCategory.CONFIG,
),
),
# Humidifier
# https://developer.tuya.com/en/docs/iot/categoryjsq?id=Kaiuz1smr440b
"jsq": (
SelectEntityDescription(
key=DPCode.SPRAY_MODE,
name="Spray Mode",
device_class=TuyaDeviceClass.HUMIDIFIER_SPRAY_MODE,
entity_category=EntityCategory.CONFIG,
icon="mdi:spray",
),
SelectEntityDescription(
key=DPCode.LEVEL,
name="Spraying Level",
device_class=TuyaDeviceClass.HUMIDIFIER_LEVEL,
entity_category=EntityCategory.CONFIG,
icon="mdi:spray",
),
SelectEntityDescription(
key=DPCode.MOODLIGHTING,
name="Moodlighting",
device_class=TuyaDeviceClass.HUMIDIFIER_MOODLIGHTING,
entity_category=EntityCategory.CONFIG,
icon="mdi:lightbulb-multiple",
),
SelectEntityDescription(
key=DPCode.COUNTDOWN,
name="Countdown",
device_class=TuyaDeviceClass.COUNTDOWN,
entity_category=EntityCategory.CONFIG,
icon="mdi:timer-cog-outline",
),
SelectEntityDescription(
key=DPCode.COUNTDOWN_SET,
name="Countdown",
device_class=TuyaDeviceClass.COUNTDOWN,
entity_category=EntityCategory.CONFIG,
icon="mdi:timer-cog-outline",
),
),
# Air Purifier
# https://developer.tuya.com/en/docs/iot/f?id=K9gf46h2s6dzm
"kj": (
SelectEntityDescription(
key=DPCode.COUNTDOWN,
name="Countdown",
device_class=TuyaDeviceClass.COUNTDOWN,
entity_category=EntityCategory.CONFIG,
icon="mdi:timer-cog-outline",
),
SelectEntityDescription(
key=DPCode.COUNTDOWN_SET,
name="Countdown",
device_class=TuyaDeviceClass.COUNTDOWN,
entity_category=EntityCategory.CONFIG,
icon="mdi:timer-cog-outline",
),
),
}
# Socket (duplicate of `kg`)
# https://developer.tuya.com/en/docs/iot/s?id=K9gf7o5prgf7s
SELECTS["cz"] = SELECTS["kg"]
# Power Socket (duplicate of `kg`)
# https://developer.tuya.com/en/docs/iot/s?id=K9gf7o5prgf7s
SELECTS["pc"] = SELECTS["kg"]
async def async_setup_entry(
hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback
) -> None:
"""Set up Tuya select dynamically through Tuya discovery."""
hass_data: HomeAssistantTuyaData = hass.data[DOMAIN][entry.entry_id]
@callback
def async_discover_device(device_ids: list[str]) -> None:
"""Discover and add a discovered Tuya select."""
entities: list[TuyaSelectEntity] = []
for device_id in device_ids:
device = hass_data.device_manager.device_map[device_id]
if descriptions := SELECTS.get(device.category):
for description in descriptions:
if description.key in device.status:
entities.append(
TuyaSelectEntity(
device, hass_data.device_manager, description
)
)
async_add_entities(entities)
async_discover_device([*hass_data.device_manager.device_map])
entry.async_on_unload(
async_dispatcher_connect(hass, TUYA_DISCOVERY_NEW, async_discover_device)
)
class TuyaSelectEntity(TuyaEntity, SelectEntity):
"""Tuya Select Entity."""
def __init__(
self,
device: TuyaDevice,
device_manager: TuyaDeviceManager,
description: SelectEntityDescription,
) -> None:
"""Init Tuya sensor."""
super().__init__(device, device_manager)
self.entity_description = description
self._attr_unique_id = f"{super().unique_id}{description.key}"
self._attr_opions: list[str] = []
if enum_type := self.find_dpcode(
description.key, dptype=DPType.ENUM, prefer_function=True
):
self._attr_options = enum_type.range
@property
def current_option(self) -> str | None:
"""Return the selected entity option to represent the entity state."""
# Raw value
value = self.device.status.get(self.entity_description.key)
if value is None or value not in self._attr_options:
return None
return value
def select_option(self, option: str) -> None:
"""Change the selected option."""
self._send_command(
[
{
"code": self.entity_description.key,
"value": option,
}
]
)
Reference in New Issue View Git Blame Copy Permalink