Entrixy — конфигуратор BLE-контроллера открытия

Мои конфигурации

Наборы настроек, которые вы сохраняли в этом браузере. Выберите нужный — все поля ниже заполнятся автоматически, останется только собрать прошивку. (В дальнейшем такие конфигурации можно будет хранить в аккаунте и делиться ими — без чувствительных данных вроде имени и пароля сети.)

Сохранённые конфигурации Выбор подставит сохранённые значения во все поля формы.

1. Плата

Чип определяет цели компиляции и доступные GPIO

2. Готовые пресеты

Кликните по пресету — параметры подставятся в форму ниже. Дальше можно подправить вручную.

Самосбор: ESP32 + релейный модуль

Это типовой DIY: плата отладки + китайский релейный модуль на 5 В или 3.3 В. Выход реле (NO + COM) идёт прямо на клеммы «Открыть» вашего привода.

Готовые WiFi-реле под перепрошивку

Если хотите промышленный корпус и сертифицированное реле — можно взять готовое и перепрошить. На физическом уровне это всё равно сухой контакт NO/COM, который замыкается на короткое время. WiFi от штатной прошивки не используется — Entrixy BLE работает напрямую с телефоном.

Розетки и WiFi-выключатели сюда не подходят. Athom Plug, Shelly Plus Plug S и им подобные устройства коммутируют 220 В на нагрузку — у них нет сухого NO/COM-выхода, только розетка. Для управления приводом нужно именно реле модели Plus 1 / Plus 1PM или DIY-плата с релейным модулем.

Перед прошивкой готового устройства проверьте распиновку. Производители периодически меняют hardware-ревизии. Распиновки взяты из публичных источников (Tasmota templates, blakadder.com) и протестированы на одной партии — на свежей вашей могут отличаться. Сверьтесь с шёлкографией платы перед прошивкой.

3. Тип замка

Главный выбор — он определяет, как работает реле. Защёлка: один импульс «Открыть». Бистабильный: два положения (открыть/закрыть отдельными пинами), состояние хранится и показывается в приложении.

Тип замка

Бистабильный: прошивка хранит положение в NVS, каждый fire переключает open↔closed, состояние шифрованно идёт в advertise — в приложении на аватаре уголки когда открыто (видят и владелец, и гость через K_state в bundle). Пин «Закрыть» настраивается в секции «Пины» ниже.

4. Пины и полярность

Пин реле «Открыть» (PIN_RELAY) Номер вывода (GPIO), к которому подключён управляющий вход реле или транзисторного ключа. Контакты реле (NO/COM) заводятся на клеммы кнопки «Открыть» вашего привода — контроллер кратко замыкает их, имитируя нажатие. В бистабильном режиме это вывод открытия.

Чем включается реле «Открыть» Каким сигналом срабатывает реле. «Высокий» — для прямых транзисторных ключей. «Низкий» — для большинства готовых релейных модулей и устройств Shelly. Если не уверены и у вас готовый модуль — выбирайте «низкий».

Длина импульса, мс Сколько миллисекунд держать контакт замкнутым за одно срабатывание. Для электромагнитной кнопки или защёлки обычно достаточно 500–1000 мс. Слишком мало — привод может не успеть среагировать; слишком много — лишний нагрев и расход питания.

Отладочный вывод (UART) Технический журнал в последовательный порт — нужен только при отладке. На ESP32-S3 порт занимает выводы GPIO43 и GPIO44. В рабочем режиме отладку лучше выключить: журнал не пишется, а эти два вывода освобождаются — их можно занять под реле.

Пин кнопки привязки (PIN_PAIR_BTN) Вывод физической кнопки на плате. Короткое нажатие, пока контроллер не привязан, запускает привязку к телефону. Долгое удержание сбрасывает привязку к заводскому состоянию. На большинстве плат это встроенная кнопка BOOT — GPIO0.

Длина удержания для сброса, мс Сколько миллисекунд нужно удерживать кнопку, чтобы сработал сброс привязки. Защита от случайного сброса — обычно 5000 мс (пять секунд).

Светодиод «открыто» (PIN_OPEN_LED) Вывод внешнего светодиода-индикатора. Загорается на время импульса открытия. Если такого светодиода в вашей схеме нет — поставьте -1.

Полярность светодиода «открыто» Как подключён светодиод. Active-LOW — катод (минус) на вывод, анод через резистор на питание (частый вариант). Active-HIGH — наоборот.

Статусный светодиод (встроенный) Встроенный в плату светодиод для индикации состояния. Номер зависит от модели: на большинстве плат ESP32-S3 это GPIO48. Поставьте -1, если светодиода нет. Поле ниже — отдельно для плат на чипе ESP32-C3.

Статусный светодиод для ESP32-C3 То же, но для плат на чипе C3 — там встроенный светодиод обычно на GPIO8.

Полярность статусного светодиода Светится при высоком или низком уровне — зависит от платы. На большинстве DevKit — Active-HIGH.

5. Энергетика / BLE-параметры

Период цикла вещания, мс Как часто контроллер просыпается и выходит в эфир (полный цикл «вещание + сон»). Меньше значение — телефон находит устройство быстрее, но батарейки садятся быстрее. Больше — экономнее, отклик чуть медленнее.

Длина окна вещания, мс Сколько миллисекунд контроллер активно вещает за один цикл, прежде чем уснуть. Должно хватать телефону, чтобы поймать устройство и подключиться — обычно 1500–2000 мс.

Удержание соединения, мс Если телефон успел подключиться, контроллер не уходит в сон ещё столько миллисекунд — чтобы принять команду и ответить.

Окно привязки, мс Сколько времени контроллер ждёт телефон в режиме привязки, прежде чем уснуть. 90 секунд с запасом хватает даже медленным телефонам.

Сон между циклами, с Сколько секунд контроллер спит между циклами вещания. 0 — никогда не спит (для питания от блока или USB). 10–20 секунд — оптимально для автономного питания: пары батареек AA хватает на месяцы.

6. Внешний RTC (опционально)

Если есть DS3231/DS1307/PCF8563 — точное время живёт годами через CR2032. Без внешнего RTC контроллер пользуется внутренним RC (drift ~5%/час). Время нужно для проверки окна действия гостевых ключей.

Тип внешнего RTC

Вывод I2C SDA Вывод линии данных I2C, к которому подключён вывод SDA модуля часов. На платах ESP32-S3 по умолчанию обычно GPIO8.

Вывод I2C SCL Вывод тактовой линии I2C, к которому подключён вывод SCL модуля часов. По умолчанию обычно GPIO9.

Сохранить эту конфигурацию

Короткое название Например «Шлагбаум во дворе» или «Калитка на даче». Конфигурация сохранится в этом браузере, чтобы в следующий раз не настраивать всё заново — она появится в списке «Мои конфигурации» вверху.

Сконфигурированный исходник

— Скопировано

Это тот самый .ino, который сервер собрал в .bin. Подсветка синтаксиса, скрол по строкам, корректно работает с кириллицей в комментариях. Можно скопировать кнопкой выше или скачать кнопкой «Скачать .ino» — содержимое идентичное.

Подключение реле к приводу

На реле задействуете два контакта: NO (нормально разомкнут) и COM (общий). Эти два провода идут на клеммы «Кнопка открытия» в плате управления вашего привода.

Привод	Куда подключать NO/COM
BFT (Phobos, Deimos, Ares)	Клеммы `START` или `OPEN` (обычно номера 21–22 в схеме)
CAME (BX, ATI, BK)	Клеммы `2–7` (open) или PED для калитки
NICE (Robus, Run, Spin)	Клеммы `1–3` (step-by-step)
FAAC (740, 844, 391)	Клеммы `OPEN A` (открыть полностью)
DoorHan (Sliding, Arm)	Клеммы `CMD` + `GND`
Шлагбаум барьерного типа	Кнопочный пост «Открыть» — параллельно его контактам
Домофон (Cyfral, Vizit, Eltis)	Реле параллельно кнопке открытия двери (трубка) или прямо на клеммы магнитного замка

Точные обозначения смотрите в инструкции к плате управления. Если плата уже подключена и работает, ищите два провода, которые идут от кнопочного поста «Открыть» — параллельно им и подключаете NO/COM реле.

Как прошивать через esptool (если без WebSerial)

Скачайте .bin сверху.
Установите esptool: pip install esptool
Подключите ESP к USB.
Прошейте: esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ble.bin
На Windows: порт обычно COM3 или COM4.

Как добраться до UART на готовых WiFi-реле

Готовые корпуса (Shelly Plus 1, Plus 1PM) не имеют внешнего USB. Нужно вскрыть корпус и подключиться к UART-пинам ESP32 через USB-to-Serial адаптер (CP2102, CH340, FTDI — любой).

Общая схема подключения

USB-Serial адаптер	ESP32 на плате
GND	GND
3.3V	3V3 (только если планируете питать от адаптера; иначе оставьте включённым штатное питание устройства)
TX	RX
RX	TX
—	EN (RESET) — кратко на GND для ребута в bootloader
—	GPIO0 — на GND во время подачи питания для входа в bootloader

Не подавайте 220 В в сетевые клеммы устройства, пока подключён USB-адаптер. Питание идёт либо через 3.3 В с адаптера, либо оставляйте сетевое полностью отключённым. Иначе земли USB и сети могут различаться по потенциалу — повреждение USB-порта компьютера гарантировано.

Распиновка по моделям

Устройство	Где UART	Заход в bootloader
Shelly Plus 1 / Plus 1PM	Внутри корпуса возле ESP32-модуля. Pad'ы маркированы `3V3 GND TX RX GPIO0`. Снять переднюю крышку (2–3 защёлки), плата лежит сверху.	Замкнуть GPIO0 на GND, кратко притянуть EN к GND

Если ваша модель здесь не указана:

templates.blakadder.com — открытая база Tasmota-шаблонов с GPIO для каждой модели. Конвертируется в наши настройки: Relay1 → пин реле, Button1 → пин кнопки, Led1 → статусный LED.
devices.esphome.io — реестр ESPHome.
Если модели нет нигде — мультиметр: прозвоните катушку реле от GPIO ESP32. Это ваш PIN_RELAY.

Если устройство не основано на ESP32 (например, ESP8266 или Tuya/BK7231) — эта прошивка не подойдёт. Для ESP8266 будет отдельный вариант с WebSocket-прошивкой.

Если перепрошивать не хочется

Есть три безболезненных альтернативы:

Самосбор — взять плату ESP32 DevKit (~5 $) и любой релейный модуль 3.3 В (~2 $). Корпус — коробка распайки. Подключение к приводу как у промышленного реле. Это рекомендуемый вариант для большинства DIY-сценариев.
WebSocket-устройство — поставить Sonoff Mini / Shelly Plus 1 с штатной прошивкой, рядом с приводом нужны WiFi и 220 В. Перейти к конфигуратору WebSocket-прошивки или использовать веб-хук через готовое облако.
Готовая прошивка из коробки — Tasmota / ESPHome с HTTP API. В приложении создаёте объект «Веб-хук» с URL устройства. Подходит когда вы не хотите устанавливать наше ПО на железо.