Podłączasz czujnik do ESP32 DevKit, a opis pinów na płytce nie zgadza się z diagramem znalezionym w sieci? Najczęściej różni się układ samej płytki, choć podstawowe funkcje GPIO klasycznego ESP32 pozostają podobne. Zanim włożysz przewody, sprawdź model modułu i kilka pinów, które mogą zablokować start albo przestać działać przy włączonym Wi-Fi.

Najbezpieczniej dobierać piny do zadania, nie do samego diagramu
- Do wejścia analogowego z Wi-Fi: wybierz GPIO z grupy ADC1, czyli GPIO32-39.
- GPIO34-39: działają jako wejścia, bez wyjścia i bez wewnętrznych rezystorów podciągających.
- GPIO6-11: w typowych modułach są połączone z pamięcią flash, więc zostaw je w spokoju.
- GPIO0, 2, 5, 12 i 15: wpływają na konfigurację startową układu; podłączone urządzenie może utrudnić uruchomienie.
- Układ pinów zależy od płytki. Porównuj nadruki na swojej płytce z diagramem dokładnego modelu.
Pinout ESP32 zaczyna się od rozpoznania płytki
Dwie płytki z napisem ESP32 mogą mieć inne rozmieszczenie wyprowadzeń, mimo że korzystają z podobnego układu ESP32-WROOM. Popularne klony DevKit V1 występują między innymi w wersjach z 30 lub 38 pinami, a ESP32-DevKitC ma własny diagram i warianty modułów. Nie zakładaj więc, że kolejność z grafiki pasuje do Twojego egzemplarza.
Na płytce szukaj nadruku przy złączu, takiego jak GPIO23, IO23, D23 lub VP. Oznaczenia „VP” i „VN” zwykle wskazują odpowiednio GPIO36 i GPIO39, ale symbole typu „D” bywają zależne od producenta. Dokumentacja ESP32-DevKitC firmy Espressif pokazuje przypisanie pinów dla konkretnej płytki, nie uniwersalny układ wszystkich klonów.
Najpierw odczytaj model i nadruki, potem podłączaj przewody. Poniższa ściąga opisuje funkcje klasycznego ESP32 w typowych płytkach DevKit z modułem WROOM, a nie każdą płytkę z rodziny ESP32.
Te piny sprawdzają się w najczęstszych połączeniach
Do prostego projektu z przyciskiem, diodą lub wyświetlaczem zwykle wystarczą piny cyfrowe, które nie są zajęte przez pamięć flash ani układ startowy. Dla I²C, czyli dwuprzewodowej magistrali do czujników, często wybiera się GPIO21 i GPIO22; w wielu bibliotekach można jednak przypisać magistralę także do innych dostępnych GPIO.
| Potrzeba | Przykładowe piny klasycznego ESP32 | Ograniczenie |
|---|---|---|
| Wejście analogowe | GPIO32-39, ADC1 | GPIO34-39 są tylko wejściowe |
| I²C | GPIO21 i GPIO22 | W kodzie ustaw piny zgodnie z okablowaniem |
| SPI w typowym projekcie | GPIO18, GPIO19, GPIO23 oraz wybrany pin CS | Sprawdź przypisanie używane przez bibliotekę i płytkę |
| Wyjście analogowe z DAC | GPIO25 lub GPIO26 | To DAC w klasycznym ESP32, nie w każdej odmianie rodziny |
| UART0 do programowania i logów | GPIO1 TX oraz GPIO3 RX | Urządzenie podłączone do tych pinów może zakłócić komunikację szeregową |
W typowym module WROOM zarezerwuj GPIO6-11 dla pamięci flash, nawet jeśli niektóre schematy układu scalonego pokazują je jako dostępne GPIO. PWM, czyli szybkie przełączanie wyjścia używane między innymi do ściemniania LED, można zwykle realizować na innych wolnych pinach cyfrowych. Właśnie dlatego sam wykaz funkcji przy pinie nie wystarcza: trzeba jeszcze sprawdzić, czy nie współdzieli go element płytki.
Przy Wi-Fi wejście analogowe wybieraj z ADC1
Czujnik światła podłączony do GPIO25 może działać w teście bez sieci, a zacząć zwracać błędy po uruchomieniu Wi-Fi. Powód jest sprzętowy: ADC2 współdzieli zasoby z Wi-Fi, podczas gdy ADC1 znajduje się na GPIO32-39. Dokumentacja sterownika ESP-IDF opisuje ograniczenie ADC2, więc przy pomiarach analogowych w urządzeniu sieciowym zacznij od ADC1.
Praktyczny wybór jest prosty: jeśli projekt ma równocześnie mierzyć napięcie i korzystać z Wi-Fi, przypisz czujnik do GPIO32-39. Jeżeli potrzebujesz wyłącznie wyjścia, nie wybieraj GPIO34-39, bo te piny nie potrafią sterować diodą ani przekaźnikiem. Uważam, że to najczęściej pomijany podział na diagramach, a właśnie on oszczędza sporo szukania przyczyn błędnego odczytu.
| Sytuacja | Prawdopodobna przyczyna | Co zrobić |
|---|---|---|
| Odczyt ADC2 znika po włączeniu Wi-Fi | Konflikt dostępu do ADC2 | Przenieś czujnik na GPIO32-39 i skonfiguruj ADC1 |
| GPIO34 nie zapala diody | Pin jest wejściowy, nie wyjściowy | Wybierz wolny pin wyjściowy, na przykład GPIO18 lub GPIO23 |
| Przycisk na GPIO34 losowo zmienia stan | Brak wewnętrznych rezystorów pull-up/pull-down | Dodaj zewnętrzny rezystor podciągający albo wybierz inny pin |
| Płytka nie uruchamia się po podłączeniu modułu | Urządzenie może wymuszać nieprawidłowy poziom na pinie startowym | Odłącz moduł od GPIO startowego i uruchom płytkę ponownie |
Piny startowe i wejściowe wymagają osobnego traktowania
GPIO0, GPIO2, GPIO5, GPIO12 i GPIO15 to piny konfiguracyjne startu, zwane strapping pins. Układ odczytuje ich stany podczas uruchamiania, więc przycisk, przekaźnik lub inny moduł może zmienić sposób startu ESP32. Szczególnej ostrożności wymaga GPIO12, którego stan podczas rozruchu może wpłynąć na konfigurację napięcia pamięci flash w klasycznym układzie.
Osobna pułapka to GPIO34-39: są wejściami, ale nie mają programowo włączanych wewnętrznych rezystorów podciągających. Jeśli przycisk podłączysz do GPIO34 bez zewnętrznego rezystora, wejście może „pływać”, czyli odczytywać zakłócony, niestabilny stan. Szczegóły funkcji i ograniczeń pinów opisuje dokumentacja GPIO dla klasycznego ESP32.
Gdy urządzenie nie startuje, odłącz najpierw moduły od GPIO0, GPIO2, GPIO5, GPIO12 i GPIO15, po czym uruchom płytkę bez dodatkowego obciążenia. Jeśli problem znika, przenieś połączenie na wolny pin bez funkcji startowej albo dobierz układ rezystorów tak, by nie wymuszał niewłaściwego poziomu przy włączeniu zasilania.
Bezpieczny wybór pinów skraca debugowanie
Do analogowego czujnika współpracującego z Wi-Fi wybierz ADC1, do wejścia przycisku sprawdź dostępność podciągania, a do wyjścia omijaj GPIO34-39. Prawdę mówiąc, przy pierwszym podłączeniu najrozsądniej zostawić piny startowe i linie flash w spokoju, nawet jeśli akurat kuszą wygodnym położeniem na płytce.
Przed podaniem zasilania porównaj nadruk konkretnej płytki z jej diagramem i sprawdź, czy moduł peryferyjny nie podaje na GPIO napięcia 5 V. Wejścia klasycznego ESP32 pracują w logice 3,3 V i nie są odporne na 5 V; urządzenie wymagające takiego poziomu trzeba połączyć przez odpowiedni konwerter. Taki krótki przegląd pinów zwykle zapobiega zarówno problemom z programem, jak i uszkodzeniu układu.