blob: d72c0c34c21dfacce83eb010987c3e567e38c776 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
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
Pierre Ossmanaf8350c2007-09-24 07:15:48 +020013#include <linux/leds.h>
Guennadi Liakhovetskia7d1a1e2012-05-01 16:51:38 +020014#include <linux/mutex.h>
Adrian Hunterdfa13eb2015-05-07 13:10:12 +030015#include <linux/timer.h>
Alexey Dobriyand43c36d2009-10-07 17:09:06 +040016#include <linux/sched.h>
Paul Gortmaker313162d2012-01-30 11:46:54 -050017#include <linux/device.h>
Per Forlin1b676f72011-08-19 14:52:37 +020018#include <linux/fault-inject.h>
Pierre Ossmanaf8350c2007-09-24 07:15:48 +020019
Pierre Ossmanaaac1b42007-02-28 15:33:10 +010020#include <linux/mmc/core.h>
Seungwon Jeoncdc99172014-04-23 17:07:35 +090021#include <linux/mmc/card.h>
Shawn Lin81ac2af2016-05-26 09:56:22 +080022#include <linux/mmc/mmc.h>
Nicolas Pitreda68c4e2010-03-05 13:43:31 -080023#include <linux/mmc/pm.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070024
25struct mmc_ios {
26 unsigned int clock; /* clock rate */
27 unsigned short vdd;
28
Philip Langdale4be34c92007-03-11 17:15:15 -070029/* vdd stores the bit number of the selected voltage range from below. */
Linus Torvalds1da177e2005-04-16 15:20:36 -070030
31 unsigned char bus_mode; /* command output mode */
32
33#define MMC_BUSMODE_OPENDRAIN 1
34#define MMC_BUSMODE_PUSHPULL 2
35
Pierre Ossman865e9f12005-09-03 16:45:02 +010036 unsigned char chip_select; /* SPI chip select */
37
38#define MMC_CS_DONTCARE 0
39#define MMC_CS_HIGH 1
40#define MMC_CS_LOW 2
41
Linus Torvalds1da177e2005-04-16 15:20:36 -070042 unsigned char power_mode; /* power supply mode */
43
44#define MMC_POWER_OFF 0
45#define MMC_POWER_UP 1
46#define MMC_POWER_ON 2
Roger Tseng8af465d2014-09-24 17:07:13 +080047#define MMC_POWER_UNDEFINED 3
Pierre Ossmanf2182782005-09-06 15:18:55 -070048
49 unsigned char bus_width; /* data bus width */
50
51#define MMC_BUS_WIDTH_1 0
52#define MMC_BUS_WIDTH_4 2
Jarkko Lavinenb30f8af2008-11-17 14:35:21 +020053#define MMC_BUS_WIDTH_8 3
Pierre Ossmancd9277c2007-02-18 12:07:47 +010054
55 unsigned char timing; /* timing specification used */
56
57#define MMC_TIMING_LEGACY 0
58#define MMC_TIMING_MMC_HS 1
59#define MMC_TIMING_SD_HS 2
Kevin Liued9dbb62012-10-17 19:04:46 +080060#define MMC_TIMING_UHS_SDR12 3
61#define MMC_TIMING_UHS_SDR25 4
62#define MMC_TIMING_UHS_SDR50 5
63#define MMC_TIMING_UHS_SDR104 6
64#define MMC_TIMING_UHS_DDR50 7
Seungwon Jeon79f7ae72014-03-14 21:11:56 +090065#define MMC_TIMING_MMC_DDR52 8
66#define MMC_TIMING_MMC_HS200 9
Seungwon Jeon0a5b6432014-04-23 17:14:58 +090067#define MMC_TIMING_MMC_HS400 10
Adrian Hunter0f8d8ea2010-08-24 13:20:26 +030068
Arindam Nathf2119df2011-05-05 12:18:57 +053069 unsigned char signal_voltage; /* signalling voltage (1.8V or 3.3V) */
70
71#define MMC_SIGNAL_VOLTAGE_330 0
72#define MMC_SIGNAL_VOLTAGE_180 1
Philip Rakity4c4cb172011-05-13 11:17:18 +053073#define MMC_SIGNAL_VOLTAGE_120 2
Arindam Nathd6d50a12011-05-05 12:18:59 +053074
75 unsigned char drv_type; /* driver type (A, B, C, D) */
76
77#define MMC_SET_DRIVER_TYPE_B 0
78#define MMC_SET_DRIVER_TYPE_A 1
79#define MMC_SET_DRIVER_TYPE_C 2
80#define MMC_SET_DRIVER_TYPE_D 3
Shawn Lin81ac2af2016-05-26 09:56:22 +080081
82 bool enhanced_strobe; /* hs400es selection */
Linus Torvalds1da177e2005-04-16 15:20:36 -070083};
84
85struct mmc_host_ops {
Adrian Hunter8ea926b2009-09-22 16:44:29 -070086 /*
Per Forlinaa8b6832011-07-01 18:55:22 +020087 * It is optional for the host to implement pre_req and post_req in
88 * order to support double buffering of requests (prepare one
89 * request while another request is active).
Per Forlin7c8a2822011-08-29 15:35:58 +020090 * pre_req() must always be followed by a post_req().
91 * To undo a call made to pre_req(), call post_req() with
92 * a nonzero err condition.
Per Forlinaa8b6832011-07-01 18:55:22 +020093 */
94 void (*post_req)(struct mmc_host *host, struct mmc_request *req,
95 int err);
96 void (*pre_req)(struct mmc_host *host, struct mmc_request *req,
97 bool is_first_req);
Linus Torvalds1da177e2005-04-16 15:20:36 -070098 void (*request)(struct mmc_host *host, struct mmc_request *req);
Wolfram Sang93b69112016-04-01 17:44:36 +020099
Anton Vorontsov28f52482008-06-17 18:17:15 +0400100 /*
Wolfram Sang93b69112016-04-01 17:44:36 +0200101 * Avoid calling the next three functions too often or in a "fast
102 * path", since underlaying controller might implement them in an
103 * expensive and/or slow way. Also note that these functions might
104 * sleep, so don't call them in the atomic contexts!
105 */
106
107 /*
108 * Notes to the set_ios callback:
109 * ios->clock might be 0. For some controllers, setting 0Hz
110 * as any other frequency works. However, some controllers
111 * explicitly need to disable the clock. Otherwise e.g. voltage
112 * switching might fail because the SDCLK is not really quiet.
113 */
114 void (*set_ios)(struct mmc_host *host, struct mmc_ios *ios);
115
116 /*
Anton Vorontsov08f80bb2008-06-17 18:17:39 +0400117 * Return values for the get_ro callback should be:
118 * 0 for a read/write card
119 * 1 for a read-only card
120 * -ENOSYS when not supported (equal to NULL callback)
121 * or a negative errno value when something bad happened
Wolfram Sang93b69112016-04-01 17:44:36 +0200122 */
123 int (*get_ro)(struct mmc_host *host);
124
125 /*
Thomas Petazzoniee63a7d22008-09-02 10:14:13 +0200126 * Return values for the get_cd callback should be:
Anton Vorontsov08f80bb2008-06-17 18:17:39 +0400127 * 0 for a absent card
128 * 1 for a present card
129 * -ENOSYS when not supported (equal to NULL callback)
130 * or a negative errno value when something bad happened
Anton Vorontsov28f52482008-06-17 18:17:15 +0400131 */
Anton Vorontsov28f52482008-06-17 18:17:15 +0400132 int (*get_cd)(struct mmc_host *host);
133
Nicolas Pitre17b759a2007-07-24 02:09:39 -0400134 void (*enable_sdio_irq)(struct mmc_host *host, int enable);
Daniel Mack3fcb0272010-04-01 10:03:25 +0200135
136 /* optional callback for HC quirks */
137 void (*init_card)(struct mmc_host *host, struct mmc_card *card);
Arindam Nathf2119df2011-05-05 12:18:57 +0530138
139 int (*start_signal_voltage_switch)(struct mmc_host *host, struct mmc_ios *ios);
Girish K Sa4924c72012-01-11 14:04:52 -0500140
Johan Rudholmd8878742013-01-28 15:08:26 +0100141 /* Check if the card is pulling dat[0:3] low */
142 int (*card_busy)(struct mmc_host *host);
143
Girish K Sa4924c72012-01-11 14:04:52 -0500144 /* The tuning command opcode value is different for SD and eMMC cards */
145 int (*execute_tuning)(struct mmc_host *host, u32 opcode);
Seungwon Jeon0a5b6432014-04-23 17:14:58 +0900146
147 /* Prepare HS400 target operating frequency depending host driver */
148 int (*prepare_hs400_tuning)(struct mmc_host *host, struct mmc_ios *ios);
Shawn Lin81ac2af2016-05-26 09:56:22 +0800149 /* Prepare enhanced strobe depending host driver */
150 void (*hs400_enhanced_strobe)(struct mmc_host *host,
151 struct mmc_ios *ios);
Adrian Hunterf1683592015-02-06 14:12:54 +0200152 int (*select_drive_strength)(struct mmc_card *card,
153 unsigned int max_dtr, int host_drv,
Adrian Hunterb4f30a12015-02-06 14:12:52 +0200154 int card_drv, int *drv_type);
Adrian Hunterb2499512011-08-29 16:42:11 +0300155 void (*hw_reset)(struct mmc_host *host);
Guennadi Liakhovetski9f1fb602012-12-04 16:51:32 +0100156 void (*card_event)(struct mmc_host *host);
Kuninori Morimoto2e47e842014-09-02 19:08:53 -0700157
158 /*
159 * Optional callback to support controllers with HW issues for multiple
160 * I/O. Returns the number of supported blocks for the request.
161 */
162 int (*multi_io_quirk)(struct mmc_card *card,
163 unsigned int direction, int blk_size);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700164};
165
166struct mmc_card;
167struct device;
168
Per Forlinaa8b6832011-07-01 18:55:22 +0200169struct mmc_async_req {
170 /* active mmc request */
171 struct mmc_request *mrq;
172 /*
173 * Check error status of completed mmc request.
174 * Returns 0 if success otherwise non zero.
175 */
176 int (*err_check) (struct mmc_card *, struct mmc_async_req *);
177};
178
Guennadi Liakhovetski27410ee2012-05-01 15:40:15 +0200179/**
180 * struct mmc_slot - MMC slot functions
181 *
182 * @cd_irq: MMC/SD-card slot hotplug detection IRQ or -EINVAL
183 * @handler_priv: MMC/SD-card slot context
184 *
185 * Some MMC/SD host controllers implement slot-functions like card and
186 * write-protect detection natively. However, a large number of controllers
187 * leave these functions to the CPU. This struct provides a hook to attach
188 * such slot-function drivers.
189 */
190struct mmc_slot {
191 int cd_irq;
Guennadi Liakhovetskib67e1982011-12-25 20:40:03 -0500192 void *handler_priv;
193};
194
Konstantin Dorfman2220eed2013-01-14 14:28:17 -0500195/**
196 * mmc_context_info - synchronization details for mmc context
197 * @is_done_rcv wake up reason was done request
198 * @is_new_req wake up reason was new request
199 * @is_waiting_last_req mmc context waiting for single running request
200 * @wait wait queue
201 * @lock lock to protect data fields
202 */
203struct mmc_context_info {
204 bool is_done_rcv;
205 bool is_new_req;
206 bool is_waiting_last_req;
207 wait_queue_head_t wait;
208 spinlock_t lock;
209};
210
Guennadi Liakhovetskie1377882012-06-20 02:28:43 -0400211struct regulator;
Ulf Hansson3aa87932014-11-28 14:38:36 +0100212struct mmc_pwrseq;
Guennadi Liakhovetskie1377882012-06-20 02:28:43 -0400213
214struct mmc_supply {
215 struct regulator *vmmc; /* Card power supply */
216 struct regulator *vqmmc; /* Optional Vccq supply */
217};
218
Linus Torvalds1da177e2005-04-16 15:20:36 -0700219struct mmc_host {
Greg Kroah-Hartmanfcaf71f2006-09-12 17:00:10 +0200220 struct device *parent;
221 struct device class_dev;
Russell Kingdce77372005-08-19 09:42:52 +0100222 int index;
David Brownellf57b2252006-09-03 06:43:33 -0700223 const struct mmc_host_ops *ops;
Ulf Hansson3aa87932014-11-28 14:38:36 +0100224 struct mmc_pwrseq *pwrseq;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700225 unsigned int f_min;
226 unsigned int f_max;
Hein Tibosch88ae8b82010-09-06 09:37:19 +0800227 unsigned int f_init;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700228 u32 ocr_avail;
Takashi Iwai8f230f42010-12-08 10:04:30 +0100229 u32 ocr_avail_sdio; /* SDIO-specific OCR */
230 u32 ocr_avail_sd; /* SD-specific OCR */
231 u32 ocr_avail_mmc; /* MMC-specific OCR */
Ulf Hansson8dede182015-11-05 16:11:12 +0100232#ifdef CONFIG_PM_SLEEP
Maxim Levitsky4c2ef252010-08-10 18:01:41 -0700233 struct notifier_block pm_notify;
Ulf Hansson8dede182015-11-05 16:11:12 +0100234#endif
Aaron Lu55c46652012-07-04 13:31:48 +0800235 u32 max_current_330;
236 u32 max_current_300;
237 u32 max_current_180;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700238
Philip Langdale55556da2007-03-16 19:39:00 -0700239#define MMC_VDD_165_195 0x00000080 /* VDD voltage 1.65 - 1.95 */
Pierre Ossmanf74d1322007-02-09 22:49:31 +0100240#define MMC_VDD_20_21 0x00000100 /* VDD voltage 2.0 ~ 2.1 */
241#define MMC_VDD_21_22 0x00000200 /* VDD voltage 2.1 ~ 2.2 */
242#define MMC_VDD_22_23 0x00000400 /* VDD voltage 2.2 ~ 2.3 */
243#define MMC_VDD_23_24 0x00000800 /* VDD voltage 2.3 ~ 2.4 */
244#define MMC_VDD_24_25 0x00001000 /* VDD voltage 2.4 ~ 2.5 */
245#define MMC_VDD_25_26 0x00002000 /* VDD voltage 2.5 ~ 2.6 */
246#define MMC_VDD_26_27 0x00004000 /* VDD voltage 2.6 ~ 2.7 */
247#define MMC_VDD_27_28 0x00008000 /* VDD voltage 2.7 ~ 2.8 */
248#define MMC_VDD_28_29 0x00010000 /* VDD voltage 2.8 ~ 2.9 */
249#define MMC_VDD_29_30 0x00020000 /* VDD voltage 2.9 ~ 3.0 */
250#define MMC_VDD_30_31 0x00040000 /* VDD voltage 3.0 ~ 3.1 */
251#define MMC_VDD_31_32 0x00080000 /* VDD voltage 3.1 ~ 3.2 */
252#define MMC_VDD_32_33 0x00100000 /* VDD voltage 3.2 ~ 3.3 */
253#define MMC_VDD_33_34 0x00200000 /* VDD voltage 3.3 ~ 3.4 */
254#define MMC_VDD_34_35 0x00400000 /* VDD voltage 3.4 ~ 3.5 */
255#define MMC_VDD_35_36 0x00800000 /* VDD voltage 3.5 ~ 3.6 */
256
Lee Jones5f1a4dd2012-11-14 12:35:51 +0000257 u32 caps; /* Host capabilities */
Pierre Ossmanf2182782005-09-06 15:18:55 -0700258
259#define MMC_CAP_4_BIT_DATA (1 << 0) /* Can the host do 4 bit transfers */
Pierre Ossman23af6032008-07-06 01:10:27 +0200260#define MMC_CAP_MMC_HIGHSPEED (1 << 1) /* Can do MMC high-speed timing */
261#define MMC_CAP_SD_HIGHSPEED (1 << 2) /* Can do SD high-speed timing */
262#define MMC_CAP_SDIO_IRQ (1 << 3) /* Can signal pending SDIO IRQs */
263#define MMC_CAP_SPI (1 << 4) /* Talks only SPI protocols */
264#define MMC_CAP_NEEDS_POLL (1 << 5) /* Needs polling for card-detection */
Jarkko Lavinenb30f8af2008-11-17 14:35:21 +0200265#define MMC_CAP_8_BIT_DATA (1 << 6) /* Can the host do 8 bit transfers */
Ulf Hanssonc4d770d2013-05-02 14:02:39 +0200266#define MMC_CAP_AGGRESSIVE_PM (1 << 7) /* Suspend (e)MMC/SD at idle */
Adrian Hunter9feae242009-09-22 16:44:32 -0700267#define MMC_CAP_NONREMOVABLE (1 << 8) /* Nonremovable e.g. eMMC */
Jarkko Lavinenb1ebe382009-09-22 16:44:34 -0700268#define MMC_CAP_WAIT_WHILE_BUSY (1 << 9) /* Waits while card is busy */
Adrian Hunterdfe86cb2010-08-11 14:17:46 -0700269#define MMC_CAP_ERASE (1 << 10) /* Allow erase/trim commands */
Hanumath Prasaddfc13e82010-09-30 17:37:23 -0400270#define MMC_CAP_1_8V_DDR (1 << 11) /* can support */
271 /* DDR mode at 1.8V */
272#define MMC_CAP_1_2V_DDR (1 << 12) /* can support */
273 /* DDR mode at 1.2V */
Ohad Ben-Cohened919b02010-11-19 09:29:09 +0200274#define MMC_CAP_POWER_OFF_CARD (1 << 13) /* Can power off after boot */
Aries Lee22113ef2010-12-15 08:14:24 +0100275#define MMC_CAP_BUS_WIDTH_TEST (1 << 14) /* CMD14/CMD19 bus width ok */
Arindam Nathf2119df2011-05-05 12:18:57 +0530276#define MMC_CAP_UHS_SDR12 (1 << 15) /* Host supports UHS SDR12 mode */
277#define MMC_CAP_UHS_SDR25 (1 << 16) /* Host supports UHS SDR25 mode */
278#define MMC_CAP_UHS_SDR50 (1 << 17) /* Host supports UHS SDR50 mode */
279#define MMC_CAP_UHS_SDR104 (1 << 18) /* Host supports UHS SDR104 mode */
280#define MMC_CAP_UHS_DDR50 (1 << 19) /* Host supports UHS DDR50 mode */
Arindam Nathd6d50a12011-05-05 12:18:59 +0530281#define MMC_CAP_DRIVER_TYPE_A (1 << 23) /* Host supports Driver Type A */
282#define MMC_CAP_DRIVER_TYPE_C (1 << 24) /* Host supports Driver Type C */
283#define MMC_CAP_DRIVER_TYPE_D (1 << 25) /* Host supports Driver Type D */
Andrei Warkentind0c97cf2011-05-23 15:06:36 -0500284#define MMC_CAP_CMD23 (1 << 30) /* CMD23 supported. */
Adrian Hunterb2499512011-08-29 16:42:11 +0300285#define MMC_CAP_HW_RESET (1 << 31) /* Hardware reset */
Pierre Ossmanf2182782005-09-06 15:18:55 -0700286
Lee Jones5f1a4dd2012-11-14 12:35:51 +0000287 u32 caps2; /* More host capabilities */
Adrian Hunterf7c56ef2011-09-23 12:48:21 +0300288
289#define MMC_CAP2_BOOTPART_NOACC (1 << 0) /* Boot partition no access */
Ulf Hansson53275c22013-06-10 17:03:46 +0200290#define MMC_CAP2_FULL_PWR_CYCLE (1 << 2) /* Can do full power cycle */
Girish K Sa4924c72012-01-11 14:04:52 -0500291#define MMC_CAP2_HS200_1_8V_SDR (1 << 5) /* can support */
292#define MMC_CAP2_HS200_1_2V_SDR (1 << 6) /* can support */
293#define MMC_CAP2_HS200 (MMC_CAP2_HS200_1_8V_SDR | \
294 MMC_CAP2_HS200_1_2V_SDR)
Adrian Hunter83bb24a2012-03-13 05:19:13 -0400295#define MMC_CAP2_HC_ERASE_SZ (1 << 9) /* High-capacity erase size */
Guennadi Liakhovetski5c08d7f2012-05-01 15:49:52 +0200296#define MMC_CAP2_CD_ACTIVE_HIGH (1 << 10) /* Card-detect signal active high */
297#define MMC_CAP2_RO_ACTIVE_HIGH (1 << 11) /* Write-protect signal active high */
Seungwon Jeonabd9ac12013-02-06 17:01:43 +0900298#define MMC_CAP2_PACKED_RD (1 << 12) /* Allow packed read */
299#define MMC_CAP2_PACKED_WR (1 << 13) /* Allow packed write */
300#define MMC_CAP2_PACKED_CMD (MMC_CAP2_PACKED_RD | \
301 MMC_CAP2_PACKED_WR)
Adrian Hunter0d3e3352013-04-04 16:41:06 +0300302#define MMC_CAP2_NO_PRESCAN_POWERUP (1 << 14) /* Don't power up before scan */
Seungwon Jeon0a5b6432014-04-23 17:14:58 +0900303#define MMC_CAP2_HS400_1_8V (1 << 15) /* Can support HS400 1.8V */
304#define MMC_CAP2_HS400_1_2V (1 << 16) /* Can support HS400 1.2V */
305#define MMC_CAP2_HS400 (MMC_CAP2_HS400_1_8V | \
306 MMC_CAP2_HS400_1_2V)
Adrian Hunter549c0b12014-11-06 15:19:05 +0200307#define MMC_CAP2_HSX00_1_2V (MMC_CAP2_HS200_1_2V_SDR | MMC_CAP2_HS400_1_2V)
Russell Kingbf3b5ec2014-04-25 12:55:30 +0100308#define MMC_CAP2_SDIO_IRQ_NOTHREAD (1 << 17)
Lars-Peter Clausen9f6e0bf2015-05-06 20:31:19 +0200309#define MMC_CAP2_NO_WRITE_PROTECT (1 << 18) /* No physical write protect pin, assume that card is always read-write */
Carlo Caione100a6062015-11-25 15:39:51 +0100310#define MMC_CAP2_NO_SDIO (1 << 19) /* Do not send SDIO commands during initialization */
Shawn Linef29c0e2016-05-26 09:56:12 +0800311#define MMC_CAP2_HS400_ES (1 << 20) /* Host supports enhanced strobe */
Adrian Hunterf7c56ef2011-09-23 12:48:21 +0300312
Nicolas Pitreda68c4e2010-03-05 13:43:31 -0800313 mmc_pm_flag_t pm_caps; /* supported pm features */
314
Linus Torvalds1da177e2005-04-16 15:20:36 -0700315 /* host specific block data */
316 unsigned int max_seg_size; /* see blk_queue_max_segment_size */
Martin K. Petersena36274e2010-09-10 01:33:59 -0400317 unsigned short max_segs; /* see blk_queue_max_segments */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700318 unsigned short unused;
Pierre Ossman55db8902006-11-21 17:55:45 +0100319 unsigned int max_req_size; /* maximum number of bytes in one req */
Pierre Ossmanfe4a3c72006-11-21 17:54:23 +0100320 unsigned int max_blk_size; /* maximum size of one mmc block */
Pierre Ossman55db8902006-11-21 17:55:45 +0100321 unsigned int max_blk_count; /* maximum number of blocks in one req */
Ulf Hansson68eb80e2013-12-18 09:57:38 +0100322 unsigned int max_busy_timeout; /* max busy timeout in ms */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700323
324 /* private data */
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100325 spinlock_t lock; /* lock for claim and bus ops */
326
Linus Torvalds1da177e2005-04-16 15:20:36 -0700327 struct mmc_ios ios; /* current io bus settings */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700328
David Brownell97018582007-08-08 09:09:01 -0700329 /* group bitfields together to minimize padding */
330 unsigned int use_spi_crc:1;
331 unsigned int claimed:1; /* host exclusively claimed */
332 unsigned int bus_dead:1; /* bus has been released */
333#ifdef CONFIG_MMC_DEBUG
334 unsigned int removed:1; /* host is being removed */
335#endif
Adrian Hunterdfa13eb2015-05-07 13:10:12 +0300336 unsigned int can_retune:1; /* re-tuning can be used */
337 unsigned int doing_retune:1; /* re-tuning in progress */
338 unsigned int retune_now:1; /* do re-tuning at next req */
Adrian Hunter7ff27602016-05-16 15:35:24 +0300339 unsigned int retune_paused:1; /* re-tuning is temporarily disabled */
David Brownell97018582007-08-08 09:09:01 -0700340
Maxim Levitsky4c2ef252010-08-10 18:01:41 -0700341 int rescan_disable; /* disable card detection */
Johan Rudholm3339d1e2012-08-23 13:40:55 +0200342 int rescan_entered; /* used with nonremovable devices */
Adrian Hunter8ea926b2009-09-22 16:44:29 -0700343
Adrian Hunterdfa13eb2015-05-07 13:10:12 +0300344 int need_retune; /* re-tuning is needed */
345 int hold_retune; /* hold off re-tuning */
346 unsigned int retune_period; /* re-tuning period in secs */
347 struct timer_list retune_timer; /* for periodic re-tuning */
348
Markus Mayerfa372a52014-04-08 15:19:43 -0700349 bool trigger_card_event; /* card_event necessary */
350
Pierre Ossmanb8558852007-01-03 19:47:29 +0100351 struct mmc_card *card; /* device attached to this host */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700352
353 wait_queue_head_t wq;
Adrian Hunter319a3f12009-09-22 16:44:30 -0700354 struct task_struct *claimer; /* task that has host claimed */
355 int claim_cnt; /* "claim" nesting count */
Pierre Ossmanf22ee4e2006-12-26 15:11:23 +0100356
David Howellsc4028952006-11-22 14:57:56 +0000357 struct delayed_work detect;
Adrian Hunterd3049502011-11-28 16:22:00 +0200358 int detect_change; /* card detect flag */
Guennadi Liakhovetski27410ee2012-05-01 15:40:15 +0200359 struct mmc_slot slot;
Russell King01357dc2005-09-08 22:46:00 +0100360
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100361 const struct mmc_bus_ops *bus_ops; /* current bus driver */
362 unsigned int bus_refs; /* reference counter */
Pierre Ossman7ea239d2006-12-31 00:11:32 +0100363
Nicolas Pitred1496c32007-06-30 16:29:41 +0200364 unsigned int sdio_irqs;
365 struct task_struct *sdio_irq_thread;
Nicolas Pitrebbbc4c42012-04-16 19:16:54 -0400366 bool sdio_irq_pending;
Nicolas Pitred1496c32007-06-30 16:29:41 +0200367 atomic_t sdio_irq_thread_abort;
368
Nicolas Pitreda68c4e2010-03-05 13:43:31 -0800369 mmc_pm_flag_t pm_flags; /* requested pm features */
370
Pierre Ossmanaf8350c2007-09-24 07:15:48 +0200371 struct led_trigger *led; /* activity led */
Pierre Ossmanaf8350c2007-09-24 07:15:48 +0200372
Linus Walleij99fc5132010-09-29 01:08:27 -0400373#ifdef CONFIG_REGULATOR
374 bool regulator_enabled; /* regulator state */
375#endif
Guennadi Liakhovetskie1377882012-06-20 02:28:43 -0400376 struct mmc_supply supply;
Linus Walleij99fc5132010-09-29 01:08:27 -0400377
Haavard Skinnemoen6edd8ee2008-07-24 14:18:57 +0200378 struct dentry *debugfs_root;
379
Per Forlinaa8b6832011-07-01 18:55:22 +0200380 struct mmc_async_req *areq; /* active async req */
Konstantin Dorfman2220eed2013-01-14 14:28:17 -0500381 struct mmc_context_info context_info; /* async synchronization info */
Per Forlinaa8b6832011-07-01 18:55:22 +0200382
Per Forlin1b676f72011-08-19 14:52:37 +0200383#ifdef CONFIG_FAIL_MMC_REQUEST
384 struct fault_attr fail_mmc_request;
385#endif
386
Giuseppe CAVALLAROdf162192011-11-04 13:53:19 +0100387 unsigned int actual_clock; /* Actual HC clock rate */
388
Aaron Lueed222a2013-03-05 11:24:52 +0800389 unsigned int slotno; /* used for sdio acpi binding */
390
Sascha Hauer3d705d12014-08-19 10:45:51 +0200391 int dsr_req; /* DSR value is valid */
392 u32 dsr; /* optional driver stage (DSR) value */
393
Russell King01357dc2005-09-08 22:46:00 +0100394 unsigned long private[0] ____cacheline_aligned;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700395};
396
Guennadi Liakhovetski8c9beb12013-02-15 16:13:53 +0100397struct mmc_host *mmc_alloc_host(int extra, struct device *);
398int mmc_add_host(struct mmc_host *);
399void mmc_remove_host(struct mmc_host *);
400void mmc_free_host(struct mmc_host *);
Simon Baatzec0a7512013-06-09 22:14:11 +0200401int mmc_of_parse(struct mmc_host *host);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700402
Russell King01357dc2005-09-08 22:46:00 +0100403static inline void *mmc_priv(struct mmc_host *host)
404{
405 return (void *)host->private;
406}
407
David Brownell97018582007-08-08 09:09:01 -0700408#define mmc_host_is_spi(host) ((host)->caps & MMC_CAP_SPI)
409
Greg Kroah-Hartmanfcaf71f2006-09-12 17:00:10 +0200410#define mmc_dev(x) ((x)->parent)
Pierre Ossman11354d02007-01-14 01:41:45 +0100411#define mmc_classdev(x) (&(x)->class_dev)
Kay Sieversd1b26862008-11-08 21:37:46 +0100412#define mmc_hostname(x) (dev_name(&(x)->class_dev))
Linus Torvalds1da177e2005-04-16 15:20:36 -0700413
Guennadi Liakhovetski8c9beb12013-02-15 16:13:53 +0100414int mmc_power_save_host(struct mmc_host *host);
415int mmc_power_restore_host(struct mmc_host *host);
Adrian Huntereae1aee2009-09-22 16:44:33 -0700416
Guennadi Liakhovetski8c9beb12013-02-15 16:13:53 +0100417void mmc_detect_change(struct mmc_host *, unsigned long delay);
418void mmc_request_done(struct mmc_host *, struct mmc_request *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700419
Nicolas Pitre17b759a2007-07-24 02:09:39 -0400420static inline void mmc_signal_sdio_irq(struct mmc_host *host)
421{
422 host->ops->enable_sdio_irq(host, 0);
Nicolas Pitrebbbc4c42012-04-16 19:16:54 -0400423 host->sdio_irq_pending = true;
Yangbo Luf13e5b92015-07-10 11:36:45 +0800424 if (host->sdio_irq_thread)
425 wake_up_process(host->sdio_irq_thread);
Nicolas Pitre17b759a2007-07-24 02:09:39 -0400426}
427
Russell Kingbf3b5ec2014-04-25 12:55:30 +0100428void sdio_run_irqs(struct mmc_host *host);
429
Linus Walleij99fc5132010-09-29 01:08:27 -0400430#ifdef CONFIG_REGULATOR
David Brownell5c139412009-03-11 03:30:43 -0800431int mmc_regulator_get_ocrmask(struct regulator *supply);
Linus Walleij99fc5132010-09-29 01:08:27 -0400432int mmc_regulator_set_ocr(struct mmc_host *mmc,
433 struct regulator *supply,
434 unsigned short vdd_bit);
Douglas Anderson2086f802015-10-12 14:48:25 +0200435int mmc_regulator_set_vqmmc(struct mmc_host *mmc, struct mmc_ios *ios);
Linus Walleij99fc5132010-09-29 01:08:27 -0400436#else
437static inline int mmc_regulator_get_ocrmask(struct regulator *supply)
438{
439 return 0;
440}
441
442static inline int mmc_regulator_set_ocr(struct mmc_host *mmc,
443 struct regulator *supply,
444 unsigned short vdd_bit)
445{
446 return 0;
447}
Douglas Anderson2086f802015-10-12 14:48:25 +0200448
449static inline int mmc_regulator_set_vqmmc(struct mmc_host *mmc,
450 struct mmc_ios *ios)
451{
452 return -EINVAL;
453}
Linus Walleij99fc5132010-09-29 01:08:27 -0400454#endif
David Brownell5c139412009-03-11 03:30:43 -0800455
Tim Kryger4d1f52f2014-05-06 15:57:01 -0700456int mmc_regulator_get_supply(struct mmc_host *mmc);
457
Matt Fleming71d7d3d2010-09-27 09:42:19 +0100458static inline int mmc_card_is_removable(struct mmc_host *host)
459{
Ulf Hansson2501c912013-10-30 01:00:18 +0100460 return !(host->caps & MMC_CAP_NONREMOVABLE);
Matt Fleming71d7d3d2010-09-27 09:42:19 +0100461}
462
Ohad Ben-Cohena5e94252011-04-05 17:43:20 +0300463static inline int mmc_card_keep_power(struct mmc_host *host)
Ohad Ben-Cohen080bc972010-11-28 07:21:29 +0200464{
465 return host->pm_flags & MMC_PM_KEEP_POWER;
466}
467
Ohad Ben-Cohen6b93d01f2011-04-05 17:43:21 +0300468static inline int mmc_card_wake_sdio_irq(struct mmc_host *host)
469{
470 return host->pm_flags & MMC_PM_WAKE_SDIO_IRQ;
471}
Andrei Warkentind0c97cf2011-05-23 15:06:36 -0500472
473static inline int mmc_host_cmd23(struct mmc_host *host)
474{
475 return host->caps & MMC_CAP_CMD23;
476}
Adrian Hunterf7c56ef2011-09-23 12:48:21 +0300477
478static inline int mmc_boot_partition_access(struct mmc_host *host)
479{
480 return !(host->caps2 & MMC_CAP2_BOOTPART_NOACC);
481}
482
Sujit Reddy Thumma41875e32012-12-04 17:06:19 +0530483static inline int mmc_host_uhs(struct mmc_host *host)
484{
485 return host->caps &
486 (MMC_CAP_UHS_SDR12 | MMC_CAP_UHS_SDR25 |
487 MMC_CAP_UHS_SDR50 | MMC_CAP_UHS_SDR104 |
488 MMC_CAP_UHS_DDR50);
489}
490
Seungwon Jeonce39f9d2013-02-06 17:02:46 +0900491static inline int mmc_host_packed_wr(struct mmc_host *host)
492{
493 return host->caps2 & MMC_CAP2_PACKED_WR;
494}
495
Seungwon Jeoncdc99172014-04-23 17:07:35 +0900496static inline int mmc_card_hs(struct mmc_card *card)
497{
498 return card->host->ios.timing == MMC_TIMING_SD_HS ||
499 card->host->ios.timing == MMC_TIMING_MMC_HS;
500}
501
502static inline int mmc_card_uhs(struct mmc_card *card)
503{
504 return card->host->ios.timing >= MMC_TIMING_UHS_SDR12 &&
505 card->host->ios.timing <= MMC_TIMING_UHS_DDR50;
506}
507
508static inline bool mmc_card_hs200(struct mmc_card *card)
509{
510 return card->host->ios.timing == MMC_TIMING_MMC_HS200;
511}
512
513static inline bool mmc_card_ddr52(struct mmc_card *card)
514{
515 return card->host->ios.timing == MMC_TIMING_MMC_DDR52;
516}
Seungwon Jeon0a5b6432014-04-23 17:14:58 +0900517
518static inline bool mmc_card_hs400(struct mmc_card *card)
519{
520 return card->host->ios.timing == MMC_TIMING_MMC_HS400;
521}
522
Shawn Lin81ac2af2016-05-26 09:56:22 +0800523static inline bool mmc_card_hs400es(struct mmc_card *card)
524{
525 return card->host->ios.enhanced_strobe;
526}
527
Adrian Hunterdfa13eb2015-05-07 13:10:12 +0300528void mmc_retune_timer_stop(struct mmc_host *host);
529
530static inline void mmc_retune_needed(struct mmc_host *host)
531{
532 if (host->can_retune)
533 host->need_retune = 1;
534}
535
536static inline void mmc_retune_recheck(struct mmc_host *host)
537{
538 if (host->hold_retune <= 1)
539 host->retune_now = 1;
540}
541
Adrian Hunter7ff27602016-05-16 15:35:24 +0300542void mmc_retune_pause(struct mmc_host *host);
543void mmc_retune_unpause(struct mmc_host *host);
544
Robert P. J. Day100e9182011-05-27 16:04:03 -0400545#endif /* LINUX_MMC_HOST_H */