Wie man CircuitPython auf M5Stack Cardputer installiert
27 Feb 2025
0 Kommentare
Heute haben wir gute Nachrichten. Der M5Stack Cardputer kann jetzt CircuitPython verwenden. Und wir haben einen Test für den M5Stack Cardputer. CircuitPython läuft einwandfrei.
Lass uns herausfinden, wie man CircuitPython auf dem M5Stack Cardputer installiert und wie man Python-Programmierung verwendet.
Schritt-für-Schritt-Installationsanleitung
Schritt 1: Laden Sie die CircuitPython-Firmware herunter
Besuchen Sie die offizielle CircuitPython-Downloadseite:
Gehe zu CircuitPython für M5Stack Cardputer.
Diese Seite listet die speziell für den M5Stack Cardputer entwickelte Firmware auf.
Wählen Sie die neueste stabile Version aus:
Stand Februar 25, 2025, ist die neueste stabile Version wahrscheinlich CircuitPython 9.2.4 (oder eine neuere 9.x-Version, falls verfügbar).
Suchen Sie nach einer Datei mit einem Namen wie adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Direkter Download-Link (basierend auf der aktuellen stabilen Version):
Speichern Sie die Datei:
Laden Sie die .bin-Datei an einem leicht zugänglichen Ort auf Ihrem Computer herunter (z. B. Desktop oder Downloads-Ordner).
Schritt 2: Bootloader-Modus auf M5Stack Cardputer eingeben
Gerät ausschalten:
Wenn der Cardputer eingeschaltet ist, trennen Sie ihn vom USB-Kabel oder schalten Sie ihn aus.
Mit Computer verbinden:
Stecken Sie ein Ende des USB-C-Kabels in Ihren Computer und lassen Sie das andere Ende vorerst unverbunden.
Bootloader-Modus eingeben:
Suchen Sie die BOOT-Taste am M5Stack Cardputer (typischerweise an der Seite oder unten, je nach Layout; überprüfen Sie die M5Stack Cardputer-Dokumentation, wenn Sie sich nicht sicher sind).
Drücken und halten Sie die BOOT-Taste.
Halten Sie die BOOT-Taste gedrückt und schließen Sie das USB-C-Kabel an den Cardputer an.
Halten Sie die BOOT-Taste etwa 1-2 Sekunden lang gedrückt, nachdem Sie sie angeschlossen haben, und lassen Sie sie dann los.
Das Gerät sollte sich jetzt im Bootloader-Modus befinden.
Bootloader-Modus überprüfen:
Auf Ihrem Computer sollte ein neues USB-Laufwerk erscheinen, das RPI-RP2 (oder ähnlich, was auf den ESP32-S3-Bootloader hinweist) genannt wird.
Wenn kein Laufwerk angezeigt wird, wiederholen Sie den Vorgang und stellen Sie sicher, dass Sie die BOOT-Taste während der Verbindung lange genug gedrückt halten.
Schritt 3: Installieren Sie die Firmware
Kopieren Sie die .bin-Datei:
Öffnen Sie das RPI-RP2-Laufwerk in Ihrem Datei-Explorer (z. B. Datei-Explorer unter Windows, Finder unter macOS).
Ziehen Sie die heruntergeladene .bin-Datei (z. B. adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) auf das RPI-RP2-Laufwerk.
Alternativ können Sie die Datei in das Laufwerk kopieren und einfügen.
Warten auf Installation:
"Das Laufwerk wird automatisch geschlossen, und der Cardputer wird neu gestartet, sobald die Firmware kopiert wurde (dies dauert einige Sekunden)."
Trennen Sie das USB-Kabel während dieses Vorgangs nicht.
Installation bestätigen:
Nach dem Neustart sollte das USB-Laufwerk wieder erscheinen, jetzt mit dem Namen CIRCUITPY.
Öffnen Sie das CIRCUITPY-Laufwerk, um zu bestätigen, dass es Dateien wie boot.py oder README.txt enthält. Dies zeigt an, dass CircuitPython erfolgreich installiert ist.
Schritt 4: Testen Sie die Installation
Mit einem seriellen Terminal verbinden (Optional, aber empfohlen):
Verwenden Sie ein Tool wie Mu Editor (am einfachsten für Anfänger), PuTTY (Windows) oder screen (macOS/Linux), um eine Verbindung zum seriellen Port des Cardputers herzustellen.
Suchen Sie den COM-Port:
Windows: Überprüfen Sie den Geräte-Manager auf einen neuen COM-Port (z. B. COM3).
macOS/Linux: Führen Sie ls /dev/tty* aus und suchen Sie nach /dev/ttyUSB0 oder /dev/ttyACM0.
Im Mu Editor:
Öffnen Sie Mu, wählen Sie den Modus „Serial“ und verbinden Sie sich mit dem erkannten Port.
Sie sollten eine Python REPL-Eingabeaufforderung (>>>) sehen.
Führen Sie einen einfachen Test durch
Schritt 5: Vorbereitung zur Benutzung
Überprüfen Sie den Lib-Ordner:
Öffne CIRCUITPY und suche nach einem lib-Ordner. Wenn er leer ist oder nicht existiert, erstelle einen manuell (CIRCUITPY/lib/).
Hier werden Sie später externe Bibliotheken hinzufügen (z. B. adafruit-circuitpython-requests.mpy).
Speichern Sie Ihren Code:
Erstellen Sie eine Datei mit dem Namen code.py im Wurzelverzeichnis von CIRCUITPY, um Ihr Programm beim Booten automatisch auszuführen.
Fehlerbehebung
Kein RPI-RP2-Laufwerk erscheint:
Stellen Sie sicher, dass das USB-Kabel Daten unterstützt (testen Sie es, wenn möglich, mit einem anderen).
Überprüfen Sie die Timing des BOOT-Buttons – halten Sie ihn gedrückt, bis der USB angeschlossen ist.
Versuchen Sie einen anderen USB-Anschluss an Ihrem Computer.
Laufwerk erscheint, akzeptiert aber keine .bin:
Überprüfen Sie, ob die .bin-Datei mit dem M5Stack Cardputer übereinstimmt (nicht mit einem anderen Board).
Lade die Datei erneut herunter, um sicherzustellen, dass sie nicht beschädigt ist.
Kein CIRCUITPY nach der Installation:
Trennen Sie das USB-Kabel und schließen Sie es wieder an.
Wenn es weiterhin fehlschlägt, wiederholen Sie den Prozess mit einem neuen .bin-Download.
Serielle Verbindung fehlgeschlagen:
Stellen Sie sicher, dass der richtige COM-Port ausgewählt ist.
Installieren Sie USB-Treiber, falls erforderlich (ESP32-S3 verwendet normalerweise integrierte Treiber, aber überprüfen Sie M5Stack Docs für Einzelheiten).
Nächste Schritte
Sobald CircuitPython installiert ist, kannst du Bibliotheken in den lib-Ordner hinzufügen und deinen Code hochladen (z. B. das DeepSeek API-Skript). Wenn du Hilfe bei diesem Teil benötigst oder auf Fehler stößt, lass es mich wissen, und ich werde dich weiter anleiten!
