使用适用于 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)

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

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

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

先决条件

要通过适用于 FreeRTOS 的 Amazon IoT Device Tester (IDT) UI 运行测试,必须完成第 先决条件 页上有关 IDT FreeRTOS 资格认证 (FRQ) 2.x 的先决条件。

配置 Amazon 凭证

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

  • 在凭证文件中

  • 作为环境变量

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 UI 的 IDT 中指定配置文件名称。有关配置文件的更多信息,请参阅命名配置文件

环境变量是由操作系统维护且由系统命令使用的变量。如果您关闭 SSH 会话,则不会保存。适用于 FreeRTOS UI 的 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 中,打开导航菜单,然后选择创建新配置

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

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

    • Amazon 账户设置 – 适用于 FreeRTOS的 IDT 在测试运行过程中用于创建 Amazon 资源 Amazon Web Services 账户 信息。这些设置在 config.json 文件中进行配置。

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

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

    • 空中下载 (OTA) 更新 - 控制 OTA 功能测试的设置。这些设置在 device.jsonuserdata.json 文件的 features 数据块中配置。

  3. 审核页面上,验证您的配置信息。

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

修改现有配置

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

修改配置

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

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

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

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

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

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

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

运行资格认证测试

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

运行资格认证测试

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

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

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

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

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

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