❮ Elige un controlador Enlace: BLE (Bluetooth)

Controlador de apertura BLE

Elige un módulo ya hecho o monta un controlador con un par de piezas, ajusta unos pocos parámetros y súbele el programa terminado directamente desde el navegador.

Qué hace el firmware

Un teléfono —el del propietario, o el de un invitado con una llave válida— envía la orden Abrir directamente por Bluetooth cuando estás cerca del controlador. El controlador cierra durante un instante un par de contactos del motor (un segundo por defecto), igual que un botón corriente, y los vuelve a abrir; no conmuta corriente. Para motores y cerraduras biestables puedes activar más abajo un modo con apertura y cierre separados y seguimiento de la posición. La apertura se hace con un toque en la aplicación; también hay apertura automática al acercarte.

Qué hay dentro

El enlace entre el teléfono y el controlador está bien cifrado: no se puede falsificar ni interceptar. No hay nada que configurar, la protección ya viene incorporada. Entre aperturas el controlador duerme y casi no consume.

1. Elija su placa

Primero decide sobre qué montarlo: coge un módulo ya hecho, con el controlador y el relé ya soldados juntos, o móntalo con piezas (una placa ESP32 aparte más un módulo de relé). Toca tu placa y te mostraremos cómo conectarla, mientras los ajustes correctos caen en el formulario de abajo. Al final subes el programa terminado —también llamado firmware— al controlador.

Placas de controlador

ESP32 con relé en una sola placa

Placas listas con el ESP32 y el relé ya soldados juntos: no hace falta un módulo aparte.

Relés Wi-Fi comerciales (sustituir el programa)

Si quieres una carcasa de fábrica bien hecha y un relé certificado, coge un dispositivo comercial y cárgale nuestro programa en lugar del suyo. Por dentro sigue siendo un relé corriente: un par de contactos que se cierran un instante y pulsan el botón de abrir. Un dispositivo así no necesita su propio Wi-Fi: Entrixy habla directamente con el teléfono.

Qué más te hará falta

Estas imágenes no son pulsables: solo muestran qué aspecto tienen los componentes.

Módulo de relé Hace falta cuando la placa no lleva relé. Tres cables van al ESP32: control, alimentación y masa (GND). La salida del relé va al motor

Programador con zócalo En este zócalo se encaja un módulo ESP32 o ESP32-S3 desnudo para poder subirle el programa

Adaptador USB-UART Sirve para subir el programa a las placas de relé y a Shelly: se conecta a unos pocos pines

Los enchufes inteligentes y los interruptores Wi-Fi no sirven aquí. Athom Plug, Shelly Plus Plug S y equipos similares conmutan la tensión de red hacia una carga: no tienen salida seca NO/COM, solo un enchufe. Para mover un motor de portón necesitas un relé Plus 1 o Plus 1PM, o una placa casera con módulo de relé.

Antes de cargar el programa en un dispositivo comercial, comprueba qué pin es cuál. Los fabricantes cambian los pines de sitio de vez en cuando dentro del mismo modelo. Hemos tomado los esquemas de fuentes abiertas y los hemos comprobado en nuestras propias unidades; la tuya puede diferir un poco. Guíate por las marcas de la propia placa.

2. Placa

Placa qué modelo de ESP32: determina los pines disponibles

¿No sabes qué chip tienes? Conecta la placa al ordenador con un cable USB (un módulo desnudo, a través de un programador) y pulsa el botón: el navegador detecta el chip y lo selecciona en la lista de arriba. Funciona en escritorio con Chrome o Edge.

3. Tipo de cerradura

La elección principal: decide cómo se comporta el relé. Impulso: un único pulso de Abrir. Biestable: dos posiciones, con abrir y cerrar en pines distintos; el estado se guarda y se muestra en la aplicación.

Tipo de cerradura

Modo biestable: el controlador recuerda la posición actual (abierto o cerrado) y la conmuta en cada activación. La posición se ve en el icono del objeto en la aplicación, tanto para el propietario como para el invitado. El pin para la orden Cerrar se define más abajo, en el apartado Pines.

4. Pines y polaridad

Relé y cerradura

Pin del relé de apertura (PIN_RELAY) El número de GPIO al que va la entrada de control del módulo de relé. Los contactos del relé (NO/COM) van a los bornes del botón Abrir de tu motor: el controlador los cierra un instante, imitando una pulsación. En modo biestable este es el pin de apertura. Importante: las masas (GND) del controlador y del módulo de relé tienen que ir unidas: sin masa común el relé no funcionará.

Nivel durante el impulso

Nivel en reposo (entre pulsos)

Un pulso HIGH va bien con conmutadores de transistor directos; uno LOW (pulso = LOW, reposo = HIGH) va bien con la mayoría de los módulos de relé comerciales y con Shelly. El nivel en reposo suele ser el contrario del pulso.

Duración del pulso, ms Cuántos milisegundos se mantiene cerrado el contacto en cada activación. Para un botón de Abrir lo típico son 500–2000 ms. Demasiado corto y el motor puede no reaccionar; demasiado largo y hay calentamiento y consumo innecesarios.

Indicadores

LED de apertura (PIN_OPEN_LED) El pin de un LED indicador externo. Se enciende mientras dura el pulso de apertura. Si tu circuito no lleva ese LED, pon -1.

Polaridad del LED de apertura Cómo está conectado el LED. Activo en bajo significa que el cátodo va al pin y el ánodo, por una resistencia, a la alimentación: es lo habitual. Activo en alto es al revés.

LED de estado (integrado) El pin del LED indicador integrado en la placa. Depende del modelo: en el ESP32-S3 suele ser GPIO48, en el ESP32-C3 GPIO8, en el ESP32 clásico (WROOM) GPIO2. El valor por defecto sigue al chip elegido arriba y se puede cambiar. Pon -1 si no hay tal LED.

Polaridad del LED de estado Se enciende con nivel alto o bajo, según la placa. La mayoría de los DevKit son activos en alto.

Botón de emparejamiento

Pin del botón de emparejamiento (PIN_PAIR_BTN) El pin de un botón físico de la placa. Mientras el controlador está sin emparejar, una pulsación corta inicia el emparejamiento con un teléfono. Una pulsación larga devuelve el emparejamiento al estado de fábrica. En la mayoría de las placas es el botón BOOT integrado, GPIO0.

Tiempo de pulsación para el reinicio, ms Cuántos milisegundos hay que mantener pulsado el botón para que se dispare el reinicio del emparejamiento. Como protección frente a descuidos, suelen ser 5000 ms, cinco segundos.

Diagnóstico

Salida de depuración (UART) Un registro técnico al puerto serie, necesario solo mientras depuras. En el ESP32-S3 el puerto ocupa GPIO43 y GPIO44. En funcionamiento normal es mejor desactivarlo: no se escribe registro y esos dos pines quedan libres para el relé.

5. Alimentación y ahorro de batería

Periodo del ciclo de anuncio, ms Con qué frecuencia el controlador despierta y sale al aire: el ciclo completo de anuncio más sueño. Un valor menor hace que el teléfono encuentre antes el dispositivo, pero las pilas se agotan más rápido. Uno mayor ahorra energía a costa de una respuesta algo más lenta.

Duración de la ventana de anuncio, ms Cuántos milisegundos anuncia activamente el controlador en un ciclo antes de dormirse. Debe bastar para que un teléfono pille el dispositivo y se conecte: normalmente 1500–2000 ms.

Mantener la conexión, ms Si un teléfono ha logrado conectarse, el controlador se queda despierto estos milisegundos de más para recibir la orden y responder.

Ventana de emparejamiento, ms Cuánto espera el controlador a un teléfono en modo de emparejamiento antes de dormirse. Noventa segundos sobran incluso para teléfonos lentos.

Sueño entre ciclos, s Cuántos segundos duerme el controlador entre ciclos de anuncio. 0 significa que no duerme nunca, para alimentación de red o USB. Con pilas, el punto dulce está en 10–20 segundos: un par de AA duran meses.

6. Reloj externo (opcional)

Un pequeño módulo de reloj (DS3231, DS1307 o PCF8563) con su propia pila de botón mantiene la hora exacta durante años. Sin él, el reloj interno del controlador se desvía de forma apreciable, alrededor de un 5 % por hora. La hora exacta solo importa si entregas a los invitados llaves con caducidad; si no, sáltate este apartado.

Tipo de RTC externo

Guardar esta configuración

Nombre corto Por ejemplo, «Barrera del patio» o «Portón de la casa de campo». Si has iniciado sesión, va a tu cuenta y está disponible desde cualquier dispositivo. Si no, se guarda en este navegador para que no tengas que configurarlo todo otra vez.

Compilar y subir el programa

El servidor compila el programa (el firmware) exactamente para tus ajustes. Puedes descargar el archivo o subirlo al controlador directamente desde el navegador.

Mantener el emparejamiento con la aplicación (actualizar el firmware sin borrar los ajustes)

Si quieres verlo, retocarlo a mano, descargar .ino o compartir un enlace, pulsa «Abrir en el editor». Es el mismo código fuente que el servidor compiló en .bin.

Lo siguiente: emparejar el controlador en la aplicación

Tras la subida, el controlador espera 90 segundos a un propietario en modo de emparejamiento. Abre la aplicación Entrixy en el papel de propietario → Añadir objeto → BLE — el controlador aparece en la lista, selecciónalo. Si no aparece, pulsa el botón de emparejamiento de la placa: el LED empieza a parpadear y la lista se actualiza. La aplicación intercambia claves y el controlador pasa a ser tuyo. Los detalles están en la guía, apartado «Emparejamiento».

Conexión del relé al motor

Se usan dos contactos del relé: NO (normalmente abierto) y COM (común). Estos dos cables van a los bornes del «botón Abrir» de la placa de control de tu motor.

Motor	Dónde conectar NO/COM
BFT (Phobos, Deimos, Ares)	Bornes `START` o `OPEN` (en el esquema suelen ir numerados 21–22)
CAME (BX, ATI, BK)	Bornes `2–7` (abrir), o PED para una puerta peatonal
NICE (Robus, Run, Spin)	Bornes `1–3` (paso a paso)
FAAC (740, 844, 391)	Bornes `OPEN A` (apertura total)
DoorHan (Sliding, Arm)	Bornes `CMD` + `GND`
Barrera de brazo	La columna con el pulsador de Abrir: en paralelo con sus contactos
Portero (Cyfral, Vizit, Eltis)	El relé en paralelo con el botón de apertura del telefonillo, o directamente en los bornes de la cerradura magnética

Consulta las etiquetas exactas en el manual de tu placa de control. Si la placa ya está cableada y funcionando, localiza los dos cables que vienen de la columna del pulsador de Abrir y conecta el NO/COM del relé en paralelo con ellos.

Subida con esptool (si la vía del navegador falló)

Descarga .bin de arriba.
Instala esptool: pip install esptool
Conecta el ESP por USB.
Grábalo: esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ble.bin
En Windows el puerto suele ser COM3 o COM4.

Acceso al UART en relés Wi-Fi comerciales

Los equipos ya hechos (Shelly Plus 1, Plus 1PM) no tienen USB externo. Hay que abrir la carcasa y conectarse a los pines UART del ESP32 con un adaptador USB-serie: CP2102, CH340 o FTDI, cualquiera vale.

Conexión general

Adaptador USB-serie	ESP32 en la placa
GND	GND
3.3V	3V3 (solo si vas a alimentarlo desde el adaptador; si no, deja el equipo con su propia alimentación)
TX	RX
RX	TX
—	EN (RESET): brevemente a GND para arrancar en el bootloader
—	GPIO0: a GND al alimentar, para entrar en el bootloader

No apliques tensión de red a los bornes de red del equipo mientras el adaptador USB esté conectado. Aliméntalo con los 3,3 V del adaptador o deja la red totalmente desconectada. De lo contrario, las masas de USB y de red pueden quedar a distinto potencial y el puerto USB de tu ordenador se destruirá.

Pinout por modelo

Dispositivo	Dónde está el UART	Entrar en el bootloader
Shelly Plus 1 / Plus 1PM	Dentro de la carcasa, junto al módulo ESP32. Los pads están marcados como `3V3 GND TX RX GPIO0`. Quita la tapa frontal (dos o tres clips); la placa queda arriba.	Une GPIO0 a GND y lleva brevemente EN a GND

Si tu modelo no aparece aquí:

templates.blakadder.com — una base de datos abierta de plantillas de Tasmota con los GPIO de cada modelo. Se traduce a nuestros ajustes así: Relay1 → el pin del relé, Button1 → el pin del botón, Led1 → el LED de estado.
devices.esphome.io — el registro de ESPHome.
Si el modelo no aparece por ninguna parte, echa mano del multímetro: sigue la bobina del relé hasta un GPIO del ESP32. Ese es tu PIN_RELAY.

El BLE solo funciona en el ESP32. Para un ESP8266 (Wemos D1, NodeMCU) o un relé Wi-Fi comercial usa el configurador de internet — allí el enlace va por internet.

Si prefieres no subir tú mismo el programa

Tres opciones para evitarlo:

Constrúyelo tú mismo — coge una placa ESP32 DevKit (unos 5 $) y cualquier módulo de relé de 3,3 V (unos 2 $). Una caja de conexiones hace de carcasa. Se conecta al motor igual que un relé industrial. Es la vía recomendada para la mayoría de los casos caseros.
Un dispositivo por internet — reflashea un relé Wi-Fi comercial con contacto seco (Shelly Plus 1) con nuestro programa en el configurador de internet, o déjale su propio firmware y ábrelo mediante un webhook. Junto al motor hacen falta Wi-Fi y corriente de red.
Firmware ya hecho, listo para usar — Tasmota o ESPHome. En la aplicación creas un objeto de tipo Webhook con la dirección del dispositivo. Te va bien si prefieres no poner nuestro programa en el dispositivo.

Tras pulsar el botón, espera un momento: el archivo suele estar listo en menos de un minuto. Cuando el programa esté compilado, aparecerá un botón de descarga.