Introducción a Espressif ESP32-S2

Procedimiento para registrarse en Cuenta de AWS

1. Abra https://portal.aws.amazon.com/billing/signup.

2. Siga las instrucciones que se le indiquen.

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

   Al registrarse en una Cuenta de AWS, se crea un Usuario raíz de la cuenta de AWS. 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.

Protección de Usuario raíz de la cuenta de AWS

1. Inicie sesión en Consola de administración de AWS como propietario de la cuenta; para ello, elija Usuario raíz e introduzca el correo electrónico de su Cuenta de AWS. 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 Habilitación de un dispositivo MFA virtual para su usuario raíz de la Cuenta de AWS (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 cómo usar Directorio de IAM Identity Center como origen de identidad, consulte Configuración del acceso de los usuarios con el Directorio de IAM Identity Center predeterminado en la Guía del usuario de AWS IAM Identity Center.

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 de IAM Identity Center, consulte Inicio de sesión en el portal de acceso de AWS en la Guía del usuario de AWS Sign-In.

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. Configure el hardware de Espressif.

   Para obtener información acerca de cómo configurar el hardware de la placa de desarrollo ESP32-S2, consulte ESP32-S2-Saola-1.

   importante

   Cuando llegue a la sección Introducción de las guías de Espressif, deténgase y vuelva a las instrucciones en esta página.

2. Descargue Amazon FreeRTOS desde GitHub. (Para ver las instrucciones, consulte el archivo README.md).

3. Configure el entorno de desarrollo.

   Debe instalar una cadena de herramientas para comunicarse con la placa. Espressif proporciona el ESP-IDF para desarrollar software para sus placas. Dado que el ESP-IDF tiene su propia versión del kernel de FreeRTOS integrada como componente, Amazon FreeRTOS incluye una versión personalizada del ESP-IDF v4.2 en la que se ha eliminado el kernel de FreeRTOS. Esto soluciona los problemas relacionados con los archivos duplicados al compilar. Para usar la versión personalizada del ESP-IDF v4.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 el instalador en línea universal de ESP-IDF para Windows.

   2. Ejecute el instalador en línea universal.

   3. Cuando llegue al paso Descargar o usar ESP-IDF, seleccione Usar un directorio ESP-IDF existente y establezca Elegir directorio ESP-IDF existente en freertos/vendors/espressif/esp-idf.

   4. Complete la instalación.

   macOS

   1. Siga las instrucciones que se indican en Requisitos previos para la configuración estándar de la cadena de herramientas (ESP-IDF v4.2) para macOS.

      importante

      Cuando llegue a las instrucciones de “Obtención de ESP-IDF” en Pasos siguientes, deténgase y 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 herramientas de la cadena de herramientas ESP-IDF a la ruta de su terminal con el siguiente comando.

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

   Linux

   1. Siga las instrucciones que se indican en Requisitos previos para la configuración estándar de la cadena de herramientas (ESP-IDF v4.2) para Linux.

      importante

      Cuando llegue a las instrucciones de “Obtención de ESP-IDF” en Pasos siguientes, deténgase y 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 herramientas de la cadena de herramientas ESP-IDF 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 entre su máquina host y el ESP32-DevKitC, debe instalar los controladores de VCP de puente del CP210x USB a UART. 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.

1. Si ejecuta macOS o Linux, abra un símbolo del terminal. Si utiliza Windows, abra la aplicación “ESP-IDF 4.x CMD” (si incluyó esta opción al instalar la cadena de herramientas de ESP-IDF) o la aplicación de “símbolo del sistema” en caso contrario.

2. Para verificar que tiene instalado Python3, ejecute lo siguiente:

   python --version

   Se muestra la versión instalada. Si no tiene instalado Python 3.0.1 o una versión posterior, puede instalarlo desde el sitio web de Python.

3. Necesita la interfaz de la línea de comandos (CLI) de AWS para ejecutar los comandos de AWS IoT. Si ejecuta Windows, utilice el comando easy_install awscli para instalar la CLI de AWS en la aplicación de “Comando” o “ESP-IDF 4.x CMD”.

   Si ejecuta macOS o Linux, consulte Instalación de la CLI de AWS.

4. Ejecute

   aws configure

   y configure la CLI de AWS con su ID de clave de acceso de AWS, la clave de acceso secreta y la región predeterminada de AWS. Para obtener más información, consulte Configuración de la CLI de AWS.

5. Utilice el comando siguiente para instalar el SDK de AWS para Python (boto3):

   • En Windows, en la aplicación de “Comando” o “ESP-IDF 4.x CMD”, ejecute

     easy_install boto3

   • En macOS o Linux, ejecute

     pip install tornado nose --user

     y, a continuación, ejecute

     pip install boto3 --user

Ejecución del script de configuración

1. Para configurar el script, abra freertos/tools/aws_config_quick_start/configure.json y defina los siguientes atributos:

   afr_source_dir

   Ruta completa del directorio freertos de su equipo. Asegúrese de que utiliza barras diagonales para especificar esta ruta.

   thing_name

   El nombre que desea asignar al objeto de AWS IoT que representa la placa.

   wifi_ssid

   El SSID de su red wifi.

   wifi_password

   La contraseña para su red wifi.

   wifi_security

   El tipo de seguridad para su red wifi. Los siguientes son tipos de seguridad válidos:

   • eWiFiSecurityOpen (abierta, sin seguridad)

   • eWiFiSecurityWEP (seguridad WEP)

   • eWiFiSecurityWPA (seguridad WPA)

   • eWiFiSecurityWPA2 (seguridad WPA2)

2. Si ejecuta macOS o Linux, abra un símbolo del terminal. Si ejecuta Windows, abra la aplicación de “ESP-IDF 4.x CMD” o “Comando”.

3. Vaya al directorio freertos/tools/aws_config_quick_start y ejecute

   python SetupAWS.py setup

   El script hace lo siguiente:

   • Crea un objeto de AWS IoT, un certificado y una política.

   • Asocia la política de AWS IoT para el certificado y el certificado al objeto de AWS IoT.

   • Rellena el archivo aws_clientcredential.h con su punto de conexión de AWS IoT, el SSID de la red wifi y las credenciales.

   • Formatea el certificado y la clave privada y los escribe en el archivo de encabezado aws_clientcredential_keys.h.

   nota

   El certificado tiene codificación fija únicamente con fines ilustrativos. Las aplicaciones de producción deben almacenar estos archivos en un lugar seguro.

   Para obtener más información sobre SetupAWS.py, consulte el archivo README.md en el directorio freertos/tools/aws_config_quick_start.

Suscripción al tema de MQTT con el cliente de MQTT de AWS IoT

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, escriba your-thing-name/example/topic y, a continuación, elija Suscribirse al tema.

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 (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=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 build

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

   Executing action: all (aliases: build)
      Running cmake in directory /path/to/hello_world/build
      Executing "cmake -G Ninja -DPYTHON_DEPS_CHECKED=1 -DESP_PLATFORM=1 -DVENDOR=espressif -DBOARD=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -DCCACHE_ENABLE=0 /path/to/hello_world"...
      -- The C compiler identification is GNU 8.4.0
      -- The CXX compiler identification is GNU 8.4.0
      -- The ASM compiler identification is GNU
   
      ... (more lines of build system output)
   
      [1628/1628] Generating binary image from built executable
      esptool.py v3.0
      Generated /path/to/hello_world/build/aws_demos.bin
   
      Project build complete. To flash, run this command:
      esptool.py -p (PORT) -b 460800 --before default_reset --after hard_reset --chip esp32s2  write_flash --flash_mode dio --flash_size detect --flash_freq 80m 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin 0x16000 build/ota_data_initial.bin 0x20000 build/aws_demos.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 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=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0

   • Con Ninja

     cmake -DVENDOR=espressif -DBOARD=esp32s2_saola_1 -DCOMPILER=xtensa-esp32s2 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0 -GNinja

4. Compilar el proyecto.

   • Con Unix Makefiles

     make -C ./YOUR_BUILD_DIRECTORY -j8

   • Con Ninja

     ninja -C ./YOUR_BUILD_DIRECTORY -j8

5. 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