Wymagana przeglądarka Chrome lub Edge na komputerze (Web Serial API).
Firefox i Safari oraz telefony nie są obsługiwane.
Wgraj firmware bezpośrednio z przeglądarki — bez instalowania żadnych programów.
📌 Uwaga: płytka ma DWA gniazda USB — to ważne, do którego podłączysz!
Port „UART"
gniazdo z mostkiem USB-UART
✅ Wgrywanie firmware (wolniejsze)
✅ Logi i komendy (terminal) 👉 Podłącz tutaj — działa do wszystkiego
Port „USB"
natywny USB ESP32-S3
✅ Wgrywanie firmware (szybsze)
❌ NIE pokazuje logów ani nie przyjmuje komend
Gniazda są opisane małym drukiem na płytce (UART / USB), tuż obok siebie.
Jeśli chcesz tylko wgrać firmware — wystarczy którekolwiek. Do terminala/logów
musisz użyć portu „UART".
📺 Wybierz swój wyświetlacz:
💡 Pierwsze dwa przyciski dotyczą zwykłego devkitu ESP32-S3 N16R8 z osobno podłączonym
wyświetlaczem TFT SPI (ST7789/ILI9341/ILI9488). Masz wyświetlacz OLED — SSD1306 (0.96" I2C),
SSD1309 (2.42" I2C), SH1106 (1.3" I2C) lub SSD1322 (3.12" SPI, skala szarości)? Obsługiwany
identycznie w obu tych wariantach — wybierz dowolny, a typ wyświetlacza ustawisz później w panelu
WWW urządzenia. Trzeci przycisk (Waveshare LCD 1.9) to osobna, gotowa płytka ze zintegrowanym
ekranem — powyższe nie ma do niej zastosowania.
Niepewny, który masz ekran? Sprawdź oznaczenie na płytce wyświetlacza lub w opisie zakupu —
wgranie złego wariantu nie uszkodzi urządzenia, ale ekran nie będzie działał poprawnie
do czasu ponownego wgrania właściwego.
Twoja przeglądarka nie obsługuje Web Serial.
Użyj Google Chrome lub Microsoft Edge na komputerze (nie na telefonie).
Wgrywanie działa tylko przez połączenie HTTPS.
Podłącz ESP32-S3 N16R8 kablem USB do komputera.
Kliknij Zainstaluj i wybierz port szeregowy (COM).
Potwierdź i poczekaj na zakończenie wgrywania.
Gotowe — urządzenie samo się zrestartuje. 🎉
📶 Po wgraniu: połączenie z WiFi (dotyczy KAŻDEGO wariantu, w tym Waveshare LCD 1.9)
Zaraz po wgraniu — a potem za każdym razem, gdy urządzenie nie zna żadnej zapisanej sieci — radio samo tworzy
WŁASNĄ sieć WiFi o nazwie „ESP32-Radio”. Połącz się z nią telefonem lub komputerem —
wymagane hasło: 12345678. Dopiero po połączeniu otwórz w przeglądarce
http://192.168.4.1 i tam wpisz nazwę oraz hasło swojej domowej sieci WiFi.
⚠️ Waveshare LCD 1.9: to JEDYNY sposób — w odróżnieniu od pozostałych wariantów
(ST7789/ILI9341, ILI9488), które mają DODATKOWO możliwość ustawienia WiFi komendą w terminalu
(monitor portu szeregowego, 115200 baud: wifi set <numer> <SSID> <hasło>),
na module Waveshare LCD 1.9 ta alternatywa nie działa — jedyna droga to sieć „ESP32-Radio” opisana wyżej.
🔘 Jeśli wgrywanie nie startuje lub przerywa się
Wprowadź płytkę w tryb wgrywania ręcznie: przytrzymaj BOOT,
krótko naciśnij RST (lub EN), puść BOOT —
i dopiero wtedy kliknij „Zainstaluj". Zwykle nie jest to potrzebne (płytka
sama wchodzi w tryb wgrywania), ale ratuje, gdy pojawiają się błędy.
📋 Historia zmian (Changelog)
v1.0.4_G08.08.2026
⭐ Trzeci przegląd stabilności — cały kod ponownie sprawdzono i naprawiono kolejną porcję rzadkich, ukrytych przyczyn możliwych zawieszeń i niespójnych odczytów danych
⭐ Nowy tryb wskaźnika głośności: segmentowy pasek LED (obok spektrum, wskazówek i pogody) — dostępny na wszystkich wariantach wyświetlacza LCD
🔧 Szybsza zmiana orientacji ekranu na Waveshare LCD 1.9" — obrót (ręczny lub żyroskopem) jest teraz niemal natychmiastowy, bez migotania
🔧 Naprawiono rzadki przypadek utraty ostatniej zmiany suwaka (np. jasności ekranu) przy bardzo szybkim przeciąganiu — teraz zawsze zostaje zapisana na stałe
🔧 Wydłużono czas oczekiwania na połączenie WiFi (15s → 35s) — pomaga przy bardzo słabym sygnale
v1.0.4_F02.08.2026
⭐ Duży przegląd stabilności — dwie niezależne rundy — cały kod sprawdzono dwukrotnie pod kątem wielomiesięcznej, nieprzerwanej pracy i naprawiono łącznie kilkadziesiąt rzadkich, ukrytych przyczyn możliwych zawieszeń, utraty ustawień i restartów (WiFi, zapis ustawień/stacji, aktualizacje przez WiFi, odtwarzanie strumienia)
🔧 Naprawiono miganie i czarny ekran przy obrocie wyświetlacza (Waveshare LCD 1.9") — zmiana orientacji ekranu (ręczna lub żyroskopem) nie pokazuje już krótkiego białego/przesuniętego obrazu ani nie zostawia czarnego ekranu na liście stacji
🔧 Bezpieczniejszy zapis ustawień — nagły zanik zasilania w trakcie zapisu ustawień nie psuje już pliku konfiguracji (WiFi/EQ/itd. się nie gubią)
🛠️ Dodatkowe zabezpieczenie odtwarzacza — wykrywa teraz jeszcze jeden rzadki przypadek "cichego zawieszenia" strumienia audio
v1.0.4_E01.08.2026
⭐ Naprawiono rzadkie zawieszanie się odtwarzania — gdy stacja chwilowo odsyłała błąd zamiast dźwięku, radio potrafiło "zawiesić się" w ciszy bez końca zamiast spróbować ponownie
🛠️ Rozszerzona diagnostyka — nowa sekcja w panelu WWW pokazuje statystyki bieżącej sesji (np. rozłączenia streamu/WiFi) i historię „zdrowia” pamięci co godzinę — łatwiej zauważyć problem, zanim doprowadzi do awarii
v1.0.4_D31.07.2026
⭐ Duży przegląd stabilności — usunięto kilka rzadkich przyczyn zawieszania się urządzenia (przy pobieraniu pogody, przy usypianiu i przy problemach z WiFi)
🔧 Naprawiono błąd — pogoda czasem nie pojawiała się po ponownym uruchomieniu lub wybudzeniu urządzenia
🔧 Naprawiono rzadkie zawieszanie się przy wyświetlaniu utworów ze specjalnymi znakami w tytule
🛠️ Rozszerzona diagnostyka — historia restartów pokazuje teraz też ostatnie zdarzenie dźwięku i który układ się zawiesił
v1.0.4_C30.07.2026
⭐ Nowy obsługiwany wyświetlacz: ILI9488 (3.5"/4", 320×480) — osobny wariant firmware, wybór na tej stronie
v1.0.4_B25.07.2026
🔧 Poprawiono wyświetlanie pogody
⭐ Dodano wyświetlanie miejscowości
v1.0.4_A24.07.2026
⭐ Rozszerzona diagnostyka — w zakładce Info: częstotliwość procesora, wolna pamięć, wolne miejsce na aktualizacje
⚡ Instalator webowy (ESP Web Tools) — wgrywanie z przeglądarki
Coś nie działa?
❌ „Failed to open serial port"
Port COM jest zajęty przez inny program. Zamknij monitor szeregowy
(Arduino IDE, PlatformIO, PuTTY) i wszelkie inne karty z instalatorem,
odepnij i wepnij kabel USB, odśwież stronę i spróbuj ponownie.
🔌 Nie widać urządzenia / brak portu
Użyj kabla USB do przesyłu danych (nie tylko do ładowania).
Sprawdź też inne gniazdo USB. Na niektórych płytkach trzeba wpiąć kabel
w port oznaczony USB, a nie UART/COM.
🛠️ Płytka nie wchodzi w tryb wgrywania
Ręcznie: przytrzymaj przycisk BOOT, krótko naciśnij
RESET (lub EN), puść BOOT. Potem znów
kliknij Zainstaluj.
🌐 Przycisk „Zainstaluj" nie reaguje
Użyj Google Chrome lub Microsoft Edge na komputerze.
Firefox, Safari oraz telefony i tablety nie obsługują wgrywania
(brak Web Serial API).
🖥️ Terminal / Konsola — logi i komendy
Podgląd logów z urządzenia i wysyłanie komend. Przydatne, gdy coś nie działa —
możesz skopiować logi i wysłać je autorowi.
🔌 Podłącz kabel do portu „UART"!
Logi i komendy działają tylko przez gniazdo „UART" (z mostkiem USB-UART).
Natywny port „USB" służy do wgrywania, ale tutaj nic nie pokaże.
Działa tylko w Chrome/Edge na komputerze. Terminal i instalator nie mogą
być połączone naraz — jeśli przed chwilą wgrywałeś firmware, odśwież stronę.
⚠️ Wgrywanie trwa już ponad 90 sekund — coś może być nie tak.
Sprawdź poniższe i odśwież stronę:
Użyj portu UART (nie natywnego USB) — tylko ten działa stabilnie
Sprawdź czy kabel USB przesyła dane (nie tylko ładuje)
Podłącz bezpośrednio do komputera — bez hubów USB
Wejdź ręcznie w tryb wgrywania: przytrzymaj BOOT, naciśnij RST, puść BOOT — potem odśwież stronę i spróbuj ponownie