115a0580cSDavid Brownell /* 215a0580cSDavid Brownell * mmc_spi.c - Access SD/MMC cards through SPI master controllers 315a0580cSDavid Brownell * 415a0580cSDavid Brownell * (C) Copyright 2005, Intec Automation, 515a0580cSDavid Brownell * Mike Lavender (mike@steroidmicros) 615a0580cSDavid Brownell * (C) Copyright 2006-2007, David Brownell 715a0580cSDavid Brownell * (C) Copyright 2007, Axis Communications, 815a0580cSDavid Brownell * Hans-Peter Nilsson (hp@axis.com) 915a0580cSDavid Brownell * (C) Copyright 2007, ATRON electronic GmbH, 1015a0580cSDavid Brownell * Jan Nikitenko <jan.nikitenko@gmail.com> 1115a0580cSDavid Brownell * 1215a0580cSDavid Brownell * 1315a0580cSDavid Brownell * This program is free software; you can redistribute it and/or modify 1415a0580cSDavid Brownell * it under the terms of the GNU General Public License as published by 1515a0580cSDavid Brownell * the Free Software Foundation; either version 2 of the License, or 1615a0580cSDavid Brownell * (at your option) any later version. 1715a0580cSDavid Brownell * 1815a0580cSDavid Brownell * This program is distributed in the hope that it will be useful, 1915a0580cSDavid Brownell * but WITHOUT ANY WARRANTY; without even the implied warranty of 2015a0580cSDavid Brownell * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 2115a0580cSDavid Brownell * GNU General Public License for more details. 2215a0580cSDavid Brownell * 2315a0580cSDavid Brownell * You should have received a copy of the GNU General Public License 2415a0580cSDavid Brownell * along with this program; if not, write to the Free Software 2515a0580cSDavid Brownell * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. 2615a0580cSDavid Brownell */ 2715a0580cSDavid Brownell #include <linux/hrtimer.h> 2815a0580cSDavid Brownell #include <linux/delay.h> 2915a0580cSDavid Brownell #include <linux/blkdev.h> 3015a0580cSDavid Brownell #include <linux/dma-mapping.h> 3115a0580cSDavid Brownell #include <linux/crc7.h> 3215a0580cSDavid Brownell #include <linux/crc-itu-t.h> 3315a0580cSDavid Brownell 3415a0580cSDavid Brownell #include <linux/mmc/host.h> 3515a0580cSDavid Brownell #include <linux/mmc/mmc.h> /* for R1_SPI_* bit values */ 3615a0580cSDavid Brownell 3715a0580cSDavid Brownell #include <linux/spi/spi.h> 3815a0580cSDavid Brownell #include <linux/spi/mmc_spi.h> 3915a0580cSDavid Brownell 4015a0580cSDavid Brownell #include <asm/unaligned.h> 4115a0580cSDavid Brownell 4215a0580cSDavid Brownell 4315a0580cSDavid Brownell /* NOTES: 4415a0580cSDavid Brownell * 4515a0580cSDavid Brownell * - For now, we won't try to interoperate with a real mmc/sd/sdio 4615a0580cSDavid Brownell * controller, although some of them do have hardware support for 4715a0580cSDavid Brownell * SPI protocol. The main reason for such configs would be mmc-ish 4815a0580cSDavid Brownell * cards like DataFlash, which don't support that "native" protocol. 4915a0580cSDavid Brownell * 5015a0580cSDavid Brownell * We don't have a "DataFlash/MMC/SD/SDIO card slot" abstraction to 5115a0580cSDavid Brownell * switch between driver stacks, and in any case if "native" mode 5215a0580cSDavid Brownell * is available, it will be faster and hence preferable. 5315a0580cSDavid Brownell * 5415a0580cSDavid Brownell * - MMC depends on a different chipselect management policy than the 5515a0580cSDavid Brownell * SPI interface currently supports for shared bus segments: it needs 5615a0580cSDavid Brownell * to issue multiple spi_message requests with the chipselect active, 5715a0580cSDavid Brownell * using the results of one message to decide the next one to issue. 5815a0580cSDavid Brownell * 5915a0580cSDavid Brownell * Pending updates to the programming interface, this driver expects 6015a0580cSDavid Brownell * that it not share the bus with other drivers (precluding conflicts). 6115a0580cSDavid Brownell * 6215a0580cSDavid Brownell * - We tell the controller to keep the chipselect active from the 6315a0580cSDavid Brownell * beginning of an mmc_host_ops.request until the end. So beware 6415a0580cSDavid Brownell * of SPI controller drivers that mis-handle the cs_change flag! 6515a0580cSDavid Brownell * 6615a0580cSDavid Brownell * However, many cards seem OK with chipselect flapping up/down 6715a0580cSDavid Brownell * during that time ... at least on unshared bus segments. 6815a0580cSDavid Brownell */ 6915a0580cSDavid Brownell 7015a0580cSDavid Brownell 7115a0580cSDavid Brownell /* 7215a0580cSDavid Brownell * Local protocol constants, internal to data block protocols. 7315a0580cSDavid Brownell */ 7415a0580cSDavid Brownell 7515a0580cSDavid Brownell /* Response tokens used to ack each block written: */ 7615a0580cSDavid Brownell #define SPI_MMC_RESPONSE_CODE(x) ((x) & 0x1f) 7715a0580cSDavid Brownell #define SPI_RESPONSE_ACCEPTED ((2 << 1)|1) 7815a0580cSDavid Brownell #define SPI_RESPONSE_CRC_ERR ((5 << 1)|1) 7915a0580cSDavid Brownell #define SPI_RESPONSE_WRITE_ERR ((6 << 1)|1) 8015a0580cSDavid Brownell 8115a0580cSDavid Brownell /* Read and write blocks start with these tokens and end with crc; 8215a0580cSDavid Brownell * on error, read tokens act like a subset of R2_SPI_* values. 8315a0580cSDavid Brownell */ 8415a0580cSDavid Brownell #define SPI_TOKEN_SINGLE 0xfe /* single block r/w, multiblock read */ 8515a0580cSDavid Brownell #define SPI_TOKEN_MULTI_WRITE 0xfc /* multiblock write */ 8615a0580cSDavid Brownell #define SPI_TOKEN_STOP_TRAN 0xfd /* terminate multiblock write */ 8715a0580cSDavid Brownell 8815a0580cSDavid Brownell #define MMC_SPI_BLOCKSIZE 512 8915a0580cSDavid Brownell 9015a0580cSDavid Brownell 9115a0580cSDavid Brownell /* These fixed timeouts come from the latest SD specs, which say to ignore 9215a0580cSDavid Brownell * the CSD values. The R1B value is for card erase (e.g. the "I forgot the 9315a0580cSDavid Brownell * card's password" scenario); it's mostly applied to STOP_TRANSMISSION after 9415a0580cSDavid Brownell * reads which takes nowhere near that long. Older cards may be able to use 9515a0580cSDavid Brownell * shorter timeouts ... but why bother? 9615a0580cSDavid Brownell */ 9715a0580cSDavid Brownell #define readblock_timeout ktime_set(0, 100 * 1000 * 1000) 9815a0580cSDavid Brownell #define writeblock_timeout ktime_set(0, 250 * 1000 * 1000) 9915a0580cSDavid Brownell #define r1b_timeout ktime_set(3, 0) 10015a0580cSDavid Brownell 10115a0580cSDavid Brownell 10215a0580cSDavid Brownell /****************************************************************************/ 10315a0580cSDavid Brownell 10415a0580cSDavid Brownell /* 10515a0580cSDavid Brownell * Local Data Structures 10615a0580cSDavid Brownell */ 10715a0580cSDavid Brownell 10815a0580cSDavid Brownell /* "scratch" is per-{command,block} data exchanged with the card */ 10915a0580cSDavid Brownell struct scratch { 11015a0580cSDavid Brownell u8 status[29]; 11115a0580cSDavid Brownell u8 data_token; 11215a0580cSDavid Brownell __be16 crc_val; 11315a0580cSDavid Brownell }; 11415a0580cSDavid Brownell 11515a0580cSDavid Brownell struct mmc_spi_host { 11615a0580cSDavid Brownell struct mmc_host *mmc; 11715a0580cSDavid Brownell struct spi_device *spi; 11815a0580cSDavid Brownell 11915a0580cSDavid Brownell unsigned char power_mode; 12015a0580cSDavid Brownell u16 powerup_msecs; 12115a0580cSDavid Brownell 12215a0580cSDavid Brownell struct mmc_spi_platform_data *pdata; 12315a0580cSDavid Brownell 12415a0580cSDavid Brownell /* for bulk data transfers */ 12515a0580cSDavid Brownell struct spi_transfer token, t, crc, early_status; 12615a0580cSDavid Brownell struct spi_message m; 12715a0580cSDavid Brownell 12815a0580cSDavid Brownell /* for status readback */ 12915a0580cSDavid Brownell struct spi_transfer status; 13015a0580cSDavid Brownell struct spi_message readback; 13115a0580cSDavid Brownell 13215a0580cSDavid Brownell /* underlying DMA-aware controller, or null */ 13315a0580cSDavid Brownell struct device *dma_dev; 13415a0580cSDavid Brownell 13515a0580cSDavid Brownell /* buffer used for commands and for message "overhead" */ 13615a0580cSDavid Brownell struct scratch *data; 13715a0580cSDavid Brownell dma_addr_t data_dma; 13815a0580cSDavid Brownell 13915a0580cSDavid Brownell /* Specs say to write ones most of the time, even when the card 14015a0580cSDavid Brownell * has no need to read its input data; and many cards won't care. 14115a0580cSDavid Brownell * This is our source of those ones. 14215a0580cSDavid Brownell */ 14315a0580cSDavid Brownell void *ones; 14415a0580cSDavid Brownell dma_addr_t ones_dma; 14515a0580cSDavid Brownell }; 14615a0580cSDavid Brownell 14715a0580cSDavid Brownell 14815a0580cSDavid Brownell /****************************************************************************/ 14915a0580cSDavid Brownell 15015a0580cSDavid Brownell /* 15115a0580cSDavid Brownell * MMC-over-SPI protocol glue, used by the MMC stack interface 15215a0580cSDavid Brownell */ 15315a0580cSDavid Brownell 15415a0580cSDavid Brownell static inline int mmc_cs_off(struct mmc_spi_host *host) 15515a0580cSDavid Brownell { 15615a0580cSDavid Brownell /* chipselect will always be inactive after setup() */ 15715a0580cSDavid Brownell return spi_setup(host->spi); 15815a0580cSDavid Brownell } 15915a0580cSDavid Brownell 16015a0580cSDavid Brownell static int 16115a0580cSDavid Brownell mmc_spi_readbytes(struct mmc_spi_host *host, unsigned len) 16215a0580cSDavid Brownell { 16315a0580cSDavid Brownell int status; 16415a0580cSDavid Brownell 16515a0580cSDavid Brownell if (len > sizeof(*host->data)) { 16615a0580cSDavid Brownell WARN_ON(1); 16715a0580cSDavid Brownell return -EIO; 16815a0580cSDavid Brownell } 16915a0580cSDavid Brownell 17015a0580cSDavid Brownell host->status.len = len; 17115a0580cSDavid Brownell 17215a0580cSDavid Brownell if (host->dma_dev) 17315a0580cSDavid Brownell dma_sync_single_for_device(host->dma_dev, 17415a0580cSDavid Brownell host->data_dma, sizeof(*host->data), 17515a0580cSDavid Brownell DMA_FROM_DEVICE); 17615a0580cSDavid Brownell 17715a0580cSDavid Brownell status = spi_sync(host->spi, &host->readback); 17815a0580cSDavid Brownell if (status == 0) 17915a0580cSDavid Brownell status = host->readback.status; 18015a0580cSDavid Brownell 18115a0580cSDavid Brownell if (host->dma_dev) 18215a0580cSDavid Brownell dma_sync_single_for_cpu(host->dma_dev, 18315a0580cSDavid Brownell host->data_dma, sizeof(*host->data), 18415a0580cSDavid Brownell DMA_FROM_DEVICE); 18515a0580cSDavid Brownell 18615a0580cSDavid Brownell return status; 18715a0580cSDavid Brownell } 18815a0580cSDavid Brownell 18915a0580cSDavid Brownell static int 19015a0580cSDavid Brownell mmc_spi_skip(struct mmc_spi_host *host, ktime_t timeout, unsigned n, u8 byte) 19115a0580cSDavid Brownell { 19215a0580cSDavid Brownell u8 *cp = host->data->status; 19315a0580cSDavid Brownell 19415a0580cSDavid Brownell timeout = ktime_add(timeout, ktime_get()); 19515a0580cSDavid Brownell 19615a0580cSDavid Brownell while (1) { 19715a0580cSDavid Brownell int status; 19815a0580cSDavid Brownell unsigned i; 19915a0580cSDavid Brownell 20015a0580cSDavid Brownell status = mmc_spi_readbytes(host, n); 20115a0580cSDavid Brownell if (status < 0) 20215a0580cSDavid Brownell return status; 20315a0580cSDavid Brownell 20415a0580cSDavid Brownell for (i = 0; i < n; i++) { 20515a0580cSDavid Brownell if (cp[i] != byte) 20615a0580cSDavid Brownell return cp[i]; 20715a0580cSDavid Brownell } 20815a0580cSDavid Brownell 20915a0580cSDavid Brownell /* REVISIT investigate msleep() to avoid busy-wait I/O 21015a0580cSDavid Brownell * in at least some cases. 21115a0580cSDavid Brownell */ 21215a0580cSDavid Brownell if (ktime_to_ns(ktime_sub(ktime_get(), timeout)) > 0) 21315a0580cSDavid Brownell break; 21415a0580cSDavid Brownell } 21515a0580cSDavid Brownell return -ETIMEDOUT; 21615a0580cSDavid Brownell } 21715a0580cSDavid Brownell 21815a0580cSDavid Brownell static inline int 21915a0580cSDavid Brownell mmc_spi_wait_unbusy(struct mmc_spi_host *host, ktime_t timeout) 22015a0580cSDavid Brownell { 22115a0580cSDavid Brownell return mmc_spi_skip(host, timeout, sizeof(host->data->status), 0); 22215a0580cSDavid Brownell } 22315a0580cSDavid Brownell 22415a0580cSDavid Brownell static int mmc_spi_readtoken(struct mmc_spi_host *host) 22515a0580cSDavid Brownell { 22615a0580cSDavid Brownell return mmc_spi_skip(host, readblock_timeout, 1, 0xff); 22715a0580cSDavid Brownell } 22815a0580cSDavid Brownell 22915a0580cSDavid Brownell 23015a0580cSDavid Brownell /* 23115a0580cSDavid Brownell * Note that for SPI, cmd->resp[0] is not the same data as "native" protocol 23215a0580cSDavid Brownell * hosts return! The low byte holds R1_SPI bits. The next byte may hold 23315a0580cSDavid Brownell * R2_SPI bits ... for SEND_STATUS, or after data read errors. 23415a0580cSDavid Brownell * 23515a0580cSDavid Brownell * cmd->resp[1] holds any four-byte response, for R3 (READ_OCR) and on 23615a0580cSDavid Brownell * newer cards R7 (IF_COND). 23715a0580cSDavid Brownell */ 23815a0580cSDavid Brownell 23915a0580cSDavid Brownell static char *maptype(struct mmc_command *cmd) 24015a0580cSDavid Brownell { 24115a0580cSDavid Brownell switch (mmc_spi_resp_type(cmd)) { 24215a0580cSDavid Brownell case MMC_RSP_SPI_R1: return "R1"; 24315a0580cSDavid Brownell case MMC_RSP_SPI_R1B: return "R1B"; 24415a0580cSDavid Brownell case MMC_RSP_SPI_R2: return "R2/R5"; 24515a0580cSDavid Brownell case MMC_RSP_SPI_R3: return "R3/R4/R7"; 24615a0580cSDavid Brownell default: return "?"; 24715a0580cSDavid Brownell } 24815a0580cSDavid Brownell } 24915a0580cSDavid Brownell 25015a0580cSDavid Brownell /* return zero, else negative errno after setting cmd->error */ 25115a0580cSDavid Brownell static int mmc_spi_response_get(struct mmc_spi_host *host, 25215a0580cSDavid Brownell struct mmc_command *cmd, int cs_on) 25315a0580cSDavid Brownell { 25415a0580cSDavid Brownell u8 *cp = host->data->status; 25515a0580cSDavid Brownell u8 *end = cp + host->t.len; 25615a0580cSDavid Brownell int value = 0; 25715a0580cSDavid Brownell char tag[32]; 25815a0580cSDavid Brownell 25915a0580cSDavid Brownell snprintf(tag, sizeof(tag), " ... CMD%d response SPI_%s", 26015a0580cSDavid Brownell cmd->opcode, maptype(cmd)); 26115a0580cSDavid Brownell 26215a0580cSDavid Brownell /* Except for data block reads, the whole response will already 26315a0580cSDavid Brownell * be stored in the scratch buffer. It's somewhere after the 26415a0580cSDavid Brownell * command and the first byte we read after it. We ignore that 26515a0580cSDavid Brownell * first byte. After STOP_TRANSMISSION command it may include 26615a0580cSDavid Brownell * two data bits, but otherwise it's all ones. 26715a0580cSDavid Brownell */ 26815a0580cSDavid Brownell cp += 8; 26915a0580cSDavid Brownell while (cp < end && *cp == 0xff) 27015a0580cSDavid Brownell cp++; 27115a0580cSDavid Brownell 27215a0580cSDavid Brownell /* Data block reads (R1 response types) may need more data... */ 27315a0580cSDavid Brownell if (cp == end) { 27415a0580cSDavid Brownell unsigned i; 27515a0580cSDavid Brownell 27615a0580cSDavid Brownell cp = host->data->status; 27715a0580cSDavid Brownell 27815a0580cSDavid Brownell /* Card sends N(CR) (== 1..8) bytes of all-ones then one 27915a0580cSDavid Brownell * status byte ... and we already scanned 2 bytes. 28015a0580cSDavid Brownell * 28115a0580cSDavid Brownell * REVISIT block read paths use nasty byte-at-a-time I/O 28215a0580cSDavid Brownell * so it can always DMA directly into the target buffer. 28315a0580cSDavid Brownell * It'd probably be better to memcpy() the first chunk and 28415a0580cSDavid Brownell * avoid extra i/o calls... 28515a0580cSDavid Brownell */ 28615a0580cSDavid Brownell for (i = 2; i < 9; i++) { 28715a0580cSDavid Brownell value = mmc_spi_readbytes(host, 1); 28815a0580cSDavid Brownell if (value < 0) 28915a0580cSDavid Brownell goto done; 29015a0580cSDavid Brownell if (*cp != 0xff) 29115a0580cSDavid Brownell goto checkstatus; 29215a0580cSDavid Brownell } 29315a0580cSDavid Brownell value = -ETIMEDOUT; 29415a0580cSDavid Brownell goto done; 29515a0580cSDavid Brownell } 29615a0580cSDavid Brownell 29715a0580cSDavid Brownell checkstatus: 29815a0580cSDavid Brownell if (*cp & 0x80) { 29915a0580cSDavid Brownell dev_dbg(&host->spi->dev, "%s: INVALID RESPONSE, %02x\n", 30015a0580cSDavid Brownell tag, *cp); 30115a0580cSDavid Brownell value = -EBADR; 30215a0580cSDavid Brownell goto done; 30315a0580cSDavid Brownell } 30415a0580cSDavid Brownell 30515a0580cSDavid Brownell cmd->resp[0] = *cp++; 30615a0580cSDavid Brownell cmd->error = 0; 30715a0580cSDavid Brownell 30815a0580cSDavid Brownell /* Status byte: the entire seven-bit R1 response. */ 30915a0580cSDavid Brownell if (cmd->resp[0] != 0) { 31015a0580cSDavid Brownell if ((R1_SPI_PARAMETER | R1_SPI_ADDRESS 31115a0580cSDavid Brownell | R1_SPI_ILLEGAL_COMMAND) 31215a0580cSDavid Brownell & cmd->resp[0]) 31315a0580cSDavid Brownell value = -EINVAL; 31415a0580cSDavid Brownell else if (R1_SPI_COM_CRC & cmd->resp[0]) 31515a0580cSDavid Brownell value = -EILSEQ; 31615a0580cSDavid Brownell else if ((R1_SPI_ERASE_SEQ | R1_SPI_ERASE_RESET) 31715a0580cSDavid Brownell & cmd->resp[0]) 31815a0580cSDavid Brownell value = -EIO; 31915a0580cSDavid Brownell /* else R1_SPI_IDLE, "it's resetting" */ 32015a0580cSDavid Brownell } 32115a0580cSDavid Brownell 32215a0580cSDavid Brownell switch (mmc_spi_resp_type(cmd)) { 32315a0580cSDavid Brownell 32415a0580cSDavid Brownell /* SPI R1B == R1 + busy; STOP_TRANSMISSION (for multiblock reads) 32515a0580cSDavid Brownell * and less-common stuff like various erase operations. 32615a0580cSDavid Brownell */ 32715a0580cSDavid Brownell case MMC_RSP_SPI_R1B: 32815a0580cSDavid Brownell /* maybe we read all the busy tokens already */ 32915a0580cSDavid Brownell while (cp < end && *cp == 0) 33015a0580cSDavid Brownell cp++; 33115a0580cSDavid Brownell if (cp == end) 33215a0580cSDavid Brownell mmc_spi_wait_unbusy(host, r1b_timeout); 33315a0580cSDavid Brownell break; 33415a0580cSDavid Brownell 33515a0580cSDavid Brownell /* SPI R2 == R1 + second status byte; SEND_STATUS 33615a0580cSDavid Brownell * SPI R5 == R1 + data byte; IO_RW_DIRECT 33715a0580cSDavid Brownell */ 33815a0580cSDavid Brownell case MMC_RSP_SPI_R2: 33915a0580cSDavid Brownell cmd->resp[0] |= *cp << 8; 34015a0580cSDavid Brownell break; 34115a0580cSDavid Brownell 34215a0580cSDavid Brownell /* SPI R3, R4, or R7 == R1 + 4 bytes */ 34315a0580cSDavid Brownell case MMC_RSP_SPI_R3: 34415a0580cSDavid Brownell cmd->resp[1] = be32_to_cpu(get_unaligned((u32 *)cp)); 34515a0580cSDavid Brownell break; 34615a0580cSDavid Brownell 34715a0580cSDavid Brownell /* SPI R1 == just one status byte */ 34815a0580cSDavid Brownell case MMC_RSP_SPI_R1: 34915a0580cSDavid Brownell break; 35015a0580cSDavid Brownell 35115a0580cSDavid Brownell default: 35215a0580cSDavid Brownell dev_dbg(&host->spi->dev, "bad response type %04x\n", 35315a0580cSDavid Brownell mmc_spi_resp_type(cmd)); 35415a0580cSDavid Brownell if (value >= 0) 35515a0580cSDavid Brownell value = -EINVAL; 35615a0580cSDavid Brownell goto done; 35715a0580cSDavid Brownell } 35815a0580cSDavid Brownell 35915a0580cSDavid Brownell if (value < 0) 36015a0580cSDavid Brownell dev_dbg(&host->spi->dev, "%s: resp %04x %08x\n", 36115a0580cSDavid Brownell tag, cmd->resp[0], cmd->resp[1]); 36215a0580cSDavid Brownell 36315a0580cSDavid Brownell /* disable chipselect on errors and some success cases */ 36415a0580cSDavid Brownell if (value >= 0 && cs_on) 36515a0580cSDavid Brownell return value; 36615a0580cSDavid Brownell done: 36715a0580cSDavid Brownell if (value < 0) 36815a0580cSDavid Brownell cmd->error = value; 36915a0580cSDavid Brownell mmc_cs_off(host); 37015a0580cSDavid Brownell return value; 37115a0580cSDavid Brownell } 37215a0580cSDavid Brownell 37315a0580cSDavid Brownell /* Issue command and read its response. 37415a0580cSDavid Brownell * Returns zero on success, negative for error. 37515a0580cSDavid Brownell * 37615a0580cSDavid Brownell * On error, caller must cope with mmc core retry mechanism. That 37715a0580cSDavid Brownell * means immediate low-level resubmit, which affects the bus lock... 37815a0580cSDavid Brownell */ 37915a0580cSDavid Brownell static int 38015a0580cSDavid Brownell mmc_spi_command_send(struct mmc_spi_host *host, 38115a0580cSDavid Brownell struct mmc_request *mrq, 38215a0580cSDavid Brownell struct mmc_command *cmd, int cs_on) 38315a0580cSDavid Brownell { 38415a0580cSDavid Brownell struct scratch *data = host->data; 38515a0580cSDavid Brownell u8 *cp = data->status; 38615a0580cSDavid Brownell u32 arg = cmd->arg; 38715a0580cSDavid Brownell int status; 38815a0580cSDavid Brownell struct spi_transfer *t; 38915a0580cSDavid Brownell 39015a0580cSDavid Brownell /* We can handle most commands (except block reads) in one full 39115a0580cSDavid Brownell * duplex I/O operation before either starting the next transfer 39215a0580cSDavid Brownell * (data block or command) or else deselecting the card. 39315a0580cSDavid Brownell * 39415a0580cSDavid Brownell * First, write 7 bytes: 39515a0580cSDavid Brownell * - an all-ones byte to ensure the card is ready 39615a0580cSDavid Brownell * - opcode byte (plus start and transmission bits) 39715a0580cSDavid Brownell * - four bytes of big-endian argument 39815a0580cSDavid Brownell * - crc7 (plus end bit) ... always computed, it's cheap 39915a0580cSDavid Brownell * 40015a0580cSDavid Brownell * We init the whole buffer to all-ones, which is what we need 40115a0580cSDavid Brownell * to write while we're reading (later) response data. 40215a0580cSDavid Brownell */ 40315a0580cSDavid Brownell memset(cp++, 0xff, sizeof(data->status)); 40415a0580cSDavid Brownell 40515a0580cSDavid Brownell *cp++ = 0x40 | cmd->opcode; 40615a0580cSDavid Brownell *cp++ = (u8)(arg >> 24); 40715a0580cSDavid Brownell *cp++ = (u8)(arg >> 16); 40815a0580cSDavid Brownell *cp++ = (u8)(arg >> 8); 40915a0580cSDavid Brownell *cp++ = (u8)arg; 41015a0580cSDavid Brownell *cp++ = (crc7(0, &data->status[1], 5) << 1) | 0x01; 41115a0580cSDavid Brownell 41215a0580cSDavid Brownell /* Then, read up to 13 bytes (while writing all-ones): 41315a0580cSDavid Brownell * - N(CR) (== 1..8) bytes of all-ones 41415a0580cSDavid Brownell * - status byte (for all response types) 41515a0580cSDavid Brownell * - the rest of the response, either: 41615a0580cSDavid Brownell * + nothing, for R1 or R1B responses 41715a0580cSDavid Brownell * + second status byte, for R2 responses 41815a0580cSDavid Brownell * + four data bytes, for R3 and R7 responses 41915a0580cSDavid Brownell * 42015a0580cSDavid Brownell * Finally, read some more bytes ... in the nice cases we know in 42115a0580cSDavid Brownell * advance how many, and reading 1 more is always OK: 42215a0580cSDavid Brownell * - N(EC) (== 0..N) bytes of all-ones, before deselect/finish 42315a0580cSDavid Brownell * - N(RC) (== 1..N) bytes of all-ones, before next command 42415a0580cSDavid Brownell * - N(WR) (== 1..N) bytes of all-ones, before data write 42515a0580cSDavid Brownell * 42615a0580cSDavid Brownell * So in those cases one full duplex I/O of at most 21 bytes will 42715a0580cSDavid Brownell * handle the whole command, leaving the card ready to receive a 42815a0580cSDavid Brownell * data block or new command. We do that whenever we can, shaving 42915a0580cSDavid Brownell * CPU and IRQ costs (especially when using DMA or FIFOs). 43015a0580cSDavid Brownell * 43115a0580cSDavid Brownell * There are two other cases, where it's not generally practical 43215a0580cSDavid Brownell * to rely on a single I/O: 43315a0580cSDavid Brownell * 43415a0580cSDavid Brownell * - R1B responses need at least N(EC) bytes of all-zeroes. 43515a0580cSDavid Brownell * 43615a0580cSDavid Brownell * In this case we can *try* to fit it into one I/O, then 43715a0580cSDavid Brownell * maybe read more data later. 43815a0580cSDavid Brownell * 43915a0580cSDavid Brownell * - Data block reads are more troublesome, since a variable 44015a0580cSDavid Brownell * number of padding bytes precede the token and data. 44115a0580cSDavid Brownell * + N(CX) (== 0..8) bytes of all-ones, before CSD or CID 44215a0580cSDavid Brownell * + N(AC) (== 1..many) bytes of all-ones 44315a0580cSDavid Brownell * 44415a0580cSDavid Brownell * In this case we currently only have minimal speedups here: 44515a0580cSDavid Brownell * when N(CR) == 1 we can avoid I/O in response_get(). 44615a0580cSDavid Brownell */ 44715a0580cSDavid Brownell if (cs_on && (mrq->data->flags & MMC_DATA_READ)) { 44815a0580cSDavid Brownell cp += 2; /* min(N(CR)) + status */ 44915a0580cSDavid Brownell /* R1 */ 45015a0580cSDavid Brownell } else { 45115a0580cSDavid Brownell cp += 10; /* max(N(CR)) + status + min(N(RC),N(WR)) */ 45215a0580cSDavid Brownell if (cmd->flags & MMC_RSP_SPI_S2) /* R2/R5 */ 45315a0580cSDavid Brownell cp++; 45415a0580cSDavid Brownell else if (cmd->flags & MMC_RSP_SPI_B4) /* R3/R4/R7 */ 45515a0580cSDavid Brownell cp += 4; 45615a0580cSDavid Brownell else if (cmd->flags & MMC_RSP_BUSY) /* R1B */ 45715a0580cSDavid Brownell cp = data->status + sizeof(data->status); 45815a0580cSDavid Brownell /* else: R1 (most commands) */ 45915a0580cSDavid Brownell } 46015a0580cSDavid Brownell 46115a0580cSDavid Brownell dev_dbg(&host->spi->dev, " mmc_spi: CMD%d, resp %s\n", 46215a0580cSDavid Brownell cmd->opcode, maptype(cmd)); 46315a0580cSDavid Brownell 46415a0580cSDavid Brownell /* send command, leaving chipselect active */ 46515a0580cSDavid Brownell spi_message_init(&host->m); 46615a0580cSDavid Brownell 46715a0580cSDavid Brownell t = &host->t; 46815a0580cSDavid Brownell memset(t, 0, sizeof(*t)); 46915a0580cSDavid Brownell t->tx_buf = t->rx_buf = data->status; 47015a0580cSDavid Brownell t->tx_dma = t->rx_dma = host->data_dma; 47115a0580cSDavid Brownell t->len = cp - data->status; 47215a0580cSDavid Brownell t->cs_change = 1; 47315a0580cSDavid Brownell spi_message_add_tail(t, &host->m); 47415a0580cSDavid Brownell 47515a0580cSDavid Brownell if (host->dma_dev) { 47615a0580cSDavid Brownell host->m.is_dma_mapped = 1; 47715a0580cSDavid Brownell dma_sync_single_for_device(host->dma_dev, 47815a0580cSDavid Brownell host->data_dma, sizeof(*host->data), 47915a0580cSDavid Brownell DMA_BIDIRECTIONAL); 48015a0580cSDavid Brownell } 48115a0580cSDavid Brownell status = spi_sync(host->spi, &host->m); 48215a0580cSDavid Brownell if (status == 0) 48315a0580cSDavid Brownell status = host->m.status; 48415a0580cSDavid Brownell 48515a0580cSDavid Brownell if (host->dma_dev) 48615a0580cSDavid Brownell dma_sync_single_for_cpu(host->dma_dev, 48715a0580cSDavid Brownell host->data_dma, sizeof(*host->data), 48815a0580cSDavid Brownell DMA_BIDIRECTIONAL); 48915a0580cSDavid Brownell if (status < 0) { 49015a0580cSDavid Brownell dev_dbg(&host->spi->dev, " ... write returned %d\n", status); 49115a0580cSDavid Brownell cmd->error = status; 49215a0580cSDavid Brownell return status; 49315a0580cSDavid Brownell } 49415a0580cSDavid Brownell 49515a0580cSDavid Brownell /* after no-data commands and STOP_TRANSMISSION, chipselect off */ 49615a0580cSDavid Brownell return mmc_spi_response_get(host, cmd, cs_on); 49715a0580cSDavid Brownell } 49815a0580cSDavid Brownell 49915a0580cSDavid Brownell /* Build data message with up to four separate transfers. For TX, we 50015a0580cSDavid Brownell * start by writing the data token. And in most cases, we finish with 50115a0580cSDavid Brownell * a status transfer. 50215a0580cSDavid Brownell * 50315a0580cSDavid Brownell * We always provide TX data for data and CRC. The MMC/SD protocol 50415a0580cSDavid Brownell * requires us to write ones; but Linux defaults to writing zeroes; 50515a0580cSDavid Brownell * so we explicitly initialize it to all ones on RX paths. 50615a0580cSDavid Brownell * 50715a0580cSDavid Brownell * We also handle DMA mapping, so the underlying SPI controller does 50815a0580cSDavid Brownell * not need to (re)do it for each message. 50915a0580cSDavid Brownell */ 51015a0580cSDavid Brownell static void 51115a0580cSDavid Brownell mmc_spi_setup_data_message( 51215a0580cSDavid Brownell struct mmc_spi_host *host, 51315a0580cSDavid Brownell int multiple, 51415a0580cSDavid Brownell enum dma_data_direction direction) 51515a0580cSDavid Brownell { 51615a0580cSDavid Brownell struct spi_transfer *t; 51715a0580cSDavid Brownell struct scratch *scratch = host->data; 51815a0580cSDavid Brownell dma_addr_t dma = host->data_dma; 51915a0580cSDavid Brownell 52015a0580cSDavid Brownell spi_message_init(&host->m); 52115a0580cSDavid Brownell if (dma) 52215a0580cSDavid Brownell host->m.is_dma_mapped = 1; 52315a0580cSDavid Brownell 52415a0580cSDavid Brownell /* for reads, readblock() skips 0xff bytes before finding 52515a0580cSDavid Brownell * the token; for writes, this transfer issues that token. 52615a0580cSDavid Brownell */ 52715a0580cSDavid Brownell if (direction == DMA_TO_DEVICE) { 52815a0580cSDavid Brownell t = &host->token; 52915a0580cSDavid Brownell memset(t, 0, sizeof(*t)); 53015a0580cSDavid Brownell t->len = 1; 53115a0580cSDavid Brownell if (multiple) 53215a0580cSDavid Brownell scratch->data_token = SPI_TOKEN_MULTI_WRITE; 53315a0580cSDavid Brownell else 53415a0580cSDavid Brownell scratch->data_token = SPI_TOKEN_SINGLE; 53515a0580cSDavid Brownell t->tx_buf = &scratch->data_token; 53615a0580cSDavid Brownell if (dma) 53715a0580cSDavid Brownell t->tx_dma = dma + offsetof(struct scratch, data_token); 53815a0580cSDavid Brownell spi_message_add_tail(t, &host->m); 53915a0580cSDavid Brownell } 54015a0580cSDavid Brownell 54115a0580cSDavid Brownell /* Body of transfer is buffer, then CRC ... 54215a0580cSDavid Brownell * either TX-only, or RX with TX-ones. 54315a0580cSDavid Brownell */ 54415a0580cSDavid Brownell t = &host->t; 54515a0580cSDavid Brownell memset(t, 0, sizeof(*t)); 54615a0580cSDavid Brownell t->tx_buf = host->ones; 54715a0580cSDavid Brownell t->tx_dma = host->ones_dma; 54815a0580cSDavid Brownell /* length and actual buffer info are written later */ 54915a0580cSDavid Brownell spi_message_add_tail(t, &host->m); 55015a0580cSDavid Brownell 55115a0580cSDavid Brownell t = &host->crc; 55215a0580cSDavid Brownell memset(t, 0, sizeof(*t)); 55315a0580cSDavid Brownell t->len = 2; 55415a0580cSDavid Brownell if (direction == DMA_TO_DEVICE) { 55515a0580cSDavid Brownell /* the actual CRC may get written later */ 55615a0580cSDavid Brownell t->tx_buf = &scratch->crc_val; 55715a0580cSDavid Brownell if (dma) 55815a0580cSDavid Brownell t->tx_dma = dma + offsetof(struct scratch, crc_val); 55915a0580cSDavid Brownell } else { 56015a0580cSDavid Brownell t->tx_buf = host->ones; 56115a0580cSDavid Brownell t->tx_dma = host->ones_dma; 56215a0580cSDavid Brownell t->rx_buf = &scratch->crc_val; 56315a0580cSDavid Brownell if (dma) 56415a0580cSDavid Brownell t->rx_dma = dma + offsetof(struct scratch, crc_val); 56515a0580cSDavid Brownell } 56615a0580cSDavid Brownell spi_message_add_tail(t, &host->m); 56715a0580cSDavid Brownell 56815a0580cSDavid Brownell /* 56915a0580cSDavid Brownell * A single block read is followed by N(EC) [0+] all-ones bytes 57015a0580cSDavid Brownell * before deselect ... don't bother. 57115a0580cSDavid Brownell * 57215a0580cSDavid Brownell * Multiblock reads are followed by N(AC) [1+] all-ones bytes before 57315a0580cSDavid Brownell * the next block is read, or a STOP_TRANSMISSION is issued. We'll 57415a0580cSDavid Brownell * collect that single byte, so readblock() doesn't need to. 57515a0580cSDavid Brownell * 57615a0580cSDavid Brownell * For a write, the one-byte data response follows immediately, then 57715a0580cSDavid Brownell * come zero or more busy bytes, then N(WR) [1+] all-ones bytes. 57815a0580cSDavid Brownell * Then single block reads may deselect, and multiblock ones issue 57915a0580cSDavid Brownell * the next token (next data block, or STOP_TRAN). We can try to 58015a0580cSDavid Brownell * minimize I/O ops by using a single read to collect end-of-busy. 58115a0580cSDavid Brownell */ 58215a0580cSDavid Brownell if (multiple || direction == DMA_TO_DEVICE) { 58315a0580cSDavid Brownell t = &host->early_status; 58415a0580cSDavid Brownell memset(t, 0, sizeof(*t)); 58515a0580cSDavid Brownell t->len = (direction == DMA_TO_DEVICE) 58615a0580cSDavid Brownell ? sizeof(scratch->status) 58715a0580cSDavid Brownell : 1; 58815a0580cSDavid Brownell t->tx_buf = host->ones; 58915a0580cSDavid Brownell t->tx_dma = host->ones_dma; 59015a0580cSDavid Brownell t->rx_buf = scratch->status; 59115a0580cSDavid Brownell if (dma) 59215a0580cSDavid Brownell t->rx_dma = dma + offsetof(struct scratch, status); 59315a0580cSDavid Brownell t->cs_change = 1; 59415a0580cSDavid Brownell spi_message_add_tail(t, &host->m); 59515a0580cSDavid Brownell } 59615a0580cSDavid Brownell } 59715a0580cSDavid Brownell 59815a0580cSDavid Brownell /* 59915a0580cSDavid Brownell * Write one block: 60015a0580cSDavid Brownell * - caller handled preceding N(WR) [1+] all-ones bytes 60115a0580cSDavid Brownell * - data block 60215a0580cSDavid Brownell * + token 60315a0580cSDavid Brownell * + data bytes 60415a0580cSDavid Brownell * + crc16 60515a0580cSDavid Brownell * - an all-ones byte ... card writes a data-response byte 60615a0580cSDavid Brownell * - followed by N(EC) [0+] all-ones bytes, card writes zero/'busy' 60715a0580cSDavid Brownell * 60815a0580cSDavid Brownell * Return negative errno, else success. 60915a0580cSDavid Brownell */ 61015a0580cSDavid Brownell static int 61115a0580cSDavid Brownell mmc_spi_writeblock(struct mmc_spi_host *host, struct spi_transfer *t) 61215a0580cSDavid Brownell { 61315a0580cSDavid Brownell struct spi_device *spi = host->spi; 61415a0580cSDavid Brownell int status, i; 61515a0580cSDavid Brownell struct scratch *scratch = host->data; 61615a0580cSDavid Brownell 61715a0580cSDavid Brownell if (host->mmc->use_spi_crc) 61815a0580cSDavid Brownell scratch->crc_val = cpu_to_be16( 61915a0580cSDavid Brownell crc_itu_t(0, t->tx_buf, t->len)); 62015a0580cSDavid Brownell if (host->dma_dev) 62115a0580cSDavid Brownell dma_sync_single_for_device(host->dma_dev, 62215a0580cSDavid Brownell host->data_dma, sizeof(*scratch), 62315a0580cSDavid Brownell DMA_BIDIRECTIONAL); 62415a0580cSDavid Brownell 62515a0580cSDavid Brownell status = spi_sync(spi, &host->m); 62615a0580cSDavid Brownell if (status == 0) 62715a0580cSDavid Brownell status = host->m.status; 62815a0580cSDavid Brownell 62915a0580cSDavid Brownell if (status != 0) { 63015a0580cSDavid Brownell dev_dbg(&spi->dev, "write error (%d)\n", status); 63115a0580cSDavid Brownell return status; 63215a0580cSDavid Brownell } 63315a0580cSDavid Brownell 63415a0580cSDavid Brownell if (host->dma_dev) 63515a0580cSDavid Brownell dma_sync_single_for_cpu(host->dma_dev, 63615a0580cSDavid Brownell host->data_dma, sizeof(*scratch), 63715a0580cSDavid Brownell DMA_BIDIRECTIONAL); 63815a0580cSDavid Brownell 63915a0580cSDavid Brownell /* 64015a0580cSDavid Brownell * Get the transmission data-response reply. It must follow 64115a0580cSDavid Brownell * immediately after the data block we transferred. This reply 64215a0580cSDavid Brownell * doesn't necessarily tell whether the write operation succeeded; 64315a0580cSDavid Brownell * it just says if the transmission was ok and whether *earlier* 64415a0580cSDavid Brownell * writes succeeded; see the standard. 64515a0580cSDavid Brownell */ 64615a0580cSDavid Brownell switch (SPI_MMC_RESPONSE_CODE(scratch->status[0])) { 64715a0580cSDavid Brownell case SPI_RESPONSE_ACCEPTED: 64815a0580cSDavid Brownell status = 0; 64915a0580cSDavid Brownell break; 65015a0580cSDavid Brownell case SPI_RESPONSE_CRC_ERR: 65115a0580cSDavid Brownell /* host shall then issue MMC_STOP_TRANSMISSION */ 65215a0580cSDavid Brownell status = -EILSEQ; 65315a0580cSDavid Brownell break; 65415a0580cSDavid Brownell case SPI_RESPONSE_WRITE_ERR: 65515a0580cSDavid Brownell /* host shall then issue MMC_STOP_TRANSMISSION, 65615a0580cSDavid Brownell * and should MMC_SEND_STATUS to sort it out 65715a0580cSDavid Brownell */ 65815a0580cSDavid Brownell status = -EIO; 65915a0580cSDavid Brownell break; 66015a0580cSDavid Brownell default: 66115a0580cSDavid Brownell status = -EPROTO; 66215a0580cSDavid Brownell break; 66315a0580cSDavid Brownell } 66415a0580cSDavid Brownell if (status != 0) { 66515a0580cSDavid Brownell dev_dbg(&spi->dev, "write error %02x (%d)\n", 66615a0580cSDavid Brownell scratch->status[0], status); 66715a0580cSDavid Brownell return status; 66815a0580cSDavid Brownell } 66915a0580cSDavid Brownell 67015a0580cSDavid Brownell t->tx_buf += t->len; 67115a0580cSDavid Brownell if (host->dma_dev) 67215a0580cSDavid Brownell t->tx_dma += t->len; 67315a0580cSDavid Brownell 67415a0580cSDavid Brownell /* Return when not busy. If we didn't collect that status yet, 67515a0580cSDavid Brownell * we'll need some more I/O. 67615a0580cSDavid Brownell */ 67715a0580cSDavid Brownell for (i = 1; i < sizeof(scratch->status); i++) { 67815a0580cSDavid Brownell if (scratch->status[i] != 0) 67915a0580cSDavid Brownell return 0; 68015a0580cSDavid Brownell } 68115a0580cSDavid Brownell return mmc_spi_wait_unbusy(host, writeblock_timeout); 68215a0580cSDavid Brownell } 68315a0580cSDavid Brownell 68415a0580cSDavid Brownell /* 68515a0580cSDavid Brownell * Read one block: 68615a0580cSDavid Brownell * - skip leading all-ones bytes ... either 68715a0580cSDavid Brownell * + N(AC) [1..f(clock,CSD)] usually, else 68815a0580cSDavid Brownell * + N(CX) [0..8] when reading CSD or CID 68915a0580cSDavid Brownell * - data block 69015a0580cSDavid Brownell * + token ... if error token, no data or crc 69115a0580cSDavid Brownell * + data bytes 69215a0580cSDavid Brownell * + crc16 69315a0580cSDavid Brownell * 69415a0580cSDavid Brownell * After single block reads, we're done; N(EC) [0+] all-ones bytes follow 69515a0580cSDavid Brownell * before dropping chipselect. 69615a0580cSDavid Brownell * 69715a0580cSDavid Brownell * For multiblock reads, caller either reads the next block or issues a 69815a0580cSDavid Brownell * STOP_TRANSMISSION command. 69915a0580cSDavid Brownell */ 70015a0580cSDavid Brownell static int 70115a0580cSDavid Brownell mmc_spi_readblock(struct mmc_spi_host *host, struct spi_transfer *t) 70215a0580cSDavid Brownell { 70315a0580cSDavid Brownell struct spi_device *spi = host->spi; 70415a0580cSDavid Brownell int status; 70515a0580cSDavid Brownell struct scratch *scratch = host->data; 70615a0580cSDavid Brownell 70715a0580cSDavid Brownell /* At least one SD card sends an all-zeroes byte when N(CX) 70815a0580cSDavid Brownell * applies, before the all-ones bytes ... just cope with that. 70915a0580cSDavid Brownell */ 71015a0580cSDavid Brownell status = mmc_spi_readbytes(host, 1); 71115a0580cSDavid Brownell if (status < 0) 71215a0580cSDavid Brownell return status; 71315a0580cSDavid Brownell status = scratch->status[0]; 71415a0580cSDavid Brownell if (status == 0xff || status == 0) 71515a0580cSDavid Brownell status = mmc_spi_readtoken(host); 71615a0580cSDavid Brownell 71715a0580cSDavid Brownell if (status == SPI_TOKEN_SINGLE) { 71815a0580cSDavid Brownell if (host->dma_dev) { 71915a0580cSDavid Brownell dma_sync_single_for_device(host->dma_dev, 72015a0580cSDavid Brownell host->data_dma, sizeof(*scratch), 72115a0580cSDavid Brownell DMA_BIDIRECTIONAL); 72215a0580cSDavid Brownell dma_sync_single_for_device(host->dma_dev, 72315a0580cSDavid Brownell t->rx_dma, t->len, 72415a0580cSDavid Brownell DMA_FROM_DEVICE); 72515a0580cSDavid Brownell } 72615a0580cSDavid Brownell 72715a0580cSDavid Brownell status = spi_sync(spi, &host->m); 72815a0580cSDavid Brownell if (status == 0) 72915a0580cSDavid Brownell status = host->m.status; 73015a0580cSDavid Brownell 73115a0580cSDavid Brownell if (host->dma_dev) { 73215a0580cSDavid Brownell dma_sync_single_for_cpu(host->dma_dev, 73315a0580cSDavid Brownell host->data_dma, sizeof(*scratch), 73415a0580cSDavid Brownell DMA_BIDIRECTIONAL); 73515a0580cSDavid Brownell dma_sync_single_for_cpu(host->dma_dev, 73615a0580cSDavid Brownell t->rx_dma, t->len, 73715a0580cSDavid Brownell DMA_FROM_DEVICE); 73815a0580cSDavid Brownell } 73915a0580cSDavid Brownell 74015a0580cSDavid Brownell } else { 74115a0580cSDavid Brownell dev_dbg(&spi->dev, "read error %02x (%d)\n", status, status); 74215a0580cSDavid Brownell 74315a0580cSDavid Brownell /* we've read extra garbage, timed out, etc */ 74415a0580cSDavid Brownell if (status < 0) 74515a0580cSDavid Brownell return status; 74615a0580cSDavid Brownell 74715a0580cSDavid Brownell /* low four bits are an R2 subset, fifth seems to be 74815a0580cSDavid Brownell * vendor specific ... map them all to generic error.. 74915a0580cSDavid Brownell */ 75015a0580cSDavid Brownell return -EIO; 75115a0580cSDavid Brownell } 75215a0580cSDavid Brownell 75315a0580cSDavid Brownell if (host->mmc->use_spi_crc) { 75415a0580cSDavid Brownell u16 crc = crc_itu_t(0, t->rx_buf, t->len); 75515a0580cSDavid Brownell 75615a0580cSDavid Brownell be16_to_cpus(&scratch->crc_val); 75715a0580cSDavid Brownell if (scratch->crc_val != crc) { 75815a0580cSDavid Brownell dev_dbg(&spi->dev, "read - crc error: crc_val=0x%04x, " 75915a0580cSDavid Brownell "computed=0x%04x len=%d\n", 76015a0580cSDavid Brownell scratch->crc_val, crc, t->len); 76115a0580cSDavid Brownell return -EILSEQ; 76215a0580cSDavid Brownell } 76315a0580cSDavid Brownell } 76415a0580cSDavid Brownell 76515a0580cSDavid Brownell t->rx_buf += t->len; 76615a0580cSDavid Brownell if (host->dma_dev) 76715a0580cSDavid Brownell t->rx_dma += t->len; 76815a0580cSDavid Brownell 76915a0580cSDavid Brownell return 0; 77015a0580cSDavid Brownell } 77115a0580cSDavid Brownell 77215a0580cSDavid Brownell /* 77315a0580cSDavid Brownell * An MMC/SD data stage includes one or more blocks, optional CRCs, 77415a0580cSDavid Brownell * and inline handshaking. That handhaking makes it unlike most 77515a0580cSDavid Brownell * other SPI protocol stacks. 77615a0580cSDavid Brownell */ 77715a0580cSDavid Brownell static void 77815a0580cSDavid Brownell mmc_spi_data_do(struct mmc_spi_host *host, struct mmc_command *cmd, 77915a0580cSDavid Brownell struct mmc_data *data, u32 blk_size) 78015a0580cSDavid Brownell { 78115a0580cSDavid Brownell struct spi_device *spi = host->spi; 78215a0580cSDavid Brownell struct device *dma_dev = host->dma_dev; 78315a0580cSDavid Brownell struct spi_transfer *t; 78415a0580cSDavid Brownell enum dma_data_direction direction; 78515a0580cSDavid Brownell struct scatterlist *sg; 78615a0580cSDavid Brownell unsigned n_sg; 78715a0580cSDavid Brownell int multiple = (data->blocks > 1); 78815a0580cSDavid Brownell 78915a0580cSDavid Brownell if (data->flags & MMC_DATA_READ) 79015a0580cSDavid Brownell direction = DMA_FROM_DEVICE; 79115a0580cSDavid Brownell else 79215a0580cSDavid Brownell direction = DMA_TO_DEVICE; 79315a0580cSDavid Brownell mmc_spi_setup_data_message(host, multiple, direction); 79415a0580cSDavid Brownell t = &host->t; 79515a0580cSDavid Brownell 79615a0580cSDavid Brownell /* Handle scatterlist segments one at a time, with synch for 79715a0580cSDavid Brownell * each 512-byte block 79815a0580cSDavid Brownell */ 79915a0580cSDavid Brownell for (sg = data->sg, n_sg = data->sg_len; n_sg; n_sg--, sg++) { 80015a0580cSDavid Brownell int status = 0; 80115a0580cSDavid Brownell dma_addr_t dma_addr = 0; 80215a0580cSDavid Brownell void *kmap_addr; 80315a0580cSDavid Brownell unsigned length = sg->length; 80415a0580cSDavid Brownell enum dma_data_direction dir = direction; 80515a0580cSDavid Brownell 80615a0580cSDavid Brownell /* set up dma mapping for controller drivers that might 80715a0580cSDavid Brownell * use DMA ... though they may fall back to PIO 80815a0580cSDavid Brownell */ 80915a0580cSDavid Brownell if (dma_dev) { 81015a0580cSDavid Brownell /* never invalidate whole *shared* pages ... */ 81115a0580cSDavid Brownell if ((sg->offset != 0 || length != PAGE_SIZE) 81215a0580cSDavid Brownell && dir == DMA_FROM_DEVICE) 81315a0580cSDavid Brownell dir = DMA_BIDIRECTIONAL; 81415a0580cSDavid Brownell 81515a0580cSDavid Brownell dma_addr = dma_map_page(dma_dev, sg->page, 0, 81615a0580cSDavid Brownell PAGE_SIZE, dir); 81715a0580cSDavid Brownell if (direction == DMA_TO_DEVICE) 81815a0580cSDavid Brownell t->tx_dma = dma_addr + sg->offset; 81915a0580cSDavid Brownell else 82015a0580cSDavid Brownell t->rx_dma = dma_addr + sg->offset; 82115a0580cSDavid Brownell } 82215a0580cSDavid Brownell 82315a0580cSDavid Brownell /* allow pio too; we don't allow highmem */ 82415a0580cSDavid Brownell kmap_addr = kmap(sg->page); 82515a0580cSDavid Brownell if (direction == DMA_TO_DEVICE) 82615a0580cSDavid Brownell t->tx_buf = kmap_addr + sg->offset; 82715a0580cSDavid Brownell else 82815a0580cSDavid Brownell t->rx_buf = kmap_addr + sg->offset; 82915a0580cSDavid Brownell 83015a0580cSDavid Brownell /* transfer each block, and update request status */ 83115a0580cSDavid Brownell while (length) { 83215a0580cSDavid Brownell t->len = min(length, blk_size); 83315a0580cSDavid Brownell 83415a0580cSDavid Brownell dev_dbg(&host->spi->dev, 83515a0580cSDavid Brownell " mmc_spi: %s block, %d bytes\n", 83615a0580cSDavid Brownell (direction == DMA_TO_DEVICE) 83715a0580cSDavid Brownell ? "write" 83815a0580cSDavid Brownell : "read", 83915a0580cSDavid Brownell t->len); 84015a0580cSDavid Brownell 84115a0580cSDavid Brownell if (direction == DMA_TO_DEVICE) 84215a0580cSDavid Brownell status = mmc_spi_writeblock(host, t); 84315a0580cSDavid Brownell else 84415a0580cSDavid Brownell status = mmc_spi_readblock(host, t); 84515a0580cSDavid Brownell if (status < 0) 84615a0580cSDavid Brownell break; 84715a0580cSDavid Brownell 84815a0580cSDavid Brownell data->bytes_xfered += t->len; 84915a0580cSDavid Brownell length -= t->len; 85015a0580cSDavid Brownell 85115a0580cSDavid Brownell if (!multiple) 85215a0580cSDavid Brownell break; 85315a0580cSDavid Brownell } 85415a0580cSDavid Brownell 85515a0580cSDavid Brownell /* discard mappings */ 85615a0580cSDavid Brownell if (direction == DMA_FROM_DEVICE) 85715a0580cSDavid Brownell flush_kernel_dcache_page(sg->page); 85815a0580cSDavid Brownell kunmap(sg->page); 85915a0580cSDavid Brownell if (dma_dev) 86015a0580cSDavid Brownell dma_unmap_page(dma_dev, dma_addr, PAGE_SIZE, dir); 86115a0580cSDavid Brownell 86215a0580cSDavid Brownell if (status < 0) { 86315a0580cSDavid Brownell data->error = status; 86415a0580cSDavid Brownell dev_dbg(&spi->dev, "%s status %d\n", 86515a0580cSDavid Brownell (direction == DMA_TO_DEVICE) 86615a0580cSDavid Brownell ? "write" : "read", 86715a0580cSDavid Brownell status); 86815a0580cSDavid Brownell break; 86915a0580cSDavid Brownell } 87015a0580cSDavid Brownell } 87115a0580cSDavid Brownell 87215a0580cSDavid Brownell /* NOTE some docs describe an MMC-only SET_BLOCK_COUNT (CMD23) that 87315a0580cSDavid Brownell * can be issued before multiblock writes. Unlike its more widely 87415a0580cSDavid Brownell * documented analogue for SD cards (SET_WR_BLK_ERASE_COUNT, ACMD23), 87515a0580cSDavid Brownell * that can affect the STOP_TRAN logic. Complete (and current) 87615a0580cSDavid Brownell * MMC specs should sort that out before Linux starts using CMD23. 87715a0580cSDavid Brownell */ 87815a0580cSDavid Brownell if (direction == DMA_TO_DEVICE && multiple) { 87915a0580cSDavid Brownell struct scratch *scratch = host->data; 88015a0580cSDavid Brownell int tmp; 88115a0580cSDavid Brownell const unsigned statlen = sizeof(scratch->status); 88215a0580cSDavid Brownell 88315a0580cSDavid Brownell dev_dbg(&spi->dev, " mmc_spi: STOP_TRAN\n"); 88415a0580cSDavid Brownell 88515a0580cSDavid Brownell /* Tweak the per-block message we set up earlier by morphing 88615a0580cSDavid Brownell * it to hold single buffer with the token followed by some 88715a0580cSDavid Brownell * all-ones bytes ... skip N(BR) (0..1), scan the rest for 88815a0580cSDavid Brownell * "not busy any longer" status, and leave chip selected. 88915a0580cSDavid Brownell */ 89015a0580cSDavid Brownell INIT_LIST_HEAD(&host->m.transfers); 89115a0580cSDavid Brownell list_add(&host->early_status.transfer_list, 89215a0580cSDavid Brownell &host->m.transfers); 89315a0580cSDavid Brownell 89415a0580cSDavid Brownell memset(scratch->status, 0xff, statlen); 89515a0580cSDavid Brownell scratch->status[0] = SPI_TOKEN_STOP_TRAN; 89615a0580cSDavid Brownell 89715a0580cSDavid Brownell host->early_status.tx_buf = host->early_status.rx_buf; 89815a0580cSDavid Brownell host->early_status.tx_dma = host->early_status.rx_dma; 89915a0580cSDavid Brownell host->early_status.len = statlen; 90015a0580cSDavid Brownell 90115a0580cSDavid Brownell if (host->dma_dev) 90215a0580cSDavid Brownell dma_sync_single_for_device(host->dma_dev, 90315a0580cSDavid Brownell host->data_dma, sizeof(*scratch), 90415a0580cSDavid Brownell DMA_BIDIRECTIONAL); 90515a0580cSDavid Brownell 90615a0580cSDavid Brownell tmp = spi_sync(spi, &host->m); 90715a0580cSDavid Brownell if (tmp == 0) 90815a0580cSDavid Brownell tmp = host->m.status; 90915a0580cSDavid Brownell 91015a0580cSDavid Brownell if (host->dma_dev) 91115a0580cSDavid Brownell dma_sync_single_for_cpu(host->dma_dev, 91215a0580cSDavid Brownell host->data_dma, sizeof(*scratch), 91315a0580cSDavid Brownell DMA_BIDIRECTIONAL); 91415a0580cSDavid Brownell 91515a0580cSDavid Brownell if (tmp < 0) { 91615a0580cSDavid Brownell if (!data->error) 91715a0580cSDavid Brownell data->error = tmp; 91815a0580cSDavid Brownell return; 91915a0580cSDavid Brownell } 92015a0580cSDavid Brownell 92115a0580cSDavid Brownell /* Ideally we collected "not busy" status with one I/O, 92215a0580cSDavid Brownell * avoiding wasteful byte-at-a-time scanning... but more 92315a0580cSDavid Brownell * I/O is often needed. 92415a0580cSDavid Brownell */ 92515a0580cSDavid Brownell for (tmp = 2; tmp < statlen; tmp++) { 92615a0580cSDavid Brownell if (scratch->status[tmp] != 0) 92715a0580cSDavid Brownell return; 92815a0580cSDavid Brownell } 92915a0580cSDavid Brownell tmp = mmc_spi_wait_unbusy(host, writeblock_timeout); 93015a0580cSDavid Brownell if (tmp < 0 && !data->error) 93115a0580cSDavid Brownell data->error = tmp; 93215a0580cSDavid Brownell } 93315a0580cSDavid Brownell } 93415a0580cSDavid Brownell 93515a0580cSDavid Brownell /****************************************************************************/ 93615a0580cSDavid Brownell 93715a0580cSDavid Brownell /* 93815a0580cSDavid Brownell * MMC driver implementation -- the interface to the MMC stack 93915a0580cSDavid Brownell */ 94015a0580cSDavid Brownell 94115a0580cSDavid Brownell static void mmc_spi_request(struct mmc_host *mmc, struct mmc_request *mrq) 94215a0580cSDavid Brownell { 94315a0580cSDavid Brownell struct mmc_spi_host *host = mmc_priv(mmc); 94415a0580cSDavid Brownell int status = -EINVAL; 94515a0580cSDavid Brownell 94615a0580cSDavid Brownell #ifdef DEBUG 94715a0580cSDavid Brownell /* MMC core and layered drivers *MUST* issue SPI-aware commands */ 94815a0580cSDavid Brownell { 94915a0580cSDavid Brownell struct mmc_command *cmd; 95015a0580cSDavid Brownell int invalid = 0; 95115a0580cSDavid Brownell 95215a0580cSDavid Brownell cmd = mrq->cmd; 95315a0580cSDavid Brownell if (!mmc_spi_resp_type(cmd)) { 95415a0580cSDavid Brownell dev_dbg(&host->spi->dev, "bogus command\n"); 95515a0580cSDavid Brownell cmd->error = -EINVAL; 95615a0580cSDavid Brownell invalid = 1; 95715a0580cSDavid Brownell } 95815a0580cSDavid Brownell 95915a0580cSDavid Brownell cmd = mrq->stop; 96015a0580cSDavid Brownell if (cmd && !mmc_spi_resp_type(cmd)) { 96115a0580cSDavid Brownell dev_dbg(&host->spi->dev, "bogus STOP command\n"); 96215a0580cSDavid Brownell cmd->error = -EINVAL; 96315a0580cSDavid Brownell invalid = 1; 96415a0580cSDavid Brownell } 96515a0580cSDavid Brownell 96615a0580cSDavid Brownell if (invalid) { 96715a0580cSDavid Brownell dump_stack(); 96815a0580cSDavid Brownell mmc_request_done(host->mmc, mrq); 96915a0580cSDavid Brownell return; 97015a0580cSDavid Brownell } 97115a0580cSDavid Brownell } 97215a0580cSDavid Brownell #endif 97315a0580cSDavid Brownell 97415a0580cSDavid Brownell /* issue command; then optionally data and stop */ 97515a0580cSDavid Brownell status = mmc_spi_command_send(host, mrq, mrq->cmd, mrq->data != NULL); 97615a0580cSDavid Brownell if (status == 0 && mrq->data) { 97715a0580cSDavid Brownell mmc_spi_data_do(host, mrq->cmd, mrq->data, mrq->data->blksz); 97815a0580cSDavid Brownell if (mrq->stop) 97915a0580cSDavid Brownell status = mmc_spi_command_send(host, mrq, mrq->stop, 0); 98015a0580cSDavid Brownell else 98115a0580cSDavid Brownell mmc_cs_off(host); 98215a0580cSDavid Brownell } 98315a0580cSDavid Brownell 98415a0580cSDavid Brownell mmc_request_done(host->mmc, mrq); 98515a0580cSDavid Brownell } 98615a0580cSDavid Brownell 98715a0580cSDavid Brownell /* See Section 6.4.1, in SD "Simplified Physical Layer Specification 2.0" 98815a0580cSDavid Brownell * 98915a0580cSDavid Brownell * NOTE that here we can't know that the card has just been powered up; 99015a0580cSDavid Brownell * not all MMC/SD sockets support power switching. 99115a0580cSDavid Brownell * 99215a0580cSDavid Brownell * FIXME when the card is still in SPI mode, e.g. from a previous kernel, 99315a0580cSDavid Brownell * this doesn't seem to do the right thing at all... 99415a0580cSDavid Brownell */ 99515a0580cSDavid Brownell static void mmc_spi_initsequence(struct mmc_spi_host *host) 99615a0580cSDavid Brownell { 99715a0580cSDavid Brownell /* Try to be very sure any previous command has completed; 99815a0580cSDavid Brownell * wait till not-busy, skip debris from any old commands. 99915a0580cSDavid Brownell */ 100015a0580cSDavid Brownell mmc_spi_wait_unbusy(host, r1b_timeout); 100115a0580cSDavid Brownell mmc_spi_readbytes(host, 10); 100215a0580cSDavid Brownell 100315a0580cSDavid Brownell /* 100415a0580cSDavid Brownell * Do a burst with chipselect active-high. We need to do this to 100515a0580cSDavid Brownell * meet the requirement of 74 clock cycles with both chipselect 100615a0580cSDavid Brownell * and CMD (MOSI) high before CMD0 ... after the card has been 100715a0580cSDavid Brownell * powered up to Vdd(min), and so is ready to take commands. 100815a0580cSDavid Brownell * 100915a0580cSDavid Brownell * Some cards are particularly needy of this (e.g. Viking "SD256") 101015a0580cSDavid Brownell * while most others don't seem to care. 101115a0580cSDavid Brownell * 101215a0580cSDavid Brownell * Note that this is one of the places MMC/SD plays games with the 101315a0580cSDavid Brownell * SPI protocol. Another is that when chipselect is released while 101415a0580cSDavid Brownell * the card returns BUSY status, the clock must issue several cycles 101515a0580cSDavid Brownell * with chipselect high before the card will stop driving its output. 101615a0580cSDavid Brownell */ 101715a0580cSDavid Brownell host->spi->mode |= SPI_CS_HIGH; 101815a0580cSDavid Brownell if (spi_setup(host->spi) != 0) { 101915a0580cSDavid Brownell /* Just warn; most cards work without it. */ 102015a0580cSDavid Brownell dev_warn(&host->spi->dev, 102115a0580cSDavid Brownell "can't change chip-select polarity\n"); 102215a0580cSDavid Brownell host->spi->mode &= ~SPI_CS_HIGH; 102315a0580cSDavid Brownell } else { 102415a0580cSDavid Brownell mmc_spi_readbytes(host, 18); 102515a0580cSDavid Brownell 102615a0580cSDavid Brownell host->spi->mode &= ~SPI_CS_HIGH; 102715a0580cSDavid Brownell if (spi_setup(host->spi) != 0) { 102815a0580cSDavid Brownell /* Wot, we can't get the same setup we had before? */ 102915a0580cSDavid Brownell dev_err(&host->spi->dev, 103015a0580cSDavid Brownell "can't restore chip-select polarity\n"); 103115a0580cSDavid Brownell } 103215a0580cSDavid Brownell } 103315a0580cSDavid Brownell } 103415a0580cSDavid Brownell 103515a0580cSDavid Brownell static char *mmc_powerstring(u8 power_mode) 103615a0580cSDavid Brownell { 103715a0580cSDavid Brownell switch (power_mode) { 103815a0580cSDavid Brownell case MMC_POWER_OFF: return "off"; 103915a0580cSDavid Brownell case MMC_POWER_UP: return "up"; 104015a0580cSDavid Brownell case MMC_POWER_ON: return "on"; 104115a0580cSDavid Brownell } 104215a0580cSDavid Brownell return "?"; 104315a0580cSDavid Brownell } 104415a0580cSDavid Brownell 104515a0580cSDavid Brownell static void mmc_spi_set_ios(struct mmc_host *mmc, struct mmc_ios *ios) 104615a0580cSDavid Brownell { 104715a0580cSDavid Brownell struct mmc_spi_host *host = mmc_priv(mmc); 104815a0580cSDavid Brownell 104915a0580cSDavid Brownell if (host->power_mode != ios->power_mode) { 105015a0580cSDavid Brownell int canpower; 105115a0580cSDavid Brownell 105215a0580cSDavid Brownell canpower = host->pdata && host->pdata->setpower; 105315a0580cSDavid Brownell 105415a0580cSDavid Brownell dev_dbg(&host->spi->dev, "mmc_spi: power %s (%d)%s\n", 105515a0580cSDavid Brownell mmc_powerstring(ios->power_mode), 105615a0580cSDavid Brownell ios->vdd, 105715a0580cSDavid Brownell canpower ? ", can switch" : ""); 105815a0580cSDavid Brownell 105915a0580cSDavid Brownell /* switch power on/off if possible, accounting for 106015a0580cSDavid Brownell * max 250msec powerup time if needed. 106115a0580cSDavid Brownell */ 106215a0580cSDavid Brownell if (canpower) { 106315a0580cSDavid Brownell switch (ios->power_mode) { 106415a0580cSDavid Brownell case MMC_POWER_OFF: 106515a0580cSDavid Brownell case MMC_POWER_UP: 106615a0580cSDavid Brownell host->pdata->setpower(&host->spi->dev, 106715a0580cSDavid Brownell ios->vdd); 106815a0580cSDavid Brownell if (ios->power_mode == MMC_POWER_UP) 106915a0580cSDavid Brownell msleep(host->powerup_msecs); 107015a0580cSDavid Brownell } 107115a0580cSDavid Brownell } 107215a0580cSDavid Brownell 107315a0580cSDavid Brownell /* See 6.4.1 in the simplified SD card physical spec 2.0 */ 107415a0580cSDavid Brownell if (ios->power_mode == MMC_POWER_ON) 107515a0580cSDavid Brownell mmc_spi_initsequence(host); 107615a0580cSDavid Brownell 107715a0580cSDavid Brownell /* If powering down, ground all card inputs to avoid power 107815a0580cSDavid Brownell * delivery from data lines! On a shared SPI bus, this 107915a0580cSDavid Brownell * will probably be temporary; 6.4.2 of the simplified SD 108015a0580cSDavid Brownell * spec says this must last at least 1msec. 108115a0580cSDavid Brownell * 108215a0580cSDavid Brownell * - Clock low means CPOL 0, e.g. mode 0 108315a0580cSDavid Brownell * - MOSI low comes from writing zero 108415a0580cSDavid Brownell * - Chipselect is usually active low... 108515a0580cSDavid Brownell */ 108615a0580cSDavid Brownell if (canpower && ios->power_mode == MMC_POWER_OFF) { 108715a0580cSDavid Brownell int mres; 108815a0580cSDavid Brownell 108915a0580cSDavid Brownell host->spi->mode &= ~(SPI_CPOL|SPI_CPHA); 109015a0580cSDavid Brownell mres = spi_setup(host->spi); 109115a0580cSDavid Brownell if (mres < 0) 109215a0580cSDavid Brownell dev_dbg(&host->spi->dev, 109315a0580cSDavid Brownell "switch to SPI mode 0 failed\n"); 109415a0580cSDavid Brownell 109515a0580cSDavid Brownell if (spi_w8r8(host->spi, 0x00) < 0) 109615a0580cSDavid Brownell dev_dbg(&host->spi->dev, 109715a0580cSDavid Brownell "put spi signals to low failed\n"); 109815a0580cSDavid Brownell 109915a0580cSDavid Brownell /* 110015a0580cSDavid Brownell * Now clock should be low due to spi mode 0; 110115a0580cSDavid Brownell * MOSI should be low because of written 0x00; 110215a0580cSDavid Brownell * chipselect should be low (it is active low) 110315a0580cSDavid Brownell * power supply is off, so now MMC is off too! 110415a0580cSDavid Brownell * 110515a0580cSDavid Brownell * FIXME no, chipselect can be high since the 110615a0580cSDavid Brownell * device is inactive and SPI_CS_HIGH is clear... 110715a0580cSDavid Brownell */ 110815a0580cSDavid Brownell msleep(10); 110915a0580cSDavid Brownell if (mres == 0) { 111015a0580cSDavid Brownell host->spi->mode |= (SPI_CPOL|SPI_CPHA); 111115a0580cSDavid Brownell mres = spi_setup(host->spi); 111215a0580cSDavid Brownell if (mres < 0) 111315a0580cSDavid Brownell dev_dbg(&host->spi->dev, 111415a0580cSDavid Brownell "switch back to SPI mode 3" 111515a0580cSDavid Brownell " failed\n"); 111615a0580cSDavid Brownell } 111715a0580cSDavid Brownell } 111815a0580cSDavid Brownell 111915a0580cSDavid Brownell host->power_mode = ios->power_mode; 112015a0580cSDavid Brownell } 112115a0580cSDavid Brownell 112215a0580cSDavid Brownell if (host->spi->max_speed_hz != ios->clock && ios->clock != 0) { 112315a0580cSDavid Brownell int status; 112415a0580cSDavid Brownell 112515a0580cSDavid Brownell host->spi->max_speed_hz = ios->clock; 112615a0580cSDavid Brownell status = spi_setup(host->spi); 112715a0580cSDavid Brownell dev_dbg(&host->spi->dev, 112815a0580cSDavid Brownell "mmc_spi: clock to %d Hz, %d\n", 112915a0580cSDavid Brownell host->spi->max_speed_hz, status); 113015a0580cSDavid Brownell } 113115a0580cSDavid Brownell } 113215a0580cSDavid Brownell 113315a0580cSDavid Brownell static int mmc_spi_get_ro(struct mmc_host *mmc) 113415a0580cSDavid Brownell { 113515a0580cSDavid Brownell struct mmc_spi_host *host = mmc_priv(mmc); 113615a0580cSDavid Brownell 113715a0580cSDavid Brownell if (host->pdata && host->pdata->get_ro) 113815a0580cSDavid Brownell return host->pdata->get_ro(mmc->parent); 113915a0580cSDavid Brownell /* board doesn't support read only detection; assume writeable */ 114015a0580cSDavid Brownell return 0; 114115a0580cSDavid Brownell } 114215a0580cSDavid Brownell 114315a0580cSDavid Brownell 114415a0580cSDavid Brownell static const struct mmc_host_ops mmc_spi_ops = { 114515a0580cSDavid Brownell .request = mmc_spi_request, 114615a0580cSDavid Brownell .set_ios = mmc_spi_set_ios, 114715a0580cSDavid Brownell .get_ro = mmc_spi_get_ro, 114815a0580cSDavid Brownell }; 114915a0580cSDavid Brownell 115015a0580cSDavid Brownell 115115a0580cSDavid Brownell /****************************************************************************/ 115215a0580cSDavid Brownell 115315a0580cSDavid Brownell /* 115415a0580cSDavid Brownell * SPI driver implementation 115515a0580cSDavid Brownell */ 115615a0580cSDavid Brownell 115715a0580cSDavid Brownell static irqreturn_t 115815a0580cSDavid Brownell mmc_spi_detect_irq(int irq, void *mmc) 115915a0580cSDavid Brownell { 116015a0580cSDavid Brownell struct mmc_spi_host *host = mmc_priv(mmc); 116115a0580cSDavid Brownell u16 delay_msec = max(host->pdata->detect_delay, (u16)100); 116215a0580cSDavid Brownell 116315a0580cSDavid Brownell mmc_detect_change(mmc, msecs_to_jiffies(delay_msec)); 116415a0580cSDavid Brownell return IRQ_HANDLED; 116515a0580cSDavid Brownell } 116615a0580cSDavid Brownell 116715a0580cSDavid Brownell static int mmc_spi_probe(struct spi_device *spi) 116815a0580cSDavid Brownell { 116915a0580cSDavid Brownell void *ones; 117015a0580cSDavid Brownell struct mmc_host *mmc; 117115a0580cSDavid Brownell struct mmc_spi_host *host; 117215a0580cSDavid Brownell int status; 117315a0580cSDavid Brownell 117415a0580cSDavid Brownell /* MMC and SD specs only seem to care that sampling is on the 117515a0580cSDavid Brownell * rising edge ... meaning SPI modes 0 or 3. So either SPI mode 117615a0580cSDavid Brownell * should be legit. We'll use mode 0 since it seems to be a 117715a0580cSDavid Brownell * bit less troublesome on some hardware ... unclear why. 117815a0580cSDavid Brownell */ 117915a0580cSDavid Brownell spi->mode = SPI_MODE_0; 118015a0580cSDavid Brownell spi->bits_per_word = 8; 118115a0580cSDavid Brownell 118215a0580cSDavid Brownell status = spi_setup(spi); 118315a0580cSDavid Brownell if (status < 0) { 118415a0580cSDavid Brownell dev_dbg(&spi->dev, "needs SPI mode %02x, %d KHz; %d\n", 118515a0580cSDavid Brownell spi->mode, spi->max_speed_hz / 1000, 118615a0580cSDavid Brownell status); 118715a0580cSDavid Brownell return status; 118815a0580cSDavid Brownell } 118915a0580cSDavid Brownell 119015a0580cSDavid Brownell /* We can use the bus safely iff nobody else will interfere with 119115a0580cSDavid Brownell * us. That is, either we have the experimental exclusive access 119215a0580cSDavid Brownell * primitives ... or else there's nobody to share it with. 119315a0580cSDavid Brownell */ 119415a0580cSDavid Brownell if (spi->master->num_chipselect > 1) { 119515a0580cSDavid Brownell struct device *parent = spi->dev.parent; 119615a0580cSDavid Brownell 119715a0580cSDavid Brownell /* If there are multiple devices on this bus, we 119815a0580cSDavid Brownell * can't proceed. 119915a0580cSDavid Brownell */ 120015a0580cSDavid Brownell spin_lock(&parent->klist_children.k_lock); 120115a0580cSDavid Brownell if (parent->klist_children.k_list.next 120215a0580cSDavid Brownell != parent->klist_children.k_list.prev) 120315a0580cSDavid Brownell status = -EMLINK; 120415a0580cSDavid Brownell else 120515a0580cSDavid Brownell status = 0; 120615a0580cSDavid Brownell spin_unlock(&parent->klist_children.k_lock); 120715a0580cSDavid Brownell if (status < 0) { 120815a0580cSDavid Brownell dev_err(&spi->dev, "can't share SPI bus\n"); 120915a0580cSDavid Brownell return status; 121015a0580cSDavid Brownell } 121115a0580cSDavid Brownell 121215a0580cSDavid Brownell /* REVISIT we can't guarantee another device won't 121315a0580cSDavid Brownell * be added later. It's uncommon though ... for now, 121415a0580cSDavid Brownell * work as if this is safe. 121515a0580cSDavid Brownell */ 121615a0580cSDavid Brownell dev_warn(&spi->dev, "ASSUMING unshared SPI bus!\n"); 121715a0580cSDavid Brownell } 121815a0580cSDavid Brownell 121915a0580cSDavid Brownell /* We need a supply of ones to transmit. This is the only time 122015a0580cSDavid Brownell * the CPU touches these, so cache coherency isn't a concern. 122115a0580cSDavid Brownell * 122215a0580cSDavid Brownell * NOTE if many systems use more than one MMC-over-SPI connector 122315a0580cSDavid Brownell * it'd save some memory to share this. That's evidently rare. 122415a0580cSDavid Brownell */ 122515a0580cSDavid Brownell status = -ENOMEM; 122615a0580cSDavid Brownell ones = kmalloc(MMC_SPI_BLOCKSIZE, GFP_KERNEL); 122715a0580cSDavid Brownell if (!ones) 122815a0580cSDavid Brownell goto nomem; 122915a0580cSDavid Brownell memset(ones, 0xff, MMC_SPI_BLOCKSIZE); 123015a0580cSDavid Brownell 123115a0580cSDavid Brownell mmc = mmc_alloc_host(sizeof(*host), &spi->dev); 123215a0580cSDavid Brownell if (!mmc) 123315a0580cSDavid Brownell goto nomem; 123415a0580cSDavid Brownell 123515a0580cSDavid Brownell mmc->ops = &mmc_spi_ops; 123615a0580cSDavid Brownell mmc->max_blk_size = MMC_SPI_BLOCKSIZE; 123715a0580cSDavid Brownell 123815a0580cSDavid Brownell /* As long as we keep track of the number of successfully 123915a0580cSDavid Brownell * transmitted blocks, we're good for multiwrite. 124015a0580cSDavid Brownell */ 124115a0580cSDavid Brownell mmc->caps = MMC_CAP_SPI | MMC_CAP_MULTIWRITE; 124215a0580cSDavid Brownell 124315a0580cSDavid Brownell /* SPI doesn't need the lowspeed device identification thing for 124415a0580cSDavid Brownell * MMC or SD cards, since it never comes up in open drain mode. 124515a0580cSDavid Brownell * That's good; some SPI masters can't handle very low speeds! 124615a0580cSDavid Brownell * 124715a0580cSDavid Brownell * However, low speed SDIO cards need not handle over 400 KHz; 124815a0580cSDavid Brownell * that's the only reason not to use a few MHz for f_min (until 124915a0580cSDavid Brownell * the upper layer reads the target frequency from the CSD). 125015a0580cSDavid Brownell */ 125115a0580cSDavid Brownell mmc->f_min = 400000; 125215a0580cSDavid Brownell mmc->f_max = spi->max_speed_hz; 125315a0580cSDavid Brownell 125415a0580cSDavid Brownell host = mmc_priv(mmc); 125515a0580cSDavid Brownell host->mmc = mmc; 125615a0580cSDavid Brownell host->spi = spi; 125715a0580cSDavid Brownell 125815a0580cSDavid Brownell host->ones = ones; 125915a0580cSDavid Brownell 126015a0580cSDavid Brownell /* Platform data is used to hook up things like card sensing 126115a0580cSDavid Brownell * and power switching gpios. 126215a0580cSDavid Brownell */ 126315a0580cSDavid Brownell host->pdata = spi->dev.platform_data; 126415a0580cSDavid Brownell if (host->pdata) 126515a0580cSDavid Brownell mmc->ocr_avail = host->pdata->ocr_mask; 126615a0580cSDavid Brownell if (!mmc->ocr_avail) { 126715a0580cSDavid Brownell dev_warn(&spi->dev, "ASSUMING 3.2-3.4 V slot power\n"); 126815a0580cSDavid Brownell mmc->ocr_avail = MMC_VDD_32_33|MMC_VDD_33_34; 126915a0580cSDavid Brownell } 127015a0580cSDavid Brownell if (host->pdata && host->pdata->setpower) { 127115a0580cSDavid Brownell host->powerup_msecs = host->pdata->powerup_msecs; 127215a0580cSDavid Brownell if (!host->powerup_msecs || host->powerup_msecs > 250) 127315a0580cSDavid Brownell host->powerup_msecs = 250; 127415a0580cSDavid Brownell } 127515a0580cSDavid Brownell 127615a0580cSDavid Brownell dev_set_drvdata(&spi->dev, mmc); 127715a0580cSDavid Brownell 127815a0580cSDavid Brownell /* preallocate dma buffers */ 127915a0580cSDavid Brownell host->data = kmalloc(sizeof(*host->data), GFP_KERNEL); 128015a0580cSDavid Brownell if (!host->data) 128115a0580cSDavid Brownell goto fail_nobuf1; 128215a0580cSDavid Brownell 128315a0580cSDavid Brownell if (spi->master->cdev.dev->dma_mask) { 128415a0580cSDavid Brownell struct device *dev = spi->master->cdev.dev; 128515a0580cSDavid Brownell 128615a0580cSDavid Brownell host->dma_dev = dev; 128715a0580cSDavid Brownell host->ones_dma = dma_map_single(dev, ones, 128815a0580cSDavid Brownell MMC_SPI_BLOCKSIZE, DMA_TO_DEVICE); 128915a0580cSDavid Brownell host->data_dma = dma_map_single(dev, host->data, 129015a0580cSDavid Brownell sizeof(*host->data), DMA_BIDIRECTIONAL); 129115a0580cSDavid Brownell 129215a0580cSDavid Brownell /* REVISIT in theory those map operations can fail... */ 129315a0580cSDavid Brownell 129415a0580cSDavid Brownell dma_sync_single_for_cpu(host->dma_dev, 129515a0580cSDavid Brownell host->data_dma, sizeof(*host->data), 129615a0580cSDavid Brownell DMA_BIDIRECTIONAL); 129715a0580cSDavid Brownell } 129815a0580cSDavid Brownell 129915a0580cSDavid Brownell /* setup message for status/busy readback */ 130015a0580cSDavid Brownell spi_message_init(&host->readback); 130115a0580cSDavid Brownell host->readback.is_dma_mapped = (host->dma_dev != NULL); 130215a0580cSDavid Brownell 130315a0580cSDavid Brownell spi_message_add_tail(&host->status, &host->readback); 130415a0580cSDavid Brownell host->status.tx_buf = host->ones; 130515a0580cSDavid Brownell host->status.tx_dma = host->ones_dma; 130615a0580cSDavid Brownell host->status.rx_buf = &host->data->status; 130715a0580cSDavid Brownell host->status.rx_dma = host->data_dma + offsetof(struct scratch, status); 130815a0580cSDavid Brownell host->status.cs_change = 1; 130915a0580cSDavid Brownell 131015a0580cSDavid Brownell /* register card detect irq */ 131115a0580cSDavid Brownell if (host->pdata && host->pdata->init) { 131215a0580cSDavid Brownell status = host->pdata->init(&spi->dev, mmc_spi_detect_irq, mmc); 131315a0580cSDavid Brownell if (status != 0) 131415a0580cSDavid Brownell goto fail_glue_init; 131515a0580cSDavid Brownell } 131615a0580cSDavid Brownell 131715a0580cSDavid Brownell status = mmc_add_host(mmc); 131815a0580cSDavid Brownell if (status != 0) 131915a0580cSDavid Brownell goto fail_add_host; 132015a0580cSDavid Brownell 132115a0580cSDavid Brownell dev_info(&spi->dev, "SD/MMC host %s%s%s%s\n", 132215a0580cSDavid Brownell mmc->class_dev.bus_id, 132315a0580cSDavid Brownell host->dma_dev ? "" : ", no DMA", 132415a0580cSDavid Brownell (host->pdata && host->pdata->get_ro) 132515a0580cSDavid Brownell ? "" : ", no WP", 132615a0580cSDavid Brownell (host->pdata && host->pdata->setpower) 132715a0580cSDavid Brownell ? "" : ", no poweroff"); 132815a0580cSDavid Brownell return 0; 132915a0580cSDavid Brownell 133015a0580cSDavid Brownell fail_add_host: 133115a0580cSDavid Brownell mmc_remove_host (mmc); 133215a0580cSDavid Brownell fail_glue_init: 133315a0580cSDavid Brownell if (host->dma_dev) 133415a0580cSDavid Brownell dma_unmap_single(host->dma_dev, host->data_dma, 133515a0580cSDavid Brownell sizeof(*host->data), DMA_BIDIRECTIONAL); 133615a0580cSDavid Brownell kfree(host->data); 133715a0580cSDavid Brownell 133815a0580cSDavid Brownell fail_nobuf1: 133915a0580cSDavid Brownell mmc_free_host(mmc); 134015a0580cSDavid Brownell dev_set_drvdata(&spi->dev, NULL); 134115a0580cSDavid Brownell 134215a0580cSDavid Brownell nomem: 134315a0580cSDavid Brownell kfree(ones); 134415a0580cSDavid Brownell return status; 134515a0580cSDavid Brownell } 134615a0580cSDavid Brownell 134715a0580cSDavid Brownell 134815a0580cSDavid Brownell static int __devexit mmc_spi_remove(struct spi_device *spi) 134915a0580cSDavid Brownell { 135015a0580cSDavid Brownell struct mmc_host *mmc = dev_get_drvdata(&spi->dev); 135115a0580cSDavid Brownell struct mmc_spi_host *host; 135215a0580cSDavid Brownell 135315a0580cSDavid Brownell if (mmc) { 135415a0580cSDavid Brownell host = mmc_priv(mmc); 135515a0580cSDavid Brownell 135615a0580cSDavid Brownell /* prevent new mmc_detect_change() calls */ 135715a0580cSDavid Brownell if (host->pdata && host->pdata->exit) 135815a0580cSDavid Brownell host->pdata->exit(&spi->dev, mmc); 135915a0580cSDavid Brownell 136015a0580cSDavid Brownell mmc_remove_host(mmc); 136115a0580cSDavid Brownell 136215a0580cSDavid Brownell if (host->dma_dev) { 136315a0580cSDavid Brownell dma_unmap_single(host->dma_dev, host->ones_dma, 136415a0580cSDavid Brownell MMC_SPI_BLOCKSIZE, DMA_TO_DEVICE); 136515a0580cSDavid Brownell dma_unmap_single(host->dma_dev, host->data_dma, 136615a0580cSDavid Brownell sizeof(*host->data), DMA_BIDIRECTIONAL); 136715a0580cSDavid Brownell } 136815a0580cSDavid Brownell 136915a0580cSDavid Brownell kfree(host->data); 137015a0580cSDavid Brownell kfree(host->ones); 137115a0580cSDavid Brownell 137215a0580cSDavid Brownell spi->max_speed_hz = mmc->f_max; 137315a0580cSDavid Brownell mmc_free_host(mmc); 137415a0580cSDavid Brownell dev_set_drvdata(&spi->dev, NULL); 137515a0580cSDavid Brownell } 137615a0580cSDavid Brownell return 0; 137715a0580cSDavid Brownell } 137815a0580cSDavid Brownell 137915a0580cSDavid Brownell 138015a0580cSDavid Brownell static struct spi_driver mmc_spi_driver = { 138115a0580cSDavid Brownell .driver = { 138215a0580cSDavid Brownell .name = "mmc_spi", 138315a0580cSDavid Brownell .bus = &spi_bus_type, 138415a0580cSDavid Brownell .owner = THIS_MODULE, 138515a0580cSDavid Brownell }, 138615a0580cSDavid Brownell .probe = mmc_spi_probe, 138715a0580cSDavid Brownell .remove = __devexit_p(mmc_spi_remove), 138815a0580cSDavid Brownell }; 138915a0580cSDavid Brownell 139015a0580cSDavid Brownell 139115a0580cSDavid Brownell static int __init mmc_spi_init(void) 139215a0580cSDavid Brownell { 139315a0580cSDavid Brownell return spi_register_driver(&mmc_spi_driver); 139415a0580cSDavid Brownell } 139515a0580cSDavid Brownell module_init(mmc_spi_init); 139615a0580cSDavid Brownell 139715a0580cSDavid Brownell 139815a0580cSDavid Brownell static void __exit mmc_spi_exit(void) 139915a0580cSDavid Brownell { 140015a0580cSDavid Brownell spi_unregister_driver(&mmc_spi_driver); 140115a0580cSDavid Brownell } 140215a0580cSDavid Brownell module_exit(mmc_spi_exit); 140315a0580cSDavid Brownell 140415a0580cSDavid Brownell 140515a0580cSDavid Brownell MODULE_AUTHOR("Mike Lavender, David Brownell, " 140615a0580cSDavid Brownell "Hans-Peter Nilsson, Jan Nikitenko"); 140715a0580cSDavid Brownell MODULE_DESCRIPTION("SPI SD/MMC host driver"); 140815a0580cSDavid Brownell MODULE_LICENSE("GPL"); 1409