ESP-helper

Обновлено 2026-09-22

Tuya, погодная станция

Tuya, модель модуль WBR3. 5/5 · замена модуля. Модуль Wi-Fi говорит со вторым микроконтроллером.

1. Название и модель

Карточка Tuya Smart Weather Station собирает одинаковые корпуса разных брендов. Погоду с облака Tuya станция больше не ждёт: экран можно кормить сенсорами Home Assistant. Для этого авторы ушли с обычного ESPHome. Плата generic-rtl8720cf-2mb-992k, исходники LibreTiny — коммит vitoralb/libretiny на 1a3f8ce, потому что у rtl8720c ломаются пины UART 13 и 14. Компонент tuya они тоже подменяют сборкой vitoralb/esphome на теге 2025.8.3: штатный компонент не понимает погодные команды MCU.

Модуль WBR3 для прошивки снимают и паяют пробники. Карточка отсылает к теме на Elektroda и просит отдельное питание 3,3 В с общей землёй с адаптером. Сложность в каталоге 5 из 5.

Таблица ног: PA13 приём от TX MCU, PA14 передача на RX MCU. В YAML это rx_pin: GPIO13 и tx_pin: GPIO14, скорость 9600, журнал с UART снят. Датапоинт 131 — местная температура, целое в десятых долях, поэтому множитель 0,1. Датапоинт 132 — влажность целым процентом. До трёх радиодатчиков сидят на 133–138. Яркость, единицы и ночной режим — отдельные номера в таблице карточки. Погода с улицы уходит в MCU сырым кадром через сервис того форка, короткий конфиг этого не повторяет.

Форк привязан к конкретному коммиту. Обновление ESPHome «до последнего» эту станцию соберёт уже без погодных команд.

2. Что даёт перепрошивка

  • Экран станции показывает ваши сенсоры, не облако Tuya
  • Местные температура и влажность и до трёх внешних радиодатчиков
  • Корпуса разных брендов карточка считает одной железкой

3. Что теряется

  • Модуль снимают с платы
  • Обычный ESPHome без двух форков погоду на экран не положит
  • OTA зависит от тех самых правок LibreTiny

4. Что понадобится

  • Паяльник и питание 3,3 В
  • ltchiptool
  • Два форка по ссылкам из карточки, не только этот сайт

5. Разборка и пины

Программатор USB–UART подключают к модулю, который прошивают, крест-накрест:

  • Земля переходника (GND) — на землю платы. Этот провод обязателен.
  • TX переходника — на RX модуля. На плате площадка часто подписана RX, RXD или RXD0.
  • RX переходника — на TX модуля. На плате это TX, TXD или TXD0.
  • Питание логики — 3,3 В. Пять вольт на эти площадки не подают. Если плату уже кормит её блок, линию 3,3 В с переходника не подключают вторым источником.
  • Для входа в загрузчик ESP8266 и ESP32 площадку GPIO0 (IO0, BOOT) замыкают на землю и в этот момент подают питание. После старта записи землю с GPIO0 снимают.

Если у этой модели в тексте ниже другие имена площадок, прямой порядок TX–TX или прошивка по USB, делайте как написано там. Общая схема выше — для обычного модульного UART.

Станцию разбирают, WBR3 снимают, паяют UART. Земля питания и земля адаптера общие. После проверки модуль ставят обратно.

6. Прошивка

Готового файла «прошивка именно этой модели» на этом сайте нет. Её собирает ESPHome из текстового конфига YAML: туда входят Wi-Fi, пины и команды второго чипа. Чужой .bin из интернета почти наверняка собран с чужим паролем сети.

Какую программу ставить

  • ESPHome Dashboard — дополнение в Home Assistant или программа на компьютере. В ней пишут YAML, нажимают Install, и она сама собирает прошивку. Установка: дополнение для Home Assistant или команда pip install esphome.
  • ESPHome Web, сайт web.esphome.io, — загрузчик в браузере Chrome или Edge. Им записывают уже собранный .bin на ESP8266 и ESP32 через USB–UART. На BK72xx он не рассчитан.
  • esptool — программа Espressif, чтобы снять заводскую копию флеша и записать .bin, если браузер порт не видит. Репозиторий: espressif/esptool.
  • ltchiptool — то же самое для чипов Beken BK72xx (модули WB3S, WBR3, CB3S и похожие). ESPHome для них собирается через LibreTiny. Программа: libretiny-eu/ltchiptool, описание платы: компонент bk72xx.

Как собрать конфиг

  1. В Dashboard нажмите New Device и выберите чип, который стоит на плате: ESP8266, ESP32 или BK72xx. Имя — латиницей, без пробелов.
  2. Пароль Wi-Fi уберите в файл secrets.yaml рядом с конфигом. В YAML оставьте ssid: !secret wifi_ssid и password: !secret wifi_password.
  3. Блок UART, модель и скорости из раздела ниже вставьте в этот файл. Полный пример, если он длинный, берите по ссылке в источниках внизу страницы, а не из гайда соседней модели.
  4. Строки api: и ota: оставьте. Без api: Home Assistant устройство не увидит. Ключ шифрования Dashboard предлагает сам, его потом спросит интеграция ESPHome.

Как залить первый раз

  1. Подключите USB–UART, как в разделе «Разборка и пины»: земля переходника на землю платы, TX переходника на RX модуля, RX переходника на TX модуля. Логика 3,3 В. Имена площадок на конкретной плате — там же.
  2. Для ESP8266 и ESP32 замкните GPIO0 (IO0, BOOT) на землю и в этот момент подайте питание. Для BK72xx ltchiptool сам просит перезапустить чип, обычно кратким отключением земли.
  3. В Dashboard: Install → Plug into this computer, выберите порт переходника. Либо Install → Manual download, сохраните .bin и откройте его на web.esphome.io. Из терминала то же самое делает esphome run имя-устройства.yaml.
  4. Когда в логе появится IP-адрес, GPIO0 от земли отпустите, провода можно отпаять. Следующие обновления идут по Wi-Fi, пункт OTA, паяльник больше не нужен.

Дальше — только то, чем эта модель отличается от общей схемы.

Собирают YAML с указанными source. Короткий конфиг ниже читает датапоинты 131 и 132. Кадр погоды с Home Assistant копируют из карточки целиком, там сервис get_weather_service.

Базовый конфиг этой модели с карточки или из репозитория компонента. Wi-Fi, пароль и OTA задайте как в общем разделе выше. Пароли из исходника сюда не перенесены.

rtl87xx:
  board: generic-rtl8720cf-2mb-992k
  framework:
    version: 0.0.0
    source: https://github.com/vitoralb/libretiny#1a3f8ce

external_components:
  - source: github://vitoralb/esphome@2025.8.3
    components: [tuya]

logger:
  baud_rate: 0

uart:
  rx_pin: GPIO13
  tx_pin: GPIO14
  baud_rate: 9600

tuya:

sensor:
  - platform: tuya
    name: Температура
    sensor_datapoint: 131
    unit_of_measurement: "°C"
    filters:
      - multiply: 0.1
  - platform: tuya
    name: Влажность
    sensor_datapoint: 132
    unit_of_measurement: "%"

7. Настройка в Home Assistant

Местная температура придёт сенсором. Экран при этом может показывать другую температуру, ту, что вы прислали с HA. Это два разных числа.

8. Известные баги и как их обойти

  • Штатный компонент tuya без форка, погодные команды в логе неизвестны
  • Пины 13 и 14 на официальном LibreTiny уезжают в программный UART, карточка как раз это чинит
  • Множитель 0,1 снят, на экране HA температура в десять раз выше

9. Источники