Instalación del software necesario

1. Instalación de drivers

Los controladores de ESP32 son necesarios para permitir que la PC reconozca y se comunique correctamente con el ESP32 a través de la conexión USB. Los controladores actúan como intermediarios entre el hardware del ESP32 y el sistema operativo.

En este capitulo vemos una guía para descargar e instalar los controladores USB del ESP32.

Primeramente observamos nuestra placa e identificamos el circuito integrado del conversor USB/UART:

En la mayoría de los casos el CI corresponde con el CP2102, si ese fuera el caso:

Accedemos a la página https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers?tab=downloads.

Una vez descargado el Zip, lo descomprimimos:

Copiamos la dirección de ubicación de la carpeta:

Conectamos el dispositivo mediante cable USB.

Abrimos el administrador de dispositivos de Windows y damos doble click en CP2102:

Buscamos e instalamos el controlador manualmente:

Pegamos la ubicación copiada anteriormente:

Finalmente conectamos el ESP32 a la PC y en Puertos COM nos debería aparecer los drivers de Silicon Labs prestando atención al puerto al que está conectado.

NOTA: En caso de que el controlador fuera distinto (ej. CH9102) se deben descargar los drivers correspondientes y seguir los pasos antes mencionados.

2. Instalación Firmware

1. Descargamos el IDE de Python Thonny




2. Conectamos nuestro ESP32 a la PC mediante cable USB
3. Ejecutamos Thonny y nos dirigimos a "Herramientas > Opciones"




4. Nos dirigimos a la pestaña "Intérprete" y en la parte inferior derecha seleccionamos "Instala o actualiza MicroPython (esptool)"




5. Seleccionamos los siguientes campos:

Target port: el que corresponda 

MicroPython family: ESP32

variant: Espressif * ESP32 / WROOM

version: 1.20.0




6. Al instalar y finalizar nos debería mostrar algo similar a la siguiente imagen:
   
   



Si todo esta correcto ya tendremos MicroPython instalado en el ESP32.

⚠️ Únicamente en caso de fallo seguir con el capitulo siguiente.

2.1. Instalación de python y micropython (Alternativo)

1. Para instalar Python accedemos a la tienda de aplicaciones de Microsoft (Microsoft store) desde el menú de inicio, luego buscamos e instalamos Python:




Otra alternativa es descargar e instalar Python desde la pagina oficial https://www.python.org/

Este paso es necesario para poder ejecutar la herramienta "esptool"

2. Accedemos a https://micropython.org/download/esp32/ para descargar el firmware de micropython para ESP32 en su ultima versión (latest):



3. Copiamos la dirección de la ubicación del archivo BIN descargado.
Haciendo click en la barra de direcciones podremos seleccionar como texto y copiarlo presionando las teclas CTRL+C:




4. Luego conectamos el ESP32 mediante cable USB y abrimos el terminal de Windows PowerShell.
Para ello vamos al menú inicio y tecleamos "powershell" una vez que ubicamos el ejecutable lo ejecutamos como administrador.




5. En la terminal ejecutamos la siguiente línea de comandos: "pip install esptool"




6. Luego ejecutamos la siguiente línea de comando:

python -m esptool --chip esp32 --port COMX erase_flash

utilizando el numero de puerto correspondiente a nuestro dispositivo:




7. Finalmente dentro del PowerShell nos ubicamos en la carpeta cuya dirección la copiamos anteriormente y donde se encuentra el archivo BIN. Para ello utilizamos el comando "cd" (change directory) y pegamos el texto presionando CTRL+V:

cd "pegarladirección"

Nota: es indistinto usar comillas simples o dobles

8. Dentro del directorio ejecutamos la siguiente línea de comando:

python -m esptool --chip esp32 --port COMX --baud 460800 write_flash -z 0x1000 .\esp32-20230426-v1.20.0.bin

3. Instalación de VSCode

VSCode es un IDE altamente personalizable y potente que proporciona una amplia gama de características y extensiones para la programación. Está diseñado específicamente para trabajar con diferentes lenguajes de programación, incluido Python, que es comúnmente utilizado con el ESP32.

También cuenta con extensiones específicas para el desarrollo de ESP32, las cuales brindan herramientas útiles para la programación, la depuración y la gestión de librerías para el ESP32.

Además, VSCode tiene una excelente integración con sistemas de control de versiones, como Git. Esto facilita la colaboración y el seguimiento de cambios en el código de los proyectos, lo cual es útil cuando se trabaja en equipo o se necesita llevar un registro de las modificaciones realizadas.

Para poder probar el funcionamiento vamos a descargar e instalar el software Visual Studio Code del siguiente enlace: https://code.visualstudio.com/download

Una vez instalado iniciamos VSCode y vamos a la sección de extensiones, buscamos "pymakr Preview" y lo instalamos.

Pymakr Home > Quick Access > Settings > Pymakr: Terminal Profile > Native.

"print('Hola Mundo')"

4. Instalación de Git

Git es ampliamente utilizado como sistema de control de versiones para el desarrollo de software. Permite rastrear y gestionar los cambios en el código fuente, lo cual es especialmente útil cuando se trabaja con ESP32 que pueden involucrar múltiples desarrolladores o versiones diferentes del software. Git Bash permite utilizar los comandos de Git en sistemas Windows, lo que facilita el seguimiento y la gestión de versiones del proyecto.

Accedemos al siguiente enlace para descargarlo: https://git-scm.com/downloads

5. Git Fork

Existen dos tipos de personas: los que perdieron datos y los que van a perder datos usan git.

1. En caso de no poseer una cuenta en GitHub crearla.
   
   
2. Una vez iniciado sesión nos dirigimos al repositorio y hacemos click en Fork.
   
   
   
   
   
3. Se puede renombrar el repositorio pero se recomienda utilizar el mismo nombre
   Desmarcar la casilla de copiar únicamente la rama main.
   
   
   
   
   
   
4. Ya podemos acceder al enlace a nuestro repositorio.
   
   
   
   
   
   
5. Abrimos VSCode y clonamos el repositorio desde el explorador. Si no aparece la opción de clonar abrimos una ventana nueva (CTRL+SHIFT+N).
   
   
   
   
   
6. Pegamos la dirección, aceptamos y luego nos pedirá el directorio donde guardarlo.
   
   
   
   
   A partir de ahora se vinculará VSCode con GitHub
   
   
7. Abrimos VSCode y en la parte inferior izquierda en la sección de Accounts seleccionamos Turn on Cloud Changes.
   
   
   
   
   
8. En la parte superior seleccionamos Sign in with GitHub.
   
   
   
   
   
9. Permitimos la autorización.
   
   
   
   
   
10. 
    
    
    
    
11. 
    
    
    ⚠️ En caso de no abrir el enlace desde VSCode y no ver la lista del paso siguiente, seguir con la alternativa del capitulo siguiente
    
    
12. Seleccionar las siguientes casillas y aceptar.
    
    
    
    
    
    
13. Cada vez que modifiquemos el código y quisiéramos hacer un commit, primero hay que guardar los cambios (CTRL+S), luego ir a la sección Source Control y agregar los archivos con cambios al área de staging.
    
    
    
    
    
14. Del menú desplegable seleccionamos Commit & Push.

1. git config --global user.name "TuNombre"
2. git config --global user.email "TuEmail@email.com"

5.1. VSCode-GitHub (Alternativa)

1. Generamos un token desde settings.
   
   
   
   
   
2. Ponemos una descripción o nombre a nuestra clave y podemos seleccionar sin expiración.
   
   
   
   
   
   
3. Seleccionamos las siguientes casillas y aceptamos.
   
   
   
   
   
4. Finalmente obtenemos nuestro Token, lo copiamos y guardamos en algún lugar seguro ya que no será posible volver a visualizarlo.
   
   
   
   
   
5. En VSCode abrimos un terminal (CTRL+Ñ) y nos dirigimos a la carpeta del proyecto.
   
6. Ejecutamos el siguiente comando:
   

   
   git remote set-url origin https://TOKEN@github.com/USUARIO/REPOSITORIO.git