前言

繼先前建立好基楚的系統後，我們已經可以順利開機，並從 NFS 載入 rootf filesystem。 本文會接續之前建立的環境，開始加入自製的程式以及自訂的 Layer。

主要內容

Recipe

Recipe 是以 <APPLICATION_NAME>_<VERSION>.bb 的方式命名。裡面會包含這個 Package 該如何「穫取源始碼、Patch、編譯、安裝」的方法、它的授權方式以及它的相依套件/Package。

為了簡化 Recipe 以及避免過多的重複，我們可以將共同的部份撰寫在 <APPLICATION>.inc 並在 Recipe 中引用。

常見的配置項

• DESCRIPTION 說明、介紹此 Package

• HOMEPAGE 如果此 Package 的專案有介紹網站的話，可以寫在此

• PRIORITY 預設是: optional

• SECTION 這個 Package 的分類。例: console/utils

• LICENSE 這個 Package 的授權方式

• SRC_URL 這個 Package 源始碼位置 它的格式為: scheme://<ur>l;param1;param2 scheme 可以是 https, git, svn, hg, ftp, file, …

• SRC_URL[md5sum], SRC_URL[sha256sum] 源始碼的檢查碼設置。 例:

  • SRC_URI = “http://example.com/src.tar.bz2;name=tarball" SRC_URI[tarball.md5sum] = “97b2c3fb082241ab5c56…”
    • git scheme: git:<url>;protocol=<protocol>;branch=<branch>
    • http,https,ftp: https://<url> 也可以使用一些變數來設置位置，例: ${SOURCEFORGE_MIRROR}/<project-name>/${PN}-${PV}.tar.gz 詳細資訊可以參考 meta/conf/bitbake.conf

• S 獲取後、解壓縮後的源始碼路目錄。通常會配置為 ${WORKDIR} 如果是使用 git 來獲取程式碼，則一定要設置成 ${WORKDIR}/git

• FILESPATH 本機檔案的搜尋路徑。

  1 2	FILESPATH = "${@base_set_filespath(["${FILE_DIRNAME}/${BP}", "${FILE_DIRNAME}/${BPN}","${FILE_DIRNAME}/files"], d)}"

• FILESOVERRIDES 本機檔案的搜尋路徑。

  1	FILESOVERRIDES = "${TRANSLATED_TARGET_ARCH}:${MACHINEOVERRIDES}:${DISTROOVERRIDES}"

• LIC_FILES_CHKSUM

  1 2 3

  LIC_FILES_CHKSUM = "file://gpl.txt;md5=393a5ca..." LIC_FILES_CHKSUM = "file://main.c;beginline=3;endline=21;md5=58e..." LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=083..."

• DEPENDS 在編譯時期的相依套件/Package。

  1 2	DEPENDS = "recipe-b" DEPENDS = "recipe-b (>= 1.2)"

• RDEPENDS 在執行時期的相依套件/Package。

  1 2	RDEPENDS_${PN} = "recipe-b" RDEPENDS_${PN} = "recipe-b (> 1.2)"

常見的變數

• PN 表示 Package Name
• BPN 移除 PN 的前綴與後綴。例: nativesdk- 或是 -native。
• PV 表示 Package Version
• PR 表示 Package Revision。預設是: r0
• BP 表示 ${BPN}-${PV}
• WORKDIR 表示 Recipe 工作時期的目錄
• D 表示安裝時的目標目錄

  1 2 3 4

  do_install() { install -d ${D}${bindir} install -m 0755 hello ${D}${bindir} }

Task

在 Recipe 中有許的預設的 task，我們可以自訂、修改它們來滿足我們的需求。

• do_fetch
• do_unpack
• do_patch
• do_configure
• do_compile
• do_install
• do_package
• do_rootfs

加入自訂的 Task

1
2
3
4

do_mkimage() {
	uboot-mkimage ...
}
addtask do_mkimage after do_compile before do_install

Example Recipe

下列是一個 Recipe 的範例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

DESCRIPTION = "Hello world program"
HOMEPAGE = "http://example.net/hello/"
PRIORITY = "optional"
SECTION = "examples"
LICENSE = "CLOSED"
LIC_FILES_CHKSUM = ""
FILESOVERRIDES_prepend := "${THISDIR}/${PN}_${PV}:"
SRC_URI = " \
           file://main.c \
           file://Makefile \
           "
           
S = "${WORKDIR}"

do_configure () {
}
do_compile () {
	oe_runmake
}
do_install () {
    oe_runmake install 'DESTDIR=${D}'
}

1

bitbake -e `<package>` 

1

	bitbake -c devshell `<package>`

擴展 Recipe

通常不建議直接修改上游的配置，但常常我們又會遇到需要調整程式的需求。這時候我們可以使用 Recipe Extension (.bbappend)。 它的命名方式為 <appliction>_<version>.bbappend

recipe-b_%.bbappend:

這要的 % 為萬用字元，在此代表任意版本。

1
2
3
4

FILESEXTRAPATHS_prepend := "${THISDIR}/files:"
SRC_URI += "file://custom-modification-0.patch \
            file://custom-modification-1.patch \
"

自訂 Virtual Packages

我們可以透過 PROVIDES = "virtual/<package>" 來表示。

Class

我們可以提出共同的配置，撰寫成 .bbclass 。在不同的 Recipe 要使用時，就可以以 inherit <class> 來使用它。 常見到地方有 Build System。例: cmake, make, autotools, …。更多我們可以在 meta/classes 中找到

Base Class

已包含了 fetch, unpack, compile, … 等 Task。可以使用 oe_runmake 並透過 EXTRA_OEMAKE 來指定參數。

Kernel Class

用來建置 Linux Kernel 的 Class。它已配置了 PROVIDE，並且可以使用下列幾個變數:

• KERNEL_IMAGETYPE
• KERNEL_EXTRA_ARGS
• INITRAMFS_IMAGE

Useradd Class

用來新增系統的使用者。在使用的時候必須指定 USERADD_PACKAGES，詳情可參考 useradd-example.bb。

我們可以透過 USERADD_PARAM 與 GROUPADD_PARAM 來傳遞參數給 useradd 及 groupadd

例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

DESCRIPTION = "useradd class usage example"
PRIORITY = "optional"
SECTION = "examples"
LICENSE = "MIT"
SRC_URI = "file://file0"
LIC_FILES_CHKSUM = "file://${COREBASE}/meta/files/common-licenses/MIT;md5=0835ade698e0bc..."
inherit useradd 
USERADD_PACKAGES = "${PN}"
USERADD_PARAM = "-u 1000 -d /home/user0 -s /bin/bash user0"
do_install() {
install -m 644 file0 ${D}/home/user0/ chown user0:user0 ${D}/home/user0/file0
}

Layer

Layer 是以 meta-<LAYER_NAME> 的方式命名。裡面會包含這個一個或數個 Recipe。 Bitbake 會獲取 ${BUILDDIR}/conf/bblayers.conf 中每個 Layer 的配置，進而開始建置系統。 所以，如果我們想要加入 Layer 時，必須將其加入至 BBLAYERS 變數中。

meta-bootlinlabs

建立 meta-bootlinlabs 並加入 BBLAYERS 中。

1
2
3

cd ${BUILDDIR}
bitbake-layers create-layer -p 7 ../meta-bootlinlabs
bitbake-layers add-layer ../meta-bootlinlabs/

加入 recipe-ninvaders

1
2
3
4
5

pushd ../meta-bootlinlabs
mkdir -p recipes-ninvaders/ninvaders
recipetool create -o recipes-ninvaders/ninvaders/ninvaders_git.bb https://github.com/TheZ3ro/ninvaders
popd
bitbake ninvaders

1
2

- inherit autotools
+ inherit autotools-brokensep

將 ninvaders 加入 root filesystem 中

重新編譯後，記得要更新 NFS 分享目錄

1
2

echo 'IMAGE_INSTALL_append = " ninvaders"'
bitbake core-image-miminal

接著重新啟動 STM32MP1 之後，執行 nInvaders

小結

因為筆者手邊沒有 Nunchuk ，所以也就沒有進行 Lab 5 了。 有興趣的同學，再自己玩玩看囉!

參考連結

• OpenEmbedded Layer Index
• TheZ3ro/ninvaders
• Bootlin/Yocto with STM32
• Bootlin/Yocto with STM32 Lab

相關頁面

• 在 STM32MP1 上使用 Yocto 建置 Linux 系統
• 在 Yocto 環境中調整 Linux Kernel
• Yocto 基礎介紹
• 使用 Yocto 打造你的 Raspberry Pi 系統
• COSCUP 2021 Day 1