Jeśli szukasz łatwego i nowoczesnego sposobu na zaprogramowanie mikrokontrolera ESP32, to idealnym narzędziem będzie ESPHome. Dzięki niemu możesz tworzyć i wgrywać soft na płytkę ESP bez konieczności pisania kodu w C++, a konfiguracja odbywa się za pomocą prostego pliku YAML.
W tym poradniku pokażemy krok po kroku, jak przygotować i wgrać soft na ESP32 z użyciem ESPHome i Pythona.
Co to jest ESPHome?
ESPHome to potężny, a zarazem niezwykle prosty w użyciu framework oparty na Pythonie, który umożliwia intuicyjne tworzenie i zarządzanie oprogramowaniem dla mikrokontrolerów ESP32 oraz ESP8266.
Dzięki wykorzystaniu przejrzystej konfiguracji w formacie YAML, ESPHome pozwala użytkownikom – zarówno początkującym, jak i zaawansowanym – szybko przygotować gotowy firmware, bez potrzeby pisania kodu w językach niskopoziomowych, takich jak C++.
Jest to idealne rozwiązanie do budowy nowoczesnych urządzeń IoT (Internet of Things), które mogą być w pełni zintegrowane z popularnym systemem Home Assistant, umożliwiając automatyzację i zdalne sterowanie urządzeniami w inteligentnym domu. Co ważne, ESPHome może działać również całkowicie samodzielnie – bez konieczności połączenia z Home Assistant – co czyni go uniwersalnym narzędziem dla każdego projektu z użyciem ESP32.
ESPHome:
- Umożliwia konfigurację przez YAML
- Automatycznie generuje i kompiluje firmware
- Ułatwia wgrywanie softu przez USB lub OTA
- Obsługuje setki czujników i komponentów
Czego potrzebujesz?
- Płytka ESP (np. ESP32 DevKit v1)
- Zainstalowany Python 3
- Narzędzie ESPHome
- Kabel USB do ESP32
- (Opcjonalnie) Home Assistant – jeśli chcesz integrować urządzenie z inteligentnym domem
Krok 1: Instalacja ESPHome
Zainstaluj ESPHome globalnie przez pip:
$pip install esphome
Po zainstalowaniu upewnij się, że działa:
$esphome version
Krok 2: Utwórz projekt dla ESP32
Uruchom kreator konfiguracji:
$esphome wizard moj_esp.yaml
Zostaniesz zapytany o:
- Nazwę urządzenia
- Typ płytki (np.
esp32dev) - Dane Wi-Fi (SSID i hasło)
- Czy chcesz dodać Home Assistant API
Po zakończeniu powstanie plik konfiguracyjny moj_esp.yaml.
Krok 3: Podłącz ESP32 i wgraj soft
Po raz pierwszy musisz wgrać firmware przez USB. Podłącz płytke do usb i wykonaj następujące polecenie:
$esphome run moj_esp32.yaml
ESPHome:
- Skompiluje plik
.yamldo firmware.bin - Wgra go na ESP32 przez port szeregowy
- Uruchomi monitor portu szeregowego
💡 Kolejne aktualizacje możesz robić już bezprzewodowo (OTA), jeśli płytka ESP połączy się z Wi-Fi.
Krok 4: Edycja konfiguracji YAML
Plik YAML to serce projektu. Przykład prostego softu z czujnikiem temperatury DS18B20:
esphome:
name: moj_esp32
platform: ESP32
board: esp32dev
wifi:
ssid: "TwojaSiecWiFi"
password: "HasloDoWiFi"
sensor:
- platform: dallas
address: 0x1234567890ABCDEF
name: "Temperatura Zewnętrzna"
dallas:
- pin: GPIO4
logger:
api:
ota:
Wystarczy zapisać i ponownie wykonać:
$esphome run moj_esp32.yaml
Krok 5: Integracja z Home Assistant (opcjonalnie)
Jeśli masz Home Assistant, dodanie ESP32 z ESPHome jest banalnie proste:
- Home Assistant automatycznie wykryje nowe urządzenie ESPHome w sieci
- Wystarczy kliknąć „Dodaj”, aby zintegrować płytkę ESP z HA
- Możesz teraz odczytywać dane z czujników i sterować urządzeniami
Podsumowanie
Dzięki ESPHome możesz w prosty, szybki i nowoczesny sposób tworzyć oraz wgrywać soft na ESP32 – bez konieczności pisania skomplikowanego kodu i bez użycia Arduino IDE. Cała konfiguracja odbywa się za pomocą przejrzystych plików YAML, co znacznie upraszcza cały proces.
Wystarczy dosłownie kilka linijek konfiguracji oraz jedno polecenie w terminalu, aby Twoje urządzenie IoT było gotowe do działania i mogło rozpocząć komunikację z siecią domową lub systemem automatyki, takim jak Home Assistant.
Co więcej, ESPHome umożliwia również łatwą aktualizację oprogramowania przez Wi-Fi (OTA), co dodatkowo przyspiesza pracę i eliminuje konieczność ciągłego podłączania ESP32 do komputera.
Jeżeli napotkasz jakiekolwiek trudności lub potrzebujesz pomocy przy konfiguracji, koniecznie skontaktuj się z nami – chętnie pomożemy!