Главная страница › Home Assistant › Интеграции в Home Assistant › Настройка Zigbee2MQTT Home Assistant

Настройка Zigbee2MQTT Home Assistant

Zigbee2MQTT – это дополнение, которое позволяет убрать сторонние Zigbee хабы. И подключать устройства через одни мост. Преимуществом является быстрая настройка и управление устройствами из одного места.

Если вы используете Docker, то воспользуйтесь другим руководством — Docker Zigbee2MQTT.

Поиск и определение адаптера

После подключения необходимо узнать, на каком порту появилось устройство. Для этого перейдем в терминал и выполним команду, узнать как установить терминал в Home Assistant:

ls -l /dev/serial/by-id

У нас появляется весь список подключенных к нашему серверу устройств. Так как все операции проходят на тестовом стенде то и устройство только одно: Sonoff Zigbee Dongle-E Plus

usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20220715153021-if00 -> ../../ttyACM0

Если у вы не обнаружили адаптер, то необходимо будет скачать драйвера для вашей операционной системы. Как правило производитель выкладывает их на своем официальном сайте. В основном проблема встречается на Windows и Mac OS. У Linux и Unix систем поддержка устройств идет «из коробки».

Установка Mosquitto Broker Home Assistant

Далее нам необходим сам MQTT брокер. Который будет принимать и отсылать информацию между устройствами сети.

Переходим в «Настройки»
Далее «Дополнения»
В левом нижнем углу будет кнопка «Магазин дополнений», нажимаем на нее
В поиске вбиваем «Mosquitto broker»
Заходим в карточку и нажимаем «Установить»
После установки запускаем аддон и ставил галочку Watchdog

Необходимо будет установить логин и пароль для MQTT брокера. В конфигурации дополнения

- username: myuser
  password: mypassword

Далее заходим в список наших интеграций и Home Assistant сам предложить нам донастроить MQTT. Просто нажимаем настроить и все. Вводить ничего никуда не нужно.

Настройка MQTT в интеграциях Home Assistant

Установка Zigbee2MQTT Home Assistant

Zigbee2MQTT не входит в перечень стандартных дополнений, для его установки потребуется подключение из стороннего хранилища.

Повторяем первые 3 пункта из установки Mosquitto Broker
На странице магазина дополнений нажимаем на три точки в левом верхнем углу и переходим в «Репозитории»
Вставляем ссылку https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
Нажимаем «добавить»
Перезагружаем HA

После этого возвращаемся в магазин и у нас появляется 3 новых дополнения.

Zigbee2MQTT — актуальная, стабильная версия.
Zigbee2MQTT Edge — бета версия, в которой есть новый функционал. Но она не гарантирует стабильную работу системы.
Zigbee2MQTT Proxy — служит как прокси для внешнего Zigbee2MQTT. Единственный смысл — это добавление на боковую панель Home Assistant уже настроенного экземпляра.

Нас интересует первый, устанавливаем его, не забыв проставить галочку Watchdog.

После чего переходим в конфигурацию Zigbee2MQTT.

mqtt:

base_topic: zigbee2mqtt
server: mqtt://core-mosquitto:1883
user: myuser
password: mypassword

serial

adapter: ezsp
port: >-
  /dev/serial/by-id/...

Вместо трех точек в графе порт вписываем свой стик, который искали в самом первом пункте. Если у вас такой же стик zigbee 3.0 usb dongle, то дополнительно указываем адаптер.

Должно получиться так

На этом все, теперь переходим в меню Zigbee2MQTT и добавляем необходимые устройства.

Комментарии

Гоша

07.04.2023 18:08

Спасибо за подробную инструкцию. В ZHA не определялся адаптер. Пришлось настраивать Zigbee2MQTT. Прочитал несколько статей и только эта помогла

Ответить

Александр

23.04.2023 21:19

[23:17:53] INFO: Preparing to start...
[23:17:53] INFO: Socat not enabled
[23:17:54] INFO: Starting Zigbee2MQTT...
Zigbee2MQTT:info  2023-04-23 23:17:56: Logging to console and directory: '/config/zigbee2mqtt/log/2023-04-23.23-17-56' filename: log.txt
Zigbee2MQTT:info  2023-04-23 23:17:56: Starting Zigbee2MQTT version 1.30.3 (commit #unknown)
Zigbee2MQTT:info  2023-04-23 23:17:56: Starting zigbee-herdsman (0.14.103)
Error: Reset error: Error: {"sequence":-1} after 10000ms
    at /app/node_modules/zigbee-herdsman/src/adapter/ezsp/driver/uart.ts:298:23
    at Queue.executeNext (/app/node_modules/zigbee-herdsman/src/utils/queue.ts:32:32)

Ответить (1)

Alexander Pushkarev

24.04.2023 12:32

Вашу проблему решили, ответ ниже

Ответить

Alrxandr

25.04.2023 11:02
Здравствуйте! Такая же проблема при запуске:
```
[10:57:00] INFO: Preparing to start...
[10:57:00] INFO: Socat not enabled
[10:57:01] INFO: Starting Zigbee2MQTT...
Zigbee2MQTT:info  2023-04-25 10:57:04: Logging to console and directory: '/config/zigbee2mqtt/log/2023-04-25.10-57-04' filename: log.txt
Zigbee2MQTT:info  2023-04-25 10:57:04: Starting Zigbee2MQTT version 1.30.3 (commit #unknown)
Zigbee2MQTT:info  2023-04-25 10:57:04: Starting zigbee-herdsman (0.14.103)
Error: Reset error: Error: {"sequence":-1} after 10000ms
    at /app/node_modules/zigbee-herdsman/src/adapter/ezsp/driver/uart.ts:298:23
    at Queue.executeNext (/app/node_modules/zigbee-herdsman/src/utils/queue.ts:32:32)
```
```
serial:
   adapter: ezsp
   port: >-
     /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20221130094747-if00
```
Пробовал удалять Zigbee2MQTT и его папку, переустанавливал с перезагрузкой до и после, ничего не помогает.
Подскажите какие варианты еще можно попробовать?
Ответить (1)
- Alexander Pushkarev
  
  25.04.2023 11:19
  
  С serial все как надо.
  Надо разобраться с самом Mosquitto. А именно как он у вас запущен и запущен он вообще или нет.
  
  Проверьте статус интегарции Mosquitto
  
  Посмотрите логи Mosquitto. В них должна быть строка 2023-04-25 11:59:35: New connection from 172.30.32.2:47762 on port 1883. (IP разумеется другой)
  
  Конфигурация Mosquitto broker
  Logins
  
  - username: user password: 36v9Xv
  
  Customize
  
  active: false folder: mosquitto
  
  Попробуйте заменить весь конфиг /config/zigbee2mqtt/configuration.yaml
  
  homeassistant: true mqtt: server: mqtt://core-mosquitto:1883 user: user password: 36v9Xv serial: port: >- /dev/serial/by-id/usb-ITEAD_SONOFF_Zigbee_3.0_USB_Dongle_Plus_V2_20221130094747-if00 adapter: ezsp frontend: port: 8099 advanced: homeassistant_legacy_entity_attributes: false legacy_api: false legacy_availability_payload: false log_level: debug device_options: legacy: false
  
  Ответить (3)
  - Alrxandr
    
    25.04.2023 13:35
    
    Можете показать свой файл state.json?
    Как понимаю проблема в том, что через конфигурацию в веб интерфейсе ничего не попадает в /config/zigbee2mqtt/configuration.yaml и state.json, там были пустые файлы.
    
    Ответить
  - Alexander Pushkarev
    
    25.04.2023 14:05
    
    Отключите интеграцию и сами заполните /config/zigbee2mqtt/configuration.yaml. В state.json список устройств которые были добавлены.
    
    Часть state.json:
    
    { "0xa4c138d1a18ba3c0": { "state_l5": "ON", "state_l1": "ON", "state_l3": "ON", "state_l2": "OFF", "state_l4": "ON", "linkquality": 204 }, ... }
    
    Ответить
  - Михаил
    
    06.07.2023 12:52
    
    Мне помогло полное удаление ZHA.
    
    Ответить
Alrxandr

25.04.2023 14:36

Большое спасибо за помощь! Получилось запустить добавив файл /config/zigbee2mqtt/configuration.yaml вручную и файл state.json с содержанием: {}

Подскажите как отключить интеграцию?

Ответить (1)
- Alexander Pushkarev
  
  25.04.2023 17:22
  
  Там же где и включается:
  Настройки -> Дополнения -> Zigbee2MQTT -> Остановить (красная кнопка)
  
  Ответить (1)
  - Mikhail
    
    17.10.2023 15:30
    
    Огромное спасибо, больше дня провозился! Но только благодаря этой статье и комментариям удалось побороть Error: {"sequence":-1} after 10000ms
    
    Ответить
Игорь

29.04.2023 15:33

Здравствуйте, долго мучаясь c настройкой аддонов Mosquito MQTT и Zigbee2MQTT так как при входе в веб интерфейс выдавал ошибку 502, в итоге получилось, но почему то перестали быть активны в интеграциях подключенные устройства к SONOFF Zigbee 3.0 USB Dongle Plus V2, с чем это может быть связано?

Ответить (1)
- Alexander Pushkarev
  
  30.04.2023 13:12
  
  А что в журнале ошибок написано?
  
  Ответить
Евгений

13.05.2023 09:09

Здравствуйте! Подскажите, пожалуйста, а в настройке для USB ZigBee модуль Sonoff CC2531 есть отличия, кроме строки port: ? Сделал всё по инструкции, но Zigbee2MQTT не запускается.((

Ответить (1)
- Alexander Pushkarev
  
  13.05.2023 09:45
  
  Здравствуйте, на Sonoff CC2531 не надо указывать adapter: ezsp. При такой настройке работать не будет
  
  Ответить
Ескендир Нуржан

22.08.2023 13:23

А как потом добавить иконку протечки воды в главный экран HomeAssist?

Ответить (1)
- Alexander Pushkarev
  
  07.10.2023 19:19
  
  Обзор
  
  Нажимаете на три точки (в правом углу) и выбираете «Изменить панель»
  
  Далее «Добавить карточку», синяя кнопка внизу
  
  В качестве иконки, можно использовать протечки воды
  
  Ответить

Дмитрий

09.10.2023 17:32

Делал все по инструкции. Никак не запускается веб-интерфес zigbee2mqtt. Постоянно выдает ошибку:

"502: Bad Gateway Zigbee2MQTT
Похоже, что дополнение ещё не готово. Возможно, оно запускается. Вы хотите попробовать ещё раз?"

Кто знает как исправить?

Ответить (13)

Alexander Pushkarev

09.10.2023 17:44

А что в логах самого Zigbee2MQTT? Оно без правильной конфигурации не будет запускаться

Ответить

Дмитрий

09.10.2023 17:48

А там сплошные ошибки:

[17:46:50] INFO: Preparing to start...
[17:46:50] INFO: Socat not enabled
[17:46:52] INFO: Starting Zigbee2MQTT...
Zigbee2MQTT:info  2023-10-09 17:46:58: Logging to console and directory: '/config/zigbee2mqtt/log/2023-10-09.17-46-58' filename: log.txt
Zigbee2MQTT:info  2023-10-09 17:46:58: Starting Zigbee2MQTT version 1.33.1 (commit #unknown)
Zigbee2MQTT:info  2023-10-09 17:46:58: Starting zigbee-herdsman (0.19.0)
Zigbee2MQTT:error 2023-10-09 17:47:19: Error while starting zigbee-herdsman
Zigbee2MQTT:error 2023-10-09 17:47:19: Failed to start zigbee
Zigbee2MQTT:error 2023-10-09 17:47:19: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start.html for possible solutions
Zigbee2MQTT:error 2023-10-09 17:47:19: Exiting...
Zigbee2MQTT:error 2023-10-09 17:47:19: Error: Connection not initialized
    at Ezsp.execCommand (/app/node_modules/zigbee-herdsman/src/adapter/ezsp/driver/ezsp.ts:551:19)
    at Ezsp.version (/app/node_modules/zigbee-herdsman/src/adapter/ezsp/driver/ezsp.ts:349:35)
    at Driver.startup (/app/node_modules/zigbee-herdsman/src/adapter/ezsp/driver/driver.ts:141:25)
    at EZSPAdapter.start (/app/node_modules/zigbee-herdsman/src/adapter/ezsp/adapter/ezspAdapter.ts:165:16)
    at Controller.start (/app/node_modules/zigbee-herdsman/src/controller/controller.ts:132:29)
    at Zigbee.start (/app/lib/zigbee.ts:60:27)
    at Controller.start (/app/lib/controller.ts:101:27)
    at start (/app/index.js:107:5)

Ответить

Alexander Pushkarev

09.10.2023 17:52

Покажите конфиг

Ответить

Дмитрий

09.10.2023 17:59

homeassistant: true
advanced:
  network_key:
    - 60
    - 98
    - 205
    - 27
    - 48
    - 70
    - 217
    - 148
    - 152
    - 106
    - 172
    - 63
    - 202
    - 255
    - 107
    - 6
  pan_id: 25024
  ext_pan_id:
    - 85
    - 78
    - 182
    - 176
    - 209
    - 82
    - 142
    - 221
mqtt:
  server: mqtt://core-mosquitto:1883
  user: mqtt
  password: mqtt
serial:
  port: >-
    /dev/serial/by-id/USB-Texas_Instruments_TI_CC2531_USB_CDC___0X00124B001CD6E39E-if00
  adapter: ezsp
frontend:
  port: 8099

Ответить

Alexander Pushkarev

09.10.2023 18:05

Необходимо убрать adapter: ezsp, для вашего стика adapter можно не указывать ручную.

Так же из документации Zigbee2MQTT по вашему стику

Когда вы подключаете CC2531 к компьютеру, должен загореться зеленый светодиод. При нажатии кнопки сброса на CC2531 зеленый светодиод должен погаснуть. CC2531 имеет 2 кнопки, кнопка сброса — та, которая находится ближе всего к порту USB. Теперь попробуйте снова запустить Zigbee2MQTT.

Ответить
Дмитрий

09.10.2023 18:15

Да это я читал и делал, вот только толку ноль…

Ответить
Alexander Pushkarev

09.10.2023 18:18

А что по поводу adapter: ezsp, убрали и эффекта нет? В логах должна быть другая ошибка или интеграция запуститься.

Ответить
Дмитрий

09.10.2023 18:33

Спасибо, за то что попытались помочь.

Ответить
Дмитрий

09.10.2023 18:59

adapter: ezsp убирал, ничего не менялось, вставил обратно и, наверное, после этого скопировал лог.

Ответить

Дмитрий

09.10.2023 19:17

Ну вот лог без adapter: ezsp:

[19:16:12] INFO: Preparing to start...
[19:16:12] INFO: Socat not enabled
[19:16:14] INFO: Starting Zigbee2MQTT...
Zigbee2MQTT:info  2023-10-09 19:16:20: Logging to console and directory: '/config/zigbee2mqtt/log/2023-10-09.19-16-20' filename: log.txt
Zigbee2MQTT:info  2023-10-09 19:16:20: Starting Zigbee2MQTT version 1.33.1 (commit #unknown)
Zigbee2MQTT:info  2023-10-09 19:16:20: Starting zigbee-herdsman (0.19.0)
Zigbee2MQTT:error 2023-10-09 19:16:20: Error while starting zigbee-herdsman
Zigbee2MQTT:error 2023-10-09 19:16:21: Failed to start zigbee
Zigbee2MQTT:error 2023-10-09 19:16:21: Check https://www.zigbee2mqtt.io/guide/installation/20_zigbee2mqtt-fails-to-start.html for possible solutions
Zigbee2MQTT:error 2023-10-09 19:16:21: Exiting...
Zigbee2MQTT:error 2023-10-09 19:16:21: Error: Error while opening serialport 'Error: Error: No such file or directory, cannot open /dev/serial/by-id/USB-Texas_Instruments_TI_CC2531_USB_CDC___0X00124B001CD6E39E-if00'
    at SerialPort. (/app/node_modules/zigbee-herdsman/src/adapter/z-stack/znp/znp.ts:146:28)
    at SerialPort._error (/app/node_modules/@serialport/stream/dist/index.js:82:22)
    at /app/node_modules/@serialport/stream/dist/index.js:118:18

Ответить

Дмитрий

09.10.2023 19:25

Еще вот какая ерунда: Дополнение запущено, но при попытке открыть веб-интерфейс вываливается сообщение «Zigbee2MQTT Дополнение не запущено. Хотите запустить его сейчас?»

Ответить
Alexander Pushkarev

09.10.2023 19:39
Почитал документацию на ваш адаптер и для него немного другие инструкции по настройке. Вы вписываете полный путь до адаптера, а необходимо только ссылку на него (так только на Texas Instruments TI CC2531).

Выполните команду ls -l /dev/serial/by-id

Вы получите что-то типа этого
```
/dev/serial/by-id/USB-Texas_Instruments_TI_CC2531_USB_CDC___0X00124B001CD6E39E-if00 -> ../../ttyACM0
```
И конечный конфиг должен выглядеть так
```
serial:
  port: >-
    /dev/ttyACM0
```
или
```
serial:
  port: /dev/ttyACM0
```
пробуйте оба варианта
Ответить
Дмитрий

12.10.2023 13:23
Докладываю.
Вариант
```
serial:
  port: >-
    /dev/ttyACM0
```
автоматически заменился вариантом
```
serial:
  port: /dev/ttyACM0
```
и наконец-то веб-интерфейс запустился.

Огромное вам спасибо!
Ответить

Kamal

17.10.2023 20:53

Помогло удаление ZHA

Ответить (2)
- Sentos
  
  21.12.2023 13:05
  
  +
  
  Ответить
- Алексей
  
  12.01.2024 13:56
  
  Сам мучился несколько дней, плюнул и отложил, дальше всё снова повторилось. Пробовал искать решение везде. Помогло следующее — не просто удаление ZHA (после удаления zigbee home assistant всё так же повторялась ошибка), а удаление с последующей повторной установкой ZHA и всё сразу заработало.
  
  Ответить
Александр

20.12.2023 19:47

Спасибо. Помогла ваша статья,

Ответить
Вадим

20.02.2024 13:33

Добрый день. А есть возможность при настройки home assistant панели что бы ha обращался сразу в адрес контейнера во внутренней сити docker, а не на проброшенный порт устройства. Если делать нат на ha приложения которы в докере не работают нужно все порты прокидывать.

Ответить (1)
- Alexander Pushkarev
  
  20.02.2024 16:42
  
  В докере есть network. Контейнеры могут обращаться друг к другу по названию контейнера в рамках одной сети
  
  Ответить

Оставить комментарий