Узловое устройство XiaoBao
Мощный аддон для создания распределённой системы умного дома. Расширьте возможности HomeAssistant с помощью множественных узлов и централизованного управления.
Обзор возможнотей
Распределённая архитектура
Создавайте множественные узлы в разных сетях и управляйте ими централизованно через главный экземпляр HomeAssistant.
Синхронизация данных
Автоматическая синхронизация состояний устройств и сенсоров между всеми узлами системы.
Высокая производительность
Распределение нагрузки между узлами для повышения отзывчивости и надёжности системы.
Отказоустойчивость
Продолжайте работать даже при потере связи с некоторыми узлами благодаря автономной работе.
Ключевые особенности
-
🔗
MQTT коммуникация
Использует протокол MQTT для надёжной и быстрой передачи данных между узлами системы.
-
📡
Автообнаружение
Автоматическое обнаружение новых узлов в сети и их интеграция в систему без ручной настройки.
-
🔐
Безопасность
Шифрование данных передаваемых между узлами и аутентификация для предотвращения несанкционированного доступа.
-
⚙️
Гибкая настройка
Детальная конфигурация каждого узла включая настройки синхронизации и фильтрации устройств.
-
📊
Мониторинг состояния
Отображение статуса всех узлов и качества соединения в реальном времени.
-
🔄
Обновление по воздуху
Удалённое обновление прошивки и программного обеспечения на всех узлах системы.
Руководство по установке
Установка через HACS
Откройте HACS в HomeAssistant перейдите в раздел "Аддоны" и найдите "XiaoBao Node". Нажмите "Загрузить" и следуйте инструкциям на экране.
Конфигурация MQTT брокера
Убедитесь что у вас настроен MQTT брокер. Узловое устройство использует MQTT для коммуникации. Рекомендуется использовать встроенный MQTT брокер или Mosquitto addon.
💡 Совет
Для лучшей производительности используйте локальный MQTT брокер вместо облачных решений.
Добавление первого узла
После установки откройте конфигурацию аддона и добавьте параметры первого узла:
node_id: уникальный идентификатор узла
node_name: отображаемое имя узла
mqtt_topic: топик для коммуникации
sync_interval: интервал синхронизации (секунды)
Запуск и проверка
Запустите аддон и проверьте логи на наличие ошибок. В интерфейсе HomeAssistant должен появиться новый раздел с информацией о узлах.
Пример конфигурации
configuration.yaml
# Конфигурация узлового устройства
xiaobao_node:
# Основные настройки
mqtt:
broker: homeassistant.local
port: 1883
username: !secret mqtt_username
password: !secret mqtt_password
# Настройки узла
nodes:
- id: "node_1"
name: "Гостиная"
location: "living_room"
sync_entities:
- light.living_room_main
- sensor.living_room_temperature
- switch.living_room_fan
- id: "node_2"
name: "Спальня"
location: "bedroom"
sync_entities:
- light.bedroom_main
- sensor.bedroom_temperature
- cover.bedroom_curtains
# Синхронизация
sync_interval: 5
auto_discovery: true
encryption: true
Сценарии использования
Многокомнатный дом
Разместите узлы в разных комнатах для локальной обработки устройств и снижения нагрузки на основную систему.
Офисные здания
Создайте отдельные узлы для каждого этажа или отдела с централизованным управлением.
Загородные участки
Интегрируйте устройства в основном доме и на даче в единую систему умного дома.
Производственные помещения
Мониторьте и управляйте оборудованием в разных цехах с единой точки контроля.
Решение проблем
⚠️ Важное примечание
Убедитесь что все узлы находятся в одной сети или настроена маршрутизация между сетями. Проверьте настройки брандмауэра и MQTT брокера перед обращением в поддержку.
Узел не подключается
Возможные причины:
• Неверные настройки MQTT
• Проблемы с сетью
• Брандмауэр блокирует соединение
Решение: Проверьте логи аддона и убедитесь что MQTT брокер доступен с узла.
Синхронизация не работает
Возможные причины:
• Неверно указаны entity_id
• Нет прав доступа к устройствам
• Превышен интервал синхронизации
Решение: Проверьте конфигурацию и убедитесь что устройства существуют в HomeAssistant.
Высокая нагрузка на сеть
Возможные причины:
• Слишком короткий интервал синхронизации
• Большое количество устройств
• Частые изменения состояний
Решение: Увеличьте интервал синхронизации или уменьшите количество синхронизируемых устройств.
Часто задаваемые вопросы
Вопросы и ответы
Могу ли я использовать устройства разных производителей на одном узле?
Да узловое устройство поддерживает любые интеграции HomeAssistant включая Xiaomi Tuya Zigbee и другие протоколы.
Сколько узлов можно добавить в систему?
Количество узлов ограничено только ресурсами вашей системы и возможностями MQTT брокера. Пользователи успешно используют 10+ узлов.
Что произойдёт при потере соединения с главным узлом?
Узлы продолжат работать автономно. Локальные устройства будут функционировать а изменения состояний будут сохранены и синхронизированы при восстановлении связи.
Поддерживается ли шифрование данных?
Да поддерживается TLS/SSL шифрование для MQTT коммуникации. Рекомендуется использовать MQTT брокер с поддержкой шифрования для повышения безопасности.
Полезные ссылки
Документация
Полная документация по настройке и использованию узлового устройства.
Форум сообщества
Задайте вопросы и получите помощь от сообщества пользователей HomeAssistant.
Отслеживание проблем
Сообщайте о багах и предлагайте улучшения на GitHub.