Tom Rini | 53633a8 | 2024-02-29 12:33:36 -0500 | [diff] [blame] | 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 | |