# Repetido

En general, existen varios IDEs que permiten programar microcontroladores, entre estos tenemos: Visual Studio Code (necesita instalar el plugin o extensión PyMark), UpyCraf, Atom, Zerynth, y Thonny. En particular, esta guía se centrará en el IDE Thonny. Thonny es un entorno de desarrollo integrado para Python y diseñado para principiantes por el Instituto de Ciencias de la Computación de la Universidad de Tartu, Estonia.

Para proceder a la instalación y programación de un microcontrolador usando Thonny, esta guía se encuentra divida en: i) instalación de las librerías COM-USB, ii) Pasos para instalar Thonny en sistemas operativos Windows. iii) Actualización del firmware, iv) Se realiza el programa hola mundo y finalmente. v) Evaluación de comandos básicos, vi) Ejemplo de programación encendido y apagado de leds.

Cabe indicar que este documento se ha creado para entornos de Sistemas Operativos Windows.

## Instalación de las librerías COM-USB

Para poder conectarnos a una placa mediante los puertos USB de tu computador, lo primero que se debe de hacer es instalar la libreria que permita reconocer al microcontrolador. En este sentido a continuación se indica los pasos a seguir:
1. Abra el siguiente links https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers y hacer click en la sesión de descargas. Descargue el instalador según el sistema operativo que usted tenga instalado. En la figura se observa el instalador para sistemas operativos Windows.


2. Decomprima el archivo .zip y proceda a instalar el controlador según la versión de sistema operativo 64 o 32 bits que tenga instalado. En la figura siguiente se observa la carpeta descomprimida correspondiente al archivo descargado.


3. Una vez finalizado de instalar el controlador el mensaje siguiente muestra que el controlador está listo para ser usado con éxito.


4. La placa cuenta con un puerto micro USB el cual permite ser utilizado para alimentar la corriente y a la vez permite de entrada para el código de programación. A continuación proceda a conectar un cable micro USB a la placa y al puerto USB al computador. Por lo general, en sistemas operativos windows una vez que se conecte los dispositivos emite un sonido donde se indica que el sistema operativo ha reconocido dicha placa.

6. Para verificar que la placa se encuentra reconocida proceda a entrar a "Panel de control", y luego haga click en el programa de "Administrador de dispositivos", y dentro del programa verifique el nodo "Puertos (COM)" en dicho nodo debe aparecer "Silicon Labs CP210x USB to UART Bridge (COM4)". Por lo general suele asignarse el COM4. También, puede ser otro puerto por ejemplo COM5, COMn. En la figura siguiente se muestra lo comentado.


7. Felicitaciones, proceda con la siguiente fase.

## Instalación de Thonny en Sistemas Operativos Windows

A continuación se procede a instalar el software Thonny el mismo que nos permite interactuar con nuestro microcontrolador. Para más de detalles de la instalación usando Python proceda con el siguiente [url](https://github.com/thonny/thonny/wiki/Windows).

1. Descargue el instalador en el sitio oficial de Thonny y guarde el instalador en su carpeta de recursos:
[Sitio oficial Thonny](https://thonny.org/)

2. Proceda con los pasos de instalación de Thonny.


3. Acepte los Los términos de licencia Thonny y opcionamente si desea crear un acceso directo. Presione siguiente


4. Proceda a instalar.



5. Una vez haya culminado la instalación, proceda abrir el programa y si así lo desea puede cambiar el idioma a castellano. Para realizar lo indicado, seleccione la opción "Tools" y luego haga click en "Options" y en la siguiente venta proceda a seleccionar el lenguaje. Lo indicado se encuentra en la siguiente figura. Nota.- Para que los cambios de idiomas se vean refleados se debe cerrar el software Thonny y volver abrir.


## Actualización del firmware de la placa

Hasta este momento se ha instalado el IDE de programación. A continuación se procede a indicar los pasos a seguir para actualizar la placa con la última actualización del firmware disponbile de MicroPython.

1. Comprobar que la placa se encuentra disponible. Para este propósito, primero que debemos analizar es la comunicación entre Thonny y la placa (microcontrolador).
1.1 Abra el programa Thonny.
1.2 Haga click en la opción del menu Ejecutar y luego en "Elegir interprete"
1.3 En la opción intérprete seleccione MicroPython(ESP32)
1.4 En la opción de Puerto seleccione la opción que identifique el puerto de la sección previa. En este caso se selecciona la opción "Silicon Labs CP210x USB to UART bridge (COM4)". Los detalles se muestran en la figura siguiente:

1.5 Cabe indicar que las demás pestañas permite la configuración del entorno del IDE como por ejemplo, fuentes, terminal, etc..; Proceda a dar click en el boton "Ok".
1.6 Una vez, realizado click se muestra la ventana de "Consola". Si la ventana de consola muestra bloque similares a la siguiente figura, significa que la comunicación entre la placa y el software Thonny está disponible.

2. Una vez, comprobada la comunicación entre la placa y el sistema operativo junto a Thonny, lo siguiente a realizar es la actualización del firmware. Proceda a descargar del siguiente sitio la versión estable de MicroPython.

[https://micropython.org/download/esp32/](https://micropython.org/download/esp32/)

4. Descargue la opción que se muestra en la figura siguiente y guarde el archivo en una carpeta de sus recursos: 

5. A continuación, dar click en la opción "Ejecutar" del menu de Thonny.
6. Proceder hacer click en "Instalar o actualizar el firmware" que se encuentra con color azul. Dicha opción abrirá una nueva ventana (ESP32 firmware Installer).

7. En la ventana "ESP32 firmware installer" seleccione el puerto respectivo en este caso será COM4 y ubique el archivo descargado del paso anterior.
8. Los modo de Flash dejarlo por defecto. Y el check habilitarlo tal como se muestra en la figura.

10. Proceda a dar click en instalar. La instalación mostrará algunos mensajes que corresponde al proceso de conexión, borrado de la memoria y al proceso de escritura.


11. Si todo ha ido correcto el proceso de actualizar su placa para entornos de programación MicroPython ha culminado con éxito.


12. Finalmente, al dar click en aceptar la ventana de consola debe aparecer lo siguiente


## Interfaz de Thonny y validar los primeros comandos.

Una vez, que se haya configurado el firmware en la placa, se procede a evaluar comandos básicos del entorno de MicroPython, para posterior crear un primer programa. Para este próposito conecte la placa al USB del computador. **Para probar la instalación, hay que decirle a Thonny que queremos ejecutar el intérprete de MicroPython que hay instalado en la placa.** A continuación se detallan los pasos:

1. Haz click en Ejecutar > Selecciona la primera opción "Elegir interprete"

2. Selecciona MicroPython (ESP8266) o MicroPython (ESP32) dependiendo del modelo que estés usando.

3. A continuación debes seleccionar el puerto al que está conectada la placa. En la figura siguiente se muestra lo anteriormente indicado.


4. El editor Thonny IDE debería estar ahora conectado a la placa y deberías ver el prompt desde el intérprete de comandos (Consola). En la figura siguente se muestra una figura con cuatro áreas señaladas con distintos colores. En la parte inferior, área de color amarillo es el espacio de consola de comandos o intérprete de comandos. En dicha área el interprete debe mostrarse tal como la figura esto significa que la conexión con la placa es correcta. Por otro lado, en la parte superior izquierda de color verde se encuentra el espacio para nuestras carpetas de trabajos. El área de color azul corresponde al área donde se edita el código python. Finalmente el área de color rojo, muestra los archivos de python que tiene la placa para su ejecución (por lo general son dos main.py y boot.py). Más detalles se indicarán en posteriores talleres.


5. A continuación en la línea de comando área de amarillo digite los siguientes comandos e interprete la respuesta obtenida.
* help()
* help('modules')
* help('ujson')
* help(math)

6. Finalmente, se procede a crear el primer programa. Para esto escriba el código que se encuentra al final en el área de color azul y proceda a grabar. El IDE Thonny le mostrará una pantalla en donde ofrece dos espacios de almacenamientos de sus archivos. El primero corresponde al directorio de su computador local y el segundo corresponde a la escritura directa en la placa. Dele un nombre a su primer programa ["sample1.py"] En las figuras siguientes se muestra el código y la opción de almacenamiento del mismo:


print("Mi primer programa en MicroPython")

7. Ejecute su código.