LXR linux/include/linux/msi.h

   1#ifndef LINUX_MSI_H
   2#define LINUX_MSI_H
   3
   4#include <linux/kobject.h>
   5#include <linux/list.h>
   6
   7struct msi_msg {
   8        u32     address_lo;     /* low 32 bits of msi message address */
   9        u32     address_hi;     /* high 32 bits of msi message address */
  10        u32     data;           /* 16 bits of msi message data */
  11};
  12
  13/* Helper functions */
  14struct irq_data;
  15struct msi_desc;
  16void mask_msi_irq(struct irq_data *data);
  17void unmask_msi_irq(struct irq_data *data);
  18void __read_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
  19void __get_cached_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
  20void __write_msi_msg(struct msi_desc *entry, struct msi_msg *msg);
  21void read_msi_msg(unsigned int irq, struct msi_msg *msg);
  22void get_cached_msi_msg(unsigned int irq, struct msi_msg *msg);
  23void write_msi_msg(unsigned int irq, struct msi_msg *msg);
  24
  25struct msi_desc {
  26        struct {
  27                __u8    is_msix : 1;
  28                __u8    multiple: 3;    /* log2 number of messages */
  29                __u8    maskbit : 1;    /* mask-pending bit supported ?   */
  30                __u8    is_64   : 1;    /* Address size: 0=32bit 1=64bit  */
  31                __u8    pos;            /* Location of the msi capability */
  32                __u16   entry_nr;       /* specific enabled entry         */
  33                unsigned default_irq;   /* default pre-assigned irq       */
  34        } msi_attrib;
  35
  36        u32 masked;                     /* mask bits */
  37        unsigned int irq;
  38        unsigned int nvec_used;         /* number of messages */
  39        struct list_head list;
  40
  41        union {
  42                void __iomem *mask_base;
  43                u8 mask_pos;
  44        };
  45        struct pci_dev *dev;
  46
  47        /* Last set MSI message */
  48        struct msi_msg msg;
  49
  50        struct kobject kobj;
  51};
  52
  53/*
  54 * The arch hooks to setup up msi irqs. Those functions are
  55 * implemented as weak symbols so that they /can/ be overriden by
  56 * architecture specific code if needed.
  57 */
  58int arch_setup_msi_irq(struct pci_dev *dev, struct msi_desc *desc);
  59void arch_teardown_msi_irq(unsigned int irq);
  60int arch_setup_msi_irqs(struct pci_dev *dev, int nvec, int type);
  61void arch_teardown_msi_irqs(struct pci_dev *dev);
  62int arch_msi_check_device(struct pci_dev* dev, int nvec, int type);
  63void arch_restore_msi_irqs(struct pci_dev *dev, int irq);
  64
  65void default_teardown_msi_irqs(struct pci_dev *dev);
  66void default_restore_msi_irqs(struct pci_dev *dev, int irq);
  67
  68struct msi_chip {
  69        struct module *owner;
  70        struct device *dev;
  71        struct device_node *of_node;
  72        struct list_head list;
  73
  74        int (*setup_irq)(struct msi_chip *chip, struct pci_dev *dev,
  75                         struct msi_desc *desc);
  76        void (*teardown_irq)(struct msi_chip *chip, unsigned int irq);
  77        int (*check_device)(struct msi_chip *chip, struct pci_dev *dev,
  78                            int nvec, int type);
  79};
  80
  81#endif /* LINUX_MSI_H */
  82