ESP-helper

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

Inkbird PTH-9CW

Inkbird, модель PTH-9CW, INK-CO2W. 4/5 · пайка. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

PTH-9CW измеряет CO2 (NDIR MH-Z19D или MH-Z19E), температуру и влажность (SHT40). Датчики и экран сидят на Tuya MCU. Радиомодуль — CB3S, Beken. Сложность 4/5. Разбор есть у Dr. Gough.

Внутри стоит 18650, но экономии заряда нет: NDIR меряет постоянно. Для постоянной работы прибор оставляют в розетке. Батарею можно отключить. Конденсатор 100 мкФ на разъём батареи убирает анимацию зарядки на экране, это необязательно.

Пока J30 и J31 разомкнуты, разъём J2 до модуля не доходит. Прошивают проводами на сам CB3S. После записи перемычки запаивают обратно.

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

  • Температура, datapoint 18
  • Влажность, datapoint 19
  • CO2 в ppm, datapoint 2
  • Локальные данные без облака Inkbird

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

  • Тревоги и подсветка экрана по datapoint не меняются. Карточка пишет это прямо
  • Приложение Inkbird датчик не видит
  • Гарантия после вскрытия заканчивается

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

  • Паяльник, чтобы снять и вернуть перемычки J30 и J31
  • ltchiptool и ESPHome с BK72xx, плата cb3s
  • Распиновка CB3S из документации LibreTiny

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.

Корпус вскрывают по разбору Gough. Перемычки J30 и J31 размыкают, провода UART паяют к модулю. Пины CB3S смотрят в docs.libretiny.eu/boards/cb3s. J2 в этот момент бесполезен.

В уже залитой прошивке линия к MCU: приём P10, передача P11, 115200.

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

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

Сенсоры температуры, влажности и CO2 — точки 18, 19 и 2. Единицы и device_class берут из карточки.

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

esphome:
  name: pth-9cw
  friendly_name: PTH-9CW

bk72xx:
  board: cb3s

logger:

uart:
  rx_pin: P10
  tx_pin: P11
  baud_rate: 115200

tuya:

sensor:
  - platform: "tuya"
    name: "Temperature"
    device_class: temperature
    state_class: "measurement"
    sensor_datapoint: 18
  - platform: "tuya"
    name: "Humidity"
    device_class: humidity
    state_class: "measurement"
    unit_of_measurement: "%"
    sensor_datapoint: 19
  - platform: "tuya"
    name: "CO2"
    device_class: carbon_dioxide
    state_class: "measurement"
    unit_of_measurement: "ppm"
    sensor_datapoint: 2
    filters:
      - skip_initial: 3
      - filter_out: 500

select:
  - platform: "tuya"
    name: "Display Unit"
    enum_datapoint: 101
    optimistic: true
    options:
      0: Fahrenheit
      1: Celsius

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

CO2 полезен в автоматизации вентиляции. Порог ставьте по своему датчику после сверки с известным помещением, не по первому числу из лога.

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

  • Прошивка через J2 при разомкнутых J30 и J31 не видит чип
  • Перемычки забывают запаять, и датчик после сборки не поднимает Wi-Fi
  • Скорость 9600 здесь не подходит
  • esptool CB3S не программирует

9. Источники