Zwykła czujka PIR wykrywa, że ktoś wszedł do pokoju, ale nie widzi osoby, która siedzi przy biurku albo czyta na kanapie, więc po kilku minutach światło gaśnie. Radar mmWave wykrywa też kogoś, kto się nie rusza, bo wystarcza mu oddech i drobne ruchy ciała.
Zrobiłem więc czujnik na ścianę, który ma w jednej obudowie radar HLK-LD2410C, M5Stack ENV III (temperatura, wilgotność i ciśnienie) i M5Stack ATOM Lite, czyli ESP32. Wisi na puszce elektrycznej i łączy się z Home Assistant przez ESPHome.

Obudowa
Radar siedzi w drukowanej kuli Ø46 mm, którą da się obrócić palcami o 25° w każdą stronę, więc czujnik powieszony przy drzwiach można wycelować w kanapę albo w biurko. Całość ma 60 × 107 × 38 mm, a głowica wystaje 10 mm przed front.
Kabel USB-C wchodzi od strony ściany i wpina się w ATOM w środku, więc z zewnątrz go nie widać. Przycisk ATOM naciska się przez okienko na froncie. Korpus nakłada się na płytę, aż zaskoczą 2 zatrzaski u góry, a od spodu trzyma go jeszcze jedna śruba.
ENV III leży na dnie, za przegrodą i nad otworem w obudowie, żeby termometr był jak najdalej od ciepłego ESP32.

Lista części
| Część | Gdzie kupiłem |
|---|---|
| M5Stack ATOM Lite | Botland |
| M5Stack ENV III (SHT30 + QMP6988) z kablem Grove | Botland |
| Radar HLK-LD2410C, 24 GHz | Allegro |
| Kabel USB-A - USB-C 20 cm z wtyczką kątową 90° (aceyoon) | Amazon |
| Moduł zasilacza 230 V na USB 5 V 2,1 A do puszki | Amazon |
| Puszka podtynkowa Ø60 albo natynkowa | wkręty co 60 mm |
| 4 przewody połączeniowe Dupont, męskie, ok. 10 cm | do radaru, bez lutowania |
| Śruby M3: 7 × M3 × 8 (w tym 1 z łbem stożkowym), 3 × M3 × 10 |
Wtyczka kątowa USB-C może wystawać pod ATOM najwyżej 12 mm i mieć najwyżej 5 mm grubości. Kabel musi wychodzić z niej w bok. Z prostą wtyczką obudowa musiałaby być wyższa o 25-30 mm.
Druk
Wszystko drukuje się bez podpór, z PETG. Filament nie może mieć dodatków metalu, węgla ani grafitu, bo tłumią sygnał radaru.
| Część | Ułożenie na stole | Uwagi |
|---|---|---|
| housing (korpus) | frontem w dół | |
| back_plate (płyta) | tyłem w dół | belki zatrzasków pełne: 100% albo min. 4 obrysy |
| head_front (przód kuli) | płaskim czołem w dół | 100% wypełnienia, to osłona radaru |
| head_back (tył kuli) | płaszczyzną podziału w dół | |
| radar_frame, radar_retainer | kołnierzem w dół | |
| grove_cover | tylnym końcem w dół | |
| clamp_ring, atom_holder | płasko | |
| trim_plate (maskownica, opcja) | płasko | tylko gdy płyta ma zakryć otwór w ścianie |
Płaskie okno głowicy ma 3,6 mm, a jego wewnętrzna strona jest 12,4 mm przed antenami, tak jak zaleca Hi-Link w dokumentacji LD2410C. Grubość to połowa długości fali w materiale, liczona dla przenikalności ok. 3. Dla PETG tego nie mierzyłem, to wyliczenie, więc po złożeniu warto sprawdzić, czy czujnik wykrywa obecność także na skraju pola widzenia.
Pliki do pobrania: STL i STEP.
Połączenia
ENV III łączy się kablem Grove z gniazdem ATOM (I2C na G26 i G32). Radar podłącza się do listew na spodzie ATOM:
| LD2410C | ATOM Lite |
|---|---|
| VCC | 5V |
| GND | GND |
| TX | G19 |
| RX | G22 |
| OUT (opcjonalnie, firmware go nie używa) | G23 |
LD2410C potrzebuje 5 V i ponad 200 mA. Wyjścia ma na 3,3 V, czyli można je podłączyć wprost do ESP32. Z ATOM komunikuje się przez UART z prędkością 256000. TX i RX to opisy pinów na płytce radaru i tak podłączony radar działa u mnie. Jeśli Twój nie odpowiada, zamień te dwa przewody. Uważaj też na polaryzację zasilania, bo podłączony odwrotnie radar się grzeje.
Montaż

- Podłącz przewody Dupont do pinów LD2410C. Lutować nie trzeba. Wsuń płytkę w ramkę radaru antenami do przodu i pinami do góry i przytrzymaj ją 2 kroplami kleju na gorąco. Włóż ramkę w przednią połówkę kuli, załóż docisk, wyprowadź przewody otworem w tylnej połówce i skręć połówki 3 śrubami M3 × 10.
- Włóż kulę od tyłu w gniazdo korpusu, załóż pierścień i przykręć go 4 śrubami M3 × 8. Dokręć tak, żeby kula utrzymywała ustawienie, ale nadal dawała się obracać palcami.
- Włóż ATOM od tyłu w ramkę, przyciskiem do frontu i gniazdami w dół, i dociśnij go uchwytem (2 śruby). Podłącz przewody radaru.
- Wepnij kabel Grove w ENV III i wsuń czujnik od tyłu w szynę na dnie, perforacją w dół. Drugi koniec kabla wepnij w ATOM, wsuń kabel w wycięcie w przegrodzie i zamknij je nasuwką.
- Przykręć płytę do puszki, z kablem USB-C przełożonym przez otwór w płycie. Wtyczkę kątową wepnij w ATOM od dołu, kablem w bok.
- Nałóż korpus na płytę, aż zaskoczą zatrzaski, i wkręć śrubę od spodu. Żeby go zdjąć, wykręć śrubę i pociągnij korpus do siebie.
Zasilanie z puszki
W domu czujnik wisi na zwykłej puszce podtynkowej Ø60, takiej jak pod gniazdko albo włącznik, a w warsztacie na puszce natynkowej. W puszce siedzi moduł zasilacza 230 V na USB 5 V 2,1 A, a od niego do ATOM idzie 20-centymetrowy kabel USB-C z wtyczką kątową, więc na ścianie nie ma ani kabla, ani zasilacza wtyczkowego.
Moduł podłącza się do instalacji 230 V wyłącznie przy wyłączonym obwodzie. Jeśli nie masz uprawnień, zleć podłączenie elektrykowi.
Otwór w ścianie wokół puszki bywa szerszy niż obudowa i wtedy pod płytę idzie maskownica 74 mm. Płytę można też przykręcić do gołej ściany 4 kołkami.
Firmware: ESPHome
Cała konfiguracja jest w pliku presence-sensor.yaml, przygotowanym dla ESPHome 2026.9.1. Czujnik udostępnia w Home Assistant:
- dane z radaru: obecność, ruch, bezruch, odległości i energię celu, a w trybie inżynierskim także energię w każdej strefie,
- temperaturę i wilgotność z SHT30 oraz ciśnienie z QMP6988 (QMP6988 mierzy też temperaturę, ale ta encja jest domyślnie wyłączona, bo dokładniejszy odczyt daje SHT30),
- diodę RGB, sygnalizację LED i siłę sygnału WiFi,
- ustawienia radaru: czas podtrzymania, maksymalną strefę ruchu i bezruchu, progi każdej strefy, rozdzielczość stref, tryb inżynierski i Bluetooth radaru,
- korektę temperatury, jasność sygnalizacji i próg wilgotności dla diody.
Nazwy encji i zmiennych w pliku są po angielsku, tak jak w dokumentacji ESPHome. W Home Assistant każdą encję możesz nazwać po swojemu.
Najważniejsze fragmenty:
substitutions:
temp_fixed_offset: "-3.5"
esp32:
board: m5stack-atom
cpu_frequency: 80MHZ
i2c:
sda: GPIO26 # Grove: ENV III
scl: GPIO32
uart:
id: ld_uart
rx_pin: GPIO22
tx_pin: GPIO19
baud_rate: 256000
ld2410:
uart_id: ld_uart
binary_sensor:
- platform: ld2410
has_target:
name: "Presence"
has_moving_target:
name: "Moving Target"
has_still_target:
name: "Still Target"
sensor:
- platform: sht3xd
address: 0x44
temperature:
name: "Temperature"
filters:
- lambda: return x + ${temp_fixed_offset} + id(temp_offset).state;
humidity:
name: "Humidity"
- platform: qmp6988
pressure:
name: "Pressure"
Pierwsze wgranie:
- Zainstaluj ESPHome (
pip install esphome==2026.9.1). Zapiszpresence-sensor.yaml, a obok niegosecrets.yamlz kluczem API (wzór: secrets.example.yaml). Klucz to 32 bajty w base64, wygenerujesz go poleceniemopenssl rand -base64 32. Tym samym kluczem szyfrowane są aktualizacje przez WiFi, więc osobnego hasła OTA nie ma. - Skompiluj firmware poleceniem
esphome compile presence-sensor.yaml. Plik do pierwszego wgrania to.esphome/build/presence-sensor/.pioenvs/presence-sensor/firmware.factory.bin. - Podłącz ATOM kablem USB-C do komputera, otwórz web.esphome.io w Chrome albo Edge, wybierz “Install” i wskaż ten plik. W tym samym oknie ustawisz WiFi.
- Home Assistant sam wykryje urządzenie w integracji ESPHome i poprosi o klucz API. Urządzenie nazywa się
presence-sensor-xxxxxx, z końcówką adresu MAC, więc z jednego pliku można wgrać kilka czujników. Nazwę zmienisz w Home Assistant. - Kolejne wersje wgrasz przez WiFi:
esphome upload presence-sensor.yaml --device <IP>.
Sygnalizacja LED
Dioda w ATOM pokazuje stan czujnika. Niebieski oznacza ruch, zielony obecność bez ruchu, a pomarańczowy wilgotność na poziomie progu albo wyższą (domyślnie 70%), np. w łazience po prysznicu. Gdy w pokoju nikogo nie ma, dioda jest zgaszona. Jasność (domyślnie 10%) i próg wilgotności ustawia się w Home Assistant. Po wyłączeniu przełącznika “LED Indicator” światłem “LED” można sterować ręcznie.
Kalibracja temperatury
ESP32 grzeje wnętrze obudowy, nawet z ENV III za przegrodą. Dlatego procesor pracuje z częstotliwością 80 MHz zamiast 240 MHz, a do każdego odczytu dodawana jest stała korekta temp_fixed_offset, w moim pliku -3.5. Do reszty służy suwak “Temperature Offset” w Home Assistant, od -5 do +5 °C. Po kilku godzinach pracy porównaj odczyt z odczytem innego termometru i ustaw różnicę suwakiem.
Ustawienie radaru
LD2410C dzieli zasięg na 9 stref (g0-g8), domyślnie co 0,75 m. Jeśli czujnik wykrywa ruch za ścianą albo na korytarzu, zmniejsz w Home Assistant “Max Move Distance Gate” i “Max Still Distance Gate”. Czułość każdej strefy ustawisz progami od “g0 move threshold” do “g8 still threshold”. Tryb inżynierski pokazuje energię w każdej strefie, więc łatwiej dobrać progi. Można też użyć aplikacji HLKRadarTool przez Bluetooth.