xref: /netbsd-src/sys/dev/pci/xhci_pci.c (revision 627f7eb200a4419d89b531d55fccd2ee3ffdcde0)
1 /*	$NetBSD: xhci_pci.c,v 1.28 2021/02/07 11:25:56 ryoon Exp $	*/
2 /*	OpenBSD: xhci_pci.c,v 1.4 2014/07/12 17:38:51 yuo Exp	*/
3 
4 /*
5  * Copyright (c) 1998 The NetBSD Foundation, Inc.
6  * All rights reserved.
7  *
8  * This code is derived from software contributed to The NetBSD Foundation
9  * by Lennart Augustsson (lennart@augustsson.net) at
10  * Carlstedt Research & Technology.
11  *
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions
14  * are met:
15  * 1. Redistributions of source code must retain the above copyright
16  *    notice, this list of conditions and the following disclaimer.
17  * 2. Redistributions in binary form must reproduce the above copyright
18  *    notice, this list of conditions and the following disclaimer in the
19  *    documentation and/or other materials provided with the distribution.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #include <sys/cdefs.h>
35 __KERNEL_RCSID(0, "$NetBSD: xhci_pci.c,v 1.28 2021/02/07 11:25:56 ryoon Exp $");
36 
37 #ifdef _KERNEL_OPT
38 #include "opt_xhci_pci.h"
39 #endif
40 
41 #include <sys/param.h>
42 #include <sys/systm.h>
43 #include <sys/kernel.h>
44 #include <sys/device.h>
45 #include <sys/proc.h>
46 #include <sys/queue.h>
47 
48 #include <sys/bus.h>
49 
50 #include <dev/pci/pcivar.h>
51 #include <dev/pci/pcidevs.h>
52 
53 #include <dev/usb/usb.h>
54 #include <dev/usb/usbdi.h>
55 #include <dev/usb/usbdivar.h>
56 #include <dev/usb/usb_mem.h>
57 
58 #include <dev/usb/xhcireg.h>
59 #include <dev/usb/xhcivar.h>
60 
61 struct xhci_pci_softc {
62 	struct xhci_softc	sc_xhci;
63 	pci_chipset_tag_t	sc_pc;
64 	pcitag_t		sc_tag;
65 	void			*sc_ih;
66 	pci_intr_handle_t	*sc_pihp;
67 };
68 
69 static int
70 xhci_pci_match(device_t parent, cfdata_t match, void *aux)
71 {
72 	struct pci_attach_args *pa = (struct pci_attach_args *) aux;
73 
74 	if (PCI_CLASS(pa->pa_class) == PCI_CLASS_SERIALBUS &&
75 	    PCI_SUBCLASS(pa->pa_class) == PCI_SUBCLASS_SERIALBUS_USB &&
76 	    PCI_INTERFACE(pa->pa_class) == PCI_INTERFACE_XHCI)
77 		return 1;
78 
79 	return 0;
80 }
81 
82 static int
83 xhci_pci_port_route(struct xhci_pci_softc *psc)
84 {
85 	struct xhci_softc * const sc = &psc->sc_xhci;
86 
87 	pcireg_t val;
88 
89 	/*
90 	 * Check USB3 Port Routing Mask register that indicates the ports
91 	 * can be changed from OS, and turn on by USB3 Port SS Enable register.
92 	 */
93 	val = pci_conf_read(psc->sc_pc, psc->sc_tag, PCI_XHCI_INTEL_USB3PRM);
94 	aprint_debug_dev(sc->sc_dev,
95 	    "USB3PRM / USB3.0 configurable ports: 0x%08x\n", val);
96 
97 	pci_conf_write(psc->sc_pc, psc->sc_tag, PCI_XHCI_INTEL_USB3_PSSEN, val);
98 	val = pci_conf_read(psc->sc_pc, psc->sc_tag,PCI_XHCI_INTEL_USB3_PSSEN);
99 	aprint_debug_dev(sc->sc_dev,
100 	    "USB3_PSSEN / Enabled USB3.0 ports under xHCI: 0x%08x\n", val);
101 
102 	/*
103 	 * Check USB2 Port Routing Mask register that indicates the USB2.0
104 	 * ports to be controlled by xHCI HC, and switch them to xHCI HC.
105 	 */
106 	val = pci_conf_read(psc->sc_pc, psc->sc_tag, PCI_XHCI_INTEL_USB2PRM);
107 	aprint_debug_dev(sc->sc_dev,
108 	    "XUSB2PRM / USB2.0 ports can switch from EHCI to xHCI:"
109 	    "0x%08x\n", val);
110 	pci_conf_write(psc->sc_pc, psc->sc_tag, PCI_XHCI_INTEL_XUSB2PR, val);
111 	val = pci_conf_read(psc->sc_pc, psc->sc_tag, PCI_XHCI_INTEL_XUSB2PR);
112 	aprint_debug_dev(sc->sc_dev,
113 	    "XUSB2PR / USB2.0 ports under xHCI: 0x%08x\n", val);
114 
115 	return 0;
116 }
117 
118 static void
119 xhci_pci_attach(device_t parent, device_t self, void *aux)
120 {
121 	struct xhci_pci_softc * const psc = device_private(self);
122 	struct xhci_softc * const sc = &psc->sc_xhci;
123 	struct pci_attach_args *const pa = (struct pci_attach_args *)aux;
124 	const pci_chipset_tag_t pc = pa->pa_pc;
125 	const pcitag_t tag = pa->pa_tag;
126 	char const *intrstr;
127 	pcireg_t csr, memtype, usbrev;
128 	uint32_t hccparams;
129 	int counts[PCI_INTR_TYPE_SIZE];
130 	char intrbuf[PCI_INTRSTR_LEN];
131 	bus_addr_t memaddr;
132 	int flags, msixoff;
133 	int err;
134 
135 	sc->sc_dev = self;
136 
137 	pci_aprint_devinfo(pa, "USB Controller");
138 
139 	/* Check for quirks */
140 	sc->sc_quirks = 0;
141 
142 	csr = pci_conf_read(pc, tag, PCI_COMMAND_STATUS_REG);
143 	if ((csr & PCI_COMMAND_MEM_ENABLE) == 0) {
144 		/*
145 		 * Enable address decoding for memory range in case BIOS or
146 		 * UEFI didn't set it.
147 		 */
148 		csr = pci_conf_read(pa->pa_pc, pa->pa_tag,
149 		    PCI_COMMAND_STATUS_REG);
150 		csr |= PCI_COMMAND_MEM_ENABLE;
151 		pci_conf_write(pa->pa_pc, pa->pa_tag, PCI_COMMAND_STATUS_REG,
152 		    csr);
153 	}
154 
155 	/* map MMIO registers */
156 	memtype = pci_mapreg_type(pa->pa_pc, pa->pa_tag, PCI_CBMEM);
157 	if (PCI_MAPREG_TYPE(memtype) != PCI_MAPREG_TYPE_MEM) {
158 		sc->sc_ios = 0;
159 		aprint_error_dev(self, "BAR not 64 or 32-bit MMIO\n");
160 		return;
161 	}
162 
163 	sc->sc_iot = pa->pa_memt;
164 	if (pci_mapreg_info(pa->pa_pc, pa->pa_tag, PCI_CBMEM, memtype,
165 	    &memaddr, &sc->sc_ios, &flags) != 0) {
166 		sc->sc_ios = 0;
167 		aprint_error_dev(self, "can't get map info\n");
168 		return;
169 	}
170 
171 	if (pci_get_capability(pa->pa_pc, pa->pa_tag, PCI_CAP_MSIX, &msixoff,
172 	    NULL)) {
173 		pcireg_t msixtbl;
174 		uint32_t table_offset;
175 		int bir;
176 
177 		msixtbl = pci_conf_read(pa->pa_pc, pa->pa_tag,
178 		    msixoff + PCI_MSIX_TBLOFFSET);
179 		table_offset = msixtbl & PCI_MSIX_TBLOFFSET_MASK;
180 		bir = msixtbl & PCI_MSIX_TBLBIR_MASK;
181 		/* Shrink map area for MSI-X table */
182 		if (bir == PCI_MAPREG_NUM(PCI_CBMEM))
183 			sc->sc_ios = table_offset;
184 	}
185 	if (bus_space_map(sc->sc_iot, memaddr, sc->sc_ios, flags,
186 	    &sc->sc_ioh)) {
187 		sc->sc_ios = 0;
188 		aprint_error_dev(self, "can't map mem space\n");
189 		return;
190 	}
191 
192 	psc->sc_pc = pc;
193 	psc->sc_tag = tag;
194 
195 	hccparams = bus_space_read_4(sc->sc_iot, sc->sc_ioh, XHCI_HCCPARAMS);
196 
197 	if (XHCI_HCC_AC64(hccparams) != 0) {
198 		aprint_verbose_dev(self, "64-bit DMA");
199 		if (pci_dma64_available(pa)) {
200 			sc->sc_bus.ub_dmatag = pa->pa_dmat64;
201 			aprint_verbose("\n");
202 		} else {
203 			aprint_verbose(" - limited\n");
204 			sc->sc_bus.ub_dmatag = pa->pa_dmat;
205 		}
206 	} else {
207 		aprint_verbose_dev(self, "32-bit DMA\n");
208 		sc->sc_bus.ub_dmatag = pa->pa_dmat;
209 	}
210 
211 	/* Enable the device. */
212 	pci_conf_write(pc, tag, PCI_COMMAND_STATUS_REG,
213 		       csr | PCI_COMMAND_MASTER_ENABLE);
214 
215 	for (int i = 0; i < PCI_INTR_TYPE_SIZE; i++) {
216 		counts[i] = 1;
217 	}
218 #ifdef XHCI_DISABLE_MSI
219 	counts[PCI_INTR_TYPE_MSI] = 0;
220 #endif
221 #ifdef XHCI_DISABLE_MSIX
222 	counts[PCI_INTR_TYPE_MSIX] = 0;
223 #endif
224 
225 	/* Allocate and establish the interrupt. */
226 	if (pci_intr_alloc(pa, &psc->sc_pihp, counts, PCI_INTR_TYPE_MSIX)) {
227 		aprint_error_dev(self, "can't allocate handler\n");
228 		goto fail;
229 	}
230 	intrstr = pci_intr_string(pc, psc->sc_pihp[0], intrbuf,
231 	    sizeof(intrbuf));
232 	psc->sc_ih = pci_intr_establish_xname(pc, psc->sc_pihp[0], IPL_USB,
233 	    xhci_intr, sc, device_xname(sc->sc_dev));
234 	if (psc->sc_ih == NULL) {
235 		pci_intr_release(pc, psc->sc_pihp, 1);
236 		psc->sc_pihp = NULL;
237 		aprint_error_dev(self, "couldn't establish interrupt");
238 		if (intrstr != NULL)
239 			aprint_error(" at %s", intrstr);
240 		aprint_error("\n");
241 		goto fail;
242 	}
243 	aprint_normal_dev(self, "interrupting at %s\n", intrstr);
244 
245 	usbrev = pci_conf_read(pc, tag, PCI_USBREV) & PCI_USBREV_MASK;
246 	switch (usbrev) {
247 	case PCI_USBREV_3_0:
248 		sc->sc_bus.ub_revision = USBREV_3_0;
249 		break;
250 	case PCI_USBREV_3_1:
251 		sc->sc_bus.ub_revision = USBREV_3_1;
252 		break;
253 	default:
254 		if (usbrev < PCI_USBREV_3_0) {
255 			aprint_error_dev(self, "Unknown revision (%02x). Set to 3.0.\n",
256 			    usbrev);
257 			sc->sc_bus.ub_revision = USBREV_3_0;
258 		} else {
259 			/* Default to the latest revision */
260 			aprint_normal_dev(self,
261 			    "Unknown revision (%02x). Set to 3.1.\n", usbrev);
262 			sc->sc_bus.ub_revision = USBREV_3_1;
263 		}
264 		break;
265 	}
266 
267 	/* Intel chipset requires SuperSpeed enable and USB2 port routing */
268 	switch (PCI_VENDOR(pa->pa_id)) {
269 	case PCI_VENDOR_INTEL:
270 		sc->sc_quirks |= XHCI_QUIRK_INTEL;
271 		break;
272 	default:
273 		break;
274 	}
275 
276 	err = xhci_init(sc);
277 	if (err) {
278 		aprint_error_dev(self, "init failed, error=%d\n", err);
279 		goto fail;
280 	}
281 
282 	if ((sc->sc_quirks & XHCI_QUIRK_INTEL) != 0)
283 		xhci_pci_port_route(psc);
284 
285 	if (!pmf_device_register1(self, xhci_suspend, xhci_resume,
286 	                          xhci_shutdown))
287 		aprint_error_dev(self, "couldn't establish power handler\n");
288 
289 	/* Attach usb buses. */
290 	sc->sc_child = config_found(self, &sc->sc_bus, usbctlprint);
291 
292  	sc->sc_child2 = config_found(self, &sc->sc_bus2, usbctlprint);
293 
294 	return;
295 
296 fail:
297 	if (psc->sc_ih != NULL) {
298 		pci_intr_disestablish(psc->sc_pc, psc->sc_ih);
299 		psc->sc_ih = NULL;
300 	}
301 	if (psc->sc_pihp != NULL) {
302 		pci_intr_release(psc->sc_pc, psc->sc_pihp, 1);
303 		psc->sc_pihp = NULL;
304 	}
305 	if (sc->sc_ios) {
306 		bus_space_unmap(sc->sc_iot, sc->sc_ioh, sc->sc_ios);
307 		sc->sc_ios = 0;
308 	}
309 	return;
310 }
311 
312 static int
313 xhci_pci_detach(device_t self, int flags)
314 {
315 	struct xhci_pci_softc * const psc = device_private(self);
316 	struct xhci_softc * const sc = &psc->sc_xhci;
317 	int rv;
318 
319 	if (sc->sc_ios != 0) {
320 		rv = xhci_detach(sc, flags);
321 		if (rv)
322 			return rv;
323 
324 		pmf_device_deregister(self);
325 
326 		xhci_shutdown(self, flags);
327 
328 #if 0
329 		/* Disable interrupts, so we don't get any spurious ones. */
330 		bus_space_write_4(sc->sc_iot, sc->sc_ioh,
331 				  OHCI_INTERRUPT_DISABLE, OHCI_ALL_INTRS);
332 #endif
333 	}
334 
335 	if (psc->sc_ih != NULL) {
336 		pci_intr_disestablish(psc->sc_pc, psc->sc_ih);
337 		psc->sc_ih = NULL;
338 	}
339 	if (psc->sc_pihp != NULL) {
340 		pci_intr_release(psc->sc_pc, psc->sc_pihp, 1);
341 		psc->sc_pihp = NULL;
342 	}
343 	if (sc->sc_ios) {
344 		bus_space_unmap(sc->sc_iot, sc->sc_ioh, sc->sc_ios);
345 		sc->sc_ios = 0;
346 	}
347 
348 	return 0;
349 }
350 
351 CFATTACH_DECL3_NEW(xhci_pci, sizeof(struct xhci_pci_softc),
352     xhci_pci_match, xhci_pci_attach, xhci_pci_detach, xhci_activate, NULL,
353     xhci_childdet, DVF_DETACH_SHUTDOWN);
354