ESP-helper

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

Goldair GPOC2415

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

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

GPOC2415 — масляный обогреватель на 2400 Вт с Wi-Fi. Радиомодуль WBR3, это Beken BK72xx. За ним Tuya MCU: питание, уставка, текущая температура и режим. Сложность в каталоге 5/5, модуль выпаивают.

Автор карточки сломал WBR3 при разборе, поэтому опубликованный YAML написан уже под ESP8266 на тех же пинах UART. Если ваш WBR3 цел, его прошивают ltchiptool как BK72xx, а не esptool. Пины к MCU те же: TX GPIO1, RX GPIO3.

Сеть 220 В на силовой плате. Лицевую панель снимают только с вынутой вилкой. Внешний блок 3,3 В для прошивки обязателен, от переходника ток часто не тянет.

Обогреватель Goldair GPOC2415
Масляный радиатор GPOC2415. Фото: esphome/devices.esphome.io, GPL-3.0

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

  • Питание, datapoint 1
  • Уставка 5–30 °C, datapoint 2, и текущая температура, datapoint 3
  • Режим ECO / низкий / средний / высокий, datapoint 5
  • Блокировка, datapoint 7
  • Состояние «греет» или «держит», datapoint 11
  • Оставшиеся минуты автоотключения, datapoint 20

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

  • Приложение Goldair и Tuya перестают видеть обогреватель
  • Сломанный при разборе WBR3 заменой ESP8266 не возвращает заводское приложение
  • Гарантия после снятия панели заканчивается

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

  • Съёмник панели, отвёртка, паяльник
  • Для целого WBR3: ltchiptool и питание 3,3 В от отдельного блока, земля общая с переходником
  • Для замены, как у автора: ESP8266 и конфиг карточки
  • Заметка на Elektroda про прошивку WBR3, ссылка в источниках

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.

Лицевую панель поддевают съёмником, затем выкручивают винты и снимают её целиком. Модуль на обратной стороне основной платы. Чтобы прошить, его отпаивают и сажают пробники. Фото чипа есть в карточке.

Землю лабораторного 3,3 В и землю USB–UART соединяют вместе. От сети обогреватель в этот момент отключён.

Модуль WBR3 на плате Goldair
WBR3 на обратной стороне платы. Его прошивают ltchiptool. Автор карточки модуль повредил и дальше описывает уже ESP8266. Фото: 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.

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

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

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

Для ESP8266, которым автор заменил сгоревший модуль:

Для живого WBR3 в начале файла будет bk72xx, не esp8266. Набор datapoint тот же. Полный climate с режимами вентилятора — в карточке, там же таблица всех точек.

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

esphome:
  name: smart-heater
  friendly_name: Smart-Heater

esp8266:
  board: esp12e

logger:
  baud_rate: 0

uart:
  tx_pin: GPIO1
  rx_pin: GPIO3
  baud_rate: 9600

# Enable Home Assistant API
text_sensor:
  - platform: template
    id: tuya_work_state
    name: Work State
    filters:
      - map:
          - 0 -> Heating
          - 1 -> Warm

tuya:
  on_datapoint_update:
    - sensor_datapoint: 11
      datapoint_type: enum
      then:
        - text_sensor.template.publish:
            id: tuya_work_state
            state: !lambda "return std::to_string(x);"

switch:
  - platform: tuya
    switch_datapoint: 1
    name: Power
  - platform: tuya
    switch_datapoint: 7
    name: Child Lock
  - platform: tuya
    switch_datapoint: 101
    name: Disable Beeping

number:
  - platform: tuya
    number_datapoint: 2
    name: Temperature
    unit_of_measurement: "°C"
    min_value: 5
    max_value: 30
    step: 1

  - platform: tuya
    number_datapoint: 102
    name: AUTO-ON
    unit_of_measurement: Hours
    min_value: 0
    max_value: 24
    step: 1

  - platform: tuya
    number_datapoint: 103
    name: AUTO-OFF
    unit_of_measurement: Hours
    min_value: 0
    max_value: 24
    step: 1

sensor:
  - platform: tuya
    sensor_datapoint: 3
    name: Current Temperature
    unit_of_measurement: "°C"
  - platform: tuya
    sensor_datapoint: 20
    name: AUTO-OFF Time Remaining
    unit_of_measurement: min

select:
  - platform: tuya
    enum_datapoint: 5
    name: Power/Mode
    optimistic: true
    options:
      0: ECO
      1: LOW
      2: MED
      3: HIGH

climate:
  - platform: tuya
    name: "Smart Heater"
    switch_datapoint: 1                  # Power
    target_temperature_datapoint: 2      # Set temperature
    current_temperature_datapoint: 3     # Current temperature

    active_state: 
      datapoint: 11

    fan_mode:
      datapoint: 5
      auto_value: 0
      low_value: 1
      medium_value: 2
      high_value: 3

    visual:
      min_temperature: 5
      max_temperature: 30
      temperature_step: 1

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

Сущность климата ставит температуру и питание. Режим ECO и мощность — отдельный select точки 5. Не путайте его с уставкой: 0 в этой точке значит ECO, а не «ноль градусов».

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

  • esptool на WBR3 не работает. Это Beken
  • Питание прошивки только от USB–UART часто проваливается. Нужен отдельный 3,3 В
  • YAML автора уже под ESP8266. На BK72xx без замены блока bk72xx он не соберётся

9. Источники