← 返回首頁

沒有開發板,也能建置一套 Yocto Linux

2026.10.11 · Yocto · 7 min read

手上還沒有實體開發板,但想先把 Yocto 的建置流程走過一遍。這篇記錄我在 Ubuntu 虛擬機裡從零開始、到用 QEMU 開機的完整過程,包含三個實際卡住的錯誤。

為什麼先用 QEMU

Yocto 是在做什麼:把 kernel、bootloader、rootfs 與套件,從原始碼編譯成一套可以跑在目標板子上的 Linux image。

在正式動手之前,用 QEMU 模擬 x86-64 有兩個好處:不用等硬體到貨,而且同樣的建置流程可以完整走一遍。之後換成實體 ARM 板子時,主要差異在 BSP layer 與 machine 設定。

QEMU 測試無法取代實體硬體驗證 — Device Tree、GPIO、匯流排與廠商 driver 這些,還是得在真板上確認。

環境配置

這次使用的虛擬機規格:

項目配置說明
CPU6 核心可用於建置
RAM10 GB平行編譯時需留意記憶體
虛擬磁碟200 GB需監控建置快取的成長
作業系統Ubuntu 24.04建置環境

為了降低記憶體壓力,我在 build/conf/local.conf 限制了平行度:

BB_NUMBER_THREADS = "4"
PARALLEL_MAKE = "-j 4"

如果建置過程出現 OOM,就把這兩個數字再往下調。

建置步驟

1. 建立工作目錄

mkdir -p ~/yocto
cd ~/yocto

2. 下載 Poky 原始碼

一開始我照著印象用了 yocto-6.0 分支,結果遠端沒有這個分支:

git clone https://git.yoctoproject.org/poky -b yocto-6.0
# fatal: Remote branch yocto-6.0 not found in upstream origin

改用 Poky 的 scarthgap 分支(Yocto 5.0 系列)作為入門基礎:

cd ~/yocto
git clone https://git.yoctoproject.org/poky -b scarthgap

cd ~/yocto/poky
git branch --show-current
# scarthgap

3. 初始化建置環境

這個指令會設定 BitBake 需要的環境變數,並把工作目錄切到 build:

cd ~/yocto/poky
source oe-init-build-env build

確認環境是否正確:

pwd              # 應該在 build/
bitbake --version
echo "$BUILDDIR"

4. 設定目標機器

編輯 conf/local.conf,確認 machine 設定:

MACHINE = "qemux86-64"

MACHINE 決定要建置哪個目標硬體。這裡用的是 QEMU 的 x86-64 模擬目標。

5. 開始建置

bitbake core-image-minimal

第一次建置需要下載、解壓、編譯大量元件,時間會比之後的增量建置長得多。實際時間取決於 CPU、磁碟速度、網路與映像內容。

6. 檢查輸出

ls -lh tmp/deploy/images/qemux86-64/

7. 用 QEMU 測試

runqemu qemux86-64

三個實際卡住的錯誤

① 分支名稱不存在

原因很單純:yocto-6.0 這個分支在 Poky 遠端不存在。Yocto 的版本命名用代號(kirkstone、scarthgap 等),不是數字。改用 scarthgap 之後就正常了。

② 缺少 lz4c

BitBake 在檢查主機工具時報錯:

ERROR: The following required tools (as specified by HOSTTOOLS)
appear to be unavailable in PATH: lz4c

安裝 lz4 套件之後,系統裡只有 lz4,沒有 lz4c。檢查一下實際情況:

sudo apt install -y lz4
which lz4
dpkg -L lz4 | grep -E '/(lz4|lz4c)$'

如果確認只有 /usr/bin/lz4,可以建立相容名稱:

sudo ln -s /usr/bin/lz4 /usr/local/bin/lz4c
which lz4c
符號連結只是相容性處理。如果建置流程用到舊版 lz4c 的特定參數,還是要另外確認。

③ BitBake 無法使用 User Namespace

這個是 Ubuntu 24.04 上比較容易遇到的情況:

ERROR: User namespaces are not usable by BitBake,
possibly due to AppArmor.

BitBake 的隔離機制需要建立 user namespace,而 AppArmor 的設定可能擋掉非特權使用者的這個操作。先確認實際狀態:

sysctl kernel.apparmor_restrict_unprivileged_userns
unshare -Ur true
echo $?

判讀方式:

在確認 sysctl 是 1 的前提下,可以在自己的開發 VM 裡暫時放寬測試:

sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0
這個設定會放寬非特權程式建立 user namespace 的限制,可能影響其他程式的安全隔離。只建議在可控制的開發 VM 中作為暫時診斷,不建議未經評估就永久停用。也不要用 sudo bitbake 繞過問題 — 那會產生 root 擁有的建置檔案,之後處理權限更麻煩。

下一步

照順序確認環境,再重試建置:

# 確認版本與環境
cd ~/yocto/poky
git branch --show-current
source oe-init-build-env build

# 確認設定
grep -E '^(MACHINE|BB_NUMBER_THREADS|PARALLEL_MAKE)' conf/local.conf

# 確認工具與限制
which lz4c
sysctl kernel.apparmor_restrict_unprivileged_userns
unshare -Ur true; echo $?

# 重試
bitbake core-image-minimal

如果還是失敗,保留第一個 ERROR 與它的上下文,比較容易判斷原因。

幾個實用指令

nproc                                    # CPU 核心數
free -h                                  # 記憶體與 swap
df -h /                                  # 磁碟剩餘空間
bitbake --version                        # BitBake 版本
grep '^MACHINE' conf/local.conf          # 目前 MACHINE
journalctl -k -b --no-pager | tail -100  # 核心日誌(找 OOM)

重點整理