Documentation/devicetree/bindings/arm/arm-boards

   1 ARM Integrator/AP (Application Platform) and Integrator/CP (Compact Platform)
   2 -----------------------------------------------------------------------------
   3 ARM's oldest Linux-supported platform with connectors for different core
   4 tiles of ARMv4, ARMv5 and ARMv6 type.
   5
   6 Required properties (in root node):
   7         compatible = "arm,integrator-ap";  /* Application Platform */
   8         compatible = "arm,integrator-cp";  /* Compact Platform */
   9
  10 FPGA type interrupt controllers, see the versatile-fpga-irq binding doc.
  11
  12 Required nodes:
  13
  14 - core-module: the root node to the Integrator platforms must have
  15   a core-module with regs and the compatible string
  16   "arm,core-module-integrator"
  17 - external-bus-interface: the root node to the Integrator platforms
  18   must have an external bus interface with regs and the
  19   compatible-string "arm,external-bus-interface"
  20
  21   Required properties for the core module:
  22   - regs: the location and size of the core module registers, one
  23     range of 0x200 bytes.
  24
  25 - syscon: the root node of the Integrator platforms must have a
  26   system controller node pointing to the control registers,
  27   with the compatible string
  28   "arm,integrator-ap-syscon"
  29   "arm,integrator-cp-syscon"
  30   respectively.
  31
  32   Required properties for the system controller:
  33   - regs: the location and size of the system controller registers,
  34     one range of 0x100 bytes.
  35
  36   Required properties for the AP system controller:
  37   - interrupts: the AP syscon node must include the logical module
  38     interrupts, stated in order of module instance <module 0>,
  39     <module 1>, <module 2> ... for the CP system controller this
  40     is not required not of any use.
  41
  42 /dts-v1/;
  43 /include/ "integrator.dtsi"
  44
  45 / {
  46         model = "ARM Integrator/AP";
  47         compatible = "arm,integrator-ap";
  48
  49         core-module@10000000 {
  50                 compatible = "arm,core-module-integrator";
  51                 reg = <0x10000000 0x200>;
  52         };
  53
  54         ebi@12000000 {
  55                 compatible = "arm,external-bus-interface";
  56                 reg = <0x12000000 0x100>;
  57         };
  58
  59         syscon {
  60                 compatible = "arm,integrator-ap-syscon";
  61                 reg = <0x11000000 0x100>;
  62                 interrupt-parent = <&pic>;
  63                 /* These are the logic module IRQs */
  64                 interrupts = <9>, <10>, <11>, <12>;
  65         };
  66 };
  67
  68
  69 ARM Versatile Application and Platform Baseboards
  70 -------------------------------------------------
  71 ARM's development hardware platform with connectors for customizable
  72 core tiles.  The hardware configuration of the Versatile boards is
  73 highly customizable.
  74
  75 Required properties (in root node):
  76         compatible = "arm,versatile-ab";  /* Application baseboard */
  77         compatible = "arm,versatile-pb";  /* Platform baseboard */
  78
  79 Interrupt controllers:
  80 - VIC required properties:
  81         compatible = "arm,versatile-vic";
  82         interrupt-controller;
  83         #interrupt-cells = <1>;
  84
  85 - SIC required properties:
  86         compatible = "arm,versatile-sic";
  87         interrupt-controller;
  88         #interrupt-cells = <1>;
  89
  90 Required nodes:
  91
  92 - core-module: the root node to the Versatile platforms must have
  93   a core-module with regs and the compatible strings
  94   "arm,core-module-versatile", "syscon"
  95
  96 ARM RealView Boards
  97 -------------------
  98 The RealView boards cover tailored evaluation boards that are used to explore
  99 the ARM11 and Cortex A-8 and Cortex A-9 processors.
 100
 101 Required properties (in root node):
 102         /* RealView Emulation Baseboard */
 103         compatible = "arm,realview-eb";
 104          /* RealView Platform Baseboard for ARM1176JZF-S */
 105         compatible = "arm,realview-pb1176";
 106         /* RealView Platform Baseboard for ARM11 MPCore */
 107         compatible = "arm,realview-pb11mp";
 108         /* RealView Platform Baseboard for Cortex A-8 */
 109         compatible = "arm,realview-pba8";
 110         /* RealView Platform Baseboard Explore for Cortex A-9 */
 111         compatible = "arm,realview-pbx";
 112
 113 Required nodes:
 114
 115 - soc: some node of the RealView platforms must be the SoC
 116   node that contain the SoC-specific devices, withe the compatible
 117   string set to one of these tuples:
 118    "arm,realview-eb-soc", "simple-bus"
 119    "arm,realview-pb1176-soc", "simple-bus"
 120    "arm,realview-pb11mp-soc", "simple-bus"
 121    "arm,realview-pba8-soc", "simple-bus"
 122    "arm,realview-pbx-soc", "simple-bus"
 123
 124 - syscon: some subnode of the RealView SoC node must be a
 125   system controller node pointing to the control registers,
 126   with the compatible string set to one of these tuples:
 127    "arm,realview-eb-syscon", "syscon"
 128    "arm,realview-pb1176-syscon", "syscon"
 129    "arm,realview-pb11mp-syscon", "syscon"
 130    "arm,realview-pba8-syscon", "syscon"
 131    "arm,realview-pbx-syscon", "syscon"
 132
 133   Required properties for the system controller:
 134   - regs: the location and size of the system controller registers,
 135     one range of 0x1000 bytes.
 136
 137 Example:
 138
 139 /dts-v1/;
 140 #include <dt-bindings/interrupt-controller/irq.h>
 141 #include "skeleton.dtsi"
 142
 143 / {
 144         model = "ARM RealView PB1176 with device tree";
 145         compatible = "arm,realview-pb1176";
 146
 147         soc {
 148                 #address-cells = <1>;
 149                 #size-cells = <1>;
 150                 compatible = "arm,realview-pb1176-soc", "simple-bus";
 151                 ranges;
 152
 153                 syscon: syscon@10000000 {
 154                         compatible = "arm,realview-syscon", "syscon";
 155                         reg = <0x10000000 0x1000>;
 156                 };
 157
 158         };
 159 };