mpic.txt (7509B)
1===================================================================== 2Freescale MPIC Interrupt Controller Node 3Copyright (C) 2010,2011 Freescale Semiconductor Inc. 4===================================================================== 5 6The Freescale MPIC interrupt controller is found on all PowerQUICC 7and QorIQ processors and is compatible with the Open PIC. The 8notable difference from Open PIC binding is the addition of 2 9additional cells in the interrupt specifier defining interrupt type 10information. 11 12PROPERTIES 13 14 - compatible 15 Usage: required 16 Value type: <string> 17 Definition: Shall include "fsl,mpic". Freescale MPIC 18 controllers compatible with this binding have Block 19 Revision Registers BRR1 and BRR2 at offset 0x0 and 20 0x10 in the MPIC. 21 22 - reg 23 Usage: required 24 Value type: <prop-encoded-array> 25 Definition: A standard property. Specifies the physical 26 offset and length of the device's registers within the 27 CCSR address space. 28 29 - interrupt-controller 30 Usage: required 31 Value type: <empty> 32 Definition: Specifies that this node is an interrupt 33 controller 34 35 - #interrupt-cells 36 Usage: required 37 Value type: <u32> 38 Definition: Shall be 2 or 4. A value of 2 means that interrupt 39 specifiers do not contain the interrupt-type or type-specific 40 information cells. 41 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 - big-endian 61 Usage: optional 62 Value type: <empty> 63 If present the MPIC will be assumed to be big-endian. Some 64 device-trees omit this property on MPIC nodes even when the MPIC is 65 in fact big-endian, so certain boards override this property. 66 67 - single-cpu-affinity 68 Usage: optional 69 Value type: <empty> 70 If present the MPIC will be assumed to only be able to route 71 non-IPI interrupts to a single CPU at a time (EG: Freescale MPIC). 72 73 - last-interrupt-source 74 Usage: optional 75 Value type: <u32> 76 Some MPICs do not correctly report the number of hardware sources 77 in the global feature registers. If specified, this field will 78 override the value read from MPIC_GREG_FEATURE_LAST_SRC. 79 80INTERRUPT SPECIFIER DEFINITION 81 82 Interrupt specifiers consists of 4 cells encoded as 83 follows: 84 85 <1st-cell> interrupt-number 86 87 Identifies the interrupt source. The meaning 88 depends on the type of interrupt. 89 90 Note: If the interrupt-type cell is undefined 91 (i.e. #interrupt-cells = 2), this cell 92 should be interpreted the same as for 93 interrupt-type 0-- i.e. an external or 94 normal SoC device interrupt. 95 96 <2nd-cell> level-sense information, encoded as follows: 97 0 = low-to-high edge triggered 98 1 = active low level-sensitive 99 2 = active high level-sensitive 100 3 = high-to-low edge triggered 101 102 <3rd-cell> interrupt-type 103 104 The following types are supported: 105 106 0 = external or normal SoC device interrupt 107 108 The interrupt-number cell contains 109 the SoC device interrupt number. The 110 type-specific cell is undefined. The 111 interrupt-number is derived from the 112 MPIC a block of registers referred to as 113 the "Interrupt Source Configuration Registers". 114 Each source has 32-bytes of registers 115 (vector/priority and destination) in this 116 region. So interrupt 0 is at offset 0x0, 117 interrupt 1 is at offset 0x20, and so on. 118 119 1 = error interrupt 120 121 The interrupt-number cell contains 122 the SoC device interrupt number for 123 the error interrupt. The type-specific 124 cell identifies the specific error 125 interrupt number. 126 127 2 = MPIC inter-processor interrupt (IPI) 128 129 The interrupt-number cell identifies 130 the MPIC IPI number. The type-specific 131 cell is undefined. 132 133 3 = MPIC timer interrupt 134 135 The interrupt-number cell identifies 136 the MPIC timer number. The type-specific 137 cell is undefined. 138 139 <4th-cell> type-specific information 140 141 The type-specific cell is encoded as follows: 142 143 - For interrupt-type 1 (error interrupt), 144 the type-specific cell contains the 145 bit number of the error interrupt in the 146 Error Interrupt Summary Register. 147 148EXAMPLE 1 149 /* 150 * mpic interrupt controller with 4 cells per specifier 151 */ 152 mpic: pic@40000 { 153 compatible = "fsl,mpic"; 154 interrupt-controller; 155 #interrupt-cells = <4>; 156 #address-cells = <0>; 157 reg = <0x40000 0x40000>; 158 }; 159 160EXAMPLE 2 161 /* 162 * The MPC8544 I2C controller node has an internal 163 * interrupt number of 27. As per the reference manual 164 * this corresponds to interrupt source configuration 165 * registers at 0x5_0560. 166 * 167 * The interrupt source configuration registers begin 168 * at 0x5_0000. 169 * 170 * To compute the interrupt specifier interrupt number 171 * 172 * 0x560 >> 5 = 43 173 * 174 * The interrupt source configuration registers begin 175 * at 0x5_0000, and so the i2c vector/priority registers 176 * are at 0x5_0560. 177 */ 178 i2c@3000 { 179 #address-cells = <1>; 180 #size-cells = <0>; 181 cell-index = <0>; 182 compatible = "fsl-i2c"; 183 reg = <0x3000 0x100>; 184 interrupts = <43 2>; 185 interrupt-parent = <&mpic>; 186 dfsrr; 187 }; 188 189 190EXAMPLE 3 191 /* 192 * Definition of a node defining the 4 193 * MPIC IPI interrupts. Note the interrupt 194 * type of 2. 195 */ 196 ipi@410a0 { 197 compatible = "fsl,mpic-ipi"; 198 reg = <0x40040 0x10>; 199 interrupts = <0 0 2 0 200 1 0 2 0 201 2 0 2 0 202 3 0 2 0>; 203 }; 204 205EXAMPLE 4 206 /* 207 * Definition of a node defining the MPIC 208 * global timers. Note the interrupt 209 * type of 3. 210 */ 211 timer0: timer@41100 { 212 compatible = "fsl,mpic-global-timer"; 213 reg = <0x41100 0x100 0x41300 4>; 214 interrupts = <0 0 3 0 215 1 0 3 0 216 2 0 3 0 217 3 0 3 0>; 218 }; 219 220EXAMPLE 5 221 /* 222 * Definition of an error interrupt (interrupt type 1). 223 * SoC interrupt number is 16 and the specific error 224 * interrupt bit in the error interrupt summary register 225 * is 23. 226 */ 227 memory-controller@8000 { 228 compatible = "fsl,p4080-memory-controller"; 229 reg = <0x8000 0x1000>; 230 interrupts = <16 2 1 23>; 231 };