tsukumijima/librga-rockchip

Userspace interface to Rockchip RGA 2D accelerator (Source available, Mirror of https://github.com/JeffyCN/mirrors/tree/linux-rga-multi)

librga

RGA (Raster Graphic Acceleration Unit)是一个独立的2D硬件加速器，可用于加速点/线绘制，执行图像缩放、旋转、bitBlt、alpha混合等常见的2D图形操作。本仓库代码实现了RGA用户空间驱动，并提供了一系列2D图形操作API。

版本说明

RGA API 版本: 1.10.0

适用芯片平台

Rockchip RK3066 | RK3188 | RK2926 | RK2928 | RK3026 | RK3028 | RK3128 | Sofia3gr | RK3288 | RK3288w | RK3190 | RK1108 | RK3368 | RK3326 | RK3228 | RK3228H | RK3326 | RK1808 | RV1126 | RV1109 | RK3399 | RK3399pro | RK3566 | RK3568 | RK3588 | RK3326S | RV1106 | RV1103 | RK3528 | RK3562

目录说明

├── im2d_api：RGA API相关实现及头文件
├── include：RGA硬件相关头文件
├── core：RGA用户空间驱动实现
├── docs：FAQ以及API说明文档
├── samples：示例代码
├── toolchains：示例工具链配置文件
└──其余编译相关文件

编译说明

Android Source Project

​ 下载librga仓库拷贝至android源码工程 hardware/rockchip目录，配置好编译环境后，执行mm进行编译，根据不同的Android版本将自动选择Android.mk或Android.bp作为编译脚本。

$ mm -j16

CMAKE

​ 本仓库示例代码支持CMAKE编译，可以通过修改toolchain_*.cmake文件以及编译脚本实现快速编译。

工具链修改

• Android NDK（build for android）

​ 参考librga源码目录下toolchains/toolchain_android_ndk.cmake写法，修改NDK路径、Android版本信息等。

工具链选项	描述
CMAKE_ANDROID_NDK	NDK编译包路径
CMAKE_SYSTEM_NAME	平台名，默认为Android
CMAKE_SYSTEM_VERSION	Android版本
CMAKE_ANDROID_ARCH_ABI	处理器版本
CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION	工具链选择（clang/gcc）
CMAKE_ANDROID_STL_TYPE	NDK C++库的链接方式（c++_static/c++_shared）

• Linux（buildroot/debian）

​ 参考librga源码目录下toolchains/toolchain_linux.cmake写法，修改工具链路径、名称。

工具链选项	描述
TOOLCHAIN_HOME	工具链目录
TOOLCHAIN_NAME	工具链名称

编译脚本修改

​ 修改samples目录或需要编译的示例代码目录下cmake_*.sh，指定toolchain路径。

编译选项	描述
TOOLCHAIN_PATH	toolchain的绝对路径，即《工具链修改》小节中修改后的toolchain_*.cmake文件的绝对路径
LIBRGA_PATH	需要链接的librga.so的绝对路径，默认为librga cmake编译时的默认打包路径
BUILD_DIR	编译生成文件存放的相对路径

执行编译脚本

• Android NDK（build for android）

$ chmod +x ./cmake_android.sh
$ ./cmake_android.sh

• Linux（buildroot/debian）

$ chmod +x ./cmake_linux.sh
$ ./cmake_linux.sh

Meson

​ 本仓库提供了meson.build，buildroot/debian支持meson编译。单独编译可以使用meson.sh 脚本进行config，需要自行修改meson.sh 内指定install 路径，以及PATH等环境变量，cross目录下是交叉编译工具配置文件，也需要自行修改为对应交叉编译工具路径。

​ 执行以下操作完成编译:

$ ./meson.sh

使用说明

• 头文件引用

  • C++调用im2d api

    im2d_api/im2d.hpp

  • C调用im2d api

    im2d_api/im2d.h

• 库文件

  librga.so

  librga.a

• librga应用开发接口说明文档

  IM2D API说明文档【中文】

  IM2D API说明文档【英文】

• RGA模块FAQ文档

  RGA_FAQ【中文】

  RGA_FAQ【英文】

librga-rockchip's Issues

Failed to call RockChipRga interface

当频繁调用RGA时, 会偶尔出现以下报错, 但是再调用时又会正常, 这是代码bug吗? 如何解决这个问题呢?

使用improcess, 从源buf的指定sx,sy,sw,sh复制一个区域到目标buf指定dx,dy,dw,dh,其中sw=dw,sh=dh,图像显示错位问题？

基于Linux Kernel version 5.10.110
libRga版本：v1.9.3
Rga驱动版本：v1.2.22

问题：使用improcess, 从源buf的指定sx,sy,sw,sh复制一个区域到目标buf指定dx,dy,dw,dh,其中sw=dw,sh=dh,图像显示错位，不知是对improcess的理解不正确，还是这是一个BUG，向各位讨教。

librga源码中没有这样使用的例子，是我参考imtranslate源码实现，imtranslate与我代码不同点仅是imtranslate中sx,sy为0。

代码如下：

void drm_2da_cp_rect(uint8_t * dst, uint8_t * src, int bw, int bh, int sx,int sy, int sw, int sh, int dx,int dy) {
int usage = 0;
int ret = 0;
rga_buffer_t pat;

    im_rect srect;
    im_rect drect;
    im_rect prect;

rga_buffer_t     rga_src;
rga_buffer_t     rga_dst;

static im_handle_param_t param;

param.width = bw;
param.height = bh;
param.format = RK_FORMAT_RGBA_8888;

    rga_buffer_handle_t src_handle = importbuffer_virtualaddr(src, &param);
if (src_handle <= 0) {
	printf("Failed to import virtualaddr for src channel!\n");
	return;
}

rga_buffer_handle_t dst_handle = importbuffer_virtualaddr(dst, &param);
if (dst_handle <= 0) {
		printf("Failed to import virtualaddr for dst channel!\n");
	return;
}

rga_src = wrapbuffer_handle(src_handle, bw, bh, RK_FORMAT_RGBA_8888,bw,bh);
rga_dst = wrapbuffer_handle(dst_handle, bw, bh, RK_FORMAT_RGBA_8888,bw,bh);

empty_structure(NULL, NULL, &pat, &srect, &drect, &prect);

    if ((rga_src.width != rga_dst.width) || (rga_src.height != rga_dst.height))
       return;

srect.x = sx;
srect.y = sy;
srect.width = sw;
srect.height = sh;

drect.x = dx;
drect.y = dy;
drect.width = sw;
drect.height = sh;

ret = imcheck(rga_src, rga_dst, srect, drect);
if (ret != IM_STATUS_NOERROR) {
	printf("%d, check error! %s \n", __LINE__, imStrError((IM_STATUS)ret));
} else {
	usage |= IM_SYNC;
	printf("src buff: %d-%d    dst Buff: %d-%d \n", rga_src.wstride,rga_src.hstride,rga_dst.wstride,rga_dst.hstride);
	printf("sx:%d  sy:%d  sw:%d  sh:%d  dx:%d  dy:%d  dw:%d  dh:%d \n",srect.x,srect.y,srect.width,srect.height,drect.x,drect.y,drect.width,drect.height);
	ret = improcess(rga_src, rga_dst, pat, srect, drect, prect, usage);
	if (ret != IM_STATUS_SUCCESS) 
		printf("%d, rga copy error! %s \n", __LINE__, imStrError((IM_STATUS)ret));
}
releasebuffer_handle(src_handle);
    releasebuffer_handle(dst_handle);

}