esp-idf

ESP-IDF (Espressif IoT Development Framework) es el framework oficial de desarrollo para los SoCs de Espressif, compatible con Windows, Linux y macOS. Está dirigido a los chips de Espressif; los SoCs lanzados antes de 2016 (ESP8266 y ESP8285) son compatibles con el SDK RTOS separado. El repositorio documenta los cronogramas de soporte de versiones, avisos de fin de vida útil y la compatibilidad entre las versiones de ESP-IDF y las revisiones de chips. Cada serie de SoC y cada versión de ESP-IDF tiene su propia documentación, y el README apunta a la sección Versions de la documentación en línea para encontrar la documentación y revisar una versión específica. Para comenzar, es necesario instalar las dependencias de compilación del host, ejecutar un script de instalación (install.bat o install.ps1 en Windows; install.sh o install.fish en shells Unix) y luego exportar el entorno en cada shell (export.bat en Windows, source export.sh en Unix) antes de usar ESP-IDF. Se proporcionan un proyecto plantilla (esp-idf-template) y un conjunto de proyectos de ejemplo en el directorio examples; para iniciar un nuevo proyecto a partir de un ejemplo, el directorio del ejemplo se copia fuera del árbol de ESP-IDF. El flujo de trabajo principal utiliza la herramienta de línea de comandos idf.py. `idf.py set-target <chip_name>` selecciona el chip objetivo, y `idf.py menuconfig` abre un menú de configuración basado en texto. `idf.py build` compila la aplicación y el bootloader y genera una tabla de particiones a partir de la configuración. La grabación se realiza con `idf.py -p PORT flash`, que escribe la aplicación, el bootloader y la tabla de particiones en un chip nuevo y reconstruye automáticamente lo que sea necesario; si se omite la opción de puerto, intenta usar el primer puerto serie disponible. La salida serie se visualiza con `idf.py monitor`, que utiliza la herramienta esp-idf-monitor y puede decodificar la salida de fallos e interactuar con el dispositivo; se sale con Ctrl-]. `idf.py flash monitor` combina compilación, grabación y monitoreo en un solo paso. Para trabajo iterativo, `idf.py app` compila solo la aplicación y `idf.py app-flash` graba solo la aplicación, reconstruyendo automáticamente cuando cambian las fuentes. `idf.py erase-flash` borra toda la flash, útil para cambios en la tabla de particiones o actualizaciones OTA, y se puede combinar con otros objetivos. Para bifurcaciones que no son de GitHub, el README señala que las URLs de los submódulos son relativas y enlazan a GitHub; el script tools/set-submodules-to-github.sh establece URLs absolutas para que `git submodule update --init --recursive` pueda completarse. Este paso no es necesario al clonar desde GitHub. Los recursos incluyen la documentación en línea generada desde el directorio docs, un video de guía para principiantes, el foro esp32.com para preguntas y recursos de la comunidad, la sección de Issues de GitHub para errores y solicitudes de funciones, y una guía de contribuciones.