

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# IDT-FreeRTOS UI を開始する
<a name="dev-tester-ui-getting-started"></a>

このセクションでは、IDT-FreeRTOS UI を使用して設定を作成または変更する方法と、テストの実行方法について説明します。

**Topics**
+ [AWS 認証情報を設定する](#configure-aws-credentials)
+ [IDT-FreeRTOS UI を開く](#open-idt-ui)
+ [新しい設定を作成する](#create-new-configuration)
+ [既存の設定を変更する](#modify-existing-configuration)
+ [認定テストを実行する](#run-tests-from-ui)

## AWS 認証情報を設定する
<a name="configure-aws-credentials"></a>

で作成した AWS ユーザーの認証情報を設定する必要があります[AWS アカウントの作成と設定](dev-tester-ui-prereqs.md#ui-config-aws-account)。以下のいずれかの方法で認証情報を指定できます。
+ 認証情報ファイルを使用する
+ 環境変数を使用する

### AWS 認証情報ファイルを使用して認証情報を設定する
<a name="config-cred-file"></a>

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-FreeRTOS UI でプロファイル名を必ず指定してください。プロファイルの詳細については、「[設定ファイルと認証情報ファイルの設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)」を参照してください。

### 環境変数を使用して AWS 認証情報を設定する
<a name="config-env-vars"></a>

環境変数は、オペレーティングシステムによって維持され、システムコマンドによって使用される変数です。SSH セッションを閉じると、これらは保存されません。IDT-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-FreeRTOS UI を開く
<a name="open-idt-ui"></a>

**IDT-FreeRTOS UI を開くには**

1. サポートされているバージョンの IDT-FreeRTOS をダウンロードし、ダウンロードしたアーカイブを、ファイルシステム上で読み取りおよび書き込みアクセス許可を持っている場所に抽出します。

1. 次のコマンドを実行して IDT-FreeRTOS インストールディレクトリに移動します。

   ```
   cd {{devicetester-extract-location}}/bin 
   ```

1. 次のコマンドを実行して IDT-FreeRTOS UI を開きます。

------
#### [ Linux ]

   ```
   .devicetestergui_linux_x86-64.exe
   ```

------
#### [ Windows ]

   ```
   ./devicetestergui_win_x64-64
   ```

------
#### [ macOS ]

   ```
   ./devicetestergui_mac_x86-64
   ```

**注記**  
Mac では、システムで UI を実行できるようにするには、**[システム環境設定 > セキュリティとプライバシー]** に移動します。テストを実行するときは、これをさらに 3 回実行することが必要になる場合があります。

------

   IDT-FreeRTOS UI がデフォルトのブラウザで開きます。サポートされるブラウザの詳細については、[サポートされているウェブブラウザを使用する](dev-tester-ui-prereqs.md#idt-ui-supported-web-browser)を参照してください。

## 新しい設定を作成する
<a name="create-new-configuration"></a>

初めて使用する場合、IDT-FreeRTOS がテストを実行するのに必要な JSON 設定ファイルをセットアップするための新しい設定を作成する必要があります。これにより、テストを実行したり、作成した設定を変更できます。

`config.json`、`device.json`、および `userdata.json` ファイルの例については、[マイクロコントローラーボードの最初のテスト](qual-steps.md)を参照してください。Bluetooth Low Energy (BLE) テストにのみ使用する `resource.json` ファイルの例については、[Bluetooth Low Energy テストを実行する](afr-bridgekeeper-dt-bt.md)を参照してください。

**新しい設定を作成するには**

1. IDT-FreeRTOS UI でナビゲーションメニューを開いて、**[Create new configuration]** (新しい設定の作成) を選択します。
**重要**  
UI を開く前に、 AWS 認証情報を設定する必要があります。認証情報を設定していない場合は、IDT-FreeRTOS UI ブラウザウィンドウを閉じて、[AWS 認証情報を設定する](#configure-aws-credentials)の手順に従います。その後に IDT-FreeRTOS UI を再度開きます。

1. 設定ウィザードに従って、認定テストの実行に使用される IDT 構成設定を入力します。このウィザードで `{{devicetester-extract-location}}/config` ディレクトリにある JSON 設定ファイル内の次の設定を行います。
   + **AWS 設定** — IDT-FreeRTOS AWS アカウント がテスト実行中に AWS リソースを作成するために使用する情報。これらの設定は `config.json` ファイルで行われます。
   + **[FreeRTOS repository]** (FreeRTOS リポジトリ): FreeRTOS のリポジトリと移植されたコードへの絶対パス、および実行する認定のタイプ。これらの設定は `userdata.json` ファイルで行われます。

     認定テストを実行するには、デバイス用に FreeRTOS を移植する必要があります。詳細については、[FreeRTOS 移植ガイド](https://docs.aws.amazon.com/freertos/latest/portingguide/)を参照してください。
   + **[Build and flash]** (ビルドとフラッシュ): IDT がボード上でテストを自動的にビルドおよびフラッシュできるようにする、ハードウェア用のビルドコマンドとフラッシュコマンド。これらの設定は `userdata.json` ファイルで行われます。
   + **[Devices]** (デバイス): テスト対象のデバイス用のデバイスプール設定。これらの設定は、`device.json` ファイルのデバイスプールに関する `id` および `sku` フィールドと `devices` ブロックで行われます。
   + **[Networking]** (ネットワーク): デバイスのネットワーク通信サポートをテストするための設定。これらの設定は、`device.json` ファイルの `features` ブロックと `userdata.json` ファイルの `clientWifiConfig` および `testWifiConfig` ブロックで行われます。
   + **[Echo server]** (エコーサーバー): セキュアソケットテスト用のエコーサーバー設定。これらの設定は `userdata.json` ファイルで行われます。

     エコーサーバー設定の詳細については、[https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html](https://docs.aws.amazon.com/freertos/latest/portingguide/afr-echo-server.html)を参照してください。
   + **[CMake]**: (オプション) CMake ビルド機能テストを実行するための設定。この設定は、CMake をビルドシステムとして使用する場合にのみ必要です。これらの設定は `userdata.json` ファイルで行われます。
   + **[BLE]**: Bluetooth Low Energy 機能テストを実行するための設定。これらの設定は、`device.json` ファイルの `features` ブロックおよび `resource.json` ファイルで行われます。
   + **[OTA]**: OTA 機能テストを実行するための設定。これらの設定は、`device.json` ファイルの `features` ブロックおよび `userdata.json` ファイルで行われます。

1.  **[Review]** (確認) ページで、設定情報を確認します。

設定の確認が完了したら、**[Run tests]** (テストの実行) を選択して、認定テストを実行します。

## 既存の設定を変更する
<a name="modify-existing-configuration"></a>

IDT の設定ファイルを既にセットアップしている場合は、IDT-FreeRTOS UI を使用して既存の設定を変更できます。既存の設定ファイルが `{{devicetester-extract-location}}/config` ディレクトリにあることを確認します。

**新しい設定を変更するには**

1. IDT-FreeRTOS UI でナビゲーションメニューを開いて、**[Edit existing configuration]** (既存の設定の編集) を選択します。

   設定ダッシュボードには、既存の構成設定に関する情報が表示されます。設定が正しくない、または使用できない場合、設定のステータスは `Error validating configuration` です。

1. 既存の設定を変更するには、以下のステップを実行します。

   1. 構成設定の名前を選択して、設定ページを開きます。

   1. 設定を変更し、**[Save]** (保存) を選択して、対応する設定ファイルを再生成します。

設定の変更が完了したら、すべての構成設定が検証に合格することを確認します。各構成設定のステータスが `Valid` の場合、この設定を使用して認定テストを実行できます。

## 認定テストを実行する
<a name="run-tests-from-ui"></a>

IDT-FreeRTOS の設定を作成したら、認定テストを実行できます。

**認定テストを実行するには**

1. 設定を確認します。

1. ナビゲーションメニューで、**[Run tests]** (テストの実行) を選択します。

1. テストの実行を開始するには、**[Start tests]** (テストの開始) を選択します。

IDT-FreeRTOS は認定テストを実行し、テスト実行の概要とエラーを **Test runner** コンソールに表示します。テストの実行が完了したら、次の場所でテスト結果とログを確認できます。
+ テスト結果は、`{{devicetester-extract-location}}/results/{{execution-id}}` ディレクトリにあります。
+ テストのログは `{{devicetester-extract-location}}/results/{{execution-id}}/logs` ディレクトリにあります。

テスト結果とログの詳細については、「[IDT for FreeRTOS の結果を表示する](view-results-frq.md)」および「[IDT for FreeRTOS ログを表示する](view-logs-frq.md)」を参照してください。