Raspberry Pi — apertura por internet

1. Plataforma

Elige una plataforma: de ella dependen los campos siguientes.

microcontrolador

ESP32 / ESP32-S3 / C3 / C6

Shelly Plus 1 y placas DevKit. Se conectan al Wi-Fi y el programa se sube directamente desde el navegador.

microcontrolador

ESP8266

Wemos D1 mini, NodeMCU 1.0. La opción económica, se conecta por Wi-Fi.

Placa Linux

Raspberry Pi (Python)

Pi Zero W / 3 / 4 / 5. Un script de Python más un servicio de systemd. De la red se encarga el sistema operativo; el programa solo necesita un pin GPIO para el relé.

2. Preajustes listos

Toca un preajuste y sus parámetros caen en el formulario de abajo. Después puedes ajustarlos a mano.

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

Shelly Plus 1 Un relé listo en una carcasa de fábrica bien hecha Shelly Plus 1PM Lo mismo, y además mide el consumo

Móntalo tú mismo sobre un ESP32

ESP32-S3 DevKit Una placa con USB más un módulo de relé aparte ESP32-C3 SuperMini Una placa compacta más un módulo de relé ESP32 con relé integrado Una placa con el relé ya soldado junto al ESP32 ESP32 (módulo WROOM) Sin USB: el programa se sube por USB-UART en los pines RX/TX/GPIO0, y la alimentación y el relé se sueldan ESP32-S3 (módulo) Un módulo S3 sin placa base: la alimentación y el relé se sueldan, y el programa entra por USB o USB-UART

Placas de controlador ESP8266

Los relés Wi-Fi comerciales sobre ESP8266 (Sonoff y similares) no mueven un portón: conmutan tensión de red y no tienen contactos secos. Necesitas una placa sencilla más un módulo de relé aparte (ver «Qué más te hará falta» más abajo): eso es lo que te da un par de contactos libres que actúan como un botón.

Wemos D1 mini Una placa ESP8266 con USB: el programa se sube directamente desde el navegador ESP8266 (módulo ESP-12) Sin USB: el programa se sube por USB-UART en los pines RX/TX/GPIO0, y la alimentación y el relé se sueldan

Raspberry Pi

En una Pi corriente el relé cuelga del GPIO: el mismo módulo de relé que para el ESP (ver «Qué más te hará falta» más abajo). O coge un HAT de relés que se encaja directamente en el conector de la Pi.

Raspberry Pi 4 / 5 La alimentación y la red están en la placa. El relé va en el GPIO Raspberry Pi Zero W Compacta, por Wi-Fi. El relé va en el GPIO Waveshare RPi Relay Board Un HAT de relés que se encaja directamente en el conector GPIO: sin soldar nada

Qué más te hará falta

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

Módulo de relé El mismo para un ESP32, un ESP8266 o una Raspberry Pi: cualquier placa sin relé integrado. Tres cables al controlador: control, alimentación y masa (GND). La salida del relé va al motor

Adaptador USB-UART Hace falta cuando no hay USB propio: equipos Shelly ya hechos y módulos ESP32/ESP8266 desnudos. Las placas con USB (DevKit, Wemos) no lo necesitan

3. WiFi

El nombre de la red y la contraseña se escriben en el programa del dispositivo. Si más adelante cambias de Wi-Fi, tendrás que recompilar y subir el programa con los datos nuevos.

3. Red

Una Raspberry Pi se conecta a la red a través del sistema operativo: el Wi-Fi o la Ethernet se configuran con el habitual raspi-config, NetworkManager o /etc/wpa_supplicant/wpa_supplicant.conf. El script en sí no necesita credenciales de Wi-Fi.

¿Es tu primera vez configurando uno? En una Pi Zero W lo más fácil es poner el SSID y la contraseña en la partición de arranque de la tarjeta SD, en el archivo wpa_supplicant.conf. En una Pi 4 o 5 es más sencillo con raspi-config nonint do_wifi_country RU y raspi-config nonint do_wifi_ssid_passphrase MyHomeWiFi secret.

4. Credenciales del dispositivo

En la aplicación añade un objeto de tipo «Dispositivo» — una vez registrado, la aplicación muestra el código del dispositivo. Pégalo en el campo de abajo: el firmware lo usa para conectarse al servidor.

5. Relé

6. LED (opcional)

Puedes gobernar dos indicadores: el estado de la conexión con el servidor y la actividad del relé. Déjalos en -1 si no los necesitas.

Guardar esta configuración

Vincular con la aplicación

En la aplicación abre el objeto Dispositivo → «Vincular con la aplicación», copia el código (empieza por ENTX-BIND:), pégalo abajo y pulsa «Escribir en el controlador». A partir de ahí el controlador solo abre con una orden de tu aplicación: el secreto le llega por USB, sin pasar por la red ni por el servidor.

El controlador ya debe estar grabado y conectado por USB. Si la aplicación ha vuelto a emitir la clave, repite la vinculación con el código nuevo.

Instalación en una Raspberry Pi

Una vez que hayas descargado el entrixy.py:

1. Pon el archivo en /opt/entrixy/entrixy.py en la Pi (puedes usar scp).
2. Instala las dependencias: sudo pip install websockets RPi.GPIO (en una Pi 5 usa gpiod).
3. Descarga el servicio de systemd: entrixy.service, ponlo en /etc/systemd/system/.
4. Actívalo en el arranque: sudo systemctl enable --now entrixy.
5. Compruébalo: sudo journalctl -u entrixy -f → deberías ver [entrixy] auth OK.

El script se reconecta solo cuando se cae el enlace y vuelve tras reiniciar la Pi.

Conexión del relé al motor

Se usan dos contactos de la salida del dispositivo: 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.

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 NO/COM en paralelo con ellos.

Acceso al UART en relés Wi-Fi comerciales

El equipo Shelly Plus 1 ya hecho no tiene USB externo. Hay que abrir la carcasa y conectarse a los pines UART con un adaptador USB-serie: CP2102, CH340 o FTDI, cualquiera vale.

Conexión general

Pinout por modelo

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

1. Descarga .bin de arriba.
2. Instala esptool: pip install esptool
3. Conecta el dispositivo al USB o a un adaptador USB-serie.
4. Grábalo:
   esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ws.bin
5. En Windows el puerto suele ser COM3 o COM4.