xref: /freebsd/sys/contrib/device-tree/Bindings/arm/arm,realview.yaml (revision 5d6d6278979b9eab598a23c804d23e930d2f7268) 
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
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
79    required:
80      - compatible
81
82required:
83  - compatible
84  - soc
85
86additionalProperties: true
87
88...
89