Blog
ESP-IDF: SDK, compilación y vs Arduino
Qué es el esp32 idf, cómo instalarlo y cómo montar un primer proyecto — ESP-IDF es el SDK oficial de C/C++ de Espressif, y llega más profundo que el envoltorio de Arduino. Respuestas cortas a las preguntas que la gente hace cuando el board manager deja de bastar.
¿Qué es el ESP32 IDF?
ESP-IDF (Espressif IoT Development Framework) es el SDK oficial de C/C++ de Espressif — la empresa que fabrica el chip. Tienes FreeRTOS, drivers de hardware y el sistema de build idf.py en lugar del envoltorio amable de Arduino. No es un lenguaje ni un IDE; es el toolchain con el que habla la propia documentación del chip.
¿Cómo instalar el ESP32 IDF?
En Windows, el IDE de Espressif o el instalador de esp-idf montan Python, Git y los toolchains en una sola ejecución. En Linux: git clone –recursive del repositorio, y luego source install.sh y export.sh. Calcula 4–6 GB de disco y 10–20 minutos; mi instalación v5.3 en un portátil de 2022 tardó 14 minutos.
¿Cómo meter un proyecto en el ESP32 IDF?
Un proyecto es una carpeta: un directorio main/ con tus archivos C más un CMakeLists.txt arriba. Copia uno de los ejemplos en examples/get-started, ejecuta idf.py set-target esp32s3 una vez y luego idf.py build. El código estilo Arduino no entra tal cual — ESP-IDF quiere app_main(), no setup() y loop(). El FAQ de primeros pasos cubre la vía Arduino si vienes de ahí.
¿Cómo ejecutar boot.py en ESP32?
boot.py es el script de arranque de MicroPython, no un concepto de ESP-IDF. Flashea MicroPython primero (esptool.py write_flash 0x1000 micropython.bin), luego sube boot.py al filesystem y se ejecuta en cada arranque. ¿Esperabas boot.py en ESP-IDF? Firmware equivocado para el trabajo.
¿ESP-IDF o Arduino — cuál debería usar?
Ambos funcionan; la respuesta depende de tu placa y tu paciencia. Arduino es un envoltorio que esconde sdkconfig y el sistema de build. ESP-IDF te da control y coincide con la documentación oficial — que es buena, pero asume experiencia en C. Para cualquier cosa con deep sleep más Wi-Fi, o para un producto, ESP-IDF es la apuesta segura; para un prototipo hobby, Arduino llega antes.
¿Qué es app_main() y por qué mi build lo quiere?
Cada proyecto ESP-IDF define exactamente un app_main() — el punto de entrada, sin la separación setup()/loop(). Crea una tarea FreeRTOS dentro y mantenla viva. Si tu build termina en ‘undefined reference to app_main’, esa función es la pieza que falta.
¿Qué es sdkconfig y debería editarlo?
sdkconfig es el config generado de tu proyecto, regenerado en cada build limpio. No lo edites a mano: idf.py menuconfig lo escribe por ti. sdkconfig.defaults es el archivo que se commitea. El FAQ de entresijos explica cómo el config se propaga al build.
¿Qué significa “fatal error: driver/gpio.h: No such file or directory”?
Una dependencia de componente que falta. El header existe en el SDK — tu CMakeLists.txt simplemente no lo declara en REQUIRES. Una línea lo arregla, y es el error de compilación ESP-IDF más común que he ayudado a depurar en foros. Me pasó en mi primer proyecto a las 2 de la madrugada; el arreglo tardó 20 segundos cuando dejé de entrar en pánico.
¿Cómo ajustar el baud rate de un ESP32 usando ESP-IDF?
Ejecuta idf.py menuconfig → Serial flasher config → Default flash baud rate. Esa es la respuesta directa a ‘how to set baud rate of a ESP32 using ESP-IDF’: es la velocidad de flasheo, no la velocidad UART de tu app. El baud rate de tu aplicación es un parámetro del driver UART que pones en código, por separado.
¿Puedo ejecutar código Arduino dentro de ESP-IDF?
Sí, los cores recientes traen Arduino como componente opcional — idf.py add-dependency espressif/arduino-esp32 lo añade. En general funciona, aunque mezclar los dos mundos confunde: dos sistemas de config, dos APIs de temporizadores. Elige uno por proyecto. Depurar un proyecto mixto es donde el FAQ de depuración demuestra su valor.
Los proyectos de este tema se ejecutan directamente en el simulador gratuito de sensbench: circuito preconectado, firmware incluido, sin cuenta y sin instalación.