Rockchip RK3588 - Rockchip Linux SDK脚本分析

----------------------------------------------------------------------------------------------------------------------------

开发板 :ArmSoM-Sige7开发板eMMC64GBLPDDR48GB
显示屏 :15.6英寸HDMI接口显示屏u-boot2017.09linux5.10
----------------------------------------------------------------------------------------------------------------------------

在《Rockchip RK3588 - Rockchip Linux SDK编译》我们SDK的编译流程以及固件升级相关的内容,本节将会对编译脚本进行深入的分析。

一、build.sh分析

Rockchip Linux SDK编译命令是由build.sh脚本实现的,其入口函数为main函数。

1.1 main函数

由于main函数代码内容较长,我们只对重点内容进行分析:

点击查看代码
main()
{[ -z "$DEBUG" ] || set -xtrap 'err_handler' ERRset -eE# Save intial envionmentsunset INITIAL_SESSIONINITIAL_ENV=$(mktemp -u)if [ -z "$RK_SESSION" ]; thenINITIAL_SESSION=1env > "$INITIAL_ENV"fiexport LC_ALL=Cexport SCRIPTS_DIR="$(dirname "$(realpath "$BASH_SOURCE")")"export COMMON_DIR="$(realpath "$SCRIPTS_DIR/..")"export SDK_DIR="$(realpath "$COMMON_DIR/../../..")"export DEVICE_DIR="$SDK_DIR/device/rockchip"export CHIPS_DIR="$DEVICE_DIR/.chips"export CHIP_DIR="$DEVICE_DIR/.chip"export RK_DATA_DIR="$COMMON_DIR/data"export RK_TOOL_DIR="$COMMON_DIR/tools"export RK_IMAGE_DIR="$COMMON_DIR/images"export RK_KBUILD_DIR="$COMMON_DIR/linux-kbuild"export RK_CONFIG_IN="$COMMON_DIR/configs/Config.in"export RK_BUILD_HOOK_DIR="$COMMON_DIR/build-hooks"export BUILD_HELPER="$RK_BUILD_HOOK_DIR/build-helper"export RK_POST_HOOK_DIR="$COMMON_DIR/post-hooks"export POST_HELPER="$RK_POST_HOOK_DIR/post-helper"export PARTITION_HELPER="$SCRIPTS_DIR/partition-helper"export RK_SESSION="${RK_SESSION:-$(date +%F_%H-%M-%S)}"export RK_OUTDIR="$SDK_DIR/output"export RK_SESSION_DIR="$RK_OUTDIR/sessions"export RK_LOG_BASE_DIR="$RK_OUTDIR/log"export RK_LOG_DIR="$RK_SESSION_DIR/$RK_SESSION"export RK_INITIAL_ENV="$RK_LOG_DIR/initial.env"export RK_CUSTOM_ENV="$RK_LOG_DIR/custom.env"export RK_FINAL_ENV="$RK_LOG_DIR/final.env"export RK_ROCKDEV_DIR="$SDK_DIR/rockdev"export RK_FIRMWARE_DIR="$RK_OUTDIR/firmware"export RK_SECURITY_FIRMWARE_DIR="$RK_OUTDIR/security-firmware"export RK_CONFIG="$RK_OUTDIR/.config"export RK_DEFCONFIG_LINK="$RK_OUTDIR/defconfig"# For Makefilecase "$@" inmake-targets)# Chip targetsls "$CHIPS_DIR";&make-usage)run_build_hooks "$@"rm -f "$INITIAL_ENV"exit 0 ;;esac# Log SDK informationMANIFEST="$SDK_DIR/.repo/manifest.xml"if [ -e "$MANIFEST" ]; thenif [ ! -L "$MANIFEST" ]; thenMANIFEST="$SDK_DIR/.repo/manifests/$(grep -o "[^\"]*\.xml" "$MANIFEST")"fiTAG="$(grep -o "linux-.*-gen-rkr[^.\"]*" "$MANIFEST" | \head -n 1 || true)"MANIFEST="$(basename "$(realpath "$MANIFEST")")"echoecho -e "\e[35m############### Rockchip Linux SDK ###############\e[0m"echoecho -e "\e[35mManifest: $MANIFEST\e[0m"if [ "$TAG" ]; thenecho -e "\e[35mVersion: $TAG\e[0m"fiechofi# Prepare firmware dirsmkdir -p "$RK_FIRMWARE_DIR" "$RK_SECURITY_FIRMWARE_DIR"cd "$SDK_DIR"[ -f README.md ] || ln -rsf "$COMMON_DIR/README.md" .[ -d common ] || ln -rsf "$COMMON_DIR" .# TODO: Remove it in the repo manifest.xmlrm -f envsetup.shOPTIONS=${@:-allsave}# Special handle for chip and defconfig# e.g. ./build.sh rk3588:rockchip_defconfigfor opt in $OPTIONS; doif [ -d "$CHIPS_DIR/${opt%%:*}" ]; thenOPTIONS=$(echo "$OPTIONS" | xargs -n 1 | \sed "s/^$opt$/chip:$opt/" | xargs)elif echo "$opt" | grep -q "^[0-9a-z_]*_defconfig$"; thenOPTIONS=$(echo "$OPTIONS" | xargs -n 1 | \sed "s/^$opt$/defconfig:$opt/" | xargs)fidone# Options checkingCMDS="$(run_build_hooks support-cmds all | xargs)"for opt in $OPTIONS; docase "$opt" inhelp | h | -h | --help | usage | \?) usage ;;clean:*)# Check cleanup modulesfor m in $(echo ${opt#clean:} | tr ':' ' '); dogrep -wq clean_hook \"$SCRIPTS_DIR/mk-$m.sh" \2>/dev/null || usagedone;&shell | cleanall)# Check single optionsif [ "$opt" = "$OPTIONS" ]; thenbreakfiecho "ERROR: $opt cannot combine with other options!";;post-rootfs)if [ "$opt" = "$1" -a -d "$2" ]; then# Hide other args from build stagesOPTIONS=$optbreakfiecho "ERROR: $opt should be the first option followed by rootfs dir!";;*)# Make sure that all options are handledif option_check "$CMDS" $opt; thencontinuefiecho "ERROR: Unhandled option: $opt";;esacusagedone# Prepare log dirsif [ ! -d "$RK_LOG_DIR" ]; thenrm -rf "$RK_LOG_BASE_DIR" "$RK_LOG_DIR" "$RK_SESSION_DIR/latest"mkdir -p "$RK_LOG_DIR"ln -rsf "$RK_SESSION_DIR" "$RK_LOG_BASE_DIR"ln -rsf "$RK_LOG_DIR" "$RK_SESSION_DIR/latest"echo -e "\e[33mLog saved at $RK_LOG_DIR\e[0m"echofi# Drop old logscd "$RK_LOG_BASE_DIR"rm -rf $(ls -t | sed '1,10d')cd "$SDK_DIR"# Save initial envionmentsif [ "$INITIAL_SESSION" ]; thenrm -f "$RK_INITIAL_ENV"mv "$INITIAL_ENV" "$RK_INITIAL_ENV"ln -rsf "$RK_INITIAL_ENV" "$RK_OUTDIR/"fi# Init stage (preparing SDK configs, etc.)run_build_hooks init $OPTIONSrm -f "$RK_OUTDIR/.tmpconfig*"# No need to go furtherCMDS="$(run_build_hooks support-cmds pre-build build \post-build | xargs) cleanall clean post-rootfs"option_check "$CMDS" $OPTIONS || return 0# Force exporting config environmentsset -a# Load config environmentssource "$RK_CONFIG"cp "$RK_CONFIG" "$RK_LOG_DIR"if [ -z "$INITIAL_SESSION" ]; then# Inherit session environmentssed -n 's/^\(RK_.*=\)\(.*\)/\1"\2"/p' "$RK_FINAL_ENV" > \"$INITIAL_ENV"source "$INITIAL_ENV"rm -f "$INITIAL_ENV"else# Detect and save custom environments# Find custom environmentsrm -f "$RK_CUSTOM_ENV"for cfg in $(grep "^RK_" "$RK_INITIAL_ENV" || true); doenv | grep -q "^${cfg//\"/}$" || \echo "$cfg" >> "$RK_CUSTOM_ENV"done# Allow custom environments overridingif [ -e "$RK_CUSTOM_ENV" ]; thenln -rsf "$RK_CUSTOM_ENV" "$RK_OUTDIR/"echo -e "\e[31mWARN: Found custom environments: \e[0m"cat "$RK_CUSTOM_ENV"echo -e "\e[31mAssuming that is expected, please clear them if otherwise.\e[0m"read -t 10 -p "Press enter to continue."source "$RK_CUSTOM_ENV"if grep -q "^RK_KERNEL_VERSION=" "$RK_CUSTOM_ENV"; thenecho -e "\e[31mCustom RK_KERNEL_VERSION ignored!\e[0m"load_config RK_KERNEL_VERSIONfiif grep -q "^RK_ROOTFS_SYSTEM=" "$RK_CUSTOM_ENV"; thenecho -e "\e[31mCustom RK_ROOTFS_SYSTEM ignored!\e[0m"load_config RK_ROOTFS_SYSTEMfififisource "$PARTITION_HELPER"rk_partition_initset +aexport PYTHON3=/usr/bin/python3export RK_KERNEL_VERSION_REAL=$(kernel_version_real)# Handle special commandscase "$OPTIONS" incleanall)run_build_hooks cleanrm -rf "$RK_OUTDIR" "$SDK_DIR/rockdev"finish_build cleanallexit 0 ;;clean:*)MODULES="$(echo ${OPTIONS#clean:} | tr ':' ' ')"for m in $MODULES; do"$SCRIPTS_DIR/mk-$m.sh" cleandonefinish_build clean - $MODULESexit 0 ;;post-rootfs)shiftrun_post_hooks $@finish_build post-rootfsexit 0 ;;esac# Save final environmentsrm -f "$RK_FINAL_ENV"env > "$RK_FINAL_ENV"ln -rsf "$RK_FINAL_ENV" "$RK_OUTDIR/"# Log configsechoecho "=========================================="echo "          Final configs"echo "=========================================="env | grep -E "^RK_.*=.+" | grep -vE "PARTITION_[0-9]" | \grep -vE "=\"\"$|_DEFAULT=y" | \grep -vE "^RK_CONFIG|_BASE_CFG=|_LINK=|DIR=|_ENV=|_NAME=" | sortecho# Pre-build stage (submodule configuring, etc.)run_build_hooks pre-build $OPTIONS# No need to go furtherCMDS="$(run_build_hooks support-cmds build post-build | xargs)"option_check "$CMDS" $OPTIONS || return 0# Build stage (building, etc.)run_build_hooks build $OPTIONS# No need to go furtherCMDS="$(run_build_hooks support-cmds post-build | xargs)"option_check "$CMDS" $OPTIONS || return 0# Post-build stage (firmware packing, etc.)run_build_hooks post-build $OPTIONS
}
1.1.1 提示模式和错误处理

调试模式设置:首先通过判断是否设置了环境变量DEBUG,决定是否启用调试模式。如果 DEBUG 被设置为非空值,则运行 set -x 开启调试模式,这样脚本执行时会显示每一行命令的执行情况。

错误处理:使用 trapERR 捕获脚本中的错误。一旦发生错误,将调用 err_handler 函数;同时,set -eE 确保如果任何命令失败,脚本会立即退出,并且支持 ERR 跟踪。

保存初始环境变量:接着尝试保存当前的环境变量到一个临时文件中。首先,它解除定义了 INITIAL_SESSION 变量(如果存在),然后使用 mktemp -u 生成一个唯一的临时文件路径。如果 RK_SESSION 变量未设置,则认为这是一个新的会话,并将所有当前环境变量保存到生成的临时文件中。

1.1.2 设置环境变量

接着是设置一系列环境变,这些变量定义了一些重要的目录路径,通常在脚本执行过程中会用到这些路径。

export LC_ALL=Cexport SCRIPTS_DIR="$(dirname "$(realpath "$BASH_SOURCE")")"
export COMMON_DIR="$(realpath "$SCRIPTS_DIR/..")"
......

realpath "$BASH_SOURCE" 获取当前脚本的绝对路径,由于build.sh指向了device/rockchip/common/scripts/build.sh;所以:

SCRIPTS_DIR=<SDK>/device/rockchip/common/scripts
COMMON_DIR=<SDK>/device/rockchip/common
SDK_DIR=<SDK>
DEVICE_DIR=<SDK>/device/rockchip
CHIPS_DIR=<SDK>/device/rockchip/.chips
CHIP_DIR=<SDK>/device/rockchip/.chip
RK_DATA_DIR=<SDK>/device/rockchip/common/data
RK_TOOL_DIR=<SDK>/device/rockchip/common/tools
RK_IMAGE_DIR=<SDK>/device/rockchip/common/images
RK_KBUILD_DIR=<SDK>/device/rockchip/common/linux-kbuild
RK_CONFIG_IN=<SDK>/device/rockchip/common/configs/Config.in
RK_BUILD_HOOK_DIR=<SDK>/device/rockchip/common/build-hooks
BUILD_HELPER=<SDK>/device/rockchip/common/build-hooks/build-helper
RK_POST_HOOK_DIR=<SDK>/device/rockchip/common/post-hooks
POST_HELPER=<SDK>/device/rockchip/common/post-hooks/post-helper
PARTITION_HELPER=<SDK>/device/rockchip/common/scripts/partition-helper
RK_SESSION=2024-07-08_21-52-58
RK_OUTDIR=<SDK>/output
RK_SESSION_DIR=<SDK>output/sessions
RK_LOG_BASE_DIR=<SDK>/output/log
RK_LOG_DIR=<SDK>/output/sessions/2024-07-08_21-52-58
RK_INITIAL_ENV=<SDK>/output/sessions/2024-07-08_21-52-58/initial.env
RK_CUSTOM_ENV=<SDK>/output/sessions/2024-07-08_21-52-58/custom.env
RK_FINAL_ENV=<SDK>/output/sessions/2024-07-08_21-52-58/final.env
RK_ROCKDEV_DIR=<SDK>/rockdev
RK_FIRMWARE_DIR=<SDK>/output/firmware
RK_SECURITY_FIRMWARE_DIR=<SDK>/output/security-firmware
RK_CONFIG=<SDK>/output/.config
RK_DEFCONFIG_LINK=<SDK>/output/defconfig
1.1.3 选项make-targets/make-usage

接着就是对选项make-targetsmake-usage的支持,实际上也是输出帮助信息。

1.1.4 选项chip/defconfig

接着就是对如下选项的支持:

  • chip[:<chip>[:<config>]] <chip>可选,表示SoC,比如rk3588<config>可选,表示板级配置,比如rockchip_defconfig
  • defconfig[:<config>]:<config>可选,表示板级配置,比如rockchip_defconfig

(1) 如果有参数传递给脚本,则OPTIONS被设置为这些参数的组合;如果没有参数传递,则OPTIONS被设置为 allsave

(2) 接着对$OPTIONS变量进行特殊处理,用于处理 chipdefconfig的情况。它会检查每个参数,并根据特定的条件对其进行转换。

首先:

if [ -d "$CHIPS_DIR/${opt%%:*}" ]; thenOPTIONS=$(echo "$OPTIONS" | xargs -n 1 | \sed "s/^$opt$/chip:$opt/" | xargs)

检查是否存在以$CHIPS_DIR开头、后面跟着$opt变量:分隔之前的字符串作为目录名, 如果满足;修改 $OPTIONS 变量,替换内容$optchip:$opt

  • 比如./builsh rk3588:rockchip_defconfigopt=rk3588:rockchip_defconfig,处理后OPTIONS=chip:rk3588:rockchip_defconfig

接着:

elif echo "$opt" | grep -q "^[0-9a-z_]*_defconfig$"; thenOPTIONS=$(echo "$OPTIONS" | xargs -n 1 | \sed "s/^$opt$/defconfig:$opt/" | xargs)
fi

如果是以_defconfig结尾命名,修改 $OPTIONS 变量,替换内容$optdefconfig:$opt

  • 比如./builsh rockchip_defconfigopt=rockchip_defconfig,处理后OPTIONS=defconfig:rockchip_defconfig
1.1.5 选项检查

首先是获取支持的所有命令:

CMDS="$(run_build_hooks support-cmds all | xargs)"

xargs 将会把 run_build_hooks support-cmds all 的输出(echo函数的输出)捕获,并通过管道传递给 xargs

由于run_build_hooks函数会依次执行<SDK>/device/rockchip/common/build-hooks下的*.sh脚本,因此CMDS存储的就是这些脚本执行的输出,具体分析参考后文《run_build_hooks》。

执行完毕CMDS中存储build.sh支持的所有命令;

CMDS='chip defconfig lunch .*_defconfig olddefconfig savedefconfig menuconfig config shell print-parts mod-parts edit-parts new-parts insert-part del-part move-part rename-part resize-part kernel-config kernel-make kmake kernel modules linux-headers wifibt rtos buildroot debian yocto buildroot-config buildroot-make bmake rootfs buildroot debian yocto recovery pcba security_check createkeys security_ramboot security_uboot security_boot security_recovery security_rootfs loader uboot uefi firmware edit-package-file edit-ota-package-file edit-package-file edit-ota-package-file updateimg otapackage all allsave save'

接着是一段选项检查的代码;

for opt in $OPTIONS; docase "$opt" inhelp | h | -h | --help | usage | \?) usage ;;clean:*)# Check cleanup modulesfor m in $(echo ${opt#clean:} | tr ':' ' '); dogrep -wq clean_hook \"$SCRIPTS_DIR/mk-$m.sh" \2>/dev/null || usagedone;&shell | cleanall)# Check single optionsif [ "$opt" = "$OPTIONS" ]; thenbreakfiecho "ERROR: $opt cannot combine with other options!";;post-rootfs)if [ "$opt" = "$1" -a -d "$2" ]; then# Hide other args from build stagesOPTIONS=$optbreakfiecho "ERROR: $opt should be the first option followed by rootfs dir!";;*)# Make sure that all options are handledif option_check "$CMDS" $opt; thencontinuefiecho "ERROR: Unhandled option: $opt";;esacusage
done

根据传入的选项($OPTIONS)进行判断和处理,这里遍历选项依次执行:

  • 当选项满足help | h | -h | --help | usage | \?,执行usage函数。比如我们前文执行 ./build.sh help,就是则调用usage函数来显示帮助信息;
  • 如果选项以 clean: 开头,则验证验证相应的清理模块是否存在,比如./build.sh clean:kernel,则判断"device/rockchip/common/scripts/mk-kernel.sh/mk-kernel.sh中是否包含clean_hook方法;后续会调用mk-kernel.sh clean执行清理工作;
  • 如果选项是shellcleanall,执行函数run_build_hooks clean,该函数则会遍历device/rockchip/common/scriptsshell脚本文件,并传入clean参数函数依次执行;
  • 如果选项是post-rootfs,并且满足上面的条件,则设置OPTIONS=$opt
  • 如果不满足以上条件,则调用option_check函数检查给定的命令选项是否在指定的命令列表中,如果匹配失败,则输出错误信息,并调用usage函数。
1.1.6 准备日志目录

接着是创建编译日志目录:

# Prepare log dirs
if [ ! -d "$RK_LOG_DIR" ]; thenrm -rf "$RK_LOG_BASE_DIR" "$RK_LOG_DIR" "$RK_SESSION_DIR/latest"mkdir -p "$RK_LOG_DIR"ln -rsf "$RK_SESSION_DIR" "$RK_LOG_BASE_DIR"ln -rsf "$RK_LOG_DIR" "$RK_SESSION_DIR/latest"echo -e "\e[33mLog saved at $RK_LOG_DIR\e[0m"echo
fi

首先判断日志目录$RK_LOG_DIR是否存在,如果该目录不存在,则执行一系列操作来创建目录结构并设置符号链接,将 $RK_LOG_DIR符号链接到$RK_SESSION_DIR/latest,确保最新日志目录符号链接始终指向最新的日志目录。

1.1.7 清理旧日志

接着是清理日志目录,只保留最新的10次编译的日志记录:

# Drop old logs
cd "$RK_LOG_BASE_DIR"
rm -rf $(ls -t | sed '1,10d')
cd "$SDK_DIR"

跳转到<SDK>/output/log目录,把除了最新的10个文件或目录外的所有内容传递给rm -rf命令进行删除操作。

1.1.8 保存初始化环境变量

接着是保存初始化环境变量;

# Save initial envionments
if [ "$INITIAL_SESSION" ]; thenrm -f "$RK_INITIAL_ENV"mv "$INITIAL_ENV" "$RK_INITIAL_ENV"ln -rsf "$RK_INITIAL_ENV" "$RK_OUTDIR/"
fi

由于前文设置INITIAL_ENV=$(mktemp-u),即使用mktemp -u生成一个唯一的临时文件路径,比如/tmp/tmp.ag1ffjvNMG

因此该段脚本:

  • 它会先删除旧的<SDK>/output/sessions/initial.env文件;
  • 然后将临时文件移动并重命名为<SDK>/output/sessions/$RK_SESSION/initial.env
  • 最后在指定的输出目录<SDK>/output下创建一个指向<SDK>/output/sessions/$RK_SESSION/initial.env的符号链接。
1.1.9 初始化阶段

脚本进入初始化阶段,用于准备SDK配置等工作;

# Init stage (preparing SDK configs, etc.)
run_build_hooks init $OPTIONS
rm -f "$RK_OUTDIR/.tmpconfig*"

这里再次调用run_build_hooks函数,入参为init $OPTIONS,具体分析参考后文《run_build_hooks》。

1.1.10 选项检查

接下来就是判断我们传入的选项是否是build.sh pre-build build post-build阶段中定义的命令。

# No need to go further
CMDS="$(run_build_hooks support-cmds pre-build build \post-build | xargs) cleanall clean post-rootfs"
option_check "$CMDS" $OPTIONS || return 0

xargs 将会把 run_build_hooks support-cmds pre-build build post-build 的输出(echo函数的输出)捕获,并通过管道传递给 xargs

由于run_build_hooks函数会依次执行<SDK>/device/rockchip/common/build-hooks下的sh脚本,因此CMDS存储的就是这些脚本执行的输出。

执行完毕CMDS中存储build.shpre-build build post-build阶段中支持的命令;

CMDS='shell print-parts mod-parts edit-parts new-parts insert-part del-part move-part rename-part resize-part kernel-config kernel-make kmake kernel modules linux-headers wifibt rtos buildroot-config buildroot-make bmake rootfs buildroot debian yocto recovery pcba security_check createkeys security_ramboot security_uboot security_boot security_recovery security_rootfs loader uboot uefi firmware edit-package-file edit-ota-package-file updateimg otapackage all allsave save cleanall clean post-rootfs'

接着调用option_check检查变量CMDS中的命令是否包含在$OPTIONS指定的选项中。

  • 如果找到任何一个在任何一个选项中有匹配,则函数返回0,表示命令匹配成功;
  • 如果所有的命令都没有在任何一个选项中找到匹配,则函数最终返回1,表示命令匹配失败。

如果option_check函数返回非0值(即失败),则执行return 0,表示退出当前函数。

1.1.11 导出config environments
# Force exporting config environments
set -a# Load config environments
source "$RK_CONFIG"
cp "$RK_CONFIG" "$RK_LOG_DIR"if [ -z "$INITIAL_SESSION" ]; then# Inherit session environmentssed -n 's/^\(RK_.*=\)\(.*\)/\1"\2"/p' "$RK_FINAL_ENV" > \"$INITIAL_ENV"source "$INITIAL_ENV"rm -f "$INITIAL_ENV"
else# Detect and save custom environments# Find custom environmentsrm -f "$RK_CUSTOM_ENV"for cfg in $(grep "^RK_" "$RK_INITIAL_ENV" || true); doenv | grep -q "^${cfg//\"/}$" || \echo "$cfg" >> "$RK_CUSTOM_ENV"done# Allow custom environments overridingif [ -e "$RK_CUSTOM_ENV" ]; thenln -rsf "$RK_CUSTOM_ENV" "$RK_OUTDIR/"echo -e "\e[31mWARN: Found custom environments: \e[0m"cat "$RK_CUSTOM_ENV"echo -e "\e[31mAssuming that is expected, please clear them if otherwise.\e[0m"read -t 10 -p "Press enter to continue."source "$RK_CUSTOM_ENV"if grep -q "^RK_KERNEL_VERSION=" "$RK_CUSTOM_ENV"; thenecho -e "\e[31mCustom RK_KERNEL_VERSION ignored!\e[0m"load_config RK_KERNEL_VERSIONfiif grep -q "^RK_ROOTFS_SYSTEM=" "$RK_CUSTOM_ENV"; thenecho -e "\e[31mCustom RK_ROOTFS_SYSTEM ignored!\e[0m"load_config RK_ROOTFS_SYSTEMfifi
fisource "$PARTITION_HELPER"
rk_partition_initset +a
1.1.12 选项claenall/clean:*/post-rootfs
export PYTHON3=/usr/bin/python3
export RK_KERNEL_VERSION_REAL=$(kernel_version_real)# Handle special commands
case "$OPTIONS" incleanall)run_build_hooks cleanrm -rf "$RK_OUTDIR" "$SDK_DIR/rockdev"finish_build cleanallexit 0 ;;clean:*)MODULES="$(echo ${OPTIONS#clean:} | tr ':' ' ')"for m in $MODULES; do"$SCRIPTS_DIR/mk-$m.sh" cleandonefinish_build clean - $MODULESexit 0 ;;post-rootfs)shiftrun_post_hooks $@finish_build post-rootfsexit 0 ;;
esac
1.1.13 保存final环境变量
# Save final environments
rm -f "$RK_FINAL_ENV"
env > "$RK_FINAL_ENV"
ln -rsf "$RK_FINAL_ENV" "$RK_OUTDIR/"
1.1.14 预编译/编译/编译后
# Log configs
echo
echo "=========================================="
echo "          Final configs"
echo "=========================================="
env | grep -E "^RK_.*=.+" | grep -vE "PARTITION_[0-9]" | \grep -vE "=\"\"$|_DEFAULT=y" | \grep -vE "^RK_CONFIG|_BASE_CFG=|_LINK=|DIR=|_ENV=|_NAME=" | sort
echo# Pre-build stage (submodule configuring, etc.)
run_build_hooks pre-build $OPTIONS# No need to go further
CMDS="$(run_build_hooks support-cmds build post-build | xargs)"
option_check "$CMDS" $OPTIONS || return 0# Build stage (building, etc.)
run_build_hooks build $OPTIONS# No need to go further
CMDS="$(run_build_hooks support-cmds post-build | xargs)"
option_check "$CMDS" $OPTIONS || return 0# Post-build stage (firmware packing, etc.)
run_build_hooks post-build $OPTIONS
1.2 option_check

option_check函数检查给定的命令选项是否在指定的命令列表中。

option_check()
{# 将第一个参数$1赋值给变量CMDS,这个参数是一组命令列表,用空格分隔CMDS="$1"# 将参数列表向左移动一位,去掉了第一个参数(即CMDS),剩下的参数存储在$@中shift# 嵌套循环检查选项和命令for opt in $@; do     # 遍历传递给函数的所有剩余参数(除了第一个参数CMDS)for cmd in $CMDS; do    # 再嵌套一个循环,遍历存储在CMDS变量中的命令列表# NOTE: There might be patterns in commands 检查命令是否匹配选项,如果grep 命令没有匹配到,则继续下一次循>环echo "${opt%%:*}" | grep -q "^$cmd$" || continue# 如果匹配成功,则返回状态码 0,表示找到了匹配的命令选项return 0donedonereturn 1
}

比如我们给函数传入:

commands="run jump swim"
option_check "$commands" run swim sleep

在这个示例中:

  • $commands被传递给CMDS变量,即CMDS="run jump swim;
  • run swim sleep是要检查的选项,即option1=runoption2=swimoption3=sleep
    函数会逐个检查每个选项是否在命令列表CMDS中,如果找到任意匹配的命令,则返回状态码0;否则返回状态码1。
1.3 run_hooks

run_hooks在指定目录中查找并执行所有以 .sh 结尾的脚本文件。如果执行任何一个脚本失败,它将调用错误处理函数 err_handler 处理错误,并以失败的返回码退出整个脚本。

run_hooks()
{# 将第一个参数$1赋值给变量DIRDIR="$1"# 将参数列表向左移动一位,去掉了第一个参数(即DIR),剩下的参数存储在$@中shift# 遍历目录for dir in "$CHIP_DIR/$(basename "$DIR")/" "$DIR"; do# 当前的$dir是否是一个存在的目录。如果不是,则继续到下一个循环迭代[ -d "$dir" ] || continue# 在$dir目录下(不深入子目录,-maxdepth 1)查找所有以.sh结尾的文件for hook in $(find "$dir" -maxdepth 1 -name "*.sh" | sort); do"$hook" $@ && continue   # *.sh退出状态码为0则执行continueHOOK_RET=$?err_handler $HOOK_RET "${FUNCNAME[0]} $*" "$hook $*"exit $HOOK_RETdonedone
}

比如我们给函数传入:

RK_BUILD_HOOK_DIR=<SDK>/device/rockchip/common/build-hooks
run_hooks "$RK_BUILD_HOOK_DIR" support-cmds all

在这个示例中:

  • 将遍历目录<SDK>/device/rockchip/.chip/build-hooks<SDK>/device/rockchip/common/build-hooks

  • 由于<SDK>/device/rockchip/.chip/build-hooks不是目录将跳过;

  • 接着在<SDK>/device/rockchip/common/build-hooks 目录下(不深入子目录,-maxdepth 1)查找所有以.sh 结尾的文件;依次执行

    • 执行找到的每一个脚本文件,传递参数support-cmds all
    • 如果执行成功(exit 0),则继续下一个钩子脚本的执行;
    • 如果执行失败(exit 非0),调用err_handler 函数处理错误,传递错误码、当前函数名以及传递给当前函数的所有参数,以HOOK_RET的值退出脚本,终止整个构建过程。

我们查看<SDK>/device/rockchip/common/build-hooks目录下的sh脚本;

root@ubuntu:/work/sambashare/rk3588/armsom/armsom-rk3588-bsp$ ll device/rockchip/common/build-hooks/
lrwxrwxrwx  1 root root   23  6月  9 12:58 00-config.sh -> ../scripts/mk-config.sh*
lrwxrwxrwx  1 root root   22  6月  9 12:58 00-shell.sh -> ../scripts/mk-shell.sh*
lrwxrwxrwx  1 root root   27  6月  9 12:58 05-partitions.sh -> ../scripts/mk-partitions.sh*
lrwxrwxrwx  1 root root   23  6月  9 12:58 10-kernel.sh -> ../scripts/mk-kernel.sh*
lrwxrwxrwx  1 root root   23  6月  9 12:58 20-wifibt.sh -> ../scripts/mk-wifibt.sh*
lrwxrwxrwx  1 root root   21  6月  9 12:58 25-rtos.sh -> ../scripts/mk-rtos.sh*
lrwxrwxrwx  1 root root   23  6月  9 12:58 30-rootfs.sh -> ../scripts/mk-rootfs.sh*
lrwxrwxrwx  1 root root   25  6月  9 12:58 40-recovery.sh -> ../scripts/mk-recovery.sh*
lrwxrwxrwx  1 root root   21  6月  9 12:58 50-pcba.sh -> ../scripts/mk-pcba.sh*
lrwxrwxrwx  1 root root   25  6月  9 12:58 60-security.sh -> ../scripts/mk-security.sh*
lrwxrwxrwx  1 root root   23  6月  9 12:58 70-loader.sh -> ../scripts/mk-loader.sh*
lrwxrwxrwx  1 root root   25  6月  9 12:58 80-firmware.sh -> ../scripts/mk-firmware.sh*
lrwxrwxrwx  1 root root   26  6月  9 12:58 90-updateimg.sh -> ../scripts/mk-updateimg.sh*
lrwxrwxrwx  1 root root   20  6月  9 12:58 99-all.sh -> ../scripts/mk-all.sh*
lrwxrwxrwx  1 root root   23  6月  9 12:58 build-helper -> ../scripts/build-helper
-rwxr-xr-x  1 root root 4210  6月  9 12:58 example.sh.in*

其中,比较重要的有:

  • 00-config.sh:板载配置相关,支持的编译选项有chipdefconfigmenuconfig等;
  • 05-partitions.sh:分区配置相关,支持的编译选项有:print-partsmod-parts edit-parts等;
  • 10-kernel.sh:内核编译相关,支持的编译选项有:kernelmoduleslinux-headers等;
  • 20-wifibt.shwifibt编译相关;
  • 30-rootfs.sh:根文件系统编译相关,支持的编译选项有:buildrootyoctodebian等;
  • 40-recovery.shrecovery编译相关;
  • 70-loader.shuboot编译相关,支持的编译选项有:loader[:cmds]uboot[:cmds] uefi[:cmds] 等;
  • 80-firmware.sh:分区镜像打包相关;
  • 90-updateimg.sh:统一固件打包相关;
  • 99-all.sh :所有,支持的编译选项有:allsave等;

在该示例中将会按顺序依次执行*.sh脚本,并传递参数support-cmds all,有关这些*.sh脚本的执行我们在后面介绍。

1.4 run_build_hooks

run_build_hooks函数作用是运行一些构建过程中的钩子(hooks),并且记录执行日志。

run_build_hooks()
{# Don't log these hookscase "$1" ininit | pre-build | make-* | usage | support-cmds)run_hooks "$RK_BUILD_HOOK_DIR" $@ || truereturn 0;;esac# 设置日志文件LOG_FILE="$(start_log "$1")"# 记录运行日志echo -e "# run hook: $@\n" >> "$LOG_FILE"# 运行钩子并记录输出run_hooks "$RK_BUILD_HOOK_DIR" $@ 2>&1 | tee -a "$LOG_FILE"# 处理钩子执行结果HOOK_RET=${PIPESTATUS[0]}if [ $HOOK_RET -ne 0 ]; thenerr_handler $HOOK_RET "${FUNCNAME[0]} $*" "$@"exit $HOOK_RETfi
}

函数执行流程如下:

  • 根据传递给函数的第一个参数$1进行匹配,如果$1匹配到initpre-build、以make-开头的任意字符串、usage或者 support-cmds中的一个;

    • 调用run_hooks函数,并传递参数<SDK>/device/rockchip/common/build-hooks$@(所有传递给当前函数的参数);
    • || true 确保即使run_hooks函数失败,也不会中断执行;
    • 返回状态码 0,表示成功执行;
  • 设置日志文件:LOG_FILE被设置为一个日志文件的路径,使用start_log函数生成基于传入参数$1的日志文件名;

  • 记录运行日志:将# run hook: $@打印到$LOG_FILE中;

  • 运行钩子并记录输出:

    • 再次调用run_hooks函数,传递<SDK>/device/rockchip/common/build-hooks$@,标准错误(2)输出到(>)到标准输出(&1);
    • 将标准错误输出重定向到标准输出,这样可以确保错误信息也被tee命令捕获到;
    • tee -a将管道中的输出同时输出到标准输出和追加到$LOG_FILE文件中;
  • 处理钩子执行结果:将管道中上一个命令的退出状态保存在HOOK_RET变量中,PIPESTATUS[0]Bash 内置的数组,包含了最近一个管道中命令的退出状态;

    • 如果HOOK_RET不等于 0,则表示有错误发生;
    • 调用err_handler 数处理错误,传递错误码、当前函数名以及传递给当前函数的所有参数;
    • HOOK_RET的值退出脚本,终止整个构建过程。

在编译过程中,main函数多次调用run_build_hooks 函数的,其执行顺序依次为;

  • run_build_hooks support-cmds all
  • run_build_hooks init recovery
  • run_build_hooks support-cmds pre-build build post-build
  • run_build_hooks pre-build recovery
  • run_build_hooks support-cmds build post-build
  • run_build_hooks build recovery
  • run_build_hooks support-cmds post-build
  • run_build_hooks post-buildrecovery

二、build-helper

build-helper从文件名字不难猜测出来这是一个编译辅助脚本,其位于<SDK>/device/rockchip/common/build-hooks目录下,提供了若干个辅助函数。

2. 1 脚本入口

build-helper脚本会被<SDK>/device/rockchip/common/build-hooks下的所有*.sh脚本调用,并传入不同的参数,比如:

  • support-cmds all
  • init recovery
  • support-cmds pre-build build post-build
  • pre-build recovery
  • support-cmds build post-build
  • build recovery
  • support-cmds post-build;
  • post-build recovery

其中:recovery可以替换成./build.sh支持的任意选项,比如allbuildrootubootkernel等。

脚本入口代码如下:

......# 跳转到<SDK>目录
cd "$SDK_DIR"# 比如 LOG_FILE_NAME=$(*.sh脚本名称,比如00-config)-(参数1,比如`support-cmds`)_2024-07-08_21-12-25
LOG_FILE_NAME="$(basename "${0%.sh}")-$1_$(date +"%F_%H-%M-%S")"case "$1" inhelp | h | -h | --help | \?) usage ;;make-targets) make_targets; exit 0 ;;make-usage) make_usage; exit 0 ;;usage) usage_hook; exit 0 ;;support-cmds)   # 将参数列表向左移动一位,去掉了第一个参数(support-cmds),剩下的参数存储在$@中(即all)shift{ALL_CMDS="$INIT_CMDS $PRE_BUILD_CMDS $BUILD_CMDS \$POST_BUILD_CMDS"for stage in ${@:-all}; docase $stage ininit) echo "$INIT_CMDS" ;;pre-build) echo "$PRE_BUILD_CMDS" ;;build) echo "$BUILD_CMDS" ;;post-build) echo "$POST_BUILD_CMDS" ;;# 走这里,输出支持的命令 chip defconfig lunch .*_defconfig olddefconfig savedefconfig menuconfig configall) echo "$ALL_CMDS" ;;   esacdone} | xargs -n 1 | grep -v "^default$" | xargs || true   # 过滤掉单独包含 "default" 的行,然后将剩余的行作为参数依次传递给下一个命令exit 0;;clean)try_func clean_hookexit 0;;init)shifttry_hook init_hook "$INIT_CMDS" $@exit 0;;pre-build)shifttry_hook pre_build_hook "$PRE_BUILD_CMDS" $@exit 0;;build)shifttry_hook build_hook "$BUILD_CMDS" $@exit 0;;post-build)shifttry_hook post_build_hook "$POST_BUILD_CMDS" $@exit 0;;
esacif [ "$DRY_RUN" ]; thenecho "Environment 'DRY_RUN' ignored!"unset DRY_RUN
fiif [ "$2" = cmds ]; thenexport DRY_RUN=1
fi
2.1.1 入参为support-cmds all

如果入参为support-cmds all,代码会进入support-cmds分支;

support-cmds)    # 走这里# 将参数列表向左移动一位,去掉了第一个参数(support-cmds),剩下的参数存储在$@中(即all)shift{ALL_CMDS="$INIT_CMDS $PRE_BUILD_CMDS $BUILD_CMDS \$POST_BUILD_CMDS"for stage in ${@:-all}; docase $stage ininit) echo "$INIT_CMDS" ;;pre-build) echo "$PRE_BUILD_CMDS" ;;build) echo "$BUILD_CMDS" ;;post-build) echo "$POST_BUILD_CMDS" ;;# 走这里,输出支持的命令 chip defconfig lunch .*_defconfig olddefconfig savedefconfig menuconfig configall) echo "$ALL_CMDS" ;;   esacdone} | xargs -n 1 | grep -v "^default$" | xargs || true   # 过滤掉单独包含 "default" 的行,然后将剩余的行作为参数依次传递给下一个命令exit 0;;

首先输出ALL_CMDS,最后执行exit 0退出*.sh脚本(build-heleper是在*.sh脚本中以source方式执行的)文件的执行;

通过代码分析,我们可以得到入参第一个参数为support-cmds的命令均会进入该分支:

  • support-cmds all

  • support-cmds pre-build build post-build

  • support-cmds build post-build

  • support-cmds post-build;

脚本根据support-cmds之后的参数来执行不同的处理逻辑,比如:

  • all:输出所有支持的命令,包括INIT_CMDSPRE_BUILD_CMDSBUILD_CMDSPOST_BUILD_CMDS
  • pre-build:输出PRE_BUILD_CMDS
  • build:输出BUILD_CMDS
  • post-build:输出POST_BUILD_CMDS

由于<SDK>/device/rockchip/common/build-hooks目录下各个*.sh脚本中支持的INIT_CMDSPRE_BUILD_CMDSBUILD_CMDSPOST_BUILD_CMDS是不同的,因此每个*.sh脚本在使用source命令执行build-helper脚本时输出也是不同的。

我们以如下命令为例:

CMDS="$(run_build_hooks support-cmds all | xargs)"

xargs 将会把 run_build_hooks support-cmds all 的输出(echo函数的输出)捕获,并通过管道传递给 xargs。由于run_build_hooks函数会依次执行*.sh脚本,因此CMDS存储的就是这些脚本执行的输出结果。

2.1.2 入参为init recovery

如果入参为init recovery,代码会进入init分支;

init)# 将参数列表向左移动一位,去掉了第一个参数(support-cmds),剩下的参数存储在$@中(即recovery)shifttry_hook init_hook "$INIT_CMDS" $@exit 0;;

接着会执行try_hook函数,具体参考《try_hook分析》。

2.1.3 入参为pre-build recovery

如果入参为pre-build recovery,代码会进入pre-build分支;

pre-build)shifttry_hook pre_build_hook "$PRE_BUILD_CMDS" $@exit 0;;

接着会执行try_hook函数,具体参考《try_hook分析》。

2.1.4 入参为build recovery

如果入参为build recovery,代码会进入build分支;

build)shifttry_hook build_hook "$BUILD_CMDS" $@exit 0;;

接着会执行try_hook函数,具体参考《try_hook分析》。

2.1.5 入参为post-build recovery

如果入参为post-build recovery,代码会进入post-build分支;

post-build)shifttry_hook post_build_hook "$POST_BUILD_CMDS" $@exit 0;;

接着会执行try_hook函数,具体参考《try_hook分析》。

2.2 err_handler

error处理函数,脚本中的任何命令失败(即退出状态为非零),那么就会调用err_handler函数;

err_handler()
{# 如果参数1为空,则获取最近一次执行命令的退出状态ret=${1:-$?}# 退出状态为0,直接返回[ "$ret" -eq 0 ] && return# 入参参数2为空,输出调用栈中的第二个函数名echo "ERROR: Running $0 - ${2:-${FUNCNAME[1]}} failed!"# 输出错误状态码,以及发生错误的行号echo "ERROR: exit code $ret from line ${BASH_LINENO[0]}:"# 如果参数3为空,输出当前正在执行的命令echo "    ${3:-$BASH_COMMAND}"echo "ERROR: call stack:"for i in $(seq 1 $((${#FUNCNAME[@]} - 1))); doSOURCE="${BASH_SOURCE[$i]}"LINE=${BASH_LINENO[$(( $i - 1 ))]}echo "    $(basename "$SOURCE"): ${FUNCNAME[$i]}($LINE)"doneexit $ret
}
trap 'err_handler' ERR
set -eE
2.3 try_hook

try_hook函数接收3个参数:

  • 参数1是被调用的hook函数;
  • 参数2是hook函数支持的命令数组CMDS
  • 参数3是当前需要执行的任一选项命令;

函数定义如下:

try_hook()
{# init_hook、pre_build_hook等FUNC=$1# 将参数列表向左移动一位,去掉了第一个参数(init_hook)shift# 支持的命令数组CMDS="$1"# 将参数列表向左移动一位,去掉了第二个参数(CMDS)shift# 配以default开头并且后面跟着一个空格或者直接是行尾的行if echo "$CMDS" | grep -qE "^default( |$)"; thenOPTS="default $@"else# 一般走这里OPTS="$@ default"fi# 检查名为$FUNC的函数是否存在并且可执行,不存在或不可执行则return 0type $FUNC >/dev/null 2>/dev/null || return 0# 遍历选项数组for opt in $OPTS; do#匹配包含:cmds这个字符串,并且后面紧跟着一个冒号:,或者是行尾的地方  比如opt="recovery:cmds",IS_DRY_RUN=$(echo $opt | grep -E ":cmds(:|$)" || true)# 遍历命令数组for cmd in $CMDS; do# NOTE: There might be patterns in commands .... default 姑且认为查找opt、cmd相等的项ARGS="$(echo $opt | grep -E "^$cmd(:|$)" | \tr ':' ' ' || true)"[ "$ARGS" ] || continue# D优先使用DRY_RUN变量的值,如果DRY_RUN不存在或为空,则根据IS_DRY_RUN的值来决定是否展开为1。DRY_RUN=${DRY_RUN:-${IS_DRY_RUN:+1}} \try_func $FUNC $ARGSdonedone
}

这里我们姑且认为双层循环就是查找在CMDS数组中支持的选项,然后调用try_func函数,并传递参数$FUNC以及匹配到的选项。

2.3.1 入参为init_hook

build-helper脚本中入参为init_hook的函数调用如下:

try_hook init_hook "$INIT_CMDS" $@

由于<SDK>/device/rockchip/common/build-hooks目录下各个*.sh脚本中定义的init_hook函数、INIT_CMDS数组不相同,尽管$@参数一样但是执行的结果均是不同的。

注意:实际上只有部分*.sh脚本定义有init_hook,如果该函数未定义的try_hook会直接return 0

2.3.2 入参为pre_build_hook

build-helper脚本中入参为pre_build_hook的函数调用如下:

try_hook pre_build_hook "$PRE_BUILD_CMDS" $@

由于<SDK>/device/rockchip/common/build-hooks目录下各个*.sh脚本中定义的pre_build_hook函数、PRE_BUILD_CMDS数组不相同,尽管$@参数一样但是执行的结果均是不同的。

注意:实际上只有部分*.sh脚本定义有pre_build_hook,如果该函数未定义的try_hook会直接return 0

2.3.3 入参为build_hook

build-helper脚本中入参为build_hook的函数调用如下:

try_hook build_hook "$BUILD_CMDS" $@

由于<SDK>/device/rockchip/common/build-hooks目录下各个*.sh脚本中定义的build_hook函数、BUILD_CMDS数组不相同,尽管$@参数一样但是执行的结果均是不同的。

注意:实际上只有部分*.sh脚本定义有build_hook,如果该函数未定义的try_hook会直接return 0

2.3.4 入参为post_build_hook

build-helper脚本中入参为post_build_hook的函数调用如下:

try_hook post_build_hook "$POST_BUILD_CMDS" $@

由于<SDK>/device/rockchip/common/build-hooks目录下各个*.sh脚本中定义的post_build_hook函数、POST_BUILD_CMDS数组不相同,尽管$@参数一样但是执行的结果均是不同的。

注意:实际上只有部分*.sh脚本定义有post_build_hook,如果该函数未定义的try_hook会直接return 0

2.3 try_func

尝试调用某个函数,函数接收多个参数:

  • 参数1为函数将要调用的hook函数,比如usage_hookinit_hookpre_build_hook build_hook post_build_hook clean_hook;这些函数一般在查看使用说明、构建的初始化阶段、预构建、构建、构建后、以及清理时被触发;
  • 参数2为hook函数的入参,传入hook函数所支持的命令选项;

比如try_func init_hook default,将会执行init_hook default

# try_func init_hook default
try_func()
{# 检查名为init_hook的函数是否存在并且可执行,不存在或不可执行则return 0type $1 >/dev/null 2>/dev/null || return 0# Don't log these hookscase "${1%_hook}" in   # 第一个参数移除_hook,即initinit | pre_build)$@          # 执行init_hook defaultreturn 0;;esacif [ "$DRY_RUN" ]; thenDRY_FUNC=$1_dry         # 比如build_hook_drytype $DRY_FUNC >/dev/null 2>/dev/null || return 0# 将参数列表向左移动一位,去掉了第1个参数shift# 函数调用$DRY_FUNC $@return 0fi# 设置日志文件LOG_FILE="$(start_log ${LOG_FILE_NAME%%_*} $LOG_FILE_NAME)"、# 记录运行日志echo -e "# run func: $@\n" >> "$LOG_FILE"# 运行钩子并记录输出$@ 2>&1 | tee -a "$LOG_FILE"# 处理钩子执行结果FUNC_RET=${PIPESTATUS[0]}if [ $FUNC_RET -ne 0 ]; thenerr_handler $FUNC_RET "${FUNCNAME[0]} $*" "$@"exit $FUNC_RETfi
}

判断调用的是不是init_hookpre_build_hook函数,如果是执行该函数并将参数传入,执行完后return 0

如果是build_hook post_build_hook 等函数,

  • 如果$DRY_RUN存在将会执行$1_dry,比如build_hook_dry 参数2 ,执行完后return 0
  • 否则将会执行如下过程:
    • 设置日志文件:LOG_FILE=output/sessions/latest/$(*.sh脚本名称,比如00-config)-(参数1,比如support-cmds)_创建时间
    • 记录运行日志:将# run hook: $@打印到$LOG_FILE中;
    • 运行钩子并记录输出:
      • 调用钩子函数,并将标准错误(2)输出到(>)到标准输出(&1);
      • 将标准错误输出重定向到标准输出,这样可以确保错误信息也被tee命令捕获到;
      • tee -a将管道中的输出同时输出到标准输出和追加到$LOG_FILE文件中;
    • 处理钩子执行结果:将管道中上一个命令的退出状态保存在FUNC_RET变量中,PIPESTATUS[0]Bash 内置的数组,包含了最近一个管道中命令的退出状态;
      • 如果FUNC_RET不等于 0,则表示有错误发生;
      • 调用err_handler数处理错误,传递错误码、当前函数名以及传递给当前函数的所有参数;
      • FUNC_RET的值退出脚本,终止整个构建过程。

三、00-config.sh

00-config.sh脚本位于<SDK>/device/rockchip/common/build-hooks/目录,这里我们挑选一些重点内容介绍。

3.1 脚本入口

首先执行SDK/device/rockchip/common/build-hooks/build-helper脚本,会将这个脚本的内容直接加载到当前shell环境中执行,build-helper.sh 能够获取父文件中的变量和参数;

#  source SDK/device/rockchip/common/build-hooks/build-helper
source "${BUILD_HELPER:-$(dirname "$(realpath "$0")")/../build-hooks/build-helper}"init_hook $@

使用source命令执行脚本的一些注意事项:

  • 环境变量和函数的影响:被执行的脚本可以修改当前shell的环境变量和定义的函数,这些修改将持续影响到当前shell的会话,直到会话结束或者重新定义了这些变量和函数。
  • 退出状态:被执行的脚本的退出状态(即最后一个命令的退出状态)会影响到当前shell。可以通过$?变量来获取最近一次执行命令的退出状态;
  • 交互性:与直接执行脚本不同,使用source执行脚本时,不会创建新的shell环境,因此不会有新的子shell进程。这使得它适合于需要脚本和当前shell环境之间相互影响的场景,例如定义函数或设置环境变量;
3.2 usage_hook

usage_hook用于输出当前脚本支持的命令;

usage_hook()
{echo -e "chip[:<chip>[:<config>]]          \tchoose chip"echo -e "defconfig[:<config>]              \tchoose defconfig"echo -e " *_defconfig                      \tswitch to specified defconfig"echo "    available defconfigs:"ls "$CHIP_DIR/" | grep "defconfig$" | sed "s/^/\t/"echo -e " olddefconfig                     \tresolve any unresolved symbols in .config"echo -e " savedefconfig                    \tsave current config to defconfig"echo -e " menuconfig                       \tinteractive curses-based configurator"echo -e "config                            \tmodify SDK defconfig"
}
3.3 init_hook

init_hook函数在构建的初始化阶段被调用,用于处理INIT_CMDS命令;

INIT_CMDS="chip defconfig lunch .*_defconfig olddefconfig savedefconfig menuconfig config default"init_hook()
{case "${1:-default}" inchip) shift; choose_chip $@ ;;lunch|defconfig) shift; choose_defconfig $@ ;;*_defconfig) switch_defconfig "$1" ;;olddefconfig | savedefconfig | menuconfig)prepare_config$MAKE $1;;config)prepare_config$MAKE menuconfig$MAKE savedefconfig;;default) prepare_config ;; # End of init*) usage ;;esac
}

在调用init_hook函数时可以传入以上任一命令作为选项,init_hook将会执行不同的分支:

  • chip:执行 choose_chip $@函数;
  • lunch|defconfig:执行choose_defconfig $@函数;
  • _defconfig:执行switch_defconfig "$1" 函数;
  • olddefconfig | savedefconfig | menuconfig:执行prepare_config函数;
  • config:执行prepare_config函数、$MAKE menuconfig$MAKE savedefconfig
  • default:执行prepare_config函数;
  • 不满足以上命令,将会执行usage输出该脚本用法;
3.3.1 入参为default

执行prepare_config函数;

# 如果板载配置不存在在,选择板载配置
prepare_config()
{	# 如果<SDK>/device/rockchip/.chip路径不存在,则执行choose_chip选择芯片# 如果存在,其指向如下:.chip -> .chips/rk3588/[ -e "$CHIP_DIR" ] || choose_chip# 进入<SDK>/device/rockchipcd "$DEVICE_DIR"# 查找/device/rockchip/.chips目录下文件,即删除rk3588   rk3588 -> .chips/rk3588/rm -f $(ls "$CHIPS_DIR")   # ln -rsf .chips/rk3588 .ln -rsf "$(readlink "$CHIP_DIR")" .# 跳转到SDK目录cd "$SDK_DIR"# 如果<SDK>/output/defconfig文件不存在或不可读,则执行choose_chip选择芯片		if [ ! -r "$RK_DEFCONFIG_LINK" ]; thenecho "WARN: $RK_DEFCONFIG_LINK not exists"choose_defconfigreturn 0fi# 由<SDK>/output/defconfig -> ../device/rockchip/.chips/rk3588/rockchip_rk3588_sige7_defconfig,得到rockchip_rk3588_sige7_defconfigDEFCONFIG=$(basename "$(realpath "$RK_DEFCONFIG_LINK")")# 检查两个文件是否不是同一个文件if [ ! "$RK_DEFCONFIG_LINK" -ef "$CHIP_DIR/$DEFCONFIG" ]; thenecho "WARN: $RK_DEFCONFIG_LINK is invalid"choose_defconfigreturn 0fi# 检查文件$RK_CONFIG是否比$RK_DEFCONFIG_LINK更旧if [ "$RK_CONFIG" -ot "$RK_DEFCONFIG_LINK" ]; thenecho "WARN: $RK_CONFIG is out-dated"$MAKE $DEFCONFIG &>/dev/nullreturn 0fiCONFIG_DIR="$(dirname "$RK_CONFIG_IN")"if find "$CONFIG_DIR" -cnewer "$RK_CONFIG" | grep -q ""; thenecho "WARN: $CONFIG_DIR is updated"$MAKE $DEFCONFIG &>/dev/nullreturn 0fiCFG="RK_DEFCONFIG=\"$(realpath "$RK_DEFCONFIG_LINK")\""if ! grep -wq "$CFG" "$RK_CONFIG"; thenecho "WARN: $RK_CONFIG is invalid"$MAKE $DEFCONFIG &>/dev/nullreturn 0fiif [ "$RK_CONFIG" -nt "${RK_CONFIG}.old" ]; then$MAKE olddefconfig &>/dev/nulltouch "${RK_CONFIG}.old"fi
}
3.1.2 入参为_defconfig

执行switch_defconfig函数:

switch_defconfig()
{DEFCONFIG="$1"[ -f "$DEFCONFIG" ] || DEFCONFIG="$CHIP_DIR/$DEFCONFIG"if [ ! -f "$DEFCONFIG" ]; thenecho "No such defconfig: $1"exit 1fiecho "Switching to defconfig: $DEFCONFIG"rm -f "$RK_DEFCONFIG_LINK"ln -rsf "$DEFCONFIG" "$RK_DEFCONFIG_LINK"DEFCONFIG="$(realpath "$DEFCONFIG")"rm -rf "$CHIP_DIR"ln -rsf "$(dirname "$DEFCONFIG")" "$CHIP_DIR"$MAKE $(basename "$DEFCONFIG")
}

参考文章

[1] Rockchip_Developer_Guide_Linux_Software_CN.pdf

[2] repo介绍与使用

[3] Rockchip_Developer_Guide_Linux_Upgrade_CN.pdf

[4] Rockchip RK3588 - NanoPC-T6开发板介绍

[5] Rockchip RK3399 - NanoPC-T4开发板介绍

[6] Buildroot根文件系统构建

[7] Debian根文件系统构建

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/diannao/43959.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

LeetCode //C - 214. Shortest Palindrome

214. Shortest Palindrome You are given a string s. You can convert s to a palindrome by adding characters in front of it. Return the shortest palindrome you can find by performing this transformation. Example 1: Input: s “aacecaaa” Output: “aaacec…

如何在JetBrains中写Codeforce?

目录 前言 正文 leetcode 个人喜好 参考资料 具体操作步骤 尾声 &#x1f52d; Hi,I’m Pleasure1234&#x1f331; I’m currently learning Vue.js,SpringBoot,Computer Security and so on.&#x1f46f; I’m studying in University of Nottingham Ningbo China&#x1f4…

Python函数 之 模块和包

1.模块 1, 在Python 中, 每个以 .py 结尾的 Python 代码⽂件 都可以称为是⼀个模块。 2, 在模块中 别⼈书写好的功能(变量, 函数, 类)&#xff0c;我们可以拿来直接使⽤。 3, 我们自己写的代码文件&#xff0c; 想要作为模块让别⼈使⽤, 你的代码⽂件名(模块名) 满足标识符的规…

物流工业三防平板实时跟踪货物位置和状态

在当今全球化和高度数字化的商业环境中&#xff0c;物流行业的高效运作对于企业的成功和经济的繁荣至关重要。货物的准确、实时跟踪不仅能提高物流效率&#xff0c;还能增强客户满意度&#xff0c;降低运营成本。物流工业三防平板的出现&#xff0c;为实现货物位置和状态的实时…

全网最适合入门的面向对象编程教程:12 类和对象的 Python 实现-Python 使用 logging 模块输出程序运行日志

全网最适合入门的面向对象编程教程&#xff1a;12 类和对象的 Python 实现-Python 使用 logging 模块输出程序运行日志 摘要&#xff1a; 本文主要介绍了日志的定义和作用&#xff0c;以及 Python 内置日志处理的 logging 模块&#xff0c;同时简单说明了日志等级和 logging …

【人工智能】-- 搜索技术(状态空间法)

个人主页&#xff1a;欢迎来到 Papicatch的博客 课设专栏 &#xff1a;学生成绩管理系统 专业知识专栏&#xff1a; 专业知识 文章目录 &#x1f349;引言 &#x1f348;介绍 &#x1f349;状态空间法 &#x1f348;状态空间的构成 &#x1f34d;状态 &#x1f34d;算符…

搜维尔科技:触觉反馈数据手套CyberGlove击鼓测试

触觉反馈数据手套CyberGlove击鼓测试 搜维尔科技&#xff1a;触觉反馈数据手套CyberGlove击鼓测试

办公助手推荐✨

办公助手来啦&#xff01;✨ 办公助手来啦&#xff01;✨&#x1f31f; 主要亮点&#x1f4dd; 全新PDF编辑器&#x1f3a8; 丰富的幻灯片版式&#x1f30d; 改进的从右至左显示&#x1f310; 新增本地化选项 &#x1f4ca; 应用场景在线办公套件&#x1f4f1; 多平台支持&…

IEC62056标准体系简介-1.引言

随着微电子技术和信息技术的发展&#xff0c;电力系统由智能计量仪表、自动化装置、现代通信设备等组成的各类系统逐步取代过去由感应系计量表计、手动装置、人工操作等组成的运行模式。为满足电力市场变革和用户管理中的抄表&#xff08;含自动&#xff09;、用户服务、价格表…

torch.autograd.Function自定义前向传播和反向传播

torch.autograd.Function 是 PyTorch 提供的一个接口&#xff0c;用于自定义前向传播和反向传播的操作。自定义操作需要继承 torch.autograd.Function 并重载 forward 和 backward 方法。 下面是一个简单的示例&#xff0c;展示如何自定义一个平方操作的前向传播和反向传播。 …

idea创建dynamic web project

由于网课老师用的是eclipse,所以又得自己找教程了…… 解决方案&#xff1a; https://blog.csdn.net/Awt_FuDongLai/article/details/115523552

20240709每日后端--------最优解决Invalid bound statement (not found)

目标 最优解决Invalid bound statement (not found) 步骤 1、打包 2、查看target下是否成双成对出现 3、核对无误后&#xff0c;即可解决问题。

软考高级里《系统架构设计师》容易考吗?

我还是22年通过的架构考试。系统架构设计师属于软考高级科目&#xff0c;难度比初级和中级都要大&#xff0c;往年的通过率也比较低&#xff0c;一般在10-20%左右。从总体来说&#xff0c;这门科目确实是不好过的&#xff0c;大家如果想要备考系统架构设计师的话&#xff0c;还…

Kithara和OpenCV (一)

Kithara使用 OpenCV 目录 Kithara使用 OpenCV简介需求和支持的环境构建 OpenCV 库使用 CMake 进行配置以与 Kithara 一起工作 使用 OpenCV 库设置项目运行 OpenCV 代码图像采集和 OpenCV自动并行化限制和局限性1.系统建议2.实时限制3.不支持的功能和缺失的功能4.显示 OpenCV 对…

【技术选型】FastDFS、OSS如何选择

【技术选型】FastDFS、OSS如何选择 开篇词&#xff1a;干货篇&#xff1a;FastDFS&#xff1a;OSS&#xff08;如阿里云OSS&#xff09;&#xff1a; 总结篇&#xff1a;我是杰叔叔&#xff0c;一名沪漂的码农&#xff0c;下期再会&#xff01; 开篇词&#xff1a; 文件存储该选…

简谈设计模式之原型模式

原型模式是一种创建型设计模式, 用于创建对象, 而不必指定它们所属的具体类. 它通过复制现有对象 (即原型) 来创建新对象. 原型模式适用于当创建新对象的过程代价较高或复杂时, 通过克隆现有对象来提高性能 原型模式结构 原型接口. 声明一个克隆自身的接口具体原型. 实现克隆…

【鸿蒙学习笔记】属性学习迭代笔记

这里写目录标题 TextImageColumnRow Text Entry Component struct PracExample {build() {Row() {Text(文本描述).fontSize(40)// 字体大小.fontWeight(FontWeight.Bold)// 加粗.fontColor(Color.Blue)// 字体颜色.backgroundColor(Color.Red)// 背景颜色.width(50%)// 组件宽…

展开说说:Android服务之实现AIDL跨应用通信

前面几篇总结了Service的使用和源码执行流程&#xff0c;这里再简单分析一下如果需要Service跨进程通信该怎样做。AIDL&#xff08;Android Interface Definition Language&#xff09;Android接口定义语言&#xff0c;用于实现 Android 两个进程之间进行进程间通信&#xff08…

Clickhouse的联合索引

Clickhouse 有了单独的键索引&#xff0c;为什么还需要有联合索引呢&#xff1f;了解过mysql的兄弟们应该都知道这个事。 对sql比较熟悉的兄弟们估计看见这个联合索引心里大概有点数了&#xff0c;不过clickhouse的联合索引相比mysql的又有些不一样了&#xff0c;mysql 很遵循最…

深入解析Spring Boot的application.yml配置文件

目录 引言Spring Boot配置文件简介 application.yml的优点 基本结构与语法 YAML语法基础Spring Boot中application.yml的基本结构 常见配置项详解 服务器配置数据源配置日志配置其他常见配置 环境配置与Profile 多环境配置激活Profile 高级配置与技巧 属性的占位符替换自定义配…