乐鑫-WROOM-32SE ESP32 入门

要注册 AWS 账户

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

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

   注册过程的一部分涉及接听电话或短信，并在电话键盘上输入验证码。

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

保护你的 AWS 账户根用户

1. 选择 Root 用户并输入您的 AWS 账户 电子邮件地址，以账户所有者的身份登录。AWS Management Console在下一页上，输入您的密码。

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

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

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

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

1. 启用 IAM Identity Center。

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

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

   有关使用 IAM Identity Center 目录 作为身份源的教程，请参阅《用户指南》 IAM Identity Center 目录中的使用默认设置配置AWS IAM Identity Center 用户访问权限。

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

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

  有关使用 IAM Identity Center 用户登录的帮助，请参阅AWS 登录 用户指南中的登录 AWS 访问门户。

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

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

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

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

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

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

2. 按照步骤与建立串行连接 ESP32。

3. 建立串行连接后，记下主板连接的串行端口。在构建演示时需要用到它。

1. 按照配置 FreeRTOS 演示中的步骤配置 FreeRTOS 演示项目。跳过最后一步格式化您的 AWS IoT 凭证，然后改为执行以下步骤。

2. Microchip 提供了多种脚本工具来帮助设置 ATECC6 08A 部件。导航到 freertos/vendors/microchip/secure_elements/app/example_trust_chain_tool 目录，然后打开 README.md 文件。

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

   1. 创建并注册证书颁发机构 AWS

   2. 在 ATECC6 08A 上生成密钥并导出公钥和设备序列号

   3. 为设备生成证书并向注册该证书 AWS

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

使用生成演示应用程序的编译文件 CMake

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

2. 在命令行窗口中，输入以下命令以生成构建文件。

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

   备注

   要构建用于调试的应用程序，请添加 -DCMAKE_BUILD_TYPE=Debug 标志。

   要生成测试应用程序构建文件，请添加 -DAFR_ENABLE_TESTS=1 标志。

   Espressif 提供的代码使用轻型 IP (lwIP) 堆栈作为默认网络堆栈。要改用 freerTOS+TCP 网络堆栈，请在命令中添加标–DAFR_ESP_FREERTOS_TCP志。 CMake

   要为非供应商提供的代码添加 LwIP 依赖关系，请在自定义 Wi-Fi 组件的依赖文件 CMake CMakeLists.txt中添加以下几行。

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

使用 Make 构建应用程序

1. 导航到 build 目录。

2. 在命令行窗口中，输入以下命令以通过 Make 构建应用程序。

   make all -j4

   注意

   每当您在 aws_demos 项目和 aws_tests 项目之间切换时，都必须使用 cmake 命令构建生成文件。

使用生成演示应用程序的编译文件 CMake

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

2. 在命令行窗口中，输入以下命令以生成构建文件。

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

   注意

   要构建用于调试的应用程序，请添加 -DCMAKE_BUILD_TYPE=Debug 标志。

   要生成测试应用程序构建文件，请添加 -DAFR_ENABLE_TESTS=1 标志。

   Espressif 提供的代码使用轻型 IP (lwIP) 堆栈作为默认网络堆栈。要改用 freerTOS+TCP 网络堆栈，请在命令中添加标–DAFR_ESP_FREERTOS_TCP志。 CMake

   要为非供应商提供的代码添加 LwIP 依赖关系，请在自定义 Wi-Fi 组件的依赖文件 CMake CMakeLists.txt中添加以下几行。

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

构建应用程序

1. 导航到 build 目录。

2. 在命令行窗口中，输入以下命令以调用 Ninja 来构建应用程序。

   ninja

   或者，使用通用 CMake 接口来构建应用程序。

   cmake --build your-build-directory

   注意

   每当您在 aws_demos 项目和 aws_tests 项目之间切换时，都必须使用 cmake 命令构建生成文件。

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

2. 按照步骤与建立串行连接 ESP32。

3. 建立串行连接后，记下主板连接的串行端口。在构建演示时需要用到它。

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

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

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

   1. 创建并注册证书颁发机构 AWS

   2. 在 ATECC6 08A 上生成密钥并导出公钥和设备序列号

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

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

构建和刷写项目

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

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

   Windows

   vendors\espressif\esp-idf\export.bat

   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

构建和刷写项目

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

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

1. 登录 AWS IoT 控制台。

2. 在导航窗格中，选择测试以打开 MQTT 客户端。

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