Fehlerbehebung
Beginnen Sie mit dem Symptom, das Sie beobachten können. Nehmen Sie jeweils nur eine Änderung vor und wiederholen Sie dann das kleinste Beispiel aus dem Schnellstart.
Verbindung und Upload
Das Board erscheint nicht als Port
Manche USB-Kabel übertragen nur Strom. Versuchen Sie ein Kabel, von dem Sie wissen, dass es Daten überträgt, und stecken Sie es direkt in den Computer statt in einen Hub. Der USB-C-Connector des Boards führt über einen USB-zu-Seriell-Chip CH340K, und manche Computer benötigen einen CH340-Treiber, bevor der Port erscheint. Wenn bei Ihnen kein Port angezeigt wird, installieren Sie den CH340-Treiber für Ihr Betriebssystem und stecken Sie das Board danach erneut an.
Der Upload schlägt fehl oder kann keine Verbindung herstellen
Prüfen Sie, ob unter Tools > Board der Eintrag Soldered NULA Dual ESP32C5 eingestellt und der Port des Boards ausgewählt ist. Schließen Sie alles, was den Port sonst noch geöffnet hat (Serial Monitor, ein MicroPython-Terminal oder idf.py monitor), da ihn immer nur ein Programm nutzen kann.
Für Uploads sind normalerweise keine Tasten nötig, da die automatische Reset-Schaltung das Board selbstständig in den Download-Modus versetzt. Schlägt der Upload trotzdem fehl, versetzen Sie das Board von Hand in den Download-Modus und laden Sie erneut hoch: Halten Sie die Benutzertaste (die an IO28) gedrückt, drücken und lösen Sie die Reset-Taste und lassen Sie dann die Benutzertaste los.
Serielle Ausgabe
Der Serial Monitor zeigt zufällige Zeichen an
Die Baudrate im Serial Monitor stimmt nicht mit der im Sketch überein. Stellen Sie das Dropdown-Menü in der Ecke des Serial Monitor auf den Wert in Serial.begin() ein.
Der Serial Monitor bleibt leer
Drücken Sie bei geöffnetem Serial Monitor die Reset-Taste des Boards: Der Sketch hat möglicherweise schon etwas ausgegeben, bevor der Monitor verbunden war. Serial führt bei diesem Board über den CH340K zu den Pins RX und TX und funktioniert daher mit USB CDC On Boot in der Standardeinstellung Disabled.
Die MicroPython-REPL reagiert nicht
Drücken Sie Ctrl-C, um ein laufendes Programm zu stoppen, und dann Ctrl-D für einen Soft-Reset. Wenn weiterhin kein >>>-Prompt erscheint, prüfen Sie, ob das Terminal auf 115200 Baud eingestellt ist, schließen Sie andere Programme, die den Port verwenden, und prüfen Sie, ob Sie die Firmware ESP32_GENERIC_C5 geflasht haben, also die für den Chip dieses Boards.
Stromversorgung und Spannung
Das Board startet von selbst neu, oft beim Start von WLAN
Die Stromversorgung kommt den Stromspitzen nicht hinterher, und der Chip startet neu, wenn die Spannung einbricht (bei einem ESP32 meldet das Log, dass der Brownout-Detektor ausgelöst wurde). Verwenden Sie einen USB-Port direkt am Computer oder einen Hub mit eigener Stromversorgung, ein kürzeres Kabel oder einen geladenen Akku.
Ein angeschlossener Sensor oder ein Modul funktioniert nicht
Die GPIO-Pins (General-Purpose Input/Output) arbeiten mit 3,3-V-Logik. Ein 5-V-Signal an einem GPIO-Pin kann das Board beschädigen. Schließen Sie 5-V-Bauteile daher über einen Pegelwandler an und versorgen Sie jedes Bauteil mit der Spannung, die in dessen eigener Dokumentation angegeben ist.
Nichts leuchtet, oder das Board wird warm
Ziehen Sie sofort den Stecker und trennen Sie alles, was daran angeschlossen ist. Suchen Sie nach einem Kurzschluss zwischen Versorgungsspannung und Masse und schließen Sie dann ein Bauteil nach dem anderen wieder an. Wenn ein Akku angeschlossen ist, prüfen Sie vor dem erneuten Anstecken, ob dessen Stecker so verdrahtet ist, wie es der Akku-Connector des Boards erwartet: Akkustecker verschiedener Hersteller sind nicht alle gleich verdrahtet.
Erstes Programm
Der Upload hat funktioniert, aber die LED blinkt nicht
Die RGB-LED (eine LED mit Rot-, Grün- und Blaukanal) ist eine adressierbare WS2812B an IO8 und keine einfache LED. Sie benötigt daher Daten statt eines konstanten Pegels. Prüfen Sie in der Arduino IDE, ob das Board auf Soldered NULA Dual ESP32C5 eingestellt ist: Erst seine Board-Definition sorgt dafür, dass LED_BUILTIN die RGB-LED ansteuert. Verwenden Sie in MicroPython das Modul neopixel an Pin 8, wie im Schnellstart. Prüfen Sie in ESP-IDF die GPIO-Nummer und den LED-Typ im Menü Example Configuration: Das Blink-Beispiel benötigt auf diesem Board LED strip und GPIO 8.
Board-spezifische Probleme
Das Board führt nach einem Reset Ihr Programm nicht aus
IO28 ist einer der Boot-Pins des Chips. Ist er beim Verlassen des Resets auf Low, während GPIO27 (ein weiterer Boot-Pin, der auf dem Board durch einen Pull-up auf High gehalten wird) auf High liegt, startet der Chip im Download-Modus und wartet auf einen Upload, statt Ihr Programm auszuführen. Lassen Sie die Benutzertaste los, bevor Sie Reset drücken, und prüfen Sie, dass nichts, was an IO28 an der Stiftleiste angeschlossen ist, den Pin beim Start auf Low zieht.