MIMXRT1020-EVKのスタート・ガイド

• SWDとJTAGによるデバッグ・サポート
• 柔軟性の高いソフトウェア
• ペリフェラル・ドライバ一式（ソース・コードあり）
• アプリケーション・サンプルとプロジェクト・ファイル

詳細はこちら

• 拡張性に優れたオープンソースのリアルタイム・オペレーティング・システム (RTOS)
• 複数のハードウェア・アーキテクチャをサポート
• リソースに制約のあるデバイス向けに最適化
• セキュリティを重視した設計

詳細については、 Zephyr OSデベロッパ・ウェブサイトをご覧ください。

MCUXpresso SDKのインポート

1. MCUXpresso IDEを開きます
2. コンピュータでワークスペースのディレクトリを選択します。
3. MCUXpresso IDEウィンドウ内のビューを［Installed SDKs（インストール済みSDK）］に切り替えます。
4. Windowsエクスプローラを開き、EVK-MIMXRT1020 SDKのzipファイルを［Installed SDKs（インストール済みSDK）］ビューにドラッグ・アンド・ドロップします。
5. 次のプロンプトが表示されます。［OK］をクリックしてインポートを続行します。
6. インストールされたSDKは、以下に示すように［Installed SDKs（インストール済みSDK）］ビューに表示されます。

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

1. 左下隅にある「Quickstart Panel（クイックスタート・パネル）」を確認します

   

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

   

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

   

4. 矢印ボタンを使用して［demo_apps］カテゴリを展開し、hello_worldの横にあるチェックボックスをクリックしてそのプロジェクトを選択します。［SDK Debug Console（SDKデバッグ・コンソール）］として［UART］が選択されていることを確認してください。次に、［Finish（完了）］をクリックします。

   

5. ここで、プロジェクト名をクリックし、［Build（ビルド）］アイコンをクリックして、プロジェクトをビルドします。

   

6. ビルドの進捗状況は［Console（コンソール）］タブで確認できます。

   

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

1. プロジェクトがコンパイルされたので、ボードにフラッシュしてプロジェクトを実行できます。
2. MIMXRT1020-EVKのOpenSDAデバッグ・コネクタにUSBケーブルが接続されていることを確認し、「Quickstart Panel（クイックスタート・パネル）」の［Debug（デバッグ）］をクリックします。

3. MCUXpresso IDEは接続されたボードを検出します。MIMXRT1020-EVKに統合されたOpenSDA回路の一部であるCMSIS-DAPデバッグ・プローブが検出される必要があります。［OK］をクリックして続行します。

   

4. ファームウェアがボードにダウンロードされ、デバッガが起動します。

   

5. ターミナル・プログラムを開き、ボードが列挙したCOMポートに接続します。ボーレート115200、8データ・ビット、パリティなし、1ストップ・ビットを使用します。

6. ［Resume（再開）］ボタンをクリックして、アプリケーションの実行を開始します。

   

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

   

8. 命令の一時停止、ステップ・イン、ステップ・オーバーを行うにはメニュー・バーのコントロールを使用します。デバッグ・セッションを停止するには、［Terminate（終了）］アイコンをクリックします。

   

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

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

1. 目的のデモ・アプリケーション・ワークスペースをまだ開いていない場合はここで開きます。ほとんどのサンプル・アプリケーション・ワークスペースのファイルは、次のパスに置かれています。

   /boards////iar
   

   hello_worldデモをサンプルとして使用する場合、パスは以下に置かれています。

   /boards/evkmimxrt1020/demo_apps/hello_world/iar/hello_world.eww

2. ドロップダウン・リストから、目的のビルド・ターゲットを選択します。

   ここでは、「hello_world – flexspi_nor_debug」ターゲットを選択します。

   

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

   

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

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

1. 開発プラットフォームをUSBケーブルでPCに接続します。

2. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、デバッグのCOMポートに接続します。次の設定値を用いてターミナルを設定します。

   1. ボーレート115200（board.hファイルのBOARD_DEBUG_UART_BAUDRATE変数を参照）
   2. パリティなし
   3. 8データ・ビット
   4. 1ストップ・ビット

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

   

4. アプリケーションがターゲットにダウンロードされると、自動的にmain()関数まで実行されます。

5. ［Go（実行）］ボタンをクリックすると、コードが実行され、アプリケーションが起動します。

   

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

   

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

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

1. µVisionという名前のMDK IDEを開きます。IDEで、［Pack Installer（パック・インストーラ）］アイコンを選択します。

   

2. ［Pack Installer（パック・インストーラ）］ウィンドウで、［Devices（デバイス）］タブに移動し、［NXP］の下のMIMXRT1021デバイスを選択します。

   
3. ［Pack（パック）］タブで、MIMXRT1020-EVKボードのDFPをインストールします。DFPの名前はNXP::MIMXRT1021_DFPです。パックの横にある［Install（インストール）］ボタンをクリックします。このプロセスを正常に完了するには、インターネット接続が必要となります。


4. インストールが完了したら、［Pack Installer（パック・インストーラ）］ウィンドウを閉じて、µVision IDEに戻ります。

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

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

1. 目的のデモ・アプリケーション・ワークスペースをまだ開いていない場合は以下で開きます。

   /boards////mdk
   

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

   /boards/evkmimxrt1020/demo_apps/hello_world/mdk/hello_world.uvmpw

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

   

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

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

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

1. 開発プラットフォームをUSBケーブルでPCに接続します。

2. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、デバッグのシリアル・ポート番号に接続します。次の設定値を用いてターミナルを設定します。

   • ボーレート115200（board.hファイルのBOARD_DEBUG_UART_BAUDRATE変数を参照）
   • パリティなし
   • 8データ・ビット
   • 1ストップ・ビット

3. アプリケーションが正しくビルドされたら、［Load（ロード）］ボタンをクリックして、アプリケーションをターゲットにダウンロードします。

   

4. アプリケーションをデバッグする場合、［Start/Stop Debug Session（デバッグ・セッションの開始/終了）］ボタン（赤色でハイライト表示）をクリックします。

   

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

   

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

   
7. ［Stop（停止）］を押して、デバッグ・セッションを終了します。

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

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

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

GNU Arm Embeddedツールチェーンからインストーラをダウンロードして、実行します。これは実際のツールチェーンです（コンパイラ、リンカなど）。Kinetis SDKリリース・ノートに記載されている、サポート対象の最新バージョンのGCCツールチェーンを使用する必要があります。

MinGWのインストール

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

1. MinGW - Minimalist GNU for Windowsファイルから最新のMinGW mingw-get-setupインストーラをダウンロードしてください。

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ビルド・システムが正しく機能しない場合があります。

   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\4.9 2015q3

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



CMakeのインストール

1. CMakeからCMake 3.0.xをダウンロードします

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

   

3. インストーラの残りの手順に従います。

4. PATHの変更を適用するには、システムの再起動が必要になる場合があります。

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

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

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

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

   /boards////armgcc
   

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

   /boards/evkmimxrt1020/demo_apps/hello_world/armgcc

   

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

   

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

ここでは、J-Link GDBサーバ・アプリケーションを使用してデモ・アプリケーションを実行する手順について説明します。この作業を行うには、次の2つの要件があります。

• 以下のいずれかであることを確認してください。

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

• ボードのデバッグ・インターフェースにスタンドアロンのJ-Linkポッドが接続されている。一部のハードウェア・プラットフォームでは、外部デバッグ・インターフェースで正常に機能させるためにハードウェアに変更を加える必要があることにご注意ください。

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

1. このボードはJ-Linkデバッグ・プローブをサポートしています。ご使用の前にSEGGERソフトウェアをインストールしてください。SEGGERからダウンロードできます

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

3. PCのターミナル・アプリケーション（PuTTY、Tera Termなど）を開き、デバッグのシリアル・ポート番号に接続します。次の設定値を用いてターミナルを設定します。

• ボーレート115200（board.hファイルのBOARD_DEBUG_UART_BAUDRATE変数を参照）

• パリティなし

• 8データ・ビット

• 1ストップ・ビット

• J-Link GDBサーバ・アプリケーションを開きます。SEGGERインストール・フォルダ（例えば、C:\Program Files (x86)\SEGGER\JLink_V632f）に移動します。デバッグおよびリリースのターゲットについては、ここでコマンド・ウィンドウを開き、「JLinkGDBServer.exe」コマンドを使用します。注：sdram_debugおよびsdram_releaseターゲットの場合は、次のコマンドを使用します。

   JLinkGDBServer.exescriptfile/boards/evkmimxrt1020/demo_apps/hello_world/
  evkmimxrt1020_sdram_init.jlinkscript

• 今回の例で選択されているターゲット・デバイスは、MIMXRT1021xxx5Aです。

  

• 接続すると、画面は次の図のようになります。

  

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

  

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

  /boards////armgcc/debug 
  

  /boards////armgcc/release
  

  今回の例の場合、実際のパスは次のようになります。

  /boards/evkmimxrt1020/demo_apps/hello_world/armgcc/flexspi_nor_debug

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

  

• 次のコマンドを実行します。

  「target remote localhost:2331」

  「monitor reset」

  「monitor halt」

  「load」

• アプリケーションがダウンロードされ、リセット・ベクタで停止します。「monitor go」コマンドを実行すると、デモ・アプリケーションが起動します。

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