ESPHome pozwala opisać działanie płytki w konfiguracji YAML, zbudować firmware i połączyć urządzenie z Home Assistant. Najłatwiej rozpocząć od samej komunikacji. Gdy WiFi i integracja działają, dołożenie czujnika jest osobnym, łatwiejszym do sprawdzenia krokiem.

Device Builder oraz integracja mają różne zadania

ESPHome Device Builder służy do tworzenia konfiguracji, kompilowania i instalowania programu. Integracja ESPHome w Home Assistant odbiera dane oraz udostępnia sterowanie działającym urządzeniem. Zainstalowanie jednego elementu nie oznacza automatycznie ukończenia drugiego.

Sposób uruchomienia Device Buildera zależy od instalacji Home Assistant. Jeśli Twoja wersja oferuje odpowiedni katalog aplikacji/dodatków, skorzystaj z tej drogi. W innej instalacji użyj oddzielnego środowiska opisanego w aktualnym przewodniku ESPHome.

Utwórz konfigurację dla właściwej płytki

Uruchom kreator nowego urządzenia i wybierz rodzinę układu oraz płytkę. ESP32, ESP32-C3 i ESP32-S3 wymagają właściwych ustawień — nie są zamiennymi nazwami profilu. Wprowadź dane WiFi lokalnie i zachowaj plik konfiguracji oraz plik sekretów poza publicznym repozytorium.

Nie kopiuj bez zmian starego przykładu z platform: ESP32 umieszczonym pod esphome:. Obecna konfiguracja platformy jest oddzielnym komponentem. Korzystaj z kodu utworzonego przez aktualny kreator i walidatora, a następnie dodawaj własne sekcje.

Pierwsza instalacja i kontrola logów

Podłącz płytkę przewodem USB z transmisją danych. Zainstaluj zbudowany program metodą dostępną w Device Builderze lub odpowiednim narzędziu ESPHome. Upewnij się, że wybrany port należy do tej płytki — zapis zastępuje dotychczasowe oprogramowanie.

Po uruchomieniu sprawdź logi: model układu, połączenie z WiFi i adres IP. Jeśli nie ma portu, zacznij od diagnostyki USB-UART. Jeśli program działa, ale nie ma sieci, sprawdź konfigurację WiFi, zanim dołożysz peryferia.

Dodanie do Home Assistant

W Home Assistant sprawdź wykryte urządzenia ESPHome lub dodaj integrację, wskazując osiągalny adres urządzenia. Zachowaj wygenerowane dane zabezpieczające API. Telefon, serwer Home Assistant i płytka nie muszą być jednym urządzeniem ani używać tego samego portu USB — po instalacji komunikują się przez sieć.

Dopiero potem dodaj czujnik, wybierając jego konkretny komponent, model i pin. Sprawdź napięcia zasilania oraz sygnałów. DHT11 z dawnej instrukcji był przykładem, a nie obowiązkowym wyposażeniem każdej płytki.

Aktualizacje i kopia konfiguracji

Aby aktualizować bezprzewodowo, program musi zawierać obsługę OTA. Obecna składnia wykorzystuje platformę w sekcji ota; przykład w dokumentacji wygląda następująco:

ota:
  - platform: esphome
    password: !secret ota_password

To fragment konfiguracji, nie kompletny plik urządzenia. Hasło definiujesz w swoim pliku sekretów. Szczegóły i dostępne opcje opisuje komponent ESPHome OTA.

Po zmianie wykonaj walidację, kompilację i próbę na płytce. Zachowuj YAML wraz z wersją narzędzia, ponieważ sam plik BIN nie odtwarza czytelnego projektu. W urządzeniu wykonawczym sprawdź również bezpieczny stan po resecie i utracie komunikacji.