2610 Custom Meta Tags

2503 Hero Banner

AMD製品に関連する技術ブログ

2610 Long Copy

<02_Yocto Projectソフトウェアコンポーネント作成> VivadoでKR260のハードウェアデザインを作って動かしてみた!Ver.2025.2版

2026-10-19

2610 Long Copy - body

はじめに

本記事はシリーズ記事の一部です。
以下の手順を順番に進めることで、Kria KR260 のハードウェアデザイン作成から Linux 実機動作までを一通り体験できます。

 本記事では、前回 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 プラットフォームの作成について解説します。

 

2503 Grid Box Light - Blog

ブログ

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

2503 Grid Box Light - Kria

Kria

Kria SOMはアダプティブSoCデバイスを搭載しており、スマートカメラやエンベデッドビジョンなどに最適です。

2610 2503 Link Side Box

AMD製品に関連する技術ブログ