翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Windows Simulator で Microchip ATECC608A セキュアエレメントの使用の開始方法
**重要**
このリファレンス統合は、非推奨の Amazon-FreeRTOS リポジトリでホストされています。新しいプロジェクトを作成するときは、[ここから始める](freertos-getting-started-modular.md)ことをお勧めします。現在非推奨の Amazon-FreeRTOS リポジトリをベースにした既存の FreeRTOS プロジェクトが既にある場合は、「[Amazon FreeRTOS Github リポジトリ移行ガイド](github-repo-migration.md)」を参照してください。
このチュートリアルでは、Windows Simulator で Microchip ATECC608A セキュアエレメントの使用を開始するための手順について説明します。
以下のハードウェアが必要です。
+ [Microchip ATECC608A セキュアエレメントクリックボード](https://www.mikroe.com/secure-4-click)
+ [SAMD21 XPlained Pro](https://www.microchipdirect.com/product/ATSAMD21-XPRO?dfw_tracker=64197-ATSAMD21-XPRO&gclid=EAIaIQobChMIn5jIuM3C5QIVk_5kCh1m1Ag4EAQYASABEgLKtfD_BwE)
+ [mikroBUS Xplained Pro アダプター](https://www.microchip.com/Developmenttools/ProductDetails/ATMBUSADAPTER-XPRO)
開始する前に、 AWS IoT と FreeRTOS ダウンロードを設定して、デバイスを AWS クラウドに接続する必要があります。手順については「[最初のステップ](freertos-prereqs.md)」を参照してください。このチュートリアルでは、FreeRTOS ダウンロードディレクトリへのパスを {{freertos}} とします。
## 概要
このチュートリアルでは、以下の手順が含まれています。
1. ボードをホストマシンに接続します。
1. マイクロコントローラーボード用の組み込みアプリケーションを開発およびデバッグするためのソフトウェアをホストマシンにインストールします。
1. FreeRTOS デモアプリケーションをバイナリイメージにクロスコンパイルします。
1. アプリケーションバイナリイメージをボードにロードし、アプリケーションを実行します。
## Microchip ATECC608A ハードウェアのセットアップ
Microchip ATECC608A デバイスを操作する前に、まず SAMD21 をプログラムする必要があります。
**SAMD21 XPlained Pro ボードのセットアップ**
1. [CryptoAuthSSH-XSTK (DM320109) - Latest Firmware](http://ww1.microchip.com/downloads/en/DeviceDoc/ATCRYPTOAUTHSSH-XSTK_v1.0.1.zip) リンクをたどって、手順書 (PDF)、および D21 にプログラムできるバイナリを含む .zip ファイルをダウンロードします。
1. [Atmel Studio 7](https://microchipdeveloper.com/atstudio:studio7intro) IDP をダウンロードしてインストールします。インストール時に必ず **SMART ARM MCU** ドライバアーキテクチャを選択するようにしてください。
1. USB 2.0 Micro B ケーブルを使用して「Debug USB」コネクタをコンピュータに接続し、PDF の指示に従います。(「Debug USB」コネクタは、POWER LED とピンに最も近い USB ポートです)。
**ハードウェアを接続する**
1. 「Debug USB」コネクタからマイクロ USB ケーブルを取り外します。
1. mikroBUS XPlained Pro アダプターを EXT1 位置の SAMD21 ボードに差し込みます。
1. ATECC608A セキュア 4 クリックボードを mikroBUSX XPlained Pro アダプターに差し込みます。クリックボードのノッチ付きコーナーがアダプタボードのノッチ付きアイコンと一致していることを確認します。
1. マイクロ USB ケーブルをターゲット USB に差し込みます。
セットアップは以下のようになります。
## 開発環境をセットアップする
### にサインアップする AWS アカウント
の使用を開始するには AWS、 が必要です AWS アカウント。の作成の詳細については AWS アカウント、 *AWS アカウント管理 リファレンスガイド*[の「 の開始方法 AWS アカウント](https://docs.aws.amazon.com//accounts/latest/reference/getting-started.html)」を参照してください。
アクセスを提供するには、ユーザー、グループ、またはロールにアクセス許可を追加します。
+ のユーザーとグループ AWS IAM アイデンティティセンター:
アクセス許可セットを作成します。「*AWS IAM アイデンティティセンター ユーザーガイド*」の「[アクセス許可セットを作成する](https://docs.aws.amazon.com//singlesignon/latest/userguide/howtocreatepermissionset.html)」の手順に従ってください。
+ IAM 内で、ID プロバイダーによって管理されているユーザー:
ID フェデレーションのロールを作成します。詳細については *IAM ユーザーガイド* の [サードパーティー ID プロバイダー (フェデレーション) 用のロールを作成する](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-idp.html) を参照してください。
+ IAM ユーザー:
+ ユーザーが担当できるロールを作成します。手順については *IAM ユーザーガイド* の [IAM ユーザーのロールの作成](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) を参照してください。
+ (お奨めできない方法) ポリシーをユーザーに直接アタッチするか、ユーザーをユーザーグループに追加します。*IAM ユーザーガイド* の [ユーザー (コンソール) へのアクセス許可の追加](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console) の指示に従います。
**設定**
1. [FreeRTOS GitHub リポジトリ](https://github.com/aws/amazon-freertos)から FreeRTOS レポをダウンロードします。
GitHub から FreeRTOS をダウンロードするには
1. [FreeRTOS GitHub リポジトリ](https://github.com/aws/amazon-freertos)を参照します。
1. **[Clone or download]** (クローンまたはダウンロード) を選択します。
1. コンピュータのコマンドラインから、リポジトリをホストマシンのディレクトリに複製します。
```
git clone https://github.com/aws/amazon-freertos.git -\-recurse-submodules
```
**重要**
このトピックでは、FreeRTOS ダウンロードディレクトリへのパスを `{{freertos}}` とします。
`{{freertos}}` パスにスペース文字が含まれていると、構築が失敗する可能性があります。リポジトリをクローンまたはコピーするときは、作成するパスにスペース文字が含まれていないことを確認してください。
Microsoft Windows でのファイルパスの最大長は 260 文字です。FreeRTOS のダウンロードディレクトリパスが長くなると、構築が失敗する可能性があります。
ソースコードにはシンボリックリンクが含まれている可能性があるため、Windows を使用してアーカイブを抽出する場合は、次の操作を行う必要があります。
[開発者モード](https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development)を有効にするか、または、
管理者としてコンソールを使用します。
この操作を行えば、Windows でアーカイブを抽出する際にシンボリックリンクを適切に作成できます。この操作を行わないと、シンボリックリンクは、そのパスがテキストとして含まれる、または空白の通常ファイルとして書き込まれます。詳細については、ブログの投稿「[Symlinks in Windows 10\!](https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/)」を参照してください。
Windows で Git を使用する場合は、開発者モードを有効にするか、以下を実行する必要があります。
次のコマンドを使用して、`core.symlinks` を true に設定します。
```
git config -\-global core.symlinks true
```
システムへの書き込みを行う git コマンド (**git pull**、**git clone**、**git submodule update -\\-init -\\-recursive** など) を使用する場合は、管理者としてコンソールを使用します。
1. `{{freertos}}` ディレクトリから、使用するブランチをチェックアウトします。
1. 開発環境をセットアップします。
1. [WinPCap](https://www.winpcap.org) の最新バージョンをインストールします。
1. Microsoft Visual Studio をインストールします。
Visual Studio バージョン 2017 および 2019 は動作することが確認されています。Visual Studio のすべてのエディションがサポートされます (Community、Professional、または Enterprise)。
IDE に加えて、[Desktop development with C\+\+] (C\+\+ によるデスクトップ開発) コンポーネントをインストールします。次に、[**オプション**] で、最新の Windows 10 SDK をインストールします。
1. アクティブな有線イーサネット接続が存在することを確認してください。
## FreeRTOS デモプロジェクトを構築して実行する
**重要**
Microchip ATECC608A デバイスには、プロジェクトが初めて実行されるとき (`C_InitToken` 呼び出し時) にデバイスにロックされる 1 回だけの初期化があります。ただし、FreeRTOS デモプロジェクトおよびテストプロジェクトには別の設定があります。デモプロジェクト構成中にデバイスがロックされた場合、テストプロジェクトのすべてのテストを成功することはできません。
**Visual Studio IDE で FreeRTOS デモプロジェクトを構築して実行するには**
1. Visual Studio にプロジェクトをロードします。
**[File]** (ファイル) メニューで、**[Open]** (開く) を選択します。**[File/Solution]** (ファイル/ソリューション) を選択し、`{{freertos}}\projects\microchip\ecc608a_plus_winsim\visual_studio\aws_demos\aws_demos.sln` に移動してから **[Open]** (開く) を選択します。
1. デモプロジェクトをリターゲットします。
指定されたデモプロジェクトは、Windows SDK によって異なりますが、Windows SDK バージョンは指定されていません。デフォルトでは、IDE でマシンに存在しない SDK バージョンを使用してデモのビルドが試行されることがあります。Windows SDK バージョンを設定するには、**[aws\_demos]** を右クリックし、**[Retarget Projects]** (プロジェクトをリターゲット) を選択します。これにより、**[Review Solution Actions]** (ソリューションのアクションを確認) ウィンドウが開きます。マシンに存在する Windows SDK バージョン (ドロップダウンの初期値でかまいません) を選択して、**[OK]** を選択します。
1. プロジェクトを構築して実行します。
**[Build]** (構築) メニューから **[Build Solution]** (ソリューションの構築) を選択し、ソリューションがエラーなしで構築されることを確認します。**[Debug] (デバッグ)、[Start Debugging] (デバッグを開始)** を選択し、プロジェクトを実行します。最初の実行では、デバイスインターフェイスを設定して再コンパイルする必要があります。詳細については、「[ネットワークインターフェイスを設定する](getting_started_windows.md#win-network-interface)」を参照してください。
1. Microchip ATECC608A をプロビジョニングします。
Microchip から、ATECC608A 部品のセットアップに役立ついくつかのスクリプトツールが提供されています。`{{freertos}}\vendors\microchip\secure_elements\app\example_trust_chain_tool` に移動し、README.md ファイルを開きます。
`README.md` ファイルの手順に従って、デバイスをプロビジョニングします。このステップには、以下が含まれます。
1. 認証機関を作成して登録します AWS。
1. Microchip ATECC608A でキーを生成し、公開鍵とデバイスのシリアル番号をエクスポートする。
1. デバイスの証明書を生成し、その証明書を に登録します AWS。
1. CA 認定とデバイス証明書をデバイスにロードする。
1. FreeRTOS サンプルを構築して実行します。
デモプロジェクトを再実行します。これで、接続に成功します。
## トラブルシューティング
一般的なトラブルシューティング情報については、「[トラブルシューティングの開始方法](gsg-troubleshooting.md)」を参照してください。