ESPectre, komponent, który z ESP32 i zwykłego punktu dostępowego Wi-Fi robi czujnik ruchu, da się teraz stroić z Home Assistanta w trakcie pracy. Zmiany Francesca Pace'a trafiły do gałęzi deweloperskiej ESPHome 2 listopada 2026 roku, tuż po północy czasu polskiego, razem z aktualizacją dokumentacji. W stabilnym wydaniu jeszcze ich nie ma. Do tej pory zmiana czułości oznaczała edycję YAML i ponowne wgranie oprogramowania.

Przypomnienie

ESPectre odczytuje z radia ESP32 informacje o stanie kanału (CSI, Channel State Information). Gdy ktoś chodzi po pokoju, zmieniają się drogi, którymi biegnie sygnał Wi-Fi, a wartości CSI się wahają. Komponent przelicza te wahania na wskaźnik ruchu i nie potrzebuje do tego żadnego dodatkowego czujnika. Projekt powstał w październiku 2025 roku jako komponent zewnętrzny, a w wydaniu 2026.10 wszedł do samego ESPHome. Działa na ESP32, ESP32-S2, ESP32-S3 i ESP32-C3, a z ESP-IDF także na ESP32-C5 i ESP32-C6. Autor zaznacza, że na razie nie wykrywa pewnie osoby, która siedzi bez ruchu, więc brak ruchu nie znaczy, że w pokoju nikogo nie ma.

Nowe encje

Zmiana podnosi wersję ESPectre SDK do 3.1.0 i przenosi do ESPHome ustawienia, które komponent zewnętrzny miał już wcześniej:

  • platforma number z polami threshold, motion_on_hits i motion_off_hits, czyli próg czułości oraz liczba kolejnych wykryć potrzebna do włączenia i wyłączenia stanu ruchu,
  • platforma switch z polem sensing, które wstrzymuje wykrywanie (jego stan wraca po ponownym uruchomieniu, zanim wystartuje wykrywanie),
  • klucze traffic_generator_mode, detection_algorithm i csi_sample_spacing w platformie select,
  • trzy nowe czujniki diagnostyczne, które pokazują częstotliwość wywołań CSI oraz odsetek brakujących i nadmiarowych próbek.

Liczba wykryć, algorytm i odstęp próbek są zapamiętywane po ponownym uruchomieniu. Próg nie, bo profil Lightweight i tak kalibruje go od nowa przy starcie. Wśród nowych opcji YAML są window_size, csi_target_pps, evaluation_interval oraz bloki lowpass_filter i hampel_filter.

Przy aktualizacji trzeba poprawić jedną rzecz. Encję select ustawioną bezpośrednio w platformie należy przenieść pod klucz traffic_generator_mode:. Stary zapis nadal działa, ale z ostrzeżeniem, a zniknie w ESPHome 2027.5.0.

Kompilacja włącza teraz też odpowiedzi na ping wysyłany na adres grupowy (multicast). W trybie external inne urządzenie wysyła takie pingi, a odpowiedzi ESP32 dają ruch, z którego powstają dane CSI.

Co to zmienia w praktyce

Wykrywanie ruchu przez Wi-Fi mocno zależy od pomieszczenia, ustawienia routera i mebli, więc próg zwykle trzeba ustawiać kilka razy. Z nowymi encjami można obserwować wskaźnik ruchu w Home Assistancie, przesunąć suwak i od razu zobaczyć efekt. Przełącznik sensing przyda się też w automatyzacjach, na przykład do wstrzymania wykrywania, gdy sprząta robot odkurzający.

Pace przetestował zmiany na ESP32-S3 zarówno z ESP-IDF, jak i z Arduino. Skoro kod jest już w gałęzi deweloperskiej, powinien trafić do najbliższego wydania z nowymi funkcjami, czyli ESPHome 2026.11.