先决条件 - FreeRTOS
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

先决条件

本节介绍通过 Amazon IoT Device Tester 测试微控制器的先决条件。

下载 FreeRTOS

你可以使用以下命令GitHub从中下载 FreeRTOS 的发行版:

git clone --branch <FREERTOS_RELEASE_VERSION> --recurse-submodules https://github.com/aws/amazon-freertos.git cd amazon-freertos git submodule update --checkout --init --recursive

其中 <FREERTOS_RELEASE_VERSION> 是与 支持的适用于 FreeRTOS 的 Amazon IoT Device Tester 版本 中列出的 IDT 版本对应的 FreeRTOS 版本(例如 202007.00)。这样可以确保您拥有完整的源代码,包括子模块,并且使用适用于您的 FreeRTOS 版本的 IDT 的正确版本,反之亦然。

Windows 的路径长度限制为 260 个字符。FreeRTOS 的路径结构是多级深层结构,因此如果您使用 Windows,请确保文件路径不超过 260 个字符的限制。例如,将 FreeRTOS 克隆到 C:\FreeRTOS 而不是 C:\Users\username\programs\projects\myproj\FreeRTOS\

LTS 资格认证的注意事项(使用 LTS 库的 FreeRTOS 的资格认证)

  • 要在 Amazon 合作伙伴设备目录中将您的微控制器指定为支持基于长期支持 (LTS) 的 FreeRTOS 版本,您必须提供清单文件。有关更多信息,请参阅《FreeRTOS 资格认证指南》中的 FreeRTOS 资格认证检查清单

  • 为了验证您的微控制器是否支持基于 LTS 的 FreeRTOS 版本,并使其有资格提交到 Amazon 合作伙伴设备目录,您必须使用 Amazon IoT Device Tester (IDT) 和 FreeRTOS 资格认证 (FRQ) 测试套件版本 v1.4.x。

  • 对基于 LTS 的 FreeRTOS 版本的支持仅限于 202012.xx 版本的 FreeRTOS。

下载适用于 FreeRTOS 的 IDT

为了执行资格认证测试,FreeRTOS 的每个版本都有对应的适用于 FreeRTOS 的 IDT 版本。从 支持的适用于 FreeRTOS 的 Amazon IoT Device Tester 版本 下载适用于 FreeRTOS 的 ITD 的相应版本。

将适用于 FreeRTOS 的 IDT 提取到文件系统上您具有读写权限的位置。由于 Microsoft Windows 对路径长度具有字符数限制,因此将适用于 FreeRTOS 的 IDT 提取到根目录,如 C:\D:\

注意

我们不建议多个用户从共享位置(如 NFS 目录或 Windows 网络共享文件夹)运行 IDT。这可能会导致崩溃或数据损坏。我们建议您将 IDT 包解压缩到本地驱动器。

创建和配置 Amazon 账户

注册 Amazon Web Services 账户

如果您还没有 Amazon Web Services 账户,请完成以下步骤来创建一个。

注册 Amazon Web Services 账户
  1. 打开 https://portal.aws.amazon.com/billing/signup

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

    在注册时,将接到一通电话,要求使用电话键盘输入一个验证码。

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

注册过程完成后,Amazon 会向您发送一封确认电子邮件。在任何时候,您都可以通过转至 https://aws.amazon.com/ 并选择我的账户来查看当前的账户活动并管理您的账户。

保护 IAM 用户

注册 Amazon Web Services 账户 后,启用多重身份验证 (MFA) 保护您的管理用户。有关说明,请参阅《IAM 用户指南》中的为 IAM 用户启用虚拟 MFA 设备(控制台)

要授予其他用户访问您的 Amazon Web Services 账户资源的权限,请创建 IAM 用户。为了保护您的 IAM 用户,请启用 MFA 并仅向 IAM 用户授予执行任务所需的权限。

有关创建和保护 IAM 用户的更多信息,请参阅《IAM 用户指南》中的以下主题:

Amazon IoT Device Tester 托管式策略

AWSIoTDeviceTesterForFreeRTOSFullAccess 托管策略包含版本检查、更新功能和指标收集的以下 Amazon IoT Device Tester 权限。

  • iot-device-tester:SupportedVersion

    授予 Amazon IoT Device Tester 获取受支持产品、测试套件和 IDT 版本列表的权限。

  • iot-device-tester:LatestIdt

    授予 Amazon IoT Device Tester 获取可供下载的最新 IDT 版本的权限。

  • iot-device-tester:CheckVersion

    授予 Amazon IoT Device Tester 检查 IDT、测试套件和产品的版本兼容性的权限。

  • iot-device-tester:DownloadTestSuite

    授予 Amazon IoT Device Tester 下载测试套件更新的权限。

  • iot-device-tester:SendMetrics

    授予 Amazon 收集有关 Amazon IoT Device Tester 内部使用情况的指标的权限。

(可选)安装 Amazon Command Line Interface

您可能偏好使用 Amazon CLI 执行一些操作。如果您没有安装 Amazon CLI,请按照安装 Amazon CLI 中的说明执行操作。

通过从命令行运行 aws configure,为要使用的 Amazon 区域配置 Amazon CLI。有关支持适用于 FreeRTOS 的 IDT 的 Amazon 区域的信息,请参阅 Amazon 区域和端点。有关 aws configure 的更多信息,请参阅使用 aws configure 进行快速配置