Rockchip Rockit Runtime 运行库开发指南

本文以所提供的 Rockchip 中英文 V2.28.0（2025-04-27）文档为依据，保留第 3-13 章技术内容，按中文技术内容补足英文遗漏，并注明差异。作为 ArmSoM 平台参考，使用前须逐项核对实际开发板、SoC、SDK/BSP、内核与外设；不代表所有 ArmSoM 板卡均支持。本页未执行命令或进行硬件验证。

3. 框架

为了更好的移植rockit, 在内核中新开发一套runtime library, 下文简称RRT, 内核中的RRT框图如下:

.
├── isp.ko   ---- isp模块，对应/dev/mpi/rkisp-vir0节点
├── valloc.ko  --- buffer管理器，对应/dev/mpi/valloc节点
├── venc.ko    --- 编码器模块，对应/dev/mpi/venc
├── vmpi.ko    --- 媒体框架， 对应 /dev/mpi/vmpi
├── vpss.ko    --- vpss模块，对应 /dev/mpi/vpss
├── vrga.ko    --- rga模块，对应 /dev/mpi/vrga
├── vrgn.ko    --- rgn模块，对应 /dev/mpi/vrgn
├── vsys.ko    --- 系统模块，对应 /dev/mpi/vsys
└── vvi.ko     --- vi模块， 对应 /dev/mpi/vvi

在使用rockit 接口之前,需要加载上述ko,加载方式如下(注:上述所有ko, 已合并成一个ko):

insmod rockit.ko

使用以下命令检查是否加载成功:

# lsmod
Module                  Size  Used by    Tainted: G
rknpu                  21535  1
rockit                 90530 14
mpp_vcodec            350020  4 rockit
rga3                   76968  3 rockit
sc4336                  8940  2
phy_rockchip_csi2_dphy     7657  0
phy_rockchip_csi2_dphy_hw     7644  0
video_rkisp           138585  3 rockit,[permanent]
video_rkcif           107889  4
rk_dvbm                 5813  2 mpp_vcodec,video_rkisp

加载成功后,即可运行依赖rockit.so相关程序。

3.1 KO支持的参数

3.1.1 mcu_fw_path

MCU卷绕固件路径,默认空,不加载mcu固件:

insmod rockit.ko mcu_fw_path=/oem/usr/ko/hpmcu_wrap.bin

3.1.2 mcu_fw_addr

MCU 卷绕固件的地址,默认为0xff6ff000(RV1106), 0X210f6000(RV1103B):

insmod rockit.ko mcu_fw_addr=0xff6ff000

3.1.3 isp_max_h

isp 前级输入的高度,如果VICAP配置裁剪功能,应配置裁剪后的宽度,如果次参数配置错误,cat /dev/mpi/vlog 会有提示正确的值。

mpi_log_err("isp input height config err, config h= %d, real h = %d", isp_max_h, isp_h);

insmod rockit.ko isp_max_h=1920

3.1.4 isp_max_w

保留。

3.1.5 en_mcu

是否使能MCU驱动,默认开启(RV1106)/关闭(RV1103B),关闭后不加载MCU驱动:

insmod rockit.ko en_mcu=0

3.1.6 rk_dma_heap_base

RK_MPI_SYS_RelasePhyMemory释放的MMZ的首地址, 需要4K对⻬, 并且大于MMZ的起始地址,MMZ起始地址计算方式: 总物理内存 - MMZ大小

insmod rockit.ko rk_dma_heap_base=0x40000

3.1.7 rk_dma_heap_size

RK_MPI_SYS_RelasePhyMemory释放的MMZ的大小,需要小于等于MMZ的大小。

insmod rockit.ko rk_dma_heap_size=0x40000

4. 跨平台移植

RRT新增OSAL,并基于OSAL改写,不仅可以运行在Linux内核态,也可运行在Linux用戶态,RTOS上,目前RV1103B/RV1126B中存在2个RRT,一个运行在用戶态,另一个运行在内核态。LINUX用戶态和RTOS上查看 /dev/mpi/xxx 相关节点需要在原有的命令前加上dumpsys。

dumpsys cat /dev/mpi/valloc
dumpsys cat /dev/mpi/vsys
dumpsys cat /dev/mpi/vlog
dumpsys cat /dev/mpi/vrgn

5. 跨平台通信

在一个SOC上可能运行多个RRT,为了减少模块开发者的沟通成本, RRT实现了跨平台互通,即通过 VALLOC模块实现跨平台BUFFER引用计数的管理,通过VSYS模块实现跨平台绑定和 BUFFER的传递,因此跨平台通信有一个前提条件: 各平台的RRT可以通过物理内存共享BUFFER。下表为各SOC支持的RRT,以及每个RRT包含的模块。

6. VALLOC

媒体框架的内存分配器,负责分配,管理媒体框架所需要的内存,使用以下命令可以查看当前内存状态。

cat /dev/mpi/valloc

7. VLOG

媒体框架的LOG管理器。

7.1 查看内核LOG

cat /dev/mpi/vlog

7.2 设置模块LOG输出等级的方式

命令同时修改 rockit so 和 ko 的模块日志级别。module 可选 all cmpi mb sys vdec venc rgn vpss vgs tde avs wbc vo vi ai ao aenc adec。level 可选 0,1,2,3,4,5,6；2 为 ERR（红色），3 为 WRN（黄色），4 为 INF（绿色）。

echo module=level > /tmp/rt_log_level

7.3 设置 SO LOG输出路径和大小

echo rt_log_path=/tmp/rockit.log > /tmp/rt_log_level

echo rt_log_size=1024000 > /tmp/rt_log_level

7.4 清除LOG

echo 0 > /dev/mpi/vlog

8. VSYS

媒体绑定关系管理器,可以通过如下命令查看当前绑定关系和帧率相关信息:

cat /dev/mpi/vsys

9. VENC

编码参数,可以通过以下命令:

cat /proc/vcodec/enc/venc_info

venc thread status

venc chn running status

venc chn attr 1

venc chn attr 2

ring buf status

hw status

hw param

fine tuning param

venc roi attr

hw session infos

bitstream buffer addr

h264e chn attr

Syntax INFO1

Syntax INFO2

h265e chn attr

Syntax INFO1

Syntax INFO2

Trans Info

jpege chn attr

RC base param1

RC base param2

RC run comm param1

RC run comm param2

RC gop mode attr

RC run vbr common param

RC run cbr param

RC run avbr param

RC HierarchicalQp INFO

RC debreath_effect info

RC run CBR/VBR info1

mpp_packet pool

mpp_buffer pool

mpp_frame pool

10. venc_info 和 rockit api 映射关系

venc_info 是内核打印的编码器配置参数,目前只有RV1103B/RV1106B、RV1103/RV1106支持。本章节主要对重点配置进行梳理,侧重主观效果、客观压缩率相关配置。

11. IVS

智能视频监控参数,可以通过以下命令:

cat /proc/vcodec/ivs/ivs_info

ivs channel attr

ivs common cfg

ivs md cfg

ivs od cfg

12. VRGN

媒体框架的RGN管理器,使用以下命令可以查看当前RGN的相关信息:

cat /dev/mpi/vrgn

13. VRGA

rockit 种的RGA驱动管理器,使用以下命令可以查看当前RGA NODE状态

cat /dev/mpi/vrga

原稿差异与核对事项

• 两种原稿均标 V2.28.0、2025-04-27；中文多出 memtype、nkid，已纳入四语正文，不能仅由页数判断内容新旧。
• VSYS 的 table：中文为“大小为帧率，n 表示留 n 帧，0 表示丢”；英文为“大小为帧率，0 保留、1 丢弃”。正文采用中文基线并保留此冲突，实际行为须核对 SDK。
• isp_max_h 定义为输入高度，裁剪说明却写“宽度”；两份文档都如此。应以 SDK 实现和原稿诊断提示核对，不静默改为高度。
• RV1126B 内核模块列表原样写 VALLC；cenalbe、SCALL、RK_MPI_SYS_RelasePhyMemory 也保留原稿拼写。中文 last_runing、runing、heigth 在英文分别为 last_running、running、height，这些差异已在对应字段注明。
• 两份 API 映射表均把 qp_dlt_row_i 对应到 u32RowQpDelta、qp_dlt_row 对应到 u32RowIQpDelta；与名称所暗示的 I/P 含义可能不一致，未擅自交换。
• 中文为 mpp_packet pool 与 mpp_buffer pool 两张表；英文连续两表都写 mpp_buffer pool。本页采用中文标题，并完整保留 packet、buffer、frame 三张表。
• 英文 VRGN 的 h x y 额外说明“共 8 组”，已补入中文。英文 wcnt 写 frame rate，中文为实际帧数；以中文为基线。min_size 中文为单帧分配所需最小空闲空间，英文写 latest；采用中文含义并记录差异。
• 编码器描述中的英文 Warp 按中文“卷绕”理解为 wrapping；标识不改。中文还明确 ROI 的 QP 和 intra 针对宏块、SAD 是均值补偿前后的比较、静态场景极低码率使能、去拖尾及噪声抖动/蠕动，均同步到其他语言。