2 * linux/drivers/mmc/tmio_mmc.c
4 * Copyright (C) 2004 Ian Molton
5 * Copyright (C) 2007 Ian Molton
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
11 * Driver for the MMC / SD / SDIO cell found in:
13 * TC6393XB TC6391XB TC6387XB T7L66XB ASIC3
15 * This driver draws mainly on scattered spec sheets, Reverse engineering
16 * of the toshiba e800 SD driver and some parts of the 2.4 ASIC3 driver (4 bit
17 * support). (Further 4 bit support from a later datasheet).
20 * Investigate using a workqueue for PIO transfers
23 * Better Power management
24 * Handle MMC errors better
25 * double buffer support
28 #include <linux/module.h>
29 #include <linux/irq.h>
30 #include <linux/device.h>
31 #include <linux/delay.h>
32 #include <linux/mmc/host.h>
33 #include <linux/mfd/core.h>
34 #include <linux/mfd/tmio.h>
38 static void tmio_mmc_set_clock(struct tmio_mmc_host
*host
, int new_clock
)
43 for (clock
= host
->mmc
->f_min
, clk
= 0x80000080;
44 new_clock
>= (clock
<<1); clk
>>= 1)
49 sd_config_write8(host
, CNF_SD_CLK_MODE
, clk
>> 22);
50 sd_ctrl_write16(host
, CTL_SD_CARD_CLK_CTL
, clk
& 0x1ff);
53 static void tmio_mmc_clk_stop(struct tmio_mmc_host
*host
)
55 sd_ctrl_write16(host
, CTL_CLK_AND_WAIT_CTL
, 0x0000);
57 sd_ctrl_write16(host
, CTL_SD_CARD_CLK_CTL
, ~0x0100 &
58 sd_ctrl_read16(host
, CTL_SD_CARD_CLK_CTL
));
62 static void tmio_mmc_clk_start(struct tmio_mmc_host
*host
)
64 sd_ctrl_write16(host
, CTL_SD_CARD_CLK_CTL
, 0x0100 |
65 sd_ctrl_read16(host
, CTL_SD_CARD_CLK_CTL
));
67 sd_ctrl_write16(host
, CTL_CLK_AND_WAIT_CTL
, 0x0100);
71 static void reset(struct tmio_mmc_host
*host
)
73 /* FIXME - should we set stop clock reg here */
74 sd_ctrl_write16(host
, CTL_RESET_SD
, 0x0000);
75 sd_ctrl_write16(host
, CTL_RESET_SDIO
, 0x0000);
77 sd_ctrl_write16(host
, CTL_RESET_SD
, 0x0001);
78 sd_ctrl_write16(host
, CTL_RESET_SDIO
, 0x0001);
83 tmio_mmc_finish_request(struct tmio_mmc_host
*host
)
85 struct mmc_request
*mrq
= host
->mrq
;
91 mmc_request_done(host
->mmc
, mrq
);
94 /* These are the bitmasks the tmio chip requires to implement the MMC response
95 * types. Note that R1 and R6 are the same in this scheme. */
96 #define APP_CMD 0x0040
97 #define RESP_NONE 0x0300
98 #define RESP_R1 0x0400
99 #define RESP_R1B 0x0500
100 #define RESP_R2 0x0600
101 #define RESP_R3 0x0700
102 #define DATA_PRESENT 0x0800
103 #define TRANSFER_READ 0x1000
104 #define TRANSFER_MULTI 0x2000
105 #define SECURITY_CMD 0x4000
108 tmio_mmc_start_command(struct tmio_mmc_host
*host
, struct mmc_command
*cmd
)
110 struct mmc_data
*data
= host
->data
;
113 /* Command 12 is handled by hardware */
114 if (cmd
->opcode
== 12 && !cmd
->arg
) {
115 sd_ctrl_write16(host
, CTL_STOP_INTERNAL_ACTION
, 0x001);
119 switch (mmc_resp_type(cmd
)) {
120 case MMC_RSP_NONE
: c
|= RESP_NONE
; break;
121 case MMC_RSP_R1
: c
|= RESP_R1
; break;
122 case MMC_RSP_R1B
: c
|= RESP_R1B
; break;
123 case MMC_RSP_R2
: c
|= RESP_R2
; break;
124 case MMC_RSP_R3
: c
|= RESP_R3
; break;
126 pr_debug("Unknown response type %d\n", mmc_resp_type(cmd
));
132 /* FIXME - this seems to be ok comented out but the spec suggest this bit should
133 * be set when issuing app commands.
134 * if(cmd->flags & MMC_FLAG_ACMD)
139 if (data
->blocks
> 1) {
140 sd_ctrl_write16(host
, CTL_STOP_INTERNAL_ACTION
, 0x100);
143 if (data
->flags
& MMC_DATA_READ
)
147 enable_mmc_irqs(host
, TMIO_MASK_CMD
);
149 /* Fire off the command */
150 sd_ctrl_write32(host
, CTL_ARG_REG
, cmd
->arg
);
151 sd_ctrl_write16(host
, CTL_SD_CMD
, c
);
156 /* This chip always returns (at least?) as much data as you ask for.
157 * I'm unsure what happens if you ask for less than a block. This should be
158 * looked into to ensure that a funny length read doesnt hose the controller.
161 static inline void tmio_mmc_pio_irq(struct tmio_mmc_host
*host
)
163 struct mmc_data
*data
= host
->data
;
169 pr_debug("Spurious PIO IRQ\n");
173 buf
= (unsigned short *)(tmio_mmc_kmap_atomic(host
, &flags
) +
176 count
= host
->sg_ptr
->length
- host
->sg_off
;
177 if (count
> data
->blksz
)
180 pr_debug("count: %08x offset: %08x flags %08x\n",
181 count
, host
->sg_off
, data
->flags
);
183 /* Transfer the data */
184 if (data
->flags
& MMC_DATA_READ
)
185 sd_ctrl_read16_rep(host
, CTL_SD_DATA_PORT
, buf
, count
>> 1);
187 sd_ctrl_write16_rep(host
, CTL_SD_DATA_PORT
, buf
, count
>> 1);
189 host
->sg_off
+= count
;
191 tmio_mmc_kunmap_atomic(host
, &flags
);
193 if (host
->sg_off
== host
->sg_ptr
->length
)
194 tmio_mmc_next_sg(host
);
199 static inline void tmio_mmc_data_irq(struct tmio_mmc_host
*host
)
201 struct mmc_data
*data
= host
->data
;
202 struct mmc_command
*stop
;
207 pr_debug("Spurious data end IRQ\n");
212 /* FIXME - return correct transfer count on errors */
214 data
->bytes_xfered
= data
->blocks
* data
->blksz
;
216 data
->bytes_xfered
= 0;
218 pr_debug("Completed data request\n");
220 /*FIXME - other drivers allow an optional stop command of any given type
221 * which we dont do, as the chip can auto generate them.
222 * Perhaps we can be smarter about when to use auto CMD12 and
223 * only issue the auto request when we know this is the desired
224 * stop command, allowing fallback to the stop command the
225 * upper layers expect. For now, we do what works.
228 if (data
->flags
& MMC_DATA_READ
)
229 disable_mmc_irqs(host
, TMIO_MASK_READOP
);
231 disable_mmc_irqs(host
, TMIO_MASK_WRITEOP
);
234 if (stop
->opcode
== 12 && !stop
->arg
)
235 sd_ctrl_write16(host
, CTL_STOP_INTERNAL_ACTION
, 0x000);
240 tmio_mmc_finish_request(host
);
243 static inline void tmio_mmc_cmd_irq(struct tmio_mmc_host
*host
,
246 struct mmc_command
*cmd
= host
->cmd
;
250 pr_debug("Spurious CMD irq\n");
256 /* This controller is sicker than the PXA one. Not only do we need to
257 * drop the top 8 bits of the first response word, we also need to
258 * modify the order of the response for short response command types.
261 for (i
= 3, addr
= CTL_RESPONSE
; i
>= 0 ; i
--, addr
+= 4)
262 cmd
->resp
[i
] = sd_ctrl_read32(host
, addr
);
264 if (cmd
->flags
& MMC_RSP_136
) {
265 cmd
->resp
[0] = (cmd
->resp
[0] << 8) | (cmd
->resp
[1] >> 24);
266 cmd
->resp
[1] = (cmd
->resp
[1] << 8) | (cmd
->resp
[2] >> 24);
267 cmd
->resp
[2] = (cmd
->resp
[2] << 8) | (cmd
->resp
[3] >> 24);
269 } else if (cmd
->flags
& MMC_RSP_R3
) {
270 cmd
->resp
[0] = cmd
->resp
[3];
273 if (stat
& TMIO_STAT_CMDTIMEOUT
)
274 cmd
->error
= -ETIMEDOUT
;
275 else if (stat
& TMIO_STAT_CRCFAIL
&& cmd
->flags
& MMC_RSP_CRC
)
276 cmd
->error
= -EILSEQ
;
278 /* If there is data to handle we enable data IRQs here, and
279 * we will ultimatley finish the request in the data_end handler.
280 * If theres no data or we encountered an error, finish now.
282 if (host
->data
&& !cmd
->error
) {
283 if (host
->data
->flags
& MMC_DATA_READ
)
284 enable_mmc_irqs(host
, TMIO_MASK_READOP
);
286 enable_mmc_irqs(host
, TMIO_MASK_WRITEOP
);
288 tmio_mmc_finish_request(host
);
295 static irqreturn_t
tmio_mmc_irq(int irq
, void *devid
)
297 struct tmio_mmc_host
*host
= devid
;
298 unsigned int ireg
, irq_mask
, status
;
300 pr_debug("MMC IRQ begin\n");
302 status
= sd_ctrl_read32(host
, CTL_STATUS
);
303 irq_mask
= sd_ctrl_read32(host
, CTL_IRQ_MASK
);
304 ireg
= status
& TMIO_MASK_IRQ
& ~irq_mask
;
306 pr_debug_status(status
);
307 pr_debug_status(ireg
);
310 disable_mmc_irqs(host
, status
& ~irq_mask
);
312 pr_debug("tmio_mmc: Spurious irq, disabling! "
313 "0x%08x 0x%08x 0x%08x\n", status
, irq_mask
, ireg
);
314 pr_debug_status(status
);
320 /* Card insert / remove attempts */
321 if (ireg
& (TMIO_STAT_CARD_INSERT
| TMIO_STAT_CARD_REMOVE
)) {
322 ack_mmc_irqs(host
, TMIO_STAT_CARD_INSERT
|
323 TMIO_STAT_CARD_REMOVE
);
324 mmc_detect_change(host
->mmc
, 0);
327 /* CRC and other errors */
328 /* if (ireg & TMIO_STAT_ERR_IRQ)
329 * handled |= tmio_error_irq(host, irq, stat);
332 /* Command completion */
333 if (ireg
& TMIO_MASK_CMD
) {
334 ack_mmc_irqs(host
, TMIO_MASK_CMD
);
335 tmio_mmc_cmd_irq(host
, status
);
339 if (ireg
& (TMIO_STAT_RXRDY
| TMIO_STAT_TXRQ
)) {
340 ack_mmc_irqs(host
, TMIO_STAT_RXRDY
| TMIO_STAT_TXRQ
);
341 tmio_mmc_pio_irq(host
);
344 /* Data transfer completion */
345 if (ireg
& TMIO_STAT_DATAEND
) {
346 ack_mmc_irqs(host
, TMIO_STAT_DATAEND
);
347 tmio_mmc_data_irq(host
);
350 /* Check status - keep going until we've handled it all */
351 status
= sd_ctrl_read32(host
, CTL_STATUS
);
352 irq_mask
= sd_ctrl_read32(host
, CTL_IRQ_MASK
);
353 ireg
= status
& TMIO_MASK_IRQ
& ~irq_mask
;
355 pr_debug("Status at end of loop: %08x\n", status
);
356 pr_debug_status(status
);
358 pr_debug("MMC IRQ end\n");
364 static int tmio_mmc_start_data(struct tmio_mmc_host
*host
,
365 struct mmc_data
*data
)
367 pr_debug("setup data transfer: blocksize %08x nr_blocks %d\n",
368 data
->blksz
, data
->blocks
);
370 /* Hardware cannot perform 1 and 2 byte requests in 4 bit mode */
371 if (data
->blksz
< 4 && host
->mmc
->ios
.bus_width
== MMC_BUS_WIDTH_4
) {
372 printk(KERN_ERR
"%s: %d byte block unsupported in 4 bit mode\n",
373 mmc_hostname(host
->mmc
), data
->blksz
);
377 tmio_mmc_init_sg(host
, data
);
380 /* Set transfer length / blocksize */
381 sd_ctrl_write16(host
, CTL_SD_XFER_LEN
, data
->blksz
);
382 sd_ctrl_write16(host
, CTL_XFER_BLK_COUNT
, data
->blocks
);
387 /* Process requests from the MMC layer */
388 static void tmio_mmc_request(struct mmc_host
*mmc
, struct mmc_request
*mrq
)
390 struct tmio_mmc_host
*host
= mmc_priv(mmc
);
394 pr_debug("request not null\n");
399 ret
= tmio_mmc_start_data(host
, mrq
->data
);
404 ret
= tmio_mmc_start_command(host
, mrq
->cmd
);
410 mrq
->cmd
->error
= ret
;
411 mmc_request_done(mmc
, mrq
);
414 /* Set MMC clock / power.
415 * Note: This controller uses a simple divider scheme therefore it cannot
416 * run a MMC card at full speed (20MHz). The max clock is 24MHz on SD, but as
417 * MMC wont run that fast, it has to be clocked at 12MHz which is the next
420 static void tmio_mmc_set_ios(struct mmc_host
*mmc
, struct mmc_ios
*ios
)
422 struct tmio_mmc_host
*host
= mmc_priv(mmc
);
425 tmio_mmc_set_clock(host
, ios
->clock
);
427 /* Power sequence - OFF -> ON -> UP */
428 switch (ios
->power_mode
) {
429 case MMC_POWER_OFF
: /* power down SD bus */
430 sd_config_write8(host
, CNF_PWR_CTL_2
, 0x00);
431 tmio_mmc_clk_stop(host
);
433 case MMC_POWER_ON
: /* power up SD bus */
435 sd_config_write8(host
, CNF_PWR_CTL_2
, 0x02);
437 case MMC_POWER_UP
: /* start bus clock */
438 tmio_mmc_clk_start(host
);
442 switch (ios
->bus_width
) {
443 case MMC_BUS_WIDTH_1
:
444 sd_ctrl_write16(host
, CTL_SD_MEM_CARD_OPT
, 0x80e0);
446 case MMC_BUS_WIDTH_4
:
447 sd_ctrl_write16(host
, CTL_SD_MEM_CARD_OPT
, 0x00e0);
451 /* Let things settle. delay taken from winCE driver */
455 static int tmio_mmc_get_ro(struct mmc_host
*mmc
)
457 struct tmio_mmc_host
*host
= mmc_priv(mmc
);
459 return (sd_ctrl_read16(host
, CTL_STATUS
) & TMIO_STAT_WRPROTECT
) ? 0 : 1;
462 static struct mmc_host_ops tmio_mmc_ops
= {
463 .request
= tmio_mmc_request
,
464 .set_ios
= tmio_mmc_set_ios
,
465 .get_ro
= tmio_mmc_get_ro
,
469 static int tmio_mmc_suspend(struct platform_device
*dev
, pm_message_t state
)
471 struct mfd_cell
*cell
= (struct mfd_cell
*)dev
->dev
.platform_data
;
472 struct mmc_host
*mmc
= platform_get_drvdata(dev
);
475 ret
= mmc_suspend_host(mmc
, state
);
477 /* Tell MFD core it can disable us now.*/
478 if (!ret
&& cell
->disable
)
484 static int tmio_mmc_resume(struct platform_device
*dev
)
486 struct mfd_cell
*cell
= (struct mfd_cell
*)dev
->dev
.platform_data
;
487 struct mmc_host
*mmc
= platform_get_drvdata(dev
);
488 struct tmio_mmc_host
*host
= mmc_priv(mmc
);
491 /* Tell the MFD core we are ready to be enabled */
493 ret
= cell
->enable(dev
);
498 /* Enable the MMC/SD Control registers */
499 sd_config_write16(host
, CNF_CMD
, SDCREN
);
500 sd_config_write32(host
, CNF_CTL_BASE
,
501 (dev
->resource
[0].start
>> host
->bus_shift
) & 0xfffe);
503 mmc_resume_host(mmc
);
509 #define tmio_mmc_suspend NULL
510 #define tmio_mmc_resume NULL
513 static int __devinit
tmio_mmc_probe(struct platform_device
*dev
)
515 struct mfd_cell
*cell
= (struct mfd_cell
*)dev
->dev
.platform_data
;
516 struct tmio_mmc_data
*pdata
;
517 struct resource
*res_ctl
, *res_cnf
;
518 struct tmio_mmc_host
*host
;
519 struct mmc_host
*mmc
;
522 if (dev
->num_resources
!= 3)
525 res_ctl
= platform_get_resource(dev
, IORESOURCE_MEM
, 0);
526 res_cnf
= platform_get_resource(dev
, IORESOURCE_MEM
, 1);
527 if (!res_ctl
|| !res_cnf
)
530 pdata
= cell
->driver_data
;
531 if (!pdata
|| !pdata
->hclk
)
536 mmc
= mmc_alloc_host(sizeof(struct tmio_mmc_host
), &dev
->dev
);
540 host
= mmc_priv(mmc
);
542 platform_set_drvdata(dev
, mmc
);
544 /* SD control register space size is 0x200, 0x400 for bus_shift=1 */
545 host
->bus_shift
= resource_size(res_ctl
) >> 10;
547 host
->ctl
= ioremap(res_ctl
->start
, resource_size(res_ctl
));
551 host
->cnf
= ioremap(res_cnf
->start
, resource_size(res_cnf
));
555 mmc
->ops
= &tmio_mmc_ops
;
556 mmc
->caps
= MMC_CAP_4_BIT_DATA
;
557 mmc
->f_max
= pdata
->hclk
;
558 mmc
->f_min
= mmc
->f_max
/ 512;
559 mmc
->ocr_avail
= MMC_VDD_32_33
| MMC_VDD_33_34
;
561 /* Tell the MFD core we are ready to be enabled */
563 ret
= cell
->enable(dev
);
568 /* Enable the MMC/SD Control registers */
569 sd_config_write16(host
, CNF_CMD
, SDCREN
);
570 sd_config_write32(host
, CNF_CTL_BASE
,
571 (dev
->resource
[0].start
>> host
->bus_shift
) & 0xfffe);
573 /* Disable SD power during suspend */
574 sd_config_write8(host
, CNF_PWR_CTL_3
, 0x01);
576 /* The below is required but why? FIXME */
577 sd_config_write8(host
, CNF_STOP_CLK_CTL
, 0x1f);
579 /* Power down SD bus*/
580 sd_config_write8(host
, CNF_PWR_CTL_2
, 0x00);
582 tmio_mmc_clk_stop(host
);
585 ret
= platform_get_irq(dev
, 0);
591 disable_mmc_irqs(host
, TMIO_MASK_ALL
);
593 ret
= request_irq(host
->irq
, tmio_mmc_irq
, IRQF_DISABLED
|
594 IRQF_TRIGGER_FALLING
, "tmio-mmc", host
);
600 printk(KERN_INFO
"%s at 0x%08lx irq %d\n", mmc_hostname(host
->mmc
),
601 (unsigned long)host
->ctl
, host
->irq
);
603 /* Unmask the IRQs we want to know about */
604 enable_mmc_irqs(host
, TMIO_MASK_IRQ
);
618 static int __devexit
tmio_mmc_remove(struct platform_device
*dev
)
620 struct mmc_host
*mmc
= platform_get_drvdata(dev
);
622 platform_set_drvdata(dev
, NULL
);
625 struct tmio_mmc_host
*host
= mmc_priv(mmc
);
626 mmc_remove_host(mmc
);
627 free_irq(host
->irq
, host
);
636 /* ------------------- device registration ----------------------- */
638 static struct platform_driver tmio_mmc_driver
= {
641 .owner
= THIS_MODULE
,
643 .probe
= tmio_mmc_probe
,
644 .remove
= __devexit_p(tmio_mmc_remove
),
645 .suspend
= tmio_mmc_suspend
,
646 .resume
= tmio_mmc_resume
,
650 static int __init
tmio_mmc_init(void)
652 return platform_driver_register(&tmio_mmc_driver
);
655 static void __exit
tmio_mmc_exit(void)
657 platform_driver_unregister(&tmio_mmc_driver
);
660 module_init(tmio_mmc_init
);
661 module_exit(tmio_mmc_exit
);
663 MODULE_DESCRIPTION("Toshiba TMIO SD/MMC driver");
664 MODULE_AUTHOR("Ian Molton <spyro@f2s.com>");
665 MODULE_LICENSE("GPL v2");
666 MODULE_ALIAS("platform:tmio-mmc");