Entrixy — конфигуратор устройства открытия по WiFi

1. Тип устройства

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

микроконтроллер

ESP32 / ESP32-S3 / C3 / C6

Shelly Plus 1, Sonoff Mini R3, платы DevKit. Подключаются к WiFi, программа загружается прямо из браузера.

микроконтроллер

ESP8266

Sonoff Mini R2, Sonoff Basic, Wemos D1 mini, NodeMCU 1.0. Старый дешёвый стек 8266 + BearSSL.

linux-плата

Raspberry Pi (Python)

Pi Zero W / 3 / 4 / 5. Python-скрипт + systemd-сервис. Сетку настраивает ОС, нам только GPIO.

Плата определяет цель компиляции и доступные пины

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

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

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

Собрать самому на ESP32

Розетки и умные выключатели сюда не подходят. Athom Plug, Shelly Plus Plug S и похожие — это розетки, они включают/выключают 220 В на нагрузку, а отдельных «сухих» контактов для кнопки у них нет. Для привода нужно именно реле с парой свободных контактов: Shelly Plus 1, Sonoff Mini или плата ESP32 с релейным модулем.

3. WiFi

SSID сети имя вашего домашнего WiFi (2.4 ГГц, 5 ГГц не поддерживается)

Пароль WPA2/WPA3 пароль сети

Имя сети и пароль записываются прямо в программу устройства. Если потом смените WiFi — нужно будет собрать и загрузить программу заново с новыми данными.

3. Сеть

Raspberry Pi подключается к сети средствами ОС — настройка WiFi или Ethernet идёт через стандартный raspi-config, NetworkManager или /etc/wpa_supplicant/wpa_supplicant.conf. Скрипту WiFi-креды не нужны.

Если ставите впервые — для Pi Zero W удобнее всего прописать SSID и пароль на boot-разделе SD-карты в файле wpa_supplicant.conf. Для Pi 4 / 5 проще через raspi-config nonint do_wifi_country RU и raspi-config nonint do_wifi_ssid_passphrase MyHomeWiFi секрет.

4. Учётные данные устройства

Эти два значения сервер использует для аутентификации вашего устройства. Их нужно зарегистрировать в приложении: Настройки → Устройства → Добавить WebSocket-устройство — приложение сделает запрос на сервер, получит пару и покажет её. Скопируйте сюда.

device_key 32 символа hex (0–9, a–f)

device_secret 32 символа hex (0–9, a–f)

Сгенерированную случайно пару всё равно нужно зарегистрировать на сервере. Без записи в БД сервер не примет устройство и закроет соединение. Поэтому штатный путь — сначала добавить в приложении, скопировать показанные значения, а кнопка генерации сверху нужна для офлайн-сборки прошивки впрок (с известными вам значениями).

5. Реле

Пин реле (PIN_RELAY) выход на катушку реле, NO/COM идут на клеммы «Открыть» привода

Полярность реле

Длина импульса, мс сколько держать реле замкнутым; типично 500–2000 мс для кнопки «Открыть»

6. Светодиоды (опционально)

Можно вывести два индикатора: статус подключения к серверу и срабатывание реле. Если не нужны — оставьте -1.

Пин статусного LED горит когда WiFi+WSS установлены, мигает при потере связи; -1 = нет

Полярность статусного LED

Пин LED «открыто» мигает во время импульса реле; -1 = нет

Полярность LED «открыто»

Тип замка

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

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

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

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

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

Этот исходник уже содержит ваши device_key, device_secret, WiFi-креды (для микроконтроллеров) и пины — те же что зашиты в .bin. Можно вставить в Arduino IDE или редактор на устройстве и собрать вручную.

Установка на Raspberry Pi

После того как скачали сконфигурированный entrixy.py:

Положите файл в /opt/entrixy/entrixy.py на Pi (можно через scp).
Установите зависимости: sudo pip install websockets RPi.GPIO (для Pi 5 используйте gpiod).
Скачайте systemd-сервис: entrixy.service, положите в /etc/systemd/system/.
Включите автозапуск: sudo systemctl enable --now entrixy.
Проверьте: sudo journalctl -u entrixy -f → должно появиться [entrixy] auth OK.

Скрипт сам реконнектится при потере соединения и поднимается после ребута Pi.

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

На выходе устройства задействуете два контакта: 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.

Как добраться до UART на готовых устройствах

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

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

USB-Serial адаптер	Устройство
GND	GND
3.3V	3V3
TX	RX
RX	TX
—	EN/RESET — кратко на GND для ребута в bootloader
—	GPIO0 — на GND во время подачи питания для входа в bootloader

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

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

Устройство	Где UART	Заход в bootloader
Sonoff Mini R2 (ESP8266)	Pad'ы возле модуля внутри корпуса с шёлкографией `3V3 RX TX GND`	Замкнуть GPIO0 на GND, подать питание
Sonoff Mini R3 (ESP32)	USB-C наружу, ничего вскрывать не нужно	Зажать BOOT, кратко RESET, отпустить BOOT
Sonoff Basic (ESP8266)	4 pad'а с шёлкографией `3V3 RX TX GND`	Зажать кнопку, подать питание
Shelly Plus 1 / 1PM (ESP32)	Pad'ы внутри корпуса возле ESP32-модуля	Замкнуть GPIO0 на GND, кратко притянуть EN к GND

Загрузка через esptool (вручную)

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

Устройство открытия по WiFi