Saltar al contenido principal

Guía de Instalación y Uso de ESP-IDF

Documentación Oficial​

Consulta la documentación oficial para obtener instrucciones detalladas:


Instalación​

Windows​

esp

  • Abre el instalador y selecciona todas las opciones de placas disponibles.

esp

Creación y Configuración de un Proyecto - Espressif-IDE​

  1. Abre el Espressif-IDE.

  2. Crea un nuevo proyecto de ejemplo.

esp

  1. Selecciona la placa ESP32-C6.

esp

  1. Configura los ajustes del proyecto:

    • Establece la velocidad del reloj en 40MHz.
    • Establece la memoria flash en 4MB.

  2. Compila el proyecto.

esp

  1. Flashea el firmware en la placa.

GNU/Linux (Ubuntu)​

Requisitos​

Asegúrate de que Python3 esté instalado:

python3 --version

Instala las dependencias necesarias:

sudo apt-get install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

Configuración del Entorno​

  1. Crea un directorio para ESP-IDF:

    mkdir -p ~/esp
    cd ~/esp
    git clone -b v5.3 --recursive https://github.com/espressif/esp-idf.git

  2. Instala el ejemplo para ESP32-C6:

    cd ~/esp/esp-idf
    ./install.sh esp32c6
nota

Para desarrollar para múltiples placas:

./install.sh esp32,esp32s2

También puedes instalar todas las placas a la vez:

./install.sh all

Configuración de Variables de Entorno​

Configura las variables de entorno:

. $HOME/esp/esp-idf/export.sh

Para un uso frecuente, crea un alias:

alias get_idf='. $HOME/esp/esp-idf/export.sh'

Creación y Configuración de un Proyecto​

  1. Copia el ejemplo "hello_world":

    cd ~/esp
    cp -r $IDF_PATH/examples/get-started/hello_world .

  2. Entra en el directorio del proyecto y configura la placa objetivo:

    cd ~/esp/hello_world
    idf.py set-target esp32c6
    idf.py menuconfig

    esp

    • Navega a Serial flasher config.

    • Establece la velocidad del reloj en 40MHz y la memoria flash en 4MB.

  3. Compila el proyecto:

    idf.py build

  4. Flashea el firmware:

    idf.py -p /dev/ttyACM0 flash

Subida de Firmware​

  1. Verifica la conexión del dispositivo:

    lsusb
    dmesg | grep ttyACM*
    [ 6497.689351] cdc_acm 1-1:1.0: ttyACM0: USB ACM device

  2. Flashea el firmware:

    idf.py -p /dev/ttyACM0 flash

    esp_linux

  3. Confirma la subida exitosa.

Uso de WSL​

  1. Abre una terminal (se recomienda PowerShell en modo administrador).
  2. Usa usbipd para ver los dispositivos USB conectados y crear un enlace de comunicación.
  3. Adjunta el dispositivo: 
    usbipd attach --busid <bus-id>
  4. Verifica el dispositivo en tu consola de Linux.

Para desvincular el dispositivo:

  • Desconecta el dispositivo en PowerShell: 
    usbipd detach --busid <bus-id>
  • Desvincula el dispositivo para usarlo en Windows: 
    usbipd unbind --busid <bus-id>

Notas Adicionales​

  • Asegúrate siempre de usar las rutas correctas para tu entorno.
  • Consulta la documentación oficial para solucionar problemas y configuraciones avanzadas.
  • Para comandos frecuentes, considera crear alias para agilizar tu flujo de trabajo.
  • Usa los comandos idf.py para compilar, flashear y gestionar proyectos.