ESP-helper

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

Tekkar, привод шторы

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

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

Карточка Tekkar 3rd generation описывает трёхкнопочный привод на модуле CB3S. Зелёный светодиод верхней кнопки — P23, синяя подсветка всех кнопок — P9, красный средней — P26, все инверсные. Кнопки: открыть P10, стоп P7, закрыть P8. Реле открытия P14, реле закрытия P24.

В YAML ход — delay: 16s внутри шаблонной шторы, не отдельное поле time_based. Перед включением одного реле второе явно гасят.

Прошивка: крышку снимают, плату вынимают, на обратной стороне CB3S. Паяют RX1, это P10, TX1, это P11, землю и 3,3 В. ltchiptool запускают и коротко сажают CEN на землю. Автор карточки пишет, что в его экземпляре связь появилась только после выпайки всего модуля. P10 после сборки снова кнопка «открыть», программатор на ней не оставляют.

P10 нельзя одновременно держать на адаптере и считать кнопкой. Сначала прошивка, потом сборка.

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

  • Штора локально, кнопки на клавише остаются
  • Реле разведены проще, чем у LoraTap: открытие это P14, закрытие это P24
  • Модуль CB3S уже есть в списке плат LibreTiny

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

  • 16 секунд из примера не совпадут с вашим карнизом
  • Часть плат не шьётся, пока модуль не выпаян
  • Приложение Tuya больше не ведёт клавишу

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

  • Паяльник, крючков карточка не обещает
  • ltchiptool
  • Снятое напряжение линии

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.

Лицевую крышку снимают, плату вытаскивают. CB3S снизу. CEN на землю коротко, пока ltchiptool ждёт чип.

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

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

Пишут UF2. Плату в конфиге ставят cb3s. После прошивки провода с P10 снимают, иначе кнопка открытия сидит на адаптере.

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

bk72xx:
  board: cb3s

switch:
  - platform: gpio
    id: relay_open
    pin: P14
    restore_mode: always off
  - platform: gpio
    id: relay_close
    pin: P24
    restore_mode: always off

cover:
  - platform: template
    name: Штора
    id: curtain
    optimistic: true
    open_action:
      - switch.turn_off: relay_close
      - switch.turn_on: relay_open
      - delay: 16s
      - switch.turn_off: relay_open
    close_action:
      - switch.turn_off: relay_open
      - switch.turn_on: relay_close
      - delay: 16s
      - switch.turn_off: relay_close
    stop_action:
      - switch.turn_off: relay_open
      - switch.turn_off: relay_close

binary_sensor:
  - platform: gpio
    pin: P10
    filters:
      - invert:
    on_press:
      then:
        - cover.open: curtain
  - platform: gpio
    pin: P7
    filters:
      - invert:
    on_press:
      then:
        - cover.stop: curtain
  - platform: gpio
    pin: P8
    filters:
      - invert:
    on_press:
      then:
        - cover.close: curtain

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

Сущность cover оптимистичная: позиция есть, концевика нет. Время 16 с меняют по факту хода.

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

  • Программатор оставлен на P10
  • CEN не замыкали, чип не входит в запись
  • Время хода не подстроено, мотор упирается и гудит

9. Источники