xref: /linux-6.15/include/linux/amba/mmci.h (revision db4e8395)
1 /*
2  *  include/linux/amba/mmci.h
3  */
4 #ifndef AMBA_MMCI_H
5 #define AMBA_MMCI_H
6 
7 #include <linux/mmc/host.h>
8 
9 /* Just some dummy forwarding */
10 struct dma_chan;
11 
12 /**
13  * struct mmci_platform_data - platform configuration for the MMCI
14  * (also known as PL180) block.
15  * @f_max: the maximum operational frequency for this host in this
16  * platform configuration. When this is specified it takes precedence
17  * over the module parameter for the same frequency.
18  * @ocr_mask: available voltages on the 4 pins from the block, this
19  * is ignored if a regulator is used, see the MMC_VDD_* masks in
20  * mmc/host.h
21  * @vdd_handler: a callback function to translate a MMC_VDD_*
22  * mask into a value to be binary (or set some other custom bits
23  * in MMCIPWR) or:ed and written into the MMCIPWR register of the
24  * block.  May also control external power based on the power_mode.
25  * @status: if no GPIO read function was given to the block in
26  * gpio_wp (below) this function will be called to determine
27  * whether a card is present in the MMC slot or not
28  * @gpio_wp: read this GPIO pin to see if the card is write protected
29  * @gpio_cd: read this GPIO pin to detect card insertion
30  * @cd_invert: true if the gpio_cd pin value is active low
31  * @capabilities: the capabilities of the block as implemented in
32  * this platform, signify anything MMC_CAP_* from mmc/host.h
33  * @dma_filter: function used to select an appropriate RX and TX
34  * DMA channel to be used for DMA, if and only if you're deploying the
35  * generic DMA engine
36  * @dma_rx_param: parameter passed to the DMA allocation
37  * filter in order to select an appropriate RX channel. If
38  * there is a bidirectional RX+TX channel, then just specify
39  * this and leave dma_tx_param set to NULL
40  * @dma_tx_param: parameter passed to the DMA allocation
41  * filter in order to select an appropriate TX channel. If this
42  * is NULL the driver will attempt to use the RX channel as a
43  * bidirectional channel
44  */
45 struct mmci_platform_data {
46 	unsigned int f_max;
47 	unsigned int ocr_mask;
48 	u32 (*vdd_handler)(struct device *, unsigned int vdd,
49 			   unsigned char power_mode);
50 	unsigned int (*status)(struct device *);
51 	int	gpio_wp;
52 	int	gpio_cd;
53 	bool	cd_invert;
54 	unsigned long capabilities;
55 	bool (*dma_filter)(struct dma_chan *chan, void *filter_param);
56 	void *dma_rx_param;
57 	void *dma_tx_param;
58 };
59 
60 #endif
61