設定 - Yocto - 版の履歴

Wiki: /* 依存関係のパッケージのインストール */

2026-01-30T16:33:03Z

依存関係のパッケージのインストール

← 古い版		2026年1月31日 (土) 01:33時点における版
78行目:		78行目:
	Yocto Projectを使用するには、以下に示すパッケージをインストールする。<br>		Yocto Projectを使用するには、以下に示すパッケージをインストールする。<br>
	# RHEL		# RHEL
	~~## サブスクリプションの登録~~
	~~sudo subscription-manager register --username=<your-username> --password=<your-password>~~

	~~## サブスクリプションのアタッチ~~
	~~sudo subscription-manager attach --auto~~

	## CRBリポジトリの有効化		## CRBリポジトリの有効化
	## 開発に必要なパッケージはCodeReady Linux Builder(CRB)リポジトリに含まれているため		## 開発に必要なパッケージはCodeReady Linux Builder (CRB) リポジトリに含まれているため
	sudo subscription-manager repos --enable codeready-builder-for-rhel-10-$(arch)-rpms		sudo subscription-manager repos --enable codeready-builder-for-rhel-10-$(arch)-rpms

113行目:		107行目:
	<br>		<br>
	BitBakeの実行にはPythonの追加パッケージが必要である。<br>		BitBakeの実行にはPythonの追加パッケージが必要である。<br>
	~~# Python関連パッケージ~~		# RHEL
	## RHEL
	sudo dnf install python3-pexpect python3-jinja2 python3-subunit \		sudo dnf install python3-pexpect python3-jinja2 python3-subunit \
	python3-pip python3-GitPython python3-distro		python3-pip python3-GitPython python3-distro
134行目:		127行目:
	libz1-32bit libncurses6-32bit libreadline8-32bit		libz1-32bit libncurses6-32bit libreadline8-32bit
	<br>		<br>

	==== ロケール設定の確認 ====		==== ロケール設定の確認 ====
	ロケール設定が正しく行われているかどうかを確認する。<br>		ロケール設定が正しく行われているかどうかを確認する。<br>

Wiki: /* 標準レイヤの構造分析 */

2026-01-30T16:29:45Z

標準レイヤの構造分析

← 古い版		2026年1月31日 (土) 01:29時点における版
203行目:		203行目:
	├── classes/ # BitBakeクラス (base.bbclass、image.bbclass等)		├── classes/ # BitBakeクラス (base.bbclass、image.bbclass等)
	├── conf/ # 基本設定ファイル		├── conf/ # 基本設定ファイル
	│ ├── bitbake.conf # BitBakeのグローバル設定		│ ├── bitbake.conf # BitBakeのグローバル設定
	│ └── machine/ # 汎用マシン設定		│ └── machine/ # 汎用マシン設定
	├── recipes-core/ # init、busybox、base-files等		├── recipes-core/ # init、busybox、base-files等
	├── recipes-kernel/ # Linuxカーネル関連		├── recipes-kernel/ # Linuxカーネル関連
214行目:		214行目:
	├── conf/		├── conf/
	│ └── distro/		│ └── distro/
	│ └── poky.conf # Pokyディストロ設定		│ └── poky.conf # Pokyディストロ設定
	└── recipes-core/ # Poky固有のレシピ		└── recipes-core/ # Poky固有のレシピ
	<br>		<br>

Wiki: /* 開発環境の構築 */

2026-01-30T16:29:03Z

開発環境の構築

← 古い版		2026年1月31日 (土) 01:29時点における版
131行目:		131行目:

	# SUSE		# SUSE
			sudo zypper install glibc-32bit libgcc_s1-32bit libstdc++6-32bit \
			libz1-32bit libncurses6-32bit libreadline8-32bit
	<br>		<br>
	==== ロケール設定の確認 ====		==== ロケール設定の確認 ====
145行目:		146行目:
	export LC_ALL=en_US.UTF-8		export LC_ALL=en_US.UTF-8
	<br>		<br>
	~~上記の環境変数は~~~/.profileファイル等に設定することを推奨する。<br>		上記の環境変数は、~/.profileファイル等に設定することを推奨する。<br>
	<br>		<br>
	==== SELinuxの設定 ====		==== SELinuxの設定 ====
	~~ビルド中にSELinuxが問題を引き起こす場合があるため、必要に応じてPermissiveモードに設定する。~~<br>		SELinuxを使用している場合、ビルド中にSELinuxが問題を引き起こす場合があるため、必要に応じてPermissiveモードに設定する。<br>
	# 現在のSELinux状態の確認		# 現在のSELinux状態の確認
	getenforce		getenforce

Wiki: /* ディレクトリ構成 */

2026-01-30T16:27:47Z

ディレクトリ構成

← 古い版		2026年1月31日 (土) 01:27時点における版
14行目:		14行目:
	==== ディレクトリ構成 ====		==== ディレクトリ構成 ====
	~/yocto-project/		~/yocto-project/
	├── poky/ # Yocto Project Poky		├── poky/ # Yocto Project Poky
	│ ├── meta/ # OpenEmbedded-Core		│ ├── meta/ # OpenEmbedded-Core
	│ ├── meta-poky/ # Pokyディストロ設定		│ ├── meta-poky/ # Pokyディストロ設定
	│ └── meta-yocto-bsp/ # リファレンスBSP		│ └── meta-yocto-bsp/ # リファレンスBSP
	├── meta-custom-distro/ # カスタムレイヤ		├── meta-custom-distro/ # カスタムレイヤ
	│ ├── conf/		│ ├── conf/
	│ │ ├── layer.conf # レイヤ設定		│ │ ├── layer.conf # レイヤ設定
	│ │ ├── machine/ # マシン設定		│ │ ├── machine/ # マシン設定
	│ │ └── distro/ # ディストロ設定		│ │ └── distro/ # ディストロ設定
	│ ├── recipes-core/ # コアレシピ		│ ├── recipes-core/ # コアレシピ
	│ │ ├── images/ # イメージレシピ		│ │ ├── images/ # イメージレシピ
	│ │ ├── packagegroups/ # パッケージグループ		│ │ ├── packagegroups/ # パッケージグループ
	│ │ └── base-files/ # base-files拡張		│ │ └── base-files/ # base-files拡張
	│ ├── recipes-apps/ # アプリケーションレシピ		│ ├── recipes-apps/ # アプリケーションレシピ
	│ └── recipes-kernel/ # カーネル関連		│ └── recipes-kernel/ # カーネル関連
	└── build/ # ビルドディレクトリ		└── build/ # ビルドディレクトリ
	├── conf/		├── conf/
	│ ├── local.conf # ローカル設定		│ ├── local.conf # ローカル設定
35行目:		35行目:
	└── tmp/		└── tmp/
	└── deploy/		└── deploy/
	├── images/ # 生成イメージ		├── images/ # 生成イメージ
	└── sdk/ # SDK		└── sdk/ # SDK
	<br>		<br>

	==== レイヤの概念 ====		==== レイヤの概念 ====
	レイヤは、関連するレシピ、設定、クラスをグループ化したものである。<br>		レイヤは、関連するレシピ、設定、クラスをグループ化したものである。<br>

Wiki: ページの作成:「== 概要 == Yocto Projectは、組み込みLinuxシステムのカスタムディストリビューションを構築するためのオープンソースプロジェクトである。

Yocto Projectは、以下の主要なコンポーネントで構成される。
* Poky : Yocto Projectのリファレンスディストリビューションであり、ビルドシステムの基盤となる。 BitBake *: Pythonで実装されたタスク実行エン…」

2026-01-30T16:26:52Z

ページの作成:「== 概要 == Yocto Projectは、組み込みLinuxシステムのカスタムディストリビューションを構築するためのオープンソースプロジェクトである。 Yocto Projectは、以下の主要なコンポーネントで構成される。 * Poky *: Yocto Projectのリファレンスディストリビューションであり、ビルドシステムの基盤となる。 * BitBake *: Pythonで実装されたタスク実行エン…」

新規ページ

== 概要 ==
Yocto Projectは、組み込みLinuxシステムのカスタムディストリビューションを構築するためのオープンソースプロジェクトである。 
 
Yocto Projectは、以下の主要なコンポーネントで構成される。 
* Poky
*: Yocto Projectのリファレンスディストリビューションであり、ビルドシステムの基盤となる。
* BitBake
*: Pythonで実装されたタスク実行エンジンであり、レシピを解析してビルドタスクを実行する。
* OpenEmbedded-Core
*: 基本的なレシピ、クラス、設定ファイルのコレクションである。
 

== Yocto Projectの基本概念 ==
==== ディレクトリ構成 ====
~/yocto-project/
├── poky/ # Yocto Project Poky
│ ├── meta/ # OpenEmbedded-Core
│ ├── meta-poky/ # Pokyディストロ設定
│ └── meta-yocto-bsp/ # リファレンスBSP
├── meta-custom-distro/ # カスタムレイヤ
│ ├── conf/
│ │ ├── layer.conf # レイヤ設定
│ │ ├── machine/ # マシン設定
│ │ └── distro/ # ディストロ設定
│ ├── recipes-core/ # コアレシピ
│ │ ├── images/ # イメージレシピ
│ │ ├── packagegroups/ # パッケージグループ
│ │ └── base-files/ # base-files拡張
│ ├── recipes-apps/ # アプリケーションレシピ
│ └── recipes-kernel/ # カーネル関連
└── build/ # ビルドディレクトリ
├── conf/
│ ├── local.conf # ローカル設定
│ └── bblayers.conf # レイヤ設定
└── tmp/
└── deploy/
├── images/ # 生成イメージ
└── sdk/ # SDK
 
==== レイヤの概念 ====
レイヤは、関連するレシピ、設定、クラスをグループ化したものである。 
レイヤを使用することで、機能の追加や変更を既存のコードベースに影響を与えずに行うことができる。 
 
一般的なレイヤ構造は以下の通りである。 
meta-layername/
├── conf/
│ └── layer.conf # レイヤ設定ファイル
├── recipes-core/ # コアレシピ
├── recipes-kernel/ # カーネル関連レシピ
├── recipes-apps/ # アプリケーションレシピ
└── classes/ # BitBakeクラス
 
==== レシピの構造 ====
レシピ (.bbファイル) は、ソフトウェアパッケージのビルド方法を定義する。 
 
主要な変数として以下がある。 
* DESCRIPTION
*: パッケージの説明
* LICENSE
*: ライセンス種別
* SRC_URI
*: ソースコードの取得先
* S
*: ソースディレクトリ
* do_compile
*: コンパイル処理
* do_install
*: インストール処理
 
==== マシン設定とディストリビューション設定 ====
マシン設定 (.conf) は、ターゲットハードウェアの特性 (CPU、メモリ、ペリフェラル等) を定義する。 
ディストリビューション設定 (.conf) は、ディストリビューションの特性(パッケージマネージャ、init システム等)を定義する。 
 

== 開発環境の構築 ==
==== 依存関係のパッケージのインストール ====
Yocto Projectを使用するには、以下に示すパッケージをインストールする。 
# RHEL
## サブスクリプションの登録
sudo subscription-manager register --username=<your-username> --password=<your-password>

## サブスクリプションのアタッチ
sudo subscription-manager attach --auto

## CRBリポジトリの有効化
## 開発に必要なパッケージはCodeReady Linux Builder(CRB)リポジトリに含まれているため
sudo subscription-manager repos --enable codeready-builder-for-rhel-10-$(arch)-rpms

## EPELリポジトリのインストール
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm

## 基本的な開発ツール
sudo dnf groupinstall "Development Tools"

## Yocto Project必須パッケージ
sudo dnf install git tar python3 python3-pip gcc gcc-c++ make wget curl \
chrpath diffstat texinfo cpio xz bzip2 gzip unzip \
patch perl perl-Data-Dumper perl-Thread-Queue perl-bignum \
glibc-devel glibc-devel.i686 libstdc++-devel libstdc++-devel.i686 \
zlib-devel zlib-devel.i686 SDL-devel xterm \
rpcgen libnsl2-devel rpcsvc-proto-devel \
socat screen tmux lz4 zstd hostname file which

# SUSE
sudo zypper install git tar python3 python3-pip gcc gcc-c++ make wget \
chrpath diffstat texinfo cpio xz bzip2 gzip unzip \
patch perl perl-Data-Dumper perl-Thread-Queue \
glibc-devel glibc-devel-32bit libstdc++-devel \
libstdc++-devel-32bit zlib-devel zlib-devel-32bit \
SDL-devel xterm rpcgen libnsl-devel rpcsvc-proto-devel \
socat screen tmux
 
BitBakeの実行にはPythonの追加パッケージが必要である。 
# Python関連パッケージ
## RHEL
sudo dnf install python3-pexpect python3-jinja2 python3-subunit \
python3-pip python3-GitPython python3-distro

# SUSE
sudo zypper install python3-pexpect python3-Jinja2 python3-subunit \
python3-pip python3-GitPython python3-distro

# pipを使用した追加パッケージ (必要に応じて)
pip3 install --user kas
 
クロスコンパイル時に32ビットライブラリが必要になる場合がある。 
# RHEL
sudo dnf install glibc.i686 libgcc.i686 libstdc++.i686 zlib.i686 \
ncurses-libs.i686 readline.i686

# SUSE

 
==== ロケール設定の確認 ====
ロケール設定が正しく行われているかどうかを確認する。 
# en_US.UTF-8ロケールの生成確認
locale -a | grep en_US

# ロケールが存在しない場合は生成
sudo dnf install glibc-langpack-en

# 環境変数の設定
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
 
上記の環境変数は~/.profileファイル等に設定することを推奨する。 
 
==== SELinuxの設定 ====
ビルド中にSELinuxが問題を引き起こす場合があるため、必要に応じてPermissiveモードに設定する。 
# 現在のSELinux状態の確認
getenforce

# 一時的にPermissiveモードに変更
sudo setenforce 0
 
恒久的に変更する場合は、/etc/selinux/config ファイルを編集する。 
sudo vi /etc/selinux/config
 
# /etc/selinux/configファイル

SELINUX=permissive
 
※注意 
本番環境ではSELinuxを無効化せず、適切なポリシーを設定することを推奨する。 
 
==== ファイアウォールの設定 ====
ビルド中にソースコードをダウンロードするため、ネットワークアクセスが必要である。 
# ファイアウォールの状態確認
sudo firewall-cmd --state

# 必要に応じてHTTP/HTTPSを許可
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
 
==== Gitの設定 ====
Yoctoのビルドシステムでは、Gitの設定が必要である。 
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
 
==== Pokyのダウンロード ====
作業ディレクトリを作成して、Pokyをダウンロードする。 
mkdir -p ~/yocto-project
cd ~/yocto-project

# Scarthgap (LTS) ブランチを使用
git clone -b scarthgap git://git.yoctoproject.org/poky.git
 
==== ビルド環境の初期化 ====
ビルド環境を初期化する。 
cd ~/yocto-project/poky
source oe-init-build-env ../build
 
上記のコマンドを実行すると、buildディレクトリが作成され、自動的にそのディレクトリに移動する。 
 

== 標準レイヤの構造分析 ==
==== metaレイヤ ====
metaはOpenEmbedded-Coreレイヤであり、基本的なレシピとクラスが含まれる。 
meta/
├── classes/ # BitBakeクラス (base.bbclass、image.bbclass等)
├── conf/ # 基本設定ファイル
│ ├── bitbake.conf # BitBakeのグローバル設定
│ └── machine/ # 汎用マシン設定
├── recipes-core/ # init、busybox、base-files等
├── recipes-kernel/ # Linuxカーネル関連
└── recipes-support/ # サポートライブラリ
 
==== meta-pokyレイヤ ====
meta-pokyレイヤーはPokyディストリビューション固有の設定を含む。 
meta-poky/
├── conf/
│ └── distro/
│ └── poky.conf # Pokyディストロ設定
└── recipes-core/ # Poky固有のレシピ
 
==== meta-yocto-bspレイヤ ====
meta-yocto-bspレイヤーは、リファレンスBSP (Board Support Package) を提供する。 
 
meta-yocto-bsp/
├── conf/
│ └── machine/
│ ├── beaglebone-yocto.conf
│ └── genericarm64.conf
└── recipes-kernel/ # BSP固有のカーネル設定
 

== カスタムレイヤの作成 ==
==== レイヤディレクトリの作成 ====
カスタムディストリビューション用のレイヤを作成する。 
cd ~/yocto-project
mkdir -p meta-custom-distro/conf
mkdir -p meta-custom-distro/recipes-core/images
mkdir -p meta-custom-distro/recipes-core/packagegroups
mkdir -p meta-custom-distro/recipes-apps
mkdir -p meta-custom-distro/recipes-kernel/linux
 
==== layer.confの作成 ====
レイヤ設定ファイルを作成する。 
vi ~/yocto-project/meta-custom-distro/conf/layer.conf
 
# レイヤ設定ファイル
# meta-custom-distro レイヤ

# レシピとアペンドファイルの収集パターン
BBPATH .= ":${LAYERDIR}"

BBFILES += " \
${LAYERDIR}/recipes-*/*/*.bb \
${LAYERDIR}/recipes-*/*/*.bbappend \
"

BBFILE_COLLECTIONS += "meta-custom-distro"
BBFILE_PATTERN_meta-custom-distro = "^${LAYERDIR}/"

# レイヤの優先度(数値が大きいほど優先)
BBFILE_PRIORITY_meta-custom-distro = "7"

# 互換性のあるYoctoバージョン
LAYERCOMPAT_meta-custom-distro = "scarthgap"

# レイヤの依存関係
LAYERDEPENDS_meta-custom-distro = "core"
 
==== ビルド設定へのレイヤ追加 ====
bblayers.confにカスタムレイヤを追加する。 
vi ~/yocto-project/build/conf/bblayers.conf
 
BBLAYERS ?= " \
/home/user/yocto-project/poky/meta \
/home/user/yocto-project/poky/meta-poky \
/home/user/yocto-project/poky/meta-yocto-bsp \
/home/user/yocto-project/meta-custom-distro \
"
 
または、bitbake-layersコマンドを使用する。 
cd ~/yocto-project/build
bitbake-layers add-layer ../meta-custom-distro
 
==== BitBakeコマンド ====
* bitbake <image-name>
*: イメージのビルド
* bitbake -c <task> <recipe>
*: 特定タスクの実行
* bitbake -e <recipe>
*: レシピの変数展開を表示
* bitbake -g <recipe>
*: 依存関係グラフの生成
* bitbake-layers show-layers
*: レイヤ一覧の表示
* bitbake-layers show-recipes
*: レシピ一覧の表示
* bitbake -s
*: 利用可能なレシピの表示
 

== カスタムマシン設定の作成 ==
例えば、Cortex-A53向けのカスタムマシン設定を行う場合を示す。 
 
==== マシン設定ディレクトリの作成 ====
任意のアーキテクチャ向けのカスタムマシン設定を作成する。 
mkdir -p ~/yocto-project/meta-custom-distro/conf/machine
vi ~/yocto-project/meta-custom-distro/conf/machine/custom-cortexa53.conf
 
==== マシン設定ファイルの内容 ====
# custom-cortexa53.conf
# Cortex-A53ベースのカスタムマシン設定

# マシンの説明
#@TYPE: Machine
#@NAME: Custom Cortex-A53 Machine
#@DESCRIPTION: Custom machine configuration for Cortex-A53 based boards

# 汎用ARM64設定をインクルード
require conf/machine/include/arm/armv8a/tune-cortexa53.inc

# マシン固有の設定
MACHINE_FEATURES = "usbhost vfat ext2 screen alsa"

# カーネル設定
PREFERRED_PROVIDER_virtual/kernel ?= "linux-yocto"
KERNEL_IMAGETYPE = "Image"
KERNEL_DEVICETREE = ""

# ブートローダー設定
PREFERRED_PROVIDER_virtual/bootloader ?= "u-boot"
UBOOT_MACHINE = "qemu_arm64_defconfig"

# シリアルコンソール設定
SERIAL_CONSOLES = "115200;ttyAMA0"

# ルートファイルシステム設定
IMAGE_FSTYPES = "tar.gz ext4 wic"
WKS_FILE = "sdimage-bootpart.wks"

# QEMU設定(エミュレーション用)
MACHINE_EXTRA_RRECOMMENDS += "kernel-modules"

# イメージオーバーヘッド設定
IMAGE_ROOTFS_EXTRA_SPACE = "262144"
 
==== local.confでのマシン指定 ====
ビルド設定でカスタムマシンを指定する。 
vi ~/yocto-project/build/conf/local.conf
 
# カスタムマシンを使用
MACHINE = "custom-cortexa53"
 

== カスタムディストリビューション設定の作成 ==
==== ディストリビューション設定ディレクトリの作成 ====
カスタムディストリビューション設定を作成する。 
mkdir -p ~/yocto-project/meta-custom-distro/conf/distro
vi ~/yocto-project/meta-custom-distro/conf/distro/custom-embedded.conf
 
==== ディストリビューション設定ファイルの内容 ====
# custom-embedded.conf
# カスタム組み込みLinuxディストリビューション設定

# Pokyディストロ設定をベースとする
require conf/distro/poky.conf

# ディストリビューション名とバージョン
DISTRO = "custom-embedded"
DISTRO_NAME = "Custom Embedded Linux"
DISTRO_VERSION = "1.0.0"
DISTRO_CODENAME = "stable"

# メンテナ情報
MAINTAINER = "Your Name <your.email@example.com>"

# ディストリビューション機能
DISTRO_FEATURES = "acl argp ext2 ipv4 ipv6 largefile usbhost wifi \
systemd usrmerge"

# systemdを使用
DISTRO_FEATURES_BACKFILL_CONSIDERED = "sysvinit"
VIRTUAL-RUNTIME_init_manager = "systemd"
VIRTUAL-RUNTIME_initscripts = "systemd-compat-units"

# パッケージマネージャ設定
PACKAGE_CLASSES = "package_rpm"

# SDKの設定
SDK_VENDOR = "-customsdk"
SDK_VERSION = "${DISTRO_VERSION}"
SDK_NAME = "${DISTRO}-${TCLIBC}-${SDKMACHINE}-${IMAGE_BASENAME}-${TUNE_PKGARCH}-${MACHINE}"

# ビルド最適化
INHERIT += "rm_work"

# ライセンス許可設定
LICENSE_FLAGS_ACCEPTED = "commercial"
 
==== local.confでのディストリビューション指定 ====
ビルド設定でカスタムディストリビューションを指定する。 
vi ~/yocto-project/build/conf/local.conf
 
# カスタムディストリビューションを使用
DISTRO = "custom-embedded"
 

== カスタムレシピの作成 ==
==== アプリケーションレシピの作成 ====
サンプルアプリケーションのレシピを作成する。 
mkdir -p ~/yocto-project/meta-custom-distro/recipes-apps/hello-custom/files
vi ~/yocto-project/meta-custom-distro/recipes-apps/hello-custom/hello-custom_1.0.bb
 
# hello-custom_1.0.bb
# サンプルアプリケーションレシピ

SUMMARY = "Custom Hello World Application"
DESCRIPTION = "A simple hello world application for the custom distribution"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"

SRC_URI = "file://hello-custom.c \
file://Makefile"

S = "${WORKDIR}"

do_compile() {
oe_runmake
}

do_install() {
install -d ${D}${bindir}
install -m 0755 hello-custom ${D}${bindir}/
}
 
===== ソースコードの作成 =====
hello-custom.cを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-apps/hello-custom/files/hello-custom.c
 
<syntaxhighlight lang="c">
#include <stdio.h>

int main(int argc, char *argv[])
{
printf("Hello from Custom Embedded Linux!\n");
printf("Build Date: %s %s\n", __DATE__, __TIME__);
return 0;
}
</syntaxhighlight>
 
Makefileを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-apps/hello-custom/files/Makefile
 
<syntaxhighlight lang="make">
CC ?= gcc
CFLAGS ?= -Wall -O2

all: hello-custom

hello-custom: hello-custom.c
$(CC) $(CFLAGS) -o $@ $<

clean:
rm -f hello-custom
</syntaxhighlight>
 
==== base-filesのbbappend作成 ====
base-filesを拡張して、カスタムシステム情報を追加する。 
mkdir -p ~/yocto-project/meta-custom-distro/recipes-core/base-files
vi ~/yocto-project/meta-custom-distro/recipes-core/base-files/base-files_%.bbappend
 
# base-files_%.bbappend
# base-filesレシピの拡張

FILESEXTRAPATHS:prepend := "${THISDIR}/files:"

do_install:append() {
# カスタムissueファイルを作成
echo "Custom Embedded Linux ${DISTRO_VERSION}" > ${D}${sysconfdir}/issue
echo "Kernel \r on \m" >> ${D}${sysconfdir}/issue
echo "" >> ${D}${sysconfdir}/issue

# /etc/os-releaseをカスタマイズ
echo 'NAME="${DISTRO_NAME}"' > ${D}${sysconfdir}/os-release
echo 'VERSION="${DISTRO_VERSION}"' >> ${D}${sysconfdir}/os-release
echo 'ID=custom-embedded' >> ${D}${sysconfdir}/os-release
echo 'VERSION_ID="${DISTRO_VERSION}"' >> ${D}${sysconfdir}/os-release
echo 'PRETTY_NAME="${DISTRO_NAME} ${DISTRO_VERSION}"' >> ${D}${sysconfdir}/os-release
}
 
==== カーネル設定のbbappend作成 ====
カーネル設定をカスタマイズするbbappendを作成する。 
mkdir -p ~/yocto-project/meta-custom-distro/recipes-kernel/linux/files
vi ~/yocto-project/meta-custom-distro/recipes-kernel/linux/linux-yocto_%.bbappend
 
# linux-yocto_%.bbappend
# カーネル設定の拡張

FILESEXTRAPATHS:prepend := "${THISDIR}/files:"

SRC_URI += "file://custom-kernel.cfg"

# カーネル設定フラグメント
KERNEL_CONFIG_FRAGMENTS += "${WORKDIR}/custom-kernel.cfg"
 
カーネル設定フラグメントを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-kernel/linux/files/custom-kernel.cfg
 
# カスタムカーネル設定
CONFIG_LOCALVERSION="-custom"
CONFIG_SYSVIPC=y
CONFIG_POSIX_MQUEUE=y
CONFIG_HIGH_RES_TIMERS=y
CONFIG_PREEMPT=y
CONFIG_IKCONFIG=y
CONFIG_IKCONFIG_PROC=y
CONFIG_CGROUPS=y
CONFIG_NAMESPACES=y
 
==== パッケージグループの作成 ====
基本パッケージグループを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-core/packagegroups/packagegroup-custom-base.bb
 
# packagegroup-custom-base.bb
# 基本パッケージグループ

SUMMARY = "Custom Base Package Group"
DESCRIPTION = "Essential packages for the custom embedded distribution"

inherit packagegroup

RDEPENDS:${PN} = " \
base-files \
base-passwd \
busybox \
sysvinit-inittab \
systemd \
systemd-compat-units \
udev \
util-linux \
e2fsprogs \
dosfstools \
iproute2 \
openssh \
openssl \
ca-certificates \
"
 
開発用パッケージグループを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-core/packagegroups/packagegroup-custom-dev.bb
 
# packagegroup-custom-dev.bb
# 開発用パッケージグループ

SUMMARY = "Custom Development Package Group"
DESCRIPTION = "Development and debugging tools"

inherit packagegroup

RDEPENDS:${PN} = " \
gdb \
strace \
ltrace \
tcpdump \
iperf3 \
htop \
nano \
vim \
git \
cmake \
make \
gcc \
g++ \
binutils \
python3 \
python3-pip \
"
 

== カスタムイメージの作成 ==
==== 最小イメージの作成 ====
最小構成のイメージレシピを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-core/images/custom-image-minimal.bb
 
# custom-image-minimal.bb
# 最小構成イメージ

SUMMARY = "Custom Minimal Image"
DESCRIPTION = "A minimal image for the custom embedded distribution"
LICENSE = "MIT"

inherit core-image

IMAGE_FEATURES += "ssh-server-openssh"

IMAGE_INSTALL = " \
packagegroup-core-boot \
packagegroup-custom-base \
hello-custom \
kernel-modules \
"

# ルートファイルシステムサイズ
IMAGE_ROOTFS_SIZE ?= "262144"
IMAGE_ROOTFS_EXTRA_SPACE = "131072"

# デフォルトロケール
IMAGE_LINGUAS = "en-us"
 
==== 開発用イメージの作成 ====
開発ツールを含むイメージレシピを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-core/images/custom-image-dev.bb
 
# custom-image-dev.bb
# 開発用イメージ

SUMMARY = "Custom Development Image"
DESCRIPTION = "A development image with debugging tools"
LICENSE = "MIT"

# 最小イメージをベースとする
require custom-image-minimal.bb

IMAGE_FEATURES += "debug-tweaks dev-pkgs dbg-pkgs tools-debug tools-sdk"

IMAGE_INSTALL += " \
packagegroup-custom-dev \
packagegroup-core-buildessential \
"

# 開発用に追加のスペースを確保
IMAGE_ROOTFS_EXTRA_SPACE = "524288"
 
==== 本番用イメージの作成 ====
本番環境向けのイメージレシピを作成する。 
vi ~/yocto-project/meta-custom-distro/recipes-core/images/custom-image-production.bb
 
# custom-image-production.bb
# 本番用イメージ

SUMMARY = "Custom Production Image"
DESCRIPTION = "A production-ready image with security hardening"
LICENSE = "MIT"

# 最小イメージをベースとする
require custom-image-minimal.bb

# セキュリティ強化
IMAGE_FEATURES:remove = "debug-tweaks"
IMAGE_FEATURES += "read-only-rootfs"

# 追加パッケージ
IMAGE_INSTALL += " \
watchdog \
logrotate \
"

# 本番用の最適化
EXTRA_IMAGE_FEATURES = ""

# パスワード設定を強制
INHERIT += "extrausers"
EXTRA_USERS_PARAMS = "usermod -P 'rootpassword' root;"
 

== ビルドの実行と確認 ==
==== ビルドの開始 ====
イメージをビルドする。 
cd ~/yocto-project/build
source ../poky/oe-init-build-env .

# 最小イメージのビルド
bitbake custom-image-minimal
 
==== ビルドの監視 ====
ビルド状況を監視する方法は以下の通りである。 
 
# 別ターミナルでログを監視
tail -f ~/yocto-project/build/tmp/log/cooker/custom-cortexa53/console-latest.log

# ビルドタスクの確認
bitbake -g custom-image-minimal
cat pn-buildlist
 
==== ビルド成果物の確認 ====
ビルドが完了すると、以下のディレクトリに成果物が生成される。 
ls -la ~/yocto-project/build/tmp/deploy/images/custom-cortexa53/
 
主な成果物は以下の通りである。 
custom-image-minimal-custom-cortexa53.tar.gz : ルートファイルシステム (tar.gz)
custom-image-minimal-custom-cortexa53.ext4 : ルートファイルシステム (ext4)
custom-image-minimal-custom-cortexa53.wic : ブート可能なディスクイメージ
Image : Linuxカーネルイメージ
modules-custom-cortexa53.tgz : カーネルモジュール
 

== 一般的なビルドエラーと対処法 ==
==== do_fetchエラー ====
ソースコードのダウンロードに失敗した場合は、以下に示す事柄を確認する。 
# ネットワーク接続の確認
ping git.yoctoproject.org

# プロキシ設定の確認(必要な場合)
export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"
 
==== do_compileエラー ====
コンパイルエラーの場合は、ログファイルを確認する。 
# エラーログの確認
cat ~/yocto-project/build/tmp/work/*/package-name/*/temp/log.do_compile

# 依存関係の確認
bitbake -e package-name | grep ^DEPENDS
 
==== ディスク容量不足 ====
ビルドには大量のディスク容量が必要である。(最低50[GB]を推奨する) 
# ディスク使用量の確認
df -h ~/yocto-project

# 不要なビルド成果物の削除
bitbake -c cleanall package-name
 

== デプロイメントとテスト ==
==== QEMUでのテスト ====
QEMUを使用してイメージをテストする。 
cd ~/yocto-project/build
runqemu custom-cortexa53 nographic
 
QEMUを終了する場合は、[Ctrl] + [A]キーを押下した後、[X]キーを押下する。 
 
==== WICイメージの書き込み ====
WICイメージをSDカードに書き込む。 
# SDカードデバイスの確認
lsblk

# イメージの書き込み
# sdXは実際のデバイス名に置換すること
sudo dd if=~/yocto-project/build/tmp/deploy/images/custom-cortexa53/custom-image-minimal-custom-cortexa53.wic \
of=/dev/sdX bs=4M status=progress conv=fsync

sync
 
※注意 
ddコマンドは誤ったデバイスを指定するとデータが失われるため、デバイス名を十分に確認すること。 
 
==== NFSブートの設定 ====
開発時にはNFSブートを使用すると便利である。 
 
ホストPCでNFSサーバを設定する。 
# NFSサーバのインストール
sudo zypper install nfs-kernel-server
 
エクスポート設定を行う。 
sudo vi /etc/exports
 
/home/<ユーザ名>/yocto-project/build/tmp/deploy/images/custom-cortexa53/custom-image-minimal-custom-cortexa53-*.rootfs *(rw,no_root_squash,no_subtree_check)
 
NFSサーバを起動する。 
sudo systemctl enable nfs-server
sudo systemctl start nfs-server
sudo exportfs -a
 
==== SDKの生成 ====
クロスコンパイル用のSDKを生成する。 
bitbake custom-image-minimal -c populate_sdk
 
SDKは以下のディレクトリに生成される。 
ls ~/yocto-project/build/tmp/deploy/sdk/
 
SDKのインストールと使用方法は以下の通りである。 
# SDKのインストール
./poky-glibc-x86_64-custom-image-minimal-cortexa53-custom-cortexa53-toolchain-*.sh

# 環境のセットアップ
source /opt/poky/*/environment-setup-cortexa53-poky-linux

# クロスコンパイルの確認
$CC --version
$CC -o hello hello.c
 

== 保守とアップデート ==
==== バージョン管理 ====
カスタムレイヤをGitで管理することを推奨する。 
cd ~/yocto-project/meta-custom-distro
git init
git add .
git commit -m "Initial commit of custom distribution layer"
 
タグを使用してリリースを管理する。 
git tag -a v1.0.0 -m "Release version 1.0.0"
git push origin v1.0.0
 
==== Yoctoバージョンのアップグレード ====
Yoctoの新しいLTSバージョンにアップグレードする手順は以下の通りである。 
cd ~/yocto-project/poky
git fetch --all
git checkout scarthgap # または新しいLTSブランチ

# カスタムレイヤのLAYERCOMPATを更新
vi ~/yocto-project/meta-custom-distro/conf/layer.conf
 
LAYERCOMPAT_meta-custom-distro = "scarthgap" # 新しいバージョンに更新
 
==== セキュリティアップデート ====
CVE (脆弱性) チェックを有効にする。 
vi ~/yocto-project/build/conf/local.conf
 
# CVEチェックを有効化
INHERIT += "cve-check"
 
CVEレポートを生成する。 
bitbake custom-image-minimal -c cve_check

# レポートの確認
cat ~/yocto-project/build/tmp/deploy/cve/custom-image-minimal-cve.txt
 
==== ドキュメントの整備 ====
以下に示すドキュメントを整備することを推奨する。 
# レイヤのREADME
vi ~/yocto-project/meta-custom-distro/README.md
 
# meta-custom-distro

## 概要
Custom Embedded Linux ディストリビューション用のYoctoレイヤ

## 対応Yoctoバージョン
- Scarthgap (LTS)

## 依存レイヤ
- poky/meta
- poky/meta-poky
- poky/meta-yocto-bsp

## 使用方法
1. ビルド環境の初期化
source poky/oe-init-build-env build

2. レイヤの追加
bitbake-layers add-layer ../meta-custom-distro

3. local.confの設定
MACHINE = "custom-cortexa53"
DISTRO = "custom-embedded"

4. ビルドの実行
bitbake custom-image-minimal

## 含まれるレシピ
- custom-image-minimal : 最小構成イメージ
- custom-image-dev : 開発用イメージ
- custom-image-production : 本番用イメージ
- hello-custom : サンプルアプリケーション
- packagegroup-custom-base : 基本パッケージグループ
- packagegroup-custom-dev : 開発用パッケージグループ

## ライセンス
MIT License
 

== 参考情報 ==
* Yocto Project公式ドキュメント
*: https://docs.yoctoproject.org/
* BitBakeユーザマニュアル
*: https://docs.yoctoproject.org/bitbake/
* OpenEmbeddedレイヤインデックス
*: https://layers.openembedded.org/
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics, SUSE Linux and RHEL | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,RHEL,Red Hat,Red Hat Enterprise Linux,RHEL 10,uCLnux,Podman,Yocto,Yocto Project,BitBake,Poky,OpenEmbedded,Embedded Linux,組み込みLinux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路、SUSE LinuxおよびRHELに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits, SUSE Linux and RHEL
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]][[カテゴリ:Qt]]