Перейти к содержанию

Zigbee2mqtt-connection

Материал из XIOT Wiki


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 ```

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

mqtt:

 base_topic: zigbee2mqtt
 server: 'mqtt://localhost:1887'

serial:

 port: /dev/ttyMOD2

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" ```