xref: /linux/include/linux/mmc/host.h (revision b0148a98ec5151fec82064d95f11eb9efbc628ea)
1 /*
2  *  linux/include/linux/mmc/host.h
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation.
7  *
8  *  Host driver specific definitions.
9  */
10 #ifndef LINUX_MMC_HOST_H
11 #define LINUX_MMC_HOST_H
12 
13 #include <linux/mmc/mmc.h>
14 
15 struct mmc_ios {
16 	unsigned int	clock;			/* clock rate */
17 	unsigned short	vdd;
18 
19 #define	MMC_VDD_150	0
20 #define	MMC_VDD_155	1
21 #define	MMC_VDD_160	2
22 #define	MMC_VDD_165	3
23 #define	MMC_VDD_170	4
24 #define	MMC_VDD_180	5
25 #define	MMC_VDD_190	6
26 #define	MMC_VDD_200	7
27 #define	MMC_VDD_210	8
28 #define	MMC_VDD_220	9
29 #define	MMC_VDD_230	10
30 #define	MMC_VDD_240	11
31 #define	MMC_VDD_250	12
32 #define	MMC_VDD_260	13
33 #define	MMC_VDD_270	14
34 #define	MMC_VDD_280	15
35 #define	MMC_VDD_290	16
36 #define	MMC_VDD_300	17
37 #define	MMC_VDD_310	18
38 #define	MMC_VDD_320	19
39 #define	MMC_VDD_330	20
40 #define	MMC_VDD_340	21
41 #define	MMC_VDD_350	22
42 #define	MMC_VDD_360	23
43 
44 	unsigned char	bus_mode;		/* command output mode */
45 
46 #define MMC_BUSMODE_OPENDRAIN	1
47 #define MMC_BUSMODE_PUSHPULL	2
48 
49 	unsigned char	chip_select;		/* SPI chip select */
50 
51 #define MMC_CS_DONTCARE		0
52 #define MMC_CS_HIGH		1
53 #define MMC_CS_LOW		2
54 
55 	unsigned char	power_mode;		/* power supply mode */
56 
57 #define MMC_POWER_OFF		0
58 #define MMC_POWER_UP		1
59 #define MMC_POWER_ON		2
60 
61 	unsigned char	bus_width;		/* data bus width */
62 
63 #define MMC_BUS_WIDTH_1		0
64 #define MMC_BUS_WIDTH_4		2
65 };
66 
67 struct mmc_host_ops {
68 	void	(*request)(struct mmc_host *host, struct mmc_request *req);
69 	void	(*set_ios)(struct mmc_host *host, struct mmc_ios *ios);
70 	int	(*get_ro)(struct mmc_host *host);
71 };
72 
73 struct mmc_card;
74 struct device;
75 
76 struct mmc_host {
77 	struct device		*parent;
78 	struct device		class_dev;
79 	int			index;
80 	const struct mmc_host_ops *ops;
81 	unsigned int		f_min;
82 	unsigned int		f_max;
83 	u32			ocr_avail;
84 
85 	unsigned long		caps;		/* Host capabilities */
86 
87 #define MMC_CAP_4_BIT_DATA	(1 << 0)	/* Can the host do 4 bit transfers */
88 #define MMC_CAP_MULTIWRITE	(1 << 1)	/* Can accurately report bytes sent to card on error */
89 #define MMC_CAP_BYTEBLOCK	(1 << 2)	/* Can do non-log2 block sizes */
90 
91 	/* host specific block data */
92 	unsigned int		max_seg_size;	/* see blk_queue_max_segment_size */
93 	unsigned short		max_hw_segs;	/* see blk_queue_max_hw_segments */
94 	unsigned short		max_phys_segs;	/* see blk_queue_max_phys_segments */
95 	unsigned short		unused;
96 	unsigned int		max_req_size;	/* maximum number of bytes in one req */
97 	unsigned int		max_blk_size;	/* maximum size of one mmc block */
98 	unsigned int		max_blk_count;	/* maximum number of blocks in one req */
99 
100 	/* private data */
101 	struct mmc_ios		ios;		/* current io bus settings */
102 	u32			ocr;		/* the current OCR setting */
103 
104 	unsigned int		mode;		/* current card mode of host */
105 #define MMC_MODE_MMC		0
106 #define MMC_MODE_SD		1
107 
108 	struct list_head	cards;		/* devices attached to this host */
109 
110 	wait_queue_head_t	wq;
111 	spinlock_t		lock;		/* claimed lock */
112 	unsigned int		claimed:1;	/* host exclusively claimed */
113 
114 	struct mmc_card		*card_selected;	/* the selected MMC card */
115 
116 	struct delayed_work	detect;
117 
118 	unsigned long		private[0] ____cacheline_aligned;
119 };
120 
121 extern struct mmc_host *mmc_alloc_host(int extra, struct device *);
122 extern int mmc_add_host(struct mmc_host *);
123 extern void mmc_remove_host(struct mmc_host *);
124 extern void mmc_free_host(struct mmc_host *);
125 
126 static inline void *mmc_priv(struct mmc_host *host)
127 {
128 	return (void *)host->private;
129 }
130 
131 #define mmc_dev(x)	((x)->parent)
132 #define mmc_classdev(x)	(&(x)->class_dev)
133 #define mmc_hostname(x)	((x)->class_dev.bus_id)
134 
135 extern int mmc_suspend_host(struct mmc_host *, pm_message_t);
136 extern int mmc_resume_host(struct mmc_host *);
137 
138 extern void mmc_detect_change(struct mmc_host *, unsigned long delay);
139 extern void mmc_request_done(struct mmc_host *, struct mmc_request *);
140 
141 #endif
142 
143