LubanCat-5IO (RK3588) 编译安装 FFmpeg 硬编解码版，支持 MPP/RGA 硬件加速

LubanCat-5IO (RK3588) 编译安装 FFmpeg 硬编解码版支持 MPP/RGA 硬件加速本文介绍如何在野火 LubanCat-5IORockchip RK3588开发板上从源码编译安装ffmpeg-rockchip启用MPP 硬件编解码和RGA 硬件滤镜实现视频处理的全面硬件加速。目录1. 背景2. 硬件与系统环境3. 安装编译依赖4. 编译 ffmpeg-rockchip5. 安装6. 验证硬编解码支持7. 使用示例8. 踩坑记录9. 总结参考链接1. 背景Rockchip RK3588 内置强大的多媒体处理单元MPPMedia Process Platform硬件视频编解码支持 H.264/H.265/VP9/AV1 等格式RGARaster Graphic Acceleration2D 图像硬件加速支持缩放、旋转、格式转换但通过apt install ffmpeg安装的标准 FFmpeg不带 Rockchip 硬件加速支持。想要用上硬件编解码需要编译 nyanmisaka/ffmpeg-rockchip 这个专为 Rockchip 优化的 FFmpeg 分支。2. 硬件与系统环境项目参数开发板Embedfire LubanCat-5IOSoCRockchip RK3588(S)CPU四核 A76 2.4GHz 四核 A55 1.8GHzGPUARM Mali-G610NPU6 TOPS内存8 GB LPDDR4X操作系统Debian GNU/Linux 12 (bookworm)内核Linux 6.1.99-rk3588架构aarch64 (ARM64)3. 安装编译依赖3.1 基础构建工具sudoaptupdatesudoaptinstall-ygitmeson cmake pkg-config gcc ninja-build3.2 开发库sudoaptinstall-ylibasound2-dev⚠️注意野火 Debian 镜像中libdrm-dev、libv4l-dev、librga-dev、librockchip-mpp-dev等包被apt-mark hold锁定。但这些库已预装在系统中可直接使用无需重复安装。验证 pkg-config 依赖是否就绪pkg-config--existslibdrmecholibdrm: OK||echolibdrm: MISSINGpkg-config--existsrockchip_mppechorockchip_mpp: OK||echorockchip_mpp: MISSINGpkg-config--existslibrgaecholibrga: OK||echolibrga: MISSINGpkg-config--existslibv4l2echolibv4l2: OK||echolibv4l2: MISSINGpkg-config--existsalsaechoalsa: OK||echoalsa: MISSING全部输出OK即可继续。4. 编译 ffmpeg-rockchip4.1 克隆源码mkdir-p~/ffmpegcd~/ffmpeggitclone--depth1https://github.com/nyanmisaka/ffmpeg-rockchip.git ffmpeg-rockchipcdffmpeg-rockchip--depth1只克隆最新提交大幅加快克隆速度。4.2 配置编译选项./configure\--prefix/usr\--enable-gpl\--enable-version3\--enable-libdrm\--enable-rkmpp\--enable-rkrga\--enable-alsa\--enable-libv4l2关键参数说明参数作用--enable-rkmpp启用 MPP 硬件编解码器--enable-rkrga启用 RGA 硬件滤镜缩放/合成/裁剪--enable-libdrmDRM 支持显存零拷贝--enable-libv4l2V4L2 摄像头采集支持--enable-alsaALSA 音频采集支持看到config.h is unchanged等输出且无报错即配置成功。4.3 编译make-j$(nproc)RK3588 有 8 个核心-j$(nproc)利用全部核心并行编译3~5 分钟即可完成。5. 安装sudomakeinstall安装到/usr前缀会覆盖系统原有的 ffmpeg如有。安装后验证版本ffmpeg-version输出示例ffmpeg version 40c412d Copyright (c) 2000-2023 the FFmpeg developers built with gcc 12 (Debian 12.2.0-14deb12u1) configuration: --prefix/usr --enable-gpl --enable-version3 --enable-libdrm --enable-rkmpp --enable-rkrga --enable-alsa --enable-libv4l26. 验证硬编解码支持6.1 查看 rkmpp 硬件解码器ffmpeg-decoders2/dev/null|greprkmpp输出V..... av1_rkmpp AV1 硬件解码器 V..... h263_rkmpp H.263 硬件解码器 V..... h264_rkmpp H.264 硬件解码器 V..... hevc_rkmpp H.265/HEVC 硬件解码器 V..... mjpeg_rkmpp MJPEG 硬件解码器 V..... mpeg1_rkmpp MPEG-1 硬件解码器 V..... mpeg2_rkmpp MPEG-2 硬件解码器 V..... mpeg4_rkmpp MPEG-4 硬件解码器 V..... vp8_rkmpp VP8 硬件解码器 V..... vp9_rkmpp VP9 硬件解码器✅ 共10 种硬件解码格式。6.2 查看 rkmpp 硬件编码器ffmpeg-encoders2/dev/null|greprkmpp输出V..... h264_rkmpp H.264 硬件编码器 V..... hevc_rkmpp H.265/HEVC 硬件编码器 V..... mjpeg_rkmpp MJPEG 硬件编码器✅ 共3 种硬件编码格式。6.3 查看 rkrga 硬件滤镜ffmpeg-filters2/dev/null|greprkrga输出... overlay_rkrga 视频合成硬件加速 ... scale_rkrga 视频缩放 格式转换硬件加速 ... vpp_rkrga 视频后处理缩放/裁剪/转置硬件加速✅ 共3 种RGA 硬件滤镜。7. 使用示例7.1 硬件解码 RGA 缩放 硬件编码将 4K 视频硬件解码RGA 缩放到 1080p再硬件编码为 H.264ffmpeg-c:vh264_rkmpp-iinput_4k.mp4\-vfscale_rkrga1920:1080\-c:vh264_rkmpp-b:v4000k\output_1080p.mp47.2 USB 摄像头硬件编码推 RTSP 流# 先查看摄像头设备节点v4l2-ctl --list-devices# 以 H.264 硬件编码推流到 MediaMTX RTSP 服务器ffmpeg\-fv4l2-video_size1920x1080-framerate30\-pixel_formatnv24-i/dev/video0\-vfformatyuv420p\-c:vh264_rkmpp-b:v4000k-g60\-frtsp-rtsp_transporttcp\rtsp://127.0.0.1:8554/live7.3 AV1 硬件解码转 H.265 硬件编码ffmpeg-c:vav1_rkmpp-iinput_av1.mkv\-c:vhevc_rkmpp-b:v6000k\-c:acopy output_hevc.mp47.4 多个 RGA 滤镜组合ffmpeg-c:vh264_rkmpp-iinput.mp4\-vfscale_rkrga1280:720,vpp_rkrgaw640:h480:x100:y50\-c:vh264_rkmpp-b:v2000k output.mp48. 踩坑记录8.1 依赖版本不匹配binNMU 冲突libdrm-dev、libv4l-dev等包在野火 Debian 镜像中被apt-mark hold锁定且已安装版本与 Debian 官方源的 binNMU 版本b1/b2后缀不一致直接apt install会报依赖错误。解决方案系统预装的开发库已满足编译需求跳过这些包的升级直接使用已有版本即可。8.2 野火系统预装 MPP/RGA 库LubanCat-5IO 的 Debian 镜像已预装librockchip-mpp-dev1.5.0和librga-dev2.2.0且与nyanmisaka/ffmpeg-rockchip兼容。无需按官方指南重新编译 MPP 和 RGA 库可直接跳到 ffmpeg 编译步骤。8.3 静态库而非动态库ffmpeg-rockchip默认编译为静态链接static: yes, shared: no生成的ffmpeg二进制文件较大约 80MB但不依赖外部.so库部署更简单。9. 总结通过编译nyanmisaka/ffmpeg-rockchipLubanCat-5IO 可以获得完整的硬件视频加速能力能力支持格式硬件解码H.264, H.265, AV1, VP8, VP9, MPEG-1/2/4, H.263, MJPEG硬件编码H.264, H.265, MJPEGRGA 滤镜缩放、裁剪、转置、合成、格式转换配合 RK3588 的 6 TOPS NPU 和 Mali-G610 GPULubanCat-5IO 是一台非常适合边缘 AI 视频处理场景的强大开发板。参考链接nyanmisaka/ffmpeg-rockchip — FFmpeg Rockchip 硬件加速分支nyanmisaka/ffmpeg-rockchip Wiki — 使用手册野火 LubanCat 官方文档 - FFmpeg 安装MediaMTX — RTSP 流媒体服务器野火 LubanCat 快速使用手册 本文基于 LubanCat-5IO (RK3588) Debian 12 实测编写编译日期2026-07-06。如果觉得本文有帮助欢迎点赞、收藏、关注~