Zum Hauptinhalt springen

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.

Noch immer blockiert?​