保姆级教程：在Rockchip RK板子上搞定RGA、DRM和MPP库的完整安装与验证

嵌入式Linux开发实战：Rockchip平台RGA/DRM/MPP全栈环境搭建指南

拿到一块崭新的Rockchip开发板时，多媒体处理能力的释放往往从三个关键库开始：负责2D图形加速的RGA、管理显示输出的DRM，以及处理视频编解码的MPP。但官方文档的碎片化和社区教程的版本差异，让不少开发者在环境配置阶段就消耗了不必要的精力。本文将用实验室级别的精准操作，带你穿越依赖迷宫。

1. 环境准备：从零构建编译基石

嵌入式开发环境的搭建就像盖房子，地基的稳固程度决定了后续所有工作的效率。Rockchip平台的编译工具链有其特殊性，我们需要特别注意工具版本与硬件架构的匹配。

基础编译工具安装（适用于Ubuntu/Debian系系统）：

sudo apt update && sudo apt install -y \ build-essential \ git \ cmake \ autoconf \ automake \ libtool \ pkg-config \ libdrm-dev

提示：如果使用其他Linux发行版，需替换apt为对应的包管理命令（如yum或dnf），部分软件包名称可能有差异。

现代构建工具meson和ninja已成为Rockchip推荐的工具链组合，它们的安装需要特别注意版本兼容性：

# 获取meson最新稳定版 git clone --depth 1 -b 0.63.2 https://github.com/mesonbuild/meson.git sudo cp meson/meson.py /usr/local/bin/meson sudo chmod +x /usr/local/bin/meson # 编译安装ninja git clone --depth 1 -b v1.11.1 https://github.com/ninja-build/ninja.git cd ninja && ./configure.py --bootstrap sudo cp ninja /usr/local/bin/

验证工具链是否就位：

meson --version # 应输出0.63.2或更高 ninja --version # 应显示1.11.1或更高

2. DRM驱动部署：显示系统的核心枢纽

libdrm-rockchip是连接内核DRM驱动与用户空间的关键中间层，其定制版实现了Rockchip特有的显示管线控制功能。安装过程需要注意自动生成配置文件的细节。

从源码编译安装：

git clone --depth 1 -b rk33-mid-9.0-develop https://github.com/rockchip-linux/libdrm-rockchip.git cd libdrm-rockchip # 生成配置脚本 autoreconf -fiv

配置阶段的关键参数说明：

执行编译安装：

./configure --prefix=/usr/local --enable-rockchip --enable-udev make -j$(nproc) sudo make install

环境配置：

# 更新动态库缓存 sudo ldconfig # 验证安装 ls /usr/local/lib/libdrm_rockchip.so # 确认库文件存在

3. RGA加速库：嵌入式图形处理的瑞士军刀

Rockchip的RGA（Raster Graphic Acceleration）硬件加速器能高效处理旋转、缩放、格式转换等操作，其Linux用户空间库的安装需要特别注意符号链接的创建。

源码获取与编译：

git clone --depth 1 https://github.com/rockchip-linux/linux-rga.git cd linux-rga

使用meson构建时，建议创建独立的build目录：

mkdir build && cd build meson setup --prefix=/usr .. ninja

安装后需要手动创建版本化符号链接：

sudo cp librga.so* /usr/lib/ sudo ldconfig # 验证安装 ls /usr/lib/librga.so # 应显示有效的符号链接

测试用例验证：

cd ../demo && make ./rga_demo # 运行测试程序观察输出

4. MPP框架：视频编解码的硬件钥匙

媒体处理框架（Media Process Platform）是Rockchip视频编解码硬件的统一接口，其编译配置需要根据具体芯片型号调整。

源码编译关键步骤：

git clone --depth 1 https://github.com/rockchip-linux/mpp.git cd mpp

MPP的CMake配置参数解析：

针对RK3399的典型配置：

mkdir build && cd build cmake -DCMAKE_INSTALL_PREFIX=/usr \ -DRKPLATFORM=ON \ -DHAVE_DRM=ON \ -DCMAKE_BUILD_TYPE=Release .. make -j$(nproc) sudo make install

验证安装：

# 检查安装文件 ls /usr/lib/librockchip_mpp.so # 运行测试程序 cd ../test && mkdir build && cd build cmake .. && make ./mpp_dec_test -i test.h264 -t 7 # H.264解码测试

5. 联合调试：三库协同实战

当三个库都就位后，真正的挑战在于让它们协同工作。下面是一个典型的视频处理流水线验证方案。

创建测试项目目录结构：

video_pipeline/ ├── CMakeLists.txt ├── include │ ├── drm_utils.h │ └── rga_utils.h └── src ├── main.c └── drm_utils.c

关键CMake配置：

cmake_minimum_required(VERSION 3.10) project(video_pipeline) set(CMAKE_C_STANDARD 11) find_package(PkgConfig REQUIRED) pkg_check_modules(DRM REQUIRED libdrm) pkg_check_modules(RGA REQUIRED librga) pkg_check_modules(MPP REQUIRED rockchip_mpp) include_directories( ${DRM_INCLUDE_DIRS} ${RGA_INCLUDE_DIRS} ${MPP_INCLUDE_DIRS} ) add_executable(pipeline src/main.c src/drm_utils.c) target_link_libraries(pipeline ${DRM_LIBRARIES} ${RGA_LIBRARIES} ${MPP_LIBRARIES} pthread )

典型问题排查指南：

1. 头文件包含错误：

   // 错误示例 #include <drm/drm_mode.h> // 正确写法 #include <libdrm/drm_mode.h>

2. 链接库顺序问题：

   # 错误顺序会导致未定义引用 target_link_libraries(pipeline drm rockchip_mpp rga) # 正确顺序 target_link_libraries(pipeline rockchip_mpp rga drm)

3. 权限问题处理：

   # 将用户加入video和render组 sudo usermod -aG video,render $(whoami)

6. 性能调优与进阶技巧

环境搭建只是起点，真正的价值在于发挥硬件全部潜力。以下是一些实战中积累的优化经验。

RGA性能调优参数：

MPP解码器缓冲池配置：

MppDecCfg cfg; mpp_dec_cfg_init(&cfg); // 针对1080p视频的推荐设置 mpp_dec_cfg_set_s32(cfg, "base:out_count", 6); mpp_dec_cfg_set_s32(cfg, "base:input_timeout", 100); mpp_dec_cfg_set_s32(cfg, "base:output_timeout", 100);

DRM显示流水线调试命令：

# 查看当前显示模式 modetest -M rockchip # 测试具体显示管线 modetest -M rockchip -s 38@35:1920x1080 -P 39@35:1920x1080

在RK3399平台上实测，经过优化的视频处理流水线可以实现：

• 1080p30 H.264解码延迟 < 30ms
• 图像缩放处理吞吐量 > 60fps
• 色彩空间转换耗时 < 5ms