翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# MediaTek MT7697Hx Development Kit の開始方法
**重要**
このリファレンス統合は、非推奨の Amazon-FreeRTOS リポジトリでホストされています。新しいプロジェクトを作成するときは、[ここから始める](freertos-getting-started-modular.md)ことをお勧めします。現在非推奨の Amazon-FreeRTOS リポジトリをベースにした既存の FreeRTOS プロジェクトが既にある場合は、「[Amazon FreeRTOS Github リポジトリ移行ガイド](github-repo-migration.md)」を参照してください。
このチュートリアルでは、MediaTek MT7697Hx 開発キットの使用を開始するための手順について説明します。MediaTek MT7697Hx 開発キットをお持ちでない場合は、 AWSPartner Device Catalog にアクセスして[当社のパートナー](https://devices.amazonaws.com/detail/a3G0L00000AAOmPUAX/MT7697Hx-Development-Kit)から購入してください。
開始する前に、 AWS IoTと FreeRTOS ダウンロードを設定して、デバイスをAWS クラウドに接続する必要があります。手順については「[最初のステップ](freertos-prereqs.md)」を参照してください。このチュートリアルでは、FreeRTOS ダウンロードディレクトリへのパスを `freertos` とします。
## 概要:
このチュートリアルには、使用開始のための以下の手順が含まれています。
1. マイクロコントローラーボード用の組み込みアプリケーションを開発およびデバッグするためのソフトウェアをホストマシンにインストールします。
1. FreeRTOS デモアプリケーションをバイナリイメージにクロスコンパイルします。
1. アプリケーションバイナリイメージをボードにロードし、アプリケーションを実行します。
1. モニタリングおよびデバッグの目的で、シリアル接続経由でボード上で実行されているアプリケーションに接続します。
## 開発環境をセットアップする
環境をセットアップする前に、MediaTek MT7697Hx Development Kit の USB ポートにコンピュータを接続します。
### Keil MDK をダウンロードしてインストールする
ボードで FreeRTOS プロジェクトを設定、構築、実行するには、GUI ベースの Keil Microcontroller Development Kit (MDK) を使用します。Keil MDK には、μVision IDE および μVision Debugger が含まれています。
**注記**
Keil MDK は、Windows 7、Windows 8、および Windows 10 64 ビットコンピュータでのみサポートされています。
**Keil MDK をダウンロードしてインストールするには**
1. [Keil MDK の開始方法](http://www2.keil.com/mdk5/install/)ページを開き、**[Download MDK-Core]** (MDK-Core のダウンロード) を選択します。
1. Keil に登録するには、情報を入力して送信します。
1. MDK 実行ファイルを右クリックし、Keil MDK インストーラをコンピュータに保存します。
1. Keil MDK インストーラを開き、ステップを完了します。MediaTek デバイスパック (MT76x7 シリーズ) がインストールされていることを確認します。
## シリアル接続の確立
USB ケーブルを使用して、ボードをホストコンピュータに接続します。Windows デバイスマネージャーに COM ポートが表示されます。デバッグするには、ターミナルユーティリティツール (例: HyperTerminal や TeraTerm) を使用して、ポートへのセッションを開きます。
## クラウドの MQTT メッセージのモニタリング
FreeRTOS デモプロジェクトを実行する前に、AWS IoTコンソールで MQTT クライアントを設定して、デバイスが AWSクラウドに送信するメッセージをモニタリングできます。
**MQTT クライアントで AWS IoTMQTT トピックをサブスクライブするには**
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」が 購読しているトピックに複数回送信されたことを確認できます。
## Keil MDK を使用して FreeRTOS デモプロジェクトを構築して実行する
**Keil μVision で FreeRTOS デモプロジェクトを構築するには**
1. **[Start]** (スタート) メニューから Keil μVision 5 を開きます。
1. `projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/aws_demos.uvprojx` プロジェクトファイルを開きます。
1. メニューから、**[Project]** (プロジェクト)、**[Build target]** (ビルドターゲット) の順に選択します。
コードがビルドされたら、`projects/mediatek/mt7697hx-dev-kit/uvision/aws_demos/out/Objects/aws_demo.axf` にデモ実行ファイルが表示されます。
**FreeRTOS デモプロジェクトを実行するには**
1. MediaTek MT7697Hx Development Kit を PROGRAM モードに設定します。
kit を PROGRAM モードに設定するには、**[PROG]** ボタンを押し続けます。**[PROG]** ボタンを押し続けながら、**[RESET]** (リセット) ボタンを押して離し、**[PROG]** ボタンを離します。
1. メニューから、**[Flash]**、**[Configure Flash Tools]** (Flash ツールを設定) を選択します。
1. [**Options for Target '`aws_demo`'**] で、[**デバッグ**] タブを選択します。**[Use]** (使用) を選択して、デバッガーを **[CMSIS-DAP Debugger]** (CMSIS-DAP デバッガー) に設定し、**[OK]** を選択します。
1. メニューから、**[Flash]**、**[Download]** (ダウンロード) を選択します。
ダウンロードが完了すると、μVision より通知されます。
1. ターミナルユーティリティを使用して、シリアルコンソールウィンドウを開きます。シリアルポートを 115200 bps、パリティなし、8 ビット、および 1 ストップビットに設定します。
1. MediaTek MT7697Hx Development Kit で **[RESET]** (リセット) ボタンを選択します。
## トラブルシューティング
### Keil μVision での FreeRTOS プロジェクトのデバッグ
現時点では、Keil μVision で MediaTek 用の FreeRTOS デモプロジェクトをデバッグする前に、Keil μVision に付属している MediaTek パッケージを編集する必要があります。
**MediaTek パッケージを編集して FreeRTOS プロジェクトをデバッグするには**
1. Keil MDK インストールフォルダの `Keil_v5\ARM\PACK\.Web\MediaTek.MTx.pdsc` ファイルを開きます。
1. `flag = Read32(0x20000000);` のインスタンスをすべて、`flag = Read32(0x0010FBFC);` に置き換えます。
1. `Write32(0x20000000, 0x76877697);` のインスタンスをすべて、`Write32(0x0010FBFC, 0x76877697);` に置き換えます。
**プロジェクトのデバッグを開始するには**
1. メニューから、**[Flash]**、**[Configure Flash Tools]** (Flash ツールを設定) を選択します。
1. **[Target]** (ターゲット) タブを選択し、**[Read/Write Memory Areas]** (読み取り/書き取りメモリエリア) を選択します。IRAM1 と IRAM2 がいずれも選択されていることを確認します。
1. **[Debug]** (デバッグ) タブ、**[CMSIS-DAP Debugger]** (CMSIS-DAP デバッガー) の順に選択します。
1. `vendors/mediatek/boards/mt7697hx-dev-kit/aws_demos/application_code/main.c` を開き、マクロ `MTK_DEBUGGER` を `1` に設定します。
1. μVision でデモプロジェクトを再構築します。
1. MediaTek MT7697Hx Development Kit を PROGRAM モードに設定します。
kit を PROGRAM モードに設定するには、**[PROG]** ボタンを押し続けます。**[PROG]** ボタンを押し続けながら、**[RESET]** (リセット) ボタンを押して離し、**[PROG]** ボタンを離します。
1. メニューから、**[Flash]**、**[Download]** (ダウンロード) を選択します。
ダウンロードが完了すると、μVision より通知されます。
1. MediaTek MT7697Hx Development Kit で **[RESET]** (リセット) ボタンを選択します。
1. μVision メニューから、**[Debug]** (デバッグ)、**[Start/Stop Debug Session]** (デバッグセッションの開始/停止) の順に選択します。デバッグセッションを開始すると、**[Call Stack \$1 Locals]** (スタックの呼び出し \$1 ローカル) ウィンドウが開きます。
1. メニューから **[Debug]** (デバッグ) を選択し、**[Stop]** (停止) を選択して、コードの実行を一時停止します。プログラムカウンタは次の行で停止します。
```
{ volatile int wait_ice = 1 ; while ( wait_ice ) ; }
```
1. **[Call Stack \$1 Locals]** (スタックの呼び出し \$1 ローカル) ウィンドウで、`wait_ice` の値を `0` に変更します。
1. プロジェクトのソースコードのブレークポイントを設定し、コードを実行します。
### IDE デバッガー設定のトラブルシューティング
アプリケーションのデバッグ中に問題が発生した場合は、デバッガー設定が正しくない可能性があります。
**デバッガー設定が正しいことを確認するには**
1. Keil µVision を開きます。
1. `aws_demos` プロジェクトを右クリックし **[Options]** (オプション) を選択し、**[Utilities]** (ユーティリティ) タブで **[-- Use Debug Driver --]** (デバッグドライバを使用) の隣にある **[Settings]** (設定) を選択します。
1. **[Debug]** (デバッグ) タブの設定が以下のように表示されていることを確認します。
![\[CMSIS-DAP Cortex-M ターゲットドライバーのセットアップダイアログで、シリアル番号、ファームウェアバージョン、アダプタータイプ、SW デバイスオプション、および設定が含まれます。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/mediatek-debug-2.png)
1. **[Flash Download]** (フラッシュダウンロード) タブの設定が以下のように表示されていることを確認します。
![\[Cortex-M ターゲットドライバーのセットアップウィンドウで、ダウンロード関数、アルゴリズムの RAM、プログラミングアルゴリズムの説明、デバイスの詳細のオプションが含まれます。\]](http://docs.aws.amazon.com/ja_jp/freertos/latest/userguide/images/mediatek-debug-3.png)
FreeRTOS の開始方法に関する一般的なトラブルシューティングについては、「[トラブルシューティングの開始方法](gsg-troubleshooting.md)」を参照してください。