← Documents Documentation/devicetree/bindings/powerpc/nintendo/wii.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Nintendo Wii

Wii Hollywood chip과 Flipper-compatible peripheral, USB·SD·IPC binding입니다.

Source pathDocumentation/devicetree/bindings/powerpc/nintendo/wii.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

wii.txt:1-162

GameCube 호환 interface와 Wii 전용 EHCI·SDHCI·IPC·Hollywood PIC·control node를 구분합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
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.m) The control node
143
144 Represents the control interface used to setup several miscellaneous
145 settings of the "Hollywood" chip like boot memory mappings, resets,
146 disk interface mode, etc.
147
148 Required properties:
149
150 - compatible : should be "nintendo,hollywood-control"
151 - reg : should contain the control registers location and length
152
153 1.n) The Disk Interface (DI) node
154
155 Represents the interface used to communicate with mass storage devices.
156
157 Required properties:
158
159 - compatible : should be "nintendo,hollywood-di"
160 - reg : should contain the DI registers location and length
161 - interrupts : should contain the DI interrupt
162
163

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Wii root와 Hollywood

1-22

Root node는 Nintendo Wii console을 나타내며 필수 `model`과 `compatible`은 모두 `nintendo,wii`입니다. Multi-function Hollywood chip node는 Wii의 여러 device를 포함하고 필수 `compatible`은 `nintendo,hollywood`입니다.

VI·PI·Flipper PIC

23-55

VI는 graphics processor와 외부 video encoder를 연결하며 `nintendo,hollywood-vi`, `nintendo,flipper-vi` compatible, register 범위와 interrupt를 가집니다. PI는 processor 사이 data·control interface이며 `nintendo,hollywood-pi`, `nintendo,flipper-pi` compatible과 register 범위를 가집니다.

Hollywood 내부 Flipper interrupt controller는 PI 아래에 배치하며 `#interrupt-cells = <1>`, `nintendo,flipper-pic`, 빈 `interrupt-controller` property가 필요합니다.

DSP·SI·AI·EXI

56-99

DSP는 audio offload용이며 `nintendo,hollywood-dsp`, `nintendo,flipper-dsp` compatible, register 범위와 interrupt를 사용합니다. SI는 RS232가 아닌 gamepad용 proprietary serial interface이며 `nintendo,hollywood-si`, `nintendo,flipper-si` compatible을 사용합니다.

AI는 외부 16-bit stereo DAC interface이며 `nintendo,hollywood-ai`, `nintendo,flipper-ai` compatible을 사용합니다. EXI는 multi-channel SPI-like interface이며 `nintendo,hollywood-exi`, `nintendo,flipper-exi` compatible을 사용합니다. 두 node 모두 해당 register 범위와 interrupt가 필요합니다.

EHCI·SDHCI·IPC·Hollywood PIC

100-141

USB 2.0 EHCI node는 `nintendo,hollywood-usb-ehci`, `usb-ehci` compatible을, SDHCI node는 `nintendo,hollywood-sdhci`, `sdhci` compatible을 사용하며 register 범위와 interrupt가 필요합니다.

IPC는 Broadway와 Starlet processor 사이 통신 interface이며 `nintendo,hollywood-ipc`, register 범위와 interrupt를 사용합니다.

Hollywood PIC는 `#interrupt-cells = <1>`, `nintendo,hollywood-pic`, register 범위, 빈 `interrupt-controller`와 Flipper PIC의 cascade interrupt가 필요합니다.

Hollywood control과 Disk Interface

142-162

Control node는 boot memory mapping, reset, disk-interface mode 등 Hollywood의 miscellaneous setting을 구성하며 `nintendo,hollywood-control` compatible과 register 범위를 가집니다.

DI는 mass-storage 통신용이며 `nintendo,hollywood-di` compatible, DI register 범위와 interrupt가 필요합니다.