Guía del usuario

Instalación de la aplicación, el controlador, el emparejamiento, las llaves de invitado, la automatización y la seguridad. Versión del documento: 30.05.2026.

Contenido
  1. Qué es Entrixy
  2. Instalación de la app
  3. Preparación del controlador
    1. Configurador de firmware
    2. Grabación desde el navegador
    3. Regrabar relés Wi-Fi comerciales
    4. Grabación manual con esptool
  4. Vinculación del controlador con la app
  5. Objetos
    1. Controlador BLE
    2. Número de teléfono
    3. Webhook
  6. Llaves de invitado
  7. Automatización
    1. Geolocalización
    2. Wi-Fi
    3. Hora
    4. BLE
    5. Combinación de reglas
    6. Confirmación de la acción
  8. Webhooks en detalle
    1. Modo app
    2. Modo servidor
  9. Integraciones con el hogar inteligente
  10. La app web para invitados
  11. Seguridad
  12. Preguntas frecuentes y problemas

1. Qué es Entrixy

Entrixy es un sistema para controlar accesos a distancia: barreras, puertas, portones, cerraduras. Hay dos formas de hacerlo:

Cualquier objeto se puede compartir con un invitado —un familiar, un compañero, un repartidor— con límites de plazo, horario o condiciones de geolocalización.

Funciones adicionales:

2. Instalación de la app

La app se distribuye como archivo APK independiente desde el sitio entrixy.com. Todavía no está en las tiendas de aplicaciones.

En un teléfono Android

  1. Abra en su teléfono entrixy.com/download/android y toque "Descargar APK".
  2. Espere a que termine la descarga. Abra el archivo entrixy.apk.
  3. Si el sistema lo pide, permite la instalación desde orígenes desconocidos para tu navegador o gestor de archivos.
  4. Confirme la instalación.
  5. En el primer arranque la aplicación pide permisos. Para qué sirve cada uno:
    PermisoPara qué
    Bluetooth (búsqueda y conexión)Encontrar el controlador cercano y enviar el comando de apertura
    GeolocalizaciónEscenarios de automatización por geozona. Búsqueda BLE en versiones antiguas de Android.
    Ubicación en segundo planoDisparo al acercarte al objeto con la aplicación en segundo plano
    CámaraEscaneo del código QR de una llave de invitado
    NotificacionesAvisos de una llamada entrante o de una acción pendiente de confirmación
    Excluir de la optimización de bateríaPara que el ahorro de energía no cierre el servicio en segundo plano
Un consejo para Samsung y Huawei. Abre Ajustes → Batería → Aplicaciones que nunca se suspenden (o un apartado similar) y añade Entrixy.

Tras la instalación, la aplicación pregunta en qué papel quieres usarla:

3. Preparación del controlador

Si ya tienes un controlador listo con el firmware de fábrica de Entrixy, sáltate este apartado y ve directamente a la vinculación.

Por defecto el controlador trabaja en modo de impulso: cierra durante un instante (0,5–2 segundos) un par de contactos del motor o de la cerradura, igual que si alguien pulsara el botón Abrir.

Para motores y cerraduras que necesitan entradas separadas de apertura y cierre o un estado mantenido existe modo biestable: el controlador conmuta la posición y la recuerda; la aplicación muestra Abierto/Cerrado en lugar de un simple Disparado. El modo se elige al generar el firmware en el configurador.

Como controlador sirve cualquiera de estos:

Los enchufes y los interruptores Wi-Fi no sirven. Athom Plug, Shelly Plus Plug S y equipos similares conmutan la tensión de red hacia una carga y no tienen salida seca NO/COM. Para mover un motor de portón necesitas o bien un relé con contacto seco (Shelly Plus 1), o bien un módulo hecho por ti.
Importante sobre los chips. El control BLE directo solo lo admiten los chips de la familia ESP32 con Bluetooth: ESP32, ESP32-S3, ESP32-C3, ESP32-C6, ESP32-H2. El ESP32-S2 chip y el antiguo ESP8266 no tienen Bluetooth: solo se pueden usar con el firmware Wi-Fi o a través de un webhook.
Cuando la autonomía no es lo importante. Si el motor tiene Wi-Fi y un enchufe cerca y quieres abrirlo a distancia, échale un vistazo a opción por internet. Esa es la vía alternativa: el controlador está siempre en línea y no depende de lo lejos que esté tu teléfono.

Si montas el controlador tú mismo o necesitas firmware para una distribución de pines no estándar, son tres pasos:

3.1 Configurador de firmware

Abra entrixy.com/esp/ble/ — es un formulario con los parámetros del firmware. (El hub entrixy.com/controller/ permite elegir primero entre la opción BLE y la de internet; aquí seguimos la vía BLE.)

Qué rellenar (el formulario está dividido en secciones):

  1. 1. Elija su placa. Toca la tarjeta de tu placa (ESP32 DevKit, ESP32-S3 DevKit, ESP32-C3 SuperMini, un relé Shelly Plus 1 ya montado, un módulo desnudo, etc.): el modelo, los pines y la polaridad se rellenan solos. Después puedes ajustarlos a mano.
  2. 2. Placa. El modelo del chip ESP32: determina qué pines están disponibles. El botón "Detectar el chip conectado" reconoce la placa por USB en Chrome o Edge.
  3. 3. Tipo de cerradura. Pestillo — un solo impulso de apertura. Biestable — dos posiciones (abrir y cerrar en pines distintos); el estado se guarda y se ve en la aplicación.
  4. 4. Pines y polaridad. Pin del relé de apertura — el GPIO al que va la entrada de control del módulo de relé; sus contactos NO/COM se conectan a los bornes Open del motor. Nivel durante el impulso y nivel en reposo (HIGH/LOW): en la mayoría de los módulos comerciales y en Shelly el impulso es LOW y el reposo HIGH; en los conmutadores de transistor directos es al revés. Duración del impulso — normalmente 500–2000 ms. Debajo: el pin del botón de emparejamiento (suele ser el botón BOOT integrado, GPIO0; una pulsación larga borra el emparejamiento) y los LED opcionales (pon −1 si no tienes ninguno).
  5. 5. Alimentación y ahorro de batería. Parámetros del ciclo BLE: periodo del ciclo de anuncio (con qué frecuencia despierta el controlador: un valor menor da respuesta más rápida, uno mayor ahorra energía), duración de la ventana de anuncio, tiempo de retención de la conexión, ventana de vinculación y sueño entre ciclos (10–20 s: un par de pilas AA duran meses; 0 significa sin suspensión, para alimentación por USB).
  6. 6. Reloj externo (opcional). Un módulo RTC (DS3231, DS1307, PCF8563) y los pines I2C: solo hacen falta si entregas a los invitados llaves con caducidad. Sin él puedes saltarte este apartado.

Cuando el formulario esté completo, pulse "Compilar el programa".

3.2 Grabación desde el navegador

La forma más sencilla: sin instalar programas extra.

Requisitos:
  • Chrome, Edge, Opera o Brave de escritorio, versión 89 o posterior. Firefox, Safari y los navegadores móviles no admiten WebSerial y no funcionarán.
  • Un cable USB para conectar el controlador al ordenador.
  • Un controlador USB-COM. En la mayoría de las placas se instala solo. Si la tuya lleva un chip CH340 o CP210x y no aparece ningún puerto, instala el controlador del fabricante.
  1. Conecte el controlador al ordenador por USB.
  2. En el configurador, pulse "Cargar en el controlador".
  3. El navegador muestra un selector de dispositivos USB. Elige tu controlador en la lista.
  4. En la página aparece un registro del proceso:
    • Lectura de los datos del chip (tipo, dirección MAC).
    • Descarga del firmware desde el servidor.
    • Comienza la escritura. La barra avanza del 0 al 100 %.
    • Reinicio del controlador.
  5. Al terminar, el controlador se reinicia solo y arranca con el nuevo firmware.
No desconectes el USB durante la grabación. Si el proceso se interrumpe, el controlador se queda en modo bootloader y hay que volver a grabarlo.

Si algo sale mal:

SíntomaSolución
"WebSerial no es compatible"Abra la página en Chrome o Edge de escritorio
El controlador no aparece en el selector de puertosInstale el controlador USB-COM (CH340, CP210x)
"Failed to connect" tras una larga esperaMantén pulsado el botón BOOT (o IO0) de la placa, pulsa RESET, suelta RESET y después BOOT: así pones el controlador en modo bootloader a mano
"Port is already open"Cierra el IDE de Arduino, PuTTY, MicroPython y cualquier otro programa que ocupe el puerto

3.3 Regrabar relés Wi-Fi comerciales

Los relés Wi-Fi comerciales con contacto seco (Shelly Plus 1, Shelly Plus 1PM) vienen con el firmware del fabricante. Para tener control BLE directo, sin nube y sin depender del Wi-Fi, hay que sobrescribir ese firmware con Entrixy.

Estos equipos están pensados para automatismos de portón y barrera: tienen un par de bornes secos NO/COM que se conectan directamente a los bornes Open de tu motor. La carcasa es compacta, el relé está certificado y, a diferencia de un módulo casero, no necesita caja de conexiones.

Lo que necesitará:

Seguridad. Desconecta el equipo de la red eléctrica antes de abrirlo. Nunca conectes un adaptador USB-serie a un equipo bajo tensión de red: la diferencia de potencial de masa destruirá el puerto USB de tu ordenador.

Pasos:

  1. Abra el configurador entrixy.com/esp/ble/. Elige en el apartado "Relés Wi-Fi comerciales para reflashear" el preajuste que lleva el nombre de tu relé.
  2. Los ajustes de pines se rellenan solos. Proceden de bases de datos abiertas de pinouts (templates.blakadder.com, devices.esphome.io) y están probados en las revisiones más habituales.
  3. En la página del configurador, en el apartado "Acceso al UART en relés Wi-Fi comerciales", busca tu modelo y sigue las instrucciones de conexión.
  4. Conecta el adaptador USB-serie: TX al RX del equipo, RX al TX del equipo, GND a GND. Alimenta el equipo desde los 3,3 V del adaptador, o desde su propia fuente con la red desconectada.
  5. Pon el ESP en modo bootloader (en la mayoría de los equipos, une GPIO0 a GND al alimentarlo).
  6. Pulse "Compilar el programa" y espere a que termine.
  7. Cárgalo con "Subir al controlador" o con esptool desde tu ordenador.
  8. Desconecta todos los cables y cierra la carcasa. Devuélvele al equipo su alimentación de red habitual.
  9. El relé aparece por BLE como un dispositivo a la espera de emparejarse. Empareja según se describe en el apartado 4. Vinculación del controlador.
  10. Conecta los bornes NO/COM del lado de red del equipo en paralelo con el botón Abrir de tu motor (consulta la tabla de bornes típicos en el apartado del configurador "Conexión del relé al motor").

Si su modelo no está entre los preajustes:

  1. Búsquelo en templates.blakadder.com — una base abierta de plantillas de Tasmota.
  2. La plantilla indica los GPIO de los elementos principales: Relay1 = pin del relé, Button1 = pin del botón, Led1 = LED de estado.
  3. Asegúrate de que el equipo tiene bornes de salida NO/COM (contacto seco): sin ellos no puede accionar un motor de portón, solo conmutar corriente a una carga.
  4. Introduce a mano en el formulario del configurador los valores de GPIO que hayas averiguado.

3.4 Grabación manual con esptool

Si WebSerial no funciona (por ejemplo, en un ordenador antiguo o en un móvil), descarga el archivo de firmware y usa la utilidad esptool.

  1. En la página del configurador pulsa "Descargar archivo" y guarda el .bin.
  2. Instale esptool con Python: 
    pip install esptool
  3. Conecte el controlador al ordenador.
  4. Ejecute el comando de grabación: 
    esptool.py --chip auto --port /dev/ttyUSB0 \
  write_flash 0x0 entrixy-ble-XXXX.bin
    En Windows, en lugar de /dev/ttyUSB0 use el puerto COM (por ejemplo COM3). Ponga su propio nombre de archivo. La dirección 0x0 es correcto: nuestro archivo ya contiene el bootloader, la tabla de particiones y la aplicación en una sola imagen combinada.
  5. Cuando termine, desconecta el controlador y vuelve a conectarlo para que arranque el nuevo firmware.

4. Vinculación del controlador con la app

Tras la grabación, el controlador queda a la espera de emparejarse. En ese modo emite durante 90 segundos la señal "esperando propietario". Si nadie se empareja en ese plazo, pasa al modo normal sin propietario.

  1. Abra la app en el rol de propietario.
  2. Vaya a Ajustes → "Añadir objeto" → tipo "BLE".
  3. La app empieza a buscar controladores en modo de vinculación.
  4. Si el controlador ya está en modo de emparejamiento (recién grabado, o con el botón de emparejamiento pulsado hace poco), aparece en la lista. Selecciónalo.
  5. Si no aparece, pulsa el botón de emparejamiento del controlador. El LED empieza a parpadear rápido y la lista de la aplicación se actualiza.
  6. La aplicación realiza un intercambio de claves ECDH. Tarda unos segundos. A partir de ahí el controlador es tuyo: nadie más podrá emparejarse con él hasta que lo reinicies.
  7. Ponle nombre al objeto ("Barrera del patio", "Puerta lateral", "Cerradura del trastero"). Puedes elegir un icono o subir una foto.
Borrado de la vinculación. Para entregar el controlador a otro propietario o volver a emparejarlo, mantén pulsado el botón de emparejamiento más de 5 segundos. El controlador vuelve a su estado de fábrica y entra de nuevo en modo de emparejamiento durante 90 segundos.

5. Objetos

Un objeto es aquello que quieres controlar. Un mismo usuario puede tener varios objetos de tipos distintos: la barrera del patio (un controlador BLE), el número del operador (un teléfono), un relé en la casa inteligente (un webhook).

5.1 Controlador BLE

Se añade desde el apartado "Emparejamiento del controlador" de más arriba. En la pantalla principal aparece como una tarjeta con indicador de estado:

Al tocar la tarjeta se abre el objeto directamente, si tus ajustes de seguridad lo permiten.

5.2 Número de teléfono

Para portones y barreras que se abren llamando a un número.

  1. Ajustes → "Añadir objeto" → tipo "Llamada".
  2. Introduce el número del operador o el del controlador de la barrera.
  3. Configura "Colgar tras N segundos" si quieres una llamada de apertura corta (5–10 segundos) y sin conversación.
  4. Elija cómo se gestiona:
    • Llamada directa — la app marca el número por sí misma.
    • Notificación — los invitados reciben la pregunta "¿abrir?", tú lo confirmas y la llamada sale desde tu teléfono.

5.3 Webhook

Para integrarse con cualquier cosa que acepte órdenes HTTP: una casa inteligente, un relé en tu red Wi-Fi, la API de un portón, IFTTT.

  1. Ajustes → "Añadir objeto" → tipo "URL".
  2. Introduzca la URL del servicio de destino.
  3. Elija el método HTTP: GET, POST, PUT.
  4. Añade cabeceras si hacen falta (Authorization, X-API-Key).
  5. Indique el cuerpo de la petición para POST o PUT.
  6. Elija el modo: app o servidor (detalles en la sección 8. Webhooks).

6. Llaves de invitado

La llave de invitado es una invitación para que otra persona acceda a tus objetos. El invitado usa la misma aplicación Entrixy, solo que en el papel de invitado.

Creación de una llave

  1. En la pantalla principal: Invitados → Crear llave.
  2. Escribe el nombre del destinatario ("Repartidor", "Ana"). Ese nombre lo ves tú en el registro; el invitado ve otro.
  3. Marca los objetos a los que das acceso. Vale cualquier subconjunto de tus objetos.
  4. Configura la automatización de cada objeto que compartes (geozona, horario, zona BLE). Puedes fijar los ajustes para que el invitado no los cambie, u ofrecer valores por defecto que el invitado pueda relajar o endurecer.
  5. Guarde. La llave aparecerá en la lista de invitados.

Entrega de la llave

La tarjeta de la llave ofrece varias formas de hacérsela llegar al destinatario:

Gestión de invitados

En el apartado Invitados están las llaves que has emitido. Con cada una puedes:

El registro de eventos del invitado

Cada apertura hecha por un invitado queda en el registro del propietario con la marca "Invitado: nombre". Funciona incluso si el invitado usó BLE directamente sin red: el evento se guarda en el teléfono del invitado y se envía en cuanto se conecta al servidor.

7. Automatización

Cualquier objeto se puede configurar para dispararse automáticamente según condiciones. Ábrelo desde el menú del objeto → Automatización.

7.1 Geolocalización

Se abre cuando usted se acerca a un punto del mapa.

  1. Coloca el punto en el mapa (pulsa "Usar la actual" si estás junto al objeto).
  2. Fija el radio: la distancia a la que se dispara (lo habitual es 20–50 metros para patios y 100–200 para aparcamientos grandes).
  3. Guarde.

Cómo funciona la activación:

7.2 Wi-Fi

Abre cuando tu teléfono se conecta a una red Wi-Fi concreta. Útil para "cuando estoy en casa, abre el portón al llegar".

  1. Active la regla de Wi-Fi.
  2. Añada una red. La app muestra las disponibles cerca.
  3. Puedes añadir varias redes (por ejemplo, casa y trabajo). Por defecto, cualquier coincidencia lo dispara.

7.3 Hora

Un límite por hora del día y día de la semana. Úsalo para restringir a un invitado ("acceso solo en horario laboral") o como condición en tu propia automatización.

7.4 BLE

Se dispara según la potencia de la señal BLE del controlador. Va bien para cerraduras y barreras donde el GPS es impreciso: en interiores o en un aparcamiento subterráneo.

7.5 Combinación de reglas

Puedes activar varias reglas a la vez y elegir cómo se combinan:

7.6 Confirmación de la acción

Puede exigir una confirmación adicional antes de cada apertura:

Estos ajustes se pueden incrustar en la llave de un invitado: por ejemplo, exigir PIN al invitado, pero no a ti.

8. Webhooks en detalle

Un objeto de tipo webhook funciona en uno de dos modos. Cuál elijas depende de quién deba hacer la petición HTTP: tu teléfono o nuestro servidor.

8.1 Modo app

La petición HTTP la envía la aplicación de tu teléfono. Al dispararse —tú tocas, o un invitado lo pide a través del servidor— el servidor avisa a tu teléfono, y este hace la petición a la dirección de destino.

Cuándo elegirlo:

Limitación: tu teléfono debe estar en línea en ese momento. Si está apagado o sin internet, el webhook no se enviará.

8.2 Modo servidor

Nuestro servidor envía la petición HTTP él mismo, desde su propia dirección IP. Tu teléfono no hace falta en ese momento.

El cuerpo de la petición es JSON con firma HMAC:

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

La firma se calcula así: componga la cadena timestamp.nonce.action.object_id y calcule HMAC-SHA256(esa cadena, webhook_secret), después compárela con la signatureque ha recibido. Rechace la petición si |now − timestamp| tiene más de 300 segundos. El formato completo y un vector de prueba están en entrixy.com/webhook.

Cuándo elegirlo:

Seguridad: al crear el webhook usted define un webhook_secret. Los invitados nunca reciben ese secreto, aunque tengan acceso al objeto. El servidor firma las peticiones con él en tu nombre.

Tiempo de espera: si el servicio de destino no responde en 15 segundos, el servidor cierra la conexión y devuelve un estado de error.

9. Integraciones con la casa inteligente

El directorio /integrations/ del sitio contiene configuraciones listas para las plataformas más populares. Cada una tiene su propio README con esquema de conexión.

PlataformaQué hacer
Home AssistantCopia configuration.yaml del directorio. En Entrixy crea un webhook en modo servidor con la URL https://your-ha/api/webhook/entrixy.
ShellyEn Entrixy crea un webhook en modo aplicación con la URL http://shelly-ip/relay/0?turn=on. Una simple llamada GET: el teléfono hace la petición dentro de tu red doméstica.
TasmotaIgual que con Shelly. URL: http://tasmota-ip/cm?cmnd=Power%20Toggle.
ESPHomeFirmware alternativo para el ESP32 si prefieres el ecosistema ESPHome a nuestro protocolo BLE. En el directorio hay una configuración YAML de ejemplo.
OpenHABParecido a Home Assistant. Acepta peticiones HTTP a través de la API de reglas.
curlUn script de prueba. Acepta nuestro JSON, verifica la firma HMAC e imprime el resultado. Úsalo para depurar.
FlaskUn esqueleto en Python para tu propio servicio. Acepta nuestro JSON y valida la firma.

10. La aplicación web para invitados

Si un invitado no quiere instalar la aplicación de Android, o tiene un iPhone, existe una versión web en entrixy.com/app/.

La aplicación web admite:

La aplicación web no admite:

Para que todo funcione sin límites, al invitado le conviene instalar la aplicación de Android.

11. Seguridad

El enlace con el controlador

El primer emparejamiento usa ECDH X25519. Ambas partes calculan el secreto compartido a la vez: el secreto en sí nunca viaja por el aire.

Cada orden de apertura (FIRE) va firmada con HMAC-SHA256 usando el secreto compartido y un nonce de un solo uso que el controlador emite de antemano. Escuchar el aire no permite repetir la orden: ese nonce ya está gastado.

Acceso de invitado

El invitado no recibe el secreto compartido, sino un token de vida limitada (24 horas por defecto) firmado por el propietario. El controlador comprueba la firma del propietario y la caducidad: incluso un token de invitado filtrado deja de funcionar al expirar.

El token se renueva automáticamente a través del servidor mientras siga en pie el emparejamiento del propietario. En cuanto el propietario revoca la llave, la siguiente renovación falla y el invitado pierde el acceso.

El enlace entre la aplicación y el servidor

Todas las conexiones usan TLS (HTTPS y WSS). Los datos de usuario —números de teléfono, nombres de objetos y de invitados— se guardan en el servidor con cifrado de extremo a extremo, así que ni siquiera el dueño del servidor puede leerlos sin tu clave.

La criptografía se describe en detalle en el documento Arquitectura E2EE.

Webhooks en modo servidor

Las peticiones se firman con HMAC-SHA256. El secreto que fijas en el servidor nunca se entrega a clientes ni a invitados. Quien intercepte una petición no puede repetirla, porque la marca de tiempo caduca a los 300 segundos: una regla que aplica el servicio de destino.

12. Preguntas frecuentes y resolución de problemas

El controlador BLE no se ve

  1. Comprueba que el controlador tiene alimentación. El LED debería parpadear.
  2. Comprueba que el Bluetooth del teléfono está activado.
  3. Si el ahorro de batería está activo, desactívalo para Entrixy.
  4. Acércate al controlador, a un metro o dos: en el límite del alcance la señal puede caer.
  5. Si el controlador está en sueño profundo (deep_sleep_wake_s > 0), no está en el aire todo el rato, solo durante su ventana de vigilia. Espera de 10 a 30 segundos.

Se dispara varias veces seguidas

Lo más probable es que estés justo en el borde de la zona de disparo y la señal fluctúe por interferencias. Qué hacer:

Un invitado dice que la tarjeta está gris y no abre

Comprueba el estado de su llave en tu apartado Invitados. Posibles motivos:

La aplicación se ha cerrado sola

Android mata los servicios en segundo plano con dureza para ahorrar batería. Para evitarlo:

El webhook no llega a Home Assistant

  1. Revisa la URL en los ajustes del webhook. Debe estar completa: con el esquema https:// y el puerto si no es el estándar.
  2. Comprueba que Home Assistant es accesible desde fuera (en modo servidor) o desde tu red doméstica (en modo aplicación).
  3. Mira los registros de Home Assistant en el momento del disparo: debería aparecer una entrada de la petición entrante.
  4. Revisa el cortafuegos de tu router, por si bloquea las conexiones entrantes.

Las notificaciones de llamada no funcionan en Huawei

Las notificaciones push dependen de Google FCM, que en Huawei no está disponible sin los Servicios de Google. Como alternativa, mantén la aplicación abierta en vez de minimizada, o usa el emparejamiento BLE y las geozonas en lugar de las notificaciones.

Cómo actualizar la aplicación

Abre entrixy.com/download/android en el móvil e instala la última versión sobre la actual. Tus datos se conservan.

Cuando una actualización es obligatoria —una corrección crítica de seguridad— la aplicación muestra un diálogo bloqueante al arrancar.

Cómo borrar tu cuenta y todos los datos

Abre la aplicación → Ajustes → Borrar cuenta. Todo lo que hay en el servidor se elimina en 30 días, el plazo estándar indicado en la política de privacidad.

Para un borrado inmediato, envía una solicitud a la dirección de soporte indicada en la Política de privacidad.

Documento actualizado el 30.05.2026. Si algo no queda claro o tu escenario no está cubierto, escribe a hello@entrixy.com.