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

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

开始使用 IDT-FreeRTOS 用户界面

本节介绍如何使用 IDT-FreeRTOS UI 创建或修改配置，然后向您展示如何运行测试。

配置Amazon证书

您必须配置 IAM 用户凭证Amazon你在其中创建的用户创建和配置 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 UI 中指定配置文件名。有关配置式的更多信息，请参阅命名配置文件.

环境变量是由操作系统维护且由系统命令使用的变量。如果关闭 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 上，要允许系统运行 UI，请转到系统偏好设置-> 安全和隐私. 当你运行测试时，你可能需要再执行三次此操作。

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

创建新的配置

如果你是第一次使用的用户，那么你必须创建一个新的配置来设置 IDT-freerTOS 运行测试所需的 JSON 配置文件。然后，您可以运行测试或修改创建的配置。

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

创建新的配置

  1. 在 IDT-FreeRTOS UI 中，打开导航菜单，然后选择创建新配置.

    重要

    你必须配置你的Amazon打开 UI 之前的凭据。如果尚未配置凭据，请关闭 IDT-FreeRTOS UI 浏览器窗口，按照中的步骤操作配置Amazon证书，然后重新打开 IDT-FreeRTOS UI。

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

    • Amazon设置—Amazon Web Services 账户IDT-FreeRTOS 用来创建的信息Amazon测试运行期间的资源。这些设置在config.json文件。

    • FreeRTOS 存储库— FreeRTOS 存储库和移植代码的绝对路径，以及要执行的资格类型。这些设置在userdata.json文件。

      在运行资格测试之前，必须为设备移植 FreeRTOS。有关更多信息，请参阅 。FreeRTOS 移植指南

    • 构建并刷写— 适用于的硬件的生成和刷写命令，这些命令允许 IDT 自动生成并刷写主板。这些设置在userdata.json文件。

    • Devices— 要测试的设备的设备池设置。这些设置在id和sku字段以及devices中的设备池的阻止device.json文件。

    • 联网— 测试设备的网络通信支持的设置。这些设置在features块device.json文件，然后在clientWifiConfig和testWifiConfig在数据块userdata.json文件。

    • Echo 服务器— 用于安全套接字测试的 echo 服务器配置设置。这些设置在userdata.json文件。

      有关 echo 服务器配置的更多信息，请参阅https://docs.amazonaws.cn/freertos/latest/portingguide/afr-echo-server.html.

    • CMake—（可选）运行 CMake 构建功能测试的设置。仅当您使用 CMake 作为生成系统时，需要此配置。这些设置在userdata.json文件。

    • BLE— 运行蓝牙低功耗功能测试的设置。这些设置在features块device.json文件和resource.json文件。

    • 太田— 运行 OTA 功能测试的设置。这些设置在features块device.json文件和userdata.json文件。

  3. 在存储库的审核页面中，验证您的配置信息。

查看完配置后，要运行资格测试，请选择运行测试.

修改现有配置

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

修改新配置

  1. 在 IDT-FreeRTOS UI 中，打开导航菜单，然后选择编辑现有配置.

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

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

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

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

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

运行认证测试

创建适用于的 IDT-免费的配置后，您可以运行资格测试。

要进行资格测试

  1. 验证您的配置。

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

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

IDT-freerTOS 运行资格测试，并在测试运行器控制台。在测试运行完成后，您可以从以下位置查看测试结果和日志：

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

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

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