开始使用 Espressif ESP32-WROOM-32SE

注册 AWS 账户

1. 打开 https://portal.aws.amazon.com/billing/signup。

2. 按照屏幕上的说明操作。

   在注册时，将接到电话或收到短信，要求使用电话键盘输入一个验证码。

   当您注册 AWS 账户 时，系统将会创建一个 AWS 账户根用户。根用户有权访问该账户中的所有 AWS 服务和资源。作为最佳安全实践，请为用户分配管理访问权限，并且只使用根用户来执行需要根用户访问权限的任务。

保护您的 AWS 账户根用户

1. 选择根用户并输入您的 AWS 账户 电子邮件地址，以账户拥有者身份登录 AWS 管理控制台。在下一页上，输入您的密码。

   要获取使用根用户登录方面的帮助，请参阅《AWS 登录 用户指南》中的 Signing in as the root user。

2. 为您的根用户启用多重身份验证（MFA）。

   有关说明，请参阅《IAM 用户指南》中的为 AWS 账户 根用户启用虚拟 MFA 设备（控制台）。

创建具有管理访问权限的用户

1. 启用 IAM Identity Center。

   有关说明，请参阅《AWS IAM Identity Center 用户指南》中的 Enabling AWS IAM Identity Center。

2. 在 IAM Identity Center 中，为用户授予管理访问权限。

   有关如何使用 IAM Identity Center 目录 作为身份源的教程，请参阅《AWS IAM Identity Center 用户指南》中的 Configure user access with the default IAM Identity Center 目录。

以具有管理访问权限的用户身份登录

• 要使用您的 IAM Identity Center 用户身份登录，请使用您在创建 IAM Identity Center 用户时发送到您的电子邮件地址的登录网址。

  要获取使用 IAM Identity Center 用户登录方面的帮助，请参阅《AWS 登录 用户指南》中的 Signing in to the AWS access portal。

将访问权限分配给其他用户

1. 在 IAM Identity Center 中，创建一个权限集，该权限集遵循应用最低权限的最佳做法。

   有关说明，请参阅《AWS IAM Identity Center 用户指南》中的 Create a permission set。

2. 将用户分配到一个组，然后为该组分配单点登录访问权限。

   有关说明，请参阅《AWS IAM Identity Center 用户指南》中的 Add groups。

1. 设置 Espressif 硬件。

   有关设置 ESP32-WROOM-32SE 开发主板硬件的信息，请参阅《ESP32-DevKitC V4 入门指南》。

   重要

   在该指南的分步安装部分，请按照步骤进行操作，直到完成步骤 4（设置环境变量）。完成步骤 4 后，请暂停，然后按照此处的其余步骤进行操作。

2. 从 GitHub 下载 Amazon FreeRTOS。（有关说明，请参阅 README.md 文件。）

3. 设置开发环境。

   要与您的主板通信，必须安装工具链。Espressif 提供了 ESP-IDF 来为主板开发软件。由于 ESP-IDF 将其 FreeRTOS 内核版本集成为组件，因此，Amazon FreeRTOS 包含删除了 FreeRTOS 内核的 ESP-IDF v4.2 自定义版本。这修复了编译时重复文件的问题。要使用 Amazon FreeRTOS 附带的 ESP-IDF v4.2 的自定义版本，请按照以下主机操作系统的说明进行操作。

   （Windows）：

   1. 下载 ESP-IDF 的 Windows 版通用在线安装程序。

   2. 运行通用在线安装程序。

   3. 在下载或使用 ESP-IDF步骤，请选择使用现有 ESP-IDF 目录并将选择现有 ESP-IDF 目录设置为 freertos/vendors/espressif/esp-idf。

   4. 完成安装。

   macOS：

   1. 按照适用于 macOS 的工具链标准设置先决条件 (ESP-IDF v4.2) 中的说明进行操作。

      重要

      在后续步骤下的“获取 ESP-IDF”说明部分，请暂停并返回到此页面上的说明。

   2. 打开一个命令行窗口。

   3. 转到 FreeRTOS 下载目录，然后运行以下脚本来下载并安装适用于您平台的 espressif 工具链。

      vendors/espressif/esp-idf/install.sh

   4. 使用以下命令以将 ESP-IDF 工具链工具添加到终端路径中。

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

   （Linux）：

   1. 按照适用于 Linux 的工具链标准设置先决条件 (ESP-IDF v4.2) 中的说明进行操作。

      重要

      在后续步骤下的“获取 ESP-IDF”说明部分，请暂停并返回到此页面上的说明。

   2. 打开一个命令行窗口。

   3. 转到 FreeRTOS 下载目录，然后运行以下脚本来下载并安装适用于您平台的 Espressif 工具链。

      vendors/espressif/esp-idf/install.sh

   4. 使用以下命令以将 ESP-IDF 工具链工具添加到终端路径中。

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

4. 建立串行连接。

   1. 要在您的主机和 ESP32-WROOM-32SE 之间建立串行连接，请安装 CP210x USB to UART Bridge VCP 驱动程序。您可以从 Silicon Labs 下载这些驱动程序。

   2. 按照建立与 ESP32 的串行连接中的步骤操作。

   3. 建立串行连接后，记下主板连接的串行端口。您需要它来刷写演示。

1. 按照配置 FreeRTOS 演示中的步骤配置 FreeRTOS 演示项目。在对 AWS IoT 凭证进行格式化的最后一步，请暂停并执行以下步骤。

2. Microchip 提供了多种脚本工具来帮助设置 ATECC608A 部件。导航到 freertos/vendors/microchip/example_trust_chain_tool 目录并打开 README.md 文件。

3. 请按照 README.md 文件中的说明预置您的设备。相应步骤包括：

   1. 创建证书颁发机构并将其注册到 AWS。

   2. 在 ATECC608A 上生成您的密钥，并导出公有密钥和设备序列号。

   3. 为设备生成证书并将该证书注册到 AWS。

4. 按照 开发人员模式密钥预置 的说明，将 CA 证书和设备证书加载到设备上。

使用 AWS IoT MQTT 客户端订阅 MQTT 主题

1. 登录 AWS IoT 控制台。

2. 在导航窗格中，选择测试，然后选择 MQTT 测试客户端。

3. 在订阅主题中，输入 your-thing-name/example/topic，然后选择订阅主题。

在 Windows、Linux 和 macOS 上构建和刷写 FreeRTOS (ESP-IDF v4.2)

1. 转到 FreeRTOS 下载目录的根目录。

2. 在命令行窗口中输入以下命令以将 ESP-IDF 工具添加到终端 PATH 中：

   Windows（“命令”应用程序）

   vendors\espressif\esp-idf\export.bat

   Windows（“ESP-IDF 4.x CMD”应用程序）

   （打开应用程序时就已经完成此操作。）

   Linux / macOS

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

3. 在 build 目录中配置 cmake 并使用以下命令构建固件映像。

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

   您应该会看到以下示例的输出。

      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' 

   如果没有错误，构建会生成固件二进制 .bin 文件。

4. 使用以下命令擦除开发主板的闪存。

   idf.py erase_flash

5. 使用 idf.py 脚本将应用程序二进制文件刷写到主板。

   idf.py flash

6. 使用以下命令监控主板串行端口的输出。

   idf.py monitor

   注意

   • 您可以合并这些命令，如以下示例所示。

     idf.py erase_flash flash monitor

   • 对于某些主机设置，您必须在刷写主板时指定端口，如以下示例所示。

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

构建和刷写项目

1. 在命令行窗口中，转到 FreeRTOS 下载目录的根目录。

2. 运行以下脚本，将 ESP-IDF 工具添加到 Shell 的 PATH 中。

   Windows

   vendors\espressif\esp-idf\export.bat

   Linux / macOS

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

3. 使用以下命令来生成构建文件。

   对于 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

   对于 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. 擦除闪存，然后刷写主板。

   对于 Unix Makefiles

   make -C ./YOUR_BUILD_DIRECTORY erase_flash

   make -C ./YOUR_BUILD_DIRECTORY flash

   对于 Ninja

   ninja -C ./YOUR_BUILD_DIRECTORY erase_flash

   ninja -C ./YOUR_BUILD_DIRECTORY flash