[2026-11-20] 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/ventilation-ha-nodered.md

This commit is contained in:
Alexey Martemyanov committed 2026-11-20 13:13:35 +06:00
1 parent e16fae38f9
commit d46455a79d
5 files changed
+296 -14

No files matched your search

+5 -2
View File
@@ -1,4 +1,7 @@
--- ---
updated: '2026-11-20'
---
---
title: "🏡 Умный дом — хотелки и роадмап автоматизаций" title: "🏡 Умный дом — хотелки и роадмап автоматизаций"
aliases: [Умный дом, Умный дом хотелки, Home automation, Smart home, home-automation-wishlist] aliases: [Умный дом, Умный дом хотелки, Home automation, Smart home, home-automation-wishlist]
tags: [family, lists, smart-home, tech] tags: [family, lists, smart-home, tech]
@@ -36,7 +39,7 @@ related:
> Порядок — рекомендация агента (отдача / стоимость). Финальный порядок — за Alex. > Порядок — рекомендация агента (отдача / стоимость). Финальный порядок — за Alex.
### 1. ⭐ Вентиляция по CO₂ — доехать до конца ### 1. ⭐ Вентиляция по CO₂ — доехать до конца
Логика **уже написана** в Node-RED ([[family/how-to/home-automation]]): Demand Aggregator → Intake Allocation → Discretization → Damper Outputs → Exhaust Arbitration → Fans → Kitchen Hood. Логика **реализована частично**. Рабочее описание, сценарии, настройка и отладка вынесены в [[family/tech/ventilation-ha-nodered]] (сверка 2026-11-20 по сохранённому flow). Есть расчёт спроса, приток и PI вытяжки; управление вытяжными заслонками и подключение кухонного fan в проверенном снимке отсутствуют. Живой статус t610 на дату сверки не проверен.
**Блокер:** `fan.fan_at2_1/2` и `switch.fan_3_*` (slave 10) — `unavailable`, блок закомментирован в `configuration.yaml`. **Блокер:** `fan.fan_at2_1/2` и `switch.fan_3_*` (slave 10) — `unavailable`, блок закомментирован в `configuration.yaml`.
> ✅ **По вытяжке кухни — СДЕЛАНО 2026-09-16:** ZHA отдаёт её тремя `light.kitchen_hood_light*` (TS0003 = 3 реле), а узел «Kitchen Hood» в Node-RED ждёт **`fan`/`switch`**. Прямой смены домена в HA нет → создан Template-фан 🌀 **`fan.kitchen_hood`** (3 скорости, 33/66/100 %), три света скрыты. Узел в Node-RED теперь можно вешать на `fan.kitchen_hood`. Разбор — [[family/tech/kitchen-hood-fan-template]]. > ✅ **По вытяжке кухни — СДЕЛАНО 2026-09-16:** ZHA отдаёт её тремя `light.kitchen_hood_light*` (TS0003 = 3 реле), а узел «Kitchen Hood» в Node-RED ждёт **`fan`/`switch`**. Прямой смены домена в HA нет → создан Template-фан 🌀 **`fan.kitchen_hood`** (3 скорости, 33/66/100 %), три света скрыты. Узел в Node-RED теперь можно вешать на `fan.kitchen_hood`. Разбор — [[family/tech/kitchen-hood-fan-template]].
**Что нужно:** раскомментировать slave 10 и убедиться, что AT2 отвечает (в §5 доки плана зафиксировано: прямой `nc` на slave 10 даёт `OK`, значение 100 → железо живо). **Что нужно:** раскомментировать slave 10 и убедиться, что AT2 отвечает (в §5 доки плана зафиксировано: прямой `nc` на slave 10 даёт `OK`, значение 100 → железо живо).
@@ -119,7 +122,7 @@ ZONT-реле котлов уже дают статусы; 2 Zigbee-розетк
- [[family/how-to/home-automation]] — **единственный рабочий документ** по техчасти: хост, доступ, аддоны, Modbus, Zigbee, питфоллы - [[family/how-to/home-automation]] — **единственный рабочий документ** по техчасти: хост, доступ, аддоны, Modbus, Zigbee, питфоллы
- [[family/how-to/home-automation]] — карта железза: AT2 (параметры/PWM), Slave ID, регистры заслонок/реле, ZONT relays - [[family/how-to/home-automation]] — карта железза: AT2 (параметры/PWM), Slave ID, регистры заслонок/реле, ZONT relays
- [[family/how-to/ha-automations]] — логика HA-автоматизаций, карта device_id/entity_id, разбор дефекта «ночной свет душевой» - [[family/how-to/ha-automations]] — логика HA-автоматизаций, карта device_id/entity_id, разбор дефекта «ночной свет душевой»
- [[family/how-to/home-automation]] — алгоритм вентиляции по CO₂ (Node-RED) - [[family/tech/ventilation-ha-nodered]] — алгоритм вентиляции, состояние работ, сценарии и отладка HA / Node-RED
- [[family/how-to/ha-automations]] §7 — греющий кабель ввода воды - [[family/how-to/ha-automations]] §7 — греющий кабель ввода воды
- [[family/documents/home-wishlist]] — хотелки по дому и участку (не автоматизация) - [[family/documents/home-wishlist]] — хотелки по дому и участку (не автоматизация)
- [[family/index]] — топик-карта family/ - [[family/index]] — топик-карта family/
+4
View File
@@ -1,6 +1,10 @@
---
updated: '2026-11-20'
---
# ⚙️ HA — автоматизации # ⚙️ HA — автоматизации
> **Справочник логики автоматизаций** (`automations.yaml` на t610). Топология/команды/Modbus — [[family/how-to/home-automation]]. > **Справочник логики автоматизаций** (`automations.yaml` на t610). Топология/команды/Modbus — [[family/how-to/home-automation]].
> **Вентиляция: сценарии, вычисление спроса, Node-RED, настройка и отладка** — [[family/tech/ventilation-ha-nodered]].
> 🟢 **24 АВТОМАТИЗАЦИИ — 23 `on`, 1 `off`** (`Ventilation automation on`, намеренно), `unavailable` = 0. Zigbee работает на ZHA. > 🟢 **24 АВТОМАТИЗАЦИИ — 23 `on`, 1 `off`** (`Ventilation automation on`, намеренно), `unavailable` = 0. Zigbee работает на ZHA.
> >
+22 -8
View File
@@ -1,13 +1,26 @@
--- ---
title: "🏠 Домашняя автоматизация" title: "\U0001F3E0 Домашняя автоматизация"
aliases: [Умный дом, Home automation, HA, Zigbee, Modbus, вентиляция, t610, RCU stall, USB reset] aliases:
tags: [family, how-to, smarthome] - Умный дом
updated: 2026-09-18 - Home automation
- HA
- Zigbee
- Modbus
- вентиляция
- t610
- RCU stall
- USB reset
tags:
- family
- how-to
- smarthome
updated: '2026-11-20'
--- ---
# 🏠 Домашняя автоматизация # 🏠 Домашняя автоматизация
> **Единственный справочник по домашней автоматизации.** Всё: топология, железо, Zigbee, Modbus, доступ, команды, сценарии, питфоллы. > **Основной справочник по домашней автоматизации:** топология, железо, Zigbee, Modbus, доступ, команды и питфоллы.
> **Логика вентиляции, сценарии, настройка и отладка HA / Node-RED** — [[family/tech/ventilation-ha-nodered]]. Сводка 2026-11-20: сохранённый flow проверен по коду; живой статус требует проверки.
> **Автоматизации** (25 шт., логика, дефекты) — [[family/how-to/ha-automations]]. > **Автоматизации** (25 шт., логика, дефекты) — [[family/how-to/ha-automations]].
> **Метрики хоста (RAM/темп, аддон)** — [[family/tech/t610-hw-metrics-addon]]. > **Метрики хоста (RAM/темп, аддон)** — [[family/tech/t610-hw-metrics-addon]].
> 🔌 **«Почему реле выключилось» — разбор по логбуку:** [[family/tech/t610-relay-off-log-forensics]]. > 🔌 **«Почему реле выключилось» — разбор по логбуку:** [[family/tech/t610-relay-off-log-forensics]].
@@ -609,7 +622,7 @@ uci show firewall.@rule[3]
Flow: `/addon_configs/a0d7b954_nodered/flows.json` (68 узлов). Узел `server` → `"addon": true` (Supervisor даёт доступ к HA без токена). Flow: `/addon_configs/a0d7b954_nodered/flows.json` (68 узлов). Узел `server` → `"addon": true` (Supervisor даёт доступ к HA без токена).
Модуль: `node-red-contrib-home-assistant-websocket@0.80.3`. Наружу НЕ выпущен (`host_network: true` глушит маппинг) → только ingress HA. Домен `nodered.*` не используется (401 от nginx HA). Модуль: `node-red-contrib-home-assistant-websocket@0.80.3`. Наружу НЕ выпущен (`host_network: true` глушит маппинг) → только ingress HA. Домен `nodered.*` не используется (401 от nginx HA).
**Алгоритм вентиляции по CO₂** (детали — §5.4): комнаты `bedroom`/`kids`/`living` (приоритет living 1.2), дискретизация заслонок 0/33/66/100 (living — двойная 66/100), вытяжка `at2_1 = max(toilet, shower, kitchen)`, `at2_2 = max(bathroom, office)`, скорости вентиляторов 30/50/70/100 %, вытяжка кухни 3 скорости, rate-limit 30–60 с. **Алгоритм и состояние работ** вынесены в [[family/tech/ventilation-ha-nodered]]. Проверенный локальный снимок использует `bedroom`/`kids`/`dining`, веса второго этажа 0.5/1.0, гистерезис притока и gate 10 минут, PI вытяжки. Кухонный fan и вытяжные заслонки в этом снимке не подключены. Прежняя сводка про `living=1.2`, скорости 30/50/70/100 и rate-limit 30–60 с с доступным кодом не совпадает; текущий flow t610 повторно не снят.
--- ---
@@ -667,8 +680,9 @@ curl -s -H @/tmp/h1 "$B/api/config/automation/config/<ID>" > /tmp/aut_<ID>.json
### 5.4. Вентиляция по CO₂ (Node-RED) ### 5.4. Вентиляция по CO₂ (Node-RED)
Структура: `demand aggregator → intake allocation → дискретизация заслонок → outputs → exhaust arbitration → заслонки вытяжки → вентиляторы → вытяжка кухни`. Рабочая документация: [[family/tech/ventilation-ha-nodered]] — фактический граф доступного flow, формулы спроса и PI, расписания, гистерезис, ограничения и приёмка.
Всё в HA — через Node-RED ingress. Данные: `modbus/sensors/<room>/<param>` в MQTT.
После агрегатора приток и вытяжка расходятся параллельными ветками. Управление вытяжными заслонками и кухонным fan в проверенном снимке отсутствует; прежняя последовательная цепочка описывала целевой контур. Доступ к Node-RED на t610 — через ingress HA; эксплуатационные статусы выше датированы сентябрём 2026.
--- ---
+9 -4
View File
@@ -1,5 +1,5 @@
--- ---
title: "🍳 Вытяжка кухни — смена домена light → fan (`fan.kitchen_hood`, 3 скорости)" title: "\U0001F373 Вытяжка кухни — смена домена light → fan (`fan.kitchen_hood`, 3 скорости)"
aliases: aliases:
- kitchen hood - kitchen hood
- kitchen_hood - kitchen_hood
@@ -11,11 +11,14 @@ aliases:
- kitchen-hood-domain-conversion - kitchen-hood-domain-conversion
- kitchen-hood-fan-template - kitchen-hood-fan-template
created: '2026-09-16' created: '2026-09-16'
updated: 2026-09-16 updated: '2026-11-20'
note: "✅ ЗАКРЫТО полностью: fan.kitchen_hood создан, зона назначена, свет и диагностика скрыты, ссылка в карте этажей home_plan переведена с мёртвого fan.fan_3 на fan.kitchen_hood" note: >-
✅ ЗАКРЫТО полностью: fan.kitchen_hood создан, зона назначена, свет и
диагностика скрыты, ссылка в карте этажей home_plan переведена с мёртвого
fan.fan_3 на fan.kitchen_hood
type: tech type: tech
namespace: family namespace: family
status: "🟢 РАБОТАЕТ. fan.kitchen_hood (3 скорости, speed_count: 3) поверх light.kitchen_hood_light[,_2,_3]. Три света + 13 сущностей диагностики скрыты. План этажей починен. Проверено фактом 2026-09-16. ⚠️ Порядок скоростей ждёт физической проверки — §10." status: "\U0001F7E2 РАБОТАЕТ. fan.kitchen_hood (3 скорости, speed_count: 3) поверх light.kitchen_hood_light[,_2,_3]. Три света + 13 сущностей диагностики скрыты. План этажей починен. Проверено фактом 2026-09-16. ⚠️ Порядок скоростей ждёт физической проверки — §10."
tags: tags:
- family - family
- tech - tech
@@ -313,6 +316,8 @@ jq -r '.. | objects | select(.entity? != null) | .entity' /config/.storage/lovel
## 9. Роадмап вентиляции ## 9. Роадмап вентиляции
Рабочий документ общего алгоритма, его фактических подключений и отладки: [[family/tech/ventilation-ha-nodered]]. Создание `fan.kitchen_hood` само по себе не подтверждает его подключение к Node-RED.
[[family/documents/home-automation-wishlist]] §2 п.1 ожидает **«Kitchen Hood»** как конечный узел алгоритма вентиляции по CO₂ (Node-RED: `Demand Aggregator → Intake Allocation → Discretization → Damper Outputs → Exhaust Arbitration → Fans → Kitchen Hood`). Ранее узел был мёртв вместе с контуром AT2 — теперь у вытяжки есть **рабочая сущность `fan.kitchen_hood`**, на которую можно вешать автоматику. Ждёт решения по slave 10 (AT2 снят Alex'ом). [[family/documents/home-automation-wishlist]] §2 п.1 ожидает **«Kitchen Hood»** как конечный узел алгоритма вентиляции по CO₂ (Node-RED: `Demand Aggregator → Intake Allocation → Discretization → Damper Outputs → Exhaust Arbitration → Fans → Kitchen Hood`). Ранее узел был мёртв вместе с контуром AT2 — теперь у вытяжки есть **рабочая сущность `fan.kitchen_hood`**, на которую можно вешать автоматику. Ждёт решения по slave 10 (AT2 снят Alex'ом).
--- ---
+256
View File
@@ -0,0 +1,256 @@
---
title: 'Вентиляция — HA / Node-RED: логика, настройка и отладка'
aliases:
- Автоматика вентиляции
- Ventilation Node-RED
- Вентиляция HA настройка и отладка
tags:
- family
- tech
- smarthome
- home-assistant
- nodered
- ventilation
created: '2026-11-20'
updated: '2026-11-20'
status: Логика сверена с сохранённым flow; живой статус не проверен
---
# Вентиляция — HA / Node-RED: логика, настройка и отладка
Рабочий документ текущих работ по автоматике вентиляции: вычисление потребности, сценарии комнат, распределение притока, управление вытяжкой, настройка и проверка результата.
Карта оборудования, адреса Modbus, регистры и доступ к хосту остаются в [[family/how-to/home-automation]]. Реализация кухонной вытяжки — [[family/tech/kitchen-hood-fan-template]]. Здесь сохраняется описание поведения автоматики и состояние её доработок.
## 1. Статус и границы достоверности
Сводка собрана 2026-11-20. Логика ниже проверена по локальному `nodered-flows-updated.json` из проекта `/Users/admin/Automation/HA-ZONT-Modbus` (68 узлов, снимок апрельских работ 2026-04-13). Это доступный снимок кода, совпадение с текущим flow на t610 не установлено.
Последнее документированное эксплуатационное состояние — сентябрь 2026:
- Flow перенесён на HA OS / t610; путь `/addon_configs/a0d7b954_nodered/flows.json`, в справочнике указаны 68 узлов и подключение к HA через `addon: true`.
- Node-RED отмечен остановленным 2026-09-15. HA-автоматизация `Ventilation automation on` намеренно выключена. Это разные уровни включения; есть ещё переключатель внутри flow.
- Исполнительный контур AT2 описан как отключённый в конфигурации HA. Возобновление этой задачи ранее снято с работ; текущая документационная задача его не включает.
- Для кухонной вытяжки создан `fan.kitchen_hood`. Подключение этой сущности к Node-RED и физический порядок скоростей в доступных материалах не подтверждены.
Живой статус на 2026-11-20 не проверен: SSH к t610 вернул `Network is unreachable`; чтение HA API с локальным токеном отклонено автоматической проверкой разрешений. Статус «остановлен» выше относится к последней записи, а не к измерению сегодня.
Локальный апрельский flow содержит `addon: false`, поэтому его нельзя считать готовым экспортом для замены текущего flow t610. Старый путь NAS из локальной документации — исторический.
## 2. Роли HA и Node-RED
- HA предоставляет датчики, уставки, covers/fans и выполняет команды через свои сервисы и скрипты.
- Node-RED вычисляет спрос `0–100%`, хранит последнее состояние комнат, распределяет приток и выдаёт команды.
- Идея CRE (Consumer → Request → Executor): комнатный потребитель формирует запрос; общий исполнитель согласует запросы и управляет механизмами. В доступном flow модель реализована частично.
- Перекоммутация вытяжных заслонок, ручной override с TTL и холодовое ограничение остаются требованиями, а не подтверждённой реализацией.
Фактическая схема апрельского снимка:
```text
CO₂ спальни / детской / столовой → Demand соответствующей комнаты ──┐
TVOC / PM10 / CH₂O столовой → Demand cooking → join(3) → MAX ────────┤
Влажность кабинета + cron ON/OFF → Demand office ──────────────────┤
↓
Aggregate room demands
├─ allocation 2-го этажа
│ → kids / bedroom discretizer → rbe → HA cover
├─ dining discretizer → rbe A/B → HA covers
├─ office discretizer → rbe → HA cover
├─ rbe demands → debug 1
└─ Exhaust arbitration (PI)
├─ rbe → AT2-1 cmd → HA fan
├─ rbe → AT2-2 cmd → HA fan
└─ vent trace
```
Расчёт влажности столовой существует отдельным узлом, его выход никуда не подключён. Кухонный cooking demand в этом снимке до сервиса вытяжки не доведён.
## 3. Включение и события
`fan.automation` → `set global AUTOMATION_ENABLED` устанавливает boolean: включено только при строковом состоянии `on`.
Если флаг false или не задан, `Aggregate room demands` прекращает обработку до обновления `room_demands`. Команды выключения вентиляторов или закрытия заслонок при этом не выдаются. Уже выданные команды сохраняют действие; сохранённый спрос может устареть.
Датчики и helpers подаются узлами `server-state-changed` с `outputInitially: true`, затем только при изменении состояния; текущие `unknown/unavailable` игнорируются. Общего периодического пересчёта нет. Cron `12:35` подключён только к `debug 2` и автоматику не обновляет.
Изменение уставки только записывает её в global context. Немедленного пересчёта комнат не происходит: требуется следующее событие соответствующего датчика. Аналогично включение `fan.automation` само не вызывает проход агрегатора.
## 4. Вычисление спроса
Для подключённых сенсорных веток:
```text
demand = clamp(round((value - TARGET) / (MAX - TARGET) × 100), 0, 100)
```
- CO₂ спальни, детской, столовой: `TARGET = CO2_TARGET`, `MAX = 1500`.
- TVOC столовой → cooking: `TVOC_TARGET`, `MAX = 200`.
- PM10 столовой → cooking: `PM10_TARGET`, `MAX = 60`.
- Формальдегид столовой → cooking: `FORMALDEHYDE_TARGET`, `MAX = 20`; единицы измерения перед настройкой требуют сверки с датчиком.
- Влажность кабинета вне расписания: `HUMIDITY_TARGET`, `MAX = 80`.
Globals поступают из `input_number.co2_target`, `humidity_target`, `tvoc_target`, `pm10_target`, `formaldehyde_target`. Текущие живые значения не сняты. Пример с синтетической уставкой CO₂ 600: 600 ppm → 0%, 1050 ppm → 50%, 1500 ppm → 100%.
Отсутствующая уставка вызывает исключение. Проверки конечности чисел и условия `TARGET < MAX` в функциях нет; `NaN` может попасть в последующие расчёты.
Cooking получает максимум трёх нормированных запросов (topics `tvoc`, `pm10`, `formaldehyde`). Join собирает объект, `count=3`, `accumulate=true`, таймаута нет. До получения трёх частей стартовый результат может отсутствовать; свежесть сохранённых значений не контролируется.
Старая проектная кривая CO₂ 600/700/1500 и ступенчатые пороги TVOC/PM10 из `homeassistant/ventilation.md` — исходное предложение. В проверенном flow применяется линейная формула выше.
## 5. Сценарии комнат: реализация и требования
**Спальня и детская.** Спрос считается по CO₂ постоянно. Спальня не ограничена ночным окном. Дальше используется относительное распределение притока между двумя комнатами.
**Столовая.** Приток управляется только её CO₂ demand через две заслонки. TVOC/PM10/CH₂O идут в cooking и не увеличивают `demands.dining` в проверенном снимке.
**Кабинет.** Cron ON — `09:30`, OFF — `23:00`, оба `once=false`. ON сохраняет `scheduled_demand=true` и даёт demand 100%. Вне этого флага применяется влажность. Часовой пояс выполнения cron требует проверки в живом Node-RED; в сентябрьском справочнике HA указан `Asia/Krasnoyarsk`.
Узел OFF передаёт только `scheduled_demand=false`, без измерения влажности в `payload`. Поэтому именно событие OFF вычисляет `NaN`; следующее корректное событие влажности может заменить его. При запуске посреди рабочего окна автоматического восстановления расписания по текущему времени нет; сохранность флага зависит от context store.
**Кухня / cooking.** Спрос загрязнения вычисляется, но нет вызова ни старого `script.set_fan_3_speed`, ни нового `fan.kitchen_hood`. Отдельный `demands.kitchen` не формируется.
**Туалет, душевая, ванная.** Вытяжная арбитрация читает их спрос, но производителей этих запросов и cron для них в снимке нет.
**Северная и гостевая.** Автоматики в проверенном flow нет.
Требования из исходного плана, ожидающие реализации и проверки:
- Кабинет: рабочее окно `10:00–23:00`, независимый приток и вытяжка; время отличается от cron `09:30` в коде.
- Туалет: минимальная вытяжка `09:00–23:00`; позднее заменить расписание датчиками.
- Спальня: приток по CO₂ в `23:00–11:00`.
- Душевая: вытяжка 100% в `23:30–00:30` и `09:00–12:00`.
- Ванная: вытяжка 100% в `11:30–13:00` и `20:00–03:00`.
- Северная: закрывать в понедельник утром, открывать вручную; гостевая — ручной режим.
- При улице ниже −35 °C ограничивать приток столовой и детской до 66%.
- Ручной override комнаты с TTL 2 часа, автоматическое закрытие/выключение при отсутствии спроса.
## 6. Распределение притока
Для второго этажа:
```text
weighted.bedroom = demand.bedroom × 0.5
weighted.kids = demand.kids × 1.0
allocation.room = 100 × weighted.room / sum(weighted)
```
Это относительная доля, а не абсолютный спрос. Если запрос есть только у детской, даже demand 1% даёт allocation 100%. При одинаковых запросах доли примерно 33.3% спальне и 66.7% детской.
При сумме 0 функция возвращает `null`. Команда закрытия обеих заслонок не отправляется; предыдущие положения могут сохраниться.
Кабинет и столовая используют непосредственно свой demand, минуя это распределение. Приоритет гостиной 1.2, упомянутый в старой сводке Obsidian, в проверенном снимке отсутствует.
## 7. Дискретизация и ограничение частоты
Детская, спальня и кабинет: позиции `0 / 33 / 66 / 100`.
Начальная позиция без context: вход <10 → 0; <45 → 33; <75 → 66; иначе 100.
После инициализации используется гистерезис:
- Из 0: при входе ≥15 переход к 33.
- Из 33: <5 → 0; ≥45 → 66; иначе 33.
- Из 66: <35 → 33; ≥75 → 100; иначе 66.
- Из 100: <65 → 66; иначе 100.
За один проход возможен только один соседний переход. Скачок спроса до 100 при сохранённой позиции 0 сначала выдаёт 33.
Столовая: уровни `L0=[0,0]`, `L1=[66,0]`, `L2=[66,66]`, `L3=[100,66]`, `L4=[100,100]` для левой и правой заслонок.
- Начальный выбор: границы 10 / 30 / 55 / 80%.
- Вверх L0→L1→L2→L3→L4: границы 15 / 35 / 60 / 85%.
- Вниз L4→L3→L2→L1→L0: при входе ниже 75 / 45 / 20 / 5%.
- После инициализации также один соседний шаг за проход.
У всех дискретизаторов `MIN_INTERVAL_MS = 10 × 60 × 1000`. Событие внутри интервала отбрасывается; очереди, отложенной отправки и таймера повторения нет. Поэтому утверждение «команда придёт не позже чем через 10 минут» неверно: требуется новое событие после окончания интервала.
`last_sent` обновляется до downstream `rbe`, даже если позиция та же и сервис HA затем не вызывается. Это время пропущенного через gate расчёта, а не подтверждение физического движения.
Контекст: `kids_pos/last_sent`, `bedroom_pos/last_sent`, `office_pos/last_sent`, `dining_level/last_sent` с соответствующими префиксами. Он хранит расчётное последнее положение; обратная связь от фактического положения заслонки в этих узлах не используется.
## 8. Вытяжка и PI
```text
group1 = max(toilet, shower, kitchen)
group2 = max(bathroom, office)
error = max(bedroom, kids, dining)
dt = min(минуты с предыдущего вызова, 10)
если error == 0: integral = 0
иначе: integral = min(50, integral + error × dt × 0.03)
boost = round(error × 0.6 + integral)
fan1 = group1 > 0 ? min(100, max(group1, boost)) : 0
fan2 = group2 > 0 ? min(100, max(group2, boost)) : 0
```
`error` — нормированный спрос, а не ошибка CO₂ в ppm. В проверенном снимке столовая даёт сюда только CO₂. Состояние: `pi_last_ms`, `pi_integral`.
PI вызывается на каждом сообщении агрегатора, включая неизменившийся спрос; отдельного таймера PI нет. При редких событиях учитывается максимум 10 минут за вызов. Само течение времени без событий скорость не повышает.
Повышенный CO₂ сам по себе вентилятор не запускает: требуется ненулевой спрос соответствующей вытяжной группы. В доступном снимке нет производителей toilet/shower/kitchen/bathroom; кабинет — единственный подключённый источник group2. Автоматическое открытие вытяжных заслонок отсутствует.
Выходы fan идут через отдельные `rbe`: ноль вызывает `fan.turn_off`, положительное значение — `fan.set_percentage`. Дискретные скорости 30/50/70/100 из старой сводки в этой функции отсутствуют. Дополнительного ограничения частоты команд fan здесь нет.
## 9. Отладка
Порядок проверки для следующих работ:
1. Снять текущий flow t610, сравнить с апрельским снимком и записать дату/хеш. Проверить состояние аддона, подключение к HA и все уровни включения.
2. Проверить наличие входных сущностей и числовые значения helpers. После миграции ZHA проверить ссылку влажности кабинета: в апрельском flow остался старый Zigbee entity ID.
3. На входе каждой Demand проверить числовой `payload`, затем `room` и demand 0–100. Отдельно проверить cron OFF кабинета.
4. В `Aggregate room demands` проверить `flow.room_demands`: комнаты не исчезают сами и TTL нет. Значение могло сохраниться с прошлого события.
5. На втором этаже сравнить demand с `weighted` и `intake_pct`; при нулевом спросе проверить отсутствие команды закрытия.
6. В дискретизаторах проверить предыдущую позицию, `last_sent`, статус `throttled`, затем выход `rbe`.
7. В вытяжке проверить group1/group2, error, integral и fan-команды; наличие PI trace не доказывает открытие заслонок или движение воздуха.
8. Подтверждать результат последовательно: расчёт → сервис HA → состояние исполнительной сущности → физическая реакция. Сохранённое число положения в HA — программная оценка, а не само по себе измерение положения.
Доступные debug-узлы:
- `debug 1`: `msg.demands` после `rbe`, при изменении объекта.
- `vent trace`: `msg.trace` после Exhaust arbitration на каждом его выходе, включая расчёты с неизменившимся спросом.
- `debug 2`: timestamp от отдельного cron 12:35; не свидетельствует о работе вентиляции.
Ветки притока и вытяжки идут параллельно после агрегатора. Записи дискретизаторов в их `msg.trace` не собраны обратно в ветку вытяжки. Поэтому `vent trace` не является общей трассой всех решений; для притока требуется отдельный debug на его ветке.
Статусы дискретизаторов: 0 — чёрный, 33 — жёлтый, 66 — синий, 100 — зелёный; серое кольцо — gate. Для столовой статус показывает L0–L4 и обе позиции. В PI: зелёный error≤20, жёлтый 20<error≤50, красный >50; текст — обе скорости и integral.
Параметры настройки: входные helpers; приоритеты `bedroom=0.5/kids=1`; пороги и интервал дискретизаторов; PI `Kp=0.6`, `Ki=0.03`, предел integral 50. Изменения требуют сравнения с живым flow и отдельной проверки результата; значения здесь описывают доступный снимок.
## 10. Открытые работы и приёмка
Приоритетные дефекты доступного снимка:
- [ ] Нулевой спрос второго этажа должен выдавать требуемое закрытие вместо `return null`.
- [ ] OFF кабинета должен использовать валидное измерение влажности; расписание должно восстанавливаться после запуска.
- [ ] Определить согласованное поведение общего OFF и повторный расчёт при включении.
- [ ] Обеспечить актуальность запросов, обработку `NaN` и пересчёт после смены уставки.
- [ ] Согласовать способ запуска вытяжки по CO₂ с запросами групп и управлением вытяжными заслонками.
- [ ] Подключить cooking к актуальному кухонному fan; проверить соответствие скоростей физически.
- [ ] Определить гарантированную повторную обработку после gate и поведение при ручном изменении положения.
- [ ] Реализовать согласованные расписания, override и холодовое ограничение из §5.
Приёмка после будущих изменений:
- [ ] Записаны действующий экспорт и различия с исходным снимком.
- [ ] Прогнаны рост/спад CO₂, нулевой спрос всех комнат, start/restart, OFF/ON и изменение уставки без изменения датчика.
- [ ] Проверены границы cron, переход через полночь и запуск внутри рабочего окна.
- [ ] Проверены отсутствие/восстановление датчика, неполный cooking join и нечисловые значения.
- [ ] Проверены gate, гистерезис, ручное управление и фактическое закрытие при нулевом спросе.
- [ ] Для вытяжки проверены маршрут воздуха, заслонки, команда fan и физическая реакция.
Эти пункты — очередь проверки и доработок; код и эксплуатационное состояние данной документационной работой не менялись.
## 11. Проверка документа и источники
2026-11-20 выполнена сверка графа и функций локального JSON. Семь синтетических проверок через Node.js с выполнением исходного кода Function-узлов подтвердили:
- CO₂ 1050 при TARGET 600 → demand 50%.
- Нулевые запросы второго этажа → `null`; единственный kids demand 1% → allocation 100%.
- OFF кабинета без влажности → `NaN`.
- Позиция 0 при входе 100 → 33; следующее событие внутри 10 минут отбрасывается.
- Неизменившееся положение тоже обновляет `last_sent`.
- Только kids demand 100 при нулевых групповых запросах → оба fan 0.
- Общий OFF отбрасывает новое значение и сохраняет прежний `room_demands`.
Это проверка функций с подставленными context/time, без запущенного Node-RED, HA и механизмов. Сквозной прогон на действующей системе не выполнялся.
Источники:
- `nodered-flows-updated.json`, SHA-256 `464fdcf196a9c925ee5595db85dbc74498c55c2731d591bc390fe49a47b844f7`: проверенный доступный код.
- `nodered-flows-backup.json`: предшествующая версия; в ней Exhaust arbitration не подключён к агрегатору.
- `homeassistant/ventilation-nodered.md`: исходная заметка State & Debug Guide от 2026-04-13; содержание перенесено сюда с исправлением расхождений с кодом, в проекте оставлен указатель.
- `homeassistant/ventilation.md`: исходные требования CRE и сценарии; предложения отделены от реализации.
- [[family/how-to/home-automation]]: топология, состояние t610 и Node-RED, прежние краткие описания алгоритма.
- [[family/how-to/ha-automations]]: HA-автоматизации, отдельное состояние Ventilation automation on.
- [[family/documents/home-automation-wishlist]]: исторические блокеры и роадмап.
- [[family/tech/kitchen-hood-fan-template]]: реализация актуального кухонного fan.