Руководство пользователя Entrixy

Версия документа: 2026-05-30 · Совместимо с приложением 6.66+.

Содержание
  1. Что такое Entrixy
  2. Установка приложения
  3. Подготовка контроллера
    1. Конфигуратор прошивки
    2. Прошивка через браузер
    3. Перепрошивка готовых ESP32-розеток
    4. Прошивка через esptool вручную
  4. Привязка контроллера к приложению
  5. Объекты
    1. BLE-контроллер
    2. Телефонный номер
    3. Веб-хук
  6. Гостевые ключи
  7. Автоматизация
    1. Геозона
    2. WiFi-сеть
    3. Расписание
    4. BLE-расстояние
    5. Комбинирование правил
    6. Подтверждение действия
  8. Веб-хуки подробно
    1. Режим «приложение»
    2. Режим «сервер»
  9. Интеграции с умным домом
  10. Гостевое веб-приложение
  11. Безопасность
  12. Частые вопросы и неполадки

1. Что такое Entrixy

Entrixy — система удалённого управления объектами доступа: шлагбаум, дверь, ворота, замок. Управление идёт двумя путями:

Любой объект можно расшарить гостю — родственнику, коллеге, курьеру — с лимитом по времени, расписанию или условиям геолокации.

Дополнительные возможности:


2. Установка приложения

Приложение распространяется отдельным APK-файлом с сайта entrixy.com. В магазинах приложений пока нет.

На Android-телефоне

  1. Откройте в браузере телефона entrixy.com и нажмите «Скачать».
  2. Дождитесь загрузки. Откройте скачанный entrixy.apk.
  3. Если система запросит — разрешите установку из неизвестных источников для браузера или файлового менеджера.
  4. Подтвердите установку.
  5. После запуска приложение запросит разрешения. Что и зачем:
    РазрешениеЗачем
    Bluetooth (поиск + подключение)Поиск контроллера в эфире и отправка команды открытия
    ГеолокацияСценарии автоматизации по геозоне. Сканирование BLE на старых версиях Android.
    Фоновая геолокацияСрабатывание при подходе к объекту при свёрнутом приложении
    КамераСканирование QR-кода гостевого ключа
    УведомленияУведомление о входящем вызове или подтверждении действия
    Не оптимизировать аккумуляторЧтобы фоновая служба не была убита системой энергосбережения
Совет для Samsung и Huawei. Откройте «Настройки → Аккумулятор → Не отключающиеся приложения» (или аналогичный пункт) и добавьте Entrixy. Это нужно чтобы система не выгружала фоновую службу из памяти.

После установки приложение спросит, в какой роли вы хотите его использовать:


3. Подготовка контроллера

Если у вас уже есть готовый контроллер с заводской прошивкой Entrixy — раздел можно пропустить и сразу перейти к привязке.

Задача контроллера простая: на короткое время (0.5–2 секунды) замкнуть пару контактов привода или замка, как если бы кто-то нажал кнопку «Открыть».

В качестве контроллера подходит:

Розетки и встроенные WiFi-выключатели не подходят. Athom Plug, Shelly Plus Plug S и им подобные устройства коммутируют 220 В на нагрузку и не имеют сухого NO/COM-выхода. Для управления приводом нужно либо реле с сухим контактом (Shelly Plus 1), либо самосборный модуль.
Важно про чипы. Для прямого BLE-управления подходят только чипы линейки ESP32 с Bluetooth: ESP32, ESP32-S3, ESP32-C3, ESP32-C6, ESP32-H2. Чип ESP32-S2 и старый ESP8266 Bluetooth не имеют — их можно использовать только через WiFi-вариант прошивки или веб-хук.
Если нет смысла в автономности. Если у привода есть WiFi и розетка 220 В рядом, а вы хотите открывать удалённо — рассмотрите WebSocket-вариант прошивки. Это альтернативный путь, где контроллер всегда онлайн и не зависит от расстояния до телефона.

Если контроллер собираете сами или прошивка нужна под нестандартное расположение пинов — действуем в три шага:

3.1 Конфигуратор прошивки

Откройте entrixy.com/esp/ble/. Откроется страница с формой параметров. (Лендинг entrixy.com/esp/ позволяет сначала выбрать между BLE-вариантом и WebSocket-вариантом — мы здесь идём по BLE.)

Что заполнить:

  1. Чип. Выберите модель ESP32 которую используете. Самые распространённые: ESP32-S3 DevKit (рекомендуется для новых проектов), классический ESP32 WROOM, или компактный ESP32-C3.
  2. Пресет. Если у вас типовая плата — нажмите один из готовых пресетов («ESP32-S3 DevKit», «ESP32 WROOM», «Готовая релейная плата»). Параметры подставятся автоматически.
  3. GPIO реле. Номер пина куда подключена катушка реле.
  4. Полярность реле. Для большинства готовых модулей — active-low (катушка тянет от +V к GPIO). Для модулей с прямым подключением транзистора — active-high.
  5. Длительность импульса. Сколько миллисекунд реле должно удерживаться во включённом состоянии. Для типовых шлагбаумов достаточно 500–1000 мс, для замков — 3–5 секунд.
  6. GPIO кнопки сопряжения. Кнопка для входа в режим привязки. Долгое нажатие >5 секунд сбрасывает контроллер.
  7. Светодиоды. Внешний (горит во время импульса реле) и встроенный (статус). Если светодиодов нет — поставьте −1.
  8. Энергопотребление. Параметры BLE-цикла:
  9. Внешний RTC. Если на плате установлены часы реального времени (DS3231 / DS1307 / PCF8563) — укажите тип и пины I2C. Без RTC время синхронизируется по BLE и WiFi.

Когда форма заполнена, нажмите «Скомпилировать прошивку».

3.2 Прошивка через браузер

Самый простой способ — без установки дополнительных программ.

Требования:
  1. Подключите контроллер к компьютеру по USB.
  2. На странице конфигуратора нажмите «Прошить через браузер».
  3. Браузер покажет диалог выбора USB-устройства. Выберите ваш контроллер из списка.
  4. На странице появится журнал процесса:
  5. По завершении контроллер автоматически перезагрузится и начнёт работать с новой прошивкой.
Не отключайте USB во время прошивки. Если процесс прервётся — контроллер останется в bootloader-режиме и потребует повторной прошивки.

Если что-то пошло не так:

СимптомРешение
«WebSerial не поддерживается»Откройте страницу в настольном Chrome или Edge
Контроллер не появляется в диалоге выбора портаУстановите драйвер USB-COM (CH340, CP210x)
«Failed to connect» после долгого ожиданияЗажмите кнопку BOOT (или IO0) на плате, нажмите RESET, отпустите RESET, потом BOOT — это введёт контроллер в режим bootloader вручную
«Port is already open»Закройте Arduino IDE, PuTTY, MicroPython, и другие программы которые занимают порт

3.3 Перепрошивка готовых WiFi-реле

Готовые WiFi-реле с сухим контактом (Shelly Plus 1, Shelly Plus 1PM) приходят с штатной прошивкой производителя. Чтобы получить прямое BLE-управление без облака и без зависимости от WiFi, штатную прошивку нужно перезаписать на Entrixy.

Эти устройства специально спроектированы под автоматику ворот и шлагбаумов: у них есть пара клемм для сухого контакта NO/COM, которая идёт прямо на клеммы «Открыть» вашего привода. Корпус компактный, реле сертифицированное, в отличие от самосбора не нужна коробка распайки.

Что потребуется:

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

Порядок:

  1. Откройте конфигуратор entrixy.com/esp/ble/. Выберите пресет с названием вашего реле в разделе «Готовые WiFi-реле под перепрошивку».
  2. Параметры пинов подставятся автоматически. Они взяты из открытых баз распиновок (templates.blakadder.com, devices.esphome.io) и протестированы на типовых ревизиях.
  3. На странице конфигуратора в разделе «Как добраться до UART на готовых WiFi-реле» найдите вашу модель и следуйте инструкции по подключению.
  4. Подключите USB-Serial адаптер: TX → RX устройства, RX → TX устройства, GND → GND. Питание устройства — от 3.3V адаптера, либо от родного источника при отключённом 220 В.
  5. Введите ESP в режим bootloader (для большинства устройств — замкнуть GPIO0 на GND при подаче питания).
  6. Нажмите «Скомпилировать прошивку», дождитесь готовности.
  7. Прошейте через «Прошить через браузер» или через esptool на компьютере.
  8. Отключите все провода, соберите корпус. Подайте на устройство штатное питание 220 В.
  9. Реле появится в эфире BLE как устройство в режиме ожидания привязки. Привязка — как описано в разделе 4. Привязка контроллера.
  10. Клеммы NO/COM сетевой части устройства подключите параллельно кнопке «Открыть» вашего привода (см. таблицу типовых клемм в разделе конфигуратора «Подключение реле к приводу»).

Если вашей модели нет в пресетах:

  1. Найдите её на templates.blakadder.com — открытая база Tasmota-шаблонов.
  2. В шаблоне будут указаны GPIO для основных элементов: Relay1 = пин реле, Button1 = пин кнопки, Led1 = статусный LED.
  3. Убедитесь что у устройства есть выходные клеммы NO/COM (сухой контакт) — без них для управления приводом оно не подходит, только для коммутации питания через нагрузку.
  4. Подставьте найденные значения GPIO в форму конфигуратора вручную.

3.4 Прошивка через esptool вручную

Если WebSerial не работает (например на старом компьютере или мобильном устройстве), скачайте файл прошивки и используйте утилиту esptool.

  1. На странице конфигуратора нажмите «Скачать .bin». Сохраните файл.
  2. Установите esptool через Python:
    pip install esptool
  3. Подключите контроллер к компьютеру.
  4. Запустите команду прошивки:
    esptool.py --chip auto --port /dev/ttyUSB0 \
      write_flash 0x0 entrixy-ble-XXXX.bin
    Для Windows вместо /dev/ttyUSB0 используйте COM-порт (например COM3). Имя файла подставьте своё. Адрес 0x0 верный — наш файл уже включает bootloader, таблицу разделов и приложение в одном «merged» формате.
  5. После завершения отключите и снова подключите контроллер для запуска новой прошивки.

4. Привязка контроллера к приложению

После прошивки контроллер находится в режиме ожидания привязки. В этом режиме он излучает в эфир сигнал «жду владельца» в течение 90 секунд. Если за это время никто не привязался — уходит в обычный режим без владельца.

  1. Откройте приложение в роли владельца.
  2. Перейдите в Настройки → «Добавить объект» → «BLE-контроллер».
  3. Приложение начнёт поиск контроллеров в режиме привязки.
  4. Если контроллер уже в режиме привязки (только что прошит или недавно нажата кнопка сопряжения) — он появится в списке. Выберите его.
  5. Если не появился — нажмите кнопку сопряжения на контроллере. Светодиод начнёт быстро мигать. Список в приложении обновится.
  6. Приложение выполнит обмен ключами по криптографическому протоколу ECDH. Это занимает несколько секунд. После завершения контроллер становится «вашим» — никто другой не сможет к нему привязаться, пока вы не сбросите его.
  7. Введите название объекта (например «Шлагбаум во двор», «Калитка», «Замок в кладовке»). Можно выбрать иконку или загрузить фото.
Сброс привязки. Если нужно передать контроллер другому владельцу или перепривязать — нажмите кнопку сопряжения на контроллере и удерживайте более 5 секунд. Контроллер вернётся в заводское состояние и снова войдёт в режим привязки на 90 секунд.

5. Объекты

Объект — это то, чем вы хотите управлять. У одного пользователя может быть несколько объектов разных типов: шлагбаум во дворе (BLE-контроллер), номер диспетчера (телефонный номер), реле в умном доме (веб-хук).

5.1 BLE-контроллер

Добавляется через раздел «Привязка контроллера» выше. На главном экране отображается как карточка с индикатором состояния:

Тап по карточке открывает объект напрямую (если разрешено настройками безопасности).

5.2 Телефонный номер

Для шлагбаумов которые открываются звонком на номер.

  1. Настройки → «Добавить объект» → «Телефонный номер».
  2. Введите номер диспетчера или контроллера шлагбаума.
  3. Выберите параметр «Сбрасывать через N секунд» — если нужен короткий звонок-открытие (5–10 секунд) без переговоров.
  4. Выберите режим обработки:

5.3 Веб-хук

Для интеграции с любым устройством которое принимает HTTP-команды: умный дом, реле в WiFi-сети, API ворот, IFTTT.

  1. Настройки → «Добавить объект» → «Веб-хук».
  2. Введите URL целевого сервиса.
  3. Выберите HTTP-метод: GET, POST, PUT.
  4. Добавьте заголовки если требуются (Authorization, X-API-Key).
  5. Укажите тело запроса для POST/PUT.
  6. Выберите режим: «приложение» или «сервер» (подробности в разделе 8. Веб-хуки).

6. Гостевые ключи

Гостевой ключ — это приглашение для другого человека получить доступ к вашим объектам. Гость использует то же приложение Entrixy, только в роли гостя.

Создание ключа

  1. На главном экране → «Гости» → «Создать ключ».
  2. Введите имя получателя (например «Курьер», «Анна»). Имя видно вам в журнале — гость видит другое название.
  3. Отметьте объекты к которым даёте доступ. Можно выбрать любое подмножество ваших объектов.
  4. Настройте автоматизацию для каждого расшаренного объекта (геозона, расписание, BLE-зона). Можно задать жёсткие ограничения «гость не сможет менять» или предложить настройки «по умолчанию» которые гость может ослабить или ужесточить.
  5. Сохраните. Ключ появится в списке гостей.

Передача ключа

На карточке созданного ключа есть несколько способов передать его получателю:

Управление гостями

В разделе «Гости» виден список выданных ключей. По каждому можно:

Журнал событий гостя

Все открытия гостем попадают в общий журнал владельца с пометкой «Гость: имя». Это работает даже когда гость использовал BLE напрямую без сети — событие копится локально на телефоне гостя и передаётся при первом же подключении к серверу.


7. Автоматизация

Каждому объекту можно настроить автоматическое срабатывание по условиям. Открывается из меню объекта → «Автоматизация».

7.1 Геозона

Открывается когда вы подходите к точке на карте.

  1. Установите точку на карте (нажмите «Использовать текущую» если стоите рядом с объектом).
  2. Задайте радиус — минимальное расстояние до точки при котором срабатывает (обычно 20–50 метров для дворов, 100–200 для больших парковок).
  3. Сохраните.

Логика срабатывания:

7.2 WiFi-сеть

Открывается при подключении телефона к определённой WiFi-сети. Удобно для «когда я дома — открой ворота при подъезде».

  1. Включите правило WiFi.
  2. Добавьте сеть. Приложение покажет список доступных рядом.
  3. Можно добавить несколько сетей (например домашняя и рабочая). По умолчанию срабатывает при совпадении любой.

7.3 Расписание

Ограничение по времени дня и дню недели. Можно использовать как ограничение для гостя («доступ только в рабочие часы») или как условие автоматизации владельца.

7.4 BLE-расстояние

Срабатывает по силе BLE-сигнала контроллера. Подходит для замков и шлагбаумов где геолокация GPS неточна (внутри здания, в подземном паркинге).

7.5 Комбинирование правил

Можно включить несколько правил одновременно и выбрать как они объединяются:

7.6 Подтверждение действия

Можно потребовать дополнительное подтверждение перед каждым открытием:

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


8. Веб-хуки подробно

Объект-вебхук работает в одном из двух режимов. Выбор зависит от того, кто должен делать HTTP-запрос: ваш телефон или наш сервер.

8.1 Режим «приложение»

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

Когда выбирать:

Ограничение: ваш телефон должен быть в сети в момент срабатывания. Если телефон выключен или нет интернета — вебхук не уйдёт.

8.2 Режим «сервер»

HTTP-запрос отправляет наш сервер напрямую с своего IP-адреса. Телефон в момент срабатывания не нужен.

Тело запроса всегда JSON, подписан HMAC-SHA256:

{
  "action": "open",
  "object_id": 42,
  "timestamp": 1717075200,
  "nonce": "8f2a1c4b5e6d7f80",
  "signature": "a3b4c5d6e7f8..."
}

Подпись считается так: возьмите JSON без поля signature, посчитайте HMAC-SHA256(body, webhook_secret). Сравните с присланным значением.

Когда выбирать:

Безопасность: при создании вебхука вы задаёте webhook_secret. Гостям этот секрет не передаётся, даже если у них есть доступ к объекту. Сервер сам подписывает запросы вашим секретом.

Таймаут: если целевой сервис не отвечает 15 секунд — сервер закрывает соединение и возвращает статус ошибки.


9. Интеграции с умным домом

В каталоге /integrations/ на сайте лежат готовые конфигурации для популярных платформ. У каждой свой README со схемой подключения.

ПлатформаЧто нужно сделать
Home AssistantСкопировать configuration.yaml из каталога. Создать в Entrixy веб-хук в режиме «сервер» с URL https://ваш-ha/api/webhook/entrixy.
ShellyВ Entrixy создать веб-хук в режиме «приложение» с URL http://shelly-ip/relay/0?turn=on. Прямой вызов GET, телефон делает запрос внутри домашней сети.
TasmotaТо же что Shelly. URL: http://tasmota-ip/cm?cmnd=Power%20Toggle.
ESPHomeАльтернативная прошивка для ESP32 если предпочитаете экосистему ESPHome вместо нашего BLE-протокола. В каталоге пример YAML-конфига.
OpenHABАналог Home Assistant. Принимает HTTP-запросы по API правил.
curlТестовый скрипт. Принимает наш JSON, проверяет HMAC-подпись, печатает результат. Используйте для отладки.
FlaskPython-скелет для своего сервиса. Принимает наш JSON, валидирует подпись.

10. Гостевое веб-приложение

Если гость не хочет устанавливать Android-приложение (или у него iPhone) — можно использовать веб-версию по адресу entrixy.com/app/.

Веб-приложение поддерживает:

Веб-приложение не поддерживает:

Для полной функциональности гостю всё же лучше Android-приложение.


11. Безопасность

Связь с контроллером

Используется криптографический протокол ECDH X25519 при первой привязке. Общий секрет вычисляется обеими сторонами одновременно — в эфире секрет не передаётся.

Каждая команда открытия (FIRE) подписана HMAC-SHA256 с использованием общего секрета и одноразового значения (nonce), которое контроллер выдаёт перед командой. Перехват эфира не позволяет повторить команду — nonce уже использован.

Гостевой доступ

Гостю передаётся не общий секрет, а специальный токен с ограниченным сроком действия (по умолчанию 24 часа). Токен подписан владельцем. Контроллер проверяет подпись хозяина и срок действия — даже если гостевой токен утечёт, после истечения срока он не сработает.

Продление токена идёт автоматически через сервер пока действует привязка владельца. Если владелец отозвал ключ — следующее продление не пройдёт, гость потеряет доступ.

Связь приложения с сервером

Все соединения по TLS (HTTPS и WSS). Пользовательские данные (телефонные номера, имена объектов и гостей) на сервере хранятся в зашифрованном виде с помощью технологии E2EE — даже владелец сервера не может прочитать содержимое без вашего ключа.

Детальная спецификация криптографии описана в документе E2EE архитектура.

Веб-хуки в режиме «сервер»

Запросы подписываются HMAC-SHA256. Указанный вами секрет на сервере не передаётся клиентам и гостям. Если кто-то перехватит запрос — повторить его не сможет, так как timestamp устаревает за 60 секунд (правило проверяется на целевом сервисе).


12. Частые вопросы и неполадки

BLE-контроллер не виден в эфире

  1. Проверьте питание контроллера. Светодиод должен мигать.
  2. Проверьте Bluetooth на телефоне — включён ли.
  3. Если включён режим энергосбережения батареи на телефоне — отключите его для Entrixy.
  4. Подойдите ближе к контроллеру (до 1–2 метров) — на пределе радиуса сигнал может теряться.
  5. Если контроллер настроен на глубокий сон (deep_sleep_wake_s > 0) — он появляется в эфире не постоянно, а только в окне awake. Подождите 10–30 секунд.

Срабатывает несколько раз подряд

Скорее всего вы стоите на границе зоны срабатывания и сигнал «дышит» из-за помех. Решения:

Гость говорит «карточка серая, не открывает»

Проверьте у себя в разделе «Гости» статус его ключа. Возможные причины:

Приложение само закрылось

Android-системы агрессивно выгружают фоновые службы для экономии батареи. Чтобы это не происходило:

Веб-хук не приходит на Home Assistant

  1. Проверьте URL в настройках вебхука. Должен быть полный — со схемой https:// и портом если нестандартный.
  2. Проверьте что Home Assistant доступен извне (если режим «сервер») или из вашей домашней сети (если режим «приложение»).
  3. Откройте логи Home Assistant в момент срабатывания — должна быть запись о входящем запросе.
  4. Проверьте firewall на роутере — не блокирует ли входящие подключения.

На Huawei не работает push-уведомление о звонке

Push-уведомления используют сервис Google FCM, который недоступен на Huawei без Google Services. Обходное решение — оставлять приложение в foreground (не сворачивать) или использовать BLE-привязку и геозоны вместо push.

Как обновить приложение

Открыть entrixy.com на телефоне и скачать свежий APK. Установка поверх существующей версии — данные сохраняются.

В случаях когда обновление обязательно (критический фикс безопасности) — приложение само покажет блокирующий диалог при старте.

Как удалить аккаунт и все данные

Откройте приложение → Настройки → «Удалить аккаунт». Все данные на сервере будут стёрты в течение 30 дней (стандартное время согласно политике приватности).

Для немедленного удаления отправьте запрос на адрес поддержки указанный в Privacy Policy.


Документ обновлён 2026-05-30. Если что-то непонятно или сценарий не описан — пишите в поддержку или открывайте issue в репозитории проекта.