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

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 ESP32 Espressif - -32SE WROOM

importante

Esta integración de referencia está alojada en el RTOS repositorio Amazon Free, que está en desuso. Recomendamos empezar por aquí al crear un nuevo proyecto. Si ya tienes un RTOS proyecto gratuito basado en el RTOS repositorio de Amazon Free, ahora obsoleto, consulta la. Guía de migración al repositorio RTOS Github gratuito de Amazon

nota
  • Para descubrir cómo integrar bibliotecas RTOS modulares gratuitas y demos en tu propio IDF proyecto de Espressif, consulta nuestra integración de referencia destacada para la plataforma -C3. ESP32

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

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

Información general

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. Compila de forma cruzada una aplicación de RTOS demostración gratuita con 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 Free RTOS en tu tarjeta Espressif, debes configurar tu AWS cuenta y tus permisos.

Inscríbase para obtener una Cuenta de AWS

Si no tiene uno Cuenta de AWS, complete los siguientes pasos para crearlo.

Para suscribirse a una Cuenta de AWS
  1. Abrir https://portal.aws.amazon.com/billing/registro.

  2. Siga las instrucciones que se le indiquen.

    Parte del procedimiento de registro consiste en recibir una llamada telefónica e indicar un código de verificación en el teclado del teléfono.

    Cuando te registras en un Cuenta de AWS, Usuario raíz de la cuenta de AWSse crea un. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, asigne acceso administrativo a un usuario y utilice únicamente el usuario raíz para realizar tareas que requieren acceso de usuario raíz.

AWS te envía un correo electrónico de confirmación una vez finalizado el proceso de registro. En cualquier momento, puede ver la actividad de su cuenta actual y administrarla accediendo a https://aws.amazon.com/y seleccionando Mi cuenta.

Creación de un usuario con acceso administrativo

Después de crear un usuario administrativo Cuenta de AWS, asegúrelo Usuario raíz de la cuenta de AWS AWS IAM Identity Center, habilite y cree un usuario administrativo para no usar el usuario root en las tareas diarias.

Proteja su Usuario raíz de la cuenta de AWS
  1. Inicie sesión AWS Management Consolecomo propietario de la cuenta seleccionando el usuario root e introduciendo su dirección de Cuenta de AWS correo electrónico. En la siguiente página, escriba su contraseña.

    Para obtener ayuda para iniciar sesión con el usuario raíz, consulte Iniciar sesión como usuario raíz en la Guía del usuario de AWS Sign-In .

  2. Activa la autenticación multifactorial (MFA) para tu usuario root.

    Para obtener instrucciones, consulte Habilitar un MFA dispositivo virtual para el usuario Cuenta de AWS root (consola) en la Guía del IAM usuario.

Creación de un usuario con acceso administrativo
  1. Habilite IAM Identity Center.

    Consulte las instrucciones en Activar AWS IAM Identity Center en la Guía del usuario de AWS IAM Identity Center .

  2. En IAM Identity Center, conceda acceso administrativo a un usuario.

    Para ver un tutorial sobre cómo usar el Directorio de IAM Identity Center como fuente de identidad, consulte Configurar el acceso de los usuarios con la configuración predeterminada Directorio de IAM Identity Center en la Guía del AWS IAM Identity Center usuario.

Iniciar sesión como usuario con acceso de administrador
  • Para iniciar sesión con su usuario de IAM Identity Center, utilice el inicio de sesión URL que se envió a su dirección de correo electrónico cuando creó el usuario de IAM Identity Center.

    Para obtener ayuda para iniciar sesión con un usuario de IAM Identity Center, consulte Iniciar sesión en el portal de AWS acceso en la Guía del AWS Sign-In usuario.

Concesión de acceso a usuarios adicionales
  1. En IAM Identity Center, cree un conjunto de permisos que siga la práctica recomendada de aplicar permisos con privilegios mínimos.

    Para conocer las instrucciones, consulte Create a permission set en la Guía del usuario de AWS IAM Identity Center .

  2. Asigne usuarios a un grupo y, a continuación, asigne el acceso de inicio de sesión único al grupo.

    Para conocer las instrucciones, consulte Add groups en la Guía del usuario de AWS IAM Identity Center .

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 la configuración del hardware de la placa de desarrollo ESP32 WROOM - 32SE, consulte la Guía de introducción a la ESP32 - DevKit C V4.

    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. Descarga Amazon gratis RTOS desde GitHub. (Para obtener instrucciones, consulte el READMEarchivo.md).

  3. Configure el entorno de desarrollo.

    Debe instalar una cadena de herramientas para comunicarse con la placa. Espressif proporciona el ESP software necesario IDF para desarrollar software para sus placas. Como el ESP - IDF tiene su propia versión del RTOS kernel gratuito integrada como componente, Amazon Free RTOS incluye una versión personalizada del ESP - IDF v4.2 en la que se ha eliminado el RTOS kernel gratuito. 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, sigue las instrucciones que aparecen a continuación para el sistema operativo de tu máquina host.

    Windows

    1. Descargue ESP el IDF 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 IDF directorio existente ESP y establece Elegir IDF directorio existente ESP 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 Pasos siguientes, 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 RTOS descargas gratuitas y, a continuación, ejecute el siguiente script para descargar e instalar la cadena de herramientas espressif para su plataforma.

      vendors/espressif/esp-idf/install.sh
    4. Agrega las herramientas de la IDF cadena de herramientas ESP - a la ruta de tu 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 RTOS descargas gratuitas y, a continuación, ejecute el siguiente script para descargar e instalar la cadena de herramientas de Espressif para su plataforma.

      vendors/espressif/esp-idf/install.sh
    4. Añada las herramientas de la IDF cadena de herramientas ESP - 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 el ESP32 WROOM - 32SE, instale los controladores CP21 0x USB to Bridge. UART VCP Puede descargar estos controladores de Silicon Labs.

    2. Siga los pasos para establecer una conexión en 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.

Configure las aplicaciones de RTOS demostración gratuitas

Para este tutorial, el archivo RTOS de configuración gratuito se encuentra enfreertos/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 ATECC6 08A tiene una inicialización única que se bloquea en el dispositivo la primera vez que se ejecuta un proyecto (durante la llamada aC_InitToken). Sin embargo, el proyecto de RTOS demostración gratuito y el proyecto de prueba tienen configuraciones diferentes. 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 RTOS demostración gratuita siguiendo los pasos que se indican enConfiguración de las RTOS demostraciones gratuitas. Cuando llegue al último paso: formatear sus AWS IoT credenciales, deténgase y lleve a cabo los siguientes pasos.

  2. Microchip ha proporcionado varias herramientas de creación de scripts para ayudar a configurar las piezas del ATECC6 08A. 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. Genera tus claves en el ATECC6 08A y exporta la clave pública y el número de serie del dispositivo.

    3. Genera un certificado para el dispositivo y regístralo con AWSél.

  4. Cargue el certificado de entidad de certificación y el certificado de dispositivo en el dispositivo siguiendo las instrucciones de Aprovisionamiento de claves en modo desarrollador.

Supervisar MQTT los mensajes en la AWS nube

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

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

  2. En el panel de navegación, selecciona Probar y, a continuación, selecciona MQTTTest Client.

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

Cree, actualice y ejecute el proyecto de RTOS demostración gratuita con el script idf.py

Puedes usar la IDF utilidad de Espressif (idf.py) para generar los archivos de compilación, compilar el binario de la aplicación y guardar los binarios en tu dispositivo.

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
Compila y RTOS flashea gratis en Windows, Linux y macOS (ESP- IDF v4.2)
  1. Navega hasta la raíz de tu directorio de RTOS descargas gratuitas.

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

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

    (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

Compila y flashea gratis con RTOS CMake

Además de usar el idf.py script proporcionado por el IDF SDK para compilar y ejecutar tu código, también puedes compilar el proyecto con élCMake. 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, navega hasta la raíz de tu directorio de RTOS descargas gratuitas.

  2. Ejecuta el siguiente script para añadir las IDF herramientas ESP - a tu shellPATH.

    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 el uso y la solución de problemas de ESP32 las placas Espressif, consulte los siguientes temas: