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

📋 Обзор

Zigbee2MQTT - это аддон для Home Assistant, который позволяет использовать Zigbee устройства без проприетарных шлюзов. Аддон преобразует Zigbee сообщения в MQTT, что обеспечивает интеграцию с любой системой поддерживающей MQTT.

⚙️ Системные требования

Перед установкой Zigbee2MQTT убедитесь, что ваша система соответствует следующим требованиям:

🚀 Установка Zigbee2MQTT

Шаг 1: Установка MQTT Брокера

Если у вас ещё не установлен MQTT брокер, установите его сначала:

1. Откройте Home Assistant
2. Перейдите в Настройки → Аддоны → Магазин аддонов
3. Найдите "Mosquitto broker"
4. Нажмите "Установить"
5. После установки нажмите "Запустить"
6. Нажмите "Открыть веб-интерфейс" для настройки

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

Теперь установим сам Zigbee2MQTT аддон:

1. Перейдите в Настройки → Аддоны → Магазин аддонов
2. Нажмите на меню (три точки) в правом верхнем углу
3. Выберите "Репозитории"
4. Добавьте репозиторий: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
5. Подождите обновления списка аддонов
6. Найдите "Zigbee2MQTT" в списке
7. Нажмите "Установить"

Шаг 3: Настройка USB устройства

Для работы Zigbee координатора необходимо настроить доступ к USB устройству:

1. Подключите Zigbee координатор к USB порту
2. Перейдите в Настройки → Система → Обслуживание
3. Запустите терминал
4. Введите команду: ls /dev/ttyUSB* /dev/ttyACM*
5. Запомните имя устройства (например, /dev/ttyUSB0)

Шаг 4: Конфигурация Zigbee2MQTT

Откройте настройки аддона Zigbee2MQTT:

• Перейдите в раздел "Конфигурация"
• Настройте основные параметры:

data_path: /config/zigbee2mqtt
devices: devices.yaml
groups: groups.yaml
homeassistant: true
permit_join: true
mqtt:
  base_topic: zigbee2mqtt
  server: 'mqtt://core-mosquitto:1883'
serial:
  port: /dev/ttyUSB0
frontend:
  port: 8080

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

1. Нажмите "Сохранить" в конфигурации
2. Перейдите на вкладку "Информация"
3. Нажмите "Запустить"
4. Подождите несколько секунд
5. Проверьте логи на наличие ошибок

📱 Добавление устройств

Режим подключения

Чтобы добавить новое Zigbee устройство:

1. Откройте веб-интерфейс Zigbee2MQTT (порт 8080)
2. Включите режим подключения (Permit Join)
3. Приведите устройство в режим сопряжения (обычно длинное нажатие кнопки)
4. Дождитесь появления устройства в списке
5. Отключите режим подключения после добавления

Интеграция с Home Assistant

После добавления устройства:

1. Устройство автоматически появится в Home Assistant
2. Перейдите в Настройки → Устройства и службы
3. Найдите новое Zigbee устройство
4. Настройте сущности (entities) по необходимости
5. Добавьте на дашборд

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

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

• Убедитесь, что устройство находится в режиме сопряжения
• Проверьте, что батарея заряжена
• Попробуйте приблизить устройство к координатору
• Проверьте логи Zigbee2MQTT на наличие ошибок

USB устройство не обнаруживается

• Проверьте подключение USB координатора
• Попробуйте другой USB порт
• Проверьте настройки прав доступа в конфигурации HA
• Убедитесь, что другое приложение не использует устройство

Устройства часто теряют связь

• Проверьте расстояние между устройствами и координатором
• Рассмотрите возможность добавления Zigbee маршрутизаторов
• Проверьте наличие Wi-Fi помех (Zigbee работает на 2.4 ГГц)
• Обновите прошивку координатора

Аддон не запускается

• Проверьте логи аддона на наличие ошибок
• Убедитесь, что MQTT брокер запущен
• Проверьте конфигурацию на наличие синтаксических ошибок
• Попробуйте переустановить аддон

💡 Рекомендации

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

Можно ли использовать несколько координаторов?

Да, но рекомендуется использовать один координатор для всей сети. Несколько координаторов могут работать на разных каналах.

Как сбросить Zigbee устройство?

Обычно это делается длительным нажатием кнопки питания или сброса в течение 10-20 секунд. Конкретная процедура зависит от производителя.

Можно ли использовать Zigbee и Z-Wave одновременно?

Да, Zigbee и Z-Wave работают на разных частотах и не мешают друг другу. Вы можете использовать оба протокола в Home Assistant.

Как изменить канал Zigbee?

Канал можно изменить в конфигурации Zigbee2MQTT в параметре serial: → channel:. Рекомендуется использовать каналы 11, 15, 20, 25.

📚 Дополнительные ресурсы

Для более подробной информации обратитесь к следующим ресурсам:

• Официальная документация Zigbee2MQTT
• Репозиторий Zigbee2MQTT Add-on
• Сообщество Home Assistant
• Zigbee Alliance