1 /* 2 * (C) Copyright 2012 SAMSUNG Electronics 3 * Jaehoon Chung <jh80.chung@samsung.com> 4 * 5 * SPDX-License-Identifier: GPL-2.0+ 6 */ 7 8 #ifndef __DWMMC_HW_H 9 #define __DWMMC_HW_H 10 11 #include <asm/io.h> 12 #include <mmc.h> 13 14 #define DWMCI_CTRL 0x000 15 #define DWMCI_PWREN 0x004 16 #define DWMCI_CLKDIV 0x008 17 #define DWMCI_CLKSRC 0x00C 18 #define DWMCI_CLKENA 0x010 19 #define DWMCI_TMOUT 0x014 20 #define DWMCI_CTYPE 0x018 21 #define DWMCI_BLKSIZ 0x01C 22 #define DWMCI_BYTCNT 0x020 23 #define DWMCI_INTMASK 0x024 24 #define DWMCI_CMDARG 0x028 25 #define DWMCI_CMD 0x02C 26 #define DWMCI_RESP0 0x030 27 #define DWMCI_RESP1 0x034 28 #define DWMCI_RESP2 0x038 29 #define DWMCI_RESP3 0x03C 30 #define DWMCI_MINTSTS 0x040 31 #define DWMCI_RINTSTS 0x044 32 #define DWMCI_STATUS 0x048 33 #define DWMCI_FIFOTH 0x04C 34 #define DWMCI_CDETECT 0x050 35 #define DWMCI_WRTPRT 0x054 36 #define DWMCI_GPIO 0x058 37 #define DWMCI_TCMCNT 0x05C 38 #define DWMCI_TBBCNT 0x060 39 #define DWMCI_DEBNCE 0x064 40 #define DWMCI_USRID 0x068 41 #define DWMCI_VERID 0x06C 42 #define DWMCI_HCON 0x070 43 #define DWMCI_UHS_REG 0x074 44 #define DWMCI_BMOD 0x080 45 #define DWMCI_PLDMND 0x084 46 #define DWMCI_DBADDR 0x088 47 #define DWMCI_IDSTS 0x08C 48 #define DWMCI_IDINTEN 0x090 49 #define DWMCI_DSCADDR 0x094 50 #define DWMCI_BUFADDR 0x098 51 #define DWMCI_DATA 0x200 52 53 /* Interrupt Mask register */ 54 #define DWMCI_INTMSK_ALL 0xffffffff 55 #define DWMCI_INTMSK_RE (1 << 1) 56 #define DWMCI_INTMSK_CDONE (1 << 2) 57 #define DWMCI_INTMSK_DTO (1 << 3) 58 #define DWMCI_INTMSK_TXDR (1 << 4) 59 #define DWMCI_INTMSK_RXDR (1 << 5) 60 #define DWMCI_INTMSK_DCRC (1 << 7) 61 #define DWMCI_INTMSK_RTO (1 << 8) 62 #define DWMCI_INTMSK_DRTO (1 << 9) 63 #define DWMCI_INTMSK_HTO (1 << 10) 64 #define DWMCI_INTMSK_FRUN (1 << 11) 65 #define DWMCI_INTMSK_HLE (1 << 12) 66 #define DWMCI_INTMSK_SBE (1 << 13) 67 #define DWMCI_INTMSK_ACD (1 << 14) 68 #define DWMCI_INTMSK_EBE (1 << 15) 69 70 /* Raw interrupt Regsiter */ 71 #define DWMCI_DATA_ERR (DWMCI_INTMSK_EBE | DWMCI_INTMSK_SBE | DWMCI_INTMSK_HLE |\ 72 DWMCI_INTMSK_FRUN | DWMCI_INTMSK_EBE | DWMCI_INTMSK_DCRC) 73 #define DWMCI_DATA_TOUT (DWMCI_INTMSK_HTO | DWMCI_INTMSK_DRTO) 74 /* CTRL register */ 75 #define DWMCI_CTRL_RESET (1 << 0) 76 #define DWMCI_CTRL_FIFO_RESET (1 << 1) 77 #define DWMCI_CTRL_DMA_RESET (1 << 2) 78 #define DWMCI_DMA_EN (1 << 5) 79 #define DWMCI_CTRL_SEND_AS_CCSD (1 << 10) 80 #define DWMCI_IDMAC_EN (1 << 25) 81 #define DWMCI_RESET_ALL (DWMCI_CTRL_RESET | DWMCI_CTRL_FIFO_RESET |\ 82 DWMCI_CTRL_DMA_RESET) 83 84 /* CMD register */ 85 #define DWMCI_CMD_RESP_EXP (1 << 6) 86 #define DWMCI_CMD_RESP_LENGTH (1 << 7) 87 #define DWMCI_CMD_CHECK_CRC (1 << 8) 88 #define DWMCI_CMD_DATA_EXP (1 << 9) 89 #define DWMCI_CMD_RW (1 << 10) 90 #define DWMCI_CMD_SEND_STOP (1 << 12) 91 #define DWMCI_CMD_ABORT_STOP (1 << 14) 92 #define DWMCI_CMD_PRV_DAT_WAIT (1 << 13) 93 #define DWMCI_CMD_UPD_CLK (1 << 21) 94 #define DWMCI_CMD_USE_HOLD_REG (1 << 29) 95 #define DWMCI_CMD_START (1 << 31) 96 97 /* CLKENA register */ 98 #define DWMCI_CLKEN_ENABLE (1 << 0) 99 #define DWMCI_CLKEN_LOW_PWR (1 << 16) 100 101 /* Card-type registe */ 102 #define DWMCI_CTYPE_1BIT 0 103 #define DWMCI_CTYPE_4BIT (1 << 0) 104 #define DWMCI_CTYPE_8BIT (1 << 16) 105 106 /* Status Register */ 107 #define DWMCI_BUSY (1 << 9) 108 #define DWMCI_FIFO_MASK 0x1fff 109 #define DWMCI_FIFO_SHIFT 17 110 111 /* FIFOTH Register */ 112 #define MSIZE(x) ((x) << 28) 113 #define RX_WMARK(x) ((x) << 16) 114 #define TX_WMARK(x) (x) 115 #define RX_WMARK_SHIFT 16 116 #define RX_WMARK_MASK (0xfff << RX_WMARK_SHIFT) 117 118 #define DWMCI_IDMAC_OWN (1 << 31) 119 #define DWMCI_IDMAC_CH (1 << 4) 120 #define DWMCI_IDMAC_FS (1 << 3) 121 #define DWMCI_IDMAC_LD (1 << 2) 122 123 /* Bus Mode Register */ 124 #define DWMCI_BMOD_IDMAC_RESET (1 << 0) 125 #define DWMCI_BMOD_IDMAC_FB (1 << 1) 126 #define DWMCI_BMOD_IDMAC_EN (1 << 7) 127 128 /* UHS register */ 129 #define DWMCI_DDR_MODE (1 << 16) 130 131 /* quirks */ 132 #define DWMCI_QUIRK_DISABLE_SMU (1 << 0) 133 134 /** 135 * struct dwmci_host - Information about a designware MMC host 136 * 137 * @name: Device name 138 * @ioaddr: Base I/O address of controller 139 * @quirks: Quick flags - see DWMCI_QUIRK_... 140 * @caps: Capabilities - see MMC_MODE_... 141 * @bus_hz: Bus speed in Hz, if @get_mmc_clk() is NULL 142 * @div: Arbitrary clock divider value for use by controller 143 * @dev_index: Arbitrary device index for use by controller 144 * @dev_id: Arbitrary device ID for use by controller 145 * @buswidth: Bus width in bits (8 or 4) 146 * @fifoth_val: Value for FIFOTH register (or 0 to leave unset) 147 * @mmc: Pointer to generic MMC structure for this device 148 * @priv: Private pointer for use by controller 149 * @stride_pio: Provide the ability of accessing fifo with burst mode 150 */ 151 struct dwmci_host { 152 const char *name; 153 void *ioaddr; 154 unsigned int quirks; 155 unsigned int caps; 156 unsigned int version; 157 unsigned int clock; 158 unsigned int bus_hz; 159 unsigned int div; 160 int dev_index; 161 int dev_id; 162 int buswidth; 163 u32 fifoth_val; 164 struct mmc *mmc; 165 void *priv; 166 bool stride_pio; 167 168 void (*clksel)(struct dwmci_host *host); 169 void (*board_init)(struct dwmci_host *host); 170 171 /** 172 * Get / set a particular MMC clock frequency 173 * 174 * This is used to request the current clock frequency of the clock 175 * that drives the DWMMC peripheral. The caller will then use this 176 * information to work out the divider it needs to achieve the 177 * required MMC bus clock frequency. If you want to handle the 178 * clock external to DWMMC, use @freq to select the frequency and 179 * return that value too. Then DWMMC will put itself in bypass mode. 180 * 181 * @host: DWMMC host 182 * @freq: Frequency the host is trying to achieve 183 */ 184 unsigned int (*get_mmc_clk)(struct dwmci_host *host, uint freq); 185 int (*execute_tuning)(struct dwmci_host *host, u32 opcode); 186 #ifndef CONFIG_BLK 187 struct mmc_config cfg; 188 #endif 189 190 /* use fifo mode to read and write data */ 191 bool fifo_mode; 192 }; 193 194 struct dwmci_idmac { 195 u32 flags; 196 u32 cnt; 197 u32 addr; 198 u32 next_addr; 199 } __aligned(ARCH_DMA_MINALIGN); 200 201 static inline void dwmci_writel(struct dwmci_host *host, int reg, u32 val) 202 { 203 writel(val, host->ioaddr + reg); 204 } 205 206 static inline void dwmci_writew(struct dwmci_host *host, int reg, u16 val) 207 { 208 writew(val, host->ioaddr + reg); 209 } 210 211 static inline void dwmci_writeb(struct dwmci_host *host, int reg, u8 val) 212 { 213 writeb(val, host->ioaddr + reg); 214 } 215 static inline u32 dwmci_readl(struct dwmci_host *host, int reg) 216 { 217 return readl(host->ioaddr + reg); 218 } 219 220 static inline u16 dwmci_readw(struct dwmci_host *host, int reg) 221 { 222 return readw(host->ioaddr + reg); 223 } 224 225 static inline u8 dwmci_readb(struct dwmci_host *host, int reg) 226 { 227 return readb(host->ioaddr + reg); 228 } 229 230 #ifdef CONFIG_BLK 231 /** 232 * dwmci_setup_cfg() - Set up the configuration for DWMMC 233 * 234 * This is used to set up a DWMMC device when you are using CONFIG_BLK. 235 * 236 * This should be called from your MMC driver's probe() method once you have 237 * the information required. 238 * 239 * Generally your driver will have a platform data structure which holds both 240 * the configuration (struct mmc_config) and the MMC device info (struct mmc). 241 * For example: 242 * 243 * struct rockchip_mmc_plat { 244 * struct mmc_config cfg; 245 * struct mmc mmc; 246 * }; 247 * 248 * ... 249 * 250 * Inside U_BOOT_DRIVER(): 251 * .platdata_auto_alloc_size = sizeof(struct rockchip_mmc_plat), 252 * 253 * To access platform data: 254 * struct rockchip_mmc_plat *plat = dev_get_platdata(dev); 255 * 256 * See rockchip_dw_mmc.c for an example. 257 * 258 * @cfg: Configuration structure to fill in (generally &plat->mmc) 259 * @host: DWMMC host 260 * @max_clk: Maximum supported clock speed in HZ (e.g. 150000000) 261 * @min_clk: Minimum supported clock speed in HZ (e.g. 400000) 262 */ 263 void dwmci_setup_cfg(struct mmc_config *cfg, struct dwmci_host *host, 264 u32 max_clk, u32 min_clk); 265 266 /** 267 * dwmci_bind() - Set up a new MMC block device 268 * 269 * This is used to set up a DWMMC block device when you are using CONFIG_BLK. 270 * It should be called from your driver's bind() method. 271 * 272 * See rockchip_dw_mmc.c for an example. 273 * 274 * @dev: Device to set up 275 * @mmc: Pointer to mmc structure (normally &plat->mmc) 276 * @cfg: Empty configuration structure (generally &plat->cfg). This is 277 * normally all zeroes at this point. The only purpose of passing 278 * this in is to set mmc->cfg to it. 279 * @return 0 if OK, -ve if the block device could not be created 280 */ 281 int dwmci_bind(struct udevice *dev, struct mmc *mmc, struct mmc_config *cfg); 282 283 #else 284 /** 285 * add_dwmci() - Add a new DWMMC interface 286 * 287 * This is used when you are not using CONFIG_BLK. Convert your driver over! 288 * 289 * @host: DWMMC host structure 290 * @max_clk: Maximum supported clock speed in HZ (e.g. 150000000) 291 * @min_clk: Minimum supported clock speed in HZ (e.g. 400000) 292 * @return 0 if OK, -ve on error 293 */ 294 int add_dwmci(struct dwmci_host *host, u32 max_clk, u32 min_clk); 295 #endif /* !CONFIG_BLK */ 296 297 #ifdef CONFIG_DM_MMC 298 /* Export the operations to drivers */ 299 int dwmci_probe(struct udevice *dev); 300 extern const struct dm_mmc_ops dm_dwmci_ops; 301 #endif 302 303 #endif /* __DWMMC_HW_H */ 304