irqchip/gic-v3-its: Add support for device tree msi-map and msi-mask
authorFrank Li <Frank.Li@nxp.com>
Mon, 14 Apr 2025 18:30:59 +0000 (14:30 -0400)
committerThomas Gleixner <tglx@linutronix.de>
Wed, 7 May 2025 15:49:24 +0000 (17:49 +0200)
commitf1680d9081e161925c3aca81231ee867c95890b0
tree0c89067ac010265a936f90dc3d8dbe3c6c096117
parenta6aed6b9c79e57064fa8c028662214b436578e80
irqchip/gic-v3-its: Add support for device tree msi-map and msi-mask

Some platform devices create child devices dynamically and require the
parent device's msi-map to map device IDs to actual sideband information.

A typical use case is using ITS as a PCIe Endpoint Controller(EPC)'s
doorbell function, where PCI hosts send TLP memory writes to the EP
controller. The EP controller converts these writes to AXI transactions
and appends platform-specific sideband information.

EPC's DTS will provide such information by msi-map and msi-mask. A
simplified dts as

pcie-ep@10000000 {
...
msi-map = <0 &its 0xc 8>;
                          ^^^ 0xc is implement defined sideband information,
      which append to AXI write transaction.
           ^ 0 is function index.

msi-mask = <0x7>
}

Check msi-map if msi-parent missed to keep compatility with existing systems.

Signed-off-by: Frank Li <Frank.Li@nxp.com>
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Link: https://lore.kernel.org/all/20250414-ep-msi-v18-5-f69b49917464@nxp.com
drivers/irqchip/irq-gic-v3-its-msi-parent.c