esp32install - wgrywanie programów na ESP32 z przeglądarki (bez IDE, bez esptoola, bez konta)

iTomek · 3 godziny temu

Cześć!

Wpinacie ESP32 do komputera i na stronie klikacie jeden przycisk. Po paru minutach na płytce działa czyjś gotowy projekt, a na komputerze nie przybyło ani jednego programu. Taką stronę zrobiłem we wrześniu dla swoich urządzeń i teraz oddaję ją w całości, na licencji MIT, żebyście mogli postawić to samo przy swoich projektach.

Instalator na esp32ai.me: przy każdym systemie płytka i wersja do wgrania

Przyda się, jeśli macie gotowy plik .bin i nie chcecie dla niego stawiać Arduino IDE ani esptoola. Najbardziej przyda się jednak autorom projektów na ESP32, którym instrukcja instalacji rozrasta się do dwóch stron.

Wgrywanie własnego pliku

Otwieracie esp32ai.me/pl/install?own=1 w Chrome, Edge albo Operze. Firefox też da radę – od wersji 151 (maj 2026) ma Web Serial. Safari i przeglądarki w telefonach go nie mają, więc tam zobaczycie tylko, czego brakuje.
Klikacie „Wybierz plik”. Build z PlatformIO albo Arduino zostawia zwykle trzy, cztery pliki (bootloader, tablica partycji, aplikacja), więc przyciskiem „Dodaj kolejny plik” dokładacie następne wiersze, maksymalnie sześć. Strona podpowiada adres dla każdego pliku na podstawie jego nagłówka, a przy okazji rozpoznaje rodzinę układu. Podpowiedzi możecie poprawić.
Klikacie „Podłącz i zainstaluj” i wybieracie port w okienku przeglądarki. Bajty jadą z Waszego dysku prosto w kabel, bez żadnego serwera po drodze.

Program z buildu: strona sama podała adres 0x10000 i rozpoznała ESP32-S3

Przycisk instalacji przy projekcie z GitHuba

Całość to jeden katalog plików statycznych, około megabajta, bez kroku budowania. Najprościej postawić go na GitHub Pages, w repozytorium Waszego projektu. Przeszedłem tę drogę na buildzie z PlatformIO dla zwykłego ESP32, aż do strony z przyciskiem instalacji. Samo wgrywanie na płytkę sprawdziłem dotąd tylko na ESP32-S3.

Pobieracie esp32install jako ZIP, rozpakowujecie i zawartość katalogu esp32install-main przenosicie do docs/install w swoim repozytorium.
Pliki z buildu (PlatformIO trzyma je w .pio/build/<nazwa środowiska>/) kopiujecie do docs/install/firmware/. Muszą leżeć właśnie tam, bo GitHub Releases nie wysyła nagłówków CORS i przeglądarka nie pobierze stamtąd binarki.

W katalogu docs/install odpalacie skrypt, który policzy rozmiary i sumy SHA-256. Przykład jest dla zwykłego ESP32. Na ESP32-S3 i ESP32-C3 bootloader idzie pod 0x0, a --chip dostaje ESP32-S3 albo ESP32-C3.

python3 tools/manifest.py firmware/bootloader.bin@0x1000 firmware/partitions.bin@0x8000 firmware/firmware.bin@0x10000 --chip ESP32 --name "Mój projekt" --version 1.0.0 --out firmware/moj-projekt-1-0-0.json

Plik catalog.json zastępujecie takim jak niżej (ten z repozytorium jest pusty) i sprawdzacie całość poleceniem python3 tools/check.py .. U mnie skończyło się na SUMMARY 26 OK, 0 WARN, 0 FAIL.

{ "site": "moj-projekt", "systems": [ { "id": "moj-projekt", "name": "Mój projekt", "device": "ESP32 DevKit",
  "releases": [ { "version": "1.0.0", "manifest": "firmware/moj-projekt-1-0-0.json", "channel": "stable" } ] } ] }

W ustawieniach repozytorium (Settings → Pages) wybieracie publikację z gałęzi main i katalogu /docs.

Do README dopisujecie link:

[Zainstaluj z przeglądarki](https://<login>.github.io/<repozytorium>/install/?fw=moj-projekt)

Jeśli już publikujecie wydania dla esp-web-tools z ESPHome, Wasz manifest wejdzie bez zmian. A gdy płytka śpi z wyłączonym USB i komputer jej nie widzi, w catalog.json jest pole connectHint na jedno zdanie podpowiedzi pod przyciskiem.

Co sprawdza przed zapisem

Zanim zapisze choćby bajt, instalator sprawdza:

czy plik zbudowano na ten układ, więc binarki z ESP32-S3 nie wgracie przez pomyłkę na zwykłe ESP32,
czy pliki mieszczą się w pamięci płytki i nie nachodzą na siebie,
czy pobrany plik ma sumę SHA-256 podaną w wydaniu.

Jeśli coś się nie zgadza, instalacja staje, a ekran mówi, w którym miejscu. Płytki z włączonym secure boot instalator nie ruszy, bo po wgraniu zwykłego pliku już by nie wstała.

Dla urządzeń, które trzymają ustawienia użytkownika, jest tryb aktualizacji (w manifeście --profile preserve, szczegóły w README). Niczego nie kasuje, a przed zapisem odkłada na Wasz dysk kopię całej pamięci. Jeśli płytka po instalacji zna protokół Improv, Wi-Fi podajecie od razu przez kabel.

Tabela w README wymienia jedenaście rodzin, od ESP8266 po ESP32-P4. Wziąłem ją z biblioteki esptool-js. Jeśli wgracie coś na C3, C6 albo zwykłe ESP32, dajcie znać, jak poszło.

Skąd pomysł?

Do swoich urządzeń potrzebowałem strony instalacji i zacząłem od esp-web-tools z ESPHome. Świetne narzędzie, tyle że jego manifest nie ma pola na sumę kontrolną, więc strona nie ma czym sprawdzić, czy pobrała właściwy plik. Nie chciałem też, żeby kod, który zapisuje komuś pamięć, przychodził z obcego CDN-u.

Na forum pojawiło się kiedyś pytanie o ESPConnect. To narzędzie do czego innego – warsztat do zaglądania w płytkę (rejestry, partycje, NVS) dla kogoś, kto wie, czego szuka. esp32install umie mniej i jest dla osoby, która chce tylko wgrać Wasz projekt.

Kod pisałem z Claude Code, a część pomysłów wziąłem z wcześniejszego instalatora, który robiłem z Codexem. Ja decydowałem, co strona ma sprawdzać i kiedy się zatrzymać, a testy robiłem na własnych płytkach. Open Radio, które niedawno opisałem w dziale DIY, też da się wgrać z esp32ai.me/pl/install.

Linki: