Использование ESPHome-устройств с контроллером Wiren Board

Материал из Wiren Board

Описание

Представление ESPHome-устройства в контроллере Wiren Board

ESPHome — это прошивка для Wi-Fi устройств на базе контроллеров ESP. Её часто используют для изготовления самодельных беспроводных устройств: датчиков, модулей управления шторами или насосами и т.п.

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

esphome2wb — это стороннее программное обеспечение, которое написано и поддерживается автором.

Конвертер выполнен в виде скрипта wb-rules, который преобразовывает MQTT-топики ESPHome-устройства в контролы виртуального устройства Wiren Board.

Настройка ESPHome-устройства

Перед тем, как использовать устройство с контроллером Wiren Board, включите в прошивке поддержку MQTT и укажите параметры подключения к MQTT-брокеру. Для этого добавьте в файл конфигурации прошивки строки:

  name: "my_device"
  prefix: "esphome/${name}"

# Настройки подключения к MQTT-брокеру
mqtt:
  broker: 192.168.1.0 # укажите IP-адрес контроллера
  port: 1883
  username: ''
  password: ''
  discovery: false
  id: mqtt_client
  topic_prefix: "${prefix}"  

# Передача статуса в MQTT
  birth_message:
      topic: "${prefix}/text_sensor/status/state"
      payload: online

  will_message:
      topic: "${prefix}/text_sensor/status/state"
      payload: offline

  shutdown_message :
      topic: "${prefix}/text_sensor/status/state"
      payload: shutdown

После этого устройство подключится к MQTT-брокеру контроллера и создаст топики по адресу /esphome/device-name.

Установка конвертера esphome2wb

Инструкция:

  1. Скачайте из репозитория файл скрипта esphome2wb.js.
  2. Положите этот файл в папку контроллера /etc/wb-rules/ или создайте в веб-интерфейсе контроллера новый скрипт и вставьте в него содержимое файла.

Всё, теперь все устройства с прошивкой ESPHome, которые подключаются к MQTT-брокеру контроллера автоматически появятся на вкладке Devices.

Полезные ссылки