翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Nuvoton NuMaker-IoT-M487 の開始方法 **重要** このリファレンス統合は、非推奨の Amazon-FreeRTOS リポジトリでホストされています。新しいプロジェクトを作成するときは、[ここから始める](freertos-getting-started-modular.md)ことをお勧めします。現在非推奨の Amazon-FreeRTOS リポジトリをベースにした既存の FreeRTOS プロジェクトが既にある場合は、「[Amazon FreeRTOS Github リポジトリ移行ガイド](github-repo-migration.md)」を参照してください。 このチュートリアルでは、Nuvoton NuMaker-IoT-M487 開発ボードの使用を開始するための手順について説明します。シリーズマイクロコントローラーには、RJ45 イーサネットおよび Wi-Fi モジュールが組み込まれています。Nuvoton NuMaker-IoT-M487 をお持ちでない場合は、[AWS Partner Device Catalog](https://devices.amazonaws.com/detail/a3G0h000000Tg9cEAC/NuMaker-IoT-M487) にアクセスして当社のパートナーから購入してください。 開始する前に、開発ボードを AWS クラウドに接続するように AWS IoT と FreeRTOS ソフトウェアを設定する必要があります。手順については、「[最初のステップ](freertos-prereqs.md)」を参照してください。このチュートリアルでは、FreeRTOS ダウンロードディレクトリへのパスを `freertos` とします。 ## 概要: このチュートリアルでは次のステップを説明します。 1. マイクロコントローラーボード用の組み込みアプリケーションを開発およびデバッグするためのソフトウェアをホストマシンにインストールします。 1. FreeRTOS デモアプリケーションをバイナリイメージにクロスコンパイルします。 1. アプリケーションバイナリイメージをボードにロードし、アプリケーションを実行します。 ## 開発環境をセットアップする Keil MDK Nuvoton エディションは、Nuvoton M487 ボード用のアプリケーションを開発およびデバッグするために設計されています。Keil MDK v5 Essential、Plus、または Pro バージョンは Nuvoton M487 (Cortex-M4 コア) MCU でも動作します。Keil MDK Nuvoton エディションは、Nuvoton Cortex-M4 シリーズ MCU の割引価格でダウンロードできます。Keil MDK は Windows でのみサポートされています。 **NuMaker-IoT-M487 用の開発ツールをインストールするには** 1. Keil MDK ウェブサイトから [Keil MDK Nuvoton Edition](https://store.developer.arm.com/store/embedded-iot-software-tools/keil-mdk-nuvoton-edition?edition=1164) をダウンロードします。 1. ライセンスを使用して Keil MDK をホストマシンにインストールします。Keil MDK には、Keil µVision IDE、C/C\$1\$1 コンパイルツールチェーン、および µVision デバッガーが含まれています。 インストール中に問題が発生した場合は、[Nuvoton](https://www.nuvoton.com/contact-us) にお問い合わせください。 1. [Nuvoton Development Tool](https://www.nuvoton.com/tool-and-software/ide-and-compiler/) ページにある **Nu-Link\$1Keil\$1Driver\$1V3.06.7215r** (または最新バージョン) をインストールします。 ## FreeRTOS デモプロジェクトを構築して実行する **FreeRTOS デモプロジェクトを構築するには** 1. Keil µVision IDE を開きます。 1. **[File]** (ファイル) メニューで、**[Open]** (開く) を選択します。**[Open file]** (ファイルを開く) ダイアログボックスで、ファイルタイプセレクタが **[Project Files]** (プロジェクトファイル) に設定されていることを確認します。 1. 構築する Wi-Fi またはイーサネットデモプロジェクトを選択します。 + Wi-Fi デモプロジェクトを開くには、`freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos` ディレクトリでターゲットプロジェクト `aws_demos.uvproj` を選択します。 + イーサネットデモプロジェクトを開くには、`freertos\projects\nuvoton\numaker_iot_m487_wifi\uvision\aws_demos_eth` ディレクトリでターゲットプロジェクト `aws_demos_eth.uvproj` を選択します。 1. ボードをフラッシュするための設定が正しいことを確認するには、IDE で `aws_demo` プロジェクトを右クリックし、**[Options]** (オプション) を選択します。(詳細については、[トラブルシューティング](#gsg-nuvoton-m487-troubleshoot) をご覧ください。) 1. **[Utilities]** (ユーティリティ) タブで、**[Use Target Driver for Flash Programming]** (フラッシュプログラミング用のターゲットドライバーを使用する) が選択されており、**[Nuvoton Nu-Link Debugger]** (Nuvoton Nu-Link デバッガー) がターゲットドライバーとして設定されていることを確認します。 1. **[Debug]** (デバッグ) タブで、**[Nuvoton Nu-Link Debugger]** (Nuvoton Nu-Link デバッガー) の横にある **[Settings]** (設定) を選択します。 1. [**Chip Type**] (チップのタイプ) が [**M480**] に設定されていることを確認します。 1. Keil µVision IDE **[Project]** (プロジェクト) ナビゲーションペインで、`aws_demos` プロジェクトを選択します。**[Project]** (プロジェクト) メニューで **[Build Target]** (ターゲットを構築) を選択します。 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 デモプロジェクトを実行するには** 1. Numaker-IoT-M487 ボードをホストマシン (コンピュータ) に接続します。 1. プロジェクトを再構築します。 1. Keil µVision IDE の **[Flash]** (フラッシュ) メニューで、**[Download]** (ダウンロード) を選択します。 1. **[Debug]** (デバッグ) メニューで、**[Start/Stop Debug Session]** (デバッグセッションの開始/停止) を選択します。 1. デバッガーが `main()` のブレークポイントで停止したら、**[Run]** (実行) メニューを開き、**[Run (F5)]** (実行 (F5)) を選択します。 AWS IoT コンソールの MQTT クライアントに、デバイスから送信された MQTT メッセージが表示されます。 ## FreeRTOS で CMake を使用する CMake を使用して、サードパーティーのコードエディタやデバッグツールを使用して開発した FreeRTOS デモアプリケーションやアプリケーションを構築して実行することもできます。 CMake ビルドシステムがインストールされていることを確認します。[FreeRTOS で CMake を使用する](getting-started-cmake.md) の指示に従った後に、このセクションのステップに従います。 **注記** コンパイラ (Keil) の場所へのパスが Path システム変数 (`C:\Keil_v5\ARM\ARMCC\bin` など) にあることを確認します。 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]** (トピックへのサブスクライブ) を選択します。 **ソースファイルからビルドファイルを生成し、デモプロジェクトを実行するには** 1. ホストマシンで、コマンドプロンプトを開き、*freertos* フォルダに移動します。 1. 生成されたビルドファイルを格納するフォルダを作成します。このフォルダは、*BUILD\$1FOLDER* と呼びます。 1. Wi-Fi またはイーサネットデモのビルドファイルを生成します。 + Wi-Fi の場合: FreeRTOS デモプロジェクトのソースファイルが格納されているディレクトリに移動します。次に、以下のコマンドを実行してビルドファイルを生成します。 ``` cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -S . -B BUILD_FOLDER -G Ninja ``` + イーサネットの場合: FreeRTOS デモプロジェクトのソースファイルが格納されているディレクトリに移動します。次に、以下のコマンドを実行してビルドファイルを生成します。 ``` cmake -DVENDOR=nuvoton -DBOARD=numaker_iot_m487_wifi -DCOMPILER=arm-keil -DAFR_ENABLE_ETH=1 -S . -B BUILD_FOLDER -G Ninja ``` 1. 以下のコマンドを実行して、M487 にフラッシュするバイナリを生成します。 ``` cmake --build BUILD_FOLDER ``` この時点で、バイナリファイル `aws_demos.bin` は `BUILD_FOLDER/vendors/Nuvoton/boards/numaker_iot_m487_wifi` フォルダにある必要があります。 1. ボードをフラッシュモードに設定するには、MSG スイッチ (ICE の ISW1 の 4 番) がオンになっていることを確認します。ボードに接続すると、ウィンドウ (およびドライブ) が割り当てられます。(「[トラブルシューティング](#gsg-nuvoton-m487-troubleshoot)」を参照してください。) 1. ターミナルエミュレータを開き、UART 経由でメッセージを表示します。[ターミナルエミュレーターをインストールする](gsg-troubleshooting.md#uart-term) の指示に従います。 1. 生成されたバイナリをデバイスにコピーして、デモプロジェクトを実行します。 MQTT クライアントで AWS IoT MQTT トピックにサブスクライブした場合、 AWS IoT コンソールにデバイスによって送信された MQTT メッセージが表示されます。 ## トラブルシューティング + Windows がデバイス `VCOM` を認識できない場合は、[Nu-Link USB Driver v1.6](https://www.nuvoton.com/export/resource-files/Nu-Link_USB_Driver_V1.6.zip) から NuMaker Windows シリアルポートドライバーをインストールします。 + Nu-Link 経由でデバイスを Keil MDK (IDE) に接続する場合は、次に示すように MSG スイッチ (ICE 上の ISW1 の 4 番) がオフになっていることを確認します。 ![\[SD カードスロット、マイクロコントローラー、ピン、電源、リセットコネクタがラベル付けされた回路基板。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/nuvoton-m487-gsg.png) 開発環境の設定やボードへの接続で問題が発生した場合は、[Nuvoton](http://www.nuvoton.com/contact-us/) にお問い合わせください。 ### Keil μVision での FreeRTOS プロジェクトのデバッグ **Keil µVision でデバッグセッションを開始するには** 1. Keil µVision を開きます。 1. 手順に従って、[FreeRTOS デモプロジェクトを構築して実行する](#gsg-nuvoton-m487-build-run) で FreeRTOS デモプロジェクトを構築します。 1. **[Debug]** (デバッグ) メニューで、**[Start/Stop Debug Session]** (デバッグセッションの開始/停止) を選択します。 デバッグセッションを開始すると、**[Call Stack\$1Locals]** (スタックの呼び出し \$1 ローカル) ウィンドウが表示されます。μVision はデモをボードに点滅させ、デモを実行し、`main()` 関数の先頭で停止します。 1. プロジェクトのソースコードのブレークポイントを設定し、コードを実行します。プロジェクトは次のようになります。 ![\[メインソースコードファイルで、デバイスマイクロコントローラープロジェクトのハードウェア初期化、タスクスケジューリング、キープロビジョニングが含まれます。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/numaker-iot-m487-debug.png) ### μVision デバッグ設定のトラブルシューティング アプリケーションのデバッグ中に問題が発生した場合は、Keil µVision でデバッグ設定が正しく設定されていることを確認してください。 **μVision デバッグ設定が正しいことを確認するには** 1. Keil µVision を開きます。 1. IDE で `aws_demo` プロジェクトを右クリックし、**[Options]** (オプション) を選択します。 1. **[Utilities]** (ユーティリティ) タブで、**[Use Target Driver for Flash Programming]** (フラッシュプログラミング用のターゲットドライバーを使用する) が選択されており、**[Nuvoton Nu-Link Debugger]** (Nuvoton Nu-Link デバッガー) がターゲットドライバーとして設定されていることを確認します。 ![\[オプションウィンドウで、フラッシュプログラミング、デバッグ、出力ファイル処理の設定を示します。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/nulink-debugger-target.png) 1. **[Debug]** (デバッグ) タブで、**[Nuvoton Nu-Link Debugger]** (Nuvoton Nu-Link デバッガー) の横にある **[Settings]** (設定) を選択します。 ![\[Nu-Link デバッガー設定ダイアログで、ドライバーバージョン、ICE バージョン、デバイスファミリー、デバイス ID、ポート、最大クロック、チップタイプ、接続モード、リセットオプション、電源制御電圧のオプションが含まれます。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/nulink-driver-setup.png) 1. [**Chip Type**] (チップのタイプ) が [**M480**] に設定されていることを確認します。