2 * linux/drivers/mmc/host/mmci.h - ARM PrimeCell MMCI PL180/1 driver
4 * Copyright (C) 2003 Deep Blue Solutions, Ltd, All Rights Reserved.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 as
8 * published by the Free Software Foundation.
10 #define MMCIPOWER 0x000
11 #define MCI_PWR_OFF 0x00
12 #define MCI_PWR_UP 0x02
13 #define MCI_PWR_ON 0x03
14 #define MCI_OD (1 << 6)
15 #define MCI_ROD (1 << 7)
17 * The ST Micro version does not have ROD and reuse the voltage registers for
20 #define MCI_ST_DATA2DIREN (1 << 2)
21 #define MCI_ST_CMDDIREN (1 << 3)
22 #define MCI_ST_DATA0DIREN (1 << 4)
23 #define MCI_ST_DATA31DIREN (1 << 5)
24 #define MCI_ST_FBCLKEN (1 << 7)
25 #define MCI_ST_DATA74DIREN (1 << 8)
27 #define MMCICLOCK 0x004
28 #define MCI_CLK_ENABLE (1 << 8)
29 #define MCI_CLK_PWRSAVE (1 << 9)
30 #define MCI_CLK_BYPASS (1 << 10)
31 #define MCI_4BIT_BUS (1 << 11)
33 * 8bit wide buses, hardware flow contronl, negative edges and clock inversion
34 * supported in ST Micro U300 and Ux500 versions
36 #define MCI_ST_8BIT_BUS (1 << 12)
37 #define MCI_ST_U300_HWFCEN (1 << 13)
38 #define MCI_ST_UX500_NEG_EDGE (1 << 13)
39 #define MCI_ST_UX500_HWFCEN (1 << 14)
40 #define MCI_ST_UX500_CLK_INV (1 << 15)
41 /* Modified PL180 on Versatile Express platform */
42 #define MCI_ARM_HWFCEN (1 << 12)
44 /* Modified on Qualcomm Integrations */
45 #define MCI_QCOM_CLK_WIDEBUS_8 (BIT(10) | BIT(11))
46 #define MCI_QCOM_CLK_FLOWENA BIT(12)
47 #define MCI_QCOM_CLK_INVERTOUT BIT(13)
49 /* select in latch data and command in */
50 #define MCI_QCOM_CLK_SELECT_IN_FBCLK BIT(15)
51 #define MCI_QCOM_CLK_SELECT_IN_DDR_MODE (BIT(14) | BIT(15))
53 #define MMCIARGUMENT 0x008
55 /* The command register controls the Command Path State Machine (CPSM) */
56 #define MMCICOMMAND 0x00c
57 #define MCI_CPSM_RESPONSE BIT(6)
58 #define MCI_CPSM_LONGRSP BIT(7)
59 #define MCI_CPSM_INTERRUPT BIT(8)
60 #define MCI_CPSM_PENDING BIT(9)
61 #define MCI_CPSM_ENABLE BIT(10)
62 /* Command register flag extenstions in the ST Micro versions */
63 #define MCI_CPSM_ST_SDIO_SUSP BIT(11)
64 #define MCI_CPSM_ST_ENCMD_COMPL BIT(12)
65 #define MCI_CPSM_ST_NIEN BIT(13)
66 #define MCI_CPSM_ST_CE_ATACMD BIT(14)
67 /* Command register flag extensions in the Qualcomm versions */
68 #define MCI_CPSM_QCOM_PROGENA BIT(11)
69 #define MCI_CPSM_QCOM_DATCMD BIT(12)
70 #define MCI_CPSM_QCOM_MCIABORT BIT(13)
71 #define MCI_CPSM_QCOM_CCSENABLE BIT(14)
72 #define MCI_CPSM_QCOM_CCSDISABLE BIT(15)
73 #define MCI_CPSM_QCOM_AUTO_CMD19 BIT(16)
74 #define MCI_CPSM_QCOM_AUTO_CMD21 BIT(21)
76 #define MMCIRESPCMD 0x010
77 #define MMCIRESPONSE0 0x014
78 #define MMCIRESPONSE1 0x018
79 #define MMCIRESPONSE2 0x01c
80 #define MMCIRESPONSE3 0x020
81 #define MMCIDATATIMER 0x024
82 #define MMCIDATALENGTH 0x028
84 /* The data control register controls the Data Path State Machine (DPSM) */
85 #define MMCIDATACTRL 0x02c
86 #define MCI_DPSM_ENABLE BIT(0)
87 #define MCI_DPSM_DIRECTION BIT(1)
88 #define MCI_DPSM_MODE BIT(2)
89 #define MCI_DPSM_DMAENABLE BIT(3)
90 #define MCI_DPSM_BLOCKSIZE BIT(4)
91 /* Control register extensions in the ST Micro U300 and Ux500 versions */
92 #define MCI_DPSM_ST_RWSTART BIT(8)
93 #define MCI_DPSM_ST_RWSTOP BIT(9)
94 #define MCI_DPSM_ST_RWMOD BIT(10)
95 #define MCI_DPSM_ST_SDIOEN BIT(11)
96 /* Control register extensions in the ST Micro Ux500 versions */
97 #define MCI_DPSM_ST_DMAREQCTL BIT(12)
98 #define MCI_DPSM_ST_DBOOTMODEEN BIT(13)
99 #define MCI_DPSM_ST_BUSYMODE BIT(14)
100 #define MCI_DPSM_ST_DDRMODE BIT(15)
101 /* Control register extensions in the Qualcomm versions */
102 #define MCI_DPSM_QCOM_DATA_PEND BIT(17)
103 #define MCI_DPSM_QCOM_RX_DATA_PEND BIT(20)
105 #define MMCIDATACNT 0x030
106 #define MMCISTATUS 0x034
107 #define MCI_CMDCRCFAIL (1 << 0)
108 #define MCI_DATACRCFAIL (1 << 1)
109 #define MCI_CMDTIMEOUT (1 << 2)
110 #define MCI_DATATIMEOUT (1 << 3)
111 #define MCI_TXUNDERRUN (1 << 4)
112 #define MCI_RXOVERRUN (1 << 5)
113 #define MCI_CMDRESPEND (1 << 6)
114 #define MCI_CMDSENT (1 << 7)
115 #define MCI_DATAEND (1 << 8)
116 #define MCI_STARTBITERR (1 << 9)
117 #define MCI_DATABLOCKEND (1 << 10)
118 #define MCI_CMDACTIVE (1 << 11)
119 #define MCI_TXACTIVE (1 << 12)
120 #define MCI_RXACTIVE (1 << 13)
121 #define MCI_TXFIFOHALFEMPTY (1 << 14)
122 #define MCI_RXFIFOHALFFULL (1 << 15)
123 #define MCI_TXFIFOFULL (1 << 16)
124 #define MCI_RXFIFOFULL (1 << 17)
125 #define MCI_TXFIFOEMPTY (1 << 18)
126 #define MCI_RXFIFOEMPTY (1 << 19)
127 #define MCI_TXDATAAVLBL (1 << 20)
128 #define MCI_RXDATAAVLBL (1 << 21)
129 /* Extended status bits for the ST Micro variants */
130 #define MCI_ST_SDIOIT (1 << 22)
131 #define MCI_ST_CEATAEND (1 << 23)
132 #define MCI_ST_CARDBUSY (1 << 24)
134 #define MMCICLEAR 0x038
135 #define MCI_CMDCRCFAILCLR (1 << 0)
136 #define MCI_DATACRCFAILCLR (1 << 1)
137 #define MCI_CMDTIMEOUTCLR (1 << 2)
138 #define MCI_DATATIMEOUTCLR (1 << 3)
139 #define MCI_TXUNDERRUNCLR (1 << 4)
140 #define MCI_RXOVERRUNCLR (1 << 5)
141 #define MCI_CMDRESPENDCLR (1 << 6)
142 #define MCI_CMDSENTCLR (1 << 7)
143 #define MCI_DATAENDCLR (1 << 8)
144 #define MCI_STARTBITERRCLR (1 << 9)
145 #define MCI_DATABLOCKENDCLR (1 << 10)
146 /* Extended status bits for the ST Micro variants */
147 #define MCI_ST_SDIOITC (1 << 22)
148 #define MCI_ST_CEATAENDC (1 << 23)
149 #define MCI_ST_BUSYENDC (1 << 24)
151 #define MMCIMASK0 0x03c
152 #define MCI_CMDCRCFAILMASK (1 << 0)
153 #define MCI_DATACRCFAILMASK (1 << 1)
154 #define MCI_CMDTIMEOUTMASK (1 << 2)
155 #define MCI_DATATIMEOUTMASK (1 << 3)
156 #define MCI_TXUNDERRUNMASK (1 << 4)
157 #define MCI_RXOVERRUNMASK (1 << 5)
158 #define MCI_CMDRESPENDMASK (1 << 6)
159 #define MCI_CMDSENTMASK (1 << 7)
160 #define MCI_DATAENDMASK (1 << 8)
161 #define MCI_STARTBITERRMASK (1 << 9)
162 #define MCI_DATABLOCKENDMASK (1 << 10)
163 #define MCI_CMDACTIVEMASK (1 << 11)
164 #define MCI_TXACTIVEMASK (1 << 12)
165 #define MCI_RXACTIVEMASK (1 << 13)
166 #define MCI_TXFIFOHALFEMPTYMASK (1 << 14)
167 #define MCI_RXFIFOHALFFULLMASK (1 << 15)
168 #define MCI_TXFIFOFULLMASK (1 << 16)
169 #define MCI_RXFIFOFULLMASK (1 << 17)
170 #define MCI_TXFIFOEMPTYMASK (1 << 18)
171 #define MCI_RXFIFOEMPTYMASK (1 << 19)
172 #define MCI_TXDATAAVLBLMASK (1 << 20)
173 #define MCI_RXDATAAVLBLMASK (1 << 21)
174 /* Extended status bits for the ST Micro variants */
175 #define MCI_ST_SDIOITMASK (1 << 22)
176 #define MCI_ST_CEATAENDMASK (1 << 23)
177 #define MCI_ST_BUSYENDMASK (1 << 24)
179 #define MMCIMASK1 0x040
180 #define MMCIFIFOCNT 0x048
181 #define MMCIFIFO 0x080 /* to 0x0bc */
183 #define MCI_IRQENABLE \
184 (MCI_CMDCRCFAILMASK|MCI_DATACRCFAILMASK|MCI_CMDTIMEOUTMASK| \
185 MCI_DATATIMEOUTMASK|MCI_TXUNDERRUNMASK|MCI_RXOVERRUNMASK| \
186 MCI_CMDRESPENDMASK|MCI_CMDSENTMASK|MCI_STARTBITERRMASK)
188 /* These interrupts are directed to IRQ1 when two IRQ lines are available */
189 #define MCI_IRQ1MASK \
190 (MCI_RXFIFOHALFFULLMASK | MCI_RXDATAAVLBLMASK | \
191 MCI_TXFIFOHALFEMPTYMASK)
195 #define MMCI_PINCTRL_STATE_OPENDRAIN "opendrain"
202 * struct variant_data - MMCI variant-specific quirks
203 * @clkreg: default value for MCICLOCK register
204 * @clkreg_enable: enable value for MMCICLOCK register
205 * @clkreg_8bit_bus_enable: enable value for 8 bit bus
206 * @clkreg_neg_edge_enable: enable value for inverted data/cmd output
207 * @datalength_bits: number of bits in the MMCIDATALENGTH register
208 * @fifosize: number of bytes that can be written when MMCI_TXFIFOEMPTY
209 * is asserted (likewise for RX)
210 * @fifohalfsize: number of bytes that can be written when MCI_TXFIFOHALFEMPTY
211 * is asserted (likewise for RX)
212 * @data_cmd_enable: enable value for data commands.
213 * @st_sdio: enable ST specific SDIO logic
214 * @st_clkdiv: true if using a ST-specific clock divider algorithm
215 * @datactrl_mask_ddrmode: ddr mode mask in datactrl register.
216 * @blksz_datactrl16: true if Block size is at b16..b30 position in datactrl register
217 * @blksz_datactrl4: true if Block size is at b4..b16 position in datactrl
219 * @datactrl_mask_sdio: SDIO enable mask in datactrl register
220 * @pwrreg_powerup: power up value for MMCIPOWER register
221 * @f_max: maximum clk frequency supported by the controller.
222 * @signal_direction: input/out direction of bus signals can be indicated
223 * @pwrreg_clkgate: MMCIPOWER register must be used to gate the clock
224 * @busy_detect: true if the variant supports busy detection on DAT0.
225 * @busy_dpsm_flag: bitmask enabling busy detection in the DPSM
226 * @busy_detect_flag: bitmask identifying the bit in the MMCISTATUS register
227 * indicating that the card is busy
228 * @busy_detect_mask: bitmask identifying the bit in the MMCIMASK0 to mask for
229 * getting busy end detection interrupts
230 * @pwrreg_nopower: bits in MMCIPOWER don't controls ext. power supply
231 * @explicit_mclk_control: enable explicit mclk control in driver.
232 * @qcom_fifo: enables qcom specific fifo pio read logic.
233 * @qcom_dml: enables qcom specific dma glue for dma transfers.
234 * @reversed_irq_handling: handle data irq before cmd irq.
235 * @mmcimask1: true if variant have a MMCIMASK1 register.
236 * @start_err: bitmask identifying the STARTBITERR bit inside MMCISTATUS
238 * @opendrain: bitmask identifying the OPENDRAIN bit inside MMCIPOWER register
240 struct variant_data {
242 unsigned int clkreg_enable;
243 unsigned int clkreg_8bit_bus_enable;
244 unsigned int clkreg_neg_edge_enable;
245 unsigned int datalength_bits;
246 unsigned int fifosize;
247 unsigned int fifohalfsize;
248 unsigned int data_cmd_enable;
249 unsigned int datactrl_mask_ddrmode;
250 unsigned int datactrl_mask_sdio;
253 bool blksz_datactrl16;
254 bool blksz_datactrl4;
257 bool signal_direction;
261 u32 busy_detect_flag;
262 u32 busy_detect_mask;
264 bool explicit_mclk_control;
267 bool reversed_irq_handling;
271 void (*init)(struct mmci_host *host);
274 /* mmci variant callbacks */
275 struct mmci_host_ops {
276 void (*dma_setup)(struct mmci_host *host);
279 struct mmci_host_next {
280 struct dma_async_tx_descriptor *dma_desc;
281 struct dma_chan *dma_chan;
288 struct mmc_request *mrq;
289 struct mmc_command *cmd;
290 struct mmc_data *data;
291 struct mmc_host *mmc;
298 /* cached value of requested clk in set_ios */
299 unsigned int clock_cache;
308 struct mmci_platform_data *plat;
309 struct mmci_host_ops *ops;
310 struct variant_data *variant;
311 struct pinctrl *pinctrl;
312 struct pinctrl_state *pins_default;
313 struct pinctrl_state *pins_opendrain;
318 struct timer_list timer;
319 unsigned int oldstat;
322 struct sg_mapping_iter sg_miter;
324 int (*get_rx_fifocnt)(struct mmci_host *h, u32 status, int remain);
326 #ifdef CONFIG_DMA_ENGINE
328 struct dma_chan *dma_current;
329 struct dma_chan *dma_rx_channel;
330 struct dma_chan *dma_tx_channel;
331 struct dma_async_tx_descriptor *dma_desc_current;
332 struct mmci_host_next next_data;
333 bool dma_in_progress;
335 #define dma_inprogress(host) ((host)->dma_in_progress)
337 #define dma_inprogress(host) (0)