|
|
Строка 7: |
Строка 7: |
| #* [[#wb-zigbee2mqtt | wb-zigbee2mqtt]] — конвертер из zigbee2mqtt в Wiren Board MQTT Conventions. | | #* [[#wb-zigbee2mqtt | wb-zigbee2mqtt]] — конвертер из zigbee2mqtt в Wiren Board MQTT Conventions. |
|
| |
|
| == zigbee2mqtt == | | == Установка и настройка zigbee2mqtt == |
|
| |
|
| === Описание === | | === Описание === |
Строка 13: |
Строка 13: |
| Официальный сайт — [https://www.zigbee2mqtt.io/ zigbee2mqtt]. | | Официальный сайт — [https://www.zigbee2mqtt.io/ zigbee2mqtt]. |
|
| |
|
| === Установка ===
| | {{Wbincludes:Installing Software In Console}} |
|
| |
|
| ==== Установка с помощью apt ==== | | === Процесс установки === |
| Так как пакет в свой репозиторий мы собираем сами, его версия может отличаться от текущей актуальной версии zigbee2mqtt.
| | Версия пакета zigbee2mqtt в стабильном релизе может отставать от актуальной версии, которая доступна у автора. Все свежии версии доступны в [[testing | тестовом релизе]]. |
|
| |
|
| Запустите консоль и введите команду:
| | Мы рекомендуем устанавливать готовый пакет из нашего репозитория, введите команду: |
| <syntaxhighlight lang="bash"> | | <syntaxhighlight lang="bash"> |
| apt update && apt install -y zigbee2mqtt | | apt update && apt install zigbee2mqtt |
| </syntaxhighlight> | | </syntaxhighlight> |
|
| |
|
| ==== Сборка из исходников ====
| | Альтернативный способ установки — сборка из исходников по [[Zigbee2mqtt-src | инструкции]]. |
| {{note|info| zigbee2mqtt версии 1.22 и выше может не работать с прошивкой модулей WBE2R-R-ZIGBEE, выпущенных до конца 2021 года. Такие модули нужно прошить [[WBE2R-R-ZIGBEE_ZigBee_Extension_Module#Прошивка | свежей прошивкой]].}}
| |
| Это альтернативный метод установки, который позволяет установить актуальную версию zigbee2mqtt. [https://www.zigbee2mqtt.io/guide/installation/01_linux.html Оригинальная инструкция].
| |
| | |
| # Установите необходимые компоненты
| |
| #: <syntaxhighlight lang="bash">
| |
| apt install -y nodejs git make g++ gcc
| |
| </syntaxhighlight>
| |
| # Скопируйте файлы из репозитория zigbee2mqtt:
| |
| #: <syntaxhighlight lang="bash">
| |
| git clone https://github.com/Koenkk/zigbee2mqtt.git /mnt/data/root/zigbee2mqtt
| |
| </syntaxhighlight>
| |
| # Настройте права на папку:
| |
| #: <syntaxhighlight lang="bash">
| |
| chown -R root:root /mnt/data/root/zigbee2mqtt
| |
| </syntaxhighlight>
| |
| # Перейдите в папку с исходниками zigbee2mqtt:
| |
| #: <syntaxhighlight lang="bash">
| |
| cd /mnt/data/root/zigbee2mqtt
| |
| </syntaxhighlight>
| |
| # Запустите установку:
| |
| #: <syntaxhighlight lang="bash">
| |
| npm ci
| |
| </syntaxhighlight>
| |
| #: В процессе установки будет показано несколько предупреждений. Их можно игнорировать.
| |
| | |
| Настройте автоматический запуск zigbee2mqtt, для этого создайте сервис:
| |
| # Создайте новый файл и откройте его на редактирование:
| |
| #: <syntaxhighlight lang="bash">
| |
| mcedit /etc/systemd/system/zigbee2mqtt.service
| |
| </syntaxhighlight>
| |
| # Скопируйте в него следующий текст:
| |
| #: <syntaxhighlight lang="bash">
| |
| [Unit]
| |
| Description=zigbee2mqtt
| |
| After=network.target
| |
| | |
| [Service]
| |
| ExecStart=/usr/bin/npm start
| |
| WorkingDirectory=/mnt/data/root/zigbee2mqtt
| |
| StandardOutput=inherit
| |
| StandardError=inherit
| |
| Restart=always
| |
| User=root
| |
| | |
| [Install]
| |
| WantedBy=multi-user.target
| |
| </syntaxhighlight>
| |
| # Сохраните файл.
| |
| # Разрешите автозапуск сервиса командой:
| |
| #: <syntaxhighlight lang="bash">
| |
| systemctl enable zigbee2mqtt.service
| |
| </syntaxhighlight>
| |
|
| |
|
| === Конфигурация === | | === Конфигурация === |
| Если вы используете модуль расширения [[WBE2R-R-ZIGBEE]], убедитесь, что правильно выставили модуль в '''Settings''' → '''Configs''' → '''Hardware Modules Configuration'''. | | Если вы используете модуль расширения [[WBE2R-R-ZIGBEE]], убедитесь, что правильно выставили модуль в '''Settings''' → '''Configs''' → '''Hardware Modules Configuration'''. При использовании USB-стика порты будут называться <code>/dev/ttyUSB0</code> и <code>/dev/ttyUSB1</code>. |
|
| |
|
| | Настройка: |
| # Откройте файл <code>configuration.yaml</code> для редактированияː | | # Откройте файл <code>configuration.yaml</code> для редактированияː |
| #:<syntaxhighlight lang="bash"> | | #:<syntaxhighlight lang="bash"> |
Строка 104: |
Строка 53: |
| </syntaxhighlight> | | </syntaxhighlight> |
|
| |
|
| Теперь вы можете установить конвертер [[#wb-zigbee2mqtt | wb-zigbee2mqtt]] и Zigbee-устройства можно будет добавить на вкладку '''Devices'''. | | Теперь вы можете установить конвертер wb-zigbee2mqtt и Zigbee-устройства можно будет добавить на вкладку '''Devices'''. |
|
| |
|
| === Управление сервисом === | | === Управление сервисом === |
Строка 114: |
Строка 63: |
| systemctl status zigbee2mqtt # получить статус | | systemctl status zigbee2mqtt # получить статус |
| </syntaxhighlight> | | </syntaxhighlight> |
|
| |
| === Добавление устройств ===
| |
|
| |
| Если вы не используете [[#wb-zigbee2mqtt | wb-zigbee2mqtt]], то для добавления нового устройства в настройках zigbee2mqtt включите параметр '''permit_join''':
| |
| <pre>
| |
| permit_join: true
| |
| </pre>
| |
|
| |
| Далее следуйте инструкции к устройству. В основном требуется зажать кнопку «pair» на несколько секунд и дождаться «мигания» светодиода. После этого устройство должно передать информацию о себе на контроллер. Иногда требуется дополнительно нажимать на кнопку каждую секунду, что бы устройство не «уснуло». После успешного добавления устройство автоматически появится во вкладке Devices.
| |
|
| |
| Более подробная информация на [https://www.zigbee2mqtt.io/ сайте zigbee2mqtt].
| |
|
| |
|
| === Веб-интерфейс (Frontend) === | | === Веб-интерфейс (Frontend) === |
| Веб-интерфейс zigbee2mqtt потребляет ресурсы контроллера — не включайте его, если не используете: добавлять устройства удобно через [[#wb-zigbee2mqtt | wb-zigbee2mqtt]], а удалять можно из файла конфигурации вручную. | | Веб-интерфейс zigbee2mqtt потребляет ресурсы контроллера — не включайте его, если не используете: добавлять и удалять устройства можно через наш конвертер wb-zigbee2mqtt. |
|
| |
|
| Настройка веб-интерфейса zigbee2mqtt:
| | Если вам всё же нужен родной веб-интерфейс zigbee2mqtt, то его можно включить в файле настроек: |
| # Откройте файл <code>configuration.yaml</code> для редактированияː | | # Откройте файл <code>configuration.yaml</code> для редактированияː |
| #:<syntaxhighlight lang="bash"> | | #:<syntaxhighlight lang="bash"> |