View a markdown version of this page

Cómo empezar con el Espressif ESP32-WROOM-32SE - FreeRTOS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo empezar con el Espressif ESP32-WROOM-32SE

importante

Esta integración de referencia está alojada en el Amazon-FreeRTOS repositorio, que está en desuso. Recomendamos empezar por aquí al crear un nuevo proyecto. Si ya tiene un proyecto de Freertos existente basado en el Amazon-FreeRTOS repositorio ahora obsoleto, consulte la. Amazon-FreeRTOS Guía de migración del repositorio de Github

nota
  • Para explorar cómo integrar las bibliotecas modulares y demostraciones de FreeRTOS en su propio proyecto de Espressif IDF, consulte nuestra destacada integración de referencia para plataformas. ESP32-C3

  • Actualmente, el puerto Freertos para ESP32-WROOM-32SE no admite la función de multiprocesamiento simétrico (SMP).

Este tutorial te muestra cómo empezar a usar el Espressif. ESP32-WROOM-32SE Para comprar uno de nuestros socios en el catálogo de dispositivos AWS asociados, consulte. ESP32-WROOM-32SE

Descripción general de

Este tutorial le guiará a través de los siguientes pasos:

  1. Conecte la placa a un equipo host.

  2. Instale el software en su equipo host para desarrollar y depurar las aplicaciones integradas de la placa del microcontrolador.

  3. Realice la compilación cruzada de una aplicación de demostración de FreeRTOS en una imagen binaria.

  4. Cargue la imagen binaria de la aplicación en su placa y, a continuación, ejecute la aplicación.

  5. Monitorice y depure la aplicación en ejecución mediante una conexión serie.

Requisitos previos

Antes de empezar a usar Freertos en tu pizarra Espressif, debes configurar tu cuenta y tus permisos. AWS

Inscríbase para obtener una Cuenta de AWS

Para empezar AWS, necesitas un Cuenta de AWS. Para obtener información sobre cómo crear un Cuenta de AWS, consulte Cómo empezar con un Cuenta de AWS en la Guía de AWS Account Management referencia.

Para dar acceso, agregue permisos a los usuarios, grupos o roles:

Introducción

nota

Los comandos de Linux de este tutorial requieren que utilice el intérprete de comandos Bash.

  1. Configure el hardware de Espressif.

    Para obtener información sobre cómo configurar el hardware de la placa de ESP32-WROOM-32SE desarrollo, consulte la Guía de ESP32-DevKitC introducción a la versión 4.

    importante

    Cuando llegue a la sección Instalación paso a paso de la guía, siga hasta completar el paso 4 (Configuración de las variables de entorno). Deténgase después de completar el paso 4 y siga los pasos restantes aquí.

  2. Descargue Amazon FreeRTOS desde. GitHub (Para obtener instrucciones, consulte el README.mdarchivo).

  3. Configure el entorno de desarrollo.

    Debe instalar una cadena de herramientas para comunicarse con la placa. Espressif proporciona el software necesario ESP-IDF para desarrollar sus placas. Dado que ESP-IDF tiene su propia versión del núcleo de FreeRTOS integrada como componente, Amazon FreeRTOS incluye una versión personalizada de la versión 4.2 en la que se ha eliminado ESP-IDF el núcleo de FreeRTOS. Esto soluciona los problemas relacionados con los archivos duplicados al compilar. Para usar la versión personalizada de la ESP-IDF versión 4.2 incluida en Amazon FreeRTOS, siga las instrucciones que aparecen a continuación para el sistema operativo de su máquina host.

    Windows

    1. Descargue ESP-IDF el instalador universal en línea para Windows.

    2. Ejecute el instalador en línea universal.

    3. Cuando llegues al paso Descargar o usar ESP-IDF, selecciona Usar un ESP-IDF directorio existente y establece Elegir ESP-IDF directorio existente enfreertos/vendors/espressif/esp-idf.

    4. Complete la instalación.

    macOS

    1. Siga las instrucciones de la configuración estándar de los requisitos previos de la cadena de herramientas (ESP-IDF v4.2) para macOS.

      importante

      Cuando llegue a las instrucciones «Obtener ESP-IDF» de la sección «Próximos pasos», deténgase y, a continuación, vuelva a las instrucciones de esta página.

    2. Abra una ventana de línea de comandos.

    3. Navegue hasta el directorio de descargas de FreeRTOS y ejecute el siguiente script para descargar e instalar la cadena de herramientas espressif para su plataforma.

      vendors/espressif/esp-idf/install.sh
    4. Añada las ESP-IDF herramientas de la cadena de herramientas a la ruta de su terminal con el siguiente comando.

      source vendors/espressif/esp-idf/export.sh

    Linux

    1. Siga las instrucciones de la configuración estándar de los requisitos previos de la cadena de herramientas (ESP-IDF v4.2) para Linux.

      importante

      Cuando llegue a las instrucciones «Obtener ESP-IDF» de la sección «Próximos pasos», deténgase y, a continuación, vuelva a las instrucciones de esta página.

    2. Abra una ventana de línea de comandos.

    3. Navegue hasta el directorio de descargas de FreeRTOS y ejecute el siguiente script para descargar e instalar la cadena de herramientas Espressif para su plataforma.

      vendors/espressif/esp-idf/install.sh
    4. Añada las ESP-IDF herramientas de la cadena de herramientas a la ruta de su terminal con el siguiente comando.

      source vendors/espressif/esp-idf/export.sh
  4. Establezca una conexión serie.

    1. Para establecer una conexión en serie entre su máquina host y la ESP32-WROOM-32SE, instale los controladores VCP USB a UART Bridge del CP210x. Puede descargar estos controladores de Silicon Labs.

    2. Siga los pasos para establecer una conexión serie con ESP32.

    3. Después de establecer una conexión serie, anote el puerto serie de la conexión de la placa. Lo necesita para instalar la demostración.

Configuración de las aplicaciones de demostración de FreeRTOS

Para este tutorial, el archivo de configuración de FreeRTOS se encuentra en freertos/vendors/espressif/boards/board-name/aws_demos/config_files/FreeRTOSConfig.h. (Por ejemplo, si se elige AFR_BOARD espressif.esp32_devkitc, el archivo de configuración se encuentra en freertos/vendors/espressif/boards/esp32/aws_demos/config_files/FreeRTOSConfig.h).

importante

El dispositivo ATECC608A tiene una inicialización única que se bloquea en el dispositivo la primera vez que se ejecuta un proyecto (durante la llamada a C_InitToken). Sin embargo, el proyecto de prueba y el proyecto de demostración de FreeRTOS tienen diferentes configuraciones. Si el dispositivo está bloqueado durante las configuraciones del proyecto de demostración, no todas las pruebas del proyecto de prueba tendrán éxito.

  1. Configure el proyecto de demostración de FreeRTOS siguiendo los pasos que se describen en Configuración de las demostraciones de FreeRTOS. Cuando llegue al último paso para formatear sus AWS IoT credenciales, deténgase y lleve a cabo los siguientes pasos.

  2. El microchip dispone de varias herramientas de scripting como ayuda para la configuración de los componentes de ATECC608A. Vaya al directorio freertos/vendors/microchip/example_trust_chain_tool y abra el archivo README.md.

  3. Siga las instrucciones del archivo README.md para aprovisionar el dispositivo. Estos pasos incluyen lo siguiente:

    1. Cree y registre una autoridad de certificación con AWS.

    2. Genere sus claves en el ATECC608A y exporte la clave pública y el número de serie del dispositivo.

    3. Genere un certificado para el dispositivo y regístrelo en él AWS.

  4. Cargue el certificado de entidad de certificación y el certificado de dispositivo en el dispositivo siguiendo las instrucciones de Developer-mode aprovisionamiento de claves.

Supervisión de los mensajes MQTT en el AWS Cloud

Antes de ejecutar el proyecto de demostración de Freertos, puede configurar el cliente MQTT en la AWS IoT consola para supervisar los mensajes que su dispositivo envía a la nube. AWS

Para suscribirse al tema MQTT con el AWS IoT Cliente MQTT
  1. Inicie sesión en la consola de AWS IoT.

  2. En el panel de navegación, seleccione Probar y, a continuación, seleccione el cliente de prueba MQTT.

  3. En Tema de suscripción, introduzca your-thing-name/example/topic y, a continuación, elija Suscribirse al tema.

Creación, instalación y ejecución del proyecto de demostración de FreeRTOS con el script idf.py

Puede utilizar la utilidad IDF de Espressif (idf.py) para generar los archivos de creación, crear el binario de la aplicación e instalar la placa.

nota

Algunas configuraciones pueden requerir que utilice la opción de puerto “-p port-name” con idf.py para especificar el puerto correcto, como en el siguiente ejemplo.

idf.py -p /dev/cu.usbserial-00101301B flash
Cree y actualice FreeRTOS en Windows, Linux y macOS (ESP-IDF v4.2)
  1. Desplácese hasta la raíz del directorio de descargas de FreeRTOS.

  2. En una ventana de línea de comandos, introduce el siguiente comando para añadir ESP-IDF las herramientas a la RUTA de tu terminal:

    Windows (aplicación “Comando”)
    vendors\espressif\esp-idf\export.bat
    Windows (aplicación «ESP-IDF 4.x CMD»)

    (Esto ya se hizo cuando abrió aplicación).

    Linux/macOS
    source vendors/espressif/esp-idf/export.sh
  3. Configure cmake en el directorio build y cree la imagen del firmware con el siguiente comando.

    idf.py -DVENDOR=espressif -DBOARD=esp32_ecc608a_devkitc -DCOMPILER=xtensa-esp32 build

    Debería ver un resultado como el del siguiente ejemplo.

    Running cmake in directory /path/to/hello_world/build Executing "cmake -G Ninja --warn-uninitialized /path/to/hello_world"... Warn about uninitialized values. -- Found Git: /usr/bin/git (found version "2.17.0") -- Building empty aws_iot component due to configuration -- Component names: ... -- Component paths: ... ... (more lines of build system output) [527/527] Generating hello-world.bin esptool.py v2.3.1 Project build complete. To flash, run this command: ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x10000 build/hello-world.bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin or run 'idf.py -p PORT flash'

    Si no hay errores, la creación generará los archivos .bin binarios del firmware.

  4. Borre la memoria flash de la placa de desarrollo con el siguiente comando.

    idf.py erase_flash
  5. Utilice el script idf.py para instalar el archivo binario de la aplicación en la placa.

    idf.py flash
  6. Supervise la salida del puerto serie de la placa con el siguiente comando.

    idf.py monitor
    nota
    • Puede combinar estos comandos como se muestra en el siguiente ejemplo.

      idf.py erase_flash flash monitor
    • Para determinadas configuraciones de máquinas host, debe especificar el puerto en el que se va a instalar la placa, como en el siguiente ejemplo.

      idf.py erase_flash flash monitor -p /dev/ttyUSB1

Creación e instalación de FreeRTOS con CMake

Además de usar el script idf.py proporcionado por el SDK de IDF para crear y ejecutar su código, también puede crear el proyecto con CMake. Actualmente es compatible con Unix Makefile y el sistema de creación Ninja.

Creación e instalación del proyecto
  1. En una ventana de línea de comandos, navegue hasta el directorio de descargas de FreeRTOS.

  2. Ejecute el siguiente script para añadir las ESP-IDF herramientas al PATH de su shell.

    Windows
    vendors\espressif\esp-idf\export.bat
    Linux/macOS
    source vendors/espressif/esp-idf/export.sh
  3. Utilice el siguiente comando para generar los archivos de creación.

    Con Unix Makefiles
    cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0
    Con Ninja
    cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0 -GNinja
  4. Borre la instalación y, a continuación, instale la placa.

    Con Unix Makefiles
    make -C ./YOUR_BUILD_DIRECTORY erase_flash
    make -C ./YOUR_BUILD_DIRECTORY flash
    Con Ninja
    ninja -C ./YOUR_BUILD_DIRECTORY erase_flash
    ninja -C ./YOUR_BUILD_DIRECTORY flash

Información adicional

Para obtener más información sobre cómo utilizar y solucionar problemas de las placas Espressif ESP32, consulte los siguientes temas: