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

From Wiren Board
This is the approved revision of this page, as well as being the most recent.

Описание

Tasmota — это прошивка для Wi-Fi устройств на базе контроллеров ESP. Подробнее читайте на сайте tasmota.github.io.

Для использования Tasmota-устройств с контроллером Wiren Board нужно установить конвертер tasmota2wb.

tasmota2wb

tasmota2wb — это стороннее программное обеспечение, которое написано и поддерживается пользователем avp.

Конвертер выполнен в виде сервиса, который преобразовывает MQTT-топики tasmota-устройства в контролы виртуального устройства Wiren Board, поэтому перед работой с tasmota-устройством в нём нужно включить поддержку MQTT.

Так как конвертер поставляется в исходных кодах, то для сборки вам понадобится персональный компьютер с Debian-подобной ОС Linux.


Подготовка

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

Установите необходимые библиотеки:

apt install git libjsoncpp-dev libmosquittopp-dev

Создайте папку, где будем собирать конвертер и хранить систему сборки:

mkdir ~/dev
cd ~/dev

Загрузите Wiren Board Development Environment:

wget https://raw.githubusercontent.com/wirenboard/wirenboard/master/wbdev
chmod +x wbdev

Установите Docker:

sudo apt install apt-transport-https ca-certificates curl gnupg2 software-properties-common -y

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

echo \
  "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io

Сборка

Загрузите исходные коды конвертера:

cd ~/dev
git clone https://github.com/avp-avp/tasmota2wb.git
cd tasmota2wb

В оригинальном репозитории в файле .gitmodules путь к субмодулю libs указан через ssh. Если у вас нет аккаунта на Github с привязанным SSH-ключём, то измените путь репозитория:

  1. Откройте файл на редактирование:
    mcedit ./.gitmodules
    
  2. Замените url на https://github.com/avp-avp/libs.git:
    [submodule "libs"]
    	path = libs
    	url = https://github.com/avp-avp/libs.git
    

Инициализируйте субмодуль libs:

git submodule init
git submodule update

Соберите конвертер, для этого выполните по очереди команды:

sudo WBDEV_TARGET=wb6 ../wbdev chroot autoreconf -fvi
sudo WBDEV_TARGET=wb6 ../wbdev chroot ./configure 
sudo WBDEV_TARGET=wb6 ../wbdev chroot make

В примере указана переменная WBDEV_TARGET=wb6 — это для сборки для контроллера Wiren Board 6. Если вы собираете под другой контроллер, смотрите нужное значение WBDEV_TARGET в Описании Wiren Board Development Environment.

Скопируйте файлы на контроллер, например, с ip-адресом 192.168.42.1:

scp tasmota2wb.service root@192.168.42.1:/etc/systemd/system/
scp tasmota2wb/tasmota2wb root@192.168.42.1:/usr/bin/tasmota2wb
scp tasmota2wb.json root@192.168.42.1:/mnt/data/etc/tasmota2wb.conf
ssh root@192.168.42.1 "ln -s /mnt/data/etc/tasmota2wb.conf /etc/tasmota2wb.conf"
ssh root@192.168.42.1 "systemctl enable tasmota2wb"
ssh root@192.168.42.1 "service tasmota2wb start"

Добавление сенсоров

Сенсоры tasmota-устройств описаны в файле конфигурации tasmota2wb.conf.

Чтобы добавить новый сенсор, нужно:

  1. Найти в MQTT-брокере топик с tasmota-устройством, он будет по адресу /tasmota/discovery/.
  2. Найти в нём топик sensors, например, мы нашли запись "ANALOG":{"Temperature":50.3}.
  3. Добавить новый сенсор в файл конфигурации, раздел sensors:
    {"path":"ANALOG/Temperature",     "type":"temperature",         "name":"Temperature"}
    

Соблюдайте синтаксис JSON при добавлении нового сенсора.

Deb-пакет

Пакет собран из официального репозитория 07.09.2021 для контроллера Wiren Board 6, может не содержать всех обновлений и не поддерживается.

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

Настройте tasmota-устройство, чтобы оно отправляло данные в MQTT-брокер контроллера:

  1. Перейдите ConfigurationConfigure MQTT.
  2. Заполните поля, в поле Host укажите IP-адрес контроллера, а User и Password можно не указывать — по умолчанию на контроллере Wiren Board MQTT-брокер не требует авторизации.
  3. Нажмите Save.

По умолчанию tasmota-устройство отправляет телеметрию в MQTT-брокер раз в 300 секунд, но вы можете это изменить:

  1. Перейдите ConfigurationConfigure Logging.
  2. В поле Telemetry period установите желаемое значение, но не меньше 10 — это минимум, заложенный автором прошивки.
  3. Нажмите кнопку Save.

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