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