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

Установка приложения, контроллер, привязка, гостевые ключи, автоматизация и безопасность. Версия документа: 2026-05-30.

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

1. Что такое Entrixy

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

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

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

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

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

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

  1. Откройте на телефоне entrixy.com/download/android и нажмите «Скачать APK».
  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 В рядом, а вы хотите открывать удалённо — рассмотрите Internet-вариант. Это альтернативный путь, где контроллер всегда онлайн и не зависит от расстояния до телефона.

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

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

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

Что заполнить (форма разбита на секции):

  1. 1. Выберите вашу плату. Нажмите карточку своей платы (ESP32 DevKit, ESP32-S3 DevKit, ESP32-C3 SuperMini, готовое реле Shelly Plus 1, модуль без обвязки и т.д.) — модель, пины и полярность подставятся автоматически. Дальше можно подправить вручную.
  2. 2. Плата. Модель чипа ESP32 — от неё зависят доступные выводы (пины). Кнопка «Определить подключённый чип» распознаёт плату по USB в Chrome или Edge.
  3. 3. Тип замка. Защёлка — один импульс «Открыть». Бистабильный — два положения (открыть и закрыть отдельными выводами), состояние хранится и видно в приложении.
  4. 4. Пины и полярность. Пин реле «Открыть» — вывод (GPIO), к которому подключён управляющий вход релейного модуля; его контакты NO/COM идут на клеммы «Открыть» привода. Уровень во время импульса и уровень покоя (HIGH/LOW): для большинства готовых модулей и Shelly — импульс LOW, покой HIGH; для прямых транзисторных ключей — наоборот. Длина импульса — типично 500–2000 мс. Ниже: пин кнопки привязки (обычно встроенная BOOT — GPIO0; долгое удержание сбрасывает привязку) и опциональные светодиоды (если их нет — поставьте −1).
  5. 5. Питание и экономия батареи. Параметры BLE-цикла: период цикла вещания (как часто контроллер просыпается — меньше значение = быстрее отклик, больше = экономичнее), длина окна вещания, удержание соединения, окно привязки и сон между циклами (10–20 с — пары батареек AA хватает на месяцы; 0 — не спит, для питания от USB).
  6. 6. Внешние часы (опционально). Модуль RTC (DS3231 / DS1307 / PCF8563) и пины I2C — нужны, только если выдаёте гостям ключи с ограничением по времени. Без него секцию можно пропустить.

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

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

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

Требования:
  • Настольный браузер Chrome, Edge, Opera или Brave версии 89 и выше. Firefox и Safari, а также мобильные браузеры — не поддерживают технологию WebSerial и не подходят.
  • USB-кабель для подключения контроллера к компьютеру.
  • Установленный драйвер USB-COM. Для большинства плат он подтягивается автоматически. Если плата с микросхемой CH340 или CP210x и порт не появляется — установите драйвер от производителя.
  1. Подключите контроллер к компьютеру по USB.
  2. На странице конфигуратора нажмите «Загрузить в контроллер».
  3. Браузер покажет диалог выбора USB-устройства. Выберите ваш контроллер из списка.
  4. На странице появится журнал процесса:
    • Чтение информации о чипе (тип, MAC-адрес).
    • Загрузка прошивки с сервера.
    • Старт записи. Прогресс-бар идёт от 0 до 100%.
    • Перезагрузка контроллера.
  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. Настройки → «Добавить объект» → тип «URL».
  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 Wi-Fi

Открывается при подключении телефона к определённой 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-подписью:

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

Подпись считается так: соберите строку timestamp.nonce.action.object_id и посчитайте HMAC-SHA256(этой строки, webhook_secret), сверьте с присланным signature. Отклоните запрос, если |now − timestamp| больше 300 секунд. Полный формат и тест-вектор — на entrixy.com/webhook.

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

Безопасность: при создании вебхука вы задаёте 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 устаревает за 300 секунд (правило проверяется на целевом сервисе).

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. Обходное решение — держать приложение открытым (не сворачивать) или использовать BLE-привязку и геозоны вместо уведомлений.

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

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

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

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

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

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

Документ обновлён 2026-05-30. Если что-то непонятно или сценарий не описан — напишите на hello@entrixy.com.