Tasmota

Описание

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

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

tasmota2wb

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

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

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

• 

  Tasmota-устройство в веб-интерфейсе контроллера Wiren Board

• 

  Веб-интерфейс tasmota

• 

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

Подготовка

Подготовим среду для сборки конвертера. Все команды могут выполниться от обычного пользователя, где необходимы привилегии администратора, используйте 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. Откройте файл на редактирование:

   nano ./.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, может не содержать всех обновлений и не поддерживается.

• tasmota2wb_0.1-1_armhf.deb

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

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

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

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

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

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

• Официальный сайт прошивки Tasmota
• Репозиторий tasmots2wb на Github
• Тема на нашем форуме, где упоминается конвертер tasmota2wb
• Описание Wiren Board Development Environment
• Скрипт конвертера на wb-rules — альтернативный вариант не требующий сборки.
• Настройка доступа к mosquitto v2.