手上還沒有實體開發板,但想先把 Yocto 的建置流程走過一遍。這篇記錄我在 Ubuntu 虛擬機裡從零開始、到用 QEMU 開機的完整過程,包含三個實際卡住的錯誤。
Yocto 是在做什麼:把 kernel、bootloader、rootfs 與套件,從原始碼編譯成一套可以跑在目標板子上的 Linux image。
在正式動手之前,用 QEMU 模擬 x86-64 有兩個好處:不用等硬體到貨,而且同樣的建置流程可以完整走一遍。之後換成實體 ARM 板子時,主要差異在 BSP layer 與 machine 設定。
QEMU 測試無法取代實體硬體驗證 — Device Tree、GPIO、匯流排與廠商 driver 這些,還是得在真板上確認。
這次使用的虛擬機規格:
| 項目 | 配置 | 說明 |
|---|---|---|
| CPU | 6 核心 | 可用於建置 |
| RAM | 10 GB | 平行編譯時需留意記憶體 |
| 虛擬磁碟 | 200 GB | 需監控建置快取的成長 |
| 作業系統 | Ubuntu 24.04 | 建置環境 |
為了降低記憶體壓力,我在 build/conf/local.conf 限制了平行度:
BB_NUMBER_THREADS = "4"
PARALLEL_MAKE = "-j 4"
如果建置過程出現 OOM,就把這兩個數字再往下調。
mkdir -p ~/yocto
cd ~/yocto
一開始我照著印象用了 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
這個指令會設定 BitBake 需要的環境變數,並把工作目錄切到 build:
cd ~/yocto/poky
source oe-init-build-env build
確認環境是否正確:
pwd # 應該在 build/
bitbake --version
echo "$BUILDDIR"
編輯 conf/local.conf,確認 machine 設定:
MACHINE = "qemux86-64"
MACHINE 決定要建置哪個目標硬體。這裡用的是 QEMU 的 x86-64 模擬目標。
bitbake core-image-minimal
第一次建置需要下載、解壓、編譯大量元件,時間會比之後的增量建置長得多。實際時間取決於 CPU、磁碟速度、網路與映像內容。
ls -lh tmp/deploy/images/qemux86-64/
runqemu qemux86-64
原因很單純:yocto-6.0 這個分支在 Poky 遠端不存在。Yocto 的版本命名用代號(kirkstone、scarthgap 等),不是數字。改用 scarthgap 之後就正常了。
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 的特定參數,還是要另外確認。
這個是 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 $?
判讀方式:
1:系統啟用了這項限制。unshare -Ur true 回傳 0:目前使用者可以建立 user namespace。Operation not permitted:被拒絕,需要搭配核心日誌判斷原因。在確認 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)
sudo bitbake 繞過問題,會產生 root 權限的建置檔案。