目次
はじめに
この記事では MCUXpresso for Visual Studio Code を使用した以下の内容を説明しています。
・ MCUXpresso SDK のインポート
・ MCUXpresso SDK から Hello World アプリケーション Example プロジェクトのインポート
MCUXpresso for Visual Studio Code は事前にダウンロード&インストール済みとして説明を進めます。
参考: まだインストールがお済でない場合は、以下の記事ページを参考にインストールしておいてください。
[VS Code で NXP マイコン開発 1] MCUXpresso for Visual Studio Code のインストール方法
参考: 最新の MCUXpresso for Visual Studio Code ドキュメントは以下のページをご参照ください。
MCUXpresso for VS Code documentation
参考: この記事では Development Board として FRDM-MCXN947 を例として説明しています。
MCX N94/N54 MCU 用 FRDM 開発ボード - FRDM-MCXN947
注記:
SDK をうまくインストールできない等が発生した場合は、MCUXpresso for Visual Studio Code に関連する各種ツールが最新バージョンになっているか確認し、最新バージョンをインストールください。
MCUXpresso for Visual Studio Code の “QUICKSTART PANEL” にある “Open MCUXpresso Installer” をクリックして、MCUXpresso Installer から最新バージョンをインストールします。
① "Check for newer version of components" アイコンをクリックすると、最新バージョンのコンポーネントがあるかを確認します
② "Up to date" アイコンをクリックすると、最新バージョンのコンポーネントがあれば更新インストールします
最新バージョンのコンポーネントがインストールされると、 [info] Latest MCUXpresso Installer version is installed メッセージが表示されます。
【図1】 MCUXpresso Installer を使用した最新バージョンのコンポーネントの更新インストール
なお、この記事の執筆当時(2026年1月)に使用したバージョンは下表の通りです。
【表1】 この記事で使用したコンポーネントのバージョン
項番 |
コンポーネント名 |
バージョン |
概要 |
|---|---|---|---|
1 |
MCUXpresso SDK Developer | 25.12 | MCUXpresso SDK 開発に必要なツール |
2 |
Arm GNU Toolchain | 14.2.1 | Arm GNU ツールチェーンとそれを使って構築された追加の NXP ライブラリ |
3 |
Standalone Toolchain Add-ons | 14.2.2 | Arm GNU ツールチェーン用の NXP ライブラリとヘッダーファイル |
4 |
MCUXpresso Configuration Tools | 25.12 | MCU の PIN、Clock、Peripheral の設定を GUI 行う Tool |
5 |
MCUXpresso Secure Provisioning Tool | 25.12 | Boot Image 生成、 Flash Programming 機能などを兼ね備えた Tool |
注記:この記事では MCUXpresso SDK リポジトリを対象にインポート方法を説明しています。
参考: MCUXpresso SDK リポジトリのインストールについては、以下の MCUXpresso SDK の関連ドキュメントを参照してください。
Working with MCUXpresso SDK
参考: この記事の説明対象外ですが、Zephyr リポジトリのインストールについては、以下の Zephyr 関連ドキュメントに従ってください。
Working with Zephyr
1. MCUXpresso SDK のインポート
NXP の MCUXpresso SDK は、同社のマイクロコントローラ(MCU)向けに開発を簡素化・加速するための包括的なソフトウェア開発キット(SDK)です。
高品質なドライバ、ミドルウェア、RTOS、リファレンス・ソフトウェア、サンプルコードなどを統合し、MCUXpresso for Visual Studio Code などのツールと連携して、効率的な組み込みシステム開発を支援しています。
この章では MCUXpresso for Visual Studio Code に MCUXpresso SDK をインポートする方法を説明します。
1-1. MCUXpresso SDK のインポート
1-1-1. SDK インポート先の準備
この記事の説明では、以下のようなインポート先フォルダーを準備しておきます(※ 以下のフォルダー名とパスは一例です)。
・ C:\nxp\MCUXpresso-VSC (MCUXpresso for VS Code のトップフォルダー)
・ C:\nxp\MCUXpresso-VSC\sdk (SDK のインポート・フォルダー)
【図2】 SDK インポート先フォルダーを準備
1-1-2. SDK のインポート先の指定
(1) MCUXpresso for Visual Studio Code の “IMPORTED REPOSITRIES” にある + ボタン(Import Local/Remote Repository)をクリックします。
【図3】 Import Repository を開く
注記:
大きな青い [Import repository] ボタンは、最初のリポジトリがワークスペースにインポートされるまでのみ使用できます。
【図4】 初回のみ表示される 大きな青い [Import repository] ボタン
(2) "Import Repository" ビューが開いたら "REMOTE ARCHIVE" タブを選択し、Location: 項目にある [Browse] ボタンをクリックします。
【図5】 “REMOTE ARCHIVE” タブ の Location: 項目にある [Browse] ボタンをクリック
(3) 『1-1-1. SDK インポート先の準備』 のセクションで準備しておいた C:\nxp\MCUXpresso-VSC\sdk フォルダーに移動して [新しいフォルダー] をクリックします。
【図6】 [新しいフォルダー] をクリック
(4) この記事で使用する FRDM-MCXN947 Development Board 用として n947 フォルダーを作成します。
(5) 作成した C:\nxp\MCUXpresso-VSC\sdk\n947 フォルダーに移動して [フォルダーの選択] をクリックします。
【図7】 n947 フォルダーを作成して [フォルダーの選択] をクリック
(6) "Import Repository" ビューに戻り "REMOTE ARCHIVE" タブの Location: が C:\nxp\MCUXpresso-VSC\sdk\n947 になっていることを確認します。
【図8】 Location: が設定したフォルダーになっていることを確認
1-1-3. 使用する Development Board の SDK を選択しインポート
(1) "Import Repository" ビュー "REMOTE ARCHIVE" タブの Package: 欄から、ご所望の Development Board の SDK を選択できます。例えば Package: 欄に n947 と入力すると、Version: 欄に FRDM-MCXN947 が表示されるので、それを選択します。
【図9】 Package: 欄から所望の Development Board の SDK を選択(例: FRDM-MCXN947)
(2) Boards に FRDM-MCXN947 Development Board の画像が表示されます。Name: 欄と Location: 欄が正しいことを確認します。
(3) "Create Git repository" は不要なのでチェックボックスをオフにします。
(4) MCUXpresso SDK ライセンス規約に同意する場合は "I agree" にチェックを入れて、[Import] ボタンをクリックするとインポートが開始します。
【図10】 “I agree” にチェックを入れて [Import] をクリックしてインポート開始
(5) Import が完了すると 『Repository successfully imported』 の表示が出るので閉じます。
【図11】 『Repository successfully imported』 の表示が出たら閉じる
(6) “IMPORTED REPOSITRIES” の下に MCUXpresso SDK Repository (c:\nxp\MCUXpresso-VSC\sdk\n947\frdm_mcxn947) が追加されています。
【図12】 追加された FRDM-MCXN947 Development Board 向け MCUXpresso SDK Repository
これで MCUXpresso SDK のインポートは完了です。
2. MCUXpresso SDK から Hello World アプリケーション Example をインポート
(1) “IMPORTED REPOSITRIES” の下にあるインポート済みの MCUXpresso SDK Repository を右クリックして、表示されたメニューから “Import Example Application from an Imported Repository” を選択します。
【図13】 “Import Example Application from an Imported Repository” を選択
(2) “Import Example from Repository” ビューが開きます。
【図14】 “Import Example from Repository” ビュー
参考: “Import Example from Repository” ビューには、以下のような入力フィールドがあります:
・ Repository
インポートしたソースリポジトリから選択します(MCUXpresso、Zephyr、またはカスタムリポジトリを選択できます)。
・ Board
ここにリストされているボード(選択したリポジトリ内で利用可能なもの)を選択します。
・ Template
上記で選択した Repository/Board で利用可能なプロジェクトテンプレートのリストです。
・ App type
アプリケーションの種類を選択します。
・ Name
プロジェクト名。これはワークスペースで参照されます。プロジェクト名がすでに存在する場合はエラーが表示されます。
・ Location
プロジェクトのパス。パスが存在しない場合は作成されます。このフィールドは、アプリケーションがリポジトリに保存されていない限り使用できます。
・ Toolchain
すでにインストールされているツールチェーンの1つを選択します。
・ Open readme file after project is imported
チェックを入れると、Example の readme ファイルが存在する場合に、[Import] ボタン押下後に readme ファイルが開きます。このオプションはデフォルトでオフになっています。
(3) “Repository:” に、インポート済みの SDK リポジトリのパスが設定されていることを確認します(この記事では FRDM-MCXN947 SDK)。
(4) “App type:” に、アプリケーションの種類が指定されていることを確認します。
(5) “Toolchain:” に、インストールされているツールチェーンが指定されていることを確認します。
【図15】 “Import Example from Repository” ビューの設定 (1)
参考: 選択したリポジトリの種類に応じて “App type:” には以下のアプリケーションの種類が利用可能です:
・ Repository application
アプリケーションはリポジトリフォルダ内に直接配置されます(サンプルのソースコードはコピーされません)。
・ Freestanding application
サンプルのソースコードはコピー先フォルダにコピーされます。
・ Workspace application
プロジェクトはリポジトリ・ワークスペース内にあります(詳細は「Zephyr Application Development 」をご参照ください)。
・ Standalone application
プロジェクトは自己完結型で、リポジトリから独立しています。
【表2】 選択した Repository の種類に応じて “App type:” に設定可能なアプリケーションの種類
| Repository Type | Application Type | |||
|---|---|---|---|---|
| Repository | Freestanding | Workspace | Standalone | |
| MCUXpresso SDK 2.x | ✓ | |||
| MCUXpresso SDK 24.12 to 25.09 | ✓ | ✓ | ||
| MCUXpresso SDK 25.12 and newer | ✓ | ✓ | ✓ | |
| Zephyr | ✓ | ✓ | ✓ | |
| Matter | ✓ | ✓ | ||
注記:Standalone application は現在試験運用中となり、有効化するには、 Settings->Extensions->MCUXpresso for VS Code and check the “Enable Standalone Projects” チェックボックスをオンにする必要があります
(6) “Board:” で、プルダウンから使用するボードを選択します(この記事では FRDM-MCXN947)。
【図16】 “Import Example from Repository” ビューの設定 (2)
(7) “Template:” の検索窓に、アプリケーション Example 名(キーワード)を入力します(この記事では hello と入力) 。
リストされた中から所望の Example を選択します(この記事では frdmmcxn947_hello_world_cm33_core0)。
【図17】 “Import Example from Repository” ビューの設定 (3)
(8) 必要に応じて “Open readme file after project is imported” のチェックボックスにチェックを入れると、[Import] ボタンを押した後に Example の readme ファイルが開きます(デフォルトはオフです)。
(9) [Import] ボタンをクリックすると、アプリケーション Example のインポートが実行されます。
【図18】 アプリケーション Example のインポートを実行
(10) 『Do you trust the authors of the files in this folder?』 の表示が出た場合は、[Yes] ボタンをクリックします。
【図19】 『このフォルダ内のファイルの作成者を信頼しますか?』の確認メッセージ
(11) “Open readme file after project is imported” のチェックボックスにチェックを入れた場合は、Example の readme ファイルが開きます。
【図20】 オープンした readme ファイル
(12) “PROJECTS” の下にインポートされたアプリケーション Example プロジェクトがあることを確認します。
【図21】 “PROJECTS” 下にインポートしたアプリケーション Example を確認
これでアプリケーション Example プロジェクトのインポートは完了です。
おわりに
この記事では、使用する Development Board 向けの MCUXpresso SDK と、アプリケーション Example プロジェクトをインポートする方法について説明しました。Hello World 以外にも様々な Example が用意されていますので選択してお試しください。
冒頭の 「はじめに」 の注記に記載した通り、うまくインストールできない場合は MCUXpresso IDE を最新バージョンにアップデートしてみてください。
サンプル・プロジェクトの Build と Debug 方法については、次の記事をご覧ください。