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 czujnika, widok od frontu

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.

Widok rozstrzelony: płyta, ATOM, ENV III, głowica z radarem i korpus

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

Schemat połączeń ATOM Lite, LD2410C i ENV III

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ż

Wnętrze bez korpusu i głowicy: płyta, ATOM, ENV III i ramka radaru

  1. 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.
  2. 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.
  3. 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.
  4. 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ą.
  5. 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.
  6. 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:

  1. Zainstaluj ESPHome (pip install esphome==2026.9.1). Zapisz presence-sensor.yaml, a obok niego secrets.yaml z kluczem API (wzór: secrets.example.yaml). Klucz to 32 bajty w base64, wygenerujesz go poleceniem openssl rand -base64 32. Tym samym kluczem szyfrowane są aktualizacje przez WiFi, więc osobnego hasła OTA nie ma.
  2. Skompiluj firmware poleceniem esphome compile presence-sensor.yaml. Plik do pierwszego wgrania to .esphome/build/presence-sensor/.pioenvs/presence-sensor/firmware.factory.bin.
  3. 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.
  4. 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.
  5. 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.