blob: d66b08d6f5091ec557cd376b9bbdeb91f69f836f [file] [log] [blame]
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001/*
Pierre Ossman70f10482007-07-11 20:04:50 +02002 * linux/drivers/mmc/core/sd.c
Pierre Ossman7ea239d2006-12-31 00:11:32 +01003 *
4 * Copyright (C) 2003-2004 Russell King, All Rights Reserved.
5 * SD support Copyright (C) 2004 Ian Molton, All Rights Reserved.
6 * Copyright (C) 2005-2007 Pierre Ossman, All Rights Reserved.
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
11 */
12
13#include <linux/err.h>
Wolfram Sang9288cac2013-11-26 02:16:25 +010014#include <linux/sizes.h>
Tejun Heo5a0e3ad2010-03-24 17:04:11 +090015#include <linux/slab.h>
Paul Gortmaker0205a902011-07-15 12:01:27 -040016#include <linux/stat.h>
Ulf Hansson0cb403a2013-10-10 14:20:05 +020017#include <linux/pm_runtime.h>
Pierre Ossman7ea239d2006-12-31 00:11:32 +010018
19#include <linux/mmc/host.h>
20#include <linux/mmc/card.h>
21#include <linux/mmc/mmc.h>
Pierre Ossman3373c0a2007-05-31 22:25:11 +020022#include <linux/mmc/sd.h>
Pierre Ossman7ea239d2006-12-31 00:11:32 +010023
24#include "core.h"
Ulf Hansson4facdde2017-01-13 14:14:14 +010025#include "card.h"
Pierre Ossman4101c162007-05-19 13:39:01 +020026#include "bus.h"
Pierre Ossman7ea239d2006-12-31 00:11:32 +010027#include "mmc_ops.h"
Mark Brownce101492011-02-10 10:58:37 +000028#include "sd.h"
Pierre Ossman7ea239d2006-12-31 00:11:32 +010029#include "sd_ops.h"
30
Pierre Ossman7ea239d2006-12-31 00:11:32 +010031static const unsigned int tran_exp[] = {
32 10000, 100000, 1000000, 10000000,
33 0, 0, 0, 0
34};
35
36static const unsigned char tran_mant[] = {
37 0, 10, 12, 13, 15, 20, 25, 30,
38 35, 40, 45, 50, 55, 60, 70, 80,
39};
40
41static const unsigned int tacc_exp[] = {
42 1, 10, 100, 1000, 10000, 100000, 1000000, 10000000,
43};
44
45static const unsigned int tacc_mant[] = {
46 0, 10, 12, 13, 15, 20, 25, 30,
47 35, 40, 45, 50, 55, 60, 70, 80,
48};
49
Wolfram Sang9288cac2013-11-26 02:16:25 +010050static const unsigned int sd_au_size[] = {
51 0, SZ_16K / 512, SZ_32K / 512, SZ_64K / 512,
52 SZ_128K / 512, SZ_256K / 512, SZ_512K / 512, SZ_1M / 512,
53 SZ_2M / 512, SZ_4M / 512, SZ_8M / 512, (SZ_8M + SZ_4M) / 512,
54 SZ_16M / 512, (SZ_16M + SZ_8M) / 512, SZ_32M / 512, SZ_64M / 512,
55};
56
Pierre Ossman7ea239d2006-12-31 00:11:32 +010057#define UNSTUFF_BITS(resp,start,size) \
58 ({ \
59 const int __size = size; \
60 const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1; \
61 const int __off = 3 - ((start) / 32); \
62 const int __shft = (start) & 31; \
63 u32 __res; \
64 \
65 __res = resp[__off] >> __shft; \
66 if (__size + __shft > 32) \
67 __res |= resp[__off-1] << ((32 - __shft) % 32); \
68 __res & __mask; \
69 })
70
71/*
72 * Given the decoded CSD structure, decode the raw CID to our CID structure.
73 */
Michal Miroslaw71578a12010-08-10 18:01:40 -070074void mmc_decode_cid(struct mmc_card *card)
Pierre Ossman7ea239d2006-12-31 00:11:32 +010075{
76 u32 *resp = card->raw_cid;
77
Pierre Ossman7ea239d2006-12-31 00:11:32 +010078 /*
79 * SD doesn't currently have a version field so we will
80 * have to assume we can parse this.
81 */
82 card->cid.manfid = UNSTUFF_BITS(resp, 120, 8);
83 card->cid.oemid = UNSTUFF_BITS(resp, 104, 16);
84 card->cid.prod_name[0] = UNSTUFF_BITS(resp, 96, 8);
85 card->cid.prod_name[1] = UNSTUFF_BITS(resp, 88, 8);
86 card->cid.prod_name[2] = UNSTUFF_BITS(resp, 80, 8);
87 card->cid.prod_name[3] = UNSTUFF_BITS(resp, 72, 8);
88 card->cid.prod_name[4] = UNSTUFF_BITS(resp, 64, 8);
89 card->cid.hwrev = UNSTUFF_BITS(resp, 60, 4);
90 card->cid.fwrev = UNSTUFF_BITS(resp, 56, 4);
91 card->cid.serial = UNSTUFF_BITS(resp, 24, 32);
92 card->cid.year = UNSTUFF_BITS(resp, 12, 8);
93 card->cid.month = UNSTUFF_BITS(resp, 8, 4);
94
95 card->cid.year += 2000; /* SD cards year offset */
96}
97
98/*
99 * Given a 128-bit response, decode to our card CSD structure.
100 */
Pierre Ossmanbd766312007-05-01 16:11:57 +0200101static int mmc_decode_csd(struct mmc_card *card)
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100102{
103 struct mmc_csd *csd = &card->csd;
104 unsigned int e, m, csd_struct;
105 u32 *resp = card->raw_csd;
106
107 csd_struct = UNSTUFF_BITS(resp, 126, 2);
108
109 switch (csd_struct) {
110 case 0:
111 m = UNSTUFF_BITS(resp, 115, 4);
112 e = UNSTUFF_BITS(resp, 112, 3);
113 csd->tacc_ns = (tacc_exp[e] * tacc_mant[m] + 9) / 10;
114 csd->tacc_clks = UNSTUFF_BITS(resp, 104, 8) * 100;
115
116 m = UNSTUFF_BITS(resp, 99, 4);
117 e = UNSTUFF_BITS(resp, 96, 3);
118 csd->max_dtr = tran_exp[e] * tran_mant[m];
119 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
120
121 e = UNSTUFF_BITS(resp, 47, 3);
122 m = UNSTUFF_BITS(resp, 62, 12);
123 csd->capacity = (1 + m) << (e + 2);
124
125 csd->read_blkbits = UNSTUFF_BITS(resp, 80, 4);
126 csd->read_partial = UNSTUFF_BITS(resp, 79, 1);
127 csd->write_misalign = UNSTUFF_BITS(resp, 78, 1);
128 csd->read_misalign = UNSTUFF_BITS(resp, 77, 1);
Sascha Hauer3d705d12014-08-19 10:45:51 +0200129 csd->dsr_imp = UNSTUFF_BITS(resp, 76, 1);
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100130 csd->r2w_factor = UNSTUFF_BITS(resp, 26, 3);
131 csd->write_blkbits = UNSTUFF_BITS(resp, 22, 4);
132 csd->write_partial = UNSTUFF_BITS(resp, 21, 1);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700133
134 if (UNSTUFF_BITS(resp, 46, 1)) {
135 csd->erase_size = 1;
136 } else if (csd->write_blkbits >= 9) {
137 csd->erase_size = UNSTUFF_BITS(resp, 39, 7) + 1;
138 csd->erase_size <<= csd->write_blkbits - 9;
139 }
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100140 break;
141 case 1:
142 /*
Arindam Nath3a303512011-05-05 12:19:03 +0530143 * This is a block-addressed SDHC or SDXC card. Most
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100144 * interesting fields are unused and have fixed
145 * values. To avoid getting tripped by buggy cards,
146 * we assume those fixed values ourselves.
147 */
148 mmc_card_set_blockaddr(card);
149
150 csd->tacc_ns = 0; /* Unused */
151 csd->tacc_clks = 0; /* Unused */
152
153 m = UNSTUFF_BITS(resp, 99, 4);
154 e = UNSTUFF_BITS(resp, 96, 3);
155 csd->max_dtr = tran_exp[e] * tran_mant[m];
156 csd->cmdclass = UNSTUFF_BITS(resp, 84, 12);
Arindam Nath3a303512011-05-05 12:19:03 +0530157 csd->c_size = UNSTUFF_BITS(resp, 48, 22);
158
159 /* SDXC cards have a minimum C_SIZE of 0x00FFFF */
160 if (csd->c_size >= 0xFFFF)
161 mmc_card_set_ext_capacity(card);
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100162
163 m = UNSTUFF_BITS(resp, 48, 22);
164 csd->capacity = (1 + m) << 10;
165
166 csd->read_blkbits = 9;
167 csd->read_partial = 0;
168 csd->write_misalign = 0;
169 csd->read_misalign = 0;
170 csd->r2w_factor = 4; /* Unused */
171 csd->write_blkbits = 9;
172 csd->write_partial = 0;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700173 csd->erase_size = 1;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100174 break;
175 default:
Girish K Sa3c76eb2011-10-11 11:44:09 +0530176 pr_err("%s: unrecognised CSD structure version %d\n",
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100177 mmc_hostname(card->host), csd_struct);
Pierre Ossmanbd766312007-05-01 16:11:57 +0200178 return -EINVAL;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100179 }
Pierre Ossmanbd766312007-05-01 16:11:57 +0200180
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700181 card->erase_size = csd->erase_size;
182
Pierre Ossmanbd766312007-05-01 16:11:57 +0200183 return 0;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100184}
185
186/*
187 * Given a 64-bit response, decode to our card SCR structure.
188 */
Pierre Ossmanbd766312007-05-01 16:11:57 +0200189static int mmc_decode_scr(struct mmc_card *card)
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100190{
191 struct sd_scr *scr = &card->scr;
192 unsigned int scr_struct;
193 u32 resp[4];
194
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100195 resp[3] = card->raw_scr[1];
196 resp[2] = card->raw_scr[0];
197
198 scr_struct = UNSTUFF_BITS(resp, 60, 4);
199 if (scr_struct != 0) {
Girish K Sa3c76eb2011-10-11 11:44:09 +0530200 pr_err("%s: unrecognised SCR structure version %d\n",
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100201 mmc_hostname(card->host), scr_struct);
Pierre Ossmanbd766312007-05-01 16:11:57 +0200202 return -EINVAL;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100203 }
204
205 scr->sda_vsn = UNSTUFF_BITS(resp, 56, 4);
206 scr->bus_widths = UNSTUFF_BITS(resp, 48, 4);
Arindam Nath013909c2011-05-05 12:18:58 +0530207 if (scr->sda_vsn == SCR_SPEC_VER_2)
208 /* Check if Physical Layer Spec v3.0 is supported */
209 scr->sda_spec3 = UNSTUFF_BITS(resp, 47, 1);
Pierre Ossmanbd766312007-05-01 16:11:57 +0200210
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700211 if (UNSTUFF_BITS(resp, 55, 1))
212 card->erased_byte = 0xFF;
213 else
214 card->erased_byte = 0x0;
215
Andrei Warkentinf0d89972011-05-23 15:06:38 -0500216 if (scr->sda_spec3)
217 scr->cmds = UNSTUFF_BITS(resp, 32, 2);
Pierre Ossmanbd766312007-05-01 16:11:57 +0200218 return 0;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100219}
220
221/*
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700222 * Fetch and process SD Status register.
223 */
224static int mmc_read_ssr(struct mmc_card *card)
225{
226 unsigned int au, es, et, eo;
Paul Burtone85baa82016-11-11 14:22:36 +0000227 u32 *raw_ssr;
Uri Yanai5275a652016-08-14 11:46:36 +0300228 int i;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700229
230 if (!(card->csd.cmdclass & CCC_APP_SPEC)) {
Joe Perches66061102014-09-12 14:56:56 -0700231 pr_warn("%s: card lacks mandatory SD Status function\n",
232 mmc_hostname(card->host));
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700233 return 0;
234 }
235
Paul Burtone85baa82016-11-11 14:22:36 +0000236 raw_ssr = kmalloc(sizeof(card->raw_ssr), GFP_KERNEL);
237 if (!raw_ssr)
238 return -ENOMEM;
239
240 if (mmc_app_sd_status(card, raw_ssr)) {
Joe Perches66061102014-09-12 14:56:56 -0700241 pr_warn("%s: problem reading SD Status register\n",
242 mmc_hostname(card->host));
Paul Burtone85baa82016-11-11 14:22:36 +0000243 kfree(raw_ssr);
Uri Yanai5275a652016-08-14 11:46:36 +0300244 return 0;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700245 }
246
247 for (i = 0; i < 16; i++)
Paul Burtone85baa82016-11-11 14:22:36 +0000248 card->raw_ssr[i] = be32_to_cpu(raw_ssr[i]);
249
250 kfree(raw_ssr);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700251
252 /*
253 * UNSTUFF_BITS only works with four u32s so we have to offset the
254 * bitfield positions accordingly.
255 */
Uri Yanai5275a652016-08-14 11:46:36 +0300256 au = UNSTUFF_BITS(card->raw_ssr, 428 - 384, 4);
Wolfram Sang9288cac2013-11-26 02:16:25 +0100257 if (au) {
258 if (au <= 9 || card->scr.sda_spec3) {
259 card->ssr.au = sd_au_size[au];
Uri Yanai5275a652016-08-14 11:46:36 +0300260 es = UNSTUFF_BITS(card->raw_ssr, 408 - 384, 16);
261 et = UNSTUFF_BITS(card->raw_ssr, 402 - 384, 6);
Wolfram Sang9288cac2013-11-26 02:16:25 +0100262 if (es && et) {
Uri Yanai5275a652016-08-14 11:46:36 +0300263 eo = UNSTUFF_BITS(card->raw_ssr, 400 - 384, 2);
Wolfram Sang9288cac2013-11-26 02:16:25 +0100264 card->ssr.erase_timeout = (et * 1000) / es;
265 card->ssr.erase_offset = eo * 1000;
266 }
267 } else {
Joe Perches66061102014-09-12 14:56:56 -0700268 pr_warn("%s: SD Status: Invalid Allocation Unit size\n",
269 mmc_hostname(card->host));
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700270 }
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700271 }
Uri Yanai5275a652016-08-14 11:46:36 +0300272
273 return 0;
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700274}
275
276/*
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200277 * Fetches and decodes switch information
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100278 */
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200279static int mmc_read_switch(struct mmc_card *card)
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100280{
281 int err;
282 u8 *status;
283
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200284 if (card->scr.sda_vsn < SCR_SPEC_VER_1)
Pierre Ossman17b04292007-07-22 22:18:46 +0200285 return 0;
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200286
287 if (!(card->csd.cmdclass & CCC_SWITCH)) {
Joe Perches66061102014-09-12 14:56:56 -0700288 pr_warn("%s: card lacks mandatory switch function, performance might suffer\n",
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200289 mmc_hostname(card->host));
Pierre Ossman17b04292007-07-22 22:18:46 +0200290 return 0;
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200291 }
292
Pierre Ossman17b04292007-07-22 22:18:46 +0200293 err = -EIO;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100294
295 status = kmalloc(64, GFP_KERNEL);
296 if (!status) {
Girish K Sa3c76eb2011-10-11 11:44:09 +0530297 pr_err("%s: could not allocate a buffer for "
Arindam Nath013909c2011-05-05 12:18:58 +0530298 "switch capabilities.\n",
299 mmc_hostname(card->host));
Pierre Ossman17b04292007-07-22 22:18:46 +0200300 return -ENOMEM;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100301 }
302
Aaron Lua39ca6ae2012-07-03 14:16:11 +0800303 /*
304 * Find out the card's support bits with a mode 0 operation.
305 * The argument does not matter, as the support bits do not
306 * change with the arguments.
307 */
308 err = mmc_sd_switch(card, 0, 0, 0, status);
Pierre Ossman17b04292007-07-22 22:18:46 +0200309 if (err) {
Arindam Nath013909c2011-05-05 12:18:58 +0530310 /*
311 * If the host or the card can't do the switch,
312 * fail more gracefully.
313 */
314 if (err != -EINVAL && err != -ENOSYS && err != -EFAULT)
Pierre Ossmanadf66a02007-07-22 23:08:30 +0200315 goto out;
316
Joe Perches66061102014-09-12 14:56:56 -0700317 pr_warn("%s: problem reading Bus Speed modes\n",
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200318 mmc_hostname(card->host));
Pierre Ossman17b04292007-07-22 22:18:46 +0200319 err = 0;
Pierre Ossmanadf66a02007-07-22 23:08:30 +0200320
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100321 goto out;
322 }
323
Qiang Liufffe5d52011-11-08 08:43:08 -0500324 if (status[13] & SD_MODE_HIGH_SPEED)
325 card->sw_caps.hs_max_dtr = HIGH_SPEED_MAX_DTR;
Subhash Jadavanif2815f62011-08-10 11:16:01 +0530326
Arindam Nath013909c2011-05-05 12:18:58 +0530327 if (card->scr.sda_spec3) {
328 card->sw_caps.sd3_bus_mode = status[13];
Aaron Lua39ca6ae2012-07-03 14:16:11 +0800329 /* Driver Strengths supported by the card */
Arindam Nath013909c2011-05-05 12:18:58 +0530330 card->sw_caps.sd3_drv_type = status[9];
Russell Kingd9812782016-01-02 10:06:29 +0000331 card->sw_caps.sd3_curr_limit = status[7] | status[6] << 8;
Arindam Nath013909c2011-05-05 12:18:58 +0530332 }
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100333
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200334out:
335 kfree(status);
336
337 return err;
338}
339
340/*
341 * Test if the card supports high-speed mode and, if so, switch to it.
342 */
Michal Miroslaw71578a12010-08-10 18:01:40 -0700343int mmc_sd_switch_hs(struct mmc_card *card)
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200344{
345 int err;
346 u8 *status;
347
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200348 if (card->scr.sda_vsn < SCR_SPEC_VER_1)
Pierre Ossman17b04292007-07-22 22:18:46 +0200349 return 0;
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200350
351 if (!(card->csd.cmdclass & CCC_SWITCH))
Pierre Ossman17b04292007-07-22 22:18:46 +0200352 return 0;
Pierre Ossman3373c0a2007-05-31 22:25:11 +0200353
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200354 if (!(card->host->caps & MMC_CAP_SD_HIGHSPEED))
Pierre Ossman17b04292007-07-22 22:18:46 +0200355 return 0;
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200356
357 if (card->sw_caps.hs_max_dtr == 0)
Pierre Ossman17b04292007-07-22 22:18:46 +0200358 return 0;
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200359
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200360 status = kmalloc(64, GFP_KERNEL);
361 if (!status) {
Girish K Sa3c76eb2011-10-11 11:44:09 +0530362 pr_err("%s: could not allocate a buffer for "
Pierre Ossmanfacba912007-07-24 21:53:43 +0200363 "switch capabilities.\n", mmc_hostname(card->host));
Pierre Ossman17b04292007-07-22 22:18:46 +0200364 return -ENOMEM;
Pierre Ossman1addfcd2007-05-01 14:46:08 +0200365 }
366
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100367 err = mmc_sd_switch(card, 1, 0, 1, status);
Pierre Ossman17b04292007-07-22 22:18:46 +0200368 if (err)
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100369 goto out;
370
371 if ((status[16] & 0xF) != 1) {
Joe Perches66061102014-09-12 14:56:56 -0700372 pr_warn("%s: Problem switching card into high-speed mode!\n",
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100373 mmc_hostname(card->host));
Michal Miroslaw71578a12010-08-10 18:01:40 -0700374 err = 0;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100375 } else {
Michal Miroslaw71578a12010-08-10 18:01:40 -0700376 err = 1;
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100377 }
378
379out:
380 kfree(status);
381
382 return err;
383}
384
Arindam Nathd6d50a12011-05-05 12:18:59 +0530385static int sd_select_driver_type(struct mmc_card *card, u8 *status)
386{
Adrian Hunterfa021ce2015-02-06 14:12:53 +0200387 int card_drv_type, drive_strength, drv_type;
Arindam Nathd6d50a12011-05-05 12:18:59 +0530388 int err;
389
Adrian Hunter3853a042015-02-06 14:12:56 +0200390 card->drive_strength = 0;
391
Adrian Hunterfa021ce2015-02-06 14:12:53 +0200392 card_drv_type = card->sw_caps.sd3_drv_type | SD_DRIVER_TYPE_B;
Philip Rakityca8e99b2011-07-06 08:51:32 -0700393
Adrian Huntere23350b2015-02-06 14:12:55 +0200394 drive_strength = mmc_select_drive_strength(card,
395 card->sw_caps.uhs_max_dtr,
396 card_drv_type, &drv_type);
Philip Rakityca8e99b2011-07-06 08:51:32 -0700397
Adrian Hunterb4f30a12015-02-06 14:12:52 +0200398 if (drive_strength) {
399 err = mmc_sd_switch(card, 1, 2, drive_strength, status);
400 if (err)
401 return err;
402 if ((status[15] & 0xF) != drive_strength) {
403 pr_warn("%s: Problem setting drive strength!\n",
404 mmc_hostname(card->host));
405 return 0;
406 }
Adrian Hunter3853a042015-02-06 14:12:56 +0200407 card->drive_strength = drive_strength;
Arindam Nathd6d50a12011-05-05 12:18:59 +0530408 }
409
Adrian Hunterb4f30a12015-02-06 14:12:52 +0200410 if (drv_type)
411 mmc_set_driver_type(card->host, drv_type);
Arindam Nathd6d50a12011-05-05 12:18:59 +0530412
413 return 0;
414}
415
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530416static void sd_update_bus_speed_mode(struct mmc_card *card)
Arindam Nath49c468f2011-05-05 12:19:01 +0530417{
Arindam Nath49c468f2011-05-05 12:19:01 +0530418 /*
419 * If the host doesn't support any of the UHS-I modes, fallback on
420 * default speed.
421 */
Johan Rudholm3f8a7fa2013-01-28 15:08:24 +0100422 if (!mmc_host_uhs(card->host)) {
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530423 card->sd_bus_speed = 0;
424 return;
425 }
Arindam Nath49c468f2011-05-05 12:19:01 +0530426
427 if ((card->host->caps & MMC_CAP_UHS_SDR104) &&
428 (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR104)) {
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530429 card->sd_bus_speed = UHS_SDR104_BUS_SPEED;
Arindam Nath49c468f2011-05-05 12:19:01 +0530430 } else if ((card->host->caps & MMC_CAP_UHS_DDR50) &&
431 (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_DDR50)) {
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530432 card->sd_bus_speed = UHS_DDR50_BUS_SPEED;
Arindam Nath49c468f2011-05-05 12:19:01 +0530433 } else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
434 MMC_CAP_UHS_SDR50)) && (card->sw_caps.sd3_bus_mode &
435 SD_MODE_UHS_SDR50)) {
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530436 card->sd_bus_speed = UHS_SDR50_BUS_SPEED;
Arindam Nath49c468f2011-05-05 12:19:01 +0530437 } else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
438 MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25)) &&
439 (card->sw_caps.sd3_bus_mode & SD_MODE_UHS_SDR25)) {
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530440 card->sd_bus_speed = UHS_SDR25_BUS_SPEED;
Arindam Nath49c468f2011-05-05 12:19:01 +0530441 } else if ((card->host->caps & (MMC_CAP_UHS_SDR104 |
442 MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR25 |
443 MMC_CAP_UHS_SDR12)) && (card->sw_caps.sd3_bus_mode &
444 SD_MODE_UHS_SDR12)) {
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530445 card->sd_bus_speed = UHS_SDR12_BUS_SPEED;
446 }
447}
448
449static int sd_set_bus_speed_mode(struct mmc_card *card, u8 *status)
450{
451 int err;
452 unsigned int timing = 0;
453
454 switch (card->sd_bus_speed) {
455 case UHS_SDR104_BUS_SPEED:
456 timing = MMC_TIMING_UHS_SDR104;
457 card->sw_caps.uhs_max_dtr = UHS_SDR104_MAX_DTR;
458 break;
459 case UHS_DDR50_BUS_SPEED:
460 timing = MMC_TIMING_UHS_DDR50;
461 card->sw_caps.uhs_max_dtr = UHS_DDR50_MAX_DTR;
462 break;
463 case UHS_SDR50_BUS_SPEED:
464 timing = MMC_TIMING_UHS_SDR50;
465 card->sw_caps.uhs_max_dtr = UHS_SDR50_MAX_DTR;
466 break;
467 case UHS_SDR25_BUS_SPEED:
468 timing = MMC_TIMING_UHS_SDR25;
469 card->sw_caps.uhs_max_dtr = UHS_SDR25_MAX_DTR;
470 break;
471 case UHS_SDR12_BUS_SPEED:
472 timing = MMC_TIMING_UHS_SDR12;
473 card->sw_caps.uhs_max_dtr = UHS_SDR12_MAX_DTR;
474 break;
475 default:
476 return 0;
Arindam Nath49c468f2011-05-05 12:19:01 +0530477 }
478
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530479 err = mmc_sd_switch(card, 1, 0, card->sd_bus_speed, status);
Arindam Nath49c468f2011-05-05 12:19:01 +0530480 if (err)
481 return err;
482
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530483 if ((status[16] & 0xF) != card->sd_bus_speed)
Joe Perches66061102014-09-12 14:56:56 -0700484 pr_warn("%s: Problem setting bus speed mode!\n",
Arindam Nath49c468f2011-05-05 12:19:01 +0530485 mmc_hostname(card->host));
486 else {
487 mmc_set_timing(card->host, timing);
488 mmc_set_clock(card->host, card->sw_caps.uhs_max_dtr);
489 }
490
491 return 0;
492}
493
Aaron Lu55c46652012-07-04 13:31:48 +0800494/* Get host's max current setting at its current voltage */
495static u32 sd_get_host_max_current(struct mmc_host *host)
496{
497 u32 voltage, max_current;
498
499 voltage = 1 << host->ios.vdd;
500 switch (voltage) {
501 case MMC_VDD_165_195:
502 max_current = host->max_current_180;
503 break;
504 case MMC_VDD_29_30:
505 case MMC_VDD_30_31:
506 max_current = host->max_current_300;
507 break;
508 case MMC_VDD_32_33:
509 case MMC_VDD_33_34:
510 max_current = host->max_current_330;
511 break;
512 default:
513 max_current = 0;
514 }
515
516 return max_current;
517}
518
Arindam Nath5371c922011-05-05 12:19:02 +0530519static int sd_set_current_limit(struct mmc_card *card, u8 *status)
520{
Philip Rakity0aa67702012-05-27 18:36:33 -0700521 int current_limit = SD_SET_CURRENT_NO_CHANGE;
Arindam Nath5371c922011-05-05 12:19:02 +0530522 int err;
Aaron Lu55c46652012-07-04 13:31:48 +0800523 u32 max_current;
Arindam Nath5371c922011-05-05 12:19:02 +0530524
525 /*
526 * Current limit switch is only defined for SDR50, SDR104, and DDR50
Philip Rakity0aa67702012-05-27 18:36:33 -0700527 * bus speed modes. For other bus speed modes, we do not change the
528 * current limit.
Aaron Lu55c46652012-07-04 13:31:48 +0800529 */
530 if ((card->sd_bus_speed != UHS_SDR50_BUS_SPEED) &&
531 (card->sd_bus_speed != UHS_SDR104_BUS_SPEED) &&
532 (card->sd_bus_speed != UHS_DDR50_BUS_SPEED))
533 return 0;
534
535 /*
536 * Host has different current capabilities when operating at
537 * different voltages, so find out its max current first.
538 */
539 max_current = sd_get_host_max_current(card->host);
540
541 /*
Aaron Lua39ca6ae2012-07-03 14:16:11 +0800542 * We only check host's capability here, if we set a limit that is
543 * higher than the card's maximum current, the card will be using its
544 * maximum current, e.g. if the card's maximum current is 300ma, and
545 * when we set current limit to 200ma, the card will draw 200ma, and
546 * when we set current limit to 400/600/800ma, the card will draw its
547 * maximum 300ma from the host.
Russell Kingd9812782016-01-02 10:06:29 +0000548 *
549 * The above is incorrect: if we try to set a current limit that is
550 * not supported by the card, the card can rightfully error out the
551 * attempt, and remain at the default current limit. This results
552 * in a 300mA card being limited to 200mA even though the host
553 * supports 800mA. Failures seen with SanDisk 8GB UHS cards with
554 * an iMX6 host. --rmk
Arindam Nath5371c922011-05-05 12:19:02 +0530555 */
Russell Kingd9812782016-01-02 10:06:29 +0000556 if (max_current >= 800 &&
557 card->sw_caps.sd3_curr_limit & SD_MAX_CURRENT_800)
Aaron Lu55c46652012-07-04 13:31:48 +0800558 current_limit = SD_SET_CURRENT_LIMIT_800;
Russell Kingd9812782016-01-02 10:06:29 +0000559 else if (max_current >= 600 &&
560 card->sw_caps.sd3_curr_limit & SD_MAX_CURRENT_600)
Aaron Lu55c46652012-07-04 13:31:48 +0800561 current_limit = SD_SET_CURRENT_LIMIT_600;
Russell Kingd9812782016-01-02 10:06:29 +0000562 else if (max_current >= 400 &&
563 card->sw_caps.sd3_curr_limit & SD_MAX_CURRENT_400)
Aaron Lu55c46652012-07-04 13:31:48 +0800564 current_limit = SD_SET_CURRENT_LIMIT_400;
Russell Kingd9812782016-01-02 10:06:29 +0000565 else if (max_current >= 200 &&
566 card->sw_caps.sd3_curr_limit & SD_MAX_CURRENT_200)
Aaron Lu55c46652012-07-04 13:31:48 +0800567 current_limit = SD_SET_CURRENT_LIMIT_200;
Arindam Nath5371c922011-05-05 12:19:02 +0530568
Philip Rakity0aa67702012-05-27 18:36:33 -0700569 if (current_limit != SD_SET_CURRENT_NO_CHANGE) {
570 err = mmc_sd_switch(card, 1, 3, current_limit, status);
571 if (err)
572 return err;
Arindam Nath5371c922011-05-05 12:19:02 +0530573
Philip Rakity0aa67702012-05-27 18:36:33 -0700574 if (((status[15] >> 4) & 0x0F) != current_limit)
Joe Perches66061102014-09-12 14:56:56 -0700575 pr_warn("%s: Problem setting current limit!\n",
Philip Rakity0aa67702012-05-27 18:36:33 -0700576 mmc_hostname(card->host));
Arindam Nath5371c922011-05-05 12:19:02 +0530577
Philip Rakity0aa67702012-05-27 18:36:33 -0700578 }
Aaron Lua39ca6ae2012-07-03 14:16:11 +0800579
Arindam Nath5371c922011-05-05 12:19:02 +0530580 return 0;
581}
582
Arindam Nathd6d50a12011-05-05 12:18:59 +0530583/*
584 * UHS-I specific initialization procedure
585 */
586static int mmc_sd_init_uhs_card(struct mmc_card *card)
587{
588 int err;
589 u8 *status;
590
591 if (!card->scr.sda_spec3)
592 return 0;
593
594 if (!(card->csd.cmdclass & CCC_SWITCH))
595 return 0;
596
597 status = kmalloc(64, GFP_KERNEL);
598 if (!status) {
Girish K Sa3c76eb2011-10-11 11:44:09 +0530599 pr_err("%s: could not allocate a buffer for "
Arindam Nathd6d50a12011-05-05 12:18:59 +0530600 "switch capabilities.\n", mmc_hostname(card->host));
601 return -ENOMEM;
602 }
603
604 /* Set 4-bit bus width */
605 if ((card->host->caps & MMC_CAP_4_BIT_DATA) &&
606 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) {
607 err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4);
608 if (err)
609 goto out;
610
611 mmc_set_bus_width(card->host, MMC_BUS_WIDTH_4);
612 }
613
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530614 /*
615 * Select the bus speed mode depending on host
616 * and card capability.
617 */
618 sd_update_bus_speed_mode(card);
619
Arindam Nathd6d50a12011-05-05 12:18:59 +0530620 /* Set the driver strength for the card */
621 err = sd_select_driver_type(card, status);
Arindam Nath49c468f2011-05-05 12:19:01 +0530622 if (err)
623 goto out;
624
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530625 /* Set current limit for the card */
626 err = sd_set_current_limit(card, status);
Arindam Nath5371c922011-05-05 12:19:02 +0530627 if (err)
628 goto out;
629
Subhash Jadavani93c712f2011-08-09 12:19:31 +0530630 /* Set bus speed mode of the card */
631 err = sd_set_bus_speed_mode(card, status);
Arindam Nathb513ea22011-05-05 12:19:04 +0530632 if (err)
633 goto out;
634
Fredrik Soderstedt810e08e2013-04-17 13:50:53 +0200635 /*
636 * SPI mode doesn't define CMD19 and tuning is only valid for SDR50 and
637 * SDR104 mode SD-cards. Note that tuning is mandatory for SDR104.
638 */
Adrian Hunter63e415c2014-12-05 19:40:59 +0200639 if (!mmc_host_is_spi(card->host) &&
Carlo Caionee10c3212016-01-13 09:36:55 +0100640 (card->host->ios.timing == MMC_TIMING_UHS_SDR50 ||
641 card->host->ios.timing == MMC_TIMING_UHS_DDR50 ||
642 card->host->ios.timing == MMC_TIMING_UHS_SDR104)) {
Adrian Hunter63e415c2014-12-05 19:40:59 +0200643 err = mmc_execute_tuning(card);
Weijun Yang4324f6d2015-10-04 12:04:11 +0000644
645 /*
646 * As SD Specifications Part1 Physical Layer Specification
647 * Version 3.01 says, CMD19 tuning is available for unlocked
648 * cards in transfer state of 1.8V signaling mode. The small
649 * difference between v3.00 and 3.01 spec means that CMD19
650 * tuning is also available for DDR50 mode.
651 */
Carlo Caionee10c3212016-01-13 09:36:55 +0100652 if (err && card->host->ios.timing == MMC_TIMING_UHS_DDR50) {
Weijun Yang4324f6d2015-10-04 12:04:11 +0000653 pr_warn("%s: ddr50 tuning failed\n",
654 mmc_hostname(card->host));
655 err = 0;
656 }
657 }
658
Arindam Nathd6d50a12011-05-05 12:18:59 +0530659out:
660 kfree(status);
661
662 return err;
663}
664
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100665MMC_DEV_ATTR(cid, "%08x%08x%08x%08x\n", card->raw_cid[0], card->raw_cid[1],
666 card->raw_cid[2], card->raw_cid[3]);
667MMC_DEV_ATTR(csd, "%08x%08x%08x%08x\n", card->raw_csd[0], card->raw_csd[1],
668 card->raw_csd[2], card->raw_csd[3]);
669MMC_DEV_ATTR(scr, "%08x%08x\n", card->raw_scr[0], card->raw_scr[1]);
Uri Yanai5275a652016-08-14 11:46:36 +0300670MMC_DEV_ATTR(ssr,
671 "%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x%08x\n",
672 card->raw_ssr[0], card->raw_ssr[1], card->raw_ssr[2],
673 card->raw_ssr[3], card->raw_ssr[4], card->raw_ssr[5],
674 card->raw_ssr[6], card->raw_ssr[7], card->raw_ssr[8],
675 card->raw_ssr[9], card->raw_ssr[10], card->raw_ssr[11],
676 card->raw_ssr[12], card->raw_ssr[13], card->raw_ssr[14],
677 card->raw_ssr[15]);
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100678MMC_DEV_ATTR(date, "%02d/%04d\n", card->cid.month, card->cid.year);
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700679MMC_DEV_ATTR(erase_size, "%u\n", card->erase_size << 9);
680MMC_DEV_ATTR(preferred_erase_size, "%u\n", card->pref_erase << 9);
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100681MMC_DEV_ATTR(fwrev, "0x%x\n", card->cid.fwrev);
682MMC_DEV_ATTR(hwrev, "0x%x\n", card->cid.hwrev);
683MMC_DEV_ATTR(manfid, "0x%06x\n", card->cid.manfid);
684MMC_DEV_ATTR(name, "%s\n", card->cid.prod_name);
685MMC_DEV_ATTR(oemid, "0x%04x\n", card->cid.oemid);
686MMC_DEV_ATTR(serial, "0x%08x\n", card->cid.serial);
Bojan Prtvar5fb06af2016-07-04 13:56:55 +0200687MMC_DEV_ATTR(ocr, "%08x\n", card->ocr);
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100688
689
Bojan Prtvar6825a602016-07-19 11:16:38 +0200690static ssize_t mmc_dsr_show(struct device *dev,
691 struct device_attribute *attr,
692 char *buf)
693{
694 struct mmc_card *card = mmc_dev_to_card(dev);
695 struct mmc_host *host = card->host;
696
697 if (card->csd.dsr_imp && host->dsr_req)
698 return sprintf(buf, "0x%x\n", host->dsr);
699 else
700 /* return default DSR value */
701 return sprintf(buf, "0x%x\n", 0x404);
702}
703
704static DEVICE_ATTR(dsr, S_IRUGO, mmc_dsr_show, NULL);
705
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100706static struct attribute *sd_std_attrs[] = {
707 &dev_attr_cid.attr,
708 &dev_attr_csd.attr,
709 &dev_attr_scr.attr,
Uri Yanai5275a652016-08-14 11:46:36 +0300710 &dev_attr_ssr.attr,
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100711 &dev_attr_date.attr,
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700712 &dev_attr_erase_size.attr,
713 &dev_attr_preferred_erase_size.attr,
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100714 &dev_attr_fwrev.attr,
715 &dev_attr_hwrev.attr,
716 &dev_attr_manfid.attr,
717 &dev_attr_name.attr,
718 &dev_attr_oemid.attr,
719 &dev_attr_serial.attr,
Bojan Prtvar5fb06af2016-07-04 13:56:55 +0200720 &dev_attr_ocr.attr,
Bojan Prtvar6825a602016-07-19 11:16:38 +0200721 &dev_attr_dsr.attr,
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100722 NULL,
723};
Axel Lind1e58212014-03-08 15:05:27 +0800724ATTRIBUTE_GROUPS(sd_std);
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100725
Michal Miroslaw71578a12010-08-10 18:01:40 -0700726struct device_type sd_type = {
Axel Lind1e58212014-03-08 15:05:27 +0800727 .groups = sd_std_groups,
Pierre Ossman51ec92e2008-03-21 23:54:50 +0100728};
729
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100730/*
Michal Miroslaw71578a12010-08-10 18:01:40 -0700731 * Fetch CID from card.
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200732 */
Arindam Nathd6d50a12011-05-05 12:18:59 +0530733int mmc_sd_get_cid(struct mmc_host *host, u32 ocr, u32 *cid, u32 *rocr)
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200734{
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200735 int err;
Aaron Lu55c46652012-07-04 13:31:48 +0800736 u32 max_current;
Johan Rudholm0797e5f2013-01-28 15:08:28 +0100737 int retries = 10;
Ulf Hansson69041152013-09-13 11:31:33 +0200738 u32 pocr = ocr;
Johan Rudholm0797e5f2013-01-28 15:08:28 +0100739
740try_again:
741 if (!retries) {
742 ocr &= ~SD_OCR_S18R;
Joe Perches66061102014-09-12 14:56:56 -0700743 pr_warn("%s: Skipping voltage switch\n", mmc_hostname(host));
Johan Rudholm0797e5f2013-01-28 15:08:28 +0100744 }
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200745
746 /*
747 * Since we're changing the OCR value, we seem to
748 * need to tell some cards to go back to the idle
749 * state. We wait 1ms to give cards time to
750 * respond.
751 */
752 mmc_go_idle(host);
753
754 /*
755 * If SD_SEND_IF_COND indicates an SD 2.0
756 * compliant card and we should set bit 30
757 * of the ocr to indicate that we can handle
758 * block-addressed SDHC cards.
759 */
760 err = mmc_send_if_cond(host, ocr);
Pierre Ossman17b04292007-07-22 22:18:46 +0200761 if (!err)
Arindam Nathf2119df2011-05-05 12:18:57 +0530762 ocr |= SD_OCR_CCS;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200763
Arindam Nathf2119df2011-05-05 12:18:57 +0530764 /*
765 * If the host supports one of UHS-I modes, request the card
Johan Rudholm0797e5f2013-01-28 15:08:28 +0100766 * to switch to 1.8V signaling level. If the card has failed
767 * repeatedly to switch however, skip this.
Arindam Nathf2119df2011-05-05 12:18:57 +0530768 */
Johan Rudholm0797e5f2013-01-28 15:08:28 +0100769 if (retries && mmc_host_uhs(host))
Arindam Nathf2119df2011-05-05 12:18:57 +0530770 ocr |= SD_OCR_S18R;
771
Aaron Lu55c46652012-07-04 13:31:48 +0800772 /*
773 * If the host can supply more than 150mA at current voltage,
774 * XPC should be set to 1.
775 */
776 max_current = sd_get_host_max_current(host);
777 if (max_current > 150)
Arindam Nathf2119df2011-05-05 12:18:57 +0530778 ocr |= SD_OCR_XPC;
779
Arindam Nathd6d50a12011-05-05 12:18:59 +0530780 err = mmc_send_app_op_cond(host, ocr, rocr);
Pierre Ossman17b04292007-07-22 22:18:46 +0200781 if (err)
Michal Miroslaw71578a12010-08-10 18:01:40 -0700782 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200783
Arindam Nathf2119df2011-05-05 12:18:57 +0530784 /*
785 * In case CCS and S18A in the response is set, start Signal Voltage
786 * Switch procedure. SPI mode doesn't support CMD11.
787 */
Arindam Nathd6d50a12011-05-05 12:18:59 +0530788 if (!mmc_host_is_spi(host) && rocr &&
789 ((*rocr & 0x41000000) == 0x41000000)) {
Ulf Hansson0f791fd2013-09-12 15:36:34 +0200790 err = mmc_set_signal_voltage(host, MMC_SIGNAL_VOLTAGE_180,
Ulf Hansson69041152013-09-13 11:31:33 +0200791 pocr);
Johan Rudholm0797e5f2013-01-28 15:08:28 +0100792 if (err == -EAGAIN) {
793 retries--;
794 goto try_again;
795 } else if (err) {
796 retries = 0;
Arindam Nathf2119df2011-05-05 12:18:57 +0530797 goto try_again;
798 }
799 }
800
David Brownellaf517152007-08-08 09:11:32 -0700801 if (mmc_host_is_spi(host))
802 err = mmc_send_cid(host, cid);
803 else
804 err = mmc_all_send_cid(host, cid);
Michal Miroslaw71578a12010-08-10 18:01:40 -0700805
806 return err;
807}
808
809int mmc_sd_get_csd(struct mmc_host *host, struct mmc_card *card)
810{
811 int err;
812
813 /*
814 * Fetch CSD from card.
815 */
816 err = mmc_send_csd(card, card->raw_csd);
Pierre Ossman17b04292007-07-22 22:18:46 +0200817 if (err)
Michal Miroslaw71578a12010-08-10 18:01:40 -0700818 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200819
Michal Miroslaw71578a12010-08-10 18:01:40 -0700820 err = mmc_decode_csd(card);
821 if (err)
822 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200823
Michal Miroslaw71578a12010-08-10 18:01:40 -0700824 return 0;
825}
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200826
Lars-Peter Clausen9f6e0bf2015-05-06 20:31:19 +0200827static int mmc_sd_get_ro(struct mmc_host *host)
828{
829 int ro;
830
831 /*
832 * Some systems don't feature a write-protect pin and don't need one.
833 * E.g. because they only have micro-SD card slot. For those systems
834 * assume that the SD card is always read-write.
835 */
836 if (host->caps2 & MMC_CAP2_NO_WRITE_PROTECT)
837 return 0;
838
839 if (!host->ops->get_ro)
840 return -1;
841
Lars-Peter Clausen9f6e0bf2015-05-06 20:31:19 +0200842 ro = host->ops->get_ro(host);
Lars-Peter Clausen9f6e0bf2015-05-06 20:31:19 +0200843
844 return ro;
845}
846
Michal Miroslaw71578a12010-08-10 18:01:40 -0700847int mmc_sd_setup_card(struct mmc_host *host, struct mmc_card *card,
848 bool reinit)
849{
850 int err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200851
Michal Miroslaw71578a12010-08-10 18:01:40 -0700852 if (!reinit) {
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200853 /*
854 * Fetch SCR from card.
855 */
856 err = mmc_app_send_scr(card, card->raw_scr);
Pierre Ossman17b04292007-07-22 22:18:46 +0200857 if (err)
Michal Miroslaw71578a12010-08-10 18:01:40 -0700858 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200859
Pierre Ossmanbd766312007-05-01 16:11:57 +0200860 err = mmc_decode_scr(card);
Michal Miroslaw71578a12010-08-10 18:01:40 -0700861 if (err)
862 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200863
864 /*
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700865 * Fetch and process SD Status register.
866 */
867 err = mmc_read_ssr(card);
868 if (err)
869 return err;
870
871 /* Erase init depends on CSD and SSR */
872 mmc_init_erase(card);
873
874 /*
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200875 * Fetch switch information from card.
876 */
877 err = mmc_read_switch(card);
Pierre Ossman17b04292007-07-22 22:18:46 +0200878 if (err)
Michal Miroslaw71578a12010-08-10 18:01:40 -0700879 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200880 }
881
882 /*
Wolfgang Muees9d9f25c2009-04-07 14:48:16 +0100883 * For SPI, enable CRC as appropriate.
884 * This CRC enable is located AFTER the reading of the
885 * card registers because some SDHC cards are not able
886 * to provide valid CRCs for non-512-byte blocks.
887 */
888 if (mmc_host_is_spi(host)) {
889 err = mmc_spi_set_crc(host, use_spi_crc);
890 if (err)
Michal Miroslaw71578a12010-08-10 18:01:40 -0700891 return err;
Wolfgang Muees9d9f25c2009-04-07 14:48:16 +0100892 }
893
894 /*
Michal Miroslaw71578a12010-08-10 18:01:40 -0700895 * Check if read-only switch is active.
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200896 */
Michal Miroslaw71578a12010-08-10 18:01:40 -0700897 if (!reinit) {
Lars-Peter Clausen9f6e0bf2015-05-06 20:31:19 +0200898 int ro = mmc_sd_get_ro(host);
Michal Miroslaw71578a12010-08-10 18:01:40 -0700899
900 if (ro < 0) {
Joe Perches66061102014-09-12 14:56:56 -0700901 pr_warn("%s: host does not support reading read-only switch, assuming write-enable\n",
Michal Miroslaw71578a12010-08-10 18:01:40 -0700902 mmc_hostname(host));
903 } else if (ro > 0) {
904 mmc_card_set_readonly(card);
905 }
906 }
907
908 return 0;
909}
910
911unsigned mmc_sd_get_max_clock(struct mmc_card *card)
912{
913 unsigned max_dtr = (unsigned int)-1;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200914
Seungwon Jeoncdc99172014-04-23 17:07:35 +0900915 if (mmc_card_hs(card)) {
Pierre Ossman6abaa0c2007-05-01 16:00:02 +0200916 if (max_dtr > card->sw_caps.hs_max_dtr)
917 max_dtr = card->sw_caps.hs_max_dtr;
918 } else if (max_dtr > card->csd.max_dtr) {
919 max_dtr = card->csd.max_dtr;
920 }
921
Michal Miroslaw71578a12010-08-10 18:01:40 -0700922 return max_dtr;
923}
924
Michal Miroslaw71578a12010-08-10 18:01:40 -0700925/*
926 * Handle the detection and initialisation of a card.
927 *
928 * In the case of a resume, "oldcard" will contain the card
929 * we're trying to reinitialise.
930 */
931static int mmc_sd_init_card(struct mmc_host *host, u32 ocr,
932 struct mmc_card *oldcard)
933{
934 struct mmc_card *card;
935 int err;
936 u32 cid[4];
Arindam Nathd6d50a12011-05-05 12:18:59 +0530937 u32 rocr = 0;
Michal Miroslaw71578a12010-08-10 18:01:40 -0700938
Michal Miroslaw71578a12010-08-10 18:01:40 -0700939 WARN_ON(!host->claimed);
940
Arindam Nathd6d50a12011-05-05 12:18:59 +0530941 err = mmc_sd_get_cid(host, ocr, cid, &rocr);
Michal Miroslaw71578a12010-08-10 18:01:40 -0700942 if (err)
943 return err;
944
945 if (oldcard) {
946 if (memcmp(cid, oldcard->raw_cid, sizeof(cid)) != 0)
947 return -ENOENT;
948
949 card = oldcard;
950 } else {
951 /*
952 * Allocate card structure.
953 */
954 card = mmc_alloc_card(host, &sd_type);
955 if (IS_ERR(card))
956 return PTR_ERR(card);
957
Ulf Hansson69041152013-09-13 11:31:33 +0200958 card->ocr = ocr;
Michal Miroslaw71578a12010-08-10 18:01:40 -0700959 card->type = MMC_TYPE_SD;
960 memcpy(card->raw_cid, cid, sizeof(card->raw_cid));
961 }
962
963 /*
Doug Andersoneac86322014-12-02 15:42:45 -0800964 * Call the optional HC's init_card function to handle quirks.
965 */
966 if (host->ops->init_card)
967 host->ops->init_card(host, card);
968
969 /*
Michal Miroslaw71578a12010-08-10 18:01:40 -0700970 * For native busses: get card RCA and quit open drain mode.
971 */
972 if (!mmc_host_is_spi(host)) {
973 err = mmc_send_relative_addr(host, &card->rca);
974 if (err)
Wei WANG7fca9672013-07-17 14:21:10 +0800975 goto free_card;
Michal Miroslaw71578a12010-08-10 18:01:40 -0700976 }
977
978 if (!oldcard) {
979 err = mmc_sd_get_csd(host, card);
980 if (err)
Wei WANG7fca9672013-07-17 14:21:10 +0800981 goto free_card;
Michal Miroslaw71578a12010-08-10 18:01:40 -0700982
983 mmc_decode_cid(card);
984 }
985
986 /*
Sascha Hauer3d705d12014-08-19 10:45:51 +0200987 * handling only for cards supporting DSR and hosts requesting
988 * DSR configuration
989 */
990 if (card->csd.dsr_imp && host->dsr_req)
991 mmc_set_dsr(host);
992
993 /*
Michal Miroslaw71578a12010-08-10 18:01:40 -0700994 * Select card, as all following commands rely on that.
995 */
996 if (!mmc_host_is_spi(host)) {
997 err = mmc_select_card(card);
998 if (err)
Wei WANG7fca9672013-07-17 14:21:10 +0800999 goto free_card;
Michal Miroslaw71578a12010-08-10 18:01:40 -07001000 }
1001
1002 err = mmc_sd_setup_card(host, card, oldcard != NULL);
1003 if (err)
1004 goto free_card;
1005
Arindam Nathd6d50a12011-05-05 12:18:59 +05301006 /* Initialization sequence for UHS-I cards */
1007 if (rocr & SD_ROCR_S18A) {
1008 err = mmc_sd_init_uhs_card(card);
Pierre Ossman17b04292007-07-22 22:18:46 +02001009 if (err)
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001010 goto free_card;
Arindam Nathd6d50a12011-05-05 12:18:59 +05301011 } else {
1012 /*
1013 * Attempt to change to high-speed (if supported)
1014 */
1015 err = mmc_sd_switch_hs(card);
1016 if (err > 0)
Seungwon Jeoncdc99172014-04-23 17:07:35 +09001017 mmc_set_timing(card->host, MMC_TIMING_SD_HS);
Arindam Nathd6d50a12011-05-05 12:18:59 +05301018 else if (err)
1019 goto free_card;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001020
Arindam Nathd6d50a12011-05-05 12:18:59 +05301021 /*
1022 * Set bus speed.
1023 */
1024 mmc_set_clock(host, mmc_sd_get_max_clock(card));
1025
1026 /*
1027 * Switch to wider bus (if supported).
1028 */
1029 if ((host->caps & MMC_CAP_4_BIT_DATA) &&
1030 (card->scr.bus_widths & SD_SCR_BUS_WIDTH_4)) {
1031 err = mmc_app_set_bus_width(card, MMC_BUS_WIDTH_4);
1032 if (err)
1033 goto free_card;
1034
1035 mmc_set_bus_width(host, MMC_BUS_WIDTH_4);
1036 }
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001037 }
1038
Michal Miroslaw71578a12010-08-10 18:01:40 -07001039 host->card = card;
Pierre Ossman17b04292007-07-22 22:18:46 +02001040 return 0;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001041
1042free_card:
1043 if (!oldcard)
1044 mmc_remove_card(card);
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001045
Pierre Ossmanadf66a02007-07-22 23:08:30 +02001046 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001047}
1048
1049/*
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001050 * Host is being removed. Free up the current card.
1051 */
1052static void mmc_sd_remove(struct mmc_host *host)
1053{
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001054 mmc_remove_card(host->card);
1055 host->card = NULL;
1056}
1057
1058/*
Adrian Hunterd3049502011-11-28 16:22:00 +02001059 * Card detection - card is alive.
1060 */
1061static int mmc_sd_alive(struct mmc_host *host)
1062{
1063 return mmc_send_status(host->card, NULL);
1064}
1065
1066/*
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001067 * Card detection callback from host.
1068 */
1069static void mmc_sd_detect(struct mmc_host *host)
1070{
1071 int err;
1072
Ulf Hanssone94cfef2013-05-02 14:02:38 +02001073 mmc_get_card(host->card);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001074
1075 /*
1076 * Just check if our card has been removed.
1077 */
Adrian Hunterd3049502011-11-28 16:22:00 +02001078 err = _mmc_detect_card_removed(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001079
Ulf Hanssone94cfef2013-05-02 14:02:38 +02001080 mmc_put_card(host->card);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001081
Pierre Ossman17b04292007-07-22 22:18:46 +02001082 if (err) {
Pierre Ossman4101c162007-05-19 13:39:01 +02001083 mmc_sd_remove(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001084
1085 mmc_claim_host(host);
1086 mmc_detach_bus(host);
Ulf Hansson7f7e4122011-09-21 14:08:13 -04001087 mmc_power_off(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001088 mmc_release_host(host);
1089 }
1090}
1091
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001092static int _mmc_sd_suspend(struct mmc_host *host)
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001093{
Jaehoon Chung85e727e2012-05-31 20:31:47 +09001094 int err = 0;
1095
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001096 mmc_claim_host(host);
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001097
1098 if (mmc_card_suspended(host->card))
1099 goto out;
1100
David Brownellaf517152007-08-08 09:11:32 -07001101 if (!mmc_host_is_spi(host))
Jaehoon Chung85e727e2012-05-31 20:31:47 +09001102 err = mmc_deselect_cards(host);
Seungwon Jeoncdc99172014-04-23 17:07:35 +09001103
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001104 if (!err) {
Ulf Hansson74590262013-06-10 17:03:38 +02001105 mmc_power_off(host);
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001106 mmc_card_set_suspended(host->card);
1107 }
Nicolas Pitre95cdfb72009-09-22 16:45:29 -07001108
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001109out:
1110 mmc_release_host(host);
Jaehoon Chung85e727e2012-05-31 20:31:47 +09001111 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001112}
1113
1114/*
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001115 * Callback for suspend
1116 */
1117static int mmc_sd_suspend(struct mmc_host *host)
1118{
1119 int err;
1120
1121 err = _mmc_sd_suspend(host);
1122 if (!err) {
1123 pm_runtime_disable(&host->card->dev);
1124 pm_runtime_set_suspended(&host->card->dev);
1125 }
1126
1127 return err;
1128}
1129
1130/*
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001131 * This function tries to determine if the same card is still present
1132 * and, if so, restore all state to it.
1133 */
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001134static int _mmc_sd_resume(struct mmc_host *host)
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001135{
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001136 int err = 0;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001137
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001138 mmc_claim_host(host);
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001139
1140 if (!mmc_card_suspended(host->card))
1141 goto out;
1142
Ulf Hansson69041152013-09-13 11:31:33 +02001143 mmc_power_up(host, host->card->ocr);
Ulf Hansson69041152013-09-13 11:31:33 +02001144 err = mmc_sd_init_card(host, host->card->ocr, host->card);
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001145 mmc_card_clr_suspended(host->card);
Pierre Ossman2986d0b2007-07-22 17:52:06 +02001146
Ulf Hansson9ec775f2013-10-02 17:37:09 +02001147out:
1148 mmc_release_host(host);
Nicolas Pitre95cdfb72009-09-22 16:45:29 -07001149 return err;
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001150}
1151
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001152/*
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001153 * Callback for resume
1154 */
1155static int mmc_sd_resume(struct mmc_host *host)
1156{
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001157 pm_runtime_enable(&host->card->dev);
Ulf Hanssonc29536e2015-11-05 16:01:32 +01001158 return 0;
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001159}
1160
1161/*
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001162 * Callback for runtime_suspend.
1163 */
1164static int mmc_sd_runtime_suspend(struct mmc_host *host)
1165{
1166 int err;
1167
1168 if (!(host->caps & MMC_CAP_AGGRESSIVE_PM))
1169 return 0;
1170
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001171 err = _mmc_sd_suspend(host);
Ulf Hansson0cc81a82013-10-03 11:24:44 +02001172 if (err)
Masanari Iidaf42cf8d2015-02-24 23:11:26 +09001173 pr_err("%s: error %d doing aggressive suspend\n",
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001174 mmc_hostname(host), err);
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001175
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001176 return err;
1177}
1178
1179/*
1180 * Callback for runtime_resume.
1181 */
1182static int mmc_sd_runtime_resume(struct mmc_host *host)
1183{
1184 int err;
1185
Ulf Hansson0cb403a2013-10-10 14:20:05 +02001186 err = _mmc_sd_resume(host);
Adrian Hunter520322d2015-12-14 15:51:27 +02001187 if (err && err != -ENOMEDIUM)
Ulf Hanssonc29536e2015-11-05 16:01:32 +01001188 pr_err("%s: error %d doing runtime resume\n",
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001189 mmc_hostname(host), err);
1190
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001191 return 0;
1192}
1193
Johan Rudholmdc0ecfe2015-01-12 15:38:06 +01001194static int mmc_sd_reset(struct mmc_host *host)
1195{
1196 mmc_power_cycle(host, host->card->ocr);
Ulf Hansson3056c492015-06-01 11:14:58 +02001197 return mmc_sd_init_card(host, host->card->ocr, host->card);
Johan Rudholmdc0ecfe2015-01-12 15:38:06 +01001198}
1199
Adrian Hunter9feae242009-09-22 16:44:32 -07001200static const struct mmc_bus_ops mmc_sd_ops = {
1201 .remove = mmc_sd_remove,
1202 .detect = mmc_sd_detect,
Ulf Hanssonc4d770d2013-05-02 14:02:39 +02001203 .runtime_suspend = mmc_sd_runtime_suspend,
1204 .runtime_resume = mmc_sd_runtime_resume,
Adrian Hunter9feae242009-09-22 16:44:32 -07001205 .suspend = mmc_sd_suspend,
1206 .resume = mmc_sd_resume,
Adrian Hunterd3049502011-11-28 16:22:00 +02001207 .alive = mmc_sd_alive,
Ulf Hansson5992e782013-06-10 17:03:42 +02001208 .shutdown = mmc_sd_suspend,
Johan Rudholmdc0ecfe2015-01-12 15:38:06 +01001209 .reset = mmc_sd_reset,
Adrian Hunter9feae242009-09-22 16:44:32 -07001210};
1211
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001212/*
1213 * Starting point for SD card init.
1214 */
Andy Ross807e8e42011-01-03 10:36:56 -08001215int mmc_attach_sd(struct mmc_host *host)
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001216{
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001217 int err;
Ulf Hansson69041152013-09-13 11:31:33 +02001218 u32 ocr, rocr;
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001219
Pierre Ossmand84075c82007-08-09 13:23:56 +02001220 WARN_ON(!host->claimed);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001221
Andy Ross807e8e42011-01-03 10:36:56 -08001222 err = mmc_send_app_op_cond(host, 0, &ocr);
1223 if (err)
1224 return err;
1225
Ulf Hansson2501c912013-10-30 01:00:18 +01001226 mmc_attach_bus(host, &mmc_sd_ops);
Takashi Iwai8f230f42010-12-08 10:04:30 +01001227 if (host->ocr_avail_sd)
1228 host->ocr_avail = host->ocr_avail_sd;
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001229
Philip Langdale55556da2007-03-16 19:39:00 -07001230 /*
David Brownellaf517152007-08-08 09:11:32 -07001231 * We need to get OCR a different way for SPI.
1232 */
1233 if (mmc_host_is_spi(host)) {
1234 mmc_go_idle(host);
1235
1236 err = mmc_spi_read_ocr(host, 0, &ocr);
1237 if (err)
1238 goto err;
1239 }
1240
Ulf Hansson69041152013-09-13 11:31:33 +02001241 rocr = mmc_select_voltage(host, ocr);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001242
1243 /*
1244 * Can we support the voltage(s) of the card(s)?
1245 */
Ulf Hansson69041152013-09-13 11:31:33 +02001246 if (!rocr) {
Pierre Ossman109b5be2007-07-23 00:12:10 +02001247 err = -EINVAL;
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001248 goto err;
Pierre Ossman109b5be2007-07-23 00:12:10 +02001249 }
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001250
1251 /*
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001252 * Detect and init the card.
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001253 */
Ulf Hansson69041152013-09-13 11:31:33 +02001254 err = mmc_sd_init_card(host, rocr, NULL);
Pierre Ossman17b04292007-07-22 22:18:46 +02001255 if (err)
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001256 goto err;
1257
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001258 mmc_release_host(host);
Pierre Ossman4101c162007-05-19 13:39:01 +02001259 err = mmc_add_card(host->card);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001260 if (err)
Pierre Ossman2986d0b2007-07-22 17:52:06 +02001261 goto remove_card;
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001262
Sergei Shtylyov2860d062015-10-14 23:53:03 +03001263 mmc_claim_host(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001264 return 0;
1265
Pierre Ossman2986d0b2007-07-22 17:52:06 +02001266remove_card:
Pierre Ossman6abaa0c2007-05-01 16:00:02 +02001267 mmc_remove_card(host->card);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001268 host->card = NULL;
Pierre Ossman2986d0b2007-07-22 17:52:06 +02001269 mmc_claim_host(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001270err:
1271 mmc_detach_bus(host);
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001272
Girish K Sa3c76eb2011-10-11 11:44:09 +05301273 pr_err("%s: error %d whilst initialising SD card\n",
Pierre Ossman109b5be2007-07-23 00:12:10 +02001274 mmc_hostname(host), err);
1275
Pierre Ossmanadf66a02007-07-22 23:08:30 +02001276 return err;
Pierre Ossman7ea239d2006-12-31 00:11:32 +01001277}