dt-bindings: display: dw_mipi_dsi.txt: convert to yaml

Synopsys DesignWare MIPI DSI host controller

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

This document defines device tree properties for the Synopsys DesignWare MIPI

DSI host controller. It doesn't constitue a device tree binding specification

by itself but is meant to be referenced by platform-specific device tree

bindings.

When referenced from platform device tree bindings the properties defined in

this document are defined as follows. The platform device tree bindings are

responsible for defining whether each optional property is used or not.

- reg: Memory mapped base address and length of the DesignWare MIPI DSI

  host controller registers. (mandatory)

- clocks: References to all the clocks specified in the clock-names property

  as specified in [1]. (mandatory)

- clock-names:

  - "pclk" is the peripheral clock for either AHB and APB. (mandatory)

  - "px_clk" is the pixel clock for the DPI/RGB input. (optional)

- resets: References to all the resets specified in the reset-names property

  as specified in [2]. (optional)

- reset-names: string reset name, must be "apb" if used. (optional)

- panel or bridge node: see [3]. (mandatory)

[1] Documentation/devicetree/bindings/clock/clock-bindings.txt

[2] Documentation/devicetree/bindings/reset/reset.txt

[3] Documentation/devicetree/bindings/display/mipi-dsi-bus.txt

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

%YAML 1.2

---

$id: http://devicetree.org/schemas/display/bridge/snps,dw-mipi-dsi.yaml#

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

title: Synopsys DesignWare MIPI DSI host controller

maintainers:

  - Philippe CORNU <philippe.cornu@st.com>

description: |

  This document defines device tree properties for the Synopsys DesignWare MIPI

  DSI host controller. It doesn't constitue a device tree binding specification

  by itself but is meant to be referenced by platform-specific device tree

  bindings.

  When referenced from platform device tree bindings the properties defined in

  this document are defined as follows. The platform device tree bindings are

  responsible for defining whether each property is required or optional.

allOf:

  - $ref: ../dsi-controller.yaml#

properties:

  reg:

    maxItems: 1

  clocks:

    items:

      - description: Module clock

      - description: DSI bus clock for either AHB and APB

      - description: Pixel clock for the DPI/RGB input

    minItems: 2

  clock-names:

    items:

      - const: ref

      - const: pclk

      - const: px_clk

    minItems: 2

  resets:

    maxItems: 1

  reset-names:

    const: apb

  ports:

    type: object

    properties:

      port@0:

        type: object

        description: Input node to receive pixel data.

      port@1:

        type: object

        description: DSI output node to panel.

    required:

      - port@0

      - port@1

required:

  - clock-names

  - clocks

  - ports

  - reg