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

Duux Bora (DXDH02) — осушитель, в котором ESP32 стоит отдельным модулем в кожухе под вентилятором и говорит со вторым чипом по протоколу Tuya. Каталог ESPHome оценивает работу на 3/5: нужна разборка, отдельная «сырая» прошивка протокола не пишется.

Линия: GPIO17 передаёт, GPIO16 принимает, 9600 бод. Это медленнее, чем у Levoit, и это нормально для Tuya MCU.

В карточке каталога таблица GPIO местами задублирована. Рабочий ориентир — блок UART из того же конфига: tx_pin: GPIO17, rx_pin: GPIO16, baud_rate: 9600.

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

Штатный компонент tuya в опубликованном конфиге отдаёт:

питание
ночной режим, блокировку от детей и режим очистки
целевую влажность, обычно с шагом 5% в диапазоне 30–80
измеренную влажность
режим Auto или только очистка
скорость вентилятора, высокая или низкая
признак полного бака. В разборе датапоинта 11 «в живую» видели значение 8, то есть установлен третий бит

Управление остаётся в квартире. Аккаунт производителя для ежедневных команд не нужен.

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

Фирменное приложение и учётная запись Duux
Готовые сцены производителя, если они жили только в облаке
Гарантия после снятия ручки, верхней панели и винтов под ней
Историю влажности из приложения. Её заново копите в Home Assistant
Датапоинты, которые автор карточки не видел на своём аппарате. Неизвестный байт в маске бака лучше залогировать, а не объявлять новой функцией

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

Отвёртки под винты корпуса и винты кожуха модуля
USB–UART на 3,3 В
Тонкие провода к площадкам на обратной стороне платы. Постоянная гребёнка не нужна, если прошиваете один раз и дальше живёте на OTA
Фен или просто терпение на защёлках верхней панели. Греть пластик сильно не нужно
ESPHome со встроенной платформой tuya. Внешний репозиторий компонента для базового конфига не требуется

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.

По карточке каталога порядок такой:

Снять все видимые винты, включая те, что закрыты баком для воды
Передняя и задняя половины держатся ещё двумя винтами под верхней панелью
Ручку для переноски сдвигают чуть вперёд, пока не найдётся выемка, и снимают в сторону. Тянуть изо всех сил не нужно
Верхняя панель на защёлках. Её поддевают из отверстий, которые открылись после снятия ручки, лучше с углов
После двух скрытых винтов снимается передняя половина
Под вентилятором небольшой чёрный кожух на двух винтах. Внутри него плата ESP32

Площадки прошивки на обратной стороне платы:

P10 — к TX переходника (это приём ESP)
P11 — к RX переходника (это передача ESP)
P13 — замкнуть на землю на время входа в загрузчик, это GPIO0
P3 — земля для этой перемычки

Дальше обычное правило ESP32: питание логики 3,3 В, TX переходника на RX модуля и наоборот.

Схема площадок прошивки Duux Bora: P10, P11, P13 и P3 — Это схема по карточке каталога, не фотография платы. P10 — к TX переходника, P11 — к RX, P13 замыкают на землю P3 только чтобы войти в загрузчик. Схема по devices.esphome.io

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

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

Конфиг опирается на встроенный компонент Tuya. Ниже ужатая схема опубликованного файла: шифрование API, пароль OTA и имя устройства подставьте свои.

Полный файл на devices.esphome.io дополнительно описывает режим, скорость, ночной и сервисный выключатели и маску бака на датапоинте 11. Его и стоит копировать, а не собирать датчики по памяти.

На время отладки в uart можно включить debug, чтобы видеть байты. После того как сущности ожили, отладку лучше убрать: лог на 9600 легко забивает консоль.

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

esphome:
  name: $devicename
  friendly_name: "Duux Dehumidifier DXDH02"

esp32:
  variant: esp32
  framework:
    type: esp-idf

# Enable logging
logger:

# Enable Home Assistant API
time:
  - platform: homeassistant
    id: homeassistant_time

uart:
  tx_pin: GPIO17
  rx_pin: GPIO16
  baud_rate: 9600
  debug:

# Register the Tuya MCU connection
tuya:
  on_datapoint_update:
    - sensor_datapoint: 11
      datapoint_type: bitmask
      then:
        - lambda: |-
            ESP_LOGD("main", "on_datapoint_update %s", format_hex_pretty(x).c_str());
            // only seen in the wild is decimal value 8, for Water Tank Full
            id(water_tank_full).publish_state((x >> 3) & 1);

binary_sensor:
  - platform: template
    id: water_tank_full
    name: "Water tank"
    device_class: problem
    icon: "mdi:water-alert"

switch:
  - platform: tuya
    name: "Power"
    switch_datapoint: 1
  - platform: tuya
    name: "Night mode"
    icon: "mdi:sleep"
    switch_datapoint: 5
  - platform: tuya
    name: "Child lock"
    icon: "mdi:lock"
    switch_datapoint: 7
  - platform: tuya
    name: "Cleaning Mode"
    icon: "mdi:monitor-shimmer"
    switch_datapoint: 101

number:
  - platform: tuya
    name: "Target humidity"
    number_datapoint: 4
    unit_of_measurement: "%"
    device_class: "humidity"
    min_value: 30
    max_value: 80
    step: 5

sensor:
  - platform: tuya
    name: "Humidity"
    sensor_datapoint: 3
    unit_of_measurement: "%"
    device_class: "humidity"
    accuracy_decimals: 0

select:
  - platform: tuya
    name: "Mode"
    icon: "mdi:cog"
    enum_datapoint: 2
    options:
      0: Auto
      1: Purify only
  - platform: tuya
    name: "Fan speed"
    icon: "mdi:fan"
    enum_datapoint: 6
    options:
      0: High
      1: Low

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

Осушитель появится как набор выключателей, чисел и списков, а не как единая климатическая сущность. Для панели из них собирают карточку:

выключатель питания
число целевой влажности
датчик текущей влажности
список режима и скорости
бинарный датчик полного бака с классом problem, чтобы он подсвечивался как неисправность

Автоматизация «бак полон» полезнее облачного пуша: уведомление уходит, даже если телефон не в аккаунте Duux. Вторую автоматизацию имеет смысл повесить на влажность комнатного датчика, если встроенный датчик стоит в струе сухого воздуха и занижает показания.

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

Скорость 115200, привычная по Levoit, здесь не работает. У Bora 9600
Перепутанные P10 и P11 выглядят как «плата молчит». Меняется пара проводов, а не датапоинты
Датапоинт 11 — битовая маска. Автор карточки видел значение 8 (бак полон) и прямо пишет, что другие комбинации вживую не проверял. Не назначайте остальным битам названия наугад
В таблице GPIO на карточке GPIO16 указан дважды. Для конфига важны строки UART, а не пустые строки таблицы
Если загрузчик не стартует, P13 должен быть на земле только в момент подачи питания, а не всё время работы
Пластиковые защёлки верхней панели ломаются от рычага отвёрткой. Сначала ищется штатный люфт после снятия ручки

9. Источники

Каталог Duux Bora DXDH02 на devices.esphome.io https://devices.esphome.io/devices/duux-bora-dxdh02/
GitHub Исходник карточки Duux Bora https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/Duux-Bora-DXDH02/index.md
Документация Компонент Tuya в документации ESPHome https://esphome.io/components/tuya/