开始使用 IDT-FreeRTOS 用户界面 - 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_IDAWS_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.jsondevice.jsonuserdata.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文件中配置的。

    • 设备 —待测试设备的设备池设置。这些设置是在idsku字段中配置的,设备池的devices块是在device.json文件中配置的。

    • 网络 —用于测试设备的网络通信支持的设置。这些设置是在文件features块中配置的,在device.json文件的clientWifiConfigtestWifiConfig块中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目录下。

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