Merge ath-next from git://git.kernel.org/pub/scm/linux/kernel/git/kvalo/ath.git
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / arm / gemini.txt
1 Cortina systems Gemini platforms
2
3 The Gemini SoC is the project name for an ARMv4 FA525-based SoC originally
4 produced by Storlink Semiconductor around 2005. The company was renamed
5 later renamed Storm Semiconductor. The chip product name is Storlink SL3516.
6 It was derived from earlier products from Storm named SL3316 (Centroid) and
7 SL3512 (Bulverde).
8
9 Storm Semiconductor was acquired by Cortina Systems in 2008 and the SoC was
10 produced and used for NAS and similar usecases. In 2014 Cortina Systems was
11 in turn acquired by Inphi, who seem to have discontinued this product family.
12
13 Many of the IP blocks used in the SoC comes from Faraday Technology.
14
15 Required properties (in root node):
16         compatible = "cortina,gemini";
17
18 Required nodes:
19
20 - soc: the SoC should be represented by a simple bus encompassing all the
21   onchip devices, this is referred to as the soc bus node.
22
23 - syscon: the soc bus node must have a system controller node pointing to the
24   global control registers, with the compatible string
25   "cortina,gemini-syscon", "syscon";
26
27 - timer: the soc bus node must have a timer node pointing to the SoC timer
28   block, with the compatible string "cortina,gemini-timer"
29   See: clocksource/cortina,gemini-timer.txt
30
31 - interrupt-controller: the sob bus node must have an interrupt controller
32   node pointing to the SoC interrupt controller block, with the compatible
33   string "cortina,gemini-interrupt-controller"
34   See interrupt-controller/cortina,gemini-interrupt-controller.txt
35
36 Example:
37
38 / {
39         model = "Foo Gemini Machine";
40         compatible = "cortina,gemini";
41         #address-cells = <1>;
42         #size-cells = <1>;
43
44         memory {
45                 device_type = "memory";
46                 reg = <0x00000000 0x8000000>;
47         };
48
49         soc {
50                 #address-cells = <1>;
51                 #size-cells = <1>;
52                 ranges;
53                 compatible = "simple-bus";
54                 interrupt-parent = <&intcon>;
55
56                 syscon: syscon@40000000 {
57                         compatible = "cortina,gemini-syscon", "syscon";
58                         reg = <0x40000000 0x1000>;
59                 };
60
61                 uart0: serial@42000000 {
62                         compatible = "ns16550a";
63                         reg = <0x42000000 0x100>;
64                         clock-frequency = <48000000>;
65                         interrupts = <18 IRQ_TYPE_LEVEL_HIGH>;
66                         reg-shift = <2>;
67                 };
68
69                 timer@43000000 {
70                         compatible = "cortina,gemini-timer";
71                         reg = <0x43000000 0x1000>;
72                         interrupt-parent = <&intcon>;
73                         interrupts = <14 IRQ_TYPE_EDGE_FALLING>, /* Timer 1 */
74                                      <15 IRQ_TYPE_EDGE_FALLING>, /* Timer 2 */
75                                      <16 IRQ_TYPE_EDGE_FALLING>; /* Timer 3 */
76                         syscon = <&syscon>;
77                 };
78
79                 intcon: interrupt-controller@48000000 {
80                         compatible = "cortina,gemini-interrupt-controller";
81                         reg = <0x48000000 0x1000>;
82                         interrupt-controller;
83                         #interrupt-cells = <2>;
84                 };
85         };
86 };