media: visl: add virtual stateless decoder driver
authorDaniel Almeida <daniel.almeida@collabora.com>
Sat, 5 Nov 2022 13:58:42 +0000 (10:58 -0300)
committerHans Verkuil <hverkuil-cisco@xs4all.nl>
Fri, 18 Nov 2022 14:48:16 +0000 (15:48 +0100)
commit04e27f7953b6ba6cefc52c9b981b6eeafefea103
tree40b411b545a0536bada01da48b2e6f12ca862c69
parent9d175a81e28f260916a0a13f457dd8b940eafb4e
media: visl: add virtual stateless decoder driver

A virtual stateless device for stateless uAPI development purposes.

This tool's objective is to help the development and testing of
userspace applications that use the V4L2 stateless API to decode media.

A userspace implementation can use visl to run a decoding loop even when
no hardware is available or when the kernel uAPI for the codec has not
been upstreamed yet. This can reveal bugs at an early stage.

This driver can also trace the contents of the V4L2 controls submitted
to it.  It can also dump the contents of the vb2 buffers through a
debugfs interface. This is in many ways similar to the tracing
infrastructure available for other popular encode/decode APIs out there
and can help develop a userspace application by using another (working)
one as a reference.

Note that no actual decoding of video frames is performed by visl. The
V4L2 test pattern generator is used to write various debug information
to the capture buffers instead.

Signed-off-by: Daniel Almeida <daniel.almeida@collabora.com>
Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl>
22 files changed:
Documentation/admin-guide/media/v4l-drivers.rst
Documentation/admin-guide/media/visl.rst [new file with mode: 0644]
MAINTAINERS
drivers/media/test-drivers/Kconfig
drivers/media/test-drivers/Makefile
drivers/media/test-drivers/visl/Kconfig [new file with mode: 0644]
drivers/media/test-drivers/visl/Makefile [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-core.c [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-debugfs.c [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-debugfs.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-dec.c [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-dec.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-trace-fwht.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-trace-h264.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-trace-hevc.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-trace-mpeg2.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-trace-points.c [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-trace-vp8.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-trace-vp9.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-video.c [new file with mode: 0644]
drivers/media/test-drivers/visl/visl-video.h [new file with mode: 0644]
drivers/media/test-drivers/visl/visl.h [new file with mode: 0644]