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

Zigbee2mqtt-connection: различия между версиями

Материал из XIOT Wiki
Нет описания правки
Нет описания правки
Строка 2: Строка 2:


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


== 1. Установка Zigbee2MQTT ==
== 1. Установка Zigbee2MQTT ==
🛠 Для установки выполните команды в консоли контроллера (SSH):
🛠 Для установки выполните команды в консоли контроллера (SSH):
 
apt update && apt install zigbee2mqtt
 
apt update && apt install zigbee2mqtt
 
`


После установки сервис Zigbee2MQTT появится в системе и будет запускаться автоматически.
После установки сервис Zigbee2MQTT появится в системе и будет запускаться автоматически.
Строка 16: Строка 13:
== 2. Конфигурация Zigbee2MQTT ==
== 2. Конфигурация Zigbee2MQTT ==
📂 Файлы конфигурации расположены в каталоге:
📂 Файлы конфигурации расположены в каталоге:
```
 
/mnt/data/root/zigbee2mqtt/data/
/mnt/data/root/zigbee2mqtt/data/
```


Откройте основной конфигурационный файл:
Откройте основной конфигурационный файл:
```
nano /mnt/data/root/zigbee2mqtt/data/configuration.yaml
nano /mnt/data/root/zigbee2mqtt/data/configuration.yaml
```


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


mqtt:
Важно указать порт '''1887''', чтобы zigbee2mqtt подключался напрямую в XIOT.
 
Указать порт в который подключена плата zigbee, например '''/dev/ttyMOD2'''
homeassistant: false
permit_join: false
mqtt:
   base_topic: zigbee2mqtt
   base_topic: zigbee2mqtt
   server: 'mqtt://localhost:1887'
   server: 'mqtt://localhost:1887'
 
serial:
serial:
   port: /dev/ttyMOD2
   port: /dev/ttyMOD2
 
frontend:
advanced:
  enabled: true
  port: 8081
  host: 0.0.0.0
advanced:
   rtscts: false
   rtscts: false
   last_seen: epoch
   last_seen: epoch
   pan_id: GENERATE
   pan_id: GENERATE
   network_key: GENERATE
   network_key: GENERATE
```


После редактирования нажмите:
После редактирования нажмите:
Ctrl+S — сохранить   
Ctrl+S — сохранить   
Ctrl+X — выйти
Ctrl+X — выйти


== 3. Перезапуск Zigbee2MQTT ==
== 3. Перезапуск Zigbee2MQTT ==
⚙ После изменения конфигурации выполните:
⚙ После изменения конфигурации выполните:
```
systemctl restart zigbee2mqtt
systemctl restart zigbee2mqtt
```
 
Проверить статус:
Проверить статус:
```
systemctl status zigbee2mqtt
systemctl status zigbee2mqtt
```


== 4. Включение режима добавления (Permit Join) ==
== 4. Включение режима добавления (Permit Join) ==
Добавление Zigbee-устройств возможно только при включённом режиме permit_join.
Добавление Zigbee-устройств возможно только при включённом режиме permit_join.


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


== 5. Подключение устройств ==
== 5. Подключение устройств ==
📡 1. Активируйте поиск устройств.   
1. Активируйте поиск устройств.   
 
2. Переведите устройство в режим сопряжения.   
2. Переведите устройство в режим сопряжения.   
3. Устройство появится в списке со своим уникальным адресом (например,  
 
```
3. Устройство появится в списке со своим уникальным адресом (например, 0x00158d000e761d64).   
0x00158d000e761d64
 
```
).   
4. XIOT автоматически определит тип устройства.
4. XIOT автоматически определит тип устройства.


🔍 Просмотр логов:
🔍 Просмотр логов:
```
journalctl -u zigbee2mqtt -f
journalctl -u zigbee2mqtt -f
```


== 6. Работа устройств в XIOT ==
== 6. Работа устройств в XIOT ==
После успешного подключения Zigbee-устройства отображаются в разделе:
После успешного подключения Zigbee-устройства отображаются в разделе:
Драйверы → Zigbee2MQTT
Драйверы → Zigbee2MQTT


Для каждого устройства отображаются:
Для каждого устройства отображаются:
– имя, модель;   
– имя, модель;   
– текущие показания;   
– текущие показания;   
– уровень сигнала;   
– уровень сигнала;   
– заряд батареи;   
– заряд батареи;   
– элементы управления, если доступны.
– элементы управления, если доступны.


== 7. Полезные команды ==
== 7. Полезные команды ==
Просмотр логов сервиса:
Просмотр логов:
```
journalctl -u zigbee2mqtt -f
journalctl -u zigbee2mqtt -f
```


Поиск ошибок:
Поиск ошибок:
```
journalctl -u zigbee2mqtt --since "5 minutes ago"
journalctl -u zigbee2mqtt --since "5 minutes ago"
```

Версия от 18:58, 3 декабря 2025


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"