ESP-helper

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

DeskUp Pro, стол с RJ12

SmartHomeGuys, модель DeskUp Pro Controller RJ12. 1/5 · USB, без пайки. Модуль Wi-Fi говорит со вторым микроконтроллером.

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

DeskUp Pro — плата под стоячие столы с портом RJ12, сделанная под ESPHome. Каталог ставит сложность 1/5 и флаг made-for-esphome. Штатные кнопки стола README обещает сохранить.

В common/base.yaml UART 9600: передача ${tx_pin}, по умолчанию GPIO13, комментарий «жёлтый провод, раньше был GPIO1», приём GPIO12, комментарий «красный провод, раньше был GPIO4». Верхний файл deskup-pro-controller.yaml эти пины только показывает закомментированными, чтобы их можно было переопределить.

Кадры к контроллеру стола начинаются с байтов F1 F1. Останов в том же файле — F1 F1 2B 00 2B 7E. Полный набор команд сидит в base.yaml, это около тысячи строк, на странице дан каркас линии.

IKEA Idasen говорит по Bluetooth с колонной LINAK. Этот RJ12-файл к нему не относится.

Контроллер DeskUp Pro сверху
DeskUp Pro. Стол подключают кабелем RJ12, пайка не нужна. Фото: esphome/devices.esphome.io, GPL-3.0

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

  • Высота стола и пресеты в Home Assistant
  • Кнопки на корпусе стола остаются
  • Прошивка по USB, пайка не нужна

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

  • Стол без RJ12 этим контроллером не поднять
  • Пределы высоты в файле по умолчанию от Maidesite TH2 Plus. На другом столе их задают своими
  • Idasen, Upsy Desky и этот контроллер — три разные схемы

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

  • Сам DeskUp Pro и стол с RJ12
  • Кабель USB
  • Репозиторий SmartHomeGuys/DeskUp-Pro-Controller-RJ12 и документация на GitHub Pages

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.

Плату под стол крепят по инструкции производителя, в стол не паяют. RJ12 вставляют в порт стола. Если провода смотрят сами: жёлтый — TX GPIO13, красный — RX GPIO12. Старые заметки с GPIO1 и GPIO4 относятся к прошлой разводке, комментарий в base.yaml это прямо говорит.

DeskUp Pro под столешницей
Так контроллер стоит под столом. UART в прошивке: TX GPIO13 жёлтый, RX GPIO12 красный. Фото: esphome/devices.esphome.io, GPL-3.0

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

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

В Dashboard импортируют пакет по ссылке package_import_url из yaml репозитория. Секреты Wi-Fi свои. Высоту минимума и максимума ставят по наклейке своего стола, не оставляют 62 и 126 от Maidesite, если стол другой.

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

uart:
  - id: uart_bus
    tx_pin: GPIO13  # жёлтый провод
    rx_pin: GPIO12  # красный провод
    baud_rate: 9600

# Остальные кадры F1 F1 и пределы высоты — в common/base.yaml репозитория.
# Этот фрагмент только фиксирует линию. Импорт всего контроллера:
# packages:
#   device_base: github://SmartHomeGuys/DeskUp-Pro-Controller-RJ12/common/base.yaml@main

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

Крышка и кнопки пресетов придут из пакета. Первый ход дайте коротким, пока не упрётесь в механический предел. Команда останова в репозитории уже привязана к логике крышки.

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

  • Файл Idasen или Upsy Desky прошивают в DeskUp
  • Старые пины GPIO1 и GPIO4 оставляют после обновления base.yaml
  • Пределы чужого стола, крышка уезжает в упор

9. Источники