本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用适用于 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
-
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
注意
如果您不使用 default
Amazon 配置文件,则必须在适用于 FreeRTOS UI 的 IDT 中指定配置文件名称。有关配置文件的更多信息,请参阅命名配置文件。
环境变量是由操作系统维护且由系统命令使用的变量。如果您关闭 SSH 会话,则不会保存。适用于 FreeRTOS UI 的 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 UI 的 IDT
打开适用于 FreeRTOS UI 的 IDT
-
下载支持的适用于 FreeRTOS 版本的 IDT。然后将下载的存档解压缩到您拥有读写权限的目录中。
-
转到适用于 FreeRTOS 的 IDT 安装的目录:
cd
devicetester-extract-location
/bin -
运行以下命令以打开适用于 FreeRTOS UI 的 IDT:
适用于 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.json
、device.json
和 userdata.json
文件的示例,请参阅准备首次测试微控制器主板。
创建新的配置
-
在适用于 FreeRTOS UI 的 IDT 中,打开导航菜单,然后选择创建新配置。
-
按照配置向导输入用于运行资格认证测试的 IDT 配置设置。该向导在
目录中的 JSON 配置文件中配置以下设置。devicetester-extract-location
/config-
设备设置 – 要测试的设备的设备池设置。这些设置在
id
和sku
字段中配置,设备池的设备数据块位于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.json
和device.json
文件中进行配置。 -
空中下载 (OTA) 更新 - 控制 OTA 功能测试的设置。这些设置在
device.json
和userdata.json
文件的features
数据块中配置。
-
-
在审核页面上,验证您的配置信息。
审核配置完成后,要运行资格认证测试,请选择运行测试。
修改现有配置
如果您已经为适用于 FreeRTOS 的 IDT 设置了配置文件,则可以使用适用于 FreeRTOS UI 的 IDT 修改现有配置。现有的配置文件必须位于
目录中。devicetester-extract-location
/config
修改配置
-
在适用于 FreeRTOS UI 的 IDT 中,打开导航菜单,然后选择编辑现有配置。
配置控制面板会显示有关现有配置设置的信息。如果配置不正确或不可用,则配置的状态为
Error validating configuration
。 -
要修改现有配置设置,请完成以下步骤:
-
选择配置设置的名称以打开其设置页面。
-
修改设置,然后选择保存,以便重新生成相应的配置文件。
-
-
要修改适用于 FreeRTOS 的 IDT 测试运行设置,请在编辑视图中选择 IDT 测试运行设置:
修改配置完成后,请确认所有配置设置均可通过验证。如果每个配置设置的状态为 Valid
,则可以使用此配置运行资格认证测试。
运行资格认证测试
为适用于 FreeRTOS UI 的 IDT 创建配置后,就可以运行资格认证测试了。
运行资格认证测试
-
在导航菜单中,选择运行测试。
-
要开始运行测试,请选择开始测试。默认情况下,会针对您的设备配置运行所有适用的测试。适用于 FreeRTOS 的 IDT 会在所有测试完成后生成一份资格认证报告。
适用于 FreeRTOS 的 IDT 运行资格认证测试。然后,它会在测试运行器控制台中显示测试运行摘要和所有错误。测试运行完成后,您可以从以下位置查看测试结果和日志:
-
测试结果位于
目录中。devicetester-extract-location
/results/execution-id
-
测试日志位于
目录中。devicetester-extract-location
/results/execution-id
/logs
有关测试结果和日志的更多信息,请参阅了解结果和日志。