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

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

先决条件

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

下载 FreeRTOS

您可以从下载 FreeRTOS 版本。GitHub使用以下命令:

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

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

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

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

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

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

下载适用于 FreeRTOS 的 IDT

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

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

注意

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

创建和配置 Amazon 账户

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

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

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

    1. 登录 IAM 控制台

    2. 在导航窗格中,选择 Policies (策略)

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

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

      重要

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

      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*" ] } ] }
      Beijing and Ningxia 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-cn:iam::*:policy/idt*", "arn:aws-cn:iam::*:role/idt*" ] } ] }
    5. 完成后,选择查看策略

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

    7. 选择 Create policy(创建策略)

  3. 使用运行所需权限创建 IAM 用户Amazon IoT Device Tester.

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

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

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

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

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

    3. 选择 Next:。标签

    4. 选择 Next:。审核以查看您的选择摘要。

    5. 选择 Create user

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

Amazon IoT Device Tester 托管式策略

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

  • iot-device-tester:SupportedVersion

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

  • iot-device-tester:LatestIdt

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

  • iot-device-tester:CheckVersion

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

  • iot-device-tester:DownloadTestSuite

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

  • iot-device-tester:SendMetrics

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

(可选) 安装 Amazon Command Line Interface

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

配置Amazon CLI(对于 )Amazon你想通过运行来使用的地区aws configure从命令行中。有关的信息Amazon支持 FreeRTOS 的 IDT 的地区,请参阅Amazon区域和终端节点. 有关 的更多信息aws configure看到使用 进行快速配置aws configure.