blob: 01a64c5442bfb66874693b1b8430b01f28f7912f [file] [log] [blame]
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +05301/*
2 * SD Association Host Standard Specification v2.0 controller emulation
3 *
4 * Copyright (c) 2011 Samsung Electronics Co., Ltd.
5 * Mitsyanko Igor <i.mitsyanko@samsung.com>
6 * Peter A.G. Crosthwaite <peter.crosthwaite@petalogix.com>
7 *
8 * Based on MMC controller for Samsung S5PC1xx-based board emulation
9 * by Alexey Merkulov and Vladimir Monakhov.
10 *
11 * This program is free software; you can redistribute it and/or modify it
12 * under the terms of the GNU General Public License as published by the
13 * Free Software Foundation; either version 2 of the License, or (at your
14 * option) any later version.
15 *
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
19 * See the GNU General Public License for more details.
20 *
21 * You should have received a copy of the GNU _General Public License along
22 * with this program; if not, see <http://www.gnu.org/licenses/>.
23 */
24
25#ifndef SDHCI_H
26#define SDHCI_H
27
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053028#include "hw/pci/pci.h"
29#include "hw/sysbus.h"
30#include "hw/sd/sd.h"
Eduardo Habkostdb1015e2020-09-03 16:43:22 -040031#include "qom/object.h"
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053032
33/* SD/MMC host controller state */
Eduardo Habkostdb1015e2020-09-03 16:43:22 -040034struct SDHCIState {
Philippe Mathieu-Daudéf82a0f42018-01-16 13:28:15 +000035 /*< private >*/
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053036 union {
37 PCIDevice pcidev;
38 SysBusDevice busdev;
39 };
Philippe Mathieu-Daudéf82a0f42018-01-16 13:28:15 +000040
41 /*< public >*/
Peter Maydell40bbc192016-02-18 14:16:18 +000042 SDBus sdbus;
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053043 MemoryRegion iomem;
Philippe Mathieu-Daudé02e57e12018-01-25 11:45:30 +000044 AddressSpace sysbus_dma_as;
Philippe Mathieu-Daudédd55c482018-01-16 13:28:21 +000045 AddressSpace *dma_as;
Philippe Mathieu-Daudé60765b62018-01-16 13:28:21 +000046 MemoryRegion *dma_mr;
Andrey Smirnovfd1e5c82018-02-09 10:40:29 +000047 const MemoryRegionOps *io_ops;
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053048
49 QEMUTimer *insert_timer; /* timer for 'changing' sd card. */
50 QEMUTimer *transfer_timer;
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053051 qemu_irq irq;
52
Philippe Mathieu-Daudéf82a0f42018-01-16 13:28:15 +000053 /* Registers cleared on reset */
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053054 uint32_t sdmasysad; /* SDMA System Address register */
55 uint16_t blksize; /* Host DMA Buff Boundary and Transfer BlkSize Reg */
56 uint16_t blkcnt; /* Blocks count for current transfer */
57 uint32_t argument; /* Command Argument Register */
58 uint16_t trnmod; /* Transfer Mode Setting Register */
59 uint16_t cmdreg; /* Command Register */
60 uint32_t rspreg[4]; /* Response Registers 0-3 */
61 uint32_t prnsts; /* Present State Register */
Philippe Mathieu-Daudé06c51202018-02-08 13:48:06 -030062 uint8_t hostctl1; /* Host Control Register */
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053063 uint8_t pwrcon; /* Power control Register */
64 uint8_t blkgap; /* Block Gap Control Register */
65 uint8_t wakcon; /* WakeUp Control Register */
66 uint16_t clkcon; /* Clock control Register */
67 uint8_t timeoutcon; /* Timeout Control Register */
68 uint8_t admaerr; /* ADMA Error Status Register */
69 uint16_t norintsts; /* Normal Interrupt Status Register */
70 uint16_t errintsts; /* Error Interrupt Status Register */
71 uint16_t norintstsen; /* Normal Interrupt Status Enable Register */
72 uint16_t errintstsen; /* Error Interrupt Status Enable Register */
73 uint16_t norintsigen; /* Normal Interrupt Signal Enable Register */
74 uint16_t errintsigen; /* Error Interrupt Signal Enable Register */
75 uint16_t acmd12errsts; /* Auto CMD12 error status register */
Philippe Mathieu-Daudéea55a222018-02-08 13:48:07 -030076 uint16_t hostctl2; /* Host Control 2 */
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053077 uint64_t admasysaddr; /* ADMA System Address Register */
Guenter Roeck3b2d8172020-06-16 10:32:29 +010078 uint16_t vendor_spec; /* Vendor specific register */
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053079
Philippe Mathieu-Daudéf82a0f42018-01-16 13:28:15 +000080 /* Read-only registers */
Philippe Mathieu-Daudé5efc9012018-01-16 13:28:20 +000081 uint64_t capareg; /* Capabilities Register */
82 uint64_t maxcurr; /* Maximum Current Capabilities Register */
Philippe Mathieu-Daudéaceb5b02018-02-08 13:47:55 -030083 uint16_t version; /* Host Controller Version Register */
Philippe Mathieu-Daudéf82a0f42018-01-16 13:28:15 +000084
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053085 uint8_t *fifo_buffer; /* SD host i/o FIFO buffer */
86 uint32_t buf_maxsz;
87 uint16_t data_count; /* current element in FIFO buffer */
88 uint8_t stopped_state;/* Current SDHC state */
Andrew Baumann0a7ac9f2016-02-25 13:35:30 -080089 bool pending_insert_state;
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +053090 /* Buffer Data Port Register - virtual access point to R and W buffers */
91 /* Software Reset Register - always reads as 0 */
92 /* Force Event Auto CMD12 Error Interrupt Reg - write only */
93 /* Force Event Error Interrupt Register- write only */
94 /* RO Host Controller Version Register always reads as 0x2401 */
Philippe Mathieu-Daudéb635d982018-01-16 13:28:16 +000095
96 /* Configurable properties */
97 bool pending_insert_quirk; /* Quirk for Raspberry Pi card insert int */
Andrey Smirnovfd1e5c82018-02-09 10:40:29 +000098 uint32_t quirks;
Philippe Mathieu-Daudéaceb5b02018-02-08 13:47:55 -030099 uint8_t sd_spec_version;
Philippe Mathieu-Daudé0034ebe2018-02-08 13:48:09 -0300100 uint8_t uhs_mode;
Guenter Roeck3b2d8172020-06-16 10:32:29 +0100101 uint8_t vendor; /* For vendor specific functionality */
Eduardo Habkostdb1015e2020-09-03 16:43:22 -0400102};
103typedef struct SDHCIState SDHCIState;
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +0530104
Guenter Roeck3b2d8172020-06-16 10:32:29 +0100105#define SDHCI_VENDOR_NONE 0
106#define SDHCI_VENDOR_IMX 1
107
Andrey Smirnovfd1e5c82018-02-09 10:40:29 +0000108/*
109 * Controller does not provide transfer-complete interrupt when not
110 * busy.
111 *
112 * NOTE: This definition is taken out of Linux kernel and so the
113 * original bit number is preserved
114 */
115#define SDHCI_QUIRK_NO_BUSY_IRQ BIT(14)
116
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +0530117#define TYPE_PCI_SDHCI "sdhci-pci"
Eduardo Habkost8110fa12020-08-31 17:07:33 -0400118DECLARE_INSTANCE_CHECKER(SDHCIState, PCI_SDHCI,
119 TYPE_PCI_SDHCI)
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +0530120
121#define TYPE_SYSBUS_SDHCI "generic-sdhci"
Eduardo Habkost8110fa12020-08-31 17:07:33 -0400122DECLARE_INSTANCE_CHECKER(SDHCIState, SYSBUS_SDHCI,
123 TYPE_SYSBUS_SDHCI)
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +0530124
Andrey Smirnovfd1e5c82018-02-09 10:40:29 +0000125#define TYPE_IMX_USDHC "imx-usdhc"
126
Philippe Mathieu-Daudéc85fba52019-10-22 16:50:37 +0100127#define TYPE_S3C_SDHCI "s3c-sdhci"
128
Sai Pavan Boddu637d23b2015-10-08 18:51:02 +0530129#endif /* SDHCI_H */