先决条件 - FreeRTOS
下载 FreeRTOS下载适用于 FreeRTOS 的 IDT创建和配置 AWS 账户AWS IoT Device Tester 托管策略(可选) 安装 AWS Command Line Interface
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

先决条件

此部分介绍通过 AWS IoT Device Tester 测试微控制器的先决条件。

下载 FreeRTOS

您可以从 GitHub 下载想要测试的 FreeRTOS 的版本。Windows 的路径长度限制为 260 个字符。FreeRTOS 的路径结构是多级深层结构，因此如果您使用 Windows，请确保文件路径不超过 260 个字符的限制。例如，将 FreeRTOS 克隆到 C:\FreeRTOS 而不是 C:\Users\username\programs\projects\myproj\FreeRTOS\。

下载适用于 FreeRTOS 的 IDT

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

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

注意

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

创建和配置 AWS 账户

按照以下步骤操作，创建和配置一个 AWS 账户、一个 IAM 用户以及一个 IAM 策略，该策略向适用于 FreeRTOS 的 IDT 授予在运行测试时代表您访问资源的权限。

  1. 如果您已有 AWS 账户，请跳到下一步。创建 AWS 账户。

  2. 创建一个 IAM 策略，向适用于 FreeRTOS 的 IDT 授予 IAM 权限以创建具有特定权限的服务角色。

    1. 登录 IAM 控制台。

    2. 在导航窗格中，选择 Policies。

    3. 在内容窗格中，选择创建策略。

    4. 选择 JSON 选项卡，然后将以下权限复制到 JSON 文本框中。

      重要

      以下策略模板授予创建角色、创建策略和将策略附加到角色的 IDT 权限。适用于 FreeRTOS 的 IDT 将这些权限用于创建角色的测试。尽管策略模板不向用户提供管理员权限，但这些权限可能用于获得对您的 AWS 账户的管理员访问权限。

      Most Regions
      {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:CreatePolicy",
                "iam:DetachRolePolicy",
                "iam:DeleteRolePolicy",
                "iam:DeletePolicy",
                "iam:CreateRole",
                "iam:DeleteRole",
                "iam:AttachRolePolicy"
            ],
            "Resource": [
                "arn:aws:iam::*:policy/idt*",
                "arn:aws:iam::*:role/idt*"
            ]
        }
    ]
}
      北京和宁夏区域

      可以在 北京和宁夏区域 中使用以下策略模板。

      {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iam:CreatePolicy",
                "iam:DetachRolePolicy",
                "iam:DeleteRolePolicy",
                "iam:DeletePolicy",
                "iam:CreateRole",
                "iam:DeleteRole",
                "iam:AttachRolePolicy"
            ],
            "Resource": [
                "arn:aws-cn:iam::*:policy/idt*",
                "arn:aws-cn:iam::*:role/idt*"
            ]
        }
    ]
}

    5. 完成后，选择 Review policy (查看策略)。

    6. 在 Review (查看) 页面上，输入 IDTFreeRTOSIAMPermissions 作为策略名称。查看策略 Summary (摘要) 以验证策略授予的权限。

    7. 选择 Create policy。

  3. 创建具有运行 AWS IoT Device Tester 所需权限的 IAM 用户。

    1. 按照创建 IAM 用户（控制台）中的步骤 1 到 5 操作。

    2. 将必要的权限附加到您的 IAM 用户：

      1. 在 Set permissions (设置权限) 页面上，选择 Attach existing policies to user directly (直接将现有策略附加到用户)。

      2. 搜索您在步骤 2 中创建的 IDTFreeRTOSIAMPermissions 策略。选中复选框。

      3. 搜索 AWSIoTDeviceTesterForFreeRTOSFullAccess 策略。选中复选框。

    3. 选择下一步: 标签。

    4. 选择 Next: Review (下一步：审核) 以查看您的选择摘要。

    5. 选择 Create user。

    6. 要查看用户的访问密钥（访问密钥 ID 和秘密访问密钥），请选择每个密码和访问密钥旁边的 Show (显示)，然后选择 Download .csv (下载 .csv)。将该文件保存到安全的位置。

AWS IoT Device Tester 托管策略

AWSIoTDeviceTesterForFreeRTOSFullAccess 托管策略包含以下权限，允许设备测试程序执行和收集指标：

  • iot-device-tester:SupportedVersion

    授予权限以获取 IDT 支持的 FreeRTOS 版本和测试套件版本列表，以便它们可以从 AWS CLI 获取。

  • iot-device-tester:LatestIdt

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

  • iot-device-tester:CheckVersion

    授予权限以检查产品、测试套件和 AWS IoT Device Tester 版本组合是否兼容。

  • iot-device-tester:DownloadTestSuite

    向 AWS IoT Device Tester 授予权限以下载测试套件。

  • iot-device-tester:SendMetrics

    授予权限以发布 AWS IoT Device Tester 使用情况指标数据。

(可选) 安装 AWS Command Line Interface

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

通过从命令行运行 aws configure，为要使用的 AWS 区域配置 CLI。有关支持适用于 FreeRTOS 的 IDT 的 AWS 区域的信息，请参阅 AWS 区域和终端节点。