Branch data Line data Source code
1 : : // SPDX-License-Identifier: GPL-2.0-or-later
2 : : /*
3 : : * linux/drivers/mmc/core/sd_ops.h
4 : : *
5 : : * Copyright 2006-2007 Pierre Ossman
6 : : */
7 : :
8 : : #include <linux/slab.h>
9 : : #include <linux/types.h>
10 : : #include <linux/export.h>
11 : : #include <linux/scatterlist.h>
12 : :
13 : : #include <linux/mmc/host.h>
14 : : #include <linux/mmc/card.h>
15 : : #include <linux/mmc/mmc.h>
16 : : #include <linux/mmc/sd.h>
17 : :
18 : : #include "core.h"
19 : : #include "sd_ops.h"
20 : :
21 : 1656 : int mmc_app_cmd(struct mmc_host *host, struct mmc_card *card)
22 : : {
23 : : int err;
24 : 1656 : struct mmc_command cmd = {};
25 : :
26 [ + + + - : 1656 : if (WARN_ON(card && card->host != host))
- + + - ]
27 : : return -EINVAL;
28 : :
29 : 1656 : cmd.opcode = MMC_APP_CMD;
30 : :
31 [ + + ]: 1656 : if (card) {
32 : 621 : cmd.arg = card->rca << 16;
33 : 621 : cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_AC;
34 : : } else {
35 : 1035 : cmd.arg = 0;
36 : 1035 : cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_BCR;
37 : : }
38 : :
39 : 1656 : err = mmc_wait_for_cmd(host, &cmd, 0);
40 [ + - ]: 1656 : if (err)
41 : : return err;
42 : :
43 : : /* Check that card supported application commands */
44 [ + - + - ]: 1656 : if (!mmc_host_is_spi(host) && !(cmd.resp[0] & R1_APP_CMD))
45 : : return -EOPNOTSUPP;
46 : :
47 : 1656 : return 0;
48 : : }
49 : : EXPORT_SYMBOL_GPL(mmc_app_cmd);
50 : :
51 : 1242 : static int mmc_wait_for_app_cmd(struct mmc_host *host, struct mmc_card *card,
52 : : struct mmc_command *cmd)
53 : : {
54 : 1242 : struct mmc_request mrq = {};
55 : : int i, err = -EIO;
56 : :
57 : : /*
58 : : * We have to resend MMC_APP_CMD for each attempt so
59 : : * we cannot use the retries field in mmc_command.
60 : : */
61 [ + - ]: 1242 : for (i = 0; i <= MMC_CMD_RETRIES; i++) {
62 : 1242 : err = mmc_app_cmd(host, card);
63 [ - + ]: 1242 : if (err) {
64 : : /* no point in retrying; no APP commands allowed */
65 [ # # ]: 0 : if (mmc_host_is_spi(host)) {
66 [ # # ]: 0 : if (cmd->resp[0] & R1_SPI_ILLEGAL_COMMAND)
67 : : break;
68 : : }
69 : 0 : continue;
70 : : }
71 : :
72 : 1242 : memset(&mrq, 0, sizeof(struct mmc_request));
73 : :
74 : 1242 : memset(cmd->resp, 0, sizeof(cmd->resp));
75 : 1242 : cmd->retries = 0;
76 : :
77 : 1242 : mrq.cmd = cmd;
78 : 1242 : cmd->data = NULL;
79 : :
80 : 1242 : mmc_wait_for_req(host, &mrq);
81 : :
82 : 1242 : err = cmd->error;
83 [ - + ]: 1242 : if (!cmd->error)
84 : : break;
85 : :
86 : : /* no point in retrying illegal APP commands */
87 [ # # ]: 0 : if (mmc_host_is_spi(host)) {
88 [ # # ]: 0 : if (cmd->resp[0] & R1_SPI_ILLEGAL_COMMAND)
89 : : break;
90 : : }
91 : : }
92 : :
93 : 1242 : return err;
94 : : }
95 : :
96 : 207 : int mmc_app_set_bus_width(struct mmc_card *card, int width)
97 : : {
98 : 207 : struct mmc_command cmd = {};
99 : :
100 : 207 : cmd.opcode = SD_APP_SET_BUS_WIDTH;
101 : 207 : cmd.flags = MMC_RSP_R1 | MMC_CMD_AC;
102 : :
103 [ + - - ]: 207 : switch (width) {
104 : : case MMC_BUS_WIDTH_1:
105 : : cmd.arg = SD_BUS_WIDTH_1;
106 : : break;
107 : : case MMC_BUS_WIDTH_4:
108 : 207 : cmd.arg = SD_BUS_WIDTH_4;
109 : 207 : break;
110 : : default:
111 : : return -EINVAL;
112 : : }
113 : :
114 : 207 : return mmc_wait_for_app_cmd(card->host, card, &cmd);
115 : : }
116 : :
117 : 414 : int mmc_send_app_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr)
118 : : {
119 : 414 : struct mmc_command cmd = {};
120 : : int i, err = 0;
121 : :
122 : 414 : cmd.opcode = SD_APP_OP_COND;
123 [ - + ]: 414 : if (mmc_host_is_spi(host))
124 : 0 : cmd.arg = ocr & (1 << 30); /* SPI only defines one bit */
125 : : else
126 : 414 : cmd.arg = ocr;
127 : 414 : cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R3 | MMC_CMD_BCR;
128 : :
129 [ + - ]: 1035 : for (i = 100; i; i--) {
130 : 1035 : err = mmc_wait_for_app_cmd(host, NULL, &cmd);
131 [ + - ]: 1035 : if (err)
132 : : break;
133 : :
134 : : /* if we're just probing, do a single pass */
135 [ + + ]: 1035 : if (ocr == 0)
136 : : break;
137 : :
138 : : /* otherwise wait until reset completes */
139 [ - + ]: 828 : if (mmc_host_is_spi(host)) {
140 [ # # ]: 0 : if (!(cmd.resp[0] & R1_SPI_IDLE))
141 : : break;
142 : : } else {
143 [ + + ]: 828 : if (cmd.resp[0] & MMC_CARD_BUSY)
144 : : break;
145 : : }
146 : :
147 : : err = -ETIMEDOUT;
148 : :
149 : 621 : mmc_delay(10);
150 : : }
151 : :
152 [ - + ]: 414 : if (!i)
153 : 0 : pr_err("%s: card never left busy state\n", mmc_hostname(host));
154 : :
155 [ + - + - ]: 414 : if (rocr && !mmc_host_is_spi(host))
156 : 414 : *rocr = cmd.resp[0];
157 : :
158 : 414 : return err;
159 : : }
160 : :
161 : 414 : int mmc_send_if_cond(struct mmc_host *host, u32 ocr)
162 : : {
163 : 414 : struct mmc_command cmd = {};
164 : : int err;
165 : : static const u8 test_pattern = 0xAA;
166 : : u8 result_pattern;
167 : :
168 : : /*
169 : : * To support SD 2.0 cards, we must always invoke SD_SEND_IF_COND
170 : : * before SD_APP_OP_COND. This command will harmlessly fail for
171 : : * SD 1.0 cards.
172 : : */
173 : 414 : cmd.opcode = SD_SEND_IF_COND;
174 [ - + ]: 414 : cmd.arg = ((ocr & 0xFF8000) != 0) << 8 | test_pattern;
175 : 414 : cmd.flags = MMC_RSP_SPI_R7 | MMC_RSP_R7 | MMC_CMD_BCR;
176 : :
177 : 414 : err = mmc_wait_for_cmd(host, &cmd, 0);
178 [ + - ]: 414 : if (err)
179 : : return err;
180 : :
181 [ - + ]: 414 : if (mmc_host_is_spi(host))
182 : 0 : result_pattern = cmd.resp[1] & 0xFF;
183 : : else
184 : 414 : result_pattern = cmd.resp[0] & 0xFF;
185 : :
186 [ + - ]: 414 : if (result_pattern != test_pattern)
187 : : return -EIO;
188 : :
189 : 414 : return 0;
190 : : }
191 : :
192 : 207 : int mmc_send_relative_addr(struct mmc_host *host, unsigned int *rca)
193 : : {
194 : : int err;
195 : 207 : struct mmc_command cmd = {};
196 : :
197 : 207 : cmd.opcode = SD_SEND_RELATIVE_ADDR;
198 : : cmd.arg = 0;
199 : 207 : cmd.flags = MMC_RSP_R6 | MMC_CMD_BCR;
200 : :
201 : 207 : err = mmc_wait_for_cmd(host, &cmd, MMC_CMD_RETRIES);
202 [ + - ]: 207 : if (err)
203 : : return err;
204 : :
205 : 207 : *rca = cmd.resp[0] >> 16;
206 : :
207 : 207 : return 0;
208 : : }
209 : :
210 : 207 : int mmc_app_send_scr(struct mmc_card *card)
211 : : {
212 : : int err;
213 : 207 : struct mmc_request mrq = {};
214 : 207 : struct mmc_command cmd = {};
215 : 207 : struct mmc_data data = {};
216 : : struct scatterlist sg;
217 : : __be32 *scr;
218 : :
219 : : /* NOTE: caller guarantees scr is heap-allocated */
220 : :
221 : 207 : err = mmc_app_cmd(card->host, card);
222 [ + - ]: 207 : if (err)
223 : : return err;
224 : :
225 : : /* dma onto stack is unsafe/nonportable, but callers to this
226 : : * routine normally provide temporary on-stack buffers ...
227 : : */
228 : : scr = kmalloc(sizeof(card->raw_scr), GFP_KERNEL);
229 [ + - ]: 207 : if (!scr)
230 : : return -ENOMEM;
231 : :
232 : 207 : mrq.cmd = &cmd;
233 : 207 : mrq.data = &data;
234 : :
235 : 207 : cmd.opcode = SD_APP_SEND_SCR;
236 : 207 : cmd.arg = 0;
237 : 207 : cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_ADTC;
238 : :
239 : 207 : data.blksz = 8;
240 : 207 : data.blocks = 1;
241 : 207 : data.flags = MMC_DATA_READ;
242 : 207 : data.sg = &sg;
243 : 207 : data.sg_len = 1;
244 : :
245 : 207 : sg_init_one(&sg, scr, 8);
246 : :
247 : 207 : mmc_set_data_timeout(&data, card);
248 : :
249 : 207 : mmc_wait_for_req(card->host, &mrq);
250 : :
251 : 207 : card->raw_scr[0] = be32_to_cpu(scr[0]);
252 : 207 : card->raw_scr[1] = be32_to_cpu(scr[1]);
253 : :
254 : 207 : kfree(scr);
255 : :
256 [ + - ]: 207 : if (cmd.error)
257 : : return cmd.error;
258 [ - + ]: 207 : if (data.error)
259 : 0 : return data.error;
260 : :
261 : : return 0;
262 : : }
263 : :
264 : 414 : int mmc_sd_switch(struct mmc_card *card, int mode, int group,
265 : : u8 value, u8 *resp)
266 : : {
267 : 414 : struct mmc_request mrq = {};
268 : 414 : struct mmc_command cmd = {};
269 : 414 : struct mmc_data data = {};
270 : : struct scatterlist sg;
271 : :
272 : : /* NOTE: caller guarantees resp is heap-allocated */
273 : :
274 : 414 : mode = !!mode;
275 : 414 : value &= 0xF;
276 : :
277 : 414 : mrq.cmd = &cmd;
278 : 414 : mrq.data = &data;
279 : :
280 : 414 : cmd.opcode = SD_SWITCH;
281 : 414 : cmd.arg = mode << 31 | 0x00FFFFFF;
282 : 414 : cmd.arg &= ~(0xF << (group * 4));
283 : 414 : cmd.arg |= value << (group * 4);
284 : 414 : cmd.flags = MMC_RSP_SPI_R1 | MMC_RSP_R1 | MMC_CMD_ADTC;
285 : :
286 : 414 : data.blksz = 64;
287 : 414 : data.blocks = 1;
288 : 414 : data.flags = MMC_DATA_READ;
289 : 414 : data.sg = &sg;
290 : 414 : data.sg_len = 1;
291 : :
292 : 414 : sg_init_one(&sg, resp, 64);
293 : :
294 : 414 : mmc_set_data_timeout(&data, card);
295 : :
296 : 414 : mmc_wait_for_req(card->host, &mrq);
297 : :
298 [ + - ]: 414 : if (cmd.error)
299 : : return cmd.error;
300 [ - + ]: 414 : if (data.error)
301 : 0 : return data.error;
302 : :
303 : : return 0;
304 : : }
305 : :
306 : 207 : int mmc_app_sd_status(struct mmc_card *card, void *ssr)
307 : : {
308 : : int err;
309 : 207 : struct mmc_request mrq = {};
310 : 207 : struct mmc_command cmd = {};
311 : 207 : struct mmc_data data = {};
312 : : struct scatterlist sg;
313 : :
314 : : /* NOTE: caller guarantees ssr is heap-allocated */
315 : :
316 : 207 : err = mmc_app_cmd(card->host, card);
317 [ + - ]: 207 : if (err)
318 : : return err;
319 : :
320 : 207 : mrq.cmd = &cmd;
321 : 207 : mrq.data = &data;
322 : :
323 : 207 : cmd.opcode = SD_APP_SD_STATUS;
324 : 207 : cmd.arg = 0;
325 : 207 : cmd.flags = MMC_RSP_SPI_R2 | MMC_RSP_R1 | MMC_CMD_ADTC;
326 : :
327 : 207 : data.blksz = 64;
328 : 207 : data.blocks = 1;
329 : 207 : data.flags = MMC_DATA_READ;
330 : 207 : data.sg = &sg;
331 : 207 : data.sg_len = 1;
332 : :
333 : 207 : sg_init_one(&sg, ssr, 64);
334 : :
335 : 207 : mmc_set_data_timeout(&data, card);
336 : :
337 : 207 : mmc_wait_for_req(card->host, &mrq);
338 : :
339 [ + - ]: 207 : if (cmd.error)
340 : : return cmd.error;
341 [ - + ]: 207 : if (data.error)
342 : 0 : return data.error;
343 : :
344 : : return 0;
345 : : }
|