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

DDS238-4-W — однофазный счётчик на DIN-рейку, DTS238-7-W — трёхфазный родственник. Оба в одной карточке. На корпусе есть порт RS-485 Modbus, 1200–9600 бод, по умолчанию 9600, без чётности. Wi-Fi-модуль внутри — ESP8266, сложность замены прошивки 5/5.

Компонент dxs238xw из форка rodgon81 читает измерения по UART модуля: TX GPIO1, RX GPIO3, 9600. Журнал с этого UART снимают.

Клеммы RS-485 на корпусе карточка не объявляет теми же пинами, что GPIO1 и GPIO3. Это отдельный порт для внешнего мастера Modbus. Прошивается радиомодуль, а не эта клемма.

Счётчик DDS238-4-W — DDS238-4 на DIN-рейке. Винтовой RS-485 на лицевой панели — не площадки прошивки. Фото: esphome/devices.esphome.io, GPL-3.0

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

Частота, энергия импорта и экспорта, суммарная энергия
Напряжение, ток и мощность, которые компонент отдаёт для вашей фазы
Локальные данные без облака Tuya

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

Приложение Tuya / TOMZN счётчик больше не видит
Откат возможен только если сняли свой дамп модуля до стирания
Гарантия после вскрытия корпуса счётчика заканчивается

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

Доступ к ESP8266 внутри счётчика. Сеть на клеммах смертельна, автомат отключают
USB–UART 3,3 В
Внешний компонент rodgon81, не встроенный modbus ESPHome

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.

Карточка показывает фото UART рядом с модулем. Программатор сажают на TX, RX и землю модуля, GPIO0 на землю для загрузчика ESP8266. Силовые клеммы в этот момент обесточены.

Не путайте винтовой порт RS-485 на лицевой панели с площадками прошивки.

Модуль внутри DDS238-4 — Wi-Fi-модуль ESP8266 внутри. Линия на клеммах снята, прежде чем открывать корпус. Фото: esphome/devices.esphome.io, GPL-3.0

UART модуля DDS238-4 — Площадки UART модуля: TX GPIO1, RX GPIO3, 9600. Это не клемма RS-485. Фото: 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, паяльник больше не нужен.

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

Список сенсоров длинный и разный для одной и трёх фаз. Его берут из карточки, а не собирают по имени полей.

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

---
#------------------------------------------------------------------------
# Common setting for the 1 and 3 Phase Meter (DDS238-4 W and DTS238-7 W).
# All possible entities are shown, but the idea is to only place the ones
# that are going to be used.
#
# The following code only shows the properties needed to configure the
# meter to access the measurements. Everything related to Wifi, MQTT, API,
# Time, etc., see directly in the ESPHome options, because it is not the
# scope of this Readme.
#------------------------------------------------------------------------

logger:
  level: DEBUG
  baud_rate: 0

uart:
  tx_pin: 1
  rx_pin: 3
  baud_rate: 9600

dxs238xw:
  update_interval: 3s

sensor:
  - platform: dxs238xw
    frequency:
      name: "Frequency"

    import_active_energy:
      name: "Import Active Energy"
    export_active_energy:
      name: "Export Active Energy"
    total_energy:
      name: "Total Energy"

    energy_purchase_balance:
      name: "Energy Purchase - Balance"

    phase_count:
      name: "Phases N°"

    energy_purchase_price:
      name: "Energy Purchase Price"

    total_energy_price:
      name: "Total Energy Price"
    contract_total_energy:
      name: "Total Energy Contract"

    price_kWh:
      name: "kWh Price"

text_sensor:
  - platform: dxs238xw
    meter_state_detail:
      name: "State - Detail"
      filters:
        - substitute:
            - "Off by Over Voltage -> INACTIVE - Over Voltage"
            - "Off by Under Voltage -> INACTIVE - Under Voltage"
            - "Off by Over Current -> INACTIVE - Over Current"
            - "Off by End Purchase -> INACTIVE - End Purchase"
            - "Off by End Delay -> INACTIVE - End Delay"
            - "Off by User -> INACTIVE - By User"
            - "Off by Unknown -> INACTIVE - Unknown"
            - "Power Ok -> ACTIVE"
    delay_value_remaining:
      name: "Remaining Delay Time"
    meter_id:
      name: "Serial N°"

number:
  - platform: dxs238xw
    max_current_limit:
      name: "Maximum Current"
    max_voltage_limit:
      name: "Maximum Voltage"
    min_voltage_limit:
      name: "Minimum Voltage"
    energy_purchase_value:
      name: "Energy Purchase"
    energy_purchase_alarm:
      name: "Energy Purchase Alarm"
    delay_value_set:
      name: "Delay Time"
    starting_kWh:
      name: "kWh Start"
    price_kWh:
      name: "kWh Price"

switch:
  - platform: dxs238xw
    energy_purchase_state:
      name: "Activate Energy Purchase"
    meter_state:
      name: "State SmartMeter"
    delay_state:
      name: "Activate Delay"

button:
  - platform: dxs238xw
    reset_data:
      name: "Restart Consumption"

binary_sensor:
  - platform: gpio
    internal: true
    id: button_0
    pin:
      number: GPIO13
      mode:
        input: true
        pullup: true
      inverted: true
    on_multi_click:
      - timing:
          - ON for at least 1s
        then:
          - dxs238xw.meter_state_toggle
        invalid_cooldown: 0ms

  - platform: dxs238xw
    warning_off_by_over_voltage:
      name: "Over Voltage Alert"
    warning_off_by_under_voltage:
      name: "Under Voltage Alert"
    warning_off_by_over_current:
      name: "Over Current Alert"
    warning_off_by_end_purchase:
      name: "End Purchase Alert"
    warning_off_by_end_delay:
      name: "End Delay Alert"
    warning_off_by_user:
      name: "Off by User Alert"
    warning_purchase_alarm:
      name: "Balance Purchase Alert"
    meter_state:
      name: "Relay State"

status_led:
  pin:
    number: GPIO14
    inverted: no

---
#------------------------------------------------------------------------
# This setting is only for the 1 Phase Meter (DDS238-4 W).
# All possible entities are shown, but the idea is to only place the ones
# that are going to be used.
#
# The following code only shows the properties needed to configure the
# meter to access the measurements. Everything related to Wifi, MQTT, API,
# Time, etc., see directly in the ESPHome options, because it is not the
# scope of this Readme.
#------------------------------------------------------------------------

sensor:
  - platform: dxs238xw
    current_phase_1:
      name: "Current"

    voltage_phase_1:
      name: "Voltage"

    reactive_power_phase_1:
      name: "Reactive Power"

    active_power_phase_1:
      name: "Active Power"

    power_factor_phase_1:
      name: "Power Factor"

---
#------------------------------------------------------------------------
# This setting is only for the 3 Phase Meter (DTS238-7 W).
# All possible entities are shown, but the idea is to only place the ones
# that are going to be used.
#
# The following code only shows the properties needed to configure the
# meter to access the measurements. Everything related to Wifi, MQTT, API,
# Time, etc., see directly in the ESPHome options, because it is not the
# scope of this Readme.
#------------------------------------------------------------------------

sensor:
  - platform: dxs238xw
    current_phase_1:
      name: "Current Phase 1"
    current_phase_2:
      name: "Current Phase 2"
    current_phase_3:
      name: "Current Phase 3"

    voltage_phase_1:
      name: "Voltage Phase 1"
    voltage_phase_2:
      name: "Voltage Phase 2"
    voltage_phase_3:
      name: "Voltage Phase 3"

    reactive_power_phase_1:
      name: "Reactive Power Phase 1"
    reactive_power_phase_2:
      name: "Reactive Power Phase 2"
    reactive_power_phase_3:
      name: "Reactive Power Phase 3"
    reactive_power_total:
      name: "Reactive Power Total"

    active_power_phase_1:
      name: "Active Power Phase 1"
    active_power_phase_2:
      name: "Active Power Phase 2"
    active_power_phase_3:
      name: "Active Power Phase 3"
    active_power_total:
      name: "Active Power Total"

    power_factor_phase_1:
      name: "Power Factor Phase 1"
    power_factor_phase_2:
      name: "Power Factor Phase 2"
    power_factor_phase_3:
      name: "Power Factor Phase 3"
    power_factor_total:
      name: "Power Factor Total"

on_...:
  then:
    - dxs238xw.meter_state_on

id(smart_meter).meter_state_on();

on_...:
  then:
    - dxs238xw.meter_state_off

id(smart_meter).meter_state_off();

on_...:
  then:
    - dxs238xw.meter_state_toggle

id(smart_meter).meter_state_toggle();

binary_sensor:
  - platform: gpio
    internal: true
    id: button_0
    pin:
      number: GPIO13
      mode:
        input: true
        pullup: true
      inverted: true
    on_multi_click:
      - timing:
          - ON for at least 1s
        then:
          - dxs238xw.meter_state_toggle
        invalid_cooldown: 0ms

status_led:
  pin:
    number: GPIO14
    inverted: no

external_components:
  - source:
      type: git
      url: https://github.com/rodgon81/esphome
      ref: dev
    refresh: 300s
    components: [dxs238xw]

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

Энергию вешайте на панель счётчика с состоянием total increasing, как отдаёт компонент. Не суммируйте её второй раз шаблоном, иначе расход удвоится.

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

modbus: на GPIO1 не заменяет dxs238xw. Это другой разбор того же UART
Журнал на 115200 занимает линию, счётчик молчит
Трёхфазный DTS238-7 и однофазный DDS238-4 делят компонент, но набор сущностей не одинаковый

9. Источники

Каталог DDS238-4-W на devices.esphome.io https://devices.esphome.io/devices/Hiking-DDS238-4-WiFi/
GitHub Исходник карточки https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/Hiking-DDS238-4-WiFi/index.md
GitHub rodgon81/esphome, компонент dxs238xw https://github.com/rodgon81/esphome
Документация Внешние компоненты ESPHome https://esphome.io/components/external_components/