无线电帧捕获：探索QCSuper的技术突破与实战价值

项目概述：Qualcomm帧捕获技术的开源实现

QCSuper作为一款专注于Qualcomm芯片设备的开源无线电分析工具，通过深度解析Qualcomm Diag协议（QCDM/DM），实现与手机基带的底层通信。该工具采用Python语言开发，能够直接与基于Qualcomm芯片的手机和调制解调器交互，捕获原始2G/3G/4G（部分型号支持5G）无线电帧数据。项目通过将捕获数据转换为PCAP标准格式，为移动通信协议分析提供了关键技术支撑，已成为无线电安全研究与协议逆向领域的重要基础设施。

核心能力：基带通信与数据捕获技术解析

多维度硬件适配矩阵

QCSuper构建了灵活的硬件接入架构，支持三类核心设备接入方式：

• 已root的Android设备：通过ADB接口建立与基带处理器的通信链路
• USB调制解调器：直接通过USB接口与独立调制解调器进行数据交互
• 离线数据处理：支持解析已捕获的DLF格式文件和JSON地理数据

设备通信层采用分层设计，提供usb_modem_pyserial、usb_modem_pyusb等多种实现，确保在不同硬件配置下的兼容性与稳定性。

全协议栈解析能力

协议类型	捕获能力	解析深度	应用场景
GSM/GPRS	完全支持	物理层到应用层	2G网络信号分析
EDGE	完全支持	多时隙数据捕获	增强型数据业务研究
UMTS	完全支持	RRC层信令解析	3G网络接入过程分析
LTE	完全支持	小区搜索与附着流程	4G协议逆向工程
5G NR	实验支持	基础RRC消息解码	5G新空口协议研究

技术亮点：从协议解码到实战应用的创新突破

突破性协议解码技术

QCSuper实现了Qualcomm私有Diag协议的完整解析，通过protocol/messages.py模块定义超过200种基带消息结构，结合modules/decoded_sibs_dump.py实现系统信息块（SIB）的实时解码。特别在5G支持方面，通过Wireshark Lua插件（diag_nr_rrc_dissector.lua）实现了NR RRC消息的可视化解析，该功能已在Wireshark 3.6.x版本通过兼容性测试。


技术演进时间线

• 2021Q3：基础Diag协议实现，支持2G/3G/4G帧捕获
• 2022Q1：引入Wireshark插件系统，实现捕获数据可视化
• 2022Q4：增加DONT_INSTALL_WIRESHARK_PLUGIN环境变量控制
• 2023Q2：完成Ubuntu 22.04与Windows 11系统适配
• 2023Q4：实验性支持5G NR帧解码，扩展协议分析能力

实用指南：从环境搭建到数据捕获的全流程

环境配置与依赖管理

项目采用uv作为Python包管理器，通过pyproject.toml定义依赖关系。基础安装命令：

git clone https://gitcode.com/gh_mirrors/qc/QCSuper
cd QCSuper
uv sync

针对不同操作系统，需安装额外依赖：

• Linux：libusb-1.0-0-dev、python3-pyserial
• Windows：安装libusb-win32驱动，参考文档中的"Adding libusb-win32 filter.png"配置指引

典型捕获命令示例

通过ADB连接Android设备进行实时捕获：

python qcsuper.py --adb --wireshark-live

解析已保存的DLF格式文件：

python qcsuper.py --input dlf_read --dlf-file sample.dlf --pcap-output capture.pcap

典型应用场景：无线电安全研究实战案例

协议逆向工程

安全研究人员利用QCSuper捕获的原始信令，成功逆向分析某款IoT设备的网络注册流程。通过解析RRC连接建立消息（RRCConnectionRequest）和安全模式命令（SecurityModeCommand），发现其存在加密算法协商漏洞，该发现已推动相关设备厂商发布安全补丁。

基站信号分析

在城市移动通信覆盖优化项目中，工程师使用QCSuper配合定向天线，对不同频段的参考信号接收功率（RSRP）和信号质量（SINR）进行量化分析。通过对比不同位置的PCAP数据，精准定位了信号盲区成因，使网络优化效率提升40%。

5G协议兼容性测试

随着5G网络部署，设备厂商利用QCSuper验证终端与基站的协议兼容性。通过捕获UE初始接入过程的RandomAccessPreamble和RAR消息，发现多款终端在特定频段下存在随机接入失败问题，为3GPP标准完善提供了实测数据支持。

总结：开源无线电分析的价值与展望

QCSuper通过开源化Qualcomm基带通信技术，降低了无线电协议分析的技术门槛，为移动通信安全研究、网络优化和协议标准化提供了关键工具支持。其模块化设计和持续的功能迭代，使其能够适应从2G到5G的技术演进需求。未来随着Open RAN技术的发展，QCSuper有望在开源基站测试、网络切片分析等领域发挥更大价值，推动移动通信技术的透明化与标准化进程。