xref: /freebsd/sys/dev/sdhci/sdhci_acpi.c (revision 5956d97f4b3204318ceb6aa9c77bd0bc6ea87a41)
1 /*-
2  * Copyright (c) 2017 Oleksandr Tymoshenko <gonzo@FreeBSD.org>
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
24  */
25 
26 #include <sys/cdefs.h>
27 __FBSDID("$FreeBSD$");
28 
29 #include <sys/param.h>
30 #include <sys/systm.h>
31 #include <sys/bus.h>
32 #include <sys/kernel.h>
33 #include <sys/lock.h>
34 #include <sys/module.h>
35 #include <sys/mutex.h>
36 #include <sys/resource.h>
37 #include <sys/rman.h>
38 #include <sys/sysctl.h>
39 #include <sys/taskqueue.h>
40 
41 #include <machine/bus.h>
42 #include <machine/resource.h>
43 
44 #include <contrib/dev/acpica/include/acpi.h>
45 #include <dev/acpica/acpivar.h>
46 
47 #include <dev/mmc/bridge.h>
48 #include <dev/mmc/mmcreg.h>
49 
50 #include <dev/sdhci/sdhci.h>
51 
52 #include "mmcbr_if.h"
53 #include "sdhci_if.h"
54 
55 #define	SDHCI_AMD_RESET_DLL_REG	0x908
56 
57 static const struct sdhci_acpi_device {
58 	const char*	hid;
59 	int		uid;
60 	const char	*desc;
61 	u_int		quirks;
62 } sdhci_acpi_devices[] = {
63 	{ "80860F14",	1, "Intel Bay Trail/Braswell eMMC 4.5/4.5.1 Controller",
64 	    SDHCI_QUIRK_INTEL_POWER_UP_RESET |
65 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
66 	    SDHCI_QUIRK_CAPS_BIT63_FOR_MMC_HS400 |
67 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
68 	{ "80860F14",	3, "Intel Bay Trail/Braswell SDXC Controller",
69 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
70 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
71 	{ "80860F16",	0, "Intel Bay Trail/Braswell SDXC Controller",
72 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
73 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
74 	{ "80865ACA",	0, "Intel Apollo Lake SDXC Controller",
75 	    SDHCI_QUIRK_BROKEN_DMA |	/* APL18 erratum */
76 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
77 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
78 	{ "80865ACC",	0, "Intel Apollo Lake eMMC 5.0 Controller",
79 	    SDHCI_QUIRK_BROKEN_DMA |	/* APL18 erratum */
80 	    SDHCI_QUIRK_INTEL_POWER_UP_RESET |
81 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
82 	    SDHCI_QUIRK_MMC_DDR52 |
83 	    SDHCI_QUIRK_CAPS_BIT63_FOR_MMC_HS400 |
84 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
85 	{ "AMDI0040",	0, "AMD eMMC 5.0 Controller",
86 	    SDHCI_QUIRK_32BIT_DMA_SIZE |
87 	    SDHCI_QUIRK_MMC_HS400_IF_CAN_SDR104 },
88 	{ NULL, 0, NULL, 0}
89 };
90 
91 static char *sdhci_ids[] = {
92 	"80860F14",
93 	"80860F16",
94 	"80865ACA",
95 	"80865ACC",
96 	"AMDI0040",
97 	NULL
98 };
99 
100 struct sdhci_acpi_softc {
101 	struct sdhci_slot slot;
102 	struct resource	*mem_res;	/* Memory resource */
103 	struct resource *irq_res;	/* IRQ resource */
104 	void		*intrhand;	/* Interrupt handle */
105 	const struct sdhci_acpi_device *acpi_dev;
106 };
107 
108 static void sdhci_acpi_intr(void *arg);
109 static int sdhci_acpi_detach(device_t dev);
110 
111 static uint8_t
112 sdhci_acpi_read_1(device_t dev, struct sdhci_slot *slot __unused,
113     bus_size_t off)
114 {
115 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
116 
117 	bus_barrier(sc->mem_res, 0, 0xFF,
118 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
119 	return bus_read_1(sc->mem_res, off);
120 }
121 
122 static void
123 sdhci_acpi_write_1(device_t dev, struct sdhci_slot *slot __unused,
124     bus_size_t off, uint8_t val)
125 {
126 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
127 
128 	bus_barrier(sc->mem_res, 0, 0xFF,
129 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
130 	bus_write_1(sc->mem_res, off, val);
131 }
132 
133 static uint16_t
134 sdhci_acpi_read_2(device_t dev, struct sdhci_slot *slot __unused,
135     bus_size_t off)
136 {
137 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
138 
139 	bus_barrier(sc->mem_res, 0, 0xFF,
140 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
141 	return bus_read_2(sc->mem_res, off);
142 }
143 
144 static void
145 sdhci_acpi_write_2(device_t dev, struct sdhci_slot *slot __unused,
146     bus_size_t off, uint16_t val)
147 {
148 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
149 
150 	bus_barrier(sc->mem_res, 0, 0xFF,
151 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
152 	bus_write_2(sc->mem_res, off, val);
153 }
154 
155 static uint32_t
156 sdhci_acpi_read_4(device_t dev, struct sdhci_slot *slot __unused,
157     bus_size_t off)
158 {
159 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
160 
161 	bus_barrier(sc->mem_res, 0, 0xFF,
162 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
163 	return bus_read_4(sc->mem_res, off);
164 }
165 
166 static void
167 sdhci_acpi_write_4(device_t dev, struct sdhci_slot *slot __unused,
168     bus_size_t off, uint32_t val)
169 {
170 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
171 
172 	bus_barrier(sc->mem_res, 0, 0xFF,
173 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
174 	bus_write_4(sc->mem_res, off, val);
175 }
176 
177 static void
178 sdhci_acpi_read_multi_4(device_t dev, struct sdhci_slot *slot __unused,
179     bus_size_t off, uint32_t *data, bus_size_t count)
180 {
181 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
182 
183 	bus_read_multi_stream_4(sc->mem_res, off, data, count);
184 }
185 
186 static void
187 sdhci_acpi_write_multi_4(device_t dev, struct sdhci_slot *slot __unused,
188     bus_size_t off, uint32_t *data, bus_size_t count)
189 {
190 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
191 
192 	bus_write_multi_stream_4(sc->mem_res, off, data, count);
193 }
194 
195 static void
196 sdhci_acpi_set_uhs_timing(device_t dev, struct sdhci_slot *slot)
197 {
198 	const struct sdhci_acpi_softc *sc;
199 	const struct sdhci_acpi_device *acpi_dev;
200 	const struct mmc_ios *ios;
201 	device_t bus;
202 	uint16_t old_timing;
203 	enum mmc_bus_timing timing;
204 
205 	bus = slot->bus;
206 	old_timing = SDHCI_READ_2(bus, slot, SDHCI_HOST_CONTROL2);
207 	old_timing &= SDHCI_CTRL2_UHS_MASK;
208 	sdhci_generic_set_uhs_timing(dev, slot);
209 
210 	sc = device_get_softc(dev);
211 	acpi_dev = sc->acpi_dev;
212 	/*
213 	 * AMDI0040 controllers require SDHCI_CTRL2_SAMPLING_CLOCK to be
214 	 * disabled when switching from HS200 to high speed and to always
215 	 * be turned on again when tuning for HS400.  In the later case,
216 	 * an AMD-specific DLL reset additionally is needed.
217 	 */
218 	if (strcmp(acpi_dev->hid, "AMDI0040") == 0 && acpi_dev->uid == 0) {
219 		ios = &slot->host.ios;
220 		timing = ios->timing;
221 		if (old_timing == SDHCI_CTRL2_UHS_SDR104 &&
222 		    timing == bus_timing_hs)
223 			SDHCI_WRITE_2(bus, slot, SDHCI_HOST_CONTROL2,
224 			    SDHCI_READ_2(bus, slot, SDHCI_HOST_CONTROL2) &
225 			    ~SDHCI_CTRL2_SAMPLING_CLOCK);
226 		if (ios->clock > SD_SDR50_MAX &&
227 		    old_timing != SDHCI_CTRL2_MMC_HS400 &&
228 		    timing == bus_timing_mmc_hs400) {
229 			SDHCI_WRITE_2(bus, slot, SDHCI_HOST_CONTROL2,
230 			    SDHCI_READ_2(bus, slot, SDHCI_HOST_CONTROL2) |
231 			    SDHCI_CTRL2_SAMPLING_CLOCK);
232 			SDHCI_WRITE_4(bus, slot, SDHCI_AMD_RESET_DLL_REG,
233 			    0x40003210);
234 			DELAY(20);
235 			SDHCI_WRITE_4(bus, slot, SDHCI_AMD_RESET_DLL_REG,
236 			    0x40033210);
237 		}
238 	}
239 }
240 
241 static const struct sdhci_acpi_device *
242 sdhci_acpi_find_device(device_t dev)
243 {
244 	char *hid;
245 	int i, uid;
246 	ACPI_HANDLE handle;
247 	ACPI_STATUS status;
248 	int rv;
249 
250 	rv = ACPI_ID_PROBE(device_get_parent(dev), dev, sdhci_ids, &hid);
251 	if (rv > 0)
252 		return (NULL);
253 
254 	handle = acpi_get_handle(dev);
255 	status = acpi_GetInteger(handle, "_UID", &uid);
256 	if (ACPI_FAILURE(status))
257 		uid = 0;
258 
259 	for (i = 0; sdhci_acpi_devices[i].hid != NULL; i++) {
260 		if (strcmp(sdhci_acpi_devices[i].hid, hid) != 0)
261 			continue;
262 		if ((sdhci_acpi_devices[i].uid != 0) &&
263 		    (sdhci_acpi_devices[i].uid != uid))
264 			continue;
265 		return (&sdhci_acpi_devices[i]);
266 	}
267 
268 	return (NULL);
269 }
270 
271 static int
272 sdhci_acpi_probe(device_t dev)
273 {
274 	const struct sdhci_acpi_device *acpi_dev;
275 
276 	acpi_dev = sdhci_acpi_find_device(dev);
277 	if (acpi_dev == NULL)
278 		return (ENXIO);
279 
280 	device_set_desc(dev, acpi_dev->desc);
281 
282 	return (BUS_PROBE_DEFAULT);
283 }
284 
285 static int
286 sdhci_acpi_attach(device_t dev)
287 {
288 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
289 	int rid, err;
290 	u_int quirks;
291 	const struct sdhci_acpi_device *acpi_dev;
292 
293 	acpi_dev = sdhci_acpi_find_device(dev);
294 	if (acpi_dev == NULL)
295 		return (ENXIO);
296 
297 	sc->acpi_dev = acpi_dev;
298 	quirks = acpi_dev->quirks;
299 
300 	/* Allocate IRQ. */
301 	rid = 0;
302 	sc->irq_res = bus_alloc_resource_any(dev, SYS_RES_IRQ, &rid,
303 		RF_ACTIVE);
304 	if (sc->irq_res == NULL) {
305 		device_printf(dev, "can't allocate IRQ\n");
306 		return (ENOMEM);
307 	}
308 
309 	rid = 0;
310 	sc->mem_res = bus_alloc_resource_any(dev, SYS_RES_MEMORY,
311 	    &rid, RF_ACTIVE);
312 	if (sc->mem_res == NULL) {
313 		device_printf(dev, "can't allocate memory resource for slot\n");
314 		sdhci_acpi_detach(dev);
315 		return (ENOMEM);
316 	}
317 
318 	/*
319 	 * Intel Bay Trail and Braswell eMMC controllers share the same IDs,
320 	 * but while with these former DDR52 is affected by the VLI54 erratum,
321 	 * these latter require the timeout clock to be hardcoded to 1 MHz.
322 	 */
323 	if (strcmp(acpi_dev->hid, "80860F14") == 0 && acpi_dev->uid == 1 &&
324 	    SDHCI_READ_4(dev, &sc->slot, SDHCI_CAPABILITIES) == 0x446cc8b2 &&
325 	    SDHCI_READ_4(dev, &sc->slot, SDHCI_CAPABILITIES2) == 0x00000807)
326 		quirks |= SDHCI_QUIRK_MMC_DDR52 | SDHCI_QUIRK_DATA_TIMEOUT_1MHZ;
327 	quirks &= ~sdhci_quirk_clear;
328 	quirks |= sdhci_quirk_set;
329 	sc->slot.quirks = quirks;
330 
331 	err = sdhci_init_slot(dev, &sc->slot, 0);
332 	if (err) {
333 		device_printf(dev, "failed to init slot\n");
334 		sdhci_acpi_detach(dev);
335 		return (err);
336 	}
337 
338 	/* Activate the interrupt */
339 	err = bus_setup_intr(dev, sc->irq_res, INTR_TYPE_MISC | INTR_MPSAFE,
340 	    NULL, sdhci_acpi_intr, sc, &sc->intrhand);
341 	if (err) {
342 		device_printf(dev, "can't setup IRQ\n");
343 		sdhci_acpi_detach(dev);
344 		return (err);
345 	}
346 
347 	/* Process cards detection. */
348 	sdhci_start_slot(&sc->slot);
349 
350 	return (0);
351 }
352 
353 static int
354 sdhci_acpi_detach(device_t dev)
355 {
356 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
357 
358 	if (sc->intrhand)
359 		bus_teardown_intr(dev, sc->irq_res, sc->intrhand);
360 	if (sc->irq_res)
361 		bus_release_resource(dev, SYS_RES_IRQ,
362 		    rman_get_rid(sc->irq_res), sc->irq_res);
363 
364 	if (sc->mem_res) {
365 		sdhci_cleanup_slot(&sc->slot);
366 		bus_release_resource(dev, SYS_RES_MEMORY,
367 		    rman_get_rid(sc->mem_res), sc->mem_res);
368 	}
369 
370 	return (0);
371 }
372 
373 static int
374 sdhci_acpi_shutdown(device_t dev)
375 {
376 
377 	return (0);
378 }
379 
380 static int
381 sdhci_acpi_suspend(device_t dev)
382 {
383 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
384 	int err;
385 
386 	err = bus_generic_suspend(dev);
387 	if (err)
388 		return (err);
389 	sdhci_generic_suspend(&sc->slot);
390 	return (0);
391 }
392 
393 static int
394 sdhci_acpi_resume(device_t dev)
395 {
396 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
397 	int err;
398 
399 	sdhci_generic_resume(&sc->slot);
400 	err = bus_generic_resume(dev);
401 	if (err)
402 		return (err);
403 	return (0);
404 }
405 
406 static void
407 sdhci_acpi_intr(void *arg)
408 {
409 	struct sdhci_acpi_softc *sc = (struct sdhci_acpi_softc *)arg;
410 
411 	sdhci_generic_intr(&sc->slot);
412 }
413 
414 static device_method_t sdhci_methods[] = {
415 	/* device_if */
416 	DEVMETHOD(device_probe, sdhci_acpi_probe),
417 	DEVMETHOD(device_attach, sdhci_acpi_attach),
418 	DEVMETHOD(device_detach, sdhci_acpi_detach),
419 	DEVMETHOD(device_shutdown, sdhci_acpi_shutdown),
420 	DEVMETHOD(device_suspend, sdhci_acpi_suspend),
421 	DEVMETHOD(device_resume, sdhci_acpi_resume),
422 
423 	/* Bus interface */
424 	DEVMETHOD(bus_read_ivar,	sdhci_generic_read_ivar),
425 	DEVMETHOD(bus_write_ivar,	sdhci_generic_write_ivar),
426 
427 	/* mmcbr_if */
428 	DEVMETHOD(mmcbr_update_ios,	sdhci_generic_update_ios),
429 	DEVMETHOD(mmcbr_switch_vccq,	sdhci_generic_switch_vccq),
430 	DEVMETHOD(mmcbr_tune,		sdhci_generic_tune),
431 	DEVMETHOD(mmcbr_retune,		sdhci_generic_retune),
432 	DEVMETHOD(mmcbr_request,	sdhci_generic_request),
433 	DEVMETHOD(mmcbr_get_ro,		sdhci_generic_get_ro),
434 	DEVMETHOD(mmcbr_acquire_host,   sdhci_generic_acquire_host),
435 	DEVMETHOD(mmcbr_release_host,   sdhci_generic_release_host),
436 
437 	/* SDHCI accessors */
438 	DEVMETHOD(sdhci_read_1,		sdhci_acpi_read_1),
439 	DEVMETHOD(sdhci_read_2,		sdhci_acpi_read_2),
440 	DEVMETHOD(sdhci_read_4,		sdhci_acpi_read_4),
441 	DEVMETHOD(sdhci_read_multi_4,	sdhci_acpi_read_multi_4),
442 	DEVMETHOD(sdhci_write_1,	sdhci_acpi_write_1),
443 	DEVMETHOD(sdhci_write_2,	sdhci_acpi_write_2),
444 	DEVMETHOD(sdhci_write_4,	sdhci_acpi_write_4),
445 	DEVMETHOD(sdhci_write_multi_4,	sdhci_acpi_write_multi_4),
446 	DEVMETHOD(sdhci_set_uhs_timing,	sdhci_acpi_set_uhs_timing),
447 
448 	DEVMETHOD_END
449 };
450 
451 static driver_t sdhci_acpi_driver = {
452 	"sdhci_acpi",
453 	sdhci_methods,
454 	sizeof(struct sdhci_acpi_softc),
455 };
456 
457 DRIVER_MODULE(sdhci_acpi, acpi, sdhci_acpi_driver, NULL, NULL);
458 SDHCI_DEPEND(sdhci_acpi);
459 
460 #ifndef MMCCAM
461 MMC_DECLARE_BRIDGE(sdhci_acpi);
462 #endif
463