xref: /openbmc/linux/drivers/mmc/host/dw_mmc.h (revision 7587eb18)
1 /*
2  * Synopsys DesignWare Multimedia Card Interface driver
3  *  (Based on NXP driver for lpc 31xx)
4  *
5  * Copyright (C) 2009 NXP Semiconductors
6  * Copyright (C) 2009, 2010 Imagination Technologies Ltd.
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  */
13 
14 #ifndef _DW_MMC_H_
15 #define _DW_MMC_H_
16 
17 #define DW_MMC_240A		0x240a
18 
19 #define SDMMC_CTRL		0x000
20 #define SDMMC_PWREN		0x004
21 #define SDMMC_CLKDIV		0x008
22 #define SDMMC_CLKSRC		0x00c
23 #define SDMMC_CLKENA		0x010
24 #define SDMMC_TMOUT		0x014
25 #define SDMMC_CTYPE		0x018
26 #define SDMMC_BLKSIZ		0x01c
27 #define SDMMC_BYTCNT		0x020
28 #define SDMMC_INTMASK		0x024
29 #define SDMMC_CMDARG		0x028
30 #define SDMMC_CMD		0x02c
31 #define SDMMC_RESP0		0x030
32 #define SDMMC_RESP1		0x034
33 #define SDMMC_RESP2		0x038
34 #define SDMMC_RESP3		0x03c
35 #define SDMMC_MINTSTS		0x040
36 #define SDMMC_RINTSTS		0x044
37 #define SDMMC_STATUS		0x048
38 #define SDMMC_FIFOTH		0x04c
39 #define SDMMC_CDETECT		0x050
40 #define SDMMC_WRTPRT		0x054
41 #define SDMMC_GPIO		0x058
42 #define SDMMC_TCBCNT		0x05c
43 #define SDMMC_TBBCNT		0x060
44 #define SDMMC_DEBNCE		0x064
45 #define SDMMC_USRID		0x068
46 #define SDMMC_VERID		0x06c
47 #define SDMMC_HCON		0x070
48 #define SDMMC_UHS_REG		0x074
49 #define SDMMC_RST_N		0x078
50 #define SDMMC_BMOD		0x080
51 #define SDMMC_PLDMND		0x084
52 #define SDMMC_DBADDR		0x088
53 #define SDMMC_IDSTS		0x08c
54 #define SDMMC_IDINTEN		0x090
55 #define SDMMC_DSCADDR		0x094
56 #define SDMMC_BUFADDR		0x098
57 #define SDMMC_CDTHRCTL		0x100
58 #define SDMMC_DATA(x)		(x)
59 /*
60 * Registers to support idmac 64-bit address mode
61 */
62 #define SDMMC_DBADDRL		0x088
63 #define SDMMC_DBADDRU		0x08c
64 #define SDMMC_IDSTS64		0x090
65 #define SDMMC_IDINTEN64		0x094
66 #define SDMMC_DSCADDRL		0x098
67 #define SDMMC_DSCADDRU		0x09c
68 #define SDMMC_BUFADDRL		0x0A0
69 #define SDMMC_BUFADDRU		0x0A4
70 
71 /*
72  * Data offset is difference according to Version
73  * Lower than 2.40a : data register offest is 0x100
74  */
75 #define DATA_OFFSET		0x100
76 #define DATA_240A_OFFSET	0x200
77 
78 /* shift bit field */
79 #define _SBF(f, v)		((v) << (f))
80 
81 /* Control register defines */
82 #define SDMMC_CTRL_USE_IDMAC		BIT(25)
83 #define SDMMC_CTRL_CEATA_INT_EN		BIT(11)
84 #define SDMMC_CTRL_SEND_AS_CCSD		BIT(10)
85 #define SDMMC_CTRL_SEND_CCSD		BIT(9)
86 #define SDMMC_CTRL_ABRT_READ_DATA	BIT(8)
87 #define SDMMC_CTRL_SEND_IRQ_RESP	BIT(7)
88 #define SDMMC_CTRL_READ_WAIT		BIT(6)
89 #define SDMMC_CTRL_DMA_ENABLE		BIT(5)
90 #define SDMMC_CTRL_INT_ENABLE		BIT(4)
91 #define SDMMC_CTRL_DMA_RESET		BIT(2)
92 #define SDMMC_CTRL_FIFO_RESET		BIT(1)
93 #define SDMMC_CTRL_RESET		BIT(0)
94 /* Clock Enable register defines */
95 #define SDMMC_CLKEN_LOW_PWR		BIT(16)
96 #define SDMMC_CLKEN_ENABLE		BIT(0)
97 /* time-out register defines */
98 #define SDMMC_TMOUT_DATA(n)		_SBF(8, (n))
99 #define SDMMC_TMOUT_DATA_MSK		0xFFFFFF00
100 #define SDMMC_TMOUT_RESP(n)		((n) & 0xFF)
101 #define SDMMC_TMOUT_RESP_MSK		0xFF
102 /* card-type register defines */
103 #define SDMMC_CTYPE_8BIT		BIT(16)
104 #define SDMMC_CTYPE_4BIT		BIT(0)
105 #define SDMMC_CTYPE_1BIT		0
106 /* Interrupt status & mask register defines */
107 #define SDMMC_INT_SDIO(n)		BIT(16 + (n))
108 #define SDMMC_INT_EBE			BIT(15)
109 #define SDMMC_INT_ACD			BIT(14)
110 #define SDMMC_INT_SBE			BIT(13)
111 #define SDMMC_INT_HLE			BIT(12)
112 #define SDMMC_INT_FRUN			BIT(11)
113 #define SDMMC_INT_HTO			BIT(10)
114 #define SDMMC_INT_VOLT_SWITCH		BIT(10) /* overloads bit 10! */
115 #define SDMMC_INT_DRTO			BIT(9)
116 #define SDMMC_INT_RTO			BIT(8)
117 #define SDMMC_INT_DCRC			BIT(7)
118 #define SDMMC_INT_RCRC			BIT(6)
119 #define SDMMC_INT_RXDR			BIT(5)
120 #define SDMMC_INT_TXDR			BIT(4)
121 #define SDMMC_INT_DATA_OVER		BIT(3)
122 #define SDMMC_INT_CMD_DONE		BIT(2)
123 #define SDMMC_INT_RESP_ERR		BIT(1)
124 #define SDMMC_INT_CD			BIT(0)
125 #define SDMMC_INT_ERROR			0xbfc2
126 /* Command register defines */
127 #define SDMMC_CMD_START			BIT(31)
128 #define SDMMC_CMD_USE_HOLD_REG	BIT(29)
129 #define SDMMC_CMD_VOLT_SWITCH		BIT(28)
130 #define SDMMC_CMD_CCS_EXP		BIT(23)
131 #define SDMMC_CMD_CEATA_RD		BIT(22)
132 #define SDMMC_CMD_UPD_CLK		BIT(21)
133 #define SDMMC_CMD_INIT			BIT(15)
134 #define SDMMC_CMD_STOP			BIT(14)
135 #define SDMMC_CMD_PRV_DAT_WAIT		BIT(13)
136 #define SDMMC_CMD_SEND_STOP		BIT(12)
137 #define SDMMC_CMD_STRM_MODE		BIT(11)
138 #define SDMMC_CMD_DAT_WR		BIT(10)
139 #define SDMMC_CMD_DAT_EXP		BIT(9)
140 #define SDMMC_CMD_RESP_CRC		BIT(8)
141 #define SDMMC_CMD_RESP_LONG		BIT(7)
142 #define SDMMC_CMD_RESP_EXP		BIT(6)
143 #define SDMMC_CMD_INDX(n)		((n) & 0x1F)
144 /* Status register defines */
145 #define SDMMC_GET_FCNT(x)		(((x)>>17) & 0x1FFF)
146 #define SDMMC_STATUS_DMA_REQ		BIT(31)
147 #define SDMMC_STATUS_BUSY		BIT(9)
148 /* FIFOTH register defines */
149 #define SDMMC_SET_FIFOTH(m, r, t)	(((m) & 0x7) << 28 | \
150 					 ((r) & 0xFFF) << 16 | \
151 					 ((t) & 0xFFF))
152 /* HCON register defines */
153 #define DMA_INTERFACE_IDMA		(0x0)
154 #define DMA_INTERFACE_DWDMA		(0x1)
155 #define DMA_INTERFACE_GDMA		(0x2)
156 #define DMA_INTERFACE_NODMA		(0x3)
157 #define SDMMC_GET_TRANS_MODE(x)		(((x)>>16) & 0x3)
158 #define SDMMC_GET_SLOT_NUM(x)		((((x)>>1) & 0x1F) + 1)
159 #define SDMMC_GET_HDATA_WIDTH(x)	(((x)>>7) & 0x7)
160 #define SDMMC_GET_ADDR_CONFIG(x)	(((x)>>27) & 0x1)
161 /* Internal DMAC interrupt defines */
162 #define SDMMC_IDMAC_INT_AI		BIT(9)
163 #define SDMMC_IDMAC_INT_NI		BIT(8)
164 #define SDMMC_IDMAC_INT_CES		BIT(5)
165 #define SDMMC_IDMAC_INT_DU		BIT(4)
166 #define SDMMC_IDMAC_INT_FBE		BIT(2)
167 #define SDMMC_IDMAC_INT_RI		BIT(1)
168 #define SDMMC_IDMAC_INT_TI		BIT(0)
169 /* Internal DMAC bus mode bits */
170 #define SDMMC_IDMAC_ENABLE		BIT(7)
171 #define SDMMC_IDMAC_FB			BIT(1)
172 #define SDMMC_IDMAC_SWRESET		BIT(0)
173 /* H/W reset */
174 #define SDMMC_RST_HWACTIVE		0x1
175 /* Version ID register define */
176 #define SDMMC_GET_VERID(x)		((x) & 0xFFFF)
177 /* Card read threshold */
178 #define SDMMC_SET_RD_THLD(v, x)		(((v) & 0xFFF) << 16 | (x))
179 #define SDMMC_UHS_18V			BIT(0)
180 /* All ctrl reset bits */
181 #define SDMMC_CTRL_ALL_RESET_FLAGS \
182 	(SDMMC_CTRL_RESET | SDMMC_CTRL_FIFO_RESET | SDMMC_CTRL_DMA_RESET)
183 
184 /* FIFO register access macros. These should not change the data endian-ness
185  * as they are written to memory to be dealt with by the upper layers */
186 #define mci_fifo_readw(__reg)	__raw_readw(__reg)
187 #define mci_fifo_readl(__reg)	__raw_readl(__reg)
188 #define mci_fifo_readq(__reg)	__raw_readq(__reg)
189 
190 #define mci_fifo_writew(__value, __reg)	__raw_writew(__reg, __value)
191 #define mci_fifo_writel(__value, __reg)	__raw_writel(__reg, __value)
192 #define mci_fifo_writeq(__value, __reg)	__raw_writeq(__reg, __value)
193 
194 /* Register access macros */
195 #define mci_readl(dev, reg)			\
196 	readl_relaxed((dev)->regs + SDMMC_##reg)
197 #define mci_writel(dev, reg, value)			\
198 	writel_relaxed((value), (dev)->regs + SDMMC_##reg)
199 
200 /* 16-bit FIFO access macros */
201 #define mci_readw(dev, reg)			\
202 	readw_relaxed((dev)->regs + SDMMC_##reg)
203 #define mci_writew(dev, reg, value)			\
204 	writew_relaxed((value), (dev)->regs + SDMMC_##reg)
205 
206 /* 64-bit FIFO access macros */
207 #ifdef readq
208 #define mci_readq(dev, reg)			\
209 	readq_relaxed((dev)->regs + SDMMC_##reg)
210 #define mci_writeq(dev, reg, value)			\
211 	writeq_relaxed((value), (dev)->regs + SDMMC_##reg)
212 #else
213 /*
214  * Dummy readq implementation for architectures that don't define it.
215  *
216  * We would assume that none of these architectures would configure
217  * the IP block with a 64bit FIFO width, so this code will never be
218  * executed on those machines. Defining these macros here keeps the
219  * rest of the code free from ifdefs.
220  */
221 #define mci_readq(dev, reg)			\
222 	(*(volatile u64 __force *)((dev)->regs + SDMMC_##reg))
223 #define mci_writeq(dev, reg, value)			\
224 	(*(volatile u64 __force *)((dev)->regs + SDMMC_##reg) = (value))
225 
226 #define __raw_writeq(__value, __reg) \
227 	(*(volatile u64 __force *)(__reg) = (__value))
228 #define __raw_readq(__reg) (*(volatile u64 __force *)(__reg))
229 #endif
230 
231 extern int dw_mci_probe(struct dw_mci *host);
232 extern void dw_mci_remove(struct dw_mci *host);
233 #ifdef CONFIG_PM_SLEEP
234 extern int dw_mci_suspend(struct dw_mci *host);
235 extern int dw_mci_resume(struct dw_mci *host);
236 #endif
237 
238 /**
239  * struct dw_mci_slot - MMC slot state
240  * @mmc: The mmc_host representing this slot.
241  * @host: The MMC controller this slot is using.
242  * @ctype: Card type for this slot.
243  * @mrq: mmc_request currently being processed or waiting to be
244  *	processed, or NULL when the slot is idle.
245  * @queue_node: List node for placing this node in the @queue list of
246  *	&struct dw_mci.
247  * @clock: Clock rate configured by set_ios(). Protected by host->lock.
248  * @__clk_old: The last updated clock with reflecting clock divider.
249  *	Keeping track of this helps us to avoid spamming the console
250  *	with CONFIG_MMC_CLKGATE.
251  * @flags: Random state bits associated with the slot.
252  * @id: Number of this slot.
253  * @sdio_id: Number of this slot in the SDIO interrupt registers.
254  */
255 struct dw_mci_slot {
256 	struct mmc_host		*mmc;
257 	struct dw_mci		*host;
258 
259 	u32			ctype;
260 
261 	struct mmc_request	*mrq;
262 	struct list_head	queue_node;
263 
264 	unsigned int		clock;
265 	unsigned int		__clk_old;
266 
267 	unsigned long		flags;
268 #define DW_MMC_CARD_PRESENT	0
269 #define DW_MMC_CARD_NEED_INIT	1
270 #define DW_MMC_CARD_NO_LOW_PWR	2
271 #define DW_MMC_CARD_NO_USE_HOLD 3
272 	int			id;
273 	int			sdio_id;
274 };
275 
276 /**
277  * dw_mci driver data - dw-mshc implementation specific driver data.
278  * @caps: mmc subsystem specified capabilities of the controller(s).
279  * @init: early implementation specific initialization.
280  * @set_ios: handle bus specific extensions.
281  * @parse_dt: parse implementation specific device tree properties.
282  * @execute_tuning: implementation specific tuning procedure.
283  *
284  * Provide controller implementation specific extensions. The usage of this
285  * data structure is fully optional and usage of each member in this structure
286  * is optional as well.
287  */
288 struct dw_mci_drv_data {
289 	unsigned long	*caps;
290 	int		(*init)(struct dw_mci *host);
291 	void		(*set_ios)(struct dw_mci *host, struct mmc_ios *ios);
292 	int		(*parse_dt)(struct dw_mci *host);
293 	int		(*execute_tuning)(struct dw_mci_slot *slot, u32 opcode);
294 	int		(*prepare_hs400_tuning)(struct dw_mci *host,
295 						struct mmc_ios *ios);
296 	int		(*switch_voltage)(struct mmc_host *mmc,
297 					  struct mmc_ios *ios);
298 };
299 #endif /* _DW_MMC_H_ */
300