[2026-09-16] eagle: family/documents/home-automation-wishlist.md family/how-to/ha-automations.md family/how-to/home-automation.md family/tech/kitchen-hood-fan-template.md family/tech/zigbee-t610-z2m-i-zha.md

family/how-to/ha-automations.md

@@ -18,7 +18,7 @@
 > 1. **`device`-триггер батареи — тип `battery_level`, НЕ `battery`.** Иначе `Automation ... failed to setup triggers and has been disabled`.
 > 2. **`binary_sensor` «battery_low» в ZHA нет** — только numeric `sensor.*_battery`, порог через `below: 10`.
 > 3. **Домен `entity_id` не меняется переименованием:** `switch.office_table_light_switch_l1` → ZHA-имя `light.tz3000_5gey1ohx_ts0002_osveshchenie`. Автоматизации переписаны на `light.*`.
-   > 🍳 **Сменить домен у СУЩЕСТВУЮЩЕЙ сущности HA нельзя** (ни реестром, ни customize). Обход — Template-хелпер поверх исходной сущности. `switch_as_x` для этого не годится: принимает **только `switch`**, не `light`. Разбор — [[family/tech/kitchen-hood-domain-conversion]].
+   > 🍳 **Сменить домен у СУЩЕСТВУЮЩЕЙ сущности HA нельзя** (ни реестром, ни customize). Обход — Template-хелпер поверх исходной сущности. `switch_as_x` для этого не годится: принимает **только `switch`**, не `light`. ✅ Применено на вытяжке кухни: `fan.kitchen_hood`. Разбор — [[family/tech/kitchen-hood-fan-template]].
 > 4. **`reload` — `POST /api/services/automation/reload`** с long-lived JWT, порт 80 (`http://172.30.32.1/api/`). Супервизорский токен → 401.
 
 ## 1. Где живёт

family/how-to/home-automation.md

@@ -2,7 +2,7 @@
 title: "🏠 Домашняя автоматизация"
 aliases: [Умный дом, Home automation, HA, Zigbee, Modbus, вентиляция, t610, RCU stall, USB reset]
 tags: [family, how-to, smarthome]
-updated: 2026-09-16 (доступ к API изнутри t610: `172.30.32.1` ОПРОВЕРГНУТ — `000`, аддон в своём netns, единственный путь `mallexxx.duckdns.org`; §2.1 — 4 ловушки написания скриптов для t610: маскировщик `Authorization`, base64-токен, BusyBox `date -v`, `jq` в `ssh`; §5 подсветка лестницы — разбор утреннего ВЫКЛ; 🍳 вытяжка кухни — 3 × `light.*`, смена домена → [[family/tech/kitchen-hood-domain-conversion]])
+updated: 2026-09-16 (вытяжка кухни переведена в 🌀 `fan.kitchen_hood` Template-хелпером: домен `light.` сменить нельзя, `switch_as_x` берёт только `switch`; +7 питфоллов 46–52 про «создал сущность, а в UI нет» — зона Template-сущности, `hidden_by` vs storage-дашборды, `check_config` → `[]`; §2.1 — 4 ловушки написания скриптов для t610: маскировщик `Authorization`, base64-токен, BusyBox `date -v`, `jq` в `ssh`; §5 подсветка лестницы — разбор утреннего ВЫКЛ)
 ---
 
 # 🏠 Домашняя автоматизация
@@ -766,6 +766,13 @@ Hz:PWM 0:0 1:0 2:0 3:0 4:48 5:55 6:63 7:70 8:78 9:85 10:92 11:97 12:102 13:107 1
 | 42 | ⚠️ **Живой конфиг сниффа — НЕ в `/addons/modbus-bridge/config.yaml`** | `config.yaml` = только опции аддона (device/baud). Регистры и коррекции — в `data/config.template.tmpl` → `run.sh` рендерит из него `/app/config.yml` при старте |
 | 44 | 🔴 **`MemFree` читают как «сколько памяти всего/занято»** | Верные метрики: **`MemTotal`** (всего) и **`MemAvailable`** (доступно). `MemFree` падает из-за файлового кэша (Cached 2.3 ГБ) и в I/O-шторме. См. §3.9 |
 | 45 | 🔴 **«BIOS 4096 МБ → HA видит 1.44 ГБ»** — ложная тревога | Реально usable **3.31 ГБ** (минус ~800 МБ ACPI NVS/data + reserved + iGPU). Проверять `head -3 /proc/meminfo` + `dmesg \| grep e820`. См. §3.9 |
+| 46 | 🔴 **Создал сущность → «в UI её нет»** | Проверять **4** вещи: (1) `/api/states/<e>` отвечает, (2) `area_id` ≠ `null` в реестре, (3) диагностика устройства скрыта, (4) дашборды не ссылаются на мёртвые сущности. Разбор — [[family/tech/kitchen-hood-fan-template]] §6.1 |
+| 47 | 🔴 **Template-сущность из YAML не получает `area_id`** | У неё нет `device_id` → зону назначать вручную WS `config/entity_registry/update` с `area_id`. Иначе «невидима» на дашбордах зон |
+| 48 | 🔴 **`hidden_by: user` НЕ убирает сущность из storage-дашбордов и `area_entities()`** | Это два независимых механизма. Ссылки в `/config/.storage/lovelace.*` вписаны руками — править их отдельно (`jq`). Реально «выключить» — только `disabled_by` |
+| 49 | 🔴 **Правки `.storage/*` (дашборды, реестры) не видны до перезагрузки страницы** | Hard-refresh **Cmd+Shift+R**; обычный F5 может отдать кэш |
+| 50 | **`homeassistant.check_config` через сервис отдаёт `[]`** | Это **не** ошибка — сервис не возвращает тело. Проверять `GET /api/config` → `.state` (или `/api/template`) |
+| 51 | **Локальный `yaml.safe_load` падает на `!include`/`!secret`** | Заглушка: `L.add_multi_constructor('!', lambda l,s,n: {})` — иначе конфиг локально не проверить |
+| 52 | 🔴 **Новый `template:` блок требует `restart` ядра**, не `automation reload` | Диагностика мёртвых ссылок: `jq -r '.. \| objects \| select(.entity? != null) \| .entity' /config/.storage/lovelace.* \| sort -u` → сверить со `/api/states` |
 
 ---
 
@@ -861,7 +868,7 @@ ssh root@192.168.2.176 'ha apps logs local_modbus-bridge | grep -E "Raw RTU|→
 - ⚠️ **Осиротевший `/config/go2rtc.yaml`** (1085 байт) — go2rtc удалён, читать нечем.
 - ⚠️ **Watchdog `local_ustreamer` не включён** (в отличие от остальных 6 аддонов, §3.7).
 - ⚠️ **Свет кабинета мигает при перезагрузке HA** — `office_pass_switch_*` с `platform: state` без `to`. Разбор — [[family/how-to/ha-automations]] §3.
-- 🍳 **Вытяжка кухни отдаётся как 3 × `light.*` — Alex хочет вывести из категории «свет».** Прямой смены домена нет; рабочий путь — Template-fan/switch поверх `light.*`. Ждёт решения + уточнения маппинга «реле → скорость». Разбор — [[family/tech/kitchen-hood-domain-conversion]].
+- ✅ **Вытяжка кухни — СДЕЛАНО 2026-09-16.** Была 3 × `light.*` (ZHA, TS0003) → теперь 🌀 **`fan.kitchen_hood`** (Template, `speed_count: 3`, 33/66/100 %). Три света + 13 сущностей диагностики скрыты (`hidden_by: user`), зона `kitchen`, карта этажей `home_plan` переведена с мёртвого `fan.fan_3`. **Прямой смены домена в HA НЕТ** (`switch_as_x` берёт только `switch`). ⚠️ Осталось: физическая проверка «реле → скорость». Док: [[family/tech/kitchen-hood-fan-template]]
 - ⚠️ **Греющий кабель не проверен физически** — розетка ни разу не включалась.
 
 **Справочные факты:**