ESPHome ma wbudowaną obsługę Hi-Link HLK-LD6004, radaru obecności 60 GHz, który podaje położenie każdej wykrytej osoby, a nie tylko informację, czy ktoś jest w pokoju. Siedem zmian autorstwa Ricka van Hattema (wolph), sprawdzonych przez J. Nicka Kostona (bdraco), trafiło do gałęzi deweloperskiej 31 października 2026 nad ranem, między 4:05 a 6:45 czasu polskiego.

Co udostępnia komponent

LD6004 komunikuje się tym samym protokołem TinyFrame co LD6002B, który ESPHome już obsługuje. Zamiast pisać drugi parser, autor najpierw przeniósł wspólny kod do bazowego komponentu ld600x, a obsługa LD6004 jest teraz cienką warstwą nad nim. Komponent prosi moduł o trzy miejsca na cele, bo tyle według Hi-Link wynosi maksimum.

Poszczególne platformy dodają kolejne encje:

  • czujniki binarne obecności ogólnej, każdego z trzech celów i każdego obszaru wykrywania;
  • czujniki liczby celów i wykrytych punktów oraz, dla każdego celu, współrzędne X, Y i Z, indeks Dopplera i identyfikator skupiska;
  • sześć granic każdego obszaru wykrywania, zakłóceń i przebywania;
  • listy wyboru czułości, szybkości reakcji, sposobu montażu, trybu pracy i zachowania wyjścia P20 modułu;
  • liczby określające czas pamiętania przebywania i odstęp między odczytami, przycisk czyszczący dane o przebywaniu, a do tego czujniki tekstowe i przełączniki.

Tryby pracy to tryb normalny, oszczędny, tryb dla powierzchni silnie odbijających oraz dwa tryby, które wyłączają radar i ustawiają wyjście P20 w stan wysoki albo niski. Obszary to prostopadłościany w przestrzeni: obszary wykrywania wyznaczają miejsca, w których radar ma zgłaszać obecność, obszary zakłóceń - miejsca do pominięcia, a obszary przebywania, maksymalnie trzy, dochodzą wtedy, gdy konfiguracja z nich korzysta.

Strefy rysowane na stronie urządzenia

Wpisywanie w YAML sześciu współrzędnych dla każdej strefy szybko się nudzi, dlatego autor udostępnił też edytor współrzędnych dla ESPHome. Ładuje się on na wbudowanej stronie urządzenia. Obszary można przeciągać myszą albo wpisać ich granice, a potem zapisać je w radarze. W konfiguracji wystarczy web_server z opcją js_extra_urls wskazującą skrypt.

Najprostsza konfiguracja wygląda tak:

uart:
  tx_pin: GPIO0
  rx_pin: GPIO1
  baud_rate: 115200

ld6004:
  id: radar

binary_sensor:
  - platform: ld6004
    target:
      name: Radar Presence
    target_1:
      name: Target 1

Testy i dostępność

Autor sprawdził komponent na płytce Seeed XIAO ESP32-C6 z modułem LD6004 na oprogramowaniu 3.18.0. Testowe kompilacje obejmują ESP32 z ESP-IDF, ESP8266 i RP2040. Dokumentacja czeka w osobnej zmianie w serwisie esphome.io.

Kod jest już w gałęzi deweloperskiej, więc powinien trafić do ESPHome 2026.11. Według OHF Daily wersja beta tego wydania jest zaplanowana na 4 listopada. Do tego czasu LD6004 działa tylko na gałęzi deweloperskiej.