🕸️

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

Настройка Zigbee устройств через zigbee2mqtt
Подключение Zigbee датчиков и актуаторов
Zigbee устройства подключаются к системе RealIoT через модуль zigbee2mqtt. Следуйте этой инструкции для быстрого и правильного подключения.
1 Выберите тип подключения

Для подключения конкретного устройства к системе RealIoT выберите «Тип подключения» из спадающего меню на панели "Свойства". Возможные варианты:

  • Zigbee
  • WiFi
  • LoRa
  • Matter
Для устройств Zigbee процесс подключения начинается именно с этого момента, а для WiFi, LoRa и Matter начинать надо с физического подключения этих устройств к соответствующим сетям.
2 Выберите MQTT брокер

После выбора типа подключения Zigbee нажмите кнопку «Подкл. к сети (...)». Под кнопкой появится выпадающее меню, в котором надо выбрать MQTT брокер.

В типовом случае, если у вас один RealIoT хаб, будет только один вариант: «Основной брокер (localhost)».

Если у вас несколько хабов и вы хотите получать данные не только с текущего хаба, но и с других, то в выпадающем списке будет несколько брокеров. Дополнительные брокеры подключаются на странице «Настройки – MQTT брокер».
3 Откройте интерфейс zigbee2mqtt

Щелкните по имени брокера. Откроется страница модуля zigbee2mqtt, где можно увидеть список IoT устройств, подключенных ранее.

Интерфейс zigbee2mqtt
Интерфейс zigbee2mqtt со списком устройств
На этой стадии очень полезно проверить, что данные от датчка поступают. Для этого щелкните по имени устройства и на открывшейся странице посмотрите список параметров. Параметры изменятся сразу, как только от датчика придут данные.
4 Подключите новое устройство

Для подключения нового Zigbee устройства:

  1. Нажмите кнопку «Разрешить присоединение» в интерфейсе zigbee2mqtt
  2. На самом Zigbee устройстве нажмите кнопку присоединения к сети (как описано в руководстве к устройству)
  3. Через 10-60 секунд устройство появится в списке
Обычно кнопка присоединения находится на корпусе устройства. Некоторые устройства требуют удержания кнопки в течение 5-10 секунд.
Если вы сменили хаб или координатор на хабе, то датчик, возможно, придется подключить заново.
5 Настройте устройство

Щелкните по имени устройства, чтобы увидеть страницу с настройками выбранного устройства:

Настройки Zigbee устройства
Страница настроек Zigbee устройства

Здесь можно заменить физический IEEE-адрес устройства (зашитый в само устройство) вида 0x00158d000705342a на понятное имя, например g01_fl3_dining_room.

Теперь можно закрыть страницу zigbee2mqtt, предварительно скопировав понятное имя (например, g01_fl3_dining_room) в буфер обмена.
Рекомендуется использовать осмысленные имена с префиксами, например:
  • sensor_kitchen_temperature - датчик температуры на кухне
  • light_bedroom_main - основной свет в спальне
  • relay_garage_door - реле гаражных ворот
6 Сохраните адрес устройства

Вставьте скопированное имя в поле «SN или DevEUI:» на ранее открытой вкладке «Свойства». Нажмите кнопку «Сохранить».

После сохранения система начнет получать данные от устройства. Если устройство активно передает данные, они появятся в течение нескольких секунд.

Выбор параметров датчика

Теперь можно закрыть страницу zigbee2mqtt, предварительно скопировав понятное имя (например, g01_fl3_dining_room) в клипборд. Его надо вставить в поле «SN или DevEUI:» на ранее открытой вкладке «Свойства». Теперь сохраните введенный адрес кнопкой «Сохранить».

Далее нужно выбрать, какие именно данные вам нужно получать от подключенного IoT устройства. Нажмите «Выбрать параметры», чтобы открыть вкладку «Выбор параметров датчика»:

Выбор параметров датчика
Окно выбора параметров Zigbee датчика
Заранее мы не знаем, какие параметры предоставляет конкретный датчик. Для их получения есть несколько способов.
1 Прослушивание датчика

Нажмите кнопку «Начать прослушивание», затем коротко нажмите кнопку на zigbee устройстве. При этом устройство отправит сообщение со своими данными.

Это сообщение будет получено в JSON формате и представлено на вкладке в виде списка параметров.

Выбирать нужно только нужные вам параметры, т.к. от их количества зависит нагрузка на процессор IoT хаба.

Исторические данные:

  • Отметьте параметры, историю которых нужно хранить в базе данных
  • Укажите продолжительность хранения
  • Исторические данные потребуются для построения графиков
Кнопка «Показать график» появится на вкладке «Свойства» только при условии, что вы хотя бы один параметр отметили как исторический.
2 Запросить данные из координатора

Если датчик находится далеко от вас и кнопку на корпусе нажимать неудобно, то его параметры можно запросить у zigbee координатора.

Для этого нужно нажать кнопку «Запросить данные из координатора».

Этот вариант хуже, потому что координатор может прислать сокращенный набор параметров.
3 Вписать параметры вручную

Этот вариант можно использовать, если вы точно знаете название параметра.

Названия параметров можно найти в документации производителя устройства или на сайте zigbee2mqtt в разделе поддерживаемых устройств.
4 Параметры из базы данных

При первоначальной загрузке вкладки «Выбор параметров датчика» список параметров берется из базы данных. В базе он появляется после первоначального подключения устройства такого же типа.

Перед тем как нажать кнопку «Выбрать параметры» очень важно вписать «Модель устройства» в форму «Свойства». Это поле нужно для извлечения из базы данных параметров устройства такого же типа.

✅ Подключение Zigbee устройств настроено!

Теперь ваши Zigbee датчики и актуаторы подключены к системе RealIoT
и готовы к использованию в сценариях автоматизации.

← Назад к справке