Rockchip MPP

Dockerized build system for Rockchip MPP with Gstreamer to provide accelerated video encoding & decoding.

Build Prerequisites

• Docker w/ buildx plugin
  • If docker buildx inspect works, you're all set!
• arm64 host
  • Cross-compilation from amd64 not currently supported

Quick Start

Run the pre-built Debian Bullseye image:

docker run -it --privileged docker.io/milas/rkmpp-debian:bullseye 

💡 The --privileged flag is required to allow access to the hardware encoder/decoder.

Individual groups and targets also exist if you don't want to build everything or want to use one of the experimental targets.

Debian - Bullseye (11)

Debian with the necessary Rockchip and Gstreamer libraries.

This version is chosen to most closely align with the Rockchip libraries for compatibility. I would recommend using multi-stage builds with this as the final stage.

You're also welcome to try --set='*.build-arg=OS_BASE=debian:bookworm' to build with Bookworm as the base image, for example. Ubuntu could be done the same way.

Build the image:

docker buildx bake rkmpp-debian --load

This step is optional. Pre-built images are available on Docker Hub.

Run the image:

docker run -it --privileged docker.io/milas/rkmpp-debian:bullseye 

librga aka RGA (Raster Graphic Acceleration Unit)

Upstream: https://github.com/JeffyCN/mirrors/tree/linux-rga-multi

docker buildx bake rkmpp-rga

out/rkmpp
└── rga
    └── usr
        └── local
            ├── include
            │   └── rga
            │       ├── drmrga.h
            │       ├── GrallocOps.h
            │       ├── im2d_buffer.h
            │       ├── im2d_common.h
            │       ├── im2d_expand.h
            │       ├── im2d.h
            │       ├── im2d.hpp
            │       ├── im2d_mpi.h
            │       ├── im2d_single.h
            │       ├── im2d_task.h
            │       ├── im2d_type.h
            │       ├── im2d_version.h
            │       ├── RgaApi.h
            │       ├── rga.h
            │       ├── RgaMutex.h
            │       ├── RgaSingleton.h
            │       ├── RgaUtils.h
            │       └── RockchipRga.h
            └── lib
                ├── librga.so -> librga.so.2
                ├── librga.so.2 -> librga.so.2.1.0
                ├── librga.so.2.1.0
                └── pkgconfig
                    └── librga.pc

mpp aka MPP (Media Process Platform)

Upstream: https://github.com/rockchip-linux/mpp/tree/develop

docker buildx bake rkmpp-mpp

out/rkmpp
└── mpp
    └── usr
        └── local
            ├── bin
            │   ├── mpi_dec_mt_test
            │   ├── mpi_dec_multi_test
            │   ├── mpi_dec_nt_test
            │   ├── mpi_dec_test
            │   ├── mpi_enc_mt_test
            │   ├── mpi_enc_test
            │   ├── mpi_rc2_test
            │   ├── mpp_info_test
            │   └── vpu_api_test
            ├── include
            │   └── rockchip
            │       ├── mpp_buffer.h
            │       ├── mpp_compat.h
            │       ├── mpp_err.h
            │       ├── mpp_frame.h
            │       ├── mpp_log_def.h
            │       ├── mpp_log.h
            │       ├── mpp_meta.h
            │       ├── mpp_packet.h
            │       ├── mpp_rc_api.h
            │       ├── mpp_rc_defs.h
            │       ├── mpp_task.h
            │       ├── rk_hdr_meta_com.h
            │       ├── rk_mpi_cmd.h
            │       ├── rk_mpi.h
            │       ├── rk_type.h
            │       ├── rk_vdec_cfg.h
            │       ├── rk_vdec_cmd.h
            │       ├── rk_venc_cfg.h
            │       ├── rk_venc_cmd.h
            │       ├── rk_venc_rc.h
            │       ├── rk_venc_ref.h
            │       ├── vpu_api.h
            │       └── vpu.h
            └── lib
                ├── librockchip_mpp.so -> librockchip_mpp.so.1
                ├── librockchip_mpp.so.0
                ├── librockchip_mpp.so.1 -> librockchip_mpp.so.0
                ├── librockchip_vpu.so -> librockchip_vpu.so.1
                ├── librockchip_vpu.so.0
                ├── librockchip_vpu.so.1 -> librockchip_vpu.so.0
                └── pkgconfig
                    ├── rockchip_mpp.pc
                    └── rockchip_vpu.pc

gstreamer-rockhip aka Gstreamer Plugin

Upstream: https://github.com/JeffyCN/mirrors/tree/gstreamer-rockchip

docker buildx bake rkmpp-gstreamer-plugin

out/rkmpp
└── gstreamer
    └── usr
        └── local
            └── lib
                └── gstreamer-1.0
                    ├── libgstkmssrc.so
                    ├── libgstrkximage.so
                    └── libgstrockchipmpp.so