Files
obsidian-vault/family/tech/ventilation-ha-nodered.md
T

345 lines
38 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
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, жёлтый 20<error≤50, красный >50; текст — обе скорости и 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.