本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
开始使用 IDT-FreeRTOS 用户界面
本节向您展示如何使用 IDT-FreeRTOS 用户界面创建或修改配置,然后向您展示如何运行测试。
配置Amazon证书
您必须为在中创建的Amazon用户配置 IAM 用户证书创建和配置 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>
如果您不使用default
Amazon配置文件,请务必在 IDT-FreerTOS 用户界面中指定配置文件名称。有关配置文件的更多信息,请参阅命名配置文件。
环境变量是由操作系统维护且由系统命令使用的变量。如果您关闭 SSH 会话,则不会保存它们。IDT-FreeRTOS 用户界面使用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>
打开 IDT-FreerTOS 用户界面
打开 IDT-FreerTOS 用户界面
-
下载支持的 IDT-FreeRTOS 版本,并将下载的存档解压到文件系统上您具有读写权限的位置。
-
运行以下命令以导航到 IDT-FreeRTOS 安装目录:
cd
devicetester-extract-location
/bin -
运行以下命令以打开 IDT-FreeRTOS 用户界面:
IDT-FreeRTOS 用户界面将在您的默认浏览器中打开。有关支持的浏览器的信息,请参阅使用支持的 Web 浏览器。
创建新配置
如果您是初次使用的用户,则必须创建新配置来设置 IDT-FreeRTOS 运行测试所需的 JSON 配置文件。然后,您可以运行测试或修改已创建的配置。
有关config.json
、device.json
和userdata.json
文件的示例,请参见准备首次测试微控制器主板。有关仅用于运行低功耗蓝牙 (BLE) 测试resource.json
的文件示例,请参阅运行低功耗蓝牙功能测试。
创建新配置
-
在 IDT-FreeRTOS 用户界面中,打开导航菜单,然后选择 “创建新配置”。
重要 在打开 UI 之前,必须配置您的Amazon证书。如果您尚未配置证书,请关闭 IDT-FreerTOS 用户界面浏览器窗口,按照中的配置Amazon证书步骤操作,然后重新打开 IDT-FreerTOS 用户界面。
-
按照配置向导输入用于运行资格测试的 IDT 配置设置。该向导在位于
目录中的 JSON 配置文件中配置以下设置。devicetester-extract-location
/config-
Amazon设置 — IDT-FreerTOS 在测试运行期间用于创建Amazon资源Amazon Web Services 账户的信息。这些设置是在
config.json
文件中配置的。 -
FreeRTOS 存储库 — FreeRTOS 存储库和移植代码的绝对路径,以及您想要执行的资格认证类型。这些设置是在
userdata.json
文件中配置的。必须先为设备移植 FreeRTOS,然后才能运行资格测试。有关更多信息,请参阅 FreeRTOS 移植指南
-
B@@ uild an d flash — 硬件的编译和 flash 命令,允许 IDT 在你的主板上自动构建和闪存测试。这些设置是在
userdata.json
文件中配置的。 -
设备 —待测试设备的设备池设置。这些设置是在
id
和sku
字段中配置的,设备池的devices
块是在device.json
文件中配置的。 -
网络 —用于测试设备的网络通信支持的设置。这些设置是在文件
features
块中配置的,在device.json
文件的clientWifiConfig
和testWifiConfig
块中userdata.json
配置的。 -
Echo 服务器 — 用于安全套接字测试的 echo 服务器配置设置。这些设置是在
userdata.json
文件中配置的。有关回显服务器配置的更多信息,请参阅https://docs.amazonaws.cn/freertos/latest/portingguide/afr-echo-server.html。
-
CMake —(可选)运行 CMake 编译功能测试的设置。仅当您使用 CMake 作为构建系统时,才需要此配置。这些设置是在
userdata.json
文件中配置的。 -
BLE —运行低功耗蓝牙功能测试的设置。这些设置是在文件
features
块和device.json
文件中配置的resource.json
。 -
OTA —运行 OTA 功能测试的设置。这些设置是在文件
features
块和device.json
文件中配置的userdata.json
。
-
-
在 “查看” 页面上,验证您的配置信息。
检查完配置后,要运行资格测试,请选择 “运行测试”。
修改现有配置
如果您已经为 IDT 设置了配置文件,则可以使用 IDT-FreerTOS 用户界面修改现有配置。确保您的现有配置文件在
目录中可用。devicetester-extract-location
/config
修改新配置
-
在 IDT-FreeRTOS 用户界面中,打开导航菜单,然后选择 “编辑现有配置”。
配置仪表板显示有关您的现有配置设置的信息。如果配置不正确或不可用,则该配置的状态为
Error validating configuration
。 -
要修改现有配置设置,请完成以下步骤:
-
选择配置设置的名称以打开其设置页面。
-
修改设置,然后选择 Save 重新生成相应的配置文件。
-
修改完配置后,请验证所有配置设置是否通过验证。如果每个配置设置的状态为Valid
,则可以使用此配置运行资格测试。
运行资格测试
为 IDT-FreeRTOS 创建配置后,即可运行资格测试。
运行资格测试
-
验证您的配置。
-
在导航菜单中,选择运行测试。
-
要开始测试运行,请选择 “开始测试”。
IDT-FreeRTOS 运行资格测试,并在测试运行器控制台中显示测试运行摘要和任何错误。测试运行完成后,您可以从以下位置查看测试结果和日志:
-
测试结果位于
目录下。devicetester-extract-location
/results/execution-id
-
测试日志位于
目录下。devicetester-extract-location
/results/execution-id
/logs
有关测试结果和日志的更多信息,请参阅了解结果和日志。