[2026-09-15] eagle: Modbus/RTU_Framing_Source_Analysis.md family/archive/t610-migration-log-2026-09.md family/documents/home-automation-wishlist.md family/how-to/gitea-config.md family/how-to/ha-automations.md family/how-to/home-automation.md family/how-to/nodered-ventilation.md family/how-to/truenas-access.md family/how-to/truenas-infrastructure.md family/how-to/zigbee2mqtt-t610.md

family/how-to/ha-automations.md

@@ -1,194 +1,124 @@
----
-title: "⚙️ HA — автоматизации (automations.yaml)"
-aliases: [HA automations, Автоматизации HA, automations.yaml, Ночной свет душевая]
-tags: [family, how-to, smarthome, home-assistant, automation]
-updated: 2026-09-15
-related:
-  - "[[family/plans/t610-home-automation]]"
-  - "[[family/how-to/home-automation]]"
-  - "[[family/how-to/zigbee2mqtt-t610]]"
-  - "[[family/documents/home-automation-wishlist]]"
----
+# ⚙️ HA — автоматизации
 
-> **📌 Текущий статус (2026-09-15):** дефект «ночной свет душевой» — **порог исправлен** `8 → 6` (по решению Alex), применено через REST и подтверждено. **Открытый хвост:** у ВЫКЛ-автоматизации по-прежнему `conditions: []` — нет связи с основным освещением; при 2 lx свет может залипать. Ждём факта: залипнет или нет.
-
-# ⚙️ HA — автоматизации (`automations.yaml`)
-
-> **Назначение документа:** разбор логики автоматизаций Home Assistant на t610, карта «устройство ↔ entity_id ↔ device_id», найденные дефекты. Карта железа/Modbus — [[family/how-to/home-automation]]. Хост/аддоны/доступ — [[family/plans/t610-home-automation]].
+> **Справочник логики автоматизаций** (`automations.yaml` на t610). Топология/команды/Modbus — [[family/how-to/home-automation]].
 
 ## 1. Где живёт
 
 - **Файл:** `/config/automations.yaml` в HA Core на t610.
-- **Локальная копия-эталон (проверено 2026-09-15):** `~/tmp-t610/automations/automations.yaml` (208 строк, 16 автоматизаций) и `~/tmp-t610/etap3-fix/automations.yaml` (версия после правки зон, 2026-09-14).
-- **Итого автоматизаций:** **16** (15 `on` / 1 `off`).
-- ⚠️ **Живой конфиг читать через REST API**, а не по памяти: `GET /api/config/automation/config/<id>`. Готовый скрипт-образец — `~/tmp-t610/check_aut_dushev.sh`.
+- **Всего:** 16 автоматизаций (15 `on` / 1 `off` — `Ventilation automation on`).
+- **Локальная копия:** `~/tmp-t610/automations/automations.yaml`.
+- **Читать живьём через API** (не по памяти):
+  ```bash
+  B="https://mallexxx.duckdns.org"
+  curl -s -H @/tmp/h1 "$B/api/config/automation/config/<ID>"
+  ```
 
-## 2. Карта device_id ↔ entity_id (из `~/tmp-t610/etap3-fix/devid_mapping.json`)
+### 🔴 ПИТФОЛЛ (стоил пустой заливки)
 
-| device_id | Устройство / назначение |
-|---|---|
-| `4095e7c3b47b9dc9640cfb8c3aeff022` | **`shower_2_presence_sensor`** — радар присутствия душевой 2 (Tuya `ZY-M100-S_2` / TS0601) |
-| `4d6e55505ff7dbad13d2674cdcb18d5a` | **`night_light_shower_2`** — ночная подсветка душевой 2 (Tuya `TS0001`, Zigbee-реле) |
-| `1ea8bbc2612dde303e4279bc5fbad57a` | `light_sensor_stairs` — датчик освещённости лестницы (TS0222) |
-| `028b7d9f489c87bdc9e563473a1d61e8` | подсветка лестницы (`switch`) |
-| `5cd5d9d2d289b5e470bbeaac0eb7905c` | кнопка/диммер спальни (TS0043-подобная) |
-| `098a641cb1d30f08f1ae293e00d9885b` | `light.bed_dimmer` (TS0052) |
-| `16d2c6f64ec399e5261c89b35c1e75c6` | розетка циркуляции ГВС |
-| `b9d384a51b780a7924ed9504eddec12e` | `boiler_water_leak` — датчик протечки котельной (TS0207) |
-| `bcf47eeae909877978bdaf6c705210f8` | датчик t° Zigbee = `office_temperature_sensor` (`0xa4c13862d39377e6`, TS0201, кабинет). Уточнено 2026-09-15 |
-| *(новый, device_id не зафиксирован)* | **`0xa4c138c650636cf6`** (TS0201, `_TZ3000_dowj6gyi`) — Zigbee-датчик t°/влажности, спарен 2026-09-15, назначается как `toilet_1_floor_temperature`. См. [[family/how-to/zigbee2mqtt-t610]] §5 |
-| `0c7a0eb6d60e852b447266da69a7785e` | *(entity-хелпер, см. mapping)* |
+REST `GET/POST /api/config/automation/config/<id>` использует поля **во множественном числе — `triggers` / `conditions` / `actions`** (в файле `automations.yaml` — `trigger`/`condition`/`action`).
+Правка по единственному числу **молча уходит в пустые пути**: POST → `200 {"result":"ok"}`, значения НЕ меняются.
+→ **ВСЕГДА читать конфиг обратно и сверять фактические значения.**
 
-> ⚠️ **H2000 PRO не в этой карте и не Zigbee.** `sensor.h2000_pro_*` приходят отдельной интеграцией (`config_entry 01M2EXY2D5YJZY71VAKJTTGB16`), не через z2m/Modbus. **Не трогать** (Alex 2026-09-15).
+**Бэкап перед правкой:** `cp ~/tmp-t610/automations/automations.yaml{,.bak-$(date +%Y%m%d-%H%M%S)}`
 
-**Сущности радара душевой 2** (`device_id 4095e7c3…`, платформа `mqtt`):
-- `sensor.shower_2_presence_sensor_illuminance` — «Освещенность», lx
-- `binary_sensor.shower_2_presence_sensor_presence` — «Занятость», on/off
-- `sensor.shower_2_presence_sensor_target_distance` — Target distance, м
-- `number.shower_2_presence_sensor_radar_sensitivity` — 0..9
-- `number.shower_2_presence_sensor_minimum_range` / `maximum_range` — 0..9.5 м, шаг 0.15
-- `number.shower_2_presence_sensor_detection_delay` — 0..10 с
-- `number.shower_2_presence_sensor_fading_time` — 0.5..1500 с
-- `sensor.shower_2_presence_sensor_linkquality`
+---
 
-**Сущности ночной подсветки душевой 2** (`device_id 4d6e5550…`):
-- `switch.night_light_shower_2` — **само реле** (его и дёргает автоматизация)
-- `light.night_light_shower_2` — хелпер `switch_as_x` поверх того же реле (`config_entry 01KKC78ZM7QRJQY36Q4D27KGCD`, `target_domain: light`, `invert: false`). **Один и тот же физический релей — управлять надо `switch.`-сущностью, к которой привязана автоматика.**
-- `number.night_light_shower_2_countdown`, `select..._power_on_behavior`, `select..._switch_type`, `sensor..._linkquality`
-
-## 3. Ночной свет душевой — две автоматизации
-
-**ВКЛ — `id: '1771997851260'`, «Вкл. ночной свет душевая»**
-
-```yaml
-triggers:
-  - platform: device
-    type: occupied          # binary_sensor.shower_2_presence_sensor_presence
-    device_id: 4095e7c3b47b9dc9640cfb8c3aeff022
-    entity_id: b4a50e16942064f9c00d0d86501a667e
-  - platform: device
-    type: illuminance       # sensor.shower_2_presence_sensor_illuminance
-    device_id: 4095e7c3b47b9dc9640cfb8c3aeff022
-    entity_id: df9fe40b9d96de3b1bdeeb62707a7cab
-    below: 6            # ✅ применено 2026-09-15 (было 8)
-conditions:
-  - condition: device
-    type: is_illuminance ... below: 6
-  - condition: device
-    type: is_occupied
-actions:  # turn_on
-  - type: turn_on  domain: switch  entity_id: fa72bc65e5cf9e9249a5b0d377e5a3f4
-     # = switch.night_light_shower_2
-mode: single
-```
-
-**ВЫКЛ — `id: '1771997918348'`, «Выкл. ночной свет душевая»**
-
-```yaml
-triggers:
-  - type: not_occupied     # присутствие пропало
-  - type: illuminance ... above: 6   # ✅ применено 2026-09-15 (было 8)
-conditions: []             # ⚠️ ПУСТО — нет ни одного условия
-actions:  # turn_off switch.night_light_shower_2
-mode: single
-```
-
-### 🔴 Дефект (диагностирован 2026-09-15)
-
-**Симптом:** ночной свет горит при включённом основном освещении; датчик присутствия при этом ничего не нарушает.
-
-**Первопричина — асимметрия логики, а НЕ датчик:**
-1. **Нет связи «основное освещение включено → ночной свет не нужен».** В ВЫКЛ-автоматизации `conditions: []` — она ничего не проверяет про основной свет. Гасит только по `not_occupied` или `above: 8`.
-2. **Порог `8 lx` стоял ровно в центре дребезга датчика.** Факт-замер 2026-09-15: покой = **2 lx**, а при движении/свете значение металось **7 ↔ 12** (см. §3 «Обоснование цифрой»). Порог `8` попадал в мёртвую середину → ВКЛ и ВЫКЛ срабатывали по кругу. Триггер `above: 8` **срабатывал**, но нестабильно.
-3. **`mode: single` + `occupied` держится** → человек в душевой, темно по показаниям → ночной свет горит поверх основного.
-
-**❌ Отвергнутые версии (не повторять):**
-- «датчик присутствия не видит порог / виноват датчик» — **неверно**: `binary_sensor..._presence` работает штатно (observed `on`/`off` в 04:49:15).
-- «порог просто надо чуть поднять» — **частично верно, и это и сделано**: порог `8` действительно лежал в центре дребезга (7↔12), поэтому его и сдвинули на `6`. Но **корень** — отсутствие условия по основному свету: порогом это не лечится (потолок датчика ~15 lx, он не отличает ночной свет от основного).
-
-**✅ Факт-замер (2026-09-15, 04:48–04:49 UTC):**
-
-| Сущность | Значение |
-|---|---|
-| `sensor.shower_2_presence_sensor_illuminance` | 2 lx |
-| `binary_sensor.shower_2_presence_sensor_presence` | off |
-| `switch.night_light_shower_2` | off |
-| `number..._fading_time` | 10 с |
-| `number..._maximum_range` | 2.85 м |
-
-### ✅ Применённая правка (2026-09-15) — порог 8 → 6
-
-**Решение Alex (дословно): «ставь 6».** Применено через REST API и **подтверждено чтением конфига обратно**:
-
-| Автоматизация | Триггер | Условие |
-|---|---|---|
-| ВКЛ `1771997851260` | `illuminance below: 6` | `below: 6` + `is_occupied` |
-| ВЫКЛ `1771997918348` | `illuminance above: 6` | — (по-прежнему пусто) |
-
-**📊 Обоснование цифрой (ключевой замер).** История `sensor.shower_2_presence_sensor_illuminance`:
-
-- **За 10 минут до правки (2026-09-15, 04:27–04:48 UTC):** `7 → 12 → 7 → 12 → 7 → 12 → 7` — метание **7 ↔ 12**.
-- **2026-09-14 днём:** `15↔8`, `13↔8`, `5↔0` — тот же дребезг вокруг 8.
-- **Рабочий диапазон датчика в этой точке — всего 0…15 lx.** Порог `8` стоял ровно в центре метания → ВКЛ/ВЫКЛ хлопали туда-сюда.
-
-**⚠️ Остаточный риск (предупреждён Alex, принят осознанно):** при **2 lx** (покой) ВЫКЛ ждёт `above: 6` и может не наступить → ночной свет залипнет. Гистерезис **сознательно не сделан** по прямому указанию Alex.
-**Если залипнет — варианты (по возрастанию):** ① гистерезис `вкл below 4 / выкл above 10`; ② гасить ночной свет по факту включения основной лампы (**блокер: сущность основного освещения верхней душевой неизвестна** — среди `light.*`/`switch.*` душевой есть только `night_light_shower_2`); ③ калибровка `illuminance_calibration` радара.
-
-**Артефакты:**
-- Скрипт-образец: `~/tmp-t610/fix_shower_light_threshold.sh` (читает конфиг → правит только `.below`/`.above` == 8 → POST → читает обратно).
-- Бэкап файла: `~/tmp-t610/automations/automations.yaml.bak-20260915-105455`.
-
-**🔴 ПИТФОЛЛ (стоил одной пустой заливки):** REST `GET/POST /api/config/automation/config/<id>` отдаёт и принимает поля **во МНОЖЕСТВЕННОМ числе — `triggers` / `conditions`** (в файле `automations.yaml` — `trigger`/`condition`). Правка по единственному числу через API **молча уходит в пустые пути**: `POST` возвращает `200 {"result":"ok"}`, но значения НЕ меняются. → **ВСЕГДА читать конфиг обратно и сверять фактические значения.**
-
-### Прочие наблюдения (не правки)
-
-- `fading_time` = 10 с, `maximum_range` = **2.85 м** — проверить, покрывает ли зона всю душевую.
-- Калибровка `illuminance_calibration` радара: 2 lx при выключенном свете в закрытой душевой — правдоподобно, но потолок 15 lx подозрительно низок.
-- **Луковичный вывод:** потолок датчика ~15 lx означает, что он **не отличает ночной свет от основного** — оба выше его шкалы. Поэтому порогом задача «гасить ночной при включении основного» **не решается в принципе**, нужен триггер по основной лампе (см. блокер выше).
-
-## 4. Прочие содержательные автоматизации
+## 2. Карта автоматизаций
 
 | id | alias | Логика |
 |---|---|---|
 | `1768585827761` | Выключить циркуляцию ГВС | `time 23:00` → turn_off |
 | `1768585922970` | Включить циркуляцию ГВС | `time 09:30` → turn_on |
-| `1770404069135` | Ventilation automation on | `time 05:00` → `fan.turn_on fan.automation` |
-| `5735cb9f855e462dbdbdf680d0d6a66f` | office_pass_switch_table | `switch.office_table_light_switch_l1` change → toggle `light.smart_light_office_left` |
-| `45b96f6f38f6488ba70266fa5da665f5` | office_pass_switch_main | `switch.office_table_light_switch_l2` change → toggle `light.smart_light_office_right` |
+| `1770404069135` | Ventilation automation on | `time 05:00` → `fan.turn_on fan.automation` *(off)* |
+| `5735cb9f855e462dbdbdf680d0d6a66f` | **office_pass_switch_table** | кнопка L1 → toggle `light.smart_light_office_left` ⚠️ |
+| `45b96f6f38f6488ba70266fa5da665f5` | **office_pass_switch_main** | кнопка L2 → toggle `light.smart_light_office_right` ⚠️ |
 | `1771466806839` | Светло: выкл. подсветку лестницы | lever `illuminance above: 150` → turn_off |
 | `1771466955010` | Темно: вкл. подсветку лестницы | lever `illuminance below: 130` → turn_on |
 | `1771683420621` | Toggle Dimmer bed | кнопка `single` → toggle `light.bed_dimmer` |
 | `1771683677259` | Dimmer bed cycle | кнопка `double` → цикл яркости 20/40/60/80/100 % |
-| `1771997851260` | **Вкл. ночной свет душевая** | см. §3 🔴 |
-| `1771997918348` | **Выкл. ночной свет душевая** | см. §3 🔴 |
-| `1773451257968` | Протечка котельная | `moist` → `notify.notify` «Протечка котельная» |
+| `1771997851260` | **Вкл. ночной свет душевая** | присутствие + темно → `switch.night_light_shower_2` on |
+| `1771997918348` | **Выкл. ночной свет душевая** | нет присутствия / светло → off |
+| `1773451257968` | Протечка котельная | `moist` → `notify.notify` |
 | `1773451323415` | Датчик протечки котельная батарея | `bat_low` → notify |
 | `1773459513601` | Датчик освещенности лестница батарея | `battery_level below 10` → notify |
 | `1773459606336` | Light switch bed батарея | `battery_level below 10` → notify |
 | `1773459663218` | Zigbee T sensor батарея | `battery_level below 10` → notify |
 
-> **⚠️ Наблюдение:** «Светло/Темно подсветка лестницы» использует **гистерезис** (below 130 / above 150) — это единственная пара с правильной защитой от дребезга. Паттерн годится как образец для правки душевой.
+> **Образец правильной защиты от дребезга:** «Светло/Темно подсветка лестницы» использует **гистерезис** (`below: 130` / `above: 150`). Брать как эталон.
 
-## 5. Питфоллы диагностики
+---
 
-- **Секрет-маскировщик Hermes** подменяет `Bearer $(cat ...)` на `***` → собирать заголовок через `printf` в файл, затем `curl -H @/tmp/hdr.txt`. Рабочий `/tmp/.hatok` уже есть на Mac.
-- `ha apps logs <slug>` обрезает вывод и отдаёт старый буфер → живой лог только через API.
-- Запросы к `http://192.168.2.176` (raw IP, plain HTTP, private network) **требуют апрува** в Hermes — предупреждать Alex заранее, не ретраить вслепую.
-- **🔴 Форма полей через REST — МНОЖЕСТВЕННОЕ число:** `GET/POST /api/config/automation/config/<id>` использует `triggers` / `conditions` (в файле — `trigger` / `condition`). Правка по единственному числу **молча уходит в пустые пути**: `POST` отдаёт `200 {"result":"ok"}`, значения НЕ меняются. **Всегда читать обратно и сверять.**
-- **История значения (для доказательства дребезга) — эндпоинт истории:**
-  ```
-  GET /api/history/period/<ISO-TS>?filter_entity_id=<entity>&minimal_response&no_attributes
-  ```
-  Возвращает список списков; брать `.[0]`, печатать `last_changed` + `state`. Пример (последние 25 мин):
-  ```
-  curl -s -H @/tmp/hdr.txt "http://192.168.2.176/api/history/period/$(date -u -v-25M '+%Y-%m-%dT%H:%M:%S')+00:00?filter_entity_id=sensor.shower_2_presence_sensor_illuminance&minimal_response&no_attributes"
-  ```
-  Именно этим способом доказано метание 7↔12 вокруг порога 8.
-- **Две сущности = одно реле:** `switch.night_light_shower_2` и `light.night_light_shower_2` — один и тот же физический реле (`switch_as_x`). Управлять надо той, к которой привязана автоматизация (`switch.`), иначе состояние «расходится» в UI.
+## 3. 🔴 ДЕФЕКТ: свет кабинета мигает при перезагрузке HA
 
-## Связанные заметки
+**Симптом:** при каждом рестарте HA свет в кабинете мигает.
 
-- [[family/plans/t610-home-automation]] — единственный рабочий документ по техчасти (хост, доступ, аддоны, Modbus, Zigbee)
-- [[family/how-to/home-automation]] — карта железа: AT2 (параметры/PWM), Slave ID, регистры заслонок/реле, ZONT relays
-- [[family/documents/home-automation-wishlist]] — роадмап автоматизаций, приоритеты
-- [[family/how-to/nodered-ventilation]] — алгоритм вентиляции по CO₂ (Node-RED)
+**Первопричина:** триггеры `office_pass_switch_table` / `office_pass_switch_main` используют `platform: state` **без `to`/`from`** → срабатывают на **любую** смену состояния сущности кнопки.
+
+При старте HA кнопки проходят `unavailable → unknown → on` — каждый переход дёргает `light.toggle`. Подтверждено историей: `switch.office_table_light_switch_l1` сменил состояние 3 раза в течение 5 минут в момент рестартов HA (`05:16:36 → unavailable`, `05:16:40 → on`, `05:18:39 → unavailable`, `05:18:46 → unknown`, `05:19:20 → on`).
+
+**Текущий конфиг (сырой):**
+```json
+{
+  "alias": "office_pass_switch_table",
+  "mode": "restart",
+  "trigger": [{"platform": "state", "entity_id": ["switch.office_table_light_switch_l1"]}],
+  "action": [{"service": "light.toggle", "target": {"entity_id": "light.smart_light_office_left"}}]
+}
+```
+
+**Направление фикса:** привязать триггер к конкретному состоянию (`to:`) ИЛИ заменить на триггер по событию нажатия. Требует определить фактическое поведение кнопки при физическом нажатии (сейчас кнопки в `on` — это состояние после старта, не нажатие).
+
+**Статус:** ⚠️ **НЕ ИСПРАВЛЕНО.** Требует замера поведения кнопки при нажатии.
+
+---
+
+## 4. Ночной свет душевой 2
+
+**Сущности** (device_id `4095e7c3b47b9dc9640cfb8c3aeff022` = радар, `4d6e55505ff7dbad13d2674cdcb18d5a` = лампа):
+
+- `sensor.shower_2_presence_sensor_illuminance` — освещённость, lx
+- `binary_sensor.shower_2_presence_sensor_presence` — занятость
+- `switch.night_light_shower_2` — **само реле** (его дёргает автоматизация)
+- `light.night_light_shower_2` — хелпер `switch_as_x` поверх того же реле
+
+> ⚠️ **Две сущности = одно реле.** Управлять надо `switch.` — той, к которой привязана автоматика, иначе состояние «расходится» в UI.
+
+**Автоматизации:**
+
+| | id | Триггер | Условие |
+|---|---|---|---|
+| ВКЛ | `1771997851260` | `illuminance below: 6` + `occupied` | `below: 6` + `is_occupied` |
+| ВЫКЛ | `1771997918348` | `not_occupied` + `illuminance above: 6` | ⚠️ **`conditions: []`** — пусто |
+
+**История правки (2026-09-15):** порог `8 → 6`. Порог `8` лежал ровно в центре дребезга датчика (**7 ↔ 12**), рабочий диапазон датчика всего **0…15 lx** → ВКЛ/ВЫКЛ хлопали по кругу.
+
+**⚠️ Остаточный риск (принят Alex):** при **2 lx** (покой) ВЫКЛ ждёт `above: 6` и может не наступить → свет залипнет. Гистерезис сознательно не сделан.
+**Если залипнет — варианты:** ① гистерезис `вкл below 4 / выкл above 10`; ② гасить по факту включения основной лампы (**блокер: сущность основного освещения верхней душевой неизвестна**); ③ калибровка `illuminance_calibration` радара.
+
+**Параметры радара:** `fading_time` = 10 с, `maximum_range` = 2.85 м — проверять, покрывает ли зона всю душевую.
+
+---
+
+## 5. Диагностика
+
+```bash
+# История значения (доказательство дребезга)
+T=$(date -u -v-3H '+%Y-%m-%dT%H:%M:%S')
+curl -s -H @/tmp/h1 "$B/api/history/period/$T+00:00?filter_entity_id=<entity>&minimal_response&no_attributes" \
+  | jq -r '.[0][] | "\(.last_changed) -> \(.state)"'
+
+# Состояния сущностей устройства (через шаблон)
+curl -s -X POST -H @/tmp/h1 -H "Content-Type: application/json" \
+  -d '{"template":"{% set dev = device_id(\"sensor.x\") %}{% for e in device_entities(dev) %}{{ e }} = {{ states(e) }}\n{% endfor %}"}' \
+  "$B/api/template"
+```
+
+**Артефакты:** `~/tmp-t610/fix_shower_light_threshold.sh` (образец правки порога), `~/tmp-t610/ha_ws.py` (WS-реестры).
+**Бэкап:** `~/tmp-t610/automations/automations.yaml.bak-20260915-105455`.
+
+---
+
+## Связанные
+
+- [[family/how-to/home-automation]] — единый справочник: топология, железо, Zigbee, Modbus, команды, сценарии, питфоллы
+- [[family/documents/home-automation-wishlist]] — роадмап идей и приоритетов