Guía Paso a Paso: Instalación de MicroPython y Programación de la ESP8266 NodeMCU Amica en Linux Mint

Autor: AlexanderArias Londoño
Clase: IoT
Fecha: 6 de octubre de 2026

La tarjeta de desarrollo ESP8266 NodeMCU Amica es una plataforma versátil y económica ampliamente utilizada en proyectos de Internet de las Cosas (IoT). Programar este dispositivo con MicroPython bajo Linux Mint permite crear aplicaciones empotradas eficientes utilizando la sintaxis de Python.

Esta guía paso a paso abarca desde la preparación inicial de Linux Mint y la resolución de conflictos con puertos serie, hasta el flasheado del firmware, la resolución de problemas comunes como el bucle de reinicio (boot loop) y la configuración de Thonny IDE para ejecutar scripts interactivos.

1. Preparación del Sistema Operativo Linux Mint

Antes de conectar la tarjeta ESP8266, es necesario preparar el entorno de Linux Mint para asegurar la correcta detección del convertidor serie USB (generalmente los chips CP2102 o CH340).

Paso 1.1: Diagnóstico del hardware USB con `lsusb`

Conecte la tarjeta ESP8266 a la computadora utilizando un cable USB que soporte transmisión de datos. Abra una terminal (Ctrl + Alt + T) y ejecute:

lsusb

Examine la lista desplegada. Debe identificar una línea similar a una de las siguientes:

Bus 001 Device 005: ID 10c4:ea60 Silicon Labs CP210x UART Bridge
Bus 001 Device 004: ID 1a86:7523 QinHeng Electronics CH340 serial converter

Nota de diagnóstico: Si no aparece ninguna línea nueva al conectar la placa, reemplace el cable USB. Muchos cables comerciales económicos solo incluyen líneas de alimentación eléctrica y carecen de hilos de datos.

Paso 1.2: Eliminación del servicio conflictivo `brltty`

En distribuciones basadas en Debian y Ubuntu como Linux Mint, el servicio del sistema brltty (diseñado para lectores de pantalla Braille) intercepta automáticamente los convertidores USB-Serie al detectarlos, provocando que el puerto /dev/ttyUSB0 desaparezca a los pocos segundos de ser creado.

Para eliminar esta interferencia, desinstale el paquete ejecutando:

sudo apt remove brltty

Paso 1.3: Asignación de permisos de acceso serie (`dialout`)

Por defecto, los dispositivos serie en Linux pertenecen al grupo de sistema dialout. Para interactuar con la tarjeta sin requerir permisos de superusuario (sudo), agregue su usuario actual al grupo:

sudo usermod -aG dialout $USER

Importante: Debe cerrar la sesión en Linux Mint y volver a iniciarla para que el sistema aplique el cambio de grupo.

Paso 1.4: Confirmación del puerto `/dev/ttyUSB0`

Reconecte la tarjeta a la computadora y verifique la creación del puerto serie:

ls /dev/ttyUSB*

Si la terminal responde con /dev/ttyUSB0, la comunicación física está correctamente establecida.

2. Creación del Entorno Virtual de Python e Instalación de `esptool`

Para cumplir con las especificaciones de gestión de paquetes de Python en Linux Mint (PEP 668), la herramienta oficial de flasheado de Espressif (esptool) debe instalarse dentro de un entorno virtual aislado.

Cree un entorno virtual denominado esp_env en su carpeta personal:
```
python3 -m venv esp_env
```
Active el entorno virtual:
```
source esp_env/bin/activate
```
(Verá la etiqueta (esp_env) al inicio del indicador de la terminal).
Instale o actualice esptool:
```
pip install esptool
```

3. Descarga y Flasheado del Firmware de MicroPython

A diferencia de los microcontroladores ESP32 (donde la memoria flash se graba a partir de la dirección 0x1000), en la arquitectura ESP8266 la imagen del firmware debe escribirse comenzando exactamente en la dirección 0x0.

Paso 3.1: Descarga del firmware binario

Visite la sección oficial de descargas de MicroPython para ESP8266 en micropython.org/download/esp8266.
Descargue la versión estable más reciente en formato .bin y guarde el archivo en su carpeta ~/Descargas.

Paso 3.2: Borrado de la memoria flash

Con el entorno (esp_env) activo en la terminal, elimine el contenido previo de la memoria flash de la tarjeta:

esptool --port /dev/ttyUSB0 --chip esp8266 erase-flash

Espere aproximadamente 10 segundos hasta que la terminal confirme Flash memory erased successfully.

Paso 3.3: Grabación del firmware en modo `dout`

Muchas tarjetas NodeMCU Amica cuentan con memorias flash SPI que requieren el modo de comunicación dout (Dual Output) y una asignación explícita del tamaño de memoria (4MB). Usar otros modos (como dio o qio) puede causar que la placa falle al arrancar.

Ejecute el siguiente comando de grabado:

esptool --port /dev/ttyUSB0 --chip esp8266 write-flash --flash-mode dout --flash-size 4MB 0x0 ~/Descargas/ESP8266_GENERIC-*.bin

Sugerencia de conexión: Si la terminal muestra el mensaje Connecting......_____, mantenga presionado el botón físico FLASH (o BOOT) de la placa durante 2 segundos hasta que comience el progreso de transferencia.

Al llegar al 100%, desconecta el cable USB del ordenador, espera 5 segundos y vuelve a conectarlo para realizar un reinicio eléctrico completo del chip.

4. Diagnóstico de Caracteres Extraños y Bucle de Reinicio (Boot Loop)

Si al intentar conectar la tarjeta observa que el LED azul parpadea rápidamente de forma ininterrumpida y en la terminal aparecen caracteres raros o símbolos corruptos ($plN|...), la placa se encuentra en un bucle de reinicio.

¿Por qué ocurren los caracteres extraños?

Al encenderse o reiniciar, el gestor de arranque (bootloader) del chip ESP8266 emite mensajes de diagnóstico a una velocidad nativa de 74880 baudios. Como los entornos como Thonny escuchan a la velocidad estándar de 115200 baudios, esa diferencia de velocidad provoca que el texto legible se convierta en símbolos extraños.

Verificación del diagnóstico con `miniterm`

Para leer los mensajes de diagnóstico reales del bootloader y confirmar la causa del reinicio, puede abrir una terminal a 74880 baudios:

python3 -m serial.tools.miniterm /dev/ttyUSB0 74880

Si observa texto legible indicando el estado del sistema, presione Ctrl + ] (o cierre la terminal) para salir de miniterm.
Si confirma que la tarjeta se reinicia continuamente, la causa principal es haber flasheado sin la opción --flash-mode dout. Repita el Paso 3.2 y Paso 3.3 asegurándose de incluir --flash-mode dout.

5. Configuración de Thonny IDE

Una vez grabado el firmware correctamente y realizado el reinicio eléctrico, configure el entorno Thonny:

Inicie la aplicación Thonny en Linux Mint.
Vaya al menú superior Herramientas > Opciones... (Tools > Options...).
Seleccione la pestaña Intérprete (Interpreter).
En la opción de microcontrolador, seleccione MicroPython (ESP8266).
En la opción de puerto, seleccione /dev/ttyUSB0.
Presione Aceptar.

Haga clic en la consola inferior (Shell) de Thonny y presione Ctrl + C o Ctrl + D. Verá aparecer la consola interactiva con el prompt >>>:

MicroPython v1.2x.x on 2026-xx-xx; ESP module with ESP8266
Type "help()" for more information.
>>>

6. Pruebas de Funcionamiento y Control de E/S con `machine`

En la tarjeta ESP8266 NodeMCU Amica, el LED azul integrado en la placa está conectado al pin GPIO 2 (marcado en la serigrafía como D4).

Mapeo de estados y lógica invertida

El circuito del LED integrado en la ESP8266 funciona con lógica invertida:

Nivel Lógico	Estado en MicroPython	Nivel de Voltaje	Estado del LED
0 (LOW)	`led.value(0)`	0 V (GND)	ENCENDIDO
1 (HIGH)	`led.value(1)`	3.3 V	APAGADO

Código de prueba interactivo (Shell)

Escriba las siguientes órdenes directamente en la consola >>> de Thonny para encender y apagar el LED:

import machine

# Configurar GPIO 2 como salida digital
led = machine.Pin(2, machine.Pin.OUT)

# Encender el LED azul integrado
led.value(0)

# Apagar el LED azul integrado
led.value(1)

Programa autónomo de parpadeo (`main.py`)

Para que la tarjeta ejecute la rutina de forma automática cada vez que se conecte a la energía sin depender de la computadora:

En Thonny, cree un archivo nuevo (Archivo > Nuevo).

Copie el siguiente código:

import machine
import time

# Pin GPIO 2 correspondiente al LED de la NodeMCU
led = machine.Pin(2, machine.Pin.OUT)

# Bucle principal de parpadeo
while True:
    led.value(0)   # Encender LED (0V / LOW)
    time.sleep(1)  # Esperar 1 segundo
    led.value(1)   # Apagar LED (3.3V / HIGH)
    time.sleep(1)  # Esperar 1 segundo

Guarde el archivo seleccionando como destino Dispositivo MicroPython (MicroPython device).
Asígnele el nombre exacto main.py.

Al presionar el botón de reinicio RST de la NodeMCU Amica, el programa main.py se iniciará automáticamente, haciendo parpadear el LED de forma indefinida.

Diseño Electrónico

martes, 6 de octubre de 2026