This commit is contained in:
Gavin 2025-08-04 11:28:17 +08:00 committed by GitHub
commit ea163b33e0
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
7 changed files with 3303 additions and 2722 deletions

View File

@ -45,13 +45,15 @@ off Xiaomi or its affiliates' products.
Light entities for Xiaomi Home. Light entities for Xiaomi Home.
""" """
from __future__ import annotations from __future__ import annotations
import logging import logging
from typing import Any, Optional from typing import Any, Optional, List, Dict
from homeassistant.config_entries import ConfigEntry from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.helpers.entity_registry import async_get as async_get_entity_registry
from homeassistant.components.light import ( from homeassistant.components.light import (
ATTR_BRIGHTNESS, ATTR_BRIGHTNESS,
ATTR_COLOR_TEMP_KELVIN, ATTR_COLOR_TEMP_KELVIN,
@ -59,34 +61,31 @@ from homeassistant.components.light import (
ATTR_EFFECT, ATTR_EFFECT,
LightEntity, LightEntity,
LightEntityFeature, LightEntityFeature,
ColorMode ColorMode,
)
from homeassistant.util.color import (
value_to_brightness,
brightness_to_value
) )
from homeassistant.util.color import value_to_brightness, brightness_to_value
from .miot.miot_spec import MIoTSpecProperty from .miot.miot_spec import MIoTSpecProperty
from .miot.miot_device import MIoTDevice, MIoTEntityData, MIoTServiceEntity from .miot.miot_device import MIoTDevice, MIoTEntityData, MIoTServiceEntity
from .miot.const import DOMAIN from .miot.const import DOMAIN
_LOGGER = logging.getLogger(__name__) _LOGGER = logging.getLogger(__name__)
async def async_setup_entry( async def async_setup_entry(
hass: HomeAssistant, hass: HomeAssistant,
config_entry: ConfigEntry, config_entry: ConfigEntry,
async_add_entities: AddEntitiesCallback, async_add_entities: AddEntitiesCallback,
) -> None: ) -> None:
"""Set up a config entry.""" """Set up a config entry."""
device_list: list[MIoTDevice] = hass.data[DOMAIN]['devices'][ device_list: list[MIoTDevice] = hass.data[DOMAIN]["devices"][
config_entry.entry_id] config_entry.entry_id]
new_entities = [] new_entities = []
for miot_device in device_list: for miot_device in device_list:
for data in miot_device.entity_list.get('light', []): for data in miot_device.entity_list.get("light", []):
new_entities.append( new_entities.append(
Light(miot_device=miot_device, entity_data=data)) Light(miot_device=miot_device, entity_data=data, hass=hass))
if new_entities: if new_entities:
async_add_entities(new_entities) async_add_entities(new_entities)
@ -94,6 +93,7 @@ async def async_setup_entry(
class Light(MIoTServiceEntity, LightEntity): class Light(MIoTServiceEntity, LightEntity):
"""Light entities for Xiaomi Home.""" """Light entities for Xiaomi Home."""
# pylint: disable=unused-argument # pylint: disable=unused-argument
_VALUE_RANGE_MODE_COUNT_MAX = 30 _VALUE_RANGE_MODE_COUNT_MAX = 30
_prop_on: Optional[MIoTSpecProperty] _prop_on: Optional[MIoTSpecProperty]
@ -105,16 +105,17 @@ class Light(MIoTServiceEntity, LightEntity):
_brightness_scale: Optional[tuple[int, int]] _brightness_scale: Optional[tuple[int, int]]
_mode_map: Optional[dict[Any, Any]] _mode_map: Optional[dict[Any, Any]]
def __init__( def __init__(self, miot_device: MIoTDevice, entity_data: MIoTEntityData,
self, miot_device: MIoTDevice, entity_data: MIoTEntityData hass: HomeAssistant) -> None:
) -> None:
"""Initialize the Light.""" """Initialize the Light."""
super().__init__(miot_device=miot_device, entity_data=entity_data) super().__init__(miot_device=miot_device, entity_data=entity_data)
self.hass = hass
self._attr_color_mode = None self._attr_color_mode = None
self._attr_supported_color_modes = set() self._attr_supported_color_modes = set()
self._attr_supported_features = LightEntityFeature(0) self._attr_supported_features = LightEntityFeature(0)
if miot_device.did.startswith('group.'): self.miot_device = miot_device
self._attr_icon = 'mdi:lightbulb-group' if miot_device.did.startswith("group."):
self._attr_icon = "mdi:lightbulb-group"
self._prop_on = None self._prop_on = None
self._prop_brightness = None self._prop_brightness = None
@ -123,37 +124,38 @@ class Light(MIoTServiceEntity, LightEntity):
self._prop_mode = None self._prop_mode = None
self._brightness_scale = None self._brightness_scale = None
self._mode_map = None self._mode_map = None
self._command_send_mode_entity_id = None
# properties # properties
for prop in entity_data.props: for prop in entity_data.props:
# on # on
if prop.name == 'on': if prop.name == "on":
self._prop_on = prop self._prop_on = prop
# brightness # brightness
if prop.name == 'brightness': if prop.name == "brightness":
if prop.value_range: if prop.value_range:
self._brightness_scale = ( self._brightness_scale = (
prop.value_range.min_, prop.value_range.max_) prop.value_range.min_,
prop.value_range.max_,
)
self._prop_brightness = prop self._prop_brightness = prop
elif ( elif self._mode_map is None and prop.value_list:
self._mode_map is None
and prop.value_list
):
# For value-list brightness # For value-list brightness
self._mode_map = prop.value_list.to_map() self._mode_map = prop.value_list.to_map()
self._attr_effect_list = list(self._mode_map.values()) self._attr_effect_list = list(self._mode_map.values())
self._attr_supported_features |= LightEntityFeature.EFFECT self._attr_supported_features |= LightEntityFeature.EFFECT
self._prop_mode = prop self._prop_mode = prop
else: else:
_LOGGER.info( _LOGGER.info("invalid brightness format, %s",
'invalid brightness format, %s', self.entity_id) self.entity_id)
continue continue
# color-temperature # color-temperature
if prop.name == 'color-temperature': if prop.name == "color-temperature":
if not prop.value_range: if not prop.value_range:
_LOGGER.info( _LOGGER.info(
'invalid color-temperature value_range format, %s', "invalid color-temperature value_range format, %s",
self.entity_id) self.entity_id,
)
continue continue
self._attr_min_color_temp_kelvin = prop.value_range.min_ self._attr_min_color_temp_kelvin = prop.value_range.min_
self._attr_max_color_temp_kelvin = prop.value_range.max_ self._attr_max_color_temp_kelvin = prop.value_range.max_
@ -161,40 +163,40 @@ class Light(MIoTServiceEntity, LightEntity):
self._attr_color_mode = ColorMode.COLOR_TEMP self._attr_color_mode = ColorMode.COLOR_TEMP
self._prop_color_temp = prop self._prop_color_temp = prop
# color # color
if prop.name == 'color': if prop.name == "color":
self._attr_supported_color_modes.add(ColorMode.RGB) self._attr_supported_color_modes.add(ColorMode.RGB)
self._attr_color_mode = ColorMode.RGB self._attr_color_mode = ColorMode.RGB
self._prop_color = prop self._prop_color = prop
# mode # mode
if prop.name == 'mode': if prop.name == "mode":
mode_list = None mode_list = None
if prop.value_list: if prop.value_list:
mode_list = prop.value_list.to_map() mode_list = prop.value_list.to_map()
elif prop.value_range: elif prop.value_range:
mode_list = {} mode_list = {}
if ( if (int((prop.value_range.max_ - prop.value_range.min_) /
int(( prop.value_range.step)
prop.value_range.max_ > self._VALUE_RANGE_MODE_COUNT_MAX):
- prop.value_range.min_
) / prop.value_range.step)
> self._VALUE_RANGE_MODE_COUNT_MAX
):
_LOGGER.error( _LOGGER.error(
'too many mode values, %s, %s, %s', "too many mode values, %s, %s, %s",
self.entity_id, prop.name, prop.value_range) self.entity_id,
prop.name,
prop.value_range,
)
else: else:
for value in range( for value in range(
prop.value_range.min_, prop.value_range.min_,
prop.value_range.max_, prop.value_range.max_,
prop.value_range.step): prop.value_range.step,
mode_list[value] = f'mode {value}' ):
mode_list[value] = f"mode {value}"
if mode_list: if mode_list:
self._mode_map = mode_list self._mode_map = mode_list
self._attr_effect_list = list(self._mode_map.values()) self._attr_effect_list = list(self._mode_map.values())
self._attr_supported_features |= LightEntityFeature.EFFECT self._attr_supported_features |= LightEntityFeature.EFFECT
self._prop_mode = prop self._prop_mode = prop
else: else:
_LOGGER.info('invalid mode format, %s', self.entity_id) _LOGGER.info("invalid mode format, %s", self.entity_id)
continue continue
if not self._attr_supported_color_modes: if not self._attr_supported_color_modes:
@ -241,9 +243,8 @@ class Light(MIoTServiceEntity, LightEntity):
@property @property
def effect(self) -> Optional[str]: def effect(self) -> Optional[str]:
"""Return the current mode.""" """Return the current mode."""
return self.get_map_value( return self.get_map_value(map_=self._mode_map,
map_=self._mode_map, key=self.get_prop_value(prop=self._prop_mode))
key=self.get_prop_value(prop=self._prop_mode))
async def async_turn_on(self, **kwargs) -> None: async def async_turn_on(self, **kwargs) -> None:
"""Turn the light on. """Turn the light on.
@ -252,42 +253,176 @@ class Light(MIoTServiceEntity, LightEntity):
""" """
# on # on
# Dirty logic for lumi.gateway.mgl03 indicator light # Dirty logic for lumi.gateway.mgl03 indicator light
if self._prop_on: # Determine whether the device sends the light-on properties in batches or one by one
value_on = True if self._prop_on.format_ == bool else 1 # Search entityid through unique_id to avoid the user modifying entityid and causing command_send_mode to not match
await self.set_property_async( if self._command_send_mode_entity_id is None:
prop=self._prop_on, value=value_on) entity_registry = async_get_entity_registry(self.hass)
# brightness device_id = list(
self.miot_device.device_info.get("identifiers"))[0][1]
self._command_send_mode_entity_id = entity_registry.async_get_entity_id(
"select", DOMAIN, f"select.light_{device_id}_command_send_mode")
if self._command_send_mode_entity_id is None:
_LOGGER.error(
"light command_send_mode not found, %s",
self.entity_id,
)
return
command_send_mode = self.hass.states.get(
self._command_send_mode_entity_id)
send_brightness_first = False
if ATTR_BRIGHTNESS in kwargs: if ATTR_BRIGHTNESS in kwargs:
brightness = brightness_to_value( brightness_new = kwargs[ATTR_BRIGHTNESS]
self._brightness_scale, kwargs[ATTR_BRIGHTNESS]) brightness_old = self.brightness
await self.set_property_async( if brightness_old and brightness_new <= brightness_old:
prop=self._prop_brightness, value=brightness, send_brightness_first = True
write_ha_state=False) if command_send_mode and command_send_mode.state == "Send Together":
# color-temperature set_properties_list: List[Dict[str, Any]] = []
if ATTR_COLOR_TEMP_KELVIN in kwargs: # mode
await self.set_property_async( if ATTR_EFFECT in kwargs:
prop=self._prop_color_temp, set_properties_list.append({
value=kwargs[ATTR_COLOR_TEMP_KELVIN], "prop":
write_ha_state=False) self._prop_mode,
self._attr_color_mode = ColorMode.COLOR_TEMP "value":
# rgb color self.get_map_key(map_=self._mode_map,
if ATTR_RGB_COLOR in kwargs: value=kwargs[ATTR_EFFECT]),
r = kwargs[ATTR_RGB_COLOR][0] })
g = kwargs[ATTR_RGB_COLOR][1] # brightness
b = kwargs[ATTR_RGB_COLOR][2] if send_brightness_first and ATTR_BRIGHTNESS in kwargs:
rgb = (r << 16) | (g << 8) | b brightness = brightness_to_value(self._brightness_scale,
await self.set_property_async( kwargs[ATTR_BRIGHTNESS])
prop=self._prop_color, value=rgb, set_properties_list.append({
write_ha_state=False) "prop": self._prop_brightness,
self._attr_color_mode = ColorMode.RGB "value": brightness
# mode })
if ATTR_EFFECT in kwargs: # color-temperature
await self.set_property_async( if ATTR_COLOR_TEMP_KELVIN in kwargs:
prop=self._prop_mode, set_properties_list.append({
value=self.get_map_key( "prop": self._prop_color_temp,
map_=self._mode_map, value=kwargs[ATTR_EFFECT]), "value": kwargs[ATTR_COLOR_TEMP_KELVIN],
write_ha_state=False) })
self.async_write_ha_state() self._attr_color_mode = ColorMode.COLOR_TEMP
# rgb color
if ATTR_RGB_COLOR in kwargs:
r = kwargs[ATTR_RGB_COLOR][0]
g = kwargs[ATTR_RGB_COLOR][1]
b = kwargs[ATTR_RGB_COLOR][2]
rgb = (r << 16) | (g << 8) | b
set_properties_list.append({
"prop": self._prop_color,
"value": rgb
})
self._attr_color_mode = ColorMode.RGB
# brightness
if not send_brightness_first and ATTR_BRIGHTNESS in kwargs:
brightness = brightness_to_value(self._brightness_scale,
kwargs[ATTR_BRIGHTNESS])
set_properties_list.append({
"prop": self._prop_brightness,
"value": brightness
})
if self._prop_on:
value_on = True if self._prop_on.format_ == bool else 1 # noqa: E721
set_properties_list.append({
"prop": self._prop_on,
"value": value_on
})
await self.set_properties_async(set_properties_list)
self.async_write_ha_state()
elif command_send_mode and command_send_mode.state == "Send Turn On First":
set_properties_list: List[Dict[str, Any]] = []
if self._prop_on:
value_on = True if self._prop_on.format_ == bool else 1 # noqa: E721
set_properties_list.append({
"prop": self._prop_on,
"value": value_on
})
# mode
if ATTR_EFFECT in kwargs:
set_properties_list.append({
"prop":
self._prop_mode,
"value":
self.get_map_key(map_=self._mode_map,
value=kwargs[ATTR_EFFECT]),
})
# brightness
if send_brightness_first and ATTR_BRIGHTNESS in kwargs:
brightness = brightness_to_value(self._brightness_scale,
kwargs[ATTR_BRIGHTNESS])
set_properties_list.append({
"prop": self._prop_brightness,
"value": brightness
})
# color-temperature
if ATTR_COLOR_TEMP_KELVIN in kwargs:
set_properties_list.append({
"prop": self._prop_color_temp,
"value": kwargs[ATTR_COLOR_TEMP_KELVIN],
})
self._attr_color_mode = ColorMode.COLOR_TEMP
# rgb color
if ATTR_RGB_COLOR in kwargs:
r = kwargs[ATTR_RGB_COLOR][0]
g = kwargs[ATTR_RGB_COLOR][1]
b = kwargs[ATTR_RGB_COLOR][2]
rgb = (r << 16) | (g << 8) | b
set_properties_list.append({
"prop": self._prop_color,
"value": rgb
})
self._attr_color_mode = ColorMode.RGB
# brightness
if not send_brightness_first and ATTR_BRIGHTNESS in kwargs:
brightness = brightness_to_value(self._brightness_scale,
kwargs[ATTR_BRIGHTNESS])
set_properties_list.append({
"prop": self._prop_brightness,
"value": brightness
})
await self.set_properties_async(set_properties_list)
self.async_write_ha_state()
else:
if self._prop_on:
value_on = True if self._prop_on.format_ == bool else 1 # noqa: E721
await self.set_property_async(prop=self._prop_on,
value=value_on)
# color-temperature
if ATTR_COLOR_TEMP_KELVIN in kwargs:
await self.set_property_async(
prop=self._prop_color_temp,
value=kwargs[ATTR_COLOR_TEMP_KELVIN],
write_ha_state=False,
)
self._attr_color_mode = ColorMode.COLOR_TEMP
# rgb color
if ATTR_RGB_COLOR in kwargs:
r = kwargs[ATTR_RGB_COLOR][0]
g = kwargs[ATTR_RGB_COLOR][1]
b = kwargs[ATTR_RGB_COLOR][2]
rgb = (r << 16) | (g << 8) | b
await self.set_property_async(prop=self._prop_color,
value=rgb,
write_ha_state=False)
self._attr_color_mode = ColorMode.RGB
# brightness
if ATTR_BRIGHTNESS in kwargs:
brightness = brightness_to_value(self._brightness_scale,
kwargs[ATTR_BRIGHTNESS])
await self.set_property_async(prop=self._prop_brightness,
value=brightness,
write_ha_state=False)
# mode
if ATTR_EFFECT in kwargs:
await self.set_property_async(
prop=self._prop_mode,
value=self.get_map_key(map_=self._mode_map,
value=kwargs[ATTR_EFFECT]),
write_ha_state=False,
)
self.async_write_ha_state()
async def async_turn_off(self, **kwargs) -> None: async def async_turn_off(self, **kwargs) -> None:
"""Turn the light off.""" """Turn the light off."""

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -45,18 +45,24 @@ off Xiaomi or its affiliates' products.
Select entities for Xiaomi Home. Select entities for Xiaomi Home.
""" """
from __future__ import annotations from __future__ import annotations
import logging
from typing import Optional from typing import Optional
from homeassistant.config_entries import ConfigEntry from homeassistant.config_entries import ConfigEntry
from homeassistant.core import HomeAssistant from homeassistant.core import HomeAssistant
from homeassistant.helpers.entity_platform import AddEntitiesCallback from homeassistant.helpers.entity_platform import AddEntitiesCallback
from homeassistant.components.select import SelectEntity from homeassistant.components.select import SelectEntity
from homeassistant.helpers.entity import EntityCategory
from homeassistant.helpers.restore_state import RestoreEntity
from .miot.const import DOMAIN from .miot.const import DOMAIN
from .miot.miot_device import MIoTDevice, MIoTPropertyEntity from .miot.miot_device import MIoTDevice, MIoTPropertyEntity
from .miot.miot_spec import MIoTSpecProperty from .miot.miot_spec import MIoTSpecProperty
_LOGGER = logging.getLogger(__name__)
async def async_setup_entry( async def async_setup_entry(
hass: HomeAssistant, hass: HomeAssistant,
@ -64,17 +70,30 @@ async def async_setup_entry(
async_add_entities: AddEntitiesCallback, async_add_entities: AddEntitiesCallback,
) -> None: ) -> None:
"""Set up a config entry.""" """Set up a config entry."""
device_list: list[MIoTDevice] = hass.data[DOMAIN]['devices'][ device_list: list[MIoTDevice] = hass.data[DOMAIN]["devices"][
config_entry.entry_id] config_entry.entry_id]
new_entities = [] new_entities = []
for miot_device in device_list: for miot_device in device_list:
for prop in miot_device.prop_list.get('select', []): for prop in miot_device.prop_list.get("select", []):
new_entities.append(Select(miot_device=miot_device, spec=prop)) new_entities.append(Select(miot_device=miot_device, spec=prop))
if new_entities: if new_entities:
async_add_entities(new_entities) async_add_entities(new_entities)
# create select for light
new_light_select_entities = []
for miot_device in device_list:
# Add it to all devices with light entities, because some bathroom heaters and clothes drying racks also have lights.
# if "device:light" in miot_device.spec_instance.urn:
if miot_device.entity_list.get("light", []):
device_id = list(miot_device.device_info.get("identifiers"))[0][1]
new_light_select_entities.append(
LightCommandSendMode(hass=hass, device_id=device_id))
if new_light_select_entities:
async_add_entities(new_light_select_entities)
class Select(MIoTPropertyEntity, SelectEntity): class Select(MIoTPropertyEntity, SelectEntity):
"""Select entities for Xiaomi Home.""" """Select entities for Xiaomi Home."""
@ -87,10 +106,47 @@ class Select(MIoTPropertyEntity, SelectEntity):
async def async_select_option(self, option: str) -> None: async def async_select_option(self, option: str) -> None:
"""Change the selected option.""" """Change the selected option."""
await self.set_property_async( await self.set_property_async(value=self.get_vlist_value(
value=self.get_vlist_value(description=option)) description=option))
@property @property
def current_option(self) -> Optional[str]: def current_option(self) -> Optional[str]:
"""Return the current selected option.""" """Return the current selected option."""
return self.get_vlist_description(value=self._value) return self.get_vlist_description(value=self._value)
class LightCommandSendMode(SelectEntity, RestoreEntity):
"""To control whether to turn on the light, you need to send the light-on command first and
then send other color temperatures and brightness or send them all at the same time.
The default is to send one by one."""
def __init__(self, hass: HomeAssistant, device_id: str):
super().__init__()
self.hass = hass
self._device_id = device_id
self._attr_name = "Command Send Mode"
self.entity_id = f"select.light_{device_id}_command_send_mode"
self._attr_unique_id = self.entity_id
self._attr_options = [
"Send One by One", "Send Turn On First", "Send Together"
]
self._attr_device_info = {"identifiers": {(DOMAIN, device_id)}}
self._attr_current_option = self._attr_options[0]
self._attr_entity_category = EntityCategory.CONFIG
async def async_select_option(self, option: str):
if option in self._attr_options:
self._attr_current_option = option
self.async_write_ha_state()
async def async_added_to_hass(self):
await super().async_added_to_hass()
if (last_state := await self.async_get_last_state()
) and last_state.state in self._attr_options:
self._attr_current_option = last_state.state
@property
def current_option(self):
return self._attr_current_option