34 lines
1.5 KiB
ReStructuredText
34 lines
1.5 KiB
ReStructuredText
|
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
|
||
|
|
|
||
|
|
.. _media-controller-intro:
|
||
|
|
|
||
|
|
Introduction
|
||
|
|
============
|
||
|
|
|
||
|
|
Media devices increasingly handle multiple related functions. Many USB
|
||
|
|
cameras include microphones, video capture hardware can also output
|
||
|
|
video, or SoC camera interfaces also perform memory-to-memory operations
|
||
|
|
similar to video codecs.
|
||
|
|
|
||
|
|
Independent functions, even when implemented in the same hardware, can
|
||
|
|
be modelled as separate devices. A USB camera with a microphone will be
|
||
|
|
presented to userspace applications as V4L2 and ALSA capture devices.
|
||
|
|
The devices' relationships (when using a webcam, end-users shouldn't
|
||
|
|
have to manually select the associated USB microphone), while not made
|
||
|
|
available directly to applications by the drivers, can usually be
|
||
|
|
retrieved from sysfs.
|
||
|
|
|
||
|
|
With more and more advanced SoC devices being introduced, the current
|
||
|
|
approach will not scale. Device topologies are getting increasingly
|
||
|
|
complex and can't always be represented by a tree structure. Hardware
|
||
|
|
blocks are shared between different functions, creating dependencies
|
||
|
|
between seemingly unrelated devices.
|
||
|
|
|
||
|
|
Kernel abstraction APIs such as V4L2 and ALSA provide means for
|
||
|
|
applications to access hardware parameters. As newer hardware expose an
|
||
|
|
increasingly high number of those parameters, drivers need to guess what
|
||
|
|
applications really require based on limited information, thereby
|
||
|
|
implementing policies that belong to userspace.
|
||
|
|
|
||
|
|
The media controller API aims at solving those problems.
|