Nach Symptom sortiert
Diese Lektion ist zum Nachschlagen gedacht, wenn etwas nicht geht. Sie geht vom Symptom aus, nicht von der Ursache — denn das Symptom ist, was du siehst.
Das Gerät startet gar nicht mehr, seit ich etwas angelötet habe
| Verdacht | prüfen |
|---|---|
| Ein Flash-Pin ist belegt | ESP32: GPIO6–11, 16, 17 · S3: GPIO26–32 · C6: GPIO24–26 und 28–30 |
| Ein Strapping-Pin wird beim Reset gezogen | ESP32: GPIO0, 2, 5, 12, 15 · S3: GPIO0, 3, 45, 46 · C6: GPIO4, 5, 8, 9, 15 |
| GPIO12 beim klassischen ESP32 auf High | Der Klassiker: stellt die Flash-Spannung auf 1.8 V. Bei 3.3-V-Flash bootet der Chip nicht. |
Vorgehen: Das zuletzt angelötete Bauteil abklemmen. Startet es wieder, war es der Pin und nicht die Software. Dann die Spannung an diesem Pin während des Einschaltens messen — das ist der einzige Beweis.
Es startet, stürzt aber nach einiger Zeit ab
Typisch für einen gestörten Flash-Pin: Solange der Code im Cache liegt, merkt der Chip nichts. Erst beim Nachladen kippt es. Deshalb hängt der Absturz oft daran, wie viel Code gerade läuft, und nicht an einer bestimmten Stelle.
Der Analogwert ist Unsinn, sobald WLAN läuft
Der Pin liegt an ADC2. Umziehen auf ADC1: ESP32 GPIO32–39, S3 GPIO1–10. Der C6 hat nur ADC1, dort liegt es an etwas anderem.
Der Taster löst manchmal von selbst aus
| Verdacht | prüfen |
|---|---|
| Pin ohne Pull-Widerstand | Bei GPIO34–39 des klassischen ESP32 gibt es keinen internen — externen Widerstand setzen. |
| Interner Pull-up nicht eingeschaltet | Bei allen anderen Pins per Software zuschaltbar. |
Das Gerät wacht nie wieder auf
Der Weckeingang liegt an einem Pin ohne RTC-/LP-Funktion. Weckfähig sind: ESP32 GPIO0, 2, 4, 12–15, 25–27, 32–39 · S3 GPIO0–21 · C6 nur GPIO0–7. Beim C6 zusätzlich beachten: kein ext0, nur ext1.
Ich komme nicht in den Download-Modus
Beim C6 ist die Bedingung anders als beim ESP32: GPIO9 auf Low und GPIO8 auf High. Wer beide nach Masse zieht, kommt nicht hinein.
Der Ruhestrom ist zehnmal höher als im Datenblatt
Fast nie der Chip. Der Reihe nach: Betriebs-Leuchtdiode auf dem Board, Spannungsregler, USB-Brücke — und dann Pins, an denen ein interner Pull gegen eine externe Beschaltung arbeitet.
Die Anleitung sagt „Pin D4", mein Board hat kein D4
Der Aufdruck ist eine Beschriftung des Boardherstellers und keine Chipeigenschaft. In der Pinout-Zeichnung deines Boards die GPIO-Nummer nachschlagen — nur die ist übertragbar.
Der Fehler hinter den meisten Fehlern
Fast alles oben lässt sich auf eine Gewohnheit zurückführen:
Eine Aussage über Pins wurde von einem Chip auf einen anderen übertragen.
„GPIO34 ist nur Eingang" — beim klassischen ESP32. „GPIO9 gehört dem Flash" — beim klassischen ESP32; beim C6 ist GPIO9 der Boot-Modus-Pin. „Beide Pins nach Masse für den Download-Modus" — beim ESP32 und S3, beim C6 falsch.
Die meisten Anleitungen im Netz sind über den klassischen ESP32 geschrieben, auch wenn sie nur „ESP32" sagen. Wenn du einen anderen Chip vor dir hast, ist jede Pinnummer darin eine Vermutung.
Zum Schluss: die drei Dokumente
Dieser Kurs kann dir nicht jede Zahl abnehmen — er sagt dir vor allem, wo sie steht. Drei Quellen decken alles ab:
| Frage | Dokument | Abschnitt |
|---|---|---|
| Was kann dieser Pin? Welche Grenzen? | Datenblatt des Chips | „Restrictions for GPIOs", „Boot Configurations", „Electrical Characteristics" |
| Wie heisst das in der Software, was ist erlaubt? | ESP-IDF Programming Guide | „GPIO & RTC GPIO", „Sleep Modes", „ADC" |
| Was hängt auf meiner Platine daran? | Unterlagen des Boards | Schaltplan oder Pinout |
Die ersten beiden sind verlässlich und versioniert. Beim dritten bist du auf den Hersteller angewiesen — und wenn er nichts liefert, auf dein Messgerät.
Und die eine Angewohnheit, die am meisten spart: Schreib in deine eigene Dokumentation immer die GPIO-Nummer und den Chipnamen dazu. „Sensor an GPIO7, ESP32-C6" ist in zwei Jahren noch eine Aussage. „Sensor an D4" ist es nicht.
Quellen
Diese Lektion fasst zusammen, was in den Modulen 5 bis 9 belegt ist:
- ESP32 Series Datasheet v5.2, Abschnitte 2.3.1, 3 und 5
- ESP32-S3 Series Datasheet v2.2, Abschnitte 2.3.4, 2.3.5, 3 und 5
- ESP32-C6 Series Datasheet v1.5, Abschnitte 2.3.4, 2.3.5, 3 und 5
- ESP-IDF Programming Guide, GPIO & RTC GPIO, Sleep Modes, ADC Oneshot Mode Driver, je Chip
- esptool-Dokumentation, Boot Mode Selection, je Chip
Die Zuordnung von Symptom zu Verdacht ist Erfahrung und keine Datenblattangabe; belegt sind die Pinlisten dahinter.
Stand geprüft am 3. August 2026.