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