Merge branch 'patchwork' into v4l_for_linus

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/arm/allwinner,sun4i-a10-csi.yaml#

$id: http://devicetree.org/schemas/media/allwinner,sun4i-a10-csi.yaml#

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

title: Allwinner A10 CMOS Sensor Interface (CSI) Device Tree Bindings

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/media/allwinner,sun8i-h3-deinterlace.yaml#

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

title: Allwinner H3 Deinterlace Device Tree Bindings

maintainers:

  - Jernej Skrabec <jernej.skrabec@siol.net>

  - Chen-Yu Tsai <wens@csie.org>

  - Maxime Ripard <mripard@kernel.org>

description: |-

  The Allwinner H3 and later has a deinterlace core used for

  deinterlacing interlaced video content.

properties:

  compatible:

    const: allwinner,sun8i-h3-deinterlace

  reg:

    maxItems: 1

  interrupts:

    maxItems: 1

  clocks:

    items:

      - description: Deinterlace interface clock

      - description: Deinterlace module clock

      - description: Deinterlace DRAM clock

  clock-names:

    items:

      - const: bus

      - const: mod

      - const: ram

  resets:

    maxItems: 1

  interconnects:

    maxItems: 1

  interconnect-names:

    const: dma-mem

required:

  - compatible

  - reg

  - interrupts

  - clocks

additionalProperties: false

examples:

  - |

    #include <dt-bindings/interrupt-controller/arm-gic.h>

    #include <dt-bindings/clock/sun8i-h3-ccu.h>

    #include <dt-bindings/reset/sun8i-h3-ccu.h>

    deinterlace: deinterlace@1400000 {

        compatible = "allwinner,sun8i-h3-deinterlace";

        reg = <0x01400000 0x20000>;

        clocks = <&ccu CLK_BUS_DEINTERLACE>,

                 <&ccu CLK_DEINTERLACE>,

                 <&ccu CLK_DRAM_DEINTERLACE>;

        clock-names = "bus", "mod", "ram";

        resets = <&ccu RST_BUS_DEINTERLACE>;

        interrupts = <GIC_SPI 93 IRQ_TYPE_LEVEL_HIGH>;

        interconnects = <&mbus 9>;

        interconnect-names = "dma-mem";

    };

...

Required Properties:

  - compatible: Must contain "adi,ad5820"

  - compatible: Must contain one of:

		- "adi,ad5820"

		- "adi,ad5821"

		- "adi,ad5823"

  - reg: I2C slave address

  - VANA-supply: supply of voltage for VANA pin

Optional properties:

   - enable-gpios : GPIO spec for the XSHUTDOWN pin. The XSHUTDOWN signal is

active low, a high level on the pin enables the device.

Example:

       ad5820: coil@c {

               reg = <0x0c>;

               VANA-supply = <&vaux4>;

               enable-gpios = <&msmgpio 26 GPIO_ACTIVE_HIGH>;

       };

* Sony IMX290 1/2.8-Inch CMOS Image Sensor

The Sony IMX290 is a 1/2.8-Inch CMOS Solid-state image sensor with

Square Pixel for Color Cameras. It is programmable through I2C and 4-wire

interfaces. The sensor output is available via CMOS logic parallel SDR output,

Low voltage LVDS DDR output and CSI-2 serial data output. The CSI-2 bus is the

default. No bindings have been defined for the other busses.

Required Properties:

- compatible: Should be "sony,imx290"

- reg: I2C bus address of the device

- clocks: Reference to the xclk clock.

- clock-names: Should be "xclk".

- clock-frequency: Frequency of the xclk clock in Hz.

- vdddo-supply: Sensor digital IO regulator.

- vdda-supply: Sensor analog regulator.

- vddd-supply: Sensor digital core regulator.

Optional Properties:

- reset-gpios: Sensor reset GPIO

The imx290 device node should contain one 'port' child node with

an 'endpoint' subnode. For further reading on port node refer to

Documentation/devicetree/bindings/media/video-interfaces.txt.

Required Properties on endpoint:

- data-lanes: check ../video-interfaces.txt

- link-frequencies: check ../video-interfaces.txt

- remote-endpoint: check ../video-interfaces.txt

Example:

	&i2c1 {

		...

		imx290: camera-sensor@1a {

			compatible = "sony,imx290";

			reg = <0x1a>;

			reset-gpios = <&msmgpio 35 GPIO_ACTIVE_LOW>;

			pinctrl-names = "default";

			pinctrl-0 = <&camera_rear_default>;

			clocks = <&gcc GCC_CAMSS_MCLK0_CLK>;

			clock-names = "xclk";

			clock-frequency = <37125000>;

			vdddo-supply = <&camera_vdddo_1v8>;

			vdda-supply = <&camera_vdda_2v8>;

			vddd-supply = <&camera_vddd_1v5>;

			port {

				imx290_ep: endpoint {

					data-lanes = <1 2 3 4>;

					link-frequencies = /bits/ 64 <445500000>;

					remote-endpoint = <&csiphy0_ep>;

				};

			};

		};

Optional properties

-------------------

- nokia,nvm-size: The size of the NVM, in bytes. If the size is not given,

  the NVM contents will not be read.

- reset-gpios: XSHUTDOWN GPIO

- flash-leds: See ../video-interfaces.txt

- lens-focus: See ../video-interfaces.txt