{"id":13039,"date":"2026-09-15T18:25:00","date_gmt":"2026-09-15T16:25:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=13039"},"modified":"2026-09-09T13:25:02","modified_gmt":"2026-09-09T11:25:02","slug":"tutorial-konfiguracja-stref-radaru-ld2450-w-esphome-i-home-assistant","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/pl\/smart-home-pl\/tutorials-pl-smart-home-pl\/tutorial-konfiguracja-stref-radaru-ld2450-w-esphome-i-home-assistant\/","title":{"rendered":"Tutorial: Konfiguracja stref radaru LD2450 w ESPHome i Home Assistant"},"content":{"rendered":"

Radar obecno\u015bci typu LD2450 potrafi co\u015b, czego czujnik ruchu nigdy nie potrafi\u0142: m\u00f3wi, gdzie. Do trzech cel\u00f3w, ka\u017cdy ze wsp\u00f3\u0142rz\u0119dn\u0105 x i y w milimetrach, od\u015bwie\u017canych kilka razy na sekund\u0119.<\/p>\n

Ciekawe pytanie staje si\u0119 przez to pytaniem geometrycznym. Strefa to cztery liczby – po dwie na o\u015b – a wszystko, co czyni taki uk\u0142ad u\u017cytecznym albo uci\u0105\u017cliwym, dzieje si\u0119 w tym, jak te cztery liczby powstaj\u0105.<\/p>\n

\n\"Siatka
Pocz\u0105tek uk\u0142adu le\u017cy w czujniku, y biegnie do przodu, x w poprzek i jest ujemny po lewej. Strefa jest prostok\u0105tem w tym uk\u0142adzie – nie w pokoju.<\/figcaption><\/figure>\n

Co czujnik naprawd\u0119 podaje<\/h2>\n

LD2450 to radar 24 GHz \u015bledz\u0105cy jednocze\u015bnie do trzech cel\u00f3w. Na ka\u017cdy cel podaje trzy liczby: wsp\u00f3\u0142rz\u0119dn\u0105 x, wsp\u00f3\u0142rz\u0119dn\u0105 y oraz pr\u0119dko\u015b\u0107 – dwie pierwsze w milimetrach, ostatni\u0105 w centymetrach na sekund\u0119, przy czym znak ujemny oznacza ruch w stron\u0119 czujnika.<\/p>\n

W\u0142a\u015bnie tym r\u00f3\u017cni si\u0119 od mniejszego rodze\u0144stwa. LD2410 odpowiada tylko na to, czy co\u015b jest i mniej wi\u0119cej jak daleko, w podziale na bramki odleg\u0142o\u015bci. Oddzieli\u0107 biurka od drzwi nie potrafi, bo nic nie wie o tym, w kt\u00f3rym kierunku le\u017cy jedno i drugie.<\/p>\n

Dwie w\u0142a\u015bciwo\u015bci warto pozna\u0107 przed jakimkolwiek monta\u017cem. Obszar wykrywania jest klinem oko\u0142o 120 stopni, czyli po 60 stopni na ka\u017cd\u0105 stron\u0119 kierunku patrzenia – wszystko poza nim pozostaje niewidoczne, niezale\u017cnie od odleg\u0142o\u015bci. A u\u017cyteczny zasi\u0119g wewn\u0105trz pomieszcze\u0144 wynosi oko\u0142o sze\u015bciu metr\u00f3w, przy czym dok\u0142adno\u015b\u0107 wsp\u00f3\u0142rz\u0119dnych spada wyra\u017anie wcze\u015bniej.<\/p>\n

Ustalenie pocz\u0105tku uk\u0142adu przed wszystkim innym<\/h2>\n

Ka\u017cda liczba strefy odnosi si\u0119 do uk\u0142adu wsp\u00f3\u0142rz\u0119dnych, kt\u00f3rego pocz\u0105tkiem jest sam czujnik. O\u015b y wskazuje kierunek, w kt\u00f3rym patrzy p\u0142ytka; o\u015b x biegnie w poprzek, ujemna po lewej, dodatnia po prawej, patrz\u0105c zza czujnika.<\/p>\n

Wynikaj\u0105 z tego trzy rzeczy, a wszystkie trzy taniej za\u0142atwi\u0107 przed przyklejeniem modu\u0142u.<\/p>\n

Czujnik zamontowany obr\u00f3cony o dziewi\u0119\u0107dziesi\u0105t stopni zamienia osie, a ka\u017cd\u0105 stref\u0119 narysowan\u0105 na rzucie trzeba przenie\u015b\u0107 z zamian\u0105. Czujnik zamontowany do g\u00f3ry nogami odbija o\u015b x, wi\u0119c lewa i prawa zamieniaj\u0105 si\u0119 miejscami, a strefa l\u0105duje po drugiej stronie pokoju. A czujnik przesuni\u0119ty o dwadzie\u015bcia centymetr\u00f3w w \u0142adniejsze miejsce uniewa\u017cnia wszystkie strefy naraz, bo wszystkie mierzono z poprzedniego po\u0142o\u017cenia.<\/p>\n

Praktyczne po\u0142o\u017cenie monta\u017cowe LD2450 to \u015bciana na wysoko\u015bci oko\u0142o 1,2 do 1,5 metra – mniej wi\u0119cej na wysoko\u015bci bioder. Wy\u017cej radar patrzy na ludzi z g\u00f3ry, a nie w poprzek, i wsp\u00f3\u0142rz\u0119dna y mierzy wtedy przek\u0105tn\u0105 zamiast odcinka po pod\u0142odze. Po\u0142o\u017cenie sufitowe jest zadaniem innego czujnika.<\/p>\n

Konfiguracja – i miejsce, w kt\u00f3rym mieszka strefa<\/h2>\n

Strona ESPHome jest kr\u00f3tka. Radar rozmawia po \u0142\u0105czu szeregowym z pr\u0119dko\u015bci\u0105 256 000 bod\u00f3w, a komponent robi z tego encje.<\/p>\n

uart:\n  id: uart_radar\n  tx_pin: GPIO17\n  rx_pin: GPIO16\n  baud_rate: 256000\n  parity: NONE\n  stop_bits: 1\n\nld2450:\n  id: radar\n  uart_id: uart_radar\n  throttle: 1000ms\n\nbinary_sensor:\n  - platform: ld2450\n    ld2450_id: radar\n    has_target:\n      name: \"Obecnosc\"\n    zone_1:\n      occupancy:\n        name: \"Biurko zajete\"\n    zone_2:\n      occupancy:\n        name: \"Strefa drzwi zajeta\"\n\nsensor:\n  - platform: ld2450\n    ld2450_id: radar\n    target_1:\n      x:\n        name: \"Cel 1 X\"\n      y:\n        name: \"Cel 1 Y\"\n      speed:\n        name: \"Cel 1 predkosc\"\n    zone_1:\n      target_count:\n        name: \"Cele przy biurku\"\n\nnumber:\n  - platform: ld2450\n    ld2450_id: radar\n    presence_timeout:\n      name: \"Czas podtrzymania\"\n    zone_1:\n      x_begin:\n        name: \"Strefa 1 X poczatek\"\n      y_begin:\n        name: \"Strefa 1 Y poczatek\"\n      x_end:\n        name: \"Strefa 1 X koniec\"\n      y_end:\n        name: \"Strefa 1 Y koniec\"<\/code><\/pre>\n
Ustawienie throttle<\/code> jest najbardziej op\u0142acalne ze wszystkich. Bez niego radar melduje kilka razy na sekund\u0119, a ka\u017cdy taki meldunek staje si\u0119 w Home Assistant zmian\u0105 stanu. Jedna sekunda w zupe\u0142no\u015bci wystarcza do o\u015bwietlenia i chroni baz\u0119 danych przed przyrostem o megabajt dziennie na czujnik.<\/p>\n
Zaskakuj\u0105cym szczeg\u00f3\u0142em jest to, gdzie mieszkaj\u0105 granice stref. Nie s\u0105 warto\u015bciami w pliku YAML – to liczby we flashu samego modu\u0142u radarowego, a ESPHome pokazuje je jako encje liczbowe, aby da\u0142o si\u0119 je raz ustawi\u0107. To wygodne, bo stref\u0119 da si\u0119 wtedy poprawi\u0107 z telefonu, stoj\u0105c w pomieszczeniu. To zarazem pu\u0142apka, bo wymieniony modu\u0142 wraca ze strefami fabrycznymi, a nic w konfiguracji nie m\u00f3wi, jak brzmia\u0142y wcze\u015bniej. Cztery liczby na stref\u0119 nale\u017c\u0105 do komentarza w pliku YAML, cho\u0107by tylko jako dokumentacja.<\/p>\n
Pomiar strefy zamiast zgadywania<\/h2>\n
Granice stref wzi\u0119te z rzutu bywaj\u0105 b\u0142\u0119dne na tyle cz\u0119sto, \u017ce pomiar idzie szybciej. Pomiar wymaga jednej osoby, pi\u0119ciu minut i dw\u00f3ch czujnik\u00f3w wsp\u00f3\u0142rz\u0119dnych z powy\u017cszej konfiguracji.<\/p>\n
Stani\u0119cie w ka\u017cdym naro\u017cniku zamierzonej strefy i odczytanie warto\u015bci x oraz y daje prostok\u0105t wprost. Cztery naro\u017cniki, osiem liczb, a ich warto\u015bci skrajne to granice. Warto doda\u0107 do tego tolerancj\u0119 oko\u0142o dwudziestu centymetr\u00f3w na stron\u0119, bo cz\u0142owiek nie jest punktem: radar podaje \u015brodek odbicia, a ten w\u0119druje po ciele przy ka\u017cdym obrocie.<\/p>\n
Pomiary narozne przy biurku (x \/ y w mm)\n\n  z przodu z lewej     380 \/  840\n  z przodu z prawej   1760 \/  810\n  z tylu z lewej       420 \/ 2310\n  z tylu z prawej     1780 \/ 2360\n\nStrefa 1 z tolerancja:  x  300 \u2026 1800     y  800 \u2026 2400<\/code><\/pre>\n
Do tej samej sesji nale\u017c\u0105 dwa sprawdzenia. Przej\u015bcie przez stref\u0119 i wyj\u015bcie z niej powinno prze\u0142\u0105czy\u0107 czujnik zaj\u0119to\u015bci czysto w obie strony. A stani\u0119cie tu\u017c poza granic\u0105 prze\u0142\u0105czy\u0107 go nie powinno – je\u015bli jednak prze\u0142\u0105cza, strefa jest wi\u0119ksza ni\u017c zamierzono albo odbicie przychodzi sk\u0105din\u0105d ni\u017c od osoby.<\/p>\n
Drugie sprawdzenie znajduje b\u0142\u0119dy monta\u017cu. Metalowa szafa, grzejnik albo du\u017ce lustro odbijaj\u0105 sygna\u0142 radaru i wytwarzaj\u0105 cel stoj\u0105cy tam, gdzie nikogo nie ma. Takie widmo poznaje si\u0119 po tym, \u017ce stoi ca\u0142kiem nieruchomo i nigdy nie odchodzi; zaradzi temu inny k\u0105t czujnika, a nie mniejsza strefa.<\/p>\n
Automatyzacja – i to, co ka\u017ce jej miga\u0107<\/h2>\n
Przy dzia\u0142aj\u0105cej strefie sama automatyzacja jest niewidowiskowa – i bez jednej linii by miga\u0142a.<\/p>\n
binary_sensor:\n  - platform: ld2450\n    ld2450_id: radar\n    zone_1:\n      occupancy:\n        name: \"Biurko zajete\"\n        filters:\n          - delayed_off: 20s<\/code><\/pre>\n
To delayed_off<\/code> stanowi r\u00f3\u017cnic\u0119 mi\u0119dzy lamp\u0105 pal\u0105c\u0105 si\u0119, dop\u00f3ki kto\u015b pracuje, a lamp\u0105 gasn\u0105c\u0105, gdy tylko osoba odchyli si\u0119 do ty\u0142u. Radar traci cel nieruchomy \u0142atwiej ni\u017c ruchomy, a dwadzie\u015bcia sekund podtrzymania nic nie kosztuje, usuwaj\u0105c za to ca\u0142\u0105 klas\u0119 za\u017cale\u0144.<\/p>\n
Jego odpowiednikiem jest czas podtrzymania w samym module, rozstrzygaj\u0105cy, jak d\u0142ugo radar melduje cel po ostatnim wykryciu. Oba op\u00f3\u017anienia si\u0119 sumuj\u0105: pi\u0119\u0107 sekund podtrzymania plus dwadzie\u015bcia sekund filtra oznacza, \u017ce \u015bwiat\u0142o ga\u015bnie dwadzie\u015bcia pi\u0119\u0107 sekund po opuszczeniu miejsca. To nale\u017cy ustawi\u0107 \u015bwiadomie, a nie przypadkiem.<\/p>\n
Po stronie Home Assistant jedna zasada oszcz\u0119dza du\u017co szukania usterek: automatyzacja powinna reagowa\u0107 na czujnik strefy, nigdy na surowe wsp\u00f3\u0142rz\u0119dne. Wyzwalacz na liczbowej warto\u015bci x odpala przy ka\u017cdym drgnieniu podawanego \u015brodka, a ta sama nieruchomo siedz\u0105ca osoba przekracza taki pr\u00f3g kilkadziesi\u0105t razy na godzin\u0119.<\/p>\n
Co i tak idzie potem nie tak<\/h2>\n
Trzy zjawiska odpowiadaj\u0105 za wi\u0119kszo\u015b\u0107 pozosta\u0142ych k\u0142opot\u00f3w, a ka\u017cde ma inn\u0105 rad\u0119.<\/p>\n
Pierwszym jest ruch, kt\u00f3ry nie jest cz\u0142owiekiem. Wentylator, firanka w przeci\u0105gu, wisz\u0105ca ro\u015blina – wszystkie si\u0119 poruszaj\u0105, wszystkie odbijaj\u0105, a dla radaru wygl\u0105daj\u0105 jak powolny cel. Strefa je omijaj\u0105ca to odpowied\u017a najczystsza; gdzie si\u0119 nie da, pomaga warunek minimalnej pr\u0119dko\u015bci, bo zak\u0142\u00f3cenia rzadko daj\u0105 sta\u0142y kierunek.<\/p>\n
Drugim jest pok\u00f3j s\u0105siedni. Dwadzie\u015bcia cztery gigaherce przechodz\u0105 przez p\u0142yt\u0119 gipsow\u0105 z niewielk\u0105 strat\u0105, wi\u0119c strefa przy\u0142o\u017cona do \u015bciany obejmuje tak\u017ce kanap\u0119 za ni\u0105. Wsp\u00f3\u0142rz\u0119dne nie m\u00f3wi\u0105 nic o \u015bcianach, bo radar nic o nich nie wie. Znajdzie to wy\u0142\u0105cznie pomiar, a warto go wykona\u0107 celowo: kto\u015b chodzi po s\u0105siednim pokoju, a liczba cel\u00f3w jest obserwowana.<\/p>\n
Trzecim jest to, \u017ce drugi radar w tym samym pomieszczeniu zak\u0142\u00f3ca pierwszy. Dwa modu\u0142y LD2450 na tej samej cz\u0119stotliwo\u015bci skierowane na siebie wytwarzaj\u0105 w obu cele nienale\u017c\u0105ce do \u017cadnego z nich. Gdzie potrzebne s\u0105 dwa, powinny patrze\u0107 od siebie, a na\u0142o\u017cenie ich klin\u00f3w pozosta\u0107 niewielkie.<\/p>\n
\n
\u0179r\u00f3d\u0142a<\/h2>\n