开始使用 IDT-FreeRTOS 用户界面 - FreeRTOS
配置Amazon证书打开 IDT-FreerTOS 用户界面创建新配置修改现有配置运行资格测试
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

开始使用 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>
注意

如果您不使用defaultAmazon配置文件，请务必在 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 用户界面

  1. 下载支持的 IDT-FreeRTOS 版本，并将下载的存档解压到文件系统上您具有读写权限的位置。

  2. 运行以下命令以导航到 IDT-FreeRTOS 安装目录：

    cd devicetester-extract-location/bin

  3. 运行以下命令以打开 IDT-FreeRTOS 用户界面：

    Linux
    .devicetestergui_linux_x86-64.exe
    Windows
    ./devicetestergui_win_x64-64
    macOS
    ./devicetestergui_mac_x86-64
    注意

    在 Mac 上，要允许系统运行用户界面，请前往 “系统偏好设置”-> “安全和隐私”。当你运行测试时，你可能需要再做三次。

    IDT-FreeRTOS 用户界面将在您的默认浏览器中打开。有关支持的浏览器的信息，请参阅使用支持的 Web 浏览器。

创建新配置

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

有关config.json、device.json和userdata.json文件的示例，请参见准备首次测试微控制器主板。有关仅用于运行低功耗蓝牙 (BLE) 测试resource.json的文件示例，请参阅运行低功耗蓝牙功能测试。

创建新配置

  1. 在 IDT-FreeRTOS 用户界面中，打开导航菜单，然后选择 “创建新配置”。

    重要

    在打开 UI 之前，必须配置您的Amazon证书。如果您尚未配置证书，请关闭 IDT-FreerTOS 用户界面浏览器窗口，按照中的配置Amazon证书步骤操作，然后重新打开 IDT-FreerTOS 用户界面。

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

    • 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。

  3. 在 “查看” 页面上，验证您的配置信息。

检查完配置后，要运行资格测试，请选择 “运行测试”。

修改现有配置

如果您已经为 IDT 设置了配置文件，则可以使用 IDT-FreerTOS 用户界面修改现有配置。确保您的现有配置文件在devicetester-extract-location/config目录中可用。

修改新配置

  1. 在 IDT-FreeRTOS 用户界面中，打开导航菜单，然后选择 “编辑现有配置”。

    配置仪表板显示有关您的现有配置设置的信息。如果配置不正确或不可用，则该配置的状态为Error validating configuration。

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

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

    2. 修改设置，然后选择 Save 重新生成相应的配置文件。

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

运行资格测试

为 IDT-FreeRTOS 创建配置后，即可运行资格测试。

运行资格测试

  1. 验证您的配置。

  2. 在导航菜单中，选择运行测试。

  3. 要开始测试运行，请选择 “开始测试”。

IDT-FreeRTOS 运行资格测试，并在测试运行器控制台中显示测试运行摘要和任何错误。测试运行完成后，您可以从以下位置查看测试结果和日志：

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

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

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