安装并启动内核

构建成功后,Qualcomm^® Linux 启动系统使用两个已刷写的镜像来启动内核:efi.bin(ESP 分区)和 dtb.bin(DTB 分区)。

镜像构成

Yocto 构建将内核产物打包为可刷写的镜像:

efi.bin 是 EFI 系统分区(ESP)镜像。包含 systemd-boot(启动管理器)和打包为 UKI type-2 镜像的内核,该镜像捆绑了内核、initramfs,以及可选的设备树。刷写到 efi 分区。
dtb.bin 是 DTB 分区镜像。包含所有编译后的设备树 blob(DTB)。刷写到 dtb_a 分区。

表:内核构建产物

镜像	镜像名称	构建部署路径	详情
内核 ELF	`vmlinux`	`build/tmp/deploy/images/<machine>/<image>-*.rootfs.qcomflash/`	带调试符号的输出内核 ELF。
Initramfs	`initramfs-qcom-image-<machine>.cpio.gz`	`build/tmp/deploy/images/<machine>/`	CPIO 格式的 initramfs。
内核镜像	`Image`	`build/tmp/deploy/images/<machine>/`	原始内核二进制文件。systemd-boot 不支持压缩镜像。
内核模块	`modules-<machine>.tgz`	`build/tmp/deploy/images/<machine>/`	动态可加载内核模块(DLKM)。
设备树 blob	`<SoC>-<board>-<variant>.dtb`	`build/tmp/deploy/images/<machine>/`	单个设备树 blob。
ESP 分区	`efi.bin`	`build/tmp/deploy/images/<machine>/<image>-*.rootfs.qcomflash/`	打包为 UKI type-2 镜像的 systemd-boot、内核和 initramfs。
DTB 分区	`dtb.bin`	`build/tmp/deploy/images/<machine>/<image>-*.rootfs.qcomflash/`	打包在 FIT 镜像中的所有 DTBO。

部署内核产物

如果你之前尚未刷写所有启动二进制文件,请先按照带固件的 BSP 镜像构建中的完整刷写说明操作。对于后续仅涉及内核的更新,可以增量刷写 efi.bin 和 dtb.bin:

# Navigate to the build output directory
cd build/tmp/deploy/images/<machine>/<image>-*.rootfs.qcomflash/

# Flash the ESP and DTB partition images
fastboot flash efi efi.bin
fastboot flash dtb_a dtb.bin
fastboot reboot

内核或 DTS 更改后,必须同时刷写 efi.bin 和 dtb.bin,以保持内核和设备树同步。

验证正在运行的内核

设备重启后,确认正在运行的内核版本符合预期,且启动过程没有错误。

连接到设备

使用以下方法之一访问设备上的 shell:

串行控制台(UART),推荐用于早期启动检查。有关设置说明,请参阅连接到你的目标设备。
ADB shell,在设备完全启动后使用:

adb shell

SSH,使用设备 IP 地址通过网络连接:

ssh root@<device-ip>

检查内核版本

# Short version string
uname -r

# Full version, architecture, and build timestamp
uname -a

# Detailed version including compiler
cat /proc/version

uname -r 的输出应反映你构建并刷写的内核版本(例如 LTS 系列的 6.18.x 字符串)。

检查启动健康状况

检查内核环形缓冲区,查找早期启动中的错误或警告:

# Print the first 50 lines of kernel messages
dmesg | head -50

# Filter for errors and warnings only
dmesg --level=err,warn

在使用 systemd 的系统上,也可以通过以下命令查看当前启动的内核消息:

journalctl -k -b

确认内核模块

验证预期的内核模块已成功加载:

# List all loaded modules
lsmod

# Check if Qualcomm-specific modules are present
lsmod | grep qcom

要检查所需模块是否缺失,请在目标设备上运行以下命令,确认该模块已包含在内核配置中,且在配置更改后重新构建了镜像:

zcat /proc/config.gz | grep CONFIG_<Module>

故障排除

如果内核版本与构建的版本不符,或设备无法启动:

重新运行 fastboot flash 命令并检查是否有 OKAY 响应,确认刷写过程没有错误。
确认 efi.bin 和 dtb.bin 已刷写到正确的分区(分别为 efi 和 dtb_a)。
有关启动失败和内核 panic 分析,请参阅内核问题故障排除。
有关串行控制台日志捕获,请参阅内核日志。

简介

架构

关键文档

技术

系统

发行说明

镜像构成

部署内核产物

验证正在运行的内核

连接到设备

检查内核版本

检查启动健康状况

确认内核模块

故障排除

​镜像构成

​部署内核产物

​验证正在运行的内核

​连接到设备

​检查内核版本

​检查启动健康状况

​确认内核模块

​故障排除

镜像构成

部署内核产物

验证正在运行的内核

连接到设备

检查内核版本

检查启动健康状况

确认内核模块

故障排除