FRDM-MCXA156のスタート・ガイド

最新バージョンのMCUXpresso IDEには、ターミナル・エミュレーション・アプリケーションが含まれています。このツールは、NXP開発プラットフォームの仮想シリアル・ポートから送信された情報を表示するために使用できます。

1. MCUXpresso IDEを開きます

2. MCUXpresso IDEの画面上部にある［Open a Terminal（ターミナルを開く）］ボタンをクリックするか、［Ctrl + Alt + Shift + T］を同時に押して、MCUXpresso IDEターミナルを起動します

3. シリアル・ターミナルを選択します

4. シリアル・ポート（LPC-Link2のCOMポート番号を使用）をボーレート115,200、8データ・ビット、パリティなし、1ストップ・ビットに設定し、［OK］ボタンをクリックします

5. 接続が確立されているか検証します。接続されている場合、MCUXpresso IDEの［Terminal（端末）］ビューの表示は下図のようになります

6. 以上で設定は完了です

Tera Termは、広く利用されているオープン・ソースのターミナル・エミュレーション・アプリケーションです。このプログラムを使用して、NXP開発プラットフォームの仮想シリアル・ポートから送信された情報を表示できます。

1. SourceForgeからTera Termをダウンロードします。ダウンロードしたら、インストーラを実行し、このウェブページに戻って手順を続行します

ダウンロード

2. Tera Termを起動します。初めて起動する際には、次のダイアログが表示されます。［Serial（シリアル）］オプションを選択します。ボードが接続されている場合は、COMポートが自動的にリスト内に表示されます

3. 事前に確認したCOMポート番号を使用して、シリアル・ポートをボーレート115,200、8データ・ビット、パリティなし、1ストップ・ビットに設定します。この設定は［Setup（セットアップ）］->［Serial Port（シリアル・ポート）］から行うことができます
4. 接続が確立されているか検証します。確立されている場合、Tera Termのタイトル・バーに次のように表示されます

PuTTYは、広く利用されているターミナル・エミュレーション・アプリケーションです。このプログラムを使用して、NXP開発プラットフォームの仮想シリアル・ポートから送信された情報を表示できます。

1. 下のボタンをクリックしてPuTTYをダウンロードします。ダウンロードしたら、インストーラを実行し、このウェブページに戻って手順を続行します

ダウンロード

2. 選択したダウンロードのタイプに応じて、ダウンロードした*.exeファイルをダブルクリックするか、［Start（スタート）］メニューから選択して、PuTTYを起動します
3. 表示されたウィンドウで設定を行い、［Serial（シリアル）］ラジオ・ボタンを選択して、事前に確認したCOMポート番号を入力します。ボーレートもあわせて指定します。今回は115,200を入力します

4. ［Open（開く）］をクリックして、シリアル接続を確立します。ボードが接続されていて、正しいCOMポートが入力されていれば、ターミナル・ウィンドウが開きます。設定が正しくない場合は、アラートが表示されます

5. 以上で設定は完了です

次の手順に従ってhello_worldアプリケーションを開きます。以下の説明では、Cortex M33コアのコンパイルとデバッグの手順を取り上げています。

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

IAR Embedded Workbench for Arm 9.50.1以上を使用してください。

1. まず、事前にダウンロードしておいたFRDM-MCXA156 SDKパッケージを解凍します

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

   /boards////iar

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

4. プロジェクトを右クリックして［Options（オプション）］を選択し、プロジェクトのプロパティを開きます

5. ［Debugger（デバッガ）］セクションに移動し、デバッガ・ドライバを「CMSIS DAP」に変更します［OK］ボタンをクリックします

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

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


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

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

1. USBケーブルを使用して、PCを開発プラットフォームのJ21「MCU-Link USB」に接続します

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

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

5. Cortex-M33でhello_worldアプリケーションが実行されています

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

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

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

2. ［Pack Installer（パック・インストーラ）］ウィンドウで「MCXA」を検索し、MCXA1xxファミリを表示させます。そのMCXA1XXの名前をクリックすると、右側に「NXP: MCXA156_DFP pack」と表示されます。パックの横にある［Install（インストール）］ボタンをクリックします。このプロセスを正常に完了するには、インターネット接続が必要となります
3. インストールが完了したら、［Pack Installer（パック・インストーラ）］ウィンドウを閉じて、µVision IDEに戻ります

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

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

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

   /boards////mdk

2. ［Debug Configurations（デバッグの構成）］を選択します

3. プロジェクトを右クリックし、プロジェクトのオプションを選択します。

4. 次に、［Debug（デバッグ）］オプションに移動して、CMSIS-DAP ARMv8-M Debuggerを選択します。［OK］ボタンをクリックします

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

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

MCX Aファミリ・スタート・ガイド

前提条件

ここに記載されている例ではWindows 10を対象としていますが、MCUXpresso for Visual Studio CodeはMacOSおよびLinuxにも簡単にインストールできます。

• MCUXpresso for VS Codeの拡張機能向けのソフトウェア・インストール手順に従ってください
• FRDM-MCXA156用のMCUXpresso SDKをダウンロードまたは入手してください (SDK_2_16_000_FRDM-MCXA156.zip)

ハードウェアの要件

• FRDM-MCXA156
• Type-C USBケーブル × 1

ハードウェアの準備

このラボは、NXP MCX A評価キット (FRDM) を対象としています。キットにはデバイスの評価に役立つ、さまざまなペリフェラルが接続されています。これにはオンボードのデバッグ・プローブが含まれます。このデバッグ・プローブは、このラボ向けのCMSIS-DAPファームウェアが事前にプログラム済みです。このラボで各種サンプルのデバッグ・メッセージを表示するために、同じデバッグ・プローブを使用して、利用可能なCOMポートに接続します。

MCUXpresso for VS Codeを開く

1. Visual Studio Codeを開き、左側のパネルのMCUXpressoアイコン［x］をクリックします
2. 次のステップに進むには、下図に示している［Installed Repositories（インストールされたレポジトリ）］パネルをクリックします

NXP MCUXpresso SDKの追加

NXPの拡張機能により、Visual Studio Codeのワークスペースにソフトウェア・リポジトリを追加するためのツールが用意されています。ソフトウェア・リポジトリは、次の3つのソースから追加できます。

• GitのリモートURL
• NXPのMCUXpresso SDKアーカイブ・ファイル
• 既存のGitフォルダ

このセクションでは、前提条件として提供されているSDKアーカイブ・ファイルを使用して、MCX Aマイクロコントローラ用のMCUXpresso SDKをインポートします。

1. ［Installed Repositories（インストールされたレポジトリ）］パネルの［Import Repository（レポジトリのインポート）］ボタンをクリックします。このボタンは最初のリポジトリが追加される前に表示されます。今後、［Installed Repositories（インストールされたレポジトリ）］セクションの右上にある ［+］シンボルをクリックすることでリポジトリを追加できるようになる予定です

2. 提供されているMCX A SDKアーカイブ・ファイルをインポートするには、［Local Archive（ローカル・アーカイブ）］オプションを選択します
3. ［Archive（アーカイブ）］エントリ（［Downloads（ダウンロード）］フォルダ内）で、MCX A SDKファイルの場所を参照します
4. SDKを保存する共通の「保存先」となるフォルダを参照します（ここではC:\Users\NXP\Desktop\VSCODE_SDK）。新しいSDKの名前を入力します（ここではSDK_2_16_000_FRDM-MCXA156）

5. ［Import（インポート）］をクリックします。MCX A SDKがローカル・フォルダに展開され、［Installed Repositories（インストールされたリポジトリ）］パネルに追加されます

サンプル・プロジェクトのインポート

NXPの拡張機能により、開発者がプロジェクトをワークスペースにインポートできる［Projects（プロジェクト）］ペインが用意されています。新しいプロジェクトは、リポジトリ、既存のローカル・プロジェクト、アーカイブされたプロジェクトの3つのソースからインポートすることができます。このセクションでは、先ほど［Installed Repositories（インストールされたレポジトリ）］ パネルに追加したSDKからMCX Aのサンプルをインポートします。

1. ［Import Example from Repository（リポジトリからサンプルをインポート）］をクリックします。このボタンは、現在のワークスペースにプロジェクトがない場合に表示されます。今後、［Projects（プロジェクト）］セクションの右上にあるシンボルを使用して追加のプロジェクトをインポートできるようになる予定です。リポジトリのサンプルを追加するには、［II\］シンボルをクリックします。［+］シンボルをクリックして、MCUXpresso for VS Codeの拡張機能で事前に作成しておいたPC上のプロジェクトをインポートします。［］シンボルをクリックして、MCUXpresso for VS Codeの拡張機能で事前に作成しておいたアーカイブ・ファイル内のプロジェクトをインポートします

2. ［Import Example from Repository（リポジトリからサンプルをインポート）］ウィンドウに適切な情報を入力します。［Choose a Repository（リポジトリの選択）］をクリックし、利用可能なリポジトリまたはインストールされているリポジトリを一覧から選択します。SDK_2_16_000_FRDM-MCXA156を選択します
3. ［Choose a Toolchain（ツールチェーンの選択）］をクリックし、利用可能なビルド・ツールを一覧から選択します。MCUXpressoインストーラでは、デフォルトでgcc-arm-none-eabi-12.3.1を選択できます。このツールは、MCUXpresso IDEの他のデフォルトのインストール先も参照します。これらは、GNU Armツール・チェーンの代替オプションとして表示される場合があります。gcc-arm-none-eabi-12.3.1を選択します
4. ［Choose a Board（ボードの選択）］をクリックし、選択したリポジトリでサポートされているボードを表示します。ボード数が多い場合は、利用可能な選択領域に入力して絞り込むことができます。「FRDM-MCXA156」を選択します。ボードを選択するとボードの画像が表示されるため、選択が正しいかどうかを確認できます
5. ［Choose a Template（テンプレートの選択）］をクリックし、選択したリポジトリで利用可能なサンプルを表示します。サンプル数が多い場合は、利用可能な選択領域に入力して絞り込むことができます（例：「Hello」と入力してHello Worldのサンプルを絞り込む）。demo_apps/hello_worldを選択します

6. ［Location（場所）］フィールドの［Browse（参照）］をクリックします。新しく作成するプロジェクトのフォルダの場所を選択します
7. ［Create（作成）］をクリックします。これにより、MCX A用の新しい「Hello World」 サンプルが「Projects（プロジェクト）」パネルに追加されます

プロジェクトのビルド

ビルド・プロセスは、プロジェクトの作成時に構成されます。ユーザーは、［Project（プロジェクト）］ビューのアイコンを使用してビルドを開始できます。プロジェクト名の右側にあるビルド・アイコンをクリックすると、そのプロジェクトのビルドが開始されます。左側のナビゲーション・ペイン内の［X］アイコンをクリックして、MCUXpresso拡張機能の画面に戻る必要があります。前のセクションから、エクスプローラの画面のままになっているかもしれません。

1. hello_worldプロジェクトの右側にあるビルド・アイコンをクリックします。これにより、ビルド・プロセスが開始されます。画面下部の［Output terminal（出力ターミナル）］タブにビルドの進行状況が表示されます
2. あるいは、プロジェクト名を右クリックしてその他のビルド・オプションを表示することもできます。［Rebuild（リビルド）］または［Clean Build（ビルドのクリーン）］をクリックすると、過去のビルドのビルド・アーティファクトが削除されて、プロジェクトをリビルドできます。「Build Selected（選択済みをビルド）］をクリックした場合は、「no work to do（実行する作業はありません）」という出力が表示されます

終了コード0で完了すればビルド・プロセスは成功です。

プロジェクトのフラッシュおよびデバッグ

ユーザーはMCUXpresso for Visual Studio Codeを使って、NXPマイクロコントローラのプロジェクトのプログラムとデバッグを実行できます。その際には、デバッグ・プローブのドライバが正しくインストールされ、構成されている必要があります。MCUXpresso for Visual Studio Codeでは、NXP、SEGGER、PEmicroの一般的なデバッグ・プローブを使用できます。MCUXpressoインストーラには、さまざまなデバッグ・プローブのサポートを適切にインストールするためのオプションが用意されています。

ビルドされたプロジェクトで出力されたバイナリは、デバッグ・セッションが起動する前にターゲット・ボードにフラッシュされます。デバッグ・セッションでは、開発者がプロジェクトの動作を分析するのに役立つコントロールとビューが提供されます。次の手順では、MCX A FRDM評価キットを正常にフラッシュし、プログラムする方法を示します。

1. オンボード・デバッグ・プローブがPCのUSBポートに接続されていることを確認します
2. ［Debug Probes（デバッグ・プローブ）］ペインの更新矢印をクリックして、接続されているデバッグ・プローブを検出します


3. ビルドされたプロジェクトのイメージを使用してターゲット・デバイスをプログラミングすると、デバッグ・セッションが始まります。選択したプロジェクトの右側にある再生アイコン（一般的な三角形の再生アイコン）をクリックします

   

   Visual Studio Codeのデバッグ・セッションでは、ユーザーに別の［Run and Debug（実行とデバッグ）］画面が表示されます。これにより、左側のプライマリ・ナビゲーション・ペインで、バグ・アイコンがハイライト表示されます。主なツールについては、以下の図をご覧ください。

   1. デバッグの開始：ここからでもデバッグを起動できます
   2. デバッグの制御：一時停止、ステップ・オーバー、ステップ・イン、ステップ・アウト、再起動、停止
   3. 変数：ローカルとレジスタ
   4. ウォッチ：式を追加して監視を継続できます
   5. ブレークポイント：対象のコードの追加、切り替え、表示
   6. コール・スタック： プログラム内のアクティブなサブルーチンのリスト
   7. ステータス・リボン：画面下部のステータス・テキストが変化します/色がオレンジに変わります
   

1. J-Linkソフトウェアをダウンロードします。SEGGERのダウンロード・ページにアクセスします

2. 「J-Link Software and Documentation Pack（J-Linkソフトウェアおよびドキュメント・パック）」セクションを展開します

3. お使いのOSに対応するソフトウェアを選択し、最新版をダウンロードします

   

   規約に同意して、ソフトウェアをダウンロードします

4. ダウンロードした.exeファイルをダブルクリックして実行します。J-Linkのインストールが完了するまで、セットアップ手順に従って操作を進めます
5. 以上で設定は完了です