452 lines
61 KiB
Markdown
452 lines
61 KiB
Markdown
---
|
||
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: >-
|
||
Базовая модель дома собрана: 18 зон, Blender/GLB, 12 сценариев; натурная
|
||
калибровка и приёмка предстоят
|
||
---
|
||
# Вентиляция — калибровка, сценарии и система автоматики
|
||
|
||
Рабочий документ проекта законченной системы вентиляции: калибровка датчиков температуры и качества воздуха, измерение потоков, описание и воспроизведение сценариев, настройка реакций и сборка проверяемой конфигурации.
|
||
|
||
**Для моделирования выбран комплект OpenModelica + Buildings + Python** (§0.4.1–0.4.5). Собрана базовая модель всего дома: 18 помещений, 3D-геометрия, полная документированная воздушная сеть и 12 расчётных сценариев; аэродинамические коэффициенты требуют натурной калибровки. Прежний выбор CONTAM заменён. **Платформа автоматики пока не выбрана.** 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.4.1. Пересмотр выбора: OpenModelica + Buildings + Python
|
||
|
||
Решение 2026-11-20 после повторного анализа: для моделирования выбран **OpenModelica + Modelica Buildings + Python**. Прежний выбор CONTAM заменён. Платформа исполнения действующей автоматики при этом не выбрана.
|
||
|
||
**Главный критерий:** минимальное ручное участие владельца. Создание и изменение модели, расчёт конфигураций, обработка измерений и подбор параметров должны выполняться программно. Простота графического редактора сама по себе этому критерию не соответствует.
|
||
|
||
Выбранный комплект:
|
||
- **OpenModelica** — компиляция и расчёт текстовой модели без GUI; испытан официальный Docker-образ ARM64 на текущем Mac.
|
||
- **Modelica Buildings** — открытая библиотека готовых компонентов: помещения, двери, сопротивления, заслонки, вентиляторы, перенос загрязнений и отопление.
|
||
- **Python** — подготовка входных данных, формирование модели/параметров, запуск серий, сравнение с измерениями, подгонка и отчёты.
|
||
- **Программная 3D-геометрия из тех же данных помещений** — отдельное представление модели для визуальной проверки. В испытании сформированы OBJ и PNG; ручное рисование владельцем в CAD не требуется для такого маршрута.
|
||
|
||
Это комплект разработки модели. Готового универсального мастера «загрузить план и замеры → получить всю настроенную систему» не подтверждено. Труд разработки конвейера ложится на программную реализацию, а не на ручную работу владельца в интерфейсе.
|
||
|
||
### 0.4.2. Практическая проверка нового маршрута
|
||
|
||
Выполнен синтетический тест, без участия реального оборудования и без физических измерений дома:
|
||
- Среда: текущий Mac ARM64 → Docker/Colima Linux ARM64.
|
||
- Компилятор: OpenModelica 1.27.1. Библиотека: Buildings 14.0.0.
|
||
- Программно подготовлена модель двух помещений, двух приточных заслонок, открываемой двери и вытяжного вентилятора с характеристикой давления/расхода.
|
||
- Пакетный `omc` успешно скомпилировал модель: 386 уравнений и 386 переменных.
|
||
- Прогнаны пять конфигураций: дверь закрыта/открыта, низкая скорость fan, ограниченная заслонка A, отдельная контрольная конфигурация.
|
||
- Подтверждены баланс расходов и изменения результата при изменении двери, скорости и заслонки.
|
||
- Автоматически восстановлен один параметр сопротивления: истинное значение 1.7, начальное приближение 0.8, результат около 1.7. Подгонка по четырём конфигурациям, проверка на пятой; 62 вызова расчётного исполняемого файла.
|
||
- Из общего `fixture.json` получены расчётные объёмы и тестовая 3D-геометрия двух помещений; OBJ и изображение созданы программно.
|
||
- Воспроизводимый `verify.sh` дополнительно выполнен в новом чистом контейнере: код завершения 0, восемь проверок пройдены. Временные контейнеры после сохранения результатов удалены.
|
||
|
||
Наблюдения для подгонки сгенерированы тем же симулятором без шума. Такой тест подтверждает техническую работоспособность автоматической подгонки, а не точность модели реального дома и не возможность восстановить произвольное число неизвестных из любых замеров.
|
||
|
||
Артефакты в проекте `/Users/admin/Automation/HA-ZONT-Modbus/homeassistant/modeling-evaluation/2026-11-20/`:
|
||
- `README.md` — полный пересмотр, метод, ограничения и источники.
|
||
- `verify.sh` — воспроизводимый прогон в одноразовом контейнере.
|
||
- `fixture.json`, `TwoRoomTrial.mo`, `evaluate.py` — исходные данные и расчёт.
|
||
- `results.json`, `compile.log` — результаты и диагностический лог.
|
||
- `geometry.py`, `rooms.obj`, `preview.png` — проверка программной 3D-геометрии.
|
||
|
||
### 0.4.3. Сравнение кандидатов по критерию автономной работы
|
||
|
||
- **OpenModelica + Buildings + Python — выбран.** Текстовые модели, произвольная сеть компонентов, пакетные расчёты, открытый код и перспектива добавления отопления. На текущем окружении фактически проверены компиляция, серии расчётов и автоматическая подгонка. Удобство для владельца достигается автоматизацией подготовки, а не необходимостью изучать Modelica.
|
||
- **EnergyPlus + AirflowNetwork — альтернативный кандидат.** Есть нативная macOS ARM64-сборка, CLI/Python API и epJSON для программного создания модели. Хорошо подходит для совместного расчёта здания и энергопотребления. Часть воздушной сети привязана к структуре HVAC/air loops и имеет документированные ограничения. Оценка более сложной адаптации двух общих вытяжных групп — инженерный вывод по документации; практический сравнительный прогон не выполнен.
|
||
- **CONTAM — снят статус окончательного выбора.** Расчётные возможности подходят, и работа не обязана сводиться к ручному GUI: NIST описывает API расчёта и создания/изменения проектов. Однако полный программный маршрут на текущем ARM64-окружении не проверен. Windows-редактор и наличие функций воздухообмена не были достаточным основанием назвать систему самой удобной для автономного выполнения работ.
|
||
- **OpenFOAM/Carbonfly — возможная последующая детализация.** Предназначены для пространственных потоков внутри помещений. Для первого этапа расходов между комнатами добавляют подготовку сетки и граничных условий. Практически не испытывались.
|
||
|
||
Первоначальный выбор OpenModelica опирался на заданный способ работы и небольшой прототип; затем конвейер проверен на полной модели дома (§0.4.5). Практический сравнительный прогон всех альтернатив не выполнялся; точность модели дома остаётся предметом натурной калибровки.
|
||
|
||
### 0.4.4. Что может выполняться программно и где остаётся участие владельца
|
||
|
||
Программная часть проекта:
|
||
- Восстановление описания помещений по имеющимся планам и размерам, генерация проверяемого 3D-представления.
|
||
- Создание сети путей воздуха и моделей оборудования.
|
||
- Подготовка пошаговых заданий для замеров и привязка каждого результата к конфигурации.
|
||
- Обработка измерений, подбор определяемых по ним параметров, оценка расхождения на отдельных контрольных замерах.
|
||
- Прогон сценариев, подбор режимов, подготовка правил/конфигурации будущей автоматики и документации.
|
||
|
||
Участие владельца требуется для физических сведений, которых нет в исходниках: подтвердить фактический монтаж/геометрию, выполнить измерения, отметить состояние дверей и механизмов, подтвердить конечную физическую реакцию. При доступном управлении оборудованием переключение испытательных конфигураций можно автоматизировать; такой живой маршрут ещё не проверен.
|
||
|
||
В проекте уже есть планы этажей, размерные изображения и разрез. `floorplan/PLAN.md` указывает отсутствие схемы вентиляции в исходном проекте. Фактические трассы и размеры каналов нельзя получить из условных иконок HA.
|
||
|
||
Границы проверки после сборки модели дома (§0.4.5):
|
||
- Двухкомнатный синтетический прототип сохранён как отдельная первоначальная проверка инструмента; модель реального дома теперь собрана отдельно в `homeassistant/ventilation-model/`.
|
||
- На полной сети проверены расчёт CO₂, влажности, частиц, условных VOC/HCHO, ветрового давления и высотной тяги. Физическая точность неизмеренных коэффициентов пока не подтверждена.
|
||
- `DoorOperable` для промежуточного входа `y` интерполирует между закрытой и открытой дверью. Это не угол открытия; точную зависимость для приоткрытой двери требуется определить измерениями.
|
||
- Типовая характеристика заслонки не заменяет измерение расхода при её реальных дискретных положениях.
|
||
- Для натурной подгонки нужны достаточные измерения и раздельная контрольная выборка. Удачная синтетическая подгонка не является полевой валидацией.
|
||
- Установка на HA, управление механизмами, согласованные реакции автоматики и сквозная натурная приёмка пока не выполнены.
|
||
Источники:
|
||
- [OpenModelica: официальный Docker ARM64 и пакетный omc](https://openmodelica.org/download/docker/).
|
||
- [Buildings 14.0.0: испытанные версии компиляторов](https://github.com/lbl-srg/modelica-buildings/releases/tag/v14.0.0).
|
||
- [Buildings: многозонные модели и ограничения DoorOperable](https://simulationresearch.lbl.gov/modelica/releases/v14.0.0/help/Buildings_Airflow_Multizone.html).
|
||
- [SciPy: подбор параметров методом least_squares](https://docs.scipy.org/doc/scipy/reference/generated/scipy.optimize.least_squares.html).
|
||
- [EnergyPlus: воздушная сеть и ограничения](https://energyplus.readthedocs.io/en/stable/guides/input-output-reference/1.27-group-airflow-network.html).
|
||
- [EnergyPlus: программный формат epJSON](https://energyplus.readthedocs.io/en/v25.1.0/essentials/essentials.html).
|
||
- [NIST: Development and Application of CONTAM APIs](https://www.nist.gov/publications/development-and-application-contam-apis).
|
||
|
||
### 0.4.5. Базовая модель всего дома — 2026-11-20
|
||
|
||
Модель сохранена в проекте: `/Users/admin/Automation/HA-ZONT-Modbus/homeassistant/ventilation-model/`. Основной паспорт — `README.md`; повторный прогон — `verify.sh`.
|
||
|
||
**Геометрия и источники.** Публичные планы `floor1_ha.svg` и `floor2_ha.svg`, скачанные из HA без токена, совпали с локальными SVG по SHA-256. Для метрической геометрии использован замороженный снимок векторных контуров обмерных PDF из существующей работы `floorplan/blender/`; эта независимая работа не изменялась. Сверены восемь исходных PDF. Все 18 помещений и реальные контуры проёмов включены; отметка второго этажа 3,25 м. Согласованность масштаба по 11 размерным привязкам — до 2,65 мм, это характеристика чертежа, не точность натурного обмера.
|
||
|
||
По контурам: 219,94 м² полезной площади и 620,98 м³ воздуха; первый этаж 110,32 м² / 319,54 м³, второй 109,61 м² / 301,44 м³. Повторяющиеся в PDF итоги 64,77 м² не использованы. Расхождения отдельных подписанных и векторных площадей сохранены; наибольшее — ванная, 0,282 м² (2,74%).
|
||
|
||
Первый этаж: тамбур, котельная, холл-лестница, гостиная-столовая, кухня, кладовая, гостевой санузел, сауна, кабинет. Второй: холл-лестница, коридор, взрослая спальня, гардеробная, взрослая душевая, гостевая, детская 1, детская 2 / северная, ванная-постирочная.
|
||
|
||
**Состав воздушной сети:**
|
||
- 16 внутренних дверей/проходов и вертикальная лестничная связь.
|
||
- 18 физических наружных проёмов, 19 расчётных путей: непрерывное лестничное остекление разделено между этажами. Открываемость окон требует подтверждения.
|
||
- 6 приточных заслонок; 5 вытяжных заслонок; две группы AT2 и отдельная кухонная вытяжка.
|
||
- Общие коллекторы, сопротивления ветвей, наружные утечки и гидростатические перепады. Реальная трассировка каналов неизвестна; коллекторы заданы топологически.
|
||
- 33 канала от 14 документированных устройств датчиков/присутствия, с исходными gain=1 и offset=0. Entity_id и текущая доступность не сверены с живым HA; старые поправки CO₂ повторно не применяются.
|
||
|
||
**Физика:** переменные давления с накоплением массы, температура и влажность смешанных объёмов, CO₂, PM2.5/PM10, отдельные условные компоненты VOC/HCHO, двунаправленный обмен через двери, суммарный лестничный поток, условный ветер, упрощённые теплопотери/инерция и идеальный источник тепла. Реальная система отопления и охрана ещё не добавлены. Пространственные струи/CFD, конденсация и тяга котла не рассчитываются.
|
||
|
||
**Проверки:** OpenModelica 1.27.1 + Buildings 14.0.0; 9717 уравнений / 9717 переменных. Все 12 двухчасовых сценариев прошли: дом, ночь, открытые двери, низкая и высокая скорость, готовка, душ, уход, отъезд, приезд, ветер, остановка вентиляторов. Проверены конечность выходов, неотрицательность концентраций, баланс массы 18 зон, рост вытяжки со скоростью, импульсы загрязнений/влажности и спад CO₂ после ухода. Численный остаток массового баланса на выданных отсчётах — до 1,2×10⁻¹⁶ кг/с; физическую точность это не задаёт. 72 объёмные сетки проверены по объёмам исходных контуров. Все 18 скрытых воздушных объёмов Blender отдельно сопоставлены с расчётными зонами, включая воздух над лестницей: максимальное расхождение 1,35×10⁻⁵ м³. GLB повторно импортирован: 50 объектов, метрические габариты подтверждены. Сквозной verify.sh выполнен в новом чистом контейнере с кодом завершения 0; все этапы прошли.
|
||
|
||
**Автоматическая подгонка:** на полной модели восстановлен один коэффициент сопротивления 1,7 → 1,69999995; 12 синтетических обучающих наблюдений в двух конфигурациях, 6 контрольных в отдельной конфигурации дверей, 27 вызовов симулятора. Проверена также линейная коррекция датчика. Данные без шума созданы тем же симулятором; это проверка конвейера, не натурная калибровка.
|
||
|
||
**Артефакты:**
|
||
- `geometry/house.blend`, `geometry/house.glb` — редактируемая и переносимая 3D-модель; полная высота стен и проёмы. Маркеры устройств внутри комнат условные.
|
||
- `geometry/overview.png`, `floor1.png`, `floor2.png` — обзор со срезом стен и планы с названиями/площадями.
|
||
- `house.json`, `HouseVentilation.mo`, `signals.json` — исходные данные, расчёт и привязки сигналов.
|
||
- `scenarios.json`, `results/`, `validation.json` — конфигурации, временные ряды и проверки.
|
||
- `measurements/airflow.csv`, `sensors.csv`, `fit-config.json`, `calibrate.py` — пустые натурные шаблоны и подбор ограниченного набора параметров с контрольной выборкой.
|
||
- `synthetic-check/` — отдельные искусственные данные и отчёт, не смешанные с натурными замерами.
|
||
|
||
**До полевой калибровки** кривые вентиляторов, сопротивления каналов, утечки, зависимость расхода от команды и часть высот являются начальными оценками. Часть геометрических высот взята из проекта, а не обмера. Окончательные реакции ухода/отъезда/приезда не утверждены; текущие значения сценариев служат расчётными примерами.
|
||
|
||
### 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.
|