ESP-IDF es el marco de desarrollo oficial para el chip ESP32.
Consulte las guías de configuración para obtener instrucciones detalladas para configurar ESP-IDF:
Además del proyecto esp-idf-template mencionado en la guía de configuración, ESP-IDF viene con algunos proyectos de ejemplo en el directorio de ejemplos.
Una vez que haya encontrado el proyecto con el que desea trabajar, cambie a su directorio y podrá configurarlo y compilarlo.
make menuconfig
?
para ver una pantalla de ayuda. La tecla Intro sale de la pantalla de ayuda.Y
y N
para habilitar (Sí) y deshabilitar (No) los elementos de configuración con las casillas de verificación " [*]
"?
al resaltar un elemento de configuración, se muestra ayuda sobre ese elemento./
para buscar los elementos de configuración.Una vez que haya terminado de configurar, presione Escape varias veces para salir y diga "Sí" para guardar la nueva configuración cuando se le solicite.
make all
... compilará la aplicación, el gestor de arranque y generará una tabla de particiones basada en la configuración.
Cuando termine make all
, imprimirá una línea de comando para usar esptool.py para actualizar el chip. Sin embargo, también puedes hacer esto desde make ejecutando:
make flash
Esto actualizará todo el proyecto (aplicación, gestor de arranque y tabla de particiones) en un nuevo chip. Los ajustes para la actualización del puerto serie se pueden configurar con make menuconfig
.
No es necesario ejecutar make all
antes de ejecutar make flash
, make flash
reconstruirá automáticamente todo lo que lo necesite.
El objetivo make monitor
utilizará el miniterm ya instalado (una parte de pyserial) para mostrar la salida en serie del ESP32 en la consola del terminal.
Salga de miniterm escribiendo Ctrl-].
Para flashear y monitorear la salida en una sola pasada, puede ejecutar:
make flash monitor
Después del flash inicial, es posible que desees compilar y flashear solo tu aplicación, no el gestor de arranque ni la tabla de particiones:
make app
: crea solo la aplicación.make app-flash
: flashea solo la aplicación. make app-flash
reconstruirá automáticamente la aplicación si la necesita.
(En el desarrollo normal, no hay ningún inconveniente en actualizar el gestor de arranque y la tabla de particiones cada vez, si no han cambiado).
ESP-IDF admite la compilación de varios archivos en paralelo, por lo que todos los comandos anteriores se pueden ejecutar como make -jN
donde N
es el número de procesos de creación paralelos que se ejecutarán (generalmente N debe ser igual o uno más que el número de núcleos de CPU). en su sistema.)
Se pueden combinar múltiples funciones de creación en una. Por ejemplo: para compilar la aplicación y el gestor de arranque usando 5 trabajos en paralelo, luego actualizar todo y luego mostrar la salida en serie de la ejecución de ESP32:
make -j5 flash monitor
Una vez que haya compilado su proyecto, el directorio "build" contendrá un archivo binario con un nombre como "my_app.bin". Este es un binario de imagen ESP32 que el gestor de arranque puede cargar.
La memoria flash de un solo ESP32 puede contener múltiples aplicaciones, así como muchos tipos diferentes de datos (datos de calibración, sistemas de archivos, almacenamiento de parámetros, etc.). Por este motivo, se actualiza una tabla de particiones para compensar 0x4000 en la memoria flash.
Cada entrada en la tabla de particiones tiene un nombre (etiqueta), tipo (aplicación, datos u otra cosa), subtipo y el desplazamiento en flash donde se carga la partición.
La forma más sencilla de utilizar la tabla de particiones es make menuconfig
y elegir una de las tablas de particiones predefinidas simples:
En ambos casos, la aplicación de fábrica se actualiza con un desplazamiento de 0x10000. Si make partition_table
, imprimirá un resumen de la tabla de particiones.
Para obtener más detalles sobre las tablas de particiones y cómo crear variaciones personalizadas, consulte el archivo docs/partition-tables.rst
.
El objetivo make flash
no borra todo el contenido del flash. Sin embargo, a veces es útil volver a configurar el dispositivo a un estado totalmente borrado, especialmente al realizar cambios en la tabla de particiones o actualizaciones de aplicaciones OTA. Para borrar todo el flash, ejecute make erase_flash
.
Esto se puede combinar con otros objetivos, es decir, make erase_flash flash
borre todo y luego vuelva a actualizar la nueva aplicación, el gestor de arranque y la tabla de particiones.
Documentación para la última versión: http://esp-idf.readthedocs.io/. Esta documentación se crea a partir del directorio de documentos de este repositorio.
El foro esp32.com es un lugar para hacer preguntas y encontrar recursos de la comunidad.
Consulte la sección Problemas en github si encuentra un error o tiene una solicitud de función. Verifique los problemas existentes antes de abrir uno nuevo.
Si está interesado en contribuir a ESP-IDF, consulte la Guía de contribuciones.