xref: /freebsd/sys/dev/sdhci/sdhci_acpi.c (revision fe2494903422ba3b924eba82cb63a6a9188fad7a)
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 
49 #include <dev/sdhci/sdhci.h>
50 
51 #include "mmcbr_if.h"
52 #include "sdhci_if.h"
53 
54 static const struct sdhci_acpi_device {
55 	const char*	hid;
56 	int		uid;
57 	const char	*desc;
58 	u_int		quirks;
59 } sdhci_acpi_devices[] = {
60 	{ "80860F14",	1, "Intel Bay Trail/Braswell eMMC 4.5/4.5.1 Controller",
61 	    SDHCI_QUIRK_INTEL_POWER_UP_RESET |
62 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
63 	    SDHCI_QUIRK_CAPS_BIT63_FOR_MMC_HS400 |
64 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
65 	{ "80860F14",	3, "Intel Bay Trail/Braswell SDXC Controller",
66 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
67 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
68 	{ "80860F16",	0, "Intel Bay Trail/Braswell SDXC Controller",
69 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
70 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
71 	{ "80865ACA",	0, "Intel Apollo Lake SDXC Controller",
72 	    SDHCI_QUIRK_BROKEN_DMA |	/* APL18 erratum */
73 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
74 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
75 	{ "80865ACC",	0, "Intel Apollo Lake eMMC 5.0 Controller",
76 	    SDHCI_QUIRK_BROKEN_DMA |	/* APL18 erratum */
77 	    SDHCI_QUIRK_INTEL_POWER_UP_RESET |
78 	    SDHCI_QUIRK_WAIT_WHILE_BUSY |
79 	    SDHCI_QUIRK_MMC_DDR52 |
80 	    SDHCI_QUIRK_CAPS_BIT63_FOR_MMC_HS400 |
81 	    SDHCI_QUIRK_PRESET_VALUE_BROKEN },
82 	{ "AMDI0040",	0, "AMD eMMC 5.0 Controller",
83 	    SDHCI_QUIRK_32BIT_DMA_SIZE },
84 	{ NULL, 0, NULL, 0}
85 };
86 
87 static char *sdhci_ids[] = {
88 	"80860F14",
89 	"80860F16",
90 	"80865ACA",
91 	"80865ACC",
92 	"AMDI0040",
93 	NULL
94 };
95 
96 struct sdhci_acpi_softc {
97 	u_int		quirks;		/* Chip specific quirks */
98 	struct resource *irq_res;	/* IRQ resource */
99 	void		*intrhand;	/* Interrupt handle */
100 
101 	struct sdhci_slot slot;
102 	struct resource	*mem_res;	/* Memory resource */
103 };
104 
105 static void sdhci_acpi_intr(void *arg);
106 static int sdhci_acpi_detach(device_t dev);
107 
108 static uint8_t
109 sdhci_acpi_read_1(device_t dev, struct sdhci_slot *slot __unused,
110     bus_size_t off)
111 {
112 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
113 
114 	bus_barrier(sc->mem_res, 0, 0xFF,
115 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
116 	return bus_read_1(sc->mem_res, off);
117 }
118 
119 static void
120 sdhci_acpi_write_1(device_t dev, struct sdhci_slot *slot __unused,
121     bus_size_t off, uint8_t val)
122 {
123 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
124 
125 	bus_barrier(sc->mem_res, 0, 0xFF,
126 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
127 	bus_write_1(sc->mem_res, off, val);
128 }
129 
130 static uint16_t
131 sdhci_acpi_read_2(device_t dev, struct sdhci_slot *slot __unused,
132     bus_size_t off)
133 {
134 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
135 
136 	bus_barrier(sc->mem_res, 0, 0xFF,
137 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
138 	return bus_read_2(sc->mem_res, off);
139 }
140 
141 static void
142 sdhci_acpi_write_2(device_t dev, struct sdhci_slot *slot __unused,
143     bus_size_t off, uint16_t val)
144 {
145 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
146 
147 	bus_barrier(sc->mem_res, 0, 0xFF,
148 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
149 	bus_write_2(sc->mem_res, off, val);
150 }
151 
152 static uint32_t
153 sdhci_acpi_read_4(device_t dev, struct sdhci_slot *slot __unused,
154     bus_size_t off)
155 {
156 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
157 
158 	bus_barrier(sc->mem_res, 0, 0xFF,
159 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
160 	return bus_read_4(sc->mem_res, off);
161 }
162 
163 static void
164 sdhci_acpi_write_4(device_t dev, struct sdhci_slot *slot __unused,
165     bus_size_t off, uint32_t val)
166 {
167 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
168 
169 	bus_barrier(sc->mem_res, 0, 0xFF,
170 	    BUS_SPACE_BARRIER_READ | BUS_SPACE_BARRIER_WRITE);
171 	bus_write_4(sc->mem_res, off, val);
172 }
173 
174 static void
175 sdhci_acpi_read_multi_4(device_t dev, struct sdhci_slot *slot __unused,
176     bus_size_t off, uint32_t *data, bus_size_t count)
177 {
178 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
179 
180 	bus_read_multi_stream_4(sc->mem_res, off, data, count);
181 }
182 
183 static void
184 sdhci_acpi_write_multi_4(device_t dev, struct sdhci_slot *slot __unused,
185     bus_size_t off, uint32_t *data, bus_size_t count)
186 {
187 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
188 
189 	bus_write_multi_stream_4(sc->mem_res, off, data, count);
190 }
191 
192 static const struct sdhci_acpi_device *
193 sdhci_acpi_find_device(device_t dev)
194 {
195 	char *hid;
196 	int i, uid;
197 	ACPI_HANDLE handle;
198 	ACPI_STATUS status;
199 	int rv;
200 
201 	rv =  ACPI_ID_PROBE(device_get_parent(dev), dev, sdhci_ids, &hid);
202 	if (rv > 0)
203 		return (NULL);
204 
205 	handle = acpi_get_handle(dev);
206 	status = acpi_GetInteger(handle, "_UID", &uid);
207 	if (ACPI_FAILURE(status))
208 		uid = 0;
209 
210 	for (i = 0; sdhci_acpi_devices[i].hid != NULL; i++) {
211 		if (strcmp(sdhci_acpi_devices[i].hid, hid) != 0)
212 			continue;
213 		if ((sdhci_acpi_devices[i].uid != 0) &&
214 		    (sdhci_acpi_devices[i].uid != uid))
215 			continue;
216 		return (&sdhci_acpi_devices[i]);
217 	}
218 
219 	return (NULL);
220 }
221 
222 static int
223 sdhci_acpi_probe(device_t dev)
224 {
225 	const struct sdhci_acpi_device *acpi_dev;
226 
227 	acpi_dev = sdhci_acpi_find_device(dev);
228 	if (acpi_dev == NULL)
229 		return (ENXIO);
230 
231 	device_set_desc(dev, acpi_dev->desc);
232 
233 	return (BUS_PROBE_DEFAULT);
234 }
235 
236 static int
237 sdhci_acpi_attach(device_t dev)
238 {
239 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
240 	int rid, err;
241 	const struct sdhci_acpi_device *acpi_dev;
242 
243 	acpi_dev = sdhci_acpi_find_device(dev);
244 	if (acpi_dev == NULL)
245 		return (ENXIO);
246 
247 	sc->quirks = acpi_dev->quirks;
248 
249 	/* Allocate IRQ. */
250 	rid = 0;
251 	sc->irq_res = bus_alloc_resource_any(dev, SYS_RES_IRQ, &rid,
252 		RF_ACTIVE);
253 	if (sc->irq_res == NULL) {
254 		device_printf(dev, "can't allocate IRQ\n");
255 		return (ENOMEM);
256 	}
257 
258 	rid = 0;
259 	sc->mem_res = bus_alloc_resource_any(dev, SYS_RES_MEMORY,
260 	    &rid, RF_ACTIVE);
261 	if (sc->mem_res == NULL) {
262 		device_printf(dev, "can't allocate memory resource for slot\n");
263 		sdhci_acpi_detach(dev);
264 		return (ENOMEM);
265 	}
266 
267 	/*
268 	 * Intel Bay Trail and Braswell eMMC controllers share the same IDs,
269 	 * but while with these former DDR52 is affected by the VLI54 erratum,
270 	 * these latter require the timeout clock to be hardcoded to 1 MHz.
271 	 */
272 	if (strcmp(acpi_dev->hid, "80860F14") == 0 && acpi_dev->uid == 1 &&
273 	    SDHCI_READ_4(dev, &sc->slot, SDHCI_CAPABILITIES) == 0x446cc8b2 &&
274 	    SDHCI_READ_4(dev, &sc->slot, SDHCI_CAPABILITIES2) == 0x00000807)
275 		sc->quirks |= SDHCI_QUIRK_MMC_DDR52 |
276 		    SDHCI_QUIRK_DATA_TIMEOUT_1MHZ;
277 	sc->quirks &= ~sdhci_quirk_clear;
278 	sc->quirks |= sdhci_quirk_set;
279 	sc->slot.quirks = sc->quirks;
280 
281 	err = sdhci_init_slot(dev, &sc->slot, 0);
282 	if (err) {
283 		device_printf(dev, "failed to init slot\n");
284 		sdhci_acpi_detach(dev);
285 		return (err);
286 	}
287 
288 	/* Activate the interrupt */
289 	err = bus_setup_intr(dev, sc->irq_res, INTR_TYPE_MISC | INTR_MPSAFE,
290 	    NULL, sdhci_acpi_intr, sc, &sc->intrhand);
291 	if (err) {
292 		device_printf(dev, "can't setup IRQ\n");
293 		sdhci_acpi_detach(dev);
294 		return (err);
295 	}
296 
297 	/* Process cards detection. */
298 	sdhci_start_slot(&sc->slot);
299 
300 	return (0);
301 }
302 
303 static int
304 sdhci_acpi_detach(device_t dev)
305 {
306 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
307 
308 	if (sc->intrhand)
309 		bus_teardown_intr(dev, sc->irq_res, sc->intrhand);
310 	if (sc->irq_res)
311 		bus_release_resource(dev, SYS_RES_IRQ,
312 		    rman_get_rid(sc->irq_res), sc->irq_res);
313 
314 	if (sc->mem_res) {
315 		sdhci_cleanup_slot(&sc->slot);
316 		bus_release_resource(dev, SYS_RES_MEMORY,
317 		    rman_get_rid(sc->mem_res), sc->mem_res);
318 	}
319 
320 	return (0);
321 }
322 
323 static int
324 sdhci_acpi_shutdown(device_t dev)
325 {
326 
327 	return (0);
328 }
329 
330 static int
331 sdhci_acpi_suspend(device_t dev)
332 {
333 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
334 	int err;
335 
336 	err = bus_generic_suspend(dev);
337 	if (err)
338 		return (err);
339 	sdhci_generic_suspend(&sc->slot);
340 	return (0);
341 }
342 
343 static int
344 sdhci_acpi_resume(device_t dev)
345 {
346 	struct sdhci_acpi_softc *sc = device_get_softc(dev);
347 	int err;
348 
349 	sdhci_generic_resume(&sc->slot);
350 	err = bus_generic_resume(dev);
351 	if (err)
352 		return (err);
353 	return (0);
354 }
355 
356 static void
357 sdhci_acpi_intr(void *arg)
358 {
359 	struct sdhci_acpi_softc *sc = (struct sdhci_acpi_softc *)arg;
360 
361 	sdhci_generic_intr(&sc->slot);
362 }
363 
364 static device_method_t sdhci_methods[] = {
365 	/* device_if */
366 	DEVMETHOD(device_probe, sdhci_acpi_probe),
367 	DEVMETHOD(device_attach, sdhci_acpi_attach),
368 	DEVMETHOD(device_detach, sdhci_acpi_detach),
369 	DEVMETHOD(device_shutdown, sdhci_acpi_shutdown),
370 	DEVMETHOD(device_suspend, sdhci_acpi_suspend),
371 	DEVMETHOD(device_resume, sdhci_acpi_resume),
372 
373 	/* Bus interface */
374 	DEVMETHOD(bus_read_ivar,	sdhci_generic_read_ivar),
375 	DEVMETHOD(bus_write_ivar,	sdhci_generic_write_ivar),
376 
377 	/* mmcbr_if */
378 	DEVMETHOD(mmcbr_update_ios,	sdhci_generic_update_ios),
379 	DEVMETHOD(mmcbr_switch_vccq,	sdhci_generic_switch_vccq),
380 	DEVMETHOD(mmcbr_tune,		sdhci_generic_tune),
381 	DEVMETHOD(mmcbr_retune,		sdhci_generic_retune),
382 	DEVMETHOD(mmcbr_request,	sdhci_generic_request),
383 	DEVMETHOD(mmcbr_get_ro,		sdhci_generic_get_ro),
384 	DEVMETHOD(mmcbr_acquire_host,   sdhci_generic_acquire_host),
385 	DEVMETHOD(mmcbr_release_host,   sdhci_generic_release_host),
386 
387 	/* SDHCI accessors */
388 	DEVMETHOD(sdhci_read_1,		sdhci_acpi_read_1),
389 	DEVMETHOD(sdhci_read_2,		sdhci_acpi_read_2),
390 	DEVMETHOD(sdhci_read_4,		sdhci_acpi_read_4),
391 	DEVMETHOD(sdhci_read_multi_4,	sdhci_acpi_read_multi_4),
392 	DEVMETHOD(sdhci_write_1,	sdhci_acpi_write_1),
393 	DEVMETHOD(sdhci_write_2,	sdhci_acpi_write_2),
394 	DEVMETHOD(sdhci_write_4,	sdhci_acpi_write_4),
395 	DEVMETHOD(sdhci_write_multi_4,	sdhci_acpi_write_multi_4),
396 	DEVMETHOD(sdhci_set_uhs_timing,	sdhci_generic_set_uhs_timing),
397 
398 	DEVMETHOD_END
399 };
400 
401 static driver_t sdhci_acpi_driver = {
402 	"sdhci_acpi",
403 	sdhci_methods,
404 	sizeof(struct sdhci_acpi_softc),
405 };
406 static devclass_t sdhci_acpi_devclass;
407 
408 DRIVER_MODULE(sdhci_acpi, acpi, sdhci_acpi_driver, sdhci_acpi_devclass, NULL,
409     NULL);
410 MODULE_DEPEND(sdhci_acpi, sdhci, 1, 1, 1);
411 
412 #ifndef MMCCAM
413 MMC_DECLARE_BRIDGE(sdhci_acpi);
414 #endif
415