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

ITC-308-WIFI держит температуру розеткой нагрева и розеткой охлаждения. Старые аппараты несут Tuya TYWE3S, это ESP8266. Новые получили WBR3S на Realtek RTL8720DN. На конец 2023 года LibreTiny этот чип не поддерживал. Вместо WBR3S паяют ESP-12S, распиновка совместима, конфиг тот же. Сложность 4/5.

Модуль говорит с MCU по UART 9600, TX GPIO1, RX GPIO3.

TYWE3S сидит на дочерней плате, её отпаивают перед прошивкой. RST и EN держат на 3,3 В, иначе программирование не стартует.

Термостат Inkbird ITC-308 — ITC-308-WIFI. Старые партии на TYWE3S, новые на WBR3S. Фото: esphome/devices.esphome.io, GPL-3.0

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

Уставка, datapoint 106, диапазон в карточке от −50 до 99,9 °C, множитель 10
Калибровка датчика, datapoint 102, от −15 до 15 °C
Задержка компрессора и остальные числа 108, 109, 110, 117, 118 — в полном файле
Состояние реле при загрузке: охлаждение, выкл, нагрев

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

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

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

Паяльник, чтобы снять дочернюю плату или заменить WBR3S
USB–UART 3,3 В
Источник 3,3 В на RST и EN на время записи TYWE3S

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.

Дочернюю плату с модулем выпаивают. Для TYWE3S программатор на TX, RX, землю, GPIO0 на землю, плюс RST и EN на 3,3 В. Для новой партии на место WBR3S ставят ESP-12S и прошивают его как ESP8266 до или после посадки, если GPIO0 доступен.

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

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

Уставка приходит числом с multiply: 10: в протоколе десятые доли целым. Этот множитель в карточке обязателен. Блок on_boot публикует текст «Cooling», «Off» или «Heating» по внутреннему состоянию. Его копируют целиком.

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

esphome:
  # Required to get the relay status at boot
  on_boot:
    priority: 600
    then:
        - lambda: |-
            if ((id(relay_status_internal).state == 1)) {
              id(relay_status).publish_state("Cooling");
            }
            else if ((id(relay_status_internal).state == 2)) {
              id(relay_status).publish_state("Off");
            }
            else if ((id(relay_status_internal).state == 3)) {
              id(relay_status).publish_state("Heating");
            }

esp8266:
  board: esp01_1m

logger:
  baud_rate: 0

uart:
  rx_pin: GPIO3
  tx_pin: GPIO1
  baud_rate: 9600

tuya:

sensor:
  # WiFi Signal Sensor
  - platform: wifi_signal
    name: "${friendly_name} WiFi Status"
    update_interval: 60s
  # Temperature
  - platform: "tuya"
    name: "Temperature"
    sensor_datapoint: 104
    accuracy_decimals: 1
    icon: mdi:thermometer
    unit_of_measurement: "°C"
    filters:
     - multiply: 0.1
  # Relay status
  - platform: "tuya"
    id: "relay_status_internal"
    sensor_datapoint: 115
    internal: true
    on_value:
      then:
        - lambda: |-
            if ((id(relay_status_internal).state == 1)) {
              id(relay_status).publish_state("Cooling");
            }
            else if ((id(relay_status_internal).state == 2)) {
              id(relay_status).publish_state("Off");
            }
            else if ((id(relay_status_internal).state == 3)) {
              id(relay_status).publish_state("Heating");
            }
text_sensor:
  - platform: template
    id: "relay_status"
    name: "Relay Status"
    icon: "mdi:play-pause"
    update_interval: 60s

number:
  # Temperature Calibration
  - platform: "tuya"
    name: "Calibration"
    number_datapoint: 102
    min_value: -15
    max_value: 15
    step: 0.1
    unit_of_measurement: "°C"
    multiply: 10
    icon: mdi:thermometer
  # Temperature Set Point
  - platform: "tuya"
    name: "Temperature Set Point"
    number_datapoint: 106
    min_value: -50.00
    max_value: 99.90
    step: 0.1
    unit_of_measurement: "°C"
    multiply: 10
    icon: mdi:thermometer
  # Compressor Delay Time
  - platform: "tuya"
    name: "Compressor Delay Time"
    number_datapoint: 108
    min_value: 0
    max_value: 10
    step: 1
    unit_of_measurement: "Minutes"
    icon: mdi:clock
  # Alarm High Limit
  - platform: "tuya"
    name: "Alarm High Limit"
    number_datapoint: 109
    min_value: -50.00
    max_value: 99.90
    step: 0.1
    multiply: 10
    icon: mdi:thermometer
  # Alarm Low Limit
  - platform: "tuya"
    name: "Alarm Low Limit"
    number_datapoint: 110
    min_value: -50.00
    max_value: 99.90
    step: 0.1
    multiply: 10
    icon: mdi:thermometer
  # Heating Differential
  - platform: "tuya"
    name: "Heating Differential Value"
    number_datapoint: 117
    min_value: 0.30
    max_value: 15
    step: 0.1
    multiply: 10
    icon: mdi:thermometer
  # Cooling Differential
  - platform: "tuya"
    name: "Cooling Differential Value"
    number_datapoint: 118
    min_value: 0.30
    max_value: 15
    step: 0.1
    multiply: 10
    icon: mdi:thermometer

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

Нагреватель и холодильник не включайте автоматизацией поверх уставки MCU. Две логики сразу короткоциклят компрессор. Задержка компрессора как раз про это.

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

WBR3S прошивают esptool и не получают ответ
Без 3,3 В на RST и EN TYWE3S не входит в запись
Множитель 10 забывают, и уставка 250 отображается как 250 °C вместо 25,0

9. Источники

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