Using the Video Decode/Encode Accelerator Unittests Manually

VDAtest (or video_decode_accelerator_unittest) and VEAtest (or video_encode_accelerator_unittest) are unit tests that embeds the Chrome video decoding/encoding stack without requiring the whole browser, meaning they can work in a headless environment. They includes a variety of tests to validate the decoding and encoding stacks with h264, vp8 and vp9.

Running these tests manually can be very useful when bringing up a new codec, or in order to make sure that new code does not break hardware decoding and/or encoding. This document is a walk though the prerequisites for running these programs, as well as their most common options.

Prerequisites

The required kernel drivers should be loaded, and there should exist a /dev/video-dec0 symbolic link pointing to the decoder device node (e.g. /dev/video-dec0 → /dev/video0). Similarly, a /dev/video-enc0 symbolic link should point to the encoder device node.

The unittests can be built by specifying the video_decode_accelerator_unittest and video_encode_accelerator_unittest targets to ninja. If you are building for an ARM board that is not yet supported by the simplechrome workflow, use arm-generic as the board. It should work across all ARM targets.

For unlisted Intel boards, any other Intel target (preferably with the same chipset) should be usable with libva. AMD targets can use amd64-generic.

Basic VDA usage

The media/test/data folder in Chromium's source tree contains files with encoded video data (test-25fps.h264, test-25fps.vp8 and test-25fps.vp9). Each of these files also has a .md5 counterpart, which contains the md5 checksums of valid thumbnails.

Test filtering options

The list of available tests can be retrieved using the --gtest_list_tests option.

By default, all tests are run, which can be a bit too much, especially when bringing up a new codec. The --gtest_filter option can be used to specify a pattern of test names to run. For instance, to only run the TestDecodeTimeMedian test, one can specify --gtest_filter="*TestDecodeTimeMedian*".

So the complete command line to test vp9 decoding with the TestDecodeTimeMedian test only (a good starting point for bringup) would be

Basic VEA usage

The VEA works in a similar fashion to the VDA, taking raw YUV files in I420 format as input and producing e.g. a H.264 Annex-B byte stream. Sample raw YUV files can be found at the following locations: