使用适用于 FreeRTOS 的 IDT 用户界面运行 FreeRTOS 资格认证套件 2.0 (FRQ 2.0) - FreeRTOS
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

使用适用于 FreeRTOS 的 IDT 用户界面运行 FreeRTOS 资格认证套件 2.0 (FRQ 2.0)

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

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

本节介绍了适用于 FreeRTOS UI 的 IDT 的先决条件以及如何从 UI 运行资格认证测试。

先决条件

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

配置 Amazon 凭证

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

  • 在凭证文件中

  • 作为环境变量

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

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

  • macOS 和 Linux~/.aws/credentials

  • WindowsC:\Users\UserName\.aws\credentials

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

[default] aws_access_key_id = your_access_key_id aws_secret_access_key = your_secret_access_key
注意

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

环境变量是由操作系统维护且由系统命令使用的变量。如果您关闭 SSH 会话,则不会保存。适用于 FreeRTOS 的 IDT 用户界面使用AWS_ACCESS_KEY_IDAWS_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 UI 的 IDT

打开适用于 FreeRTOS UI 的 IDT
  1. 下载支持的适用于 FreeRTOS 版本的 IDT。然后将下载的存档解压缩到您拥有读写权限的目录中。

  2. 转到适用于 FreeRTOS 的 IDT 安装的目录:

    cd devicetester-extract-location/bin
  3. 运行以下命令以打开适用于 FreeRTOS UI 的 IDT:

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

    在 macOS 中,要允许您的系统运行此 UI,请转到系统首选项 -> 安全和隐私。当您运行测试时,可能需要再执行此命令三次。

    适用于 FreeRTOS UI 的 IDT 将在您的默认浏览器中打开。以下浏览器的最新三个主要版本支持此 UI:

    • Google Chrome

    • Mozilla Firefox

    • Microsoft Edge

    • Apple Safari for macOS

    注意

    为了获得更好的体验,我们建议使用 Google Chrome 或 Mozilla Firefox 来访问适用于 FreeRTOS UI 的 IDT。此 UI 不支持 Microsoft Internet Explorer。

    重要

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

创建新的配置

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

有关 config.jsondevice.jsonuserdata.json 文件的示例,请参阅准备首次测试微控制器主板

创建新的配置
  1. 在适用于 FreeRTOS UI 的 IDT 中,打开导航菜单,然后选择创建新配置

    FreeRTOS 设备测试器界面带有 “创建新配置” 按钮和有关微控制器自动自检的信息。
  2. 按照配置向导输入用于运行资格认证测试的 IDT 配置设置。该向导在 devicetester-extract-location/config 目录中的 JSON 配置文件中配置以下设置。

    • 设备设置 – 要测试的设备的设备池设置。这些设置在 idsku 字段中配置,设备池的设备数据块位于 config.json 文件中。

      FreeRTOS 设备测试器配置屏幕,其中包含用于配置设备池的标识符和 SKU 字段、连接方法、密钥配置、PKCS #11 设置、设备详细信息输入字段以及用于添加设备或标识符的控件等设备设置选项。
    • Amazon 帐户设置 — 适用于 FreeRTOS 的 IDT 在测试运行期间用于 Amazon 创建资源 Amazon Web Services 账户 的信息。这些设置在 config.json 文件中进行配置。

      Amazon Web Services 账户 设置页面,其中包含账户区域、凭据位置(如文件或环境)以及个人资料名称字段
    • FreeRTOS 实现 — FreeRTOS 存储库和移植代码的绝对路径,以及您想要运行 IDT FRQ 的 FreeRTOS 版本。FreeRTOS-Libraries-Integration-Tests GitHub 存储库中执行和参数配置头文件的路径。适用于您的硬件的构建和刷写命令,允许 IDT 在您的主板上自动构建和刷写测试。这些设置在 userdata.json 文件中进行配置。

      FreeRTOS 实现配置部分包含存储库路径、测试执行路径、FreeRTOS 版本、构建工具详细信息和 Flash 工具设置。
    • PKCS #11 标签和 Echo 服务器PKCS #11 标签对应于根据关键功能和密钥预配方法在硬件中配置的密钥。传输接口测试的 Echo 服务器配置设置。这些设置在 userdata.jsondevice.json 文件中进行配置。

      PKCS #11 标签和 Echo 服务器配置,包括密钥标签、密钥生成方法和服务器端口号的输入字段
    • O ver-the-air (OTA) 更新-控制 OTA 功能测试的设置。这些设置在 device.jsonuserdata.json 文件的 features 数据块中配置。

      OTA 更新配置选项:跳过测试、数据协议、固件路径、PAL 证书路径、代码签名、哈希/签名算法、可信/不可信的签名者证书、签名者证书文件、编译签名者证书、签名者平台。
  3. 审核页面上,验证您的配置信息。

    为 FreeRTOS 设备测试器创建配置对话框,显示有关创建带有编辑或运行测试选项的新测试配置的详细信息。

审核配置完成后,要运行资格认证测试,请选择运行测试

修改现有配置

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

修改配置

  1. 在适用于 FreeRTOS UI 的 IDT 中,打开导航菜单,然后选择编辑现有配置

    配置控制面板会显示有关现有配置设置的信息。如果配置不正确或不可用,则配置的状态为 Error validating configuration

    配置屏幕,显示有效状态的设备 Amazon Web Services 账户、FreeRTOS 实现、PKCS 标签和 echo 服务器 over-the-air 、更新和测试运行设置部分。
  2. 要修改现有配置设置,请完成以下步骤:

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

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

  3. 要修改适用于 FreeRTOS 的 IDT 测试运行设置,请在编辑视图中选择 IDT 测试运行设置

    IDT 测试运行设置对话框,其中包含测试选择、跳过测试组、超时倍数和第一次失败时停止的选项。

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

运行资格认证测试

为适用于 FreeRTOS UI 的 IDT 创建配置后,就可以运行资格认证测试了。

运行资格认证测试

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

  2. 要开始运行测试,请选择开始测试。默认情况下,会针对您的设备配置运行所有适用的测试。适用于 FreeRTOS 的 IDT 会在所有测试完成后生成一份资格认证报告。

    FreeRTOS 的设备测试器界面显示尚未运行任何测试,其中包含创建新配置、编辑现有配置和运行测试的选项。

适用于 FreeRTOS 的 IDT 运行资格认证测试。然后,它会在测试运行器控制台中显示测试运行摘要和所有错误。测试运行完成后,您可以从以下位置查看测试结果和日志:

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

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

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

FreeRTOS 设备测试器执行日志,显示已通过的测试、测试组以及日志和报告的文件路径。