diff options
| author | Linus Torvalds <torvalds@linux-foundation.org> | 2011-03-18 09:31:43 -0400 |
|---|---|---|
| committer | Linus Torvalds <torvalds@linux-foundation.org> | 2011-03-18 09:31:43 -0400 |
| commit | 0a95d92c0054e74fb79607ac2df958b7bf295706 (patch) | |
| tree | e2c5f836e799dcfd72904949be47595af91432e7 /Documentation/devicetree | |
| parent | 08351fc6a75731226e1112fc7254542bd3a2912e (diff) | |
| parent | 831532035b12a5f7b600515a6f4da0b207b82d6e (diff) | |
Merge branch 'next' of git://git.kernel.org/pub/scm/linux/kernel/git/benh/powerpc
* 'next' of git://git.kernel.org/pub/scm/linux/kernel/git/benh/powerpc: (62 commits)
powerpc/85xx: Fix signedness bug in cache-sram
powerpc/fsl: 85xx: document cache sram bindings
powerpc/fsl: define binding for fsl mpic interrupt controllers
powerpc/fsl_msi: Handle msi-available-ranges better
drivers/serial/ucc_uart.c: Add of_node_put to avoid memory leak
powerpc/85xx: Fix SPE float to integer conversion failure
powerpc/85xx: Update sata controller compatible for p1022ds board
ATA: Add FSL sata v2 controller support
powerpc/mpc8xxx_gpio: simplify searching for 'fsl, qoriq-gpio' compatiable
powerpc/8xx: remove obsolete mgsuvd board
powerpc/82xx: rename and update mgcoge board support
powerpc/83xx: rename and update kmeter1
powerpc/85xx: Workaroudn e500 CPU erratum A005
powerpc/fsl_pci: Add support for FSL PCIe controllers v2.x
powerpc/85xx: Fix writing to spin table 'cpu-release-addr' on ppc64e
powerpc/pseries: Disable MSI using new interface if possible
powerpc: Enable GENERIC_HARDIRQS_NO_DEPRECATED.
powerpc: core irq_data conversion.
powerpc: sysdev/xilinx_intc irq_data conversion.
powerpc: sysdev/uic irq_data conversion.
...
Fix up conflicts in arch/powerpc/sysdev/fsl_msi.c (due to getting rid of
of_platform_driver in arch/powerpc)
Diffstat (limited to 'Documentation/devicetree')
3 files changed, 239 insertions, 43 deletions
diff --git a/Documentation/devicetree/bindings/powerpc/fsl/cache_sram.txt b/Documentation/devicetree/bindings/powerpc/fsl/cache_sram.txt new file mode 100644 index 00000000000..781955f5217 --- /dev/null +++ b/Documentation/devicetree/bindings/powerpc/fsl/cache_sram.txt | |||
| @@ -0,0 +1,20 @@ | |||
| 1 | * Freescale PQ3 and QorIQ based Cache SRAM | ||
| 2 | |||
| 3 | Freescale's mpc85xx and some QorIQ platforms provide an | ||
| 4 | option of configuring a part of (or full) cache memory | ||
| 5 | as SRAM. This cache SRAM representation in the device | ||
| 6 | tree should be done as under:- | ||
| 7 | |||
| 8 | Required properties: | ||
| 9 | |||
| 10 | - compatible : should be "fsl,p2020-cache-sram" | ||
| 11 | - fsl,cache-sram-ctlr-handle : points to the L2 controller | ||
| 12 | - reg : offset and length of the cache-sram. | ||
| 13 | |||
| 14 | Example: | ||
| 15 | |||
| 16 | cache-sram@fff00000 { | ||
| 17 | fsl,cache-sram-ctlr-handle = <&L2>; | ||
| 18 | reg = <0 0xfff00000 0 0x10000>; | ||
| 19 | compatible = "fsl,p2020-cache-sram"; | ||
| 20 | }; | ||
diff --git a/Documentation/devicetree/bindings/powerpc/fsl/mpic.txt b/Documentation/devicetree/bindings/powerpc/fsl/mpic.txt index 71e39cf3215..8aa10f45ebe 100644 --- a/Documentation/devicetree/bindings/powerpc/fsl/mpic.txt +++ b/Documentation/devicetree/bindings/powerpc/fsl/mpic.txt | |||
| @@ -1,42 +1,211 @@ | |||
| 1 | * OpenPIC and its interrupt numbers on Freescale's e500/e600 cores | 1 | ===================================================================== |
| 2 | 2 | Freescale MPIC Interrupt Controller Node | |
| 3 | The OpenPIC specification does not specify which interrupt source has to | 3 | Copyright (C) 2010,2011 Freescale Semiconductor Inc. |
| 4 | become which interrupt number. This is up to the software implementation | 4 | ===================================================================== |
| 5 | of the interrupt controller. The only requirement is that every | 5 | |
| 6 | interrupt source has to have an unique interrupt number / vector number. | 6 | The Freescale MPIC interrupt controller is found on all PowerQUICC |
| 7 | To accomplish this the current implementation assigns the number zero to | 7 | and QorIQ processors and is compatible with the Open PIC. The |
| 8 | the first source, the number one to the second source and so on until | 8 | notable difference from Open PIC binding is the addition of 2 |
| 9 | all interrupt sources have their unique number. | 9 | additional cells in the interrupt specifier defining interrupt type |
| 10 | Usually the assigned vector number equals the interrupt number mentioned | 10 | information. |
| 11 | in the documentation for a given core / CPU. This is however not true | 11 | |
| 12 | for the e500 cores (MPC85XX CPUs) where the documentation distinguishes | 12 | PROPERTIES |
| 13 | between internal and external interrupt sources and starts counting at | 13 | |
| 14 | zero for both of them. | 14 | - compatible |
| 15 | 15 | Usage: required | |
| 16 | So what to write for external interrupt source X or internal interrupt | 16 | Value type: <string> |
| 17 | source Y into the device tree? Here is an example: | 17 | Definition: Shall include "fsl,mpic". Freescale MPIC |
| 18 | 18 | controllers compatible with this binding have Block | |
| 19 | The memory map for the interrupt controller in the MPC8544[0] shows, | 19 | Revision Registers BRR1 and BRR2 at offset 0x0 and |
| 20 | that the first interrupt source starts at 0x5_0000 (PIC Register Address | 20 | 0x10 in the MPIC. |
| 21 | Map-Interrupt Source Configuration Registers). This source becomes the | 21 | |
| 22 | number zero therefore: | 22 | - reg |
| 23 | External interrupt 0 = interrupt number 0 | 23 | Usage: required |
| 24 | External interrupt 1 = interrupt number 1 | 24 | Value type: <prop-encoded-array> |
| 25 | External interrupt 2 = interrupt number 2 | 25 | Definition: A standard property. Specifies the physical |
| 26 | ... | 26 | offset and length of the device's registers within the |
| 27 | Every interrupt number allocates 0x20 bytes register space. So to get | 27 | CCSR address space. |
| 28 | its number it is sufficient to shift the lower 16bits to right by five. | 28 | |
| 29 | So for the external interrupt 10 we have: | 29 | - interrupt-controller |
| 30 | 0x0140 >> 5 = 10 | 30 | Usage: required |
| 31 | 31 | Value type: <empty> | |
| 32 | After the external sources, the internal sources follow. The in core I2C | 32 | Definition: Specifies that this node is an interrupt |
| 33 | controller on the MPC8544 for instance has the internal source number | 33 | controller |
| 34 | 27. Oo obtain its interrupt number we take the lower 16bits of its memory | 34 | |
| 35 | address (0x5_0560) and shift it right: | 35 | - #interrupt-cells |
| 36 | 0x0560 >> 5 = 43 | 36 | Usage: required |
| 37 | 37 | Value type: <u32> | |
| 38 | Therefore the I2C device node for the MPC8544 CPU has to have the | 38 | Definition: Shall be 2 or 4. A value of 2 means that interrupt |
| 39 | interrupt number 43 specified in the device tree. | 39 | specifiers do not contain the interrupt-type or type-specific |
| 40 | 40 | information cells. | |
| 41 | [0] MPC8544E PowerQUICCTM III, Integrated Host Processor Family Reference Manual | 41 | |
| 42 | MPC8544ERM Rev. 1 10/2007 | 42 | - #address-cells |
| 43 | Usage: required | ||
| 44 | Value type: <u32> | ||
| 45 | Definition: Shall be 0. | ||
| 46 | |||
| 47 | - pic-no-reset | ||
| 48 | Usage: optional | ||
| 49 | Value type: <empty> | ||
| 50 | Definition: The presence of this property specifies that the | ||
| 51 | MPIC must not be reset by the client program, and that | ||
| 52 | the boot program has initialized all interrupt source | ||
| 53 | configuration registers to a sane state-- masked or | ||
| 54 | directed at other cores. This ensures that the client | ||
| 55 | program will not receive interrupts for sources not belonging | ||
| 56 | to the client. The presence of this property also mandates | ||
| 57 | that any initialization related to interrupt sources shall | ||
| 58 | be limited to sources explicitly referenced in the device tree. | ||
| 59 | |||
| 60 | INTERRUPT SPECIFIER DEFINITION | ||
| 61 | |||
| 62 | Interrupt specifiers consists of 4 cells encoded as | ||
| 63 | follows: | ||
| 64 | |||
| 65 | <1st-cell> interrupt-number | ||
| 66 | |||
| 67 | Identifies the interrupt source. The meaning | ||
| 68 | depends on the type of interrupt. | ||
| 69 | |||
| 70 | Note: If the interrupt-type cell is undefined | ||
| 71 | (i.e. #interrupt-cells = 2), this cell | ||
| 72 | should be interpreted the same as for | ||
| 73 | interrupt-type 0-- i.e. an external or | ||
| 74 | normal SoC device interrupt. | ||
| 75 | |||
| 76 | <2nd-cell> level-sense information, encoded as follows: | ||
| 77 | 0 = low-to-high edge triggered | ||
| 78 | 1 = active low level-sensitive | ||
| 79 | 2 = active high level-sensitive | ||
| 80 | 3 = high-to-low edge triggered | ||
| 81 | |||
| 82 | <3rd-cell> interrupt-type | ||
| 83 | |||
| 84 | The following types are supported: | ||
| 85 | |||
| 86 | 0 = external or normal SoC device interrupt | ||
| 87 | |||
| 88 | The interrupt-number cell contains | ||
| 89 | the SoC device interrupt number. The | ||
| 90 | type-specific cell is undefined. The | ||
| 91 | interrupt-number is derived from the | ||
| 92 | MPIC a block of registers referred to as | ||
| 93 | the "Interrupt Source Configuration Registers". | ||
| 94 | Each source has 32-bytes of registers | ||
| 95 | (vector/priority and destination) in this | ||
| 96 | region. So interrupt 0 is at offset 0x0, | ||
| 97 | interrupt 1 is at offset 0x20, and so on. | ||
| 98 | |||
| 99 | 1 = error interrupt | ||
| 100 | |||
| 101 | The interrupt-number cell contains | ||
| 102 | the SoC device interrupt number for | ||
| 103 | the error interrupt. The type-specific | ||
| 104 | cell identifies the specific error | ||
| 105 | interrupt number. | ||
| 106 | |||
| 107 | 2 = MPIC inter-processor interrupt (IPI) | ||
| 108 | |||
| 109 | The interrupt-number cell identifies | ||
| 110 | the MPIC IPI number. The type-specific | ||
| 111 | cell is undefined. | ||
| 112 | |||
| 113 | 3 = MPIC timer interrupt | ||
| 114 | |||
| 115 | The interrupt-number cell identifies | ||
| 116 | the MPIC timer number. The type-specific | ||
| 117 | cell is undefined. | ||
| 118 | |||
| 119 | <4th-cell> type-specific information | ||
| 120 | |||
| 121 | The type-specific cell is encoded as follows: | ||
| 122 | |||
| 123 | - For interrupt-type 1 (error interrupt), | ||
| 124 | the type-specific cell contains the | ||
| 125 | bit number of the error interrupt in the | ||
| 126 | Error Interrupt Summary Register. | ||
| 127 | |||
| 128 | EXAMPLE 1 | ||
| 129 | /* | ||
| 130 | * mpic interrupt controller with 4 cells per specifier | ||
| 131 | */ | ||
| 132 | mpic: pic@40000 { | ||
| 133 | compatible = "fsl,mpic"; | ||
| 134 | interrupt-controller; | ||
| 135 | #interrupt-cells = <4>; | ||
| 136 | #address-cells = <0>; | ||
| 137 | reg = <0x40000 0x40000>; | ||
| 138 | }; | ||
| 139 | |||
| 140 | EXAMPLE 2 | ||
| 141 | /* | ||
| 142 | * The MPC8544 I2C controller node has an internal | ||
| 143 | * interrupt number of 27. As per the reference manual | ||
| 144 | * this corresponds to interrupt source configuration | ||
| 145 | * registers at 0x5_0560. | ||
| 146 | * | ||
| 147 | * The interrupt source configuration registers begin | ||
| 148 | * at 0x5_0000. | ||
| 149 | * | ||
| 150 | * To compute the interrupt specifier interrupt number | ||
| 151 | * | ||
| 152 | * 0x560 >> 5 = 43 | ||
| 153 | * | ||
| 154 | * The interrupt source configuration registers begin | ||
| 155 | * at 0x5_0000, and so the i2c vector/priority registers | ||
| 156 | * are at 0x5_0560. | ||
| 157 | */ | ||
| 158 | i2c@3000 { | ||
| 159 | #address-cells = <1>; | ||
| 160 | #size-cells = <0>; | ||
| 161 | cell-index = <0>; | ||
| 162 | compatible = "fsl-i2c"; | ||
| 163 | reg = <0x3000 0x100>; | ||
| 164 | interrupts = <43 2>; | ||
| 165 | interrupt-parent = <&mpic>; | ||
| 166 | dfsrr; | ||
| 167 | }; | ||
| 168 | |||
| 169 | |||
| 170 | EXAMPLE 3 | ||
| 171 | /* | ||
| 172 | * Definition of a node defining the 4 | ||
| 173 | * MPIC IPI interrupts. Note the interrupt | ||
| 174 | * type of 2. | ||
| 175 | */ | ||
| 176 | ipi@410a0 { | ||
| 177 | compatible = "fsl,mpic-ipi"; | ||
| 178 | reg = <0x40040 0x10>; | ||
| 179 | interrupts = <0 0 2 0 | ||
| 180 | 1 0 2 0 | ||
| 181 | 2 0 2 0 | ||
| 182 | 3 0 2 0>; | ||
| 183 | }; | ||
| 184 | |||
| 185 | EXAMPLE 4 | ||
| 186 | /* | ||
| 187 | * Definition of a node defining the MPIC | ||
| 188 | * global timers. Note the interrupt | ||
| 189 | * type of 3. | ||
| 190 | */ | ||
| 191 | timer0: timer@41100 { | ||
| 192 | compatible = "fsl,mpic-global-timer"; | ||
| 193 | reg = <0x41100 0x100>; | ||
| 194 | interrupts = <0 0 3 0 | ||
| 195 | 1 0 3 0 | ||
| 196 | 2 0 3 0 | ||
| 197 | 3 0 3 0>; | ||
| 198 | }; | ||
| 199 | |||
| 200 | EXAMPLE 5 | ||
| 201 | /* | ||
| 202 | * Definition of an error interrupt (interupt type 1). | ||
| 203 | * SoC interrupt number is 16 and the specific error | ||
| 204 | * interrupt bit in the error interrupt summary register | ||
| 205 | * is 23. | ||
| 206 | */ | ||
| 207 | memory-controller@8000 { | ||
| 208 | compatible = "fsl,p4080-memory-controller"; | ||
| 209 | reg = <0x8000 0x1000>; | ||
| 210 | interrupts = <16 2 1 23>; | ||
| 211 | }; | ||
diff --git a/Documentation/devicetree/bindings/powerpc/fsl/msi-pic.txt b/Documentation/devicetree/bindings/powerpc/fsl/msi-pic.txt index bcc30bac683..70558c3f368 100644 --- a/Documentation/devicetree/bindings/powerpc/fsl/msi-pic.txt +++ b/Documentation/devicetree/bindings/powerpc/fsl/msi-pic.txt | |||
| @@ -5,14 +5,21 @@ Required properties: | |||
| 5 | first is "fsl,CHIP-msi", where CHIP is the processor(mpc8610, mpc8572, | 5 | first is "fsl,CHIP-msi", where CHIP is the processor(mpc8610, mpc8572, |
| 6 | etc.) and the second is "fsl,mpic-msi" or "fsl,ipic-msi" depending on | 6 | etc.) and the second is "fsl,mpic-msi" or "fsl,ipic-msi" depending on |
| 7 | the parent type. | 7 | the parent type. |
| 8 | |||
| 8 | - reg : should contain the address and the length of the shared message | 9 | - reg : should contain the address and the length of the shared message |
| 9 | interrupt register set. | 10 | interrupt register set. |
| 11 | |||
| 10 | - msi-available-ranges: use <start count> style section to define which | 12 | - msi-available-ranges: use <start count> style section to define which |
| 11 | msi interrupt can be used in the 256 msi interrupts. This property is | 13 | msi interrupt can be used in the 256 msi interrupts. This property is |
| 12 | optional, without this, all the 256 MSI interrupts can be used. | 14 | optional, without this, all the 256 MSI interrupts can be used. |
| 15 | Each available range must begin and end on a multiple of 32 (i.e. | ||
| 16 | no splitting an individual MSI register or the associated PIC interrupt). | ||
| 17 | |||
| 13 | - interrupts : each one of the interrupts here is one entry per 32 MSIs, | 18 | - interrupts : each one of the interrupts here is one entry per 32 MSIs, |
| 14 | and routed to the host interrupt controller. the interrupts should | 19 | and routed to the host interrupt controller. the interrupts should |
| 15 | be set as edge sensitive. | 20 | be set as edge sensitive. If msi-available-ranges is present, only |
| 21 | the interrupts that correspond to available ranges shall be present. | ||
| 22 | |||
| 16 | - interrupt-parent: the phandle for the interrupt controller | 23 | - interrupt-parent: the phandle for the interrupt controller |
| 17 | that services interrupts for this device. for 83xx cpu, the interrupts | 24 | that services interrupts for this device. for 83xx cpu, the interrupts |
| 18 | are routed to IPIC, and for 85xx/86xx cpu the interrupts are routed | 25 | are routed to IPIC, and for 85xx/86xx cpu the interrupts are routed |
