← Выбор контроллера BLE (Bluetooth Low Energy)

BLE-контроллер открытия

Выберите готовый модуль или соберите контроллер из пары деталей, настройте несколько параметров — и загрузите в него готовую программу прямо из браузера.

Что делает прошивка

Когда телефон владельца (или гостя с действующим ключом) приближается на заданное расстояние, приложение само отправляет команду «Открыть» — и контроллер на короткое время (по умолчанию 1 секунду) замыкает реле, словно вы нажали кнопку «Открыть». Питание он не переключает — просто на миг замыкает пару контактов, как обычная кнопка.

Что внутри

Связь телефона с контроллером надёжно зашифрована — её нельзя подделать или перехватить. Настраивать защиту не нужно, она уже встроена. Между открытиями контроллер спит и почти не тратит энергию.

1. Выберите вашу плату

Сначала решите, на чём будете собирать: взять готовый модуль, где плата и реле уже на одной плате, или собрать из частей (отдельная плата ESP32 + релейный модуль). Нажмите на свою плату — покажем, как её подключить, а нужные настройки сами встанут в форму ниже. В самом конце вы загрузите в контроллер готовую программу (её ещё называют «прошивка»).

Платы-контроллеры

ESP32 с реле на одной плате

Готовые платы, где ESP32 и реле уже распаяны вместе — отдельный модуль не нужен.

Готовые WiFi-реле (заменить программу)

Если хотите аккуратный заводской корпус и сертифицированное реле — возьмите готовое устройство и загрузите в него нашу программу вместо родной. Внутри всё равно обычное реле: пара контактов, которая на миг замыкается и «нажимает» кнопку открытия. Родной WiFi такому устройству не нужен — Entrixy работает с телефоном напрямую.

Что ещё понадобится

Эти картинки не нажимаются — мы просто показываем, как выглядит железо, чтобы вы узнали его в магазине.

Релейный модуль Нужен, если реле нет на плате. К ESP32 идут 3 провода: управление, питание и общий минус «земля» (GND). Выход реле — на привод

Программатор с гнездом Голый модуль ESP32 / ESP32-S3 вставляется в это гнездо, чтобы загрузить в него программу

USB-UART переходник Им заливают программу на платы с реле и на Shelly — подключается к нескольким контактам

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

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

2. Плата

Чип какая у вас плата — от этого зависит, какие выводы (пины) доступны

Не знаете, какой у вас чип? Подключите плату к компьютеру по USB-кабелю (голый модуль — через программатор) и нажмите кнопку — браузер сам определит чип и выставит его в списке выше. Работает на компьютере в Chrome или Edge.

3. Тип замка

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

Тип замка

Бистабильный режим: контроллер запоминает текущее положение (открыто или закрыто) и переключает его при каждом срабатывании. Положение видно в приложении на значке объекта — и владельцу, и гостю. Вывод для команды «Закрыть» задаётся ниже, в секции «Пины».

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

Реле и замок

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

Уровень во время импульса

Уровень покоя (между импульсами)

«Высокий» импульс — для прямых транзисторных ключей; «низкий» (импульс=LOW, покой=HIGH) — для большинства готовых релейных модулей и Shelly. Уровень покоя обычно обратный импульсу.

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

Индикаторы

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

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

Статусный светодиод (встроенный) Вывод встроенного индикаторного светодиода платы. Зависит от модели: ESP32-S3 — обычно GPIO48, ESP32-C3 — GPIO8, классический ESP32 (WROOM) — GPIO2. Значение по умолчанию подставляется под выбранный вверху чип, можно изменить. Поставьте -1, если такого светодиода нет.

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

Кнопка привязки

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

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

Диагностика

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

5. Питание и экономия батареи

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

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

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

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

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

6. Внешние часы (опционально)

Маленький модуль часов (DS3231, DS1307 или PCF8563) со своей батарейкой-таблеткой годами держит точное время. Без него встроенные часы контроллера заметно убегают (примерно 5% в час). Точное время нужно, только если вы выдаёте гостям ключи с ограничением по времени действия — иначе этот раздел можно пропустить.

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

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

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

Готовим и загружаем программу

Сервер соберёт программу (прошивку) именно под ваши настройки. Готовый файл можно скачать или сразу загрузить в контроллер прямо из браузера.

Сохранить привязку к приложению (обновить прошивку, не стирая настройки)

Хотите посмотреть, поправить вручную, скачать .ino или поделиться ссылкой — нажмите «Открыть в редакторе». Это тот же исходник, который сервер собрал в .bin.

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

На реле задействуете два контакта: 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 (если из браузера не получилось)

Скачайте .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-сценариев.
Устройство по WiFi (WebSocket) — поставить Sonoff Mini / Shelly Plus 1 с их родной программой; рядом с приводом нужны WiFi и 220 В. Открыть конфигуратор WiFi-версии или использовать веб-хук через облако.
Готовая программа из коробки — Tasmota или ESPHome. В приложении создаёте объект «Веб-хук» с адресом устройства. Подходит, если совсем не хотите загружать в устройство нашу программу.

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