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 は新しいテストスイートをオンラインでチェックします。詳細については、テストスイートのバージョン を参照してください。

test-id

(オプション) 実行するテスト (カンマ区切りリストとして)。指定した場合、group-id は 1 つのグループを指定する必要があります。

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 を指定して指定したテストスイートまたはシステム上の最新バージョンを使用します 。

例

常に最新のテストスイートをダウンロードして使用するには、次のコマンドを使用します。

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 上で 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 を使用します。

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

デバイスプールに対してテストスイートを実行します。

再資格のテスト

IDT for FreeRTOS 認定テストの新しいバージョンがリリースされた場合や、ボード固有のパッケージまたはデバイスドライバーを更新した場合は、IDT for FreeRTOS を使用してマイクロコントローラーボードをテストできます。その後の認定テストでは、最新バージョンの FreeRTOS と IDT for FreeRTOS を使用してテストを再実行してください。