I dag har vi gode nyheder. M5Stack Cardputer kan nu bruge CircuitPython. Og vi har en test for M5Stack Cardputer. CircuitPython kører fint.
Lad os finde ud af, hvordan man installerer CircuitPython på M5Stack Cardputer, og hvordan man bruger Python-programmering.
Trin-for-trin installationsvejledning
Trin 1: Download CircuitPython-firmware
Besøg den officielle CircuitPython-downloadside:
Denne side viser firmware, der er specifikt bygget til M5Stack Cardputer.
Vælg den seneste stabile version:
Pr. 25. februar 2025 er den seneste stabile version sandsynligvis CircuitPython 9.2.4 (eller en nyere 9.x-udgivelse, hvis tilgængelig).
Se efter en fil med et navn som adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Direkte downloadlink (baseret på den nuværende stabile version):
Gem filen:
Download .bin-filen til et let tilgængeligt sted på din computer (f.eks. Skrivebord eller Downloads-mappen).
Trin 2: Gå ind i Bootloader-tilstand på M5Stack Cardputer
Sluk enheden:
Hvis Cardputer er tændt, skal du afbryde det fra USB-kablet eller slukke det.
Tilslut til computer:
Sæt den ene ende af USB-C-kablet i din computer, og lad den anden ende være frakoblet for nu.
Gå ind i Bootloader-tilstand:
Find BOOT-knappen på M5Stack Cardputer (typisk på siden eller bunden, afhængigt af layoutet; tjek M5Stack Cardputer Docs, hvis du er i tvivl).
Tryk og hold BOOT-knappen nede.
Mens du holder BOOT-knappen nede, skal du tilslutte USB-C-kablet til Cardputer.
Fortsæt med at holde BOOT-knappen nede i cirka 1-2 sekunder efter tilslutning, og slip den derefter.
Enheden bør nu være i bootloader-tilstand.
Bekræft bootloader-tilstand:
På din computer bør et nyt USB-drev dukke op med navnet RPI-RP2 (eller lignende, hvilket indikerer ESP32-S3 bootloaderen).
Hvis der ikke vises noget drev, gentag processen og sørg for at holde BOOT-knappen nede længe nok under tilslutning.
Trin 3: Installer firmwaren
Kopier .bin-filen:
Åbn RPI-RP2-drevet i din filudforsker (f.eks. Stifinder på Windows, Finder på macOS).
Træk og slip den downloadede .bin-fil (f.eks. adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) på RPI-RP2-drevet.
Alternativt kan du kopiere og indsætte filen i drevet.
Vent på installationen:
Drevet lukker automatisk, og Cardputer genstarter, når firmwaren er kopieret (det tager et par sekunder).
Frakobl ikke USB-kablet under denne proces.
Bekræft installationen:
Efter genstart bør USB-drevet dukke op igen, nu med navnet CIRCUITPY.
Åbn CIRCUITPY-drevet for at bekræfte, at det indeholder filer som boot.py eller en README.txt. Dette indikerer, at CircuitPython er installeret korrekt.
Trin 4: Test installationen
Forbind til en seriel terminal (valgfrit, men anbefalet):
Brug et værktøj som Mu Editor (nemmest for begyndere), PuTTY (Windows) eller screen (macOS/Linux) for at forbinde til Cardputerens serielle port.
Find COM-porten:
Windows: Tjek Enhedshåndtering for en ny COM-port (f.eks. COM3).
macOS/Linux: Kør ls /dev/tty* og kig efter /dev/ttyUSB0 eller /dev/ttyACM0.
I Mu Editor:
Åbn Mu, vælg “Serial” tilstand, og forbind til den fundne port.
Du bør se en Python REPL-prompt (>>>).
Kør en simpel test
Trin 5: Forbered til brug
Tjek lib-mappen:
Åbn CIRCUITPY og kig efter en lib-mappe. Hvis den er tom eller ikke findes, opret en manuelt (CIRCUITPY/lib/).
Her vil du senere tilføje eksterne biblioteker (f.eks. adafruit-circuitpython-requests.mpy).
Gem din kode:
Opret en fil med navnet code.py i CIRCUITPY-rodbiblioteket for automatisk at køre dit program ved opstart.
Fejlfinding
Ingen RPI-RP2-drev vises:
Sørg for, at USB-kablet understøtter data (test med et andet, hvis muligt).
Dobbelttjek BOOT-knappens timing – hold den nede indtil efter USB er tilsluttet.
Prøv en anden USB-port på din computer.
Drevet vises, men accepterer ikke .bin:
Bekræft, at .bin-filen matcher M5Stack Cardputer (ikke et andet board).
Download filen igen for at sikre, at den ikke er beskadiget.
Ingen CIRCUITPY efter installation:
Frakobl og tilslut USB-kablet igen.
Hvis det stadig fejler, gentag processen med en frisk .bin-download.
Seriel forbindelse fejler:
Sørg for, at den korrekte COM-port er valgt.
Installer USB-drivere om nødvendigt (ESP32-S3 bruger typisk indbyggede drivere, men tjek M5Stack Docs for detaljer).
Næste skridt
Når CircuitPython er installeret, kan du tilføje biblioteker til lib-mappen og uploade din kode (f.eks. DeepSeek API-scriptet). Hvis du har brug for hjælp til den del eller støder på fejl, så lad mig det vide, så guider jeg dig videre!
