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

DDS238-1-W1 — счётчик Hiking / TOMZN на 63 А, DIN-рейка, класс точности энергии 1. Радиомодуль с завода — WB3S (BK72xx). Карточка описывает замену на ESP-12F, сложность 5/5. Кнопка SET сидит на Tuya MCU, нагрузка переключается тройным нажатием.

ESP-12F прошивают до установки: RX и TX на плате уже уходят в MCU, загрузчик по ним не поймать, когда модуль впаян.

Между землёй и GPIO15 нужен резистор 10 кОм. Без него ESP-12F часто не стартует. Корпус 0805 в карточке назван удобным.

Счётчик DDS238-1-W1 — DDS238-1-W1 на DIN-рейке. Фото: esphome/devices.esphome.io, GPL-3.0

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

Измерения и реле нагрузки локально, через протокол Tuya MCU
Тройное нажатие SET остаётся на стороне MCU, если точка в конфиге это учитывает

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

WB3S после замены не возвращает заводское приложение
Гарантия счётчика заканчивается
Дамп Beken нужен был до выпаивания. После замены отката на Tuya нет

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

ESP-12F, прошитый на столе
Резистор 10 кОм на GPIO15 к земле
Отвёртка. Корпус на винтах и местами на клее. Автомат линии выключен

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.

Крышку снимают, плату отсоединяют. На фото карточки виден MCU и посадочное место модуля. ESP-12F сажают вместо WB3S.

Со стороны ESP: GPIO1 — приём MCU (RX чипа счётчика ждёт передачу ESP), GPIO3 — передача MCU. Подписи в таблице карточки: GPIO01 «Tuya MCU Rx», GPIO03 «Tuya MCU Tx». Синий светодиод модуля — GPIO2, инверсный.

MCU и модуль внутри DDS238-1-W1 — WB3S меняют на ESP-12F. Прошивают модуль до пайки: линии TX и RX уже заняты MCU. Фото: esphome/devices.esphome.io, GPL-3.0

Открытый корпус DDS238-1-W1 — Корпус открыт. Силовые клеммы на этом кадре не трогают: линия должна быть снята автоматом. Фото: esphome/devices.esphome.io, GPL-3.0

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, паяльник больше не нужен.

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

Сначала esphome run на голом ESP-12F, с выведенными GPIO0, TX, RX и землёй. Потом модуль впаивают, в конфиге оставляют UART к MCU и logger.baud_rate: 0. Полный набор точек энергии — в карточке DDS238-1-W1, он не совпадает с компонентом dxs238xw от модели DDS238-4.

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

# Basic Config
---
substitutions:
  device_name: "energy-meter"
  friendly_name: "Energy Meter"

esphome:
  name: ${device_name}
  friendly_name: ${friendly_name}

esp8266:
  board: esp12e

logger:
  baud_rate: 0

uart:
  rx_pin: GPIO03
  tx_pin: GPIO01
  baud_rate: 9600

tuya:
  on_datapoint_update:
    - sensor_datapoint: 6
      datapoint_type: raw
      then:
        - lambda: |-
            ESP_LOGD("main", "on_datapoint_update %s", format_hex_pretty(x).c_str());
            id(voltage).publish_state((x[13] << 8 | x[14]) * 0.1);
            id(current).publish_state((x[11] << 8 | x[12]) * 0.001);

#            id(power_active).publish_state((x[02] << 8 | x[03]) * 0.001);   # Power Active   in kW   - DP103
#            id(power_reactive).publish_state((x[06] << 8 | x[07]) * 0.001); # Power Reactive in kVAr - DP110

output:
  - platform: gpio
    pin: GPIO14
    id: tuya_led_wifi
    inverted: True

switch:
  - platform: "tuya"
    id: sw_relay
    name: "Switch"
    switch_datapoint: 16

  - platform: "tuya"
    name: "Restore on startup"
    switch_datapoint: 11
    inverted: True

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO16
      inverted: True
    name: "SET long press"

sensor:
  - platform: template
    id: voltage
    name: "Voltage"
    device_class: voltage
    unit_of_measurement: V
    state_class: measurement
    accuracy_decimals: 1

  - platform: template
    id: current
    name: "Current"
    device_class: current
    unit_of_measurement: A
    state_class: measurement
    accuracy_decimals: 3

  - platform: "tuya"
    name: "Frequency"
    sensor_datapoint: 105
    device_class: frequency
    unit_of_measurement: Hz
    state_class: measurement
    accuracy_decimals: 2
    filters:
      - multiply: 0.01

  - platform: "tuya"
    id: power_active
    name: "Power Active"
    sensor_datapoint: 103
    device_class: power
    unit_of_measurement: kW
    state_class: measurement
    accuracy_decimals: 3
    filters:
      - multiply: 0.001

  - platform: "tuya"
    id: power_reactive
    name: "Power Reactive"
    sensor_datapoint: 110
    device_class: power
    unit_of_measurement: kVAr
    state_class: measurement
    accuracy_decimals: 3
    filters:
      - multiply: 0.001

  - platform: "tuya"
    name: "Power Factor"
    sensor_datapoint: 111
    device_class: power_factor
    state_class: measurement
    accuracy_decimals: 3
    filters:
      - multiply: 0.001

  - platform: "tuya"
    name: "Energy"
    sensor_datapoint: 101
    device_class: energy
    unit_of_measurement: kWh
    state_class: total_increasing
    accuracy_decimals: 3
    filters:
      - multiply: 0.001

  - platform: "tuya"
    name: "Energy from Grid"
    sensor_datapoint: 1
    device_class: energy
    unit_of_measurement: kWh
    state_class: total_increasing
    accuracy_decimals: 3
    filters:
      - multiply: 0.001

  - platform: "tuya"
    name: "Energy to Grid"
    sensor_datapoint: 102
    device_class: energy
    unit_of_measurement: kWh
    state_class: total_increasing
    accuracy_decimals: 3
    filters:
      - multiply: 0.001

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

Энергию и мощность проверьте по известной нагрузке, например по лампе с паспорта. Коэффициент в карточке может быть умножением сырого числа, его не выкидывайте.

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

Прошивка уже впаянного ESP-12F по тем же TX/RX, что сидят на MCU, не входит в загрузчик
Конфиг DDS238-4 (dxs238xw) на эту плату не встаёт: там другой модуль и другой разбор
GPIO15 без подтяжки

9. Источники

Каталог DDS238-1-W1 на devices.esphome.io https://devices.esphome.io/devices/Hiking-DDS238-1-W1/
GitHub Исходник карточки https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/Hiking-DDS238-1-W1/index.md