4 * This module allows virtio devices to be used over a virtual PCI device.
5 * This can be used with QEMU based VMMs like KVM or Xen.
7 * Copyright IBM Corp. 2007
10 * Anthony Liguori <aliguori@us.ibm.com>
12 * This work is licensed under the terms of the GNU GPL, version 2 or later.
13 * See the COPYING file in the top-level directory.
17 #include <linux/module.h>
18 #include <linux/list.h>
19 #include <linux/pci.h>
20 #include <linux/interrupt.h>
21 #include <linux/virtio.h>
22 #include <linux/virtio_config.h>
23 #include <linux/virtio_ring.h>
24 #include <linux/virtio_pci.h>
25 #include <linux/highmem.h>
26 #include <linux/spinlock.h>
28 MODULE_AUTHOR("Anthony Liguori <aliguori@us.ibm.com>");
29 MODULE_DESCRIPTION("virtio-pci");
30 MODULE_LICENSE("GPL");
33 /* Our device structure */
34 struct virtio_pci_device
36 struct virtio_device vdev;
37 struct pci_dev *pci_dev;
39 /* the IO mapping for the PCI config space */
42 /* a list of queues so we can dispatch IRQs */
44 struct list_head virtqueues;
47 struct virtio_pci_vq_info
49 /* the actual virtqueue */
52 /* the number of entries in the queue */
55 /* the index of the queue */
58 /* the virtual address of the ring queue */
61 /* the list node for the virtqueues list */
62 struct list_head node;
65 /* Qumranet donated their vendor ID for devices 0x1000 thru 0x10FF. */
66 static struct pci_device_id virtio_pci_id_table[] = {
67 { 0x1af4, PCI_ANY_ID, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0 },
71 MODULE_DEVICE_TABLE(pci, virtio_pci_id_table);
73 /* A PCI device has it's own struct device and so does a virtio device so
74 * we create a place for the virtio devices to show up in sysfs. I think it
75 * would make more sense for virtio to not insist on having it's own device. */
76 static struct device virtio_pci_root = {
78 .bus_id = "virtio-pci",
81 /* Unique numbering for devices under the kvm root */
82 static unsigned int dev_index;
84 /* Convert a generic virtio device to our structure */
85 static struct virtio_pci_device *to_vp_device(struct virtio_device *vdev)
87 return container_of(vdev, struct virtio_pci_device, vdev);
90 /* virtio config->feature() implementation */
91 static bool vp_feature(struct virtio_device *vdev, unsigned bit)
93 struct virtio_pci_device *vp_dev = to_vp_device(vdev);
96 /* Since this function is supposed to have the side effect of
97 * enabling a queried feature, we simulate that by doing a read
98 * from the host feature bitmask and then writing to the guest
100 mask = ioread32(vp_dev->ioaddr + VIRTIO_PCI_HOST_FEATURES);
101 if (mask & (1 << bit)) {
103 iowrite32(mask, vp_dev->ioaddr + VIRTIO_PCI_GUEST_FEATURES);
106 return !!(mask & (1 << bit));
109 /* virtio config->get() implementation */
110 static void vp_get(struct virtio_device *vdev, unsigned offset,
111 void *buf, unsigned len)
113 struct virtio_pci_device *vp_dev = to_vp_device(vdev);
114 void *ioaddr = vp_dev->ioaddr + VIRTIO_PCI_CONFIG + offset;
118 for (i = 0; i < len; i++)
119 ptr[i] = ioread8(ioaddr + i);
122 /* the config->set() implementation. it's symmetric to the config->get()
124 static void vp_set(struct virtio_device *vdev, unsigned offset,
125 const void *buf, unsigned len)
127 struct virtio_pci_device *vp_dev = to_vp_device(vdev);
128 void *ioaddr = vp_dev->ioaddr + VIRTIO_PCI_CONFIG + offset;
132 for (i = 0; i < len; i++)
133 iowrite8(ptr[i], ioaddr + i);
136 /* config->{get,set}_status() implementations */
137 static u8 vp_get_status(struct virtio_device *vdev)
139 struct virtio_pci_device *vp_dev = to_vp_device(vdev);
140 return ioread8(vp_dev->ioaddr + VIRTIO_PCI_STATUS);
143 static void vp_set_status(struct virtio_device *vdev, u8 status)
145 struct virtio_pci_device *vp_dev = to_vp_device(vdev);
146 /* We should never be setting status to 0. */
148 return iowrite8(status, vp_dev->ioaddr + VIRTIO_PCI_STATUS);
151 static void vp_reset(struct virtio_device *vdev)
153 struct virtio_pci_device *vp_dev = to_vp_device(vdev);
154 /* 0 status means a reset. */
155 return iowrite8(0, vp_dev->ioaddr + VIRTIO_PCI_STATUS);
158 /* the notify function used when creating a virt queue */
159 static void vp_notify(struct virtqueue *vq)
161 struct virtio_pci_device *vp_dev = to_vp_device(vq->vdev);
162 struct virtio_pci_vq_info *info = vq->priv;
164 /* we write the queue's selector into the notification register to
165 * signal the other end */
166 iowrite16(info->queue_index, vp_dev->ioaddr + VIRTIO_PCI_QUEUE_NOTIFY);
169 /* A small wrapper to also acknowledge the interrupt when it's handled.
170 * I really need an EIO hook for the vring so I can ack the interrupt once we
171 * know that we'll be handling the IRQ but before we invoke the callback since
172 * the callback may notify the host which results in the host attempting to
173 * raise an interrupt that we would then mask once we acknowledged the
175 static irqreturn_t vp_interrupt(int irq, void *opaque)
177 struct virtio_pci_device *vp_dev = opaque;
178 struct virtio_pci_vq_info *info;
179 irqreturn_t ret = IRQ_NONE;
182 /* reading the ISR has the effect of also clearing it so it's very
183 * important to save off the value. */
184 isr = ioread8(vp_dev->ioaddr + VIRTIO_PCI_ISR);
186 /* It's definitely not us if the ISR was not high */
190 /* Configuration change? Tell driver if it wants to know. */
191 if (isr & VIRTIO_PCI_ISR_CONFIG) {
192 struct virtio_driver *drv;
193 drv = container_of(vp_dev->vdev.dev.driver,
194 struct virtio_driver, driver);
196 if (drv->config_changed)
197 drv->config_changed(&vp_dev->vdev);
200 spin_lock(&vp_dev->lock);
201 list_for_each_entry(info, &vp_dev->virtqueues, node) {
202 if (vring_interrupt(irq, info->vq) == IRQ_HANDLED)
205 spin_unlock(&vp_dev->lock);
210 /* the config->find_vq() implementation */
211 static struct virtqueue *vp_find_vq(struct virtio_device *vdev, unsigned index,
212 void (*callback)(struct virtqueue *vq))
214 struct virtio_pci_device *vp_dev = to_vp_device(vdev);
215 struct virtio_pci_vq_info *info;
216 struct virtqueue *vq;
220 /* Select the queue we're interested in */
221 iowrite16(index, vp_dev->ioaddr + VIRTIO_PCI_QUEUE_SEL);
223 /* Check if queue is either not available or already active. */
224 num = ioread16(vp_dev->ioaddr + VIRTIO_PCI_QUEUE_NUM);
225 if (!num || ioread32(vp_dev->ioaddr + VIRTIO_PCI_QUEUE_PFN))
226 return ERR_PTR(-ENOENT);
228 /* allocate and fill out our structure the represents an active
230 info = kmalloc(sizeof(struct virtio_pci_vq_info), GFP_KERNEL);
232 return ERR_PTR(-ENOMEM);
234 info->queue_index = index;
237 info->queue = kzalloc(PAGE_ALIGN(vring_size(num,PAGE_SIZE)), GFP_KERNEL);
238 if (info->queue == NULL) {
243 /* activate the queue */
244 iowrite32(virt_to_phys(info->queue) >> PAGE_SHIFT,
245 vp_dev->ioaddr + VIRTIO_PCI_QUEUE_PFN);
247 /* create the vring */
248 vq = vring_new_virtqueue(info->num, vdev, info->queue,
249 vp_notify, callback);
252 goto out_activate_queue;
258 spin_lock(&vp_dev->lock);
259 list_add(&info->node, &vp_dev->virtqueues);
260 spin_unlock(&vp_dev->lock);
265 iowrite32(0, vp_dev->ioaddr + VIRTIO_PCI_QUEUE_PFN);
272 /* the config->del_vq() implementation */
273 static void vp_del_vq(struct virtqueue *vq)
275 struct virtio_pci_device *vp_dev = to_vp_device(vq->vdev);
276 struct virtio_pci_vq_info *info = vq->priv;
278 spin_lock(&vp_dev->lock);
279 list_del(&info->node);
280 spin_unlock(&vp_dev->lock);
282 vring_del_virtqueue(vq);
284 /* Select and deactivate the queue */
285 iowrite16(info->queue_index, vp_dev->ioaddr + VIRTIO_PCI_QUEUE_SEL);
286 iowrite32(0, vp_dev->ioaddr + VIRTIO_PCI_QUEUE_PFN);
292 static struct virtio_config_ops virtio_pci_config_ops = {
293 .feature = vp_feature,
296 .get_status = vp_get_status,
297 .set_status = vp_set_status,
299 .find_vq = vp_find_vq,
303 /* the PCI probing function */
304 static int __devinit virtio_pci_probe(struct pci_dev *pci_dev,
305 const struct pci_device_id *id)
307 struct virtio_pci_device *vp_dev;
310 /* We only own devices >= 0x1000 and <= 0x103f: leave the rest. */
311 if (pci_dev->device < 0x1000 || pci_dev->device > 0x103f)
314 if (pci_dev->revision != VIRTIO_PCI_ABI_VERSION) {
315 printk(KERN_ERR "virtio_pci: expected ABI version %d, got %d\n",
316 VIRTIO_PCI_ABI_VERSION, pci_dev->revision);
320 /* allocate our structure and fill it out */
321 vp_dev = kzalloc(sizeof(struct virtio_pci_device), GFP_KERNEL);
325 snprintf(vp_dev->vdev.dev.bus_id, BUS_ID_SIZE, "virtio%d", dev_index);
326 vp_dev->vdev.index = dev_index;
329 vp_dev->vdev.dev.parent = &virtio_pci_root;
330 vp_dev->vdev.config = &virtio_pci_config_ops;
331 vp_dev->pci_dev = pci_dev;
332 INIT_LIST_HEAD(&vp_dev->virtqueues);
333 spin_lock_init(&vp_dev->lock);
335 /* enable the device */
336 err = pci_enable_device(pci_dev);
340 err = pci_request_regions(pci_dev, "virtio-pci");
342 goto out_enable_device;
344 vp_dev->ioaddr = pci_iomap(pci_dev, 0, 0);
345 if (vp_dev->ioaddr == NULL)
346 goto out_req_regions;
348 pci_set_drvdata(pci_dev, vp_dev);
350 /* we use the subsystem vendor/device id as the virtio vendor/device
351 * id. this allows us to use the same PCI vendor/device id for all
352 * virtio devices and to identify the particular virtio driver by
353 * the subsytem ids */
354 vp_dev->vdev.id.vendor = pci_dev->subsystem_vendor;
355 vp_dev->vdev.id.device = pci_dev->subsystem_device;
357 /* register a handler for the queue with the PCI device's interrupt */
358 err = request_irq(vp_dev->pci_dev->irq, vp_interrupt, IRQF_SHARED,
359 vp_dev->vdev.dev.bus_id, vp_dev);
361 goto out_set_drvdata;
363 /* finally register the virtio device */
364 err = register_virtio_device(&vp_dev->vdev);
371 free_irq(pci_dev->irq, vp_dev);
373 pci_set_drvdata(pci_dev, NULL);
374 pci_iounmap(pci_dev, vp_dev->ioaddr);
376 pci_release_regions(pci_dev);
378 pci_disable_device(pci_dev);
384 static void __devexit virtio_pci_remove(struct pci_dev *pci_dev)
386 struct virtio_pci_device *vp_dev = pci_get_drvdata(pci_dev);
388 free_irq(pci_dev->irq, vp_dev);
389 pci_set_drvdata(pci_dev, NULL);
390 pci_iounmap(pci_dev, vp_dev->ioaddr);
391 pci_release_regions(pci_dev);
392 pci_disable_device(pci_dev);
397 static int virtio_pci_suspend(struct pci_dev *pci_dev, pm_message_t state)
399 pci_save_state(pci_dev);
400 pci_set_power_state(pci_dev, PCI_D3hot);
404 static int virtio_pci_resume(struct pci_dev *pci_dev)
406 pci_restore_state(pci_dev);
407 pci_set_power_state(pci_dev, PCI_D0);
412 static struct pci_driver virtio_pci_driver = {
413 .name = "virtio-pci",
414 .id_table = virtio_pci_id_table,
415 .probe = virtio_pci_probe,
416 .remove = virtio_pci_remove,
418 .suspend = virtio_pci_suspend,
419 .resume = virtio_pci_resume,
423 static int __init virtio_pci_init(void)
427 err = device_register(&virtio_pci_root);
431 err = pci_register_driver(&virtio_pci_driver);
433 device_unregister(&virtio_pci_root);
438 module_init(virtio_pci_init);
440 static void __exit virtio_pci_exit(void)
442 device_unregister(&virtio_pci_root);
443 pci_unregister_driver(&virtio_pci_driver);
446 module_exit(virtio_pci_exit);