3-1-1. 新しい環境向け：Yocto 3.4 (honister) 以降のバージョン

# Set the MACHINE from "stratix10", "arria10", "cyclone5", "agilex7_xxx (ex. agilex7_dk_si_agf014ea)", or "agilex5" 
sed -i 's/^MACHINE .*=.*$/MACHINE = "arria10"/g' conf/local.conf
# Set the Path for download directory  
sed -i 's/#DL_DIR ?= "${TOPDIR}\/downloads"/DL_DIR = "${TOPDIR}\/..\/downloads"/g' conf/local.conf
# Use the LTS kernel and set version 
echo 'PREFERRED_PROVIDER_virtual/kernel = "linux-socfpga-lts"' >> conf/local.conf
echo 'PREFERRED_VERSION_linux-socfpga-lts = "6.1.%"' >> conf/local.conf
# Use systemd 
echo 'DISTRO_FEATURES:append = " systemd usrmerge"' >> conf/local.conf
echo 'VIRTUAL-RUNTIME_init_manager = "systemd"' >> conf/local.conf
# Build additional rootfs type 
echo 'IMAGE_FSTYPES += "jffs2 tar.gz"' >> conf/local.conf
# Ensure we build in all kernel-modules 
echo "MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS += \"kernel-modules\"" >> conf/local.conf
# Other settings 
echo 'INHERIT += "rm_work"' >> conf/local.conf
echo 'DEPLOY_DIR = "${TOPDIR}/../deploy"' >> conf/local.conf
echo 'BB_GENERATE_MIRROR_TARBALLS = "1"' >> conf/local.conf
echo 'BB_DANGLINGAPPENDS_WARNONLY = "1"' >> conf/local.conf
echo 'DISTRO_FEATURES:remove = "ptest"' >> conf/local.conf
echo 'IMAGE_FSTYPES:remove = "multiubi"' >> conf/local.conf
echo 'INHERIT += "archiver"' >> conf/local.conf
echo 'ARCHIVER_MODE[src] = "original"' >> conf/local.conf
echo 'COPY_LIC_MANIFEST = "1"' >> conf/local.conf
echo 'COPY_LIC_DIRS = "1"' >> conf/local.conf
echo 'LICENSE_CREATE_PACKAGE = "1"' >> conf/local.conf

3-1-2. 古い環境向け：Yocto 3.3.x (hardknott) 以前のバージョン

# Set the MACHINE from agilex, stratix10, arria10, or cyclone5" 
sed -i 's/^MACHINE .*=.*$/MACHINE = "arria10"/g' conf/local.conf
# Set the Path for download directory  
sed -i 's/#DL_DIR ?= "${TOPDIR}\/downloads"/DL_DIR = "${TOPDIR}\/..\/downloads"/g' conf/local.conf
# Use the LTS kernel and set version 
echo 'PREFERRED_PROVIDER_virtual/kernel = "linux-socfpga-lts"' >> conf/local.conf
echo 'PREFERRED_VERSION_linux-socfpga-lts = "5.4.104%"' >> conf/local.conf
# Use systemd 
echo 'DISTRO_FEATURES_append = " systemd"' >> conf/local.conf
echo 'VIRTUAL-RUNTIME_init_manager = "systemd"' >> conf/local.conf
# Build additional rootfs type 
echo 'IMAGE_FSTYPES += "jffs2 tar.gz"' >> conf/local.conf
# Ensure we build in all kernel-modules 
echo "MACHINE_ESSENTIAL_EXTRA_RRECOMMENDS += \"kernel-modules\"" >> conf/local.conf
# Other settings 
echo 'INHERIT += "rm_work"' >> conf/local.conf
echo 'DEPLOY_DIR = "${TOPDIR}/../deploy"' >> conf/local.conf
echo 'BB_GENERATE_MIRROR_TARBALLS = "1"' >> conf/local.conf
echo 'BB_DANGLINGAPPENDS_WARNONLY = "1"' >> conf/local.conf
echo 'DISTRO_FEATURES_remove = "ptest"' >> conf/local.conf
echo 'INHERIT += "archiver"' >> conf/local.conf
echo 'ARCHIVER_MODE[src] = "original"' >> conf/local.conf
echo 'COPY_LIC_MANIFEST = "1"' >> conf/local.conf
echo 'COPY_LIC_DIRS = "1"' >> conf/local.conf
echo 'LICENSE_CREATE_PACKAGE = "1"' >> conf/local.conf

ここでは、主に以下の指定をおこなっています。

・MACHINE ： ビルドターゲットとする機種を指定。
　（SoC FPGA の場合は、cyclone5 / arria5 / arria10 / stratix10 / agilex から選択します）
　　※バージョン 4.1 (langdale) 以降で agilex をターゲットとする場合は、複数の選択肢から機種を選んで指定する必要があります。
　　【バージョン 4.1 (langdale) 向け】
　　　- agilex_fm61 ... Intel Agilex® 7 FPGA F-Series Transceiver-SoC Development Kit (P-Tile and E-Tile)
　　　- agilex_fm86 ... Intel Agilex® 7 FPGA F-Series Development Kit (2x F-Tile)
　　　- agilex_fm87 ... Intel Agilex® 7 FPGA I-Series Transceiver-SoC Development Kit (4x F-Tile)
　　【バージョン 4.2 (mickledore) 以降向け】
　　　- agilex7_dk_si_agf014ea/agf014eb ... Intel Agilex® 7 FPGA F-Series Transceiver-SoC Development Kit (P-Tile and E-Tile)
　　　- agilex7_dk_si_agi027fa/agi027fb ... Intel Agilex® 7 FPGA I-Series Transceiver-SoC Development Kit (4x F-Tile)
　　　- agilex7_dk_dev_agf027f1es ... Intel Agilex® 7 FPGA F-Series Development Kit (2x F-Tile)
　　　- agilex7_dv_dev_agm039fes ... Intel Agilex® 7 FPGA M-Series Development Kit - HBM2e Edition (3x F-Tile & 1x R-Tile)

　　MACHINE に指定可能な文字列は meta-intel-fpga レイヤーの conf/machine 以下に格納されているファイル名で決まります。
　　実際の内容は以下のリンク先を参照ください。ページ右上のプルダウンおよび switch ボタンより Yocto バージョンも選択できます。 
　　 machine « conf - meta-intel-fpga - Layer containing Intel SoCFPGA hardware support metadata (yoctoproject.org)

・PREFERRED_PROVIDER_virtual/kernel, PREFERRED_VERSION_linux-socfpga-lts ： Linux カーネルバージョンの指定。
　（ meta-intel-fpga/recipes-kernel 以下のレシピからビルド対象のカーネルバージョンを選択します）

・DISTRO_FEATURES:append, VIRTUAL-RUNTIME_init_manager ： Linux の起動・システム管理に "systemd" を使用するための指定。

・IMAGE_FSTYPES  ： 生成するファイルシステムの形式を指定。

　※補足： 3-1-1. 新しい環境向けの手順では local.conf に「IMAGE_FSTYPES:remove = "multiubi"」を指定することで UBIFS を生成しないように変更しています。
　　生成されるイメージサイズが大きい場合に UBIFS のサイズ超過によるエラーが発生することを抑止する目的で変更しているため、UBIFS を生成したい場合には該当の記述を削除してください。

以下のオプションは、作業ディレクトリー以下の構成を整理するために指定しているものです。（任意）

・DL_DIR ： ビルド実行時に Fetch （ダウンロード）されるファイルの格納先を指定。

・DEPLOY_DIR ： ビルド実行の結果、生成されるイメージの格納先を指定。

その他のオプションについても必須の内容ではないので、気になる場合は Yocto 公式ドキュメントを調べてみてください。

3-2-1. 新しい環境向け：Yocto 3.4 (honister) 以降のバージョン（ U-Boot および ATF の設定）

echo 'PREFERRED_PROVIDER_virtual/bootloader = "u-boot-socfpga"' >> conf/local.conf
echo 'PREFERRED_VERSION_u-boot-socfpga = "v2023.04%"' >> conf/local.conf
echo 'PREFERRED_VERSION_arm-trusted-firmware = "v2.9"' >> conf/local.conf
echo 'require conf/machine/arria10-gsrd.conf' >> conf/local.conf
# Set the UBOOT_CONFIG:xx from MACHINE-socdk-atf (ex. "stratix10-socdk-atf") or MACHINE-socdk (ex. "cyclone5-socdk"). 
# xx is MACHINE Name (ex. "agilex7_dk_si_agf014ea"). 
echo 'UBOOT_CONFIG:arria10 = "arria10-socdk"' >> conf/local.conf
echo 'IMAGE_TYPE:arria10 = "gsrd"' >> conf/local.conf

2024年2月現在、Yocto 4.3 (nanbield) を使用して Arria® 10 もしくは Stratix® 10 をターゲットにする場合は以下の設定もおこなってください。

echo 'EXTRA_IMAGEDEPENDS:remove:arria10 = "u-boot-socfpga-env"' >> conf/local.conf
echo 'EXTRA_IMAGEDEPENDS:remove:stratix10 = "u-boot-socfpga-env"' >> conf/local.conf

Yocto 4.1 (langdale) もしくは Yocto 4.2 (mickledore) を使用して Cyclone® V をターゲットにする場合には以下の設定もおこなってください。

この設定（RBO_RELEASE_VER）では、Rocketboards.org の Release サイトにある rbf-source フォルダーの所在を指定しています。"2022.10" の指定により Index of /2022.10/rbf-source/ (rocketboards.org) にある FPGA コンフィギュレーションデータ(.rbf) を使用します。※Yocto 4.3 (nanbield) ではこの設定は不要です。

echo 'RBO_RELEASE_VER:cyclone5 = "2022.10"' >> conf/local.conf

3-2-2. 古い環境向け：Yocto 3.3.x (hardknott) 以前のバージョン（ U-Boot および ATF の設定）

echo 'PREFERRED_PROVIDER_virtual/bootloader = "u-boot-socfpga"' >> conf/local.conf
echo 'PREFERRED_VERSION_u-boot-socfpga = "v2021.01%"' >> conf/local.conf
echo 'PREFERRED_VERSION_arm-trusted-firmware = "v2.4%"' >> conf/local.conf
echo 'require conf/machine/arria10-extra.conf' >> conf/local.conf
# Set the UBOOT_CONFIG from "agilex-socdk-atf", "stratix10-socdk-atf", "arria10-socdk", or "cyclone5-socdk" 
echo 'UBOOT_CONFIG = "arria10-socdk"' >> conf/local.conf
echo 'IMAGE_TYPE = "gsrd"' >> conf/local.conf

ここでは、主に以下の指定をおこなっています。

・PREFERRED_PROVIDER_virtual/bootloader, PREFERRED_VERSION_u-boot-socfpga ： U-Boot バージョンの指定。
　（ meta-intel-fpga/recipes-bsp/u-boot 以下のレシピからビルド対象の U-Boot バージョンを選択します）

・PREFERRED_VERSION_arm-trusted-firmware ： ATF バージョンの指定。
　（ meta-intel-fpga/recipes-bsp/arm-trusted-firmware 以下のレシピからビルド対象の ATF バージョンを選択します）

・require conf/machine/xxxx-extra.conf (xxxx-gsrd.conf) ： ブートローダー関連の設定を含む拡張コンフィグファイルを指定。

・UBOOT_CONFIG ： U-Boot ビルド時の defconfig の選択などに使用されます。
  （ "agilex7_dk_si_agf014ea-socdk-atf", "stratix10-socdk-atf", "arria10-socdk", "cyclone5-socdk" から選択します。その他の選択肢はレシピの記述を参照ください。）

・IMAGE_TYPE ： 評価ボード用のリファレンスデザイン（Golden System Reference Design）向けには "gsrd" を指定。
　（ 通常は "gsrd" を指定してください。その他のデザインをターゲットにする場合に "gsrd" 以外を指定する場合があります。）