Przez trzy lata opcja „Simple” w liście wyboru trybu pracy komponentu LD2420 w ESPHome nie robiła tego, co obiecywała. Zmiana #21651 autorstwa J. Nicka Kostona (bdraco), scalona z gałęzią rozwojową 26 października 2026, sprawia, że radar obecności HLK-LD2420 na fale milimetrowe rzeczywiście przechodzi w uproszczony tryb raportowania. Poprawka ma trafić do ESPHome 2026.11, chyba że wcześniej zostanie przeniesiona do któregoś z wydań poprawkowych 2026.10.x.

Na czym polegał błąd

Komponent LD2420 oferuje tryby Normal, Calibrate i Simple od chwili, gdy pojawił się w ESPHome 2023.11.0 (zmiana #4847). Wybranie Simple zmieniało jednak tylko stan po stronie ESPHome: lista pokazywała Simple, ale komponent nigdy nie wysyłał nowego trybu do modułu. Na module z oprogramowaniem 1.5.4 lub nowszym radar dalej przesyłał ramki z poziomami energii.

Zastosowanie konfiguracji pogarszało sprawę, bo zawsze przestawiało wybór z powrotem na Normal. Moduł przełączony w tryb Simple w inny sposób i tak z niego wychodził.

Z opisu zmiany wynika, że kolejne przeróbki listy wyboru zachowały to działanie, więc nie jest to błąd wprowadzony w 2026.10. Ta opcja po prostu nigdy nie działała.

Po co komu tryb Simple

Błąd zgłoszono wcześniej tego samego dnia, w zgłoszeniu #21643 dotyczącym ESPHome 2026.10.0. Autor zgłoszenia podglądał wyjście UART radaru przez osobną przejściówkę USB i wyjaśnia, dlaczego zależy mu na tym trybie. W trybie Simple moduł podaje tylko stan obecności (włączony lub wyłączony) i odległość, wyznaczane na podstawie progów wyzwalania i obecności w bezruchu dla poszczególnych stref odległości, a wyprowadzenie OT2 odzwierciedla ten stan. Według niego reakcja jest co najmniej o mniej więcej pół sekundy szybsza niż wykrywanie obecności w trybie Normal, czyli energetycznym. Dotąd jedynym sposobem było skopiowanie komponentu do własnego katalogu i zmiana stałej z wersją oprogramowania modułu, a to przestało się kompilować w 2026.10.

Co zmienia poprawka

  • Simple zapisuje w module uproszczony tryb raportowania, a Normal i Calibrate przywracają tryb energetyczny.
  • Gdy moduł już raportuje w żądany sposób, nic nie jest wysyłane. Moduły z oprogramowaniem starszym niż 1.5.4, które obsługują tylko uproszczony tryb, działają więc jak dotąd.
  • Jeśli moduł odrzuci zmianę, lista wraca do trybu, który moduł faktycznie zgłasza, zamiast pokazywać nieprawdziwy stan.
  • Zastosowanie konfiguracji nie przestawia już wyboru na Normal. Kończy jedynie kalibrację, więc moduł w trybie Simple w nim zostaje.

Zmiana dodaje test integracyjny z zasymulowanym UART-em, który steruje listą wyboru przez API. Według opisu na starym kodzie test nie przechodzi przy zapisie trybu Simple, a z poprawką przechodzi.