支持软件 TNR/MCTF - Qualcomm Dragonwing Documentation

IQ-9075-EVKIQ-8275-EVKGPU 加速

GPU

处理引擎

NV12_Q08C

输入格式

MCTF

降噪

平台适用范围：
软件 TNR / MCTF 仅在 IQ-9075-EVK 和 IQ-8275-EVK 上启用。

01 · 它是什么？

运动补偿时域滤波（Motion Compensated Temporal Filtering） —— 一种基于软件的视频质量滤波器，可跨帧降低噪声 —— 在 IPE 硬件 MCTF 不可用的情况下运行于 GPU 上。 MCTF 通过降低时域噪声和增强运动清晰度来改善预览和视频质量。软件实现运行在 GPU 上，在静态区域执行帧间混合，并应用全局运动补偿变换。

02 · 它控制什么

SW MCTF Workflow Pipeline:
Current Frame  →  ME Matrix  →  Warp (prev frame)  →  Alpha Mask  →  Blend  →  Output Frame
Previous Output →  Noise Calc  →  Blend Input  ↗

阶段	作用	跳过的影响
运动估计（ME）	计算当前帧与前一帧之间的变换矩阵	无运动补偿 → 出现鬼影伪像
变形（Warp）	使用 ME 矩阵对前一输出帧进行变形	混合未对齐 → 出现拖影
Alpha 掩码	对背景与局部运动区域进行分类	静态噪声未被降低，运动区域过度混合
混合（Blend）	使用 alpha 掩码 + 噪声估计合并当前帧与前一帧	输出视频中可见时域噪声

对于高运动场景（机器人、汽车），降低 MCTF 混合强度可防止快速移动物体上出现时域鬼影。

03 · 验证

使用 SSH 连接到设备控制台。有关说明，请参阅 How To SSH?。

收集用户日志

实时监控 CamX 核心配置状态。

Log Collection

# On device console
journalctl -f > /opt/user_log.txt

收集内核日志

捕获 ISP 硬件管理器事件和获取信息。

Kernel Logging

dmesg -w > /opt/kernel_log.txt

使用 sw-tnr=true 运行 GStreamer 管线

使用 NV12_Q08C 格式执行管线并启用软件 TNR 标志。

GStreamer (SW MCTF Enablement)

gst-launch-1.0 -e qtiqmmfsrc name=camsrc video_0::type=preview sw-tnr=true ! \
video/x-raw,format=NV12_Q08C,width=1280,height=720,framerate=30/1 ! \
v4l2h264enc capture-io-mode=4 output-io-mode=5 \
extra-controls="controls,video_bitrate=6000000,video_bitrate_mode=0;" ! \
h264parse ! mp4mux ! filesink location=/opt/cam_prev.mp4

验证日志输出

通过检查用户日志中的以下确切日志条目来确认该功能已激活：CamX 管线状态：

User Log Verification

CamX: [CORE_CFG] 3509 3556 [CORE] camxpipeline.h:4222 SetPipelineStatus()
RealTimeFeatureZSLPreviewRawSWMCTF_0_cam_0 status is now PipelineStatus::STREAM_ON

MCTF 库初始化：

User Log Verification

CamX: [ INFO] 3509 3556 [CHI ] camxchimoduleswmctf.cpp:328 Initialize()
libmctf Version: 1.0.0

STREAM_ON 确认 CamX 管线已在启用 MCTF 的情况下运行。libmctf Version 字符串确认软件库已在 GPU 上初始化。

🛠️ 故障排查 / 已知问题 — 软件 TNR/MCTF

问题 / 现象	详情 / 备注
快速移动物体上出现鬼影伪像	高运动场景（机器人、汽车）可能导致时域鬼影 — 降低 MCTF 混合强度以缓解
用户日志中未看到 `STREAM_ON` 状态	CamX 管线可能未在启用 MCTF 的情况下运行 — 验证日志条目：`SetPipelineStatus() ... status is now PipelineStatus::STREAM_ON`
`libmctf` 库未初始化	如果用户日志中没有 `libmctf Version: 1.0.0`，则软件 MCTF 库在 GPU 上初始化失败 — 检查 `camxchimoduleswmctf.cpp:328 Initialize()`

GPU

NV12_Q08C

MCTF

​01 · 它是什么？

​02 · 它控制什么

​03 · 验证

​🛠️ 故障排查 / 已知问题 — 软件 TNR/MCTF

01 · 它是什么？

02 · 它控制什么

03 · 验证

🛠️ 故障排查 / 已知问题 — 软件 TNR/MCTF