Fehlerbehebung
Beginnen Sie mit dem Symptom, das Sie beobachten können. Nehmen Sie jeweils nur eine Änderung vor und versuchen Sie es dann erneut mit dem kleinsten Beispiel aus dem Schnellstart.
Verbindung und Upload
Das Board erscheint nicht als Port
Manche USB-Kabel übertragen nur Strom. Probieren Sie ein Kabel, von dem Sie wissen, dass es Daten überträgt, und stecken Sie es direkt am Computer ein, nicht über einen Hub. Das Board kommuniziert über einen CH340K USB-zu-Seriell-Chip mit Ihrem Computer. Installieren Sie daher den CH340-Treiber, falls Ihr System ihn nicht erkennt.
Der Upload schlägt fehl oder kann keine Verbindung herstellen
Prüfen Sie, ob Tools → Board und Tools → Port zu diesem Board passen. Schließen Sie alles, was den Port sonst geöffnet hat (Serieller Monitor oder ein anderes Terminal), denn nur ein Programm kann ihn gleichzeitig nutzen. Schlägt es weiterhin fehl, versetzen Sie das Board in den Bootloader-Modus und laden Sie erneut hoch: Halten Sie die Taste USER gedrückt, drücken und lassen Sie RESET los und lassen Sie dann USER los.
Serielle Ausgabe
Der Serielle Monitor zeigt zufällige Zeichen
Die Baudrate im Seriellen Monitor stimmt nicht mit der im Sketch überein. Stellen Sie das Dropdown-Menü in der Ecke des Seriellen Monitors auf den Wert in Serial.begin() ein.
Der Serielle Monitor bleibt leer
Drücken Sie bei geöffnetem Seriellen Monitor die Taste RESET des Boards: Möglicherweise hat der Sketch etwas ausgegeben, bevor der Monitor verbunden war. Prüfen Sie außerdem, ob Tools → USB CDC On Boot auf Disabled steht. Der USB-C-Connector dieses Boards ist über den CH340K an UART0 mit dem ESP32-S3 verbunden, daher muss Serial auf UART0 bleiben.
Die MicroPython-REPL reagiert nicht
Drücken Sie Ctrl-C, um ein laufendes Programm zu beenden, und anschließend Ctrl-D für einen Soft-Reset.
Erscheint weiterhin kein >>>-Prompt, prüfen Sie, ob das Terminal auf 115200
Baud eingestellt ist, schließen Sie andere Programme, die den Port nutzen, und prüfen Sie, ob Sie die
ESP32_GENERIC_S3-Firmware mit Octal-SPIRAM-Unterstützung (SPIRAM_OCT) geflasht haben, also die
Firmware für das Modul dieses Boards.
Spannungsversorgung
Das Board startet von selbst neu, oft beim Start von WLAN
Die Versorgung kommt mit den Stromspitzen nicht zurecht, 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 aktiven Hub, ein kürzeres Kabel oder einen geladenen Akku.
Ein angeschlossener Sensor oder ein Modul funktioniert nicht
Die GPIO-Pins arbeiten mit 3,3-V-Logik. Ein 5-V-Signal an einem GPIO-Pin kann das Board beschädigen. Schließen Sie daher 5-V-Bauteile über einen Pegelwandler an und versorgen Sie jedes Bauteil mit der Spannung, die in seiner eigenen Dokumentation verlangt wird.
Nichts leuchtet, oder das Board wird warm
Ziehen Sie es sofort ab und trennen Sie alles, was daran angeschlossen ist. Suchen Sie nach einem Kurzschluss zwischen Versorgungsspannung und Masse und schließen Sie dann die Bauteile einzeln wieder an. Ist ein Akku angeschlossen, prüfen Sie seine Polarität anhand der Markierung + und - neben dem Connector: Akkustecker verschiedener Hersteller sind nicht alle gleich belegt.
Erstes Programm
Der Upload hat funktioniert, aber die LED leuchtet nicht
Die RGB-LED ist eine WS2812B an GPIO6. Sie benötigt Farbdaten, die rgbLedWrite() sendet, und LED_BUILTIN des generischen Boards zeigt auf GPIO48, nicht auf diese LED. Verwenden Sie rgbLedWrite(6, ...) wie im Schnellstart und prüfen Sie, dass an dem Header-Pin 6, der dieselbe Leitung ist, nichts anderes angeschlossen ist.
Board-spezifische Probleme
CAN funktioniert über USB, aber nicht mit Akku
Der CAN-Transceiver benötigt 4,5 bis 5,5 V, die er aus USB oder vom Pin VCC bezieht. Allein mit Akkubetrieb schaltet er bei Unterspannung ab, während der ESP32-S3 weiterläuft. Versorgen Sie das Board über USB-C oder speisen Sie 4,5 bis 5,5 V in VCC ein, sobald es auf dem Bus kommunizieren soll.
Sie müssen den CAN-Abschluss des Boards entfernen
Das Board verbindet standardmäßig einen 120-Ω-Abschlusswiderstand zwischen CAN_H und CAN_L. Trennen Sie JP3 auf der Unterseite auf, um ihn zu entfernen. Siehe Jumper in Hardware-Details.