driver-api/media/mc-core.rst

1 .. SPDX-License-Identifier: GPL-2.0
4 ------------------------
11 on the kernel-side implementation of the media framework.
24 in a System-on-Chip image processing pipeline), DMA channels or physical
32 A link is a point-to-point oriented connection between two pads, either
40 instance, defined in ``include/media/media-device.h``.
42 embedding the :c:type:`media_device` instance in a larger driver-specific
60 instance, defined in ``include/media/media-entity.h``. The structure is usually
61 embedded into a higher-level structure, such as
78 ``include/media/media-entity.h``. Currently, only one type of interface is
90 defined in ``include/media/media-entity.h``. Each entity stores its pads in
92 a driver-specific structure.
94 Pads are identified by their entity and their 0-based index in the pads
115 defined in ``include/media/media-entity.h``. There are two types of links:
152 ``include/media/media-device.h``.
154 ..  code-block:: c
194 source devices (such as a sensors) and flowing through media entity pads
213 media_pipeline in higher-level pipeline structures and can then access the
231 Link configuration will fail with ``-EBUSY`` by default if either end of the
253 in the end provide a way to use driver-specific callbacks.
264 .. code-block:: c
277 .. code-block:: c
314 Drivers should use the appropriate media-core routines to manage the shared
315 media device life-time handling the two states:
316 1. allocate -> register -> delete
317 2. get reference to already registered device -> delete
327 Call :c:func:`media_device_delete()` to free the media_device. Freeing is
333 .. kernel-doc:: include/media/media-device.h
335 .. kernel-doc:: include/media/media-devnode.h
337 .. kernel-doc:: include/media/media-entity.h
339 .. kernel-doc:: include/media/media-request.h
341 .. kernel-doc:: include/media/media-dev-allocator.h