Hoe CircuitPython te installeren op M5Stack Cardputer
27 Feb 2025
0 Opmerkingen
Vandaag hebben we goed nieuws. M5Stack Cardputer kan nu CircuitPython gebruiken. En we hebben een test voor de M5Stack Cardputer. CircuitPython werkt prima.
Laten we ontdekken hoe we CircuitPython op de M5Stack Cardputer kunnen installeren en hoe we Python-programmering kunnen gebruiken.
Stapsgewijze Installatiegids
Stap 1: Download CircuitPython Firmware
Bezoek de officiële CircuitPython downloadpagina:
Ga naar CircuitPython voor M5Stack Cardputer.
Deze pagina bevat firmware die specifiek is gebouwd voor de M5Stack Cardputer.
Selecteer de nieuwste stabiele versie:
Vanaf 25 februari 2025 is de nieuwste stabiele versie waarschijnlijk CircuitPython 9.2.4 (of een nieuwere 9.x-release als deze beschikbaar is).
Zoek naar een bestand met een naam zoals adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Directe downloadlink (gebaseerd op de huidige stabiele versie):
Bestand opslaan:
Download het .bin-bestand naar een gemakkelijk toegankelijke locatie op je computer (bijv. Bureaublad of map Downloads).
Stap 2: Voer de Bootloader-modus in op de M5Stack Cardputer
Schakel het apparaat uit:
Als de Cardputer is ingeschakeld, koppel deze dan los van de USB-kabel of zet hem uit.
Verbind met computer:
Steek één uiteinde van de USB-C-kabel in je computer en laat het andere uiteinde voorlopig los.
Voer de opstartmodus in:
Zoek de BOOT-knop op de M5Stack Cardputer (typisch aan de zijkant of onderkant, afhankelijk van de indeling; raadpleeg de M5Stack Cardputer Docs als je het niet zeker weet).
Druk op de BOOT-knop en houd deze ingedrukt.
Houd de BOOT-knop ingedrukt en sluit de USB-C-kabel aan op de Cardputer.
Blijf de BOOT-knop ongeveer 1-2 seconden ingedrukt houden na het aansluiten, en laat deze dan los.
Het apparaat zou nu in de bootloader-modus moeten zijn.
Controleer opstartmodus:
Op uw computer zou er een nieuwe USB-stick moeten verschijnen met de naam RPI-RP2 (of iets dergelijks, dat de ESP32-S3 bootloader aangeeft).
Als er geen schijf verschijnt, herhaal dan het proces en zorg ervoor dat je de BOOT-knop lang genoeg ingedrukt houdt tijdens de verbinding.
Stap 3: Installeer de Firmware
Kopieer het .bin-bestand:
Open de RPI-RP2-schijf in je bestandsverkenner (bijv. Verkenner op Windows, Finder op macOS).
Sleep het gedownloade .bin-bestand (bijv. adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) naar de RPI-RP2-schijf.
Alternatief, kopieer en plak het bestand in de schijf.
Wacht op installatie:
De schijf sluit automatisch en de Cardputer zal opnieuw opstarten zodra de firmware is gekopieerd (dit duurt een paar seconden).
Koppel de USB-kabel tijdens dit proces niet los.
Bevestig installatie:
Na het opnieuw opstarten zou de USB-stick weer moeten verschijnen, nu met de naam CIRCUITPY.
Open de CIRCUITPY-schijf om te bevestigen dat deze bestanden bevat zoals boot.py of een README.txt. Dit geeft aan dat CircuitPython succesvol is geïnstalleerd.
Stap 4: Test de installatie
Verbind met een seriële terminal (optioneel maar aanbevolen):
Gebruik een tool zoals Mu Editor (het gemakkelijkst voor beginners), PuTTY (Windows) of screen (macOS/Linux) om verbinding te maken met de seriële poort van de Cardputer.
Zoek de COM-poort:
Windows: Controleer Apparaatbeheer op een nieuwe COM-poort (bijv. COM3).
macOS/Linux: Voer ls /dev/tty* uit en zoek naar /dev/ttyUSB0 of /dev/ttyACM0.
In Mu-editor:
Open Mu, selecteer de "Seriële" modus en maak verbinding met de gedetecteerde poort.
Je zou een Python REPL-prompt (>>>) moeten zien.
Voer een eenvoudige test uit
Stap 5: Voorbereiden voor Gebruik
Controleer lib-map:
Open CIRCUITPY en zoek naar een lib-map. Als deze leeg is of niet bestaat, maak dan handmatig een aan (CIRCUITPY/lib/).
Dit is waar je later externe bibliotheken zult toevoegen (bijv. adafruit-circuitpython-requests.mpy).
Bewaar uw code:
Maak een bestand met de naam code.py in de CIRCUITPY rootdirectory om je programma automatisch bij het opstarten uit te voeren.
Probleemoplossen
Geen RPI-RP2-stuurprogramma verschijnt:
Zorg ervoor dat de USB-kabel gegevens ondersteunt (test met een andere als dat mogelijk is).
Controleer de timing van de BOOT-knop nogmaals—houd deze ingedrukt totdat de USB is aangesloten.
Probeer een andere USB-poort op je computer.
Schijf verschijnt maar accepteert geen .bin:
Controleer of het .bin-bestand overeenkomt met de M5Stack Cardputer (niet met een ander bord).
Download het bestand opnieuw om te zorgen dat het niet beschadigd is.
Geen CIRCUITPY Na Installatie:
Koppel de USB-kabel los en weer aan.
Als het nog steeds niet lukt, herhaal dan het proces met een nieuwe .bin-download.
Seriële verbinding mislukt:
Zorg ervoor dat de juiste COM-poort is geselecteerd.
Installeer USB-stuurprogramma's indien nodig (ESP32-S3 gebruikt meestal ingebouwde stuurprogramma's, maar controleer M5Stack Docs voor specificaties).
Volgende stappen
Zodra CircuitPython is geïnstalleerd, kun je bibliotheken toevoegen aan de lib-map en je code uploaden (bijv. het DeepSeek API-script). Als je hulp nodig hebt met dat deel of fouten tegenkomt, laat het me weten, en ik zal je verder helpen!
