使用 IDT for FreeRTOS 用户界面运行 FreeRTOS 资格套件 2.0 (FRQ 2.0) - FreeRTOS
先决条件配置Amazon凭证打开 FreeRTOS 用户界面的 IDT创建新的配置修改现有配置运行资格测试
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用 IDT for FreeRTOS 用户界面运行 FreeRTOS 资格套件 2.0 (FRQ 2.0)

Amazon IoT Device Testerfor FreeRTOS（适用于 FreeRTOS 的 IDT）包括基于 Web 的用户界面 (UI)，您可以在其中与 IDT 命令行应用程序和相关配置文件进行交互。您可以使用 IDT for FreeRTOS 用户界面为设备创建新配置或修改现有配置。您还可以使用用户界面调用 IDT 应用程序并针对您的设备运行 FreeRTOS 测试。

有关如何使用命令行运行资格测试的信息，请参阅准备首次测试微控制器主板。

本节介绍了 FreeRTOS 用户界面的 IDT 的先决条件以及如何从用户界面运行资格测试。

先决条件

要通过 FreeRTOS 用户界面的Amazon IoT Device Tester (IDT) 运行测试，您必须完成 IDT FreeRTOS 资格认证 (FRQ) 2.x先决条件 页面上的先决条件。

配置Amazon凭证

您必须为在中创建的用户配置 IAMAmazon 用户证书创建和配置 Amazon 账户。您可以采用以下两种方法之一来指定凭证：

  • 在凭证文件中

  • 作为环境变量

IDT 使用与 Amazon CLI 相同的凭证文件。有关更多信息，请参阅配置和凭证文件。

凭证文件的位置因您使用的操作系统而异：

  • macOS 和 Linux —~/.aws/credentials

  • Windows – C:\Users\UserName\.aws\credentials

按以下格式将您的Amazon凭证添加到credentials文件中：

[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
注意

如果您不使用defaultAmazon配置文件，则必须在 FreeRTOS 用户界面的 IDT 中指定配置文件名称。有关配置文件的更多信息，请参阅命名配置文件。

环境变量是由操作系统维护且由系统命令使用的变量。如果您关闭 SSH 会话，则不会保存它们。FreeRTOS 用户界面的 IDT 使用AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY环境变量来存储您的Amazon证书。

要在 Linux、macOS 或 Unix 上设置这些变量，请使用 export：

export AWS_ACCESS_KEY_ID=your_access_key_id
export AWS_SECRET_ACCESS_KEY=your_secret_access_key

要在 Windows 上设置这些变量，请使用 set：

set AWS_ACCESS_KEY_ID=your_access_key_id
set AWS_SECRET_ACCESS_KEY=your_secret_access_key

打开 FreeRTOS 用户界面的 IDT

打开 FreeRTOS 的 IDT 用户界面

  1. 下载支持的 FreeRTOS 版本的 IDT。然后将下载的存档解压到您具有读写权限的目录中。

  2. 导航到 FreeRTOS 的 IDT 安装目录：

    cd devicetester-extract-location/bin

  3. 运行以下命令以打开 FreeRTOS 用户界面的 IDT：

    Linux
    .devicetester_ui_linux_x86-64
    Windows
    ./devicetester_ui_win_x64-64
    macOS
    ./devicetester_ui_mac_x86-64
    注意

    在 macOS 中，要允许您的系统运行用户界面，请前往 “系统偏好设置”-> “安全和隐私”。当你运行测试时，你可能需要再做三次。这个

    FreeRTOS 的 IDT 用户界面将在您的默认浏览器中打开。以下浏览器的最新三个主要版本支持用户界面：

    • Google Chrome

    • Mozilla Firefox

    • Microsoft Edge

    • Apple Safari for macOS

    注意

    为了获得更好的体验，我们建议谷歌浏览器或 Mozilla Firefox 访问 FreeRTOS 用户界面的 IDT。用户界面不支持微软 Internet Explorer。

    重要

    在打开 UI 之前，必须配置您的Amazon证书。如果您尚未配置证书，请关闭 IDT for FreeRTOS 用户界面浏览器窗口，按照中的步骤操作配置Amazon凭证，然后重新打开 FreeRTOS 用户界面的 IDT。

创建新的配置

如果您是首次使用的用户，则必须创建新配置来设置 IDT for FreeRTOS 运行测试所需的 JSON 配置文件。然后，您可以运行测试或修改创建的配置。

有关config.json、device.json和userdata.json文件的示例，请参见准备首次测试微控制器主板。

创建新的配置

  1. 在 IDT for FreeRTOS 用户界面中，打开导航菜单，然后选择创建新配置。

  2. 按照配置向导输入用于运行资格测试的 IDT 配置设置。该向导在位于devicetester-extract-location/config目录的 JSON 配置文件中配置以下设置。

    • 设备设置-待测试设备的设备池设置。这些设置是在id和sku字段中配置的，设备块用于config.json文件中的设备池。

    • Amazon帐户设置 — IDT for FreeRTOS 在测试运行期间用于创建Amazon资源Amazon Web Services 账户的信息。这些设置是在config.json文件中配置的。

    • FreeRTOS 实现 — FreeRTOS 存储库和移植代码的绝对路径，以及你想要在其上运行 IDT FRQ 的 FreeRTOS 版本。FreeRTOS-Libraries-Integration-Tests GitHub 存储库中执行文件和参数配置头文件的路径。硬件的编译和 flash 命令，允许 IDT 在你的主板上自动构建和闪存测试。这些设置是在userdata.json文件中配置的。

    • PKCS #11 标签和 Echo 服务器 — PKCS #11 标签，对应于根据关键功能和密钥配置方法在硬件中配置的密钥。传输接口的 echo 服务器配置设置测试。这些设置是在userdata.json和device.json文件中配置的。

    • Over-the-air (OTA) 更新-控制 OTA 功能测试的设置。这些设置是在device.json和userdata.json文件的features块中配置的。

  3. 在 “查看” 页面上，验证您的配置信息。

检查完配置后，要运行资格测试，请选择 “运行测试”。

修改现有配置

如果您已经为 FreeRTOS 的 IDT 设置了配置文件，则可以使用 IDT for FreeRTOS 用户界面修改现有配置。现有配置文件必须位于devicetester-extract-location/config目录中。

修改配置

  1. 在 IDT for FreeRTOS 用户界面中，打开导航菜单，然后选择编辑现有配置。

    配置仪表板显示有关您的现有配置设置的信息。如果配置不正确或不可用，则该配置的状态为Error validating configuration。

  2. 要修改现有配置设置，请完成以下步骤：

    1. 选择配置设置的名称以打开其设置页面。

    2. 修改设置，然后选择 “保存” 以重新生成相应的配置文件。

  3. 要修改 FreeRTOS 的 IDT 测试运行设置，请在编辑视图中选择 IDT 测试运行设置：

修改完配置后，请验证所有配置设置是否通过验证。如果每个配置设置的状态为Valid，则可以使用此配置运行资格测试。

运行资格测试

为 FreeRTOS 用户界面的 IDT 创建配置后，您可以运行资格测试。

运行资格测试

  1. 在导航菜单中，选择运行测试。

  2. 选择 “开始测试” 以开始测试运行。默认情况下，将针对您的设备配置运行所有适用的测试。FreeRTOS 的 IDT 会在所有测试完成后生成资格报告。

FreeRTOS 的 IDT 负责运行资格测试。然后，它会在测试运行器控制台中显示测试运行摘要和任何错误。测试运行完成后，您可以从以下位置查看测试结果和日志：

  • 测试结果位于devicetester-extract-location/results/execution-id目录中。

  • 测试日志位于devicetester-extract-location/results/execution-id/logs目录中。

有关测试结果和日志的更多信息，请参阅了解结果和日志。