ld_sdmmc.c revision 1.36 1 /* $NetBSD: ld_sdmmc.c,v 1.36 2019/03/19 07:08:43 mlelstv Exp $ */
2
3 /*
4 * Copyright (c) 2008 KIYOHARA Takashi
5 * All rights reserved.
6 *
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
9 * are met:
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
20 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
22 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
24 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
25 * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26 * POSSIBILITY OF SUCH DAMAGE.
27 *
28 */
29
30 #include <sys/cdefs.h>
31 __KERNEL_RCSID(0, "$NetBSD: ld_sdmmc.c,v 1.36 2019/03/19 07:08:43 mlelstv Exp $");
32
33 #ifdef _KERNEL_OPT
34 #include "opt_sdmmc.h"
35 #endif
36
37 #include <sys/param.h>
38 #include <sys/systm.h>
39 #include <sys/kernel.h>
40 #include <sys/device.h>
41 #include <sys/buf.h>
42 #include <sys/bufq.h>
43 #include <sys/bus.h>
44 #include <sys/endian.h>
45 #include <sys/dkio.h>
46 #include <sys/disk.h>
47 #include <sys/disklabel.h>
48 #include <sys/kthread.h>
49 #include <sys/syslog.h>
50 #include <sys/module.h>
51 #include <sys/pcq.h>
52
53 #include <dev/ldvar.h>
54
55 #include <dev/sdmmc/sdmmcvar.h>
56
57 #include "ioconf.h"
58
59 #ifdef LD_SDMMC_DEBUG
60 #define DPRINTF(s) printf s
61 #else
62 #define DPRINTF(s) /**/
63 #endif
64
65 #define LD_SDMMC_IORETRIES 5 /* number of retries before giving up */
66 #define RECOVERYTIME hz/2 /* time to wait before retrying a cmd */
67
68 #define LD_SDMMC_MAXQUEUECNT 4 /* number of queued bio requests */
69 #define LD_SDMMC_MAXTASKCNT 8 /* number of tasks in task pool */
70
71 struct ld_sdmmc_softc;
72
73 struct ld_sdmmc_task {
74 struct sdmmc_task task;
75
76 struct ld_sdmmc_softc *task_sc;
77
78 struct buf *task_bp;
79 int task_retries; /* number of xfer retry */
80 struct callout task_restart_ch;
81
82 kmutex_t task_lock;
83 kcondvar_t task_cv;
84
85 uintptr_t task_data;
86 };
87
88 struct ld_sdmmc_softc {
89 struct ld_softc sc_ld;
90 int sc_hwunit;
91
92 struct sdmmc_function *sc_sf;
93 struct ld_sdmmc_task sc_task[LD_SDMMC_MAXTASKCNT];
94 pcq_t *sc_freeq;
95 char *sc_typename;
96
97 struct evcnt sc_ev_discard; /* discard counter */
98 struct evcnt sc_ev_discarderr; /* discard error counter */
99 struct evcnt sc_ev_discardbusy; /* discard busy counter */
100 struct evcnt sc_ev_cachesyncbusy; /* cache sync busy counter */
101 };
102
103 static int ld_sdmmc_match(device_t, cfdata_t, void *);
104 static void ld_sdmmc_attach(device_t, device_t, void *);
105 static int ld_sdmmc_detach(device_t, int);
106
107 static int ld_sdmmc_dump(struct ld_softc *, void *, int, int);
108 static int ld_sdmmc_start(struct ld_softc *, struct buf *);
109 static void ld_sdmmc_restart(void *);
110 static int ld_sdmmc_discard(struct ld_softc *, struct buf *);
111 static int ld_sdmmc_ioctl(struct ld_softc *, u_long, void *, int32_t, bool);
112
113 static void ld_sdmmc_doattach(void *);
114 static void ld_sdmmc_dobio(void *);
115 static void ld_sdmmc_dodiscard(void *);
116
117 CFATTACH_DECL_NEW(ld_sdmmc, sizeof(struct ld_sdmmc_softc),
118 ld_sdmmc_match, ld_sdmmc_attach, ld_sdmmc_detach, NULL);
119
120
121 /* ARGSUSED */
122 static int
123 ld_sdmmc_match(device_t parent, cfdata_t match, void *aux)
124 {
125 struct sdmmc_softc *sdmsc = device_private(parent);
126
127 if (ISSET(sdmsc->sc_flags, SMF_MEM_MODE))
128 return 1;
129 return 0;
130 }
131
132 /* ARGSUSED */
133 static void
134 ld_sdmmc_attach(device_t parent, device_t self, void *aux)
135 {
136 struct ld_sdmmc_softc *sc = device_private(self);
137 struct sdmmc_attach_args *sa = aux;
138 struct ld_softc *ld = &sc->sc_ld;
139 struct ld_sdmmc_task *task;
140 struct lwp *lwp;
141 int i;
142
143 ld->sc_dv = self;
144
145 aprint_normal(": <0x%02x:0x%04x:%s:0x%02x:0x%08x:0x%03x>\n",
146 sa->sf->cid.mid, sa->sf->cid.oid, sa->sf->cid.pnm,
147 sa->sf->cid.rev, sa->sf->cid.psn, sa->sf->cid.mdt);
148 aprint_naive("\n");
149
150 sc->sc_typename = kmem_asprintf("0x%02x:0x%04x:%s",
151 sa->sf->cid.mid, sa->sf->cid.oid, sa->sf->cid.pnm);
152
153 evcnt_attach_dynamic(&sc->sc_ev_discard, EVCNT_TYPE_MISC,
154 NULL, device_xname(self), "sdmmc discard count");
155 evcnt_attach_dynamic(&sc->sc_ev_discarderr, EVCNT_TYPE_MISC,
156 NULL, device_xname(self), "sdmmc discard errors");
157 evcnt_attach_dynamic(&sc->sc_ev_discardbusy, EVCNT_TYPE_MISC,
158 NULL, device_xname(self), "sdmmc discard busy");
159
160 const int ntask = __arraycount(sc->sc_task);
161 sc->sc_freeq = pcq_create(ntask, KM_SLEEP);
162 for (i = 0; i < ntask; i++) {
163 task = &sc->sc_task[i];
164 task->task_sc = sc;
165 callout_init(&task->task_restart_ch, CALLOUT_MPSAFE);
166 mutex_init(&task->task_lock, MUTEX_DEFAULT, IPL_NONE);
167 cv_init(&task->task_cv, "ldsdmmctask");
168 pcq_put(sc->sc_freeq, task);
169 }
170
171 sc->sc_hwunit = 0; /* always 0? */
172 sc->sc_sf = sa->sf;
173
174 ld->sc_flags = LDF_ENABLED | LDF_MPSAFE;
175 ld->sc_secperunit = sc->sc_sf->csd.capacity;
176 ld->sc_secsize = SDMMC_SECTOR_SIZE;
177 ld->sc_maxxfer = MAXPHYS;
178 ld->sc_maxqueuecnt = LD_SDMMC_MAXQUEUECNT;
179 ld->sc_dump = ld_sdmmc_dump;
180 ld->sc_start = ld_sdmmc_start;
181 ld->sc_discard = ld_sdmmc_discard;
182 ld->sc_ioctl = ld_sdmmc_ioctl;
183 ld->sc_typename = sc->sc_typename;
184
185 /*
186 * Defer attachment of ld + disk subsystem to a thread.
187 *
188 * This is necessary because wedge autodiscover needs to
189 * open and call into the ld driver, which could deadlock
190 * when the sdmmc driver isn't ready in early bootstrap.
191 *
192 * Don't mark thread as MPSAFE to keep aprint output sane.
193 */
194 config_pending_incr(self);
195 if (kthread_create(PRI_NONE, 0, NULL,
196 ld_sdmmc_doattach, sc, &lwp, "%sattach", device_xname(self))) {
197 aprint_error_dev(self, "couldn't create thread\n");
198 }
199 }
200
201 static void
202 ld_sdmmc_doattach(void *arg)
203 {
204 struct ld_sdmmc_softc *sc = (struct ld_sdmmc_softc *)arg;
205 struct ld_softc *ld = &sc->sc_ld;
206 struct sdmmc_softc *ssc = device_private(device_parent(ld->sc_dv));
207 const u_int cache_size = sc->sc_sf->ext_csd.cache_size;
208 char buf[sizeof("9999 KB")];
209
210 ldattach(ld, BUFQ_DISK_DEFAULT_STRAT);
211 aprint_normal_dev(ld->sc_dv, "%d-bit width,", sc->sc_sf->width);
212 if (ssc->sc_transfer_mode != NULL)
213 aprint_normal(" %s,", ssc->sc_transfer_mode);
214 if (cache_size > 0) {
215 format_bytes(buf, sizeof(buf), cache_size);
216 aprint_normal(" %s cache%s,", buf,
217 ISSET(sc->sc_sf->flags, SFF_CACHE_ENABLED) ? "" :
218 " (disabled)");
219 }
220 if ((ssc->sc_busclk / 1000) != 0)
221 aprint_normal(" %u.%03u MHz\n",
222 ssc->sc_busclk / 1000, ssc->sc_busclk % 1000);
223 else
224 aprint_normal(" %u KHz\n", ssc->sc_busclk % 1000);
225 config_pending_decr(ld->sc_dv);
226 kthread_exit(0);
227 }
228
229 static int
230 ld_sdmmc_detach(device_t dev, int flags)
231 {
232 struct ld_sdmmc_softc *sc = device_private(dev);
233 struct ld_softc *ld = &sc->sc_ld;
234 int rv, i;
235
236 if ((rv = ldbegindetach(ld, flags)) != 0)
237 return rv;
238 ldenddetach(ld);
239
240 for (i = 0; i < __arraycount(sc->sc_task); i++) {
241 callout_destroy(&sc->sc_task[i].task_restart_ch);
242 mutex_destroy(&sc->sc_task[i].task_lock);
243 cv_destroy(&sc->sc_task[i].task_cv);
244 }
245
246 pcq_destroy(sc->sc_freeq);
247 evcnt_detach(&sc->sc_ev_discard);
248 evcnt_detach(&sc->sc_ev_discarderr);
249 evcnt_detach(&sc->sc_ev_discardbusy);
250 kmem_free(sc->sc_typename, strlen(sc->sc_typename) + 1);
251
252 return 0;
253 }
254
255 static int
256 ld_sdmmc_start(struct ld_softc *ld, struct buf *bp)
257 {
258 struct ld_sdmmc_softc *sc = device_private(ld->sc_dv);
259 struct ld_sdmmc_task *task = pcq_get(sc->sc_freeq);
260
261 if (task == NULL)
262 return EAGAIN;
263
264 task->task_bp = bp;
265 task->task_retries = 0;
266 sdmmc_init_task(&task->task, ld_sdmmc_dobio, task);
267
268 sdmmc_add_task(sc->sc_sf->sc, &task->task);
269
270 return 0;
271 }
272
273 static void
274 ld_sdmmc_restart(void *arg)
275 {
276 struct ld_sdmmc_task *task = (struct ld_sdmmc_task *)arg;
277 struct ld_sdmmc_softc *sc = task->task_sc;
278 struct buf *bp = task->task_bp;
279
280 bp->b_resid = bp->b_bcount;
281
282 sdmmc_add_task(sc->sc_sf->sc, &task->task);
283 }
284
285 static void
286 ld_sdmmc_dobio(void *arg)
287 {
288 struct ld_sdmmc_task *task = (struct ld_sdmmc_task *)arg;
289 struct ld_sdmmc_softc *sc = task->task_sc;
290 struct buf *bp = task->task_bp;
291 int error;
292
293 /*
294 * I/O operation
295 */
296 DPRINTF(("%s: I/O operation (dir=%s, blkno=0x%jx, bcnt=0x%x)\n",
297 device_xname(sc->sc_ld.sc_dv), bp->b_flags & B_READ ? "IN" : "OUT",
298 bp->b_rawblkno, bp->b_bcount));
299
300 /* is everything done in terms of blocks? */
301 if (bp->b_rawblkno >= sc->sc_sf->csd.capacity) {
302 /* trying to read or write past end of device */
303 aprint_error_dev(sc->sc_ld.sc_dv,
304 "blkno 0x%" PRIu64 " exceeds capacity %d\n",
305 bp->b_rawblkno, sc->sc_sf->csd.capacity);
306 bp->b_error = EINVAL;
307 bp->b_resid = bp->b_bcount;
308
309 goto done;
310 }
311
312 if (bp->b_flags & B_READ)
313 error = sdmmc_mem_read_block(sc->sc_sf, bp->b_rawblkno,
314 bp->b_data, bp->b_bcount);
315 else
316 error = sdmmc_mem_write_block(sc->sc_sf, bp->b_rawblkno,
317 bp->b_data, bp->b_bcount);
318 if (error) {
319 if (task->task_retries < LD_SDMMC_IORETRIES) {
320 struct dk_softc *dksc = &sc->sc_ld.sc_dksc;
321 struct cfdriver *cd = device_cfdriver(dksc->sc_dev);
322
323 diskerr(bp, cd->cd_name, "error", LOG_PRINTF, 0,
324 dksc->sc_dkdev.dk_label);
325 printf(", retrying\n");
326 task->task_retries++;
327 callout_reset(&task->task_restart_ch, RECOVERYTIME,
328 ld_sdmmc_restart, task);
329 return;
330 }
331 bp->b_error = error;
332 bp->b_resid = bp->b_bcount;
333 } else {
334 bp->b_resid = 0;
335 }
336
337 done:
338 pcq_put(sc->sc_freeq, task);
339
340 lddone(&sc->sc_ld, bp);
341 }
342
343 static int
344 ld_sdmmc_dump(struct ld_softc *ld, void *data, int blkno, int blkcnt)
345 {
346 struct ld_sdmmc_softc *sc = device_private(ld->sc_dv);
347
348 return sdmmc_mem_write_block(sc->sc_sf, blkno, data,
349 blkcnt * ld->sc_secsize);
350 }
351
352 static void
353 ld_sdmmc_dodiscard(void *arg)
354 {
355 struct ld_sdmmc_task *task = arg;
356 struct ld_sdmmc_softc *sc = task->task_sc;
357 struct buf *bp = task->task_bp;
358 uint32_t sblkno, nblks;
359 int error;
360
361 /* first and last block to erase */
362 sblkno = bp->b_rawblkno;
363 nblks = howmany(bp->b_bcount, sc->sc_ld.sc_secsize);
364
365 /* An error from discard is non-fatal */
366 error = sdmmc_mem_discard(sc->sc_sf, sblkno, sblkno + nblks - 1);
367 if (error != 0)
368 sc->sc_ev_discarderr.ev_count++;
369 else
370 sc->sc_ev_discard.ev_count++;
371 pcq_put(sc->sc_freeq, task);
372
373 if (error)
374 bp->b_error = error;
375
376 lddiscardend(&sc->sc_ld, bp);
377 }
378
379 static int
380 ld_sdmmc_discard(struct ld_softc *ld, struct buf *bp)
381 {
382 struct ld_sdmmc_softc *sc = device_private(ld->sc_dv);
383 struct ld_sdmmc_task *task = pcq_get(sc->sc_freeq);
384
385 if (task == NULL) {
386 sc->sc_ev_discardbusy.ev_count++;
387 return 0;
388 }
389
390 task->task_bp = bp;
391
392 sdmmc_init_task(&task->task, ld_sdmmc_dodiscard, task);
393
394 sdmmc_add_task(sc->sc_sf->sc, &task->task);
395
396 return 0;
397 }
398
399 static void
400 ld_sdmmc_docachesync(void *arg)
401 {
402 struct ld_sdmmc_task *task = arg;
403 struct ld_sdmmc_softc *sc = task->task_sc;
404 const bool poll = (bool)task->task_data;
405
406 task->task_data = sdmmc_mem_flush_cache(sc->sc_sf, poll);
407
408 mutex_enter(&task->task_lock);
409 cv_signal(&task->task_cv);
410 mutex_exit(&task->task_lock);
411 }
412
413 static int
414 ld_sdmmc_cachesync(struct ld_softc *ld, bool poll)
415 {
416 struct ld_sdmmc_softc *sc = device_private(ld->sc_dv);
417 struct ld_sdmmc_task *task = pcq_get(sc->sc_freeq);
418 int error = 0;
419
420 if (task == NULL) {
421 sc->sc_ev_cachesyncbusy.ev_count++;
422 return EBUSY;
423 }
424
425 sdmmc_init_task(&task->task, ld_sdmmc_docachesync, task);
426 task->task_data = poll;
427
428 mutex_enter(&task->task_lock);
429 sdmmc_add_task(sc->sc_sf->sc, &task->task);
430 error = cv_wait_sig(&task->task_cv, &task->task_lock);
431 mutex_exit(&task->task_lock);
432
433 if (error == 0)
434 error = (int)task->task_data;
435
436 pcq_put(sc->sc_freeq, task);
437
438 return error;
439 }
440
441 static int
442 ld_sdmmc_ioctl(struct ld_softc *ld, u_long cmd, void *addr, int32_t flag,
443 bool poll)
444 {
445
446 switch (cmd) {
447 case DIOCCACHESYNC:
448 return ld_sdmmc_cachesync(ld, poll);
449 default:
450 return EPASSTHROUGH;
451 }
452 }
453
454 MODULE(MODULE_CLASS_DRIVER, ld_sdmmc, "ld");
455
456 #ifdef _MODULE
457 /*
458 * XXX Don't allow ioconf.c to redefine the "struct cfdriver ld_cd"
459 * XXX it will be defined in the common-code module
460 */
461 #undef CFDRIVER_DECL
462 #define CFDRIVER_DECL(name, class, attr)
463 #include "ioconf.c"
464 #endif
465
466 static int
467 ld_sdmmc_modcmd(modcmd_t cmd, void *opaque)
468 {
469 #ifdef _MODULE
470 /*
471 * We ignore the cfdriver_vec[] that ioconf provides, since
472 * the cfdrivers are attached already.
473 */
474 static struct cfdriver * const no_cfdriver_vec[] = { NULL };
475 #endif
476 int error = 0;
477
478 #ifdef _MODULE
479 switch (cmd) {
480 case MODULE_CMD_INIT:
481 error = config_init_component(no_cfdriver_vec,
482 cfattach_ioconf_ld_sdmmc, cfdata_ioconf_ld_sdmmc);
483 break;
484 case MODULE_CMD_FINI:
485 error = config_fini_component(no_cfdriver_vec,
486 cfattach_ioconf_ld_sdmmc, cfdata_ioconf_ld_sdmmc);
487 break;
488 default:
489 error = ENOTTY;
490 break;
491 }
492 #endif
493
494 return error;
495 }
496