Componentes

Radar de presencia HLK-LD2410

Un radar de ondas milimétricas de 24 GHz que distingue a una persona en movimiento de una quieta, reporta a qué distancia está cada una y pone OUT en alto mientras hay alguien.

This part has a page of its own, with a note on using it and a circuit to try: the part page.

El Hi-Link LD2410 se comunica a 256000 baudios, 8N1, lógica de 3.3 V, en la placa LD2410C con pines a 2.54 mm. Alias: LD2410, LD2410B, LD2410C, HLK-LD2410, Hi-Link, mmWave, radar de 24 GHz, sensor de presencia humana, sensor de ocupación.

Pins

Pin Nombre Qué hace
1 TX Salida de reportes y respuestas, lógica de 3.3 V.
2 RX Comandos de entrada, lógica de 3.3 V.
3 OUT Alto (3.3 V) mientras hay alguien, bajo cuando no hay nadie.
4 GND Tierra.
5 VCC Alimentación de 5 V (el manual permite hasta 12 V).

El reporte

Unas diez veces por segundo el radar envía F4 F3 F2 F1, una longitud de dos bytes, los datos y F8 F7 F6 F5. Los números están en little-endian. Los datos básicos son 13 bytes: 02 AA, el estado del objetivo (0 nadie, 1 en movimiento, 2 quieto, 3 ambos), la distancia en cm del objetivo en movimiento (2 bytes) y su energía (0 a 100), la distancia y la energía del objetivo quieto, la distancia de detección (2 bytes) y 55 00. En modo ingeniería el tipo es 01 y a continuación va la energía en movimiento y quieto de cada puerta de distancia, 35 bytes en total.

Puertas y sensibilidad

El radar divide su rango en puertas 0 a 8, cada una de 0.75 m de profundidad (o 0.2 m). Un objetivo cuenta cuando su puerta no está más lejos que la puerta máxima (8 de fábrica) y su energía supera la sensibilidad de esa puerta. Las sensibilidades de fábrica para movimiento son 50, 50, 40, 30, 20 y luego 15; las de quieto desde la puerta 2 son 40, 40, 30, 30, 20, 20, 20. Después de que la persona se va, el radar sigue reportándola, y mantiene OUT en alto, durante la duración de ausencia: 5 segundos de fábrica.

Comandos

Cada uno es FD FC FB FA, una longitud, una palabra de comando de dos bytes, su valor y 04 03 02 01, y se responde en el mismo cuadro con la palabra más 0x0100 y un estado (0 éxito). Envía primero "habilitar configuración" (FF 00 01 00): el radar ignora cualquier otra cosa hasta entonces, y deja de reportar hasta "terminar configuración" (FE 00).

Palabra Qué hace
0x0060 Puerta máxima para movimiento y para quietud (2 a 8) y la duración de ausencia en segundos.
0x0061 Lee todas las configuraciones.
0x0062 / 0x0063 Modo ingeniería activado / desactivado.
0x0064 La sensibilidad en movimiento y quieta de una puerta, o de todas las puertas con 0xFFFF.
0x00A0 Versión del firmware.
0x00A1 Velocidad en baudios, de 9600 a 460800, tras un reinicio.
0x00A2 Configuración de fábrica, tras un reinicio.
0x00A3 Reinicio.
0x00AA / 0x00AB Fija / lee la profundidad de las puertas, 0.75 m o 0.2 m (se fija tras un reinicio).

Las configuraciones sobreviven a un corte de energía; el modo ingeniería no.

Propiedades

Propiedad Qué es
presence Quién está ahí: 0 nadie, 1 en movimiento, 2 quieto, 3 ambos.
moving_cm, still_cm A qué distancia están la persona en movimiento y la quieta, 0 a 1000 cm.
moving_energy, still_energy Su energía de señal, 0 a 100.

Los tres controles deslizantes del componente fijan los tres primeros mientras se ejecuta.

Bibliotecas

ld2410.h (biblioteca ld2410 de ncmreynolds): radar.begin(Serial1), luego radar.read() tan seguido como puedas, y presenceDetected(), movingTargetDetected(), movingTargetDistance(), stationaryTargetDetected() y sus energías. setMaxValues(), setGateSensitivityThreshold(), requestCurrentConfiguration() y las llamadas del modo ingeniería envían los comandos anteriores. O simplemente lee OUT con digitalRead().

Qué placas pueden seguirlo

256000 baudios es un bit cada 3.9 microsegundos, demasiado rápido para SoftwareSerial. Usa un puerto serie de hardware: el Serial1 o Serial2 de un ESP32 (cualquier velocidad, fijada con exactitud), o el Serial1 al Serial3 de una Mega, donde 16 MHz produce 250000 baudios, 2.3 por ciento lento, que el radar todavía lee. En una Uno el único puerto de hardware es del monitor serie, así que usa solo OUT, o pon primero el radar a 9600 baudios con el comando 0x00A1.

Lo que el modelo hace bien

Las tramas, los comandos y sus respuestas, el modo de configuración, las puertas, las sensibilidades y puertas máximas, la retención de ausencia en los reportes y en OUT, el modo ingeniería, la velocidad en baudios y la profundidad de puertas que esperan un reinicio, y la configuración de fábrica son del manual de Hi-Link (protocolo LD2410C V1.00). La versión del firmware y la dirección MAC son los ejemplos del manual.

Lo que no modela

There is no radio: the energies are what is set, and the distances hold still where a real radar's wander. The manual gives no report rate, answer time or restart time, so the model reports every 100 ms, answers in 10 ms and restarts in 1 second. Bluetooth commands are answered but nothing goes over the air. The still sensitivity of gates 0 and 1 cannot be set, as on the real radar; here it reads 0, so a still person that close is always seen.

Common mistakes

Usar SoftwareSerial a 256000 baudios: no puede seguir el ritmo. Olvidar el comando de habilitar configuración, así que todos los demás comandos se ignoran. Esperar que OUT baje en el momento en que alguien se va: espera la duración de ausencia.

Véelo en acción

LD2410 presence radar ejecuta el radar en el Serial1 de una Mega con la biblioteca ld2410 y enciende el LED desde OUT. Ábrelo en /templates.