This is a VDPAU backend driver for the NVIDIA Tegra SoC's.
Mandatory:
- autotools
- libvdpau (https://www.freedesktop.org/wiki/Software/VDPAU/)
- pixman (http://www.pixman.org)
- libX11 libXext xextproto libXfixes libXv
- opentegra (https://github.com/grate-driver/xf86-video-opentegra)
Optional:
- mesa (https://github.com/grate-driver/mesa)
- Linux kernel 4.16+ (https://www.kernel.org/), enable "staging/media" drivers and select "NVIDIA Tegra Video Decoder Engine driver" in the kernel config
The VDE linux kernel driver is optional, it is required for HW accelerated video decoding. Currently VDE driver supports CAVLC H.264 videos only. The accelerated video output works without the VDE driver.
Usage of the most recent mainline upstream Linux kernel is very recommended, not all DRM fixes are backportable and some usability-critical features may be missed in older kernels.
sudo add-apt-repository ppa:grate-driver/ppa
sudo apt-get update
sudo apt-get install libvdpau-tegra
sudo layman -f -o https://raw.githubusercontent.com/grate-driver/grate-overlay/master/overlay.xml -a grate-overlay
sudo emerge libvdpau-tegra-driver
There is PKGBUILD in https://aur.archlinux.org/packages/libvdpau-tegra-git/.
sudo dnf copr enable kwizart/grate-driver
sudo dnf update
sudo dnf install xorg-x11-drv-opentegra libvdpau-tegra grate
git clone https://github.com/grate-driver/libvdpau-tegra.git
cd libvdpau-tegra
sh autogen.sh --prefix=/
make
sudo make install
If you are going to use the VDE for accelerated video decoding, first make sure that your user account has access to the VDE device. Giving access to everyone should be fine, driver uses dmabuf and performs all necessary validations, however it will be better if you change the device owner to your user or add it to the groups (video for example) relevant for your account.
$ ls -l /dev/tegra_vde
crw------- 1 root root 10, 61 Jun 21 05:37 /dev/tegra_vde
$ sudo chmod 0666 /dev/tegra_vde
$ ls -l /dev/tegra_vde
crw-rw-rw- 1 root root 10, 61 Jun 21 05:37 /dev/tegra_vde
For a usage example we use mpv (https://mpv.io/). Other players that support VDPAU are also (kinda) working, but mpv is known to work fine and is recommended.
$ VDPAU_DRIVER=tegra VDPAU_DRIVER_PATH=/path/to/libvdpau_tegra.so mpv --hwdec=vdpau --vo=vdpau video.mp4
The VDPAU_DRIVER
and VDPAU_DRIVER_PATH
environment variables aren't required if mesa (https://github.com/grate-driver/mesa) is installed.
You should see the following lines in the terminal:
Using hardware decoding (vdpau).
VO: [vdpau] 1280x720 vdpau[yuv420p]
If you don't see anything related to VDPAU, it means that it doesn't work for some reason. Check that /usr/lib/vdpau/libvdpau_tegra.so.1
exists, note that VDPAU_DRIVER_PATH
must point to the directory containing the shared library, not the library file.
Debug messages could be enabled using these environment variables: VDPAU_TRACE=1
VDPAU_TEGRA_DEBUG=1
.
VDPAU_TEGRA_FORCE_XV=1
force display output to Xv overlayVDPAU_TEGRA_FORCE_DRI=1
force display output using DRIVDPAU_TEGRA_DRI_XV_AUTOSWITCH=1
force-enable Xv<=>DRI output autoswitching (which is disabled if compositor or display rotation detected)
Accelerated output to overlay- Offload
color conversion, blittingand blending to HW - H.264 CABAC support (reverse-engineering pending)
- Support other codecs, like VC-1 or H.263