4 #include "qemu-common.h"
5 #include "hw/xen/xen_common.h"
6 #include "hw/pci/pci.h"
7 #include "xen-host-pci-device.h"
9 void xen_pt_log(const PCIDevice
*d
, const char *f
, ...) GCC_FMT_ATTR(2, 3);
11 #define XEN_PT_ERR(d, _f, _a...) xen_pt_log(d, "%s: Error: "_f, __func__, ##_a)
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)
18 # define XEN_PT_LOG(d, _f, _a...)
19 # define XEN_PT_WARN(d, _f, _a...)
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)
27 # define XEN_PT_LOG_CONFIG(d, addr, val, len)
32 #define XEN_PFN(x) ((x) >> XC_PAGE_SHIFT)
34 typedef struct XenPTRegInfo XenPTRegInfo
;
35 typedef struct XenPTReg XenPTReg
;
37 typedef struct XenPCIPassthroughState XenPCIPassthroughState
;
39 /* function type for config reg */
40 typedef int (*xen_pt_conf_reg_init
)
41 (XenPCIPassthroughState
*, XenPTRegInfo
*, uint32_t real_offset
,
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
);
62 #define XEN_PT_BAR_ALLF 0xFFFFFFFF
63 #define XEN_PT_BAR_UNMAPPED (-1)
65 #define PCI_CAP_MAX 48
69 XEN_PT_GRP_TYPE_HARDWIRED
= 0, /* 0 Hardwired reg group */
70 XEN_PT_GRP_TYPE_EMU
, /* emul reg group */
71 } XenPTRegisterGroupType
;
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 */
81 typedef struct XenPTRegion
{
83 XenPTBarFlag bar_flag
;
84 /* Translation of the emulated address */
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.
99 /* emulated register information */
100 struct XenPTRegInfo
{
104 /* reg reserved field mask (ON:reserved, OFF:defined) */
106 /* reg read only field mask (ON:RO/ROS, OFF:other) */
108 /* reg emulate field mask (ON:emu, OFF:passthrough) */
110 xen_pt_conf_reg_init init
;
111 /* read/write function pointer
112 * for double_word/word/byte size */
115 xen_pt_conf_dword_write write
;
116 xen_pt_conf_dword_read read
;
119 xen_pt_conf_word_write write
;
120 xen_pt_conf_word_read read
;
123 xen_pt_conf_byte_write write
;
124 xen_pt_conf_byte_read read
;
129 /* emulated register management */
131 QLIST_ENTRY(XenPTReg
) entries
;
133 uint32_t data
; /* emulated value */
136 typedef struct XenPTRegGroupInfo XenPTRegGroupInfo
;
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
);
143 /* emulated register group information */
144 struct XenPTRegGroupInfo
{
146 XenPTRegisterGroupType grp_type
;
148 xen_pt_reg_size_init_fn size_init
;
149 XenPTRegInfo
*emu_regs
;
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
;
158 QLIST_HEAD(, XenPTReg
) reg_tbl_list
;
162 #define XEN_PT_UNASSIGNED_PIRQ (-1)
163 typedef struct XenPTMSI
{
165 uint32_t addr_lo
; /* guest message address */
166 uint32_t addr_hi
; /* guest message upper address */
167 uint16_t data
; /* guest message data */
168 uint32_t ctrl_offset
; /* saved control offset */
169 int pirq
; /* guest pirq corresponding */
170 bool initialized
; /* when guest MSI is initialized */
171 bool mapped
; /* when pirq is mapped */
174 typedef struct XenPTMSIXEntry
{
178 uint32_t vector_ctrl
;
179 bool updated
; /* indicate whether MSI ADDR or DATA is updated */
180 bool warned
; /* avoid issuing (bogus) warning more than once */
182 typedef struct XenPTMSIX
{
183 uint32_t ctrl_offset
;
188 uint32_t table_offset_adjust
; /* page align mmap */
189 uint64_t mmio_base_addr
;
191 void *phys_iomem_base
;
192 XenPTMSIXEntry msix_entry
[0];
195 struct XenPCIPassthroughState
{
198 PCIHostDeviceAddress hostaddr
;
201 bool permissive_warned
;
202 XenHostPCIDevice real_device
;
203 XenPTRegion bases
[PCI_NUM_REGIONS
]; /* Access regions */
204 QLIST_HEAD(, XenPTRegGroup
) reg_grps
;
206 uint32_t machine_irq
;
211 MemoryRegion bar
[PCI_NUM_REGIONS
- 1];
214 MemoryListener memory_listener
;
215 MemoryListener io_listener
;
218 int xen_pt_config_init(XenPCIPassthroughState
*s
);
219 void xen_pt_config_delete(XenPCIPassthroughState
*s
);
220 XenPTRegGroup
*xen_pt_find_reg_grp(XenPCIPassthroughState
*s
, uint32_t address
);
221 XenPTReg
*xen_pt_find_reg(XenPTRegGroup
*reg_grp
, uint32_t address
);
222 int xen_pt_bar_offset_to_index(uint32_t offset
);
224 static inline pcibus_t
xen_pt_get_emul_size(XenPTBarFlag flag
, pcibus_t r_size
)
226 /* align resource size (memory type only) */
227 if (flag
== XEN_PT_BAR_FLAG_MEM
) {
228 return (r_size
+ XC_PAGE_SIZE
- 1) & XC_PAGE_MASK
;
235 /* The PCI Local Bus Specification, Rev. 3.0,
236 * Section 6.2.4 Miscellaneous Registers, pp 223
237 * outlines 5 valid values for the interrupt pin (intx).
238 * 0: For devices (or device functions) that don't use an interrupt in
244 * Xen uses the following 4 values for intx
250 * Observing that these list of values are not the same, xen_pt_pci_read_intx()
251 * uses the following mapping from hw to xen values.
252 * This seems to reflect the current usage within Xen.
254 * PCI hardware | Xen | Notes
255 * ----------------+-----+----------------------------------------------------
256 * 0 | 0 | No interrupt
261 * any other value | 0 | This should never happen, log error message
264 static inline uint8_t xen_pt_pci_read_intx(XenPCIPassthroughState
*s
)
267 xen_host_pci_get_byte(&s
->real_device
, PCI_INTERRUPT_PIN
, &v
);
271 static inline uint8_t xen_pt_pci_intx(XenPCIPassthroughState
*s
)
273 uint8_t r_val
= xen_pt_pci_read_intx(s
);
275 XEN_PT_LOG(&s
->dev
, "intx=%i\n", r_val
);
276 if (r_val
< 1 || r_val
> 4) {
277 XEN_PT_LOG(&s
->dev
, "Interrupt pin read from hardware is out of range:"
278 " value=%i, acceptable range is 1 - 4\n", r_val
);
288 int xen_pt_msi_set_enable(XenPCIPassthroughState
*s
, bool en
);
289 int xen_pt_msi_setup(XenPCIPassthroughState
*s
);
290 int xen_pt_msi_update(XenPCIPassthroughState
*d
);
291 void xen_pt_msi_disable(XenPCIPassthroughState
*s
);
293 int xen_pt_msix_init(XenPCIPassthroughState
*s
, uint32_t base
);
294 void xen_pt_msix_delete(XenPCIPassthroughState
*s
);
295 int xen_pt_msix_update(XenPCIPassthroughState
*s
);
296 int xen_pt_msix_update_remap(XenPCIPassthroughState
*s
, int bar_index
);
297 void xen_pt_msix_disable(XenPCIPassthroughState
*s
);
299 static inline bool xen_pt_has_msix_mapping(XenPCIPassthroughState
*s
, int bar
)
301 return s
->msix
&& s
->msix
->bar_index
== bar
;
305 #endif /* !XEN_PT_H */