Na płytce deweloperskiej zwykle wystarczy kliknąć „Wgraj”. W docelowym urządzeniu z tym samym ESP32 trzeba czasem przytrzymać BOOT. Różnica często tkwi w kilku elementach między konwerterem USB–UART a wejściami startowymi mikrokontrolera.

Co musi nastąpić przed zapisaniem programu?

ESP32 po resecie sprawdza wybrane wejścia, nazywane strapping pins. Na ich podstawie wybiera m.in. normalny start programu z Flash albo tryb pobierania firmware przez bootloader w ROM. W klasycznym ESP32 niski stan GPIO0 podczas resetu wybiera tryb programowania; inne piny rozruchowe również muszą mieć prawidłowe stany. Dokumentacja wyboru trybu startu ESP32.

Nie każda rodzina używa GPIO0. ESP32-C3 oraz ESP32-C6 korzystają w tym celu z GPIO9; dla poprawnego wejścia w tryb pobierania znaczenie ma też wysoki stan GPIO8. S2 i S3 korzystają z GPIO0. Dlatego instrukcję do WROOM-32 trzeba świadomie dopasować do innego układu. Tryb startu ESP32-C3, ESP32-C6.

DTR i RTS sterują startem, a TX i RX przenoszą dane

Konwerter USB–UART może udostępniać więcej sygnałów niż TX, RX i GND. DTR oraz RTS to linie sterujące, które program uruchomiony na komputerze potrafi zmieniać. Narzędzia takie jak esptool wykorzystują je do resetowania ESP32 i wyboru trybu pobierania.

W typowym układzie automatycznego programowania klasycznego ESP32 zależność funkcjonalna wygląda tak:

USB–UART: DTR → obwód auto-reset → GPIO0 / BOOT
USB–UART: RTS → obwód auto-reset → EN / CHIP_PU
USB–UART: TX  → RX mikrokontrolera
USB–UART: RX  ← TX mikrokontrolera

To opis funkcji, nie zalecenie bezpośredniego zwarcia tych wyprowadzeń przewodami. Płytka referencyjna ma obwód z tranzystorami. Zależność między DTR, RTS, GPIO0 i EN wynika z jego schematu, a nie z prostej zasady „oba sygnały nisko”. DTR i RTS są aktywne stanem niskim; stan true ustawiony w bibliotece portu może więc oznaczać napięcie bliskie 0 V. Espressif — automatyczny bootloader i schemat referencyjny.

Dlaczego potrzebny jest dodatkowy obwód?

Niektóre terminale i sterowniki zmieniają DTR/RTS podczas otwierania portu. Bez właściwego układu może to utrzymywać mikrokontroler w resecie. Obwód z płytki referencyjnej zapobiega resetowi przy jednoczesnym uaktywnieniu obu linii. Ważne są również czas narastania EN, podciągnięcie i elementy RC.

Przy projektowaniu własnej płytki zacznij od schematu referencyjnego odpowiedniej rodziny. Nie dobieraj „na oko” kondensatora tylko dlatego, że pomógł w innej konstrukcji. W gotowym module najpierw sprawdź, czy auto-reset w ogóle istnieje i czy złącze programowania udostępnia oba sygnały sterujące.

Sekwencja widziana od strony mikrokontrolera

Niezależnie od szczegółów obwodu komputer chce uzyskać następujący rezultat:

  1. Mikrokontroler zostaje zatrzymany w resecie przez niski stan EN.
  2. Pin wyboru bootloadera ma wymagany poziom w chwili wyjścia z resetu.
  3. EN wraca do stanu wysokiego; układ odczytuje konfigurację startową.
  4. Bootloader odpowiada narzędziu, które przesyła dane przez UART.
  5. Po zakończeniu następuje reset przy ustawieniach normalnego startu.

Dokładne przełączenia DTR i RTS zależą od układu pośredniczącego i implementacji narzędzia. Ręczne sterowanie tymi liniami bez znajomości schematu utrudnia diagnozę, ponieważ łatwo pomylić stan logiczny API z napięciem na pinie.

Ręczna procedura jest dobrym testem porównawczym

Gdy program zatrzymuje się na Connecting…, spróbuj przytrzymać BOOT, krótko nacisnąć RESET/EN i puścić BOOT. Następnie użyj właściwego portu w narzędziu programującym. Po zakończeniu zapisu może być potrzebny zwykły reset bez BOOT.

Jeśli ręcznie działa, a automatycznie nie, skontroluj:

  • obecność DTR i RTS na adapterze oraz ich rzeczywiste połączenie;
  • elementy obwodu resetu i podciągnięcie EN;
  • urządzenia zewnętrzne wymuszające stan na pinach BOOT lub EN;
  • zajęty port i sprzętową kontrolę przepływu w terminalu;
  • zgodność poziomów logicznych adaptera z ESP32.

Jeśli nie działa również ręcznie, najpierw rozwiąż problem kabla, portu, UART i zasilania. Pomocna jest diagnostyka esptool. Nie kasuj Flash wyłącznie po to, by sprawdzić działanie resetu.

Natywne USB ma inny mechanizm

Sprzętowy USB Serial/JTAG w obsługiwanych ESP32 może sam przełączyć układ do trybu pobierania. Nie wymaga wtedy zewnętrznego konwertera i dwóch tranzystorów sterowanych jego DTR/RTS. Gdy aplikacja wyłączyła USB lub zajęła jego GPIO, nadal może być konieczne ręczne BOOT + RESET. USB Serial/JTAG ESP32-S3.

Różnice między tymi torami opisaliśmy w poradniku natywnego USB. Samo podobieństwo dwóch gniazd USB-C nie oznacza identycznego sposobu resetowania.

Co przewidzieć w gotowym projekcie?

Nawet jeśli urządzenie będzie później aktualizowane przez Wi-Fi, warto zachować dostęp serwisowy do zasilania, masy, UART i wejść BOOT/EN albo do obsługiwanego natywnego USB. OTA wymaga działającego programu i odpowiedniego podziału pamięci; nie zastępuje każdej procedury odzyskiwania. Przy dwóch partycjach aplikacji każda musi zmieścić osobny obraz firmware. Dokumentacja OTA Espressif.

Przy pierwszym uruchomieniu własnej płytki sprawdź osobno ręczny tryb pobierania, automatyczny reset i normalny start bez komputera. To trzy różne warunki pracy, które warto potwierdzić, zanim moduł trafi do obudowy.