xref: /openbmc/qemu/hw/sd/pxa2xx_mmci.c (revision dd205025)
1 /*
2  * Intel XScale PXA255/270 MultiMediaCard/SD/SDIO Controller emulation.
3  *
4  * Copyright (c) 2006 Openedhand Ltd.
5  * Written by Andrzej Zaborowski <balrog@zabor.org>
6  *
7  * This code is licensed under the GPLv2.
8  *
9  * Contributions after 2012-01-13 are licensed under the terms of the
10  * GNU GPL, version 2 or (at your option) any later version.
11  */
12 
13 #include "qemu/osdep.h"
14 #include "qapi/error.h"
15 #include "hw/irq.h"
16 #include "hw/sysbus.h"
17 #include "migration/vmstate.h"
18 #include "hw/arm/pxa.h"
19 #include "hw/sd/sd.h"
20 #include "hw/qdev-properties.h"
21 #include "qemu/log.h"
22 #include "qemu/module.h"
23 #include "trace.h"
24 
25 #define TYPE_PXA2XX_MMCI_BUS "pxa2xx-mmci-bus"
26 #define PXA2XX_MMCI_BUS(obj) OBJECT_CHECK(SDBus, (obj), TYPE_PXA2XX_MMCI_BUS)
27 
28 struct PXA2xxMMCIState {
29     SysBusDevice parent_obj;
30 
31     MemoryRegion iomem;
32     qemu_irq irq;
33     qemu_irq rx_dma;
34     qemu_irq tx_dma;
35     qemu_irq inserted;
36     qemu_irq readonly;
37 
38     BlockBackend *blk;
39     SDBus sdbus;
40 
41     uint32_t status;
42     uint32_t clkrt;
43     uint32_t spi;
44     uint32_t cmdat;
45     uint32_t resp_tout;
46     uint32_t read_tout;
47     int32_t blklen;
48     int32_t numblk;
49     uint32_t intmask;
50     uint32_t intreq;
51     int32_t cmd;
52     uint32_t arg;
53 
54     int32_t active;
55     int32_t bytesleft;
56     uint8_t tx_fifo[64];
57     uint32_t tx_start;
58     uint32_t tx_len;
59     uint8_t rx_fifo[32];
60     uint32_t rx_start;
61     uint32_t rx_len;
62     uint16_t resp_fifo[9];
63     uint32_t resp_len;
64 
65     int32_t cmdreq;
66 };
67 
68 static bool pxa2xx_mmci_vmstate_validate(void *opaque, int version_id)
69 {
70     PXA2xxMMCIState *s = opaque;
71 
72     return s->tx_start < ARRAY_SIZE(s->tx_fifo)
73         && s->rx_start < ARRAY_SIZE(s->rx_fifo)
74         && s->tx_len <= ARRAY_SIZE(s->tx_fifo)
75         && s->rx_len <= ARRAY_SIZE(s->rx_fifo)
76         && s->resp_len <= ARRAY_SIZE(s->resp_fifo);
77 }
78 
79 
80 static const VMStateDescription vmstate_pxa2xx_mmci = {
81     .name = "pxa2xx-mmci",
82     .version_id = 2,
83     .minimum_version_id = 2,
84     .fields = (VMStateField[]) {
85         VMSTATE_UINT32(status, PXA2xxMMCIState),
86         VMSTATE_UINT32(clkrt, PXA2xxMMCIState),
87         VMSTATE_UINT32(spi, PXA2xxMMCIState),
88         VMSTATE_UINT32(cmdat, PXA2xxMMCIState),
89         VMSTATE_UINT32(resp_tout, PXA2xxMMCIState),
90         VMSTATE_UINT32(read_tout, PXA2xxMMCIState),
91         VMSTATE_INT32(blklen, PXA2xxMMCIState),
92         VMSTATE_INT32(numblk, PXA2xxMMCIState),
93         VMSTATE_UINT32(intmask, PXA2xxMMCIState),
94         VMSTATE_UINT32(intreq, PXA2xxMMCIState),
95         VMSTATE_INT32(cmd, PXA2xxMMCIState),
96         VMSTATE_UINT32(arg, PXA2xxMMCIState),
97         VMSTATE_INT32(cmdreq, PXA2xxMMCIState),
98         VMSTATE_INT32(active, PXA2xxMMCIState),
99         VMSTATE_INT32(bytesleft, PXA2xxMMCIState),
100         VMSTATE_UINT32(tx_start, PXA2xxMMCIState),
101         VMSTATE_UINT32(tx_len, PXA2xxMMCIState),
102         VMSTATE_UINT32(rx_start, PXA2xxMMCIState),
103         VMSTATE_UINT32(rx_len, PXA2xxMMCIState),
104         VMSTATE_UINT32(resp_len, PXA2xxMMCIState),
105         VMSTATE_VALIDATE("fifo size incorrect", pxa2xx_mmci_vmstate_validate),
106         VMSTATE_UINT8_ARRAY(tx_fifo, PXA2xxMMCIState, 64),
107         VMSTATE_UINT8_ARRAY(rx_fifo, PXA2xxMMCIState, 32),
108         VMSTATE_UINT16_ARRAY(resp_fifo, PXA2xxMMCIState, 9),
109         VMSTATE_END_OF_LIST()
110     }
111 };
112 
113 #define MMC_STRPCL	0x00	/* MMC Clock Start/Stop register */
114 #define MMC_STAT	0x04	/* MMC Status register */
115 #define MMC_CLKRT	0x08	/* MMC Clock Rate register */
116 #define MMC_SPI		0x0c	/* MMC SPI Mode register */
117 #define MMC_CMDAT	0x10	/* MMC Command/Data register */
118 #define MMC_RESTO	0x14	/* MMC Response Time-Out register */
119 #define MMC_RDTO	0x18	/* MMC Read Time-Out register */
120 #define MMC_BLKLEN	0x1c	/* MMC Block Length register */
121 #define MMC_NUMBLK	0x20	/* MMC Number of Blocks register */
122 #define MMC_PRTBUF	0x24	/* MMC Buffer Partly Full register */
123 #define MMC_I_MASK	0x28	/* MMC Interrupt Mask register */
124 #define MMC_I_REG	0x2c	/* MMC Interrupt Request register */
125 #define MMC_CMD		0x30	/* MMC Command register */
126 #define MMC_ARGH	0x34	/* MMC Argument High register */
127 #define MMC_ARGL	0x38	/* MMC Argument Low register */
128 #define MMC_RES		0x3c	/* MMC Response FIFO */
129 #define MMC_RXFIFO	0x40	/* MMC Receive FIFO */
130 #define MMC_TXFIFO	0x44	/* MMC Transmit FIFO */
131 #define MMC_RDWAIT	0x48	/* MMC RD_WAIT register */
132 #define MMC_BLKS_REM	0x4c	/* MMC Blocks Remaining register */
133 
134 /* Bitfield masks */
135 #define STRPCL_STOP_CLK	(1 << 0)
136 #define STRPCL_STRT_CLK	(1 << 1)
137 #define STAT_TOUT_RES	(1 << 1)
138 #define STAT_CLK_EN	(1 << 8)
139 #define STAT_DATA_DONE	(1 << 11)
140 #define STAT_PRG_DONE	(1 << 12)
141 #define STAT_END_CMDRES	(1 << 13)
142 #define SPI_SPI_MODE	(1 << 0)
143 #define CMDAT_RES_TYPE	(3 << 0)
144 #define CMDAT_DATA_EN	(1 << 2)
145 #define CMDAT_WR_RD	(1 << 3)
146 #define CMDAT_DMA_EN	(1 << 7)
147 #define CMDAT_STOP_TRAN	(1 << 10)
148 #define INT_DATA_DONE	(1 << 0)
149 #define INT_PRG_DONE	(1 << 1)
150 #define INT_END_CMD	(1 << 2)
151 #define INT_STOP_CMD	(1 << 3)
152 #define INT_CLK_OFF	(1 << 4)
153 #define INT_RXFIFO_REQ	(1 << 5)
154 #define INT_TXFIFO_REQ	(1 << 6)
155 #define INT_TINT	(1 << 7)
156 #define INT_DAT_ERR	(1 << 8)
157 #define INT_RES_ERR	(1 << 9)
158 #define INT_RD_STALLED	(1 << 10)
159 #define INT_SDIO_INT	(1 << 11)
160 #define INT_SDIO_SACK	(1 << 12)
161 #define PRTBUF_PRT_BUF	(1 << 0)
162 
163 /* Route internal interrupt lines to the global IC and DMA */
164 static void pxa2xx_mmci_int_update(PXA2xxMMCIState *s)
165 {
166     uint32_t mask = s->intmask;
167     if (s->cmdat & CMDAT_DMA_EN) {
168         mask |= INT_RXFIFO_REQ | INT_TXFIFO_REQ;
169 
170         qemu_set_irq(s->rx_dma, !!(s->intreq & INT_RXFIFO_REQ));
171         qemu_set_irq(s->tx_dma, !!(s->intreq & INT_TXFIFO_REQ));
172     }
173 
174     qemu_set_irq(s->irq, !!(s->intreq & ~mask));
175 }
176 
177 static void pxa2xx_mmci_fifo_update(PXA2xxMMCIState *s)
178 {
179     if (!s->active)
180         return;
181 
182     if (s->cmdat & CMDAT_WR_RD) {
183         while (s->bytesleft && s->tx_len) {
184             sdbus_write_byte(&s->sdbus, s->tx_fifo[s->tx_start++]);
185             s->tx_start &= 0x1f;
186             s->tx_len --;
187             s->bytesleft --;
188         }
189         if (s->bytesleft)
190             s->intreq |= INT_TXFIFO_REQ;
191     } else
192         while (s->bytesleft && s->rx_len < 32) {
193             s->rx_fifo[(s->rx_start + (s->rx_len ++)) & 0x1f] =
194                 sdbus_read_byte(&s->sdbus);
195             s->bytesleft --;
196             s->intreq |= INT_RXFIFO_REQ;
197         }
198 
199     if (!s->bytesleft) {
200         s->active = 0;
201         s->intreq |= INT_DATA_DONE;
202         s->status |= STAT_DATA_DONE;
203 
204         if (s->cmdat & CMDAT_WR_RD) {
205             s->intreq |= INT_PRG_DONE;
206             s->status |= STAT_PRG_DONE;
207         }
208     }
209 
210     pxa2xx_mmci_int_update(s);
211 }
212 
213 static void pxa2xx_mmci_wakequeues(PXA2xxMMCIState *s)
214 {
215     int rsplen, i;
216     SDRequest request;
217     uint8_t response[16];
218 
219     s->active = 1;
220     s->rx_len = 0;
221     s->tx_len = 0;
222     s->cmdreq = 0;
223 
224     request.cmd = s->cmd;
225     request.arg = s->arg;
226     request.crc = 0;	/* FIXME */
227 
228     rsplen = sdbus_do_command(&s->sdbus, &request, response);
229     s->intreq |= INT_END_CMD;
230 
231     memset(s->resp_fifo, 0, sizeof(s->resp_fifo));
232     switch (s->cmdat & CMDAT_RES_TYPE) {
233 #define PXAMMCI_RESP(wd, value0, value1)	\
234         s->resp_fifo[(wd) + 0] |= (value0);	\
235         s->resp_fifo[(wd) + 1] |= (value1) << 8;
236     case 0:	/* No response */
237         goto complete;
238 
239     case 1:	/* R1, R4, R5 or R6 */
240         if (rsplen < 4)
241             goto timeout;
242         goto complete;
243 
244     case 2:	/* R2 */
245         if (rsplen < 16)
246             goto timeout;
247         goto complete;
248 
249     case 3:	/* R3 */
250         if (rsplen < 4)
251             goto timeout;
252         goto complete;
253 
254     complete:
255         for (i = 0; rsplen > 0; i ++, rsplen -= 2) {
256             PXAMMCI_RESP(i, response[i * 2], response[i * 2 + 1]);
257         }
258         s->status |= STAT_END_CMDRES;
259 
260         if (!(s->cmdat & CMDAT_DATA_EN))
261             s->active = 0;
262         else
263             s->bytesleft = s->numblk * s->blklen;
264 
265         s->resp_len = 0;
266         break;
267 
268     timeout:
269         s->active = 0;
270         s->status |= STAT_TOUT_RES;
271         break;
272     }
273 
274     pxa2xx_mmci_fifo_update(s);
275 }
276 
277 static uint64_t pxa2xx_mmci_read(void *opaque, hwaddr offset, unsigned size)
278 {
279     PXA2xxMMCIState *s = (PXA2xxMMCIState *) opaque;
280     uint32_t ret = 0;
281 
282     switch (offset) {
283     case MMC_STRPCL:
284         break;
285     case MMC_STAT:
286         ret = s->status;
287         break;
288     case MMC_CLKRT:
289         ret = s->clkrt;
290         break;
291     case MMC_SPI:
292         ret = s->spi;
293         break;
294     case MMC_CMDAT:
295         ret = s->cmdat;
296         break;
297     case MMC_RESTO:
298         ret = s->resp_tout;
299         break;
300     case MMC_RDTO:
301         ret = s->read_tout;
302         break;
303     case MMC_BLKLEN:
304         ret = s->blklen;
305         break;
306     case MMC_NUMBLK:
307         ret = s->numblk;
308         break;
309     case MMC_PRTBUF:
310         break;
311     case MMC_I_MASK:
312         ret = s->intmask;
313         break;
314     case MMC_I_REG:
315         ret = s->intreq;
316         break;
317     case MMC_CMD:
318         ret = s->cmd | 0x40;
319         break;
320     case MMC_ARGH:
321         ret = s->arg >> 16;
322         break;
323     case MMC_ARGL:
324         ret = s->arg & 0xffff;
325         break;
326     case MMC_RES:
327         ret = (s->resp_len < 9) ? s->resp_fifo[s->resp_len++] : 0;
328         break;
329     case MMC_RXFIFO:
330         while (size-- && s->rx_len) {
331             ret |= s->rx_fifo[s->rx_start++] << (size << 3);
332             s->rx_start &= 0x1f;
333             s->rx_len --;
334         }
335         s->intreq &= ~INT_RXFIFO_REQ;
336         pxa2xx_mmci_fifo_update(s);
337         break;
338     case MMC_RDWAIT:
339         break;
340     case MMC_BLKS_REM:
341         ret = s->numblk;
342         break;
343     default:
344         qemu_log_mask(LOG_GUEST_ERROR,
345                       "%s: incorrect register 0x%02" HWADDR_PRIx "\n",
346                       __func__, offset);
347     }
348     trace_pxa2xx_mmci_read(size, offset, ret);
349 
350     return ret;
351 }
352 
353 static void pxa2xx_mmci_write(void *opaque,
354                               hwaddr offset, uint64_t value, unsigned size)
355 {
356     PXA2xxMMCIState *s = (PXA2xxMMCIState *) opaque;
357 
358     trace_pxa2xx_mmci_write(size, offset, value);
359     switch (offset) {
360     case MMC_STRPCL:
361         if (value & STRPCL_STRT_CLK) {
362             s->status |= STAT_CLK_EN;
363             s->intreq &= ~INT_CLK_OFF;
364 
365             if (s->cmdreq && !(s->cmdat & CMDAT_STOP_TRAN)) {
366                 s->status &= STAT_CLK_EN;
367                 pxa2xx_mmci_wakequeues(s);
368             }
369         }
370 
371         if (value & STRPCL_STOP_CLK) {
372             s->status &= ~STAT_CLK_EN;
373             s->intreq |= INT_CLK_OFF;
374             s->active = 0;
375         }
376 
377         pxa2xx_mmci_int_update(s);
378         break;
379 
380     case MMC_CLKRT:
381         s->clkrt = value & 7;
382         break;
383 
384     case MMC_SPI:
385         s->spi = value & 0xf;
386         if (value & SPI_SPI_MODE) {
387             qemu_log_mask(LOG_GUEST_ERROR,
388                           "%s: attempted to use card in SPI mode\n", __func__);
389         }
390         break;
391 
392     case MMC_CMDAT:
393         s->cmdat = value & 0x3dff;
394         s->active = 0;
395         s->cmdreq = 1;
396         if (!(value & CMDAT_STOP_TRAN)) {
397             s->status &= STAT_CLK_EN;
398 
399             if (s->status & STAT_CLK_EN)
400                 pxa2xx_mmci_wakequeues(s);
401         }
402 
403         pxa2xx_mmci_int_update(s);
404         break;
405 
406     case MMC_RESTO:
407         s->resp_tout = value & 0x7f;
408         break;
409 
410     case MMC_RDTO:
411         s->read_tout = value & 0xffff;
412         break;
413 
414     case MMC_BLKLEN:
415         s->blklen = value & 0xfff;
416         break;
417 
418     case MMC_NUMBLK:
419         s->numblk = value & 0xffff;
420         break;
421 
422     case MMC_PRTBUF:
423         if (value & PRTBUF_PRT_BUF) {
424             s->tx_start ^= 32;
425             s->tx_len = 0;
426         }
427         pxa2xx_mmci_fifo_update(s);
428         break;
429 
430     case MMC_I_MASK:
431         s->intmask = value & 0x1fff;
432         pxa2xx_mmci_int_update(s);
433         break;
434 
435     case MMC_CMD:
436         s->cmd = value & 0x3f;
437         break;
438 
439     case MMC_ARGH:
440         s->arg &= 0x0000ffff;
441         s->arg |= value << 16;
442         break;
443 
444     case MMC_ARGL:
445         s->arg &= 0xffff0000;
446         s->arg |= value & 0x0000ffff;
447         break;
448 
449     case MMC_TXFIFO:
450         while (size-- && s->tx_len < 0x20)
451             s->tx_fifo[(s->tx_start + (s->tx_len ++)) & 0x1f] =
452                     (value >> (size << 3)) & 0xff;
453         s->intreq &= ~INT_TXFIFO_REQ;
454         pxa2xx_mmci_fifo_update(s);
455         break;
456 
457     case MMC_RDWAIT:
458     case MMC_BLKS_REM:
459         break;
460 
461     default:
462         qemu_log_mask(LOG_GUEST_ERROR,
463                       "%s: incorrect reg 0x%02" HWADDR_PRIx " "
464                       "(value 0x%08" PRIx64 ")\n", __func__, offset, value);
465     }
466 }
467 
468 static const MemoryRegionOps pxa2xx_mmci_ops = {
469     .read = pxa2xx_mmci_read,
470     .write = pxa2xx_mmci_write,
471     .endianness = DEVICE_NATIVE_ENDIAN,
472 };
473 
474 PXA2xxMMCIState *pxa2xx_mmci_init(MemoryRegion *sysmem,
475                 hwaddr base,
476                 qemu_irq irq, qemu_irq rx_dma, qemu_irq tx_dma)
477 {
478     DeviceState *dev;
479     SysBusDevice *sbd;
480 
481     dev = qdev_new(TYPE_PXA2XX_MMCI);
482     sbd = SYS_BUS_DEVICE(dev);
483     sysbus_mmio_map(sbd, 0, base);
484     sysbus_connect_irq(sbd, 0, irq);
485     qdev_connect_gpio_out_named(dev, "rx-dma", 0, rx_dma);
486     qdev_connect_gpio_out_named(dev, "tx-dma", 0, tx_dma);
487     sysbus_realize_and_unref(sbd, &error_fatal);
488 
489     return PXA2XX_MMCI(dev);
490 }
491 
492 static void pxa2xx_mmci_set_inserted(DeviceState *dev, bool inserted)
493 {
494     PXA2xxMMCIState *s = PXA2XX_MMCI(dev);
495 
496     qemu_set_irq(s->inserted, inserted);
497 }
498 
499 static void pxa2xx_mmci_set_readonly(DeviceState *dev, bool readonly)
500 {
501     PXA2xxMMCIState *s = PXA2XX_MMCI(dev);
502 
503     qemu_set_irq(s->readonly, readonly);
504 }
505 
506 void pxa2xx_mmci_handlers(PXA2xxMMCIState *s, qemu_irq readonly,
507                           qemu_irq coverswitch)
508 {
509     DeviceState *dev = DEVICE(s);
510 
511     s->readonly = readonly;
512     s->inserted = coverswitch;
513 
514     pxa2xx_mmci_set_inserted(dev, sdbus_get_inserted(&s->sdbus));
515     pxa2xx_mmci_set_readonly(dev, sdbus_get_readonly(&s->sdbus));
516 }
517 
518 static void pxa2xx_mmci_reset(DeviceState *d)
519 {
520     PXA2xxMMCIState *s = PXA2XX_MMCI(d);
521 
522     s->status = 0;
523     s->clkrt = 0;
524     s->spi = 0;
525     s->cmdat = 0;
526     s->resp_tout = 0;
527     s->read_tout = 0;
528     s->blklen = 0;
529     s->numblk = 0;
530     s->intmask = 0;
531     s->intreq = 0;
532     s->cmd = 0;
533     s->arg = 0;
534     s->active = 0;
535     s->bytesleft = 0;
536     s->tx_start = 0;
537     s->tx_len = 0;
538     s->rx_start = 0;
539     s->rx_len = 0;
540     s->resp_len = 0;
541     s->cmdreq = 0;
542     memset(s->tx_fifo, 0, sizeof(s->tx_fifo));
543     memset(s->rx_fifo, 0, sizeof(s->rx_fifo));
544     memset(s->resp_fifo, 0, sizeof(s->resp_fifo));
545 }
546 
547 static void pxa2xx_mmci_instance_init(Object *obj)
548 {
549     PXA2xxMMCIState *s = PXA2XX_MMCI(obj);
550     SysBusDevice *sbd = SYS_BUS_DEVICE(obj);
551     DeviceState *dev = DEVICE(obj);
552 
553     memory_region_init_io(&s->iomem, obj, &pxa2xx_mmci_ops, s,
554                           "pxa2xx-mmci", 0x00100000);
555     sysbus_init_mmio(sbd, &s->iomem);
556     sysbus_init_irq(sbd, &s->irq);
557     qdev_init_gpio_out_named(dev, &s->rx_dma, "rx-dma", 1);
558     qdev_init_gpio_out_named(dev, &s->tx_dma, "tx-dma", 1);
559 
560     qbus_create_inplace(&s->sdbus, sizeof(s->sdbus),
561                         TYPE_PXA2XX_MMCI_BUS, DEVICE(obj), "sd-bus");
562 }
563 
564 static void pxa2xx_mmci_class_init(ObjectClass *klass, void *data)
565 {
566     DeviceClass *dc = DEVICE_CLASS(klass);
567 
568     dc->vmsd = &vmstate_pxa2xx_mmci;
569     dc->reset = pxa2xx_mmci_reset;
570 }
571 
572 static void pxa2xx_mmci_bus_class_init(ObjectClass *klass, void *data)
573 {
574     SDBusClass *sbc = SD_BUS_CLASS(klass);
575 
576     sbc->set_inserted = pxa2xx_mmci_set_inserted;
577     sbc->set_readonly = pxa2xx_mmci_set_readonly;
578 }
579 
580 static const TypeInfo pxa2xx_mmci_info = {
581     .name = TYPE_PXA2XX_MMCI,
582     .parent = TYPE_SYS_BUS_DEVICE,
583     .instance_size = sizeof(PXA2xxMMCIState),
584     .instance_init = pxa2xx_mmci_instance_init,
585     .class_init = pxa2xx_mmci_class_init,
586 };
587 
588 static const TypeInfo pxa2xx_mmci_bus_info = {
589     .name = TYPE_PXA2XX_MMCI_BUS,
590     .parent = TYPE_SD_BUS,
591     .instance_size = sizeof(SDBus),
592     .class_init = pxa2xx_mmci_bus_class_init,
593 };
594 
595 static void pxa2xx_mmci_register_types(void)
596 {
597     type_register_static(&pxa2xx_mmci_info);
598     type_register_static(&pxa2xx_mmci_bus_info);
599 }
600 
601 type_init(pxa2xx_mmci_register_types)
602