RCWL-0516 con ESPHome: cableado y configuración

Albert BarnosellEditor y responsable de Tecnoyfoto

Actualizado el 23 de agosto de 2026 · Cableado, GPIO de arranque, configuración ESPHome, montaje y solución de problemas revisados.

El RCWL-0516 es un sensor de movimiento por microondas económico que puede integrarse con ESPHome y Home Assistant. A diferencia de un PIR, no mide cambios de radiación infrarroja: emite una señal de radio de baja potencia y detecta el movimiento mediante el efecto Doppler. Esto permite ocultarlo detrás de plástico, madera fina o cartón, aunque también hace que una mala ubicación provoque detecciones inesperadas.

En esta guía lo conectaremos a un ESP8266 o ESP32 usando un GPIO seguro. El ejemplo antiguo utilizaba GPIO2, uno de los pines que intervienen en el arranque del ESP8266; funciona en algunos montajes, pero no es una elección recomendable para una instalación estable.

Qué detecta realmente el RCWL-0516

El módulo detecta movimiento, no presencia estática. Una persona que permanece completamente quieta puede dejar de detectarse. Para encender una luz al entrar en una habitación es una solución sencilla; para confirmar que alguien sigue sentado en ella conviene un sensor mmWave de presencia diseñado para micromovimientos.

Puede detectar movimiento a través de materiales no metálicos.
El metal bloquea o altera mucho su campo de detección.
Puede atravesar una pared fina y detectar movimiento en la estancia contigua.
Ventiladores, vibraciones, alimentación inestable o varios radares próximos pueden producir falsas activaciones.
La distancia real depende de la placa, la caja, la orientación y el entorno.

Pines y alimentación del módulo

Pin	Función	Conexión recomendada
VIN	Entrada de alimentación	5 V de la placa de desarrollo
GND	Masa	GND común con el ESP
OUT	Salida digital de detección	GPIO4 o GPIO5 en ESP8266; un GPIO libre seguro en ESP32
3V3	Salida del regulador del módulo	No se utiliza para alimentar el RCWL-0516
CDS	Entrada opcional para inhibición por luz	Se deja sin conectar en este tutorial

Las fichas técnicas habituales sitúan la alimentación de VIN aproximadamente entre 4 y 28 V y la salida OUT alrededor de 3,3 V cuando hay movimiento. Las copias del RCWL-0516 no siempre montan exactamente los mismos componentes, por lo que conviene comprobar la serigrafía y medir la salida si la procedencia es dudosa. No apliques 5 V directamente a un GPIO del ESP8266 o ESP32.

Por qué no conviene utilizar GPIO2

En el ESP8266, GPIO0, GPIO2 y GPIO15 determinan el modo de arranque. Para iniciar normalmente, GPIO0 y GPIO2 deben estar altos y GPIO15 bajo. Un periférico conectado a uno de estos pines puede modificar ese estado durante el encendido y dejar la placa sin arrancar.

Para este proyecto utiliza preferiblemente GPIO4 (D2) o GPIO5 (D1) en una Wemos D1 mini o NodeMCU. En ESP32 puedes elegir, por ejemplo, GPIO27, siempre que el pin exista y esté libre en tu modelo concreto. Nuestra guía Wemos D1 mini: pinout y ESPHome explica la diferencia entre el número GPIO y la etiqueta impresa en la placa.

Cableado del RCWL-0516

RCWL VIN → 5V de la placa de desarrollo.
RCWL GND → GND.
RCWL OUT → GPIO4 (D2) en ESP8266, o GPIO27 en el ejemplo ESP32.

Mantén los cables cortos durante la prueba. Coloca un condensador de desacoplo de 100 nF entre VIN y GND cerca del módulo si la alimentación es ruidosa; en montajes problemáticos puede añadirse también uno electrolítico de 10 a 100 µF. No sitúes la antena pegada al ESP, a un plano metálico ni dentro de una caja de metal.

Configuración ESPHome para ESP8266

Añade este bloque a un nodo ESPHome que ya tenga WiFi, API y OTA configurados:

binary_sensor:
  - platform: gpio
    name: "Movimiento radar"
    device_class: motion
    pin:
      number: GPIO4
      mode:
        input: true
    filters:
      - delayed_off: 2s

OUT es una salida digital activa en nivel alto, por lo que normalmente no necesita inverted ni una resistencia pull-up interna. delayed_off evita que una interrupción muy breve genere cambios repetidos; el propio módulo ya mantiene su salida activa durante un tiempo, así que puedes ajustar o eliminar ese filtro según la respuesta real.

Configuración para ESP32

binary_sensor:
  - platform: gpio
    name: "Movimiento radar"
    device_class: motion
    pin:
      number: GPIO27
      mode:
        input: true
    filters:
      - delayed_off: 2s

No copies GPIO27 sin comprobar tu placa: la familia ESP32 incluye modelos con pinouts diferentes. ESPHome avisa de muchos pines de arranque durante la validación; trata ese aviso como una señal para escoger otro GPIO cuando sea posible.

Cómo instalarlo para evitar falsas detecciones

Prueba primero el módulo a la vista y observa la entidad en Home Assistant.
Aléjalo de fuentes de alimentación conmutadas, motores, ventiladores y grandes piezas metálicas.
Orienta la cara de componentes hacia la zona que deseas cubrir.
Comprueba también la habitación situada detrás del sensor: el radar puede atravesar tabiques ligeros.
Solo después de ajustar la posición, monta la caja definitiva.

Una caja de plástico permite ocultarlo, pero no reduce necesariamente su alcance. Si detecta movimiento fuera de la estancia, cambiar la orientación y añadir una pantalla metálica únicamente en el lado que quieres bloquear puede ayudar; deja separación suficiente y vuelve a probar toda la zona.

Solución de problemas

Problema	Qué comprobar
El ESP8266 no arranca	Retira el sensor y cambia GPIO0, GPIO2 o GPIO15 por GPIO4/GPIO5
Siempre aparece movimiento	Alimentación, proximidad al ESP, vibraciones, otro radar o un objeto en movimiento detrás de la pared
No detecta	5 V en VIN, masa común, OUT correcto y orientación del módulo
La entidad cambia demasiado	Aumenta `delayed_off` y mejora la alimentación
El alcance es excesivo	Cambia posición/orientación o apantalla el lado no deseado

RCWL-0516 o PIR

El RCWL-0516 es útil cuando quieres ocultar el sensor o detectar movimiento sin una lente visible. Un PIR suele delimitar mejor la habitación y consume menos. Para presencia estática, ninguno de los dos es equivalente a un radar mmWave de presencia. Elegir bien el sensor evita intentar corregir por software una limitación física.