时间版本修改内容2026-6-21.0第一版一、/proc/umap/到底是什么每个文件都是对应 MPP 内核模块注册的只读状态快照debug info内容来自各模块的proc_show()回调。你只能用cat/proc/umap/vicat/proc/umap/vbcat/proc/umap/sys来做运行时诊断通道建没建、buffer 够不够、绑对了没、哪里 leak 了不能直接写它来控制模块。真正控制走的是用户态 MPI 接口libss_mpi.ass_mpi_*/ 老命名HI_MPI_*。二、逐个节点详解按功能域分组 1. 系统基础 / 内存最先要懂的两个umap 节点模块作用你看它干什么用sysSYS 系统控制MPP 全局版本、初始化状态、模块生命周期确认 MPP 起来了没、版本对不对vbVB 视频缓存池所有视频帧 buffer poolVB Pool分配/使用/泄漏统计最常用——oom 先看这里cat /proc/umap/vbmedia-memMMZ / 大块物理内存相当于cat /proc/media-mem的伙伴信息谁占了多少连续内存查 DDR 是不是被吃光logmppMPP log 系统读取/设置各模块 log levelecho venc7 /dev/logmpp这种对应 API 头文件ot_common_buffer.h/ot_buffer.hss_mpi_sys.h→ss_mpi_sys_init()/ss_mpi_sys_exit()VB 相关ss_mpi_vb.h→ss_mpi_vb_create_pool()/ss_mpi_vb_destroy_pool()绑定ss_mpi_sys_bind()/ss_mpi_sys_unbind() 2. 视频输入链Sensor → VI → ISPumap 节点模块全称功能关键 API 头文件viVI — Video Input从 MIPI/CIF/BT1120 接 sensor建 DEV/PIPE/CHN做裁剪、镜像、缩放、在线/离线ss_mpi_vi.h/ot_common_vi.hispISP — Image Signal Processorsensor 的 RAW→YUV 管线曝光、白平衡、降噪、镜头校正等ss_mpi_isp.h/ot_common_isp.hmipi_rxMIPI Rx 控制器MIPI-CSI 物理层链路状态lane 数、时钟、数据类型通常配设备树 sensor driverAPI 侧走 VIchnlVI 内部通道管理层VI 的 pipe/channel 调度细节偏内部—数据流角色Sensor → MIPI_RX → VI(PIPE) → [ISP] → 输出 YUV → VPSS/VENC/VO典型 API 调用链ss_mpi_vi_set_dev_attr()// 配置VI设备ss_mpi_vi_create_pipe()// 创建PIPEss_mpi_vi_start_pipe()// 启动// 然后从PIPE的某个通道取帧 或 通过 sys_bind 把数据推给VPSS/VENC 3. 视频处理VPSS — 裁剪/缩放/NR/格式转换/多路输出umap 节点模块功能vpssVPSS — Video Processing Sub-System图像预处理CROP、缩放、3DNR、LDC、像素格式转换、多路不同分辨率输出对应 APIss_mpi_vpss.h/ot_common_vpss.hss_mpi_vpss_create_grp()/_start_grp()/_send_frame()/_get_chn_frame()经典绑定VI → bind → VPSS(GRP) → [CHN0 1080p] [CHN1 720p] → 各自 bind → VENC 4. 视频编码 / 解码编码侧umap 节点模块功能vencVENC — Video EncoderH.264 / H.265 / MJPEG 编码通道状态h264eH.264 编码器硬件实例编码核级寄存器/性能信息更底层h265eH.265 编码器硬件实例同上jpegeJPEG 编码抓拍帧的 JPEG 压缩rcRate Control码控状态QP、bitrate 波动、跳帧记录APIss_mpi_venc.h→ss_mpi_venc_create_chn()/_start_recv_pic()/_get_stream()/_release_stream()解码侧umap 节点模块功能vdecVDEC — Video Decoder解码通道状态vfmw_ctrlVFMW 解码框架控制块解码器公共信息vfmw_stmVFMW stream码流 buffer 信息vfmw_synVFMW syntax语法解析层信息vfmw_decVFMW decoder HW硬件配置层信息jpegdJPEG 解码JPEG 静态图解码APIss_mpi_vdec.h→ss_mpi_vdec_create_chn()/_send_stream()/__get_frame() 5. 视频输出VO — HDMI / LCD / BT1120umap 节点模块功能voVO — Video Output视频图层/设备/通道输出LCD、HDMI TXhdmi0HDMI 控制器状态PHY/控制器信息hdmi0_sinkEDID / sink 能力读到的显示器分辨率/色深hdmi0_voHDMI-VO 绑定视图VO 的 HDMI 输出通道详情hdmi0_aoHDMI Audio OutputHDMI 音频较少用取决于硬件gfbg0/1/3GFX GFB 图形帧缓冲GFXGUI/OSD图层 overlay对应/dev/fbXAPIss_mpi_vo.h/ot_common_vo.h 6. 图像算法硬件加速IVE / GDC / TDE / VGSumap 节点模块功能典型用途iveIVE — IVE/NNIE 算子加速器计算机视觉算子Sobel、Canny、形态学…传统 CV 前处理gdcGDC — Geometry Distortion Correction镜头畸变校正鱼眼展开、透视校正IPCAM / 360camtdeTDE — 2D 位图引擎快速填充/blit/旋转/alpha blendUI合成、OSD搬图vgsVGS — Video Graphics Sub-system视频域轻量处理resizeOSD blend比 VPSS 轻简单叠加/缩放matchDPU Match运动匹配/特征匹配偏内部调试—rectDPU Rect矩形绘制/框选叠加—disDIS — Digital Image Stabilization电子防抖车载/IPCAM 7. 音频全链路AI → AENC → ADEC → AOumap 节点模块功能aiAI — Audio Input从 I2S/内置 codec 采 PCMaioAIOAIP/AOP 端口层音频端口抽象aencAENC — Audio EncoderG.711/AAC 等编码adecADEC — Audio Decoder解码播放aoAO — Audio Output播 PCM 到 HP/Lineoutacodec内置 Audio Codec 寄存器视图音量/增益/电源状态audec/??不过这里你只有上面这些——APIss_mpi_ai.h/ss_mpi_ao.h/ss_mpi_aenc.h/ss_mpi_adec.h 8. 高级/扩展模块umap 节点模块功能avsAVS — 图像拼接多路输入做 panorama/stitchingmcfMCF — Multi-Camera FusionVPSS-MCF多摄融合场景mdMD — Motion Detection常挂 VDA/IVE 下移动侦测rgnRGN — Region 叠加管理OSD 文字/位图/马赛克区域chnlVI 内部通道管理pipe↔chn调度mauMAUMemory Access Unit 监控内部带宽/访问调试tsfw/aicpu/npudev/npudfxNPU 相关SS928V100 集成 NPUtsfwtask scheduler firmwareaicpuAI CPUnpu dev/dfx 是 NPU 驱动调试节点跟 MPP 音视频主链路无关但同包加载dsp音频 DSP可选部分版本用 DSP 做音效/回声消除ot_user占位/user扩展给用户自定义 proc 挂点三、总结总表umap 节点中文名属于域你用它查什么主控 API 头文件sys系统控制基础MPP版本/初始化状态ss_mpi_sys.hvb视频缓存池基础/内存buffer泄漏第一现场ss_mpi_vb.hmedia-memMMZ物理内存基础/内存连续内存占用分布—proclogmppMPP日志基础开调试打印/dev/logmppvi视频输入视频采集pipe/channel/丢帧/FPSss_mpi_vi.hisp图像信号处理视频采集曝光/降噪/3A状态ss_mpi_isp.hmipi_rxMIPI接收视频采集lane/clock/sensor链路设备树sensor drvvpss视频处理视频处理GRP/CHN/缩放/裁剪/FPSss_mpi_vpss.hvenc视频编码编码chn状态/码率/FPS/errss_mpi_venc.hh264e/h265e编码硬核编码硬核级性能/寄存器统计偏内部jpege/jpegdJPEG编/解码编解码抓拍或静态图ss_mpi_venc.h/ss_mpi_vdec.hrc码率控制编码QP波动/跳帧记录ss_mpi_venc.hvdec视频解码解码chn状态/错误计数/PTSss_mpi_vdec.hvfmw_ctrl/stm/syn/dec解码框架解码解码内部阶段诊断偏内部vo视频输出显示图层/设备/输出状态ss_mpi_vo.hhdmi0 / hdmi0_sink / hdmi0_voHDMI显示显示器EDID/连接/输出ss_mpi_vo.hgfbg0/1/3图形FB显示GFX overlay图层/dev/fbXive视觉加速算法算子任务状态ss_mpi_ive.hgdc畸变校正算法校正任务/FPSss_mpi_gdc.htde2D位图引擎算法blit/填充性能ss_mpi_tde.hvgs视频图形轻量处理轻量resizeOSDss_mpi_vgs.hrgn区域叠加OSD叠加OES区域属性/显隐ss_mpi_rgn.hai / ao / aenc / adec / aio / acodec音频全链路音频采播/编码解码状态ss_mpi_ai.hss_mpi_ao.hetc.avs图像拼接高级stitch状态ss_mpi_avs.hdis电子防抖高级防抖补偿状态ss_mpi_dis.htsfw / aicpu / npudev / npudfxNPU子系统非MPP视频NPU调试独立NPU SDK四、实用速查你日常排查时最有用的 5 个cat/proc/umap/sys# MPP活没活cat/proc/umap/vb# buffer池——泄漏/不够从这里看出来cat/proc/umap/vi# sensor数据有没有进来、丢帧在哪cat/proc/umap/venc# 编码通不通、FPS对不对、err计数是不是在涨cat/proc/umap/vo# 有画面出不来查VO