3. QPST 工具界面与功能模块

QPST（Qualcomm Product Support Tool）是高通平台调试与烧录的核心桌面工具套件，集成多个独立模块完成从底层固件下载、文件系统操作到射频参数配置的全链路任务。本章逐一拆解 QPST 主界面、EFS Explorer、Software Download、Service Programming 四大模块的界面布局、功能边界、操作流程与常见陷阱。

QPST 工具模块关系图 QPST 主界面 EFS Explorer 文件系统浏览/修改 Software Download 固件烧录/镜像下载 Service Programming 射频/IMEI/网络配置 QPST Configuration RF Calibration 关键依赖 所有模块均依赖 QPST 主程序识别手机端口 (COM), 驱动异常时模块无法启动

3.1 QPST 主界面（Main UI）

启动 QPST 后首先进入主界面，窗口标题通常为 QPST - EFS File Manager / Download / Service。主界面采用左树右表布局，左侧列出可用端口及对应设备型号，右侧显示已连接设备的详细信息。

区域内容用途
Port 列表COMx – 设备序列号选择目标设备，右键可弹出模块菜单
Device Info型号、固件版本、IMEI、S/N快速确认设备身份
菜单栏File / Tools / Help启动各子模块（EFS Explorer 等）
状态栏连接状态、传输进度监控烧录或读写实时状态
常见错误 #3-1：端口不可见
若主界面未显示任何端口，请检查：①手机已进入 Download 模式（按音量键+电源，或 adb reboot download）；②驱动已安装（QDLoader 驱动）；③更换 USB 线缆并连接主板直出 USB 口，避免前置延长线。

3.2 EFS Explorer（文件系统浏览）

EFS Explorer 用于读写高通设备的嵌入式文件系统（EFS）。EFS 存储 NVRAM、校准数据、NV 项等关键参数。界面类似 Windows 资源管理器，左侧树形目录，右侧预览文件内容。

  • 典型操作：备份 EFS 分区、导出 NV 项、修改无线网络配置。
  • 权限要求：部分文件（如 nvm/、rfnv/）需要 Service Programming 授权才能写入。
  • 日志输出：所有读写操作记录在 QPST log（默认 C:\QPST\logs\QPST.log）。
⚠ 使用要点
- 修改 EFS 前务必先备份整个 / 目录到本地。
- 错误文件写入可能导致 IMEI 丢失、基带异常，必须谨慎操作。
- 常见错误 #3-2：写入时提示“Permission denied” – 通常因设备处于安全启动模式或端口未解锁。

3.3 Software Download（固件烧录）

该模块是整机烧录的核心入口，负责将编译好的 .elf、.mbn、.img 等分区镜像写入设备。界面包含文件列表、目标分区映射表和烧录控制按钮。

典型烧录流程（5 步）：

  1. 在 QPST 主界面选择目标 COM 端口，右键 → Launch Software Download。
  2. 清空已有文件列表（File → Clear All）。
  3. 添加分区镜像：Add File / Add Directory，注意文件顺序与分区名称必须匹配设备的分区表（partition.xml）。
  4. 勾选 Force All 强制擦除所有分区（仅首次烧录或救砖时使用）。
  5. 点击 Start Download，观察进度条与日志框。完成后设备自动重启。

配置文件示例（partition.xml 片段）：

<?xml version="1.0" encoding="utf-8"?>
<partition_conf>
  <partition label="sbl1" physicalpartitionnumber="0" sizeinkb="256" type="0" />
  <partition label="tz" physicalpartitionnumber="0" sizeinkb="256" type="0" />
  <partition label="aboot" physicalpartitionnumber="0" sizeinkb="1024" type="0" />
  <partition label="boot" physicalpartitionnumber="0" sizeinkb="8192" type="0" />
  <partition label="system" physicalpartitionnumber="0" sizeinkb="1048576" type="1" />
</partition_conf>
常见错误 #3-3：Download 卡在 0% 或中途停止
原因：①USB 供电不足或线缆过长；②目标分区表与镜像大小不匹配；③设备在下载模式下被其他工具占用（如 QxDM）。
解决：重新插拔 USB → 重启 QPST → 换用主板后置 USB 口 → 使用 QPST Configuration 重置端口。

3.4 Service Programming（服务编程）

此模块用于写入运营商/服务商相关参数，属于高权限操作。常见子功能包括：NV 项读写、RF 校准参数注入、网络锁/解锁、IMEI 写入。

功能标签操作内容数据来源
NV Browser读取/修改单个 NV 项（如 NV 1194）QPST 自动填充
RF Calibration写入校准文件（.chr/.clb）产线生成
Network设置 APN、锁定频段、SIM 卡限制运营商配置
IMEI写入/验证 IMEI（需授权 SPC 码）设备包装/数据库

注意：修改 IMEI 在多数国家违法，仅用于开发板或授权维修。操作前必须通过 Qualcomm SPC 解锁（SPC 码通常为 000000 或设备背面标签）。

3.5 模块协作调试与错误日志

当烧录或读写失败时，优先查看 QPST 日志（菜单 Help → QPST Log Viewer）。日志路径：

C:\Program Files (x86)\Qualcomm\QPST\bin\QPST.log

常见日志标记及含义：

  • ERROR: Unable to open port COMx → 端口未正确识别，重新插拔或修改 COM 号。
  • Download: Partition 'system' size mismatch → 镜像大小与分区表冲突，需调整 partition.xml 中的 sizeinkb。
  • EFS: Read /nv/item_files/modem/... failed → 文件系统损坏，需恢复备份或重刷 EFS。
性能优化建议
- Software Download 时勾选 Verbose Logging 可记录每一步 SBL 握手细节，便于定位中断点。
- 批量烧录同一型号设备时，使用 QPST 的 Multi-Download 功能（需企业授权）并行烧录多个端口。
- 若 EFS Explorer 响应缓慢，先关闭耗资源的 NV 项实时预览（View → Disable Live Preview）。
← 上一章 📖 返回目录 下一章 →