xref: /freebsd/sys/contrib/device-tree/Bindings/gpu/arm,mali-utgard.yaml (revision 43a5ec4eb41567cc92586503212743d89686d78f)
1# SPDX-License-Identifier: GPL-2.0-only
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/gpu/arm,mali-utgard.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ARM Mali Utgard GPU
8
9maintainers:
10  - Rob Herring <robh@kernel.org>
11  - Maxime Ripard <mripard@kernel.org>
12  - Heiko Stuebner <heiko@sntech.de>
13
14properties:
15  $nodename:
16    pattern: '^gpu@[a-f0-9]+$'
17  compatible:
18    oneOf:
19      - items:
20          - const: allwinner,sun8i-a23-mali
21          - const: allwinner,sun7i-a20-mali
22          - const: arm,mali-400
23      - items:
24          - enum:
25              - allwinner,sun4i-a10-mali
26              - allwinner,sun7i-a20-mali
27              - allwinner,sun8i-h3-mali
28              - allwinner,sun8i-r40-mali
29              - allwinner,sun50i-a64-mali
30              - rockchip,rk3036-mali
31              - rockchip,rk3066-mali
32              - rockchip,rk3188-mali
33              - rockchip,rk3228-mali
34              - samsung,exynos4210-mali
35              - stericsson,db8500-mali
36          - const: arm,mali-400
37      - items:
38          - enum:
39              - allwinner,sun50i-h5-mali
40              - amlogic,meson8-mali
41              - amlogic,meson8b-mali
42              - amlogic,meson-gxbb-mali
43              - amlogic,meson-gxl-mali
44              - hisilicon,hi6220-mali
45              - mediatek,mt7623-mali
46              - rockchip,rk3328-mali
47          - const: arm,mali-450
48
49      # "arm,mali-300"
50
51  reg:
52    maxItems: 1
53
54  interrupts:
55    minItems: 4
56    maxItems: 20
57
58  interrupt-names:
59    allOf:
60      - additionalItems: true
61        minItems: 4
62        maxItems: 20
63        items:
64          # At least enforce the first 2 interrupts
65          - const: gp
66          - const: gpmmu
67      - items:
68          # Not ideal as any order and combination are allowed
69          enum:
70            - gp        # Geometry Processor interrupt
71            - gpmmu     # Geometry Processor MMU interrupt
72            - pp        # Pixel Processor broadcast interrupt (mali-450 only)
73            - pp0       # Pixel Processor X interrupt (X from 0 to 7)
74            - ppmmu0    # Pixel Processor X MMU interrupt (X from 0 to 7)
75            - pp1
76            - ppmmu1
77            - pp2
78            - ppmmu2
79            - pp3
80            - ppmmu3
81            - pp4
82            - ppmmu4
83            - pp5
84            - ppmmu5
85            - pp6
86            - ppmmu6
87            - pp7
88            - ppmmu7
89            - pmu       # Power Management Unit interrupt (optional)
90            - combined  # stericsson,db8500-mali only
91
92  clocks:
93    maxItems: 2
94
95  clock-names:
96    items:
97      - const: bus
98      - const: core
99
100  memory-region: true
101
102  mali-supply: true
103
104  opp-table: true
105
106  power-domains:
107    maxItems: 1
108
109  resets:
110    maxItems: 1
111
112  operating-points-v2: true
113
114  "#cooling-cells":
115    const: 2
116
117required:
118  - compatible
119  - reg
120  - interrupts
121  - interrupt-names
122  - clocks
123  - clock-names
124
125additionalProperties: false
126
127allOf:
128  - if:
129      properties:
130        compatible:
131          contains:
132            enum:
133              - allwinner,sun4i-a10-mali
134              - allwinner,sun7i-a20-mali
135              - allwinner,sun8i-r40-mali
136              - allwinner,sun50i-a64-mali
137              - allwinner,sun50i-h5-mali
138              - amlogic,meson8-mali
139              - amlogic,meson8b-mali
140              - hisilicon,hi6220-mali
141              - mediatek,mt7623-mali
142              - rockchip,rk3036-mali
143              - rockchip,rk3066-mali
144              - rockchip,rk3188-mali
145              - rockchip,rk3228-mali
146              - rockchip,rk3328-mali
147    then:
148      required:
149        - resets
150
151examples:
152  - |
153    #include <dt-bindings/interrupt-controller/irq.h>
154    #include <dt-bindings/interrupt-controller/arm-gic.h>
155
156    mali: gpu@1c40000 {
157      compatible = "allwinner,sun7i-a20-mali", "arm,mali-400";
158      reg = <0x01c40000 0x10000>;
159      interrupts = <GIC_SPI 97 IRQ_TYPE_LEVEL_HIGH>,
160             <GIC_SPI 98 IRQ_TYPE_LEVEL_HIGH>,
161             <GIC_SPI 99 IRQ_TYPE_LEVEL_HIGH>,
162             <GIC_SPI 100 IRQ_TYPE_LEVEL_HIGH>,
163             <GIC_SPI 102 IRQ_TYPE_LEVEL_HIGH>,
164             <GIC_SPI 103 IRQ_TYPE_LEVEL_HIGH>,
165             <GIC_SPI 101 IRQ_TYPE_LEVEL_HIGH>;
166      interrupt-names = "gp",
167            "gpmmu",
168            "pp0",
169            "ppmmu0",
170            "pp1",
171            "ppmmu1",
172            "pmu";
173      clocks = <&ccu 1>, <&ccu 2>;
174      clock-names = "bus", "core";
175      resets = <&ccu 1>;
176      #cooling-cells = <2>;
177    };
178
179...
180