📦 Аддоны

Инструкция по клонам Zigbee

Подробное руководство по использованию функции клонов Zigbee в HomeAssistant. Множественные координаторы, оптимизация сети и настройка Zigbee множителя для расширения возможностей вашего умного дома.

Что такое клоны Zigbee?

Клоны Zigbee (Zigbee Clone) — это функция в Home Assistant, которая позволяет создавать несколько виртуальных координаторов Zigbee на основе одного физического устройства. Это позволяет:

  • Увеличить количество устройств Zigbee в сети
  • Оптимизировать распределение устройств по разным каналам
  • Улучшить стабильность сети при большом количестве устройств
  • Создать отдельные сегменты сети для разных групп устройств
💡 Важно понимать:

Клоны Zigbee используют один физический координатор, но создают несколько логических сетей. Каждая сеть работает на своём канале и имеет свой позволяющих оптимизировать работу большого количества устройств.

Предварительные требования

Перед началом использования клонов Zigbee убедитесь, что:

  • 1Установлен базовый аддон Zigbee — базовый аддон должен быть установлен и настроен
  • 2Совместимый координатор — используйте USB-координатор с поддержкой режима множественных сетей
  • 3Достаточно памяти — на системе должно быть минимум 2GB свободной оперативной памяти
  • 4Home Assistant обновлён — рекомендуется версия Home Assistant 2023.12 или выше

Установка Zigbee множителя

Шаг 1: Добавление репозитория

Откройте Home Assistant и перейдите в раздел настроек аддонов:

  1. Настройки → Аддоны → Магазин аддонов
  2. Нажмите на меню (три точки) в правом верхнем углу
  3. Выберите "Репозитории"
  4. Добавьте репозиторий Home Assistant
https://github.com/wghaos/wghaos-addons

Шаг 2: Установка аддона

  1. В магазине аддонов найдите "Zigbee Clone" или "Zigbee множитель"
  2. Нажмите "Установить"
  3. Дождитесь завершения установки
⚠️ Внимание:

Не запускайте аддон до завершения полной настройки! Сначала выполните все шаги конфигурации.

Настройка клонов

Шаг 1: Конфигурация основного координатора

В конфигурации аддона укажите параметры основного координатора:

data_path: /share/zigbee_clone
adapter: conbee
device: /dev/ttyACM0
baudrate: 115200
flowcontrol: true

# Клоны
clones:
- name: clone1
channel: 11
pan_id: 0x1234
- name: clone2
channel: 15
pan_id: 0x5678
- name: clone3
channel: 20
pan_id: 0x9ABC

Шаг 2: Настройка параметров клонов

Для каждого клона настройте следующие параметры:

  • name — уникальное имя клона (например: clone1, clone2)
  • channel — канал Zigbee (11, 15, 20, 25)
  • pan_id — уникальный идентификатор сети (16-битное шестнадцатеричное число)
  • ext_pan_id — расширенный ID сети (опционально)
💡 Совет по выбору каналов:

Используйте каналы, которые не пересекаются с Wi-Fi сетями. Рекомендуется: 11, 15, 20, 25. Каналы 11-15 чаще всего свободны от помех Wi-Fi.

Запуск и проверка

Шаг 1: Запуск аддона

  1. Нажмите кнопку "Запустить" в веб-интерфейсе аддона
  2. Откройте логи аддона для проверки успешного запуска
  3. Убедитесь, что все клоны успешно инициализированы

Шаг 2: Проверка статуса

В логах вы должны увидеть сообщения подобного вида:

[Info] Starting Zigbee Clone addon...
[Info] Main coordinator initialized on /dev/ttyACM0
[Info] Clone 'clone1' started on channel 11 (PAN ID: 0x1234)
[Info] Clone 'clone2' started on channel 15 (PAN ID: 0x5678)
[Info] Clone 'clone3' started on channel 20 (PAN ID: 0x9ABC)
[Info] All clones initialized successfully
[Info] Zigbee Clone is ready for pairing!
✓ Успешный запуск:

Если вы видите сообщение "All clones initialized successfully", значит все клоны успешно запущены и готовы к работе!

Подключение устройств

Выбор клона для подключения

При добавлении нового устройства вы можете выбрать, к какому клону оно будет подключено:

  • Откройте веб-интерфейс выбранного клона
  • Нажмите "Разрешить связывание" (Permit Join)
  • Активируйте режим сопряжения на устройстве
  • Устройство автоматически подключится к выбранному клону

Распределение устройств по клонам

Рекомендации по оптимальному распределению:

  • Клон 1 (Канал 11) — датчики, кнопки, выключатели
  • Клон 2 (Канал 15) — освещение, умные розетки
  • Клон 3 (Канал 20) — климатическое оборудование
⚠️ Важное предупреждение:

Устройства, подключённые к разным клонам, НЕ будут видеть друг друга напрямую. Они смогут взаимодействовать только через Home Assistant. Учитывайте это при создании автоматизаций.

Расширенная конфигурация

Настройка автоматического переключения

Для автоматического переключения устройств между клонами:

# В configuration.yaml
automation:
- alias: 'Optimize Zigbee Network'
trigger:
- platform: time
at: '02:00:00'
action:
- service: zigbee_clone.rebalance
data:
max_devices_per_clone: 40

Мониторинг производительности

Добавьте следующие сенсоры для мониторинга:

  • sensor.zigbee_clone1_status — статус первого клона
  • sensor.zigbee_clone1_devices — количество устройств в клоне 1
  • sensor.zigbee_clone1_rssi — среднее качество сигнала

Устранение неполадок

Проблема: Клон не запускается

Возможные причины:

  • Занят выбранный канал другим устройством
  • Некорректный PAN ID (конфликт с существующей сетью)
  • Недостаточно памяти системы

Решение: Измените канал и PAN ID для проблемного клона

Проблема: Устройства не подключаются

Проверьте:

  • Режим связывания активирован (Permit Join)
  • Устройство находится в зоне действия координатора
  • Устройство не было ранее подключено к другому клону

Проблема: Высокая задержка команд

Решение:

  • Перераспределите устройства между клонами
  • Проверьте загрузку системы
  • Уменьшите количество устройств в одном клоне (рекомендуется до 40)

Часто задаваемые вопросы

Сколько клонов можно создать?

Технически ограничений нет, но рекомендуется создавать не более 3-5 клонов для оптимальной производительности.

Можно ли перемещать устройства между клонами?

Да, но устройство нужно сначала удалить из текущего клона, затем сбросить его и подключить заново к новому клону.

Влияют ли клоны друг на друга?

Клоны работают на разных каналах и не влияют друг на друга напрямую. Однако все они используют один физический координатор.

Что происходит при перезагрузке системы?

Все клоны автоматически перезапускаются при перезагрузке Home Assistant. Устройства остаются подключёнными к своим клонам.

Лучшие практики

  • Планируйте структуру сети — перед началом определите, какие устройства будут в каком клоне
  • Документируйте назначения — ведите запись какой канал использует какой клон
  • Мониторьте нагрузку — регулярно проверяйте нагрузку на каждый клон
  • Тестируйте перед масштабированием — начните с 2 клонов и постепенно увеличивайте количество
  • Резервное копирование — регулярно делайте резервные копии конфигурации
  • Используйте разные каналы — минимизируйте interference между клонами