1 #include "qemu/osdep.h"
5 #include "qapi/error.h"
6 #include "qemu/error-report.h"
7 #include "qemu/module.h"
8 #include "sysemu/sysemu.h"
9 #include "migration/vmstate.h"
10 #include "monitor/monitor.h"
12 #include "qemu/cutils.h"
14 static void usb_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent);
16 static char *usb_get_dev_path(DeviceState *dev);
17 static char *usb_get_fw_dev_path(DeviceState *qdev);
18 static void usb_qdev_unrealize(DeviceState *qdev, Error **errp);
20 static Property usb_props[] = {
21 DEFINE_PROP_STRING("port", USBDevice, port_path),
22 DEFINE_PROP_STRING("serial", USBDevice, serial),
23 DEFINE_PROP_BIT("full-path", USBDevice, flags,
24 USB_DEV_FLAG_FULL_PATH, true),
25 DEFINE_PROP_BIT("msos-desc", USBDevice, flags,
26 USB_DEV_FLAG_MSOS_DESC_ENABLE, true),
27 DEFINE_PROP_END_OF_LIST()
30 static void usb_bus_class_init(ObjectClass *klass, void *data)
32 BusClass *k = BUS_CLASS(klass);
33 HotplugHandlerClass *hc = HOTPLUG_HANDLER_CLASS(klass);
35 k->print_dev = usb_bus_dev_print;
36 k->get_dev_path = usb_get_dev_path;
37 k->get_fw_dev_path = usb_get_fw_dev_path;
38 hc->unplug = qdev_simple_device_unplug_cb;
41 static const TypeInfo usb_bus_info = {
44 .instance_size = sizeof(USBBus),
45 .class_init = usb_bus_class_init,
46 .interfaces = (InterfaceInfo[]) {
47 { TYPE_HOTPLUG_HANDLER },
52 static int next_usb_bus = 0;
53 static QTAILQ_HEAD(, USBBus) busses = QTAILQ_HEAD_INITIALIZER(busses);
55 static int usb_device_post_load(void *opaque, int version_id)
57 USBDevice *dev = opaque;
59 if (dev->state == USB_STATE_NOTATTACHED) {
60 dev->attached = false;
67 const VMStateDescription vmstate_usb_device = {
70 .minimum_version_id = 1,
71 .post_load = usb_device_post_load,
72 .fields = (VMStateField[]) {
73 VMSTATE_UINT8(addr, USBDevice),
74 VMSTATE_INT32(state, USBDevice),
75 VMSTATE_INT32(remote_wakeup, USBDevice),
76 VMSTATE_INT32(setup_state, USBDevice),
77 VMSTATE_INT32(setup_len, USBDevice),
78 VMSTATE_INT32(setup_index, USBDevice),
79 VMSTATE_UINT8_ARRAY(setup_buf, USBDevice, 8),
80 VMSTATE_END_OF_LIST(),
84 void usb_bus_new(USBBus *bus, size_t bus_size,
85 USBBusOps *ops, DeviceState *host)
87 qbus_create_inplace(bus, bus_size, TYPE_USB_BUS, host, NULL);
88 qbus_set_bus_hotplug_handler(BUS(bus), &error_abort);
90 bus->busnr = next_usb_bus++;
91 QTAILQ_INIT(&bus->free);
92 QTAILQ_INIT(&bus->used);
93 QTAILQ_INSERT_TAIL(&busses, bus, next);
96 void usb_bus_release(USBBus *bus)
98 assert(next_usb_bus > 0);
100 QTAILQ_REMOVE(&busses, bus, next);
103 USBBus *usb_bus_find(int busnr)
108 return QTAILQ_FIRST(&busses);
109 QTAILQ_FOREACH(bus, &busses, next) {
110 if (bus->busnr == busnr)
116 static void usb_device_realize(USBDevice *dev, Error **errp)
118 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
120 if (klass->realize) {
121 klass->realize(dev, errp);
125 USBDevice *usb_device_find_device(USBDevice *dev, uint8_t addr)
127 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
128 if (klass->find_device) {
129 return klass->find_device(dev, addr);
134 static void usb_device_unrealize(USBDevice *dev, Error **errp)
136 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
138 if (klass->unrealize) {
139 klass->unrealize(dev, errp);
143 void usb_device_cancel_packet(USBDevice *dev, USBPacket *p)
145 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
146 if (klass->cancel_packet) {
147 klass->cancel_packet(dev, p);
151 void usb_device_handle_attach(USBDevice *dev)
153 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
154 if (klass->handle_attach) {
155 klass->handle_attach(dev);
159 void usb_device_handle_reset(USBDevice *dev)
161 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
162 if (klass->handle_reset) {
163 klass->handle_reset(dev);
167 void usb_device_handle_control(USBDevice *dev, USBPacket *p, int request,
168 int value, int index, int length, uint8_t *data)
170 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
171 if (klass->handle_control) {
172 klass->handle_control(dev, p, request, value, index, length, data);
176 void usb_device_handle_data(USBDevice *dev, USBPacket *p)
178 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
179 if (klass->handle_data) {
180 klass->handle_data(dev, p);
184 const char *usb_device_get_product_desc(USBDevice *dev)
186 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
187 return klass->product_desc;
190 const USBDesc *usb_device_get_usb_desc(USBDevice *dev)
192 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
194 return dev->usb_desc;
196 return klass->usb_desc;
199 void usb_device_set_interface(USBDevice *dev, int interface,
200 int alt_old, int alt_new)
202 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
203 if (klass->set_interface) {
204 klass->set_interface(dev, interface, alt_old, alt_new);
208 void usb_device_flush_ep_queue(USBDevice *dev, USBEndpoint *ep)
210 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
211 if (klass->flush_ep_queue) {
212 klass->flush_ep_queue(dev, ep);
216 void usb_device_ep_stopped(USBDevice *dev, USBEndpoint *ep)
218 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
219 if (klass->ep_stopped) {
220 klass->ep_stopped(dev, ep);
224 int usb_device_alloc_streams(USBDevice *dev, USBEndpoint **eps, int nr_eps,
227 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
228 if (klass->alloc_streams) {
229 return klass->alloc_streams(dev, eps, nr_eps, streams);
234 void usb_device_free_streams(USBDevice *dev, USBEndpoint **eps, int nr_eps)
236 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
237 if (klass->free_streams) {
238 klass->free_streams(dev, eps, nr_eps);
242 static void usb_qdev_realize(DeviceState *qdev, Error **errp)
244 USBDevice *dev = USB_DEVICE(qdev);
245 Error *local_err = NULL;
247 pstrcpy(dev->product_desc, sizeof(dev->product_desc),
248 usb_device_get_product_desc(dev));
249 dev->auto_attach = 1;
250 QLIST_INIT(&dev->strings);
253 usb_claim_port(dev, &local_err);
255 error_propagate(errp, local_err);
259 usb_device_realize(dev, &local_err);
261 usb_release_port(dev);
262 error_propagate(errp, local_err);
266 if (dev->auto_attach) {
267 usb_device_attach(dev, &local_err);
269 usb_qdev_unrealize(qdev, NULL);
270 error_propagate(errp, local_err);
276 static void usb_qdev_unrealize(DeviceState *qdev, Error **errp)
278 USBDevice *dev = USB_DEVICE(qdev);
279 USBDescString *s, *next;
281 QLIST_FOREACH_SAFE(s, &dev->strings, next, next) {
282 QLIST_REMOVE(s, next);
288 usb_device_detach(dev);
290 usb_device_unrealize(dev, errp);
292 usb_release_port(dev);
296 typedef struct LegacyUSBFactory
299 const char *usbdevice_name;
300 USBDevice *(*usbdevice_init)(USBBus *bus, const char *params);
303 static GSList *legacy_usb_factory;
305 void usb_legacy_register(const char *typename, const char *usbdevice_name,
306 USBDevice *(*usbdevice_init)(USBBus *bus,
309 if (usbdevice_name) {
310 LegacyUSBFactory *f = g_malloc0(sizeof(*f));
312 f->usbdevice_name = usbdevice_name;
313 f->usbdevice_init = usbdevice_init;
314 legacy_usb_factory = g_slist_append(legacy_usb_factory, f);
318 USBDevice *usb_create(USBBus *bus, const char *name)
322 dev = qdev_create(&bus->qbus, name);
323 return USB_DEVICE(dev);
326 static USBDevice *usb_try_create_simple(USBBus *bus, const char *name,
332 dev = USB_DEVICE(qdev_try_create(&bus->qbus, name));
334 error_setg(errp, "Failed to create USB device '%s'", name);
337 object_property_set_bool(OBJECT(dev), true, "realized", &err);
339 error_propagate_prepend(errp, err,
340 "Failed to initialize USB device '%s': ",
347 USBDevice *usb_create_simple(USBBus *bus, const char *name)
349 return usb_try_create_simple(bus, name, &error_abort);
352 static void usb_fill_port(USBPort *port, void *opaque, int index,
353 USBPortOps *ops, int speedmask)
355 port->opaque = opaque;
358 port->speedmask = speedmask;
359 usb_port_location(port, NULL, index + 1);
362 void usb_register_port(USBBus *bus, USBPort *port, void *opaque, int index,
363 USBPortOps *ops, int speedmask)
365 usb_fill_port(port, opaque, index, ops, speedmask);
366 QTAILQ_INSERT_TAIL(&bus->free, port, next);
370 void usb_register_companion(const char *masterbus, USBPort *ports[],
371 uint32_t portcount, uint32_t firstport,
372 void *opaque, USBPortOps *ops, int speedmask,
378 QTAILQ_FOREACH(bus, &busses, next) {
379 if (strcmp(bus->qbus.name, masterbus) == 0) {
385 error_setg(errp, "USB bus '%s' not found", masterbus);
388 if (!bus->ops->register_companion) {
389 error_setg(errp, "Can't use USB bus '%s' as masterbus,"
390 " it doesn't support companion controllers",
395 for (i = 0; i < portcount; i++) {
396 usb_fill_port(ports[i], opaque, i, ops, speedmask);
399 bus->ops->register_companion(bus, ports, portcount, firstport, errp);
402 void usb_port_location(USBPort *downstream, USBPort *upstream, int portnr)
405 int l = snprintf(downstream->path, sizeof(downstream->path), "%s.%d",
406 upstream->path, portnr);
407 /* Max string is nn.nn.nn.nn.nn, which fits in 16 bytes */
408 assert(l < sizeof(downstream->path));
409 downstream->hubcount = upstream->hubcount + 1;
411 snprintf(downstream->path, sizeof(downstream->path), "%d", portnr);
412 downstream->hubcount = 0;
416 void usb_unregister_port(USBBus *bus, USBPort *port)
419 object_unparent(OBJECT(port->dev));
421 QTAILQ_REMOVE(&bus->free, port, next);
425 void usb_claim_port(USBDevice *dev, Error **errp)
427 USBBus *bus = usb_bus_from_device(dev);
430 assert(dev->port == NULL);
432 if (dev->port_path) {
433 QTAILQ_FOREACH(port, &bus->free, next) {
434 if (strcmp(port->path, dev->port_path) == 0) {
439 error_setg(errp, "usb port %s (bus %s) not found (in use?)",
440 dev->port_path, bus->qbus.name);
444 if (bus->nfree == 1 && strcmp(object_get_typename(OBJECT(dev)), "usb-hub") != 0) {
445 /* Create a new hub and chain it on */
446 usb_try_create_simple(bus, "usb-hub", NULL);
448 if (bus->nfree == 0) {
449 error_setg(errp, "tried to attach usb device %s to a bus "
450 "with no free ports", dev->product_desc);
453 port = QTAILQ_FIRST(&bus->free);
455 trace_usb_port_claim(bus->busnr, port->path);
457 QTAILQ_REMOVE(&bus->free, port, next);
463 QTAILQ_INSERT_TAIL(&bus->used, port, next);
467 void usb_release_port(USBDevice *dev)
469 USBBus *bus = usb_bus_from_device(dev);
470 USBPort *port = dev->port;
472 assert(port != NULL);
473 trace_usb_port_release(bus->busnr, port->path);
475 QTAILQ_REMOVE(&bus->used, port, next);
481 QTAILQ_INSERT_TAIL(&bus->free, port, next);
485 static void usb_mask_to_str(char *dest, size_t size,
486 unsigned int speedmask)
488 static const struct {
492 { .mask = USB_SPEED_MASK_FULL, .name = "full" },
493 { .mask = USB_SPEED_MASK_HIGH, .name = "high" },
494 { .mask = USB_SPEED_MASK_SUPER, .name = "super" },
498 for (i = 0; i < ARRAY_SIZE(speeds); i++) {
499 if (speeds[i].mask & speedmask) {
500 pos += snprintf(dest + pos, size - pos, "%s%s",
507 snprintf(dest, size, "unknown");
511 void usb_check_attach(USBDevice *dev, Error **errp)
513 USBBus *bus = usb_bus_from_device(dev);
514 USBPort *port = dev->port;
515 char devspeed[32], portspeed[32];
517 assert(port != NULL);
518 assert(!dev->attached);
519 usb_mask_to_str(devspeed, sizeof(devspeed), dev->speedmask);
520 usb_mask_to_str(portspeed, sizeof(portspeed), port->speedmask);
521 trace_usb_port_attach(bus->busnr, port->path,
522 devspeed, portspeed);
524 if (!(port->speedmask & dev->speedmask)) {
525 error_setg(errp, "Warning: speed mismatch trying to attach"
526 " usb device \"%s\" (%s speed)"
527 " to bus \"%s\", port \"%s\" (%s speed)",
528 dev->product_desc, devspeed,
529 bus->qbus.name, port->path, portspeed);
534 void usb_device_attach(USBDevice *dev, Error **errp)
536 USBPort *port = dev->port;
537 Error *local_err = NULL;
539 usb_check_attach(dev, &local_err);
541 error_propagate(errp, local_err);
545 dev->attached = true;
549 int usb_device_detach(USBDevice *dev)
551 USBBus *bus = usb_bus_from_device(dev);
552 USBPort *port = dev->port;
554 assert(port != NULL);
555 assert(dev->attached);
556 trace_usb_port_detach(bus->busnr, port->path);
559 dev->attached = false;
563 static const char *usb_speed(unsigned int speed)
565 static const char *txt[] = {
566 [ USB_SPEED_LOW ] = "1.5",
567 [ USB_SPEED_FULL ] = "12",
568 [ USB_SPEED_HIGH ] = "480",
569 [ USB_SPEED_SUPER ] = "5000",
571 if (speed >= ARRAY_SIZE(txt))
576 static void usb_bus_dev_print(Monitor *mon, DeviceState *qdev, int indent)
578 USBDevice *dev = USB_DEVICE(qdev);
579 USBBus *bus = usb_bus_from_device(dev);
581 monitor_printf(mon, "%*saddr %d.%d, port %s, speed %s, name %s%s\n",
582 indent, "", bus->busnr, dev->addr,
583 dev->port ? dev->port->path : "-",
584 usb_speed(dev->speed), dev->product_desc,
585 dev->attached ? ", attached" : "");
588 static char *usb_get_dev_path(DeviceState *qdev)
590 USBDevice *dev = USB_DEVICE(qdev);
591 DeviceState *hcd = qdev->parent_bus->parent;
594 if (dev->flags & (1 << USB_DEV_FLAG_FULL_PATH)) {
595 id = qdev_get_dev_path(hcd);
598 char *ret = g_strdup_printf("%s/%s", id, dev->port->path);
602 return g_strdup(dev->port->path);
606 static char *usb_get_fw_dev_path(DeviceState *qdev)
608 USBDevice *dev = USB_DEVICE(qdev);
610 ssize_t pos = 0, fw_len;
613 fw_len = 32 + strlen(dev->port->path) * 6;
614 fw_path = g_malloc(fw_len);
615 in = dev->port->path;
616 while (fw_len - pos > 0) {
617 nr = strtol(in, &in, 10);
619 /* some hub between root port and device */
620 pos += snprintf(fw_path + pos, fw_len - pos, "hub@%lx/", nr);
623 /* the device itself */
624 pos += snprintf(fw_path + pos, fw_len - pos, "%s@%lx",
625 qdev_fw_name(qdev), nr);
632 void hmp_info_usb(Monitor *mon, const QDict *qdict)
638 if (QTAILQ_EMPTY(&busses)) {
639 monitor_printf(mon, "USB support not enabled\n");
643 QTAILQ_FOREACH(bus, &busses, next) {
644 QTAILQ_FOREACH(port, &bus->used, next) {
648 monitor_printf(mon, " Device %d.%d, Port %s, Speed %s Mb/s, "
650 bus->busnr, dev->addr, port->path,
651 usb_speed(dev->speed), dev->product_desc,
652 dev->qdev.id ? ", ID: " : "",
658 /* handle legacy -usbdevice cmd line option */
659 USBDevice *usbdevice_create(const char *cmdline)
661 USBBus *bus = usb_bus_find(-1 /* any */);
662 LegacyUSBFactory *f = NULL;
670 params = strchr(cmdline,':');
673 len = params - cmdline;
674 if (len > sizeof(driver))
675 len = sizeof(driver);
676 pstrcpy(driver, len, cmdline);
679 pstrcpy(driver, sizeof(driver), cmdline);
682 for (i = legacy_usb_factory; i; i = i->next) {
684 if (strcmp(f->usbdevice_name, driver) == 0) {
690 /* no error because some drivers are not converted (yet) */
691 error_report("usbdevice %s not found", driver);
697 error_report("Error: no usb bus to attach usbdevice %s, "
698 "please try -machine usb=on and check that "
699 "the machine model supports USB", driver);
703 if (f->usbdevice_init) {
704 dev = f->usbdevice_init(bus, params);
707 error_report("usbdevice %s accepts no params", driver);
710 dev = usb_create(bus, f->name);
713 error_report("Failed to create USB device '%s'", f->name);
716 object_property_set_bool(OBJECT(dev), true, "realized", &err);
718 error_reportf_err(err, "Failed to initialize USB device '%s': ",
720 object_unparent(OBJECT(dev));
726 static bool usb_get_attached(Object *obj, Error **errp)
728 USBDevice *dev = USB_DEVICE(obj);
730 return dev->attached;
733 static void usb_set_attached(Object *obj, bool value, Error **errp)
735 USBDevice *dev = USB_DEVICE(obj);
738 if (dev->attached == value) {
743 usb_device_attach(dev, &err);
744 error_propagate(errp, err);
746 usb_device_detach(dev);
750 static void usb_device_instance_init(Object *obj)
752 USBDevice *dev = USB_DEVICE(obj);
753 USBDeviceClass *klass = USB_DEVICE_GET_CLASS(dev);
755 if (klass->attached_settable) {
756 object_property_add_bool(obj, "attached",
757 usb_get_attached, usb_set_attached,
760 object_property_add_bool(obj, "attached",
761 usb_get_attached, NULL,
766 static void usb_device_class_init(ObjectClass *klass, void *data)
768 DeviceClass *k = DEVICE_CLASS(klass);
769 k->bus_type = TYPE_USB_BUS;
770 k->realize = usb_qdev_realize;
771 k->unrealize = usb_qdev_unrealize;
772 k->props = usb_props;
775 static const TypeInfo usb_device_type_info = {
776 .name = TYPE_USB_DEVICE,
777 .parent = TYPE_DEVICE,
778 .instance_size = sizeof(USBDevice),
779 .instance_init = usb_device_instance_init,
781 .class_size = sizeof(USBDeviceClass),
782 .class_init = usb_device_class_init,
785 static void usb_register_types(void)
787 type_register_static(&usb_bus_info);
788 type_register_static(&usb_device_type_info);
791 type_init(usb_register_types)