2 * QEMU VMWARE PVSCSI paravirtual SCSI bus
4 * Copyright (c) 2012 Ravello Systems LTD (http://ravellosystems.com)
6 * Developed by Daynix Computing LTD (http://www.daynix.com)
8 * Based on implementation by Paolo Bonzini
9 * http://lists.gnu.org/archive/html/qemu-devel/2011-08/msg00729.html
16 * This work is licensed under the terms of the GNU GPL, version 2.
17 * See the COPYING file in the top-level directory.
20 * MSI-X support has been removed for the moment because it leads Windows OS
21 * to crash on startup. The crash happens because Windows driver requires
22 * MSI-X shared memory to be part of the same BAR used for rings state
23 * registers, etc. This is not supported by QEMU infrastructure so separate
24 * BAR created from MSI-X purposes. Windows driver fails to deal with 2 BARs.
28 #include "qemu/osdep.h"
29 #include "qapi/error.h"
30 #include "qemu/main-loop.h"
31 #include "qemu/module.h"
32 #include "hw/scsi/scsi.h"
33 #include "migration/vmstate.h"
34 #include "scsi/constants.h"
35 #include "hw/pci/msi.h"
36 #include "hw/qdev-properties.h"
37 #include "vmw_pvscsi.h"
39 #include "qom/object.h"
42 #define PVSCSI_USE_64BIT (true)
43 #define PVSCSI_PER_VECTOR_MASK (false)
45 #define PVSCSI_MAX_DEVS (64)
46 #define PVSCSI_MSIX_NUM_VECTORS (1)
48 #define PVSCSI_MAX_SG_ELEM 2048
50 #define PVSCSI_MAX_CMD_DATA_WORDS \
51 (sizeof(PVSCSICmdDescSetupRings)/sizeof(uint32_t))
53 #define RS_GET_FIELD(m, field) \
54 (ldl_le_pci_dma(&container_of(m, PVSCSIState, rings)->parent_obj, \
55 (m)->rs_pa + offsetof(struct PVSCSIRingsState, field)))
56 #define RS_SET_FIELD(m, field, val) \
57 (stl_le_pci_dma(&container_of(m, PVSCSIState, rings)->parent_obj, \
58 (m)->rs_pa + offsetof(struct PVSCSIRingsState, field), val))
61 PCIDeviceClass parent_class;
62 DeviceRealize parent_dc_realize;
64 typedef struct PVSCSIClass PVSCSIClass;
66 #define TYPE_PVSCSI "pvscsi"
67 typedef struct PVSCSIState PVSCSIState;
68 #define PVSCSI(obj) OBJECT_CHECK(PVSCSIState, (obj), TYPE_PVSCSI)
70 #define PVSCSI_CLASS(klass) \
71 OBJECT_CLASS_CHECK(PVSCSIClass, (klass), TYPE_PVSCSI)
72 #define PVSCSI_GET_CLASS(obj) \
73 OBJECT_GET_CLASS(PVSCSIClass, (obj), TYPE_PVSCSI)
75 /* Compatibility flags for migration */
76 #define PVSCSI_COMPAT_OLD_PCI_CONFIGURATION_BIT 0
77 #define PVSCSI_COMPAT_OLD_PCI_CONFIGURATION \
78 (1 << PVSCSI_COMPAT_OLD_PCI_CONFIGURATION_BIT)
79 #define PVSCSI_COMPAT_DISABLE_PCIE_BIT 1
80 #define PVSCSI_COMPAT_DISABLE_PCIE \
81 (1 << PVSCSI_COMPAT_DISABLE_PCIE_BIT)
83 #define PVSCSI_USE_OLD_PCI_CONFIGURATION(s) \
84 ((s)->compat_flags & PVSCSI_COMPAT_OLD_PCI_CONFIGURATION)
85 #define PVSCSI_MSI_OFFSET(s) \
86 (PVSCSI_USE_OLD_PCI_CONFIGURATION(s) ? 0x50 : 0x7c)
87 #define PVSCSI_EXP_EP_OFFSET (0x40)
89 typedef struct PVSCSIRingInfo {
91 uint32_t txr_len_mask;
92 uint32_t rxr_len_mask;
93 uint32_t msg_len_mask;
94 uint64_t req_ring_pages_pa[PVSCSI_SETUP_RINGS_MAX_NUM_PAGES];
95 uint64_t cmp_ring_pages_pa[PVSCSI_SETUP_RINGS_MAX_NUM_PAGES];
96 uint64_t msg_ring_pages_pa[PVSCSI_SETUP_MSG_RING_MAX_NUM_PAGES];
97 uint64_t consumed_ptr;
98 uint64_t filled_cmp_ptr;
99 uint64_t filled_msg_ptr;
102 typedef struct PVSCSISGState {
108 typedef QTAILQ_HEAD(, PVSCSIRequest) PVSCSIRequestList;
111 PCIDevice parent_obj;
112 MemoryRegion io_space;
114 QEMUBH *completion_worker;
115 PVSCSIRequestList pending_queue;
116 PVSCSIRequestList completion_queue;
118 uint64_t reg_interrupt_status; /* Interrupt status register value */
119 uint64_t reg_interrupt_enabled; /* Interrupt mask register value */
120 uint64_t reg_command_status; /* Command status register value */
122 /* Command data adoption mechanism */
123 uint64_t curr_cmd; /* Last command arrived */
124 uint32_t curr_cmd_data_cntr; /* Amount of data for last command */
126 /* Collector for current command data */
127 uint32_t curr_cmd_data[PVSCSI_MAX_CMD_DATA_WORDS];
129 uint8_t rings_info_valid; /* Whether data rings initialized */
130 uint8_t msg_ring_info_valid; /* Whether message ring initialized */
131 uint8_t use_msg; /* Whether to use message ring */
133 uint8_t msi_used; /* For migration compatibility */
134 PVSCSIRingInfo rings; /* Data transfer rings manager */
135 uint32_t resetting; /* Reset in progress */
137 uint32_t compat_flags;
140 typedef struct PVSCSIRequest {
148 struct PVSCSIRingReqDesc req;
149 struct PVSCSIRingCmpDesc cmp;
150 QTAILQ_ENTRY(PVSCSIRequest) next;
153 /* Integer binary logarithm */
155 pvscsi_log2(uint32_t input)
159 while (input >> ++log) {
165 pvscsi_ring_init_data(PVSCSIRingInfo *m, PVSCSICmdDescSetupRings *ri)
168 uint32_t txr_len_log2, rxr_len_log2;
169 uint32_t req_ring_size, cmp_ring_size;
170 m->rs_pa = ri->ringsStatePPN << VMW_PAGE_SHIFT;
172 req_ring_size = ri->reqRingNumPages * PVSCSI_MAX_NUM_REQ_ENTRIES_PER_PAGE;
173 cmp_ring_size = ri->cmpRingNumPages * PVSCSI_MAX_NUM_CMP_ENTRIES_PER_PAGE;
174 txr_len_log2 = pvscsi_log2(req_ring_size - 1);
175 rxr_len_log2 = pvscsi_log2(cmp_ring_size - 1);
177 m->txr_len_mask = MASK(txr_len_log2);
178 m->rxr_len_mask = MASK(rxr_len_log2);
181 m->filled_cmp_ptr = 0;
183 for (i = 0; i < ri->reqRingNumPages; i++) {
184 m->req_ring_pages_pa[i] = ri->reqRingPPNs[i] << VMW_PAGE_SHIFT;
187 for (i = 0; i < ri->cmpRingNumPages; i++) {
188 m->cmp_ring_pages_pa[i] = ri->cmpRingPPNs[i] << VMW_PAGE_SHIFT;
191 RS_SET_FIELD(m, reqProdIdx, 0);
192 RS_SET_FIELD(m, reqConsIdx, 0);
193 RS_SET_FIELD(m, reqNumEntriesLog2, txr_len_log2);
195 RS_SET_FIELD(m, cmpProdIdx, 0);
196 RS_SET_FIELD(m, cmpConsIdx, 0);
197 RS_SET_FIELD(m, cmpNumEntriesLog2, rxr_len_log2);
199 trace_pvscsi_ring_init_data(txr_len_log2, rxr_len_log2);
201 /* Flush ring state page changes */
206 pvscsi_ring_init_msg(PVSCSIRingInfo *m, PVSCSICmdDescSetupMsgRing *ri)
212 if (!ri->numPages || ri->numPages > PVSCSI_SETUP_MSG_RING_MAX_NUM_PAGES) {
215 ring_size = ri->numPages * PVSCSI_MAX_NUM_MSG_ENTRIES_PER_PAGE;
216 len_log2 = pvscsi_log2(ring_size - 1);
218 m->msg_len_mask = MASK(len_log2);
220 m->filled_msg_ptr = 0;
222 for (i = 0; i < ri->numPages; i++) {
223 m->msg_ring_pages_pa[i] = ri->ringPPNs[i] << VMW_PAGE_SHIFT;
226 RS_SET_FIELD(m, msgProdIdx, 0);
227 RS_SET_FIELD(m, msgConsIdx, 0);
228 RS_SET_FIELD(m, msgNumEntriesLog2, len_log2);
230 trace_pvscsi_ring_init_msg(len_log2);
232 /* Flush ring state page changes */
239 pvscsi_ring_cleanup(PVSCSIRingInfo *mgr)
242 mgr->txr_len_mask = 0;
243 mgr->rxr_len_mask = 0;
244 mgr->msg_len_mask = 0;
245 mgr->consumed_ptr = 0;
246 mgr->filled_cmp_ptr = 0;
247 mgr->filled_msg_ptr = 0;
248 memset(mgr->req_ring_pages_pa, 0, sizeof(mgr->req_ring_pages_pa));
249 memset(mgr->cmp_ring_pages_pa, 0, sizeof(mgr->cmp_ring_pages_pa));
250 memset(mgr->msg_ring_pages_pa, 0, sizeof(mgr->msg_ring_pages_pa));
254 pvscsi_ring_pop_req_descr(PVSCSIRingInfo *mgr)
256 uint32_t ready_ptr = RS_GET_FIELD(mgr, reqProdIdx);
257 uint32_t ring_size = PVSCSI_MAX_NUM_PAGES_REQ_RING
258 * PVSCSI_MAX_NUM_REQ_ENTRIES_PER_PAGE;
260 if (ready_ptr != mgr->consumed_ptr
261 && ready_ptr - mgr->consumed_ptr < ring_size) {
262 uint32_t next_ready_ptr =
263 mgr->consumed_ptr++ & mgr->txr_len_mask;
264 uint32_t next_ready_page =
265 next_ready_ptr / PVSCSI_MAX_NUM_REQ_ENTRIES_PER_PAGE;
266 uint32_t inpage_idx =
267 next_ready_ptr % PVSCSI_MAX_NUM_REQ_ENTRIES_PER_PAGE;
269 return mgr->req_ring_pages_pa[next_ready_page] +
270 inpage_idx * sizeof(PVSCSIRingReqDesc);
277 pvscsi_ring_flush_req(PVSCSIRingInfo *mgr)
279 RS_SET_FIELD(mgr, reqConsIdx, mgr->consumed_ptr);
283 pvscsi_ring_pop_cmp_descr(PVSCSIRingInfo *mgr)
286 * According to Linux driver code it explicitly verifies that number
287 * of requests being processed by device is less then the size of
288 * completion queue, so device may omit completion queue overflow
289 * conditions check. We assume that this is true for other (Windows)
293 uint32_t free_cmp_ptr =
294 mgr->filled_cmp_ptr++ & mgr->rxr_len_mask;
295 uint32_t free_cmp_page =
296 free_cmp_ptr / PVSCSI_MAX_NUM_CMP_ENTRIES_PER_PAGE;
297 uint32_t inpage_idx =
298 free_cmp_ptr % PVSCSI_MAX_NUM_CMP_ENTRIES_PER_PAGE;
299 return mgr->cmp_ring_pages_pa[free_cmp_page] +
300 inpage_idx * sizeof(PVSCSIRingCmpDesc);
304 pvscsi_ring_pop_msg_descr(PVSCSIRingInfo *mgr)
306 uint32_t free_msg_ptr =
307 mgr->filled_msg_ptr++ & mgr->msg_len_mask;
308 uint32_t free_msg_page =
309 free_msg_ptr / PVSCSI_MAX_NUM_MSG_ENTRIES_PER_PAGE;
310 uint32_t inpage_idx =
311 free_msg_ptr % PVSCSI_MAX_NUM_MSG_ENTRIES_PER_PAGE;
312 return mgr->msg_ring_pages_pa[free_msg_page] +
313 inpage_idx * sizeof(PVSCSIRingMsgDesc);
317 pvscsi_ring_flush_cmp(PVSCSIRingInfo *mgr)
319 /* Flush descriptor changes */
322 trace_pvscsi_ring_flush_cmp(mgr->filled_cmp_ptr);
324 RS_SET_FIELD(mgr, cmpProdIdx, mgr->filled_cmp_ptr);
328 pvscsi_ring_msg_has_room(PVSCSIRingInfo *mgr)
330 uint32_t prodIdx = RS_GET_FIELD(mgr, msgProdIdx);
331 uint32_t consIdx = RS_GET_FIELD(mgr, msgConsIdx);
333 return (prodIdx - consIdx) < (mgr->msg_len_mask + 1);
337 pvscsi_ring_flush_msg(PVSCSIRingInfo *mgr)
339 /* Flush descriptor changes */
342 trace_pvscsi_ring_flush_msg(mgr->filled_msg_ptr);
344 RS_SET_FIELD(mgr, msgProdIdx, mgr->filled_msg_ptr);
348 pvscsi_reset_state(PVSCSIState *s)
350 s->curr_cmd = PVSCSI_CMD_FIRST;
351 s->curr_cmd_data_cntr = 0;
352 s->reg_command_status = PVSCSI_COMMAND_PROCESSING_SUCCEEDED;
353 s->reg_interrupt_status = 0;
354 pvscsi_ring_cleanup(&s->rings);
355 s->rings_info_valid = FALSE;
356 s->msg_ring_info_valid = FALSE;
357 QTAILQ_INIT(&s->pending_queue);
358 QTAILQ_INIT(&s->completion_queue);
362 pvscsi_update_irq_status(PVSCSIState *s)
364 PCIDevice *d = PCI_DEVICE(s);
365 bool should_raise = s->reg_interrupt_enabled & s->reg_interrupt_status;
367 trace_pvscsi_update_irq_level(should_raise, s->reg_interrupt_enabled,
368 s->reg_interrupt_status);
370 if (msi_enabled(d)) {
372 trace_pvscsi_update_irq_msi();
373 msi_notify(d, PVSCSI_VECTOR_COMPLETION);
378 pci_set_irq(d, !!should_raise);
382 pvscsi_raise_completion_interrupt(PVSCSIState *s)
384 s->reg_interrupt_status |= PVSCSI_INTR_CMPL_0;
386 /* Memory barrier to flush interrupt status register changes*/
389 pvscsi_update_irq_status(s);
393 pvscsi_raise_message_interrupt(PVSCSIState *s)
395 s->reg_interrupt_status |= PVSCSI_INTR_MSG_0;
397 /* Memory barrier to flush interrupt status register changes*/
400 pvscsi_update_irq_status(s);
404 pvscsi_cmp_ring_put(PVSCSIState *s, struct PVSCSIRingCmpDesc *cmp_desc)
408 cmp_descr_pa = pvscsi_ring_pop_cmp_descr(&s->rings);
409 trace_pvscsi_cmp_ring_put(cmp_descr_pa);
410 cpu_physical_memory_write(cmp_descr_pa, cmp_desc, sizeof(*cmp_desc));
414 pvscsi_msg_ring_put(PVSCSIState *s, struct PVSCSIRingMsgDesc *msg_desc)
418 msg_descr_pa = pvscsi_ring_pop_msg_descr(&s->rings);
419 trace_pvscsi_msg_ring_put(msg_descr_pa);
420 cpu_physical_memory_write(msg_descr_pa, msg_desc, sizeof(*msg_desc));
424 pvscsi_process_completion_queue(void *opaque)
426 PVSCSIState *s = opaque;
427 PVSCSIRequest *pvscsi_req;
428 bool has_completed = false;
430 while (!QTAILQ_EMPTY(&s->completion_queue)) {
431 pvscsi_req = QTAILQ_FIRST(&s->completion_queue);
432 QTAILQ_REMOVE(&s->completion_queue, pvscsi_req, next);
433 pvscsi_cmp_ring_put(s, &pvscsi_req->cmp);
435 has_completed = true;
439 pvscsi_ring_flush_cmp(&s->rings);
440 pvscsi_raise_completion_interrupt(s);
445 pvscsi_reset_adapter(PVSCSIState *s)
448 qbus_reset_all(BUS(&s->bus));
450 pvscsi_process_completion_queue(s);
451 assert(QTAILQ_EMPTY(&s->pending_queue));
452 pvscsi_reset_state(s);
456 pvscsi_schedule_completion_processing(PVSCSIState *s)
458 /* Try putting more complete requests on the ring. */
459 if (!QTAILQ_EMPTY(&s->completion_queue)) {
460 qemu_bh_schedule(s->completion_worker);
465 pvscsi_complete_request(PVSCSIState *s, PVSCSIRequest *r)
467 assert(!r->completed);
469 trace_pvscsi_complete_request(r->cmp.context, r->cmp.dataLen,
471 if (r->sreq != NULL) {
472 scsi_req_unref(r->sreq);
476 QTAILQ_REMOVE(&s->pending_queue, r, next);
477 QTAILQ_INSERT_TAIL(&s->completion_queue, r, next);
478 pvscsi_schedule_completion_processing(s);
481 static QEMUSGList *pvscsi_get_sg_list(SCSIRequest *r)
483 PVSCSIRequest *req = r->hba_private;
485 trace_pvscsi_get_sg_list(req->sgl.nsg, req->sgl.size);
491 pvscsi_get_next_sg_elem(PVSCSISGState *sg)
493 struct PVSCSISGElement elem;
495 cpu_physical_memory_read(sg->elemAddr, &elem, sizeof(elem));
496 if ((elem.flags & ~PVSCSI_KNOWN_FLAGS) != 0) {
498 * There is PVSCSI_SGE_FLAG_CHAIN_ELEMENT flag described in
499 * header file but its value is unknown. This flag requires
500 * additional processing, so we put warning here to catch it
501 * some day and make proper implementation
503 trace_pvscsi_get_next_sg_elem(elem.flags);
506 sg->elemAddr += sizeof(elem);
507 sg->dataAddr = elem.addr;
508 sg->resid = elem.length;
512 pvscsi_write_sense(PVSCSIRequest *r, uint8_t *sense, int len)
514 r->cmp.senseLen = MIN(r->req.senseLen, len);
515 r->sense_key = sense[(sense[0] & 2) ? 1 : 2];
516 cpu_physical_memory_write(r->req.senseAddr, sense, r->cmp.senseLen);
520 pvscsi_command_complete(SCSIRequest *req, uint32_t status, size_t resid)
522 PVSCSIRequest *pvscsi_req = req->hba_private;
526 trace_pvscsi_command_complete_not_found(req->tag);
532 /* Short transfer. */
533 trace_pvscsi_command_complete_data_run();
534 pvscsi_req->cmp.hostStatus = BTSTAT_DATARUN;
537 pvscsi_req->cmp.scsiStatus = status;
538 if (pvscsi_req->cmp.scsiStatus == CHECK_CONDITION) {
539 uint8_t sense[SCSI_SENSE_BUF_SIZE];
541 scsi_req_get_sense(pvscsi_req->sreq, sense, sizeof(sense));
543 trace_pvscsi_command_complete_sense_len(sense_len);
544 pvscsi_write_sense(pvscsi_req, sense, sense_len);
546 qemu_sglist_destroy(&pvscsi_req->sgl);
547 pvscsi_complete_request(s, pvscsi_req);
551 pvscsi_send_msg(PVSCSIState *s, SCSIDevice *dev, uint32_t msg_type)
553 if (s->msg_ring_info_valid && pvscsi_ring_msg_has_room(&s->rings)) {
554 PVSCSIMsgDescDevStatusChanged msg = {0};
557 msg.bus = dev->channel;
558 msg.target = dev->id;
559 msg.lun[1] = dev->lun;
561 pvscsi_msg_ring_put(s, (PVSCSIRingMsgDesc *)&msg);
562 pvscsi_ring_flush_msg(&s->rings);
563 pvscsi_raise_message_interrupt(s);
568 pvscsi_hotplug(HotplugHandler *hotplug_dev, DeviceState *dev, Error **errp)
570 PVSCSIState *s = PVSCSI(hotplug_dev);
572 pvscsi_send_msg(s, SCSI_DEVICE(dev), PVSCSI_MSG_DEV_ADDED);
576 pvscsi_hot_unplug(HotplugHandler *hotplug_dev, DeviceState *dev, Error **errp)
578 PVSCSIState *s = PVSCSI(hotplug_dev);
580 pvscsi_send_msg(s, SCSI_DEVICE(dev), PVSCSI_MSG_DEV_REMOVED);
581 qdev_simple_device_unplug_cb(hotplug_dev, dev, errp);
585 pvscsi_request_cancelled(SCSIRequest *req)
587 PVSCSIRequest *pvscsi_req = req->hba_private;
588 PVSCSIState *s = pvscsi_req->dev;
590 if (pvscsi_req->completed) {
594 if (pvscsi_req->dev->resetting) {
595 pvscsi_req->cmp.hostStatus = BTSTAT_BUSRESET;
597 pvscsi_req->cmp.hostStatus = BTSTAT_ABORTQUEUE;
600 pvscsi_complete_request(s, pvscsi_req);
604 pvscsi_device_find(PVSCSIState *s, int channel, int target,
605 uint8_t *requested_lun, uint8_t *target_lun)
607 if (requested_lun[0] || requested_lun[2] || requested_lun[3] ||
608 requested_lun[4] || requested_lun[5] || requested_lun[6] ||
609 requested_lun[7] || (target > PVSCSI_MAX_DEVS)) {
612 *target_lun = requested_lun[1];
613 return scsi_device_find(&s->bus, channel, target, *target_lun);
617 static PVSCSIRequest *
618 pvscsi_queue_pending_descriptor(PVSCSIState *s, SCSIDevice **d,
619 struct PVSCSIRingReqDesc *descr)
621 PVSCSIRequest *pvscsi_req;
624 pvscsi_req = g_malloc0(sizeof(*pvscsi_req));
626 pvscsi_req->req = *descr;
627 pvscsi_req->cmp.context = pvscsi_req->req.context;
628 QTAILQ_INSERT_TAIL(&s->pending_queue, pvscsi_req, next);
630 *d = pvscsi_device_find(s, descr->bus, descr->target, descr->lun, &lun);
632 pvscsi_req->lun = lun;
639 pvscsi_convert_sglist(PVSCSIRequest *r)
641 uint32_t chunk_size, elmcnt = 0;
642 uint64_t data_length = r->req.dataLen;
643 PVSCSISGState sg = r->sg;
644 while (data_length && elmcnt < PVSCSI_MAX_SG_ELEM) {
645 while (!sg.resid && elmcnt++ < PVSCSI_MAX_SG_ELEM) {
646 pvscsi_get_next_sg_elem(&sg);
647 trace_pvscsi_convert_sglist(r->req.context, r->sg.dataAddr,
650 chunk_size = MIN(data_length, sg.resid);
652 qemu_sglist_add(&r->sgl, sg.dataAddr, chunk_size);
655 sg.dataAddr += chunk_size;
656 data_length -= chunk_size;
657 sg.resid -= chunk_size;
662 pvscsi_build_sglist(PVSCSIState *s, PVSCSIRequest *r)
664 PCIDevice *d = PCI_DEVICE(s);
666 pci_dma_sglist_init(&r->sgl, d, 1);
667 if (r->req.flags & PVSCSI_FLAG_CMD_WITH_SG_LIST) {
668 pvscsi_convert_sglist(r);
670 qemu_sglist_add(&r->sgl, r->req.dataAddr, r->req.dataLen);
675 pvscsi_process_request_descriptor(PVSCSIState *s,
676 struct PVSCSIRingReqDesc *descr)
679 PVSCSIRequest *r = pvscsi_queue_pending_descriptor(s, &d, descr);
682 trace_pvscsi_process_req_descr(descr->cdb[0], descr->context);
685 r->cmp.hostStatus = BTSTAT_SELTIMEO;
686 trace_pvscsi_process_req_descr_unknown_device();
687 pvscsi_complete_request(s, r);
691 if (descr->flags & PVSCSI_FLAG_CMD_WITH_SG_LIST) {
692 r->sg.elemAddr = descr->dataAddr;
695 r->sreq = scsi_req_new(d, descr->context, r->lun, descr->cdb, r);
696 if (r->sreq->cmd.mode == SCSI_XFER_FROM_DEV &&
697 (descr->flags & PVSCSI_FLAG_CMD_DIR_TODEVICE)) {
698 r->cmp.hostStatus = BTSTAT_BADMSG;
699 trace_pvscsi_process_req_descr_invalid_dir();
700 scsi_req_cancel(r->sreq);
703 if (r->sreq->cmd.mode == SCSI_XFER_TO_DEV &&
704 (descr->flags & PVSCSI_FLAG_CMD_DIR_TOHOST)) {
705 r->cmp.hostStatus = BTSTAT_BADMSG;
706 trace_pvscsi_process_req_descr_invalid_dir();
707 scsi_req_cancel(r->sreq);
711 pvscsi_build_sglist(s, r);
712 n = scsi_req_enqueue(r->sreq);
715 scsi_req_continue(r->sreq);
720 pvscsi_process_io(PVSCSIState *s)
722 PVSCSIRingReqDesc descr;
723 hwaddr next_descr_pa;
725 if (!s->rings_info_valid) {
729 while ((next_descr_pa = pvscsi_ring_pop_req_descr(&s->rings)) != 0) {
731 /* Only read after production index verification */
734 trace_pvscsi_process_io(next_descr_pa);
735 cpu_physical_memory_read(next_descr_pa, &descr, sizeof(descr));
736 pvscsi_process_request_descriptor(s, &descr);
739 pvscsi_ring_flush_req(&s->rings);
743 pvscsi_dbg_dump_tx_rings_config(PVSCSICmdDescSetupRings *rc)
746 trace_pvscsi_tx_rings_ppn("Rings State", rc->ringsStatePPN);
748 trace_pvscsi_tx_rings_num_pages("Request Ring", rc->reqRingNumPages);
749 for (i = 0; i < rc->reqRingNumPages; i++) {
750 trace_pvscsi_tx_rings_ppn("Request Ring", rc->reqRingPPNs[i]);
753 trace_pvscsi_tx_rings_num_pages("Confirm Ring", rc->cmpRingNumPages);
754 for (i = 0; i < rc->cmpRingNumPages; i++) {
755 trace_pvscsi_tx_rings_ppn("Confirm Ring", rc->cmpRingPPNs[i]);
760 pvscsi_on_cmd_config(PVSCSIState *s)
762 trace_pvscsi_on_cmd_noimpl("PVSCSI_CMD_CONFIG");
763 return PVSCSI_COMMAND_PROCESSING_FAILED;
767 pvscsi_on_cmd_unplug(PVSCSIState *s)
769 trace_pvscsi_on_cmd_noimpl("PVSCSI_CMD_DEVICE_UNPLUG");
770 return PVSCSI_COMMAND_PROCESSING_FAILED;
774 pvscsi_on_issue_scsi(PVSCSIState *s)
776 trace_pvscsi_on_cmd_noimpl("PVSCSI_CMD_ISSUE_SCSI");
777 return PVSCSI_COMMAND_PROCESSING_FAILED;
781 pvscsi_on_cmd_setup_rings(PVSCSIState *s)
783 PVSCSICmdDescSetupRings *rc =
784 (PVSCSICmdDescSetupRings *) s->curr_cmd_data;
786 trace_pvscsi_on_cmd_arrived("PVSCSI_CMD_SETUP_RINGS");
788 if (!rc->reqRingNumPages
789 || rc->reqRingNumPages > PVSCSI_SETUP_RINGS_MAX_NUM_PAGES
790 || !rc->cmpRingNumPages
791 || rc->cmpRingNumPages > PVSCSI_SETUP_RINGS_MAX_NUM_PAGES) {
792 return PVSCSI_COMMAND_PROCESSING_FAILED;
795 pvscsi_dbg_dump_tx_rings_config(rc);
796 pvscsi_ring_init_data(&s->rings, rc);
798 s->rings_info_valid = TRUE;
799 return PVSCSI_COMMAND_PROCESSING_SUCCEEDED;
803 pvscsi_on_cmd_abort(PVSCSIState *s)
805 PVSCSICmdDescAbortCmd *cmd = (PVSCSICmdDescAbortCmd *) s->curr_cmd_data;
806 PVSCSIRequest *r, *next;
808 trace_pvscsi_on_cmd_abort(cmd->context, cmd->target);
810 QTAILQ_FOREACH_SAFE(r, &s->pending_queue, next, next) {
811 if (r->req.context == cmd->context) {
816 assert(!r->completed);
817 r->cmp.hostStatus = BTSTAT_ABORTQUEUE;
818 scsi_req_cancel(r->sreq);
821 return PVSCSI_COMMAND_PROCESSING_SUCCEEDED;
825 pvscsi_on_cmd_unknown(PVSCSIState *s)
827 trace_pvscsi_on_cmd_unknown_data(s->curr_cmd_data[0]);
828 return PVSCSI_COMMAND_PROCESSING_FAILED;
832 pvscsi_on_cmd_reset_device(PVSCSIState *s)
834 uint8_t target_lun = 0;
835 struct PVSCSICmdDescResetDevice *cmd =
836 (struct PVSCSICmdDescResetDevice *) s->curr_cmd_data;
839 sdev = pvscsi_device_find(s, 0, cmd->target, cmd->lun, &target_lun);
841 trace_pvscsi_on_cmd_reset_dev(cmd->target, (int) target_lun, sdev);
845 device_legacy_reset(&sdev->qdev);
847 return PVSCSI_COMMAND_PROCESSING_SUCCEEDED;
850 return PVSCSI_COMMAND_PROCESSING_FAILED;
854 pvscsi_on_cmd_reset_bus(PVSCSIState *s)
856 trace_pvscsi_on_cmd_arrived("PVSCSI_CMD_RESET_BUS");
859 qbus_reset_all(BUS(&s->bus));
861 return PVSCSI_COMMAND_PROCESSING_SUCCEEDED;
865 pvscsi_on_cmd_setup_msg_ring(PVSCSIState *s)
867 PVSCSICmdDescSetupMsgRing *rc =
868 (PVSCSICmdDescSetupMsgRing *) s->curr_cmd_data;
870 trace_pvscsi_on_cmd_arrived("PVSCSI_CMD_SETUP_MSG_RING");
873 return PVSCSI_COMMAND_PROCESSING_FAILED;
876 if (s->rings_info_valid) {
877 if (pvscsi_ring_init_msg(&s->rings, rc) < 0) {
878 return PVSCSI_COMMAND_PROCESSING_FAILED;
880 s->msg_ring_info_valid = TRUE;
882 return sizeof(PVSCSICmdDescSetupMsgRing) / sizeof(uint32_t);
886 pvscsi_on_cmd_adapter_reset(PVSCSIState *s)
888 trace_pvscsi_on_cmd_arrived("PVSCSI_CMD_ADAPTER_RESET");
890 pvscsi_reset_adapter(s);
891 return PVSCSI_COMMAND_PROCESSING_SUCCEEDED;
894 static const struct {
896 uint64_t (*handler_fn)(PVSCSIState *s);
897 } pvscsi_commands[] = {
898 [PVSCSI_CMD_FIRST] = {
900 .handler_fn = pvscsi_on_cmd_unknown,
903 /* Not implemented, data size defined based on what arrives on windows */
904 [PVSCSI_CMD_CONFIG] = {
905 .data_size = 6 * sizeof(uint32_t),
906 .handler_fn = pvscsi_on_cmd_config,
909 /* Command not implemented, data size is unknown */
910 [PVSCSI_CMD_ISSUE_SCSI] = {
912 .handler_fn = pvscsi_on_issue_scsi,
915 /* Command not implemented, data size is unknown */
916 [PVSCSI_CMD_DEVICE_UNPLUG] = {
918 .handler_fn = pvscsi_on_cmd_unplug,
921 [PVSCSI_CMD_SETUP_RINGS] = {
922 .data_size = sizeof(PVSCSICmdDescSetupRings),
923 .handler_fn = pvscsi_on_cmd_setup_rings,
926 [PVSCSI_CMD_RESET_DEVICE] = {
927 .data_size = sizeof(struct PVSCSICmdDescResetDevice),
928 .handler_fn = pvscsi_on_cmd_reset_device,
931 [PVSCSI_CMD_RESET_BUS] = {
933 .handler_fn = pvscsi_on_cmd_reset_bus,
936 [PVSCSI_CMD_SETUP_MSG_RING] = {
937 .data_size = sizeof(PVSCSICmdDescSetupMsgRing),
938 .handler_fn = pvscsi_on_cmd_setup_msg_ring,
941 [PVSCSI_CMD_ADAPTER_RESET] = {
943 .handler_fn = pvscsi_on_cmd_adapter_reset,
946 [PVSCSI_CMD_ABORT_CMD] = {
947 .data_size = sizeof(struct PVSCSICmdDescAbortCmd),
948 .handler_fn = pvscsi_on_cmd_abort,
953 pvscsi_do_command_processing(PVSCSIState *s)
955 size_t bytes_arrived = s->curr_cmd_data_cntr * sizeof(uint32_t);
957 assert(s->curr_cmd < PVSCSI_CMD_LAST);
958 if (bytes_arrived >= pvscsi_commands[s->curr_cmd].data_size) {
959 s->reg_command_status = pvscsi_commands[s->curr_cmd].handler_fn(s);
960 s->curr_cmd = PVSCSI_CMD_FIRST;
961 s->curr_cmd_data_cntr = 0;
966 pvscsi_on_command_data(PVSCSIState *s, uint32_t value)
968 size_t bytes_arrived = s->curr_cmd_data_cntr * sizeof(uint32_t);
970 assert(bytes_arrived < sizeof(s->curr_cmd_data));
971 s->curr_cmd_data[s->curr_cmd_data_cntr++] = value;
973 pvscsi_do_command_processing(s);
977 pvscsi_on_command(PVSCSIState *s, uint64_t cmd_id)
979 if ((cmd_id > PVSCSI_CMD_FIRST) && (cmd_id < PVSCSI_CMD_LAST)) {
980 s->curr_cmd = cmd_id;
982 s->curr_cmd = PVSCSI_CMD_FIRST;
983 trace_pvscsi_on_cmd_unknown(cmd_id);
986 s->curr_cmd_data_cntr = 0;
987 s->reg_command_status = PVSCSI_COMMAND_NOT_ENOUGH_DATA;
989 pvscsi_do_command_processing(s);
993 pvscsi_io_write(void *opaque, hwaddr addr,
994 uint64_t val, unsigned size)
996 PVSCSIState *s = opaque;
999 case PVSCSI_REG_OFFSET_COMMAND:
1000 pvscsi_on_command(s, val);
1003 case PVSCSI_REG_OFFSET_COMMAND_DATA:
1004 pvscsi_on_command_data(s, (uint32_t) val);
1007 case PVSCSI_REG_OFFSET_INTR_STATUS:
1008 trace_pvscsi_io_write("PVSCSI_REG_OFFSET_INTR_STATUS", val);
1009 s->reg_interrupt_status &= ~val;
1010 pvscsi_update_irq_status(s);
1011 pvscsi_schedule_completion_processing(s);
1014 case PVSCSI_REG_OFFSET_INTR_MASK:
1015 trace_pvscsi_io_write("PVSCSI_REG_OFFSET_INTR_MASK", val);
1016 s->reg_interrupt_enabled = val;
1017 pvscsi_update_irq_status(s);
1020 case PVSCSI_REG_OFFSET_KICK_NON_RW_IO:
1021 trace_pvscsi_io_write("PVSCSI_REG_OFFSET_KICK_NON_RW_IO", val);
1022 pvscsi_process_io(s);
1025 case PVSCSI_REG_OFFSET_KICK_RW_IO:
1026 trace_pvscsi_io_write("PVSCSI_REG_OFFSET_KICK_RW_IO", val);
1027 pvscsi_process_io(s);
1030 case PVSCSI_REG_OFFSET_DEBUG:
1031 trace_pvscsi_io_write("PVSCSI_REG_OFFSET_DEBUG", val);
1035 trace_pvscsi_io_write_unknown(addr, size, val);
1042 pvscsi_io_read(void *opaque, hwaddr addr, unsigned size)
1044 PVSCSIState *s = opaque;
1047 case PVSCSI_REG_OFFSET_INTR_STATUS:
1048 trace_pvscsi_io_read("PVSCSI_REG_OFFSET_INTR_STATUS",
1049 s->reg_interrupt_status);
1050 return s->reg_interrupt_status;
1052 case PVSCSI_REG_OFFSET_INTR_MASK:
1053 trace_pvscsi_io_read("PVSCSI_REG_OFFSET_INTR_MASK",
1054 s->reg_interrupt_status);
1055 return s->reg_interrupt_enabled;
1057 case PVSCSI_REG_OFFSET_COMMAND_STATUS:
1058 trace_pvscsi_io_read("PVSCSI_REG_OFFSET_COMMAND_STATUS",
1059 s->reg_interrupt_status);
1060 return s->reg_command_status;
1063 trace_pvscsi_io_read_unknown(addr, size);
1070 pvscsi_init_msi(PVSCSIState *s)
1073 PCIDevice *d = PCI_DEVICE(s);
1075 res = msi_init(d, PVSCSI_MSI_OFFSET(s), PVSCSI_MSIX_NUM_VECTORS,
1076 PVSCSI_USE_64BIT, PVSCSI_PER_VECTOR_MASK, NULL);
1078 trace_pvscsi_init_msi_fail(res);
1079 s->msi_used = false;
1086 pvscsi_cleanup_msi(PVSCSIState *s)
1088 PCIDevice *d = PCI_DEVICE(s);
1093 static const MemoryRegionOps pvscsi_ops = {
1094 .read = pvscsi_io_read,
1095 .write = pvscsi_io_write,
1096 .endianness = DEVICE_LITTLE_ENDIAN,
1098 .min_access_size = 4,
1099 .max_access_size = 4,
1103 static const struct SCSIBusInfo pvscsi_scsi_info = {
1105 .max_target = PVSCSI_MAX_DEVS,
1109 .get_sg_list = pvscsi_get_sg_list,
1110 .complete = pvscsi_command_complete,
1111 .cancel = pvscsi_request_cancelled,
1115 pvscsi_realizefn(PCIDevice *pci_dev, Error **errp)
1117 PVSCSIState *s = PVSCSI(pci_dev);
1119 trace_pvscsi_state("init");
1121 /* PCI subsystem ID, subsystem vendor ID, revision */
1122 if (PVSCSI_USE_OLD_PCI_CONFIGURATION(s)) {
1123 pci_set_word(pci_dev->config + PCI_SUBSYSTEM_ID, 0x1000);
1125 pci_set_word(pci_dev->config + PCI_SUBSYSTEM_VENDOR_ID,
1126 PCI_VENDOR_ID_VMWARE);
1127 pci_set_word(pci_dev->config + PCI_SUBSYSTEM_ID,
1128 PCI_DEVICE_ID_VMWARE_PVSCSI);
1129 pci_config_set_revision(pci_dev->config, 0x2);
1132 /* PCI latency timer = 255 */
1133 pci_dev->config[PCI_LATENCY_TIMER] = 0xff;
1135 /* Interrupt pin A */
1136 pci_config_set_interrupt_pin(pci_dev->config, 1);
1138 memory_region_init_io(&s->io_space, OBJECT(s), &pvscsi_ops, s,
1139 "pvscsi-io", PVSCSI_MEM_SPACE_SIZE);
1140 pci_register_bar(pci_dev, 0, PCI_BASE_ADDRESS_SPACE_MEMORY, &s->io_space);
1144 if (pci_is_express(pci_dev) && pci_bus_is_express(pci_get_bus(pci_dev))) {
1145 pcie_endpoint_cap_init(pci_dev, PVSCSI_EXP_EP_OFFSET);
1148 s->completion_worker = qemu_bh_new(pvscsi_process_completion_queue, s);
1150 scsi_bus_new(&s->bus, sizeof(s->bus), DEVICE(pci_dev),
1151 &pvscsi_scsi_info, NULL);
1152 /* override default SCSI bus hotplug-handler, with pvscsi's one */
1153 qbus_set_hotplug_handler(BUS(&s->bus), OBJECT(s));
1154 pvscsi_reset_state(s);
1158 pvscsi_uninit(PCIDevice *pci_dev)
1160 PVSCSIState *s = PVSCSI(pci_dev);
1162 trace_pvscsi_state("uninit");
1163 qemu_bh_delete(s->completion_worker);
1165 pvscsi_cleanup_msi(s);
1169 pvscsi_reset(DeviceState *dev)
1171 PCIDevice *d = PCI_DEVICE(dev);
1172 PVSCSIState *s = PVSCSI(d);
1174 trace_pvscsi_state("reset");
1175 pvscsi_reset_adapter(s);
1179 pvscsi_pre_save(void *opaque)
1181 PVSCSIState *s = (PVSCSIState *) opaque;
1183 trace_pvscsi_state("presave");
1185 assert(QTAILQ_EMPTY(&s->pending_queue));
1186 assert(QTAILQ_EMPTY(&s->completion_queue));
1192 pvscsi_post_load(void *opaque, int version_id)
1194 trace_pvscsi_state("postload");
1198 static bool pvscsi_vmstate_need_pcie_device(void *opaque)
1200 PVSCSIState *s = PVSCSI(opaque);
1202 return !(s->compat_flags & PVSCSI_COMPAT_DISABLE_PCIE);
1205 static bool pvscsi_vmstate_test_pci_device(void *opaque, int version_id)
1207 return !pvscsi_vmstate_need_pcie_device(opaque);
1210 static const VMStateDescription vmstate_pvscsi_pcie_device = {
1211 .name = "pvscsi/pcie",
1212 .needed = pvscsi_vmstate_need_pcie_device,
1213 .fields = (VMStateField[]) {
1214 VMSTATE_PCI_DEVICE(parent_obj, PVSCSIState),
1215 VMSTATE_END_OF_LIST()
1219 static const VMStateDescription vmstate_pvscsi = {
1222 .minimum_version_id = 0,
1223 .pre_save = pvscsi_pre_save,
1224 .post_load = pvscsi_post_load,
1225 .fields = (VMStateField[]) {
1226 VMSTATE_STRUCT_TEST(parent_obj, PVSCSIState,
1227 pvscsi_vmstate_test_pci_device, 0,
1228 vmstate_pci_device, PCIDevice),
1229 VMSTATE_UINT8(msi_used, PVSCSIState),
1230 VMSTATE_UINT32(resetting, PVSCSIState),
1231 VMSTATE_UINT64(reg_interrupt_status, PVSCSIState),
1232 VMSTATE_UINT64(reg_interrupt_enabled, PVSCSIState),
1233 VMSTATE_UINT64(reg_command_status, PVSCSIState),
1234 VMSTATE_UINT64(curr_cmd, PVSCSIState),
1235 VMSTATE_UINT32(curr_cmd_data_cntr, PVSCSIState),
1236 VMSTATE_UINT32_ARRAY(curr_cmd_data, PVSCSIState,
1237 ARRAY_SIZE(((PVSCSIState *)NULL)->curr_cmd_data)),
1238 VMSTATE_UINT8(rings_info_valid, PVSCSIState),
1239 VMSTATE_UINT8(msg_ring_info_valid, PVSCSIState),
1240 VMSTATE_UINT8(use_msg, PVSCSIState),
1242 VMSTATE_UINT64(rings.rs_pa, PVSCSIState),
1243 VMSTATE_UINT32(rings.txr_len_mask, PVSCSIState),
1244 VMSTATE_UINT32(rings.rxr_len_mask, PVSCSIState),
1245 VMSTATE_UINT64_ARRAY(rings.req_ring_pages_pa, PVSCSIState,
1246 PVSCSI_SETUP_RINGS_MAX_NUM_PAGES),
1247 VMSTATE_UINT64_ARRAY(rings.cmp_ring_pages_pa, PVSCSIState,
1248 PVSCSI_SETUP_RINGS_MAX_NUM_PAGES),
1249 VMSTATE_UINT64(rings.consumed_ptr, PVSCSIState),
1250 VMSTATE_UINT64(rings.filled_cmp_ptr, PVSCSIState),
1252 VMSTATE_END_OF_LIST()
1254 .subsections = (const VMStateDescription*[]) {
1255 &vmstate_pvscsi_pcie_device,
1260 static Property pvscsi_properties[] = {
1261 DEFINE_PROP_UINT8("use_msg", PVSCSIState, use_msg, 1),
1262 DEFINE_PROP_BIT("x-old-pci-configuration", PVSCSIState, compat_flags,
1263 PVSCSI_COMPAT_OLD_PCI_CONFIGURATION_BIT, false),
1264 DEFINE_PROP_BIT("x-disable-pcie", PVSCSIState, compat_flags,
1265 PVSCSI_COMPAT_DISABLE_PCIE_BIT, false),
1266 DEFINE_PROP_END_OF_LIST(),
1269 static void pvscsi_realize(DeviceState *qdev, Error **errp)
1271 PVSCSIClass *pvs_c = PVSCSI_GET_CLASS(qdev);
1272 PCIDevice *pci_dev = PCI_DEVICE(qdev);
1273 PVSCSIState *s = PVSCSI(qdev);
1275 if (!(s->compat_flags & PVSCSI_COMPAT_DISABLE_PCIE)) {
1276 pci_dev->cap_present |= QEMU_PCI_CAP_EXPRESS;
1279 pvs_c->parent_dc_realize(qdev, errp);
1282 static void pvscsi_class_init(ObjectClass *klass, void *data)
1284 DeviceClass *dc = DEVICE_CLASS(klass);
1285 PCIDeviceClass *k = PCI_DEVICE_CLASS(klass);
1286 PVSCSIClass *pvs_k = PVSCSI_CLASS(klass);
1287 HotplugHandlerClass *hc = HOTPLUG_HANDLER_CLASS(klass);
1289 k->realize = pvscsi_realizefn;
1290 k->exit = pvscsi_uninit;
1291 k->vendor_id = PCI_VENDOR_ID_VMWARE;
1292 k->device_id = PCI_DEVICE_ID_VMWARE_PVSCSI;
1293 k->class_id = PCI_CLASS_STORAGE_SCSI;
1294 k->subsystem_id = 0x1000;
1295 device_class_set_parent_realize(dc, pvscsi_realize,
1296 &pvs_k->parent_dc_realize);
1297 dc->reset = pvscsi_reset;
1298 dc->vmsd = &vmstate_pvscsi;
1299 device_class_set_props(dc, pvscsi_properties);
1300 set_bit(DEVICE_CATEGORY_STORAGE, dc->categories);
1301 hc->unplug = pvscsi_hot_unplug;
1302 hc->plug = pvscsi_hotplug;
1305 static const TypeInfo pvscsi_info = {
1306 .name = TYPE_PVSCSI,
1307 .parent = TYPE_PCI_DEVICE,
1308 .class_size = sizeof(PVSCSIClass),
1309 .instance_size = sizeof(PVSCSIState),
1310 .class_init = pvscsi_class_init,
1311 .interfaces = (InterfaceInfo[]) {
1312 { TYPE_HOTPLUG_HANDLER },
1313 { INTERFACE_PCIE_DEVICE },
1314 { INTERFACE_CONVENTIONAL_PCI_DEVICE },
1320 pvscsi_register_types(void)
1322 type_register_static(&pvscsi_info);
1325 type_init(pvscsi_register_types);