dt-bindings: display: vc4: hdmi: Add BCM2711 HDMI controllers bindings

# SPDX-License-Identifier: GPL-2.0

%YAML 1.2

---

$id: http://devicetree.org/schemas/display/brcm,bcm2711-hdmi.yaml#

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

title: Broadcom BCM2711 HDMI Controller Device Tree Bindings

maintainers:

  - Eric Anholt <eric@anholt.net>

properties:

  compatible:

    enum:

      - brcm,bcm2711-hdmi0

      - brcm,bcm2711-hdmi1

  reg:

    items:

      - description: HDMI controller register range

      - description: DVP register range

      - description: HDMI PHY register range

      - description: Rate Manager register range

      - description: Packet RAM register range

      - description: Metadata RAM register range

      - description: CSC register range

      - description: CEC register range

      - description: HD register range

  reg-names:

    items:

      - const: hdmi

      - const: dvp

      - const: phy

      - const: rm

      - const: packet

      - const: metadata

      - const: csc

      - const: cec

      - const: hd

  clocks:

    items:

      - description: The HDMI state machine clock

      - description: The Pixel BVB clock

      - description: The HDMI Audio parent clock

      - description: The HDMI CEC parent clock

  clock-names:

    items:

      - const: hdmi

      - const: bvb

      - const: audio

      - const: cec

  ddc:

    allOf:

      - $ref: /schemas/types.yaml#/definitions/phandle

    description: >

      Phandle of the I2C controller used for DDC EDID probing

  hpd-gpios:

    description: >

      The GPIO pin for the HDMI hotplug detect (if it doesn't appear

      as an interrupt/status bit in the HDMI controller itself)

  dmas:

    maxItems: 1

    description: >

      Should contain one entry pointing to the DMA channel used to

      transfer audio data.

  dma-names:

    const: audio-rx

  resets:

    maxItems: 1

required:

  - compatible

  - reg

  - reg-names

  - clocks

  - resets

  - ddc

additionalProperties: false

examples:

  - |

    hdmi0: hdmi@7ef00700 {

        compatible = "brcm,bcm2711-hdmi0";

        reg = <0x7ef00700 0x300>,

              <0x7ef00300 0x200>,

              <0x7ef00f00 0x80>,

              <0x7ef00f80 0x80>,

              <0x7ef01b00 0x200>,

              <0x7ef01f00 0x400>,

              <0x7ef00200 0x80>,

              <0x7ef04300 0x100>,

              <0x7ef20000 0x100>;

        reg-names = "hdmi",

                    "dvp",

                    "phy",

                    "rm",

                    "packet",

                    "metadata",

                    "csc",

                    "cec",

                    "hd";

        clocks = <&firmware_clocks 13>, <&firmware_clocks 14>, <&dvp 1>, <&clk_27MHz>;

        clock-names = "hdmi", "bvb", "audio", "cec";

        resets = <&dvp 0>;

        ddc = <&ddc0>;

    };

...