Merge tag 'docs-5.11-2' of git://git.lwn.net/linux
[linux-2.6-microblaze.git] / Documentation / devicetree / bindings / bus / allwinner,sun50i-a64-de2.yaml
1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/bus/allwinner,sun50i-a64-de2.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Allwinner A64 Display Engine Bus Device Tree Bindings
8
9 maintainers:
10   - Chen-Yu Tsai <wens@csie.org>
11   - Maxime Ripard <mripard@kernel.org>
12
13 properties:
14   $nodename:
15     pattern: "^bus(@[0-9a-f]+)?$"
16
17   "#address-cells":
18     const: 1
19
20   "#size-cells":
21     const: 1
22
23   compatible:
24     oneOf:
25       - const: allwinner,sun50i-a64-de2
26       - items:
27           - const: allwinner,sun50i-h6-de3
28           - const: allwinner,sun50i-a64-de2
29
30   reg:
31     maxItems: 1
32
33   allwinner,sram:
34     description:
35       The SRAM that needs to be claimed to access the display engine
36       bus.
37     $ref: /schemas/types.yaml#/definitions/phandle-array
38     maxItems: 1
39
40   ranges: true
41
42 patternProperties:
43   # All other properties should be child nodes with unit-address and 'reg'
44   "^[a-zA-Z][a-zA-Z0-9,+\\-._]{0,63}@[0-9a-fA-F]+$":
45     type: object
46     properties:
47       reg:
48         maxItems: 1
49
50     required:
51       - reg
52
53 required:
54   - compatible
55   - reg
56   - "#address-cells"
57   - "#size-cells"
58   - ranges
59   - allwinner,sram
60
61 additionalProperties: false
62
63 examples:
64   - |
65     bus@1000000 {
66         compatible = "allwinner,sun50i-a64-de2";
67         reg = <0x1000000 0x400000>;
68         allwinner,sram = <&de2_sram 1>;
69         #address-cells = <1>;
70         #size-cells = <1>;
71         ranges = <0 0x1000000 0x400000>;
72
73         display_clocks: clock@0 {
74             compatible = "allwinner,sun50i-a64-de2-clk";
75             reg = <0x0 0x100000>;
76             clocks = <&ccu 52>, <&ccu 99>;
77             clock-names = "bus", "mod";
78             resets = <&ccu 30>;
79             #clock-cells = <1>;
80             #reset-cells = <1>;
81         };
82     };
83
84 ...