xref: /openbmc/qemu/hw/virtio/vhost-user-gpio.c (revision fa3673e4) 
1 /*
2  * Vhost-user GPIO virtio device
3  *
4  * Copyright (c) 2022 Viresh Kumar <viresh.kumar@linaro.org>
5  *
6  * SPDX-License-Identifier: GPL-2.0-or-later
7  */
8 
9 #include "qemu/osdep.h"
10 #include "qapi/error.h"
11 #include "hw/qdev-properties.h"
12 #include "hw/virtio/virtio-bus.h"
13 #include "hw/virtio/vhost-user-gpio.h"
14 #include "qemu/error-report.h"
15 #include "standard-headers/linux/virtio_ids.h"
16 #include "trace.h"
17 
18 #define VHOST_NVQS 2
19 
20 /* Features required from VirtIO */
21 static const int feature_bits[] = {
22     VIRTIO_F_VERSION_1,
23     VIRTIO_F_NOTIFY_ON_EMPTY,
24     VIRTIO_RING_F_INDIRECT_DESC,
25     VIRTIO_RING_F_EVENT_IDX,
26     VIRTIO_GPIO_F_IRQ,
27     VIRTIO_F_RING_RESET,
28     VHOST_INVALID_FEATURE_BIT
29 };
30 
31 static void vu_gpio_get_config(VirtIODevice *vdev, uint8_t *config)
32 {
33     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
34 
35     memcpy(config, &gpio->config, sizeof(gpio->config));
36 }
37 
38 static int vu_gpio_config_notifier(struct vhost_dev *dev)
39 {
40     VHostUserGPIO *gpio = VHOST_USER_GPIO(dev->vdev);
41 
42     memcpy(dev->vdev->config, &gpio->config, sizeof(gpio->config));
43     virtio_notify_config(dev->vdev);
44 
45     return 0;
46 }
47 
48 const VhostDevConfigOps gpio_ops = {
49     .vhost_dev_config_notifier = vu_gpio_config_notifier,
50 };
51 
52 static int vu_gpio_start(VirtIODevice *vdev)
53 {
54     BusState *qbus = BUS(qdev_get_parent_bus(DEVICE(vdev)));
55     VirtioBusClass *k = VIRTIO_BUS_GET_CLASS(qbus);
56     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
57     struct vhost_dev *vhost_dev = &gpio->vhost_dev;
58     int ret, i;
59 
60     if (!k->set_guest_notifiers) {
61         error_report("binding does not support guest notifiers");
62         return -ENOSYS;
63     }
64 
65     ret = vhost_dev_enable_notifiers(vhost_dev, vdev);
66     if (ret < 0) {
67         error_report("Error enabling host notifiers: %d", ret);
68         return ret;
69     }
70 
71     ret = k->set_guest_notifiers(qbus->parent, vhost_dev->nvqs, true);
72     if (ret < 0) {
73         error_report("Error binding guest notifier: %d", ret);
74         goto err_host_notifiers;
75     }
76 
77     /*
78      * Before we start up we need to ensure we have the final feature
79      * set needed for the vhost configuration. The backend may also
80      * apply backend_features when the feature set is sent.
81      */
82     vhost_ack_features(&gpio->vhost_dev, feature_bits, vdev->guest_features);
83 
84     ret = vhost_dev_start(&gpio->vhost_dev, vdev, false);
85     if (ret < 0) {
86         error_report("Error starting vhost-user-gpio: %d", ret);
87         goto err_guest_notifiers;
88     }
89     gpio->started_vu = true;
90 
91     /*
92      * guest_notifier_mask/pending not used yet, so just unmask
93      * everything here. virtio-pci will do the right thing by
94      * enabling/disabling irqfd.
95      */
96     for (i = 0; i < gpio->vhost_dev.nvqs; i++) {
97         vhost_virtqueue_mask(&gpio->vhost_dev, vdev, i, false);
98     }
99 
100     /*
101      * As we must have VHOST_USER_F_PROTOCOL_FEATURES (because
102      * VHOST_USER_GET_CONFIG requires it) we need to explicitly enable
103      * the vrings.
104      */
105     g_assert(vhost_dev->vhost_ops &&
106              vhost_dev->vhost_ops->vhost_set_vring_enable);
107     ret = vhost_dev->vhost_ops->vhost_set_vring_enable(vhost_dev, true);
108     if (ret == 0) {
109         return 0;
110     }
111 
112     error_report("Failed to start vrings for vhost-user-gpio: %d", ret);
113 
114 err_guest_notifiers:
115     k->set_guest_notifiers(qbus->parent, gpio->vhost_dev.nvqs, false);
116 err_host_notifiers:
117     vhost_dev_disable_notifiers(&gpio->vhost_dev, vdev);
118 
119     return ret;
120 }
121 
122 static void vu_gpio_stop(VirtIODevice *vdev)
123 {
124     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
125     BusState *qbus = BUS(qdev_get_parent_bus(DEVICE(vdev)));
126     VirtioBusClass *k = VIRTIO_BUS_GET_CLASS(qbus);
127     struct vhost_dev *vhost_dev = &gpio->vhost_dev;
128     int ret;
129 
130     if (!gpio->started_vu) {
131         return;
132     }
133     gpio->started_vu = false;
134 
135     if (!k->set_guest_notifiers) {
136         return;
137     }
138 
139     vhost_dev_stop(vhost_dev, vdev, false);
140 
141     ret = k->set_guest_notifiers(qbus->parent, vhost_dev->nvqs, false);
142     if (ret < 0) {
143         error_report("vhost guest notifier cleanup failed: %d", ret);
144         return;
145     }
146 
147     vhost_dev_disable_notifiers(vhost_dev, vdev);
148 }
149 
150 static void vu_gpio_set_status(VirtIODevice *vdev, uint8_t status)
151 {
152     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
153     bool should_start = virtio_device_should_start(vdev, status);
154 
155     trace_virtio_gpio_set_status(status);
156 
157     if (!gpio->connected) {
158         return;
159     }
160 
161     if (vhost_dev_is_started(&gpio->vhost_dev) == should_start) {
162         return;
163     }
164 
165     if (should_start) {
166         if (vu_gpio_start(vdev)) {
167             qemu_chr_fe_disconnect(&gpio->chardev);
168         }
169     } else {
170         vu_gpio_stop(vdev);
171     }
172 }
173 
174 static uint64_t vu_gpio_get_features(VirtIODevice *vdev, uint64_t features,
175                                      Error **errp)
176 {
177     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
178 
179     return vhost_get_features(&gpio->vhost_dev, feature_bits, features);
180 }
181 
182 static void vu_gpio_handle_output(VirtIODevice *vdev, VirtQueue *vq)
183 {
184     /*
185      * Not normally called; it's the daemon that handles the queue;
186      * however virtio's cleanup path can call this.
187      */
188 }
189 
190 static void vu_gpio_guest_notifier_mask(VirtIODevice *vdev, int idx, bool mask)
191 {
192     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
193 
194     /*
195      * Add the check for configure interrupt, Use VIRTIO_CONFIG_IRQ_IDX -1
196      * as the macro of configure interrupt's IDX, If this driver does not
197      * support, the function will return
198      */
199 
200     if (idx == VIRTIO_CONFIG_IRQ_IDX) {
201         return;
202     }
203 
204     vhost_virtqueue_mask(&gpio->vhost_dev, vdev, idx, mask);
205 }
206 
207 static struct vhost_dev *vu_gpio_get_vhost(VirtIODevice *vdev)
208 {
209     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
210     return &gpio->vhost_dev;
211 }
212 
213 static void do_vhost_user_cleanup(VirtIODevice *vdev, VHostUserGPIO *gpio)
214 {
215     virtio_delete_queue(gpio->command_vq);
216     virtio_delete_queue(gpio->interrupt_vq);
217     g_free(gpio->vhost_vqs);
218     virtio_cleanup(vdev);
219     vhost_user_cleanup(&gpio->vhost_user);
220 }
221 
222 static int vu_gpio_connect(DeviceState *dev, Error **errp)
223 {
224     VirtIODevice *vdev = VIRTIO_DEVICE(dev);
225     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
226     struct vhost_dev *vhost_dev = &gpio->vhost_dev;
227     int ret;
228 
229     if (gpio->connected) {
230         return 0;
231     }
232     gpio->connected = true;
233 
234     vhost_dev_set_config_notifier(vhost_dev, &gpio_ops);
235     gpio->vhost_user.supports_config = true;
236 
237     gpio->vhost_dev.nvqs = VHOST_NVQS;
238     gpio->vhost_dev.vqs = gpio->vhost_vqs;
239 
240     ret = vhost_dev_init(vhost_dev, &gpio->vhost_user,
241                          VHOST_BACKEND_TYPE_USER, 0, errp);
242     if (ret < 0) {
243         return ret;
244     }
245 
246     /* restore vhost state */
247     if (virtio_device_started(vdev, vdev->status)) {
248         vu_gpio_start(vdev);
249     }
250 
251     return 0;
252 }
253 
254 static void vu_gpio_event(void *opaque, QEMUChrEvent event);
255 
256 static void vu_gpio_disconnect(DeviceState *dev)
257 {
258     VirtIODevice *vdev = VIRTIO_DEVICE(dev);
259     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
260 
261     if (!gpio->connected) {
262         return;
263     }
264     gpio->connected = false;
265 
266     vu_gpio_stop(vdev);
267     vhost_dev_cleanup(&gpio->vhost_dev);
268 
269     /* Re-instate the event handler for new connections */
270     qemu_chr_fe_set_handlers(&gpio->chardev,
271                              NULL, NULL, vu_gpio_event,
272                              NULL, dev, NULL, true);
273 }
274 
275 static void vu_gpio_event(void *opaque, QEMUChrEvent event)
276 {
277     DeviceState *dev = opaque;
278     VirtIODevice *vdev = VIRTIO_DEVICE(dev);
279     VHostUserGPIO *gpio = VHOST_USER_GPIO(vdev);
280     Error *local_err = NULL;
281 
282     switch (event) {
283     case CHR_EVENT_OPENED:
284         if (vu_gpio_connect(dev, &local_err) < 0) {
285             qemu_chr_fe_disconnect(&gpio->chardev);
286             return;
287         }
288         break;
289     case CHR_EVENT_CLOSED:
290         /* defer close until later to avoid circular close */
291         vhost_user_async_close(dev, &gpio->chardev, &gpio->vhost_dev,
292                                vu_gpio_disconnect, vu_gpio_event);
293         break;
294     case CHR_EVENT_BREAK:
295     case CHR_EVENT_MUX_IN:
296     case CHR_EVENT_MUX_OUT:
297         /* Ignore */
298         break;
299     }
300 }
301 
302 static int vu_gpio_realize_connect(VHostUserGPIO *gpio, Error **errp)
303 {
304     VirtIODevice *vdev = &gpio->parent_obj;
305     DeviceState *dev = &vdev->parent_obj;
306     struct vhost_dev *vhost_dev = &gpio->vhost_dev;
307     int ret;
308 
309     ret = qemu_chr_fe_wait_connected(&gpio->chardev, errp);
310     if (ret < 0) {
311         return ret;
312     }
313 
314     /*
315      * vu_gpio_connect() may have already connected (via the event
316      * callback) in which case it will just report success.
317      */
318     ret = vu_gpio_connect(dev, errp);
319     if (ret < 0) {
320         qemu_chr_fe_disconnect(&gpio->chardev);
321         return ret;
322     }
323     g_assert(gpio->connected);
324 
325     ret = vhost_dev_get_config(vhost_dev, (uint8_t *)&gpio->config,
326                                sizeof(gpio->config), errp);
327 
328     if (ret < 0) {
329         error_report("vhost-user-gpio: get config failed");
330 
331         qemu_chr_fe_disconnect(&gpio->chardev);
332         vhost_dev_cleanup(vhost_dev);
333         return ret;
334     }
335 
336     return 0;
337 }
338 
339 static void vu_gpio_device_realize(DeviceState *dev, Error **errp)
340 {
341     ERRP_GUARD();
342 
343     VirtIODevice *vdev = VIRTIO_DEVICE(dev);
344     VHostUserGPIO *gpio = VHOST_USER_GPIO(dev);
345     int retries, ret;
346 
347     if (!gpio->chardev.chr) {
348         error_setg(errp, "vhost-user-gpio: chardev is mandatory");
349         return;
350     }
351 
352     if (!vhost_user_init(&gpio->vhost_user, &gpio->chardev, errp)) {
353         return;
354     }
355 
356     virtio_init(vdev, VIRTIO_ID_GPIO, sizeof(gpio->config));
357 
358     gpio->command_vq = virtio_add_queue(vdev, 256, vu_gpio_handle_output);
359     gpio->interrupt_vq = virtio_add_queue(vdev, 256, vu_gpio_handle_output);
360     gpio->vhost_vqs = g_new0(struct vhost_virtqueue, VHOST_NVQS);
361 
362     gpio->connected = false;
363 
364     qemu_chr_fe_set_handlers(&gpio->chardev, NULL, NULL, vu_gpio_event, NULL,
365                              dev, NULL, true);
366 
367     retries = VU_REALIZE_CONN_RETRIES;
368     g_assert(!*errp);
369     do {
370         if (*errp) {
371             error_prepend(errp, "Reconnecting after error: ");
372             error_report_err(*errp);
373             *errp = NULL;
374         }
375         ret = vu_gpio_realize_connect(gpio, errp);
376     } while (ret < 0 && retries--);
377 
378     if (ret < 0) {
379         do_vhost_user_cleanup(vdev, gpio);
380     }
381 
382     return;
383 }
384 
385 static void vu_gpio_device_unrealize(DeviceState *dev)
386 {
387     VirtIODevice *vdev = VIRTIO_DEVICE(dev);
388     VHostUserGPIO *gpio = VHOST_USER_GPIO(dev);
389 
390     vu_gpio_set_status(vdev, 0);
391     qemu_chr_fe_set_handlers(&gpio->chardev, NULL, NULL, NULL, NULL, NULL, NULL,
392                              false);
393     vhost_dev_cleanup(&gpio->vhost_dev);
394     do_vhost_user_cleanup(vdev, gpio);
395 }
396 
397 static const VMStateDescription vu_gpio_vmstate = {
398     .name = "vhost-user-gpio",
399     .unmigratable = 1,
400 };
401 
402 static Property vu_gpio_properties[] = {
403     DEFINE_PROP_CHR("chardev", VHostUserGPIO, chardev),
404     DEFINE_PROP_END_OF_LIST(),
405 };
406 
407 static void vu_gpio_class_init(ObjectClass *klass, void *data)
408 {
409     DeviceClass *dc = DEVICE_CLASS(klass);
410     VirtioDeviceClass *vdc = VIRTIO_DEVICE_CLASS(klass);
411 
412     device_class_set_props(dc, vu_gpio_properties);
413     dc->vmsd = &vu_gpio_vmstate;
414     set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
415     vdc->realize = vu_gpio_device_realize;
416     vdc->unrealize = vu_gpio_device_unrealize;
417     vdc->get_features = vu_gpio_get_features;
418     vdc->get_config = vu_gpio_get_config;
419     vdc->set_status = vu_gpio_set_status;
420     vdc->guest_notifier_mask = vu_gpio_guest_notifier_mask;
421     vdc->get_vhost = vu_gpio_get_vhost;
422 }
423 
424 static const TypeInfo vu_gpio_info = {
425     .name = TYPE_VHOST_USER_GPIO,
426     .parent = TYPE_VIRTIO_DEVICE,
427     .instance_size = sizeof(VHostUserGPIO),
428     .class_init = vu_gpio_class_init,
429 };
430 
431 static void vu_gpio_register_types(void)
432 {
433     type_register_static(&vu_gpio_info);
434 }
435 
436 type_init(vu_gpio_register_types)
437