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

i.MX Linuxボード・サポート・パッケージ (BSP) は、特定のi.MX開発プラットフォームで組込みLinuxイメージをブートするために使用されるバイナリ・ファイル、ソース・コード、およびサポート・ファイルの集まりです。

Linuxバイナリ・デモ・ファイルの現在のリリースは、Linuxダウンロード・ページにあります。その他のドキュメントは、i.MXソフトウェアおよび開発ツールのLinuxセクションにあるi.MX Linuxドキュメント・バンドルで入手できます。

2.1 概要

FRDM-IMX93は、eMMCおよびSDカードからのブートをサポートしています。

このスタート・ガイドでは、Linux BSPイメージをSDカードに書き込むいくつかの方法の概要を説明します。経験豊富なLinux開発者は、必要に応じて他のオプションを検討することができます。

2.2 NXP Linux BSPのビルド済みイメージのダウンロード

FRDM i.MX 93開発ボードには、FRDM-IMX93用の最新のビルド済みイメージが用意されています。

ビルド済みのNXP Linuxバイナリ・デモ・イメージは、プロセッサの使用および評価のための標準的なシステムと基本的な機能のセットを提供します。システムを変更する必要なしに、ユーザーはハードウェアのインターフェースを評価し、SoC機能をテストし、ユーザー空間のアプリケーションを実行できます。

2.3 Universal Update Utility (UUU) を使用したNXP Linux BSPイメージの書き込み

「パッケージの内容」セクションでの接続に加えて、適切なUSBケーブルを使用してUSB1をホスト・マシンに接続します。

ボードの電源を切ります。「1.5 ブート・スイッチの設定」セクションを参照し、シリアル・ダウンロード・プロトコル (SDP) モードでブートするようにボードを設定します。

ホスト・マシンで使用されているOSに応じて、Linux BSPイメージをSDカードに転送する方法は異なります。詳細な手順については、以下のオプションを選択してください。

12コピー$ chmod a+x uuu        
$ sudo ./uuu -b sd_all imx-image-full-imx93frdm.rootfs.wic.zst

1コピーuuu.exe -b sd_all imx-image-full-imx93frdm.rootfs.wic.zst

このセクションでは、FRDM-IMX93用Yocto BSPイメージをビルドする方法に加えて、Matterのサポートを追加する方法、およびDebianのリリース・イメージをビルドする方法の概要を説明します

3.1 FRDM-IMX93用Yocto BSP

FRDM-IMX93 BSPリリースは、Yocto Project 5.0 (Scarthgap) を使用したi.MX SW 2024 Q3リリースがベースとなっています。ソース・コードからFRDM-IMX93イメージをビルドするには、まずi.MX Yoctoプロジェクトのユーザー・ガイドをお読みになり、YoctoプロジェクトとYoctoのビルドについて理解してください。その後、以下の手順に従ってFRDM-IMX93用のイメージをビルドしてください。

1. i.MX SW 2024 Q3 BSPリリースのダウンロード：

12コピー$ repo init -u https://github.com/nxp-imx/imx-manifest -b imx-linux-scarthgap -m imx-6.6.36-2.1.0.xml
$ repo sync 

2. Yoctoコード・ベースへのFRDM-MX93レイヤの統合：

   12コピー$ cd ${MY_YOCTO}/sources
   $ git clone https://github.com/nxp-imx-support/meta-imx-frdm.git

3. Yocto Projectの設定：

   1コピー$ MACHINE=imx93frdm DISTRO=fsl-imx-xwayland source sources/meta-imx-frdm/tools/imx-frdm-setup.sh -b frdm-imx93 

4. イメージのビルド：

   1コピー$ bitbake imx-image-full 

5. SDカードのイメージの書き込み：

   1コピー$ zstdcat imx-image-full-imx93frdm.rootfs.wic.zst | sudo dd of=/dev/sdx bs=1M && sync 

   または、uuuを使用してSDカードにイメージを書き込む場合：

   1コピー$ uuu -b sd_all imx-image-full-imx93frdm.rootfs.wic.zst

6. ブート・スイッチSW1を「0011」に切り替えてSDカードのブートを選択したら、SDカードを挿入してFRDM-IMX93ボードの電源を入れます。

3.2 FRDM-IMX93でのMatterのサポート

FRDM-IMX93はMatterをサポートしています。Matterのサポートを追加するには、以下の手順に従ってYoctoのビルドにMatterのレイヤを含めてください。

1. i.MX SW 2024 Q3 BSPリリースのダウンロード：

12コピー$ repo init -u https://github.com/nxp-imx/imx-manifest -b imx-linux-scarthgap -m imx-6.6.36-2.1.0.xml
$ repo sync 

2. i.MX Matter Yoctoレイヤのダウンロード：

   123コピー$ cd ${MY_YOCTO}/sources/meta-nxp-connectivity
   $ git remote update
   $ git checkout imx_matter_2024_q3 

3. Yoctoコード・ベースへのFRDM-MX93レイヤの統合：

   12コピー$ cd ${MY_YOCTO}/sources
   $ git clone https://github.com/nxp-imx-support/meta-imx-frdm.git

4. Yocto Projectの設定：

   1コピー$ MACHINE=imx93frdm-iwxxx-matter DISTRO=fsl-imx-xwayland source sources/meta-imx-frdm/tools/imx-frdm-matter-setup.sh bld-xwayland-imx93

5. イメージのビルド：

1コピー$ bitbake imx-image-multimedia

3.3 FRDM-IMX93でのDebian

FRDM-IMX93はDebian 12 OSをサポートしています。i.MX Debian Linux SDKディストリビューションでは、NXPが提供するカーネルおよびブート・ローダとDebianディストリビューションのユーザー空間イメージが組み合わされており、これには以下のものが含まれています。

Debianに基づくrootfs
1. Debianベース（基本パッケージ）
2. Debianサーバ（GUIデスクトップを含まない、より多くのパッケージ）
3. Debianデスクトップ（GNOME GUIデスクトップを含む）
• Linuxカーネル
• BSPコンポーネント
• 各種アプリケーション（グラフィックス、マルチメディア、ネットワーク、コネクティビティ、セキュリティ、AI/ML）

NXPのDebian Linux SDKディストリビューションの詳細については、https://nxp.com/nxpdebianをご覧ください

Debianでのクイック・スタート

DebianでFRDM-IMX93用にSDカードを作成するには、以下の手順に従ってください。

1. Linuxホストにflexインストーラをダウンロードします。

123コピー$ wget http://www.nxp.com/lgfiles/sdk/lsdk2406/flex-installer
$ chmod +x flex-installer
$ sudo mv flex-installer /usr/bin

2. LinuxホストにSDカードを差し込み、以下のとおりにイメージをインストールします。

1234コピー# format SD card
$ flex-installer -i pf -d /dev/sdb
# automatically download and install images into SD card
$ flex-installer -i auto -d /dev/mmcblk1 -m imx93frdm

3. FRDM-IMX93ボードにSDカードを差し込み、以下のとおりに追加パッケージをインストールします。
   1. イーサネット・ネットワーク・インターフェースをDHCPで設定するか、手動で設定します。

   1コピー$ dhclient -i end0

   2. 例えば以下のように、正確なシステム時刻を設定します。

   1コピー$ date -s "22 Nov 2024 09:00:00"

   3. GNOME GUIデスクトップ・バージョン用の追加パッケージをインストールします。

   1コピー$ debian-post-install-pkg desktop

   4. または、GUIデスクトップを含まないサーバ・バージョン用の追加パッケージをインストールします。

   1コピー$ debian-post-install-pkg server

   5. インストールが完了したら、rebootコマンドを実行してDebianデスクトップまたはサーバ・システムを起動します

Flexbuildを使用したDebianイメージのビルド

Flexbuildを使用してFRDM-IMX93用のDebianイメージをビルドするには、以下の手順に従ってください。

1. ビルド環境の設定

   12345コピー$ git clone https://github.com/nxp/flexbuild
   $ cd flexbuild && ./setup.env
   #Continue to run commands below in case you need to build in Docker due to lack of Ubuntu 22.04 or Debian 12 host
   $ bld docker
   $ ./setup.env

2. Flexbuildを使用したイメージのビルド：

   1コピー$ bld -m imx93frdm

3. Flexbuildの使用：

   イメージの個々の部分をビルドするには、Flexbuildを使用するための以下のコマンド・リストを確認してください。

   123456789コピー$ bld uboot -m imx93frdm (compile u-boot image for imx93frdm)
   $ bld linux (compile linux kernel for all arm64 i.MX machines)
   $ bld bsp -m imx93frdm (generate BSP firmware)
   $ bld boot (generate boot partition tarball including kernel, dtb, modules, distro bootscript for iMX machines)
   $ bld multimedia (build multimedia components for i.MX platforms)
   $ bld rfs -r debian:base (generate Debian base rootfs with base packages)
   $ bld apps -r debian:server (compile apps against runtime dependencies of Debian server RootFS)
   $ bld merge-apps -r debian:server (merge iMX-specific apps into target Debian server RootFS)
   $ bld packrfs (pack and compress target rootfs)

シリアル通信コンソールの設定

Serial-to-USBドライバは、CH342F Linuxドライバ から入手できます。

Linuxホスト・マシンのコマンド・プロンプトで、次のコマンドを実行してポート番号を確認します。

1コピーls /dev/ttyCH343USB*

最初の番号はArm® Cortex®-A55用です。

Minicomチュートリアル

次のコマンドを使用して、シリアル通信プログラム（例：minicom）をインストールし、実行します。

1. Ubuntuパッケージ・マネージャを使用してMinicomをインストールします

1コピーsudo apt-get install minicom

2. 事前に確認したポート番号を使用して、コンソール・ウィンドウでMinicomを起動します

1コピーsudo minicom /dev/ttyCH343USB * -s


3. 図に示すようにMinicomを設定し、設定を終了します
4. 次のステップでブート・スイッチの設定を行います

シリアル通信コンソールの設定

FRDM-IMX93のWCH USBシリアル・チップは、2つのシリアル・ポートを列挙します。ポートがCOM11、COM12であるとします。最初のポート (COM11) はArm® Cortex®-A55からのシリアル・コンソール通信用です。Serial-to-USBドライバは、CH342F Windowsドライバ から入手できます。

注：i.MXボードの仮想COMポートのポート番号を確認するには、Windowsのデバイス・マネージャを開き、［ポート (COMとLPT)］でUSBシリアル・ポートを探します。

Tera Termチュートリアル

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

1. Tera Termをダウンロードします。ダウンロードしたら、インストーラを実行し、このウェブページに戻って手順を続行します
2. TeraTermを起動します。初めて起動する際には、次のダイアログが表示されます。［Serial（シリアル）］オプションを選択します。ボードが接続されている場合は、COMポートが自動的にリスト内に表示されます
3. 事前に確認したCOMポート番号を使用して、シリアル・ポートをボーレート115,200、8データ・ビット、パリティなし、1ストップ・ビットに設定します。この設定は［Setup（セットアップ）］→［Serial Port（シリアル・ポート）］から行うことができます
4. 接続が確立されているか検証します。確立されている場合、Tera Termのタイトル・バーに以下のように表示されます
5. 次のステップでブート・スイッチの設定を行います

シリアル通信コンソールの設定

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

1. PuTTYをダウンロードします。ダウンロードしたら、インストーラを実行し、このウェブページに戻って手順を続行します
2. 選択したダウンロードのタイプに応じて、ダウンロードした実行ファイルをダブルクリックするか、［Start（スタート）］メニューから選択して、PuTTYを起動します
3. 起動後に表示されるウィンドウで設定を行います。［Serial（シリアル）］ラジオ・ボタンを選択し、事前に確認したCOMポート番号を入力します。ボーレートもあわせて指定します。今回は115,200を入力します
4. ［Open（開く）］をクリックして、シリアル接続を確立します。ボードが接続されていて、正しいCOMポートが入力されていれば、ターミナル・ウィンドウが開きます。設定が正しくない場合は、アラートが表示されます
5. 次のステップでブート・スイッチの設定を行います

ボードに関するドキュメント

FRDM-IMX93の関連ドキュメントをこちらでご覧いただけます。

コミュニティ

• FRDM-IMX93コミュニティでのトレーニング