1. Название и модель
Карточка описывает европейскую умную розетку Tuya на 16/20 А с измерением мощности. Снаружи она похожа на Athom, внутри другой модуль: Tuya T34. Это BK7231N в корпусе QFN32, его же называют LGA36, если считать четыре тепловые площадки снизу. Обсуждение модуля есть на Elektroda, распиновка — в даташите T34.
Отдельного Tuya MCU нет. Реле, кнопка, светодиоды и измеритель BL0937 сидят на пинах Beken. Сложность 4/5: чип с платы не снимают, к боковой грани корпуса паяют тонкий провод kynar. Два вывода доступны только сбоку, третий проще. Соседние ноги не замыкают.
Пишет ltchiptool или команда esphome upload. Питание логики — 3,3 В с USB–UART, вилка розетки вынута.
Выводы программатора и рабочие GPIO — разные номера. Вывод 25 чипа это UART приёмника загрузчика, а P24 в YAML это реле. Путать их нельзя.
2. Что даёт перепрошивка
- Реле локально
- Мощность, ток и напряжение с BL0937
- Кнопка на корпусе остаётся в вашем YAML
3. Что теряется
- Smart Life розетку не видит
- Гарантия безымянной розетки после пайки заканчивается
- Другая розетка Tuya с настоящим MCU по UART этим пинам не подчинится
4. Что понадобится
- Тонкий провод (kynar) и паяльник с тонким жалом
- USB–UART с выходом 3,3 В
- ltchiptool или
esphome upload - Даташит T34, чтобы не принять вывод 7 за CEN
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.
Корпус на винтах или клипсах, вилка вынута. Чип не выпаивают. По даташиту и карточке программатор сажают так:
- вывод 25 чипа — UART_RXD, сюда идёт TX переходника
- вывод 26 чипа — UART_TXD, сюда идёт RX переходника
- земля переходника на землю платы, питание 3,3 В
- сброс в загрузчик — короткий замыкатель CEN на землю. CEN у T34 на выводе 9
Автор карточки сначала замкнул вывод 7, думая, что это CEN. Чип всё равно вошёл в загрузчик, скорее всего из-за сброса по просадке питания. Повторять вывод 7 не нужно: рабочий CEN — вывод 9.
Рабочие пины после прошивки, это уже не ноги программатора:
- P06 — CF микросхемы BL0937, в конфиге инверсный
- P07 — CF1, инверсный
- P08 — SEL, инверсный
- P24 — реле и второй светодиод
- P26 — кнопка, инверсная, с подтяжкой
- P28 — светодиод статуса, инверсный
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.
Как собрать конфиг
- В Dashboard нажмите New Device и выберите чип, который стоит на плате: ESP8266, ESP32 или BK72xx. Имя — латиницей, без пробелов.
- Пароль Wi-Fi уберите в файл
secrets.yamlрядом с конфигом. В YAML оставьтеssid: !secret wifi_ssidиpassword: !secret wifi_password. - Блок UART, модель и скорости из раздела ниже вставьте в этот файл. Полный пример, если он длинный, берите по ссылке в источниках внизу страницы, а не из гайда соседней модели.
- Строки
api:иota:оставьте. Безapi:Home Assistant устройство не увидит. Ключ шифрования Dashboard предлагает сам, его потом спросит интеграция ESPHome.
Как залить первый раз
- Подключите USB–UART, как в разделе «Разборка и пины»: земля переходника на землю платы, TX переходника на RX модуля, RX переходника на TX модуля. Логика 3,3 В. Имена площадок на конкретной плате — там же.
- Для ESP8266 и ESP32 замкните GPIO0 (IO0, BOOT) на землю и в этот момент подайте питание. Для BK72xx ltchiptool сам просит перезапустить чип, обычно кратким отключением земли.
- В Dashboard: Install → Plug into this computer, выберите порт переходника. Либо Install → Manual download, сохраните
.binи откройте его на web.esphome.io. Из терминала то же самое делаетesphome run имя-устройства.yaml. - Когда в логе появится IP-адрес, GPIO0 от земли отпустите, провода можно отпаять. Следующие обновления идут по Wi-Fi, пункт OTA, паяльник больше не нужен.
Дальше — только то, чем эта модель отличается от общей схемы.
Плата в YAML названа обобщённо. Комментарий автора: на самом деле это модуль T34.
Измеритель — платформа hlw8012 с model: BL0937, не отдельная платформа bl0937. Документация компонента: hlw8012. Пины CF, CF1 и SEL инверсные. В карточке voltage_divider: 760, строка current_resistor: 0.001ohm закомментирована, initial_mode: CURRENT, обновление раз в 15 секунд, смена режима каждые 4 измерения. Эти числа берут из карточки и сверяют нагрузкой известной мощности.
Базовый конфиг этой модели с карточки или из репозитория компонента. Wi-Fi, пароль и OTA задайте как в общем разделе выше. Пароли из исходника сюда не перенесены.
esphome:
comment: "Tuya Smart Socket EU 20A with Power Monitor"
bk72xx:
board: generic-bk7231n-qfn32-tuya # actually a T34 Tuya module
status_led:
pin:
number: P28
inverted: true
# Local button on PCB
binary_sensor:
- platform: gpio
id: button_1
pin:
number: P26
mode:
input: True
pullup: True
inverted: True
icon: "mdi:radiobox-blank"
filters:
- delayed_on: 50ms
# Relay output
output:
- platform: gpio
pin: P24
id: relay_1
# Energy meter BL0937
sensor:
# https://esphome.io/components/sensor/hlw8012/
- platform: hlw8012
model: BL0937
cf_pin:
number: P06
inverted: true
cf1_pin:
number: P07
inverted: true
sel_pin:
number: P08
inverted: true
current:
name: "Current"
voltage:
name: "Voltage"
power:
name: "Power"
energy:
name: "Energy"
# current_resistor: 0.001ohm
voltage_divider: 760
initial_mode: CURRENT
update_interval: 15s
change_mode_every: 4
7. Настройка в Home Assistant
Мощность сверьте кипятильником или лампой известной мощности и поправьте voltage_divider в YAML, не шаблоном в Home Assistant.
8. Известные баги и как их обойти
- Замыкают вывод 7 вместо CEN на выводе 9 и считают, что так и задумано. У автора это случайно сработало, в даташите CEN на выводе 9
- Ищут платформу
bl0937. В ESPHome этот чип описан какhlw8012иmodel: BL0937 - Конфиг с
tuya:и datapoint на эту плату не ложится: UART-MCU нет - Делитель 760 заменяют числом от другой розетки, ватты уезжают
- Путают P06 измерения с выводом 25 программатора
9. Источники
- Каталог Розетка 20 А на devices.esphome.io https://devices.esphome.io/devices/Tuya-Smart-Plug-20A/
- GitHub Исходник карточки https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/Tuya-Smart-Plug-20A/index.md
- Документация Даташит модуля T34 https://developer.tuya.com/docs/iot/t34-module-datasheet?id=Ka0l4h5zvg6j8
- Документация BL0937 в документации Tuya https://developer.tuya.com/docs/iot-device-dev/Electricity-statistics?id=Kaunfo4am6icc
- Обсуждение T34 на Elektroda https://www.elektroda.com/rtvforum/topic4036975.html
- Документация Компонент hlw8012 https://esphome.io/components/sensor/hlw8012/
- Документация ltchiptool https://docs.libretiny.eu/docs/flashing/tools/ltchiptool/