本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 适用于 FreeRTOS 资格认证套件 2.0（FRQ 2.0）的 IDT 的 UI AWS IoT Device Tester for F reeRTOS（FreeRTOS 的 IDT）包括一个基于 Web 的用户界面 (UI)，您可以在其中与 IDT 命令行应用程序和相关的配置文件进行交互。您可以使用适用于 FreeRTOS 的 IDT 用户界面为您的设备创建新配置或修改现有配置。您还可以使用 UI 调用 IDT 应用程序并对您的设备运行 FreeRTOS 测试。 有关如何使用命令行运行资格认证测试的信息，请参阅[首次测试微控制器主板](lts-qual-steps.md)。 本节介绍了适用于 FreeRTOS UI 的 IDT 的先决条件以及如何从 UI 运行资格认证测试。 **Topics** + [设置 IDT 先决条件](#lts-dev-tester-ui-prereqs) + [配置 AWS 凭据以使用 IDT 用户界面](lts-configure-aws-credentials.md) + [打开适用于 FreeRTOS UI 的 IDT](lts-open-idt-ui.md) + [创建新的配置](lts-create-new-configuration.md) + [修改现有配置](lts-modify-existing-configuration.md) + [运行资格认证测试](lts-run-tests-from-ui.md) ## 设置 IDT 先决条件 要通过 AWS IoT Device Tester (IDT) for FreeRTOS 用户界面运行测试，必须完成 IDT FreeRTOS 资格认证 (FRQ) 2.x [设置 LTS 资格认证先决条件](lts-idt-dev-tester-prereqs.md) 页面上的先决条件。 # 配置 AWS 凭据以使用 IDT 用户界面 您必须为在中创建的用户配置 IAM AWS 用户证书[创建一个 AWS 账户](lts-idt-dev-tester-prereqs.md#lts-config-aws-account)。您可以采用以下两种方法之一来指定凭证： + 在凭证文件中 + 作为环境变量 ## 使用 AWS 凭证文件配置凭证 IDT 使用与 AWS CLI相同的凭证文件。有关更多信息，请参阅[配置和凭证文件](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html)。 凭证文件的位置因您使用的操作系统而异： + **macOS 和 Linux** – `~/.aws/credentials` + **Windows** – `C:\Users\UserName\.aws\credentials` 按以下格式将您的 AWS 凭证添加到`credentials`文件中： ``` [default] aws_access_key_id = your_access_key_id aws_secret_access_key = your_secret_access_key ``` **注意** 如果您不使用`default` AWS 配置文件，则必须在 IDT for FreeRTOS 用户界面中指定配置文件名称。有关配置文件的更多信息，请参阅[配置和凭证文件设置](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)。 ## 使用环境变量配置 AWS 凭证 环境变量是由操作系统维护且由系统命令使用的变量。如果您关闭 SSH 会话，则不会保存。适用于 FreeRTOS 的 IDT 用户界面使用`AWS_ACCESS_KEY_ID``AWS_SECRET_ACCESS_KEY`和环境变量来存储您的证书。 AWS 要在 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 以使用 FreeRTOS 资格认证套件。 **打开适用于 FreeRTOS UI 的 IDT** 1. 下载支持的适用于 FreeRTOS 版本的 IDT。然后将下载的存档解压缩到您拥有读写权限的目录中。 1. 转到适用于 FreeRTOS 的 IDT 安装的目录： ``` cd devicetester-extract-location/bin ``` 1. 运行以下命令以打开适用于 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 之前，您必须配置您的 AWS 凭据。如果您尚未配置凭证，请关闭适用于 FreeRTOS UI 的 IDT 浏览器窗口，按照[配置 AWS 凭据以使用 IDT 用户界面](lts-configure-aws-credentials.md)中的步骤操作，然后重新打开适用于 FreeRTOS UI 的 IDT。 # 创建新的配置 如果您是首次使用的用户，则必须创建一个新配置来设置适用于 FreeRTOS 的 IDT 运行测试所需的 JSON 配置文件。然后，您可以运行测试或修改已创建的配置。 有关 `config.json`、`device.json` 和 `userdata.json` 文件的示例，请参阅[首次测试微控制器主板](lts-qual-steps.md)。 **创建新的配置** 1. 在适用于 FreeRTOS UI 的 IDT 中，打开导航菜单，然后选择**创建新配置**。 ![\[适用于 FreeRTOS 的 Device Tester 的界面，其中包含“创建新配置”按钮和有关微控制器自动自检的信息。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/gsg-create-configuration.png) 1. 按照配置向导输入用于运行资格认证测试的 IDT 配置设置。该向导在 `devicetester-extract-location/config` 目录中的 JSON 配置文件中配置以下设置。 + **设备设置** – 要测试的设备的设备池设置。这些设置在 `id` 和 `sku` 字段中配置，设备池的**设备**数据块位于 `config.json` 文件中。 ![\[适用于 FreeRTOS 的 Device Tester 的配置屏幕，其中包含用于配置设备池的标识符和 SKU 字段、设备设置选项（如连接方法、密钥预置、PKCS #11 设置和设备详细信息输入字段）以及用于添加设备或标识符的控件。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/gsg-device-settings.png) + **AWS 帐户设置** — 适用于 FreeRTOS 的 IDT 在测试运行期间用于 AWS 创建资源 AWS 账户 的信息。这些设置在 `config.json` 文件中进行配置。 ![\[AWS 账户 设置页面，其中包含账户区域、凭据位置（如文件或环境）以及个人资料名称字段\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/gsg-account-settings.png) + **FreeRTOS 实现** — FreeRTOS 存储库和移植代码的绝对路径，以及您想要运行 IDT FRQ 的 FreeRTOS 版本。`FreeRTOS-Libraries-Integration-Tests` GitHub 存储库中执行和参数配置头文件的路径。适用于您的硬件的构建和刷写命令，允许 IDT 在您的主板上自动构建和刷写测试。这些设置在 `userdata.json` 文件中进行配置。 ![\[FreeRTOS 实施配置部分，其中包含存储库路径、测试执行路径、FreeRTOS 版本、构建工具详细信息和闪存工具设置。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/gsg-implementation-settings.png) + **PKCS \$111 标签和 Echo 服务器** – [PKCS \$111](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting-pkcs.html) 标签对应于根据关键功能和密钥预配方法在硬件中配置的密钥。传输接口测试的 Echo 服务器配置设置。这些设置在 `userdata.json` 和 `device.json` 文件中进行配置。 ![\[PKCS #11 标签和 Echo 服务器配置，其中包含密钥标签、密钥生成方法和服务器端口号的输入字段\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/gsg-pkcs11-settings.png) + **Over-the-air (OTA) 更新**-控制 OTA 功能测试的设置。这些设置在 `device.json` 和 `userdata.json` 文件的 `features` 数据块中配置。 ![\[OTA 更新配置选项：跳过测试、数据协议、固件路径、PAL 证书路径、代码签名、 hash/sign 算法、签名者证书、 trusted/untrusted 签名者证书文件、编译签名者证书、签名者平台。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/gsg-ota-settings.png) 1. 在**审核**页面上，验证您的配置信息。 ![\[适用于 FreeRTOS 的 Device Tester 的“已创建配置”对话框，展示了有关创建新测试配置的详细信息，同时展示了编辑或运行测试选项。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/gsg-configuration-created.png) 审核配置完成后，要运行资格认证测试，请选择**运行测试**。 # 修改现有配置 如果您已经为适用于 FreeRTOS 的 IDT 设置了配置文件，则可以使用适用于 FreeRTOS UI 的 IDT 修改现有配置。现有的配置文件必须位于 `devicetester-extract-location/config` 目录中。 **修改配置** 1. 在适用于 FreeRTOS UI 的 IDT 中，打开导航菜单，然后选择**编辑现有配置**。 配置控制面板会显示有关现有配置设置的信息。如果配置不正确或不可用，则配置的状态为 `Error validating configuration`。 ![\[配置屏幕，显示有效状态的设备 AWS 账户、FreeRTOS 实现、PKCS 标签和 echo 服务器 over-the-air、更新和测试运行设置部分。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/modify-existing-configuration.png) 1. 要修改现有配置设置，请完成以下步骤： 1. 选择配置设置的名称以打开其设置页面。 1. 修改设置，然后选择**保存**，以便重新生成相应的配置文件。 1. 要修改适用于 FreeRTOS 的 IDT 测试运行设置，请在编辑视图中选择 **IDT 测试运行设置**： ![\[“IDT 测试运行设置”对话框，其中包含测试选择、跳过测试组、超时倍数和第一次失败时停止的选项。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/idt-testrun-settings.png) 修改配置完成后，请确认所有配置设置均可通过验证。如果每个配置设置的状态为 `Valid`，则可以使用此配置运行资格认证测试。 # 运行资格认证测试 为适用于 FreeRTOS UI 的 IDT 创建配置后，就可以运行资格认证测试了。 **运行资格认证测试** 1. 在导航菜单中，选择**运行测试**。 1. 要开始运行测试，请选择**开始测试**。默认情况下，会针对您的设备配置运行所有适用的测试。适用于 FreeRTOS 的 IDT 会在所有测试完成后生成一份资格认证报告。 ![\[适用于 FreeRTOS 的 Device Tester 的界面，展示了“尚未运行任何测试”消息，以及创建新配置、编辑现有配置和运行测试的选项。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/idt-run-tests.png) 适用于 FreeRTOS 的 IDT 运行资格认证测试。然后，它会在**测试运行器**控制台中显示测试运行摘要和所有错误。测试运行完成后，您可以从以下位置查看测试结果和日志： + 测试结果位于 `devicetester-extract-location/results/execution-id` 目录中。 + 测试日志位于 `devicetester-extract-location/results/execution-id/logs` 目录中。 有关测试结果和日志的更多信息，请参阅[免费查看 IDT RTOSresults](view-results-lts.md)和[免费查看 IDT RTOSlogs](view-logs-lts.md)。 ![\[适用于 FreeRTOS 的 Device Tester 的执行日志，展示了测试通过情况、测试组以及日志和报告的文件路径。\]](http://docs.aws.amazon.com/zh_cn/freertos/latest/userguide/images/idt-results.png)