xref: /linux/Documentation/devicetree/bindings/arm/arm,realview.yaml (revision 08d99b2c23dfa84ca5b5e5c194062a0550888b71)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/arm/arm,realview.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ARM RealView Boards Device Tree Bindings
8
9maintainers:
10  - Linus Walleij <linus.walleij@linaro.org>
11
12description: |+
13  The ARM RealView series of reference designs were built to explore the ARM
14  11, Cortex A-8 and Cortex A-9 CPUs. This included new features compared to
15  the earlier CPUs such as TrustZone and multicore (MPCore).
16
17properties:
18  $nodename:
19    const: '/'
20  compatible:
21    oneOf:
22      - description: ARM RealView Emulation Baseboard (HBI-0140) was created
23          as a generic platform to test different FPGA designs, and has
24          pluggable CPU modules, see ARM DUI 0303E.
25        items:
26          - const: arm,realview-eb
27      - description: ARM RealView Platform Baseboard for ARM1176JZF-S
28          (HBI-0147) was created as a development board to test ARM TrustZone,
29          CoreSight and Intelligent Energy Management (IEM) see ARM DUI 0425F.
30        items:
31          - const: arm,realview-pb1176
32      - description: ARM RealView Platform Baseboard for ARM 11 MPCore
33          (HBI-0159, HBI-0175 and HBI-0176) was created to showcase
34          multiprocessing with ARM11 using MPCore using symmetric
35          multiprocessing (SMP). See ARM DUI 0351E.
36        items:
37          - const: arm,realview-pb11mp
38      - description: ARM RealView Platform Baseboard for Cortex-A8 (HBI-0178,
39          HBI-0176 and HBI-0175) was the first reference platform for the
40          Cortex CPU family, including a Cortex-A8 test chip.
41        items:
42          - const: arm,realview-pba8
43      - description: ARM RealView Platform Baseboard Explore for Cortex-A9
44          (HBI-0182 and HBI-0183) was the reference platform for the Cortex-A9
45          CPU.
46        items:
47          - const: arm,realview-pbx
48
49  soc:
50    description: All RealView boards must provide a soc node in the root of the
51      device tree, representing the System-on-Chip since these test chips are
52      rather complex.
53    type: object
54    properties:
55      compatible:
56        oneOf:
57          - items:
58            - const: arm,realview-eb-soc
59            - const: simple-bus
60          - items:
61            - const: arm,realview-pb1176-soc
62            - const: simple-bus
63          - items:
64            - const: arm,realview-pb11mp-soc
65            - const: simple-bus
66          - items:
67            - const: arm,realview-pba8-soc
68            - const: simple-bus
69          - items:
70            - const: arm,realview-pbx-soc
71            - const: simple-bus
72
73    patternProperties:
74      "^.*syscon@[0-9a-f]+$":
75        type: object
76        description: All RealView boards must provide a syscon system controller
77          node inside the soc node.
78        properties:
79          compatible:
80            oneOf:
81              - items:
82                - const: arm,realview-eb11mp-revb-syscon
83                - const: arm,realview-eb-syscon
84                - const: syscon
85                - const: simple-mfd
86              - items:
87                - const: arm,realview-eb11mp-revc-syscon
88                - const: arm,realview-eb-syscon
89                - const: syscon
90                - const: simple-mfd
91              - items:
92                - const: arm,realview-eb-syscon
93                - const: syscon
94                - const: simple-mfd
95              - items:
96                - const: arm,realview-pb1176-syscon
97                - const: syscon
98                - const: simple-mfd
99              - items:
100                - const: arm,realview-pb11mp-syscon
101                - const: syscon
102                - const: simple-mfd
103              - items:
104                - const: arm,realview-pba8-syscon
105                - const: syscon
106                - const: simple-mfd
107              - items:
108                - const: arm,realview-pbx-syscon
109                - const: syscon
110                - const: simple-mfd
111
112        required:
113          - compatible
114          - reg
115
116    required:
117      - compatible
118
119required:
120  - compatible
121  - soc
122
123...
124