Qué es el HLK-LD2410
El HLK-LD2410 es un sensor de presencia basado en radar mmWave. A diferencia de un PIR, que detecta principalmente cambios de radiación infrarroja, puede seguir detectando a una persona quieta dentro de su zona de cobertura. Eso lo hace útil para iluminación, climatización y automatizaciones donde un movimiento puntual no basta.
No es un sensor mágico: muebles, paredes, orientación, ventiladores y objetos en movimiento pueden cambiar el resultado. La instalación y la configuración de la distancia importan tanto como el módulo.
Qué necesitas
- Un módulo HLK-LD2410 compatible con la integración elegida.
- Un ESP32 con alimentación estable.
- Cables Dupont o una placa de prototipos.
- ESPHome y Home Assistant.
- Un espacio de prueba sin personas moviéndose continuamente durante la puesta en marcha.
El módulo trabaja con comunicación UART para su configuración y sus lecturas. Comprueba la versión exacta, porque existen variantes con Bluetooth y revisiones con diferencias de conexión. No uses un esquema de otro modelo sin revisar la serigrafía.
Conexión básica con ESP32
La conexión habitual requiere alimentación, masa y dos líneas UART:
| HLK-LD2410 | ESP32 | Función |
|---|---|---|
| VCC | Alimentación compatible | Energía del módulo |
| GND | GND | Referencia común |
| TX | RX del ESP32 | Datos del sensor al microcontrolador |
| RX | TX del ESP32 | Configuración desde el microcontrolador |
Los GPIO concretos dependen de tu placa. Evita los pines de arranque y los que utilice el USB-serie. La alimentación debe seguir la ficha del módulo y las señales UART deben compartir la referencia de masa.
Configuración con ESPHome
ESPHome dispone de componentes para varias versiones de LD2410. Una estructura orientativa es:
uart:
tx_pin: GPIO17
rx_pin: GPIO16
baud_rate: 256000
ld2410:
binary_sensor:
- platform: ld2410
has_target:
name: "Presencia detectada"
has_moving_target:
name: "Movimiento detectado"
has_still_target:
name: "Presencia quieta"Adapta pines, velocidad y nombres a la versión del módulo y de ESPHome. No
copies el valor de baud_rate sin comprobar la documentación de tu componente.
Compila primero, conecta el módulo y revisa el log antes de añadir
automatizaciones.
Presencia frente a movimiento
La diferencia más importante es que el sensor puede exponer estados separados:
- Movimiento: hay desplazamiento dentro de la zona observada.
- Presencia quieta: el radar sigue detectando a una persona aunque apenas se mueva.
- Objetivo: el sensor detecta actividad, pero no identifica quién está allí.
Para una luz de pasillo suele bastar movimiento. Para mantener encendida la luz de un baño mientras alguien permanece quieto, la presencia puede ser más útil. Configura un tiempo de apagado y una condición de salida para evitar cambios rápidos cuando la lectura fluctúa.
Si solo necesitas detectar movimiento, un PIR HC-SR501 es más sencillo y económico.
Ajustar zonas y distancia
Empieza con una distancia conservadora y aumenta poco a poco. Si cubres toda la habitación desde el primer intento, será difícil saber qué pared u objeto genera falsos positivos. Prueba sentado, de pie y fuera de la zona deseada.
No coloques el radar detrás de metal ni apuntando directamente a una zona con ventiladores, cortinas o superficies que se muevan. Documenta la posición y los valores configurados para poder recuperar el montaje.
Errores habituales
- No hay datos: revisa TX/RX, masa, alimentación y velocidad UART.
- Lecturas constantes: comprueba que el módulo tiene su antena libre y que la distancia configurada no es demasiado grande.
- Falsos positivos: reduce zonas, distancia y sensibilidad; aleja el sensor de ventiladores y puertas que vibren.
- ESP32 reiniciándose: utiliza una fuente estable y no alimentes cargas desde un GPIO del microcontrolador.
- No aparece una opción de configuración: la variante del módulo o la versión de ESPHome puede no soportarla todavía.
Privacidad y seguridad
El LD2410 detecta presencia, no identifica rostros ni graba vídeo. Aun así, una automatización que infiere ocupación de una habitación es información sensible. Mantén Home Assistant dentro de la red protegida, usa contraseñas únicas y no expongas su panel directamente a Internet.
Fuentes y siguiente paso
Revisa la documentación del componente LD2410 de ESPHome y la ficha del fabricante antes de fijar pines o límites. Si todavía estás eligiendo placa, consulta ESP32: qué es, para qué sirve y cómo empezar.