Come installare CircuitPython su M5Stack Cardputer
27 Feb 2025
0 Commenti
Oggi abbiamo buone notizie. M5Stack Cardputer può ora utilizzare CircuitPython. E abbiamo un test per l'M5Stack Cardputer. CircuitPython funziona bene.
Scopriamo come installare CircuitPython su M5Stack Cardputer e come utilizzare la programmazione in Python.
Guida all'installazione passo dopo passo
Passo 1: Scarica il firmware CircuitPython
Visita la pagina ufficiale di download di CircuitPython:
Questa pagina elenca il firmware specificamente costruito per il M5Stack Cardputer.
Seleziona l'ultima versione stabile:
A partire dal 25 febbraio 2025, l'ultima versione stabile è probabilmente CircuitPython 9.2.4 (o una versione 9.x più recente se disponibile).
Cerca un file chiamato qualcosa come adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin.
Link di download diretto (basato sulla versione stabile attuale):
Salva il file:
Scarica il file .bin in una posizione facilmente accessibile sul tuo computer (ad esempio, Desktop o cartella Download).
Passo 2: Accedi alla modalità Bootloader su M5Stack Cardputer
Spegni il dispositivo:
Se il Cardputer è acceso, scollegalo dal cavo USB o spegnilo.
Collegati al computer:
Collega un'estremità del cavo USB-C al tuo computer e lascia l'altra estremità scollegata per ora.
Entra in modalità bootloader:
Trova il pulsante BOOT sul M5Stack Cardputer (tipicamente sul lato o sul fondo, a seconda del layout; controlla la documentazione del M5Stack Cardputer se non sei sicuro).
Premere e tenere premuto il pulsante BOOT.
Tenendo premuto il pulsante BOOT, collegare il cavo USB-C al Cardputer.
Continua a tenere premuto il pulsante BOOT per circa 1-2 secondi dopo averlo collegato, poi rilascialo.
Il dispositivo dovrebbe ora essere in modalità bootloader.
Verifica modalità bootloader:
Sul tuo computer, dovrebbe apparire una nuova unità USB chiamata RPI-RP2 (o simile, che indica il bootloader ESP32-S3).
Se non appare alcun disco, ripeti il processo, assicurandoti di tenere premuto il pulsante BOOT abbastanza a lungo durante la connessione.
Passo 3: Installa il Firmware
Copia il file .bin:
Apri l'unità RPI-RP2 nel tuo esploratore di file (ad esempio, Esplora file su Windows, Finder su macOS).
Trascina e rilascia il file .bin scaricato (ad esempio, adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) sull'unità RPI-RP2.
In alternativa, copia e incolla il file nell'unità.
Attendere l'installazione:
L'unità si chiuderà automaticamente e il Cardputer si riavvierà una volta che il firmware è stato copiato (questo richiede alcuni secondi).
Non scollegare il cavo USB durante questo processo.
Conferma Installazione:
Dopo il riavvio, l'unità USB dovrebbe riapparire, ora chiamata CIRCUITPY.
Apri l'unità CIRCUITPY per confermare che contenga file come boot.py o README.txt. Questo indica che CircuitPython è stato installato con successo.
Passo 4: Testa l'Installazione
Collegati a un terminale seriale (opzionale ma consigliato):
Usa uno strumento come Mu Editor (il più semplice per i principianti), PuTTY (Windows) o screen (macOS/Linux) per connetterti alla porta seriale del Cardputer.
Trova la porta COM:
Windows: Controlla Gestione dispositivi per una nuova porta COM (ad es., COM3).
macOS/Linux: Esegui ls /dev/tty* e cerca /dev/ttyUSB0 o /dev/ttyACM0.
Nell'editor Mu:
Apri Mu, seleziona la modalità “Seriale” e connettiti alla porta rilevata.
Dovresti vedere un prompt REPL di Python (>>>).
Esegui un test semplice
Passo 5: Prepararsi all'uso
Controlla la cartella lib:
Apri CIRCUITPY e cerca una cartella lib. Se è vuota o non esiste, creane una manualmente (CIRCUITPY/lib/).
Qui è dove aggiungerai in seguito librerie esterne (ad esempio, adafruit-circuitpython-requests.mpy).
Salva il tuo codice:
Crea un file chiamato code.py nella directory principale di CIRCUITPY per eseguire automaticamente il tuo programma all'avvio.
Risoluzione dei problemi
Nessun drive RPI-RP2 appare:
Assicurati che il cavo USB supporti i dati (testalo con un altro se possibile).
Controlla due volte il tempo di pressione del pulsante BOOT: tienilo premuto fino a dopo che l'USB è connesso.
Prova una porta USB diversa sul tuo computer.
L'unità appare ma non accetta .bin:
Verifica che il file .bin corrisponda al M5Stack Cardputer (non a un'altra scheda).
Ridiscarica il file per assicurarti che non sia corrotto.
Nessun CIRCUITPY dopo l'installazione:
Disconnetti e riconnetti il cavo USB.
Se continua a non funzionare, ripeti il processo con un nuovo download del file .bin.
Connessione seriale non riuscita:
Assicurati che la porta COM corretta sia selezionata.
Installa i driver USB se necessario (ESP32-S3 utilizza tipicamente driver integrati, ma controlla M5Stack Docs per i dettagli).
Prossimi passi
Una volta installato CircuitPython, puoi aggiungere le librerie nella cartella lib e caricare il tuo codice (ad esempio, lo script API DeepSeek). Se hai bisogno di aiuto con quella parte o incontri errori, fammelo sapere e ti guiderò ulteriormente!
