OXT, одноканальный диммер

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

Диммер только на яркость, без цвета. Продают как OXT и Smart Best. Похожие корпуса Himojo, HaveDeer, GIRIER и RSH карточка не проверяла, хотя размер тот же: 39,2×39,2×18 мм. Сложность 4/5.

Два чипа. HK32F0301M крутит симистор. Модуль CB3S (BK7231N) шлёт ему яркость. Линия односторонняя: нужен только TX UART, в конфиге GPIO11, 9600. Приём не подключают. Внешний выключатель приходит на GPIO модуля, не на MCU.

Кадр — нули, заголовок, байт 01, байт яркости от 0x00 до 0xFF. Это не стандартный компонент tuya:.

Сеть 220 В на симисторе. Плату вынимают при снятом автомате группы света.

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

• Яркость из Home Assistant, с переходами, которые задаёте вы
• Физический выключатель остаётся на GPIO модуля
• Тайминги не заперты в приложении Tuya

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

• Приложение Tuya диммер не видит
• Совместимость с Himojo и остальными именами не доказана
• Гарантия заканчивается

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

• ltchiptool, плата CB3S
• Карточка с разбором кадра. Обычный light платформы tuya этот протокол не соберёт

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.

Корпус 39 мм вынимают из подрозетника со снятым питанием. CB3S прошивают по его UART загрузчика. Рабочий провод к MCU — один, TX модуля.

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

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

Дальше в карточке не tuya:, а свой вывод кадра яркости. Его копируют оттуда. rx_pin не добавляют: автор пишет, что приём не используется.

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

esphome:
  name: dimmer
  comment: OXT 1-ch dimmer

bk72xx:
  board: cb3s # Using original CB3S module by Tuya, can also be replaced with other pin-compatible

# Disable UART logging - we need UART to talk to dimming MCU
logger:
  baud_rate: 0

uart:
  tx_pin: GPIO11 # rx_pin is not required (not used)
  baud_rate: 9600

light:
  - platform: oxt_dimmer
    id: lamp1
    name: lamp1
    sensing_pin:
      number: GPIO08
      inverted: true
      mode: input_pullup
    min_value: 0
    max_value: 255
    default_transition_length: 1s # tranistions would work!

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

Яркость 0 и «выкл» в этом протоколе могут быть разными кадрами. Проверьте оба на лампе, которая умеет тлеть на минимуме.

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

• Ставят платформу tuya light и не получают отклика: MCU ждёт свой кадр 01 XX
• Добавляют rx_pin и занимают пин, который на плате может быть выключателем
• Журнал на том же UART портит кадры яркости

9. Источники

• Каталог OXT dimmer на devices.esphome.io https://devices.esphome.io/devices/OXT-1ch-dimmer/
• GitHub Исходник карточки https://github.com/esphome/esphome-devices/blob/main/src/docs/devices/OXT-1ch-dimmer/index.md
• Документация ltchiptool https://github.com/libretiny-eu/ltchiptool