第四章：QPST烧录前置准备

4.1 刷机包获取途径

刷机包的来源直接影响设备安全与烧录成功率。官方渠道与第三方资源各有优劣，必须在使用前验证包体的完整性与签名。

4.2 刷机包目录结构与关键文件

一个完整的 QPST 刷机包通常包含以下文件结构（以高通 MSM8953/骁龙625 平台为例）：

Firmware_Release_v2.0/
├── prog_emmc_firehose_8953_ddr.elf
├── rawprogram0.xml
├── patch0.xml
├── system.img
├── boot.img
├── recovery.img
├── persist.img
├── userdata.img
├── cache.img
├── gpt_backup0.bin
└── contents.xml                  # 可选，用于验证文件列表

其中 prog_emmc_firehose.elf、rawprogram0.xml、patch0.xml 是烧录过程中必不可少的三个核心组件。

4.3 核心文件详解

4.3.1 prog_emmc_firehose.elf

该 ELF 文件是 Qualcomm Firehose 协议的可加载程序，由 QPST 通过 EDL（Emergency Download）模式下载到设备内存中执行。它负责解析后续的 XML 命令并与主机建立高速批量传输通道。

• 命名规则： prog_emmc_firehose_<平台>_ddr.elf（DDR 版本）或 prog_emmc_firehose_<平台>_lk.elf（Little Kernel）。
• 验证要点： 必须与目标设备 SoC 型号严格匹配；MD5 值应与官方固件发布页一致。
• 风险点： 使用错误平台的 ELF 会导致设备进入烧死状态（Hard Brick），需短接测试点恢复。

4.3.2 rawprogram0.xml

该 XML 文件定义了烧录的原始分区布局和镜像写入方式。典型片段：

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <program SECTOR_SIZE_IN_BYTES="512"
           file_sector_offset="0"
           filename="partition_table_0.bin"
           label="partition_0"
           num_partition_sectors="1024"
           physical_partition_number="0"
           size_in_KB="512.0"
           sparse="false"
           start_byte_hex="0x0"
           start_sector="0"
           />
  <program SECTOR_SIZE_IN_BYTES="512"
           file_sector_offset="0"
           filename="boot.img"
           label="boot"
           num_partition_sectors="32768"
           physical_partition_number="0"
           size_in_KB="16384.0"
           start_sector="204800"
           />
</data>

• 关键属性： start_sector（起始扇区）、num_partition_sectors（分区大小）、filename（对应镜像文件）。
• 常见错误： start_sector 重叠或小于 GPT 非保护区域会导致分区表损坏。
• 验证方法： 使用 xmllint 检查语法，与原始分区表交叉比对扇区范围。

4.3.3 patch0.xml

该文件用于对已刷写的分区执行补丁操作，例如更新特定偏移量的字节值。典型场景：修改 Android 系统属性、写入序列号、覆盖 SafetyNet 状态。

<?xml version="1.0" encoding="UTF-8"?>
<data>
  <patch byte_offset="0x1234"
         filename="system.img"
         physical_partition_number="0"
         size_in_bytes="16"
         value="deadbeefcafebabe1234567890abcdef"
         />
</data>

4.4 镜像完整性验证方法

防止因下载中断、压缩包损坏、签名篡改导致烧录失败，需在开始烧录前执行以下三个步骤：

1. 校验文件摘要：使用 SHA256 或 MD5 与官方发布值对比。
2. 校验 ELF 签名：高通官方 ELF 文件通常带有 Qualcomm 私钥签名，可通过 openssl rsautl -verify 检查。
3. 校验分区表合理性：使用 gdisk -l rawprogram0.xml 提取分区始末扇区并验证无重叠。

命令行验证示例：

# 计算镜像 SHA256
sha256sum prog_emmc_firehose_8953_ddr.elf
# 输出应与官方固件页面一致：e3b0c44298fc1c149afbf4c8996fb924...

# 检查 XML 语法
xmllint --noout rawprogram0.xml

# 检查 ELF 签名（需提取公钥）
openssl dgst -sha256 -verify qualcomm_pubkey.pem -signature elf.sig prog_emmc_firehose_8953_ddr.elf

4.5 刷机包依赖关系与工作流程

下图展示了从包获取到烧录执行的完整前置准备逻辑：

4.6 常见错误与避坑指南