HLK-LD2450: Integración profunda con ESPHome y Home Assistant

Integración Profunda del HLK-LD2450: Control de Radar de Onda Milimétrica mediante ESPHome y Home Assistant

A pesar de su asequibilidad, el radar de onda milimétrica HLK-LD2450 es un potente sensor de presencia capaz de detectar no solo movimiento, sino también las coordenadas precisas, la velocidad y el ángulo de hasta tres objetivos simultáneamente. Sin embargo, su máximo potencial a menudo permanece sin explotar debido a las limitaciones de las soluciones estándar. Este artículo describe un enfoque para la integración completa del LD2450 en un ecosistema de hogar inteligente utilizando ESPHome y Home Assistant, proporcionando un control profundo sobre todos los parámetros de hardware del radar a través de su protocolo binario, evitando cualquier capa intermedia.

Capacidades y Limitaciones del HLK-LD2450 en Escenarios Estándar

El sensor LD2450 opera a 24 GHz, ofreciendo un rango de detección de 0.5 a 8 metros y un amplio campo de visión horizontal de ±60°. La comunicación se realiza a través de UART a 256000 baudios utilizando un protocolo binario, lo que lo distingue de los dispositivos controlados por comandos AT. Una característica clave del hardware son sus tres zonas configurables, que pueden definirse como rectángulos en milímetros. El radar puede filtrar objetivos de forma autónoma, proporcionando datos solo para aquellos ubicados dentro de estas zonas.

El principal desafío que enfrentan los usuarios al trabajar con el LD2450 "tal cual" es el acceso limitado a sus funciones avanzadas. La mayoría de las soluciones comerciales se centran únicamente en la lectura del flujo de datos, ignorando las capacidades de configuración dinámica. Las zonas de hardware se dejan intactas o se configuran una vez utilizando la herramienta especializada HLK-LD2450_TOOL, que a menudo solo está disponible para Windows. Parámetros cruciales como la sensibilidad, el umbral de energía, el modo de operación (Normal, Alta Sensibilidad, Baja Potencia, Alta Precisión) y el tiempo de retención del objetivo se almacenan en los registros del dispositivo, pero suelen ser inaccesibles para su modificación desde los sistemas de automatización del hogar. Esto reduce significativamente la flexibilidad del sensor en escenarios complejos que requieren respuestas adaptativas a entornos cambiantes.

Objetivos de la Integración Profunda:

Para liberar todo el potencial del LD2450, se formularon los siguientes objetivos clave, que no pueden lograrse con métodos estándar:

Gestión Dinámica de Zonas: La capacidad de cambiar las coordenadas y dimensiones de las zonas de hardware directamente desde Home Assistant. Esto permite adaptar el área de detección para varios escenarios, como el modo nocturno o cuando cambian la disposición de los muebles.
Ajuste Preciso de Sensibilidad: Regulación de la sensibilidad del radar, el umbral de energía, el tiempo de retención del objetivo y el filtro de velocidad para minimizar los falsos positivos y optimizar la detección bajo condiciones específicas.
Cambio de Modo de Operación: Alternar entre los modos Normal, Alta Sensibilidad, Baja Potencia y Alta Precisión para adaptarse a los requisitos de consumo de energía o precisión.
Control de Frecuencia de Actualización: Ajustar la tasa de actualización de datos para equilibrar la capacidad de respuesta y la carga del sistema.
Persistencia de la Configuración: La capacidad de escribir la configuración modificada en la memoria interna del radar para retenerla después de una pérdida de energía.
Monitoreo Multi-Objetivo: Obtener datos en tiempo real para hasta tres objetivos simultáneamente, incluidas sus coordenadas, lo cual es crítico para escenarios complejos de detección de presencia.

Ventajas de un Componente Nativo de ESPHome y Transición a ESP-IDF

Para lograr las capacidades mencionadas, se desarrolló un componente nativo ld2450 para ESPHome. Este enfoque permite la interacción directa con la UART del sensor, enviando comandos binarios y procesando respuestas sin protocolos ni abstracciones intermedias. El acceso directo a los registros proporciona un control completo sobre el dispositivo, transformándolo de una "caja negra" en un sensor totalmente gestionable.

Un aspecto clave para lograr un funcionamiento estable a altas velocidades de UART (256000 baudios) fue la migración del framework de Arduino a ESP-IDF. Aunque conveniente para la creación rápida de prototipos, el framework de Arduino a menudo muestra inestabilidad al trabajar con UART a tales velocidades, lo que lleva a la pérdida de datos o errores de comunicación. La transición a ESP-IDF trajo las siguientes ventajas:

Estabilidad Mejorada de la UART: ESP-IDF garantiza un funcionamiento periférico más fiable y predecible, lo cual es crucial para la transmisión de datos a alta velocidad desde el radar.
Optimización de Recursos: El firmware construido sobre ESP-IDF ocupa menos memoria flash (aproximadamente un 17% menos) y consume menos RAM. Esto libera recursos del ESP32 para otras tareas, mejorando el rendimiento general del sistema.
Preparación para el Futuro: ESPHome está haciendo una transición activa a ESP-IDF por defecto para sus componentes, lo que lo convierte en una elección estratégicamente sólida y garantiza la compatibilidad con futuras actualizaciones de la plataforma.

Análisis Detallado del Protocolo Binario y Gestión de Registros

La interacción con el HLK-LD2450 se realiza enviando comandos binarios específicos. Cada comando tiene una estructura estrictamente definida:

Header: FD FC FB FA
Length: 2 bytes (little-endian)
Command: 2 bytes
Data: N bytes
Footer: 04 03 02 01

Ejemplos de Comandos para la Configuración de Parámetros Clave:

Configuración de Sensibilidad (comando 0x64): Este parámetro permite ajustar la respuesta del radar a la detección de objetos en ocho segmentos de rango diferentes. Un ajuste flexible de la sensibilidad minimiza los falsos positivos y optimiza el rendimiento del sensor según el entorno.

```c

uint8_t cmd_sensitivity[] = {

0xFD, 0xFC, 0xFB, 0xFA,

0x0A, 0x00,

0x64, 0x00,

sens, sens, sens, sens, sens, sens, sens, sens, // 8 sensitivity values

0x04, 0x03, 0x02, 0x01

};

```

Configuración del Umbral de Energía (comando 0x60): El umbral de energía filtra las reflexiones débiles que podrían ser causadas por interferencias menores o objetos muy pequeños. Aumentar este umbral reduce la probabilidad de falsos positivos.

```c

uint8_t cmd_energy[] = {

0xFD, 0xFC, 0xFB, 0xFA,

0x04, 0x00,

0x60, 0x00,

(uint8_t)(energy & 0xFF),

(uint8_t)((energy >> 8) & 0xFF),

0x04, 0x03, 0x02, 0x01

};

```

De manera similar, otros parámetros críticos se configuran a través del protocolo binario:

Tiempo de Retención del Objetivo (comando 0x61): Determina cuánto tiempo el radar informará la presencia de un objetivo después de que este abandone la zona de detección.
Filtro de Velocidad (comando 0x62): Permite ignorar objetos que se mueven por debajo de un umbral especificado, útil para filtrar movimientos lentos e irrelevantes.
Modo de Operación (comando 0x65): Permite alternar entre los modos Normal, Alta Sensibilidad, Baja Potencia y Alta Precisión para optimizar según tareas específicas.
Frecuencia de Actualización (comando 0x66): Establece la frecuencia a la que el radar transmite los datos del objetivo.

Todas estas configuraciones están integradas en Home Assistant y pueden modificarse a través de la interfaz de usuario. Después de realizar cambios, simplemente presione el botón "Escribir Configuración en el Radar" para guardar los nuevos parámetros en la EEPROM del sensor, asegurando que persistan incluso después de un reinicio.

Configuración Avanzada de Zonas de Hardware y Seguimiento Multi-Objetivo

El LD2450 ofrece la capacidad de definir hasta tres zonas de detección de hardware. Cada zona es un rectángulo especificado por coordenadas (X1, Y1, X2, Y2) en milímetros en relación con el sensor, junto con un tiempo de espera de presencia. El radar procesa los datos a nivel de hardware, filtrando los objetivos fuera de las zonas definidas, lo que reduce la carga del microcontrolador y mejora la precisión de la detección.

Ejemplo de Configuración de Zonas en Cascada por Profundidad:

Zona 1 (Cercana): Cubre un área de 2 m × 0.75 m a una profundidad de 250–1000 mm. Ideal para detectar objetos en proximidad cercana.
Zona 2 (Media): Extiende la cobertura a 4 m × 2 m a una profundidad de 1000–3000 mm. Utilizada para un monitoreo más amplio del espacio.
Zona 3 (Lejana): Ocupa 6 m × 3 m a una profundidad de 3000–6000 mm. Permite el monitoreo de áreas distantes.

Las coordenadas y tiempos de espera de las zonas son totalmente configurables a través de Home Assistant como entidades number. Se proporcionan botones para aplicar zonas predeterminadas y para guardarlas, seguido de un reinicio del radar.

Por defecto, el LD2450 solo puede emitir datos para un único objetivo. Para rastrear múltiples objetos, el modo Multi-Objetivo debe activarse con un comando especial. Una vez habilitado, el radar comienza a transmitir información para hasta tres objetivos separados. Es importante tener en cuenta que en el modo Multi-Objetivo, la tasa de actualización de datos está limitada a 10 Hz, y el intervalo mínimo de sondeo del sensor es de 100 ms. La configuración de ESPHome incluye comprobaciones para evitar exceder estos límites cuando el modo Multi-Objetivo está activo.

Para cada objetivo detectado, se proporcionan los siguientes datos:

X, Y: Coordenadas del objetivo en milímetros.
Velocidad: Velocidad de movimiento del objetivo.
Ángulo: Ángulo hacia el objetivo.
Resolución: Resolución de detección.

Todos estos parámetros se transmiten a Home Assistant como sensores individuales, permitiendo un análisis detallado de la posición y el movimiento de los objetos en el espacio.

Visualización y Aplicación Práctica en Home Assistant

La integración con Home Assistant va más allá de la simple configuración. Para una representación clara de los datos, se utiliza una tarjeta Plotly (disponible a través de HACS), que permite visualizar los objetivos detectados como puntos y las zonas configuradas como rectángulos semitransparentes. El área de cobertura del radar se muestra con una línea discontinua, proporcionando una visión general completa del estado actual del sensor. Las actualizaciones de visualización ocurren cada pocos segundos, configurables por el usuario.

Lista de Parámetros Configurables desde Home Assistant:

Sensibilidad del Radar: Rango 0–9.
Umbral de Energía: Rango 100–10000.
Tiempo de Retención del Objetivo: Rango 0–60 segundos.
Filtro de Velocidad: Rango 0–100 cm/s.
Modo de Operación: Normal, Alta Sensibilidad, Baja Potencia, Alta Precisión.
Frecuencia de Actualización: 1–20 Hz (hasta 10 Hz en modo Multi-Objetivo).
Coordenadas y Tiempos de Espera para Tres Zonas.
Modo Multi-Objetivo y Bluetooth Activado/Desactivado (si aplica).

Además, se implementan botones para un control conveniente: "Aplicar Zonas Predeterminadas", "Escribir Configuración en el Radar", "Reiniciar Radar" y "Restablecer de Fábrica". Esto proporciona un control total sobre el sensor a través de la interfaz intuitiva de Home Assistant.

Herramientas Auxiliares e Integración Física

Antes de la instalación final y la conexión a un ESP32, el HLK-LD2450 puede preconfigurarse o probarse utilizando un adaptador USB-UART. La herramienta oficial HLK-LD2450_TOOL está disponible para Windows. Para usuarios de Linux/WSL, se han desarrollado un script connect_radar.sh (utilizando usbipd) y un script de Python radar.py para monitorear el flujo de datos y analizar el protocolo binario. Es importante tener en cuenta que el protocolo de datos utiliza marcadores AA FF, y las coordenadas se transmiten como valores de 16 bits con signo.

Para la integración física del sensor en un proyecto, hay soluciones prefabricadas disponibles. El repositorio del proyecto proporciona archivos STL para la impresión 3D de carcasas y cubiertas, simplificando significativamente la creación de un dispositivo limpio y funcional. Las recomendaciones detalladas de impresión y montaje se pueden encontrar en el archivo README dentro de la carpeta case_stl.

Puntos Clave

Control Completo sobre el HLK-LD2450: El componente nativo de ESPHome permite el control de todos los registros del radar a través del protocolo binario, liberando todo su potencial.
Estabilidad con ESP-IDF: La transición a ESP-IDF es crucial para un funcionamiento fiable de la UART a altas velocidades (256000 baudios), ofreciendo una estabilidad superior y optimización de recursos en comparación con el framework de Arduino.
Zonas de Hardware Dinámicas: La capacidad de configurar y modificar hasta tres zonas de detección de hardware directamente desde Home Assistant mejora significativamente la flexibilidad del sensor en diversos escenarios.
Seguimiento Multi-Objetivo: El radar puede rastrear hasta tres objetivos simultáneamente, proporcionando sus coordenadas precisas, velocidad y ángulo, lo que abre nuevas posibilidades para sistemas complejos de detección de presencia.
Integración Perfecta con Home Assistant: Todos los parámetros y datos del sensor son accesibles y configurables a través de la interfaz de usuario de Home Assistant, incluida la visualización de zonas y objetivos utilizando Plotly.

— Editorial Team