Idag har vi goda nyheter. M5Stack Cardputer kan nu använda CircuitPython. Och vi har ett test för M5Stack Cardputer. CircuitPython fungerar bra.
Låt oss ta reda på hur man installerar CircuitPython på M5Stack Cardputer och hur man använder Python-programmering.
Steg-för-steg installationsguide
Steg 1: Ladda ner CircuitPython-firmware
Besök den officiella nedladdningssidan för CircuitPython:
Gå till CircuitPython för M5Stack Cardputer.
Den här sidan listar firmware som är specifikt byggd för M5Stack Cardputer.
Välj den senaste stabila versionen:
Från och med den 25 februari 2025 är den senaste stabila versionen sannolikt CircuitPython 9.2.4 (eller en nyare 9.x-version om tillgänglig).
Sök efter en fil med ett namn som adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Direkt nedladdningslänk (baserat på nuvarande stabil version):
Spara filen:
Ladda ner .bin-filen till en lättillgänglig plats på din dator (t.ex. Skrivbordet eller mappen Hämtade filer).
Steg 2: Gå in i Bootloader-läge på M5Stack Cardputer
Stäng av enheten:
Om Cardputern är påslagen, koppla bort den från USB-kabeln eller stäng av den.
Anslut till dator:
Anslut ena änden av USB-C-kabeln till din dator och låt den andra änden vara frånkopplad för tillfället.
Gå in i Bootloader-läge:
Leta upp BOOT-knappen på M5Stack Cardputer (vanligtvis på sidan eller undersidan, beroende på layout; kontrollera M5Stack Cardputer Docs om du är osäker).
Tryck och håll in BOOT-knappen.
Medan du håller in BOOT-knappen, anslut USB-C-kabeln till Cardputern.
Fortsätt hålla in BOOT-knappen i ungefär 1-2 sekunder efter anslutning, släpp sedan.
Enheten bör nu vara i bootloader-läge.
Verifiera bootloader-läge:
På din dator bör en ny USB-enhet dyka upp med namnet RPI-RP2 (eller liknande, vilket indikerar ESP32-S3 bootloader).
Om ingen enhet visas, upprepa processen och se till att du håller in BOOT-knappen tillräckligt länge under anslutningen.
Steg 3: Installera firmware
Kopiera .bin-filen:
Öppna RPI-RP2-enheten i din filutforskare (t.ex. File Explorer på Windows, Finder på macOS).
Dra och släpp den nedladdade .bin-filen (t.ex. adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) på RPI-RP2-enheten.
Alternativt, kopiera och klistra in filen i enheten.
Vänta på installationen:
Enheten stängs automatiskt och Cardputern startar om när firmware har kopierats (detta tar några sekunder).
Koppla inte ur USB-kabeln under denna process.
Bekräfta installationen:
Efter omstart bör USB-enheten dyka upp igen, nu med namnet CIRCUITPY.
Öppna CIRCUITPY-enheten för att bekräfta att den innehåller filer som boot.py eller en README.txt. Detta indikerar att CircuitPython är installerat korrekt.
Steg 4: Testa installationen
Anslut till en seriell terminal (valfritt men rekommenderas):
Använd ett verktyg som Mu Editor (lättast för nybörjare), PuTTY (Windows) eller screen (macOS/Linux) för att ansluta till Cardputerns seriella port.
Hitta COM-porten:
Windows: Kontrollera Enhetshanteraren för en ny COM-port (t.ex. COM3).
macOS/Linux: Kör ls /dev/tty* och leta efter /dev/ttyUSB0 eller /dev/ttyACM0.
I Mu Editor:
Öppna Mu, välj ”Serial”-läge och anslut till den upptäckta porten.
Du bör se en Python REPL-prompt (>>>).
Kör ett enkelt test
Steg 5: Förbered för användning
Kontrollera lib-mappen:
Öppna CIRCUITPY och leta efter en mapp som heter lib. Om den är tom eller inte finns, skapa en manuellt (CIRCUITPY/lib/).
Här kommer du senare att lägga till externa bibliotek (t.ex. adafruit-circuitpython-requests.mpy).
Spara din kod:
Skapa en fil med namnet code.py i CIRCUITPY:s rotkatalog för att köra ditt program automatiskt vid start.
Felsökning
Ingen RPI-RP2-enhet visas:
Se till att USB-kabeln stödjer data (testa med en annan om möjligt).
Dubbelkolla BOOT-knappens timing – håll den intryckt tills efter att USB är ansluten.
Prova en annan USB-port på din dator.
Enheten visas men accepterar inte .bin:
Verifiera att .bin-filen matchar M5Stack Cardputer (inte en annan enhet).
Ladda ner filen igen för att säkerställa att den inte är korrupt.
Ingen CIRCUITPY efter installation:
Koppla ur och anslut USB-kabeln igen.
Om det fortfarande misslyckas, upprepa processen med en ny nedladdning av .bin-filen.
Seriell anslutning misslyckas:
Se till att rätt COM-port är vald.
Installera USB-drivrutiner vid behov (ESP32-S3 använder vanligtvis inbyggda drivrutiner, men kolla M5Stack Docs för detaljer).
Nästa steg
När CircuitPython är installerat kan du lägga till bibliotek i lib-mappen och ladda upp din kod (t.ex. DeepSeek API-skriptet). Om du behöver hjälp med det eller stöter på fel, låt mig veta så guidar jag dig vidare!
