blob: d42037f0f10d7bc7b61d39a8b8a7b716c85711fd [file] [log] [blame]
Thomas Gleixnerd2912cb2019-06-04 10:11:33 +02001// SPDX-License-Identifier: GPL-2.0-only
Linus Torvalds1da177e2005-04-16 15:20:36 -07002/*
Pierre Ossmanaaac1b42007-02-28 15:33:10 +01003 * linux/drivers/mmc/core/core.c
Linus Torvalds1da177e2005-04-16 15:20:36 -07004 *
5 * Copyright (C) 2003-2004 Russell King, All Rights Reserved.
Pierre Ossman5b4fd9a2005-09-06 15:18:56 -07006 * SD support Copyright (C) 2004 Ian Molton, All Rights Reserved.
Pierre Ossmanad3868b2008-06-28 12:52:45 +02007 * Copyright (C) 2005-2008 Pierre Ossman, All Rights Reserved.
Philip Langdalebce40a32006-10-21 12:35:02 +02008 * MMCv4 support Copyright (C) 2006 Philip Langdale, All Rights Reserved.
Linus Torvalds1da177e2005-04-16 15:20:36 -07009 */
Linus Torvalds1da177e2005-04-16 15:20:36 -070010#include <linux/module.h>
11#include <linux/init.h>
12#include <linux/interrupt.h>
13#include <linux/completion.h>
14#include <linux/device.h>
15#include <linux/delay.h>
16#include <linux/pagemap.h>
17#include <linux/err.h>
Pierre Ossmanaf8350c2007-09-24 07:15:48 +020018#include <linux/leds.h>
Pierre Ossmanb57c43a2005-09-06 15:18:53 -070019#include <linux/scatterlist.h>
Anton Vorontsov86e82862008-11-26 22:54:17 +030020#include <linux/log2.h>
Ohad Ben-Cohene5945732010-11-28 07:21:30 +020021#include <linux/pm_runtime.h>
Ulf Hanssonbbd43682013-09-20 11:02:35 +020022#include <linux/pm_wakeup.h>
Amerigo Wang35eb6db2011-07-25 17:13:11 -070023#include <linux/suspend.h>
Per Forlin1b676f72011-08-19 14:52:37 +020024#include <linux/fault-inject.h>
25#include <linux/random.h>
Jaehoon Chung950d56a2012-09-17 08:42:02 +000026#include <linux/slab.h>
Haijun Zhang6e9e3182013-08-26 09:19:22 +080027#include <linux/of.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070028
29#include <linux/mmc/card.h>
30#include <linux/mmc/host.h>
Pierre Ossmanda7fbe52006-12-24 22:46:55 +010031#include <linux/mmc/mmc.h>
32#include <linux/mmc/sd.h>
Adrian Hunter740a2212014-03-10 15:02:41 +020033#include <linux/mmc/slot-gpio.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070034
Baolin Wang7962fc32016-03-31 11:16:27 +080035#define CREATE_TRACE_POINTS
36#include <trace/events/mmc.h>
37
Pierre Ossmanaaac1b42007-02-28 15:33:10 +010038#include "core.h"
Ulf Hansson4facdde2017-01-13 14:14:14 +010039#include "card.h"
Pierre Ossmanffce2e72007-05-19 14:32:22 +020040#include "bus.h"
41#include "host.h"
Pierre Ossmane29a7d72007-05-26 13:48:18 +020042#include "sdio_bus.h"
Ulf Hansson3aa87932014-11-28 14:38:36 +010043#include "pwrseq.h"
Pierre Ossmanda7fbe52006-12-24 22:46:55 +010044
45#include "mmc_ops.h"
46#include "sd_ops.h"
Pierre Ossman5c4e6f12007-05-21 20:23:20 +020047#include "sdio_ops.h"
Linus Torvalds1da177e2005-04-16 15:20:36 -070048
Ulf Hansson12182af2016-07-27 00:04:03 +020049/* The max erase timeout, used when host->max_busy_timeout isn't specified */
50#define MMC_ERASE_TIMEOUT_MS (60 * 1000) /* 60 s */
Avri Altmanad9be7f2019-02-26 17:10:25 +020051#define SD_DISCARD_TIMEOUT_MS (250)
Ulf Hansson12182af2016-07-27 00:04:03 +020052
Ulf Hanssonfa550182012-05-09 16:15:26 +020053static const unsigned freqs[] = { 400000, 300000, 200000, 100000 };
Pierre Ossmanffce2e72007-05-19 14:32:22 +020054
55/*
David Brownellaf517152007-08-08 09:11:32 -070056 * Enabling software CRCs on the data blocks can be a significant (30%)
57 * performance cost, and for other reasons may not always be desired.
58 * So we allow it it to be disabled.
59 */
Rusty Russell90ab5ee2012-01-13 09:32:20 +103060bool use_spi_crc = 1;
David Brownellaf517152007-08-08 09:11:32 -070061module_param(use_spi_crc, bool, 0);
62
Pierre Ossmanffce2e72007-05-19 14:32:22 +020063static int mmc_schedule_delayed_work(struct delayed_work *work,
64 unsigned long delay)
65{
Ulf Hansson520bd7a2015-12-01 10:35:29 +010066 /*
67 * We use the system_freezable_wq, because of two reasons.
68 * First, it allows several works (not the same work item) to be
69 * executed simultaneously. Second, the queue becomes frozen when
70 * userspace becomes frozen during system PM.
71 */
72 return queue_delayed_work(system_freezable_wq, work, delay);
Pierre Ossmanffce2e72007-05-19 14:32:22 +020073}
74
Per Forlin1b676f72011-08-19 14:52:37 +020075#ifdef CONFIG_FAIL_MMC_REQUEST
76
77/*
78 * Internal function. Inject random data errors.
79 * If mmc_data is NULL no errors are injected.
80 */
81static void mmc_should_fail_request(struct mmc_host *host,
82 struct mmc_request *mrq)
83{
84 struct mmc_command *cmd = mrq->cmd;
85 struct mmc_data *data = mrq->data;
86 static const int data_errors[] = {
87 -ETIMEDOUT,
88 -EILSEQ,
89 -EIO,
90 };
91
92 if (!data)
93 return;
94
Ritesh Harjanie5723f92019-02-22 19:21:34 +053095 if ((cmd && cmd->error) || data->error ||
Per Forlin1b676f72011-08-19 14:52:37 +020096 !should_fail(&host->fail_mmc_request, data->blksz * data->blocks))
97 return;
98
Akinobu Mita2e744fc2013-04-29 16:21:31 -070099 data->error = data_errors[prandom_u32() % ARRAY_SIZE(data_errors)];
100 data->bytes_xfered = (prandom_u32() % (data->bytes_xfered >> 9)) << 9;
Per Forlin1b676f72011-08-19 14:52:37 +0200101}
102
103#else /* CONFIG_FAIL_MMC_REQUEST */
104
105static inline void mmc_should_fail_request(struct mmc_host *host,
106 struct mmc_request *mrq)
107{
108}
109
110#endif /* CONFIG_FAIL_MMC_REQUEST */
111
Adrian Hunter5163af52016-08-16 13:44:11 +0300112static inline void mmc_complete_cmd(struct mmc_request *mrq)
113{
114 if (mrq->cap_cmd_during_tfr && !completion_done(&mrq->cmd_completion))
115 complete_all(&mrq->cmd_completion);
116}
117
118void mmc_command_done(struct mmc_host *host, struct mmc_request *mrq)
119{
120 if (!mrq->cap_cmd_during_tfr)
121 return;
122
123 mmc_complete_cmd(mrq);
124
125 pr_debug("%s: cmd done, tfr ongoing (CMD%u)\n",
126 mmc_hostname(host), mrq->cmd->opcode);
127}
128EXPORT_SYMBOL(mmc_command_done);
129
Linus Torvalds1da177e2005-04-16 15:20:36 -0700130/**
Russell Kingfe10c6a2006-05-04 13:51:45 +0100131 * mmc_request_done - finish processing an MMC request
132 * @host: MMC host which completed request
133 * @mrq: MMC request which request
Linus Torvalds1da177e2005-04-16 15:20:36 -0700134 *
135 * MMC drivers should call this function when they have completed
Russell Kingfe10c6a2006-05-04 13:51:45 +0100136 * their processing of a request.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700137 */
138void mmc_request_done(struct mmc_host *host, struct mmc_request *mrq)
139{
140 struct mmc_command *cmd = mrq->cmd;
Russell King920e70c2006-05-04 18:22:51 +0100141 int err = cmd->error;
142
Adrian Hunterbd11e8b2015-05-07 13:10:22 +0300143 /* Flag re-tuning needed on CRC errors */
Douglas Anderson0a55f4a2019-06-17 10:56:50 -0700144 if (cmd->opcode != MMC_SEND_TUNING_BLOCK &&
145 cmd->opcode != MMC_SEND_TUNING_BLOCK_HS200 &&
146 !host->retune_crc_disable &&
Chaotian Jing031277d2015-09-30 17:37:18 +0800147 (err == -EILSEQ || (mrq->sbc && mrq->sbc->error == -EILSEQ) ||
Adrian Hunterbd11e8b2015-05-07 13:10:22 +0300148 (mrq->data && mrq->data->error == -EILSEQ) ||
Chaotian Jing031277d2015-09-30 17:37:18 +0800149 (mrq->stop && mrq->stop->error == -EILSEQ)))
Adrian Hunterbd11e8b2015-05-07 13:10:22 +0300150 mmc_retune_needed(host);
151
David Brownellaf517152007-08-08 09:11:32 -0700152 if (err && cmd->retries && mmc_host_is_spi(host)) {
153 if (cmd->resp[0] & R1_SPI_ILLEGAL_COMMAND)
154 cmd->retries = 0;
155 }
156
Adrian Hunter5163af52016-08-16 13:44:11 +0300157 if (host->ongoing_mrq == mrq)
158 host->ongoing_mrq = NULL;
159
160 mmc_complete_cmd(mrq);
161
Baolin Wang7962fc32016-03-31 11:16:27 +0800162 trace_mmc_request_done(host, mrq);
163
Linus Walleij67b83602017-03-28 10:40:31 +0200164 /*
165 * We list various conditions for the command to be considered
166 * properly done:
167 *
168 * - There was no error, OK fine then
169 * - We are not doing some kind of retry
170 * - The card was removed (...so just complete everything no matter
171 * if there are errors or retries)
172 */
173 if (!err || !cmd->retries || mmc_card_removed(host->card)) {
Per Forlin1b676f72011-08-19 14:52:37 +0200174 mmc_should_fail_request(host, mrq);
175
Adrian Hunter5163af52016-08-16 13:44:11 +0300176 if (!host->ongoing_mrq)
177 led_trigger_event(host->led, LED_OFF);
Pierre Ossmanaf8350c2007-09-24 07:15:48 +0200178
Andrew Gabbasovfc75b702014-10-01 07:14:10 -0500179 if (mrq->sbc) {
180 pr_debug("%s: req done <CMD%u>: %d: %08x %08x %08x %08x\n",
181 mmc_hostname(host), mrq->sbc->opcode,
182 mrq->sbc->error,
183 mrq->sbc->resp[0], mrq->sbc->resp[1],
184 mrq->sbc->resp[2], mrq->sbc->resp[3]);
185 }
186
Pierre Ossmane4d21702007-07-24 21:46:49 +0200187 pr_debug("%s: req done (CMD%u): %d: %08x %08x %08x %08x\n",
188 mmc_hostname(host), cmd->opcode, err,
189 cmd->resp[0], cmd->resp[1],
190 cmd->resp[2], cmd->resp[3]);
191
192 if (mrq->data) {
193 pr_debug("%s: %d bytes transferred: %d\n",
194 mmc_hostname(host),
195 mrq->data->bytes_xfered, mrq->data->error);
196 }
197
198 if (mrq->stop) {
199 pr_debug("%s: (CMD%u): %d: %08x %08x %08x %08x\n",
200 mmc_hostname(host), mrq->stop->opcode,
201 mrq->stop->error,
202 mrq->stop->resp[0], mrq->stop->resp[1],
203 mrq->stop->resp[2], mrq->stop->resp[3]);
204 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700205 }
Linus Walleij67b83602017-03-28 10:40:31 +0200206 /*
207 * Request starter must handle retries - see
208 * mmc_wait_for_req_done().
209 */
210 if (mrq->done)
211 mrq->done(mrq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700212}
213
214EXPORT_SYMBOL(mmc_request_done);
215
Adrian Hunter90a81482015-05-07 13:10:14 +0300216static void __mmc_start_request(struct mmc_host *host, struct mmc_request *mrq)
217{
218 int err;
219
220 /* Assumes host controller has been runtime resumed by mmc_claim_host */
221 err = mmc_retune(host);
222 if (err) {
223 mrq->cmd->error = err;
224 mmc_request_done(host, mrq);
225 return;
226 }
227
Hans de Goede5d3f6ef2015-09-22 17:30:25 +0200228 /*
229 * For sdio rw commands we must wait for card busy otherwise some
230 * sdio devices won't work properly.
jiajie.hao@mediatek.comf328c762017-04-23 17:38:27 +0800231 * And bypass I/O abort, reset and bus suspend operations.
Hans de Goede5d3f6ef2015-09-22 17:30:25 +0200232 */
jiajie.hao@mediatek.comf328c762017-04-23 17:38:27 +0800233 if (sdio_is_io_busy(mrq->cmd->opcode, mrq->cmd->arg) &&
234 host->ops->card_busy) {
Hans de Goede5d3f6ef2015-09-22 17:30:25 +0200235 int tries = 500; /* Wait aprox 500ms at maximum */
236
237 while (host->ops->card_busy(host) && --tries)
238 mmc_delay(1);
239
240 if (tries == 0) {
241 mrq->cmd->error = -EBUSY;
242 mmc_request_done(host, mrq);
243 return;
244 }
245 }
246
Adrian Hunter5163af52016-08-16 13:44:11 +0300247 if (mrq->cap_cmd_during_tfr) {
248 host->ongoing_mrq = mrq;
249 /*
250 * Retry path could come through here without having waiting on
251 * cmd_completion, so ensure it is reinitialised.
252 */
253 reinit_completion(&mrq->cmd_completion);
254 }
255
Baolin Wang7962fc32016-03-31 11:16:27 +0800256 trace_mmc_request_start(host, mrq);
257
Adrian Hunter3e207c82017-08-10 15:08:09 +0300258 if (host->cqe_on)
259 host->cqe_ops->cqe_off(host);
260
Adrian Hunter90a81482015-05-07 13:10:14 +0300261 host->ops->request(host, mrq);
262}
263
Adrian Hunter72a5af52017-09-22 15:36:52 +0300264static void mmc_mrq_pr_debug(struct mmc_host *host, struct mmc_request *mrq,
265 bool cqe)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700266{
Jaehoon Chung7b2fd4f2012-02-07 14:13:10 +0900267 if (mrq->sbc) {
268 pr_debug("<%s: starting CMD%u arg %08x flags %08x>\n",
269 mmc_hostname(host), mrq->sbc->opcode,
270 mrq->sbc->arg, mrq->sbc->flags);
271 }
272
Adrian Hunter4b67e632017-03-13 14:36:42 +0200273 if (mrq->cmd) {
Adrian Hunter72a5af52017-09-22 15:36:52 +0300274 pr_debug("%s: starting %sCMD%u arg %08x flags %08x\n",
275 mmc_hostname(host), cqe ? "CQE direct " : "",
276 mrq->cmd->opcode, mrq->cmd->arg, mrq->cmd->flags);
277 } else if (cqe) {
278 pr_debug("%s: starting CQE transfer for tag %d blkaddr %u\n",
279 mmc_hostname(host), mrq->tag, mrq->data->blk_addr);
Adrian Hunter4b67e632017-03-13 14:36:42 +0200280 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700281
Pierre Ossmane4d21702007-07-24 21:46:49 +0200282 if (mrq->data) {
283 pr_debug("%s: blksz %d blocks %d flags %08x "
284 "tsac %d ms nsac %d\n",
285 mmc_hostname(host), mrq->data->blksz,
286 mrq->data->blocks, mrq->data->flags,
Pierre Ossmance252ed2007-08-07 14:06:18 +0200287 mrq->data->timeout_ns / 1000000,
Pierre Ossmane4d21702007-07-24 21:46:49 +0200288 mrq->data->timeout_clks);
289 }
290
291 if (mrq->stop) {
292 pr_debug("%s: CMD%u arg %08x flags %08x\n",
293 mmc_hostname(host), mrq->stop->opcode,
294 mrq->stop->arg, mrq->stop->flags);
295 }
Adrian Hunter4b67e632017-03-13 14:36:42 +0200296}
297
Adrian Hunterf34bdd22017-03-13 14:36:43 +0200298static int mmc_mrq_prep(struct mmc_host *host, struct mmc_request *mrq)
Adrian Hunter4b67e632017-03-13 14:36:42 +0200299{
Shawn Linb044b1b2017-07-19 15:55:45 +0800300 unsigned int i, sz = 0;
Adrian Hunter4b67e632017-03-13 14:36:42 +0200301 struct scatterlist *sg;
Adrian Hunter4b67e632017-03-13 14:36:42 +0200302
Adrian Hunterf34bdd22017-03-13 14:36:43 +0200303 if (mrq->cmd) {
304 mrq->cmd->error = 0;
305 mrq->cmd->mrq = mrq;
306 mrq->cmd->data = mrq->data;
307 }
Andrew Gabbasovcce411e2014-10-01 07:14:09 -0500308 if (mrq->sbc) {
309 mrq->sbc->error = 0;
310 mrq->sbc->mrq = mrq;
311 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700312 if (mrq->data) {
Shawn Lin6ff897f2016-11-02 15:26:16 +0800313 if (mrq->data->blksz > host->max_blk_size ||
314 mrq->data->blocks > host->max_blk_count ||
315 mrq->data->blocks * mrq->data->blksz > host->max_req_size)
316 return -EINVAL;
Shawn Linb044b1b2017-07-19 15:55:45 +0800317
Pierre Ossmana84756c52008-07-29 01:09:37 +0200318 for_each_sg(mrq->data->sg, sg, mrq->data->sg_len, i)
319 sz += sg->length;
Shawn Lin6ff897f2016-11-02 15:26:16 +0800320 if (sz != mrq->data->blocks * mrq->data->blksz)
321 return -EINVAL;
Shawn Linb044b1b2017-07-19 15:55:45 +0800322
Linus Torvalds1da177e2005-04-16 15:20:36 -0700323 mrq->data->error = 0;
324 mrq->data->mrq = mrq;
325 if (mrq->stop) {
326 mrq->data->stop = mrq->stop;
327 mrq->stop->error = 0;
328 mrq->stop->mrq = mrq;
329 }
330 }
Adrian Hunterf34bdd22017-03-13 14:36:43 +0200331
332 return 0;
333}
334
Adrian Huntercb39f612017-09-22 15:36:59 +0300335int mmc_start_request(struct mmc_host *host, struct mmc_request *mrq)
Adrian Hunterf34bdd22017-03-13 14:36:43 +0200336{
337 int err;
338
Adrian Hunterd2383312017-12-01 14:55:30 +0200339 init_completion(&mrq->cmd_completion);
340
Adrian Hunterf34bdd22017-03-13 14:36:43 +0200341 mmc_retune_hold(host);
342
343 if (mmc_card_removed(host->card))
344 return -ENOMEDIUM;
345
Adrian Hunter72a5af52017-09-22 15:36:52 +0300346 mmc_mrq_pr_debug(host, mrq, false);
Adrian Hunterf34bdd22017-03-13 14:36:43 +0200347
348 WARN_ON(!host->claimed);
349
350 err = mmc_mrq_prep(host, mrq);
351 if (err)
352 return err;
353
Pierre Tardy66c036e2011-02-06 19:02:48 +0100354 led_trigger_event(host->led, LED_FULL);
Adrian Hunter90a81482015-05-07 13:10:14 +0300355 __mmc_start_request(host, mrq);
Adrian Hunterf100c1c2014-12-05 19:41:02 +0200356
357 return 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700358}
Adrian Huntercb39f612017-09-22 15:36:59 +0300359EXPORT_SYMBOL(mmc_start_request);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700360
Linus Torvalds1da177e2005-04-16 15:20:36 -0700361static void mmc_wait_done(struct mmc_request *mrq)
362{
Per Forlinaa8b6832011-07-01 18:55:22 +0200363 complete(&mrq->completion);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700364}
365
Adrian Hunter5163af52016-08-16 13:44:11 +0300366static inline void mmc_wait_ongoing_tfr_cmd(struct mmc_host *host)
367{
368 struct mmc_request *ongoing_mrq = READ_ONCE(host->ongoing_mrq);
369
370 /*
371 * If there is an ongoing transfer, wait for the command line to become
372 * available.
373 */
374 if (ongoing_mrq && !completion_done(&ongoing_mrq->cmd_completion))
375 wait_for_completion(&ongoing_mrq->cmd_completion);
376}
377
Ulf Hansson956d9fd2012-03-05 15:52:43 +0100378static int __mmc_start_req(struct mmc_host *host, struct mmc_request *mrq)
Per Forlinaa8b6832011-07-01 18:55:22 +0200379{
Adrian Hunterf100c1c2014-12-05 19:41:02 +0200380 int err;
381
Adrian Hunter5163af52016-08-16 13:44:11 +0300382 mmc_wait_ongoing_tfr_cmd(host);
383
Per Forlinaa8b6832011-07-01 18:55:22 +0200384 init_completion(&mrq->completion);
385 mrq->done = mmc_wait_done;
Adrian Hunterf100c1c2014-12-05 19:41:02 +0200386
387 err = mmc_start_request(host, mrq);
388 if (err) {
389 mrq->cmd->error = err;
Adrian Hunter5163af52016-08-16 13:44:11 +0300390 mmc_complete_cmd(mrq);
Adrian Hunterd3049502011-11-28 16:22:00 +0200391 complete(&mrq->completion);
Adrian Hunterd3049502011-11-28 16:22:00 +0200392 }
Adrian Hunterf100c1c2014-12-05 19:41:02 +0200393
394 return err;
Per Forlinaa8b6832011-07-01 18:55:22 +0200395}
396
Adrian Hunter5163af52016-08-16 13:44:11 +0300397void mmc_wait_for_req_done(struct mmc_host *host, struct mmc_request *mrq)
Per Forlinaa8b6832011-07-01 18:55:22 +0200398{
Adrian Hunter08a7e1d2011-10-03 15:33:33 +0300399 struct mmc_command *cmd;
400
401 while (1) {
402 wait_for_completion(&mrq->completion);
403
404 cmd = mrq->cmd;
Maya Erez775a9362013-04-18 15:41:55 +0300405
Adrian Hunterd3049502011-11-28 16:22:00 +0200406 if (!cmd->error || !cmd->retries ||
407 mmc_card_removed(host->card))
Adrian Hunter08a7e1d2011-10-03 15:33:33 +0300408 break;
409
Adrian Hunter90a81482015-05-07 13:10:14 +0300410 mmc_retune_recheck(host);
411
Adrian Hunter08a7e1d2011-10-03 15:33:33 +0300412 pr_debug("%s: req failed (CMD%u): %d, retrying...\n",
413 mmc_hostname(host), cmd->opcode, cmd->error);
414 cmd->retries--;
415 cmd->error = 0;
Adrian Hunter90a81482015-05-07 13:10:14 +0300416 __mmc_start_request(host, mrq);
Adrian Hunter08a7e1d2011-10-03 15:33:33 +0300417 }
Adrian Hunter90a81482015-05-07 13:10:14 +0300418
419 mmc_retune_release(host);
Per Forlinaa8b6832011-07-01 18:55:22 +0200420}
Adrian Hunter5163af52016-08-16 13:44:11 +0300421EXPORT_SYMBOL(mmc_wait_for_req_done);
422
Adrian Hunter72a5af52017-09-22 15:36:52 +0300423/*
424 * mmc_cqe_start_req - Start a CQE request.
425 * @host: MMC host to start the request
426 * @mrq: request to start
427 *
428 * Start the request, re-tuning if needed and it is possible. Returns an error
429 * code if the request fails to start or -EBUSY if CQE is busy.
430 */
431int mmc_cqe_start_req(struct mmc_host *host, struct mmc_request *mrq)
432{
433 int err;
434
435 /*
436 * CQE cannot process re-tuning commands. Caller must hold retuning
437 * while CQE is in use. Re-tuning can happen here only when CQE has no
438 * active requests i.e. this is the first. Note, re-tuning will call
439 * ->cqe_off().
440 */
441 err = mmc_retune(host);
442 if (err)
443 goto out_err;
444
445 mrq->host = host;
446
447 mmc_mrq_pr_debug(host, mrq, true);
448
449 err = mmc_mrq_prep(host, mrq);
450 if (err)
451 goto out_err;
452
453 err = host->cqe_ops->cqe_request(host, mrq);
454 if (err)
455 goto out_err;
456
457 trace_mmc_request_start(host, mrq);
458
459 return 0;
460
461out_err:
462 if (mrq->cmd) {
463 pr_debug("%s: failed to start CQE direct CMD%u, error %d\n",
464 mmc_hostname(host), mrq->cmd->opcode, err);
465 } else {
466 pr_debug("%s: failed to start CQE transfer for tag %d, error %d\n",
467 mmc_hostname(host), mrq->tag, err);
468 }
469 return err;
470}
471EXPORT_SYMBOL(mmc_cqe_start_req);
472
473/**
474 * mmc_cqe_request_done - CQE has finished processing an MMC request
475 * @host: MMC host which completed request
476 * @mrq: MMC request which completed
477 *
478 * CQE drivers should call this function when they have completed
479 * their processing of a request.
480 */
481void mmc_cqe_request_done(struct mmc_host *host, struct mmc_request *mrq)
482{
483 mmc_should_fail_request(host, mrq);
484
485 /* Flag re-tuning needed on CRC errors */
486 if ((mrq->cmd && mrq->cmd->error == -EILSEQ) ||
487 (mrq->data && mrq->data->error == -EILSEQ))
488 mmc_retune_needed(host);
489
490 trace_mmc_request_done(host, mrq);
491
492 if (mrq->cmd) {
493 pr_debug("%s: CQE req done (direct CMD%u): %d\n",
494 mmc_hostname(host), mrq->cmd->opcode, mrq->cmd->error);
495 } else {
496 pr_debug("%s: CQE transfer done tag %d\n",
497 mmc_hostname(host), mrq->tag);
498 }
499
500 if (mrq->data) {
501 pr_debug("%s: %d bytes transferred: %d\n",
502 mmc_hostname(host),
503 mrq->data->bytes_xfered, mrq->data->error);
504 }
505
506 mrq->done(mrq);
507}
508EXPORT_SYMBOL(mmc_cqe_request_done);
509
510/**
511 * mmc_cqe_post_req - CQE post process of a completed MMC request
512 * @host: MMC host
513 * @mrq: MMC request to be processed
514 */
515void mmc_cqe_post_req(struct mmc_host *host, struct mmc_request *mrq)
516{
517 if (host->cqe_ops->cqe_post_req)
518 host->cqe_ops->cqe_post_req(host, mrq);
519}
520EXPORT_SYMBOL(mmc_cqe_post_req);
521
522/* Arbitrary 1 second timeout */
523#define MMC_CQE_RECOVERY_TIMEOUT 1000
524
525/*
526 * mmc_cqe_recovery - Recover from CQE errors.
527 * @host: MMC host to recover
528 *
529 * Recovery consists of stopping CQE, stopping eMMC, discarding the queue in
530 * in eMMC, and discarding the queue in CQE. CQE must call
531 * mmc_cqe_request_done() on all requests. An error is returned if the eMMC
532 * fails to discard its queue.
533 */
534int mmc_cqe_recovery(struct mmc_host *host)
535{
536 struct mmc_command cmd;
537 int err;
538
539 mmc_retune_hold_now(host);
540
541 /*
542 * Recovery is expected seldom, if at all, but it reduces performance,
543 * so make sure it is not completely silent.
544 */
545 pr_warn("%s: running CQE recovery\n", mmc_hostname(host));
546
547 host->cqe_ops->cqe_recovery_start(host);
548
549 memset(&cmd, 0, sizeof(cmd));
550 cmd.opcode = MMC_STOP_TRANSMISSION,
551 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC,
552 cmd.flags &= ~MMC_RSP_CRC; /* Ignore CRC */
553 cmd.busy_timeout = MMC_CQE_RECOVERY_TIMEOUT,
554 mmc_wait_for_cmd(host, &cmd, 0);
555
556 memset(&cmd, 0, sizeof(cmd));
557 cmd.opcode = MMC_CMDQ_TASK_MGMT;
558 cmd.arg = 1; /* Discard entire queue */
559 cmd.flags = MMC_RSP_R1B | MMC_CMD_AC;
560 cmd.flags &= ~MMC_RSP_CRC; /* Ignore CRC */
561 cmd.busy_timeout = MMC_CQE_RECOVERY_TIMEOUT,
562 err = mmc_wait_for_cmd(host, &cmd, 0);
563
564 host->cqe_ops->cqe_recovery_finish(host);
565
566 mmc_retune_release(host);
567
568 return err;
569}
570EXPORT_SYMBOL(mmc_cqe_recovery);
571
Adrian Hunter5163af52016-08-16 13:44:11 +0300572/**
573 * mmc_is_req_done - Determine if a 'cap_cmd_during_tfr' request is done
574 * @host: MMC host
575 * @mrq: MMC request
576 *
577 * mmc_is_req_done() is used with requests that have
578 * mrq->cap_cmd_during_tfr = true. mmc_is_req_done() must be called after
579 * starting a request and before waiting for it to complete. That is,
580 * either in between calls to mmc_start_req(), or after mmc_wait_for_req()
581 * and before mmc_wait_for_req_done(). If it is called at other times the
582 * result is not meaningful.
583 */
584bool mmc_is_req_done(struct mmc_host *host, struct mmc_request *mrq)
585{
Adrian Hunter126b6272017-11-29 15:41:19 +0200586 return completion_done(&mrq->completion);
Adrian Hunter5163af52016-08-16 13:44:11 +0300587}
588EXPORT_SYMBOL(mmc_is_req_done);
Per Forlinaa8b6832011-07-01 18:55:22 +0200589
590/**
Pierre Ossman67a61c42007-07-11 20:22:11 +0200591 * mmc_wait_for_req - start a request and wait for completion
592 * @host: MMC host to start command
593 * @mrq: MMC request to start
594 *
595 * Start a new MMC custom command request for a host, and wait
Adrian Hunter5163af52016-08-16 13:44:11 +0300596 * for the command to complete. In the case of 'cap_cmd_during_tfr'
597 * requests, the transfer is ongoing and the caller can issue further
598 * commands that do not use the data lines, and then wait by calling
599 * mmc_wait_for_req_done().
600 * Does not attempt to parse the response.
Pierre Ossman67a61c42007-07-11 20:22:11 +0200601 */
602void mmc_wait_for_req(struct mmc_host *host, struct mmc_request *mrq)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700603{
Per Forlinaa8b6832011-07-01 18:55:22 +0200604 __mmc_start_req(host, mrq);
Adrian Hunter5163af52016-08-16 13:44:11 +0300605
606 if (!mrq->cap_cmd_during_tfr)
607 mmc_wait_for_req_done(host, mrq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700608}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700609EXPORT_SYMBOL(mmc_wait_for_req);
610
611/**
612 * mmc_wait_for_cmd - start a command and wait for completion
613 * @host: MMC host to start command
614 * @cmd: MMC command to start
615 * @retries: maximum number of retries
616 *
617 * Start a new MMC command for a host, and wait for the command
618 * to complete. Return any error that occurred while the command
619 * was executing. Do not attempt to parse the response.
620 */
621int mmc_wait_for_cmd(struct mmc_host *host, struct mmc_command *cmd, int retries)
622{
Masahiro Yamadac7836d12016-12-19 20:51:18 +0900623 struct mmc_request mrq = {};
Linus Torvalds1da177e2005-04-16 15:20:36 -0700624
Pierre Ossmand84075c82007-08-09 13:23:56 +0200625 WARN_ON(!host->claimed);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700626
Linus Torvalds1da177e2005-04-16 15:20:36 -0700627 memset(cmd->resp, 0, sizeof(cmd->resp));
628 cmd->retries = retries;
629
630 mrq.cmd = cmd;
631 cmd->data = NULL;
632
633 mmc_wait_for_req(host, &mrq);
634
635 return cmd->error;
636}
637
638EXPORT_SYMBOL(mmc_wait_for_cmd);
639
Pierre Ossman335eadf2005-09-06 15:18:50 -0700640/**
Russell Kingd773d722006-09-07 15:57:12 +0100641 * mmc_set_data_timeout - set the timeout for a data command
642 * @data: data phase for command
643 * @card: the MMC card associated with the data transfer
Pierre Ossman67a61c42007-07-11 20:22:11 +0200644 *
645 * Computes the data timeout parameters according to the
646 * correct algorithm given the card type.
Russell Kingd773d722006-09-07 15:57:12 +0100647 */
Pierre Ossmanb146d262007-07-24 19:16:54 +0200648void mmc_set_data_timeout(struct mmc_data *data, const struct mmc_card *card)
Russell Kingd773d722006-09-07 15:57:12 +0100649{
650 unsigned int mult;
651
652 /*
Pierre Ossmane6f918b2007-08-07 14:11:55 +0200653 * SDIO cards only define an upper 1 s limit on access.
654 */
655 if (mmc_card_sdio(card)) {
656 data->timeout_ns = 1000000000;
657 data->timeout_clks = 0;
658 return;
659 }
660
661 /*
Russell Kingd773d722006-09-07 15:57:12 +0100662 * SD cards use a 100 multiplier rather than 10
663 */
664 mult = mmc_card_sd(card) ? 100 : 10;
665
666 /*
667 * Scale up the multiplier (and therefore the timeout) by
668 * the r2w factor for writes.
669 */
Pierre Ossmanb146d262007-07-24 19:16:54 +0200670 if (data->flags & MMC_DATA_WRITE)
Russell Kingd773d722006-09-07 15:57:12 +0100671 mult <<= card->csd.r2w_factor;
672
Shawn Lin4406ae22017-08-02 11:12:42 +0800673 data->timeout_ns = card->csd.taac_ns * mult;
674 data->timeout_clks = card->csd.taac_clks * mult;
Russell Kingd773d722006-09-07 15:57:12 +0100675
676 /*
677 * SD cards also have an upper limit on the timeout.
678 */
679 if (mmc_card_sd(card)) {
680 unsigned int timeout_us, limit_us;
681
682 timeout_us = data->timeout_ns / 1000;
Ulf Hansson9eadcc052015-10-02 10:56:11 +0200683 if (card->host->ios.clock)
Linus Walleije9b86842011-01-05 00:44:32 +0100684 timeout_us += data->timeout_clks * 1000 /
Ulf Hansson9eadcc052015-10-02 10:56:11 +0200685 (card->host->ios.clock / 1000);
Russell Kingd773d722006-09-07 15:57:12 +0100686
Pierre Ossmanb146d262007-07-24 19:16:54 +0200687 if (data->flags & MMC_DATA_WRITE)
Pierre Ossman493890e2008-10-26 12:37:25 +0100688 /*
Paul Walmsley3bdc9ba2012-03-12 04:58:00 -0600689 * The MMC spec "It is strongly recommended
690 * for hosts to implement more than 500ms
691 * timeout value even if the card indicates
692 * the 250ms maximum busy length." Even the
693 * previous value of 300ms is known to be
694 * insufficient for some cards.
Pierre Ossman493890e2008-10-26 12:37:25 +0100695 */
Paul Walmsley3bdc9ba2012-03-12 04:58:00 -0600696 limit_us = 3000000;
Russell Kingd773d722006-09-07 15:57:12 +0100697 else
698 limit_us = 100000;
699
Philip Langdalefba68bd2007-01-04 06:57:32 -0800700 /*
701 * SDHC cards always use these fixed values.
702 */
Shawn Lin6ca29202017-08-07 10:07:14 +0800703 if (timeout_us > limit_us) {
Russell Kingd773d722006-09-07 15:57:12 +0100704 data->timeout_ns = limit_us * 1000;
705 data->timeout_clks = 0;
706 }
Stefan Wahrenf7bf11a2014-04-03 17:32:05 +0200707
708 /* assign limit value if invalid */
709 if (timeout_us == 0)
710 data->timeout_ns = limit_us * 1000;
Russell Kingd773d722006-09-07 15:57:12 +0100711 }
Stefan Nilsson XK6de5fc92011-11-03 09:44:12 +0100712
713 /*
714 * Some cards require longer data read timeout than indicated in CSD.
715 * Address this by setting the read timeout to a "reasonably high"
Matt Gumbel32ecd322016-05-20 10:33:46 +0300716 * value. For the cards tested, 600ms has proven enough. If necessary,
Stefan Nilsson XK6de5fc92011-11-03 09:44:12 +0100717 * this value can be increased if other problematic cards require this.
718 */
719 if (mmc_card_long_read_time(card) && data->flags & MMC_DATA_READ) {
Matt Gumbel32ecd322016-05-20 10:33:46 +0300720 data->timeout_ns = 600000000;
Stefan Nilsson XK6de5fc92011-11-03 09:44:12 +0100721 data->timeout_clks = 0;
722 }
723
Wolfgang Mueesc0c88872009-03-11 14:28:39 +0100724 /*
725 * Some cards need very high timeouts if driven in SPI mode.
726 * The worst observed timeout was 900ms after writing a
727 * continuous stream of data until the internal logic
728 * overflowed.
729 */
730 if (mmc_host_is_spi(card->host)) {
731 if (data->flags & MMC_DATA_WRITE) {
732 if (data->timeout_ns < 1000000000)
733 data->timeout_ns = 1000000000; /* 1s */
734 } else {
735 if (data->timeout_ns < 100000000)
736 data->timeout_ns = 100000000; /* 100ms */
737 }
738 }
Russell Kingd773d722006-09-07 15:57:12 +0100739}
740EXPORT_SYMBOL(mmc_set_data_timeout);
741
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300742/*
743 * Allow claiming an already claimed host if the context is the same or there is
744 * no context but the task is the same.
745 */
746static inline bool mmc_ctx_matches(struct mmc_host *host, struct mmc_ctx *ctx,
747 struct task_struct *task)
748{
749 return host->claimer == ctx ||
750 (!ctx && task && host->claimer->task == task);
751}
752
753static inline void mmc_ctx_set_claimer(struct mmc_host *host,
754 struct mmc_ctx *ctx,
755 struct task_struct *task)
756{
757 if (!host->claimer) {
758 if (ctx)
759 host->claimer = ctx;
760 else
761 host->claimer = &host->default_ctx;
762 }
763 if (task)
764 host->claimer->task = task;
765}
766
Pierre Ossmanad3868b2008-06-28 12:52:45 +0200767/**
Nicolas Pitre2342f332007-06-30 16:21:52 +0200768 * __mmc_claim_host - exclusively claim a host
Linus Torvalds1da177e2005-04-16 15:20:36 -0700769 * @host: mmc host to claim
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300770 * @ctx: context that claims the host or NULL in which case the default
771 * context will be used
Nicolas Pitre2342f332007-06-30 16:21:52 +0200772 * @abort: whether or not the operation should be aborted
Linus Torvalds1da177e2005-04-16 15:20:36 -0700773 *
Nicolas Pitre2342f332007-06-30 16:21:52 +0200774 * Claim a host for a set of operations. If @abort is non null and
775 * dereference a non-zero value then this will return prematurely with
776 * that non-zero value without acquiring the lock. Returns zero
777 * with the lock held otherwise.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700778 */
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300779int __mmc_claim_host(struct mmc_host *host, struct mmc_ctx *ctx,
780 atomic_t *abort)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700781{
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300782 struct task_struct *task = ctx ? NULL : current;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700783 DECLARE_WAITQUEUE(wait, current);
784 unsigned long flags;
Nicolas Pitre2342f332007-06-30 16:21:52 +0200785 int stop;
Ulf Hansson9250aea2015-03-27 12:15:15 +0100786 bool pm = false;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700787
Pierre Ossmancf795bf2007-07-11 20:28:02 +0200788 might_sleep();
789
Linus Torvalds1da177e2005-04-16 15:20:36 -0700790 add_wait_queue(&host->wq, &wait);
791 spin_lock_irqsave(&host->lock, flags);
792 while (1) {
793 set_current_state(TASK_UNINTERRUPTIBLE);
Nicolas Pitre2342f332007-06-30 16:21:52 +0200794 stop = abort ? atomic_read(abort) : 0;
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300795 if (stop || !host->claimed || mmc_ctx_matches(host, ctx, task))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700796 break;
797 spin_unlock_irqrestore(&host->lock, flags);
798 schedule();
799 spin_lock_irqsave(&host->lock, flags);
800 }
801 set_current_state(TASK_RUNNING);
Adrian Hunter319a3f12009-09-22 16:44:30 -0700802 if (!stop) {
Nicolas Pitre2342f332007-06-30 16:21:52 +0200803 host->claimed = 1;
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300804 mmc_ctx_set_claimer(host, ctx, task);
Adrian Hunter319a3f12009-09-22 16:44:30 -0700805 host->claim_cnt += 1;
Ulf Hansson9250aea2015-03-27 12:15:15 +0100806 if (host->claim_cnt == 1)
807 pm = true;
Adrian Hunter319a3f12009-09-22 16:44:30 -0700808 } else
Nicolas Pitre2342f332007-06-30 16:21:52 +0200809 wake_up(&host->wq);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700810 spin_unlock_irqrestore(&host->lock, flags);
811 remove_wait_queue(&host->wq, &wait);
Ulf Hansson9250aea2015-03-27 12:15:15 +0100812
813 if (pm)
814 pm_runtime_get_sync(mmc_dev(host));
815
Nicolas Pitre2342f332007-06-30 16:21:52 +0200816 return stop;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700817}
Nicolas Pitre2342f332007-06-30 16:21:52 +0200818EXPORT_SYMBOL(__mmc_claim_host);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700819
Adrian Hunter319a3f12009-09-22 16:44:30 -0700820/**
Adrian Hunter907d2e72012-02-29 09:17:21 +0200821 * mmc_release_host - release a host
Ulf Hanssonab1efd22011-03-09 09:11:02 +0100822 * @host: mmc host to release
823 *
Adrian Hunter907d2e72012-02-29 09:17:21 +0200824 * Release a MMC host, allowing others to claim the host
825 * for their operations.
Ulf Hanssonab1efd22011-03-09 09:11:02 +0100826 */
Adrian Hunter907d2e72012-02-29 09:17:21 +0200827void mmc_release_host(struct mmc_host *host)
Adrian Hunter8ea926b2009-09-22 16:44:29 -0700828{
829 unsigned long flags;
830
Adrian Hunter907d2e72012-02-29 09:17:21 +0200831 WARN_ON(!host->claimed);
832
Adrian Hunter8ea926b2009-09-22 16:44:29 -0700833 spin_lock_irqsave(&host->lock, flags);
Adrian Hunter319a3f12009-09-22 16:44:30 -0700834 if (--host->claim_cnt) {
835 /* Release for nested claim */
836 spin_unlock_irqrestore(&host->lock, flags);
837 } else {
838 host->claimed = 0;
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300839 host->claimer->task = NULL;
Adrian Hunter319a3f12009-09-22 16:44:30 -0700840 host->claimer = NULL;
841 spin_unlock_irqrestore(&host->lock, flags);
842 wake_up(&host->wq);
Ulf Hansson9250aea2015-03-27 12:15:15 +0100843 pm_runtime_mark_last_busy(mmc_dev(host));
Ulf Hansson7d5ef512018-05-31 11:40:38 +0200844 if (host->caps & MMC_CAP_SYNC_RUNTIME_PM)
845 pm_runtime_put_sync_suspend(mmc_dev(host));
846 else
847 pm_runtime_put_autosuspend(mmc_dev(host));
Adrian Hunter319a3f12009-09-22 16:44:30 -0700848 }
Adrian Hunter8ea926b2009-09-22 16:44:29 -0700849}
Linus Torvalds1da177e2005-04-16 15:20:36 -0700850EXPORT_SYMBOL(mmc_release_host);
851
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100852/*
Ulf Hanssone94cfef2013-05-02 14:02:38 +0200853 * This is a helper function, which fetches a runtime pm reference for the
854 * card device and also claims the host.
855 */
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300856void mmc_get_card(struct mmc_card *card, struct mmc_ctx *ctx)
Ulf Hanssone94cfef2013-05-02 14:02:38 +0200857{
858 pm_runtime_get_sync(&card->dev);
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300859 __mmc_claim_host(card->host, ctx, NULL);
Ulf Hanssone94cfef2013-05-02 14:02:38 +0200860}
861EXPORT_SYMBOL(mmc_get_card);
862
863/*
864 * This is a helper function, which releases the host and drops the runtime
865 * pm reference for the card device.
866 */
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300867void mmc_put_card(struct mmc_card *card, struct mmc_ctx *ctx)
Ulf Hanssone94cfef2013-05-02 14:02:38 +0200868{
Adrian Hunter6c0cedd2017-09-22 15:36:51 +0300869 struct mmc_host *host = card->host;
870
871 WARN_ON(ctx && host->claimer != ctx);
872
873 mmc_release_host(host);
Ulf Hanssone94cfef2013-05-02 14:02:38 +0200874 pm_runtime_mark_last_busy(&card->dev);
875 pm_runtime_put_autosuspend(&card->dev);
876}
877EXPORT_SYMBOL(mmc_put_card);
878
879/*
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100880 * Internal function that does the actual ios call to the host driver,
881 * optionally printing some debug output.
882 */
Russell King920e70c2006-05-04 18:22:51 +0100883static inline void mmc_set_ios(struct mmc_host *host)
884{
885 struct mmc_ios *ios = &host->ios;
886
Pierre Ossmancd9277c2007-02-18 12:07:47 +0100887 pr_debug("%s: clock %uHz busmode %u powermode %u cs %u Vdd %u "
888 "width %u timing %u\n",
Russell King920e70c2006-05-04 18:22:51 +0100889 mmc_hostname(host), ios->clock, ios->bus_mode,
890 ios->power_mode, ios->chip_select, ios->vdd,
Wolfram Sanged9feec2016-01-29 09:27:50 +0100891 1 << ios->bus_width, ios->timing);
Philip Langdalefba68bd2007-01-04 06:57:32 -0800892
Russell King920e70c2006-05-04 18:22:51 +0100893 host->ops->set_ios(host, ios);
894}
895
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100896/*
897 * Control chip select pin on a host.
898 */
Pierre Ossmanda7fbe52006-12-24 22:46:55 +0100899void mmc_set_chip_select(struct mmc_host *host, int mode)
Pierre Ossmanb57c43a2005-09-06 15:18:53 -0700900{
Pierre Ossmanda7fbe52006-12-24 22:46:55 +0100901 host->ios.chip_select = mode;
902 mmc_set_ios(host);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700903}
904
905/*
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100906 * Sets the host clock to the highest possible frequency that
907 * is below "hz".
908 */
Ulf Hansson9eadcc052015-10-02 10:56:11 +0200909void mmc_set_clock(struct mmc_host *host, unsigned int hz)
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100910{
Adrian Hunter6a98f1e2014-09-23 23:00:26 +0300911 WARN_ON(hz && hz < host->f_min);
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100912
913 if (hz > host->f_max)
914 hz = host->f_max;
915
916 host->ios.clock = hz;
917 mmc_set_ios(host);
918}
919
Adrian Hunter63e415c2014-12-05 19:40:59 +0200920int mmc_execute_tuning(struct mmc_card *card)
921{
922 struct mmc_host *host = card->host;
923 u32 opcode;
924 int err;
925
926 if (!host->ops->execute_tuning)
927 return 0;
928
Adrian Hunter3e207c82017-08-10 15:08:09 +0300929 if (host->cqe_on)
930 host->cqe_ops->cqe_off(host);
931
Adrian Hunter63e415c2014-12-05 19:40:59 +0200932 if (mmc_card_mmc(card))
933 opcode = MMC_SEND_TUNING_BLOCK_HS200;
934 else
935 opcode = MMC_SEND_TUNING_BLOCK;
936
Adrian Hunter63e415c2014-12-05 19:40:59 +0200937 err = host->ops->execute_tuning(host, opcode);
Adrian Hunter63e415c2014-12-05 19:40:59 +0200938
939 if (err)
Russell King07d97d82016-01-29 09:44:05 +0000940 pr_err("%s: tuning execution failed: %d\n",
941 mmc_hostname(host), err);
Adrian Hunter79d5a652015-05-07 13:10:13 +0300942 else
943 mmc_retune_enable(host);
Adrian Hunter63e415c2014-12-05 19:40:59 +0200944
945 return err;
946}
947
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100948/*
949 * Change the bus mode (open drain/push-pull) of a host.
950 */
951void mmc_set_bus_mode(struct mmc_host *host, unsigned int mode)
952{
953 host->ios.bus_mode = mode;
954 mmc_set_ios(host);
955}
956
957/*
958 * Change data bus width of a host.
959 */
960void mmc_set_bus_width(struct mmc_host *host, unsigned int width)
961{
Philip Rakity4c4cb172011-05-13 11:17:18 +0530962 host->ios.bus_width = width;
963 mmc_set_ios(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100964}
965
Johan Rudholm2d079c42014-11-06 14:46:54 +0100966/*
967 * Set initial state after a power cycle or a hw_reset.
968 */
969void mmc_set_initial_state(struct mmc_host *host)
970{
Adrian Hunter3e207c82017-08-10 15:08:09 +0300971 if (host->cqe_on)
972 host->cqe_ops->cqe_off(host);
973
Adrian Hunter79d5a652015-05-07 13:10:13 +0300974 mmc_retune_disable(host);
975
Johan Rudholm2d079c42014-11-06 14:46:54 +0100976 if (mmc_host_is_spi(host))
977 host->ios.chip_select = MMC_CS_HIGH;
978 else
979 host->ios.chip_select = MMC_CS_DONTCARE;
980 host->ios.bus_mode = MMC_BUSMODE_PUSHPULL;
981 host->ios.bus_width = MMC_BUS_WIDTH_1;
982 host->ios.timing = MMC_TIMING_LEGACY;
Adrian Hunter75e8a222015-02-06 14:12:51 +0200983 host->ios.drv_type = 0;
Shawn Lin81ac2af2016-05-26 09:56:22 +0800984 host->ios.enhanced_strobe = false;
985
986 /*
987 * Make sure we are in non-enhanced strobe mode before we
988 * actually enable it in ext_csd.
989 */
990 if ((host->caps2 & MMC_CAP2_HS400_ES) &&
991 host->ops->hs400_enhanced_strobe)
992 host->ops->hs400_enhanced_strobe(host, &host->ios);
Johan Rudholm2d079c42014-11-06 14:46:54 +0100993
994 mmc_set_ios(host);
995}
996
Anton Vorontsov86e82862008-11-26 22:54:17 +0300997/**
998 * mmc_vdd_to_ocrbitnum - Convert a voltage to the OCR bit number
999 * @vdd: voltage (mV)
1000 * @low_bits: prefer low bits in boundary cases
1001 *
1002 * This function returns the OCR bit number according to the provided @vdd
1003 * value. If conversion is not possible a negative errno value returned.
1004 *
1005 * Depending on the @low_bits flag the function prefers low or high OCR bits
1006 * on boundary voltages. For example,
1007 * with @low_bits = true, 3300 mV translates to ilog2(MMC_VDD_32_33);
1008 * with @low_bits = false, 3300 mV translates to ilog2(MMC_VDD_33_34);
1009 *
1010 * Any value in the [1951:1999] range translates to the ilog2(MMC_VDD_20_21).
1011 */
1012static int mmc_vdd_to_ocrbitnum(int vdd, bool low_bits)
1013{
1014 const int max_bit = ilog2(MMC_VDD_35_36);
1015 int bit;
1016
1017 if (vdd < 1650 || vdd > 3600)
1018 return -EINVAL;
1019
1020 if (vdd >= 1650 && vdd <= 1950)
1021 return ilog2(MMC_VDD_165_195);
1022
1023 if (low_bits)
1024 vdd -= 1;
1025
1026 /* Base 2000 mV, step 100 mV, bit's base 8. */
1027 bit = (vdd - 2000) / 100 + 8;
1028 if (bit > max_bit)
1029 return max_bit;
1030 return bit;
1031}
1032
1033/**
1034 * mmc_vddrange_to_ocrmask - Convert a voltage range to the OCR mask
1035 * @vdd_min: minimum voltage value (mV)
1036 * @vdd_max: maximum voltage value (mV)
1037 *
1038 * This function returns the OCR mask bits according to the provided @vdd_min
1039 * and @vdd_max values. If conversion is not possible the function returns 0.
1040 *
1041 * Notes wrt boundary cases:
1042 * This function sets the OCR bits for all boundary voltages, for example
1043 * [3300:3400] range is translated to MMC_VDD_32_33 | MMC_VDD_33_34 |
1044 * MMC_VDD_34_35 mask.
1045 */
1046u32 mmc_vddrange_to_ocrmask(int vdd_min, int vdd_max)
1047{
1048 u32 mask = 0;
1049
1050 if (vdd_max < vdd_min)
1051 return 0;
1052
1053 /* Prefer high bits for the boundary vdd_max values. */
1054 vdd_max = mmc_vdd_to_ocrbitnum(vdd_max, false);
1055 if (vdd_max < 0)
1056 return 0;
1057
1058 /* Prefer low bits for the boundary vdd_min values. */
1059 vdd_min = mmc_vdd_to_ocrbitnum(vdd_min, true);
1060 if (vdd_min < 0)
1061 return 0;
1062
1063 /* Fill the mask, from max bit to min bit. */
1064 while (vdd_max >= vdd_min)
1065 mask |= 1 << vdd_max--;
1066
1067 return mask;
1068}
Anton Vorontsov86e82862008-11-26 22:54:17 +03001069
Sascha Hauer25185f32014-06-30 11:07:25 +02001070static int mmc_of_get_func_num(struct device_node *node)
1071{
1072 u32 reg;
1073 int ret;
1074
1075 ret = of_property_read_u32(node, "reg", &reg);
1076 if (ret < 0)
1077 return ret;
1078
1079 return reg;
1080}
1081
1082struct device_node *mmc_of_find_child_device(struct mmc_host *host,
1083 unsigned func_num)
1084{
1085 struct device_node *node;
1086
1087 if (!host->parent || !host->parent->of_node)
1088 return NULL;
1089
1090 for_each_child_of_node(host->parent->of_node, node) {
1091 if (mmc_of_get_func_num(node) == func_num)
1092 return node;
1093 }
1094
1095 return NULL;
1096}
1097
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001098/*
Linus Torvalds1da177e2005-04-16 15:20:36 -07001099 * Mask off any voltages we don't support and select
1100 * the lowest voltage
1101 */
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001102u32 mmc_select_voltage(struct mmc_host *host, u32 ocr)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001103{
1104 int bit;
1105
Ulf Hansson726d6f22013-09-16 12:06:15 +02001106 /*
1107 * Sanity check the voltages that the card claims to
1108 * support.
1109 */
1110 if (ocr & 0x7F) {
1111 dev_warn(mmc_dev(host),
1112 "card claims to support voltages below defined range\n");
1113 ocr &= ~0x7F;
1114 }
1115
Linus Torvalds1da177e2005-04-16 15:20:36 -07001116 ocr &= host->ocr_avail;
Ulf Hanssonce69d372013-09-16 11:28:42 +02001117 if (!ocr) {
1118 dev_warn(mmc_dev(host), "no support for card's volts\n");
1119 return 0;
1120 }
Linus Torvalds1da177e2005-04-16 15:20:36 -07001121
Ulf Hanssonce69d372013-09-16 11:28:42 +02001122 if (host->caps2 & MMC_CAP2_FULL_PWR_CYCLE) {
1123 bit = ffs(ocr) - 1;
Timo Teras63ef7312006-11-02 19:43:27 +01001124 ocr &= 3 << bit;
Ulf Hanssonce69d372013-09-16 11:28:42 +02001125 mmc_power_cycle(host, ocr);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001126 } else {
Ulf Hanssonce69d372013-09-16 11:28:42 +02001127 bit = fls(ocr) - 1;
1128 ocr &= 3 << bit;
1129 if (bit != host->ios.vdd)
1130 dev_warn(mmc_dev(host), "exceeding card's volts\n");
Linus Torvalds1da177e2005-04-16 15:20:36 -07001131 }
1132
1133 return ocr;
1134}
1135
Ulf Hansson4e74b6b2017-01-25 11:12:34 +01001136int mmc_set_signal_voltage(struct mmc_host *host, int signal_voltage)
Johan Rudholm567c89032013-01-28 15:08:27 +01001137{
1138 int err = 0;
1139 int old_signal_voltage = host->ios.signal_voltage;
1140
1141 host->ios.signal_voltage = signal_voltage;
Ulf Hansson9eadcc052015-10-02 10:56:11 +02001142 if (host->ops->start_signal_voltage_switch)
Johan Rudholm567c89032013-01-28 15:08:27 +01001143 err = host->ops->start_signal_voltage_switch(host, &host->ios);
Johan Rudholm567c89032013-01-28 15:08:27 +01001144
1145 if (err)
1146 host->ios.signal_voltage = old_signal_voltage;
1147
1148 return err;
1149
1150}
1151
Ulf Hansson508c9862018-04-05 21:24:15 +02001152void mmc_set_initial_signal_voltage(struct mmc_host *host)
1153{
1154 /* Try to set signal voltage to 3.3V but fall back to 1.8v or 1.2v */
1155 if (!mmc_set_signal_voltage(host, MMC_SIGNAL_VOLTAGE_330))
1156 dev_dbg(mmc_dev(host), "Initial signal voltage of 3.3v\n");
1157 else if (!mmc_set_signal_voltage(host, MMC_SIGNAL_VOLTAGE_180))
1158 dev_dbg(mmc_dev(host), "Initial signal voltage of 1.8v\n");
1159 else if (!mmc_set_signal_voltage(host, MMC_SIGNAL_VOLTAGE_120))
1160 dev_dbg(mmc_dev(host), "Initial signal voltage of 1.2v\n");
1161}
1162
Adrian Hunter3f496af2017-09-25 11:29:03 +03001163int mmc_host_set_uhs_voltage(struct mmc_host *host)
1164{
1165 u32 clock;
1166
1167 /*
1168 * During a signal voltage level switch, the clock must be gated
1169 * for 5 ms according to the SD spec
1170 */
1171 clock = host->ios.clock;
1172 host->ios.clock = 0;
1173 mmc_set_ios(host);
1174
1175 if (mmc_set_signal_voltage(host, MMC_SIGNAL_VOLTAGE_180))
1176 return -EAGAIN;
1177
1178 /* Keep clock gated for at least 10 ms, though spec only says 5 ms */
1179 mmc_delay(10);
1180 host->ios.clock = clock;
1181 mmc_set_ios(host);
1182
1183 return 0;
1184}
1185
Ulf Hansson2ed573b2017-01-25 10:25:01 +01001186int mmc_set_uhs_voltage(struct mmc_host *host, u32 ocr)
Arindam Nathf2119df2011-05-05 12:18:57 +05301187{
Masahiro Yamadac7836d12016-12-19 20:51:18 +09001188 struct mmc_command cmd = {};
Arindam Nathf2119df2011-05-05 12:18:57 +05301189 int err = 0;
1190
Arindam Nathf2119df2011-05-05 12:18:57 +05301191 /*
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001192 * If we cannot switch voltages, return failure so the caller
1193 * can continue without UHS mode
1194 */
1195 if (!host->ops->start_signal_voltage_switch)
1196 return -EPERM;
1197 if (!host->ops->card_busy)
Joe Perches66061102014-09-12 14:56:56 -07001198 pr_warn("%s: cannot verify signal voltage switch\n",
1199 mmc_hostname(host));
Arindam Nathf2119df2011-05-05 12:18:57 +05301200
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001201 cmd.opcode = SD_SWITCH_VOLTAGE;
1202 cmd.arg = 0;
1203 cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
1204
1205 err = mmc_wait_for_cmd(host, &cmd, 0);
1206 if (err)
Ulf Hansson9eadcc052015-10-02 10:56:11 +02001207 return err;
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001208
Ulf Hansson9eadcc052015-10-02 10:56:11 +02001209 if (!mmc_host_is_spi(host) && (cmd.resp[0] & R1_ERROR))
1210 return -EIO;
1211
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001212 /*
1213 * The card should drive cmd and dat[0:3] low immediately
1214 * after the response of cmd11, but wait 1 ms to be sure
1215 */
1216 mmc_delay(1);
1217 if (host->ops->card_busy && !host->ops->card_busy(host)) {
1218 err = -EAGAIN;
1219 goto power_cycle;
1220 }
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001221
Adrian Hunter3f496af2017-09-25 11:29:03 +03001222 if (mmc_host_set_uhs_voltage(host)) {
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001223 /*
1224 * Voltages may not have been switched, but we've already
1225 * sent CMD11, so a power cycle is required anyway
1226 */
1227 err = -EAGAIN;
1228 goto power_cycle;
Arindam Nathf2119df2011-05-05 12:18:57 +05301229 }
1230
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001231 /* Wait for at least 1 ms according to spec */
1232 mmc_delay(1);
1233
1234 /*
1235 * Failure to switch is indicated by the card holding
1236 * dat[0:3] low
1237 */
1238 if (host->ops->card_busy && host->ops->card_busy(host))
1239 err = -EAGAIN;
1240
1241power_cycle:
1242 if (err) {
1243 pr_debug("%s: Signal voltage switch failed, "
1244 "power cycling card\n", mmc_hostname(host));
Ulf Hansson0f791fd2013-09-12 15:36:34 +02001245 mmc_power_cycle(host, ocr);
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001246 }
1247
Johan Rudholm0797e5f2013-01-28 15:08:28 +01001248 return err;
Arindam Nathf2119df2011-05-05 12:18:57 +05301249}
1250
Linus Torvalds1da177e2005-04-16 15:20:36 -07001251/*
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001252 * Select timing parameters for host.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001253 */
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001254void mmc_set_timing(struct mmc_host *host, unsigned int timing)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001255{
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001256 host->ios.timing = timing;
1257 mmc_set_ios(host);
Pierre Ossmanb57c43a2005-09-06 15:18:53 -07001258}
1259
1260/*
Arindam Nathd6d50a12011-05-05 12:18:59 +05301261 * Select appropriate driver type for host.
1262 */
1263void mmc_set_driver_type(struct mmc_host *host, unsigned int drv_type)
1264{
1265 host->ios.drv_type = drv_type;
1266 mmc_set_ios(host);
1267}
1268
Adrian Huntere23350b2015-02-06 14:12:55 +02001269int mmc_select_drive_strength(struct mmc_card *card, unsigned int max_dtr,
1270 int card_drv_type, int *drv_type)
1271{
1272 struct mmc_host *host = card->host;
1273 int host_drv_type = SD_DRIVER_TYPE_B;
Adrian Huntere23350b2015-02-06 14:12:55 +02001274
1275 *drv_type = 0;
1276
1277 if (!host->ops->select_drive_strength)
1278 return 0;
1279
1280 /* Use SD definition of driver strength for hosts */
1281 if (host->caps & MMC_CAP_DRIVER_TYPE_A)
1282 host_drv_type |= SD_DRIVER_TYPE_A;
1283
1284 if (host->caps & MMC_CAP_DRIVER_TYPE_C)
1285 host_drv_type |= SD_DRIVER_TYPE_C;
1286
1287 if (host->caps & MMC_CAP_DRIVER_TYPE_D)
1288 host_drv_type |= SD_DRIVER_TYPE_D;
1289
1290 /*
1291 * The drive strength that the hardware can support
1292 * depends on the board design. Pass the appropriate
1293 * information and let the hardware specific code
1294 * return what is possible given the options
1295 */
Ulf Hansson9eadcc052015-10-02 10:56:11 +02001296 return host->ops->select_drive_strength(card, max_dtr,
1297 host_drv_type,
1298 card_drv_type,
1299 drv_type);
Adrian Huntere23350b2015-02-06 14:12:55 +02001300}
1301
Arindam Nathd6d50a12011-05-05 12:18:59 +05301302/*
Russell King45f82452005-12-14 14:57:35 +00001303 * Apply power to the MMC stack. This is a two-stage process.
1304 * First, we enable power to the card without the clock running.
1305 * We then wait a bit for the power to stabilise. Finally,
1306 * enable the bus drivers and clock to the card.
1307 *
1308 * We must _NOT_ enable the clock prior to power stablising.
1309 *
1310 * If a host does all the power sequencing itself, ignore the
1311 * initial MMC_POWER_UP stage.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001312 */
Ulf Hansson4a065192013-09-12 14:36:53 +02001313void mmc_power_up(struct mmc_host *host, u32 ocr)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001314{
Ulf Hanssonfa550182012-05-09 16:15:26 +02001315 if (host->ios.power_mode == MMC_POWER_ON)
1316 return;
1317
Ulf Hansson3aa87932014-11-28 14:38:36 +01001318 mmc_pwrseq_pre_power_on(host);
1319
Ulf Hansson4a065192013-09-12 14:36:53 +02001320 host->ios.vdd = fls(ocr) - 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001321 host->ios.power_mode = MMC_POWER_UP;
Johan Rudholm2d079c42014-11-06 14:46:54 +01001322 /* Set initial state and call mmc_set_ios */
1323 mmc_set_initial_state(host);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001324
Ulf Hansson508c9862018-04-05 21:24:15 +02001325 mmc_set_initial_signal_voltage(host);
Aaron Lu108ecc42012-07-10 16:55:37 +08001326
Pierre Ossmanf9996ae2007-09-19 18:38:50 +02001327 /*
1328 * This delay should be sufficient to allow the power supply
1329 * to reach the minimum voltage.
1330 */
Shawn Lin6d796c62018-05-08 09:04:20 +08001331 mmc_delay(host->ios.power_delay_ms);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001332
Ulf Hansson4febb7e2015-02-02 16:01:14 +01001333 mmc_pwrseq_post_power_on(host);
1334
Hein Tibosch88ae8b82010-09-06 09:37:19 +08001335 host->ios.clock = host->f_init;
Sascha Hauer8dfd0372009-04-09 08:32:02 +02001336
Linus Torvalds1da177e2005-04-16 15:20:36 -07001337 host->ios.power_mode = MMC_POWER_ON;
Russell King920e70c2006-05-04 18:22:51 +01001338 mmc_set_ios(host);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001339
Pierre Ossmanf9996ae2007-09-19 18:38:50 +02001340 /*
1341 * This delay must be at least 74 clock sizes, or 1 ms, or the
1342 * time required to reach a stable voltage.
1343 */
Shawn Lin6d796c62018-05-08 09:04:20 +08001344 mmc_delay(host->ios.power_delay_ms);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001345}
1346
Ulf Hansson7f7e4122011-09-21 14:08:13 -04001347void mmc_power_off(struct mmc_host *host)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001348{
Ulf Hanssonfa550182012-05-09 16:15:26 +02001349 if (host->ios.power_mode == MMC_POWER_OFF)
1350 return;
1351
Ulf Hansson3aa87932014-11-28 14:38:36 +01001352 mmc_pwrseq_power_off(host);
1353
Linus Torvalds1da177e2005-04-16 15:20:36 -07001354 host->ios.clock = 0;
1355 host->ios.vdd = 0;
Ulf Hanssonb33d46c2011-03-05 14:36:24 +01001356
Linus Torvalds1da177e2005-04-16 15:20:36 -07001357 host->ios.power_mode = MMC_POWER_OFF;
Johan Rudholm2d079c42014-11-06 14:46:54 +01001358 /* Set initial state and call mmc_set_ios */
1359 mmc_set_initial_state(host);
Mika Westerberg778e2772011-08-18 15:23:48 +03001360
Daniel Drake041beb12011-09-07 10:22:09 +01001361 /*
1362 * Some configurations, such as the 802.11 SDIO card in the OLPC
1363 * XO-1.5, require a short delay after poweroff before the card
1364 * can be successfully turned on again.
1365 */
1366 mmc_delay(1);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001367}
1368
Ulf Hansson4a065192013-09-12 14:36:53 +02001369void mmc_power_cycle(struct mmc_host *host, u32 ocr)
Johan Rudholm276e0902013-01-28 15:08:25 +01001370{
1371 mmc_power_off(host);
1372 /* Wait at least 1 ms according to SD spec */
1373 mmc_delay(1);
Ulf Hansson4a065192013-09-12 14:36:53 +02001374 mmc_power_up(host, ocr);
Johan Rudholm276e0902013-01-28 15:08:25 +01001375}
1376
Linus Torvalds1da177e2005-04-16 15:20:36 -07001377/*
Adrian Bunk39361852007-07-25 00:40:58 +02001378 * Cleanup when the last reference to the bus operator is dropped.
1379 */
Adrian Bunk261172f2008-04-13 21:15:47 +03001380static void __mmc_release_bus(struct mmc_host *host)
Adrian Bunk39361852007-07-25 00:40:58 +02001381{
Shawn Lin6ff897f2016-11-02 15:26:16 +08001382 WARN_ON(!host->bus_dead);
Adrian Bunk39361852007-07-25 00:40:58 +02001383
1384 host->bus_ops = NULL;
1385}
1386
1387/*
1388 * Increase reference count of bus operator
1389 */
1390static inline void mmc_bus_get(struct mmc_host *host)
1391{
1392 unsigned long flags;
1393
1394 spin_lock_irqsave(&host->lock, flags);
1395 host->bus_refs++;
1396 spin_unlock_irqrestore(&host->lock, flags);
1397}
1398
1399/*
1400 * Decrease reference count of bus operator and free it if
1401 * it is the last reference.
1402 */
1403static inline void mmc_bus_put(struct mmc_host *host)
1404{
1405 unsigned long flags;
1406
1407 spin_lock_irqsave(&host->lock, flags);
1408 host->bus_refs--;
1409 if ((host->bus_refs == 0) && host->bus_ops)
1410 __mmc_release_bus(host);
1411 spin_unlock_irqrestore(&host->lock, flags);
1412}
1413
1414/*
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001415 * Assign a mmc bus handler to a host. Only one bus handler may control a
1416 * host at any given time.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001417 */
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001418void mmc_attach_bus(struct mmc_host *host, const struct mmc_bus_ops *ops)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001419{
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001420 unsigned long flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001421
Pierre Ossmand84075c82007-08-09 13:23:56 +02001422 WARN_ON(!host->claimed);
Pierre Ossmanb8558852007-01-03 19:47:29 +01001423
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001424 spin_lock_irqsave(&host->lock, flags);
Pierre Ossmanb8558852007-01-03 19:47:29 +01001425
Shawn Lin6ff897f2016-11-02 15:26:16 +08001426 WARN_ON(host->bus_ops);
1427 WARN_ON(host->bus_refs);
Pierre Ossmanb8558852007-01-03 19:47:29 +01001428
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001429 host->bus_ops = ops;
1430 host->bus_refs = 1;
1431 host->bus_dead = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001432
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001433 spin_unlock_irqrestore(&host->lock, flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001434}
1435
1436/*
Ulf Hansson7f7e4122011-09-21 14:08:13 -04001437 * Remove the current bus handler from a host.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001438 */
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001439void mmc_detach_bus(struct mmc_host *host)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001440{
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001441 unsigned long flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -07001442
Pierre Ossmand84075c82007-08-09 13:23:56 +02001443 WARN_ON(!host->claimed);
1444 WARN_ON(!host->bus_ops);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001445
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001446 spin_lock_irqsave(&host->lock, flags);
1447
1448 host->bus_dead = 1;
1449
1450 spin_unlock_irqrestore(&host->lock, flags);
1451
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001452 mmc_bus_put(host);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001453}
1454
Ulf Hansson2ac55d52019-10-17 15:25:36 +02001455void _mmc_detect_change(struct mmc_host *host, unsigned long delay, bool cd_irq)
Ulf Hanssonbbd43682013-09-20 11:02:35 +02001456{
Ulf Hanssonbbd43682013-09-20 11:02:35 +02001457 /*
Ulf Hanssonb52fb252020-05-29 12:23:41 +02001458 * Prevent system sleep for 5s to allow user space to consume the
1459 * corresponding uevent. This is especially useful, when CD irq is used
1460 * as a system wakeup, but doesn't hurt in other cases.
Ulf Hanssonbbd43682013-09-20 11:02:35 +02001461 */
Ulf Hanssonb52fb252020-05-29 12:23:41 +02001462 if (cd_irq && !(host->caps & MMC_CAP_NEEDS_POLL))
1463 __pm_wakeup_event(host->ws, 5000);
Ulf Hanssonbbd43682013-09-20 11:02:35 +02001464
1465 host->detect_change = 1;
1466 mmc_schedule_delayed_work(&host->detect, delay);
1467}
1468
Linus Torvalds1da177e2005-04-16 15:20:36 -07001469/**
1470 * mmc_detect_change - process change of state on a MMC socket
1471 * @host: host which changed state.
Richard Purdie8dc00332005-09-08 17:53:01 +01001472 * @delay: optional delay to wait before detection (jiffies)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001473 *
Pierre Ossman67a61c42007-07-11 20:22:11 +02001474 * MMC drivers should call this when they detect a card has been
1475 * inserted or removed. The MMC layer will confirm that any
1476 * present card is still functional, and initialize any newly
1477 * inserted.
Linus Torvalds1da177e2005-04-16 15:20:36 -07001478 */
Richard Purdie8dc00332005-09-08 17:53:01 +01001479void mmc_detect_change(struct mmc_host *host, unsigned long delay)
Linus Torvalds1da177e2005-04-16 15:20:36 -07001480{
Ulf Hanssonbbd43682013-09-20 11:02:35 +02001481 _mmc_detect_change(host, delay, true);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001482}
Linus Torvalds1da177e2005-04-16 15:20:36 -07001483EXPORT_SYMBOL(mmc_detect_change);
1484
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001485void mmc_init_erase(struct mmc_card *card)
1486{
1487 unsigned int sz;
1488
1489 if (is_power_of_2(card->erase_size))
1490 card->erase_shift = ffs(card->erase_size) - 1;
1491 else
1492 card->erase_shift = 0;
1493
1494 /*
1495 * It is possible to erase an arbitrarily large area of an SD or MMC
1496 * card. That is not desirable because it can take a long time
1497 * (minutes) potentially delaying more important I/O, and also the
1498 * timeout calculations become increasingly hugely over-estimated.
1499 * Consequently, 'pref_erase' is defined as a guide to limit erases
1500 * to that size and alignment.
1501 *
1502 * For SD cards that define Allocation Unit size, limit erases to one
Gwendal Grignouc6d8fd62016-06-03 09:08:52 -07001503 * Allocation Unit at a time.
1504 * For MMC, have a stab at ai good value and for modern cards it will
1505 * end up being 4MiB. Note that if the value is too small, it can end
1506 * up taking longer to erase. Also note, erase_size is already set to
1507 * High Capacity Erase Size if available when this function is called.
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001508 */
1509 if (mmc_card_sd(card) && card->ssr.au) {
1510 card->pref_erase = card->ssr.au;
1511 card->erase_shift = ffs(card->ssr.au) - 1;
Chuanxiao Dongcc8aa7d2014-08-14 18:29:24 +08001512 } else if (card->erase_size) {
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001513 sz = (card->csd.capacity << (card->csd.read_blkbits - 9)) >> 11;
1514 if (sz < 128)
1515 card->pref_erase = 512 * 1024 / 512;
1516 else if (sz < 512)
1517 card->pref_erase = 1024 * 1024 / 512;
1518 else if (sz < 1024)
1519 card->pref_erase = 2 * 1024 * 1024 / 512;
1520 else
1521 card->pref_erase = 4 * 1024 * 1024 / 512;
1522 if (card->pref_erase < card->erase_size)
1523 card->pref_erase = card->erase_size;
1524 else {
1525 sz = card->pref_erase % card->erase_size;
1526 if (sz)
1527 card->pref_erase += card->erase_size - sz;
1528 }
Chuanxiao Dongcc8aa7d2014-08-14 18:29:24 +08001529 } else
1530 card->pref_erase = 0;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001531}
1532
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001533static unsigned int mmc_mmc_erase_timeout(struct mmc_card *card,
1534 unsigned int arg, unsigned int qty)
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001535{
1536 unsigned int erase_timeout;
1537
Adrian Hunter7194efb2012-04-05 14:45:47 +03001538 if (arg == MMC_DISCARD_ARG ||
1539 (arg == MMC_TRIM_ARG && card->ext_csd.rev >= 6)) {
1540 erase_timeout = card->ext_csd.trim_timeout;
1541 } else if (card->ext_csd.erase_group_def & 1) {
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001542 /* High Capacity Erase Group Size uses HC timeouts */
1543 if (arg == MMC_TRIM_ARG)
1544 erase_timeout = card->ext_csd.trim_timeout;
1545 else
1546 erase_timeout = card->ext_csd.hc_erase_timeout;
1547 } else {
1548 /* CSD Erase Group Size uses write timeout */
1549 unsigned int mult = (10 << card->csd.r2w_factor);
Shawn Lin4406ae22017-08-02 11:12:42 +08001550 unsigned int timeout_clks = card->csd.taac_clks * mult;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001551 unsigned int timeout_us;
1552
Shawn Lin4406ae22017-08-02 11:12:42 +08001553 /* Avoid overflow: e.g. taac_ns=80000000 mult=1280 */
1554 if (card->csd.taac_ns < 1000000)
1555 timeout_us = (card->csd.taac_ns * mult) / 1000;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001556 else
Shawn Lin4406ae22017-08-02 11:12:42 +08001557 timeout_us = (card->csd.taac_ns / 1000) * mult;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001558
1559 /*
1560 * ios.clock is only a target. The real clock rate might be
1561 * less but not that much less, so fudge it by multiplying by 2.
1562 */
1563 timeout_clks <<= 1;
1564 timeout_us += (timeout_clks * 1000) /
Ulf Hansson9eadcc052015-10-02 10:56:11 +02001565 (card->host->ios.clock / 1000);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001566
1567 erase_timeout = timeout_us / 1000;
1568
1569 /*
1570 * Theoretically, the calculation could underflow so round up
1571 * to 1ms in that case.
1572 */
1573 if (!erase_timeout)
1574 erase_timeout = 1;
1575 }
1576
1577 /* Multiplier for secure operations */
1578 if (arg & MMC_SECURE_ARGS) {
1579 if (arg == MMC_SECURE_ERASE_ARG)
1580 erase_timeout *= card->ext_csd.sec_erase_mult;
1581 else
1582 erase_timeout *= card->ext_csd.sec_trim_mult;
1583 }
1584
1585 erase_timeout *= qty;
1586
1587 /*
1588 * Ensure at least a 1 second timeout for SPI as per
1589 * 'mmc_set_data_timeout()'
1590 */
1591 if (mmc_host_is_spi(card->host) && erase_timeout < 1000)
1592 erase_timeout = 1000;
1593
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001594 return erase_timeout;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001595}
1596
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001597static unsigned int mmc_sd_erase_timeout(struct mmc_card *card,
1598 unsigned int arg,
1599 unsigned int qty)
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001600{
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001601 unsigned int erase_timeout;
1602
Avri Altmanad9be7f2019-02-26 17:10:25 +02001603 /* for DISCARD none of the below calculation applies.
1604 * the busy timeout is 250msec per discard command.
1605 */
1606 if (arg == SD_DISCARD_ARG)
1607 return SD_DISCARD_TIMEOUT_MS;
1608
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001609 if (card->ssr.erase_timeout) {
1610 /* Erase timeout specified in SD Status Register (SSR) */
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001611 erase_timeout = card->ssr.erase_timeout * qty +
1612 card->ssr.erase_offset;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001613 } else {
1614 /*
1615 * Erase timeout not specified in SD Status Register (SSR) so
1616 * use 250ms per write block.
1617 */
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001618 erase_timeout = 250 * qty;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001619 }
1620
1621 /* Must not be less than 1 second */
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001622 if (erase_timeout < 1000)
1623 erase_timeout = 1000;
1624
1625 return erase_timeout;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001626}
1627
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001628static unsigned int mmc_erase_timeout(struct mmc_card *card,
1629 unsigned int arg,
1630 unsigned int qty)
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001631{
1632 if (mmc_card_sd(card))
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001633 return mmc_sd_erase_timeout(card, arg, qty);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001634 else
Andrei Warkentineaa02f72011-04-11 16:13:41 -05001635 return mmc_mmc_erase_timeout(card, arg, qty);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001636}
1637
1638static int mmc_do_erase(struct mmc_card *card, unsigned int from,
1639 unsigned int to, unsigned int arg)
1640{
Masahiro Yamadac7836d12016-12-19 20:51:18 +09001641 struct mmc_command cmd = {};
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001642 unsigned int qty = 0, busy_timeout = 0;
1643 bool use_r1b_resp = false;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001644 int err;
1645
Adrian Hunter8f11d102015-05-07 13:10:16 +03001646 mmc_retune_hold(card->host);
1647
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001648 /*
1649 * qty is used to calculate the erase timeout which depends on how many
1650 * erase groups (or allocation units in SD terminology) are affected.
1651 * We count erasing part of an erase group as one erase group.
1652 * For SD, the allocation units are always a power of 2. For MMC, the
1653 * erase group size is almost certainly also power of 2, but it does not
1654 * seem to insist on that in the JEDEC standard, so we fall back to
1655 * division in that case. SD may not specify an allocation unit size,
1656 * in which case the timeout is based on the number of write blocks.
1657 *
1658 * Note that the timeout for secure trim 2 will only be correct if the
1659 * number of erase groups specified is the same as the total of all
1660 * preceding secure trim 1 commands. Since the power may have been
1661 * lost since the secure trim 1 commands occurred, it is generally
1662 * impossible to calculate the secure trim 2 timeout correctly.
1663 */
1664 if (card->erase_shift)
1665 qty += ((to >> card->erase_shift) -
1666 (from >> card->erase_shift)) + 1;
1667 else if (mmc_card_sd(card))
1668 qty += to - from + 1;
1669 else
1670 qty += ((to / card->erase_size) -
1671 (from / card->erase_size)) + 1;
1672
1673 if (!mmc_card_blockaddr(card)) {
1674 from <<= 9;
1675 to <<= 9;
1676 }
1677
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001678 if (mmc_card_sd(card))
1679 cmd.opcode = SD_ERASE_WR_BLK_START;
1680 else
1681 cmd.opcode = MMC_ERASE_GROUP_START;
1682 cmd.arg = from;
1683 cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_AC;
1684 err = mmc_wait_for_cmd(card->host, &cmd, 0);
1685 if (err) {
Girish K Sa3c76eb2011-10-11 11:44:09 +05301686 pr_err("mmc_erase: group start error %d, "
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001687 "status %#x\n", err, cmd.resp[0]);
Adrian Hunter67716322011-08-29 16:42:15 +03001688 err = -EIO;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001689 goto out;
1690 }
1691
1692 memset(&cmd, 0, sizeof(struct mmc_command));
1693 if (mmc_card_sd(card))
1694 cmd.opcode = SD_ERASE_WR_BLK_END;
1695 else
1696 cmd.opcode = MMC_ERASE_GROUP_END;
1697 cmd.arg = to;
1698 cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_AC;
1699 err = mmc_wait_for_cmd(card->host, &cmd, 0);
1700 if (err) {
Girish K Sa3c76eb2011-10-11 11:44:09 +05301701 pr_err("mmc_erase: group end error %d, status %#x\n",
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001702 err, cmd.resp[0]);
Adrian Hunter67716322011-08-29 16:42:15 +03001703 err = -EIO;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001704 goto out;
1705 }
1706
1707 memset(&cmd, 0, sizeof(struct mmc_command));
1708 cmd.opcode = MMC_ERASE;
1709 cmd.arg = arg;
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001710 busy_timeout = mmc_erase_timeout(card, arg, qty);
1711 /*
1712 * If the host controller supports busy signalling and the timeout for
1713 * the erase operation does not exceed the max_busy_timeout, we should
1714 * use R1B response. Or we need to prevent the host from doing hw busy
1715 * detection, which is done by converting to a R1 response instead.
Ulf Hansson43cc64e2020-03-10 14:43:00 +01001716 * Note, some hosts requires R1B, which also means they are on their own
1717 * when it comes to deal with the busy timeout.
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001718 */
Ulf Hansson43cc64e2020-03-10 14:43:00 +01001719 if (!(card->host->caps & MMC_CAP_NEED_RSP_BUSY) &&
1720 card->host->max_busy_timeout &&
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001721 busy_timeout > card->host->max_busy_timeout) {
1722 cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_AC;
1723 } else {
1724 cmd.flags = MMC_RSP_SPI_R1B | MMC_RSP_R1B | MMC_CMD_AC;
1725 cmd.busy_timeout = busy_timeout;
1726 use_r1b_resp = true;
1727 }
1728
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001729 err = mmc_wait_for_cmd(card->host, &cmd, 0);
1730 if (err) {
Girish K Sa3c76eb2011-10-11 11:44:09 +05301731 pr_err("mmc_erase: erase error %d, status %#x\n",
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001732 err, cmd.resp[0]);
1733 err = -EIO;
1734 goto out;
1735 }
1736
1737 if (mmc_host_is_spi(card->host))
1738 goto out;
1739
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001740 /*
1741 * In case of when R1B + MMC_CAP_WAIT_WHILE_BUSY is used, the polling
1742 * shall be avoided.
1743 */
1744 if ((card->host->caps & MMC_CAP_WAIT_WHILE_BUSY) && use_r1b_resp)
1745 goto out;
1746
Ulf Hansson0d84c3e2020-02-04 09:54:45 +01001747 /* Let's poll to find out when the erase operation completes. */
1748 err = mmc_poll_for_busy(card, busy_timeout, MMC_BUSY_ERASE);
Martin Hicks833b5112018-05-28 13:23:04 +02001749
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001750out:
Adrian Hunter8f11d102015-05-07 13:10:16 +03001751 mmc_retune_release(card->host);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001752 return err;
1753}
1754
Baolin Wang71085122016-09-07 10:38:24 +08001755static unsigned int mmc_align_erase_size(struct mmc_card *card,
1756 unsigned int *from,
1757 unsigned int *to,
1758 unsigned int nr)
1759{
1760 unsigned int from_new = *from, nr_new = nr, rem;
1761
Baolin Wang6c689882016-09-07 10:38:25 +08001762 /*
1763 * When the 'card->erase_size' is power of 2, we can use round_up/down()
1764 * to align the erase size efficiently.
1765 */
1766 if (is_power_of_2(card->erase_size)) {
1767 unsigned int temp = from_new;
1768
1769 from_new = round_up(temp, card->erase_size);
1770 rem = from_new - temp;
1771
Baolin Wang71085122016-09-07 10:38:24 +08001772 if (nr_new > rem)
1773 nr_new -= rem;
1774 else
1775 return 0;
Baolin Wang71085122016-09-07 10:38:24 +08001776
Baolin Wang6c689882016-09-07 10:38:25 +08001777 nr_new = round_down(nr_new, card->erase_size);
1778 } else {
1779 rem = from_new % card->erase_size;
1780 if (rem) {
1781 rem = card->erase_size - rem;
1782 from_new += rem;
1783 if (nr_new > rem)
1784 nr_new -= rem;
1785 else
1786 return 0;
1787 }
1788
1789 rem = nr_new % card->erase_size;
1790 if (rem)
1791 nr_new -= rem;
1792 }
Baolin Wang71085122016-09-07 10:38:24 +08001793
1794 if (nr_new == 0)
1795 return 0;
1796
1797 *to = from_new + nr_new;
1798 *from = from_new;
1799
1800 return nr_new;
1801}
1802
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001803/**
1804 * mmc_erase - erase sectors.
1805 * @card: card to erase
1806 * @from: first sector to erase
1807 * @nr: number of sectors to erase
Avri Altmanbc47e2f2019-02-26 17:10:24 +02001808 * @arg: erase command argument
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001809 *
1810 * Caller must claim host before calling this function.
1811 */
1812int mmc_erase(struct mmc_card *card, unsigned int from, unsigned int nr,
1813 unsigned int arg)
1814{
1815 unsigned int rem, to = from + nr;
David Jander642c28a2015-06-23 11:43:52 +02001816 int err;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001817
Ulf Hansson94fe2582020-05-08 13:28:53 +02001818 if (!(card->csd.cmdclass & CCC_ERASE))
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001819 return -EOPNOTSUPP;
1820
1821 if (!card->erase_size)
1822 return -EOPNOTSUPP;
1823
Avri Altmanbc47e2f2019-02-26 17:10:24 +02001824 if (mmc_card_sd(card) && arg != SD_ERASE_ARG && arg != SD_DISCARD_ARG)
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001825 return -EOPNOTSUPP;
1826
Avri Altmanbc47e2f2019-02-26 17:10:24 +02001827 if (mmc_card_mmc(card) && (arg & MMC_SECURE_ARGS) &&
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001828 !(card->ext_csd.sec_feature_support & EXT_CSD_SEC_ER_EN))
1829 return -EOPNOTSUPP;
1830
Avri Altmanbc47e2f2019-02-26 17:10:24 +02001831 if (mmc_card_mmc(card) && (arg & MMC_TRIM_ARGS) &&
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001832 !(card->ext_csd.sec_feature_support & EXT_CSD_SEC_GB_CL_EN))
1833 return -EOPNOTSUPP;
1834
1835 if (arg == MMC_SECURE_ERASE_ARG) {
1836 if (from % card->erase_size || nr % card->erase_size)
1837 return -EINVAL;
1838 }
1839
Baolin Wang71085122016-09-07 10:38:24 +08001840 if (arg == MMC_ERASE_ARG)
1841 nr = mmc_align_erase_size(card, &from, &to, nr);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001842
1843 if (nr == 0)
1844 return 0;
1845
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001846 if (to <= from)
1847 return -EINVAL;
1848
1849 /* 'from' and 'to' are inclusive */
1850 to -= 1;
1851
David Jander642c28a2015-06-23 11:43:52 +02001852 /*
1853 * Special case where only one erase-group fits in the timeout budget:
1854 * If the region crosses an erase-group boundary on this particular
1855 * case, we will be trimming more than one erase-group which, does not
1856 * fit in the timeout budget of the controller, so we need to split it
1857 * and call mmc_do_erase() twice if necessary. This special case is
1858 * identified by the card->eg_boundary flag.
1859 */
Robin van der Gracht22d7e852015-08-04 08:58:33 +02001860 rem = card->erase_size - (from % card->erase_size);
1861 if ((arg & MMC_TRIM_ARGS) && (card->eg_boundary) && (nr > rem)) {
David Jander642c28a2015-06-23 11:43:52 +02001862 err = mmc_do_erase(card, from, from + rem - 1, arg);
1863 from += rem;
1864 if ((err) || (to <= from))
1865 return err;
1866 }
1867
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001868 return mmc_do_erase(card, from, to, arg);
1869}
1870EXPORT_SYMBOL(mmc_erase);
1871
1872int mmc_can_erase(struct mmc_card *card)
1873{
Ulf Hansson94fe2582020-05-08 13:28:53 +02001874 if (card->csd.cmdclass & CCC_ERASE && card->erase_size)
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001875 return 1;
1876 return 0;
1877}
1878EXPORT_SYMBOL(mmc_can_erase);
1879
1880int mmc_can_trim(struct mmc_card *card)
1881{
Shawn Linb5b4ff02015-08-12 13:08:32 +08001882 if ((card->ext_csd.sec_feature_support & EXT_CSD_SEC_GB_CL_EN) &&
1883 (!(card->quirks & MMC_QUIRK_TRIM_BROKEN)))
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001884 return 1;
1885 return 0;
1886}
1887EXPORT_SYMBOL(mmc_can_trim);
1888
Kyungmin Parkb3bf9152011-10-18 09:34:04 +09001889int mmc_can_discard(struct mmc_card *card)
1890{
1891 /*
1892 * As there's no way to detect the discard support bit at v4.5
1893 * use the s/w feature support filed.
1894 */
1895 if (card->ext_csd.feature_support & MMC_DISCARD_FEATURE)
1896 return 1;
1897 return 0;
1898}
1899EXPORT_SYMBOL(mmc_can_discard);
1900
Kyungmin Parkd9ddd622011-10-14 14:15:48 +09001901int mmc_can_sanitize(struct mmc_card *card)
1902{
Adrian Hunter28302812012-04-05 14:45:48 +03001903 if (!mmc_can_trim(card) && !mmc_can_erase(card))
1904 return 0;
Kyungmin Parkd9ddd622011-10-14 14:15:48 +09001905 if (card->ext_csd.sec_feature_support & EXT_CSD_SEC_SANITIZE)
1906 return 1;
1907 return 0;
1908}
Kyungmin Parkd9ddd622011-10-14 14:15:48 +09001909
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001910int mmc_can_secure_erase_trim(struct mmc_card *card)
1911{
Lukas Czerner5204d002014-06-18 13:18:07 +02001912 if ((card->ext_csd.sec_feature_support & EXT_CSD_SEC_ER_EN) &&
1913 !(card->quirks & MMC_QUIRK_SEC_ERASE_TRIM_BROKEN))
Adrian Hunterdfe86cb2010-08-11 14:17:46 -07001914 return 1;
1915 return 0;
1916}
1917EXPORT_SYMBOL(mmc_can_secure_erase_trim);
1918
1919int mmc_erase_group_aligned(struct mmc_card *card, unsigned int from,
1920 unsigned int nr)
1921{
1922 if (!card->erase_size)
1923 return 0;
1924 if (from % card->erase_size || nr % card->erase_size)
1925 return 0;
1926 return 1;
1927}
1928EXPORT_SYMBOL(mmc_erase_group_aligned);
Linus Torvalds1da177e2005-04-16 15:20:36 -07001929
Adrian Huntere056a1b2011-06-28 17:16:02 +03001930static unsigned int mmc_do_calc_max_discard(struct mmc_card *card,
1931 unsigned int arg)
1932{
1933 struct mmc_host *host = card->host;
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001934 unsigned int max_discard, x, y, qty = 0, max_qty, min_qty, timeout;
Adrian Huntere056a1b2011-06-28 17:16:02 +03001935 unsigned int last_timeout = 0;
Ulf Hansson12182af2016-07-27 00:04:03 +02001936 unsigned int max_busy_timeout = host->max_busy_timeout ?
1937 host->max_busy_timeout : MMC_ERASE_TIMEOUT_MS;
Adrian Huntere056a1b2011-06-28 17:16:02 +03001938
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001939 if (card->erase_shift) {
Adrian Huntere056a1b2011-06-28 17:16:02 +03001940 max_qty = UINT_MAX >> card->erase_shift;
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001941 min_qty = card->pref_erase >> card->erase_shift;
1942 } else if (mmc_card_sd(card)) {
Adrian Huntere056a1b2011-06-28 17:16:02 +03001943 max_qty = UINT_MAX;
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001944 min_qty = card->pref_erase;
1945 } else {
Adrian Huntere056a1b2011-06-28 17:16:02 +03001946 max_qty = UINT_MAX / card->erase_size;
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001947 min_qty = card->pref_erase / card->erase_size;
1948 }
Adrian Huntere056a1b2011-06-28 17:16:02 +03001949
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001950 /*
1951 * We should not only use 'host->max_busy_timeout' as the limitation
1952 * when deciding the max discard sectors. We should set a balance value
1953 * to improve the erase speed, and it can not get too long timeout at
1954 * the same time.
1955 *
1956 * Here we set 'card->pref_erase' as the minimal discard sectors no
1957 * matter what size of 'host->max_busy_timeout', but if the
1958 * 'host->max_busy_timeout' is large enough for more discard sectors,
1959 * then we can continue to increase the max discard sectors until we
Ulf Hansson12182af2016-07-27 00:04:03 +02001960 * get a balance value. In cases when the 'host->max_busy_timeout'
1961 * isn't specified, use the default max erase timeout.
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001962 */
Adrian Huntere056a1b2011-06-28 17:16:02 +03001963 do {
1964 y = 0;
1965 for (x = 1; x && x <= max_qty && max_qty - x >= qty; x <<= 1) {
1966 timeout = mmc_erase_timeout(card, arg, qty + x);
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001967
Ulf Hansson12182af2016-07-27 00:04:03 +02001968 if (qty + x > min_qty && timeout > max_busy_timeout)
Adrian Huntere056a1b2011-06-28 17:16:02 +03001969 break;
Baolin Wangbb4eecf2016-07-25 16:48:39 +08001970
Adrian Huntere056a1b2011-06-28 17:16:02 +03001971 if (timeout < last_timeout)
1972 break;
1973 last_timeout = timeout;
1974 y = x;
1975 }
1976 qty += y;
1977 } while (y);
1978
1979 if (!qty)
1980 return 0;
1981
David Jander642c28a2015-06-23 11:43:52 +02001982 /*
1983 * When specifying a sector range to trim, chances are we might cross
1984 * an erase-group boundary even if the amount of sectors is less than
1985 * one erase-group.
1986 * If we can only fit one erase-group in the controller timeout budget,
1987 * we have to care that erase-group boundaries are not crossed by a
1988 * single trim operation. We flag that special case with "eg_boundary".
1989 * In all other cases we can just decrement qty and pretend that we
1990 * always touch (qty + 1) erase-groups as a simple optimization.
1991 */
Adrian Huntere056a1b2011-06-28 17:16:02 +03001992 if (qty == 1)
David Jander642c28a2015-06-23 11:43:52 +02001993 card->eg_boundary = 1;
1994 else
1995 qty--;
Adrian Huntere056a1b2011-06-28 17:16:02 +03001996
1997 /* Convert qty to sectors */
1998 if (card->erase_shift)
David Jander642c28a2015-06-23 11:43:52 +02001999 max_discard = qty << card->erase_shift;
Adrian Huntere056a1b2011-06-28 17:16:02 +03002000 else if (mmc_card_sd(card))
David Jander642c28a2015-06-23 11:43:52 +02002001 max_discard = qty + 1;
Adrian Huntere056a1b2011-06-28 17:16:02 +03002002 else
David Jander642c28a2015-06-23 11:43:52 +02002003 max_discard = qty * card->erase_size;
Adrian Huntere056a1b2011-06-28 17:16:02 +03002004
2005 return max_discard;
2006}
2007
2008unsigned int mmc_calc_max_discard(struct mmc_card *card)
2009{
2010 struct mmc_host *host = card->host;
2011 unsigned int max_discard, max_trim;
2012
Adrian Huntere056a1b2011-06-28 17:16:02 +03002013 /*
2014 * Without erase_group_def set, MMC erase timeout depends on clock
2015 * frequence which can change. In that case, the best choice is
2016 * just the preferred erase size.
2017 */
2018 if (mmc_card_mmc(card) && !(card->ext_csd.erase_group_def & 1))
2019 return card->pref_erase;
2020
2021 max_discard = mmc_do_calc_max_discard(card, MMC_ERASE_ARG);
Jiong Wud4721332019-03-01 00:18:33 +08002022 if (mmc_can_trim(card)) {
Adrian Huntere056a1b2011-06-28 17:16:02 +03002023 max_trim = mmc_do_calc_max_discard(card, MMC_TRIM_ARG);
Jiong Wud4721332019-03-01 00:18:33 +08002024 if (max_trim < max_discard || max_discard == 0)
Adrian Huntere056a1b2011-06-28 17:16:02 +03002025 max_discard = max_trim;
2026 } else if (max_discard < card->erase_size) {
2027 max_discard = 0;
2028 }
2029 pr_debug("%s: calculated max. discard sectors %u for timeout %u ms\n",
Ulf Hansson12182af2016-07-27 00:04:03 +02002030 mmc_hostname(host), max_discard, host->max_busy_timeout ?
2031 host->max_busy_timeout : MMC_ERASE_TIMEOUT_MS);
Adrian Huntere056a1b2011-06-28 17:16:02 +03002032 return max_discard;
2033}
2034EXPORT_SYMBOL(mmc_calc_max_discard);
2035
Ulf Hansson33e6d742017-04-24 13:41:55 -05002036bool mmc_card_is_blockaddr(struct mmc_card *card)
2037{
2038 return card ? mmc_card_blockaddr(card) : false;
2039}
2040EXPORT_SYMBOL(mmc_card_is_blockaddr);
2041
Adrian Hunter0f8d8ea2010-08-24 13:20:26 +03002042int mmc_set_blocklen(struct mmc_card *card, unsigned int blocklen)
2043{
Masahiro Yamadac7836d12016-12-19 20:51:18 +09002044 struct mmc_command cmd = {};
Adrian Hunter0f8d8ea2010-08-24 13:20:26 +03002045
Ziyuan Xu1712c932016-09-21 09:43:49 +08002046 if (mmc_card_blockaddr(card) || mmc_card_ddr52(card) ||
2047 mmc_card_hs400(card) || mmc_card_hs400es(card))
Adrian Hunter0f8d8ea2010-08-24 13:20:26 +03002048 return 0;
2049
Adrian Hunter0f8d8ea2010-08-24 13:20:26 +03002050 cmd.opcode = MMC_SET_BLOCKLEN;
2051 cmd.arg = blocklen;
2052 cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_AC;
2053 return mmc_wait_for_cmd(card->host, &cmd, 5);
2054}
2055EXPORT_SYMBOL(mmc_set_blocklen);
2056
Adrian Hunterb2499512011-08-29 16:42:11 +03002057static void mmc_hw_reset_for_init(struct mmc_host *host)
2058{
Ulf Hansson52c82122017-05-08 23:52:04 +02002059 mmc_pwrseq_reset(host);
2060
Adrian Hunterb2499512011-08-29 16:42:11 +03002061 if (!(host->caps & MMC_CAP_HW_RESET) || !host->ops->hw_reset)
2062 return;
Adrian Hunterb2499512011-08-29 16:42:11 +03002063 host->ops->hw_reset(host);
Adrian Hunterb2499512011-08-29 16:42:11 +03002064}
2065
Wolfram Sang3439c582020-09-18 23:54:46 +02002066/**
2067 * mmc_hw_reset - reset the card in hardware
2068 * @host: MMC host to which the card is attached
2069 *
2070 * Hard reset the card. This function is only for upper layers, like the
2071 * block layer or card drivers. You cannot use it in host drivers (struct
2072 * mmc_card might be gone then).
2073 *
2074 * Return: 0 on success, -errno on failure
2075 */
Johan Rudholm83533ab2015-01-12 15:38:04 +01002076int mmc_hw_reset(struct mmc_host *host)
Adrian Hunterb2499512011-08-29 16:42:11 +03002077{
Johan Rudholmf855a372015-01-12 15:38:05 +01002078 int ret;
Adrian Hunterb2499512011-08-29 16:42:11 +03002079
Johan Rudholmf855a372015-01-12 15:38:05 +01002080 if (!host->card)
Adrian Hunterb2499512011-08-29 16:42:11 +03002081 return -EINVAL;
2082
Johan Rudholmf855a372015-01-12 15:38:05 +01002083 mmc_bus_get(host);
Ulf Hansson3a3db602018-04-05 13:24:43 +02002084 if (!host->bus_ops || host->bus_dead || !host->bus_ops->hw_reset) {
Johan Rudholmf855a372015-01-12 15:38:05 +01002085 mmc_bus_put(host);
Adrian Hunterb2499512011-08-29 16:42:11 +03002086 return -EOPNOTSUPP;
Adrian Hunterb2499512011-08-29 16:42:11 +03002087 }
2088
Ulf Hansson3a3db602018-04-05 13:24:43 +02002089 ret = host->bus_ops->hw_reset(host);
Johan Rudholmf855a372015-01-12 15:38:05 +01002090 mmc_bus_put(host);
Adrian Hunterb2499512011-08-29 16:42:11 +03002091
Ulf Hansson2ac55d52019-10-17 15:25:36 +02002092 if (ret < 0)
Ulf Hansson3a3db602018-04-05 13:24:43 +02002093 pr_warn("%s: tried to HW reset card, got error %d\n",
Gwendal Grignou4e6c7172016-04-01 16:04:22 -07002094 mmc_hostname(host), ret);
Adrian Hunterb2499512011-08-29 16:42:11 +03002095
Johan Rudholmf855a372015-01-12 15:38:05 +01002096 return ret;
Adrian Hunterb2499512011-08-29 16:42:11 +03002097}
Adrian Hunterb2499512011-08-29 16:42:11 +03002098EXPORT_SYMBOL(mmc_hw_reset);
2099
Ulf Hansson14332692018-04-05 13:42:00 +02002100int mmc_sw_reset(struct mmc_host *host)
2101{
2102 int ret;
2103
2104 if (!host->card)
2105 return -EINVAL;
2106
2107 mmc_bus_get(host);
2108 if (!host->bus_ops || host->bus_dead || !host->bus_ops->sw_reset) {
2109 mmc_bus_put(host);
2110 return -EOPNOTSUPP;
2111 }
2112
2113 ret = host->bus_ops->sw_reset(host);
2114 mmc_bus_put(host);
2115
2116 if (ret)
2117 pr_warn("%s: tried to SW reset card, got error %d\n",
2118 mmc_hostname(host), ret);
2119
2120 return ret;
2121}
2122EXPORT_SYMBOL(mmc_sw_reset);
2123
Andy Ross807e8e42011-01-03 10:36:56 -08002124static int mmc_rescan_try_freq(struct mmc_host *host, unsigned freq)
2125{
2126 host->f_init = freq;
2127
Shawn Lin69f25f92017-07-19 15:55:46 +08002128 pr_debug("%s: %s: trying to init card at %u Hz\n",
Andy Ross807e8e42011-01-03 10:36:56 -08002129 mmc_hostname(host), __func__, host->f_init);
Shawn Lin69f25f92017-07-19 15:55:46 +08002130
Ulf Hansson4a065192013-09-12 14:36:53 +02002131 mmc_power_up(host, host->ocr_avail);
Philip Rakity2f94e552011-02-13 23:12:28 -08002132
2133 /*
Adrian Hunterb2499512011-08-29 16:42:11 +03002134 * Some eMMCs (with VCCQ always on) may not be reset after power up, so
2135 * do a hardware reset if possible.
2136 */
2137 mmc_hw_reset_for_init(host);
2138
2139 /*
Philip Rakity2f94e552011-02-13 23:12:28 -08002140 * sdio_reset sends CMD52 to reset card. Since we do not know
2141 * if the card is being re-initialized, just send it. CMD52
2142 * should be ignored by SD/eMMC cards.
Carlo Caione100a6062015-11-25 15:39:51 +01002143 * Skip it if we already know that we do not support SDIO commands
Philip Rakity2f94e552011-02-13 23:12:28 -08002144 */
Carlo Caione100a6062015-11-25 15:39:51 +01002145 if (!(host->caps2 & MMC_CAP2_NO_SDIO))
2146 sdio_reset(host);
2147
Andy Ross807e8e42011-01-03 10:36:56 -08002148 mmc_go_idle(host);
2149
Ulf Hansson1b8d79c2016-06-21 15:12:46 +02002150 if (!(host->caps2 & MMC_CAP2_NO_SD))
2151 mmc_send_if_cond(host, host->ocr_avail);
Andy Ross807e8e42011-01-03 10:36:56 -08002152
2153 /* Order's important: probe SDIO, then SD, then MMC */
Carlo Caione100a6062015-11-25 15:39:51 +01002154 if (!(host->caps2 & MMC_CAP2_NO_SDIO))
2155 if (!mmc_attach_sdio(host))
2156 return 0;
2157
Ulf Hansson1b8d79c2016-06-21 15:12:46 +02002158 if (!(host->caps2 & MMC_CAP2_NO_SD))
2159 if (!mmc_attach_sd(host))
2160 return 0;
2161
Shawn Lina0c3b682016-07-01 15:45:28 +08002162 if (!(host->caps2 & MMC_CAP2_NO_MMC))
2163 if (!mmc_attach_mmc(host))
2164 return 0;
Andy Ross807e8e42011-01-03 10:36:56 -08002165
2166 mmc_power_off(host);
2167 return -EIO;
2168}
2169
Adrian Hunterd3049502011-11-28 16:22:00 +02002170int _mmc_detect_card_removed(struct mmc_host *host)
2171{
2172 int ret;
2173
Adrian Hunterd3049502011-11-28 16:22:00 +02002174 if (!host->card || mmc_card_removed(host->card))
2175 return 1;
2176
2177 ret = host->bus_ops->alive(host);
Kevin Liu14507342013-02-28 15:29:29 +08002178
2179 /*
2180 * Card detect status and alive check may be out of sync if card is
2181 * removed slowly, when card detect switch changes while card/slot
2182 * pads are still contacted in hardware (refer to "SD Card Mechanical
2183 * Addendum, Appendix C: Card Detection Switch"). So reschedule a
2184 * detect work 200ms later for this case.
2185 */
2186 if (!ret && host->ops->get_cd && !host->ops->get_cd(host)) {
2187 mmc_detect_change(host, msecs_to_jiffies(200));
2188 pr_debug("%s: card removed too slowly\n", mmc_hostname(host));
2189 }
2190
Adrian Hunterd3049502011-11-28 16:22:00 +02002191 if (ret) {
2192 mmc_card_set_removed(host->card);
2193 pr_debug("%s: card remove detected\n", mmc_hostname(host));
2194 }
2195
2196 return ret;
2197}
2198
2199int mmc_detect_card_removed(struct mmc_host *host)
2200{
2201 struct mmc_card *card = host->card;
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002202 int ret;
Adrian Hunterd3049502011-11-28 16:22:00 +02002203
2204 WARN_ON(!host->claimed);
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002205
2206 if (!card)
2207 return 1;
2208
Jaehoon Chung6067bafe42016-01-29 08:52:57 +09002209 if (!mmc_card_is_removable(host))
Ulf Hansson1ff25752015-11-05 16:21:39 +01002210 return 0;
2211
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002212 ret = mmc_card_removed(card);
Adrian Hunterd3049502011-11-28 16:22:00 +02002213 /*
2214 * The card will be considered unchanged unless we have been asked to
2215 * detect a change or host requires polling to provide card detection.
2216 */
Ulf Hanssonb6891672013-04-18 11:02:07 +02002217 if (!host->detect_change && !(host->caps & MMC_CAP_NEEDS_POLL))
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002218 return ret;
Adrian Hunterd3049502011-11-28 16:22:00 +02002219
2220 host->detect_change = 0;
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002221 if (!ret) {
2222 ret = _mmc_detect_card_removed(host);
Ulf Hanssonb6891672013-04-18 11:02:07 +02002223 if (ret && (host->caps & MMC_CAP_NEEDS_POLL)) {
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002224 /*
2225 * Schedule a detect work as soon as possible to let a
2226 * rescan handle the card removal.
2227 */
2228 cancel_delayed_work(&host->detect);
Ulf Hanssonbbd43682013-09-20 11:02:35 +02002229 _mmc_detect_change(host, 0, false);
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002230 }
2231 }
Adrian Hunterd3049502011-11-28 16:22:00 +02002232
Ulf Hanssonf0cc9cf2012-02-06 10:42:39 +01002233 return ret;
Adrian Hunterd3049502011-11-28 16:22:00 +02002234}
2235EXPORT_SYMBOL(mmc_detect_card_removed);
2236
Pierre Ossmanb93931a2007-05-19 14:06:24 +02002237void mmc_rescan(struct work_struct *work)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002238{
David Howellsc4028952006-11-22 14:57:56 +00002239 struct mmc_host *host =
2240 container_of(work, struct mmc_host, detect.work);
Hein Tibosch88ae8b82010-09-06 09:37:19 +08002241 int i;
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002242
Andy Ross807e8e42011-01-03 10:36:56 -08002243 if (host->rescan_disable)
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002244 return;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002245
Johan Rudholm3339d1e2012-08-23 13:40:55 +02002246 /* If there is a non-removable card registered, only scan once */
Jaehoon Chung6067bafe42016-01-29 08:52:57 +09002247 if (!mmc_card_is_removable(host) && host->rescan_entered)
Johan Rudholm3339d1e2012-08-23 13:40:55 +02002248 return;
2249 host->rescan_entered = 1;
2250
Ulf Hansson86236812015-11-05 16:08:07 +01002251 if (host->trigger_card_event && host->ops->card_event) {
Ulf Hanssond234d212015-11-05 16:08:08 +01002252 mmc_claim_host(host);
Ulf Hansson86236812015-11-05 16:08:07 +01002253 host->ops->card_event(host);
Ulf Hanssond234d212015-11-05 16:08:08 +01002254 mmc_release_host(host);
Ulf Hansson86236812015-11-05 16:08:07 +01002255 host->trigger_card_event = false;
2256 }
2257
Pierre Ossman7ea239d2006-12-31 00:11:32 +01002258 mmc_bus_get(host);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002259
Ulf Hansson99b4ddd2019-10-10 15:54:37 +02002260 /* Verify a registered card to be functional, else remove it. */
2261 if (host->bus_ops && !host->bus_dead)
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002262 host->bus_ops->detect(host);
2263
Adrian Hunterd3049502011-11-28 16:22:00 +02002264 host->detect_change = 0;
2265
Chris Ballc5841792011-01-04 12:20:22 -05002266 /*
2267 * Let mmc_bus_put() free the bus/bus_ops if we've found that
2268 * the card is no longer present.
2269 */
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002270 mmc_bus_put(host);
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002271 mmc_bus_get(host);
2272
2273 /* if there still is a card present, stop here */
2274 if (host->bus_ops != NULL) {
Pierre Ossman7ea239d2006-12-31 00:11:32 +01002275 mmc_bus_put(host);
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002276 goto out;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002277 }
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002278
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002279 /*
2280 * Only we can add a new handler, so it's safe to
2281 * release the lock here.
2282 */
2283 mmc_bus_put(host);
2284
Ulf Hanssond234d212015-11-05 16:08:08 +01002285 mmc_claim_host(host);
Jaehoon Chung6067bafe42016-01-29 08:52:57 +09002286 if (mmc_card_is_removable(host) && host->ops->get_cd &&
Sascha Hauerc1b55bf2013-12-05 14:34:46 +01002287 host->ops->get_cd(host) == 0) {
Ulf Hanssonfa550182012-05-09 16:15:26 +02002288 mmc_power_off(host);
2289 mmc_release_host(host);
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002290 goto out;
Ulf Hanssonfa550182012-05-09 16:15:26 +02002291 }
Jorg Schummer94d89ef2009-03-31 17:51:21 +03002292
Hein Tibosch88ae8b82010-09-06 09:37:19 +08002293 for (i = 0; i < ARRAY_SIZE(freqs); i++) {
Michał Mirosław661cf2d2020-01-02 11:54:58 +01002294 unsigned int freq = freqs[i];
2295 if (freq > host->f_max) {
2296 if (i + 1 < ARRAY_SIZE(freqs))
2297 continue;
2298 freq = host->f_max;
2299 }
2300 if (!mmc_rescan_try_freq(host, max(freq, host->f_min)))
Andy Ross807e8e42011-01-03 10:36:56 -08002301 break;
Jaehoon Chung06b22332011-05-12 17:18:59 +09002302 if (freqs[i] <= host->f_min)
Andy Ross807e8e42011-01-03 10:36:56 -08002303 break;
Hein Tibosch88ae8b82010-09-06 09:37:19 +08002304 }
Andy Ross807e8e42011-01-03 10:36:56 -08002305 mmc_release_host(host);
2306
2307 out:
Anton Vorontsov28f52482008-06-17 18:17:15 +04002308 if (host->caps & MMC_CAP_NEEDS_POLL)
2309 mmc_schedule_delayed_work(&host->detect, HZ);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002310}
2311
Pierre Ossmanb93931a2007-05-19 14:06:24 +02002312void mmc_start_host(struct mmc_host *host)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002313{
Michał Mirosław661cf2d2020-01-02 11:54:58 +01002314 host->f_init = max(min(freqs[0], host->f_max), host->f_min);
Guennadi Liakhovetskid9adcc12012-06-14 10:17:39 +02002315 host->rescan_disable = 0;
Ulf Hansson8d1ffc8c2015-09-11 14:41:55 +02002316
Ulf Hanssonc2c24812016-10-13 13:37:40 +02002317 if (!(host->caps2 & MMC_CAP2_NO_PRESCAN_POWERUP)) {
2318 mmc_claim_host(host);
Ulf Hansson4a065192013-09-12 14:36:53 +02002319 mmc_power_up(host, host->ocr_avail);
Ulf Hanssonc2c24812016-10-13 13:37:40 +02002320 mmc_release_host(host);
2321 }
Ulf Hansson8d1ffc8c2015-09-11 14:41:55 +02002322
Adrian Hunter740a2212014-03-10 15:02:41 +02002323 mmc_gpiod_request_cd_irq(host);
Ulf Hanssonbbd43682013-09-20 11:02:35 +02002324 _mmc_detect_change(host, 0, false);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002325}
2326
Pierre Ossmanb93931a2007-05-19 14:06:24 +02002327void mmc_stop_host(struct mmc_host *host)
Linus Torvalds1da177e2005-04-16 15:20:36 -07002328{
Adrian Hunter03dbaa02017-06-13 15:07:51 +03002329 if (host->slot.cd_irq >= 0) {
Adrian Hunter36f1d7e2018-02-27 14:51:25 +02002330 mmc_gpio_set_cd_wake(host, false);
Adrian Hunter740a2212014-03-10 15:02:41 +02002331 disable_irq(host->slot.cd_irq);
Adrian Hunter03dbaa02017-06-13 15:07:51 +03002332 }
Pierre Ossman3b91e552007-02-11 20:43:19 +01002333
Guennadi Liakhovetskid9adcc12012-06-14 10:17:39 +02002334 host->rescan_disable = 1;
Guennadi Liakhovetskid9bcbf32010-11-11 17:32:25 +01002335 cancel_delayed_work_sync(&host->detect);
Pierre Ossman3b91e552007-02-11 20:43:19 +01002336
Nicolas Pitreda68c4e2010-03-05 13:43:31 -08002337 /* clear pm flags now and let card drivers set them as needed */
2338 host->pm_flags = 0;
2339
Pierre Ossman7ea239d2006-12-31 00:11:32 +01002340 mmc_bus_get(host);
2341 if (host->bus_ops && !host->bus_dead) {
Guennadi Liakhovetski0db13fc2012-01-04 15:28:45 +01002342 /* Calling bus_ops->remove() with a claimed host can deadlock */
Ulf Hansson58a8a4a2013-06-10 17:03:36 +02002343 host->bus_ops->remove(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01002344 mmc_claim_host(host);
2345 mmc_detach_bus(host);
Ulf Hansson7f7e4122011-09-21 14:08:13 -04002346 mmc_power_off(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01002347 mmc_release_host(host);
Denis Karpov53509f02009-09-22 16:44:36 -07002348 mmc_bus_put(host);
2349 return;
Linus Torvalds1da177e2005-04-16 15:20:36 -07002350 }
Pierre Ossman7ea239d2006-12-31 00:11:32 +01002351 mmc_bus_put(host);
2352
Ulf Hansson8d1ffc8c2015-09-11 14:41:55 +02002353 mmc_claim_host(host);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002354 mmc_power_off(host);
Ulf Hansson8d1ffc8c2015-09-11 14:41:55 +02002355 mmc_release_host(host);
Linus Torvalds1da177e2005-04-16 15:20:36 -07002356}
2357
Ulf Hansson8dede182015-11-05 16:11:12 +01002358#ifdef CONFIG_PM_SLEEP
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002359/* Do the card removal on suspend if card is assumed removeable
2360 * Do that in pm notifier while userspace isn't yet frozen, so we will be able
2361 to sync the card.
2362*/
Ulf Hansson8dede182015-11-05 16:11:12 +01002363static int mmc_pm_notify(struct notifier_block *notify_block,
2364 unsigned long mode, void *unused)
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002365{
2366 struct mmc_host *host = container_of(
2367 notify_block, struct mmc_host, pm_notify);
2368 unsigned long flags;
Ulf Hansson810cadd2013-06-10 17:03:37 +02002369 int err = 0;
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002370
2371 switch (mode) {
2372 case PM_HIBERNATION_PREPARE:
2373 case PM_SUSPEND_PREPARE:
Grygorii Strashko184af162015-04-23 13:43:43 +03002374 case PM_RESTORE_PREPARE:
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002375 spin_lock_irqsave(&host->lock, flags);
2376 host->rescan_disable = 1;
2377 spin_unlock_irqrestore(&host->lock, flags);
2378 cancel_delayed_work_sync(&host->detect);
2379
Ulf Hansson810cadd2013-06-10 17:03:37 +02002380 if (!host->bus_ops)
2381 break;
2382
2383 /* Validate prerequisites for suspend */
2384 if (host->bus_ops->pre_suspend)
2385 err = host->bus_ops->pre_suspend(host);
Ulf Hansson5601aaf2013-10-30 23:15:30 +01002386 if (!err)
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002387 break;
2388
Daniel Drakede8dcc32017-12-12 10:49:02 +00002389 if (!mmc_card_is_removable(host)) {
2390 dev_warn(mmc_dev(host),
2391 "pre_suspend failed for non-removable host: "
2392 "%d\n", err);
2393 /* Avoid removing non-removable hosts */
2394 break;
2395 }
2396
Guennadi Liakhovetski0db13fc2012-01-04 15:28:45 +01002397 /* Calling bus_ops->remove() with a claimed host can deadlock */
Ulf Hansson58a8a4a2013-06-10 17:03:36 +02002398 host->bus_ops->remove(host);
Guennadi Liakhovetski0db13fc2012-01-04 15:28:45 +01002399 mmc_claim_host(host);
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002400 mmc_detach_bus(host);
Ulf Hansson7f7e4122011-09-21 14:08:13 -04002401 mmc_power_off(host);
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002402 mmc_release_host(host);
2403 host->pm_flags = 0;
2404 break;
2405
2406 case PM_POST_SUSPEND:
2407 case PM_POST_HIBERNATION:
Takashi Iwai274476f2010-12-10 08:40:31 +01002408 case PM_POST_RESTORE:
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002409
2410 spin_lock_irqsave(&host->lock, flags);
2411 host->rescan_disable = 0;
2412 spin_unlock_irqrestore(&host->lock, flags);
Ulf Hanssonbbd43682013-09-20 11:02:35 +02002413 _mmc_detect_change(host, 0, false);
Maxim Levitsky4c2ef252010-08-10 18:01:41 -07002414
2415 }
2416
2417 return 0;
2418}
Ulf Hansson8dede182015-11-05 16:11:12 +01002419
2420void mmc_register_pm_notifier(struct mmc_host *host)
2421{
2422 host->pm_notify.notifier_call = mmc_pm_notify;
2423 register_pm_notifier(&host->pm_notify);
2424}
2425
2426void mmc_unregister_pm_notifier(struct mmc_host *host)
2427{
2428 unregister_pm_notifier(&host->pm_notify);
2429}
Linus Torvalds1da177e2005-04-16 15:20:36 -07002430#endif
2431
Pierre Ossmanffce2e72007-05-19 14:32:22 +02002432static int __init mmc_init(void)
2433{
2434 int ret;
2435
Pierre Ossmanffce2e72007-05-19 14:32:22 +02002436 ret = mmc_register_bus();
Pierre Ossmane29a7d72007-05-26 13:48:18 +02002437 if (ret)
Ulf Hansson520bd7a2015-12-01 10:35:29 +01002438 return ret;
Pierre Ossmane29a7d72007-05-26 13:48:18 +02002439
2440 ret = mmc_register_host_class();
2441 if (ret)
2442 goto unregister_bus;
2443
2444 ret = sdio_register_bus();
2445 if (ret)
2446 goto unregister_host_class;
2447
2448 return 0;
2449
2450unregister_host_class:
2451 mmc_unregister_host_class();
2452unregister_bus:
2453 mmc_unregister_bus();
Pierre Ossmanffce2e72007-05-19 14:32:22 +02002454 return ret;
2455}
2456
2457static void __exit mmc_exit(void)
2458{
Pierre Ossmane29a7d72007-05-26 13:48:18 +02002459 sdio_unregister_bus();
Pierre Ossmanffce2e72007-05-19 14:32:22 +02002460 mmc_unregister_host_class();
2461 mmc_unregister_bus();
Pierre Ossmanffce2e72007-05-19 14:32:22 +02002462}
2463
Nicolas Pitre26074962007-06-16 02:07:53 -04002464subsys_initcall(mmc_init);
Pierre Ossmanffce2e72007-05-19 14:32:22 +02002465module_exit(mmc_exit);
2466
Linus Torvalds1da177e2005-04-16 15:20:36 -07002467MODULE_LICENSE("GPL");