高通QXDM无法捕获5G NR信令，如何配置正确的log mask？

Question

高通QXDM无法捕获5G NR信令，常见原因在于Log Mask配置未启用关键5G协议栈日志。默认配置通常仅开启LTE/UMTS日志，而NR相关模块（如NR RRC、NR MAC、NR PHY、NGAP、XnAP、PDCP-NR）处于关闭状态。需在QXDM中进入「File → Configure Logs」→ 选择对应Modem（如“SA”或“NSA”模式）→ 展开「5G NR」节点，手动勾选：`NR_RRC_OTA_Outgoing_Message`、`NR_RRC_OTA_Incoming_Message`、`NR_MAC_OTA_Packet`、`NR_PDCP_DL/UL_Stats`及`NR_PHY_Timing_Advance`等核心log items；同时确保`Log Level`设为“Verbose”或“Debug”，并确认`NR Feature Enable`在Modem侧已激活（可通过QXDM命令`AT+QCFG="nr5gmode"`验证）。若仍无NR日志，需检查QXDM版本是否支持目标芯片平台（如SDX55/62/72），并确认固件已加载含NR log capability的DSP image。错误配置将导致NR信令“静默”，误判为终端无5G接入能力。

Answer 1

```html

一、现象层：QXDM日志界面“5G NR信令完全空白”

在连接高通终端（如搭载SDX55/62/72平台的CPE或手机）进行现场路测或实验室复现时，QXDM v4.9+界面中仅可见LTE RRC、NAS、MAC等日志流，而NR_RRC_OTA_Incoming_Message、NR_MAC_OTA_Packet等关键条目持续无输出——即使终端已稳定驻留5G SA/NSA小区、UE Capability IE明确上报NR支持能力。该现象常被一线工程师误判为“终端未接入5G”，实则为日志通道“静默关闭”。

二、配置层：Log Mask默认禁用全部5G协议栈模块

• QXDM默认Log Configuration模板（如Default_Qualcomm_Modem_Logs.cfg）仅启用UMTS/LTE协议栈，「5G NR」节点处于折叠+全未勾选状态；
• 关键log items需手动展开并启用：NR_RRC_OTA_Outgoing_Message（含SIB1/Reconfiguration/Release）、NR_RRC_OTA_Incoming_Message（含MeasurementReport/ConnectionSetupComplete）、NR_MAC_OTA_Packet（含UL Grant/DCI解析）、NR_PDCP_DL_Stats与NR_PDCP_UL_Stats（含ROHC状态与丢包标记）、NR_PHY_Timing_Advance（TA调整闭环验证）；
• Log Level必须设为Verbose（非Warning/Error），否则NR RRC消息体将被截断（仅保留Header）。

三、系统层：Modem侧NR功能开关与固件能力校验

即使QXDM配置正确，若Modem底层未激活NR日志能力，仍将无数据输出。需执行以下双轨验证：

验证项	命令/路径	预期响应
NR协议栈使能状态	AT+QCFG="nr5gmode"	+QCFG: "nr5gmode",1（1=enabled）
DSP Image NR Log Capability	QXDM → View → DSP Log Configuration	确认NR_PHY_LOG_ENABLE、NR_RRC_LOG_ENABLE为TRUE

四、平台层：QXDM版本与芯片平台兼容性矩阵

高通不同SoC对日志架构有代际差异，旧版QXDM无法解析新平台NR log format：

● SDX55 (Snapdragon X55) → 需 QXDM v4.7.0.1+（支持NR SA PDCP-NR加密上下文解码）
● SDX62 (Snapdragon X62) → 需 QXDM v4.8.2.0+（新增XnAP/NGAP分片重组日志）
● SDX72 (Snapdragon X72) → 需 QXDM v4.9.3.0+（支持FR2 mmWave Beam Report OTA日志）

五、诊断流程：结构化排障决策树

graph TD
  A[QXDM无NR日志] --> B{Modem是否驻留5G小区？}
  B -->|否| C[检查SIM/PLMN/NR频段配置]
  B -->|是| D{AT+QCFG=\"nr5gmode\"返回1？}
  D -->|否| E[通过AT+QNVWRITE写入nv 35037=1]
  D -->|是| F[进入Configure Logs → 5G NR节点全勾选+Verbose]
  F --> G{DSP Log Configuration中NR_*_LOG_ENABLE=TRUE？}
  G -->|否| H[刷写含NR_LOG_SUPPORT的DSP image]
  G -->|是| I[捕获成功：NR_RRC_OTA_Incoming_Message可见]

六、进阶要点：NR日志链路的三层耦合关系

1. 应用层：QXDM UI的Log Mask配置决定“请求哪些log ID”；
2. 中间层：Modem侧QMI/QXDM Agent根据mask生成log packet，并经HS-USB/PCIe传输；
3. 硬件层：DSP firmware需在编译时开启FEATURE_NR_LOGGING宏，否则即使QXDM发送enable指令，DSP仍静默丢弃NR log buffer。

七、典型误操作与规避清单

• ❌ 仅勾选NR_RRC_State_Machine（状态机摘要）而忽略NR_RRC_OTA_Incoming_Message（完整信令）；
• ❌ 在NSA模式下错误启用SA_NR_RRC子集（应启用EN_DC_NR_RRC）；
• ❌ 使用QXDM v4.6打开SDX72设备——导致NR PHY Timing Advance字段解析失败并触发log drop；
• ✅ 推荐实践：导出当前配置为NR_SA_FullCapture.cfg，并用diff工具比对基线配置。

```