1 // SPDX-License-Identifier: GPL-2.0-only
3 * Mediated virtual PCI serial host device driver
5 * Copyright (c) 2016, NVIDIA CORPORATION. All rights reserved.
6 * Author: Neo Jia <cjia@nvidia.com>
7 * Kirti Wankhede <kwankhede@nvidia.com>
9 * Sample driver that creates mdev device that simulates serial port over PCI
13 #include <linux/init.h>
14 #include <linux/module.h>
15 #include <linux/kernel.h>
17 #include <linux/poll.h>
18 #include <linux/slab.h>
19 #include <linux/cdev.h>
20 #include <linux/sched.h>
21 #include <linux/wait.h>
22 #include <linux/vfio.h>
23 #include <linux/iommu.h>
24 #include <linux/sysfs.h>
25 #include <linux/ctype.h>
26 #include <linux/file.h>
27 #include <linux/mdev.h>
28 #include <linux/pci.h>
29 #include <linux/serial.h>
30 #include <uapi/linux/serial_reg.h>
31 #include <linux/eventfd.h>
36 #define VERSION_STRING "0.1"
37 #define DRIVER_AUTHOR "NVIDIA Corporation"
39 #define MTTY_CLASS_NAME "mtty"
41 #define MTTY_NAME "mtty"
43 #define MTTY_STRING_LEN 16
45 #define MTTY_CONFIG_SPACE_SIZE 0xff
46 #define MTTY_IO_BAR_SIZE 0x8
47 #define MTTY_MMIO_BAR_SIZE 0x100000
49 #define STORE_LE16(addr, val) (*(u16 *)addr = val)
50 #define STORE_LE32(addr, val) (*(u32 *)addr = val)
52 #define MAX_FIFO_SIZE 16
54 #define CIRCULAR_BUF_INC_IDX(idx) (idx = (idx + 1) & (MAX_FIFO_SIZE - 1))
56 #define MTTY_VFIO_PCI_OFFSET_SHIFT 40
58 #define MTTY_VFIO_PCI_OFFSET_TO_INDEX(off) (off >> MTTY_VFIO_PCI_OFFSET_SHIFT)
59 #define MTTY_VFIO_PCI_INDEX_TO_OFFSET(index) \
60 ((u64)(index) << MTTY_VFIO_PCI_OFFSET_SHIFT)
61 #define MTTY_VFIO_PCI_OFFSET_MASK \
62 (((u64)(1) << MTTY_VFIO_PCI_OFFSET_SHIFT) - 1)
69 static struct mtty_dev {
71 struct class *vd_class;
75 struct mdev_parent parent;
78 struct mdev_region_info {
85 #if defined(DEBUG_REGS)
86 static const char *wr_reg[] = {
97 static const char *rd_reg[] = {
109 /* loop back buffer */
111 u8 fifo[MAX_FIFO_SIZE];
117 u8 uart_reg[8]; /* 8 registers */
118 struct rxtx rxtx; /* loop back buffer */
122 u8 fcr; /* FIFO control register */
124 u8 intr_trigger_level; /* interrupt trigger level */
127 /* State of each mdev device */
129 struct vfio_device vdev;
131 struct eventfd_ctx *intx_evtfd;
132 struct eventfd_ctx *msi_evtfd;
135 struct mutex ops_lock;
136 struct mdev_device *mdev;
137 struct mdev_region_info region_info[VFIO_PCI_NUM_REGIONS];
138 u32 bar_mask[VFIO_PCI_NUM_REGIONS];
139 struct list_head next;
140 struct serial_port s[2];
141 struct mutex rxtx_lock;
142 struct vfio_device_info dev_info;
146 static struct mtty_type {
147 struct mdev_type type;
150 { .nr_ports = 1, .type.sysfs_name = "1",
151 .type.pretty_name = "Single port serial" },
152 { .nr_ports = 2, .type.sysfs_name = "2",
153 .type.pretty_name = "Dual port serial" },
156 static struct mdev_type *mtty_mdev_types[] = {
161 static atomic_t mdev_avail_ports = ATOMIC_INIT(MAX_MTTYS);
163 static const struct file_operations vd_fops = {
164 .owner = THIS_MODULE,
167 static const struct vfio_device_ops mtty_dev_ops;
169 /* function prototypes */
171 static int mtty_trigger_interrupt(struct mdev_state *mdev_state);
173 /* Helper functions */
175 static void dump_buffer(u8 *buf, uint32_t count)
180 pr_info("Buffer:\n");
181 for (i = 0; i < count; i++) {
182 pr_info("%2x ", *(buf + i));
183 if ((i + 1) % 16 == 0)
189 static void mtty_create_config_space(struct mdev_state *mdev_state)
192 STORE_LE32((u32 *) &mdev_state->vconfig[0x0], 0x32534348);
194 /* Control: I/O+, Mem-, BusMaster- */
195 STORE_LE16((u16 *) &mdev_state->vconfig[0x4], 0x0001);
197 /* Status: capabilities list absent */
198 STORE_LE16((u16 *) &mdev_state->vconfig[0x6], 0x0200);
201 mdev_state->vconfig[0x8] = 0x10;
203 /* programming interface class : 16550-compatible serial controller */
204 mdev_state->vconfig[0x9] = 0x02;
207 mdev_state->vconfig[0xa] = 0x00;
209 /* Base class : Simple Communication controllers */
210 mdev_state->vconfig[0xb] = 0x07;
212 /* base address registers */
214 STORE_LE32((u32 *) &mdev_state->vconfig[0x10], 0x000001);
215 mdev_state->bar_mask[0] = ~(MTTY_IO_BAR_SIZE) + 1;
217 if (mdev_state->nr_ports == 2) {
219 STORE_LE32((u32 *) &mdev_state->vconfig[0x14], 0x000001);
220 mdev_state->bar_mask[1] = ~(MTTY_IO_BAR_SIZE) + 1;
224 STORE_LE32((u32 *) &mdev_state->vconfig[0x2c], 0x32534348);
226 mdev_state->vconfig[0x34] = 0x00; /* Cap Ptr */
227 mdev_state->vconfig[0x3d] = 0x01; /* interrupt pin (INTA#) */
229 /* Vendor specific data */
230 mdev_state->vconfig[0x40] = 0x23;
231 mdev_state->vconfig[0x43] = 0x80;
232 mdev_state->vconfig[0x44] = 0x23;
233 mdev_state->vconfig[0x48] = 0x23;
234 mdev_state->vconfig[0x4c] = 0x23;
236 mdev_state->vconfig[0x60] = 0x50;
237 mdev_state->vconfig[0x61] = 0x43;
238 mdev_state->vconfig[0x62] = 0x49;
239 mdev_state->vconfig[0x63] = 0x20;
240 mdev_state->vconfig[0x64] = 0x53;
241 mdev_state->vconfig[0x65] = 0x65;
242 mdev_state->vconfig[0x66] = 0x72;
243 mdev_state->vconfig[0x67] = 0x69;
244 mdev_state->vconfig[0x68] = 0x61;
245 mdev_state->vconfig[0x69] = 0x6c;
246 mdev_state->vconfig[0x6a] = 0x2f;
247 mdev_state->vconfig[0x6b] = 0x55;
248 mdev_state->vconfig[0x6c] = 0x41;
249 mdev_state->vconfig[0x6d] = 0x52;
250 mdev_state->vconfig[0x6e] = 0x54;
253 static void handle_pci_cfg_write(struct mdev_state *mdev_state, u16 offset,
256 u32 cfg_addr, bar_mask, bar_index = 0;
259 case 0x04: /* device control */
260 case 0x06: /* device status */
263 case 0x3c: /* interrupt line */
264 mdev_state->vconfig[0x3c] = buf[0];
268 * Interrupt Pin is hardwired to INTA.
269 * This field is write protected by hardware
272 case 0x10: /* BAR0 */
273 case 0x14: /* BAR1 */
276 else if (offset == 0x14)
279 if ((mdev_state->nr_ports == 1) && (bar_index == 1)) {
280 STORE_LE32(&mdev_state->vconfig[offset], 0);
284 cfg_addr = *(u32 *)buf;
285 pr_info("BAR%d addr 0x%x\n", bar_index, cfg_addr);
287 if (cfg_addr == 0xffffffff) {
288 bar_mask = mdev_state->bar_mask[bar_index];
289 cfg_addr = (cfg_addr & bar_mask);
292 cfg_addr |= (mdev_state->vconfig[offset] & 0x3ul);
293 STORE_LE32(&mdev_state->vconfig[offset], cfg_addr);
295 case 0x18: /* BAR2 */
296 case 0x1c: /* BAR3 */
297 case 0x20: /* BAR4 */
298 STORE_LE32(&mdev_state->vconfig[offset], 0);
301 pr_info("PCI config write @0x%x of %d bytes not handled\n",
307 static void handle_bar_write(unsigned int index, struct mdev_state *mdev_state,
308 u16 offset, u8 *buf, u32 count)
312 /* Handle data written by guest */
315 /* if DLAB set, data is LSB of divisor */
316 if (mdev_state->s[index].dlab) {
317 mdev_state->s[index].divisor |= data;
321 mutex_lock(&mdev_state->rxtx_lock);
323 /* save in TX buffer */
324 if (mdev_state->s[index].rxtx.count <
325 mdev_state->s[index].max_fifo_size) {
326 mdev_state->s[index].rxtx.fifo[
327 mdev_state->s[index].rxtx.head] = data;
328 mdev_state->s[index].rxtx.count++;
329 CIRCULAR_BUF_INC_IDX(mdev_state->s[index].rxtx.head);
330 mdev_state->s[index].overrun = false;
333 * Trigger interrupt if receive data interrupt is
334 * enabled and fifo reached trigger level
336 if ((mdev_state->s[index].uart_reg[UART_IER] &
338 (mdev_state->s[index].rxtx.count ==
339 mdev_state->s[index].intr_trigger_level)) {
340 /* trigger interrupt */
341 #if defined(DEBUG_INTR)
342 pr_err("Serial port %d: Fifo level trigger\n",
345 mtty_trigger_interrupt(mdev_state);
348 #if defined(DEBUG_INTR)
349 pr_err("Serial port %d: Buffer Overflow\n", index);
351 mdev_state->s[index].overrun = true;
354 * Trigger interrupt if receiver line status interrupt
357 if (mdev_state->s[index].uart_reg[UART_IER] &
359 mtty_trigger_interrupt(mdev_state);
361 mutex_unlock(&mdev_state->rxtx_lock);
365 /* if DLAB set, data is MSB of divisor */
366 if (mdev_state->s[index].dlab)
367 mdev_state->s[index].divisor |= (u16)data << 8;
369 mdev_state->s[index].uart_reg[offset] = data;
370 mutex_lock(&mdev_state->rxtx_lock);
371 if ((data & UART_IER_THRI) &&
372 (mdev_state->s[index].rxtx.head ==
373 mdev_state->s[index].rxtx.tail)) {
374 #if defined(DEBUG_INTR)
375 pr_err("Serial port %d: IER_THRI write\n",
378 mtty_trigger_interrupt(mdev_state);
381 mutex_unlock(&mdev_state->rxtx_lock);
387 mdev_state->s[index].fcr = data;
389 mutex_lock(&mdev_state->rxtx_lock);
390 if (data & (UART_FCR_CLEAR_RCVR | UART_FCR_CLEAR_XMIT)) {
391 /* clear loop back FIFO */
392 mdev_state->s[index].rxtx.count = 0;
393 mdev_state->s[index].rxtx.head = 0;
394 mdev_state->s[index].rxtx.tail = 0;
396 mutex_unlock(&mdev_state->rxtx_lock);
398 switch (data & UART_FCR_TRIGGER_MASK) {
399 case UART_FCR_TRIGGER_1:
400 mdev_state->s[index].intr_trigger_level = 1;
403 case UART_FCR_TRIGGER_4:
404 mdev_state->s[index].intr_trigger_level = 4;
407 case UART_FCR_TRIGGER_8:
408 mdev_state->s[index].intr_trigger_level = 8;
411 case UART_FCR_TRIGGER_14:
412 mdev_state->s[index].intr_trigger_level = 14;
417 * Set trigger level to 1 otherwise or implement timer with
418 * timeout of 4 characters and on expiring that timer set
419 * Recevice data timeout in IIR register
421 mdev_state->s[index].intr_trigger_level = 1;
422 if (data & UART_FCR_ENABLE_FIFO)
423 mdev_state->s[index].max_fifo_size = MAX_FIFO_SIZE;
425 mdev_state->s[index].max_fifo_size = 1;
426 mdev_state->s[index].intr_trigger_level = 1;
432 if (data & UART_LCR_DLAB) {
433 mdev_state->s[index].dlab = true;
434 mdev_state->s[index].divisor = 0;
436 mdev_state->s[index].dlab = false;
438 mdev_state->s[index].uart_reg[offset] = data;
442 mdev_state->s[index].uart_reg[offset] = data;
444 if ((mdev_state->s[index].uart_reg[UART_IER] & UART_IER_MSI) &&
445 (data & UART_MCR_OUT2)) {
446 #if defined(DEBUG_INTR)
447 pr_err("Serial port %d: MCR_OUT2 write\n", index);
449 mtty_trigger_interrupt(mdev_state);
452 if ((mdev_state->s[index].uart_reg[UART_IER] & UART_IER_MSI) &&
453 (data & (UART_MCR_RTS | UART_MCR_DTR))) {
454 #if defined(DEBUG_INTR)
455 pr_err("Serial port %d: MCR RTS/DTR write\n", index);
457 mtty_trigger_interrupt(mdev_state);
467 mdev_state->s[index].uart_reg[offset] = data;
475 static void handle_bar_read(unsigned int index, struct mdev_state *mdev_state,
476 u16 offset, u8 *buf, u32 count)
478 /* Handle read requests by guest */
481 /* if DLAB set, data is LSB of divisor */
482 if (mdev_state->s[index].dlab) {
483 *buf = (u8)mdev_state->s[index].divisor;
487 mutex_lock(&mdev_state->rxtx_lock);
488 /* return data in tx buffer */
489 if (mdev_state->s[index].rxtx.head !=
490 mdev_state->s[index].rxtx.tail) {
491 *buf = mdev_state->s[index].rxtx.fifo[
492 mdev_state->s[index].rxtx.tail];
493 mdev_state->s[index].rxtx.count--;
494 CIRCULAR_BUF_INC_IDX(mdev_state->s[index].rxtx.tail);
497 if (mdev_state->s[index].rxtx.head ==
498 mdev_state->s[index].rxtx.tail) {
500 * Trigger interrupt if tx buffer empty interrupt is
501 * enabled and fifo is empty
503 #if defined(DEBUG_INTR)
504 pr_err("Serial port %d: Buffer Empty\n", index);
506 if (mdev_state->s[index].uart_reg[UART_IER] &
508 mtty_trigger_interrupt(mdev_state);
510 mutex_unlock(&mdev_state->rxtx_lock);
515 if (mdev_state->s[index].dlab) {
516 *buf = (u8)(mdev_state->s[index].divisor >> 8);
519 *buf = mdev_state->s[index].uart_reg[offset] & 0x0f;
524 u8 ier = mdev_state->s[index].uart_reg[UART_IER];
527 mutex_lock(&mdev_state->rxtx_lock);
528 /* Interrupt priority 1: Parity, overrun, framing or break */
529 if ((ier & UART_IER_RLSI) && mdev_state->s[index].overrun)
530 *buf |= UART_IIR_RLSI;
532 /* Interrupt priority 2: Fifo trigger level reached */
533 if ((ier & UART_IER_RDI) &&
534 (mdev_state->s[index].rxtx.count >=
535 mdev_state->s[index].intr_trigger_level))
536 *buf |= UART_IIR_RDI;
538 /* Interrupt priotiry 3: transmitter holding register empty */
539 if ((ier & UART_IER_THRI) &&
540 (mdev_state->s[index].rxtx.head ==
541 mdev_state->s[index].rxtx.tail))
542 *buf |= UART_IIR_THRI;
544 /* Interrupt priotiry 4: Modem status: CTS, DSR, RI or DCD */
545 if ((ier & UART_IER_MSI) &&
546 (mdev_state->s[index].uart_reg[UART_MCR] &
547 (UART_MCR_RTS | UART_MCR_DTR)))
548 *buf |= UART_IIR_MSI;
550 /* bit0: 0=> interrupt pending, 1=> no interrupt is pending */
552 *buf = UART_IIR_NO_INT;
554 /* set bit 6 & 7 to be 16550 compatible */
556 mutex_unlock(&mdev_state->rxtx_lock);
562 *buf = mdev_state->s[index].uart_reg[offset];
569 mutex_lock(&mdev_state->rxtx_lock);
570 /* atleast one char in FIFO */
571 if (mdev_state->s[index].rxtx.head !=
572 mdev_state->s[index].rxtx.tail)
575 /* if FIFO overrun */
576 if (mdev_state->s[index].overrun)
579 /* transmit FIFO empty and tramsitter empty */
580 if (mdev_state->s[index].rxtx.head ==
581 mdev_state->s[index].rxtx.tail)
582 lsr |= UART_LSR_TEMT | UART_LSR_THRE;
584 mutex_unlock(&mdev_state->rxtx_lock);
589 *buf = UART_MSR_DSR | UART_MSR_DDSR | UART_MSR_DCD;
591 mutex_lock(&mdev_state->rxtx_lock);
592 /* if AFE is 1 and FIFO have space, set CTS bit */
593 if (mdev_state->s[index].uart_reg[UART_MCR] &
595 if (mdev_state->s[index].rxtx.count <
596 mdev_state->s[index].max_fifo_size)
597 *buf |= UART_MSR_CTS | UART_MSR_DCTS;
599 *buf |= UART_MSR_CTS | UART_MSR_DCTS;
600 mutex_unlock(&mdev_state->rxtx_lock);
605 *buf = mdev_state->s[index].uart_reg[offset];
613 static void mdev_read_base(struct mdev_state *mdev_state)
616 u32 start_lo, start_hi;
619 pos = PCI_BASE_ADDRESS_0;
621 for (index = 0; index <= VFIO_PCI_BAR5_REGION_INDEX; index++) {
623 if (!mdev_state->region_info[index].size)
626 start_lo = (*(u32 *)(mdev_state->vconfig + pos)) &
627 PCI_BASE_ADDRESS_MEM_MASK;
628 mem_type = (*(u32 *)(mdev_state->vconfig + pos)) &
629 PCI_BASE_ADDRESS_MEM_TYPE_MASK;
632 case PCI_BASE_ADDRESS_MEM_TYPE_64:
633 start_hi = (*(u32 *)(mdev_state->vconfig + pos + 4));
636 case PCI_BASE_ADDRESS_MEM_TYPE_32:
637 case PCI_BASE_ADDRESS_MEM_TYPE_1M:
638 /* 1M mem BAR treated as 32-bit BAR */
640 /* mem unknown type treated as 32-bit BAR */
645 mdev_state->region_info[index].start = ((u64)start_hi << 32) |
650 static ssize_t mdev_access(struct mdev_state *mdev_state, u8 *buf, size_t count,
651 loff_t pos, bool is_write)
660 mutex_lock(&mdev_state->ops_lock);
662 index = MTTY_VFIO_PCI_OFFSET_TO_INDEX(pos);
663 offset = pos & MTTY_VFIO_PCI_OFFSET_MASK;
665 case VFIO_PCI_CONFIG_REGION_INDEX:
668 pr_info("%s: PCI config space %s at offset 0x%llx\n",
669 __func__, is_write ? "write" : "read", offset);
672 dump_buffer(buf, count);
673 handle_pci_cfg_write(mdev_state, offset, buf, count);
675 memcpy(buf, (mdev_state->vconfig + offset), count);
676 dump_buffer(buf, count);
681 case VFIO_PCI_BAR0_REGION_INDEX ... VFIO_PCI_BAR5_REGION_INDEX:
682 if (!mdev_state->region_info[index].start)
683 mdev_read_base(mdev_state);
686 dump_buffer(buf, count);
688 #if defined(DEBUG_REGS)
689 pr_info("%s: BAR%d WR @0x%llx %s val:0x%02x dlab:%d\n",
690 __func__, index, offset, wr_reg[offset],
691 *buf, mdev_state->s[index].dlab);
693 handle_bar_write(index, mdev_state, offset, buf, count);
695 handle_bar_read(index, mdev_state, offset, buf, count);
696 dump_buffer(buf, count);
698 #if defined(DEBUG_REGS)
699 pr_info("%s: BAR%d RD @0x%llx %s val:0x%02x dlab:%d\n",
700 __func__, index, offset, rd_reg[offset],
701 *buf, mdev_state->s[index].dlab);
715 mutex_unlock(&mdev_state->ops_lock);
720 static int mtty_init_dev(struct vfio_device *vdev)
722 struct mdev_state *mdev_state =
723 container_of(vdev, struct mdev_state, vdev);
724 struct mdev_device *mdev = to_mdev_device(vdev->dev);
725 struct mtty_type *type =
726 container_of(mdev->type, struct mtty_type, type);
727 int avail_ports = atomic_read(&mdev_avail_ports);
731 if (avail_ports < type->nr_ports)
733 } while (!atomic_try_cmpxchg(&mdev_avail_ports,
735 avail_ports - type->nr_ports));
737 mdev_state->nr_ports = type->nr_ports;
738 mdev_state->irq_index = -1;
739 mdev_state->s[0].max_fifo_size = MAX_FIFO_SIZE;
740 mdev_state->s[1].max_fifo_size = MAX_FIFO_SIZE;
741 mutex_init(&mdev_state->rxtx_lock);
743 mdev_state->vconfig = kzalloc(MTTY_CONFIG_SPACE_SIZE, GFP_KERNEL);
744 if (!mdev_state->vconfig) {
749 mutex_init(&mdev_state->ops_lock);
750 mdev_state->mdev = mdev;
751 mtty_create_config_space(mdev_state);
755 atomic_add(type->nr_ports, &mdev_avail_ports);
759 static int mtty_probe(struct mdev_device *mdev)
761 struct mdev_state *mdev_state;
764 mdev_state = vfio_alloc_device(mdev_state, vdev, &mdev->dev,
766 if (IS_ERR(mdev_state))
767 return PTR_ERR(mdev_state);
769 ret = vfio_register_emulated_iommu_dev(&mdev_state->vdev);
772 dev_set_drvdata(&mdev->dev, mdev_state);
776 vfio_put_device(&mdev_state->vdev);
780 static void mtty_release_dev(struct vfio_device *vdev)
782 struct mdev_state *mdev_state =
783 container_of(vdev, struct mdev_state, vdev);
785 atomic_add(mdev_state->nr_ports, &mdev_avail_ports);
786 kfree(mdev_state->vconfig);
789 static void mtty_remove(struct mdev_device *mdev)
791 struct mdev_state *mdev_state = dev_get_drvdata(&mdev->dev);
793 vfio_unregister_group_dev(&mdev_state->vdev);
794 vfio_put_device(&mdev_state->vdev);
797 static int mtty_reset(struct mdev_state *mdev_state)
799 pr_info("%s: called\n", __func__);
804 static ssize_t mtty_read(struct vfio_device *vdev, char __user *buf,
805 size_t count, loff_t *ppos)
807 struct mdev_state *mdev_state =
808 container_of(vdev, struct mdev_state, vdev);
809 unsigned int done = 0;
815 if (count >= 4 && !(*ppos % 4)) {
818 ret = mdev_access(mdev_state, (u8 *)&val, sizeof(val),
823 if (copy_to_user(buf, &val, sizeof(val)))
827 } else if (count >= 2 && !(*ppos % 2)) {
830 ret = mdev_access(mdev_state, (u8 *)&val, sizeof(val),
835 if (copy_to_user(buf, &val, sizeof(val)))
842 ret = mdev_access(mdev_state, (u8 *)&val, sizeof(val),
847 if (copy_to_user(buf, &val, sizeof(val)))
865 static ssize_t mtty_write(struct vfio_device *vdev, const char __user *buf,
866 size_t count, loff_t *ppos)
868 struct mdev_state *mdev_state =
869 container_of(vdev, struct mdev_state, vdev);
870 unsigned int done = 0;
876 if (count >= 4 && !(*ppos % 4)) {
879 if (copy_from_user(&val, buf, sizeof(val)))
882 ret = mdev_access(mdev_state, (u8 *)&val, sizeof(val),
888 } else if (count >= 2 && !(*ppos % 2)) {
891 if (copy_from_user(&val, buf, sizeof(val)))
894 ret = mdev_access(mdev_state, (u8 *)&val, sizeof(val),
903 if (copy_from_user(&val, buf, sizeof(val)))
906 ret = mdev_access(mdev_state, (u8 *)&val, sizeof(val),
924 static int mtty_set_irqs(struct mdev_state *mdev_state, uint32_t flags,
925 unsigned int index, unsigned int start,
926 unsigned int count, void *data)
930 mutex_lock(&mdev_state->ops_lock);
932 case VFIO_PCI_INTX_IRQ_INDEX:
933 switch (flags & VFIO_IRQ_SET_ACTION_TYPE_MASK) {
934 case VFIO_IRQ_SET_ACTION_MASK:
935 case VFIO_IRQ_SET_ACTION_UNMASK:
937 case VFIO_IRQ_SET_ACTION_TRIGGER:
939 if (flags & VFIO_IRQ_SET_DATA_NONE) {
940 pr_info("%s: disable INTx\n", __func__);
941 if (mdev_state->intx_evtfd)
942 eventfd_ctx_put(mdev_state->intx_evtfd);
946 if (flags & VFIO_IRQ_SET_DATA_EVENTFD) {
947 int fd = *(int *)data;
950 struct eventfd_ctx *evt;
952 evt = eventfd_ctx_fdget(fd);
957 mdev_state->intx_evtfd = evt;
958 mdev_state->irq_fd = fd;
959 mdev_state->irq_index = index;
967 case VFIO_PCI_MSI_IRQ_INDEX:
968 switch (flags & VFIO_IRQ_SET_ACTION_TYPE_MASK) {
969 case VFIO_IRQ_SET_ACTION_MASK:
970 case VFIO_IRQ_SET_ACTION_UNMASK:
972 case VFIO_IRQ_SET_ACTION_TRIGGER:
973 if (flags & VFIO_IRQ_SET_DATA_NONE) {
974 if (mdev_state->msi_evtfd)
975 eventfd_ctx_put(mdev_state->msi_evtfd);
976 pr_info("%s: disable MSI\n", __func__);
977 mdev_state->irq_index = VFIO_PCI_INTX_IRQ_INDEX;
980 if (flags & VFIO_IRQ_SET_DATA_EVENTFD) {
981 int fd = *(int *)data;
982 struct eventfd_ctx *evt;
987 if (mdev_state->msi_evtfd)
990 evt = eventfd_ctx_fdget(fd);
995 mdev_state->msi_evtfd = evt;
996 mdev_state->irq_fd = fd;
997 mdev_state->irq_index = index;
1002 case VFIO_PCI_MSIX_IRQ_INDEX:
1003 pr_info("%s: MSIX_IRQ\n", __func__);
1005 case VFIO_PCI_ERR_IRQ_INDEX:
1006 pr_info("%s: ERR_IRQ\n", __func__);
1008 case VFIO_PCI_REQ_IRQ_INDEX:
1009 pr_info("%s: REQ_IRQ\n", __func__);
1013 mutex_unlock(&mdev_state->ops_lock);
1017 static int mtty_trigger_interrupt(struct mdev_state *mdev_state)
1021 if ((mdev_state->irq_index == VFIO_PCI_MSI_IRQ_INDEX) &&
1022 (!mdev_state->msi_evtfd))
1024 else if ((mdev_state->irq_index == VFIO_PCI_INTX_IRQ_INDEX) &&
1025 (!mdev_state->intx_evtfd)) {
1026 pr_info("%s: Intr eventfd not found\n", __func__);
1030 if (mdev_state->irq_index == VFIO_PCI_MSI_IRQ_INDEX)
1031 ret = eventfd_signal(mdev_state->msi_evtfd, 1);
1033 ret = eventfd_signal(mdev_state->intx_evtfd, 1);
1035 #if defined(DEBUG_INTR)
1036 pr_info("Intx triggered\n");
1039 pr_err("%s: eventfd signal failed (%d)\n", __func__, ret);
1044 static int mtty_get_region_info(struct mdev_state *mdev_state,
1045 struct vfio_region_info *region_info,
1046 u16 *cap_type_id, void **cap_type)
1048 unsigned int size = 0;
1051 bar_index = region_info->index;
1052 if (bar_index >= VFIO_PCI_NUM_REGIONS)
1055 mutex_lock(&mdev_state->ops_lock);
1057 switch (bar_index) {
1058 case VFIO_PCI_CONFIG_REGION_INDEX:
1059 size = MTTY_CONFIG_SPACE_SIZE;
1061 case VFIO_PCI_BAR0_REGION_INDEX:
1062 size = MTTY_IO_BAR_SIZE;
1064 case VFIO_PCI_BAR1_REGION_INDEX:
1065 if (mdev_state->nr_ports == 2)
1066 size = MTTY_IO_BAR_SIZE;
1073 mdev_state->region_info[bar_index].size = size;
1074 mdev_state->region_info[bar_index].vfio_offset =
1075 MTTY_VFIO_PCI_INDEX_TO_OFFSET(bar_index);
1077 region_info->size = size;
1078 region_info->offset = MTTY_VFIO_PCI_INDEX_TO_OFFSET(bar_index);
1079 region_info->flags = VFIO_REGION_INFO_FLAG_READ |
1080 VFIO_REGION_INFO_FLAG_WRITE;
1081 mutex_unlock(&mdev_state->ops_lock);
1085 static int mtty_get_irq_info(struct vfio_irq_info *irq_info)
1087 switch (irq_info->index) {
1088 case VFIO_PCI_INTX_IRQ_INDEX:
1089 case VFIO_PCI_MSI_IRQ_INDEX:
1090 case VFIO_PCI_REQ_IRQ_INDEX:
1097 irq_info->flags = VFIO_IRQ_INFO_EVENTFD;
1098 irq_info->count = 1;
1100 if (irq_info->index == VFIO_PCI_INTX_IRQ_INDEX)
1101 irq_info->flags |= (VFIO_IRQ_INFO_MASKABLE |
1102 VFIO_IRQ_INFO_AUTOMASKED);
1104 irq_info->flags |= VFIO_IRQ_INFO_NORESIZE;
1109 static int mtty_get_device_info(struct vfio_device_info *dev_info)
1111 dev_info->flags = VFIO_DEVICE_FLAGS_PCI;
1112 dev_info->num_regions = VFIO_PCI_NUM_REGIONS;
1113 dev_info->num_irqs = VFIO_PCI_NUM_IRQS;
1118 static long mtty_ioctl(struct vfio_device *vdev, unsigned int cmd,
1121 struct mdev_state *mdev_state =
1122 container_of(vdev, struct mdev_state, vdev);
1124 unsigned long minsz;
1127 case VFIO_DEVICE_GET_INFO:
1129 struct vfio_device_info info;
1131 minsz = offsetofend(struct vfio_device_info, num_irqs);
1133 if (copy_from_user(&info, (void __user *)arg, minsz))
1136 if (info.argsz < minsz)
1139 ret = mtty_get_device_info(&info);
1143 memcpy(&mdev_state->dev_info, &info, sizeof(info));
1145 if (copy_to_user((void __user *)arg, &info, minsz))
1150 case VFIO_DEVICE_GET_REGION_INFO:
1152 struct vfio_region_info info;
1153 u16 cap_type_id = 0;
1154 void *cap_type = NULL;
1156 minsz = offsetofend(struct vfio_region_info, offset);
1158 if (copy_from_user(&info, (void __user *)arg, minsz))
1161 if (info.argsz < minsz)
1164 ret = mtty_get_region_info(mdev_state, &info, &cap_type_id,
1169 if (copy_to_user((void __user *)arg, &info, minsz))
1175 case VFIO_DEVICE_GET_IRQ_INFO:
1177 struct vfio_irq_info info;
1179 minsz = offsetofend(struct vfio_irq_info, count);
1181 if (copy_from_user(&info, (void __user *)arg, minsz))
1184 if ((info.argsz < minsz) ||
1185 (info.index >= mdev_state->dev_info.num_irqs))
1188 ret = mtty_get_irq_info(&info);
1192 if (copy_to_user((void __user *)arg, &info, minsz))
1197 case VFIO_DEVICE_SET_IRQS:
1199 struct vfio_irq_set hdr;
1200 u8 *data = NULL, *ptr = NULL;
1201 size_t data_size = 0;
1203 minsz = offsetofend(struct vfio_irq_set, count);
1205 if (copy_from_user(&hdr, (void __user *)arg, minsz))
1208 ret = vfio_set_irqs_validate_and_prepare(&hdr,
1209 mdev_state->dev_info.num_irqs,
1216 ptr = data = memdup_user((void __user *)(arg + minsz),
1219 return PTR_ERR(data);
1222 ret = mtty_set_irqs(mdev_state, hdr.flags, hdr.index, hdr.start,
1228 case VFIO_DEVICE_RESET:
1229 return mtty_reset(mdev_state);
1235 sample_mdev_dev_show(struct device *dev, struct device_attribute *attr,
1238 return sprintf(buf, "This is MDEV %s\n", dev_name(dev));
1241 static DEVICE_ATTR_RO(sample_mdev_dev);
1243 static struct attribute *mdev_dev_attrs[] = {
1244 &dev_attr_sample_mdev_dev.attr,
1248 static const struct attribute_group mdev_dev_group = {
1250 .attrs = mdev_dev_attrs,
1253 static const struct attribute_group *mdev_dev_groups[] = {
1258 static unsigned int mtty_get_available(struct mdev_type *mtype)
1260 struct mtty_type *type = container_of(mtype, struct mtty_type, type);
1262 return atomic_read(&mdev_avail_ports) / type->nr_ports;
1265 static const struct vfio_device_ops mtty_dev_ops = {
1266 .name = "vfio-mtty",
1267 .init = mtty_init_dev,
1268 .release = mtty_release_dev,
1270 .write = mtty_write,
1271 .ioctl = mtty_ioctl,
1272 .bind_iommufd = vfio_iommufd_emulated_bind,
1273 .unbind_iommufd = vfio_iommufd_emulated_unbind,
1274 .attach_ioas = vfio_iommufd_emulated_attach_ioas,
1275 .detach_ioas = vfio_iommufd_emulated_detach_ioas,
1278 static struct mdev_driver mtty_driver = {
1279 .device_api = VFIO_DEVICE_API_PCI_STRING,
1282 .owner = THIS_MODULE,
1283 .mod_name = KBUILD_MODNAME,
1284 .dev_groups = mdev_dev_groups,
1286 .probe = mtty_probe,
1287 .remove = mtty_remove,
1288 .get_available = mtty_get_available,
1291 static void mtty_device_release(struct device *dev)
1293 dev_dbg(dev, "mtty: released\n");
1296 static int __init mtty_dev_init(void)
1300 pr_info("mtty_dev: %s\n", __func__);
1302 memset(&mtty_dev, 0, sizeof(mtty_dev));
1304 idr_init(&mtty_dev.vd_idr);
1306 ret = alloc_chrdev_region(&mtty_dev.vd_devt, 0, MINORMASK + 1,
1310 pr_err("Error: failed to register mtty_dev, err:%d\n", ret);
1314 cdev_init(&mtty_dev.vd_cdev, &vd_fops);
1315 cdev_add(&mtty_dev.vd_cdev, mtty_dev.vd_devt, MINORMASK + 1);
1317 pr_info("major_number:%d\n", MAJOR(mtty_dev.vd_devt));
1319 ret = mdev_register_driver(&mtty_driver);
1323 mtty_dev.vd_class = class_create(MTTY_CLASS_NAME);
1325 if (IS_ERR(mtty_dev.vd_class)) {
1326 pr_err("Error: failed to register mtty_dev class\n");
1327 ret = PTR_ERR(mtty_dev.vd_class);
1331 mtty_dev.dev.class = mtty_dev.vd_class;
1332 mtty_dev.dev.release = mtty_device_release;
1333 dev_set_name(&mtty_dev.dev, "%s", MTTY_NAME);
1335 ret = device_register(&mtty_dev.dev);
1339 ret = mdev_register_parent(&mtty_dev.parent, &mtty_dev.dev,
1340 &mtty_driver, mtty_mdev_types,
1341 ARRAY_SIZE(mtty_mdev_types));
1347 device_del(&mtty_dev.dev);
1349 put_device(&mtty_dev.dev);
1350 class_destroy(mtty_dev.vd_class);
1352 mdev_unregister_driver(&mtty_driver);
1354 cdev_del(&mtty_dev.vd_cdev);
1355 unregister_chrdev_region(mtty_dev.vd_devt, MINORMASK + 1);
1359 static void __exit mtty_dev_exit(void)
1361 mtty_dev.dev.bus = NULL;
1362 mdev_unregister_parent(&mtty_dev.parent);
1364 device_unregister(&mtty_dev.dev);
1365 idr_destroy(&mtty_dev.vd_idr);
1366 mdev_unregister_driver(&mtty_driver);
1367 cdev_del(&mtty_dev.vd_cdev);
1368 unregister_chrdev_region(mtty_dev.vd_devt, MINORMASK + 1);
1369 class_destroy(mtty_dev.vd_class);
1370 mtty_dev.vd_class = NULL;
1371 pr_info("mtty_dev: Unloaded!\n");
1374 module_init(mtty_dev_init)
1375 module_exit(mtty_dev_exit)
1377 MODULE_LICENSE("GPL v2");
1378 MODULE_INFO(supported, "Test driver that simulate serial port over PCI");
1379 MODULE_VERSION(VERSION_STRING);
1380 MODULE_AUTHOR(DRIVER_AUTHOR);