From d46455a79d70485988f406c9dc7573d0aad9467e Mon Sep 17 00:00:00 2001 From: Alexey Martemyanov Date: Fri, 20 Nov 2026 13:13:35 +0600 Subject: [PATCH] [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 --- family/documents/home-automation-wishlist.md | 7 +- family/how-to/ha-automations.md | 4 + family/how-to/home-automation.md | 30 ++- family/tech/kitchen-hood-fan-template.md | 13 +- family/tech/ventilation-ha-nodered.md | 256 +++++++++++++++++++ 5 files changed, 296 insertions(+), 14 deletions(-) create mode 100644 family/tech/ventilation-ha-nodered.md diff --git a/family/documents/home-automation-wishlist.md b/family/documents/home-automation-wishlist.md index 55c3d2ce..d55dfa03 100755 --- a/family/documents/home-automation-wishlist.md +++ b/family/documents/home-automation-wishlist.md @@ -1,4 +1,7 @@ --- +updated: '2026-11-20' +--- +--- title: "🏡 Умный дом — хотелки и роадмап автоматизаций" aliases: [Умный дом, Умный дом хотелки, Home automation, Smart home, home-automation-wishlist] tags: [family, lists, smart-home, tech] @@ -36,7 +39,7 @@ related: > Порядок — рекомендация агента (отдача / стоимость). Финальный порядок — за Alex. ### 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`. > ✅ **По вытяжке кухни — СДЕЛАНО 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 → железо живо). @@ -119,7 +122,7 @@ ZONT-реле котлов уже дают статусы; 2 Zigbee-розетк - [[family/how-to/home-automation]] — **единственный рабочий документ** по техчасти: хост, доступ, аддоны, Modbus, Zigbee, питфоллы - [[family/how-to/home-automation]] — карта железза: AT2 (параметры/PWM), Slave ID, регистры заслонок/реле, ZONT relays - [[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/documents/home-wishlist]] — хотелки по дому и участку (не автоматизация) - [[family/index]] — топик-карта family/ diff --git a/family/how-to/ha-automations.md b/family/how-to/ha-automations.md index 9b51c604..d27a1a5d 100755 --- a/family/how-to/ha-automations.md +++ b/family/how-to/ha-automations.md @@ -1,6 +1,10 @@ +--- +updated: '2026-11-20' +--- # ⚙️ HA — автоматизации > **Справочник логики автоматизаций** (`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. > diff --git a/family/how-to/home-automation.md b/family/how-to/home-automation.md index 397b0171..6adc5196 100755 --- a/family/how-to/home-automation.md +++ b/family/how-to/home-automation.md @@ -1,13 +1,26 @@ --- -title: "🏠 Домашняя автоматизация" -aliases: [Умный дом, Home automation, HA, Zigbee, Modbus, вентиляция, t610, RCU stall, USB reset] -tags: [family, how-to, smarthome] -updated: 2026-09-18 +title: "\U0001F3E0 Домашняя автоматизация" +aliases: + - Умный дом + - 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]]. > **Метрики хоста (RAM/темп, аддон)** — [[family/tech/t610-hw-metrics-addon]]. > 🔌 **«Почему реле выключилось» — разбор по логбуку:** [[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 без токена). Модуль: `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/" > /tmp/aut_.json ### 5.4. Вентиляция по CO₂ (Node-RED) -Структура: `demand aggregator → intake allocation → дискретизация заслонок → outputs → exhaust arbitration → заслонки вытяжки → вентиляторы → вытяжка кухни`. -Всё в HA — через Node-RED ingress. Данные: `modbus/sensors//` в MQTT. +Рабочая документация: [[family/tech/ventilation-ha-nodered]] — фактический граф доступного flow, формулы спроса и PI, расписания, гистерезис, ограничения и приёмка. + +После агрегатора приток и вытяжка расходятся параллельными ветками. Управление вытяжными заслонками и кухонным fan в проверенном снимке отсутствует; прежняя последовательная цепочка описывала целевой контур. Доступ к Node-RED на t610 — через ingress HA; эксплуатационные статусы выше датированы сентябрём 2026. --- diff --git a/family/tech/kitchen-hood-fan-template.md b/family/tech/kitchen-hood-fan-template.md index a0fbd34e..85fc693c 100755 --- a/family/tech/kitchen-hood-fan-template.md +++ b/family/tech/kitchen-hood-fan-template.md @@ -1,5 +1,5 @@ --- -title: "🍳 Вытяжка кухни — смена домена light → fan (`fan.kitchen_hood`, 3 скорости)" +title: "\U0001F373 Вытяжка кухни — смена домена light → fan (`fan.kitchen_hood`, 3 скорости)" aliases: - kitchen hood - kitchen_hood @@ -11,11 +11,14 @@ aliases: - kitchen-hood-domain-conversion - kitchen-hood-fan-template created: '2026-09-16' -updated: 2026-09-16 -note: "✅ ЗАКРЫТО полностью: fan.kitchen_hood создан, зона назначена, свет и диагностика скрыты, ссылка в карте этажей home_plan переведена с мёртвого fan.fan_3 на fan.kitchen_hood" +updated: '2026-11-20' +note: >- + ✅ ЗАКРЫТО полностью: fan.kitchen_hood создан, зона назначена, свет и + диагностика скрыты, ссылка в карте этажей home_plan переведена с мёртвого + fan.fan_3 на fan.kitchen_hood type: tech 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: - family - tech @@ -313,6 +316,8 @@ jq -r '.. | objects | select(.entity? != null) | .entity' /config/.storage/lovel ## 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'ом). --- diff --git a/family/tech/ventilation-ha-nodered.md b/family/tech/ventilation-ha-nodered.md new file mode 100644 index 00000000..33513dcd --- /dev/null +++ b/family/tech/ventilation-ha-nodered.md @@ -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, жёлтый 2050; текст — обе скорости и 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.