1 /* 2 * USB xHCI controller with PCI bus emulation 3 * 4 * SPDX-FileCopyrightText: 2011 Securiforest 5 * SPDX-FileContributor: Hector Martin <hector@marcansoft.com> 6 * SPDX-sourceInfo: Based on usb-ohci.c, emulates Renesas NEC USB 3.0 7 * SPDX-FileCopyrightText: 2020 Xilinx 8 * SPDX-FileContributor: Sai Pavan Boddu <sai.pavan.boddu@xilinx.com> 9 * SPDX-sourceInfo: Moved the pci specific content for hcd-xhci.c to 10 * hcd-xhci-pci.c 11 * 12 * This library is free software; you can redistribute it and/or 13 * modify it under the terms of the GNU Lesser General Public 14 * License as published by the Free Software Foundation; either 15 * version 2.1 of the License, or (at your option) any later version. 16 * 17 * This library is distributed in the hope that it will be useful, 18 * but WITHOUT ANY WARRANTY; without even the implied warranty of 19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 20 * Lesser General Public License for more details. 21 * 22 * You should have received a copy of the GNU Lesser General Public 23 * License along with this library; if not, see <http://www.gnu.org/licenses/>. 24 */ 25 #include "qemu/osdep.h" 26 #include "hw/pci/pci.h" 27 #include "hw/qdev-properties.h" 28 #include "migration/vmstate.h" 29 #include "hw/pci/msi.h" 30 #include "hw/pci/msix.h" 31 #include "hcd-xhci-pci.h" 32 #include "trace.h" 33 #include "qapi/error.h" 34 35 #define OFF_MSIX_TABLE 0x3000 36 #define OFF_MSIX_PBA 0x3800 37 38 static void xhci_pci_intr_update(XHCIState *xhci, int n, bool enable) 39 { 40 XHCIPciState *s = container_of(xhci, XHCIPciState, xhci); 41 PCIDevice *pci_dev = PCI_DEVICE(s); 42 43 if (!msix_enabled(pci_dev)) { 44 return; 45 } 46 if (enable == !!xhci->intr[n].msix_used) { 47 return; 48 } 49 if (enable) { 50 trace_usb_xhci_irq_msix_use(n); 51 msix_vector_use(pci_dev, n); 52 xhci->intr[n].msix_used = true; 53 } else { 54 trace_usb_xhci_irq_msix_unuse(n); 55 msix_vector_unuse(pci_dev, n); 56 xhci->intr[n].msix_used = false; 57 } 58 } 59 60 static bool xhci_pci_intr_raise(XHCIState *xhci, int n, bool level) 61 { 62 XHCIPciState *s = container_of(xhci, XHCIPciState, xhci); 63 PCIDevice *pci_dev = PCI_DEVICE(s); 64 65 if (n == 0 && 66 !(msix_enabled(pci_dev) || 67 msi_enabled(pci_dev))) { 68 pci_set_irq(pci_dev, level); 69 } 70 71 if (msix_enabled(pci_dev) && level) { 72 msix_notify(pci_dev, n); 73 return true; 74 } 75 76 if (msi_enabled(pci_dev) && level) { 77 n %= msi_nr_vectors_allocated(pci_dev); 78 msi_notify(pci_dev, n); 79 return true; 80 } 81 82 return false; 83 } 84 85 static void xhci_pci_reset(DeviceState *dev) 86 { 87 XHCIPciState *s = XHCI_PCI(dev); 88 89 device_cold_reset(DEVICE(&s->xhci)); 90 } 91 92 static int xhci_pci_vmstate_post_load(void *opaque, int version_id) 93 { 94 XHCIPciState *s = XHCI_PCI(opaque); 95 PCIDevice *pci_dev = PCI_DEVICE(s); 96 int intr; 97 98 for (intr = 0; intr < s->xhci.numintrs; intr++) { 99 if (s->xhci.intr[intr].msix_used) { 100 msix_vector_use(pci_dev, intr); 101 } else { 102 msix_vector_unuse(pci_dev, intr); 103 } 104 } 105 return 0; 106 } 107 108 static void usb_xhci_pci_realize(struct PCIDevice *dev, Error **errp) 109 { 110 int ret; 111 Error *err = NULL; 112 XHCIPciState *s = XHCI_PCI(dev); 113 114 dev->config[PCI_CLASS_PROG] = 0x30; /* xHCI */ 115 dev->config[PCI_INTERRUPT_PIN] = 0x01; /* interrupt pin 1 */ 116 dev->config[PCI_CACHE_LINE_SIZE] = 0x10; 117 dev->config[0x60] = 0x30; /* release number */ 118 119 object_property_set_link(OBJECT(&s->xhci), "host", OBJECT(s), NULL); 120 s->xhci.intr_update = xhci_pci_intr_update; 121 s->xhci.intr_raise = xhci_pci_intr_raise; 122 if (!qdev_realize(DEVICE(&s->xhci), NULL, errp)) { 123 return; 124 } 125 if (strcmp(object_get_typename(OBJECT(dev)), TYPE_NEC_XHCI) == 0) { 126 s->xhci.nec_quirks = true; 127 } 128 129 if (s->msi != ON_OFF_AUTO_OFF) { 130 ret = msi_init(dev, 0x70, s->xhci.numintrs, true, false, &err); 131 /* 132 * Any error other than -ENOTSUP(board's MSI support is broken) 133 * is a programming error 134 */ 135 assert(!ret || ret == -ENOTSUP); 136 if (ret && s->msi == ON_OFF_AUTO_ON) { 137 /* Can't satisfy user's explicit msi=on request, fail */ 138 error_append_hint(&err, "You have to use msi=auto (default) or " 139 "msi=off with this machine type.\n"); 140 error_propagate(errp, err); 141 return; 142 } 143 assert(!err || s->msi == ON_OFF_AUTO_AUTO); 144 /* With msi=auto, we fall back to MSI off silently */ 145 error_free(err); 146 } 147 pci_register_bar(dev, 0, 148 PCI_BASE_ADDRESS_SPACE_MEMORY | 149 PCI_BASE_ADDRESS_MEM_TYPE_64, 150 &s->xhci.mem); 151 152 if (pci_bus_is_express(pci_get_bus(dev))) { 153 ret = pcie_endpoint_cap_init(dev, 0xa0); 154 assert(ret > 0); 155 } 156 157 if (s->msix != ON_OFF_AUTO_OFF) { 158 /* TODO check for errors, and should fail when msix=on */ 159 msix_init(dev, s->xhci.numintrs, 160 &s->xhci.mem, 0, OFF_MSIX_TABLE, 161 &s->xhci.mem, 0, OFF_MSIX_PBA, 162 0x90, NULL); 163 } 164 s->xhci.as = pci_get_address_space(dev); 165 } 166 167 static void usb_xhci_pci_exit(PCIDevice *dev) 168 { 169 XHCIPciState *s = XHCI_PCI(dev); 170 /* destroy msix memory region */ 171 if (dev->msix_table && dev->msix_pba 172 && dev->msix_entry_used) { 173 msix_uninit(dev, &s->xhci.mem, &s->xhci.mem); 174 } 175 } 176 177 static const VMStateDescription vmstate_xhci_pci = { 178 .name = "xhci", 179 .version_id = 1, 180 .post_load = xhci_pci_vmstate_post_load, 181 .fields = (const VMStateField[]) { 182 VMSTATE_PCI_DEVICE(parent_obj, XHCIPciState), 183 VMSTATE_MSIX(parent_obj, XHCIPciState), 184 VMSTATE_STRUCT(xhci, XHCIPciState, 1, vmstate_xhci, XHCIState), 185 VMSTATE_END_OF_LIST() 186 } 187 }; 188 189 static void xhci_instance_init(Object *obj) 190 { 191 XHCIPciState *s = XHCI_PCI(obj); 192 /* 193 * QEMU_PCI_CAP_EXPRESS initialization does not depend on QEMU command 194 * line, therefore, no need to wait to realize like other devices 195 */ 196 PCI_DEVICE(obj)->cap_present |= QEMU_PCI_CAP_EXPRESS; 197 object_initialize_child(obj, "xhci-core", &s->xhci, TYPE_XHCI); 198 qdev_alias_all_properties(DEVICE(&s->xhci), obj); 199 } 200 201 static const Property xhci_pci_properties[] = { 202 DEFINE_PROP_ON_OFF_AUTO("msi", XHCIPciState, msi, ON_OFF_AUTO_AUTO), 203 DEFINE_PROP_ON_OFF_AUTO("msix", XHCIPciState, msix, ON_OFF_AUTO_AUTO), 204 }; 205 206 static void xhci_class_init(ObjectClass *klass, void *data) 207 { 208 PCIDeviceClass *k = PCI_DEVICE_CLASS(klass); 209 DeviceClass *dc = DEVICE_CLASS(klass); 210 211 device_class_set_legacy_reset(dc, xhci_pci_reset); 212 dc->vmsd = &vmstate_xhci_pci; 213 set_bit(DEVICE_CATEGORY_USB, dc->categories); 214 k->realize = usb_xhci_pci_realize; 215 k->exit = usb_xhci_pci_exit; 216 k->class_id = PCI_CLASS_SERIAL_USB; 217 device_class_set_props(dc, xhci_pci_properties); 218 } 219 220 static const TypeInfo xhci_pci_info = { 221 .name = TYPE_XHCI_PCI, 222 .parent = TYPE_PCI_DEVICE, 223 .instance_size = sizeof(XHCIPciState), 224 .class_init = xhci_class_init, 225 .instance_init = xhci_instance_init, 226 .abstract = true, 227 .interfaces = (InterfaceInfo[]) { 228 { INTERFACE_PCIE_DEVICE }, 229 { INTERFACE_CONVENTIONAL_PCI_DEVICE }, 230 { } 231 }, 232 }; 233 234 static void qemu_xhci_class_init(ObjectClass *klass, void *data) 235 { 236 PCIDeviceClass *k = PCI_DEVICE_CLASS(klass); 237 238 k->vendor_id = PCI_VENDOR_ID_REDHAT; 239 k->device_id = PCI_DEVICE_ID_REDHAT_XHCI; 240 k->revision = 0x01; 241 } 242 243 static void qemu_xhci_instance_init(Object *obj) 244 { 245 XHCIPciState *s = XHCI_PCI(obj); 246 XHCIState *xhci = &s->xhci; 247 248 s->msi = ON_OFF_AUTO_OFF; 249 s->msix = ON_OFF_AUTO_AUTO; 250 xhci->numintrs = XHCI_MAXINTRS; 251 xhci->numslots = XHCI_MAXSLOTS; 252 } 253 254 static const TypeInfo qemu_xhci_info = { 255 .name = TYPE_QEMU_XHCI, 256 .parent = TYPE_XHCI_PCI, 257 .class_init = qemu_xhci_class_init, 258 .instance_init = qemu_xhci_instance_init, 259 }; 260 261 static void xhci_register_types(void) 262 { 263 type_register_static(&xhci_pci_info); 264 type_register_static(&qemu_xhci_info); 265 } 266 267 type_init(xhci_register_types) 268