Moduł 10 · Lekcja 4
Pierwsze urządzenie ESPHome: ESP32 widoczne w Home Assistant
Kurs Smart Home od Zera · ok. 45 - 50 minut · Poziom: Początkujący
Device Builder działa. Tworzysz pierwsze urządzenie: „pusty” ESP32 na Wi-Fi - bez sensorów i GPIO. Fundament: nazwa, sieć, logger, API, OTA. Gdy to działa, wiesz że płytka, USB i most do HA są OK.
Sukces to pełny łańcuch: walidacja → kompilacja → upload → log szeregowy → online w Builderze → integracja ESPHome → test OTA → powrót po zaniku zasilania. Sam komunikat „upload OK” nie wystarczy.
UI Device Buildera (od 2026.6) może wyglądać inaczej niż stare kafelki - logika ta sama. Potrzebujesz Wi-Fi 2,4 GHz (nie gościnna/izolowana na pierwszy test), kabla z danymi i dostępu USB. Zigbee zostaje osobną warstwą encji. Po tej lekcji masz pewność, że fundament sieciowy działa - dopiero potem dokładamy BME280 i GPIO.
Kluczowe fakty z tej lekcji
| • | Najpierw szkielet sieciowy, potem hardware. |
| • | API + klucz szyfrowania = rozmowa z HA. |
| • | OTA testujesz zaraz po pierwszym USB flashu. |
| • | SSID/hasło musisz znać dokładnie; 2,4 GHz. |
| • | Nazwa techniczna bez polskich znaków i spacji. |
| • | Upload OK bez online/API to jeszcze nie sukces lekcji. |
Czego się nauczysz
| ✓ | Tworzenie pierwszego urządzenia w Device Builder |
| ✓ | Minimalny YAML: esphome, esp32, wifi, logger, api, ota |
| ✓ | Flash USB i czytanie logów startu |
| ✓ | Dodanie integracji ESPHome w HA |
| ✓ | Test OTA wireless i restart zasilania |
| ✓ | Lista kontrolna przed startem (USB, Wi-Fi, Builder) |
| ✓ | Jak nie pomylić online w Builderze z pełną integracją HA |
| ✓ | Jak zapisać IP, hostname i wynik testu OTA w dokumentacji |
ESP32 online bez sensorów
| 1. | Utwórz urządzenie (np. esp32-biuro-test) z poprawną nazwą. |
| 2. | Uzupełnij Wi-Fi przez secrets; zwaliduj YAML. |
| 3. | Wgraj przez USB; potwierdź IP i online. |
| 4. | Dodaj integrację ESPHome; sprawdź encje diagnostyczne. |
| 5. | Zrób drobną zmianę i OTA; przetestuj powrót po odłączeniu USB/zasilania. |
Najczęściej zadawane pytania
Dlaczego bez sensora na start?
Żeby oddzielić problemy USB/Wi-Fi/API od okablowania I²C/GPIO.
Sieć gościnna OK?
Na pierwszy test zwykle nie - izolacja psuje discovery/API.
OTA od razu obowiązkowe?
Tak jako test ścieżki serwisowej; później oszczędza kabel.
Zigbee trzeba wyłączyć?
Nie. ESPHome dokłada własne encje obok.
Praktyczny rezultat lekcji
Wgrasz pierwsze ESP32 przewodem, przeczytasz log startu, sprawdzisz Wi-Fi i szyfrowane API, a następnie bezpiecznie przetestujesz OTA.