Fehlerbehebung
Beginnen Sie mit dem Symptom, das Sie beobachten können. Nehmen Sie jeweils nur eine Änderung vor und probieren Sie dann das kleinste Beispiel aus dem Schnellstart erneut aus.
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 an, nicht über einen Hub. Der RP2040 übernimmt USB selbst, daher braucht das Board keinen separaten USB-zu-Seriell-Driver.
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 noch geöffnet hat (Serial Monitor, Thonny oder ein anderes Terminal), denn der Port kann nur von einem Programm gleichzeitig verwendet werden.
Wenn das Board nicht mehr reagiert, beantwortet es möglicherweise die Reset-Anforderung des Uploads nicht. Ziehen Sie es ab, halten Sie die Taste BOOT gedrückt, während Sie es wieder anstecken, und führen Sie den Upload erneut aus. Dadurch startet der USB-Bootloader des RP2040, der den Upload entgegennimmt.
Der Port ändert sich oder verschwindet nach einem Upload
Ein Board mit nativem USB startet seine USB-Verbindung nach jedem Upload oder Reset neu, und der Port kann unter einem anderen Namen wieder erscheinen. Wählen Sie den Port unter Tools → Port erneut aus, bevor Sie den Serial Monitor öffnen.
Serielle Ausgabe
Der Serial Monitor zeigt zufällige Zeichen an
Die Baudrate im Serial Monitor stimmt nicht mit der im Sketch überein. Stellen Sie die Auswahlliste in der Ecke des Serial Monitor auf den Wert in Serial.begin() ein, im Beispiel aus dem Schnellstart ist das 115200.
Der Serial Monitor bleibt leer
Drücken Sie bei geöffnetem Serial Monitor die Taste RESET des Boards: Der Sketch hat möglicherweise schon etwas ausgegeben, bevor sich der Monitor verbunden hat.
Strom und Spannung
Das Board startet von selbst neu, oft wenn WLAN startet
Die Stromversorgung kommt mit den Stromspitzen nicht zurecht, und der Chip startet neu, wenn die Spannung einbricht. 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 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 seiner eigenen Dokumentation verlangt wird.
Nichts leuchtet, oder das Board wird warm
Trennen Sie es sofort vom Strom und entfernen 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 dessen Verdrahtung, bevor Sie ihn erneut anstecken: Akkustecker verschiedener Hersteller sind nicht alle gleich verdrahtet. Siehe Stromversorgung.
Board-spezifische Probleme
Windows erkennt das Board nicht
Die Windows-Store-Version der Arduino IDE hat Probleme, RP2040-Boards zu erkennen. Installieren Sie stattdessen die Arduino IDE von arduino.cc, verwenden Sie dabei das normale Windows-Installationsprogramm oder das Windows-ZIP, und erlauben Sie die Installation aller Gerätetreiber, die vorgeschlagen werden.
Unter Linux endet der Upload mit „No drive to deploy“
Eine über Flatpak installierte Arduino IDE (das viele Linux-App-Stores verwenden) hat eingeschränkten Zugriff auf Ihren Computer, sodass Uploads mit folgendem Fehler fehlschlagen können:
Scanning for RP2040 devices
...
No drive to deploy.
Installieren Sie die Arduino IDE auf anderem Weg, oder erlauben Sie ihr den Zugriff mit diesem Befehl und starten Sie die IDE anschließend neu:
flatpak override --user --filesystem=host:ro cc.arduino.IDE2