]> CyberLeo.Net >> Repos - FreeBSD/FreeBSD.git/blob - sys/dev/mmc/mmcsd.c
Regularize my copyright notice
[FreeBSD/FreeBSD.git] / sys / dev / mmc / mmcsd.c
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 2006 Bernd Walter.  All rights reserved.
5  * Copyright (c) 2006 M. Warner Losh <imp@FreeBSD.org>
6  * Copyright (c) 2017 Marius Strobl <marius@FreeBSD.org>
7  *
8  * Redistribution and use in source and binary forms, with or without
9  * modification, are permitted provided that the following conditions
10  * are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above copyright
14  *    notice, this list of conditions and the following disclaimer in the
15  *    documentation and/or other materials provided with the distribution.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  *
28  * Portions of this software may have been developed with reference to
29  * the SD Simplified Specification.  The following disclaimer may apply:
30  *
31  * The following conditions apply to the release of the simplified
32  * specification ("Simplified Specification") by the SD Card Association and
33  * the SD Group. The Simplified Specification is a subset of the complete SD
34  * Specification which is owned by the SD Card Association and the SD
35  * Group. This Simplified Specification is provided on a non-confidential
36  * basis subject to the disclaimers below. Any implementation of the
37  * Simplified Specification may require a license from the SD Card
38  * Association, SD Group, SD-3C LLC or other third parties.
39  *
40  * Disclaimers:
41  *
42  * The information contained in the Simplified Specification is presented only
43  * as a standard specification for SD Cards and SD Host/Ancillary products and
44  * is provided "AS-IS" without any representations or warranties of any
45  * kind. No responsibility is assumed by the SD Group, SD-3C LLC or the SD
46  * Card Association for any damages, any infringements of patents or other
47  * right of the SD Group, SD-3C LLC, the SD Card Association or any third
48  * parties, which may result from its use. No license is granted by
49  * implication, estoppel or otherwise under any patent or other rights of the
50  * SD Group, SD-3C LLC, the SD Card Association or any third party. Nothing
51  * herein shall be construed as an obligation by the SD Group, the SD-3C LLC
52  * or the SD Card Association to disclose or distribute any technical
53  * information, know-how or other confidential information to any third party.
54  */
55
56 #include <sys/cdefs.h>
57 __FBSDID("$FreeBSD$");
58
59 #include <sys/param.h>
60 #include <sys/systm.h>
61 #include <sys/bio.h>
62 #include <sys/bus.h>
63 #include <sys/conf.h>
64 #include <sys/endian.h>
65 #include <sys/fcntl.h>
66 #include <sys/ioccom.h>
67 #include <sys/kernel.h>
68 #include <sys/kthread.h>
69 #include <sys/lock.h>
70 #include <sys/malloc.h>
71 #include <sys/module.h>
72 #include <sys/mutex.h>
73 #include <sys/priv.h>
74 #include <sys/slicer.h>
75 #include <sys/sysctl.h>
76 #include <sys/time.h>
77
78 #include <geom/geom.h>
79 #include <geom/geom_disk.h>
80
81 #include <dev/mmc/bridge.h>
82 #include <dev/mmc/mmc_ioctl.h>
83 #include <dev/mmc/mmc_subr.h>
84 #include <dev/mmc/mmcbrvar.h>
85 #include <dev/mmc/mmcreg.h>
86 #include <dev/mmc/mmcvar.h>
87
88 #include "mmcbus_if.h"
89
90 #if __FreeBSD_version < 800002
91 #define kproc_create    kthread_create
92 #define kproc_exit      kthread_exit
93 #endif
94
95 #define MMCSD_CMD_RETRIES       5
96
97 #define MMCSD_FMT_BOOT          "mmcsd%dboot"
98 #define MMCSD_FMT_GP            "mmcsd%dgp"
99 #define MMCSD_FMT_RPMB          "mmcsd%drpmb"
100 #define MMCSD_LABEL_ENH         "enh"
101
102 #define MMCSD_PART_NAMELEN      (16 + 1)
103
104 struct mmcsd_softc;
105
106 struct mmcsd_part {
107         struct mtx disk_mtx;
108         struct mtx ioctl_mtx;
109         struct mmcsd_softc *sc;
110         struct disk *disk;
111         struct proc *p;
112         struct bio_queue_head bio_queue;
113         daddr_t eblock, eend;   /* Range remaining after the last erase. */
114         u_int cnt;
115         u_int type;
116         int running;
117         int suspend;
118         int ioctl;
119         bool ro;
120         char name[MMCSD_PART_NAMELEN];
121 };
122
123 struct mmcsd_softc {
124         device_t dev;
125         device_t mmcbus;
126         struct mmcsd_part *part[MMC_PART_MAX];
127         enum mmc_card_mode mode;
128         u_int max_data;         /* Maximum data size [blocks] */
129         u_int erase_sector;     /* Device native erase sector size [blocks] */
130         uint8_t high_cap;       /* High Capacity device (block addressed) */
131         uint8_t part_curr;      /* Partition currently switched to */
132         uint8_t ext_csd[MMC_EXTCSD_SIZE];
133         uint16_t rca;
134         uint32_t flags;
135 #define MMCSD_INAND_CMD38       0x0001
136 #define MMCSD_USE_TRIM          0x0002
137 #define MMCSD_FLUSH_CACHE       0x0004
138 #define MMCSD_DIRTY             0x0008
139         uint32_t cmd6_time;     /* Generic switch timeout [us] */
140         uint32_t part_time;     /* Partition switch timeout [us] */
141         off_t enh_base;         /* Enhanced user data area slice base ... */
142         off_t enh_size;         /* ... and size [bytes] */
143         int log_count;
144         struct timeval log_time;
145         struct cdev *rpmb_dev;
146 };
147
148 static const char *errmsg[] =
149 {
150         "None",
151         "Timeout",
152         "Bad CRC",
153         "Fifo",
154         "Failed",
155         "Invalid",
156         "NO MEMORY"
157 };
158
159 static SYSCTL_NODE(_hw, OID_AUTO, mmcsd, CTLFLAG_RD, NULL, "mmcsd driver");
160
161 static int mmcsd_cache = 1;
162 SYSCTL_INT(_hw_mmcsd, OID_AUTO, cache, CTLFLAG_RDTUN, &mmcsd_cache, 0,
163     "Device R/W cache enabled if present");
164
165 #define LOG_PPS         5 /* Log no more than 5 errors per second. */
166
167 /* bus entry points */
168 static int mmcsd_attach(device_t dev);
169 static int mmcsd_detach(device_t dev);
170 static int mmcsd_probe(device_t dev);
171 static int mmcsd_shutdown(device_t dev);
172
173 /* disk routines */
174 static int mmcsd_close(struct disk *dp);
175 static int mmcsd_dump(void *arg, void *virtual, vm_offset_t physical,
176     off_t offset, size_t length);
177 static int mmcsd_getattr(struct bio *);
178 static int mmcsd_ioctl_disk(struct disk *disk, u_long cmd, void *data,
179     int fflag, struct thread *td);
180 static void mmcsd_strategy(struct bio *bp);
181 static void mmcsd_task(void *arg);
182
183 /* RMPB cdev interface */
184 static int mmcsd_ioctl_rpmb(struct cdev *dev, u_long cmd, caddr_t data,
185     int fflag, struct thread *td);
186
187 static void mmcsd_add_part(struct mmcsd_softc *sc, u_int type,
188     const char *name, u_int cnt, off_t media_size, bool ro);
189 static int mmcsd_bus_bit_width(device_t dev);
190 static daddr_t mmcsd_delete(struct mmcsd_part *part, struct bio *bp);
191 static const char *mmcsd_errmsg(int e);
192 static int mmcsd_flush_cache(struct mmcsd_softc *sc);
193 static int mmcsd_ioctl(struct mmcsd_part *part, u_long cmd, void *data,
194     int fflag, struct thread *td);
195 static int mmcsd_ioctl_cmd(struct mmcsd_part *part, struct mmc_ioc_cmd *mic,
196     int fflag);
197 static uintmax_t mmcsd_pretty_size(off_t size, char *unit);
198 static daddr_t mmcsd_rw(struct mmcsd_part *part, struct bio *bp);
199 static int mmcsd_set_blockcount(struct mmcsd_softc *sc, u_int count, bool rel);
200 static int mmcsd_slicer(device_t dev, const char *provider,
201     struct flash_slice *slices, int *nslices);
202 static int mmcsd_switch_part(device_t bus, device_t dev, uint16_t rca,
203     u_int part);
204
205 #define MMCSD_DISK_LOCK(_part)          mtx_lock(&(_part)->disk_mtx)
206 #define MMCSD_DISK_UNLOCK(_part)        mtx_unlock(&(_part)->disk_mtx)
207 #define MMCSD_DISK_LOCK_INIT(_part)                                     \
208         mtx_init(&(_part)->disk_mtx, (_part)->name, "mmcsd disk", MTX_DEF)
209 #define MMCSD_DISK_LOCK_DESTROY(_part)  mtx_destroy(&(_part)->disk_mtx);
210 #define MMCSD_DISK_ASSERT_LOCKED(_part)                                 \
211         mtx_assert(&(_part)->disk_mtx, MA_OWNED);
212 #define MMCSD_DISK_ASSERT_UNLOCKED(_part)                               \
213         mtx_assert(&(_part)->disk_mtx, MA_NOTOWNED);
214
215 #define MMCSD_IOCTL_LOCK(_part)         mtx_lock(&(_part)->ioctl_mtx)
216 #define MMCSD_IOCTL_UNLOCK(_part)       mtx_unlock(&(_part)->ioctl_mtx)
217 #define MMCSD_IOCTL_LOCK_INIT(_part)                                    \
218         mtx_init(&(_part)->ioctl_mtx, (_part)->name, "mmcsd IOCTL", MTX_DEF)
219 #define MMCSD_IOCTL_LOCK_DESTROY(_part) mtx_destroy(&(_part)->ioctl_mtx);
220 #define MMCSD_IOCTL_ASSERT_LOCKED(_part)                                \
221         mtx_assert(&(_part)->ioctl_mtx, MA_OWNED);
222 #define MMCSD_IOCLT_ASSERT_UNLOCKED(_part)                              \
223         mtx_assert(&(_part)->ioctl_mtx, MA_NOTOWNED);
224
225 static int
226 mmcsd_probe(device_t dev)
227 {
228
229         device_quiet(dev);
230         device_set_desc(dev, "MMC/SD Memory Card");
231         return (0);
232 }
233
234 static int
235 mmcsd_attach(device_t dev)
236 {
237         device_t mmcbus;
238         struct mmcsd_softc *sc;
239         const uint8_t *ext_csd;
240         off_t erase_size, sector_size, size, wp_size;
241         uintmax_t bytes;
242         int err, i;
243         uint32_t quirks;
244         uint8_t rev;
245         bool comp, ro;
246         char unit[2];
247
248         sc = device_get_softc(dev);
249         sc->dev = dev;
250         sc->mmcbus = mmcbus = device_get_parent(dev);
251         sc->mode = mmc_get_card_type(dev);
252         /*
253          * Note that in principle with an SDHCI-like re-tuning implementation,
254          * the maximum data size can change at runtime due to a device removal/
255          * insertion that results in switches to/from a transfer mode involving
256          * re-tuning, iff there are multiple devices on a given bus.  Until now
257          * mmc(4) lacks support for rescanning already attached buses, however,
258          * and sdhci(4) to date has no support for shared buses in the first
259          * place either.
260          */
261         sc->max_data = mmc_get_max_data(dev);
262         sc->high_cap = mmc_get_high_cap(dev);
263         sc->rca = mmc_get_rca(dev);
264         sc->cmd6_time = mmc_get_cmd6_timeout(dev);
265         quirks = mmc_get_quirks(dev);
266
267         /* Only MMC >= 4.x devices support EXT_CSD. */
268         if (mmc_get_spec_vers(dev) >= 4) {
269                 MMCBUS_ACQUIRE_BUS(mmcbus, dev);
270                 err = mmc_send_ext_csd(mmcbus, dev, sc->ext_csd);
271                 MMCBUS_RELEASE_BUS(mmcbus, dev);
272                 if (err != MMC_ERR_NONE) {
273                         device_printf(dev, "Error reading EXT_CSD %s\n",
274                             mmcsd_errmsg(err));
275                         return (ENXIO);
276                 }
277         }
278         ext_csd = sc->ext_csd;
279
280         if ((quirks & MMC_QUIRK_INAND_CMD38) != 0) {
281                 if (mmc_get_spec_vers(dev) < 4) {
282                         device_printf(dev,
283                             "MMC_QUIRK_INAND_CMD38 set but no EXT_CSD\n");
284                         return (EINVAL);
285                 }
286                 sc->flags |= MMCSD_INAND_CMD38;
287         }
288
289         /*
290          * EXT_CSD_SEC_FEATURE_SUPPORT_GB_CL_EN denotes support for both
291          * insecure and secure TRIM.
292          */
293         if ((ext_csd[EXT_CSD_SEC_FEATURE_SUPPORT] &
294             EXT_CSD_SEC_FEATURE_SUPPORT_GB_CL_EN) != 0 &&
295             (quirks & MMC_QUIRK_BROKEN_TRIM) == 0) {
296                 if (bootverbose)
297                         device_printf(dev, "taking advantage of TRIM\n");
298                 sc->flags |= MMCSD_USE_TRIM;
299                 sc->erase_sector = 1;
300         } else
301                 sc->erase_sector = mmc_get_erase_sector(dev);
302
303         /*
304          * Enhanced user data area and general purpose partitions are only
305          * supported in revision 1.4 (EXT_CSD_REV == 4) and later, the RPMB
306          * partition in revision 1.5 (MMC v4.41, EXT_CSD_REV == 5) and later.
307          */
308         rev = ext_csd[EXT_CSD_REV];
309
310         /*
311          * With revision 1.5 (MMC v4.5, EXT_CSD_REV == 6) and later, take
312          * advantage of the device R/W cache if present and useage is not
313          * disabled.
314          */
315         if (rev >= 6 && mmcsd_cache != 0) {
316                 size = le32dec(&ext_csd[EXT_CSD_CACHE_SIZE]);
317                 if (bootverbose)
318                         device_printf(dev, "cache size %juKB\n", size);
319                 if (size > 0) {
320                         MMCBUS_ACQUIRE_BUS(mmcbus, dev);
321                         err = mmc_switch(mmcbus, dev, sc->rca,
322                             EXT_CSD_CMD_SET_NORMAL, EXT_CSD_CACHE_CTRL,
323                             EXT_CSD_CACHE_CTRL_CACHE_EN, sc->cmd6_time, true);
324                         MMCBUS_RELEASE_BUS(mmcbus, dev);
325                         if (err != MMC_ERR_NONE)
326                                 device_printf(dev, "failed to enable cache\n");
327                         else
328                                 sc->flags |= MMCSD_FLUSH_CACHE;
329                 }
330         }
331
332         /*
333          * Ignore user-creatable enhanced user data area and general purpose
334          * partitions partitions as long as partitioning hasn't been finished.
335          */
336         comp = (ext_csd[EXT_CSD_PART_SET] & EXT_CSD_PART_SET_COMPLETED) != 0;
337
338         /*
339          * Add enhanced user data area slice, unless it spans the entirety of
340          * the user data area.  The enhanced area is of a multiple of high
341          * capacity write protect groups ((ERASE_GRP_SIZE + HC_WP_GRP_SIZE) *
342          * 512 KB) and its offset given in either sectors or bytes, depending
343          * on whether it's a high capacity device or not.
344          * NB: The slicer and its slices need to be registered before adding
345          *     the disk for the corresponding user data area as re-tasting is
346          *     racy.
347          */
348         sector_size = mmc_get_sector_size(dev);
349         size = ext_csd[EXT_CSD_ENH_SIZE_MULT] +
350             (ext_csd[EXT_CSD_ENH_SIZE_MULT + 1] << 8) +
351             (ext_csd[EXT_CSD_ENH_SIZE_MULT + 2] << 16);
352         if (rev >= 4 && comp == TRUE && size > 0 &&
353             (ext_csd[EXT_CSD_PART_SUPPORT] &
354             EXT_CSD_PART_SUPPORT_ENH_ATTR_EN) != 0 &&
355             (ext_csd[EXT_CSD_PART_ATTR] & (EXT_CSD_PART_ATTR_ENH_USR)) != 0) {
356                 erase_size = ext_csd[EXT_CSD_ERASE_GRP_SIZE] * 1024 *
357                     MMC_SECTOR_SIZE;
358                 wp_size = ext_csd[EXT_CSD_HC_WP_GRP_SIZE];
359                 size *= erase_size * wp_size;
360                 if (size != mmc_get_media_size(dev) * sector_size) {
361                         sc->enh_size = size;
362                         sc->enh_base =
363                             le32dec(&ext_csd[EXT_CSD_ENH_START_ADDR]) *
364                             (sc->high_cap == 0 ? MMC_SECTOR_SIZE : 1);
365                 } else if (bootverbose)
366                         device_printf(dev,
367                             "enhanced user data area spans entire device\n");
368         }
369
370         /*
371          * Add default partition.  This may be the only one or the user
372          * data area in case partitions are supported.
373          */
374         ro = mmc_get_read_only(dev);
375         mmcsd_add_part(sc, EXT_CSD_PART_CONFIG_ACC_DEFAULT, "mmcsd",
376             device_get_unit(dev), mmc_get_media_size(dev) * sector_size, ro);
377
378         if (mmc_get_spec_vers(dev) < 3)
379                 return (0);
380
381         /* Belatedly announce enhanced user data slice. */
382         if (sc->enh_size != 0) {
383                 bytes = mmcsd_pretty_size(size, unit);
384                 printf(FLASH_SLICES_FMT ": %ju%sB enhanced user data area "
385                     "slice offset 0x%jx at %s\n", device_get_nameunit(dev),
386                     MMCSD_LABEL_ENH, bytes, unit, (uintmax_t)sc->enh_base,
387                     device_get_nameunit(dev));
388         }
389
390         /*
391          * Determine partition switch timeout (provided in units of 10 ms)
392          * and ensure it's at least 300 ms as some eMMC chips lie.
393          */
394         sc->part_time = max(ext_csd[EXT_CSD_PART_SWITCH_TO] * 10 * 1000,
395             300 * 1000);
396
397         /* Add boot partitions, which are of a fixed multiple of 128 KB. */
398         size = ext_csd[EXT_CSD_BOOT_SIZE_MULT] * MMC_BOOT_RPMB_BLOCK_SIZE;
399         if (size > 0 && (mmcbr_get_caps(mmcbus) & MMC_CAP_BOOT_NOACC) == 0) {
400                 mmcsd_add_part(sc, EXT_CSD_PART_CONFIG_ACC_BOOT0,
401                     MMCSD_FMT_BOOT, 0, size,
402                     ro | ((ext_csd[EXT_CSD_BOOT_WP_STATUS] &
403                     EXT_CSD_BOOT_WP_STATUS_BOOT0_MASK) != 0));
404                 mmcsd_add_part(sc, EXT_CSD_PART_CONFIG_ACC_BOOT1,
405                     MMCSD_FMT_BOOT, 1, size,
406                     ro | ((ext_csd[EXT_CSD_BOOT_WP_STATUS] &
407                     EXT_CSD_BOOT_WP_STATUS_BOOT1_MASK) != 0));
408         }
409
410         /* Add RPMB partition, which also is of a fixed multiple of 128 KB. */
411         size = ext_csd[EXT_CSD_RPMB_MULT] * MMC_BOOT_RPMB_BLOCK_SIZE;
412         if (rev >= 5 && size > 0)
413                 mmcsd_add_part(sc, EXT_CSD_PART_CONFIG_ACC_RPMB,
414                     MMCSD_FMT_RPMB, 0, size, ro);
415
416         if (rev <= 3 || comp == FALSE)
417                 return (0);
418
419         /*
420          * Add general purpose partitions, which are of a multiple of high
421          * capacity write protect groups, too.
422          */
423         if ((ext_csd[EXT_CSD_PART_SUPPORT] & EXT_CSD_PART_SUPPORT_EN) != 0) {
424                 erase_size = ext_csd[EXT_CSD_ERASE_GRP_SIZE] * 1024 *
425                     MMC_SECTOR_SIZE;
426                 wp_size = ext_csd[EXT_CSD_HC_WP_GRP_SIZE];
427                 for (i = 0; i < MMC_PART_GP_MAX; i++) {
428                         size = ext_csd[EXT_CSD_GP_SIZE_MULT + i * 3] +
429                             (ext_csd[EXT_CSD_GP_SIZE_MULT + i * 3 + 1] << 8) +
430                             (ext_csd[EXT_CSD_GP_SIZE_MULT + i * 3 + 2] << 16);
431                         if (size == 0)
432                                 continue;
433                         mmcsd_add_part(sc, EXT_CSD_PART_CONFIG_ACC_GP0 + i,
434                             MMCSD_FMT_GP, i, size * erase_size * wp_size, ro);
435                 }
436         }
437         return (0);
438 }
439
440 static uintmax_t
441 mmcsd_pretty_size(off_t size, char *unit)
442 {
443         uintmax_t bytes;
444         int i;
445
446         /*
447          * Display in most natural units.  There's no card < 1MB.  However,
448          * RPMB partitions occasionally are smaller than that, though.  The
449          * SD standard goes to 2 GiB due to its reliance on FAT, but the data
450          * format supports up to 4 GiB and some card makers push it up to this
451          * limit.  The SDHC standard only goes to 32 GiB due to FAT32, but the
452          * data format supports up to 2 TiB however.  2048 GB isn't too ugly,
453          * so we note it in passing here and don't add the code to print TB).
454          * Since these cards are sold in terms of MB and GB not MiB and GiB,
455          * report them like that.  We also round to the nearest unit, since
456          * many cards are a few percent short, even of the power of 10 size.
457          */
458         bytes = size;
459         unit[0] = unit[1] = '\0';
460         for (i = 0; i <= 2 && bytes >= 1000; i++) {
461                 bytes = (bytes + 1000 / 2 - 1) / 1000;
462                 switch (i) {
463                 case 0:
464                         unit[0] = 'k';
465                         break;
466                 case 1:
467                         unit[0] = 'M';
468                         break;
469                 case 2:
470                         unit[0] = 'G';
471                         break;
472                 default:
473                         break;
474                 }
475         }
476         return (bytes);
477 }
478
479 static struct cdevsw mmcsd_rpmb_cdevsw = {
480         .d_version      = D_VERSION,
481         .d_name         = "mmcsdrpmb",
482         .d_ioctl        = mmcsd_ioctl_rpmb
483 };
484
485 static void
486 mmcsd_add_part(struct mmcsd_softc *sc, u_int type, const char *name, u_int cnt,
487     off_t media_size, bool ro)
488 {
489         struct make_dev_args args;
490         device_t dev, mmcbus;
491         const char *ext;
492         const uint8_t *ext_csd;
493         struct mmcsd_part *part;
494         struct disk *d;
495         uintmax_t bytes;
496         u_int gp;
497         uint32_t speed;
498         uint8_t extattr;
499         bool enh;
500         char unit[2];
501
502         dev = sc->dev;
503         mmcbus = sc->mmcbus;
504         part = sc->part[type] = malloc(sizeof(*part), M_DEVBUF,
505             M_WAITOK | M_ZERO);
506         part->sc = sc;
507         part->cnt = cnt;
508         part->type = type;
509         part->ro = ro;
510         snprintf(part->name, sizeof(part->name), name, device_get_unit(dev));
511
512         MMCSD_IOCTL_LOCK_INIT(part);
513
514         /*
515          * For the RPMB partition, allow IOCTL access only.
516          * NB: If ever attaching RPMB partitions to disk(9), the re-tuning
517          *     implementation and especially its pausing need to be revisited,
518          *     because then re-tuning requests may be issued by the IOCTL half
519          *     of this driver while re-tuning is already paused by the disk(9)
520          *     one and vice versa.
521          */
522         if (type == EXT_CSD_PART_CONFIG_ACC_RPMB) {
523                 make_dev_args_init(&args);
524                 args.mda_flags = MAKEDEV_CHECKNAME | MAKEDEV_WAITOK;
525                 args.mda_devsw = &mmcsd_rpmb_cdevsw;
526                 args.mda_uid = UID_ROOT;
527                 args.mda_gid = GID_OPERATOR;
528                 args.mda_mode = 0640;
529                 args.mda_si_drv1 = part;
530                 if (make_dev_s(&args, &sc->rpmb_dev, "%s", part->name) != 0) {
531                         device_printf(dev, "Failed to make RPMB device\n");
532                         free(part, M_DEVBUF);
533                         return;
534                 }
535         } else {
536                 MMCSD_DISK_LOCK_INIT(part);
537
538                 d = part->disk = disk_alloc();
539                 d->d_close = mmcsd_close;
540                 d->d_strategy = mmcsd_strategy;
541                 d->d_ioctl = mmcsd_ioctl_disk;
542                 d->d_dump = mmcsd_dump;
543                 d->d_getattr = mmcsd_getattr;
544                 d->d_name = part->name;
545                 d->d_drv1 = part;
546                 d->d_sectorsize = mmc_get_sector_size(dev);
547                 d->d_maxsize = sc->max_data * d->d_sectorsize;
548                 d->d_mediasize = media_size;
549                 d->d_stripesize = sc->erase_sector * d->d_sectorsize;
550                 d->d_unit = cnt;
551                 d->d_flags = DISKFLAG_CANDELETE;
552                 if ((sc->flags & MMCSD_FLUSH_CACHE) != 0)
553                         d->d_flags |= DISKFLAG_CANFLUSHCACHE;
554                 d->d_delmaxsize = mmc_get_erase_sector(dev) * d->d_sectorsize;
555                 strlcpy(d->d_ident, mmc_get_card_sn_string(dev),
556                     sizeof(d->d_ident));
557                 strlcpy(d->d_descr, mmc_get_card_id_string(dev),
558                     sizeof(d->d_descr));
559                 d->d_rotation_rate = DISK_RR_NON_ROTATING;
560
561                 disk_create(d, DISK_VERSION);
562                 bioq_init(&part->bio_queue);
563
564                 part->running = 1;
565                 kproc_create(&mmcsd_task, part, &part->p, 0, 0,
566                     "%s%d: mmc/sd card", part->name, cnt);
567         }
568
569         bytes = mmcsd_pretty_size(media_size, unit);
570         if (type == EXT_CSD_PART_CONFIG_ACC_DEFAULT) {
571                 speed = mmcbr_get_clock(mmcbus);
572                 printf("%s%d: %ju%sB <%s>%s at %s %d.%01dMHz/%dbit/%d-block\n",
573                     part->name, cnt, bytes, unit, mmc_get_card_id_string(dev),
574                     ro ? " (read-only)" : "", device_get_nameunit(mmcbus),
575                     speed / 1000000, (speed / 100000) % 10,
576                     mmcsd_bus_bit_width(dev), sc->max_data);
577         } else if (type == EXT_CSD_PART_CONFIG_ACC_RPMB) {
578                 printf("%s: %ju%sB partition %d%s at %s\n", part->name, bytes,
579                     unit, type, ro ? " (read-only)" : "",
580                     device_get_nameunit(dev));
581         } else {
582                 enh = false;
583                 ext = NULL;
584                 extattr = 0;
585                 if (type >= EXT_CSD_PART_CONFIG_ACC_GP0 &&
586                     type <= EXT_CSD_PART_CONFIG_ACC_GP3) {
587                         ext_csd = sc->ext_csd;
588                         gp = type - EXT_CSD_PART_CONFIG_ACC_GP0;
589                         if ((ext_csd[EXT_CSD_PART_SUPPORT] &
590                             EXT_CSD_PART_SUPPORT_ENH_ATTR_EN) != 0 &&
591                             (ext_csd[EXT_CSD_PART_ATTR] &
592                             (EXT_CSD_PART_ATTR_ENH_GP0 << gp)) != 0)
593                                 enh = true;
594                         else if ((ext_csd[EXT_CSD_PART_SUPPORT] &
595                             EXT_CSD_PART_SUPPORT_EXT_ATTR_EN) != 0) {
596                                 extattr = (ext_csd[EXT_CSD_EXT_PART_ATTR +
597                                     (gp / 2)] >> (4 * (gp % 2))) & 0xF;
598                                 switch (extattr) {
599                                         case EXT_CSD_EXT_PART_ATTR_DEFAULT:
600                                                 break;
601                                         case EXT_CSD_EXT_PART_ATTR_SYSTEMCODE:
602                                                 ext = "system code";
603                                                 break;
604                                         case EXT_CSD_EXT_PART_ATTR_NPERSISTENT:
605                                                 ext = "non-persistent";
606                                                 break;
607                                         default:
608                                                 ext = "reserved";
609                                                 break;
610                                 }
611                         }
612                 }
613                 if (ext == NULL)
614                         printf("%s%d: %ju%sB partition %d%s%s at %s\n",
615                             part->name, cnt, bytes, unit, type, enh ?
616                             " enhanced" : "", ro ? " (read-only)" : "",
617                             device_get_nameunit(dev));
618                 else
619                         printf("%s%d: %ju%sB partition %d extended 0x%x "
620                             "(%s)%s at %s\n", part->name, cnt, bytes, unit,
621                             type, extattr, ext, ro ? " (read-only)" : "",
622                             device_get_nameunit(dev));
623         }
624 }
625
626 static int
627 mmcsd_slicer(device_t dev, const char *provider,
628     struct flash_slice *slices, int *nslices)
629 {
630         char name[MMCSD_PART_NAMELEN];
631         struct mmcsd_softc *sc;
632         struct mmcsd_part *part;
633
634         *nslices = 0;
635         if (slices == NULL)
636                 return (ENOMEM);
637
638         sc = device_get_softc(dev);
639         if (sc->enh_size == 0)
640                 return (ENXIO);
641
642         part = sc->part[EXT_CSD_PART_CONFIG_ACC_DEFAULT];
643         snprintf(name, sizeof(name), "%s%d", part->disk->d_name,
644             part->disk->d_unit);
645         if (strcmp(name, provider) != 0)
646                 return (ENXIO);
647
648         *nslices = 1;
649         slices[0].base = sc->enh_base;
650         slices[0].size = sc->enh_size;
651         slices[0].label = MMCSD_LABEL_ENH;
652         return (0);
653 }
654
655 static int
656 mmcsd_detach(device_t dev)
657 {
658         struct mmcsd_softc *sc = device_get_softc(dev);
659         struct mmcsd_part *part;
660         int i;
661
662         for (i = 0; i < MMC_PART_MAX; i++) {
663                 part = sc->part[i];
664                 if (part != NULL) {
665                         if (part->disk != NULL) {
666                                 MMCSD_DISK_LOCK(part);
667                                 part->suspend = 0;
668                                 if (part->running > 0) {
669                                         /* kill thread */
670                                         part->running = 0;
671                                         wakeup(part);
672                                         /* wait for thread to finish. */
673                                         while (part->running != -1)
674                                                 msleep(part, &part->disk_mtx, 0,
675                                                     "mmcsd disk detach", 0);
676                                 }
677                                 MMCSD_DISK_UNLOCK(part);
678                         }
679                         MMCSD_IOCTL_LOCK(part);
680                         while (part->ioctl > 0)
681                                 msleep(part, &part->ioctl_mtx, 0,
682                                     "mmcsd IOCTL detach", 0);
683                         part->ioctl = -1;
684                         MMCSD_IOCTL_UNLOCK(part);
685                 }
686         }
687
688         if (sc->rpmb_dev != NULL)
689                 destroy_dev(sc->rpmb_dev);
690
691         for (i = 0; i < MMC_PART_MAX; i++) {
692                 part = sc->part[i];
693                 if (part != NULL) {
694                         if (part->disk != NULL) {
695                                 /* Flush the request queue. */
696                                 bioq_flush(&part->bio_queue, NULL, ENXIO);
697                                 /* kill disk */
698                                 disk_destroy(part->disk);
699
700                                 MMCSD_DISK_LOCK_DESTROY(part);
701                         }
702                         MMCSD_IOCTL_LOCK_DESTROY(part);
703                         free(part, M_DEVBUF);
704                 }
705         }
706         if (mmcsd_flush_cache(sc) != MMC_ERR_NONE)
707                 device_printf(dev, "failed to flush cache\n");
708         return (0);
709 }
710
711 static int
712 mmcsd_shutdown(device_t dev)
713 {
714         struct mmcsd_softc *sc = device_get_softc(dev);
715
716         if (mmcsd_flush_cache(sc) != MMC_ERR_NONE)
717                 device_printf(dev, "failed to flush cache\n");
718         return (0);
719 }
720
721 static int
722 mmcsd_suspend(device_t dev)
723 {
724         struct mmcsd_softc *sc = device_get_softc(dev);
725         struct mmcsd_part *part;
726         int i;
727
728         for (i = 0; i < MMC_PART_MAX; i++) {
729                 part = sc->part[i];
730                 if (part != NULL) {
731                         if (part->disk != NULL) {
732                                 MMCSD_DISK_LOCK(part);
733                                 part->suspend = 1;
734                                 if (part->running > 0) {
735                                         /* kill thread */
736                                         part->running = 0;
737                                         wakeup(part);
738                                         /* wait for thread to finish. */
739                                         while (part->running != -1)
740                                                 msleep(part, &part->disk_mtx, 0,
741                                                     "mmcsd disk suspension", 0);
742                                 }
743                                 MMCSD_DISK_UNLOCK(part);
744                         }
745                         MMCSD_IOCTL_LOCK(part);
746                         while (part->ioctl > 0)
747                                 msleep(part, &part->ioctl_mtx, 0,
748                                     "mmcsd IOCTL suspension", 0);
749                         part->ioctl = -1;
750                         MMCSD_IOCTL_UNLOCK(part);
751                 }
752         }
753         if (mmcsd_flush_cache(sc) != MMC_ERR_NONE)
754                 device_printf(dev, "failed to flush cache\n");
755         return (0);
756 }
757
758 static int
759 mmcsd_resume(device_t dev)
760 {
761         struct mmcsd_softc *sc = device_get_softc(dev);
762         struct mmcsd_part *part;
763         int i;
764
765         for (i = 0; i < MMC_PART_MAX; i++) {
766                 part = sc->part[i];
767                 if (part != NULL) {
768                         if (part->disk != NULL) {
769                                 MMCSD_DISK_LOCK(part);
770                                 part->suspend = 0;
771                                 if (part->running <= 0) {
772                                         part->running = 1;
773                                         MMCSD_DISK_UNLOCK(part);
774                                         kproc_create(&mmcsd_task, part,
775                                             &part->p, 0, 0, "%s%d: mmc/sd card",
776                                             part->name, part->cnt);
777                                 } else
778                                         MMCSD_DISK_UNLOCK(part);
779                         }
780                         MMCSD_IOCTL_LOCK(part);
781                         part->ioctl = 0;
782                         MMCSD_IOCTL_UNLOCK(part);
783                 }
784         }
785         return (0);
786 }
787
788 static int
789 mmcsd_close(struct disk *dp)
790 {
791         struct mmcsd_softc *sc;
792
793         if ((dp->d_flags & DISKFLAG_OPEN) != 0) {
794                 sc = ((struct mmcsd_part *)dp->d_drv1)->sc;
795                 if (mmcsd_flush_cache(sc) != MMC_ERR_NONE)
796                         device_printf(sc->dev, "failed to flush cache\n");
797         }
798         return (0);
799 }
800
801 static void
802 mmcsd_strategy(struct bio *bp)
803 {
804         struct mmcsd_part *part;
805
806         part = bp->bio_disk->d_drv1;
807         MMCSD_DISK_LOCK(part);
808         if (part->running > 0 || part->suspend > 0) {
809                 bioq_disksort(&part->bio_queue, bp);
810                 MMCSD_DISK_UNLOCK(part);
811                 wakeup(part);
812         } else {
813                 MMCSD_DISK_UNLOCK(part);
814                 biofinish(bp, NULL, ENXIO);
815         }
816 }
817
818 static int
819 mmcsd_ioctl_rpmb(struct cdev *dev, u_long cmd, caddr_t data,
820     int fflag, struct thread *td)
821 {
822
823         return (mmcsd_ioctl(dev->si_drv1, cmd, data, fflag, td));
824 }
825
826 static int
827 mmcsd_ioctl_disk(struct disk *disk, u_long cmd, void *data, int fflag,
828     struct thread *td)
829 {
830
831         return (mmcsd_ioctl(disk->d_drv1, cmd, data, fflag, td));
832 }
833
834 static int
835 mmcsd_ioctl(struct mmcsd_part *part, u_long cmd, void *data, int fflag,
836     struct thread *td)
837 {
838         struct mmc_ioc_cmd *mic;
839         struct mmc_ioc_multi_cmd *mimc;
840         int i, err;
841         u_long cnt, size;
842
843         if ((fflag & FREAD) == 0)
844                 return (EBADF);
845
846         err = priv_check(td, PRIV_DRIVER);
847         if (err != 0)
848                 return (err);
849
850         err = 0;
851         switch (cmd) {
852         case MMC_IOC_CMD:
853                 mic = data;
854                 err = mmcsd_ioctl_cmd(part, mic, fflag);
855                 break;
856         case MMC_IOC_MULTI_CMD:
857                 mimc = data;
858                 if (mimc->num_of_cmds == 0)
859                         break;
860                 if (mimc->num_of_cmds > MMC_IOC_MAX_CMDS)
861                         return (EINVAL);
862                 cnt = mimc->num_of_cmds;
863                 size = sizeof(*mic) * cnt;
864                 mic = malloc(size, M_TEMP, M_WAITOK);
865                 err = copyin((const void *)mimc->cmds, mic, size);
866                 if (err == 0) {
867                         for (i = 0; i < cnt; i++) {
868                                 err = mmcsd_ioctl_cmd(part, &mic[i], fflag);
869                                 if (err != 0)
870                                         break;
871                         }
872                 }
873                 free(mic, M_TEMP);
874                 break;
875         default:
876                 return (ENOIOCTL);
877         }
878         return (err);
879 }
880
881 static int
882 mmcsd_ioctl_cmd(struct mmcsd_part *part, struct mmc_ioc_cmd *mic, int fflag)
883 {
884         struct mmc_command cmd;
885         struct mmc_data data;
886         struct mmcsd_softc *sc;
887         device_t dev, mmcbus;
888         void *dp;
889         u_long len;
890         int err, retries;
891         uint32_t status;
892         uint16_t rca;
893
894         if ((fflag & FWRITE) == 0 && mic->write_flag != 0)
895                 return (EBADF);
896
897         if (part->ro == TRUE && mic->write_flag != 0)
898                 return (EROFS);
899
900         /*
901          * We don't need to explicitly lock against the disk(9) half of this
902          * driver as MMCBUS_ACQUIRE_BUS() will serialize us.  However, it's
903          * necessary to protect against races with detachment and suspension,
904          * especially since it's required to switch away from RPMB partitions
905          * again after an access (see mmcsd_switch_part()).
906          */
907         MMCSD_IOCTL_LOCK(part);
908         while (part->ioctl != 0) {
909                 if (part->ioctl < 0) {
910                         MMCSD_IOCTL_UNLOCK(part);
911                         return (ENXIO);
912                 }
913                 msleep(part, &part->ioctl_mtx, 0, "mmcsd IOCTL", 0);
914         }
915         part->ioctl = 1;
916         MMCSD_IOCTL_UNLOCK(part);
917
918         err = 0;
919         dp = NULL;
920         len = mic->blksz * mic->blocks;
921         if (len > MMC_IOC_MAX_BYTES) {
922                 err = EOVERFLOW;
923                 goto out;
924         }
925         if (len != 0) {
926                 dp = malloc(len, M_TEMP, M_WAITOK);
927                 err = copyin((void *)(uintptr_t)mic->data_ptr, dp, len);
928                 if (err != 0)
929                         goto out;
930         }
931         memset(&cmd, 0, sizeof(cmd));
932         memset(&data, 0, sizeof(data));
933         cmd.opcode = mic->opcode;
934         cmd.arg = mic->arg;
935         cmd.flags = mic->flags;
936         if (len != 0) {
937                 data.len = len;
938                 data.data = dp;
939                 data.flags = mic->write_flag != 0 ? MMC_DATA_WRITE :
940                     MMC_DATA_READ;
941                 cmd.data = &data;
942         }
943         sc = part->sc;
944         rca = sc->rca;
945         if (mic->is_acmd == 0) {
946                 /* Enforce/patch/restrict RCA-based commands */
947                 switch (cmd.opcode) {
948                 case MMC_SET_RELATIVE_ADDR:
949                 case MMC_SELECT_CARD:
950                         err = EPERM;
951                         goto out;
952                 case MMC_STOP_TRANSMISSION:
953                         if ((cmd.arg & 0x1) == 0)
954                                 break;
955                         /* FALLTHROUGH */
956                 case MMC_SLEEP_AWAKE:
957                 case MMC_SEND_CSD:
958                 case MMC_SEND_CID:
959                 case MMC_SEND_STATUS:
960                 case MMC_GO_INACTIVE_STATE:
961                 case MMC_FAST_IO:
962                 case MMC_APP_CMD:
963                         cmd.arg = (cmd.arg & 0x0000FFFF) | (rca << 16);
964                         break;
965                 default:
966                         break;
967                 }
968                 /*
969                  * No partition switching in userland; it's almost impossible
970                  * to recover from that, especially if things go wrong.
971                  */
972                 if (cmd.opcode == MMC_SWITCH_FUNC && dp != NULL &&
973                     (((uint8_t *)dp)[EXT_CSD_PART_CONFIG] &
974                     EXT_CSD_PART_CONFIG_ACC_MASK) != part->type) {
975                         err = EINVAL;
976                         goto out;
977                 }
978         }
979         dev = sc->dev;
980         mmcbus = sc->mmcbus;
981         MMCBUS_ACQUIRE_BUS(mmcbus, dev);
982         err = mmcsd_switch_part(mmcbus, dev, rca, part->type);
983         if (err != MMC_ERR_NONE)
984                 goto release;
985         if (part->type == EXT_CSD_PART_CONFIG_ACC_RPMB) {
986                 err = mmcsd_set_blockcount(sc, mic->blocks,
987                     mic->write_flag & (1 << 31));
988                 if (err != MMC_ERR_NONE)
989                         goto switch_back;
990         }
991         if (mic->write_flag != 0)
992                 sc->flags |= MMCSD_DIRTY;
993         if (mic->is_acmd != 0)
994                 (void)mmc_wait_for_app_cmd(mmcbus, dev, rca, &cmd, 0);
995         else
996                 (void)mmc_wait_for_cmd(mmcbus, dev, &cmd, 0);
997         if (part->type == EXT_CSD_PART_CONFIG_ACC_RPMB) {
998                 /*
999                  * If the request went to the RPMB partition, try to ensure
1000                  * that the command actually has completed.
1001                  */
1002                 retries = MMCSD_CMD_RETRIES;
1003                 do {
1004                         err = mmc_send_status(mmcbus, dev, rca, &status);
1005                         if (err != MMC_ERR_NONE)
1006                                 break;
1007                         if (R1_STATUS(status) == 0 &&
1008                             R1_CURRENT_STATE(status) != R1_STATE_PRG)
1009                                 break;
1010                         DELAY(1000);
1011                 } while (retries-- > 0);
1012         }
1013         /*
1014          * If EXT_CSD was changed, our copy is outdated now.  Specifically,
1015          * the upper bits of EXT_CSD_PART_CONFIG used in mmcsd_switch_part(),
1016          * so retrieve EXT_CSD again.
1017          */
1018         if (cmd.opcode == MMC_SWITCH_FUNC) {
1019                 err = mmc_send_ext_csd(mmcbus, dev, sc->ext_csd);
1020                 if (err != MMC_ERR_NONE)
1021                         goto release;
1022         }
1023 switch_back:
1024         if (part->type == EXT_CSD_PART_CONFIG_ACC_RPMB) {
1025                 /*
1026                  * If the request went to the RPMB partition, always switch
1027                  * back to the default partition (see mmcsd_switch_part()).
1028                  */
1029                 err = mmcsd_switch_part(mmcbus, dev, rca,
1030                     EXT_CSD_PART_CONFIG_ACC_DEFAULT);
1031                 if (err != MMC_ERR_NONE)
1032                         goto release;
1033         }
1034         MMCBUS_RELEASE_BUS(mmcbus, dev);
1035         if (cmd.error != MMC_ERR_NONE) {
1036                 switch (cmd.error) {
1037                 case MMC_ERR_TIMEOUT:
1038                         err = ETIMEDOUT;
1039                         break;
1040                 case MMC_ERR_BADCRC:
1041                         err = EILSEQ;
1042                         break;
1043                 case MMC_ERR_INVALID:
1044                         err = EINVAL;
1045                         break;
1046                 case MMC_ERR_NO_MEMORY:
1047                         err = ENOMEM;
1048                         break;
1049                 default:
1050                         err = EIO;
1051                         break;
1052                 }
1053                 goto out;
1054         }
1055         memcpy(mic->response, cmd.resp, 4 * sizeof(uint32_t));
1056         if (mic->write_flag == 0 && len != 0) {
1057                 err = copyout(dp, (void *)(uintptr_t)mic->data_ptr, len);
1058                 if (err != 0)
1059                         goto out;
1060         }
1061         goto out;
1062
1063 release:
1064         MMCBUS_RELEASE_BUS(mmcbus, dev);
1065         err = EIO;
1066
1067 out:
1068         MMCSD_IOCTL_LOCK(part);
1069         part->ioctl = 0;
1070         MMCSD_IOCTL_UNLOCK(part);
1071         wakeup(part);
1072         if (dp != NULL)
1073                 free(dp, M_TEMP);
1074         return (err);
1075 }
1076
1077 static int
1078 mmcsd_getattr(struct bio *bp)
1079 {
1080         struct mmcsd_part *part;
1081         device_t dev;
1082
1083         if (strcmp(bp->bio_attribute, "MMC::device") == 0) {
1084                 if (bp->bio_length != sizeof(dev))
1085                         return (EFAULT);
1086                 part = bp->bio_disk->d_drv1;
1087                 dev = part->sc->dev;
1088                 bcopy(&dev, bp->bio_data, sizeof(dev));
1089                 bp->bio_completed = bp->bio_length;
1090                 return (0);
1091         }
1092         return (-1);
1093 }
1094
1095 static int
1096 mmcsd_set_blockcount(struct mmcsd_softc *sc, u_int count, bool reliable)
1097 {
1098         struct mmc_command cmd;
1099         struct mmc_request req;
1100
1101         memset(&req, 0, sizeof(req));
1102         memset(&cmd, 0, sizeof(cmd));
1103         cmd.mrq = &req;
1104         req.cmd = &cmd;
1105         cmd.opcode = MMC_SET_BLOCK_COUNT;
1106         cmd.arg = count & 0x0000FFFF;
1107         if (reliable)
1108                 cmd.arg |= 1 << 31;
1109         cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1110         MMCBUS_WAIT_FOR_REQUEST(sc->mmcbus, sc->dev, &req);
1111         return (cmd.error);
1112 }
1113
1114 static int
1115 mmcsd_switch_part(device_t bus, device_t dev, uint16_t rca, u_int part)
1116 {
1117         struct mmcsd_softc *sc;
1118         int err;
1119         uint8_t value;
1120
1121         sc = device_get_softc(dev);
1122
1123         if (sc->mode == mode_sd)
1124                 return (MMC_ERR_NONE);
1125
1126         /*
1127          * According to section "6.2.2 Command restrictions" of the eMMC
1128          * specification v5.1, CMD19/CMD21 aren't allowed to be used with
1129          * RPMB partitions.  So we pause re-tuning along with triggering
1130          * it up-front to decrease the likelihood of re-tuning becoming
1131          * necessary while accessing an RPMB partition.  Consequently, an
1132          * RPMB partition should immediately be switched away from again
1133          * after an access in order to allow for re-tuning to take place
1134          * anew.
1135          */
1136         if (part == EXT_CSD_PART_CONFIG_ACC_RPMB)
1137                 MMCBUS_RETUNE_PAUSE(sc->mmcbus, sc->dev, true);
1138
1139         if (sc->part_curr == part)
1140                 return (MMC_ERR_NONE);
1141
1142         value = (sc->ext_csd[EXT_CSD_PART_CONFIG] &
1143             ~EXT_CSD_PART_CONFIG_ACC_MASK) | part;
1144         /* Jump! */
1145         err = mmc_switch(bus, dev, rca, EXT_CSD_CMD_SET_NORMAL,
1146             EXT_CSD_PART_CONFIG, value, sc->part_time, true);
1147         if (err != MMC_ERR_NONE) {
1148                 if (part == EXT_CSD_PART_CONFIG_ACC_RPMB)
1149                         MMCBUS_RETUNE_UNPAUSE(sc->mmcbus, sc->dev);
1150                 return (err);
1151         }
1152
1153         sc->ext_csd[EXT_CSD_PART_CONFIG] = value;
1154         if (sc->part_curr == EXT_CSD_PART_CONFIG_ACC_RPMB)
1155                 MMCBUS_RETUNE_UNPAUSE(sc->mmcbus, sc->dev);
1156         sc->part_curr = part;
1157         return (MMC_ERR_NONE);
1158 }
1159
1160 static const char *
1161 mmcsd_errmsg(int e)
1162 {
1163
1164         if (e < 0 || e > MMC_ERR_MAX)
1165                 return "Bad error code";
1166         return (errmsg[e]);
1167 }
1168
1169 static daddr_t
1170 mmcsd_rw(struct mmcsd_part *part, struct bio *bp)
1171 {
1172         daddr_t block, end;
1173         struct mmc_command cmd;
1174         struct mmc_command stop;
1175         struct mmc_request req;
1176         struct mmc_data data;
1177         struct mmcsd_softc *sc;
1178         device_t dev, mmcbus;
1179         u_int numblocks, sz;
1180         char *vaddr;
1181
1182         sc = part->sc;
1183         dev = sc->dev;
1184         mmcbus = sc->mmcbus;
1185
1186         block = bp->bio_pblkno;
1187         sz = part->disk->d_sectorsize;
1188         end = bp->bio_pblkno + (bp->bio_bcount / sz);
1189         while (block < end) {
1190                 vaddr = bp->bio_data + (block - bp->bio_pblkno) * sz;
1191                 numblocks = min(end - block, sc->max_data);
1192                 memset(&req, 0, sizeof(req));
1193                 memset(&cmd, 0, sizeof(cmd));
1194                 memset(&stop, 0, sizeof(stop));
1195                 memset(&data, 0, sizeof(data));
1196                 cmd.mrq = &req;
1197                 req.cmd = &cmd;
1198                 cmd.data = &data;
1199                 if (bp->bio_cmd == BIO_READ) {
1200                         if (numblocks > 1)
1201                                 cmd.opcode = MMC_READ_MULTIPLE_BLOCK;
1202                         else
1203                                 cmd.opcode = MMC_READ_SINGLE_BLOCK;
1204                 } else {
1205                         sc->flags |= MMCSD_DIRTY;
1206                         if (numblocks > 1)
1207                                 cmd.opcode = MMC_WRITE_MULTIPLE_BLOCK;
1208                         else
1209                                 cmd.opcode = MMC_WRITE_BLOCK;
1210                 }
1211                 cmd.arg = block;
1212                 if (sc->high_cap == 0)
1213                         cmd.arg <<= 9;
1214                 cmd.flags = MMC_RSP_R1 | MMC_CMD_ADTC;
1215                 data.data = vaddr;
1216                 data.mrq = &req;
1217                 if (bp->bio_cmd == BIO_READ)
1218                         data.flags = MMC_DATA_READ;
1219                 else
1220                         data.flags = MMC_DATA_WRITE;
1221                 data.len = numblocks * sz;
1222                 if (numblocks > 1) {
1223                         data.flags |= MMC_DATA_MULTI;
1224                         stop.opcode = MMC_STOP_TRANSMISSION;
1225                         stop.arg = 0;
1226                         stop.flags = MMC_RSP_R1B | MMC_CMD_AC;
1227                         stop.mrq = &req;
1228                         req.stop = &stop;
1229                 }
1230                 MMCBUS_WAIT_FOR_REQUEST(mmcbus, dev, &req);
1231                 if (req.cmd->error != MMC_ERR_NONE) {
1232                         if (ppsratecheck(&sc->log_time, &sc->log_count,
1233                             LOG_PPS))
1234                                 device_printf(dev, "Error indicated: %d %s\n",
1235                                     req.cmd->error,
1236                                     mmcsd_errmsg(req.cmd->error));
1237                         break;
1238                 }
1239                 block += numblocks;
1240         }
1241         return (block);
1242 }
1243
1244 static daddr_t
1245 mmcsd_delete(struct mmcsd_part *part, struct bio *bp)
1246 {
1247         daddr_t block, end, start, stop;
1248         struct mmc_command cmd;
1249         struct mmc_request req;
1250         struct mmcsd_softc *sc;
1251         device_t dev, mmcbus;
1252         u_int erase_sector, sz;
1253         int err;
1254         bool use_trim;
1255
1256         sc = part->sc;
1257         dev = sc->dev;
1258         mmcbus = sc->mmcbus;
1259
1260         block = bp->bio_pblkno;
1261         sz = part->disk->d_sectorsize;
1262         end = bp->bio_pblkno + (bp->bio_bcount / sz);
1263         use_trim = sc->flags & MMCSD_USE_TRIM;
1264         if (use_trim == true) {
1265                 start = block;
1266                 stop = end;
1267         } else {
1268                 /* Coalesce with the remainder of the previous request. */
1269                 if (block > part->eblock && block <= part->eend)
1270                         block = part->eblock;
1271                 if (end >= part->eblock && end < part->eend)
1272                         end = part->eend;
1273                 /* Safely round to the erase sector boundaries. */
1274                 erase_sector = sc->erase_sector;
1275                 start = block + erase_sector - 1;        /* Round up. */
1276                 start -= start % erase_sector;
1277                 stop = end;                             /* Round down. */
1278                 stop -= end % erase_sector;
1279                 /*
1280                  * We can't erase an area smaller than an erase sector, so
1281                  * store it for later.
1282                  */
1283                 if (start >= stop) {
1284                         part->eblock = block;
1285                         part->eend = end;
1286                         return (end);
1287                 }
1288         }
1289
1290         if ((sc->flags & MMCSD_INAND_CMD38) != 0) {
1291                 err = mmc_switch(mmcbus, dev, sc->rca, EXT_CSD_CMD_SET_NORMAL,
1292                     EXT_CSD_INAND_CMD38, use_trim == true ?
1293                     EXT_CSD_INAND_CMD38_TRIM : EXT_CSD_INAND_CMD38_ERASE,
1294                     sc->cmd6_time, true);
1295                 if (err != MMC_ERR_NONE) {
1296                         device_printf(dev,
1297                             "Setting iNAND erase command failed %s\n",
1298                             mmcsd_errmsg(err));
1299                         return (block);
1300                 }
1301         }
1302
1303         /*
1304          * Pause re-tuning so it won't interfere with the order of erase
1305          * commands.  Note that these latter don't use the data lines, so
1306          * re-tuning shouldn't actually become necessary during erase.
1307          */
1308         MMCBUS_RETUNE_PAUSE(mmcbus, dev, false);
1309         /* Set erase start position. */
1310         memset(&req, 0, sizeof(req));
1311         memset(&cmd, 0, sizeof(cmd));
1312         cmd.mrq = &req;
1313         req.cmd = &cmd;
1314         if (sc->mode == mode_sd)
1315                 cmd.opcode = SD_ERASE_WR_BLK_START;
1316         else
1317                 cmd.opcode = MMC_ERASE_GROUP_START;
1318         cmd.arg = start;
1319         if (sc->high_cap == 0)
1320                 cmd.arg <<= 9;
1321         cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1322         MMCBUS_WAIT_FOR_REQUEST(mmcbus, dev, &req);
1323         if (req.cmd->error != MMC_ERR_NONE) {
1324                 device_printf(dev, "Setting erase start position failed %s\n",
1325                     mmcsd_errmsg(req.cmd->error));
1326                 block = bp->bio_pblkno;
1327                 goto unpause;
1328         }
1329         /* Set erase stop position. */
1330         memset(&req, 0, sizeof(req));
1331         memset(&cmd, 0, sizeof(cmd));
1332         req.cmd = &cmd;
1333         if (sc->mode == mode_sd)
1334                 cmd.opcode = SD_ERASE_WR_BLK_END;
1335         else
1336                 cmd.opcode = MMC_ERASE_GROUP_END;
1337         cmd.arg = stop;
1338         if (sc->high_cap == 0)
1339                 cmd.arg <<= 9;
1340         cmd.arg--;
1341         cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1342         MMCBUS_WAIT_FOR_REQUEST(mmcbus, dev, &req);
1343         if (req.cmd->error != MMC_ERR_NONE) {
1344                 device_printf(dev, "Setting erase stop position failed %s\n",
1345                     mmcsd_errmsg(req.cmd->error));
1346                 block = bp->bio_pblkno;
1347                 goto unpause;
1348         }
1349         /* Erase range. */
1350         memset(&req, 0, sizeof(req));
1351         memset(&cmd, 0, sizeof(cmd));
1352         req.cmd = &cmd;
1353         cmd.opcode = MMC_ERASE;
1354         cmd.arg = use_trim == true ? MMC_ERASE_TRIM : MMC_ERASE_ERASE;
1355         cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
1356         MMCBUS_WAIT_FOR_REQUEST(mmcbus, dev, &req);
1357         if (req.cmd->error != MMC_ERR_NONE) {
1358                 device_printf(dev, "Issuing erase command failed %s\n",
1359                     mmcsd_errmsg(req.cmd->error));
1360                 block = bp->bio_pblkno;
1361                 goto unpause;
1362         }
1363         if (use_trim == false) {
1364                 /* Store one of the remaining parts for the next call. */
1365                 if (bp->bio_pblkno >= part->eblock || block == start) {
1366                         part->eblock = stop;    /* Predict next forward. */
1367                         part->eend = end;
1368                 } else {
1369                         part->eblock = block;   /* Predict next backward. */
1370                         part->eend = start;
1371                 }
1372         }
1373         block = end;
1374 unpause:
1375         MMCBUS_RETUNE_UNPAUSE(mmcbus, dev);
1376         return (block);
1377 }
1378
1379 static int
1380 mmcsd_dump(void *arg, void *virtual, vm_offset_t physical, off_t offset,
1381     size_t length)
1382 {
1383         struct bio bp;
1384         daddr_t block, end;
1385         struct disk *disk;
1386         struct mmcsd_softc *sc;
1387         struct mmcsd_part *part;
1388         device_t dev, mmcbus;
1389         int err;
1390
1391         disk = arg;
1392         part = disk->d_drv1;
1393         sc = part->sc;
1394
1395         /* length zero is special and really means flush buffers to media */
1396         if (length == 0) {
1397                 err = mmcsd_flush_cache(sc);
1398                 if (err != MMC_ERR_NONE)
1399                         return (EIO);
1400                 return (0);
1401         }
1402
1403         dev = sc->dev;
1404         mmcbus = sc->mmcbus;
1405
1406         g_reset_bio(&bp);
1407         bp.bio_disk = disk;
1408         bp.bio_pblkno = offset / disk->d_sectorsize;
1409         bp.bio_bcount = length;
1410         bp.bio_data = virtual;
1411         bp.bio_cmd = BIO_WRITE;
1412         end = bp.bio_pblkno + bp.bio_bcount / disk->d_sectorsize;
1413         MMCBUS_ACQUIRE_BUS(mmcbus, dev);
1414         err = mmcsd_switch_part(mmcbus, dev, sc->rca, part->type);
1415         if (err != MMC_ERR_NONE) {
1416                 if (ppsratecheck(&sc->log_time, &sc->log_count, LOG_PPS))
1417                         device_printf(dev, "Partition switch error\n");
1418                 MMCBUS_RELEASE_BUS(mmcbus, dev);
1419                 return (EIO);
1420         }
1421         block = mmcsd_rw(part, &bp);
1422         MMCBUS_RELEASE_BUS(mmcbus, dev);
1423         return ((end < block) ? EIO : 0);
1424 }
1425
1426 static void
1427 mmcsd_task(void *arg)
1428 {
1429         daddr_t block, end;
1430         struct mmcsd_part *part;
1431         struct mmcsd_softc *sc;
1432         struct bio *bp;
1433         device_t dev, mmcbus;
1434         int err, sz;
1435
1436         part = arg;
1437         sc = part->sc;
1438         dev = sc->dev;
1439         mmcbus = sc->mmcbus;
1440
1441         while (1) {
1442                 MMCSD_DISK_LOCK(part);
1443                 do {
1444                         if (part->running == 0)
1445                                 goto out;
1446                         bp = bioq_takefirst(&part->bio_queue);
1447                         if (bp == NULL)
1448                                 msleep(part, &part->disk_mtx, PRIBIO,
1449                                     "mmcsd disk jobqueue", 0);
1450                 } while (bp == NULL);
1451                 MMCSD_DISK_UNLOCK(part);
1452                 if (__predict_false(bp->bio_cmd == BIO_FLUSH)) {
1453                         if (mmcsd_flush_cache(sc) != MMC_ERR_NONE) {
1454                                 bp->bio_error = EIO;
1455                                 bp->bio_flags |= BIO_ERROR;
1456                         }
1457                         biodone(bp);
1458                         continue;
1459                 }
1460                 if (bp->bio_cmd != BIO_READ && part->ro) {
1461                         bp->bio_error = EROFS;
1462                         bp->bio_resid = bp->bio_bcount;
1463                         bp->bio_flags |= BIO_ERROR;
1464                         biodone(bp);
1465                         continue;
1466                 }
1467                 MMCBUS_ACQUIRE_BUS(mmcbus, dev);
1468                 sz = part->disk->d_sectorsize;
1469                 block = bp->bio_pblkno;
1470                 end = bp->bio_pblkno + (bp->bio_bcount / sz);
1471                 err = mmcsd_switch_part(mmcbus, dev, sc->rca, part->type);
1472                 if (err != MMC_ERR_NONE) {
1473                         if (ppsratecheck(&sc->log_time, &sc->log_count,
1474                             LOG_PPS))
1475                                 device_printf(dev, "Partition switch error\n");
1476                         goto release;
1477                 }
1478                 if (bp->bio_cmd == BIO_READ || bp->bio_cmd == BIO_WRITE) {
1479                         /* Access to the remaining erase block obsoletes it. */
1480                         if (block < part->eend && end > part->eblock)
1481                                 part->eblock = part->eend = 0;
1482                         block = mmcsd_rw(part, bp);
1483                 } else if (bp->bio_cmd == BIO_DELETE) {
1484                         block = mmcsd_delete(part, bp);
1485                 }
1486 release:
1487                 MMCBUS_RELEASE_BUS(mmcbus, dev);
1488                 if (block < end) {
1489                         bp->bio_error = EIO;
1490                         bp->bio_resid = (end - block) * sz;
1491                         bp->bio_flags |= BIO_ERROR;
1492                 } else {
1493                         bp->bio_resid = 0;
1494                 }
1495                 biodone(bp);
1496         }
1497 out:
1498         /* tell parent we're done */
1499         part->running = -1;
1500         MMCSD_DISK_UNLOCK(part);
1501         wakeup(part);
1502
1503         kproc_exit(0);
1504 }
1505
1506 static int
1507 mmcsd_bus_bit_width(device_t dev)
1508 {
1509
1510         if (mmc_get_bus_width(dev) == bus_width_1)
1511                 return (1);
1512         if (mmc_get_bus_width(dev) == bus_width_4)
1513                 return (4);
1514         return (8);
1515 }
1516
1517 static int
1518 mmcsd_flush_cache(struct mmcsd_softc *sc)
1519 {
1520         device_t dev, mmcbus;
1521         int err;
1522
1523         if ((sc->flags & MMCSD_FLUSH_CACHE) == 0)
1524                 return (MMC_ERR_NONE);
1525
1526         dev = sc->dev;
1527         mmcbus = sc->mmcbus;
1528         MMCBUS_ACQUIRE_BUS(mmcbus, dev);
1529         if ((sc->flags & MMCSD_DIRTY) == 0) {
1530                 MMCBUS_RELEASE_BUS(mmcbus, dev);
1531                 return (MMC_ERR_NONE);
1532         }
1533         err = mmc_switch(mmcbus, dev, sc->rca, EXT_CSD_CMD_SET_NORMAL,
1534             EXT_CSD_FLUSH_CACHE, EXT_CSD_FLUSH_CACHE_FLUSH, 60 * 1000, true);
1535         if (err == MMC_ERR_NONE)
1536                 sc->flags &= ~MMCSD_DIRTY;
1537         MMCBUS_RELEASE_BUS(mmcbus, dev);
1538         return (err);
1539 }
1540
1541 static device_method_t mmcsd_methods[] = {
1542         DEVMETHOD(device_probe, mmcsd_probe),
1543         DEVMETHOD(device_attach, mmcsd_attach),
1544         DEVMETHOD(device_detach, mmcsd_detach),
1545         DEVMETHOD(device_shutdown, mmcsd_shutdown),
1546         DEVMETHOD(device_suspend, mmcsd_suspend),
1547         DEVMETHOD(device_resume, mmcsd_resume),
1548         DEVMETHOD_END
1549 };
1550
1551 static driver_t mmcsd_driver = {
1552         "mmcsd",
1553         mmcsd_methods,
1554         sizeof(struct mmcsd_softc),
1555 };
1556 static devclass_t mmcsd_devclass;
1557
1558 static int
1559 mmcsd_handler(module_t mod __unused, int what, void *arg __unused)
1560 {
1561
1562         switch (what) {
1563         case MOD_LOAD:
1564                 flash_register_slicer(mmcsd_slicer, FLASH_SLICES_TYPE_MMC,
1565                     TRUE);
1566                 return (0);
1567         case MOD_UNLOAD:
1568                 flash_register_slicer(NULL, FLASH_SLICES_TYPE_MMC, TRUE);
1569                 return (0);
1570         }
1571         return (0);
1572 }
1573
1574 DRIVER_MODULE(mmcsd, mmc, mmcsd_driver, mmcsd_devclass, mmcsd_handler, NULL);
1575 MODULE_DEPEND(mmcsd, g_flashmap, 0, 0, 0);
1576 MMC_DEPEND(mmcsd);