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
18static 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
135static 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
153static 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
178static 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
189static 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(device: np, compatible)) {
196 of_node_put(node: np);
197 return true;
198 }
199 }
200
201 return false;
202}
203
204static 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, compatible: 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}
244

source code of linux/drivers/mmc/core/quirks.h