27 KiB
title, aliases, tags, created, updated, status
| title | aliases | tags | created | updated | status | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Вентиляция — HA / Node-RED: логика, настройка и отладка |
|
|
2026-11-20 | 2026-11-20 | Логика сверена с сохранённым 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 и холодовое ограничение остаются требованиями, а не подтверждённой реализацией.
Фактическая схема апрельского снимка:
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. Вычисление спроса
Для подключённых сенсорных веток:
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, независимый приток и вытяжка; время отличается от cron09: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. Распределение притока
Для второго этажа:
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
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. Отладка
Порядок проверки для следующих работ:
- Снять текущий flow t610, сравнить с апрельским снимком и записать дату/хеш. Проверить состояние аддона, подключение к HA и все уровни включения.
- Проверить наличие входных сущностей и числовые значения helpers. После миграции ZHA проверить ссылку влажности кабинета: в апрельском flow остался старый Zigbee entity ID.
- На входе каждой Demand проверить числовой
payload, затемroomи demand 0–100. Отдельно проверить cron OFF кабинета. - В
Aggregate room demandsпроверитьflow.room_demands: комнаты не исчезают сами и TTL нет. Значение могло сохраниться с прошлого события. - На втором этаже сравнить demand с
weightedиintake_pct; при нулевом спросе проверить отсутствие команды закрытия. - В дискретизаторах проверить предыдущую позицию,
last_sent, статусthrottled, затем выходrbe. - В вытяжке проверить group1/group2, error, integral и fan-команды; наличие PI trace не доказывает открытие заслонок или движение воздуха.
- Подтверждать результат последовательно: расчёт → сервис 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-256464fdcf196a9c925ee5595db85dbc74498c55c2731d591bc390fe49a47b844f7: проверенный доступный код.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.