xref: /linux/Documentation/devicetree/bindings/gpu/arm,mali-bifrost.yaml (revision 415e915fdfc775ad0c6675fde1008f6f43dd6251) 
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
7title: ARM Mali Bifrost GPU
8
9maintainers:
10  - Rob Herring <robh@kernel.org>
11
12properties:
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
72required:
73  - compatible
74  - reg
75  - interrupts
76  - interrupt-names
77  - clocks
78
79additionalProperties: false
80
81allOf:
82  - if:
83      properties:
84        compatible:
85          contains:
86            const: amlogic,meson-g12a-mali
87    then:
88      required:
89        - resets
90
91examples:
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...
143