About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / devicetree / bindings / arm / arm-boards




Custom Search

Based on kernel version 4.13.3. Page generated on 2017-09-23 13:54 EST.

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	Optional nodes:
97	
98	- arm,versatile-ib2-syscon : if the Versatile has an IB2 interface
99	  board mounted, this has a separate system controller that is
100	  defined in this node.
101	  Required properties:
102	  compatible = "arm,versatile-ib2-syscon", "syscon"
103	
104	ARM RealView Boards
105	-------------------
106	The RealView boards cover tailored evaluation boards that are used to explore
107	the ARM11 and Cortex A-8 and Cortex A-9 processors.
108	
109	Required properties (in root node):
110		/* RealView Emulation Baseboard */
111		compatible = "arm,realview-eb";
112		 /* RealView Platform Baseboard for ARM1176JZF-S */
113		compatible = "arm,realview-pb1176";
114		/* RealView Platform Baseboard for ARM11 MPCore */
115		compatible = "arm,realview-pb11mp";
116		/* RealView Platform Baseboard for Cortex A-8 */
117		compatible = "arm,realview-pba8";
118		/* RealView Platform Baseboard Explore for Cortex A-9 */
119		compatible = "arm,realview-pbx";
120	
121	Required nodes:
122	
123	- soc: some node of the RealView platforms must be the SoC
124	  node that contain the SoC-specific devices, withe the compatible
125	  string set to one of these tuples:
126	   "arm,realview-eb-soc", "simple-bus"
127	   "arm,realview-pb1176-soc", "simple-bus"
128	   "arm,realview-pb11mp-soc", "simple-bus"
129	   "arm,realview-pba8-soc", "simple-bus"
130	   "arm,realview-pbx-soc", "simple-bus"
131	
132	- syscon: some subnode of the RealView SoC node must be a
133	  system controller node pointing to the control registers,
134	  with the compatible string set to one of these:
135	   "arm,realview-eb11mp-revb-syscon", "arm,realview-eb-syscon", "syscon"
136	   "arm,realview-eb11mp-revc-syscon", "arm,realview-eb-syscon", "syscon"
137	   "arm,realview-eb-syscon", "syscon"
138	   "arm,realview-pb1176-syscon", "syscon"
139	   "arm,realview-pb11mp-syscon", "syscon"
140	   "arm,realview-pba8-syscon", "syscon"
141	   "arm,realview-pbx-syscon", "syscon"
142	
143	  Required properties for the system controller:
144	  - regs: the location and size of the system controller registers,
145	    one range of 0x1000 bytes.
146	
147	Example:
148	
149	/dts-v1/;
150	#include <dt-bindings/interrupt-controller/irq.h>
151	
152	/ {
153		model = "ARM RealView PB1176 with device tree";
154		compatible = "arm,realview-pb1176";
155		#address-cells = <1>;
156		#size-cells = <1>;
157	
158		soc {
159			#address-cells = <1>;
160			#size-cells = <1>;
161			compatible = "arm,realview-pb1176-soc", "simple-bus";
162			ranges;
163	
164			syscon: syscon@10000000 {
165				compatible = "arm,realview-syscon", "syscon";
166				reg = <0x10000000 0x1000>;
167			};
168	
169		};
170	};
171	
172	ARM Versatile Express Boards
173	-----------------------------
174	For details on the device tree bindings for ARM Versatile Express boards
175	please consult the vexpress.txt file in the same directory as this file.
176	
177	ARM Juno Boards
178	----------------
179	The Juno boards are targeting development for AArch64 systems. The first
180	iteration, Juno r0, is a vehicle for evaluating big.LITTLE on AArch64,
181	with the second iteration, Juno r1, mainly aimed at development of PCIe
182	based systems. Juno r1 also has support for AXI masters placed on the TLX
183	connectors to join the coherency domain.
184	
185	Juno boards are described in a similar way to ARM Versatile Express boards,
186	with the motherboard part of the hardware being described in a separate file
187	to highlight the fact that is part of the support infrastructure for the SoC.
188	Juno device tree bindings also share the Versatile Express bindings as
189	described under the RS1 memory mapping.
190	
191	Required properties (in root node):
192		compatible = "arm,juno";	/* For Juno r0 board */
193		compatible = "arm,juno-r1";	/* For Juno r1 board */
194		compatible = "arm,juno-r2";	/* For Juno r2 board */
195	
196	Required nodes:
197	The description for the board must include:
198	   - a "psci" node describing the boot method used for the secondary CPUs.
199	     A detailed description of the bindings used for "psci" nodes is present
200	     in the psci.txt file.
201	   - a "cpus" node describing the available cores and their associated
202	     "enable-method"s. For more details see cpus.txt file.
203	
204	Example:
205	
206	/dts-v1/;
207	/ {
208		model = "ARM Juno development board (r0)";
209		compatible = "arm,juno", "arm,vexpress";
210		interrupt-parent = <&gic>;
211		#address-cells = <2>;
212		#size-cells = <2>;
213	
214		cpus {
215			#address-cells = <2>;
216			#size-cells = <0>;
217	
218			A57_0: cpu@0 {
219				compatible = "arm,cortex-a57","arm,armv8";
220				reg = <0x0 0x0>;
221				device_type = "cpu";
222				enable-method = "psci";
223			};
224	
225			.....
226	
227			A53_0: cpu@100 {
228				compatible = "arm,cortex-a53","arm,armv8";
229				reg = <0x0 0x100>;
230				device_type = "cpu";
231				enable-method = "psci";
232			};
233	
234			.....
235		};
236	
237	};
Hide Line Numbers
About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Information is copyright its respective author. All material is available from the Linux Kernel Source distributed under a GPL License. This page is provided as a free service by mjmwired.net.