hw/xen_pt.h

   1 #ifndef XEN_PT_H
   2 #define XEN_PT_H
   3
   4 #include "qemu-common.h"
   5 #include "xen_common.h"
   6 #include "pci.h"
   7 #include "xen-host-pci-device.h"
   8
   9 void xen_pt_log(const PCIDevice *d, const char *f, ...) GCC_FMT_ATTR(2, 3);
  10
  11 #define XEN_PT_ERR(d, _f, _a...) xen_pt_log(d, "%s: Error: "_f, __func__, ##_a)
  12
  13 #ifdef XEN_PT_LOGGING_ENABLED
  14 #  define XEN_PT_LOG(d, _f, _a...)  xen_pt_log(d, "%s: " _f, __func__, ##_a)
  15 #  define XEN_PT_WARN(d, _f, _a...) \
  16     xen_pt_log(d, "%s: Warning: "_f, __func__, ##_a)
  17 #else
  18 #  define XEN_PT_LOG(d, _f, _a...)
  19 #  define XEN_PT_WARN(d, _f, _a...)
  20 #endif
  21
  22 #ifdef XEN_PT_DEBUG_PCI_CONFIG_ACCESS
  23 #  define XEN_PT_LOG_CONFIG(d, addr, val, len) \
  24     xen_pt_log(d, "%s: address=0x%04x val=0x%08x len=%d\n", \
  25                __func__, addr, val, len)
  26 #else
  27 #  define XEN_PT_LOG_CONFIG(d, addr, val, len)
  28 #endif
  29
  30
  31 /* Helper */
  32 #define XEN_PFN(x) ((x) >> XC_PAGE_SHIFT)
  33
  34 typedef struct XenPTRegInfo XenPTRegInfo;
  35 typedef struct XenPTReg XenPTReg;
  36
  37 typedef struct XenPCIPassthroughState XenPCIPassthroughState;
  38
  39 /* function type for config reg */
  40 typedef int (*xen_pt_conf_reg_init)
  41     (XenPCIPassthroughState *, XenPTRegInfo *, uint32_t real_offset,
  42      uint32_t *data);
  43 typedef int (*xen_pt_conf_dword_write)
  44     (XenPCIPassthroughState *, XenPTReg *cfg_entry,
  45      uint32_t *val, uint32_t dev_value, uint32_t valid_mask);
  46 typedef int (*xen_pt_conf_word_write)
  47     (XenPCIPassthroughState *, XenPTReg *cfg_entry,
  48      uint16_t *val, uint16_t dev_value, uint16_t valid_mask);
  49 typedef int (*xen_pt_conf_byte_write)
  50     (XenPCIPassthroughState *, XenPTReg *cfg_entry,
  51      uint8_t *val, uint8_t dev_value, uint8_t valid_mask);
  52 typedef int (*xen_pt_conf_dword_read)
  53     (XenPCIPassthroughState *, XenPTReg *cfg_entry,
  54      uint32_t *val, uint32_t valid_mask);
  55 typedef int (*xen_pt_conf_word_read)
  56     (XenPCIPassthroughState *, XenPTReg *cfg_entry,
  57      uint16_t *val, uint16_t valid_mask);
  58 typedef int (*xen_pt_conf_byte_read)
  59     (XenPCIPassthroughState *, XenPTReg *cfg_entry,
  60      uint8_t *val, uint8_t valid_mask);
  61
  62 #define XEN_PT_BAR_ALLF 0xFFFFFFFF
  63 #define XEN_PT_BAR_UNMAPPED (-1)
  64
  65 #define PCI_CAP_MAX 48
  66
  67
  68 typedef enum {
  69     XEN_PT_GRP_TYPE_HARDWIRED = 0,  /* 0 Hardwired reg group */
  70     XEN_PT_GRP_TYPE_EMU,            /* emul reg group */
  71 } XenPTRegisterGroupType;
  72
  73 typedef enum {
  74     XEN_PT_BAR_FLAG_MEM = 0,        /* Memory type BAR */
  75     XEN_PT_BAR_FLAG_IO,             /* I/O type BAR */
  76     XEN_PT_BAR_FLAG_UPPER,          /* upper 64bit BAR */
  77     XEN_PT_BAR_FLAG_UNUSED,         /* unused BAR */
  78 } XenPTBarFlag;
  79
  80
  81 typedef struct XenPTRegion {
  82     /* BAR flag */
  83     XenPTBarFlag bar_flag;
  84     /* Translation of the emulated address */
  85     union {
  86         uint64_t maddr;
  87         uint64_t pio_base;
  88         uint64_t u;
  89     } access;
  90 } XenPTRegion;
  91
  92 /* XenPTRegInfo declaration
  93  * - only for emulated register (either a part or whole bit).
  94  * - for passthrough register that need special behavior (like interacting with
  95  *   other component), set emu_mask to all 0 and specify r/w func properly.
  96  * - do NOT use ALL F for init_val, otherwise the tbl will not be registered.
  97  */
  98
  99 /* emulated register infomation */
 100 struct XenPTRegInfo {
 101     uint32_t offset;
 102     uint32_t size;
 103     uint32_t init_val;
 104     /* reg read only field mask (ON:RO/ROS, OFF:other) */
 105     uint32_t ro_mask;
 106     /* reg emulate field mask (ON:emu, OFF:passthrough) */
 107     uint32_t emu_mask;
 108     /* no write back allowed */
 109     uint32_t no_wb;
 110     xen_pt_conf_reg_init init;
 111     /* read/write function pointer
 112      * for double_word/word/byte size */
 113     union {
 114         struct {
 115             xen_pt_conf_dword_write write;
 116             xen_pt_conf_dword_read read;
 117         } dw;
 118         struct {
 119             xen_pt_conf_word_write write;
 120             xen_pt_conf_word_read read;
 121         } w;
 122         struct {
 123             xen_pt_conf_byte_write write;
 124             xen_pt_conf_byte_read read;
 125         } b;
 126     } u;
 127 };
 128
 129 /* emulated register management */
 130 struct XenPTReg {
 131     QLIST_ENTRY(XenPTReg) entries;
 132     XenPTRegInfo *reg;
 133     uint32_t data; /* emulated value */
 134 };
 135
 136 typedef struct XenPTRegGroupInfo XenPTRegGroupInfo;
 137
 138 /* emul reg group size initialize method */
 139 typedef int (*xen_pt_reg_size_init_fn)
 140     (XenPCIPassthroughState *, const XenPTRegGroupInfo *,
 141      uint32_t base_offset, uint8_t *size);
 142
 143 /* emulated register group infomation */
 144 struct XenPTRegGroupInfo {
 145     uint8_t grp_id;
 146     XenPTRegisterGroupType grp_type;
 147     uint8_t grp_size;
 148     xen_pt_reg_size_init_fn size_init;
 149     XenPTRegInfo *emu_regs;
 150 };
 151
 152 /* emul register group management table */
 153 typedef struct XenPTRegGroup {
 154     QLIST_ENTRY(XenPTRegGroup) entries;
 155     const XenPTRegGroupInfo *reg_grp;
 156     uint32_t base_offset;
 157     uint8_t size;
 158     QLIST_HEAD(, XenPTReg) reg_tbl_list;
 159 } XenPTRegGroup;
 160
 161
 162 #define XEN_PT_UNASSIGNED_PIRQ (-1)
 163
 164 struct XenPCIPassthroughState {
 165     PCIDevice dev;
 166
 167     PCIHostDeviceAddress hostaddr;
 168     bool is_virtfn;
 169     XenHostPCIDevice real_device;
 170     XenPTRegion bases[PCI_NUM_REGIONS]; /* Access regions */
 171     QLIST_HEAD(, XenPTRegGroup) reg_grps;
 172
 173     uint32_t machine_irq;
 174
 175     MemoryRegion bar[PCI_NUM_REGIONS - 1];
 176     MemoryRegion rom;
 177
 178     MemoryListener memory_listener;
 179 };
 180
 181 int xen_pt_config_init(XenPCIPassthroughState *s);
 182 void xen_pt_config_delete(XenPCIPassthroughState *s);
 183 XenPTRegGroup *xen_pt_find_reg_grp(XenPCIPassthroughState *s, uint32_t address);
 184 XenPTReg *xen_pt_find_reg(XenPTRegGroup *reg_grp, uint32_t address);
 185 int xen_pt_bar_offset_to_index(uint32_t offset);
 186
 187 static inline pcibus_t xen_pt_get_emul_size(XenPTBarFlag flag, pcibus_t r_size)
 188 {
 189     /* align resource size (memory type only) */
 190     if (flag == XEN_PT_BAR_FLAG_MEM) {
 191         return (r_size + XC_PAGE_SIZE - 1) & XC_PAGE_MASK;
 192     } else {
 193         return r_size;
 194     }
 195 }
 196
 197 /* INTx */
 198 /* The PCI Local Bus Specification, Rev. 3.0,
 199  * Section 6.2.4 Miscellaneous Registers, pp 223
 200  * outlines 5 valid values for the interrupt pin (intx).
 201  *  0: For devices (or device functions) that don't use an interrupt in
 202  *  1: INTA#
 203  *  2: INTB#
 204  *  3: INTC#
 205  *  4: INTD#
 206  *
 207  * Xen uses the following 4 values for intx
 208  *  0: INTA#
 209  *  1: INTB#
 210  *  2: INTC#
 211  *  3: INTD#
 212  *
 213  * Observing that these list of values are not the same, xen_pt_pci_read_intx()
 214  * uses the following mapping from hw to xen values.
 215  * This seems to reflect the current usage within Xen.
 216  *
 217  * PCI hardware    | Xen | Notes
 218  * ----------------+-----+----------------------------------------------------
 219  * 0               | 0   | No interrupt
 220  * 1               | 0   | INTA#
 221  * 2               | 1   | INTB#
 222  * 3               | 2   | INTC#
 223  * 4               | 3   | INTD#
 224  * any other value | 0   | This should never happen, log error message
 225  */
 226
 227 static inline uint8_t xen_pt_pci_read_intx(XenPCIPassthroughState *s)
 228 {
 229     uint8_t v = 0;
 230     xen_host_pci_get_byte(&s->real_device, PCI_INTERRUPT_PIN, &v);
 231     return v;
 232 }
 233
 234 static inline uint8_t xen_pt_pci_intx(XenPCIPassthroughState *s)
 235 {
 236     uint8_t r_val = xen_pt_pci_read_intx(s);
 237
 238     XEN_PT_LOG(&s->dev, "intx=%i\n", r_val);
 239     if (r_val < 1 || r_val > 4) {
 240         XEN_PT_LOG(&s->dev, "Interrupt pin read from hardware is out of range:"
 241                    " value=%i, acceptable range is 1 - 4\n", r_val);
 242         r_val = 0;
 243     } else {
 244         r_val -= 1;
 245     }
 246
 247     return r_val;
 248 }
 249
 250 #endif /* !XEN_PT_H */