i.MX RT1170評価キットのスタート・ガイド

マルチコア・アプリケーション・プロジェクトは、リンクされた2つ（またはそれ以上の）プロジェクトで構成されています。1つのプロジェクトにはマスター・コードが含まれ、他の1つ（以上）のプロジェクトにはスレーブ・コードが含まれます。「マスター」プロジェクトには「スレーブ」プロジェクトへのリンクが含まれています。そのため、マスター・プロジェクトをビルドすると、「マスター」イメージに「スレーブ」の出力イメージが含まれます。マスター・プロジェクトをビルドすると、先にスレーブ・プロジェクトのビルドがトリガされます。

RT1170 SDKには、サンプルのマルチコア・アプリケーションが豊富に用意されています。各マルチコア・サンプルに、Arm CM7用とArm CM4用の2つのソース・ディレクトリが含まれます。

マルチコア・アプリケーションのビルドとフラッシュ

次の手順では、MCUXpresso IDEを使用したマルチコアHello Worldアプリケーションについて説明します。

注：MCUXpresso IDEのインストールについては、「スタート・ガイド」のウェブサイトのセクション「2. ソフトウェアの入手」に記載されています。

1. MCUXpresso IDEを開きます。
2. MCUXpresso IDEウィンドウ内のビューを［Installed SDKs（インストール済みSDK）］に切り替えます。

3. MIMXRT1170-EVK SDKのzipファイルを［Installed SDKs（インストール済みSDK）］ビューにドラッグ＆ドロップします。
4. 次のポップアップが表示されます。［OK］をクリックして以下のインポートを続行します。

5. インストールされたSDKは、以下に示すように［Installed SDKs（インストール済みSDK）］ビューに表示されます。

6. 左下隅にあるクイックスタート・パネルを確認します。

7. その中の［Import SDK example(s)...（SDKサンプルのインポート）］をクリックします。

8. サンプルをインポートして実行させるボードとして「evkmimxrt1170ボード」をクリックして選択し、［Next（次へ）］をクリックします。

9. 矢印ボタンを使用して［multicore_examples］カテゴリを展開し、hello_world_cm7プロジェクトの横にあるチェック・ボックスをクリックして選択状態にします。cm7プロジェクトを選択した場合、cm4プロジェクトも選択されます。出力用にデフォルトのセミホスティングではなくUARTを使用するには、［Project Options（プロジェクト・オプション）］にある［SDK Debug Console（SDKデバッグ・コンソール）］のチェック・ボックスで［UART］を選択します。次に、［Finish（完了）］をクリックします。

10. 「Project Explorer（プロジェクト・エクスプローラ）」にhello_world_cm7とhello_world_cm4が含まれていることを確認します。

11. hello_world_cm7プロジェクトを選択し、ビルドします。MCUXpressoは、最初にhello_world_cm4プロジェクトをビルドし、次にhello_world_cm7をビルドすることに留意してください。

12. プロジェクトが問題なくビルドされます。

サンプル・アプリケーションの実行

アプリケーションをダウンロードして実行するには、以下の手順を実行します。

1. このボードは、デフォルトでCMSIS-DAP/mbed/DAPLinkデバッグ・プローブをサポートしています。Windows serial configurationにアクセスし、手順に従ってWindows^® OSのシリアル・ドライバをインストールします。Linux OSを使用している場合、この手順は必要ありません。
2. ボードをコンピュータに接続します。次の点を考慮してください。
   • QSPIからブートする際は、SW1が0010に設定されていることを確認する
   • 電源をJ43に接続する（J38が [1-2] に設定されている場合）
   • micro USB-を使用してPCをボードのJ11ポートに接続する

3. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、デバッグのシリアル・ポート番号に接続します。次の設定値を用いてターミナルを設定します。
   1. ボーレート：115200 (BOARD_DEBUG_UART_BAUDRATE)
   2. パリティなし
   3. 8データ・ビット
   4. 1ストップ・ビット。

4. hello_world_cm7のアプリケーションとMIMXRT1170-EVKへのアプリケーションを選択します。

5. 「DAPLink」デバッグ・プローブを選択し、［OK］をクリックします。

6. 2つ目の「Probes discovered（検出されたプローブ）」ウィンドウが自動的に表示されます。これはhello_world_cm4プロジェクト用です。ここでも「DAPLink」デバッグ・プローブを選択し、［OK］をクリックします。
7. ［Resume（再開）］ボタンをクリックしてhello_world_cm7プロジェクトを開始します。

8. ［Resume（再開）］ボタンをクリックしてhello_world_cm4プロジェクトを開始します。

9. これで、両方のコアが動作しています。コンソールにはこの出力が以下のように表示されます。

10. マルチコアの停止をクリックしてデバッグ・セッションを終了します。

サンプル・アプリケーションのビルドと実行に関する詳細な情報および手順については、SDKの/docsフォルダにあるMIMXRT1170-EVK向けMCUXpresso SDKのスタート・ガイド.pdfを参照してください。

サンプル・アプリケーションのビルド

次の手順に従ってhello_worldアプリケーションを開きます。他のサンプル・アプリケーションでは、手順がわずかに異なる場合があります。アプリケーションによってはパスのフォルダ階層が深くなるためです。

1. 最初に、以前にダウンロードしたSDKを解凍します。
2. 目的のサンプル・アプリケーション・ワークスペースをまだ開いていない場合はここで開きます。ほとんどのサンプル・アプリケーション・ワークスペースのファイルは、次のパスに置かれています。

 /boards/////iar 

hello_worldデモをサンプルとして使用する場合、パスは次のようになります。

 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/iar/hello_world.eww 

3. ドロップダウン・リストから、目的のビルド・ターゲットを選択します。ここでは、hello_world – debugを選択します

4. アプリケーションをビルドするには、下の図で赤色でハイライト表示されている［Make（作成）］ボタンをクリックします。

5. ビルドが正常に完了します。


注：ビルド・エラーが発生した場合は、正しいボードが選択されていることを確認します。右クリックで［Project（プロジェクト）］>> ［Options（オプション）］>>［General Options（一般オプション）］>>［Target（ターゲット）］>>［Device（デバイス）］の順に進み、NXPのMIMXRT1176xxxA_M7を選択します。このボードはIAR Embedded Workbench for Armバージョン8.50.6以上でサポートされています。

サンプル・アプリケーションの実行

アプリケーションをダウンロードして実行するには、以下の手順を実行します。

1. このボードは、デフォルトでCMSIS-DAP/mbed/DAPLinkデバッグ・プローブをサポートしています。Windows serial configurationにアクセスし、手順に従ってWindows^® OSのシリアル・ドライバをインストールします。Linux OSを使用している場合、この手順は必要ありません。
2. ボードをコンピュータに接続します。次の点を考慮してください。
   • QSPIからブートする際は、SW1が0010に設定されていることを確認する
   • 電源をJ43に接続する（J38が [1-2] に設定されている場合）
   • micro USB-を使用してPCをボードのJ11ポートに接続する

3. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、デバッグのシリアル・ポート番号に接続します。次の設定値を用いてターミナルを設定します。
   1. ボーレート：115200 (BOARD_DEBUG_UART_BAUDRATE)
   2. パリティなし
   3. 8データ・ビット
   4. 1ストップ・ビット。

4. ［Download and Debug（ダウンロードとデバッグ）］ボタンをクリックして、アプリケーションをターゲットにダウンロードします。

5. アプリケーションがターゲットにダウンロードされると、自動的にmain()関数まで実行されます。
6. ［Go（実行）］ボタンをクリックすると、コードが実行され、アプリケーションが開始されます。

7. hello_worldアプリケーションが実行され、ターミナルにバナーが表示されます。表示されない場合は、ターミナルの設定と接続を確認してください。

マルチコア・サンプル・アプリケーションのビルドと実行に関する詳細な情報および手順については、SDKの/docsフォルダにあるMIMXRT1170-EVK向けMCUXpresso SDKのスタート・ガイド.pdfを参照してください。

CMSISデバイス・パックのインストール

MDKツールをインストールした後、デバッグ目的でデバイスを完全にサポートするには、CMSIS (Cortex^® Microcontroller Software Interface Standard) デバイス・パックをインストールする必要があります。このパックには、メモリ・マップ情報、レジスタ定義、フラッシュ・プログラミング・アルゴリズムなどが含まれています。下記の手順に従って、適切なCMSISパックをインストールしてください。

1. MIMXRT1171、MIMXRT1172、MIMXRT1173、MIMXRT1175、およびMIMXRT1176のパックをダウンロードします。
2. DFPをダウンロードしたら、ダブルクリックしてインストールします。
3. インストールが完了したら、［Pack Installer（パック・インストーラ）］ウィンドウを閉じて、µVision IDEに戻ります。

サンプル・アプリケーションのビルド

次の手順に従ってhello_world_demo_cm7アプリケーションを開きます。

1. 以下のパスで目的のサンプル・アプリケーション・ワークスペースを開きます。

 /boards////mdk 

ワークスペース・ファイルの名前は.uvmpwです。今回の例の場合、実際のパスは次のようになります。

 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/mdk/hello_world_demo_cm7.uvmpw 

2. デモ・プロジェクトをビルドするには、［Rebuild（リビルド）］ボタン（赤色でハイライト表示）を選択します。

3. ビルドが正常に完了します。

サンプル・アプリケーションの実行

ここでは、J-Link GDBサーバ・アプリケーションを使用してデモ・アプリケーションを実行する手順について説明します。この作業を行うには、次のいずれかであることを確認してください。

アプリケーションをダウンロードして実行するには、以下の手順を実行します。

1. このボードは、デフォルトでCMSIS-DAP/mbed/DAPLinkデバッグ・プローブをサポートしています。Windows serial configurationにアクセスし、手順に従ってWindows^® OSのシリアル・ドライバをインストールします。Linux OSを使用している場合、この手順は必要ありません。
2. ボードをコンピュータに接続します。次の点を考慮してください。
   • QSPIからブートする際は、SW1が0010に設定されていることを確認する
   • 電源をJ43に接続する（J38が [1-2] に設定されている場合）
   • micro USB-を使用してPCをボードのJ11ポートに接続する

3. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、デバッグのシリアル・ポート番号に接続します。次の設定値を用いてターミナルを設定します。
   1. ボーレート：115200 (BOARD_DEBUG_UART_BAUDRATE)
   2. パリティなし
   3. 8データ・ビット
   4. 1ストップ・ビット
   
4. アプリケーションが正しくビルドされたら、［Download（ダウンロード）］ボタンをクリックして、アプリケーションをターゲットにダウンロードします。

5. ［Start/Stop Debug Session（デバッグ・セッションの開始/停止）］をクリックしてデバッグ・ビューを開きます。

6. ［Run（実行）］ボタンをクリックすると、コードが実行され、アプリケーションが開始されます。

7. これで、hello_world_demo_cm7アプリケーションが実行されています

マルチコア・サンプル・アプリケーションのビルドと実行に関する詳細な情報および手順については、SDKの/docsフォルダにあるMIMXRT1170-EVK向けMCUXpresso SDKのスタート・ガイド.pdfを参照してください。

ツールチェーンのセットアップ

ここでは、MCUXpresso SDKでサポートされているように、Arm GCCツールチェーンを使用してMCUXpresso SDKのデモ・アプリケーションのビルドと実行を行う際に必要となるコンポーネントをインストールする手順について説明します。Arm GCCツールの使用方法はさまざまですが、今回の例では、Windows環境に焦点を当てています。ここでは省略しますが、GCCツールは、Linux OSやMac OSXの環境でも利用できます。

GCC Arm Embeddedツールチェーンのインストール

launchpad.net/gcc-arm-embeddedからインストーラをダウンロードして、実行します。これは実際のツールセットです（つまり、コンパイラ、リンカなど）。GCCツールチェーンは、/docsフォルダ内の「MIMXRT1170-EVKをサポートするMCUXpresso SDKのリリース・ノート」に記載されている最新のサポート・バージョンを使用する必要があります。

MinGWのインストール

MinGW (Minimalist GNU for Windows) 開発ツールは、サード・パーティ製のCランタイムDLL（Cygwinなど）に依存しないツール・セットを備えています。MCUXpresso SDKで使用されているビルド環境では、MinGWビルド・ツールを利用せず、MinGWとMSYSのベース・インストールを活用しています。MSYSは、Unixに似たインターフェースと各種ツールを備えた基本シェルを備えています。

1. 最新のMinGW mingw-get-setupインストーラを
   sourceforge.net/projects/mingw/files/Installer/からダウンロードします。
2. インストーラを実行します。インストール・パスとしては「C:\MinGW」を推奨しますが、それ以外の任意の場所にインストールできます。

注：インストール・パスにスペースを含めることはできません。

3. ［Basic Setup（基本セットアップ）］で、「mingw32-base」と「msys-base」が選択されていることを確認します。

4. 「Installation（インストール）」メニューで［Apply Changes（変更を適用） ］をクリックし、残りの手順に従ってインストールを完了します。

5. Windows OSのPath環境変数に適切なアイテムを追加します。これは、［Control Panel（コントロール・パネル）］>［System and Security（システムとセキュリティ）］>［System（システム）］>［Advanced System Settings（システムの詳細設定）］の［Environment Variables...（環境変数）］セクションで設定します。パスは次のとおりです。

\bin

デフォルトのインストール・パスであるC:\MinGWを使用した例を以下に示します。パスが正しく設定されていないと、ツールチェーンは機能しません。

注：PATH変数にC:\MinGW\msys\x.x\binが設定されている場合（KSDK 1.0.0向けの旧仕様）、これを削除してください。削除されていないと、新しいGCCビルド・システムが正しく機能しない場合があります。

ARMGCC_DIR向けの新しい環境変数を追加する

新しいシステム環境変数を作成して、「ARMGCC_DIR」という名前を付けます。この変数の値で、Arm GCC Embeddedツールチェーンのインストール・パスを指定します。今回の例では、次のようになります。

 C:\Program Files (x86)\GNU Tools ARM Embedded\ 

インストール・フォルダの正確なパス名については、GNU Arm GCC Embeddedツールのインストール・フォルダを参照してください。

CMakeのインストール

1. 
   CMakeのダウンロードから、CMake 3.0.xをダウンロードします。
2. CMakeをインストールします。インストール時には、必ず［Add CMake to system PATH（CMakeをシステム・パスに追加）］オプションを選択します。すべてのユーザーが使用できるパスにインストールするか、現在のユーザーのみが使用できるパスにインストールするかは、ユーザーが選択します。今回の例では、すべてのユーザーに対してインストールしています。

3. インストーラの残りの手順に従います。
4. パスの変更を適用するには、システムの再起動が必要になる場合があります。
5. sh.exeが環境変数PATHに含まれていないことを確認してください。これがあると、mingw32-makeが制限されます。

サンプル・アプリケーションのビルド

サンプル・アプリケーションをビルドする手順は次のとおりです。

1. GCC Arm Embeddedツールチェーンのコマンド・ウィンドウを開きます。ウィンドウを開くには、Windows OSの［スタート］メニューから、［プログラム］>［GNU Tools Arm Embedded ］に移動して、［GCC Command Prompt（GCCコマンド・プロンプト）］を選択します。

2. ディレクトリをサンプル・アプリケーション・プロジェクト・ディレクトリに変更します。パスは次のようになります。

 /boards////armgcc 

このガイドの場合、実際のパスは次のようになります。

 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/armgcc 

3. コマンドラインで「build_debug.bat」と入力するか、Windows OSのエクスプローラで「build_debug.bat」ファイルをダブルクリックして、ビルドを実行します。次のような出力画面が表示されます。

サンプル・アプリケーションの実行

ここでは、J-Link GDBサーバ・アプリケーションを使用してデモ・アプリケーションを実行する手順について説明します。この作業を行うには、次のいずれかであることを確認してください。

• ボードのFreelink/LPC-Link2インターフェースが、J-Linkファームウェアでプログラムされている。ボードがFreelink/LPC-Link2インターフェースをサポートしていない場合は、スタンドアロンのJ-Linkポッドが必要になります。
• ボードのデバッグ・インターフェースにスタンドアロンのJ-Linkポッドが接続されている。

注：一部のハードウェア・プラットフォームでは、外部デバッグ・インターフェースで正常に機能させるためにハードウェアに変更を加えることが必要となります。

J-Linkファームウェアを使用してFreelink/LPC-Link2インターフェースを設定する手順は、次のとおりです。

1. MIMXRT1170-EVKの電源を切ります
2. J22ヘッダにジャンパを配置してDFUブート・モードに設定します
3. MIMXRT1170-EVKの電源を入れます
4. J11ポート経由でPCに接続します
5. LPCScrypt v2.1.2からLPCScryptをダウンロードして、インストールします
6. LPCScryptのインストール先にあるscriptsフォルダ、つまり次のフォルダを開きます。
   C:/NXP/LPCScrypt_2.1.1_15/scripts
7. 「program_JLINK.cmd」スクリプトを実行します
8. スクリプトが完了したら、LPCScryptウィンドウを閉じます
9. MIMXRT1170-EVKの電源を切ります
10. J22ヘッダからジャンパを取り外します
11. MIMXRT1170-EVKの電源を入れます
12. デバイス・マネージャにJ-Linkインターフェースが一覧表示されていることを確認します

J-Linkインターフェースを設定して接続したら、以下の手順に従ってデモ・アプリケーションをダウンロードして実行します。

1. 開発プラットフォームをPCに接続します。 LPC-Link2 (J11) のUSBコネクタとPCのUSBコネクタをUSBケーブルでつないでください。スタンドアロンのJ-Linkデバッグ・ポッドを使用している場合は、ボードのSWD/JTAGコネクタにも接続してください。

2. J-Link GDBサーバ・アプリケーションを開きます。J-Linkソフトウェアがインストールされている場合、Windows OSの［スタート］メニューに移動し、［プログラム］>［SEGGER］>［J-Link J-Link GDB Server］を選択するとアプリケーションを起動できます。
3. デバイスとして「MIMXRT1176xxxA_M7」、ターゲット・インターフェースとしてSWDを選択します。

4. GDBサーバがGDB接続の待機中であることを確認します。

5. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、デバッグのシリアル・ポート番号に接続します。次の設定値を用いてターミナルを設定します。
1. 115200（board.hのリファレンスBOARD_DEBUG_UART_BAUDRATE）
2. パリティなし
3. 8データ・ビット
4. 1ストップ・ビット

6. GCC Arm Embeddedツールチェーンのコマンド・ウィンドウが開いていない場合はここで開きます。ウィンドウを開くには、Windows OSの［スタート］メニューから、［プログラム］>［GNU Tools Arm Embedded ］に移動して、［GCC Command Prompt（GCCコマンド・プロンプト）］を選択します。

7. デモ・アプリケーションの出力を格納するディレクトリに移動します。出力は、選択したビルド・ターゲットに応じて、次のいずれかのパスに格納されます。

 /boards////cm7/armgcc/debug 

 /boards////cm7/armgcc/release 

このガイドの場合、パスは次のようになります。

 /boards/evkmimxrt1170/demo_apps/hello_world/cm7/armgcc/debug 

8. arm-none-eabi-gdb.exe .elfを実行します。この例の場合、「arm-none-eabi-gdb.exe hello_world.elf」というコマンドになります。

9. GCCコマンド・プロンプトで次のコマンドを実行します。
   • target remote localhost:2331
   • monitor reset
   • monitor halt
   • load
10. アプリケーションがダウンロードされ、リセット・ベクタで停止します。
    「monitor go」コマンドを実行すると、デモ・アプリケーションが開始されます。

「hello_world」アプリケーションが実行され、ターミナルにバナーが表示されます。表示されない場合は、ターミナルの設定と接続を確認してください。

マルチコア・サンプル・アプリケーションのビルドと実行に関する詳細な情報および手順については、SDKの/docsフォルダにあるMIMXRT1170-EVK向けMCUXpresso SDKのスタート・ガイド.pdfを参照してください。