Linux 6.7-rc7
[linux-modified.git] / Documentation / devicetree / bindings / powerpc / nintendo / wii.txt
1
2 Nintendo Wii device tree
3 ========================
4
5 0) The root node
6
7   This node represents the Nintendo Wii video game console.
8
9   Required properties:
10
11    - model : Should be "nintendo,wii"
12    - compatible : Should be "nintendo,wii"
13
14 1) The "hollywood" node
15
16   This node represents the multi-function "Hollywood" chip, which packages
17   many of the devices found in the Nintendo Wii.
18
19   Required properties:
20
21    - compatible : Should be "nintendo,hollywood"
22
23 1.a) The Video Interface (VI) node
24
25   Represents the interface between the graphics processor and a external
26   video encoder.
27
28   Required properties:
29
30    - compatible : should be "nintendo,hollywood-vi","nintendo,flipper-vi"
31    - reg : should contain the VI registers location and length
32    - interrupts : should contain the VI interrupt
33
34 1.b) The Processor Interface (PI) node
35
36   Represents the data and control interface between the main processor
37   and graphics and audio processor.
38
39   Required properties:
40
41   - compatible : should be "nintendo,hollywood-pi","nintendo,flipper-pi"
42   - reg : should contain the PI registers location and length
43
44 1.b.i) The "Flipper" interrupt controller node
45
46   Represents the "Flipper" interrupt controller within the "Hollywood" chip.
47   The node for the "Flipper" interrupt controller must be placed under
48   the PI node.
49
50   Required properties:
51
52   - #interrupt-cells : <1>
53   - compatible : should be "nintendo,flipper-pic"
54   - interrupt-controller
55
56 1.c) The Digital Signal Processor (DSP) node
57
58   Represents the digital signal processor interface, designed to offload
59   audio related tasks.
60
61   Required properties:
62
63    - compatible : should be "nintendo,hollywood-dsp","nintendo,flipper-dsp"
64    - reg : should contain the DSP registers location and length
65    - interrupts : should contain the DSP interrupt
66
67 1.d) The Serial Interface (SI) node
68
69   Represents the interface to the four single bit serial interfaces.
70   The SI is a proprietary serial interface used normally to control gamepads.
71   It's NOT a RS232-type interface.
72
73   Required properties:
74
75    - compatible : should be "nintendo,hollywood-si","nintendo,flipper-si"
76    - reg : should contain the SI registers location and length
77    - interrupts : should contain the SI interrupt
78
79 1.e) The Audio Interface (AI) node
80
81   Represents the interface to the external 16-bit stereo digital-to-analog
82   converter.
83
84   Required properties:
85
86    - compatible : should be "nintendo,hollywood-ai","nintendo,flipper-ai"
87    - reg : should contain the AI registers location and length
88    - interrupts : should contain the AI interrupt
89
90 1.f) The External Interface (EXI) node
91
92   Represents the multi-channel SPI-like interface.
93
94   Required properties:
95
96    - compatible : should be "nintendo,hollywood-exi","nintendo,flipper-exi"
97    - reg : should contain the EXI registers location and length
98    - interrupts : should contain the EXI interrupt
99
100 1.h) The Enhanced Host Controller Interface (EHCI) node
101
102   Represents the USB 2.0 Enhanced Host Controller Interface.
103
104   Required properties:
105
106    - compatible : should be "nintendo,hollywood-usb-ehci","usb-ehci"
107    - reg : should contain the EHCI registers location and length
108    - interrupts : should contain the EHCI interrupt
109
110 1.i) The Secure Digital Host Controller Interface (SDHCI) nodes
111
112   Represent the Secure Digital Host Controller Interfaces.
113
114   Required properties:
115
116    - compatible : should be "nintendo,hollywood-sdhci","sdhci"
117    - reg : should contain the SDHCI registers location and length
118    - interrupts : should contain the SDHCI interrupt
119
120 1.j) The Inter-Processor Communication (IPC) node
121
122   Represent the Inter-Processor Communication interface. This interface
123   enables communications between the Broadway and the Starlet processors.
124
125    - compatible : should be "nintendo,hollywood-ipc"
126    - reg : should contain the IPC registers location and length
127    - interrupts : should contain the IPC interrupt
128
129 1.k) The "Hollywood" interrupt controller node
130
131   Represents the "Hollywood" interrupt controller within the
132   "Hollywood" chip.
133
134   Required properties:
135
136   - #interrupt-cells : <1>
137   - compatible : should be "nintendo,hollywood-pic"
138   - reg : should contain the controller registers location and length
139   - interrupt-controller
140   - interrupts : should contain the cascade interrupt of the "flipper" pic
141
142 1.l) The General Purpose I/O (GPIO) controller node
143
144   see Documentation/devicetree/bindings/gpio/nintendo,hollywood-gpio.txt
145
146 1.m) The control node
147
148   Represents the control interface used to setup several miscellaneous
149   settings of the "Hollywood" chip like boot memory mappings, resets,
150   disk interface mode, etc.
151
152   Required properties:
153
154    - compatible : should be "nintendo,hollywood-control"
155    - reg : should contain the control registers location and length
156
157 1.n) The Disk Interface (DI) node
158
159   Represents the interface used to communicate with mass storage devices.
160
161   Required properties:
162
163    - compatible : should be "nintendo,hollywood-di"
164    - reg : should contain the DI registers location and length
165    - interrupts : should contain the DI interrupt
166