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

Para suscribirte 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 implica recibir una llamada telefónica o un mensaje de texto e introducir 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.

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. Active la autenticación multifactor (MFA) para el usuario raíz.

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

Creación de un usuario con acceso administrativo

1. Activar 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 su uso 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.

Inicio de sesión como usuario con acceso de administrador

• Para iniciar sesión con el usuario de IAM Identity Center, use la URL de inicio de sesión que se envió a la dirección de correo electrónico cuando creó el usuario de IAM Identity Center.

  Para obtener ayuda para iniciar sesión con un usuario del Centro de identidades de IAM, 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 de 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 .

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 UART Bridge VCP. Puede descargar estos controladores de Silicon Labs.

2. Sigue 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 necesitará cuando compile la demostración.

1. Configure el proyecto de demostración de FreeRTOS siguiendo los pasos que se describen en Configuración de las demostraciones de FreeRTOS. Omita el último paso Para formatear sus credenciales de AWS IoT y, en su lugar, siga los pasos que se indican a continuación.

2. Microchip ha proporcionado varias herramientas de creación de scripts para ayudar a configurar las piezas del 08A. ATECC6 Vaya al directorio freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool y, a continuación, 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 en AWS

   2. Genera tus claves en el ATECC6 08A y exporta la clave pública y el número de serie del dispositivo

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

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.

Para generar los archivos de compilación de la aplicación de demostración con CMake

1. Desplácese hasta la raíz del directorio de descargas de FreeRTOS.

2. En una ventana de la línea de comandos, escriba el siguiente comando para generar los archivos de compilación.

   cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -S . -B your-build-directory

   Notas

   Para compilar la aplicación para la depuración, agregue la marca -DCMAKE_BUILD_TYPE=Debug.

   Para generar los archivos de compilación de la aplicación de prueba, añada la marca -DAFR_ENABLE_TESTS=1.

   El código proporcionado por Espressif utiliza la pila de IP ligera (lwIP) como pila de red predeterminada. Para usar la pila de redes FreeRTOS+TCP en su lugar, añada la –DAFR_ESP_FREERTOS_TCP marca al comando. CMake

   Para añadir la dependencia de LWiP para el código no proporcionado por el proveedor, añada las siguientes líneas CMake al archivo de dependenciasCMakeLists.txt, para su componente Wi-Fi personalizado.

   # Add a dependency on the bluetooth espressif component to the common component
   set(COMPONENT_REQUIRES lwip)

Creación de la aplicación con Make

1. Vaya al directorio build.

2. En una ventana de la línea de comandos, escriba el siguiente comando para compilar la aplicación con Make.

   make all -j4

   nota

   Debe generar los archivos de compilación con el comando cmake cada vez que cambie entre el proyecto aws_demos y el proyecto aws_tests.

Para generar los archivos de compilación de la aplicación de demostración con CMake

1. Desplácese hasta la raíz del directorio de descargas de FreeRTOS.

2. En una ventana de la línea de comandos, escriba el siguiente comando para generar los archivos de compilación.

   cmake -DVENDOR=espressif -DBOARD=esp32_plus_ecc608a_devkitc -DCOMPILER=xtensa-esp32 -GNinja -S . -B your-build-directory

   nota

   Para compilar la aplicación para la depuración, agregue la marca -DCMAKE_BUILD_TYPE=Debug.

   Para generar los archivos de compilación de la aplicación de prueba, añada la marca -DAFR_ENABLE_TESTS=1.

   El código proporcionado por Espressif utiliza la pila de IP ligera (lwIP) como pila de red predeterminada. Para usar la pila de redes FreeRTOS+TCP en su lugar, añada la –DAFR_ESP_FREERTOS_TCP marca al comando. CMake

   Para añadir la dependencia de LWiP para el código no proporcionado por el proveedor, añada las siguientes líneas CMake al archivo de dependenciasCMakeLists.txt, para su componente Wi-Fi personalizado.

   # Add a dependency on the bluetooth espressif component to the common component
   set(COMPONENT_REQUIRES lwip)

Creación de la aplicación

1. Vaya al directorio build.

2. En una ventana de la línea de comandos, introduzca el siguiente comando para invocar a Ninja para compilar la aplicación.

   ninja

   O bien, utilice la CMake interfaz genérica para crear la aplicación.

   cmake --build your-build-directory

   nota

   Debe generar los archivos de compilación con el comando cmake cada vez que cambie entre el proyecto aws_demos y el proyecto aws_tests.

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

2. Sigue 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 necesitará cuando compile la demostración.

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 credenciales de AWS IoT , deténgase y siga los pasos que se indican a continuación.

2. Microchip ha proporcionado varias herramientas de creación de scripts para ayudar a configurar las piezas del 08A. ATECC6 Vaya al directorio freertos/vendors/microchip/secure_elements/app/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 en AWS

   2. Genera tus claves en el ATECC6 08A y exporta la clave pública y el número de serie del dispositivo

   3. Generación de un certificado para el dispositivo y registro del certificado en AWS

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.

Creación e instalación del proyecto

1. Desplácese hasta la raíz del directorio de descargas de FreeRTOS.

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

   Windows

   vendors\espressif\esp-idf\export.bat

   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

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 herramientas ESP-IDF a la ruta de su intérprete de comandos.

   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

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 principal, elija Test (Pruebas) para abrir el cliente de MQTT.

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