Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: pci: layerscape-pci: define AER/PME interrupts

Different platforms using this controller are using different numbers of
interrupt lines and the routing of events to these interrupt lines are
different too. So instead of trying to define names for these interrupt
lines, we define the more specific AER/PME events that are routed to
these interrupt lines.

For platforms which only has a single interrupt line for miscellaneous
controller events, we can keep using the original "intr" name for
backward compatibility.

Also change the example from ls1021a to ls1088a for better representation.

Link: https://lore.kernel.org/r/20220311234938.8706-5-leoyang.li@nxp.com
Signed-off-by: Li Yang <leoyang.li@nxp.com>
Signed-off-by: Lorenzo Pieralisi <lorenzo.pieralisi@arm.com>
Reviewed-by: Rob Herring <robh@kernel.org>

authored by

Li Yang and committed by
Lorenzo Pieralisi
a3b18f5f cddc1a9a

+32 -26
+32 -26
Documentation/devicetree/bindings/pci/layerscape-pci.txt
··· 31 31 - reg: base addresses and lengths of the PCIe controller register blocks. 32 32 - interrupts: A list of interrupt outputs of the controller. Must contain an 33 33 entry for each entry in the interrupt-names property. 34 - - interrupt-names: Must include the following entries: 35 - "intr": The interrupt that is asserted for controller interrupts 34 + - interrupt-names: It could include the following entries: 35 + "aer": Used for interrupt line which reports AER events when 36 + non MSI/MSI-X/INTx mode is used 37 + "pme": Used for interrupt line which reports PME events when 38 + non MSI/MSI-X/INTx mode is used 39 + "intr": Used for SoCs(like ls2080a, lx2160a, ls2080a, ls2088a, ls1088a) 40 + which has a single interrupt line for miscellaneous controller 41 + events(could include AER and PME events). 36 42 - fsl,pcie-scfg: Must include two entries. 37 43 The first entry must be a link to the SCFG device node 38 44 The second entry is the physical PCIe controller index starting from '0'. ··· 53 47 54 48 Example: 55 49 56 - pcie@3400000 { 57 - compatible = "fsl,ls1021a-pcie"; 58 - reg = <0x00 0x03400000 0x0 0x00010000 /* controller registers */ 59 - 0x40 0x00000000 0x0 0x00002000>; /* configuration space */ 60 - reg-names = "regs", "config"; 61 - interrupts = <GIC_SPI 177 IRQ_TYPE_LEVEL_HIGH>; /* controller interrupt */ 62 - interrupt-names = "intr"; 63 - fsl,pcie-scfg = <&scfg 0>; 64 - #address-cells = <3>; 65 - #size-cells = <2>; 66 - device_type = "pci"; 67 - dma-coherent; 68 - num-lanes = <4>; 69 - bus-range = <0x0 0xff>; 70 - ranges = <0x81000000 0x0 0x00000000 0x40 0x00010000 0x0 0x00010000 /* downstream I/O */ 71 - 0xc2000000 0x0 0x20000000 0x40 0x20000000 0x0 0x20000000 /* prefetchable memory */ 72 - 0x82000000 0x0 0x40000000 0x40 0x40000000 0x0 0x40000000>; /* non-prefetchable memory */ 73 - #interrupt-cells = <1>; 74 - interrupt-map-mask = <0 0 0 7>; 75 - interrupt-map = <0000 0 0 1 &gic GIC_SPI 91 IRQ_TYPE_LEVEL_HIGH>, 76 - <0000 0 0 2 &gic GIC_SPI 188 IRQ_TYPE_LEVEL_HIGH>, 77 - <0000 0 0 3 &gic GIC_SPI 190 IRQ_TYPE_LEVEL_HIGH>, 78 - <0000 0 0 4 &gic GIC_SPI 192 IRQ_TYPE_LEVEL_HIGH>; 79 - }; 50 + pcie@3400000 { 51 + compatible = "fsl,ls1088a-pcie"; 52 + reg = <0x00 0x03400000 0x0 0x00100000>, /* controller registers */ 53 + <0x20 0x00000000 0x0 0x00002000>; /* configuration space */ 54 + reg-names = "regs", "config"; 55 + interrupts = <0 108 IRQ_TYPE_LEVEL_HIGH>; /* aer interrupt */ 56 + interrupt-names = "aer"; 57 + #address-cells = <3>; 58 + #size-cells = <2>; 59 + device_type = "pci"; 60 + dma-coherent; 61 + num-viewport = <256>; 62 + bus-range = <0x0 0xff>; 63 + ranges = <0x81000000 0x0 0x00000000 0x20 0x00010000 0x0 0x00010000 /* downstream I/O */ 64 + 0x82000000 0x0 0x40000000 0x20 0x40000000 0x0 0x40000000>; /* non-prefetchable memory */ 65 + msi-parent = <&its>; 66 + #interrupt-cells = <1>; 67 + interrupt-map-mask = <0 0 0 7>; 68 + interrupt-map = <0000 0 0 1 &gic 0 0 0 109 IRQ_TYPE_LEVEL_HIGH>, 69 + <0000 0 0 2 &gic 0 0 0 110 IRQ_TYPE_LEVEL_HIGH>, 70 + <0000 0 0 3 &gic 0 0 0 111 IRQ_TYPE_LEVEL_HIGH>, 71 + <0000 0 0 4 &gic 0 0 0 112 IRQ_TYPE_LEVEL_HIGH>; 72 + iommu-map = <0 &smmu 0 1>; /* Fixed-up by bootloader */ 73 + };