xref: /linux-6.15/include/linux/msi.h (revision 173d6681)
1 #ifndef LINUX_MSI_H
2 #define LINUX_MSI_H
3 
4 struct msi_msg {
5 	u32	address_lo;	/* low 32 bits of msi message address */
6 	u32	address_hi;	/* high 32 bits of msi message address */
7 	u32	data;		/* 16 bits of msi message data */
8 };
9 
10 /* Heper functions */
11 extern void mask_msi_irq(unsigned int irq);
12 extern void unmask_msi_irq(unsigned int irq);
13 extern void read_msi_msg(unsigned int irq, struct msi_msg *msg);
14 
15 extern void write_msi_msg(unsigned int irq, struct msi_msg *msg);
16 
17 struct msi_desc {
18 	struct {
19 		__u8	type	: 5; 	/* {0: unused, 5h:MSI, 11h:MSI-X} */
20 		__u8	maskbit	: 1; 	/* mask-pending bit supported ?   */
21 		__u8	unused	: 1;
22 		__u8	is_64	: 1;	/* Address size: 0=32bit 1=64bit  */
23 		__u8	pos;	 	/* Location of the msi capability */
24 		__u16	entry_nr;    	/* specific enabled entry 	  */
25 		unsigned default_irq;	/* default pre-assigned irq	  */
26 	}msi_attrib;
27 
28 	struct {
29 		__u16	head;
30 		__u16	tail;
31 	}link;
32 
33 	void __iomem *mask_base;
34 	struct pci_dev *dev;
35 
36 #ifdef CONFIG_PM
37 	/* PM save area for MSIX address/data */
38 	struct msi_msg msg_save;
39 #endif
40 };
41 
42 /*
43  * The arch hook for setup up msi irqs
44  */
45 int arch_setup_msi_irq(unsigned int irq, struct pci_dev *dev);
46 void arch_teardown_msi_irq(unsigned int irq);
47 
48 
49 #endif /* LINUX_MSI_H */
50