Lời mở đầu

Khi làm việc với Yocto Project, việc quản lí source code là cả một vấn đề. Nếu cứ để tất cả mọi thứ chung vào 1 folder, mọi thứ sẽ trở nên khó kiểm soát. Đó là lí do tại sao ta cần tạo layer. Nói một cách đơn giản layer tức là ngăn kéo riêng biệt, giúp chúng ta có thể sắp xếp những thay đổi tùy chỉnh mà không ảnh hưởng đến source code của hệ thống, giúp ta dễ maintain sau này.

Tóm tắt các bước lý thuyết để tạo ra layer

Bước 1: Bước đầu tiên khởi tạo môi trường và dùng lệnh bitbake để tạo ra và thêm layer vào Yocto

Bước 2: Sau khi tạo folder layer rồi, Yocto sẽ tạo ra các file cần thiết trong thư mục theo cấu trúc cơ bản dưới đây

Ở đây mình sẽ đề cập đến phần lý thuyết như sau: TRong file recipe, bạn sẽ thường thấy ba biến quan trọng giúp quản lý tên và phiên bản của recipe: PN, PV và PR

PN (Package Name) là tên của package hoặc recipe. Mặc định, nó sẽ tự động lấy từ tên của file recipe, ví dụ như trong file demo_0.1.bb, PN sẽ là demo.
PV (Package Version) đại diện cho phiên bản của package, thường được lấy từ tên của file recipe. Ví dụ, từ file demo_0.1.bb, PV sẽ là 0.1.
PR (Package Revision) đại diện cho phiên bản sửa đổi của recipe. Giá trị mặc định là r0, và sẽ tăng lên mỗi khi có sửa đổi mới cho file recipe. Ví dụ, nếu bạn cập nhật nội dung file demo_0.1.bb mà không thay đổi PV, PR sẽ tăng dần từ r0 đến r1, r2, v.v.

Bước 3: Sau khi đã tạo được cấu trúc folder cho layer và các file cơ bản, bạn có thể xem qua nội dung file recipe. Dưới đây là nội dung của file example_0.1.bb

Cấu trúc nội dung trong file bb như sau:

SUMMARY = "bitbake-layers recipe"
DESCRIPTION = "Recipe created by bitbake-layers"
LICENSE = "MIT"

python do_display_banner() {
    bb.plain("***********************************************");
    bb.plain("*                                             *");
    bb.plain("*  Example recipe created by bitbake-layers   *");
    bb.plain("*                                             *");
    bb.plain("***********************************************");
}

addtask display_banner before do_build

Trong file recipe này, bạn có thể thấy rằng chúng ta khai báo các biến như:

SUMMARY Tóm tắt ngắn gọn về mục đích của recipe
DESCRIPTION Mô trả ngắn gọn về mục đích của recipe
LICENSE Loại giấy phép của phần mềm (ví dụ: “MIT”, “GPLv2“)

Bên cạnh đó, một hàm Python đơn giản là do_display_banner được tạo ra để in ra thông điệp trong quá trình build.

Bước 4: Sử dụng lệnh bitbake để tạo layer và xem kết quả.

Thực hành tạo layer

Bước 1: Bước đầu tiên khởi tạo môi trường và dùng lệnh bitbake để tạo ra và thêm layer vào Yocto

**~/**
cd poky/
source oe-init-build-env
bitbake-layers create-layer meta-customize

Tuy nhiên, meta-customize lại nằm trong thư mục build. Thư mục build chỉ là một thư mục tạm thời để build. Chúng ta nên đặt nó trong thư mục poky ở cùng cấp với các thư mục meta khác và xóa nó.

**~/poky/build**
rm meta-customize/ -rf
bitbake-layers create-layer ../meta-customize

Sau khi tạo layer xong kiểm tra xem nó đã có trong thư mục poky chưa:

**~/poky/build**
ls ../

**Output**
bake        LICENSE               meta            meta-skeleton      README.hardware  scripts
build          LICENSE.GPL-2.0-only  meta-customize  meta-yocto-bsp     README.OE-Core   SECURITY.md
contrib        LICENSE.MIT           meta-poky       oe-init-build-env  README.poky
documentation  MEMORIAM              meta-selftest   poky               README.qemu

Thư mục meta-customize đã có trong thư mục poky, việc tạo đã hoàn tất.

Tiếp tục thêm layer mới vào Yocto Build System bằng add-layer lệnh này nó sẽ cập nhập file bblayers.conf trong thư mục build/conf để hệ thống bằng rằng layer meta-customize cần được sử dụng trong quá trình build.

**~/poky/build**
bitbake-layers add-layer ../meta-customize

Kiểm tra file bblayer xem đã layer meta-customize đã được thêm hay chưa.

**~/poky/build**
cat conf/bblayers.conf

# POKY_BBLAYERS_CONF_VERSION is increased each time build/conf/bblayers.conf
# changes incompatibly
POKY_BBLAYERS_CONF_VERSION = "2"

BBPATH = "${TOPDIR}"
BBFILES ?= ""

BBLAYERS ?= " \
  /media/eric/android/poky/meta \
  /media/eric/android/poky/meta-poky \
  /media/eric/android/poky/meta-yocto-bsp \
  /media/eric/android/poky/build/workspace \
  /media/eric/android/poky/meta-openembedded/meta-oe \
  /media/eric/android/poky/meta-qt5 \
  /media/eric/android/poky/meta-customize \
  "

Ngoài ra khi bạn không muốn build layer này nữa thì chỉ cần sử dụng lệnh remove-layer. Lệnh này nó chỉ xóa cấu hình layer meta-customize ra khỏi bblayers.conf trong Yocto build system

**~/poky/build**
bitbake-layers remove-layer ../meta-customize

Ngoài việc xem các layer trong file conf/bblayer.conf. Bạn có thể kiểm tra nhanh lại các layers hiện tại đang có bằng câu lệnh bitbake

**~/poky/build**
 bitbake-layers show-layers

**Output**
NOTE: Starting bitbake server...
layer                 path                                                                    priority
========================================================================================================
core                  /media/eric/android/poky/meta                                           5
yocto                 /media/eric/android/poky/meta-poky                                      5
yoctobsp              /media/eric/android/poky/meta-yocto-bsp                                 5
openembedded-layer    /media/eric/android/poky/meta-openembedded/meta-oe                      5
qt5-layer             /media/eric/android/poky/meta-qt5                                       7
meta-customize        /media/eric/android/poky/meta-customize                                 6

Bước 2: Sau khi tạo folder layer rồi, chúng ta sẽ thấy các file cần thiết trong thư mục theo cấu trúc mình đã đề cập ở phần lý thuyết. Trong đó Yocto đã tạo sẵn cho chúng ta thư mục recipes-example chứa recipe mẫu

Bước 3: Bạn có thể bắt đầu chỉnh sửa viết nội dung cho file recipe, ở phần này mình sẽ thực hành chỉnh sửa viết ở bài viết sau. Trước mắt chúng ta build recipe và xem nó thực thi như thế nào.

Bước 4: Dùng lệnh bitake để build layer

**~/poky/build**
 bitbake example

**Output**
Loading cache: 100% |                                                                       | ETA:  --:--:--
Loaded 0 entries from dependency cache.
Parsing recipes: 100% |######################################################################| Time: 0:00:21
Parsing of 1954 .bb files complete (0 cached, 1954 parsed). 3311 targets, 95 skipped, 0 masked, 0 errors.
NOTE: Resolving any missing task queue dependencies

Build Configuration:
BB_VERSION           = "2.8.0"
BUILD_SYS            = "x86_64-linux"
NATIVELSBSTRING      = "universal"
TARGET_SYS           = "x86_64-poky-linux"
MACHINE              = "qemux86-64"
DISTRO               = "poky"
DISTRO_VERSION       = "5.0.5"
TUNE_FEATURES        = "m64 core2"
TARGET_FPU           = ""
meta                 
meta-poky            
meta-yocto-bsp       
workspace            = "dnf-4-master:d1c25a3ce446a23e453e40ac2ba8f22b0e7ccefd"
meta-oe              = "scarthgap:2e3126c9c16bb3df0560f6b3896d01539a3bfad7"
meta-qt5             = "scarthgap:eb828418264a49b8d00035cb3d7b12fcea3be801"
meta-customize       = "dnf-4-master:d1c25a3ce446a23e453e40ac2ba8f22b0e7ccefd"

Sstate summary: Wanted 10 Local 0 Mirrors 0 Missed 10 Current 263 (0% match, 96% complete)   | ETA:  0:00:00
Initialising tasks: 100% |###################################################################| Time: 0:00:00
NOTE: Executing Tasks
***********************************************
*                                             *
*  Example recipe created by bitbake-layers   *
*                                             *
***********************************************
NOTE: Tasks Summary: Attempted 832 tasks of which 812 didn't need to be rerun and all succeeded.

Bạn có thể thấy thì Yocto in ra log Example recipe created by bitbake-layers cho biết rằng recipe example đã được tạo thành công trong quá trình build.

Bạn có thể xem các file output của source layer meta-customize.

**~/poky/build**
cd /tmp/work/core2-64-poky-linux/example/0.1

**Output**
configure.sstate          license-destdir      pseudo
deploy-rpms               package              recipe-sysroot
deploy-source-date-epoch  packages-split       recipe-sysroot-native
example-0.1               pkgdata              source-date-epoch
example.spec              pkgdata-pdata-input  sysroot-destdir
image                     pkgdata-sysroot      temp