--- title: 'Вентиляция — калибровка, сценарии и система автоматики' aliases: - Автоматика вентиляции - Ventilation Node-RED - Вентиляция HA настройка и отладка - 'Вентиляция — HA / Node-RED: логика, настройка и отладка' - Калибровка и сценарии вентиляции tags: - family - tech - smarthome - home-assistant - nodered - ventilation created: '2026-11-20' updated: '2026-11-20' status: >- Скоуп уточнён; платформа не выбрана; исходный flow разобран, измерения и сквозная приёмка предстоят --- # Вентиляция — калибровка, сценарии и система автоматики Рабочий документ проекта законченной системы вентиляции: калибровка датчиков температуры и качества воздуха, измерение потоков, описание и воспроизведение сценариев, настройка реакций и сборка проверяемой конфигурации. **Платформа автоматики пока не выбрана.** Node-RED — существующая реализация для разбора и источник исходного состояния. Конечная система может использовать другую подходящую платформу; дальнейшие требования задаются через поведение и результаты измерений. Карта оборудования, адреса Modbus, регистры и доступ к хосту остаются в [[family/how-to/home-automation]]. Реализация кухонной вытяжки — [[family/tech/kitchen-hood-fan-template]]. ## 0. Скоуп и результат проекта Уточнение скоупа: 2026-11-20. Следующие этапы входят в проект; физические измерения и настройка реакций ещё не выполнены. ### 0.1. Датчики и калибровка - Инвентаризировать используемые датчики температуры и качества воздуха по помещениям и измеряемым величинам: температура, влажность, CO₂, TVOC, частицы, формальдегид. - Проверить единицы, размещение, свежесть данных и сопоставимость показаний. - Описать метод проверки и доступный эталон для каждого типа датчика; сравнительные показания без подтверждённого эталона не обозначать как абсолютную калибровку. - Зафиксировать исходные показания, условия сравнения, поправки, место их применения и повторную проверку. Сохранять исходное значение рядом со скорректированным. - Для каналов без подтверждённой точности явно записать ограничения использования в автоматике. Результат этапа: паспорт проверки каждого используемого канала и согласованные данные на входе управления. ### 0.2. Потоки воздуха и конфигурации дома Измерить потоки при разных сочетаниях: - Положений приточных и вытяжных заслонок. - Скоростей вытяжных вентиляторов и кухонной вытяжки. - Открытости межкомнатных дверей и доступных путей перетока. Каждый опыт получает идентификатор и запись: дата, метод и прибор, точка измерения, положение каждой участвующей заслонки, скорости вентиляторов, положение дверей, условия в помещении и снаружи, время стабилизации, повторные измерения и единицы результата. Команду механизму и подтверждённое положение фиксировать раздельно. Результат этапа: воспроизводимые конфигурации и измеренные зависимости «заслонки + скорости + двери → потоки по помещениям». Проценты команд сами по себе расходом воздуха не считать. Матрицу опытов составить до начала замеров, начиная с исходного состояния и изменений отдельных факторов. ### 0.3. Сценарии и режимы дома Описать, затем воспроизвести различные юзкейсы и настроить реакцию вентиляции по результатам измерений. Обязательная часть скоупа: - Обычное использование помещений и характерные изменения температуры/качества воздуха. - Кратковременный уход из дома. - Длительный отъезд. - Возвращение / приезд и переход к обычному использованию. - Изменение открытости дверей при тех же запросах вентиляции. Предварительные примеры для каталога: сон, дневное использование детской, работа в кабинете, готовка, использование душевой/ванной, одновременные запросы нескольких помещений. Набор и ожидаемые реакции требуют уточнения; старые расписания ниже остаются исходными предложениями. Карточка каждого сценария: - Начальное состояние дома, занятость помещений и конфигурация дверей/заслонок. - Событие или последовательность действий, включая способ задания режима дома. - Ожидаемая реакция, допустимые задержки, приоритеты и ручные вмешательства. - Какие измерения должны подтвердить результат и по каким критериям сценарий принят. - Фактический прогон, наблюдения, отклонения, изменения настройки и повторная проверка. Входы, длительности и конкретные действия для ухода/отъезда/приезда пока не заданы. Эти режимы не приравниваются автоматически к полному выключению вентиляции. Режимы отъезда/приезда в дальнейшем должны связываться с отоплением и охраной. Состояние дома и переходы требуется описать единообразно, с будущими точками интеграции для этих подсистем. Их подключение — последующий этап; конкретные команды отоплению и охране пока не определены. ### 0.4. Выбор платформы и сборка системы Платформа выбирается после уточнения сценариев и измерительных зависимостей. Критерии выбора: воспроизведение сценариев, проверяемость правил, управление приоритетами и ручным режимом, восстановление после рестарта/потери данных, понятная диагностика, поддерживаемость и будущая связь с отоплением/охраной. Сборка законченной системы включает: - Согласованную модель входов, режимов дома, запросов и исполнительных команд. - Правила реакции на сценарии с учётом измеренных потоков. - Правила ручного управления, приоритетов, отсутствия данных и восстановления состояния. - Версионируемый комплект конфигурации/кода, параметров калибровки и сценарных проверок. - Воспроизводимую процедуру сборки или компиляции, если она требуется выбранной платформой, установки и возврата к предыдущей конфигурации. - Сквозную проверку сценариев на действующей системе и эксплуатационную документацию. Результат проекта — собранная и проверенная система, поведение которой подтверждено измерениями и прогонами сценариев. Выбор или запуск движка автоматики сам по себе завершением не считается. ### 0.5. Первичный состав системы для уточнения 1. Датчики температуры и качества воздуха по помещениям; наружные условия для интерпретации измерений и ограничений. 2. Калибровочные данные: эталоны/методы сравнения, исходные показания, поправки и проверка результата. 3. Приточные заслонки: столовая (две), кабинет, спальня, детская, северная. 4. Вытяжные заслонки: кухня, туалет, душевая, ванная, кабинет. 5. Вентиляторы: две группы AT2 и отдельная кухонная вытяжка. 6. Пути перетока между помещениями и состояние дверей. 7. Измерительная часть: приборы, точки замера, матрица конфигураций и журнал потоков. 8. Модель воздухообмена: измеренные зависимости расхода от конфигурации и расчёт требуемого режима. 9. Каталог юзкейсов и режимов дома, включая уход, отъезд и возвращение. 10. Исполняющая автоматика: выбранная платформа, согласование запросов, команды, приоритеты, ручное управление и восстановление. 11. Наблюдаемость и проверка: история, трассировки, воспроизведение сценариев, критерии приёмки. 12. Комплект системы: конфигурация/код, параметры, сборка, установка и документация; будущие связи режимов дома с отоплением и охраной. Это начальный перечень для уточнения состава, а не утверждение о готовности каждого элемента. Далее сохранён разбор исходной реализации Node-RED. Выявленные дефекты задают случаи для проверки будущего поведения; исправление именно старого flow не является обязательным способом реализации проекта. ## 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. Дефекты исходного flow и проверки будущего поведения Приоритетные дефекты доступного снимка: - [ ] Нулевой спрос второго этажа должен выдавать требуемое закрытие вместо `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.