Breezart Home Assistant Integration

Полнофункциональная интеграция систем вентиляции Breezart для Home Assistant.
Использует нативный TCP-протокол (порт 1560) для быстрого и надёжного управления.

Установка через HACS

Если нужно подробнее про формирование ссылки, см. документацию HACS: https://www.hacs.xyz/docs/contribute/documentation/#creating-links

✨ Особенности

• 🌡️ Climate Entity (Термостат) — единое управление температурой, режимами и скоростью вентилятора
• ⚡ Мгновенный отклик UI — optimistic updates с удержанием 6 секунд для плавного управления
• 📊 Расширенные сенсоры — температура, влажность, CO₂, VOC, состояние фильтров с правильными названиями
• 🔄 Двусторонняя синхронизация — изменения с пульта автоматически отображаются в HA (3 секунды)
• 🎛️ Полное управление — все функции доступны через Home Assistant
• 🌡️ Правильное отображение температур — текущая температура = воздух на выходе, уставка = заданная температура
• 🔌 Нативный протокол — прямое TCP-подключение без Modbus, оптимизированный опрос (3/30 сек)

🔧 Совместимость

• Модели: Breezart 550 Aqua и другие с контроллером JetLogic JL205
• Контроллер: TPD-283U-H с подключением к локальной сети
• Требования: Активированный режим удалённого управления с паролем
• Home Assistant: 2023.1.0+

🎯 Возможности

Climate (Термостат)

Единая карточка управления климатом:

• 🌡️ Установка целевой температуры (10-30°C)
• 💨 Выбор скорости вентилятора (1-8)
• 🔄 Режимы: Обогрев / Охлаждение / Авто / Вентиляция / Выключено
• 📈 Отображение текущей температуры
• ⚡ Включение/выключение установки

Сенсоры (всегда активные)

Сенсор	Описание
🌡️ Температура (точка регулирования)	Текущая температура в точке регулирования (INPUT[13])
🌡️ Температура подачи (выход установки)	Температура воздуха на выходе установки (INPUT[50])
💨 Скорость вентилятора	Текущая скорость (0-8)
💧 Влажность	Относительная влажность (%)
🔄 Режим работы	Обогрев / Охлаждение / Авто / Вентиляция
⚙️ Состояние установки	Включено / Выключено / Переходный процесс
🔧 Загрязнённость фильтра	Процент загрязнения (%)

Дополнительные сенсоры (деактивированы по умолчанию)

Включаются вручную при наличии соответствующих датчиков:

Сенсор	Описание
🌡️ Температура в помещении	Если установлен датчик
🌡️ Температура на улице	Наружный воздух
🌡️ Температура теплоносителя	Температура воды в системе
💧 Влажность (приток/комната/улица)	Дополнительные датчики влажности
🌫️ CO₂	Концентрация углекислого газа (ppm)
🌫️ VOC	Уровень загрязнённости воздуха (ppb)
🔌 Потребляемая мощность	Энергопотребление (Вт)
📊 Фактическая скорость	Реальная скорость вентилятора (%)
🧹 Фильтры 1-4	Состояние каждого фильтра с текстовым статусом

Статусы фильтров:

• ✅ Отличное (< 30%)
• 🟢 Хорошее (30-60%)
• 🟡 Требуется замена (60-85%)
• 🔴 Забит (> 85%)

Бинарные сенсоры

Сенсор	Описание
✅ Установка включена	Текущее состояние питания
⚠️ Предупреждение	Некритическая ошибка
🚨 Критическая ошибка	Фатальная ошибка системы
🔥 Угроза перегрева	Перегрев калорифера
🧹 Требуется замена фильтра	Фильтр загрязнён

Управление

Объект	Описание
🔌 Питание (switch)	Включение / выключение установки
🌡️ Заданная температура (number)	Установка целевой температуры (10-30°C)
💨 Скорость вентилятора (number)	Установка скорости (1-8)

Установка

Способ 1: HACS (рекомендуется)

1. В HACS → Интеграции → ⋯ → Пользовательские репозитории
2. Добавить: https://github.com/smirnowegor/Breezart-Home-Assistant-Integration
3. 📦 Установка: HACS → Интеграции → Breezart → Установить (v1.1.0+)
4. 🔄 Перезапуск: Home Assistant → Перезапустить
5. ⚙️ Настройка: Настройки → Устройства → Интеграции → Добавить интеграцию → Breezart

Способ 2: Ручная установка

1. Скачать репозиторий
2. Скопировать папку custom_components/breezart в <config>/custom_components/
3. Перезапустить Home Assistant
4. Настройки → Интеграции → + → Breezart

Настройка

При добавлении интеграции укажи:

• Хост: IP-адрес Breezart (например, 192.168.1.121)
• Порт: 1560 (стандартный, менять не нужно)
• Пароль: Пароль из настроек контроллера TPD-283U-H

Протокол

Интеграция использует нативный TCP-протокол Breezart (порт 1560):

• VPr07 — получение свойств устройства
• VSt07 — получение текущего состояния
• VSens — получение данных с сенсоров
• VWPwr — управление питанием
• VWTmp — установка температуры
• VWSpd — установка скорости вентилятора

Основан на протоколе из breezart-client.

Структура

custom_components/breezart/
├── __init__.py           # Основная логика, setup
├── config_flow.py        # UI настройки
├── coordinator.py        # TCP клиент и координатор данных
├── sensor.py             # Сенсоры (температура, скорость, режим...)
├── binary_sensor.py      # Бинарные сенсоры (ошибки, состояние)
├── number.py             # Управление (температура, скорость)
├── switch.py             # Выключатель питания
├── const.py              # Константы протокола
├── manifest.json         # Метаданные HACS
└── translations/         # Переводы (ru, en)

📝 Протокол и техническая информация

Интеграция использует нативный TCP-протокол Breezart (порт 1560):

• VPr07 — получение свойств устройства (диапазоны температуры/скорости, версия прошивки)
• VSt07 — получение текущего состояния (температура, режим, скорость, ошибки)
• VSens — получение данных с сенсоров (температуры, влажность, CO₂, VOC, фильтры)
• VWPwr — управление питанием (вкл/выкл)
• VWTmp — установка целевой температуры
• VWSpd — установка скорости вентилятора
• VWFtr — установка режима работы

Основан на протоколе из breezart-client.

🐛 Известные проблемы и решения

Сенсоры показывают "Неизвестно":

• Эти сенсоры деактивированы по умолчанию
• Включите их вручную в настройках устройства, если у вас есть соответствующие датчики
• Если после включения остаётся "Неизвестно" — датчик не подключён к контроллеру

Температура не устанавливается ползунком:

• Убедитесь, что вы используете версию 1.1.0+ с optimistic updates
• Если ползунок "прыгает назад" — это исправлено в текущей версии
• Текущая температура показывает воздух на выходе установки (INPUT[50])
• Заданная температура (ползунок) устанавливает уставку нагрева/охлаждения

Ошибка подключения:

• Проверьте IP-адрес и порт (1560)
• Убедитесь, что удалённое управление активировано на контроллере
• Проверьте правильность пароля

☕ Поддержка

Если вам помогла эта интеграция:

• 💰 Поддержать на Дзен
• 💬 Telegram канал
• 💸 Донат
• 💎 Криптокошелек (USDT TRC20): TCHekdJZFndXpDrHZGuTmqFNcqhWBTTzPr

📞 Связаться со мной

• 📺 YouTube
• 💬 Telegram канал
• 📝 Яндекс Дзен

🤝 Вклад в проект

Буду рад вашим предложениям и улучшениям! Создавайте Issues и Pull Requests.

📄 Лицензия

MIT License - см. файл LICENSE