3、QPST工具详解：QPST的安装与配置、端口检测、QXDM日志抓取、EFS文件系统浏览与备份
QPST，全称Qualcomm Product Support Tools。说实话，这玩意儿是我入行高通平台调试时接触的第一个工具。那时候我刚从MTK转过来，面对一整套陌生的工具链，头都是大的。但用久了你会发现，QPST就像一把瑞士军刀——功能杂，但每个都管用。
今天咱们就把它掰开揉碎了讲。安装、端口、日志、EFS，这四个点吃透了，你就能应付80%的日常调试场景。
3.1 QPST的安装与配置
安装QPST其实没什么技术含量。但有个坑，我当年踩过——版本兼容性。
QPST 2.7.x 系列对骁龙865及以下平台支持良好。但到了骁龙8 Gen1之后，建议用 QPST 2.8.x 以上版本。否则端口死活认不到，你查驱动查半天，最后发现是工具版本太老。
安装步骤很简单：
- 以管理员身份运行安装包
- 一路Next，默认路径即可
- 安装完成后，重启电脑
重启这一步，我个人习惯是必须做的。为什么？因为QPST会注册一堆虚拟串口驱动，不重启驱动加载不全。你想想看，端口都认不到，后面还怎么玩？
配置方面，主要就是端口配置。打开QPST Configuration，你会看到一个空白的端口列表。这时候把手机连上，进入Download模式（通常是音量上+电源键，或者直接adb reboot edl）。
嗯，这里要注意：有些新平台需要手动添加端口。点击Add New Port，选择你的手机对应的COM口。怎么判断是哪个？看设备管理器，Ports (COM & LPT)下面，带Qualcomm HS-USB QDLoader字样的就是。
3.2 端口检测——别让端口坑了你
端口检测，说白了就是确认工具和手机能不能对上话。我在项目中遇到过好几次，工程师折腾半天，最后发现是端口号选错了。
QPST里有个小功能叫Port Detector，在Start菜单里能找到。打开它，它会自动扫描所有可用的高通端口。扫描结果会显示端口号、设备类型、连接状态。
1. 手机进入EDL模式
2. 打开QPST Port Detector
3. 确认端口状态显示为"Connected"
如果端口显示"Not Connected"，别慌。先检查驱动。我曾经遇到过一台Win11电脑，死活装不上高通驱动。后来发现是系统强制驱动签名搞的鬼。解决办法：进入高级启动，禁用驱动签名强制验证。
还有一个常见问题：端口闪烁。就是端口在Connected和Disconnected之间来回跳。这通常是USB线的问题。别问我怎么知道的——我抽屉里至少有五根"看起来能用"但实际已经废了的USB线。
3.3 QXDM日志抓取——调试的命根子
QXDM，全称Qualcomm eXtensible Diagnostic Monitor。这工具是QPST套件里我最常用的一个。说白了，它就是高通芯片的"黑匣子记录仪"。
日志抓取流程：
- 打开QPST，确认端口连接正常
- 启动QXDM Professional（注意，不是QXDM，是带Professional的版本）
- 在View菜单里打开Log Viewer
- 点击Start Logging，选择保存路径
这里有个技巧：日志文件会非常大。我一般只抓关键消息类型。在Log Viewer里，右键可以配置过滤规则。比如我只想看NAS层的信令，就把其他层的勾去掉。这样日志文件小，分析起来也快。
抓日志前，先清空一次缓冲区（Clear Buffer）。否则日志里混着之前的老数据，分析时容易混淆。这个操作在View -> Clear All Messages里。
日志保存格式，我建议用.isf格式。为什么？因为它是压缩的，文件小。而且后续用QCAT分析时，.isf可以直接打开。.qmdl格式也行，但文件大得吓人。有一次我抓了半小时日志，.qmdl格式直接干到了2个G。换成.isf，才300多兆。
抓日志时还有个坑：手机不能休眠。休眠了，日志就断了。解决办法：在开发者选项里，开启"不锁定屏幕"和"保持唤醒状态"。或者直接用adb命令：
adb shell svc power stayon true3.4 EFS文件系统浏览与备份——别等丢了才后悔
EFS，Embedded File System。这是高通芯片上用来存NV参数、校准数据、IMEI等关键信息的分区。说白了，手机能不能打电话、能不能上网，全靠EFS里的数据撑着。
我见过太多人，刷机前不备份EFS，结果刷完发现IMEI丢了，基带没了。那时候哭都来不及。
QPST里操作EFS，用的是EFS Explorer。打开方式：
- QPST主界面 -> Tools -> EFS Explorer
- 选择对应的端口，点击OK
- 等待文件系统加载完成
加载完成后，你会看到一个类似Windows资源管理器的界面。左边是目录树，右边是文件列表。常用的目录有：
| 目录路径 | 说明 |
|---|---|
| / | 根目录，包含所有EFS数据 |
| /nv | NV参数存储区，最重要的目录 |
| /nv/item_files | 单个NV项文件 |
| /policyman | 策略管理相关文件 |
| /rfnv | 射频NV参数 |
备份操作很简单：选中整个根目录，右键 -> Backup。选择保存路径，等它跑完就行。恢复时同理，右键 -> Restore。
每次刷机、升级、修改NV参数前，必须做一次完整备份。备份文件要存到电脑上，别只存在手机里。手机都挂了，你存手机里的备份有啥用？
浏览EFS时，我建议不要随意修改文件。尤其是/nv目录下的东西。改错了，轻则信号变差，重则直接没信号。我曾经手贱改了一个NV项，结果手机搜不到任何运营商网络。折腾了两天才恢复回来。
如果你确实需要修改NV参数，记得先备份，然后只修改你知道具体含义的项。不确定的，别碰。
最后说个小技巧：EFS Explorer支持拖拽操作。你可以把电脑上的文件直接拖到EFS目录里，也可以把EFS里的文件拖到电脑上。这个功能在替换校准文件时特别方便。
好了，QPST的核心功能就这些。安装、端口、日志、EFS，这四个点你掌握了，日常调试基本够用。下一章咱们聊QPST的进阶玩法——NV参数编辑和固件烧录。那个更有意思。