hw/virtio/vhost-user-gpio.c

   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)