ESP-helper

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

Kogan Smart Air Purifier 2S

Kogan, модель KAIRPRFR2SA, KAFLTPRF2SA. 4/5 · пайка. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

Kogan 2S — бытовой очиститель с модулем TYWE1S. Это ESP8266, он только мост к Tuya MCU. В карточке две модели: KAIRPRFR2SA и KAFLTPRF2SA. Скорость линии 9600. Логгер на UART вешать нельзя, в конфиге baud_rate: 0.

Каталог оценку сложности не поставил. Здесь стоит 4/5, потому что первая запись идёт по последовательному порту модуля, как у других TYWE.

Фото площадок в карточке нет, только снимок корпуса. Куда паять, смотрите по шелкографии TYWE1S и по разбору на форуме Home Assistant.

Очиститель Kogan 2S
Kogan Smart Air Purifier 2S снаружи. Площадок модуля в карточке нет. Фото: esphome/devices.esphome.io, GPL-3.0

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

  • Питание (datapoint 1) и скорость (datapoint 4, три ступени: сон, высокая, авто)
  • Таймер: выкл, 4 часа, 8 часов (точка 19) и обратный отсчёт в минутах (точка 20)
  • Яркость индикатора (точка 101)
  • Оценка воздуха (точка 22), по заметке автора только в авторежиме: хорошо, средне, плохо

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

  • Приложение SmarterHome и облако Tuya перестают управлять очистителем
  • Гарантия после разбора обычно заканчивается
  • Неизвестные точки 5 и 11 в карточке не расшифрованы. Фильтр в процентах отсюда не обещан

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

  • USB–UART 3,3 В и доступ к модулю TYWE1S
  • Плата в конфиге esp01_1m
  • Карточка и две темы на форуме Home Assistant, ссылки в источниках

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.

Пошагового разбора в карточке нет. Модуль ищут внутри блока кнопок. Для загрузчика ESP8266 нужны земля, TX, RX и GPIO0 на землю в момент питания. Линию к MCU не перепаивают: она уже на GPIO13 и GPIO15.

Пять вольт на TYWE1S не подают.

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

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

Таймер и яркость — числа number из той же карточки. В теме на форуме есть разбор и доработки, их имеет смысл прочитать до пайки.

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

substitutions:
  name: kogan-air-purifier

esphome:
  name: "${name}"

esp8266:
  board: esp01_1m

logger:
  baud_rate: 0

# Enable Home Assistant API
uart:
  #Serial connection between the TYWE1S and the Tuya MCU
  - id: uart_0
    rx_pin: GPIO13
    tx_pin: GPIO15
    baud_rate: 9600

#Tuya component: https://esphome.io/components/tuya/
tuya:
  uart_id: uart_0

#Tuya Fan: https://esphome.io/components/fan/tuya/
fan:
  - platform: tuya
    name: ${kogan-air-purifier}
    switch_datapoint: 1 #ON, OFF
    speed_datapoint: 4 # 0 = off, 1 = sleep, 2 = high, 3 = auto
    speed_count: 3

number:
  #19 Timer Mode
  - platform: tuya
    name: "${name} Timer Mode"
    number_datapoint: 19 # 0 = off, 1 = 4hr, 2 = 8hr
    min_value: 0
    max_value: 2
    step: 1

  #20 Timer Countdown
  - platform: tuya
    name: "${name} Timer Countdown Mins"
    number_datapoint: 20 #counts down from inital timer mode value of 4hr = 240min or 8hr = 480min
    min_value: 0
    max_value: 480
    step: 1

  #101 LED Brightness
  - platform: tuya
    name: "${name} LED Brightness"
    number_datapoint: 101 #0 = off, 1 = mid, 2 = high
    min_value: 0
    max_value: 2
    step: 1

  #22 Air Quality Level
  - platform: tuya
    name: "${name} Air Quality Level"
    #Only seems to report air quality when in auto mode. 0 = Good, 1 = Yellow/Poor ,2 = Red/Bad
    number_datapoint: 22
    min_value: 0
    max_value: 2
    step: 1
#5 Unknown
# - platform: tuya
# name: "${name} DP5 Unknown" #Unknown. Could be % filter Left?
# number_datapoint: 5
# min_value: 0
# max_value: 200
# step: 1

#11 Unknown
# switch:
# - platform: tuya
# name: "${name} DP11 Unknown" #Unknown. Could maybe be reset button or wifi connection?. Have not tested.
# entity_category: config
# switch_datapoint: 11

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

Вентилятор и оценка воздуха — основные сущности. Таймер точки 19 принимает 0, 1 и 2, а не «часы». Не подписывайте эту сущность как минуты: минуты живут в точке 20.

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

  • Логгер без baud_rate: 0 занимает UART, MCU молчит
  • Качество воздуха в ручном режиме может не обновляться. Автор карточки видел его в авто
  • Точки 5 и 11 не включайте «на пробу»: карточка сама помечает их как неразобранные

9. Источники