especialmente las FDI
v5.3.1
ESP-IDF es el marco de desarrollo para los SoC de Espressif compatibles con Windows, Linux y macOS.
La siguiente tabla muestra la compatibilidad con ESP-IDF de los SoC Espressif, donde y denotan el estado de vista previa y la compatibilidad, respectivamente. El soporte de vista previa suele estar limitado en el tiempo y destinado a versiones beta de chips. Utilice una versión ESP-IDF donde el SoC deseado ya sea compatible.
| Chip | v5.0 | v5.1 | v5.2 | v5.3 | v5.4 | |
|---|---|---|---|---|---|---|
| ESP32 | ||||||
| ESP32-S2 | ||||||
| ESP32-C3 | ||||||
| ESP32-S3 | Anuncio | |||||
| ESP32-C2 | Anuncio | |||||
| ESP32-C6 | Anuncio | |||||
| ESP32-H2 | Anuncio | |||||
| ESP32-P4 | Anuncio | |||||
| ESP32-C5 | Anuncio | |||||
| ESP32-C61 | Anuncio |
Existen variantes de revisiones para una serie de chips. Consulte Compatibilidad entre versiones ESP-IDF y revisiones de SoC Espressif para obtener detalles sobre la compatibilidad entre ESP-IDF y revisiones de chips.
Los SoC Espressif lanzados antes de 2016 (ESP8266 y ESP8285) son compatibles con RTOS SDK.
Consulte https://idf.espressif.com/ para obtener enlaces a instrucciones detalladas sobre cómo configurar ESP-IDF según el chip que utilice.
Nota: Cada serie de SoC y cada versión de ESP-IDF tiene su propia documentación. Consulte la sección Versiones sobre cómo encontrar documentación y cómo verificar una versión específica de ESP-IDF.
ESP-IDF utiliza ubicaciones relativas como URL de sus submódulos (.gitmodules). Entonces se vinculan a GitHub. Si ESP-IDF se bifurca a un repositorio de Git que no está en GitHub, deberá ejecutar el script tools/set-submodules-to-github.sh después de git clone.
El script establece URL absolutas para todos los submódulos, lo que permite que se complete git submodule update --init --recursive . Si clona ESP-IDF desde GitHub, este paso no es necesario.
Además del proyecto esp-idf-template mencionado en Introducció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.
Para iniciar su propio proyecto basado en un ejemplo, copie el directorio del proyecto de ejemplo fuera del directorio ESP-IDF.
Consulte los enlaces de la guía de introducción anteriores para obtener una guía de configuración detallada. Esta es una referencia rápida para comandos comunes cuando se trabaja con proyectos ESP-IDF:
(Consulte la guía de introducción mencionada anteriormente para obtener una lista completa de los pasos necesarios con más detalles).
install.bat o install.ps1 para Windows e install.sh o install.fish para shells de Unix.export.bat ) o consígalo en Unix ( source export.sh ) en cada entorno de shell antes de usar ESP-IDF. idf.py set-target establece el objetivo del proyecto en idf.py set-target sin ningún argumento para ver una lista de objetivos admitidos.idf.py menuconfig abre un menú de configuración basado en texto donde puede configurar el proyecto. idf.py build
... compilará la aplicación, el gestor de arranque y generará una tabla de particiones basada en la configuración.
Cuando finalice la compilación, imprimirá una línea de comando para usar esptool.py para actualizar el chip. Sin embargo, también puedes hacer esto automáticamente ejecutando:
idf.py -p PORT flash
Reemplace PORT con el nombre de su puerto serie (como COM3 en Windows, /dev/ttyUSB0 en Linux o /dev/cu.usbserial-X en MacOS. Si se omite la opción -p , idf.py flash intentará flashee el primer puerto serie disponible.
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 idf.py menuconfig .
No es necesario ejecutar idf.py build antes de ejecutar idf.py flash , idf.py flash reconstruirá automáticamente todo lo que lo necesite.
El objetivo idf.py monitor utiliza la herramienta esp-idf-monitor para mostrar la salida en serie de los SoC Espressif. esp-idf-monitor también tiene una variedad de funciones para decodificar la salida de fallas e interactuar con el dispositivo. Consulte la página de documentación para obtener más detalles.
Salga del monitor escribiendo Ctrl-].
Para crear, actualizar y monitorear la salida en una sola pasada, puede ejecutar:
idf.py 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:
idf.py app : crea solo la aplicación.idf.py app-flash : actualiza solo la aplicación. idf.py app-flash reconstruirá automáticamente la aplicación si algún archivo fuente ha cambiado.
(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).
El objetivo idf.py flash no borra todo el contenido 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 idf.py erase-flash .
Esto se puede combinar con otros objetivos, es decir, idf.py -p PORT erase-flash flash borrará todo y luego volverá a actualizar la nueva aplicación, el gestor de arranque y la tabla de particiones.
Documentación de la última versión: https://docs.espressif.com/projects/esp-idf/. Esta documentación se crea a partir del directorio de documentos de este repositorio.
Guía para principiantes sobre conceptos y recursos clave de ESP-IDF
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.
