翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# IDT for FreeRTOS 認定スイート 2.0 (FRQ 2.0) の UI
AWS IoT Device Tester for FreeRTOS (IDT for FreeRTOS) には、IDT コマンドラインアプリケーションと関連する設定ファイルを操作できるウェブベースのユーザーインターフェイス (UI) が含まれています。IDT for FreeRTOS UI を使用して、デバイスの新しい設定を作成したり、既存の設定を変更したりします。この UI を使用して、IDT アプリケーションを呼び出し、デバイスに対して FreeRTOS テストを実行することもできます。
コマンドラインを使用して認定テストを実行する方法については、「[マイクロコントローラーボードの最初のテスト](lts-qual-steps.md)」を参照してください。
このセクションでは、IDT for FreeRTOS UI の前提条件と、UI から認定テストを実行する方法について説明します。
**Topics**
+ [IDT 前提条件の設定](#lts-dev-tester-ui-prereqs)
+ [IDT UI を使用するように AWS 認証情報を設定する](lts-configure-aws-credentials.md)
+ [IDT for FreeRTOS UI を開く](lts-open-idt-ui.md)
+ [新しい設定を作成する](lts-create-new-configuration.md)
+ [既存の設定を変更する](lts-modify-existing-configuration.md)
+ [認定テストを実行する](lts-run-tests-from-ui.md)
## IDT 前提条件の設定
FreeRTOS UI の AWS IoT Device Tester (IDT) を使用してテストを実行するには、IDT FreeRTOS 認定 (FRQ) 2.x の[LTS 認定の前提条件を設定する](lts-idt-dev-tester-prereqs.md)ページの前提条件を満たす必要があります。
# IDT UI を使用するように AWS 認証情報を設定する
で作成したユーザーの IAM AWS ユーザー認証情報を設定する必要があります[AWS アカウントを作成する](lts-idt-dev-tester-prereqs.md#lts-config-aws-account)。以下のいずれかの方法で認証情報を指定できます。
+ 認証情報ファイルを使用する
+ 環境変数を使用する
## AWS 認証情報ファイルを使用して認証情報を設定する
IDT では、 AWS CLIと同じ認証情報ファイルが使用されます。詳細については、「[設定ファイルと認証情報ファイル](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html)」を参照してください。
認証情報ファイルの場所は、使用しているオペレーティングシステムによって異なります。
+ **macOS および Linux** – `~/.aws/credentials`
+ **Windows** – `C:\Users\UserName\.aws\credentials`
次の形式で AWS 認証情報を `credentials` ファイルに追加します。
```
[default]
aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key
```
**注記**
`default` AWS プロファイルを使用しない場合は、IDT for FreeRTOS UI でプロファイル名を指定する必要があります。プロファイルの詳細については、「[設定ファイルと認証情報ファイルの設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)」を参照してください。
## 環境変数を使用して AWS 認証情報を設定する
環境変数は、オペレーティングシステムによって維持され、システムコマンドによって使用される変数です。SSH セッションを閉じると、これらは保存されません。IDT for FreeRTOS UI は、 `AWS_ACCESS_KEY_ID`および `AWS_SECRET_ACCESS_KEY`環境変数を使用して AWS 認証情報を保存します。
これらの変数を Linux、macOS、または Unix で設定するには、**export** を使用します。
```
export AWS_ACCESS_KEY_ID=your_access_key_id
export AWS_SECRET_ACCESS_KEY=your_secret_access_key
```
Windows でこれらの変数を設定するには、**set** を使用します。
```
set AWS_ACCESS_KEY_ID=your_access_key_id
set AWS_SECRET_ACCESS_KEY=your_secret_access_key
```
# IDT for FreeRTOS UI を開く
このトピックでは、IDT for FreeRTOS UI を開いて FreeRTOS 認定スイートを使用する方法について説明します。
**IDT for FreeRTOS UI を開く方法**
1. サポートされるバージョンの IDT for FreeRTOS をダウンロードします。次に、ダウンロードしたアーカイブを、読み取りおよび書き込みアクセス許可を持っているディレクトリに抽出します。
1. IDT for FreeRTOS のインストールディレクトリに移動します。
```
cd devicetester-extract-location/bin
```
1. 次のコマンドを実行して IDT for FreeRTOS UI を開きます。
------
#### [ Linux ]
```
.devicetester_ui_linux_x86-64
```
------
#### [ Windows ]
```
./devicetester_ui_win_x64-64
```
------
#### [ macOS ]
```
./devicetester_ui_mac_x86-64
```
**注記**
macOS でシステムが UI を実行できるようにするには、**[システム環境設定] -> [セキュリティとプライバシー]** に移動します。テストを実行するときは、これをさらに 3 回行う必要がある場合があります。
------
IDT for FreeRTOS UI がデフォルトのブラウザで開きます。以下のブラウザの最新の 3 つのメジャーバージョンは UI をサポートしています。
+ Google Chrome
+ Mozilla Firefox
+ Microsoft Edge
+ MacOS 版 Apple Safari
**注記**
エクスペリエンスの向上のために、Google Chrome または Mozilla Firefox で IDT for FreeRTOS UI にアクセスすることをお勧めします。Microsoft Internet Explorer は UI ではサポートされていません。
**重要**
UI を開く前に、 AWS 認証情報を設定する必要があります。認証情報を設定していない場合は、IDT for FreeRTOS UI ブラウザウィンドウを閉じて、「[IDT UI を使用するように AWS 認証情報を設定する](lts-configure-aws-credentials.md)」の手順に従います。その後に IDT for FreeRTOS UI を再度開きます。
# 新しい設定を作成する
初めて使用する場合、IDT for FreeRTOS がテストを実行するのに必要な JSON 設定ファイルをセットアップするための新しい設定を作成する必要があります。これにより、テストを実行したり、作成した設定を変更できます。
`config.json`、`device.json`、および `userdata.json` ファイルの例については、[マイクロコントローラーボードの最初のテスト](lts-qual-steps.md)を参照してください。
**新しい設定を作成するには**
1. IDT for FreeRTOS UI でナビゲーションメニューを開いて、**[新しい設定を作成]** を選択します。
![\[Device Tester for FreeRTOS には「Create new configuration」ボタンと、マイクロコントローラーの自動セルフテストに関する情報が含まれています。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/gsg-create-configuration.png)
1. 設定ウィザードに従って、認定テストの実行に使用される IDT 構成設定を入力します。このウィザードで `devicetester-extract-location/config` ディレクトリにある JSON 設定ファイル内の次の設定を行います。
+ **[デバイス設定]**: テスト対象のデバイス用のデバイスプール設定。これらの設定は、`config.json` ファイルのデバイスプールに関する `id` および `sku` フィールドと **[デバイス]** ブロックで行われます。
![\[Device Tester for FreeRTOS 設定画面では、デバイスプールを設定するための識別子フィールドと SKU フィールド、接続方法などのデバイス設定オプション、キープロビジョニング、PKCS #11 設定、デバイスの詳細入力フィールド、デバイスまたは識別子を追加するコントロールがあります。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/gsg-device-settings.png)
+ **AWS アカウント設定** – IDT for FreeRTOS AWS アカウント がテスト実行中に AWS リソースを作成するために使用する情報。これらの設定は `config.json` ファイルで行われます。
![\[AWS アカウント アカウントリージョン、ファイルまたは環境としての認証情報の場所、プロファイル名のフィールドを含む設定ページ\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/gsg-account-settings.png)
+ **[FreeRTOS 実装]**: FreeRTOS リポジトリと移植されたコードへの絶対パス、および IDT FRQ を実行したい FreeRTOS バージョン。`FreeRTOS-Libraries-Integration-Tests` GitHub リポジトリからの実行およびパラメータ設定ヘッダーファイルへのパス。IDT がボード上でテストを自動的にビルドおよびフラッシュできるようにする、ハードウェア用のビルドコマンドとフラッシュコマンド。これらの設定は `userdata.json` ファイルで行われます。
![\[FreeRTOS 実装設定セクションには、リポジトリパス、テスト実行パス、FreeRTOS バージョン、ビルドツールの詳細、フラッシュツールの設定があります。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/gsg-implementation-settings.png)
+ **[PKCS \$111 ラベルと Echo サーバー]**: キー機能とキープロビジョニング方法に基づいてハードウェアにプロビジョニングされたキーに対応する [PKCS \$111](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-porting-pkcs.html) ラベル。トランスポートインターフェイステスト用のエコーサーバー構成設定。これらの設定は `userdata.json` および `device.json` ファイルで行われます。
![\[PKCS #11 ラベルと Echo サーバー設定には、キーラベル、キー生成方法、サーバーポート番号の入力フィールドが含まれています。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/gsg-pkcs11-settings.png)
+ **[OTA (Over-The-Air) 更新]** — OTA 機能テストを制御する設定。これらの設定は、`device.json` および `userdata.json` ファイルの `features` ブロックで行われます。
![\[OTA 更新設定オプション: テストのスキップ、データプロトコル、ファームウェアパス、PAL 証明書パス、コード署名、ハッシュ/署名アルゴリズム、信頼済み/信頼されていない署名者の証明書、署名者の証明書ファイル、コンパイルの署名者の証明書、署名者のプラットフォーム。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/gsg-ota-settings.png)
1. **[Review]** (確認) ページで、設定情報を確認します。
![\[Device Tester for FreeRTOS 向けに作成された設定ダイアログで、新しいテスト設定の作成に関する詳細と、テストを編集または実行するオプションが表示されます。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/gsg-configuration-created.png)
設定の確認が完了したら、**[Run tests]** (テストの実行) を選択して、認定テストを実行します。
# 既存の設定を変更する
IDT for FreeRTOS の設定ファイルを既にセットアップしている場合は、IDT for FreeRTOS UI を使用して既存の設定を変更できます。既存の設定ファイルは `devicetester-extract-location/config` ディレクトリにある必要があります。
**設定を変更するには**
1. IDT for FreeRTOS UI でナビゲーションメニューを開いて、**[既存の設定の編集]** を選択します。
設定ダッシュボードには、既存の構成設定に関する情報が表示されます。設定が正しくない、または使用できない場合、設定のステータスは `Error validating configuration` です。
![\[デバイス、 AWS アカウント FreeRTOS 実装、PKCS ラベルとエコーサーバー、over-the-airの更新、有効なステータスを示すテスト実行設定セクションを含む設定画面。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/modify-existing-configuration.png)
1. 既存の設定を変更するには、以下のステップを実行します。
1. 構成設定の名前を選択して、設定ページを開きます。
1. 設定を変更し、**[Save]** (保存) を選択して、対応する設定ファイルを再生成します。
1. IDT for FreeRTOS のテスト実行設定を変更するには、編集ビューで **[IDT テスト実行設定]** を選択します。
![\[IDT テスト実行設定ダイアログには、テスト選択、テストグループのスキップ、タイムアウト乗数、初回失敗時の停止のオプションがあります。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/idt-testrun-settings.png)
設定の変更が完了したら、すべての構成設定が検証に合格することを確認します。各構成設定のステータスが `Valid` の場合、この設定を使用して認定テストを実行できます。
# 認定テストを実行する
IDT for FreeRTOS UI の設定を作成したら、認定テストを実行できます。
**認定テストを実行するには**
1. ナビゲーションメニューで、**[Run tests]** (テストの実行) を選択します。
1. テストの実行を開始するには、**[テストの開始]** を選択します。デフォルトでは、該当するすべてのテストがデバイス構成に合わせて実行されます。IDT for FreeRTOS は、すべてのテストが終了すると認定レポートを生成します。
![\[Device Tester for FreeRTOS インターフェイスには、テストが未実行であることが示されており、新しい設定の作成、既存の設定の編集、テストの実行のオプションがあります。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/idt-run-tests.png)
IDT for FreeRTOS が認定テストを実施します。次に、テスト実行の概要とエラーを **[テストランナー]** コンソールに表示します。テストの実行が完了したら、次の場所でテスト結果とログを確認できます。
+ テスト結果は、`devicetester-extract-location/results/execution-id` ディレクトリにあります。
+ テストのログは `devicetester-extract-location/results/execution-id/logs` ディレクトリにあります。
テスト結果とログの詳細については、「[IDT for FreeRTOSresults を表示する](view-results-lts.md)」および「[IDT for FreeRTOSlogs を表示する](view-logs-lts.md)」を参照してください。
![\[Device Tester for FreeRTOS 実行ログには、合格したテスト、テストグループ、ログとレポートのファイルパスが表示されます。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/idt-results.png)