翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Cypress CYW943907AEVAL1F 開発キットの開始方法
**重要**
このリファレンス統合は、非推奨の Amazon-FreeRTOS リポジトリでホストされています。新しいプロジェクトを作成するときは、[ここから始める](freertos-getting-started-modular.md)ことをお勧めします。現在非推奨の Amazon-FreeRTOS リポジトリをベースにした既存の FreeRTOS プロジェクトが既にある場合は、「[Amazon FreeRTOS Github リポジトリ移行ガイド](github-repo-migration.md)」を参照してください。
このチュートリアルでは、Cypress CYW943907AEVAL1F 開発キットの使用を開始するための手順について説明します。Cypress CYW943907AEVAL1F 開発キットがない場合は、 AWS Partner Device Catalog にアクセスして当社のいずれかの[パートナー](https://devices.amazonaws.com/detail/a3G0L00000AAPg0UAH/CYW943907AEVAL1F)から購入してください。
**注記**
このチュートリアルでは、coreMQTT Mutual Authentication デモをセットアップして実行する手順を説明します。このボードの FreeRTOS ポートは現在 TCP サーバーとクライアントのデモをサポートしていません。
開始する前に、 AWS IoT と FreeRTOS ダウンロードを設定して、デバイスを AWS クラウドに接続する必要があります。手順については「[最初のステップ](freertos-prereqs.md)」を参照してください。
**重要**
このトピックでは、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** など) を使用する場合は、管理者としてコンソールを使用します。
[FreeRTOS をダウンロードする](freertos-prereqs.md#freertos-download) で説明したように、Cypress の FreeRTOS 移植は、現在 [GitHub](https://github.com/aws/amazon-freertos) でのみ利用できます。
## 概要
このチュートリアルには、使用開始のための以下の手順が含まれています。
1. マイクロコントローラーボード用の組み込みアプリケーションを開発およびデバッグするためのソフトウェアをホストマシンにインストールします。
1. FreeRTOS デモアプリケーションをバイナリイメージにクロスコンパイルします。
1. アプリケーションバイナリイメージをボードにロードし、アプリケーションを実行します。
1. モニタリングおよびデバッグの目的で、シリアル接続経由でボード上で実行されているアプリケーションに接続します。
## 開発環境のセットアップ
### WICED Studio SDK をダウンロードおよびインストールする
この入門ガイドでは、Cypress WICED Studio SDK を使用して FreeRTOS デモでボードをプログラミングします。[WICED ソフトウェア](https://www.cypress.com/products/wiced-software)ウェブサイトにアクセスし、Cypress から WICED Studio SDK をダウンロードします。このソフトウェアをダウンロードするには、無料の Cypress アカウントに登録する必要があります。WICED Studio SDK は、Windows、macOS、および Linux オペレーティングシステムと互換性があります。
**注記**
オペレーティングシステムによっては、追加のインストール手順が必要になります。インストールする WICED Studio のオペレーティングシステムとバージョンのインストール手順をすべてお読みの上、記載されている手順に従ってください。
### 環境変数を設定する
WICED Studio を使用してボードをプログラムする前に、WICED Studio SDK インストールディレクトリ用の環境変数を作成する必要があります。変数の作成中に WICED Studio が実行されている場合は、変数を設定した後にアプリケーションを再起動する必要があります。
**注記**
WICED Studio インストーラーは、マシン上に `WICED-Studio-{{m}}.{{n}}` という名前が付けられた 2 つの個別のフォルダーを作成します。ここで `m` および `n` は、それぞれメジャーバージョン番号とマイナーバージョン番号です。このドキュメントでは、フォルダー名 `WICED-Studio-6.2` を想定していますが、インストールするバージョンの正しい名前を使用してください。`WICED_STUDIO_SDK_PATH` 環境変数を定義する場合は、WICED Studio IDE のインストールパスではなく、必ず WICED Studio SDK の完全なインストールパスを指定してください。Windows および macOS では、SDK の `WICED-Studio-{{m}}.{{n}}` フォルダーは、デフォルトで `Documents` フォルダーに作成されます。
**Windows で環境変数を作成するには**
1. **[Control Panel]** (コントロールパネル) を開き、**[System]** (システム)、**[Advanced System Settings]** (システムの詳細設定) の順に選択します。
1. **[Advanced]** (詳細設定) タブで、**[Environment Variables]** (環境変数) を選択します。
1. **[User variables]** (ユーザー変数) で 、**[New]** (新規) を選択します。
1. **[Variable name]** (変数名) で、**WICED\_STUDIO\_SDK\_PATH** と入力します。**[Variable value]** (変数値) に、WICED Studio SDK のインストールディレクトリを入力します。
**Linux または macOS で環境変数を作成するには**
1. マシンで `/etc/profile` ファイルを開き、以下の値をファイルの最終行に追加します。
```
export WICED_STUDIO_SDK_PATH={{installation-path}}/WICED-Studio-6.2
```
1. マシンを再起動します。
1. ターミナルを開き、次のコマンドを実行します。
```
cd {{freertos}}/vendors/cypress/WICED_SDK
```
```
perl platform_adjust_make.pl
```
```
chmod +x make
```
## シリアル接続の確立
**ホストマシンとボードの間にシリアル接続を確立するには**
1. USB 標準 A - Micro-B ケーブルを使用して、ボードをホストコンピュータに接続します。
1. ホストコンピュータのボードに接続するための USB シリアルポート番号を確認します。
1. シリアルターミナルを起動し、以下の設定で接続を開きます。
+ ボーレート: 115200
+ データ: 8 ビット
+ パリティ: なし
+ ストップビット: 1
+ フロー制御: なし
ターミナルのインストールとシリアル接続の設定に関する詳細については、「[ターミナルエミュレーターをインストールする](gsg-troubleshooting.md#uart-term)」を参照してください。
## クラウドの MQTT メッセージのモニタリング
FreeRTOS デモプロジェクトを実行する前に、 AWS IoT コンソールで MQTT クライアントを設定して、デバイスが AWS クラウドに送信するメッセージをモニタリングできます。
**MQTT クライアントで AWS IoT MQTT トピックをサブスクライブするには**
1. [AWS IoT コンソール](https://console.aws.amazon.com/iotv2/) にサインインします。
1. ナビゲーションペインで、**[テスト]** を選択し、**[MQTT テストクライアント]** を選択して MQTT クライアントを開きます。
1. **[Subscription topic]** (トピックのサブスクリプション) で **{{your-thing-name}}/example/topic** と入力し、**[Subscribe to topic]** (トピックへのサブスクライブ) を選択します。
## FreeRTOS デモプロジェクトを構築して実行する
ボードにシリアル接続を設定したら、FreeRTOS デモプロジェクトを構築し、ボードにデモをフラッシュしてからデモを実行できます。
**WICED Studio で FreeRTOS デモプロジェクトを構築して実行するには**
1. WICED Studio を起動します。
1. **[File]** (ファイル) メニューから **[Import]** (インポート) を選択します。[`General`] フォルダーを展開し、**[Existing Projects into Workspace]** (既存のプロジェクトを WorkSpace へ) を選択してから、**[Next]** (次へ) を選択します。
1. **[Select root directory]** (ルートディレクトリの選択) で、**[Browse...]** (参照) を選択し、パス `{{freertos}}/projects/cypress/CYW943907AEVAL1F/wicedstudio` に移動して、**[OK]** を選択します。
1. **[Projects]** (プロジェクト) で、**[aws\_demo]** プロジェクトのみのチェックボックスをオンにします。**[Finish]** (完了) を選択してプロジェクトをインポートします。ターゲットプロジェクト **aws\_demo** が **[Make Target]** (ターゲットの作成) ウィンドウに表示されます。
1. **[WICED Platform]** (WICED プラットフォーム) メニューを展開し、**[WICED Filters off]** (WICED フィルターオフ) を選択します。
1. **[ターゲットの作成]** ウィンドウで **[aws\_demo]** を展開して、`demo.aws_demo` ファイルを右クリックし、**[ターゲットを構築]** を選択してデモを構築してからボードにダウンロードします。デモは、構築されボードにダウンロードされた後、自動的に実行されます。
## トラブルシューティング
+ Windows を使用している場合は、デモプロジェクトのビルドおよび実行時に以下のエラーが表示される場合があります。
```
: recipe for target 'download_dct' failed
make.exe[1]: *** [download_dct] Error 1
```
このエラーを解決するには、以下のように行います。
1. `{{WICED-Studio-SDK-PATH}}\WICED-Studio-6.2\43xxx_Wi-Fi\tools\OpenOCD\Win32` を参照して、`openocd-all-brcm-libftdi.exe` をダブルクリックします。
1. `{{WICED-Studio-SDK-PATH}}\WICED-Studio-6.2\43xxx_Wi-Fi\tools\drivers\CYW9WCD1EVAL1` を参照して、`InstallDriver.exe` をダブルクリックします。
+ Linux または macOS を使用している場合は、デモプロジェクトのビルドおよび実行時に以下のエラーが表示される場合があります。
```
make[1]: *** [download_dct] Error 127
```
このエラーをトラブルシューティングするには、以下のコマンドを使用して、libusb-dev パッケージを更新します。
```
sudo apt-get install libusb-dev
```
FreeRTOS の開始方法に関する一般的なトラブルシューティングについては、「[トラブルシューティングの開始方法](gsg-troubleshooting.md)」を参照してください。