A continuación se detallan los pasos para la compilación del primer proyecto de ejemplo.
-
En Visual Studio Code seleccionar el menú File -> Open Workspace from File...
-
Seleccione el archivo
EProgramable_C6
ubicado en la carpetafirmware
de su repositorio, por ejemplo:C:/Repositorios/Penalva_2C_2024/firmware/
. -
Se le mostrará una ventana preguntando si confía en los autores de estos archivos. Seleccione la opción
Yes, I trust the authors
. -
En la barra del Explorador (izquierda de la ventana) se le mostrará un árbol con la estructura de directorios del Espacio de Trabajo propuesta por la cátedra. Allí encontrará:
- drivers: carpeta que contiene los drivers del microcontrolador y dispositivos.
- 0_binking: proyecto de ejemplo.
- 1_binking_switch: proyecto de ejemplo.
- x_template: plantilla a partir de la cual crear nuevos proyectos.
-
Comencemos compilando el primer ejemplo 0_blinking. Como tenemos múltiples proyectos en el Espacio de Trabajo, debemos seleccionar siempre sobre cuál estamos trabajando. Para eso presione el botón
(
ESP-IDF: Current Project
) y luego seleccione0_blinking
. -
Dentro de la carpeta 0_binking (y en la de todos los proyecto) podrá encontrar:
- .vscode: carpeta donde se guardan los archivos de configuración del proyecto.
- main: carpeta dende se encuentra el código fuente del proyecto.
- CMakelist.txt: archivo de configuración para la construcción del proyecto.
- REDAME.md: archivo con la descripción del proyecto.
- sdkconfig: archivo de configuración del software del fabricante.
-
Abra el archivo
c_cpp_properties.json
ubicado en0_blinking/.vscode/
y revise que el directorio mostrado"compilerPath"
sea correcto. Esta es la ubicación del compilador (riscv32-esp-elf-gcc.exe), y el valor por defectoC:\\Usuarios\\PC\\.espressif\\tools\\riscv32-esp-elf\\esp-12.2.0_20230208\\riscv32-esp-elf\\bin\\riscv32-esp-elf-gcc.exe
puede no coincidir con el directorio donde se encuentre en su equipo, ya que depende de la versión de IDF instalada y de la unidad donde usted haya elegido realizar la instalación. Si el directorio mostrado no existe, corrijalo por el valor correcto.
Tip
Las ubicaciones más comunes de instalación son C:/Espressif/tools/...
y %USERPROFILE%/.espressif/tools/...
en Windows y $HOME/.espressif/tools/...
en Linux.
Note
No se preocupe si el programa le muestra una advertencia en el valor de "compileCommands"
, el mismo desaparecerá luego de la primera compilación.
- El código fuente del programa lo puede encontrar en
0_blinking/main/0_blinking.c
Note
No se preocupe si el programa le muestra un error en el macro portTICK_PERIOD_MS
, el mismo desaparecerá luego de la primera compilación.
-
Para compilar el proyecto, presione el botón
(
ESP-IDF: Build project
). Aparecerá una notificación de que el proyecto está siendo compilado.
Note
La primera compilación de un proyecto puede tomar varios minutos.
-
Una vez finalizada la compilación, el programa le mostrará (en la pestaña
TERMINAL
) el porcentaje de memoria del microcontrolador que ocupará el proyecto. Además se puede observar en la barra del Explorador que se ha creado una nueva carpeta0_blinking/build/
, donde se almacenan todos los archivos resultado de la compilación.
Una vez finalizada la compilación del proyecto puede continuar con el instructivo de Grabación y Depuración.