67 lines
4.0 KiB
Python
67 lines
4.0 KiB
Python
"""Xiaomi ecosystem integrations (MIoT / Xiaomi Home) — multi-category.
|
|
|
|
Data module of the suggested-setups signature catalog — see
|
|
``helpers/signatures/_model.py`` for the direction semantics and the
|
|
method contract (every entry cites and is verified against the
|
|
integration's source; drift-probed weekly)."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from ._model import ConsumableSignature, IntegrationSignature
|
|
|
|
SIGNATURES: dict[str, IntegrationSignature] = {
|
|
"xiaomi_miot": IntegrationSignature(
|
|
name="Xiaomi MIoT",
|
|
verified="2026-07-17 @ al-one/hass-xiaomi-miot master; reset buttons re-checked 2026-09-27 @ 919b7a49",
|
|
source=(
|
|
"al-one/hass-xiaomi-miot — generic MIoT-spec entities; entity_id "
|
|
"suffix = the spec property name (core/miot_spec.py format_name + "
|
|
"eid = f'{model}_{mac[-4:]}_{desc_name}'). Cross-device consumables: "
|
|
"'filter-life-level' (PERCENTAGE) on air purifiers/humidifiers/water "
|
|
"purifiers/vacuums, 'brush-life-level' (PERCENTAGE) on vacuums. The "
|
|
"days/used-hours filter counterparts describe the SAME filter, so "
|
|
"only the percent signal is cataloged to avoid duplicate tasks. "
|
|
"Resets (re-checked 2026-09-27 @ 919b7a49): MIoT actions become buttons "
|
|
"only where the device customization lists them in button_actions "
|
|
"(core/device_customizes.py: '*.vacuum.*' reset_*, and many purifiers / "
|
|
"humidifiers / pet waterers with reset_filter_life); core/hass_entity.py names "
|
|
"the action button device.spec.generate_entity_id(action.name) → "
|
|
"'button.<model>_<mac4>_reset_filter_life' / '_reset_brush_life' (tk "
|
|
"'filter-reset_filter_life' / 'brush_cleaner-reset_brush_life'). With a "
|
|
"duplicated service (two filters, main + side brush) only the first instance "
|
|
"gets a button — the same first instance the sensor suffix matches."
|
|
),
|
|
tasks=(
|
|
# Matched via the entity_id suffix (translation_key is the noisier
|
|
# 'filter-filter_life_level' form). One % task per filter; the side
|
|
# brush collides to a '_2' suffix and is intentionally not matched.
|
|
# 2.95: completing presses the model's reset button where
|
|
# button_actions lists it.
|
|
ConsumableSignature(("filter_life_level",), "Replace Filter", "percent_left", resets=(("filter_life_level", "reset_filter_life"),)),
|
|
ConsumableSignature(("brush_life_level",), "Replace Main Brush", "percent_left", resets=(("brush_life_level", "reset_brush_life"),)),
|
|
),
|
|
),
|
|
"xiaomi_home": IntegrationSignature(
|
|
name="Xiaomi Home",
|
|
verified="2026-07-18 @ XiaoMi/ha_xiaomi_home main",
|
|
source=(
|
|
"XiaoMi/ha_xiaomi_home miot/miot_device.py gen_prop_entity_id: "
|
|
"entity_id = f'{model}_{did}_{model}_{slugify_name(prop)}_p_{siid}_{piid}' "
|
|
"(property name mid-string, no translation_key) — matched via the "
|
|
"'_<key>_p_' infix. Same MIoT spec properties as hass-xiaomi-miot. "
|
|
"Known limits (2026-09-27 @ bf38d930): on specs with two brush-cleaner "
|
|
"services (dreame-p2009: siid 9 'Main Cleaning Brush', siid 10 'Side "
|
|
"Cleaning Brush', both 'brush-life-level') the infix matches BOTH brushes "
|
|
"into the one 'Replace Main Brush' task (any-low); which siid is the side "
|
|
"brush differs per spec, so no key can tell them apart. Reset actions become "
|
|
"buttons '…_reset_filter_life_a_<siid>_<aiid>' — no catalog matcher sees an "
|
|
"'_a_' infix, so they stay unwired."
|
|
),
|
|
tasks=(
|
|
# No reset: the action buttons' '_a_' ids are never matched (above).
|
|
ConsumableSignature(("filter_life_level",), "Replace Filter", "percent_left"),
|
|
ConsumableSignature(("brush_life_level",), "Replace Main Brush", "percent_left"),
|
|
),
|
|
),
|
|
}
|