Zigbee2mqtt-connection: различия между версиями
Admin (обсуждение | вклад) Нет описания правки |
Admin (обсуждение | вклад) Нет описания правки |
||
| Строка 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 | |||
Приведите его к следующему виду: | Приведите его к следующему виду: | ||
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 — кнопка «Включить поиск». | |||
== 5. Подключение устройств == | == 5. Подключение устройств == | ||
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"