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

   1 # SPDX-License-Identifier: GPL-2.0-only
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/gpu/arm,mali-bifrost.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: ARM Mali Bifrost GPU
   8
   9 maintainers:
  10   - Rob Herring <robh@kernel.org>
  11
  12 properties:
  13   $nodename:
  14     pattern: '^gpu@[a-f0-9]+$'
  15
  16   compatible:
  17     items:
  18       - enum:
  19           - amlogic,meson-g12a-mali
  20           - realtek,rtd1619-mali
  21           - rockchip,px30-mali
  22       - const: arm,mali-bifrost # Mali Bifrost GPU model/revision is fully discoverable
  23
  24   reg:
  25     maxItems: 1
  26
  27   interrupts:
  28     items:
  29       - description: Job interrupt
  30       - description: MMU interrupt
  31       - description: GPU interrupt
  32
  33   interrupt-names:
  34     items:
  35       - const: job
  36       - const: mmu
  37       - const: gpu
  38
  39   clocks:
  40     maxItems: 1
  41
  42   mali-supply: true
  43
  44   operating-points-v2: true
  45
  46   power-domains:
  47     maxItems: 1
  48
  49   resets:
  50     maxItems: 2
  51
  52   "#cooling-cells":
  53     const: 2
  54
  55   dynamic-power-coefficient:
  56     $ref: '/schemas/types.yaml#/definitions/uint32'
  57     description:
  58       A u32 value that represents the running time dynamic
  59       power coefficient in units of uW/MHz/V^2. The
  60       coefficient can either be calculated from power
  61       measurements or derived by analysis.
  62
  63       The dynamic power consumption of the GPU is
  64       proportional to the square of the Voltage (V) and
  65       the clock frequency (f). The coefficient is used to
  66       calculate the dynamic power as below -
  67
  68       Pdyn = dynamic-power-coefficient * V^2 * f
  69
  70       where voltage is in V, frequency is in MHz.
  71
  72 required:
  73   - compatible
  74   - reg
  75   - interrupts
  76   - interrupt-names
  77   - clocks
  78
  79 additionalProperties: false
  80
  81 allOf:
  82   - if:
  83       properties:
  84         compatible:
  85           contains:
  86             const: amlogic,meson-g12a-mali
  87     then:
  88       required:
  89         - resets
  90
  91 examples:
  92   - |
  93     #include <dt-bindings/interrupt-controller/irq.h>
  94     #include <dt-bindings/interrupt-controller/arm-gic.h>
  95
  96     gpu@ffe40000 {
  97       compatible = "amlogic,meson-g12a-mali", "arm,mali-bifrost";
  98       reg = <0xffe40000 0x10000>;
  99       interrupts = <GIC_SPI 160 IRQ_TYPE_LEVEL_HIGH>,
 100              <GIC_SPI 161 IRQ_TYPE_LEVEL_HIGH>,
 101              <GIC_SPI 162 IRQ_TYPE_LEVEL_HIGH>;
 102       interrupt-names = "job", "mmu", "gpu";
 103       clocks = <&clk 1>;
 104       mali-supply = <&vdd_gpu>;
 105       operating-points-v2 = <&gpu_opp_table>;
 106       resets = <&reset 0>, <&reset 1>;
 107     };
 108
 109     gpu_opp_table: opp_table0 {
 110       compatible = "operating-points-v2";
 111
 112       opp-533000000 {
 113         opp-hz = /bits/ 64 <533000000>;
 114         opp-microvolt = <1250000>;
 115       };
 116       opp-450000000 {
 117         opp-hz = /bits/ 64 <450000000>;
 118         opp-microvolt = <1150000>;
 119       };
 120       opp-400000000 {
 121         opp-hz = /bits/ 64 <400000000>;
 122         opp-microvolt = <1125000>;
 123       };
 124       opp-350000000 {
 125         opp-hz = /bits/ 64 <350000000>;
 126         opp-microvolt = <1075000>;
 127       };
 128       opp-266000000 {
 129         opp-hz = /bits/ 64 <266000000>;
 130         opp-microvolt = <1025000>;
 131       };
 132       opp-160000000 {
 133         opp-hz = /bits/ 64 <160000000>;
 134         opp-microvolt = <925000>;
 135       };
 136       opp-100000000 {
 137         opp-hz = /bits/ 64 <100000000>;
 138         opp-microvolt = <912500>;
 139       };
 140     };
 141
 142 ...