はじめに
本記事はシリーズ記事の一部です。
以下の手順を順番に進めることで、Kria KR260 のハードウェアデザイン作成から Linux 実機動作までを一通り体験できます。
- 00_全体概要
- 01_XSAファイル生成
- 02_Yocto_Projectソフトウェアコンポーネント作成 (本記事)
- 03_Vitisプラットフォーム作成
- 04_Vitisアプリケーション作成
- 05_実機動作確認
本記事では、前回 Vivado で作成した XSA(Xilinx Support Archive)を入力として、Yocto Project による Linux イメージをビルドする手順を紹介します。
作業ディレクトリ
緑文字になっているディレクトリ、ファイルは本記事で作成します。
work/ ├─ kr260_custom_platform/ │ ├─ kr260_custom_platform.xsa │ └─ std_outdir/ └─ kr260_custom_plnx/ ├─ setupsdk ├─ sources/ └─ build/ ├─ conf/ │ └─ machine/ │ └─ kr26-sdt.conf └─ tmp/ └─ deploy/ └─ images/ └─ kr26-sdt/
Yocto 作業ディレクトリの作成
まず、Yocto 作業用のディレクトリを作成し、移動します。
mkdir kr260_custom_plnx cd kr260_custom_plnx
repo init(rel v2025.2)
AMD/Xilinx が提供している Yocto マニフェスト(rel v2025.2)を使用して、repo 管理の作業ディレクトリを初期化します。
repo init -u https://github.com/Xilinx/yocto-manifests.git -b rel-v2025.2

初回実行時には repo ツールのダウンロードや初期設定が行われます。
repo sync
repo init で指定したマニフェストに基づき、Yocto の全レイヤ(複数の Git リポジトリ)を取得・同期します。
repo sync

repo start
すべての repo 管理下リポジトリに対して、作業ブランチを作成します。
repo start rel-v2025.2 --all

Yocto ビルド環境の初期化
Yocto(PetaLinux ベース)のビルド環境を初期化します。
この操作により build ディレクトリが作成されます。
source setupsdk
初回実行時には、以下の設定ファイルが自動生成されます。
- conf/local.conf
- conf/bblayers.conf
System Device Tree(SDT)の生成
01_XSAファイル生成で作成した XSA を入力として、System Device Tree(SDT) を生成します。
コマンド
cd ../kr260_custom_platform/ sdtgen -xsa ./kr260_custom_platform.xsa -dir std_outdir -board_dts zynqmp-smk-kr26-reva -zocl enable
オプション説明
| オプション / 指定値 | 説明 |
|---|---|
-xsa ./kr260_custom_platform.xsa |
Vivado で生成したハードウェア定義(XSA)を指定 |
-dir std_outdir |
SDT の出力先 |
-board_dts zynqmp-smk-kr26-reva |
KR260(SMK-K26 RevA)用のボード DTSI を適用(PS 周辺、PHY、電源、I/O などのボード情報) |
-zocl enable |
XRT / ZOCL(FPGA カーネル用ドライバ)を使う前提の DT ノードを生成 |
build ディレクトリへ移動します。
cd build
既存 MACHINE での事前ビルド(切り分け)
まずは公式で提供されている MACHINE 定義を使い、clone した Yocto 環境が正常にビルドできることを確認します。
MACHINE=k26-smk-kr-sdt bitbake kria-image-full-cmdline
コマンドの説明
- MACHINE=k26-smk-kr-sdt
➡AMD 提供の KR260 用 MACHINE 設定を使用 - bitbake kria-image-full-cmdline
➡GUI なし・フル機能のコンソール向け Linux イメージを生成
※この手順により、「環境起因のエラー」と「カスタム設定起因のエラー」を切り分けやすくなります。
SDT から独自 MACHINE 定義を生成
生成した SDT を入力として、Yocto 用の新しい MACHINE 設定(kr26-sdt)を作成します。
コマンド
gen-machine-conf --hw-description ../../kr260_custom_platform/std_outdir/ parse-sdt -r include/k26-smk.inc -g full -O k26-smk-kr-sdt --config-dir conf/ --machine-name kr26-sdt
オプションについて
| オプション / 指定値 | 説明 |
|---|---|
--hw-description ../../kr260_custom_platform/std_outdir/ |
System Device Tree(SDT)の場所 |
parse-sdt |
System Device Tree(SDT)を入力として解析 |
-r include/k26-smk.inc |
Kria starter kit向けのリファレンス設定を読み込み |
-g full |
PLをLinux起動時にDevice Tree Overlayとしてロード |
-O k26-smk-kr-sdt |
"k26-smk-kr-sdt"をoverrideする |
--config-dir conf/ |
作成した設定ファイル出力先 |
--machine-name kr26-sdt |
作成するMACHINE設定 |
kr26-sdt.conf の修正
kr260_custom_plnx/build/conf/machine 以下にkr26-sdt.confが作成されるので、以下の赤枠部分を追記します。

これらの設定は主に以下を目的としています。
- QEMU 実行用設定の追加
- U-Boot / Linux Device Tree の指定
独自 MACHINE でのビルド
build ディレクトリに戻り、作成した kr26-sdt を指定してビルドを実行します。
MACHINE=kr26-sdt bitbake kria-image-full-cmdline
ビルド結果
ビルドは正常に完了しました。「kr260_custom_plnx/build/tmp/deploy/images/kr26-sdt」ディレクトリが生成されています。
一部 WARNING は出力されますが、今回は実機動作に影響しない内容です。

まとめ
本記事では、Vivado で作成した KR260 向け XSA を用い、Yocto Project(rel v2025.2)による Linux イメージのビルド手順を紹介しました。
System Device Tree(SDT)を生成し、gen-machine-conf を用いてハードウェア定義に基づく独自 MACHINE を作成する流れを確認しています。
次回 <03_vitisプラットフォーム作成> は、本環境を入力として Vitis プラットフォームの作成について解説します。

ブログ
AMDによる設計およびデバッグ手法のブログ、およびアヴネット社員によるAMD製品を用いた開発チャレンジのブログです。

Kria
Kria SOMはアダプティブSoCデバイスを搭載しており、スマートカメラやエンベデッドビジョンなどに最適です。
AMD製品に関連する技術ブログ
- <05_実機動作確認> VivadoでKR260のハードウェアデザインを作って動かしてみた!Ver.2025.2版
- <04_Vitisアプリケーション作成> VivadoでKR260のハードウェアデザインを作って動かしてみた!Ver.2025.2版
- <03_Vitisプラットフォーム作成> VivadoでKR260のハードウェアデザインを作って動かしてみた!Ver.2025.2版
- <02_Yocto Projectソフトウェアコンポーネント作成> VivadoでKR260のハードウェアデザインを作って動かしてみた!Ver.2025.2版
- <01_XSAファイル生成> VivadoでKR260のハードウェアデザインを作って動かしてみた!Ver.2025.2版
- <00_全体概要> VivadoでKR260のハードウェアデザインを作って動かしてみた!Ver.2025.2版
- エンジニアブログの再開およびテクニカルウェビナーのご案内
- 初心者のためのPython & Numpy入門
- KR260でIntel RealSenseを動かしてみた!
- Vitis HLSで足し算IPを作ってみた!(プログラミング編)
- KD240でモータ制御してみた!
- KR260でデジタル信号処理してみた! (3)
- KR260でデジタル信号処理してみた! (2)
- KR260でデジタル信号処理してみた! (1)
- KR260でロボットアームを動かしてみた! (2)
- KR260でロボットアームを動かしてみた! (1)
- KR260でROS2を使ってキャリブレーション&マーカー検出してみた!
- KR260とPynqでAIカメラを動かしてみた!
- KR260でROS2 Perception Stack Applicationを動かしてみた!【2】
- KR260でROS2 Perception Stack Applicationを動かしてみた!
- Kria SOMでTPM2.0を動かしてみた!
- VivadoでKR260のハードウェアデザインを作って動かしてみた!
- ROS2 Multi-Node Communications via TSNを動かしてみた!
- AIBOX-ReIDを動かしてみた!