1d524dac9SGrant Likely
2d524dac9SGrant LikelyNintendo GameCube device tree
3d524dac9SGrant Likely=============================
4d524dac9SGrant Likely
5d524dac9SGrant Likely1) The "flipper" node
6d524dac9SGrant Likely
7d524dac9SGrant Likely  This node represents the multi-function "Flipper" chip, which packages
8d524dac9SGrant Likely  many of the devices found in the Nintendo GameCube.
9d524dac9SGrant Likely
10d524dac9SGrant Likely  Required properties:
11d524dac9SGrant Likely
12d524dac9SGrant Likely   - compatible : Should be "nintendo,flipper"
13d524dac9SGrant Likely
14d524dac9SGrant Likely1.a) The Video Interface (VI) node
15d524dac9SGrant Likely
16d524dac9SGrant Likely  Represents the interface between the graphics processor and a external
17d524dac9SGrant Likely  video encoder.
18d524dac9SGrant Likely
19d524dac9SGrant Likely  Required properties:
20d524dac9SGrant Likely
21d524dac9SGrant Likely   - compatible : should be "nintendo,flipper-vi"
22d524dac9SGrant Likely   - reg : should contain the VI registers location and length
23d524dac9SGrant Likely   - interrupts : should contain the VI interrupt
24d524dac9SGrant Likely
25d524dac9SGrant Likely1.b) The Processor Interface (PI) node
26d524dac9SGrant Likely
27d524dac9SGrant Likely  Represents the data and control interface between the main processor
28d524dac9SGrant Likely  and graphics and audio processor.
29d524dac9SGrant Likely
30d524dac9SGrant Likely  Required properties:
31d524dac9SGrant Likely
32d524dac9SGrant Likely  - compatible : should be "nintendo,flipper-pi"
33d524dac9SGrant Likely  - reg : should contain the PI registers location and length
34d524dac9SGrant Likely
35d524dac9SGrant Likely1.b.i) The "Flipper" interrupt controller node
36d524dac9SGrant Likely
37d524dac9SGrant Likely  Represents the interrupt controller within the "Flipper" chip.
38d524dac9SGrant Likely  The node for the "Flipper" interrupt controller must be placed under
39d524dac9SGrant Likely  the PI node.
40d524dac9SGrant Likely
41d524dac9SGrant Likely  Required properties:
42d524dac9SGrant Likely
43d524dac9SGrant Likely  - compatible : should be "nintendo,flipper-pic"
44d524dac9SGrant Likely
45*47aab533SBjorn Helgaas1.c) The Digital Signal Processor (DSP) node
46d524dac9SGrant Likely
47d524dac9SGrant Likely  Represents the digital signal processor interface, designed to offload
48d524dac9SGrant Likely  audio related tasks.
49d524dac9SGrant Likely
50d524dac9SGrant Likely  Required properties:
51d524dac9SGrant Likely
52d524dac9SGrant Likely   - compatible : should be "nintendo,flipper-dsp"
53d524dac9SGrant Likely   - reg : should contain the DSP registers location and length
54d524dac9SGrant Likely   - interrupts : should contain the DSP interrupt
55d524dac9SGrant Likely
56d524dac9SGrant Likely1.c.i) The Auxiliary RAM (ARAM) node
57d524dac9SGrant Likely
58d524dac9SGrant Likely  Represents the non cpu-addressable ram designed mainly to store audio
59d524dac9SGrant Likely  related information.
60d524dac9SGrant Likely  The ARAM node must be placed under the DSP node.
61d524dac9SGrant Likely
62d524dac9SGrant Likely  Required properties:
63d524dac9SGrant Likely
64d524dac9SGrant Likely   - compatible : should be "nintendo,flipper-aram"
65d524dac9SGrant Likely   - reg : should contain the ARAM start (zero-based) and length
66d524dac9SGrant Likely
67d524dac9SGrant Likely1.d) The Disk Interface (DI) node
68d524dac9SGrant Likely
69d524dac9SGrant Likely  Represents the interface used to communicate with mass storage devices.
70d524dac9SGrant Likely
71d524dac9SGrant Likely  Required properties:
72d524dac9SGrant Likely
73d524dac9SGrant Likely   - compatible : should be "nintendo,flipper-di"
74d524dac9SGrant Likely   - reg : should contain the DI registers location and length
75d524dac9SGrant Likely   - interrupts : should contain the DI interrupt
76d524dac9SGrant Likely
77d524dac9SGrant Likely1.e) The Audio Interface (AI) node
78d524dac9SGrant Likely
79d524dac9SGrant Likely  Represents the interface to the external 16-bit stereo digital-to-analog
80d524dac9SGrant Likely  converter.
81d524dac9SGrant Likely
82d524dac9SGrant Likely  Required properties:
83d524dac9SGrant Likely
84d524dac9SGrant Likely   - compatible : should be "nintendo,flipper-ai"
85d524dac9SGrant Likely   - reg : should contain the AI registers location and length
86d524dac9SGrant Likely   - interrupts : should contain the AI interrupt
87d524dac9SGrant Likely
88d524dac9SGrant Likely1.f) The Serial Interface (SI) node
89d524dac9SGrant Likely
90d524dac9SGrant Likely  Represents the interface to the four single bit serial interfaces.
91d524dac9SGrant Likely  The SI is a proprietary serial interface used normally to control gamepads.
92d524dac9SGrant Likely  It's NOT a RS232-type interface.
93d524dac9SGrant Likely
94d524dac9SGrant Likely  Required properties:
95d524dac9SGrant Likely
96d524dac9SGrant Likely   - compatible : should be "nintendo,flipper-si"
97d524dac9SGrant Likely   - reg : should contain the SI registers location and length
98d524dac9SGrant Likely   - interrupts : should contain the SI interrupt
99d524dac9SGrant Likely
100d524dac9SGrant Likely1.g) The External Interface (EXI) node
101d524dac9SGrant Likely
102d524dac9SGrant Likely  Represents the multi-channel SPI-like interface.
103d524dac9SGrant Likely
104d524dac9SGrant Likely  Required properties:
105d524dac9SGrant Likely
106d524dac9SGrant Likely   - compatible : should be "nintendo,flipper-exi"
107d524dac9SGrant Likely   - reg : should contain the EXI registers location and length
108d524dac9SGrant Likely   - interrupts : should contain the EXI interrupt
109d524dac9SGrant Likely
110