【2026年版】YoctoでRaspberry Pi向けLinuxをビルドする完全ガイド

# 作業ディレクトリを作成
$ mkdir -p ~/yocto && cd ~/yocto

# Pokyをダウンロード（styhead = 最新安定版）
$ git clone -b styhead git://git.yoctoproject.org/poky.git

# meta-raspberrypiをダウンロード
$ git clone -b styhead git://git.yoctoproject.org/meta-raspberrypi

# meta-openembeddedをダウンロード（依存関係）
$ git clone -b styhead git://git.openembedded.org/meta-openembedded

# ディレクトリ構成を確認
$ ls
meta-openembedded  meta-raspberrypi  poky

# ビルド環境を初期化
$ cd ~/yocto/poky
$ source oe-init-build-env build-rpi

# buildディレクトリに移動される
# 初回実行時は conf/local.conf と conf/bblayers.conf が自動生成される

# meta-oeを追加（meta-raspberrypiの依存）
$ bitbake-layers add-layer ../../meta-openembedded/meta-oe

# meta-pythonを追加（Pythonを使う場合）
$ bitbake-layers add-layer ../../meta-openembedded/meta-python

# meta-networkingを追加（ネットワーク機能を使う場合）
$ bitbake-layers add-layer ../../meta-openembedded/meta-networking

# meta-raspberrypiを追加
$ bitbake-layers add-layer ../../meta-raspberrypi

# レイヤー一覧を確認
$ bitbake-layers show-layers
layer                 path                                             priority
================================================================================
meta                  /home/user/yocto/poky/meta                       5
meta-poky             /home/user/yocto/poky/meta-poky                  5
meta-yocto-bsp        /home/user/yocto/poky/meta-yocto-bsp             5
meta-oe               /home/user/yocto/meta-openembedded/meta-oe       6
meta-raspberrypi      /home/user/yocto/meta-raspberrypi                9

$ nano conf/local.conf

# ========================================
# Raspberry Pi向け設定
# ========================================

# ターゲットマシンを指定
# raspberrypi4-64  : Raspberry Pi 4 (64bit)
# raspberrypi5     : Raspberry Pi 5
# raspberrypi3-64  : Raspberry Pi 3 (64bit)
MACHINE = "raspberrypi4-64"

# ビルドの並列数（CPUコア数に合わせて調整）
BB_NUMBER_THREADS = "8"
PARALLEL_MAKE = "-j 8"

# SDカードイメージを生成（wic形式）
IMAGE_FSTYPES = "wic.bz2 wic.bmap"

# GPU メモリ割り当て（MB）
GPU_MEM = "64"

# シリアルコンソールを有効化（デバッグ用）
ENABLE_UART = "1"

# SSH を有効化（Dropbear）
IMAGE_FEATURES += "ssh-server-dropbear"

# root ログインを許可（開発用。本番では無効化すること）
EXTRA_IMAGE_FEATURES += "debug-tweaks"

# U-Bootブートローダーを使用
RPI_USE_U_BOOT = "1"

# 最小構成のイメージをビルド
$ bitbake core-image-minimal

# または、基本ツールを含むイメージ（busybox等が入って使いやすい）
$ bitbake core-image-base

# ビルド時間の目安（初回）
# - 8コア/32GB RAM: 約1.5〜2時間
# - 4コア/16GB RAM: 約3〜4時間

# 生成されたイメージを確認
$ ls tmp/deploy/images/raspberrypi4-64/

core-image-minimal-raspberrypi4-64.wic.bz2      # SDカードイメージ（圧縮）
core-image-minimal-raspberrypi4-64.wic.bmap     # 高速書き込み用マップ
Image                                            # カーネルイメージ
bcm2711-rpi-4-b.dtb                             # デバイスツリー

# bmaptoolをインストール
$ sudo apt install bmap-tools

# SDカードのデバイス名を確認
$ lsblk

# bmaptoolで書き込み（/dev/sdXは実際のデバイス名に置き換え）
$ cd tmp/deploy/images/raspberrypi4-64/
$ sudo bmaptool copy core-image-minimal-raspberrypi4-64.wic.bz2 /dev/sdX

# 書き込み完了後、同期
$ sync

# 圧縮を解凍しながら書き込み
$ bzcat core-image-minimal-raspberrypi4-64.wic.bz2 | sudo dd of=/dev/sdX bs=4M status=progress

# 同期
$ sync

Poky (Yocto Project Reference Distro) 5.1 raspberrypi4-64 ttyAMA0

raspberrypi4-64 login: root

root@raspberrypi4-64:~# uname -a
Linux raspberrypi4-64 6.6.x-yocto-standard #1 SMP ... aarch64 GNU/Linux

root@raspberrypi4-64:~# cat /etc/os-release
NAME="Poky (Yocto Project Reference Distro)"
VERSION="5.1 (styhead)"

# Wi-Fiドライバとツールを追加
IMAGE_INSTALL:append = " linux-firmware-bcm43455 wpa-supplicant"

# IPアドレスを確認（有線LAN接続の場合）
root@raspberrypi4-64:~# ip addr show eth0

# 別のPCからSSH接続
$ ssh root@192.168.1.xxx

# GPIOツールを追加（local.confに追記）
IMAGE_INSTALL:append = " libgpiod libgpiod-tools"

root@raspberrypi4-64:~# gpioinfo
root@raspberrypi4-64:~# gpioset gpiochip0 17=1   # GPIO17をHIGHに
root@raspberrypi4-64:~# gpioget gpiochip0 27      # GPIO27を読み取り

HDMI_FORCE_HOTPLUG = "1"
HDMI_GROUP = "2"
HDMI_MODE = "82"   # 1080p 60Hz

IMAGE_FSTYPES = "wic.bz2 wic.bmap"

ERROR: xxx has incompatible license

LICENSE_FLAGS_ACCEPTED = "commercial"