运行 FreeRTOS 资格认证套件 - FreeRTOS
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

运行 FreeRTOS 资格认证套件

您可以使用适用于 FreeRTOS 的 AWS IoT Device Tester 可执行文件与适用于 FreeRTOS 的 IDT 交互。以下命令行示例向您显示如何针对某个设备池(一组相同的设备)运行资格测试。

IDT v3.0.0 and later
devicetester_[linux | mac | win] run-suite \ --suite-id suite-id \ --group-id group-id \ --pool-id your-device-pool \ --test-id test-id \ --upgrade-test-suite y|n \ --userdata userdata.json

对某个设备池运行一组测试。userdata.json 文件必须位于 devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/ 目录中。

注意

如果您在 Windows 上运行适用于 FreeRTOS 的 IDT,请使用正斜杠 (/) 指定 userdata.json 文件的路径。

使用以下命令运行特定测试组:

devicetester_[linux | mac | win] run-suite \ --suite-id FRQ_1.0.0 \ --group-id group-id \ --pool-id pool-id \ --userdata userdata.json

如果您在单个设备池上(即仅在 device.json 文件中定义了一个设备池)运行单个测试套件,则 suite-idpool-id 参数为可选。

使用以下命令运行测试组中的特定测试用例:

devicetester_[linux | mac | win_x86-64] run-suite \ --group-id group-id \ --test-id test-id

您可以使用 list-test-cases 命令列出测试组中的测试用例。

适用于 FreeRTOS 的 IDT 命令行选项

group-id

(可选)要以逗号分隔的列表形式运行的测试组。如果未指定,IDT 将运行测试套件中的所有测试组。

pool-id

(可选)要测试的设备池。如果您在 device.json 中定义多个设备池,则需要执行此操作。如果您只有一个设备池,则可以省略此选项。

suite-id

(可选)要运行的测试套件版本。如果未指定,IDT 将在系统上使用测试目录中的最新版本。

注意

从 IDT v3.0.0 开始,IDT 在线检查较新的测试套件。有关更多信息,请参阅 测试套件版本

test-id

(可选)要以逗号分隔的列表形式运行的测试。如果指定,则 group-id 必须指定单个组。

devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
upgrade-test-suite

(可选)如果未使用,并且较新的测试套件版本可用,系统将提示您下载该版本。要隐藏提示,请指定 y 以始终下载最新的测试套件,或者指定 n 以使用系统上指定的测试套件或最新版本。

要始终下载并使用最新的测试套件,请使用以下命令。

devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite y

要使用系统上的最新测试套件,请使用以下命令。

devicetester_[linux | mac | win_x86-64] run-suite --userdata userdata file --group-id group ID --upgrade-test-suite n
h

使用帮助选项了解有关 run-suite 选项的更多信息。

devicetester_[linux | mac | win_x86-64] run-suite -h
IDT v1.7.0 and earlier
devicetester_[linux | mac | win] run-suite \ --suite-id suite-id \ --pool-id your-device-pool \ --userdata userdata.json

userdata.json 文件应位于 devicetester_extract_location/devicetester_afreertos_[win|mac|linux]/configs/ 目录中。

注意

如果您在 Windows 上运行适用于 FreeRTOS 的 IDT,请使用正斜杠 (/) 指定 userdata.json 文件的路径。

使用以下命令运行特定测试组。

devicetester_[linux | mac | win] run-suite \ --suite-id FRQ_1 --group-id group-id \ --pool-id pool-id \ --userdata userdata.json

如果您在单个设备池上(即仅在 device.json 文件中定义了一个设备池)运行单个测试套件,则 suite-idpool-id 为可选。

适用于 FreeRTOS 的 IDT 命令行选项

group-id

(可选)指定测试组。

pool-id

指定要测试的设备池。如果您只有一个设备池,则可以省略此选项。

suite-id

(可选)指定要运行的测试套件。

适用于 FreeRTOS 的 IDT 命令

适用于 FreeRTOS 的 IDT 命令支持以下操作:

IDT v3.0.0 and later
help

列出有关指定命令的信息。

list-groups

列出给定套件中的组。

list-suites

列出可用套件。

list-supported-products

列出支持的产品和测试套件版本。

list-supported-versions

列出当前 IDT 版本支持的 FreeRTOS 和测试套件版本。

list-test-cases

列出指定组中的测试用例。

run-suite

对某个设备池运行一组测试。

使用 --suite-id 选项可以指定测试套件版本,省略它可以使用系统上的最新版本。

使用 --test-id 运行单个测试用例。

devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test

有关选项的完整列表,请参阅 运行 FreeRTOS 资格认证套件

注意

从 IDT v3.0.0 开始,IDT 在线检查较新的测试套件。有关更多信息,请参阅 测试套件版本

IDT v1.7.0 and earlier
help

列出有关指定命令的信息。

list-groups

列出给定套件中的组。

list-suites

列出可用套件。

run-suite

对某个设备池运行一组测试。