运行 FreeRTOS 资格认证套件 - FreeRTOS
适用于 FreeRTOS 命令的 IDT
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

运行 FreeRTOS 资格认证套件

您可以使用适用于 FreeRTOS 的 Amazon 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  \
    --update-idt y|n  \
    --update-managed-policy 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.1  \
    --group-id group-id  \
    --pool-id pool-id  \
    --userdata userdata.json

如果您在单个设备池上（即仅在 device.json 文件中定义了一个设备池）运行单个测试套件，则 suite-id 和 pool-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
update-idt

（可选）如果未设置此参数且有较新的 IDT 版本可用，则系统将提示您更新 IDT。如果将此参数设置为 Y，则 IDT 将在检测到有更新版本可用时停止执行测试。如果将此参数设置为 N，IDT 将继续执行测试。

update-managed-policy

（可选）如果未使用此参数且 IDT 检测到您的托管策略未使用 up-to-date，则系统将提示您更新托管策略。如果将此参数设置为Y，则 IDT 将在检测到您的托管策略未 up-to-date被执行时停止测试执行。如果将此参数设置为 N，IDT 将继续执行测试。

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-id 和 pool-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

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