Merge tag 'media/v6.1-2' of git://git.kernel.org/pub/scm/linux/kernel/git/mchehab/linux-media

Dongwoon Anatech DW9714 camera voice coil lens driver

DW9174 is a 10-bit DAC with current sink capability. It is intended

for driving voice coil lenses in camera modules.

Mandatory properties:

- compatible: "dongwoon,dw9714"

- reg: I²C slave address

# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/i2c/dongwoon,dw9714.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Dongwoon Anatech DW9714 camera voice coil lens driver

maintainers:

  - Krzysztof Kozlowski <krzk@kernel.org>

description:

  DW9174 is a 10-bit DAC with current sink capability. It is intended for

  driving voice coil lenses in camera modules.

properties:

  compatible:

    const: dongwoon,dw9714

  reg:

    maxItems: 1

  powerdown-gpios:

    description:

      XSD pin for shutdown (active low)

  vcc-supply:

    description: VDD power supply

required:

  - compatible

  - reg

additionalProperties: false

examples:

  - |

    i2c {

        #address-cells = <1>;

        #size-cells = <0>;

        camera-lens@c {

            compatible = "dongwoon,dw9714";

            reg = <0x0c>;

            vcc-supply = <&reg_csi_1v8>;

        };

    };

Pipelines and media streams

^^^^^^^^^^^^^^^^^^^^^^^^^^^

A media stream is a stream of pixels or metadata originating from one or more

source devices (such as a sensors) and flowing through media entity pads

towards the final sinks. The stream can be modified on the route by the

devices (e.g. scaling or pixel format conversions), or it can be split into

multiple branches, or multiple branches can be merged.

A media pipeline is a set of media streams which are interdependent. This

interdependency can be caused by the hardware (e.g. configuration of a second

stream cannot be changed if the first stream has been enabled) or by the driver

due to the software design. Most commonly a media pipeline consists of a single

stream which does not branch.

When starting streaming, drivers must notify all entities in the pipeline to

prevent link states from being modified during streaming by calling

:c:func:`media_pipeline_start()`.

The function will mark all entities connected to the given entity through

enabled links, either directly or indirectly, as streaming.

The function will mark all the pads which are part of the pipeline as streaming.

The struct media_pipeline instance pointed to by

the pipe argument will be stored in every entity in the pipeline.

the pipe argument will be stored in every pad in the pipeline.

Drivers should embed the struct media_pipeline

in higher-level pipeline structures and can then access the

pipeline through the struct media_entity

pipeline through the struct media_pad

pipe field.

Calls to :c:func:`media_pipeline_start()` can be nested.

ignore define CEC_OP_FEAT_DEV_HAS_SET_AUDIO_RATE

ignore define CEC_OP_FEAT_DEV_SINK_HAS_ARC_TX

ignore define CEC_OP_FEAT_DEV_SOURCE_HAS_ARC_RX

ignore define CEC_OP_FEAT_DEV_HAS_SET_AUDIO_VOLUME_LEVEL

ignore define CEC_MSG_GIVE_FEATURES

ignore define CEC_MSG_SYSTEM_AUDIO_MODE_REQUEST

ignore define CEC_MSG_SYSTEM_AUDIO_MODE_STATUS

ignore define CEC_MSG_SET_AUDIO_VOLUME_LEVEL

ignore define CEC_OP_AUD_FMT_ID_CEA861

ignore define CEC_OP_AUD_FMT_ID_CEA861_CXT

   operates like the :c:func:`read()` function.

.. c:function:: void v4l2_mmap(void *start, size_t length, int prot, int flags, int fd, int64_t offset);

.. c:function:: void *v4l2_mmap(void *start, size_t length, int prot, int flags, int fd, int64_t offset);

   operates like the :c:func:`munmap()` function.

   operates like the :c:func:`mmap()` function.

.. c:function:: int v4l2_munmap(void *_start, size_t length);