瑞芯微RV1126/RV1109实战：用RKMEDIA搞定H.264编码与JPEG解码的完整流程（附代码）

瑞芯微RV1126/RV1109实战：用RKMEDIA搞定H.264编码与JPEG解码的完整流程（附代码）

在嵌入式视觉应用开发中，瑞芯微RV1126/RV1109凭借其强大的媒体处理能力成为智能摄像头、边缘计算设备的首选平台。本文将带您深入RKMEDIA框架，通过一个"智能抓拍+本地预览"的完整案例，拆解H.264视频编码与JPEG图像解码的全流程实现。不同于常规的API说明文档，我们将聚焦工程实践中的高频痛点，包括编码参数调优、OSD叠加的坑点规避、解码数据正确保存等关键环节。

1. 环境搭建与基础配置

开发前的准备工作往往决定后续调试效率。RV1126开发板建议使用官方提供的Debian 10系统镜像，内核版本需≥4.19。通过apt-get install librockchip-mpp-dev安装MPP开发包后，确认以下关键组件：

# 检查硬件编解码器状态 cat /proc/asound/cards | grep -i rockchip dmesg | grep -i vpu

典型问题排查表：

在代码层面，基础头文件包含这些关键组件：

#include <rockchip/rk_mpi.h> #include <rockchip/rk_venc_cmd.h> #define ALIGN_64(x) (((x) + 63) & ~63) // 内存对齐宏

2. H.264编码实战：从采集到优化

2.1 编码通道初始化

以下代码展示如何建立H.264 CBR编码通道，特别注意帧率控制的实现逻辑：

VENC_CHN_ATTR_S venc_attr = { .stVencAttr = { .enType = RK_CODEC_TYPE_H264, .imageType = IMAGE_TYPE_NV12, .u32PicWidth = 1920, // 需与VI输出严格一致 .u32PicHeight = 1080, .u32Profile = 66 // Baseline Profile }, .stRcAttr = { .enRcMode = VENC_RC_MODE_H264CBR, .stH264Cbr = { .u32Gop = 30, .u32BitRate = 4000000, // 4Mbps .fr32DstFrameRateDen = 1, .fr32DstFrameRateNum = 25, .u32SrcFrameRateDen = 1, .u32SrcFrameRateNum = 25 // 1:1帧率控制 } } }; RK_MPI_VENC_CreateChn(0, &venc_attr);

关键参数说明：

• u32Profile：77对应Main Profile，66为Baseline
• fr32DstFrameRateNum/Den：与输入帧率构成分数关系，设为相同值实现1:1透传
• u32BitRate：建议初始值设为分辨率乘积（1920x1080≈2Mbps）

2.2 QP动态调节技巧

通过实时获取和修改RC参数实现画质优化：

VENC_RC_PARAM_S rc_param; RK_MPI_VENC_GetRcParam(0, &rc_param); // 动态调整QP范围（I帧与非I帧独立控制） rc_param.stParamH264.u32MinQp = 25; // 下限越高码率越低 rc_param.stParamH264.u32MaxQp = 40; // 上限越低画质越稳 rc_param.stParamH264.u32MinIQp = 22; // I帧独立控制 RK_MPI_VENC_SetRcParam(0, &rc_param);

提示：夜间场景可适当提高QP下限减少码率波动，运动场景则应放宽QP上限避免马赛克

2.3 OSD叠加的工业级实现

RKMEDIA原生OSD存在256色限制，推荐通过RGA+Region方案实现高质量叠加：

// 创建ARGB8888画布 BITMAP_S bitmap = { .enPixelFormat = PIXEL_FORMAT_ARGB_8888, .u32Width = 320, .u32Height = 240, .pData = malloc(320*240*4) }; // 绘制文字（需自行实现字库解析） draw_text(bitmap.pData, "2024-07-15", 10, 10, 0xFFFF0000); // 配置叠加区域 OSD_REGION_INFO_S region = { .enRegionId = REGION_ID_0, .u32PosX = 50, .u32PosY = 50, .u32Width = 320, .u32Height = 240, .u8Inverse = 0 // 反色显示 }; RK_MPI_VENC_RGN_SetBitMap(0, &region, &bitmap);

避坑指南：

1. 动态更新OSD内容时，每次修改后必须重新调用SetBitMap
2. 区域位置超出编码分辨率会导致静默失败
3. 多区域叠加时，ID越小优先级越高

3. JPEG解码与YUV处理

3.1 解码通道配置

JPEG解码需特别指定帧模式，并注意内存分配策略：

VDEC_CHN_ATTR_S dec_attr = { .enCodecType = RK_CODEC_TYPE_JPEG, .enMode = VIDEO_MODE_FRAME, // JPEG必须使用帧模式 .enDecodecMode = VIDEO_DECODEC_HADRWARE, .u32FrameBufferCnt = 3 // 减少内存占用 }; RK_MPI_VDEC_CreateChn(0, &dec_attr); // 设置解码超时（避免硬件复位） system("echo 500 > /sys/module/rk_vcodec/parameters/mpp_dev_timeout");

3.2 YUV数据正确保存

解码后YUV数据的存储需要处理stride对齐问题：

MB_BLK mb = RK_MPI_SYS_GetMediaBuffer(RK_ID_VDEC, 0, -1); int width = RK_MPI_MB_GetWidth(mb); int height = RK_MPI_MB_GetHeight(mb); int stride = ALIGN_64(width); // 获取实际内存步进 FILE *fp = fopen("output.yuv", "wb"); uint8_t *y_plane = RK_MPI_MB_GetPtr(mb); uint8_t *uv_plane = y_plane + stride * ALIGN_64(height); // 按实际分辨率写入，跳过对齐填充部分 for (int i=0; i<height; i++) fwrite(y_plane + i*stride, 1, width, fp); for (int i=0; i<height/2; i++) fwrite(uv_plane + i*stride, 1, width, fp);

常见问题排查：

• 绿色条纹：UV平面地址计算错误
• 图像错位：未考虑stride与width的差异
• 花屏：文件写入未使用二进制模式

4. 性能调优与监控

4.1 实时状态监控命令集

# 查看编码负载 watch -n 1 "cat /proc/mpp_service/session_summary" # 监控DDR带宽 cat /sys/kernel/debug/dmc/bandwidth # 查看温度与频率 cat /sys/class/thermal/thermal_zone*/temp cat /sys/kernel/debug/clk/clk_summary | grep -E 'venc|jpeg'

4.2 编码参数优化对照表

4.3 内存泄漏检测方案

通过proc文件系统监控解码内存：

while true; do cat /proc/mpp_service/vdpu/session_buffers cat /proc/mpp_service/vepu/session_buffers sleep 1 done

若发现缓存持续增长，可通过以下方式回收：

// 强制清空解码缓存 system("echo 1 > /proc/mpp_service/vdpu/reset");