RK3588 Linux RGA 使用教程 (从零开始无脑运行RGA示例)

1. 准备工作

确保你已经拥有：

• 一块RK3588开发板（如Rockchip EVB、Orange Pi 5等）并安装了Linux系统（推荐Ubuntu 20.04或Debian）。
• 开发板已经联网，并且拥有root权限或sudo权限。
• 基本的Linux命令行操作知识（会cd、ls、make即可）。

本教程基于官方提供的librga库和示例代码，所有操作都在开发板的终端中执行。

2. 获取RGA示例代码

Rockchip在GitHub上开源了librga及其示例，我们直接克隆仓库到本地：

git clone https://github.com/rockchip-linux/linux-rga.gitcd linux-rga

如果你没有安装git，请先执行 sudo apt install git。

3. 编译示例程序

进入示例目录，直接使用make编译：

cd samplesmake

编译过程中会提示需要librga的头文件和库文件，这些通常已经包含在内核驱动中或可以通过包管理器安装。如果遇到错误，请确保你的内核版本支持RGA驱动（RK3588主线内核默认支持）。

4. 运行测试

编译完成后，会生成多个可执行文件，例如 rgaImDemo。我们运行最简单的缩放示例：

./rgaImDemo

如果一切正常，你会看到类似“rga test success”的输出，并且可能生成一张处理后的图片。这表明RGA硬件加速已经成功启用！

5. 进阶体验：自定义图像处理

你可以修改示例代码中的参数，体验RGA的强大功能。例如在 rgaImDemo.c 中调整缩放比例、旋转角度等。RGA支持硬件级别的图像缩放、旋转、裁剪、格式转换（如NV12、RGB888等），是嵌入式图形处理的利器。

例如，将一张1920x1080的图片缩放到1280x720，仅需几行代码即可完成，且性能远高于CPU软解。

6. 常见问题

• Q: 运行示例时提示“cannot open shared object file”？ A: 可能是librga库未安装，尝试 sudo apt install librga-dev 或从源码编译安装librga。
• Q: 如何确认RGA驱动已加载？ A: 执行 ls /dev/rga，如果存在该设备文件，则驱动正常。
• Q: 示例运行没有报错但也没有输出图片？ A: 检查当前目录是否有输入图片，示例可能默认需要指定图片路径，可查看源码修改。

7. 总结

通过以上几步，你已经成功在RK3588 Linux系统上运行了RGA硬件加速示例。RK3588强大的RGA单元能够极大提升2D图形处理效率，适用于视频处理、图像识别、UI渲染等场景。希望这篇教程能帮助你快速上手，开启RK3588的硬件加速之旅！

本文介绍了RK3588平台上的Linux RGA使用方法，关键词包括RK3588、Linux RGA、硬件加速、图形处理，希望对大家有所帮助。