Руководство по библиотеке Rockchip Rockit Runtime

Основа - предоставленные китайский и английский документы Rockchip V2.28.0 от 2025-04-27; сохранены технические главы 3-13. По китайскому тексту добавлены сведения, отсутствующие в английском; расхождения отмечены. Это справочный материал для платформ ArmSoM: проверьте конкретную плату, SoC, SDK/BSP, ядро и периферию. Поддержка всех плат ArmSoM не заявляется. Команды и аппаратные испытания не выполнялись.

3. Архитектура

Для упрощения переноса Rockit в ядре разработана новая библиотека времени выполнения, далее RRT. Её структура показана ниже.

.
├── isp.ko   ---- isp - модуль, узел /dev/mpi/rkisp-vir0
├── valloc.ko  --- менеджер буферов, узел /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    --- system - модуль, узел /dev/mpi/vsys
└── vvi.ko     --- vi - модуль, узел /dev/mpi/vvi

Перед использованием интерфейсов rockit необходимо загрузить перечисленные модули 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 для режима wrapping. По умолчанию пустой: прошивка MCU не загружается.

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

3.1.2 mcu_fw_addr

Адрес прошивки MCU для wrapping. По умолчанию 0xff6ff000 для RV1106 и 0x210f6000 для RV1103B.

insmod rockit.ko mcu_fw_addr=0xff6ff000

3.1.3 isp_max_h

Высота входа перед ISP. Если VICAP выполняет обрезку, источник предписывает настроить «ширину после обрезки». Это противоречит определению высоты и требует проверки по SDK. При неверной настройке 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

Начальный адрес MMZ, освобождаемой через RK_MPI_SYS_RelasePhyMemory, должен быть выровнен по 4K и превышать начало MMZ. Начало MMZ = общий объём физической памяти - размер MMZ.

insmod rockit.ko rk_dma_heap_base=0x40000

3.1.7 rk_dma_heap_size

Размер MMZ, освобождаемой через RK_MPI_SYS_RelasePhyMemory, не должен превышать размер MMZ.

insmod rockit.ko rk_dma_heap_size=0x40000

4. Межплатформенный перенос

RRT дополнена уровнем абстракции ОС OSAL и переписана на его основе. Теперь она работает в ядре Linux, в пользовательском режиме Linux и в RTOS. На RV1103B/RV1126B работают два экземпляра RRT: один в пользовательском режиме и один в ядре. Для просмотра узлов /dev/mpi/xxx в пользовательском режиме Linux и в RTOS добавьте 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 и их модули.

6. VALLOC

VALLOC выделяет и управляет памятью медиасреды. Текущее состояние памяти выводится командой:

cat /dev/mpi/valloc

Описание полей:

7. VLOG

Менеджер журналов медиасреды.

7.1 Просмотр журнала ядра

cat /dev/mpi/vlog

7.2 Настройка уровня журналирования модуля

Команда echo module=level > /tmp/rt_log_level меняет уровень журналирования модуля одновременно для rockit so и ko. Допустимые module: all cmpi mb sys vdec venc rgn vpss vgs tde avs wbc vo vi ai ao aenc adec. Уровни: 0,1,2,3,4,5,6; 2 - ERR (красный), 3 - WRN (жёлтый), 4 - INF (зелёный).

echo module=level > /tmp/rt_log_level

7.3 Путь и размер журнала SO

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

echo rt_log_size=1024000 > /tmp/rt_log_level

7.4 Очистка журнала

echo 0 > /dev/mpi/vlog

8. VSYS

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 tunning 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 и API rockit

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

VRGN управляет RGN медиасреды. Текущая информация о RGN доступна следующей командой:

cat /dev/mpi/vrgn

13. VRGA

VRGA управляет драйвером RGA в Rockit. Для просмотра текущего состояния 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 китайский указывает число кадров, английский - частоту; принято число кадров. Для min_size принято китайское «минимальное свободное место для одного кадра», а не английское «последнее».
• Английское Warp трактуется по китайскому как wrapping; идентификаторы не меняются. Сохранены уточнения о макроблоках ROI, компенсации среднего при SAD, крайне низком битрейте статичной сцены, устранении шлейфов и дрожания/ползания шума.