Componentes

Radar de presença HLK-LD2410

Um radar mmWave de 24 GHz que distingue uma pessoa em movimento de uma parada, informa a distância de cada uma e coloca OUT em alto enquanto houver alguém.

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

O Hi-Link LD2410 se comunica a 256000 baud, 8N1, lógica de 3,3 V, na placa LD2410C com pinos de 2,54 mm. Apelidos: LD2410, LD2410B, LD2410C, HLK-LD2410, Hi-Link, mmWave, radar de 24 GHz, sensor de presença humana, sensor de ocupação.

Pins

Pin Nome O que faz
1 TX Saída de relatórios e respostas, lógica de 3,3 V.
2 RX Comandos entram, lógica de 3,3 V.
3 OUT Alto (3,3 V) enquanto há alguém, baixo quando não há ninguém.
4 GND Alimentação.
5 VCC Alimentação de 5 V (o manual permite até 12 V).

O relatório

Cerca de dez vezes por segundo o radar envia F4 F3 F2 F1, um comprimento de dois bytes, os dados e F8 F7 F6 F5. Os números são little-endian. Os dados básicos têm 13 bytes: 02 AA, o estado do alvo (0 ninguém, 1 em movimento, 2 parado, 3 ambos), a distância do alvo em movimento em cm (2 bytes) e a energia (0 a 100), a distância e a energia do alvo parado, a distância de detecção (2 bytes) e 55 00. No modo engenharia o tipo é 01 e vêm em seguida a energia de movimento e de repouso de cada portão de distância, 35 bytes no total.

Portões e sensibilidade

O radar divide seu alcance em portões de 0 a 8, cada um com 0,75 m de profundidade (ou 0,2 m). Um alvo conta quando seu portão não está além do portão máximo (8 de fábrica) e sua energia supera a sensibilidade daquele portão. As sensibilidades de fábrica para movimento são 50, 50, 40, 30, 20 e depois 15; as de parado, a partir do portão 2, são 40, 40, 30, 30, 20, 20, 20. Depois que a pessoa sai, o radar continua relatando-a, e mantém OUT em alto, pela duração de ninguém: 5 segundos de fábrica.

Comandos

Cada um é FD FC FB FA, um comprimento, uma palavra de comando de dois bytes, seu valor e 04 03 02 01, e é respondido no mesmo quadro com a palavra mais 0x0100 e um status (0 sucesso). Envie "ativar configuração" (FF 00 01 00) primeiro: o radar ignora qualquer outra coisa até então, e para de relatar até o "encerrar configuração" (FE 00).

Palavra O que faz
0x0060 Portão máximo de movimento e de parado (2 a 8) e a duração de ninguém em segundos.
0x0061 Ler todas as configurações.
0x0062 / 0x0063 Modo engenharia ligado / desligado.
0x0064 A sensibilidade de movimento e de parado de um portão, ou de todos os portões com 0xFFFF.
0x00A0 Versão do firmware.
0x00A1 Taxa de transmissão, de 9600 a 460800, após uma reinicialização.
0x00A2 Configurações de fábrica, após uma reinicialização.
0x00A3 Reiniciar.
0x00AA / 0x00AB Definir / ler a profundidade do portão, 0,75 m ou 0,2 m (definida após uma reinicialização).

As configurações sobrevivem a uma queda de energia; o modo engenharia não.

Propriedades

Propriedade O que é
presence Quem está lá: 0 ninguém, 1 em movimento, 2 parado, 3 ambos.
moving_cm, still_cm A que distância estão a pessoa em movimento e a pessoa parada, de 0 a 1000 cm.
moving_energy, still_energy A energia do sinal delas, de 0 a 100.

Os três controles deslizantes no componente definem os três primeiros enquanto ele roda.

Bibliotecas

ld2410.h (biblioteca ld2410 de ncmreynolds): radar.begin(Serial1), depois radar.read() com a maior frequência possível, e presenceDetected(), movingTargetDetected(), movingTargetDistance(), stationaryTargetDetected() e suas energias. setMaxValues(), setGateSensitivityThreshold(), requestCurrentConfiguration() e as chamadas do modo engenharia enviam os comandos acima. Ou simplesmente leia OUT com digitalRead().

Quais placas conseguem acompanhar

256000 baud é um bit a cada 3,9 microssegundos, rápido demais para a SoftwareSerial. Use uma porta serial de hardware: a Serial1 ou a Serial2 de uma ESP32 (qualquer baud rate, definido exatamente), ou a Serial1 até a Serial3 de uma Mega, em que os 16 MHz geram 250000 baud, 2,3 por cento mais lento, o que o radar ainda lê. Em uma Uno a única porta de hardware é a do monitor serial, então use só a OUT, ou primeiro configure o radar para 9600 baud com o comando 0x00A1.

O que o modelo acerta

Os quadros, os comandos e suas respostas, o modo de configuração, os portões, as sensibilidades e portões máximos, a manutenção do estado de ninguém nos relatórios e em OUT, o modo engenharia, a taxa de transmissão e a profundidade de portão que esperam uma reinicialização e as configurações de fábrica são do manual da Hi-Link (protocolo LD2410C V1.00). A versão do firmware e o endereço MAC são os exemplos do manual.

O que não é modelado

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 baud: ele não consegue acompanhar. Esquecer o comando de ativar configuração, então todos os outros comandos são ignorados. Esperar que OUT caia no momento em que alguém sai: ele espera a duração de ninguém.

Veja em ação

LD2410 presence radar roda o radar na Serial1 de uma Mega com a biblioteca ld2410 e acende o LED a partir de OUT. Abra em /templates.