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,versatile.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: ARM Versatile Boards Device Tree Bindings
8
9maintainers:
10  - Linus Walleij <linus.walleij@linaro.org>
11
12description: |+
13  The ARM Versatile boards are two variants of ARM926EJ-S evaluation boards
14  with various pluggable interface boards, in essence the Versatile PB version
15  is a superset of the Versatile AB version.
16
17properties:
18  $nodename:
19    const: '/'
20  compatible:
21    oneOf:
22      - description: The ARM Versatile Application Baseboard (HBI-0118) is an
23          evaluation board specifically for the ARM926EJ-S. It can be connected
24          to an IB1 interface board for a touchscreen-type use case or an IB2
25          for a candybar phone-type use case. See ARM DUI 0225D.
26        items:
27          - const: arm,versatile-ab
28      - description: The ARM Versatile Platform Baseboard (HBI-0117) is an
29          extension of the Versatile Application Baseboard that includes a
30          PCI host controller. Like the sibling board, it is done specifically
31          for ARM926EJ-S. See ARM DUI 0224B.
32        items:
33          - const: arm,versatile-pb
34
35  core-module@10000000:
36    type: object
37    description: the root node in the Versatile platforms must contain
38      a core module child node. They are always at physical address
39      0x10000000 in all the Versatile variants.
40    properties:
41      compatible:
42        items:
43          - const: arm,core-module-versatile
44          - const: syscon
45          - const: simple-mfd
46      reg:
47        maxItems: 1
48
49    required:
50      - compatible
51      - reg
52
53patternProperties:
54  "^syscon@[0-9a-f]+$":
55    type: object
56    description: When fitted with the IB2 Interface Board, the Versatile
57      AB will present an optional system controller node which controls the
58      extra peripherals on the interface board.
59    properties:
60      compatible:
61        contains:
62          const: arm,versatile-ib2-syscon
63    required:
64      - compatible
65      - reg
66
67required:
68  - compatible
69  - core-module@10000000
70
71...
72