Skip to content

Latest commit

 

History

History
executable file
·
338 lines (243 loc) · 13.4 KB

helper_Yocto.md

File metadata and controls

executable file
·
338 lines (243 loc) · 13.4 KB
Raw

Yocto

GitHub license GitHub stars GitHub forks GitHub issues GitHub watchers

1. Yocto Project

1.1. Release Activity

Codename Yocto Project Version Release Date Current Version Support Level Poky Version BitBake branch Maintainer
Mickledore 4.2 April 2023 Future - Support for 7 months (until October 2023) N/A Richard Purdie [email protected]
Langdale 4.1 October 2022 Future - Support for 7 months (until May 2023) N/A Richard Purdie [email protected]
Kirkstone 4.0 May 2022 4.0.3 (August 2022) Long Term Support (minimum Apr. 2024) N/A 2.0 Steve Sakoman [email protected]
Honister 3.4 October 2021 3.4.4 (May 2022) EOL N/A 1.52 Anuj Mittal [email protected]
Hardknott 3.3 April 2021 3.3.6 (April 2022) EOL N/A 1.50 Anuj Mittal [email protected]

1.2. Release Information

1.3. OpenEmbedded Layer Index

1.4. Source Tree

meta-freescale

meta-freescale-distro

meta-imx

meta-openembedded

meta-rauc

poky

1.4.1. Yocto計劃

Yocto計畫主要由三個元件組成：

BitBake：讀取組態檔與處方檔（recipes)並執行，組態與建置所指定的應用程式或者系統檔案映像檔。

OpenEmbedded-Core：由基礎layers所組成，並為處方檔（recipes)，layers與classes的集合：這些要素都是在OpenEmbedded系統中共享使用的。

Poky：是一個參考系統。是許多案子與工具的集合，用來讓使用者延伸出新的發行版（Distribution)

1.5. Read Me First

編譯很花時間，至少2小時（手邊是有intel i9-11980HK）以上 ~ 1天 or 2天都有可能。

很佔空間，至少要留個100G。

還有你要先決定 Poky要抓那一版本（branch 和 rev），相對應的 meta-openembedded 和硬體相依性比較高的 meta-raspberrypi 你也要決定版本（branch 和 rev）。就算所有需要的軟體都集齊了，最後也編譯完了，最後能不能開機也是問題！

如果你不是晶片供應商（如聯發科），而只是一位 embedded engineer，聯發科領多少錢，而我們領不到他們的一半，甚至連破百萬都沒有；卻要幫他們組一包可以編譯的環境，這情何以堪。

BB 的語法太靈活，shellscript 的支援度不高；我們寫程式的時間都不夠了，還要學習這奇怪的語法。

在編譯時一定要上網！就算你已經編譯成功，而且已經下載過，還是會報失敗。

yocto 的版本變動很快，或許今年允許的 class 或語法，明年就不能用了。就連google 大神也救不了，因為新的東西，還要等有心人把踩到的屎寫出來。

最後就是 yocto 編譯的錯誤訊息相當的難理解，這有一部分是繼承了 python的傳統。

2. Poky

2.1. version

$ bitbake -e virtual/kernel | grep "^PN"
PN="linux-raspberrypi"

$ bitbake -e virtual/kernel | grep "^PV"
PV="5.15.56+gitAUTOINC+3b1dc2f1fc_a90998a3e5"

$ cat ./$PJ_YOCTO_LAYERS/poky/meta-poky/conf/distro/poky.conf | grep DISTRO_VERSION
#DISTRO_VERSION = "4.1+snapshot-${METADATA_REVISION}"
DISTRO_VERSION = "4.1"
SDK_VERSION = "${@d.getVar('DISTRO_VERSION').replace('snapshot-${METADATA_REVISION}', 'snapshot')}"

3. Yocto Recipes

3.1. core-image-base

# check core-image-base exist
$ bitbake -s | grep core-image-base
core-image-base                                       :1.0-r0
$ find -name core-image-base*.bb
./layers-master/poky/meta/recipes-core/images/core-image-base.bb

$ bitbake -e core-image-base | grep ^SRC_URI=

$ bitbake -e core-image-base | grep ^S=
S="/work/codebase/RaspberryPi/Yocto/yocto-pi/builds/build-pi3-master/tmp/work/raspberrypi3-poky-linux-gnueabi/core-image-base/1.0-r0/core-image-base-1.0"

$ bitbake -c listtasks core-image-base
$ bitbake -c cleanall core-image-base
$ bitbake -c build core-image-base

3.2. Linux Kernel (linux-)

$ bitbake -s | grep linux-

# make menuconfig
$ bitbake -c menuconfig virtual/kernel

3.3. ?apache2

"layers": [ "meta-openembedded/meta-webserver" ]
$ bitbake -s | grep apache2

3.4. avahi (mDNS)

$ bitbake -s | grep avahi

3.5. bluez5

$ bitbake -s | grep bluez5

3.6. Busybox - yocto项目修改busybox

$ bitbake -s | grep busybox

3.7. dbus

$ bitbake -s | grep dbus

3.8. dropbear (SSH)

$ bitbake -s | grep dropbear

3.9. libwebsockets

"layers": [ "meta-openembedded/meta-networking" ]
$ bitbake -s | grep libwebsockets

3.10. ?mosquitto

"layers": [ "meta-openembedded/meta-networking" ]
$ bitbake -s | grep mosquitto

3.11. glib-2.0

$ bitbake -s | grep glib-2.0

3.12. systemd

$ bitbake -s | grep systemd

4. bb helper

4.1. utils - layers/poky/bitbake/lib/bb/utils.py

A. def contains(variable, checkvalues, truevalue, falsevalue, d):

"""Check if a variable contains all the values specified.

DEPENDS += "${@bb.utils.contains('DISTRO_FEATURES', 'x11', '${X11DEPENDS}', '', d)}"

PACKAGECONFIG = "${@bb.utils.contains('DISTRO_FEATURES', 'x11', 'x11', '', d)}"

ENDIANNESS_GCC = "${@bb.utils.contains("LE_UBOOT_FOR_ARMBE_TARGET", "1", "-mlittle-endian", "", d)}"
ENDIANNESS_LD = "${@bb.utils.contains("LE_UBOOT_FOR_ARMBE_TARGET", "1", "-EL", "", d)}"

CFLAGS += "${@bb.utils.contains('SELECTED_OPTIMIZATION', '-Og', '-DXXH_NO_INLINE_HINTS', '', d)}"

B. def filter(variable, checkvalues, d):

"""Return all words in the variable that are present in the checkvalues.

PACKAGECONFIG ??= "${@bb.utils.filter('DISTRO_FEATURES', 'x11', d)}"

5. Others

5.1. BB_ENV_EXTRAWHITE

ERROR: Variable BB_ENV_EXTRAWHITE has been renamed to BB_ENV_PASSTHROUGH_ADDITIONS
ERROR: Variable BB_ENV_EXTRAWHITE from the shell environment has been renamed to BB_ENV_PASSTHROUGH_ADDITIONS
ERROR: Exiting to allow enviroment variables to be corrected

5.2. BB_ENV_PASSTHROUGH_ADDITIONS

flowchart LR
	ubuntu[ubuntu env]
	yocto[yocto env]

	ubuntu --> |BB_ENV_PASSTHROUGH_ADDITIONS| yocto
Loading 
BB_ENV_PASSTHROUGH_ADDITIONS="ALL_PROXY BBPATH_EXTRA BB_LOGCONFIG BB_NO_NETWORK BB_NUMBER_THREADS BB_SETSCENE_ENFORCE BB_SRCREV_POLICY DISTRO FTPS_PROXY FTP_PROXY GIT_PROXY_COMMAND HTTPS_PROXY HTTP_PROXY MACHINE NO_PROXY PARALLEL_MAKE SCREENDIR SDKMACHINE SOCKS5_PASSWD SOCKS5_USER SSH_AGENT_PID SSH_AUTH_SOCK STAMPS_DIR TCLIBC TCMODE all_proxy ftp_proxy ftps_proxy http_proxy https_proxy no_proxy"

$ export BB_EXTRA_SRCREV="AUTOINC"
$ export BB_ENV_PASSTHROUGH_ADDITIONS="${BB_ENV_PASSTHROUGH_ADDITIONS} BB_EXTRA_SRCREV"

SRCREV = "${@bb.utils.contains('BB_EXTRA_SRCREV','AUTOINC','${AUTOREV}','${SRCREV_RELEASE}',d)}"

or

SRCREV = "${@'${AUTOREV}' if d.getVar('BB_EXTRA_SRCREV', 'AUTOINC') \
         else '${SRCREV_RELEASE}'}"

Appendix

I. Study

I.1. Yocto計劃

II. Debug

II.1. yocto 裏 BB_FETCH_PREMIRRORONLY 是什麼功用

[ChatGPT] yocto 裏 BB_FETCH_PREMIRRORONLY 是什麼功用

在 Yocto Project 中，BB_FETCH_PREMIRRORONLY 是一個 BitBake 變數，用於指定哪些軟體包（通常是源代碼 tarballs 或 Git 存儲庫）應該僅使用本地的預先鏡像（pre-mirrors）進行下載，而不是從遠程源進行下載。這對於加速 Yocto 構建過程並減少對外部網絡資源的依賴很有用。

BB_FETCH_PREMIRRORONLY 的主要功能如下：

  1. 本地預先鏡像： Yocto 開發者可以設置本地預先鏡像，這是一個包含一組源代碼 tarballs 或 Git 存儲庫的本地資源。通常，這些資源是先從外部源（如官方網站或Git存儲庫）下載並儲存在本地預先鏡像中。
  2. 提高下載效能： 設置 BB_FETCH_PREMIRRORONLY 可以通知 BitBake 優先使用本地預先鏡像來下載源代碼。這有助於加速 Yocto 構建過程，因為本地下載通常比從遠程源下載更快。
  3. 減少對外部網絡的依賴： 通過僅使用本地預先鏡像，開發者可以減少對外部網絡資源的依賴。這在某些環境中很有用，特別是在網絡連接不穩定或有限的情況下。

使用 BB_FETCH_PREMIRRORONLY 變數時，您可以在 Yocto 的 local.conf 配置文件中設置它，如下所示：

BB_FETCH_PREMIRRORONLY = "1"

這將告訴 BitBake 優先使用本地預先鏡像，如果本地沒有所需的資源，則才會嘗試從遠程源下載。

請注意，為了正確使用 BB_FETCH_PREMIRRORONLY，您需要確保已設置本地預先鏡像，並在其中包含所需的源代碼 tarballs 或 Git 存儲庫。這通常需要事先下載和緩存這些資源。

II.2. yocto 裏 BB_NO_NETWORK 是什麼功用

[ChatGPT] yocto 裏 BB_NO_NETWORK 是什麼功用

在 Yocto Project 中，BB_NO_NETWORK 是一個 BitBake 變量，它用於指定是否禁用網絡訪問，特別是在構建嵌入式 Linux 映像時。這個變量的主要功能是允許您控制 BitBake 構建過程中的網絡連接，以適應不同的開發和部署場景。

BB_NO_NETWORK 的主要功能如下：

  1. 禁用網絡訪問： 將 BB_NO_NETWORK 設置為 "1" 可以告訴 BitBake 禁用網絡訪問。這意味著 BitBake 不會嘗試從互聯網上下載所需的源代碼、依賴項或鏡像。這對於在沒有互聯網連接的封閉環境中進行構建或在網絡不穩定的情況下進行構建非常有用。
  2. 離線構建： 當您需要在沒有網絡連接的情況下進行 Yocto 構建時，可以設置 BB_NO_NETWORK 為 "1"。這樣，BitBake 將僅依賴於本地緩存、預先下載的源代碼和預先配置的依賴項。
  3. 加速構建： 在某些情況下，開發人員可能希望通過禁用網絡訪問來加快構建過程。這是因為網絡下載操作可能會成為構建的瓶頸，禁用它們可以減少構建時間。
  4. 鏡像或本地存儲： 在某些情況下，您可能已經準備好了所需的源代碼、鏡像或依賴項，並希望避免在每次構建時下載它們。設置 BB_NO_NETWORK 可以確保 BitBake 使用您提供的本地資源。

要在 Yocto 構建中使用 BB_NO_NETWORK，您可以將以下內容添加到您的 local.conf 配置文件中：

BB_NO_NETWORK = "1"

請注意，設置 BB_NO_NETWORK 為 "1" 可以在某些情況下加快構建，但也可能需要更多的手動管理和預先下載所需的資源。因此，根據您的特定需求和情況，謹慎使用這個選項。

II.3. Previous bitbake instance shutting down?, waiting to retry...

$ find * -name bitbake.lock

$ rm builds/*/bitbake.lock

III. Glossary

IV. Tool Usage

Author

Created and designed by Lanka Hsu.

License

HelperX is available under the BSD-3-Clause license. See the LICENSE file for more info.