ESP32 en minutos con MicroPython y VSCode

En esta guía te explico paso a paso cómo configurar Visual Studio Code (VSCode), instalar MicroPython, y lanzar tu primer proyectos en cuestión de minutos. Una forma rápida, práctica y sencilla de iniciarte en la programación de microcontroladores.

¿Qué vamos a necesitar?

Estos elementos que vas a ver, son los que yo tengo ahora mismo para hacer este tutorial. Si tienes un placa similar pero no es la misma, debe valerte igual (porque es en todas prácticamente lo mismo) pero asegúrate antes de empezar.

esp32 devkit c v2

visual studio code

micropython

micro usb

Componentes varios

¡Vamos paso por paso!

Al principio puede parecer un poco abrumador e incluso complicado, pero no te preocupes, porque vamos a verlo al detalle para que no te pierdas en ningún momento. Te hago un resumen de los pasos que vamos a seguir y luego vamos con ellos al detalle.

1. Instalar Micropython en el ESP32

2. Preparación del entorno de VSCode.

3. Tu primer programa (con ChatGPT): Encendiendo LEDs.

¿Puedo programar ESP32 con MicroPython?

Pues claro que puedes, de hecho es bastante fácil.

Lo primero que tienes que hacer para poder programar con este lenguaje el ESP32 es instalarlo en la placa, así que vamos con ello.

Cmd + Espacio

Conecta tu ESP32 a tu PC

MacOS

Escribe Terminal y pulsa Intro

Windows

¿Cómo instalar micropython en un esp32?

Una vez que has conectado la placa y tienes el terminal abierto vamos a hacer los siguientes puntos. Recuerda que puedes consultar la documentación oficial de micropython si necesitas alguna información adicional.

Windows + R

Escribe cmd y pulsa Intro

Firmware

python

pip

esptool

Revisa si tienes Python instalado

Si no lo tienes instalado...

Descarga el firmware de micropython

Si no lo has descargado del enlace de arriba hazlo ahora, lo necesitamos para flashear (borrar y grabar de nuevo) el esp32. Verás que lo primero que te aparece son las instrucciones, pero si sigues bajando verás que llegas al firmware. Descarga la última versión disponible (latest).

Cuando tengas el firmware descargado necesitarás ESPTool. Esto es una herramienta del fabricante que te permite flashear la placa e instalar micropython para que podamos trabajar con este lenguaje.

Antes de seguir asegúrate de cómo se llama tu puerto de comunicación con el ESP32

MacOS

ls /dev/tty.usb*

Ahora vamos a seguir las instrucciones que marca la guía de micropython que te he dejado en el icono de arriba.

Con la instalación que hemos hecho ya deberías tener pip instalado. Si no estuviera instalado, pon en google "instalar pip <>" y sustituye <> por tu sistema operativo. Así tendrás la versión más actualizada de cómo hacerlo.

Windows

mode

Vamos a trabajar con la versión 3 de Python.

Dale a Cancelar, lo vamos a instalar de una forma mucho más sencilla.

Esto que hemos hecho aquí, certifica que no tienes python instalado.

Haz click en el enlace que tienes arriba y te llevará a la página de descargas de python (selecciona automáticamente el archivo para tu sistema operativo).

Descarga el paquete, haz doble click y sigue las instrucciones y dale a aceptar a todo. Cuando termine el proceso tendrás instalado python3 correctamente.

Puedes verificarlo de la siguiente manera

MacOS

python3 --version

Instalamos la herramienta

Borramos la flash del ESP32

Instalamos MicroPython

Revisa el puerto de conexión

Asegurate de que indicas el puerto para evitar errores

Revisa la ruta del archivo

Aquí ya lo tenemos instalado en la placa y ya podemos pasar al VSCode. Ahora ya es instalar un par de cosas rápidas y empezar a hacer proyectos.

Windows

Ve a la ruta y ejecútalo desde ahí

* Aunque hay bastantes más formas de comprobarlo, te he pueso la que creo que es más sencilla, sin meternos en procesos más largos.

Esto te mostrará los puertos COM que están en uso actualmente, si solo hay uno ya lo has identificado, si hubiera más uno, puedes desconectar el cable y volver a conectarlo y ver cuál es el puerto que aparece y desaparece.

pip install esptool

esptool.py --port <aqui el puerto> erase_flash

Materiales

Recuerda que puedes comprar los materiales necesarios en estos enlaces y que con esto me ayudas a seguir haciendo tutoriales como este.

¿Cuál es la forma más sencilla de programar esp32?

Pues mira, la verdad es que la forma más sencilla no es la que te voy a contar aquí, por lo menos de inicio, pero he decidido que vamos a empezar de esta manera porque no es mucho más difícil que "la opción sencilla" y luego nos va a aportar muchos beneficios.

¡Recuerda: tienes el enlace en la parte de arriba!

Una vez instalado te saldrá una ventana como la que ves a continuación y tienes que:

1. Ir al gestor de plugins

2. Buscar la extensión Pymakr. (¿Qué es Pymark? Te lo cuento más abajo)

3. Instalar la extensión

4. Verás que te sale en la imagen (sigue la flecha).

Pymakr es un IDE (Entorno de Desarrollo Integrado) para proyectos de MicroPython. En este caso, los desarrolladores han realizado un plugin/extensión para VSCode.

Seguimos, ya queda nada

Crea un proyecto nuevo desde PyMakr

Elige la ubicación que mejor te venga

Confirma el nombre del proyecto

Para este caso elige, led-example

Para este primer ejemplo, vamos a elegir la plantilla que viene por defecto con un código que tenemos que modificar (no viene preparado para esta placa) pero por lo menos no empezamos sobre vacío, que normalmente, suele ser más abrumador.

¡Dos cosas más y lo tenemos!

Conectate al ESP32

Pincha en el icono de establecer conexión

Verás que el icono cambia
Pincha en el icono de terminal
Te tiene que salir el mensaje que ves

Añade el dispositivo al proyecto

Pincha en ADD DEVICES
Selecciona el puerto correcto
Pincha en Aceptar

Ya lo tenemos. ¡Vamos a modificar el código y a ver los primeros resultados!

Materiales

Recuerda que puedes comprar los materiales necesarios en estos enlaces y que con esto me ayudas a seguir haciendo tutoriales como este.

¿Puedes programar ESP32 con VS Code?

Para que este punto sea lo más fácil posible, te voy a dar el código que necesitas usar para este primer ejemplo. De aquí en adelante aprenderás cómo generarlos con ChatGPT o incluso tú mismo si sabes programar.

Y ya está, ahora puedes modificar el código o hacer proyectos nuevos.
¡Disfruta de tus proyectos!

Ve al menú que te muestro en la imagen, modifica el código y asegúrate de guardarlo, de lo contrario no se ejecutará.

Cuando esté el código guardado, fíjate en el recuadro verde y utiliza la nube que tiene una flecha hacía arriba. Ese botón te permitirá subir tu código a la memoria del ESP32. Verás que cuando le das, VSCode te saca un mensaje y te dice que lo ha subido pero que no pasa nada.

Cuando se haya terminado de subir tienes que hacer lo siguiente:

¡Únete a la comunidad!