Lời nói đầu

Ở bài viết trước chúng ta đã đi qua tổng quan của Devtool về khái niệm, lệnh cơ bản, cấu trúc thư mục và hoạt động của devtool hôm nay trong bài viết này mình sẽ viết về tạo recipe trong yocto bằng công cụ devtool.

Các bước lý thuyết để thực hiện

Bước 1: Tạo một instance project helloworld.

Bước 2: Tạo một file biên dịch bằng cmake hoặc makefile.

Bước 3: Thêm recipe bằng câu lệnh devtool.

Bước 4: Biên dịch recipe mới

Bước 5: Chỉnh sửa file bb.

Các bước thực hành

Bước 1: Để cho đơn giản quản lí source code, thì chúng ta sẽ tạo instance project ngoài dường dẫn yocto

**~/**
mkdir helloworld_devtool
cd helloworld_devtool
nano helloworld_devtool.c

**~/helloworld_devtool/helloworld_devtool.c**
#include <stdio.h>

int main (int argc, char **argv)
{
    printf ("Hello Everyone!\n");
    printf ("My name is Nhat\n");
	
    return 0;
}

Bước 2: Tạo cmake để biên dịch source code

**~/helloworld_devtool**
nano CMakeLists.txt

**~/helloworld_devtool/CMakeLists.txt**
cmake_minimum_required(VERSION 3.10)
project(helloyocto_devtool)

add_executable(helloyocto_devtool helloworld_devtool.c)
install(TARGETS helloyocto_devtool DESTINATION bin)

Bây giờ, chúng ta sẽ kiểm tra xem mã nguồn có thể biên dịch thành công không trước khi thêm vào Yocto. Tạo thư mục build sẽ chứa các file tạm trong quá trình biên dịch.

**~/helloworld_devtool**
mkdir build
cd build
cmake ..
make

Nếu biên dịch thành công, bạn sẽ thấy các dòng tương tự như sau:

**Output**
-- The C compiler identification is GNU 9.4.0
-- Check for working C compiler: /usr/bin/cc
-- Check for working C compiler: /usr/bin/cc -- works
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: /media/eric/android/helloworld/build

Scanning dependencies of target helloyocto
[ 50%] Building C object CMakeFiles/helloyocto.dir/main.c.o
[100%] Linking C executable helloyocto
[100%] Built target helloyocto

Sau khi kiểm tra, chúng ta có thể xóa hoặc để lại thư mục build và bắt đầu thêm recipe vào Yocto.

Bước 3: Thêm Recipe bằng Devtool

Tiếp theo, chúng ta sẽ thêm chương trình vào Yocto bằng cách tạo một recipe với devtool. Đây là bước quan trọng để đóng gói dự án "Helloworld" và sử dụng trong hệ thống nhúng Yocto.

Như đã đề cập, để thêm một recipe mới vào hệ thống, bạn có thể sử dụng lệnh devtool add. Tuy nhiên, lệnh này chỉ hoạt động khi recipe bạn muốn thêm chưa tồn tại trong source của Yocto, vì devtool sẽ tự tạo recipe mới cho dự án.

Bây giờ chúng ta sẽ di chuyển vào thư mục build của yocto

**~/helloworld_devtool**
cd ~/poky/build

Add recipe bằng câu lệnh devtool

**~/poky/build**
devtool add helloworld-devtool ../../helloworld_devtool

**Output**
NOTE: Starting bitbake server...
ERROR: recipe helloworld is already in your workspace

Khi sử dụng lệnh devtool add để thêm một recipe mới, nếu thư mục workspace chưa tồn tại, lệnh này sẽ tự động tạo ra thư mục đó. Workspace là nơi lưu trữ các file config cho Yocto, bao gồm cả các đường dẫn tới source code bên ngoài. Nếu thư mục workspace đã tồn tại, devtool sẽ chỉ thêm recipe vào mà không tạo mới.

Cấu trúc thư mục Workspace sau khi thêm recipe

Workspace directory: Là thư mục chứa toàn bộ các recipe và cấu hình cần thiết
.bbappend files: Các file này chứa các thông tin cần thiết để Yocto biết cách sử dụng source code từ thư mục bên ngoài

Bạn có thể xem bên trong file .bbappend files

**~poky/build/workspace/appends/helloworld-devtool.bbappend**
inherit externalsrc
EXTERNALSRC = "/media/eric/android/helloworld_devtool"

Khi sử dụng devtool build để biên dịch recipe thì các file output nó sẽ nằm ở đường dẫn là giá trị của biến EXTERNALSRC

Biên dịch recipe được thêm mới

Bạn có thể sử dụng lệnh devtool build để biên dịch recipe của mình. Lệnh này tương tự như bitbake , nhưng được dùng cho mục đích phát triển. Bạn chỉ cần cung cấp tên gốc recipe (Không bao gồm version, đường dẫn hay phần mở rộng).

**~/poky/build**
devtool build helloworld-devtool

Xem kết quả sau khi biên dịch

Sau khi biên dịch, bạn có thể thấy các file tạm thời và file thực thi cuối cùng trong thư mục source code của bạn thông qua các symbolic links mà Yocto tạo ra:

**~/poky/build**
cd ..
ls -l ../helloworld_devtool/

Kết quả sẽ bao gồm các liên kết như oe-logs và oe-workdir trỏ đến các thứ mục làm việc và file log của Yocto.

Thêm recipe vào meta-customize

Qua các bước trên nhìn chung nó rất đơn giản so với cách tạo recipe nhiều bước thủ công trước đây. Nếu bạn muốn tích hợp folder helloworld của mình vào layer Yocto, bạn chỉ cần di chuyển các file liên quan vào thư mục meta-customize của mình và cập nhật lại file .bb

Đầu tiên vào layer meta-customize để tạo thư mục chứa source code

**~/poky**
cd meta-customize

**~/poky/meta-customize**
mkdir recipes-helloworld-devtool/
cd recipes-helloworld-devtool 
mkdir helloworld-devtool
cd helloworld-devtool

Sau đó copy toàn bộ source của helloworld_devtool ở ngoài thư mục yocto đã tạo trước đó và copy file bb sau khi sử dụng devtool build và nó đặt ở thư mục workspace.

**~/poky/meta-customize/recipes-helloworld-devtool**
cp ../../../../helloworld_devtool/ . -rf
cp ../../../build/workspace/recipes/helloworld-devtool/helloworld-devtool.bb .

Cấu trúc thư mục sau khi tạo và copy

Hình 2: Cấu trúc thư mục recipes-helloworld-devtool

Cập nhật lại file bb cho phù hợp với đường dẫn của source code

**~/poky/meta-customize/recipes-helloworld-devtool**
nano helloworld-devtool.bb

Nội dung file bb

**~/poky/meta-customize/recipes-myapps/helloyocto.bb**
# Recipe created by recipetool
# This is the basis of a recipe and may need further editing in order to be fully functional.
# (Feel free to remove these comments when editing.)

# Unable to find any files that looked like license statements. Check the accompanying
# documentation and source headers and set LICENSE and LIC_FILES_CHKSUM accordingly.
#
# NOTE: LICENSE is being set to "CLOSED" to allow you to at least start building - if
# this is not accurate with respect to the licensing of the software being built (it
# will not be in most cases) you must specify the correct value before using this
# recipe for anything other than initial testing/development!
LICENSE = "CLOSED"
LIC_FILES_CHKSUM = ""

# No information for SRC_URI yet (only an external source tree was specified)
SRC_URI = ""

inherit externalsrc 
EXTERNALSRC = "${THISDIR}/helloworld_devtool"

inherit cmake

# Specify any options you want to pass to cmake using EXTRA_OECMAKE:
EXTRA_OECMAKE = ""

Như bạn thấy đoạn code ở trên, mình có thêm 2 dòng code

inherit externalsrc: Lớp externalsrc cho phép sử dụng thư mục source code bên ngoài thay vì tải từ kho lưu trữ từ git.
EXTERNALSRC: Đường dẫn dẫn đến source code.

Xóa recipe khỏi thư mục Workspace

Nếu bạn không cần giữ lại recipe trong thư mục workspace, bạn có thể dùng lệnh devtool reset để xóa nó bằng câu lệnh sau:

**~/poky/build**
devtool reset helloworld-devtool

Lệnh devtool reset này sẽ xóa recipe được chỉ định trong thư mục workspace. Kiểm tra thư mục workspace:

**~/poky/build**
ls workspace/recipes/

Nếu thành công, thư mục sẽ trống và không còn file helloyocto.bb nữa.

Kiểm tra lại với công cụ bitbake

Sau khi xóa recipe khỏi workspace, bạn có thể sử dụng lệnh bitbake để kiểm tra:

**~/poky/build**
bitbake helloworld-devtool

bitbake sẽ bắt đầu biên dịch lại recipe từ vị trí source code mới trong layer Yocto. Sau khi chạy, bạn sẽ thấy quá trình biên dịch diễn ra và kết quả sẽ thông báo mọi tác vụ đều thành công.