Подключение Zigbee2mqtt

Zigbee2MQTT позволяет подключать широкий спектр Zigbee-устройств (датчики, кнопки, реле, термостаты) напрямую к контроллеру Wiren Board через MQTT.

Ниже приведена полная инструкция по установке, настройке и подключению Zigbee2MQTT.

1. Установка Zigbee2MQTT

🛠 Для установки выполните команды в консоли контроллера (SSH):

apt update && apt install zigbee2mqtt

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

2. Конфигурация Zigbee2MQTT

📂 Файлы конфигурации расположены в каталоге:

/mnt/data/root/zigbee2mqtt/data/

Откройте основной конфигурационный файл:

nano /mnt/data/root/zigbee2mqtt/data/configuration.yaml

Приведите его к следующему виду:

Важно указать порт 1887, чтобы zigbee2mqtt подключался напрямую в XIOT.

Указать порт в который подключена плата zigbee, например /dev/ttyMOD2

homeassistant: false
permit_join: false
mqtt:
 base_topic: zigbee2mqtt
 server: 'mqtt://localhost:1887'
serial:
 port: /dev/ttyMOD2
frontend:
  enabled: true
  port: 8081
  host: 0.0.0.0
advanced:
 rtscts: false
 last_seen: epoch
 pan_id: GENERATE
 network_key: GENERATE

После редактирования нажмите:

Ctrl+S — сохранить

Ctrl+X — выйти

3. Перезапуск Zigbee2MQTT

⚙ После изменения конфигурации выполните:

systemctl restart zigbee2mqtt

Проверить статус:

systemctl status zigbee2mqtt

4. Включение режима добавления (Permit Join)

Добавление Zigbee-устройств возможно только при включённом режиме permit_join.

В интерфейсе XIOT — кнопка «Включить поиск».

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

1. Активируйте поиск устройств.

2. Переведите устройство в режим сопряжения.

3. Устройство появится в списке со своим уникальным адресом (например, 0x00158d000e761d64).

4. XIOT автоматически определит тип устройства.

🔍 Просмотр логов:

journalctl -u zigbee2mqtt -f

6. Работа устройств в XIOT

После успешного подключения Zigbee-устройства отображаются в разделе:

Драйверы → Zigbee2MQTT

Для каждого устройства отображаются:

– имя, модель;

– текущие показания;

– уровень сигнала;

– заряд батареи;

– элементы управления, если доступны.

7. Полезные команды

Просмотр логов:

journalctl -u zigbee2mqtt -f

Поиск ошибок:

journalctl -u zigbee2mqtt --since "5 minutes ago"