Comment installer CircuitPython sur M5Stack Cardputer
27 Feb 2025
0 commentaires
Aujourd'hui, nous avons de bonnes nouvelles. Le M5Stack Cardputer peut maintenant utiliser CircuitPython. Et nous avons un test pour le M5Stack Cardputer. CircuitPython fonctionne bien.
Découvrons comment installer CircuitPython sur M5Stack Cardputer et comment utiliser la programmation Python.
Guide d'installation étape par étape
Étape 1 : Téléchargez le firmware CircuitPython
Visitez la page de téléchargement officielle de CircuitPython :
Allez à CircuitPython pour M5Stack Cardputer.
Cette page répertorie le firmware spécifiquement conçu pour le M5Stack Cardputer.
Sélectionnez la dernière version stable :
À partir du 25 février 2025, la dernière version stable est probablement CircuitPython 9.2.4 (ou une version 9.x plus récente si disponible).
Recherchez un fichier nommé quelque chose comme adafruit-circuitpython-m5stack_cardputer-fr_FR-9.2.4.bin.
Lien de téléchargement direct (basé sur la version stable actuelle) :
Enregistrer le fichier :
Téléchargez le fichier .bin dans un emplacement facilement accessible sur votre ordinateur (par exemple, Bureau ou dossier Téléchargements).
Étape 2 : Entrer en mode bootloader sur la carte M5Stack
Éteindre l'appareil :
Si le Cardputer est allumé, déconnectez-le du câble USB ou éteignez-le.
Se connecter à l'ordinateur :
Branchez une extrémité du câble USB-C à votre ordinateur et laissez l'autre extrémité déconnectée pour l'instant.
Entrer en mode bootloader :
Localisez le bouton BOOT sur le M5Stack Cardputer (généralement sur le côté ou en bas, selon la disposition ; consultez la documentation M5Stack Cardputer si vous n'êtes pas sûr).
Appuyez et maintenez le bouton BOOT.
Tout en maintenant le bouton BOOT enfoncé, connectez le câble USB-C au Cardputer.
Continuez à maintenir le bouton BOOT pendant environ 1 à 2 secondes après la connexion, puis relâchez-le.
L'appareil devrait maintenant être en mode bootloader.
Vérifier le mode de démarrage :
Sur votre ordinateur, un nouveau lecteur USB devrait apparaître nommé RPI-RP2 (ou similaire, indiquant le chargeur de démarrage ESP32-S3).
Si aucun lecteur n'apparaît, répétez le processus en vous assurant de maintenir le bouton BOOT suffisamment longtemps pendant la connexion.
Étape 3 : Installer le micrologiciel
Copiez le fichier .bin :
Ouvrez le lecteur RPI-RP2 dans votre explorateur de fichiers (par exemple, l'Explorateur de fichiers sur Windows, le Finder sur macOS).
Faites glisser et déposez le fichier .bin téléchargé (par exemple, adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) sur le lecteur RPI-RP2.
Alternativement, copiez et collez le fichier dans le lecteur.
Attendre l'installation :
Le lecteur se fermera automatiquement et le Cardputer redémarrera une fois le firmware copié (cela prend quelques secondes).
Ne déconnectez pas le câble USB pendant ce processus.
Confirmer l'installation :
Après le redémarrage, la clé USB devrait réapparaître, maintenant nommée CIRCUITPY.
Ouvrez le lecteur CIRCUITPY pour confirmer qu'il contient des fichiers comme boot.py ou un README.txt. Cela indique que CircuitPython est installé avec succès.
Étape 4 : Tester l'installation
Se connecter à un terminal série (optionnel mais recommandé) :
Utilisez un outil comme Mu Editor (le plus facile pour les débutants), PuTTY (Windows) ou screen (macOS/Linux) pour se connecter au port série du Cardputer.
Trouver le port COM :
Windows : Vérifiez le Gestionnaire de périphériques pour un nouveau port COM (par exemple, COM3).
macOS/Linux : Exécutez ls /dev/tty* et recherchez /dev/ttyUSB0 ou /dev/ttyACM0.
Dans l'éditeur Mu :
Ouvrez Mu, sélectionnez le mode « Série » et connectez-vous au port détecté.
Vous devriez voir un invite REPL Python (>>>).
Exécuter un test simple
Étape 5 : Préparez-vous à l'utilisation
Vérifiez le dossier lib :
Ouvrez CIRCUITPY et recherchez un dossier lib. S'il est vide ou n'existe pas, créez-en un manuellement (CIRCUITPY/lib/).
C'est ici que vous ajouterez plus tard des bibliothèques externes (par exemple, adafruit-circuitpython-requests.mpy).
Enregistrez votre code :
Créez un fichier nommé code.py dans le répertoire racine de CIRCUITPY pour exécuter votre programme automatiquement au démarrage.
Dépannage
Aucun lecteur RPI-RP2 n'apparaît :
Assurez-vous que le câble USB prend en charge les données (testez avec un autre si possible).
Vérifiez à nouveau le timing du bouton BOOT—maintenez-le enfoncé jusqu'à ce que le USB soit connecté.
Essayez un autre port USB sur votre ordinateur.
Le lecteur apparaît mais n'accepte pas .bin :
Vérifiez que le fichier .bin correspond à la M5Stack Cardputer (et non à une autre carte).
Téléchargez à nouveau le fichier pour vous assurer qu'il n'est pas corrompu.
Pas de CIRCUITPY après l'installation :
Déconnectez et reconnectez le câble USB.
Si cela échoue encore, répétez le processus avec un nouveau téléchargement .bin.
Échec de la connexion série :
Assurez-vous que le bon port COM est sélectionné.
Installez les pilotes USB si nécessaire (l'ESP32-S3 utilise généralement des pilotes intégrés, mais vérifiez M5Stack Docs pour les détails).
Prochaines étapes
Une fois CircuitPython installé, vous pouvez ajouter des bibliothèques dans le dossier lib et télécharger votre code (par exemple, le script API DeepSeek). Si vous avez besoin d'aide à ce sujet ou si vous rencontrez des erreurs, faites-le moi savoir, et je vous guiderai davantage !
