使用 QDL 刷写 Qualcomm Linux

​

下载 Qualcomm Linux 镜像

1. 下载 Qualcomm Linux 镜像
2. 解压 zip 文件
   tar -xf qli-2.0-qcom-multimedia-proprietary-image.zip
   
   可刷写的产物位于:
   <path-to-image>\images\iq-9075-evk\qcom-multimedia-proprietary-image-iq-9075-evk\
   
   其中 <path-to-image> 是解压镜像 zip 时创建的文件夹。

​

下载 QDL

1. 下载 适用于 Windows 的 QDL 工具 并解压。
   建议将镜像和 QDL 解压到同一个父文件夹中(例如 C:\Users\you\Downloads\qualcomm-flash\)。这样所有路径都在同一根目录下,便于在 provision、SAIL 和镜像文件夹之间切换。

​

设置 QDL 驱动

1. 卸载任何现有的 Qualcomm USB 驱动(QUD)— 它们会与 QDL 驱动冲突。打开设备管理器,找到你的设备并卸载所有现有驱动。设备不应出现在 COM 端口下。
2. 从解压后的 QDL 文件夹运行 install_driver.bat 以安装 WinUSB 驱动。

​

使设备进入 EDL 模式

1. 使用 SW2 DIP 拨码开关使设备进入 EDL 模式:将开关 1、2 和 4 拨到 OFF,开关 3 拨到 ON。
2. 将 12 V 电源连接到 EVK。
3. 将 USB Type-C 线缆从 EVK 的 USB0 连接到主机。
4. 拨动电源开关打开设备。
5. 打开设备管理器并确认出现一个 Qualcomm USB 设备(不在 COM 端口下)。

​

配置 UFS(Provision UFS)

• 这是一块从未刷写过的全新开发板。
• 你正在升级到新的镜像版本。
• 你正在切换发行版(Qualcomm Linux ↔ Ubuntu)。

1. 下载 provision.zip 并解压。
2. 进入解压后的 provision 文件夹:
   cd <path-to-provision>
   
3. 执行 UFS provisioning(将 <qdl_dir> 替换为你的 QDL 文件夹路径): 命令提示符(Command Prompt):
   "<qdl_dir>\qdl.exe" --storage ufs prog_firehose_ddr.elf provision_1_2.xml
   
   PowerShell:
   & "<qdl_dir>\qdl.exe" --storage ufs prog_firehose_ddr.elf provision_1_2.xml
   
   预期输出:
   UFS provisioning succeeded
   

​

刷写 SAIL 固件

1. 进入镜像目录中的 sail_nor 子文件夹:
   cd <path-to-image>\images\iq-9075-evk\qcom-multimedia-proprietary-image-iq-9075-evk\sail_nor
   
2. 刷写 SAIL 固件(将 <qdl_dir> 替换为你的 QDL 文件夹路径): 命令提示符(Command Prompt):
   "<qdl_dir>\qdl.exe" --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
   
   PowerShell:
   & "<qdl_dir>\qdl.exe" --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
   
   预期输出:
   flashed "SAIL_HYP" successfully
   flashed "SAIL_SW1" successfully
   flashed "SAIL_HYP_BKUP" successfully
   flashed "SAIL_SW1_BKUP" successfully
   flashed "PrimaryGPT" successfully
   flashed "BackupGPT" successfully
   11 patches applied
   

​

刷写 Qualcomm Linux

1. 进入主镜像文件夹:
   cd <path-to-image>\images\iq-9075-evk\qcom-multimedia-proprietary-image-iq-9075-evk
   
2. 刷写镜像(将 <qdl_dir> 替换为你的 QDL 文件夹路径 — Windows 不支持通配符,需显式列出所有文件): 命令提示符(Command Prompt):
   "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml
   
   PowerShell:
   & "<qdl_dir>\qdl.exe" prog_firehose_ddr.elf rawprogram0.xml rawprogram1.xml rawprogram2.xml rawprogram3.xml rawprogram4.xml rawprogram5.xml patch0.xml patch1.xml patch2.xml patch3.xml patch4.xml patch5.xml
   
   当最后一行显示如下内容时,刷写完成:
   partition 1 is now bootable
   

​

下载 Qualcomm Linux 镜像

1. 下载 Qualcomm Linux 镜像。
2. 解压 zip 文件
   unzip qli-2.0-qcom-multimedia-proprietary-image.zip
   
   可刷写的产物位于:
   <path-to-image>/images/iq-9075-evk/qcom-multimedia-proprietary-image-iq-9075-evk/
   
   其中 <path-to-image> 是解压镜像 zip 时创建的文件夹。

​

下载 QDL

1. 下载 适用于 macOS (Apple Silicon) 的 QDL 工具 并解压。解压后的文件夹包含 qdl 二进制文件 — 下文称为 <qdl_dir>。有关工具使用详情,参见该文件夹中的 QDL_User_Guide。
   建议将镜像和 QDL 解压到同一个父文件夹中。这样所有路径都在同一根目录下,便于在 provision、SAIL 和镜像文件夹之间切换。

​

设置 QDL 路径

1. 通过 Homebrew 安装所需的库(如已安装可跳过):
   brew install libusb libxml2
   

xcode-select --install

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

vi ~/.zshrc or vi ~/.bash_profile

PATH=/opt/homebrew/bin:$PATH

source ~/.zshrc or source ~/.bash_profile

brew doctor

Your system is ready to brew

2. 使 QDL 可执行,并清除 macOS 隔离标志(quarantine flag),以便 Gatekeeper 允许其运行:
   chmod +x <qdl_dir>/qdl
   sudo xattr -dr com.apple.quarantine <qdl_dir>
   
   需要 sudo,因为一些捆绑的库是只读的。如果此步骤之后 macOS 仍然阻止该工具,请在系统设置 → 隐私与安全性中允许它。
3. 验证 QDL 是否正常工作:
   <qdl_dir>/qdl --help
   
   你应该看到 QDL 的用法输出。如果出现错误,请检查路径。

​

使设备进入 EDL 模式

1. 使用 SW2 DIP 拨码开关使设备进入 EDL 模式:将开关 1、2 和 4 拨到 OFF,开关 3 拨到 ON。
2. 将 12 V 电源连接到 EVK。
3. 将 USB Type-C 线缆从 EVK 的 USB0 连接到主机。
4. 拨动电源开关打开设备。
5. 确认设备处于 EDL 模式:
   system_profiler SPUSBDataType | grep -A4 -i qualcomm
   
   预期输出:
   Product ID: 0x9008
   Vendor ID: 0x05c6  (Qualcomm, Inc)
   Manufacturer: Qualcomm CDMA Technologies MSM
   
   Product ID: 0x9008 确认设备处于 EDL 模式。如果未出现,请重新检查 SW2-3 和 USB-C 线缆。

​

配置 UFS(Provision UFS)

• 这是一块从未刷写过的全新开发板。
• 你正在升级到新的镜像版本。
• 你正在切换发行版(Qualcomm Linux ↔ Ubuntu)。

1. 下载 provision.zip 并解压:
   unzip provision.zip
   
2. 将 provision 文件和 QDL 二进制文件移动到同一文件夹中,然后在该文件夹中运行:
   在 macOS 上,qdl 二进制文件及其支持库必须与 provision 文件位于同一目录中。将 provision 文件复制到 <qdl_dir> 中,然后在那里运行命令。
   ./qdl --storage ufs prog_firehose_ddr.elf provision_1_2.xml
   
   预期输出:
   UFS provisioning succeeded
   

​

刷写 SAIL 固件

1. 进入解压后镜像中的 sail_nor 子文件夹:
   cd <path-to-image>/images/iq-9075-evk/qcom-multimedia-proprietary-image-iq-9075-evk/sail_nor
   
2. 刷写 SAIL 固件:
   <qdl_dir>/qdl --storage spinor prog_firehose_ddr.elf rawprogram0.xml patch0.xml
   
   预期输出:
   flashed "SAIL_HYP" successfully
   flashed "SAIL_SW1" successfully
   flashed "SAIL_HYP_BKUP" successfully
   flashed "SAIL_SW1_BKUP" successfully
   flashed "PrimaryGPT" successfully
   flashed "BackupGPT" successfully
   11 patches applied
   

​

刷写 Qualcomm Linux

1. 进入主镜像文件夹:
   cd <path-to-image>/images/iq-9075-evk/qcom-multimedia-proprietary-image-iq-9075-evk
   
2. 刷写镜像:
   <qdl_dir>/qdl --storage ufs prog_firehose_ddr.elf rawprogram*.xml patch*.xml
   
   当最后一行显示如下内容时,刷写完成:
   partition 1 is now bootable
   
   刷写过程中出现的任何扇区截断(sector-truncation)警告都是无害的。