Diseño de Sistemas Digitales Docente: Ing.

Roger Guachalla Narváez

xoroger@yahoo.es

P07B – Subida de Librerías al Firmware MicroPython con WebREPL

Introducción
Una característica única de MicroPython en el ESP8266 y el módulo WiFi es WebREPL (ciclo de lectura-evaluación-
impresión, como una 'línea de comando' de Python) accesible a través de una página web.
En lugar de utilizar una conexión en serie, con cable USB, con la placa, se puede ejecutar el código Python directamente
desde un navegador en un terminal serial simple, además permite subir módulos o librerías al firmware Micropython del
NodeMCU ESP2866. Ni siquiera es necesario conectar la placa a una red WiFi, se puede una red propia que se usa para
acceder a WebREPL.
Esta guía explicará cómo habilitar y acceder a WebREPL en MicroPython ESP8266. Tener en cuenta que solo la versión
ESP8266 de MicroPython es compatible con WebREPL, y además que WebREPL es una característica experimental que se
encuentra en desarrollo activo.

Acceso a WebREPL

1. Habilitar WebREPL

El primer paso para usar WebREPL es habilitarlo en la tarjeta NodeMCU. A partir de la versión 1.8.6 de MicroPython, el
WebREPL no está habilitado de forma predeterminada y debe habilitarse con un comando que se ejecute a través del
puerto serie.
Para habilitar WebREPL conectar la placa utilizando la conexión USB serial con ESPLORES y ejecutar el siguiente comando:

import webrepl_setup

Se solicitará activar o desactivar el WebREPL y además establecer una contraseña. Ingresar opciones para ambas
indicaciones y luego presione ‘y’ cuando se le solicite guardar y reiniciar.

2. Acceder a WebREPL
Una vez que se ejecuta WebREPL, se puede conectar a través de la red WiFi del ESP8266. Si la tarjeta aún no está
conectada a un punto de acceso inalámbrico, creará uno con el que se puede conectar desde el computador
Para conectarse a la red WiFi de la tarjeta, en el computador buscar la red WiFi anunciada como ‘MicroPython-***’ donde
*** es un conjunto de números y letras único para cada tarjeta ESP8266 (según su dirección MAC).
Seleccionar esta red e ingresar la contraseña: micropythoN para conectarse al punto de acceso de la tarjeta (la N está en
mayúscula).
A continuación, se debe tener disponible la página web del cliente WebREPL en el computador. Puede acceder a la página
web del cliente desde micropython.org (asumiendo que el computador puede estar conectado tanto a Internet como a la
red de la tarjeta NodeMCU) o descargarla desde: https://github.com/micropython/webrepl/archive/master.zip
Después de descargar el cliente WebREPL, extraer los archivos y abrir webrepl.html en el navegador (Firefox y Chrome son
los navegadores oficialmente compatibles).
Tomar en cuenta que no se puede acceder a la página del cliente WebREPL directamente desde la placa ESP8266. Para
ahorrar espacio en la memoria flash, el ESP8266 solo proporciona una interfaz websocket y no la página web del cliente
real. Se debe descargar la página del cliente WebREPL con anticipación o acceder a ella desde Internet.
Una vez que se haya cargado la página del cliente WebREPL, se verá lo siguiente:

Confirmar que el computador esté conectado a la red WiFi del ESP8266, luego hacer clic en el botón Conectar (usando la
dirección predeterminada de ws: //192.168.4.1: 8266 / al lado del botón).
Una vez conectado, WebREPL solicitará que ingrese la contraseña que se estableció al ejecutar el comando webrepl_setup
anteriormente. Ingresar la contraseña que se estableció para continuar.
Ingrese el siguiente código Python en WebREPL para verificar su funcionameinto. WebREPL funciona igual que el REPL
serial y puede usarse para programar con MicroPython.

Subida de librerías al Firmware MicroPython

En la página WebRPEPL, hacer clic en el botón ‘Examinar’ de la opción ‘Enviar un archivo’:

Seleccionar el archivo de la librería (para este ejemplo ‘LCD.py’) o módulo que se quiere enviar a la tarjeta y hacer clic en
‘Enviar a Dispositivo’

Después de unos segundos se indicará que el archivo ha sido enviado (mostrando el número de bytes). A partir de este
instante la librería se encuentra grabada en el firmware MicroPython de la tarjeta NodeMCU y puede usarse como
cualquier otra librería.