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

# STMicroelectronics STM32L4 ディスカバリキット IoT ノード用の開始方法
<a name="getting_started_st"></a>

**重要**  <a name="deprecation-message"></a>
このリファレンス統合は、非推奨の Amazon-FreeRTOS リポジトリでホストされています。新しいプロジェクトを作成するときは、[ここから始める](freertos-getting-started-modular.md)ことをお勧めします。現在非推奨の Amazon-FreeRTOS リポジトリをベースにした既存の FreeRTOS プロジェクトが既にある場合は、「[Amazon FreeRTOS Github リポジトリ移行ガイド](github-repo-migration.md)」を参照してください。

このチュートリアルでは、STMicroelectronics STM32L4 Discovery Kit IoT Node の使用を開始するための手順について説明します。STMicroelectronics STM32L4 Discovery Kit IoT Node をまだお持ちでない場合は、 AWS Partner Device Catalog にアクセスして[当社のパートナー](https://devices.amazonaws.com/detail/a3G0L00000AANsWUAX/STM32L4-Discovery-Kit-IoT-Node)から購入してください。

最新の Wi-Fi ファームウェアがインストールされていることを確認してください。最新の Wi-Fi ファームウェアをダウンロードするには、「[STM32L4 ディスカバリキット IoT ノード用、低電力ワイヤレス、Bluetooth Low Energy、NFC、SubGHz、Wi-Fi](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip)」を参照してください。**[Binary Resources]** (バイナリリソース) から **[Inventek ISM 43362 Wi-Fi module firmware update (read the readme file for instructions)]** (Inventek ISM 43362 Wi-Fi モジュールファームウェアの更新 (手順については readme ファイルをお読みください)) を選択します。

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

## 概要:
<a name="w2aac31b9b7c25c46c13"></a>

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

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

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

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

## 開発環境をセットアップする
<a name="st-setup-env"></a>

### System Workbench for STM32 をインストールする
<a name="install-system-workbench"></a>

1. [[OpenSTM32.org]](http://www.openstm32.org/HomePage) を参照します。

1. OpenSTM32 ウェブページに登録します。System Workbench をダウンロードするには、サインインする必要があります。

1. [System Workbench for STM32 インストーラ](http://www.openstm32.org/System%2BWorkbench%2Bfor%2BSTM32)を参照して、System Workbench をダウンロードおよびインストールします。

インストール中に問題が発生した場合は、[System Workbench ウェブサイト](http://www.openstm32.org/HomePage) にある、よくある質問を参照してください。

## FreeRTOS デモプロジェクトを構築して実行する
<a name="st-build-and-run-example"></a>

### FreeRTOS デモを STM32 System Workbench にインポートする
<a name="st-freertos-import-project"></a><a name="st-import-project"></a>

1. STM32 System Workbench を開き、新しい WorkSpace の名前を入力します。

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

1. **[Select Root Directory]** (ルートディレクトリを選択) に、`projects/st/stm32l475_discovery/ac6/aws_demos` と入力します。

1. デフォルトでは、プロジェクト `aws_demos` が選択されている必要があります。

1. プロジェクトを STM32 System Workbench にインポートするには、**[Finish]** (完了) を選択します。

1. **[Project]** (プロジェクト) メニューから **[Build All]** (すべて構築) を選択します。プロジェクトがエラーなしでコンパイルされているかどうかを確認します。

### クラウドの MQTT メッセージのモニタリング
<a name="w2aac31b9b7c25c46c17b5"></a>

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]** (トピックへのサブスクライブ) を選択します。

デバイス上でデモプロジェクトが正常に実行されると、「Hello World\$1」が 購読しているトピックに複数回送信されたことを確認できます。

### FreeRTOS デモプロジェクトを実行する
<a name="st-run-example"></a>

1. USB ケーブルを使用して STMicroelectronics STM32L4 ディスカバリキット IoT ノード用をコンピュータに接続します。(使用する適切な USB ポートについては、ボードに付属している製造元のドキュメントを参照してください)。

1. **[Project Explorer]** (プロジェクトエクスプローラー) から `aws_demos` を右クリックして **[Debug As]** (デバッグ方法) を選択し、**[Ac6 STM32 C/C\$1\$1 Application]** (Ac6 STM32 C/C\$1\$1 アプリケーション) を選択します。

   初めてデバッグセッションを起動した際にデバッグエラーが発生した場合は、次の手順に従います。

   1. STM32 System Workbench の **[Run]** (実行) メニューから、**[Debug Configurations]** (デバッグ設定) を選択します。

   1. **[aws\$1demos Debug]** (aws\$1demos デバッグ) を選択します (**[Ac6 STM32 Debugging]** (Ac6 STM32 デバッグ) を展開する必要がある場合があります)。

   1. **[Debugger]** (デバッガー) タブを選択します。

   1. **[Configuration Script]** (設定スクリプト) で、**[Show Generator Options]** (ジェネレーターオプションを表示) を選択します。

   1. **[Mode Setup]** (モード設定) で、**[Reset Mode]** (リセットモード) を **[Software System Reset]** (ソフトウェアシステムリセット) に設定します。**[Apply]** (適用) を選択し、**[Debug]** (デバッグ) を選択します。

1. デバッガーが `main()` のブレークポイントで停止したら、**[Run]** (実行) メニューから **[Resume]** (再開) を選択します。

### FreeRTOS で CMake を使用する
<a name="w2aac31b9b7c25c46c17b9"></a>

FreeRTOS 開発に IDE を使用しない場合は、代わりに CMake を使用して、サードパーティのコードエディタおよびデバッグツールを使用して開発したデモアプリケーションまたはアプリケーションを構築して実行できます。

まず、生成されたビルドファイルを格納するフォルダ (*build-folder*) を作成します。

ビルドファイルを生成するには、次のコマンドを使用します。

```
cmake -DVENDOR=st -DBOARD=stm32l475_discovery -DCOMPILER=arm-gcc -S freertos -B build-folder
```

シェルパス内に `arm-none-eabi-gcc` がない場合は、`AFR_TOOLCHAIN_PATH` CMake 変数を設定する必要もあります。例:

```
-D AFR_TOOLCHAIN_PATH=/home/user/opt/gcc-arm-none-eabi/bin
```

FreeRTOS で CMake を使用する方法の詳細については、「[FreeRTOS で CMake を使用する](getting-started-cmake.md)」を参照してください。

## トラブルシューティング
<a name="st-troubleshooting"></a>

デモアプリケーションから次の UART 出力が表示された場合は、Wi-Fi モジュールのファームウェアを更新する必要があります。

```
[Tmr Svc] WiFi firmware version is: xxxxxxxxxxxxx
[Tmr Svc] [WARN] WiFi firmware needs to be updated.
```

最新の Wi-Fi ファームウェアをダウンロードするには、「[STM32L4 ディスカバリキット IoT ノード用、低電力ワイヤレス、Bluetooth Low Energy、NFC、SubGHz、Wi-Fi](https://www.st.com/resource/en/utilities/inventek_fw_updater.zip)」を参照してください。**[Binary Resources]** (バイナリリソース) で、**[Inventek ISM 43362 Wi-Fi module firmware update]** (Inventek ISM 43362 Wi-Fi モジュールファームウェア更新) のダウンロードリンクを選択します。

FreeRTOS の開始方法に関する一般的なトラブルシューティングについては、「[トラブルシューティングの開始方法](gsg-troubleshooting.md)」を参照してください。