Overview

It's the name of a software project, which is a fully 100% libre and open source driver for using the hardware accelerated video de-/encoding engine found in sunxi devices. It replaces the proprietary library that has a long history of license ambiguity issues and in certain cases even (L)GPL violations.

Development / Mainline Kernel

Interested people are welcome to join the development channel #cedrus on Freenode IRC.

The main repository for the mainlining effort of the V4L2 driver is currently located at linux-cedrus-v4l2, the out-of-tree V4L2 driver is at sunxi-cedrus.

Crowdfunding

On February 2, 2018 Bootlin (formerly Free Electrons) started a crowdfunding campaign in order to bring sunxi-cedrus into the linux mainline kernel. The main goal (MPEG2 and H264 decoding on A10, A13, A20, A33, R8 and R16) and the first stretch goal (implement H3, H5 and A64) has reached already. Delivery date of the main goal is expected to be by end of June 2018, stretch goals are expected to be delivered by end of December 2018.

Outstanding stretch goals are:

H265 decoding support

H264 encoding support

Current status

The hardware is already well understood by the means of the reverse-engineering effort, which very quick got successful results. A large majority of the hardware registers are documented. With this information some Proof of Concept (PoC) example source code was written to verify that the hardware can be configured correctly from the information obtained.
To forward verifying, there was implemented a vdpau driver backend which is quite usable and can be used by any media player that uses the vdpau framework.

The Cedrus project aims for a proper driver and software that can be mainlined and upstreamed to the proper places, this can't happen with the vendor kernel driver in its limitations, source code quality or transbording as a security risk.

Steps for this proper driver and software can be seen in its planning phase.

Supported codec matrix

In this colorful table is represented what is understood and supported by hardware in the left side, the designation VE+Number are the video engine hardware version and above are the SoCs were found. Here are only SoCs and hardware versions which was confirmed or reported, the ones that aren't here should and are expected to be very equal in mode.

The right side represents the state of software. Take notice about the PoC (Proof of Concept) in which only exists for demonstration the correct understanding about the working of the hardware, sometimes the creation of this PoC is skipped.

As can be seen in this table with the color of green, the most used video codecs are already fully reversed engineered. The codecs that are still missing are too old or/and obsolete and aren't used anymore for the creation of new video content. The content (video files) that exists encoded in this codecs is in the great majority not beyond standard definition, meaning that the task of decoding is easy done with just software decode by cpu.
For this reason this codecs aren't a priority to work on.

If anyone has a need for a yet to be support codec, please contact the people involved in the cedrus project to find what can be arranged.