翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# FreeRTOS 認定スイートの実行
AWS IoT Device Tester for FreeRTOS 実行可能ファイルを使用して IDT for FreeRTOS とやり取りします。以下のコマンドラインの例では、デバイスプール (同一デバイスの集合) に対して適格性確認テストを実行する方法を示します。
------
#### [ 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 上で IDT for FreeRTOS を実行する場合、スラッシュ (/) を使用して `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
```
1 つのデバイスプールに対して 1 つのスイートを実行する場合 (`device.json` ファイルで定義したデバイスプールが 1 つしかない場合)、`suite-id` パラメータと `pool-id` パラメータは省略可能です。
テストグループの特定のテストケースを実行するには、次のコマンドを使用します。
```
devicetester_[linux | mac | win_x86-64] run-suite \
--group-id group-id \
--test-id test-id
```
`list-test-cases` コマンドを使用して、テストグループのテストケースを一覧表示できます。IDT for FreeRTOS のコマンドラインオプション
**group-id**
(オプション) 実行するテストグループ (カンマ区切りリストとして)。指定しない場合、IDT はテストスイートのすべてのテストグループを実行します。
**pool-id**
(オプション) テストするデバイスプール。これは、`device.json` で複数のデバイスプールを定義する場合に必要です。デバイスプールが 1 つしかない場合は、このオプションを省略できます。
**suite-id**
(オプション) 実行するテストスイートのバージョン。指定しない場合、IDT はシステムの tests ディレクトリにある最新バージョンを使用します。
IDT v3.0.0 以降、IDT は新しいテストスイートをオンラインでチェックします。詳細については、[テストスイートのバージョン](idt-test-suite-versions.md) を参照してください。
**test-id**
(オプション) 実行するテスト (カンマ区切りリストとして)。指定した場合、`group-id` は 1 つのグループを指定する必要があります。
**Example**
```
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 がマネージドポリシーが最新でないことを検出すると、マネージドポリシーの更新を求められます。このパラメータが `Y` に設定されている場合、IDT はマネージドポリシーが最新でないことを検出すると、テストの実行を停止します。このパラメータが `N` に設定されている場合、IDT はテストの実行を継続します。
**upgrade-test-suite**
(オプション) これを使用なくても、新しいテストスイートのバージョンが使用可能な場合は、ダウンロードするよう求められます。プロンプトを非表示にするには、`n` を指定して常に最新のテストスイートをダウンロードするか、`y` を指定して指定したテストスイートまたはシステム上の最新バージョンを使用します 。
**Example**
**例**
常に最新のテストスイートをダウンロードして使用するには、次のコマンドを使用します。
```
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` オプションの詳細を確認するには、ヘルプオプションを使用します。
**Example**
**例**
```
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 上で IDT for FreeRTOS を実行する場合、スラッシュ (/) を使用して `userdata.json` ファイルへのパスを指定します。
特定のテストグループを実行するには、次のコマンドを使用します。
```
devicetester_[linux | mac | win] run-suite \
--suite-id FRQ_1 --group-id group-id \
--pool-id pool-id \
--userdata userdata.json
```
1 つのデバイスプールに対して 1 つのスイートを実行する場合 (`device.json` ファイルで定義したデバイスプールが 1 つしかない場合)、`suite-id` と `pool-id` は省略可能です。IDT for FreeRTOS のコマンドラインオプション
**group-id**
(オプション) テストグループを指定します。
**pool-id**
テストするデバイスプールを指定します。デバイスプールが 1 つしかない場合は、このオプションを省略できます。
**suite-id**
(オプション) 実行するテストスイートを指定します。
------
## IDT for FreeRTOS コマンド
IDT for FreeRTOS のコマンドは次のオペレーションをサポートしています。
------
#### [ 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` を使用します。
**Example**
```
devicetester_[linux | mac | win_x86-64] run-suite --group-id mqtt --test-id mqtt_test
```
オプションの完全な一覧については、「[FreeRTOS 認定スイートの実行](#run-tests)」を参照してください。
IDT v3.0.0 以降、IDT は新しいテストスイートをオンラインでチェックします。詳細については、[テストスイートのバージョン](idt-test-suite-versions.md) を参照してください。
------
#### [ IDT v1.7.0 and earlier ]
**`help`**
指定されたコマンドに関する情報を一覧表示します。
**`list-groups`**
特定のスイート内のグループを一覧表示します。
**`list-suites`**
使用可能なスイートを一覧表示します。
**`run-suite`**
デバイスプールに対してテストスイートを実行します。
------
## 再資格のテスト
IDT for FreeRTOS 認定テストの新しいバージョンがリリースされた場合や、ボード固有のパッケージまたはデバイスドライバーを更新した場合は、IDT for FreeRTOS を使用してマイクロコントローラーボードをテストできます。その後の認定テストでは、最新バージョンの FreeRTOS と IDT for FreeRTOS を使用してテストを再実行してください。