drivers/mmc/core/quirks.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  *  This file contains work-arounds for many known SD/MMC
   4  *  and SDIO hardware bugs.
   5  *
   6  *  Copyright (c) 2011 Andrei Warkentin <andreiw@motorola.com>
   7  *  Copyright (c) 2011 Pierre Tardy <tardyp@gmail.com>
   8  *  Inspired from pci fixup code:
   9  *  Copyright (c) 1999 Martin Mares <mj@ucw.cz>
  10  *
  11  */
  12
  13 #include <linux/of.h>
  14 #include <linux/mmc/sdio_ids.h>
  15
  16 #include "card.h"
  17
  18 static const struct mmc_fixup __maybe_unused mmc_blk_fixups[] = {
  19 #define INAND_CMD38_ARG_EXT_CSD  113
  20 #define INAND_CMD38_ARG_ERASE    0x00
  21 #define INAND_CMD38_ARG_TRIM     0x01
  22 #define INAND_CMD38_ARG_SECERASE 0x80
  23 #define INAND_CMD38_ARG_SECTRIM1 0x81
  24 #define INAND_CMD38_ARG_SECTRIM2 0x88
  25         /* CMD38 argument is passed through EXT_CSD[113] */
  26         MMC_FIXUP("SEM02G", CID_MANFID_SANDISK, 0x100, add_quirk,
  27                   MMC_QUIRK_INAND_CMD38),
  28         MMC_FIXUP("SEM04G", CID_MANFID_SANDISK, 0x100, add_quirk,
  29                   MMC_QUIRK_INAND_CMD38),
  30         MMC_FIXUP("SEM08G", CID_MANFID_SANDISK, 0x100, add_quirk,
  31                   MMC_QUIRK_INAND_CMD38),
  32         MMC_FIXUP("SEM16G", CID_MANFID_SANDISK, 0x100, add_quirk,
  33                   MMC_QUIRK_INAND_CMD38),
  34         MMC_FIXUP("SEM32G", CID_MANFID_SANDISK, 0x100, add_quirk,
  35                   MMC_QUIRK_INAND_CMD38),
  36
  37         /*
  38          * Some MMC cards experience performance degradation with CMD23
  39          * instead of CMD12-bounded multiblock transfers. For now we'll
  40          * black list what's bad...
  41          * - Certain Toshiba cards.
  42          *
  43          * N.B. This doesn't affect SD cards.
  44          */
  45         MMC_FIXUP("SDMB-32", CID_MANFID_SANDISK, CID_OEMID_ANY, add_quirk_mmc,
  46                   MMC_QUIRK_BLK_NO_CMD23),
  47         MMC_FIXUP("SDM032", CID_MANFID_SANDISK, CID_OEMID_ANY, add_quirk_mmc,
  48                   MMC_QUIRK_BLK_NO_CMD23),
  49         MMC_FIXUP("MMC08G", CID_MANFID_TOSHIBA, CID_OEMID_ANY, add_quirk_mmc,
  50                   MMC_QUIRK_BLK_NO_CMD23),
  51         MMC_FIXUP("MMC16G", CID_MANFID_TOSHIBA, CID_OEMID_ANY, add_quirk_mmc,
  52                   MMC_QUIRK_BLK_NO_CMD23),
  53         MMC_FIXUP("MMC32G", CID_MANFID_TOSHIBA, CID_OEMID_ANY, add_quirk_mmc,
  54                   MMC_QUIRK_BLK_NO_CMD23),
  55
  56         /*
  57          * Kingston Canvas Go! Plus microSD cards never finish SD cache flush.
  58          * This has so far only been observed on cards from 11/2019, while new
  59          * cards from 2023/05 do not exhibit this behavior.
  60          */
  61         _FIXUP_EXT("SD64G", CID_MANFID_KINGSTON_SD, 0x5449, 2019, 11,
  62                    0, -1ull, SDIO_ANY_ID, SDIO_ANY_ID, add_quirk_sd,
  63                    MMC_QUIRK_BROKEN_SD_CACHE, EXT_CSD_REV_ANY),
  64
  65         /*
  66          * Some SD cards lockup while using CMD23 multiblock transfers.
  67          */
  68         MMC_FIXUP("AF SD", CID_MANFID_ATP, CID_OEMID_ANY, add_quirk_sd,
  69                   MMC_QUIRK_BLK_NO_CMD23),
  70         MMC_FIXUP("APUSD", CID_MANFID_APACER, 0x5048, add_quirk_sd,
  71                   MMC_QUIRK_BLK_NO_CMD23),
  72
  73         /*
  74          * Some MMC cards need longer data read timeout than indicated in CSD.
  75          */
  76         MMC_FIXUP(CID_NAME_ANY, CID_MANFID_MICRON, 0x200, add_quirk_mmc,
  77                   MMC_QUIRK_LONG_READ_TIME),
  78         MMC_FIXUP("008GE0", CID_MANFID_TOSHIBA, CID_OEMID_ANY, add_quirk_mmc,
  79                   MMC_QUIRK_LONG_READ_TIME),
  80
  81         /*
  82          * On these Samsung MoviNAND parts, performing secure erase or
  83          * secure trim can result in unrecoverable corruption due to a
  84          * firmware bug.
  85          */
  86         MMC_FIXUP("M8G2FA", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
  87                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
  88         MMC_FIXUP("MAG4FA", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
  89                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
  90         MMC_FIXUP("MBG8FA", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
  91                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
  92         MMC_FIXUP("MCGAFA", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
  93                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
  94         MMC_FIXUP("VAL00M", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
  95                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
  96         MMC_FIXUP("VYL00M", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
  97                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
  98         MMC_FIXUP("KYL00M", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
  99                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
 100         MMC_FIXUP("VZL00M", CID_MANFID_SAMSUNG, CID_OEMID_ANY, add_quirk_mmc,
 101                   MMC_QUIRK_SEC_ERASE_TRIM_BROKEN),
 102
 103         /*
 104          *  On Some Kingston eMMCs, performing trim can result in
 105          *  unrecoverable data conrruption occasionally due to a firmware bug.
 106          */
 107         MMC_FIXUP("V10008", CID_MANFID_KINGSTON, CID_OEMID_ANY, add_quirk_mmc,
 108                   MMC_QUIRK_TRIM_BROKEN),
 109         MMC_FIXUP("V10016", CID_MANFID_KINGSTON, CID_OEMID_ANY, add_quirk_mmc,
 110                   MMC_QUIRK_TRIM_BROKEN),
 111
 112         /*
 113          * Micron MTFC4GACAJCN-1M advertises TRIM but it does not seems to
 114          * support being used to offload WRITE_ZEROES.
 115          */
 116         MMC_FIXUP("Q2J54A", CID_MANFID_MICRON, 0x014e, add_quirk_mmc,
 117                   MMC_QUIRK_TRIM_BROKEN),
 118
 119         /*
 120          * Kingston EMMC04G-M627 advertises TRIM but it does not seems to
 121          * support being used to offload WRITE_ZEROES.
 122          */
 123         MMC_FIXUP("M62704", CID_MANFID_KINGSTON, 0x0100, add_quirk_mmc,
 124                   MMC_QUIRK_TRIM_BROKEN),
 125
 126         /*
 127          * Some SD cards reports discard support while they don't
 128          */
 129         MMC_FIXUP(CID_NAME_ANY, CID_MANFID_SANDISK_SD, 0x5344, add_quirk_sd,
 130                   MMC_QUIRK_BROKEN_SD_DISCARD),
 131
 132         END_FIXUP
 133 };
 134
 135 static const struct mmc_fixup __maybe_unused mmc_ext_csd_fixups[] = {
 136         /*
 137          * Certain Hynix eMMC 4.41 cards might get broken when HPI feature
 138          * is used so disable the HPI feature for such buggy cards.
 139          */
 140         MMC_FIXUP_EXT_CSD_REV(CID_NAME_ANY, CID_MANFID_HYNIX,
 141                               0x014a, add_quirk, MMC_QUIRK_BROKEN_HPI, 5),
 142         /*
 143          * Certain Micron (Numonyx) eMMC 4.5 cards might get broken when HPI
 144          * feature is used so disable the HPI feature for such buggy cards.
 145          */
 146         MMC_FIXUP_EXT_CSD_REV(CID_NAME_ANY, CID_MANFID_NUMONYX,
 147                               0x014e, add_quirk, MMC_QUIRK_BROKEN_HPI, 6),
 148
 149         END_FIXUP
 150 };
 151
 152
 153 static const struct mmc_fixup __maybe_unused sdio_fixup_methods[] = {
 154         SDIO_FIXUP(SDIO_VENDOR_ID_TI_WL1251, SDIO_DEVICE_ID_TI_WL1251,
 155                    add_quirk, MMC_QUIRK_NONSTD_FUNC_IF),
 156
 157         SDIO_FIXUP(SDIO_VENDOR_ID_TI_WL1251, SDIO_DEVICE_ID_TI_WL1251,
 158                    add_quirk, MMC_QUIRK_DISABLE_CD),
 159
 160         SDIO_FIXUP(SDIO_VENDOR_ID_TI, SDIO_DEVICE_ID_TI_WL1271,
 161                    add_quirk, MMC_QUIRK_NONSTD_FUNC_IF),
 162
 163         SDIO_FIXUP(SDIO_VENDOR_ID_TI, SDIO_DEVICE_ID_TI_WL1271,
 164                    add_quirk, MMC_QUIRK_DISABLE_CD),
 165
 166         SDIO_FIXUP(SDIO_VENDOR_ID_STE, SDIO_DEVICE_ID_STE_CW1200,
 167                    add_quirk, MMC_QUIRK_BROKEN_BYTE_MODE_512),
 168
 169         SDIO_FIXUP(SDIO_VENDOR_ID_MARVELL, SDIO_DEVICE_ID_MARVELL_8797_F0,
 170                    add_quirk, MMC_QUIRK_BROKEN_IRQ_POLLING),
 171
 172         SDIO_FIXUP(SDIO_VENDOR_ID_MARVELL, SDIO_DEVICE_ID_MARVELL_8887_F0,
 173                    add_limit_rate_quirk, 150000000),
 174
 175         END_FIXUP
 176 };
 177
 178 static const struct mmc_fixup __maybe_unused sdio_card_init_methods[] = {
 179         SDIO_FIXUP_COMPATIBLE("ti,wl1251", wl1251_quirk, 0),
 180
 181         SDIO_FIXUP_COMPATIBLE("silabs,wf200", add_quirk,
 182                               MMC_QUIRK_BROKEN_BYTE_MODE_512 |
 183                               MMC_QUIRK_LENIENT_FN0 |
 184                               MMC_QUIRK_BLKSZ_FOR_BYTE_MODE),
 185
 186         END_FIXUP
 187 };
 188
 189 static inline bool mmc_fixup_of_compatible_match(struct mmc_card *card,
 190                                                  const char *compatible)
 191 {
 192         struct device_node *np;
 193
 194         for_each_child_of_node(mmc_dev(card->host)->of_node, np) {
 195                 if (of_device_is_compatible(np, compatible)) {
 196                         of_node_put(np);
 197                         return true;
 198                 }
 199         }
 200
 201         return false;
 202 }
 203
 204 static inline void mmc_fixup_device(struct mmc_card *card,
 205                                     const struct mmc_fixup *table)
 206 {
 207         const struct mmc_fixup *f;
 208         u64 rev = cid_rev_card(card);
 209
 210         for (f = table; f->vendor_fixup; f++) {
 211                 if (f->manfid != CID_MANFID_ANY &&
 212                     f->manfid != card->cid.manfid)
 213                         continue;
 214                 if (f->oemid != CID_OEMID_ANY &&
 215                     f->oemid != card->cid.oemid)
 216                         continue;
 217                 if (f->name != CID_NAME_ANY &&
 218                     strncmp(f->name, card->cid.prod_name,
 219                             sizeof(card->cid.prod_name)))
 220                         continue;
 221                 if (f->cis_vendor != (u16)SDIO_ANY_ID &&
 222                     f->cis_vendor != card->cis.vendor)
 223                         continue;
 224                 if (f->cis_device != (u16)SDIO_ANY_ID &&
 225                     f->cis_device != card->cis.device)
 226                         continue;
 227                 if (f->ext_csd_rev != EXT_CSD_REV_ANY &&
 228                     f->ext_csd_rev != card->ext_csd.rev)
 229                         continue;
 230                 if (rev < f->rev_start || rev > f->rev_end)
 231                         continue;
 232                 if (f->of_compatible &&
 233                     !mmc_fixup_of_compatible_match(card, f->of_compatible))
 234                         continue;
 235                 if (f->year != CID_YEAR_ANY && f->year != card->cid.year)
 236                         continue;
 237                 if (f->month != CID_MONTH_ANY && f->month != card->cid.month)
 238                         continue;
 239
 240                 dev_dbg(&card->dev, "calling %ps\n", f->vendor_fixup);
 241                 f->vendor_fixup(card, f->data);
 242         }
 243 }