Commit cf4ef3a8 authored by Neil Armstrong's avatar Neil Armstrong Committed by Rob Herring
Browse files

dt-bindings: media: meson-ao-cec: convert to yaml 



Now that we have the DT validation in place, let's convert the device tree
bindings for the Amlogic AO-CEC controller over to a YAML schemas.

Signed-off-by: default avatarNeil Armstrong <narmstrong@baylibre.com>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent 589531a0

Documentation/devicetree/bindings/media/amlogic,meson-gx-ao-cec.yaml

0 → 100644
+91 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

# Copyright 2019 BayLibre, SAS

%YAML 1.2

---

$id: "http://devicetree.org/schemas/media/amlogic,meson-gx-ao-cec.yaml#"

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



title: Amlogic Meson AO-CEC Controller



maintainers:

  - Neil Armstrong <narmstrong@baylibre.com>



description: |

  The Amlogic Meson AO-CEC module is present is Amlogic SoCs and its purpose is

  to handle communication between HDMI connected devices over the CEC bus.



properties:

  compatible:

    enum:

      - amlogic,meson-gx-ao-cec # GXBB, GXL, GXM, G12A and SM1 AO_CEC_A module

      - amlogic,meson-g12a-ao-cec # G12A AO_CEC_B module

      - amlogic,meson-sm1-ao-cec # SM1 AO_CEC_B module



  reg:

    maxItems: 1



  interrupts:

    maxItems: 1



  hdmi-phandle:

    description: phandle to the HDMI controller

    allOf:

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



allOf:

  - if:

      properties:

        compatible:

          contains:

            enum:

              - amlogic,meson-gx-ao-cec



    then:

      properties:

        clocks:

          items:

            - description: AO-CEC clock



        clock-names:

          maxItems: 1

          items:

            - const: core



  - if:

      properties:

        compatible:

          contains:

            enum:

              - amlogic,meson-g12a-ao-cec

              - amlogic,meson-sm1-ao-cec



    then:

      properties:

        clocks:

          items:

            - description: AO-CEC clock generator source



        clock-names:

          maxItems: 1

          items:

            - const: oscin



required:

  - compatible

  - reg

  - interrupts

  - hdmi-phandle

  - clocks

  - clock-names



examples:

  - |

    cec_AO: cec@100 {

        compatible = "amlogic,meson-gx-ao-cec";

        reg = <0x0 0x00100 0x0 0x14>;

        interrupts = <199>;

        clocks = <&clkc_cec>;

        clock-names = "core";

        hdmi-phandle = <&hdmi_tx>;

    };

Documentation/devicetree/bindings/media/meson-ao-cec.txt

deleted100644 → 0
+0 −37
Original line number Diff line number Diff line 
* Amlogic Meson AO-CEC driver



The Amlogic Meson AO-CEC module is present is Amlogic SoCs and its purpose is

to handle communication between HDMI connected devices over the CEC bus.



Required properties:

  - compatible : value should be following depending on the SoC :

	For GXBB, GXL, GXM, G12A and SM1 (AO_CEC_A module) :

	"amlogic,meson-gx-ao-cec"

	For G12A (AO_CEC_B module) :

	"amlogic,meson-g12a-ao-cec"

	For SM1 (AO_CEC_B module) :

	"amlogic,meson-sm1-ao-cec"



  - reg : Physical base address of the IP registers and length of memory

	  mapped region.



  - interrupts : AO-CEC interrupt number to the CPU.

  - clocks : from common clock binding: handle to AO-CEC clock.

  - clock-names : from common clock binding, must contain :

		For GXBB, GXL, GXM, G12A and SM1 (AO_CEC_A module) :

		- "core"

		For G12A, SM1 (AO_CEC_B module) :

		- "oscin"

		corresponding to entry in the clocks property.

  - hdmi-phandle: phandle to the HDMI controller



Example:



cec_AO: cec@100 {

	compatible = "amlogic,meson-gx-ao-cec";

	reg = <0x0 0x00100 0x0 0x14>;

	interrupts = <GIC_SPI 199 IRQ_TYPE_EDGE_RISING>;

	clocks = <&clkc_AO CLKID_AO_CEC_32K>;

	clock-names = "core";

	hdmi-phandle = <&hdmi_tx>;

};