dt-bindings: display: mediatek: convert the dpi bindings to yaml

Mediatek DPI Device

===================

The Mediatek DPI function block is a sink of the display subsystem and

provides 8-bit RGB/YUV444 or 8/10/10-bit YUV422 pixel data on a parallel

output bus.

Required properties:

- compatible: "mediatek,<chip>-dpi"

  the supported chips are mt2701, mt7623, mt8173 and mt8183.

- reg: Physical base address and length of the controller's registers

- interrupts: The interrupt signal from the function block.

- clocks: device clocks

  See Documentation/devicetree/bindings/clock/clock-bindings.txt for details.

- clock-names: must contain "pixel", "engine", and "pll"

- port: Output port node with endpoint definitions as described in

  Documentation/devicetree/bindings/graph.txt. This port should be connected

  to the input port of an attached HDMI or LVDS encoder chip.

Optional properties:

- pinctrl-names: Contain "default" and "sleep".

Example:

dpi0: dpi@1401d000 {

	compatible = "mediatek,mt8173-dpi";

	reg = <0 0x1401d000 0 0x1000>;

	interrupts = <GIC_SPI 194 IRQ_TYPE_LEVEL_LOW>;

	clocks = <&mmsys CLK_MM_DPI_PIXEL>,

		 <&mmsys CLK_MM_DPI_ENGINE>,

		 <&apmixedsys CLK_APMIXED_TVDPLL>;

	clock-names = "pixel", "engine", "pll";

	pinctrl-names = "default", "sleep";

	pinctrl-0 = <&dpi_pin_func>;

	pinctrl-1 = <&dpi_pin_idle>;

	port {

		dpi0_out: endpoint {

			remote-endpoint = <&hdmi0_in>;

		};

	};

};

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/display/mediatek/mediatek,dpi.yaml#

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

title: mediatek DPI Controller Device Tree Bindings

maintainers:

  - CK Hu <ck.hu@mediatek.com>

  - Jitao shi <jitao.shi@mediatek.com>

description: |

  The Mediatek DPI function block is a sink of the display subsystem and

  provides 8-bit RGB/YUV444 or 8/10/10-bit YUV422 pixel data on a parallel

  output bus.

properties:

  compatible:

    enum:

      - mediatek,mt2701-dpi

      - mediatek,mt7623-dpi

      - mediatek,mt8173-dpi

      - mediatek,mt8183-dpi

  reg:

    maxItems: 1

  interrupts:

    maxItems: 1

  clocks:

    items:

      - description: Pixel Clock

      - description: Engine Clock

      - description: DPI PLL

  clock-names:

    items:

      - const: pixel

      - const: engine

      - const: pll

  pinctrl-0: true

  pinctrl-1: true

  pinctrl-names:

    items:

      - const: default

      - const: sleep

  port:

    type: object

    description:

      Output port node with endpoint definitions as described in

      Documentation/devicetree/bindings/graph.txt. This port should be connected

      to the input port of an attached HDMI or LVDS encoder chip.

    properties:

      endpoint:

        type: object

required:

  - compatible

  - reg

  - interrupts

  - clocks

  - clock-names

  - port

additionalProperties: false

examples:

  - |

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

    #include <dt-bindings/clock/mt8173-clk.h>

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

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

    dpi0: dpi@1401d000 {

        compatible = "mediatek,mt8173-dpi";

        reg = <0x1401d000 0x1000>;

        interrupts = <GIC_SPI 194 IRQ_TYPE_LEVEL_LOW>;

        clocks = <&mmsys CLK_MM_DPI_PIXEL>,

             <&mmsys CLK_MM_DPI_ENGINE>,

             <&apmixedsys CLK_APMIXED_TVDPLL>;

        clock-names = "pixel", "engine", "pll";

        pinctrl-names = "default", "sleep";

        pinctrl-0 = <&dpi_pin_func>;

        pinctrl-1 = <&dpi_pin_idle>;

        port {

            dpi0_out: endpoint {

                remote-endpoint = <&hdmi0_in>;

            };

        };

    };

...