2006-10-04 13:16:59 +04:00
|
|
|
#ifndef LINUX_MSI_H
|
|
|
|
#define LINUX_MSI_H
|
|
|
|
|
2011-10-06 22:08:18 +04:00
|
|
|
#include <linux/kobject.h>
|
2007-04-05 11:19:10 +04:00
|
|
|
#include <linux/list.h>
|
|
|
|
|
2006-10-04 13:16:59 +04:00
|
|
|
struct msi_msg {
|
|
|
|
u32 address_lo; /* low 32 bits of msi message address */
|
|
|
|
u32 address_hi; /* high 32 bits of msi message address */
|
|
|
|
u32 data; /* 16 bits of msi message data */
|
|
|
|
};
|
|
|
|
|
2007-01-18 07:50:05 +03:00
|
|
|
/* Helper functions */
|
2010-09-28 18:46:51 +04:00
|
|
|
struct irq_data;
|
2010-09-28 21:09:51 +04:00
|
|
|
struct msi_desc;
|
2013-04-18 20:55:46 +04:00
|
|
|
void mask_msi_irq(struct irq_data *data);
|
|
|
|
void unmask_msi_irq(struct irq_data *data);
|
|
|
|
void __read_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
|
|
|
|
void __get_cached_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
|
|
|
|
void __write_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
|
|
|
|
void read_msi_msg(unsigned int irq, struct msi_msg *msg);
|
|
|
|
void get_cached_msi_msg(unsigned int irq, struct msi_msg *msg);
|
|
|
|
void write_msi_msg(unsigned int irq, struct msi_msg *msg);
|
2006-10-04 13:16:59 +04:00
|
|
|
|
|
|
|
struct msi_desc {
|
|
|
|
struct {
|
2009-03-17 15:54:06 +03:00
|
|
|
__u8 is_msix : 1;
|
2014-06-19 12:30:30 +04:00
|
|
|
__u8 multiple: 3; /* log2 num of messages allocated */
|
|
|
|
__u8 multi_cap : 3; /* log2 num of messages supported */
|
2013-11-14 22:28:18 +04:00
|
|
|
__u8 maskbit : 1; /* mask-pending bit supported ? */
|
|
|
|
__u8 is_64 : 1; /* Address size: 0=32bit 1=64bit */
|
|
|
|
__u16 entry_nr; /* specific enabled entry */
|
|
|
|
unsigned default_irq; /* default pre-assigned irq */
|
2009-03-17 15:54:09 +03:00
|
|
|
} msi_attrib;
|
2006-10-04 13:16:59 +04:00
|
|
|
|
2009-03-17 15:54:09 +03:00
|
|
|
u32 masked; /* mask bits */
|
2007-04-05 11:19:10 +04:00
|
|
|
unsigned int irq;
|
PCI: Allocate only as many MSI vectors as requested by driver
Because of the encoding of the "Multiple Message Capable" and "Multiple
Message Enable" fields, a device can only advertise that it's capable of a
power-of-two number of vectors, and the OS can only enable a power-of-two
number.
For example, a device that's limited internally to using 18 vectors would
have to advertise that it's capable of 32. The 14 extra vectors consume
vector numbers and IRQ descriptors even though the device can't actually
use them.
This fix introduces a 'msi_desc::nvec_used' field to address this issue.
When non-zero, it is the actual number of MSIs the device will send, as
requested by the device driver. This value should be used by architectures
to set up and tear down only as many interrupt resources as the device will
actually use.
Note, although the existing 'msi_desc::multiple' field might seem
redundant, in fact it is not. The number of MSIs advertised need not be
the smallest power-of-two larger than the number of MSIs the device will
send. Thus, it is not always possible to derive the former from the
latter, so we need to keep them both to handle this case.
[bhelgaas: changelog, rename to "nvec_used"]
Signed-off-by: Alexander Gordeev <agordeev@redhat.com>
Signed-off-by: Bjorn Helgaas <bhelgaas@google.com>
2013-05-13 13:05:48 +04:00
|
|
|
unsigned int nvec_used; /* number of messages */
|
2007-04-05 11:19:10 +04:00
|
|
|
struct list_head list;
|
2006-10-04 13:16:59 +04:00
|
|
|
|
2009-03-17 15:54:08 +03:00
|
|
|
union {
|
|
|
|
void __iomem *mask_base;
|
|
|
|
u8 mask_pos;
|
|
|
|
};
|
2006-10-04 13:16:59 +04:00
|
|
|
struct pci_dev *dev;
|
|
|
|
|
2007-03-08 23:04:57 +03:00
|
|
|
/* Last set MSI message */
|
|
|
|
struct msi_msg msg;
|
2006-10-04 13:16:59 +04:00
|
|
|
};
|
|
|
|
|
|
|
|
/*
|
2013-08-10 00:27:06 +04:00
|
|
|
* The arch hooks to setup up msi irqs. Those functions are
|
|
|
|
* implemented as weak symbols so that they /can/ be overriden by
|
|
|
|
* architecture specific code if needed.
|
2006-10-04 13:16:59 +04:00
|
|
|
*/
|
2007-01-28 22:56:37 +03:00
|
|
|
int arch_setup_msi_irq(struct pci_dev *dev, struct msi_desc *desc);
|
2006-10-04 13:16:59 +04:00
|
|
|
void arch_teardown_msi_irq(unsigned int irq);
|
2013-04-18 20:55:46 +04:00
|
|
|
int arch_setup_msi_irqs(struct pci_dev *dev, int nvec, int type);
|
|
|
|
void arch_teardown_msi_irqs(struct pci_dev *dev);
|
2013-12-04 09:09:16 +04:00
|
|
|
void arch_restore_msi_irqs(struct pci_dev *dev);
|
2013-08-10 00:27:06 +04:00
|
|
|
|
|
|
|
void default_teardown_msi_irqs(struct pci_dev *dev);
|
2013-12-04 09:09:16 +04:00
|
|
|
void default_restore_msi_irqs(struct pci_dev *dev);
|
2013-11-07 01:16:56 +04:00
|
|
|
u32 default_msi_mask_irq(struct msi_desc *desc, u32 mask, u32 flag);
|
|
|
|
u32 default_msix_mask_irq(struct msi_desc *desc, u32 flag);
|
2006-10-04 13:16:59 +04:00
|
|
|
|
2013-08-10 00:27:08 +04:00
|
|
|
struct msi_chip {
|
|
|
|
struct module *owner;
|
|
|
|
struct device *dev;
|
2013-08-10 00:27:09 +04:00
|
|
|
struct device_node *of_node;
|
|
|
|
struct list_head list;
|
2013-08-10 00:27:08 +04:00
|
|
|
|
|
|
|
int (*setup_irq)(struct msi_chip *chip, struct pci_dev *dev,
|
|
|
|
struct msi_desc *desc);
|
|
|
|
void (*teardown_irq)(struct msi_chip *chip, unsigned int irq);
|
|
|
|
};
|
|
|
|
|
2006-10-04 13:16:59 +04:00
|
|
|
#endif /* LINUX_MSI_H */
|