xref: /openbmc/qemu/include/hw/virtio/virtio-bus.h (revision 61b9251a)
1 /*
2  * VirtioBus
3  *
4  *  Copyright (C) 2012 : GreenSocs Ltd
5  *      http://www.greensocs.com/ , email: info@greensocs.com
6  *
7  *  Developed by :
8  *  Frederic Konrad   <fred.konrad@greensocs.com>
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation, either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License along
21  * with this program; if not, see <http://www.gnu.org/licenses/>.
22  *
23  */
24 
25 #ifndef VIRTIO_BUS_H
26 #define VIRTIO_BUS_H
27 
28 #include "hw/qdev.h"
29 #include "sysemu/sysemu.h"
30 #include "hw/virtio/virtio.h"
31 
32 #define TYPE_VIRTIO_BUS "virtio-bus"
33 #define VIRTIO_BUS_GET_CLASS(obj) \
34         OBJECT_GET_CLASS(VirtioBusClass, obj, TYPE_VIRTIO_BUS)
35 #define VIRTIO_BUS_CLASS(klass) \
36         OBJECT_CLASS_CHECK(VirtioBusClass, klass, TYPE_VIRTIO_BUS)
37 #define VIRTIO_BUS(obj) OBJECT_CHECK(VirtioBusState, (obj), TYPE_VIRTIO_BUS)
38 
39 typedef struct VirtioBusState VirtioBusState;
40 
41 typedef struct VirtioBusClass {
42     /* This is what a VirtioBus must implement */
43     BusClass parent;
44     void (*notify)(DeviceState *d, uint16_t vector);
45     void (*save_config)(DeviceState *d, QEMUFile *f);
46     void (*save_queue)(DeviceState *d, int n, QEMUFile *f);
47     void (*save_extra_state)(DeviceState *d, QEMUFile *f);
48     int (*load_config)(DeviceState *d, QEMUFile *f);
49     int (*load_queue)(DeviceState *d, int n, QEMUFile *f);
50     int (*load_done)(DeviceState *d, QEMUFile *f);
51     int (*load_extra_state)(DeviceState *d, QEMUFile *f);
52     bool (*has_extra_state)(DeviceState *d);
53     bool (*query_guest_notifiers)(DeviceState *d);
54     int (*set_guest_notifiers)(DeviceState *d, int nvqs, bool assign);
55     int (*set_host_notifier)(DeviceState *d, int n, bool assigned);
56     void (*vmstate_change)(DeviceState *d, bool running);
57     /*
58      * transport independent init function.
59      * This is called by virtio-bus just after the device is plugged.
60      */
61     void (*device_plugged)(DeviceState *d, Error **errp);
62     /*
63      * transport independent exit function.
64      * This is called by virtio-bus just before the device is unplugged.
65      */
66     void (*device_unplugged)(DeviceState *d);
67     int (*query_nvectors)(DeviceState *d);
68     /*
69      * Does the transport have variable vring alignment?
70      * (ie can it ever call virtio_queue_set_align()?)
71      * Note that changing this will break migration for this transport.
72      */
73     bool has_variable_vring_alignment;
74 } VirtioBusClass;
75 
76 struct VirtioBusState {
77     BusState parent_obj;
78 };
79 
80 void virtio_bus_device_plugged(VirtIODevice *vdev, Error **errp);
81 void virtio_bus_reset(VirtioBusState *bus);
82 void virtio_bus_device_unplugged(VirtIODevice *bus);
83 /* Get the device id of the plugged device. */
84 uint16_t virtio_bus_get_vdev_id(VirtioBusState *bus);
85 /* Get the config_len field of the plugged device. */
86 size_t virtio_bus_get_vdev_config_len(VirtioBusState *bus);
87 /* Get the features of the plugged device. */
88 uint32_t virtio_bus_get_vdev_features(VirtioBusState *bus,
89                                     uint32_t requested_features);
90 /* Get bad features of the plugged device. */
91 uint32_t virtio_bus_get_vdev_bad_features(VirtioBusState *bus);
92 /* Get config of the plugged device. */
93 void virtio_bus_get_vdev_config(VirtioBusState *bus, uint8_t *config);
94 /* Set config of the plugged device. */
95 void virtio_bus_set_vdev_config(VirtioBusState *bus, uint8_t *config);
96 
97 static inline VirtIODevice *virtio_bus_get_device(VirtioBusState *bus)
98 {
99     BusState *qbus = &bus->parent_obj;
100     BusChild *kid = QTAILQ_FIRST(&qbus->children);
101     DeviceState *qdev = kid ? kid->child : NULL;
102 
103     /* This is used on the data path, the cast is guaranteed
104      * to succeed by the qdev machinery.
105      */
106     return (VirtIODevice *)qdev;
107 }
108 
109 #endif /* VIRTIO_BUS_H */
110