Commit 553cedf6 authored by Rob Herring's avatar Rob Herring
Browse files

dt-bindings: Convert Arm Mali Midgard GPU to DT schema 



Convert the Arm Midgard GPU binding to DT schema format.

The 'clocks' property is now required. This simplifies the schema as
effectively all the users require 'clocks' already and the upstream
driver requires at least one clock.

Reviewed-by: default avatarNeil Armstrong <narmstrong@baylibre.com>
Acked-by: default avatarMaxime Ripard <maxime.ripard@bootlin.com>
Acked-by: default avatarHeiko Stuebner <heiko@sntech.de>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent a45dddad

Documentation/devicetree/bindings/gpu/arm,mali-midgard.txt

deleted100644 → 0
+0 −119
Original line number Diff line number Diff line 
ARM Mali Midgard GPU

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



Required properties:



- compatible :

  * Must contain one of the following:

    + "arm,mali-t604"

    + "arm,mali-t624"

    + "arm,mali-t628"

    + "arm,mali-t720"

    + "arm,mali-t760"

    + "arm,mali-t820"

    + "arm,mali-t830"

    + "arm,mali-t860"

    + "arm,mali-t880"

  * which must be preceded by one of the following vendor specifics:

    + "allwinner,sun50i-h6-mali"

    + "amlogic,meson-gxm-mali"

    + "samsung,exynos5433-mali"

    + "rockchip,rk3288-mali"

    + "rockchip,rk3399-mali"



- reg : Physical base address of the device and length of the register area.



- interrupts : Contains the three IRQ lines required by Mali Midgard devices.



- interrupt-names : Contains the names of IRQ resources in the order they were

  provided in the interrupts property. Must contain: "job", "mmu", "gpu".





Optional properties:



- clocks : Phandle to clock for the Mali Midgard device.



- clock-names : Specify the names of the clocks specified in clocks

  when multiple clocks are present.

    * core: clock driving the GPU itself (When only one clock is present,

      assume it's this clock.)

    * bus: bus clock for the GPU



- mali-supply : Phandle to regulator for the Mali device. Refer to

  Documentation/devicetree/bindings/regulator/regulator.txt for details.



- operating-points-v2 : Refer to Documentation/devicetree/bindings/opp/opp.txt

  for details.



- #cooling-cells: Refer to Documentation/devicetree/bindings/thermal/thermal.txt

  for details.



- resets : Phandle of the GPU reset line.



Vendor-specific bindings

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



The Mali GPU is integrated very differently from one SoC to

another. In order to accommodate those differences, you have the option

to specify one more vendor-specific compatible, among:



- "allwinner,sun50i-h6-mali"

  Required properties:

  - clocks : phandles to core and bus clocks

  - clock-names : must contain "core" and "bus"

  - resets: phandle to GPU reset line



- "amlogic,meson-gxm-mali"

  Required properties:

  - resets : Should contain phandles of :

    + GPU reset line

    + GPU APB glue reset line



Example for a Mali-T760:



gpu@ffa30000 {

	compatible = "rockchip,rk3288-mali", "arm,mali-t760";

	reg = <0xffa30000 0x10000>;

	interrupts = <GIC_SPI 6 IRQ_TYPE_LEVEL_HIGH>,

		     <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>,

		     <GIC_SPI 8 IRQ_TYPE_LEVEL_HIGH>;

	interrupt-names = "job", "mmu", "gpu";

	clocks = <&cru ACLK_GPU>;

	mali-supply = <&vdd_gpu>;

	operating-points-v2 = <&gpu_opp_table>;

	power-domains = <&power RK3288_PD_GPU>;

	#cooling-cells = <2>;

};



gpu_opp_table: opp_table0 {

	compatible = "operating-points-v2";



	opp@533000000 {

		opp-hz = /bits/ 64 <533000000>;

		opp-microvolt = <1250000>;

	};

	opp@450000000 {

		opp-hz = /bits/ 64 <450000000>;

		opp-microvolt = <1150000>;

	};

	opp@400000000 {

		opp-hz = /bits/ 64 <400000000>;

		opp-microvolt = <1125000>;

	};

	opp@350000000 {

		opp-hz = /bits/ 64 <350000000>;

		opp-microvolt = <1075000>;

	};

	opp@266000000 {

		opp-hz = /bits/ 64 <266000000>;

		opp-microvolt = <1025000>;

	};

	opp@160000000 {

		opp-hz = /bits/ 64 <160000000>;

		opp-microvolt = <925000>;

	};

	opp@100000000 {

		opp-hz = /bits/ 64 <100000000>;

		opp-microvolt = <912500>;

	};

};

Documentation/devicetree/bindings/gpu/arm,mali-midgard.yaml

0 → 100644
+165 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: GPL-2.0-only

%YAML 1.2

---

$id: http://devicetree.org/schemas/gpu/arm,mali-midgard.yaml#

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



title: ARM Mali Midgard GPU



maintainers:

  - Rob Herring <robh@kernel.org>



properties:

  $nodename:

    pattern: '^gpu@[a-f0-9]+$'

  compatible:

    oneOf:

      - items:

          - enum:

             - allwinner,sun50i-h6-mali

          - const: arm,mali-t720

      - items:

          - enum:

             - amlogic,meson-gxm-mali

          - const: arm,mali-t820

      - items:

          - enum:

             - rockchip,rk3288-mali

          - const: arm,mali-t760

      - items:

          - enum:

             - rockchip,rk3399-mali

          - const: arm,mali-t860

      - items:

          - enum:

             - samsung,exynos5433-mali

          - const: arm,mali-t760



          # "arm,mali-t604"

          # "arm,mali-t624"

          # "arm,mali-t628"

          # "arm,mali-t830"

          # "arm,mali-t880"



  reg:

    maxItems: 1



  interrupts:

    items:

      - description: Job interrupt

      - description: MMU interrupt

      - description: GPU interrupt



  interrupt-names:

    items:

      - const: job

      - const: mmu

      - const: gpu



  clocks:

    minItems: 1

    maxItems: 2



  clock-names:

    minItems: 1

    items:

      - const: core

      - const: bus



  mali-supply:

    maxItems: 1



  resets:

    minItems: 1

    maxItems: 2



  operating-points-v2: true



  "#cooling-cells":

    const: 2



required:

  - compatible

  - reg

  - interrupts

  - interrupt-names

  - clocks



allOf:

  - if:

      properties:

        compatible:

          contains:

            const: allwinner,sun50i-h6-mali

    then:

      properties:

        clocks:

          minItems: 2

      required:

        - clock-names

        - resets

  - if:

      properties:

        compatible:

          contains:

            const: amlogic,meson-gxm-mali

    then:

      properties:

        resets:

          minItems: 2

      required:

        - resets



examples:

  - |

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

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



    gpu@ffa30000 {

      compatible = "rockchip,rk3288-mali", "arm,mali-t760";

      reg = <0xffa30000 0x10000>;

      interrupts = <GIC_SPI 6 IRQ_TYPE_LEVEL_HIGH>,

             <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>,

             <GIC_SPI 8 IRQ_TYPE_LEVEL_HIGH>;

      interrupt-names = "job", "mmu", "gpu";

      clocks = <&cru 0>;

      mali-supply = <&vdd_gpu>;

      operating-points-v2 = <&gpu_opp_table>;

      power-domains = <&power 0>;

      #cooling-cells = <2>;

    };



    gpu_opp_table: opp_table0 {

      compatible = "operating-points-v2";



      opp@533000000 {

        opp-hz = /bits/ 64 <533000000>;

        opp-microvolt = <1250000>;

      };

      opp@450000000 {

        opp-hz = /bits/ 64 <450000000>;

        opp-microvolt = <1150000>;

      };

      opp@400000000 {

        opp-hz = /bits/ 64 <400000000>;

        opp-microvolt = <1125000>;

      };

      opp@350000000 {

        opp-hz = /bits/ 64 <350000000>;

        opp-microvolt = <1075000>;

      };

      opp@266000000 {

        opp-hz = /bits/ 64 <266000000>;

        opp-microvolt = <1025000>;

      };

      opp@160000000 {

        opp-hz = /bits/ 64 <160000000>;

        opp-microvolt = <925000>;

      };

      opp@100000000 {

        opp-hz = /bits/ 64 <100000000>;

        opp-microvolt = <912500>;

      };

    };



...

CRA Git | Maintained and supported by SUSTech CRA and CCSE