Cómo empezar con el Espressif ESP32 - DevKit C y el ESP-WROVER-KIT

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.

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 .

1. Configure el hardware de Espressif.

   • Para obtener información sobre cómo configurar el hardware de la placa de desarrollo ESP32 - DevKit C, consulte la Guía de introducción a ESP32 - DevKit C V4.

   • Para obtener información sobre cómo configurar el hardware de la placa de ESP-WROVER-KIT desarrollo, consulte la Guía de ESP-WROVER-KIT introducción a la versión 4.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. 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. 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

   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 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 - DevKit C, debe instalar los controladores CP21 0x USB to UART BridgeVCP. Puede descargar estos controladores de Silicon Labs.

      Para establecer una conexión en serie entre la máquina host y el ESP32 - WROVER -KIT, debe instalar el controlador del COM puerto FTDI virtual. Puede descargar este controlador desde FTDI.

   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.

1. Si ejecuta macOS o Linux, abra un símbolo del terminal. Si utiliza Windows, abra la aplicación "ESP- IDF 4.xCMD" (si incluyó esta opción al instalar la IDF cadena de herramientas ESP -) o la aplicación «Command Prompt» en caso contrario.

2. Para verificar que tiene instalado Python3, ejecute

   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 línea de AWS comandos (CLI) para ejecutar AWS IoT los comandos. Si utilizas Windows, usa el easy_install awscli comando para instalarlo AWS CLI en la aplicación «Command» o «ESP- IDF 4.xCMD».

   Si utilizas macOS o Linux, consulta Instalación del AWS CLI.

4. Ejecute

   aws configure

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

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

   • En Windows, en la aplicación «Command» o «ESP- IDF 4.xCMD», ejecute

     pip install boto3 --user

     nota

     Consulte la Documentación de Boto3 para obtener más detalles.

   • En macOS o Linux, ejecute

     pip install tornado nose --user

     y, a continuación, ejecute

     pip install boto3 --user

   La RTOS versión gratuita incluye el SetupAWS.py script para facilitar la configuración de la placa Espressif a la que conectarse. AWS IoT 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 quieres asignar a la AWS IoT cosa que representa tu pizarra.

   wifi_ssid

   La SSID de tu 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(WEPseguridad)

   • eWiFiSecurityWPA(WPAseguridad)

   • eWiFiSecurityWPA2(WPA2seguridad)

6. Ejecute el script de configuración.

   1. Si ejecuta macOS o Linux, abra un símbolo del terminal. Si utilizas Windows, abre la aplicación "ESP- IDF 4.xCMD" o «Command».

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

      python SetupAWS.py setup

      El script hace lo siguiente:

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

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

      • Rellena el aws_clientcredential.h archivo con tu AWS IoT terminal, tu red Wi-Fi y tus SSID 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.

Para suscribirse al MQTT tema con el AWS IoT MQTT cliente

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

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 la 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_wrover_kit -DCOMPILER=xtensa-esp32 build

   Debería ver un resultado como el siguiente.

      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 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_wrover_kit -DCOMPILER=xtensa-esp32 -S . -B ./YOUR_BUILD_DIRECTORY -DAFR_ENABLE_ALL_MODULES=1 -DAFR_ENABLE_TESTS=0

   Con Ninja

   cmake -DVENDOR=espressif -DBOARD=esp32_wrover_kit -DCOMPILER=xtensa-esp32 -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

Para configurar la aplicación de SDK demostración móvil gratuita de RTOS Bluetooth Low Energy

1. Siga las instrucciones SDK para móviles para dispositivos Bluetooth de FreeRTOS para descargar e instalar la SDK plataforma móvil en su ordenador anfitrión.

2. Siga las instrucciones en Aplicación de demostración de SDK para móviles de Bluetooth de bajo consumo de FreeRTOS para configurar la aplicación móvil de demostración en su dispositivo móvil.