高通学习12--调试工具（TODO）

（TODO）

按基带通信刷机、日志诊断、性能剖析、专项子系统、崩溃内存、编译 AI、硬件仿真七大类别整理，覆盖手机 / 物联网 / 车规全骁龙平台：

一、QPST 套件（Windows 基带核心工具集，Diag 协议底座）

QPST = Qualcomm Product Support Tools，包含多个子工具：

1. QPST Configuration管理 USB COM/DIAG 端口，识别 9008 (EDL)、9001 (QDL)、9006 (Diag) 端口，是所有高通工具的连接入口。
2. QFIL（Qualcomm Flash Image Loader）EDL 紧急下载模式（9008 端口）整机刷机、分区烧录、固件恢复；砖机救砖主力工具，加载 rawprogram/partition.xml 固件包。
3. QXDM（eXtensible Diagnostic Monitor，含 Pro 专业版）实时抓全栈诊断日志（.isf/.dlf）：5G/4G/3G Modem 信令、射频、VoLTE/VoNR、AP 内核、传感器、蓝牙 WiFi、NV 状态；支持下发 AT/DIAG 指令、子系统复位、实时指标监控（RSRP/SINR/ 吞吐）；Pro 版开放底层寄存器、安全域调试权限（需厂商授权）。
4. QCAT（Communication Analyzer Tool）QXDM 日志离线深度解析：协议分层拆解、吞吐曲线、切换事件、呼叫失败溯源、CA/EN-DC 分析、SIP 信令可视化，定位通信性能瓶颈首选。
5. EFS Explorer读写基带 EFS 文件系统（校准参数、证书、运营商配置），上传 / 下载 / 删除分区文件。
6. NV Manager / QCN 工具NV 参数读写、备份 / 恢复 QCN 校准文件（IMEI、射频校准、频段、鉴权密钥），刷机后恢复基带信号必备。

二、系统 & 应用性能调优工具

1. Snapdragon Profiler（跨平台 Win/Linux/Mac）

全芯片性能剖析，覆盖 AP CPU、Adreno GPU、Hexagon DSP/NPU、内存、功耗、总线：

• 实时硬件计数器、帧率、渲染管线快照（Vulkan/OpenGL ES）；
• ML 推理负载、HVX 向量单元调度、内存泄漏、线程调度瓶颈定位；
• 游戏 / APP / 嵌入式 Linux 通用性能基准工具Qualcomm。

2. Snapdragon Tracer

轻量级内核 / 子系统轨迹抓取，帧级时序分析，常用于 Camera CamX、显示 DPU、音频 ALSA 链路时序调试，输出 trace 文本给后端解析。

三、专项子系统调试工具

1. QACT（Qualcomm Advanced Camera Tuning）Camera 图像调参专用：ISP 实时数据流、3A（曝光 / 白平衡 / 对焦）、镜头畸变、多摄同步、CamX 节点路由、帧 dump、画质量化打分，影像团队标配。
2. QACT Audio / QAT音频 DSP/ALSA 调测：音量均衡、回声消除、Codec 寄存器、蓝牙音频链路、通话音质采集分析。
3. ADAPT自动化 Modem 压力测试脚本框架，配合 QXDM 实现批量呼叫、切换、吞吐量自动化压测，工厂可靠性测试使用。
4. QDevNet / WiFi/Bluetooth Diag无线局域网 / 蓝牙底层抓包、射频功率、连接稳定性、漫游调试，集成在 QXDM 过滤器内。

四、崩溃、内存转储离线分析工具

1. RAM Dump + QCAP（Crash Analysis Portal）设备死机 / Watchdog 时抓取全内存镜像 ramdump；QCAP 云端 / 本地解析崩溃栈、死锁、内核 Oops、Modem 异常、TrustZone 安全域故障。
2. RAMParser本地轻量 ramdump 解析工具，快速定位崩溃任务、寄存器上下文。
3. TrustZone TZ Debug 工具解析 TEE 安全域日志tzbsp_log.txt，解密安全世界 diag 日志，调试指纹 / 支付 / 加密安全应用Qualcomm。
4. 开源配套（高通 Linux 原生支持）：GDB/gdbserver、Valgrind、ltrace、core-dump 内核崩溃转储分析Qualcomm。

五、编译、AI 与固件配套工具

1. Snapdragon LLVM Compiler骁龙官方编译器，优化 CPU/GPU/Hexagon 二进制性能、功耗、体积，替代 GCC 用于嵌入式与安卓编译。
2. AIMET（AI Model Efficiency Toolkit）AI 模型量化、剪枝、压缩、校准，适配 Hexagon NPU/HVX，降低推理时延与功耗。
3. Hexagon SDKDSP/NPU 开发套件：HVX 编程、NN 推理 API、仿真器、调试器，开发语音 / 图像 AI 加速算法。

六、硬件仿真、JTAG 板级调试

1. EUD（Embedded USB Debugger）高通官方 USB-JTAG 适配器，OpenOCD 对接 APSS 内核在线调试、单步、断点、寄存器读写，支持 QCS 工业 / 车规平台。
2. TRACE32（Lauterbach）商业高端 JTAG 仿真器，全子系统（AP/Modem/DSP/TEE）全速硬件调试，芯片 Bringup 阶段核心工具。
3. Surf 平台调试板配套工具原厂参考开发板的射频综测控制、电源程控、GPIO/Pinctrl 寄存器读写脚本。

七、辅助底层命令 / 驱动

1. 高通 USB 驱动（QDLoader/Qualcomm HS-USB）所有 PC 工具通信基础，区分 9008/9006/9001 设备枚举。
2. diag 命令（QXDM/ADB shell）内核态诊断入口，手动抓取子系统日志、读写寄存器、触发 dump、控制射频通路。
3. edl 命令行（开源 edl、qrcode）Linux 主机无 GUI 下批量烧录、自动化产线刷机，替代 QFIL 图形界面。

工具协作典型链路

1. 通信问题：QXDM 实时抓 log → QCAT 离线深度分析 → QCN/NV Manager 修复参数
2. 整机性能：Snapdragon Profiler 定位 CPU/GPU 瓶颈 → LLVM/AIMET 优化代码 / 模型
3. 影像调试：QACT 调 3A/ISP + Tracer 看 CamX 时序 + QXDM 抓传感器 / 总线日志
4. 死机故障：触发 ramdump → QCAP/RAMParser 解析崩溃根源
5. 救砖修复：EDL 9008 模式 + QFIL 整机重刷固件