Cypress CYW954907AEVAL1F 開発キットの開始方法

重要

このリファレンス統合は、非推奨の Amazon-FreeRTOS リポジトリでホストされています。新しいプロジェクトを作成するときは、ここから始めることをお勧めします。現在非推奨の Amazon-FreeRTOS リポジトリをベースにした既存の FreeRTOS プロジェクトが既にある場合は、「Amazon FreeRTOS Github リポジトリ移行ガイド」を参照してください。

このチュートリアルでは、Cypress CYW954907AEVAL1F 開発キットの使用を開始するための手順について説明します。Cypress CYW954907AEVAL1F 開発キットがない場合は、AWS Partner Device Catalog にアクセスして当社のいずれかのパートナーから購入してください。

注記

このチュートリアルでは、coreMQTT Mutual Authentication デモをセットアップして実行する手順を説明します。このボードの FreeRTOS 移植は現在 TCP サーバーとクライアントのデモをサポートしていません。

開始する前に、デバイスを AWS クラウドに接続するように、AWS IoT と FreeRTOS ダウンロードを設定する必要があります。手順については、「最初のステップ」を参照してください。このチュートリアルでは、FreeRTOS ダウンロードディレクトリへのパスを freertos とします。

重要

• このトピックでは、FreeRTOS ダウンロードディレクトリへのパスを freertos とします。

• freertos パスにスペース文字が含まれていると、構築が失敗する可能性があります。リポジトリをクローンまたはコピーするときは、作成するパスにスペース文字が含まれていないことを確認してください。

• Microsoft Windows でのファイルパスの最大長は 260 文字です。FreeRTOS のダウンロードディレクトリパスが長くなると、構築が失敗する可能性があります。

• ソースコードにはシンボリックリンクが含まれている可能性があるため、Windows を使用してアーカイブを抽出する場合は、次の操作を行う必要があります。

  • 開発者モードを有効にするか、または、

  • 管理者としてコンソールを使用します。

  この操作を行えば、Windows でアーカイブを抽出する際にシンボリックリンクを適切に作成できます。この操作を行わないと、シンボリックリンクは、そのパスがテキストとして含まれる、または空白の通常ファイルとして書き込まれます。詳細については、ブログの投稿「Symlinks in Windows 10!」を参照してください。

  Windows で Git を使用する場合は、開発者モードを有効にするか、以下を実行する必要があります。

  • 次のコマンドを使用して、core.symlinks を true に設定します。

    git config --global core.symlinks true

  • システムへの書き込みを行う git コマンド (git pull、git clone、git submodule update --init --recursive など) を使用する場合は、管理者としてコンソールを使用します。

• FreeRTOS をダウンロードする で説明したように、Cypress の FreeRTOS 移植は、現在 GitHub でのみ利用できます。

概要

このチュートリアルには、使用開始のための以下の手順が含まれています。

1. マイクロコントローラーボード用の組み込みアプリケーションを開発およびデバッグするためのソフトウェアをホストマシンにインストールします。

2. FreeRTOS デモアプリケーションをバイナリイメージにクロスコンパイルします。

3. アプリケーションバイナリイメージをボードにロードし、アプリケーションを実行します。

4. モニタリングおよびデバッグの目的で、シリアル接続経由でボード上で実行されているアプリケーションに接続します。

開発環境のセットアップ

WICED Studio SDK をダウンロードおよびインストールする

この入門ガイドでは、Cypress WICED Studio SDK を使用して FreeRTOS デモでボードをプログラミングします。WICED ソフトウェアウェブサイトにアクセスし、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] (システムの詳細設定) の順に選択します。

2. [Advanced] (詳細設定) タブで、[Environment Variables] (環境変数) を選択します。

3. [User variables] (ユーザー変数) で 、[New] (新規) を選択します。

4. [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

2. マシンを再起動します。

3. ターミナルを開き、次のコマンドを実行します。

   cd freertos/vendors/cypress/WICED_SDK

   perl platform_adjust_make.pl

   chmod +x make

シリアル接続の確立

ホストマシンとボードの間にシリアル接続を確立するには

1. USB 標準 A - Micro-B ケーブルを使用して、ボードをホストコンピュータに接続します。

2. ホストコンピュータのボードに接続するための USB シリアルポート番号を確認します。

3. シリアルターミナルを起動し、以下の設定で接続を開きます。

   • ボーレート: 115200

   • データ: 8 ビット

   • パリティ: なし

   • ストップビット: 1

   • フロー制御: なし

ターミナルのインストールとシリアル接続の設定に関する詳細については、「ターミナルエミュレーターをインストールする」を参照してください。

クラウドの MQTT メッセージのモニタリング

FreeRTOS デモプロジェクトを実行する前に、デバイスが AWS クラウドに送信するメッセージをモニタリングするために、AWS IoT コンソールで MQTT クライアントをセットアップすることができます。

AWS IoT MQTT クライアントで MQTT トピックをサブスクライブするには

1. AWS IoT コンソールにサインインします。

2. ナビゲーションペインで、[テスト] を選択し、[MQTT テストクライアント] を選択して MQTT クライアントを開きます。

3. [Subscription topic] (トピックのサブスクリプション) で your-thing-name/example/topic と入力し、[Subscribe to topic] (トピックへのサブスクライブ) を選択します。

FreeRTOS デモプロジェクトを構築して実行する

ボードにシリアル接続を設定したら、FreeRTOS デモプロジェクトを構築し、ボードにデモをフラッシュしてからデモを実行できます。

WICED Studio で FreeRTOS デモプロジェクトを構築して実行するには

1. WICED Studio を起動します。

2. [File] (ファイル) メニューから [Import] (インポート) を選択します。[General] フォルダーを展開し、[Existing Projects into Workspace] (既存のプロジェクトを WorkSpace へ) を選択してから、[Next] (次へ) を選択します。

3. [Select root directory] (ルートディレクトリの選択) で、[Browse...] (参照) を選択し、パス freertos/projects/cypress/CYW954907AEVAL1F/wicedstudio に移動して、[OK] を選択します。

4. [Projects] (プロジェクト) で、[aws_demo] プロジェクトのみのチェックボックスをオンにします。[Finish] (完了) を選択してプロジェクトをインポートします。ターゲットプロジェクト aws_demo が [Make Target] (ターゲットの作成) ウィンドウに表示されます。

5. [WICED Platform] (WICED プラットフォーム) メニューを展開し、[WICED Filters off] (WICED フィルターオフ) を選択します。

6. [Make Target] (ターゲットの作成) ウィンドウで [aws_demo] を展開して、demo.aws_demo ファイルを右クリックし、[Build Target] (ターゲットを構築) を選択してデモを構築してからボードにダウンロードします。デモは、構築されボードにダウンロードされた後、自動的に実行されます。

トラブルシューティング

• 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 をダブルクリックします。

  2. 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 の開始方法に関する一般的なトラブルシューティングについては、「トラブルシューティングの開始方法」を参照してください。