Qualcomm Linux 上的 U-Boot

​

概述

​

支持的 SoC

​

构建 U-Boot 镜像

​

1. 从 Qualcomm Linux GitHub 仓库构建

​

前提条件

1. 在本地计算机上安装以下软件包：
   sudo apt install libgnutls28-dev
   
2. 下载并解压 Arm GNU 工具链：
   cd ~  # or your preferred location
   wget https://developer.arm.com/-/media/Files/downloads/gnu/14.2.rel1/binrel/arm-gnu-toolchain-14.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz
   tar -xf arm-gnu-toolchain-14.2.rel1-x86_64-aarch64-none-linux-gnu.tar.xz
   
   • 这会在 ~/arm-gnu-toolchain-14.2.rel1-x86_64-aarch64-none-linux-gnu/ 创建工具链目录。如果解压到其他位置，请相应调整构建命令中的路径。
   • 仅在 x86 64 位主机上安装该工具链。
   • 其他版本请访问 Arm GNU 工具链下载。
3. 下载 qtestsign 实用程序：
   cd ~  # or your preferred location
   git clone https://github.com/msm8916-mainline/qtestsign qtestsign
   

​

构建步骤

1. 将 U-Boot 仓库从 Qualcomm Linux GitHub 下载到本地工作区，并进入 u-boot 文件夹：
   git clone https://github.com/qualcomm-linux/u-boot.git
   
2. 切换分支：
   git switch qcom-next
   
3. 检出 QLI 2.0 版本的 SRC REV：
   git checkout 5a77d4670d8084ada24a2735dda75788ed5ce925
   
4. 由于 IQ-9075 和 IQ-615 默认启用了基于内核的虚拟机（KVM），请将以下配置选项添加到各自的 defconfig 文件中：
   CONFIG_ENABLE_ARM_SOC_BOOT0_HOOK=y
   CONFIG_QCOM_EL2_GUNYAH_EXIT_SUPPORT=y
   
   QCS6490 请跳过此步骤，因为其默认未启用 KVM。
5. 为您的平台配置构建。此命令会在 .output 目录中创建所需的配置文件。请根据您的平台选择相应命令：

   SoC	命令
   QCS6490	make O=.output qcm6490_defconfig
   IQ-9075	make O=.output qcom_lemans_defconfig
   IQ-615	make O=.output qcom_qcs615_defconfig

6. 使用交叉编译工具链构建 U-Boot：
   make -j8 CROSS_COMPILE=~/arm-gnu-toolchain-14.2.rel1-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu- O=.output
   
   如果将工具链解压到了其他位置，请将 ~/arm-gnu-toolchain-14.2.rel1-x86_64-aarch64-none-linux-gnu/ 替换为您的实际工具链安装路径。
   预期结果：
   • U-Boot 构建完成且无错误。
   • u-boot.elf 文件位于 .output 目录中。

​

将 u-boot.elf 转换为 u-boot.mbn

python ~/qtestsign/qtestsign.py -v6 aboot -o .output/u-boot.mbn .output/u-boot.elf

​

2. 使用 Yocto 构建

• 要生成 U-Boot 二进制文件，请在”构建 BSP 镜像”第 3 步的构建命令中追加 :meta-qcom/ci/u-boot-qcom.yml KAS 片段。
• 在构建产物文件夹中，最终的 U-Boot 二进制文件以 uefi.elf 形式生成在 <workspace-dir>/build/tmp/deploy/images/<MACHINE>/<IMAGE>-<MACHINE>.rootfs.qcomflash/ 目录中。

CONFIG_ENABLE_ARM_SOC_BOOT0_HOOK=y
CONFIG_QCOM_EL2_GUNYAH_EXIT_SUPPORT=y

​

烧录 U-Boot 镜像

​

使用 Qualcomm 工具

​

使用 Fastboot

1. 使用以下方法之一进入 fastboot 模式：
   • 从内核：
     adb shell reboot bootloader
     
   • 从 U-Boot CLI：
     run fastboot
     
2. 从主机烧录所需镜像。例如，要烧录 U-Boot 镜像：
   fastboot flash uefi_a u-boot.mbn
   
3. 重启设备：
   fastboot reboot
   

​

支持的 U-Boot 命令

​

另请参阅

• 使用 U-Boot 日志进行故障排查