Cómo instalar CircuitPython en M5Stack Cardputer
27 Feb 2025
0 Comentarios
Hoy tenemos buenas noticias. M5Stack Cardputer ahora puede usar CircuitPython. Y tenemos una prueba para el M5Stack Cardputer. CircuitPython funciona bien.
Descubramos cómo instalar CircuitPython en M5Stack Cardputer y cómo usar la programación en Python.
Guía de instalación paso a paso
Paso 1: Descarga el firmware de CircuitPython
Visita la Página Oficial de Descarga de CircuitPython:
Esta página lista el firmware construido específicamente para el M5Stack Cardputer.
Selecciona la Última Versión Estable:
A partir del 25 de febrero de 2025, la última versión estable es probablemente CircuitPython 9.2.4 (o una versión más nueva de 9.x si está disponible).
Busca un archivo llamado algo como adafruit-circuitpython-m5stack_cardputer-es_ES-9.2.4.bin.
Enlace de descarga directa (basado en la versión estable actual):
Guardar el archivo:
Descarga el archivo .bin a un lugar de fácil acceso en tu computadora (por ejemplo, Escritorio o carpeta de Descargas).
Paso 2: Ingrese al modo Bootloader en M5Stack Cardputer
Apagar el dispositivo:
Si el Cardputer está encendido, desconéctalo del cable USB o apágalo.
Conectar a la computadora:
Conecta un extremo del cable USB-C a tu computadora y deja el otro extremo desconectado por ahora.
Entrar en Modo Bootloader:
Localiza el botón BOOT en el M5Stack Cardputer (típicamente en el lado o en la parte inferior, dependiendo del diseño; consulta la documentación de M5Stack Cardputer si no estás seguro).
Presione y mantenga presionado el botón BOOT.
Mientras mantienes presionado el botón BOOT, conecta el cable USB-C al Cardputer.
Continúe presionando el botón BOOT durante aproximadamente 1-2 segundos después de conectar, luego suéltelo.
El dispositivo debería estar ahora en modo bootloader.
Verificar Modo de Cargador de Arranque:
En tu computadora, debería aparecer una nueva unidad USB llamada RPI-RP2 (o similar, indicando el bootloader ESP32-S3).
Si no aparece ninguna unidad, repita el proceso, asegurándose de mantener presionado el botón de BOOT el tiempo suficiente durante la conexión.
Paso 3: Instalar el Firmware
Copiar el archivo .bin:
Abre la unidad RPI-RP2 en tu explorador de archivos (por ejemplo, Explorador de archivos en Windows, Finder en macOS).
Arrastra y suelta el archivo .bin descargado (por ejemplo, adafruit-circuitpython-m5stack_cardputer-en_US-9.2.4.bin) en la unidad RPI-RP2.
Alternativamente, copia y pega el archivo en la unidad.
Espera la instalación:
El disco se cerrará automáticamente y el Cardputer se reiniciará una vez que se copie el firmware (esto toma unos segundos).
No desconecte el cable USB durante este proceso.
Confirmar instalación:
Después de reiniciar, la unidad USB debería reaparecer, ahora llamada CIRCUITPY.
Abre la unidad CIRCUITPY para confirmar que contiene archivos como boot.py o README.txt. Esto indica que CircuitPython está instalado correctamente.
Paso 4: Prueba la instalación
Conectar a un terminal serie (opcional pero recomendado):
Utiliza una herramienta como Mu Editor (la más fácil para principiantes), PuTTY (Windows) o screen (macOS/Linux) para conectarte al puerto serie del Cardputer.
Encuentra el puerto COM:
Windows: Verifique el Administrador de dispositivos para un nuevo puerto COM (por ejemplo, COM3).
macOS/Linux: Ejecuta ls /dev/tty* y busca /dev/ttyUSB0 o /dev/ttyACM0.
En el editor Mu:
Abre Mu, selecciona el modo "Serial" y conéctate al puerto detectado.
Deberías ver un aviso de Python REPL (>>>).
Ejecutar una prueba sencilla
Paso 5: Preparar para el uso
Comprobar la carpeta lib:
Abre CIRCUITPY y busca una carpeta lib. Si está vacía o no existe, créala manualmente (CIRCUITPY/lib/).
Aquí es donde más tarde agregarás bibliotecas externas (por ejemplo, adafruit-circuitpython-requests.mpy).
Guarda tu código:
Crea un archivo llamado code.py en el directorio raíz de CIRCUITPY para ejecutar tu programa automáticamente al iniciar.
Solución de problemas
No aparece ninguna unidad RPI-RP2:
Asegúrate de que el cable USB soporte datos (prueba con otro si es posible).
Verifica el tiempo del botón de BOOT—manténlo presionado hasta después de que el USB esté conectado.
Prueba un puerto USB diferente en tu computadora.
La unidad aparece pero no acepta .bin:
Verifica que el archivo .bin coincida con el M5Stack Cardputer (no con otra placa).
Vuelve a descargar el archivo para asegurarte de que no esté corrupto.
No CIRCUITPY Después de la Instalación:
Desconecta y vuelve a conectar el cable USB.
Si aún falla, repite el proceso con una nueva descarga de .bin.
Fallo en la conexión serie:
Asegúrese de que se seleccione el puerto COM correcto.
Instala los controladores USB si es necesario (el ESP32-S3 generalmente utiliza controladores integrados, pero consulta M5Stack Docs para más detalles).
Próximos pasos
Una vez que CircuitPython esté instalado, puedes agregar bibliotecas a la carpeta lib y subir tu código (por ejemplo, el script de la API DeepSeek). Si necesitas ayuda con esa parte o encuentras errores, házmelo saber y te guiaré más.
