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

# 运行 FreeRTOS 资格认证 2.0 套件
<a name="lts-run-tests"></a>

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

------
#### [ IDT v4.5.2 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}}  \
    --userdata {{userdata.json}}
```

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

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

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

```
devicetester_{{[linux | mac | win]}} run-suite  \
    --suite-id FRQ_1.99.0  \
    --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 将在系统上使用测试目录中的最新版本。

**test-id**  
（可选）要以逗号分隔的列表形式运行的测试。如果指定，则 `group-id` 必须指定单个组。  

**Example**  

```
devicetester_{{[linux | mac | win_x86-64]}} run-suite --group-id FreeRTOSVersion --test-id FreeRTOSVersion
```

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

**Example**  
**示例**  

```
devicetester_{{[linux | mac | win_x86-64]}} run-suite -h
```

------

## 适用于 FreeRTOS 命令的 IDT
<a name="lts-dt-cli"></a>

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

------
#### [ IDT v4.5.2 and later ]

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

** `list-groups` **  
列出给定套件中的组。

** `list-suites` **  
列出可用套件。

** `list-supported-products` **  
列出支持的产品和测试套件版本。

** `list-supported-versions` **  
列出当前 IDT 版本支持的 FreeRTOS 和测试套件版本。

** `list-test-cases` **  
列出指定组中的测试用例。

** `run-suite` **  
对某个设备池运行一组测试。  
使用 `--suite-id` 选项可以指定测试套件版本，省略它可以使用系统上的最新版本。  
使用 `--test-id` 运行单个测试用例。  

**Example**  

```
devicetester_{{[linux | mac | win_x86-64]}} run-suite --group-id FreeRTOSVersion --test-id FreeRTOSVersion
```
从 IDT v3.0.0 开始，IDT 在线检查较新的测试套件。有关更多信息，请参阅 [测试套件版本](idt-test-suite-versions.md)。

------