diff options
author | Paul Mackerras <paulus@samba.org> | 2009-04-21 23:02:09 -0400 |
---|---|---|
committer | Paul Mackerras <paulus@samba.org> | 2009-04-21 23:02:09 -0400 |
commit | 5bd3ef84d73c2ea7b4babbad060909753c4828d4 (patch) | |
tree | fdf2bafb48ae1ed03175f6c77a7548a181e69ee9 /Documentation/powerpc | |
parent | 0658c16056660886ea2f35c4f038be70a94b1532 (diff) | |
parent | 6d25b688ecc488753af3c9e6f6a9a575b863cf37 (diff) |
Merge branch 'merge' of git://git.secretlab.ca/git/linux-2.6 into merge
Diffstat (limited to 'Documentation/powerpc')
-rw-r--r-- | Documentation/powerpc/booting-without-of.txt | 89 | ||||
-rw-r--r-- | Documentation/powerpc/dts-bindings/fsl/upm-nand.txt | 39 | ||||
-rw-r--r-- | Documentation/powerpc/dts-bindings/gpio/led.txt | 46 | ||||
-rw-r--r-- | Documentation/powerpc/dts-bindings/mtd-physmap.txt | 80 |
4 files changed, 166 insertions, 88 deletions
diff --git a/Documentation/powerpc/booting-without-of.txt b/Documentation/powerpc/booting-without-of.txt index 0ab0230cbcb0..d16b7a1c3793 100644 --- a/Documentation/powerpc/booting-without-of.txt +++ b/Documentation/powerpc/booting-without-of.txt | |||
@@ -43,12 +43,11 @@ Table of Contents | |||
43 | 2) Representing devices without a current OF specification | 43 | 2) Representing devices without a current OF specification |
44 | a) PHY nodes | 44 | a) PHY nodes |
45 | b) Interrupt controllers | 45 | b) Interrupt controllers |
46 | c) CFI or JEDEC memory-mapped NOR flash | 46 | c) 4xx/Axon EMAC ethernet nodes |
47 | d) 4xx/Axon EMAC ethernet nodes | 47 | d) Xilinx IP cores |
48 | e) Xilinx IP cores | 48 | e) USB EHCI controllers |
49 | f) USB EHCI controllers | 49 | f) MDIO on GPIOs |
50 | g) MDIO on GPIOs | 50 | g) SPI busses |
51 | h) SPI busses | ||
52 | 51 | ||
53 | VII - Marvell Discovery mv64[345]6x System Controller chips | 52 | VII - Marvell Discovery mv64[345]6x System Controller chips |
54 | 1) The /system-controller node | 53 | 1) The /system-controller node |
@@ -999,7 +998,7 @@ compatibility. | |||
999 | translation of SOC addresses for memory mapped SOC registers. | 998 | translation of SOC addresses for memory mapped SOC registers. |
1000 | - bus-frequency: Contains the bus frequency for the SOC node. | 999 | - bus-frequency: Contains the bus frequency for the SOC node. |
1001 | Typically, the value of this field is filled in by the boot | 1000 | Typically, the value of this field is filled in by the boot |
1002 | loader. | 1001 | loader. |
1003 | 1002 | ||
1004 | 1003 | ||
1005 | Recommended properties: | 1004 | Recommended properties: |
@@ -1287,71 +1286,7 @@ platforms are moved over to use the flattened-device-tree model. | |||
1287 | device_type = "open-pic"; | 1286 | device_type = "open-pic"; |
1288 | }; | 1287 | }; |
1289 | 1288 | ||
1290 | c) CFI or JEDEC memory-mapped NOR flash | 1289 | c) 4xx/Axon EMAC ethernet nodes |
1291 | |||
1292 | Flash chips (Memory Technology Devices) are often used for solid state | ||
1293 | file systems on embedded devices. | ||
1294 | |||
1295 | - compatible : should contain the specific model of flash chip(s) | ||
1296 | used, if known, followed by either "cfi-flash" or "jedec-flash" | ||
1297 | - reg : Address range of the flash chip | ||
1298 | - bank-width : Width (in bytes) of the flash bank. Equal to the | ||
1299 | device width times the number of interleaved chips. | ||
1300 | - device-width : (optional) Width of a single flash chip. If | ||
1301 | omitted, assumed to be equal to 'bank-width'. | ||
1302 | - #address-cells, #size-cells : Must be present if the flash has | ||
1303 | sub-nodes representing partitions (see below). In this case | ||
1304 | both #address-cells and #size-cells must be equal to 1. | ||
1305 | |||
1306 | For JEDEC compatible devices, the following additional properties | ||
1307 | are defined: | ||
1308 | |||
1309 | - vendor-id : Contains the flash chip's vendor id (1 byte). | ||
1310 | - device-id : Contains the flash chip's device id (1 byte). | ||
1311 | |||
1312 | In addition to the information on the flash bank itself, the | ||
1313 | device tree may optionally contain additional information | ||
1314 | describing partitions of the flash address space. This can be | ||
1315 | used on platforms which have strong conventions about which | ||
1316 | portions of the flash are used for what purposes, but which don't | ||
1317 | use an on-flash partition table such as RedBoot. | ||
1318 | |||
1319 | Each partition is represented as a sub-node of the flash device. | ||
1320 | Each node's name represents the name of the corresponding | ||
1321 | partition of the flash device. | ||
1322 | |||
1323 | Flash partitions | ||
1324 | - reg : The partition's offset and size within the flash bank. | ||
1325 | - label : (optional) The label / name for this flash partition. | ||
1326 | If omitted, the label is taken from the node name (excluding | ||
1327 | the unit address). | ||
1328 | - read-only : (optional) This parameter, if present, is a hint to | ||
1329 | Linux that this flash partition should only be mounted | ||
1330 | read-only. This is usually used for flash partitions | ||
1331 | containing early-boot firmware images or data which should not | ||
1332 | be clobbered. | ||
1333 | |||
1334 | Example: | ||
1335 | |||
1336 | flash@ff000000 { | ||
1337 | compatible = "amd,am29lv128ml", "cfi-flash"; | ||
1338 | reg = <ff000000 01000000>; | ||
1339 | bank-width = <4>; | ||
1340 | device-width = <1>; | ||
1341 | #address-cells = <1>; | ||
1342 | #size-cells = <1>; | ||
1343 | fs@0 { | ||
1344 | label = "fs"; | ||
1345 | reg = <0 f80000>; | ||
1346 | }; | ||
1347 | firmware@f80000 { | ||
1348 | label ="firmware"; | ||
1349 | reg = <f80000 80000>; | ||
1350 | read-only; | ||
1351 | }; | ||
1352 | }; | ||
1353 | |||
1354 | d) 4xx/Axon EMAC ethernet nodes | ||
1355 | 1290 | ||
1356 | The EMAC ethernet controller in IBM and AMCC 4xx chips, and also | 1291 | The EMAC ethernet controller in IBM and AMCC 4xx chips, and also |
1357 | the Axon bridge. To operate this needs to interact with a ths | 1292 | the Axon bridge. To operate this needs to interact with a ths |
@@ -1499,7 +1434,7 @@ platforms are moved over to use the flattened-device-tree model. | |||
1499 | available. | 1434 | available. |
1500 | For Axon: 0x0000012a | 1435 | For Axon: 0x0000012a |
1501 | 1436 | ||
1502 | e) Xilinx IP cores | 1437 | d) Xilinx IP cores |
1503 | 1438 | ||
1504 | The Xilinx EDK toolchain ships with a set of IP cores (devices) for use | 1439 | The Xilinx EDK toolchain ships with a set of IP cores (devices) for use |
1505 | in Xilinx Spartan and Virtex FPGAs. The devices cover the whole range | 1440 | in Xilinx Spartan and Virtex FPGAs. The devices cover the whole range |
@@ -1761,7 +1696,7 @@ platforms are moved over to use the flattened-device-tree model. | |||
1761 | listed above, nodes for these devices should include a phy-handle | 1696 | listed above, nodes for these devices should include a phy-handle |
1762 | property, and may include other common network device properties | 1697 | property, and may include other common network device properties |
1763 | like local-mac-address. | 1698 | like local-mac-address. |
1764 | 1699 | ||
1765 | iv) Xilinx Uartlite | 1700 | iv) Xilinx Uartlite |
1766 | 1701 | ||
1767 | Xilinx uartlite devices are simple fixed speed serial ports. | 1702 | Xilinx uartlite devices are simple fixed speed serial ports. |
@@ -1793,7 +1728,7 @@ platforms are moved over to use the flattened-device-tree model. | |||
1793 | - reg-offset : A value of 3 is required | 1728 | - reg-offset : A value of 3 is required |
1794 | - reg-shift : A value of 2 is required | 1729 | - reg-shift : A value of 2 is required |
1795 | 1730 | ||
1796 | f) USB EHCI controllers | 1731 | e) USB EHCI controllers |
1797 | 1732 | ||
1798 | Required properties: | 1733 | Required properties: |
1799 | - compatible : should be "usb-ehci". | 1734 | - compatible : should be "usb-ehci". |
@@ -1819,7 +1754,7 @@ platforms are moved over to use the flattened-device-tree model. | |||
1819 | big-endian; | 1754 | big-endian; |
1820 | }; | 1755 | }; |
1821 | 1756 | ||
1822 | g) MDIO on GPIOs | 1757 | f) MDIO on GPIOs |
1823 | 1758 | ||
1824 | Currently defined compatibles: | 1759 | Currently defined compatibles: |
1825 | - virtual,gpio-mdio | 1760 | - virtual,gpio-mdio |
@@ -1839,7 +1774,7 @@ platforms are moved over to use the flattened-device-tree model. | |||
1839 | &qe_pio_c 6>; | 1774 | &qe_pio_c 6>; |
1840 | }; | 1775 | }; |
1841 | 1776 | ||
1842 | h) SPI (Serial Peripheral Interface) busses | 1777 | g) SPI (Serial Peripheral Interface) busses |
1843 | 1778 | ||
1844 | SPI busses can be described with a node for the SPI master device | 1779 | SPI busses can be described with a node for the SPI master device |
1845 | and a set of child nodes for each SPI slave on the bus. For this | 1780 | and a set of child nodes for each SPI slave on the bus. For this |
diff --git a/Documentation/powerpc/dts-bindings/fsl/upm-nand.txt b/Documentation/powerpc/dts-bindings/fsl/upm-nand.txt index 84a04d5eb8e6..a48b2cadc7f0 100644 --- a/Documentation/powerpc/dts-bindings/fsl/upm-nand.txt +++ b/Documentation/powerpc/dts-bindings/fsl/upm-nand.txt | |||
@@ -5,9 +5,21 @@ Required properties: | |||
5 | - reg : should specify localbus chip select and size used for the chip. | 5 | - reg : should specify localbus chip select and size used for the chip. |
6 | - fsl,upm-addr-offset : UPM pattern offset for the address latch. | 6 | - fsl,upm-addr-offset : UPM pattern offset for the address latch. |
7 | - fsl,upm-cmd-offset : UPM pattern offset for the command latch. | 7 | - fsl,upm-cmd-offset : UPM pattern offset for the command latch. |
8 | - gpios : may specify optional GPIO connected to the Ready-Not-Busy pin. | ||
9 | 8 | ||
10 | Example: | 9 | Optional properties: |
10 | - fsl,upm-wait-flags : add chip-dependent short delays after running the | ||
11 | UPM pattern (0x1), after writing a data byte (0x2) or after | ||
12 | writing out a buffer (0x4). | ||
13 | - fsl,upm-addr-line-cs-offsets : address offsets for multi-chip support. | ||
14 | The corresponding address lines are used to select the chip. | ||
15 | - gpios : may specify optional GPIOs connected to the Ready-Not-Busy pins | ||
16 | (R/B#). For multi-chip devices, "n" GPIO definitions are required | ||
17 | according to the number of chips. | ||
18 | - chip-delay : chip dependent delay for transfering data from array to | ||
19 | read registers (tR). Required if property "gpios" is not used | ||
20 | (R/B# pins not connected). | ||
21 | |||
22 | Examples: | ||
11 | 23 | ||
12 | upm@1,0 { | 24 | upm@1,0 { |
13 | compatible = "fsl,upm-nand"; | 25 | compatible = "fsl,upm-nand"; |
@@ -26,3 +38,26 @@ upm@1,0 { | |||
26 | }; | 38 | }; |
27 | }; | 39 | }; |
28 | }; | 40 | }; |
41 | |||
42 | upm@3,0 { | ||
43 | #address-cells = <0>; | ||
44 | #size-cells = <0>; | ||
45 | compatible = "tqc,tqm8548-upm-nand", "fsl,upm-nand"; | ||
46 | reg = <3 0x0 0x800>; | ||
47 | fsl,upm-addr-offset = <0x10>; | ||
48 | fsl,upm-cmd-offset = <0x08>; | ||
49 | /* Multi-chip NAND device */ | ||
50 | fsl,upm-addr-line-cs-offsets = <0x0 0x200>; | ||
51 | fsl,upm-wait-flags = <0x5>; | ||
52 | chip-delay = <25>; // in micro-seconds | ||
53 | |||
54 | nand@0 { | ||
55 | #address-cells = <1>; | ||
56 | #size-cells = <1>; | ||
57 | |||
58 | partition@0 { | ||
59 | label = "fs"; | ||
60 | reg = <0x00000000 0x10000000>; | ||
61 | }; | ||
62 | }; | ||
63 | }; | ||
diff --git a/Documentation/powerpc/dts-bindings/gpio/led.txt b/Documentation/powerpc/dts-bindings/gpio/led.txt index ff51f4c0fa9d..4fe14deedc0a 100644 --- a/Documentation/powerpc/dts-bindings/gpio/led.txt +++ b/Documentation/powerpc/dts-bindings/gpio/led.txt | |||
@@ -1,15 +1,43 @@ | |||
1 | LED connected to GPIO | 1 | LEDs connected to GPIO lines |
2 | 2 | ||
3 | Required properties: | 3 | Required properties: |
4 | - compatible : should be "gpio-led". | 4 | - compatible : should be "gpio-leds". |
5 | - label : (optional) the label for this LED. If omitted, the label is | 5 | |
6 | Each LED is represented as a sub-node of the gpio-leds device. Each | ||
7 | node's name represents the name of the corresponding LED. | ||
8 | |||
9 | LED sub-node properties: | ||
10 | - gpios : Should specify the LED's GPIO, see "Specifying GPIO information | ||
11 | for devices" in Documentation/powerpc/booting-without-of.txt. Active | ||
12 | low LEDs should be indicated using flags in the GPIO specifier. | ||
13 | - label : (optional) The label for this LED. If omitted, the label is | ||
6 | taken from the node name (excluding the unit address). | 14 | taken from the node name (excluding the unit address). |
7 | - gpios : should specify LED GPIO. | 15 | - linux,default-trigger : (optional) This parameter, if present, is a |
16 | string defining the trigger assigned to the LED. Current triggers are: | ||
17 | "backlight" - LED will act as a back-light, controlled by the framebuffer | ||
18 | system | ||
19 | "default-on" - LED will turn on | ||
20 | "heartbeat" - LED "double" flashes at a load average based rate | ||
21 | "ide-disk" - LED indicates disk activity | ||
22 | "timer" - LED flashes at a fixed, configurable rate | ||
8 | 23 | ||
9 | Example: | 24 | Examples: |
10 | 25 | ||
11 | led@0 { | 26 | leds { |
12 | compatible = "gpio-led"; | 27 | compatible = "gpio-leds"; |
13 | label = "hdd"; | 28 | hdd { |
14 | gpios = <&mcu_pio 0 1>; | 29 | label = "IDE Activity"; |
30 | gpios = <&mcu_pio 0 1>; /* Active low */ | ||
31 | linux,default-trigger = "ide-disk"; | ||
32 | }; | ||
15 | }; | 33 | }; |
34 | |||
35 | run-control { | ||
36 | compatible = "gpio-leds"; | ||
37 | red { | ||
38 | gpios = <&mpc8572 6 0>; | ||
39 | }; | ||
40 | green { | ||
41 | gpios = <&mpc8572 7 0>; | ||
42 | }; | ||
43 | } | ||
diff --git a/Documentation/powerpc/dts-bindings/mtd-physmap.txt b/Documentation/powerpc/dts-bindings/mtd-physmap.txt new file mode 100644 index 000000000000..667c9bde8699 --- /dev/null +++ b/Documentation/powerpc/dts-bindings/mtd-physmap.txt | |||
@@ -0,0 +1,80 @@ | |||
1 | CFI or JEDEC memory-mapped NOR flash | ||
2 | |||
3 | Flash chips (Memory Technology Devices) are often used for solid state | ||
4 | file systems on embedded devices. | ||
5 | |||
6 | - compatible : should contain the specific model of flash chip(s) | ||
7 | used, if known, followed by either "cfi-flash" or "jedec-flash" | ||
8 | - reg : Address range(s) of the flash chip(s) | ||
9 | It's possible to (optionally) define multiple "reg" tuples so that | ||
10 | non-identical NOR chips can be described in one flash node. | ||
11 | - bank-width : Width (in bytes) of the flash bank. Equal to the | ||
12 | device width times the number of interleaved chips. | ||
13 | - device-width : (optional) Width of a single flash chip. If | ||
14 | omitted, assumed to be equal to 'bank-width'. | ||
15 | - #address-cells, #size-cells : Must be present if the flash has | ||
16 | sub-nodes representing partitions (see below). In this case | ||
17 | both #address-cells and #size-cells must be equal to 1. | ||
18 | |||
19 | For JEDEC compatible devices, the following additional properties | ||
20 | are defined: | ||
21 | |||
22 | - vendor-id : Contains the flash chip's vendor id (1 byte). | ||
23 | - device-id : Contains the flash chip's device id (1 byte). | ||
24 | |||
25 | In addition to the information on the flash bank itself, the | ||
26 | device tree may optionally contain additional information | ||
27 | describing partitions of the flash address space. This can be | ||
28 | used on platforms which have strong conventions about which | ||
29 | portions of the flash are used for what purposes, but which don't | ||
30 | use an on-flash partition table such as RedBoot. | ||
31 | |||
32 | Each partition is represented as a sub-node of the flash device. | ||
33 | Each node's name represents the name of the corresponding | ||
34 | partition of the flash device. | ||
35 | |||
36 | Flash partitions | ||
37 | - reg : The partition's offset and size within the flash bank. | ||
38 | - label : (optional) The label / name for this flash partition. | ||
39 | If omitted, the label is taken from the node name (excluding | ||
40 | the unit address). | ||
41 | - read-only : (optional) This parameter, if present, is a hint to | ||
42 | Linux that this flash partition should only be mounted | ||
43 | read-only. This is usually used for flash partitions | ||
44 | containing early-boot firmware images or data which should not | ||
45 | be clobbered. | ||
46 | |||
47 | Example: | ||
48 | |||
49 | flash@ff000000 { | ||
50 | compatible = "amd,am29lv128ml", "cfi-flash"; | ||
51 | reg = <ff000000 01000000>; | ||
52 | bank-width = <4>; | ||
53 | device-width = <1>; | ||
54 | #address-cells = <1>; | ||
55 | #size-cells = <1>; | ||
56 | fs@0 { | ||
57 | label = "fs"; | ||
58 | reg = <0 f80000>; | ||
59 | }; | ||
60 | firmware@f80000 { | ||
61 | label ="firmware"; | ||
62 | reg = <f80000 80000>; | ||
63 | read-only; | ||
64 | }; | ||
65 | }; | ||
66 | |||
67 | Here an example with multiple "reg" tuples: | ||
68 | |||
69 | flash@f0000000,0 { | ||
70 | #address-cells = <1>; | ||
71 | #size-cells = <1>; | ||
72 | compatible = "intel,PC48F4400P0VB", "cfi-flash"; | ||
73 | reg = <0 0x00000000 0x02000000 | ||
74 | 0 0x02000000 0x02000000>; | ||
75 | bank-width = <2>; | ||
76 | partition@0 { | ||
77 | label = "test-part1"; | ||
78 | reg = <0 0x04000000>; | ||
79 | }; | ||
80 | }; | ||