Entwicklerhandbuch zur Rockchip Rockit Runtime

Grundlage sind die bereitgestellten chinesischen und englischen Rockchip-Dokumente V2.28.0 vom 2025-04-27; die technischen Kapitel 3-13 bleiben erhalten. Im Englischen fehlende Angaben wurden aus dem chinesischen Text ergänzt; Abweichungen sind gekennzeichnet. Diese ArmSoM-Plattformreferenz erfordert die Prüfung von konkreter Platine, SoC, SDK/BSP, Kernel und Peripherie. Sie belegt keine Unterstützung aller ArmSoM-Platinen. Es wurden keine Befehle oder Hardwaretests ausgeführt.

3. Architektur

Zur einfacheren Portierung von Rockit wurde eine neue Laufzeitbibliothek im Kernel entwickelt, im Folgenden RRT. Ihre Architektur ist unten dargestellt.

.
├── isp.ko   ---- isp - Modul, Knoten /dev/mpi/rkisp-vir0
├── valloc.ko  --- Puffermanager, Knoten /dev/mpi/valloc
├── venc.ko    --- Encoder - Modul, Knoten /dev/mpi/venc
├── vmpi.ko    --- Medienframework, Knoten /dev/mpi/vmpi
├── vpss.ko    --- vpss - Modul, Knoten /dev/mpi/vpss
├── vrga.ko    --- rga - Modul, Knoten /dev/mpi/vrga
├── vrgn.ko    --- rgn - Modul, Knoten /dev/mpi/vrgn
├── vsys.ko    --- system - Modul, Knoten /dev/mpi/vsys
└── vvi.ko     --- vi - Modul, Knoten /dev/mpi/vvi

Vor der Verwendung der rockit-Schnittstellen müssen die aufgeführten ko-Module geladen werden. Alle diese Module wurden zu einem einzigen ko zusammengefasst, das mit folgendem Befehl geladen wird:

insmod rockit.ko

Prüfen Sie das erfolgreiche Laden mit folgendem Befehl:

# 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

Nach erfolgreichem Laden können Programme ausgeführt werden, die von rockit.so abhängen.

3.1 Vom KO unterstützte Parameter

3.1.1 mcu_fw_path

Pfad zur MCU-Firmware für den Wrapping-Modus. Standardmäßig leer; die MCU-Firmware wird nicht geladen.

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

3.1.2 mcu_fw_addr

Adresse der MCU-Firmware für den Wrapping-Modus. Standard: 0xff6ff000 für RV1106 und 0x210f6000 für RV1103B.

insmod rockit.ko mcu_fw_addr=0xff6ff000

3.1.3 isp_max_h

Höhe des Eingangs vor dem ISP. Bei VICAP-Zuschnitt verlangt die Quelle die „Breite nach dem Zuschnitt“. Dies widerspricht der Definition als Höhe und muss anhand des SDK geprüft werden. Bei falscher Einstellung zeigt cat /dev/mpi/vlog den richtigen Wert. Diagnosezeile:

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

Reserviert.

3.1.5 en_mcu

Aktivierung des MCU-Treibers. Standardmäßig bei RV1106 aktiviert und bei RV1103B deaktiviert. Bei Deaktivierung wird der MCU-Treiber nicht geladen.

insmod rockit.ko en_mcu=0

3.1.6 rk_dma_heap_base

Die Startadresse des durch RK_MPI_SYS_RelasePhyMemory freizugebenden MMZ muss an 4K ausgerichtet sein und oberhalb des MMZ-Anfangs liegen. MMZ-Anfang = gesamter physischer Speicher - MMZ-Größe.

insmod rockit.ko rk_dma_heap_base=0x40000

3.1.7 rk_dma_heap_size

Die durch RK_MPI_SYS_RelasePhyMemory freizugebende MMZ-Größe darf die MMZ-Größe nicht überschreiten.

insmod rockit.ko rk_dma_heap_size=0x40000

4. Plattformübergreifende Portierung

RRT wurde um die Betriebssystem-Abstraktionsschicht OSAL ergänzt und darauf umgestellt. Sie läuft im Linux-Kernelmodus, im Linux-Benutzermodus und unter RTOS. Auf RV1103B/RV1126B gibt es zwei RRT-Instanzen: eine im Benutzer- und eine im Kernelmodus. Zum Anzeigen der /dev/mpi/xxx-Knoten im Linux-Benutzermodus und unter RTOS wird dumpsys vor den ursprünglichen Befehl gesetzt:

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

5. Plattformübergreifende Kommunikation

Auf einem SoC können mehrere RRT-Instanzen laufen. Zur Vereinfachung der Zusammenarbeit zwischen Modulentwicklern unterstützt RRT plattformübergreifende Kommunikation: VALLOC verwaltet die plattformübergreifenden BUFFER-Referenzzähler, VSYS übernimmt Verbindungen und BUFFER-Übertragung. Voraussetzung ist, dass die RRT-Instanzen BUFFER über physischen Speicher gemeinsam nutzen können. Die Tabelle zeigt die unterstützten RRT-Instanzen und ihre Module je SoC.

6. VALLOC

VALLOC weist Speicher für das Medienframework zu und verwaltet ihn. Der aktuelle Speicherzustand lässt sich wie folgt anzeigen:

cat /dev/mpi/valloc

Feldbeschreibung:

7. VLOG

Protokollmanager des Medienframeworks.

7.1 Kernelprotokoll anzeigen

cat /dev/mpi/vlog

7.2 Protokollstufe eines Moduls einstellen

Der Befehl echo module=level > /tmp/rt_log_level ändert die Protokollstufe des Moduls gleichzeitig für rockit so und ko. Zulässige module: all cmpi mb sys vdec venc rgn vpss vgs tde avs wbc vo vi ai ao aenc adec. Stufen: 0,1,2,3,4,5,6; 2 - ERR (rot), 3 - WRN (gelb), 4 - INF (grün).

echo module=level > /tmp/rt_log_level

7.3 Ausgabepfad und Größe des SO-Protokolls

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

echo rt_log_size=1024000 > /tmp/rt_log_level

7.4 Protokoll löschen

echo 0 > /dev/mpi/vlog

8. VSYS

VSYS verwaltet die Verbindungen der Medienmodule. Aktuelle Verbindungen und Framerateninformationen zeigt folgender Befehl:

cat /dev/mpi/vsys

9. VENC

Die Kodierparameter können mit folgendem Befehl abgerufen werden:

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. Zuordnung zwischen venc_info und rockit-API

venc_info enthält die vom Kernel ausgegebenen Encoder-Konfigurationsparameter. Unterstützt werden nur RV1103B/RV1106B und RV1103/RV1106. Dieses Kapitel ordnet die wesentlichen Einstellungen für die subjektive Bildwirkung und die objektive Kompression.

11. IVS

Die Parameter der intelligenten Videoüberwachung können mit folgendem Befehl abgerufen werden:

cat /proc/vcodec/ivs/ivs_info

ivs channel attr

ivs common cfg

ivs md cfg

ivs od cfg

12. VRGN

VRGN verwaltet RGN im Medienframework. Aktuelle RGN-Informationen zeigt folgender Befehl:

cat /dev/mpi/vrgn

13. VRGA

VRGA verwaltet den RGA-Treiber in Rockit. Den aktuellen Zustand der RGA-NODE zeigt folgender Befehl:

cat /dev/mpi/vrga

Quellenabweichungen und Prüfhinweise

• Beide Quellen nennen V2.28.0 und 2025-04-27. Chinesisch enthält zusätzlich memtype und nkid; beide Felder stehen in allen Sprachfassungen. Die Seitenzahl allein belegt keine Aktualität.
• VSYS table: Chinesisch nennt die Framerate als Größe, n behält n Frames und 0 verwirft Frames; Englisch sagt 0 behalten und 1 verwerfen. Der Haupttext folgt der chinesischen Fassung; dieser Widerspruch muss am SDK geprüft werden.
• isp_max_h ist als Eingangshöhe definiert, beide Quellen nennen aber die „Breite nach dem Zuschnitt“. SDK-Implementierung und originale Diagnose prüfen; die Dimension wurde nicht stillschweigend geändert.
• Die RV1126B-Kernelmodulliste enthält VALLC; auch cenalbe, SCALL und RK_MPI_SYS_RelasePhyMemory bleiben unverändert. Chinesisch verwendet last_runing, runing, heigth, Englisch last_running, running, height; beide Schreibweisen sind am jeweiligen Feld angegeben.
• Beide API-Tabellen ordnen qp_dlt_row_i dem Member u32RowQpDelta und qp_dlt_row dem Member u32RowIQpDelta zu. Ein möglicher Widerspruch zur I/P-Bedeutung wurde nicht durch Vertauschen beseitigt.
• Chinesisch unterscheidet mpp_packet pool und mpp_buffer pool; Englisch nennt beide Tabellen mpp_buffer pool. Hier gelten die chinesischen Überschriften; alle drei Tabellen für packet, buffer und frame bleiben erhalten.
• Englisch ergänzt bei VRGN h x y „insgesamt 8 Gruppen“; dies steht in allen Fassungen. Bei wcnt nennt Chinesisch eine Frameanzahl, Englisch eine Framerate; die Frameanzahl gilt als Grundlage. Bei min_size gilt chinesisch „minimaler freier Speicher für einen Frame“ statt englisch „zuletzt“.
• Englisch Warp wird gemäß Chinesisch als Wrapping verstanden; Bezeichner bleiben erhalten. Die chinesischen Details zu ROI-Makroblöcken, Mittelwertkompensation bei SAD, sehr niedriger Bitrate statischer Szenen, Nachzieheffekten und Rauschzittern/-kriechen wurden übernommen.