[thirdparty/u-boot.git] / include / dwmmc.h

/* SPDX-License-Identifier: GPL-2.0+ */
/*
 * (C) Copyright 2012 SAMSUNG Electronics
 * Jaehoon Chung <jh80.chung@samsung.com>
 */

#ifndef __DWMMC_HW_H
#define __DWMMC_HW_H

#include <asm/cache.h>
#include <asm/io.h>
#include <mmc.h>
#include <linux/bitops.h>

#define DWMCI_CTRL		0x000
#define	DWMCI_PWREN		0x004
#define DWMCI_CLKDIV		0x008
#define DWMCI_CLKSRC		0x00C
#define DWMCI_CLKENA		0x010
#define DWMCI_TMOUT		0x014
#define DWMCI_CTYPE		0x018
#define DWMCI_BLKSIZ		0x01C
#define DWMCI_BYTCNT		0x020
#define DWMCI_INTMASK		0x024
#define DWMCI_CMDARG		0x028
#define DWMCI_CMD		0x02C
#define DWMCI_RESP0		0x030
#define DWMCI_RESP1		0x034
#define DWMCI_RESP2		0x038
#define DWMCI_RESP3		0x03C
#define DWMCI_MINTSTS		0x040
#define DWMCI_RINTSTS		0x044
#define DWMCI_STATUS		0x048
#define DWMCI_FIFOTH		0x04C
#define DWMCI_CDETECT		0x050
#define DWMCI_WRTPRT		0x054
#define DWMCI_GPIO		0x058
#define DWMCI_TCMCNT		0x05C
#define DWMCI_TBBCNT		0x060
#define DWMCI_DEBNCE		0x064
#define DWMCI_USRID		0x068
#define DWMCI_VERID		0x06C
#define DWMCI_HCON		0x070
#define DWMCI_UHS_REG		0x074
#define DWMCI_BMOD		0x080
#define DWMCI_PLDMND		0x084
#define DWMCI_DBADDR		0x088
#define DWMCI_IDSTS		0x08C
#define DWMCI_IDINTEN		0x090
#define DWMCI_DSCADDR		0x094
#define DWMCI_BUFADDR		0x098
#define DWMCI_DATA		0x200

/* Interrupt Mask register */
#define DWMCI_INTMSK_ALL	0xffffffff
#define DWMCI_INTMSK_RE		(1 << 1)
#define DWMCI_INTMSK_CDONE	(1 << 2)
#define DWMCI_INTMSK_DTO	(1 << 3)
#define DWMCI_INTMSK_TXDR	(1 << 4)
#define DWMCI_INTMSK_RXDR	(1 << 5)
#define DWMCI_INTMSK_RCRC	(1 << 6)
#define DWMCI_INTMSK_DCRC	(1 << 7)
#define DWMCI_INTMSK_RTO	(1 << 8)
#define DWMCI_INTMSK_DRTO	(1 << 9)
#define DWMCI_INTMSK_HTO	(1 << 10)
#define DWMCI_INTMSK_FRUN	(1 << 11)
#define DWMCI_INTMSK_HLE	(1 << 12)
#define DWMCI_INTMSK_SBE	(1 << 13)
#define DWMCI_INTMSK_ACD	(1 << 14)
#define DWMCI_INTMSK_EBE	(1 << 15)

/* Raw interrupt Regsiter */
#define DWMCI_DATA_ERR	(DWMCI_INTMSK_EBE | DWMCI_INTMSK_SBE | DWMCI_INTMSK_HLE |\
			DWMCI_INTMSK_FRUN | DWMCI_INTMSK_EBE | DWMCI_INTMSK_DCRC)
#define DWMCI_DATA_TOUT	(DWMCI_INTMSK_HTO | DWMCI_INTMSK_DRTO)
/* CTRL register */
#define DWMCI_CTRL_RESET	(1 << 0)
#define DWMCI_CTRL_FIFO_RESET	(1 << 1)
#define DWMCI_CTRL_DMA_RESET	(1 << 2)
#define DWMCI_DMA_EN		(1 << 5)
#define DWMCI_CTRL_SEND_AS_CCSD	(1 << 10)
#define DWMCI_IDMAC_EN		(1 << 25)
#define DWMCI_RESET_ALL		(DWMCI_CTRL_RESET | DWMCI_CTRL_FIFO_RESET |\
				DWMCI_CTRL_DMA_RESET)

/* CMD register */
#define DWMCI_CMD_RESP_EXP	(1 << 6)
#define DWMCI_CMD_RESP_LENGTH	(1 << 7)
#define DWMCI_CMD_CHECK_CRC	(1 << 8)
#define DWMCI_CMD_DATA_EXP	(1 << 9)
#define DWMCI_CMD_RW		(1 << 10)
#define DWMCI_CMD_SEND_STOP	(1 << 12)
#define DWMCI_CMD_ABORT_STOP	(1 << 14)
#define DWMCI_CMD_PRV_DAT_WAIT	(1 << 13)
#define DWMCI_CMD_UPD_CLK	(1 << 21)
#define DWMCI_CMD_USE_HOLD_REG	(1 << 29)
#define DWMCI_CMD_START		(1 << 31)

/* CLKENA register */
#define DWMCI_CLKEN_ENABLE	(1 << 0)
#define DWMCI_CLKEN_LOW_PWR	(1 << 16)

/* Card-type registe */
#define DWMCI_CTYPE_1BIT	0
#define DWMCI_CTYPE_4BIT	(1 << 0)
#define DWMCI_CTYPE_8BIT	(1 << 16)

/* Status Register */
#define DWMCI_FIFO_EMPTY	(1 << 2)
#define DWMCI_FIFO_FULL		(1 << 3)
#define DWMCI_BUSY		(1 << 9)
#define DWMCI_FIFO_MASK		0x1fff
#define DWMCI_FIFO_SHIFT	17

/* FIFOTH Register */
#define MSIZE(x)		((x) << 28)
#define RX_WMARK(x)		((x) << 16)
#define TX_WMARK(x)		(x)
#define RX_WMARK_SHIFT		16
#define RX_WMARK_MASK		(0xfff << RX_WMARK_SHIFT)

#define DWMCI_IDMAC_OWN		(1 << 31)
#define DWMCI_IDMAC_CH		(1 << 4)
#define DWMCI_IDMAC_FS		(1 << 3)
#define DWMCI_IDMAC_LD		(1 << 2)

/*  Bus Mode Register */
#define DWMCI_BMOD_IDMAC_RESET	(1 << 0)
#define DWMCI_BMOD_IDMAC_FB	(1 << 1)
#define DWMCI_BMOD_IDMAC_EN	(1 << 7)

/* UHS register */
#define DWMCI_DDR_MODE	(1 << 16)

/* Internal IDMAC interrupt defines */
#define DWMCI_IDINTEN_RI		BIT(1)
#define DWMCI_IDINTEN_TI		BIT(0)

#define DWMCI_IDINTEN_MASK	(DWMCI_IDINTEN_TI | \
				 DWMCI_IDINTEN_RI)

/* quirks */
#define DWMCI_QUIRK_DISABLE_SMU		(1 << 0)

/**
 * struct dwmci_host - Information about a designware MMC host
 *
 * @name:	Device name
 * @ioaddr:	Base I/O address of controller
 * @quirks:	Quick flags - see DWMCI_QUIRK_...
 * @caps:	Capabilities - see MMC_MODE_...
 * @bus_hz:	Bus speed in Hz, if @get_mmc_clk() is NULL
 * @div:	Arbitrary clock divider value for use by controller
 * @dev_index:	Arbitrary device index for use by controller
 * @dev_id:	Arbitrary device ID for use by controller
 * @buswidth:	Bus width in bits (8 or 4)
 * @fifoth_val:	Value for FIFOTH register (or 0 to leave unset)
 * @mmc:	Pointer to generic MMC structure for this device
 * @priv:	Private pointer for use by controller
 */
struct dwmci_host {
	const char *name;
	void *ioaddr;
	unsigned int quirks;
	unsigned int caps;
	unsigned int version;
	unsigned int clock;
	unsigned int bus_hz;
	unsigned int div;
	int dev_index;
	int dev_id;
	int buswidth;
	u32 fifoth_val;
	struct mmc *mmc;
	void *priv;

	int (*clksel)(struct dwmci_host *host);
	void (*board_init)(struct dwmci_host *host);

	/**
	 * Get / set a particular MMC clock frequency
	 *
	 * This is used to request the current clock frequency of the clock
	 * that drives the DWMMC peripheral. The caller will then use this
	 * information to work out the divider it needs to achieve the
	 * required MMC bus clock frequency. If you want to handle the
	 * clock external to DWMMC, use @freq to select the frequency and
	 * return that value too. Then DWMMC will put itself in bypass mode.
	 *
	 * @host:	DWMMC host
	 * @freq:	Frequency the host is trying to achieve
	 */
	unsigned int (*get_mmc_clk)(struct dwmci_host *host, uint freq);
#ifndef CONFIG_BLK
	struct mmc_config cfg;
#endif

	/* use fifo mode to read and write data */
	bool fifo_mode;
};

struct dwmci_idmac {
	u32 flags;
	u32 cnt;
	u32 addr;
	u32 next_addr;
} __aligned(ARCH_DMA_MINALIGN);

static inline void dwmci_writel(struct dwmci_host *host, int reg, u32 val)
{
	writel(val, host->ioaddr + reg);
}

static inline void dwmci_writew(struct dwmci_host *host, int reg, u16 val)
{
	writew(val, host->ioaddr + reg);
}

static inline void dwmci_writeb(struct dwmci_host *host, int reg, u8 val)
{
	writeb(val, host->ioaddr + reg);
}
static inline u32 dwmci_readl(struct dwmci_host *host, int reg)
{
	return readl(host->ioaddr + reg);
}

static inline u16 dwmci_readw(struct dwmci_host *host, int reg)
{
	return readw(host->ioaddr + reg);
}

static inline u8 dwmci_readb(struct dwmci_host *host, int reg)
{
	return readb(host->ioaddr + reg);
}

#ifdef CONFIG_BLK
/**
 * dwmci_setup_cfg() - Set up the configuration for DWMMC
 *
 * This is used to set up a DWMMC device when you are using CONFIG_BLK.
 *
 * This should be called from your MMC driver's probe() method once you have
 * the information required.
 *
 * Generally your driver will have a platform data structure which holds both
 * the configuration (struct mmc_config) and the MMC device info (struct mmc).
 * For example:
 *
 * struct rockchip_mmc_plat {
 *	struct mmc_config cfg;
 *	struct mmc mmc;
 * };
 *
 * ...
 *
 * Inside U_BOOT_DRIVER():
 *	.plat_auto	= sizeof(struct rockchip_mmc_plat),
 *
 * To access platform data:
 *	struct rockchip_mmc_plat *plat = dev_get_plat(dev);
 *
 * See rockchip_dw_mmc.c for an example.
 *
 * @cfg:	Configuration structure to fill in (generally &plat->mmc)
 * @host:	DWMMC host
 * @max_clk:	Maximum supported clock speed in HZ (e.g. 150000000)
 * @min_clk:	Minimum supported clock speed in HZ (e.g. 400000)
 */
void dwmci_setup_cfg(struct mmc_config *cfg, struct dwmci_host *host,
		u32 max_clk, u32 min_clk);

/**
 * dwmci_bind() - Set up a new MMC block device
 *
 * This is used to set up a DWMMC block device when you are using CONFIG_BLK.
 * It should be called from your driver's bind() method.
 *
 * See rockchip_dw_mmc.c for an example.
 *
 * @dev:	Device to set up
 * @mmc:	Pointer to mmc structure (normally &plat->mmc)
 * @cfg:	Empty configuration structure (generally &plat->cfg). This is
 *		normally all zeroes at this point. The only purpose of passing
 *		this in is to set mmc->cfg to it.
 * Return: 0 if OK, -ve if the block device could not be created
 */
int dwmci_bind(struct udevice *dev, struct mmc *mmc, struct mmc_config *cfg);

#else
/**
 * add_dwmci() - Add a new DWMMC interface
 *
 * This is used when you are not using CONFIG_BLK. Convert your driver over!
 *
 * @host:	DWMMC host structure
 * @max_clk:	Maximum supported clock speed in HZ (e.g. 150000000)
 * @min_clk:	Minimum supported clock speed in HZ (e.g. 400000)
 * Return: 0 if OK, -ve on error
 */
int add_dwmci(struct dwmci_host *host, u32 max_clk, u32 min_clk);
#endif /* !CONFIG_BLK */

#ifdef CONFIG_DM_MMC
/* Export the operations to drivers */
int dwmci_probe(struct udevice *dev);
extern const struct dm_mmc_ops dm_dwmci_ops;
#endif

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