diff options
author | Linus Torvalds <torvalds@linux-foundation.org> | 2009-02-02 22:26:44 -0500 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2009-02-02 22:26:44 -0500 |
commit | 93bfbd71db4d2e01c05e219f285249a74808b1d4 (patch) | |
tree | 43f38899aaa2af9169146b6523d094be299ccc60 /Documentation | |
parent | 31c952dcf83d5b0fd57b514cbe8a1664647c26e7 (diff) | |
parent | 7fbb7cadd062baf299fd8b26a80ea99da0c3fe01 (diff) |
Merge branch 'merge' of git://git.kernel.org/pub/scm/linux/kernel/git/benh/powerpc
* 'merge' of git://git.kernel.org/pub/scm/linux/kernel/git/benh/powerpc:
fbdev/atyfb: Fix DSP config on some PowerMacs & PowerBooks
powerpc: Fix oops on some machines due to incorrect pr_debug()
powerpc/ps3: Printing fixups for l64 to ll64 convserion drivers/net
powerpc/5200: update device tree binding documentation
powerpc/5200: Bugfix for PCI mapping of memory and IMMR
powerpc/5200: update defconfigs
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/powerpc/dts-bindings/fsl/mpc5200.txt | 180 | ||||
-rw-r--r-- | Documentation/powerpc/mpc52xx-device-tree-bindings.txt | 277 |
2 files changed, 180 insertions, 277 deletions
diff --git a/Documentation/powerpc/dts-bindings/fsl/mpc5200.txt b/Documentation/powerpc/dts-bindings/fsl/mpc5200.txt new file mode 100644 index 000000000000..8447fd7090d0 --- /dev/null +++ b/Documentation/powerpc/dts-bindings/fsl/mpc5200.txt | |||
@@ -0,0 +1,180 @@ | |||
1 | MPC5200 Device Tree Bindings | ||
2 | ---------------------------- | ||
3 | |||
4 | (c) 2006-2009 Secret Lab Technologies Ltd | ||
5 | Grant Likely <grant.likely@secretlab.ca> | ||
6 | |||
7 | Naming conventions | ||
8 | ------------------ | ||
9 | For mpc5200 on-chip devices, the format for each compatible value is | ||
10 | <chip>-<device>[-<mode>]. The OS should be able to match a device driver | ||
11 | to the device based solely on the compatible value. If two drivers | ||
12 | match on the compatible list; the 'most compatible' driver should be | ||
13 | selected. | ||
14 | |||
15 | The split between the MPC5200 and the MPC5200B leaves a bit of a | ||
16 | conundrum. How should the compatible property be set up to provide | ||
17 | maximum compatibility information; but still accurately describe the | ||
18 | chip? For the MPC5200; the answer is easy. Most of the SoC devices | ||
19 | originally appeared on the MPC5200. Since they didn't exist anywhere | ||
20 | else; the 5200 compatible properties will contain only one item; | ||
21 | "fsl,mpc5200-<device>". | ||
22 | |||
23 | The 5200B is almost the same as the 5200, but not quite. It fixes | ||
24 | silicon bugs and it adds a small number of enhancements. Most of the | ||
25 | devices either provide exactly the same interface as on the 5200. A few | ||
26 | devices have extra functions but still have a backwards compatible mode. | ||
27 | To express this information as completely as possible, 5200B device trees | ||
28 | should have two items in the compatible list: | ||
29 | compatible = "fsl,mpc5200b-<device>","fsl,mpc5200-<device>"; | ||
30 | |||
31 | It is *strongly* recommended that 5200B device trees follow this convention | ||
32 | (instead of only listing the base mpc5200 item). | ||
33 | |||
34 | ie. ethernet on mpc5200: compatible = "fsl,mpc5200-fec"; | ||
35 | ethernet on mpc5200b: compatible = "fsl,mpc5200b-fec", "fsl,mpc5200-fec"; | ||
36 | |||
37 | Modal devices, like PSCs, also append the configured function to the | ||
38 | end of the compatible field. ie. A PSC in i2s mode would specify | ||
39 | "fsl,mpc5200-psc-i2s", not "fsl,mpc5200-i2s". This convention is chosen to | ||
40 | avoid naming conflicts with non-psc devices providing the same | ||
41 | function. For example, "fsl,mpc5200-spi" and "fsl,mpc5200-psc-spi" describe | ||
42 | the mpc5200 simple spi device and a PSC spi mode respectively. | ||
43 | |||
44 | At the time of writing, exact chip may be either 'fsl,mpc5200' or | ||
45 | 'fsl,mpc5200b'. | ||
46 | |||
47 | The soc node | ||
48 | ------------ | ||
49 | This node describes the on chip SOC peripherals. Every mpc5200 based | ||
50 | board will have this node, and as such there is a common naming | ||
51 | convention for SOC devices. | ||
52 | |||
53 | Required properties: | ||
54 | name description | ||
55 | ---- ----------- | ||
56 | ranges Memory range of the internal memory mapped registers. | ||
57 | Should be <0 [baseaddr] 0xc000> | ||
58 | reg Should be <[baseaddr] 0x100> | ||
59 | compatible mpc5200: "fsl,mpc5200-immr" | ||
60 | mpc5200b: "fsl,mpc5200b-immr" | ||
61 | system-frequency 'fsystem' frequency in Hz; XLB, IPB, USB and PCI | ||
62 | clocks are derived from the fsystem clock. | ||
63 | bus-frequency IPB bus frequency in Hz. Clock rate | ||
64 | used by most of the soc devices. | ||
65 | |||
66 | soc child nodes | ||
67 | --------------- | ||
68 | Any on chip SOC devices available to Linux must appear as soc5200 child nodes. | ||
69 | |||
70 | Note: The tables below show the value for the mpc5200. A mpc5200b device | ||
71 | tree should use the "fsl,mpc5200b-<device>","fsl,mpc5200-<device>" form. | ||
72 | |||
73 | Required soc5200 child nodes: | ||
74 | name compatible Description | ||
75 | ---- ---------- ----------- | ||
76 | cdm@<addr> fsl,mpc5200-cdm Clock Distribution | ||
77 | interrupt-controller@<addr> fsl,mpc5200-pic need an interrupt | ||
78 | controller to boot | ||
79 | bestcomm@<addr> fsl,mpc5200-bestcomm Bestcomm DMA controller | ||
80 | |||
81 | Recommended soc5200 child nodes; populate as needed for your board | ||
82 | name compatible Description | ||
83 | ---- ---------- ----------- | ||
84 | timer@<addr> fsl,mpc5200-gpt General purpose timers | ||
85 | gpio@<addr> fsl,mpc5200-gpio MPC5200 simple gpio controller | ||
86 | gpio@<addr> fsl,mpc5200-gpio-wkup MPC5200 wakeup gpio controller | ||
87 | rtc@<addr> fsl,mpc5200-rtc Real time clock | ||
88 | mscan@<addr> fsl,mpc5200-mscan CAN bus controller | ||
89 | pci@<addr> fsl,mpc5200-pci PCI bridge | ||
90 | serial@<addr> fsl,mpc5200-psc-uart PSC in serial mode | ||
91 | i2s@<addr> fsl,mpc5200-psc-i2s PSC in i2s mode | ||
92 | ac97@<addr> fsl,mpc5200-psc-ac97 PSC in ac97 mode | ||
93 | spi@<addr> fsl,mpc5200-psc-spi PSC in spi mode | ||
94 | irda@<addr> fsl,mpc5200-psc-irda PSC in IrDA mode | ||
95 | spi@<addr> fsl,mpc5200-spi MPC5200 spi device | ||
96 | ethernet@<addr> fsl,mpc5200-fec MPC5200 ethernet device | ||
97 | ata@<addr> fsl,mpc5200-ata IDE ATA interface | ||
98 | i2c@<addr> fsl,mpc5200-i2c I2C controller | ||
99 | usb@<addr> fsl,mpc5200-ohci,ohci-be USB controller | ||
100 | xlb@<addr> fsl,mpc5200-xlb XLB arbitrator | ||
101 | |||
102 | fsl,mpc5200-gpt nodes | ||
103 | --------------------- | ||
104 | On the mpc5200 and 5200b, GPT0 has a watchdog timer function. If the board | ||
105 | design supports the internal wdt, then the device node for GPT0 should | ||
106 | include the empty property 'fsl,has-wdt'. | ||
107 | |||
108 | An mpc5200-gpt can be used as a single line GPIO controller. To do so, | ||
109 | add the following properties to the gpt node: | ||
110 | gpio-controller; | ||
111 | #gpio-cells = <2>; | ||
112 | When referencing the GPIO line from another node, the first cell must always | ||
113 | be zero and the second cell represents the gpio flags and described in the | ||
114 | gpio device tree binding. | ||
115 | |||
116 | An mpc5200-gpt can be used as a single line edge sensitive interrupt | ||
117 | controller. To do so, add the following properties to the gpt node: | ||
118 | interrupt-controller; | ||
119 | #interrupt-cells = <1>; | ||
120 | When referencing the IRQ line from another node, the cell represents the | ||
121 | sense mode; 1 for edge rising, 2 for edge falling. | ||
122 | |||
123 | fsl,mpc5200-psc nodes | ||
124 | --------------------- | ||
125 | The PSCs should include a cell-index which is the index of the PSC in | ||
126 | hardware. cell-index is used to determine which shared SoC registers to | ||
127 | use when setting up PSC clocking. cell-index number starts at '0'. ie: | ||
128 | PSC1 has 'cell-index = <0>' | ||
129 | PSC4 has 'cell-index = <3>' | ||
130 | |||
131 | PSC in i2s mode: The mpc5200 and mpc5200b PSCs are not compatible when in | ||
132 | i2s mode. An 'mpc5200b-psc-i2s' node cannot include 'mpc5200-psc-i2s' in the | ||
133 | compatible field. | ||
134 | |||
135 | |||
136 | fsl,mpc5200-gpio and fsl,mpc5200-gpio-wkup nodes | ||
137 | ------------------------------------------------ | ||
138 | Each GPIO controller node should have the empty property gpio-controller and | ||
139 | #gpio-cells set to 2. First cell is the GPIO number which is interpreted | ||
140 | according to the bit numbers in the GPIO control registers. The second cell | ||
141 | is for flags which is currently unused. | ||
142 | |||
143 | fsl,mpc5200-fec nodes | ||
144 | --------------------- | ||
145 | The FEC node can specify one of the following properties to configure | ||
146 | the MII link: | ||
147 | - fsl,7-wire-mode - An empty property that specifies the link uses 7-wire | ||
148 | mode instead of MII | ||
149 | - current-speed - Specifies that the MII should be configured for a fixed | ||
150 | speed. This property should contain two cells. The | ||
151 | first cell specifies the speed in Mbps and the second | ||
152 | should be '0' for half duplex and '1' for full duplex | ||
153 | - phy-handle - Contains a phandle to an Ethernet PHY. | ||
154 | |||
155 | Interrupt controller (fsl,mpc5200-pic) node | ||
156 | ------------------------------------------- | ||
157 | The mpc5200 pic binding splits hardware IRQ numbers into two levels. The | ||
158 | split reflects the layout of the PIC hardware itself, which groups | ||
159 | interrupts into one of three groups; CRIT, MAIN or PERP. Also, the | ||
160 | Bestcomm dma engine has it's own set of interrupt sources which are | ||
161 | cascaded off of peripheral interrupt 0, which the driver interprets as a | ||
162 | fourth group, SDMA. | ||
163 | |||
164 | The interrupts property for device nodes using the mpc5200 pic consists | ||
165 | of three cells; <L1 L2 level> | ||
166 | |||
167 | L1 := [CRIT=0, MAIN=1, PERP=2, SDMA=3] | ||
168 | L2 := interrupt number; directly mapped from the value in the | ||
169 | "ICTL PerStat, MainStat, CritStat Encoded Register" | ||
170 | level := [LEVEL_HIGH=0, EDGE_RISING=1, EDGE_FALLING=2, LEVEL_LOW=3] | ||
171 | |||
172 | For external IRQs, use the following interrupt property values (how to | ||
173 | specify external interrupts is a frequently asked question): | ||
174 | External interrupts: | ||
175 | external irq0: interrupts = <0 0 n>; | ||
176 | external irq1: interrupts = <1 1 n>; | ||
177 | external irq2: interrupts = <1 2 n>; | ||
178 | external irq3: interrupts = <1 3 n>; | ||
179 | 'n' is sense (0: level high, 1: edge rising, 2: edge falling 3: level low) | ||
180 | |||
diff --git a/Documentation/powerpc/mpc52xx-device-tree-bindings.txt b/Documentation/powerpc/mpc52xx-device-tree-bindings.txt deleted file mode 100644 index 6f12f1c79c0c..000000000000 --- a/Documentation/powerpc/mpc52xx-device-tree-bindings.txt +++ /dev/null | |||
@@ -1,277 +0,0 @@ | |||
1 | MPC5200 Device Tree Bindings | ||
2 | ---------------------------- | ||
3 | |||
4 | (c) 2006-2007 Secret Lab Technologies Ltd | ||
5 | Grant Likely <grant.likely at secretlab.ca> | ||
6 | |||
7 | ********** DRAFT *********** | ||
8 | * WARNING: Do not depend on the stability of these bindings just yet. | ||
9 | * The MPC5200 device tree conventions are still in flux | ||
10 | * Keep an eye on the linuxppc-dev mailing list for more details | ||
11 | ********** DRAFT *********** | ||
12 | |||
13 | I - Introduction | ||
14 | ================ | ||
15 | Boards supported by the arch/powerpc architecture require device tree be | ||
16 | passed by the boot loader to the kernel at boot time. The device tree | ||
17 | describes what devices are present on the board and how they are | ||
18 | connected. The device tree can either be passed as a binary blob (as | ||
19 | described in Documentation/powerpc/booting-without-of.txt), or passed | ||
20 | by Open Firmware (IEEE 1275) compatible firmware using an OF compatible | ||
21 | client interface API. | ||
22 | |||
23 | This document specifies the requirements on the device-tree for mpc5200 | ||
24 | based boards. These requirements are above and beyond the details | ||
25 | specified in either the Open Firmware spec or booting-without-of.txt | ||
26 | |||
27 | All new mpc5200-based boards are expected to match this document. In | ||
28 | cases where this document is not sufficient to support a new board port, | ||
29 | this document should be updated as part of adding the new board support. | ||
30 | |||
31 | II - Philosophy | ||
32 | =============== | ||
33 | The core of this document is naming convention. The whole point of | ||
34 | defining this convention is to reduce or eliminate the number of | ||
35 | special cases required to support a 5200 board. If all 5200 boards | ||
36 | follow the same convention, then generic 5200 support code will work | ||
37 | rather than coding special cases for each new board. | ||
38 | |||
39 | This section tries to capture the thought process behind why the naming | ||
40 | convention is what it is. | ||
41 | |||
42 | 1. names | ||
43 | --------- | ||
44 | There is strong convention/requirements already established for children | ||
45 | of the root node. 'cpus' describes the processor cores, 'memory' | ||
46 | describes memory, and 'chosen' provides boot configuration. Other nodes | ||
47 | are added to describe devices attached to the processor local bus. | ||
48 | |||
49 | Following convention already established with other system-on-chip | ||
50 | processors, 5200 device trees should use the name 'soc5200' for the | ||
51 | parent node of on chip devices, and the root node should be its parent. | ||
52 | |||
53 | Child nodes are typically named after the configured function. ie. | ||
54 | the FEC node is named 'ethernet', and a PSC in uart mode is named 'serial'. | ||
55 | |||
56 | 2. device_type property | ||
57 | ----------------------- | ||
58 | similar to the node name convention above; the device_type reflects the | ||
59 | configured function of a device. ie. 'serial' for a uart and 'spi' for | ||
60 | an spi controller. However, while node names *should* reflect the | ||
61 | configured function, device_type *must* match the configured function | ||
62 | exactly. | ||
63 | |||
64 | 3. compatible property | ||
65 | ---------------------- | ||
66 | Since device_type isn't enough to match devices to drivers, there also | ||
67 | needs to be a naming convention for the compatible property. Compatible | ||
68 | is an list of device descriptions sorted from specific to generic. For | ||
69 | the mpc5200, the required format for each compatible value is | ||
70 | <chip>-<device>[-<mode>]. The OS should be able to match a device driver | ||
71 | to the device based solely on the compatible value. If two drivers | ||
72 | match on the compatible list; the 'most compatible' driver should be | ||
73 | selected. | ||
74 | |||
75 | The split between the MPC5200 and the MPC5200B leaves a bit of a | ||
76 | conundrum. How should the compatible property be set up to provide | ||
77 | maximum compatibility information; but still accurately describe the | ||
78 | chip? For the MPC5200; the answer is easy. Most of the SoC devices | ||
79 | originally appeared on the MPC5200. Since they didn't exist anywhere | ||
80 | else; the 5200 compatible properties will contain only one item; | ||
81 | "mpc5200-<device>". | ||
82 | |||
83 | The 5200B is almost the same as the 5200, but not quite. It fixes | ||
84 | silicon bugs and it adds a small number of enhancements. Most of the | ||
85 | devices either provide exactly the same interface as on the 5200. A few | ||
86 | devices have extra functions but still have a backwards compatible mode. | ||
87 | To express this information as completely as possible, 5200B device trees | ||
88 | should have two items in the compatible list; | ||
89 | "mpc5200b-<device>\0mpc5200-<device>". It is *strongly* recommended | ||
90 | that 5200B device trees follow this convention (instead of only listing | ||
91 | the base mpc5200 item). | ||
92 | |||
93 | If another chip appear on the market with one of the mpc5200 SoC | ||
94 | devices, then the compatible list should include mpc5200-<device>. | ||
95 | |||
96 | ie. ethernet on mpc5200: compatible = "mpc5200-ethernet" | ||
97 | ethernet on mpc5200b: compatible = "mpc5200b-ethernet\0mpc5200-ethernet" | ||
98 | |||
99 | Modal devices, like PSCs, also append the configured function to the | ||
100 | end of the compatible field. ie. A PSC in i2s mode would specify | ||
101 | "mpc5200-psc-i2s", not "mpc5200-i2s". This convention is chosen to | ||
102 | avoid naming conflicts with non-psc devices providing the same | ||
103 | function. For example, "mpc5200-spi" and "mpc5200-psc-spi" describe | ||
104 | the mpc5200 simple spi device and a PSC spi mode respectively. | ||
105 | |||
106 | If the soc device is more generic and present on other SOCs, the | ||
107 | compatible property can specify the more generic device type also. | ||
108 | |||
109 | ie. mscan: compatible = "mpc5200-mscan\0fsl,mscan"; | ||
110 | |||
111 | At the time of writing, exact chip may be either 'mpc5200' or | ||
112 | 'mpc5200b'. | ||
113 | |||
114 | Device drivers should always try to match as generically as possible. | ||
115 | |||
116 | III - Structure | ||
117 | =============== | ||
118 | The device tree for an mpc5200 board follows the structure defined in | ||
119 | booting-without-of.txt with the following additional notes: | ||
120 | |||
121 | 0) the root node | ||
122 | ---------------- | ||
123 | Typical root description node; see booting-without-of | ||
124 | |||
125 | 1) The cpus node | ||
126 | ---------------- | ||
127 | The cpus node follows the basic layout described in booting-without-of. | ||
128 | The bus-frequency property holds the XLB bus frequency | ||
129 | The clock-frequency property holds the core frequency | ||
130 | |||
131 | 2) The memory node | ||
132 | ------------------ | ||
133 | Typical memory description node; see booting-without-of. | ||
134 | |||
135 | 3) The soc5200 node | ||
136 | ------------------- | ||
137 | This node describes the on chip SOC peripherals. Every mpc5200 based | ||
138 | board will have this node, and as such there is a common naming | ||
139 | convention for SOC devices. | ||
140 | |||
141 | Required properties: | ||
142 | name type description | ||
143 | ---- ---- ----------- | ||
144 | device_type string must be "soc" | ||
145 | ranges int should be <0 baseaddr baseaddr+10000> | ||
146 | reg int must be <baseaddr 10000> | ||
147 | compatible string mpc5200: "mpc5200-soc" | ||
148 | mpc5200b: "mpc5200b-soc\0mpc5200-soc" | ||
149 | system-frequency int Fsystem frequency; source of all | ||
150 | other clocks. | ||
151 | bus-frequency int IPB bus frequency in HZ. Clock rate | ||
152 | used by most of the soc devices. | ||
153 | #interrupt-cells int must be <3>. | ||
154 | |||
155 | Recommended properties: | ||
156 | name type description | ||
157 | ---- ---- ----------- | ||
158 | model string Exact model of the chip; | ||
159 | ie: model="fsl,mpc5200" | ||
160 | revision string Silicon revision of chip | ||
161 | ie: revision="M08A" | ||
162 | |||
163 | The 'model' and 'revision' properties are *strongly* recommended. Having | ||
164 | them presence acts as a bit of a safety net for working around as yet | ||
165 | undiscovered bugs on one version of silicon. For example, device drivers | ||
166 | can use the model and revision properties to decide if a bug fix should | ||
167 | be turned on. | ||
168 | |||
169 | 4) soc5200 child nodes | ||
170 | ---------------------- | ||
171 | Any on chip SOC devices available to Linux must appear as soc5200 child nodes. | ||
172 | |||
173 | Note: The tables below show the value for the mpc5200. A mpc5200b device | ||
174 | tree should use the "mpc5200b-<device>\0mpc5200-<device> form. | ||
175 | |||
176 | Required soc5200 child nodes: | ||
177 | name device_type compatible Description | ||
178 | ---- ----------- ---------- ----------- | ||
179 | cdm@<addr> cdm mpc5200-cmd Clock Distribution | ||
180 | pic@<addr> interrupt-controller mpc5200-pic need an interrupt | ||
181 | controller to boot | ||
182 | bestcomm@<addr> dma-controller mpc5200-bestcomm 5200 pic also requires | ||
183 | the bestcomm device | ||
184 | |||
185 | Recommended soc5200 child nodes; populate as needed for your board | ||
186 | name device_type compatible Description | ||
187 | ---- ----------- ---------- ----------- | ||
188 | gpt@<addr> gpt fsl,mpc5200-gpt General purpose timers | ||
189 | gpt@<addr> gpt fsl,mpc5200-gpt-gpio General purpose | ||
190 | timers in GPIO mode | ||
191 | gpio@<addr> fsl,mpc5200-gpio MPC5200 simple gpio | ||
192 | controller | ||
193 | gpio@<addr> fsl,mpc5200-gpio-wkup MPC5200 wakeup gpio | ||
194 | controller | ||
195 | rtc@<addr> rtc mpc5200-rtc Real time clock | ||
196 | mscan@<addr> mscan mpc5200-mscan CAN bus controller | ||
197 | pci@<addr> pci mpc5200-pci PCI bridge | ||
198 | serial@<addr> serial mpc5200-psc-uart PSC in serial mode | ||
199 | i2s@<addr> sound mpc5200-psc-i2s PSC in i2s mode | ||
200 | ac97@<addr> sound mpc5200-psc-ac97 PSC in ac97 mode | ||
201 | spi@<addr> spi mpc5200-psc-spi PSC in spi mode | ||
202 | irda@<addr> irda mpc5200-psc-irda PSC in IrDA mode | ||
203 | spi@<addr> spi mpc5200-spi MPC5200 spi device | ||
204 | ethernet@<addr> network mpc5200-fec MPC5200 ethernet device | ||
205 | ata@<addr> ata mpc5200-ata IDE ATA interface | ||
206 | i2c@<addr> i2c mpc5200-i2c I2C controller | ||
207 | usb@<addr> usb-ohci-be mpc5200-ohci,ohci-be USB controller | ||
208 | xlb@<addr> xlb mpc5200-xlb XLB arbitrator | ||
209 | |||
210 | Important child node properties | ||
211 | name type description | ||
212 | ---- ---- ----------- | ||
213 | cell-index int When multiple devices are present, is the | ||
214 | index of the device in the hardware (ie. There | ||
215 | are 6 PSC on the 5200 numbered PSC1 to PSC6) | ||
216 | PSC1 has 'cell-index = <0>' | ||
217 | PSC4 has 'cell-index = <3>' | ||
218 | |||
219 | 5) General Purpose Timer nodes (child of soc5200 node) | ||
220 | On the mpc5200 and 5200b, GPT0 has a watchdog timer function. If the board | ||
221 | design supports the internal wdt, then the device node for GPT0 should | ||
222 | include the empty property 'fsl,has-wdt'. | ||
223 | |||
224 | 6) PSC nodes (child of soc5200 node) | ||
225 | PSC nodes can define the optional 'port-number' property to force assignment | ||
226 | order of serial ports. For example, PSC5 might be physically connected to | ||
227 | the port labeled 'COM1' and PSC1 wired to 'COM1'. In this case, PSC5 would | ||
228 | have a "port-number = <0>" property, and PSC1 would have "port-number = <1>". | ||
229 | |||
230 | PSC in i2s mode: The mpc5200 and mpc5200b PSCs are not compatible when in | ||
231 | i2s mode. An 'mpc5200b-psc-i2s' node cannot include 'mpc5200-psc-i2s' in the | ||
232 | compatible field. | ||
233 | |||
234 | 7) GPIO controller nodes | ||
235 | Each GPIO controller node should have the empty property gpio-controller and | ||
236 | #gpio-cells set to 2. First cell is the GPIO number which is interpreted | ||
237 | according to the bit numbers in the GPIO control registers. The second cell | ||
238 | is for flags which is currently unsused. | ||
239 | |||
240 | 8) FEC nodes | ||
241 | The FEC node can specify one of the following properties to configure | ||
242 | the MII link: | ||
243 | "fsl,7-wire-mode" - An empty property that specifies the link uses 7-wire | ||
244 | mode instead of MII | ||
245 | "current-speed" - Specifies that the MII should be configured for a fixed | ||
246 | speed. This property should contain two cells. The | ||
247 | first cell specifies the speed in Mbps and the second | ||
248 | should be '0' for half duplex and '1' for full duplex | ||
249 | "phy-handle" - Contains a phandle to an Ethernet PHY. | ||
250 | |||
251 | IV - Extra Notes | ||
252 | ================ | ||
253 | |||
254 | 1. Interrupt mapping | ||
255 | -------------------- | ||
256 | The mpc5200 pic driver splits hardware IRQ numbers into two levels. The | ||
257 | split reflects the layout of the PIC hardware itself, which groups | ||
258 | interrupts into one of three groups; CRIT, MAIN or PERP. Also, the | ||
259 | Bestcomm dma engine has it's own set of interrupt sources which are | ||
260 | cascaded off of peripheral interrupt 0, which the driver interprets as a | ||
261 | fourth group, SDMA. | ||
262 | |||
263 | The interrupts property for device nodes using the mpc5200 pic consists | ||
264 | of three cells; <L1 L2 level> | ||
265 | |||
266 | L1 := [CRIT=0, MAIN=1, PERP=2, SDMA=3] | ||
267 | L2 := interrupt number; directly mapped from the value in the | ||
268 | "ICTL PerStat, MainStat, CritStat Encoded Register" | ||
269 | level := [LEVEL_HIGH=0, EDGE_RISING=1, EDGE_FALLING=2, LEVEL_LOW=3] | ||
270 | |||
271 | 2. Shared registers | ||
272 | ------------------- | ||
273 | Some SoC devices share registers between them. ie. the i2c devices use | ||
274 | a single clock control register, and almost all device are affected by | ||
275 | the port_config register. Devices which need to manipulate shared regs | ||
276 | should look to the parent SoC node. The soc node is responsible | ||
277 | for arbitrating all shared register access. | ||