Commit | Line | Data |
---|---|---|
d2912cb1 | 1 | /* SPDX-License-Identifier: GPL-2.0-only */ |
1da177e4 | 2 | /* |
aaac1b47 | 3 | * linux/drivers/mmc/core/core.h |
1da177e4 LT |
4 | * |
5 | * Copyright (C) 2003 Russell King, All Rights Reserved. | |
da7fbe58 | 6 | * Copyright 2007 Pierre Ossman |
1da177e4 | 7 | */ |
da7fbe58 PO |
8 | #ifndef _MMC_CORE_CORE_H |
9 | #define _MMC_CORE_CORE_H | |
00b137cf | 10 | |
da7fbe58 | 11 | #include <linux/delay.h> |
066185d6 UH |
12 | #include <linux/sched.h> |
13 | ||
14 | struct mmc_host; | |
15 | struct mmc_card; | |
55244c56 | 16 | struct mmc_request; |
da7fbe58 PO |
17 | |
18 | #define MMC_CMD_RETRIES 3 | |
19 | ||
7ea239d9 PO |
20 | struct mmc_bus_ops { |
21 | void (*remove)(struct mmc_host *); | |
22 | void (*detect)(struct mmc_host *); | |
810caddb | 23 | int (*pre_suspend)(struct mmc_host *); |
95cdfb72 NP |
24 | int (*suspend)(struct mmc_host *); |
25 | int (*resume)(struct mmc_host *); | |
12d01d0b UH |
26 | int (*runtime_suspend)(struct mmc_host *); |
27 | int (*runtime_resume)(struct mmc_host *); | |
d3049504 | 28 | int (*alive)(struct mmc_host *); |
6b086bde | 29 | int (*shutdown)(struct mmc_host *); |
3a3db603 | 30 | int (*hw_reset)(struct mmc_host *); |
1433269c | 31 | int (*sw_reset)(struct mmc_host *); |
97fce126 | 32 | bool (*cache_enabled)(struct mmc_host *); |
8ae11ede | 33 | int (*flush_cache)(struct mmc_host *); |
7ea239d9 PO |
34 | }; |
35 | ||
36 | void mmc_attach_bus(struct mmc_host *host, const struct mmc_bus_ops *ops); | |
37 | void mmc_detach_bus(struct mmc_host *host); | |
38 | ||
25185f3f SH |
39 | struct device_node *mmc_of_find_child_device(struct mmc_host *host, |
40 | unsigned func_num); | |
41 | ||
dfe86cba AH |
42 | void mmc_init_erase(struct mmc_card *card); |
43 | ||
da7fbe58 | 44 | void mmc_set_chip_select(struct mmc_host *host, int mode); |
7ea239d9 PO |
45 | void mmc_set_clock(struct mmc_host *host, unsigned int hz); |
46 | void mmc_set_bus_mode(struct mmc_host *host, unsigned int mode); | |
47 | void mmc_set_bus_width(struct mmc_host *host, unsigned int width); | |
48 | u32 mmc_select_voltage(struct mmc_host *host, u32 ocr); | |
2ed573b6 | 49 | int mmc_set_uhs_voltage(struct mmc_host *host, u32 ocr); |
3f496afb | 50 | int mmc_host_set_uhs_voltage(struct mmc_host *host); |
4e74b6b3 | 51 | int mmc_set_signal_voltage(struct mmc_host *host, int signal_voltage); |
508c9864 | 52 | void mmc_set_initial_signal_voltage(struct mmc_host *host); |
7ea239d9 | 53 | void mmc_set_timing(struct mmc_host *host, unsigned int timing); |
d6d50a15 | 54 | void mmc_set_driver_type(struct mmc_host *host, unsigned int drv_type); |
e23350b3 AH |
55 | int mmc_select_drive_strength(struct mmc_card *card, unsigned int max_dtr, |
56 | int card_drv_type, int *drv_type); | |
4a065193 | 57 | void mmc_power_up(struct mmc_host *host, u32 ocr); |
7f7e4129 | 58 | void mmc_power_off(struct mmc_host *host); |
4a065193 | 59 | void mmc_power_cycle(struct mmc_host *host, u32 ocr); |
2d079c43 | 60 | void mmc_set_initial_state(struct mmc_host *host); |
de13d5a4 | 61 | u32 mmc_vddrange_to_ocrmask(int vdd_min, int vdd_max); |
7ea239d9 | 62 | |
da7fbe58 PO |
63 | static inline void mmc_delay(unsigned int ms) |
64 | { | |
96455380 WS |
65 | if (ms <= 20) |
66 | usleep_range(ms * 1000, ms * 1250); | |
67 | else | |
da7fbe58 | 68 | msleep(ms); |
da7fbe58 | 69 | } |
7104e2d5 | 70 | |
b93931a6 PO |
71 | void mmc_rescan(struct work_struct *work); |
72 | void mmc_start_host(struct mmc_host *host); | |
66c915d0 | 73 | void __mmc_stop_host(struct mmc_host *host); |
b93931a6 PO |
74 | void mmc_stop_host(struct mmc_host *host); |
75 | ||
2ac55d5e UH |
76 | void _mmc_detect_change(struct mmc_host *host, unsigned long delay, |
77 | bool cd_irq); | |
d3049504 | 78 | int _mmc_detect_card_removed(struct mmc_host *host); |
55244c56 | 79 | int mmc_detect_card_removed(struct mmc_host *host); |
d3049504 | 80 | |
807e8e40 AR |
81 | int mmc_attach_mmc(struct mmc_host *host); |
82 | int mmc_attach_sd(struct mmc_host *host); | |
83 | int mmc_attach_sdio(struct mmc_host *host); | |
98b843be | 84 | |
bd68e083 | 85 | /* Module parameters */ |
90ab5ee9 | 86 | extern bool use_spi_crc; |
af517150 | 87 | |
6edd8ee6 | 88 | /* Debugfs information for hosts and cards */ |
5c5301a1 | 89 | #ifdef CONFIG_DEBUG_FS |
6edd8ee6 HS |
90 | void mmc_add_host_debugfs(struct mmc_host *host); |
91 | void mmc_remove_host_debugfs(struct mmc_host *host); | |
92 | ||
f4b7f927 HS |
93 | void mmc_add_card_debugfs(struct mmc_card *card); |
94 | void mmc_remove_card_debugfs(struct mmc_card *card); | |
5c5301a1 YB |
95 | #else |
96 | static inline void mmc_add_host_debugfs(struct mmc_host *host) | |
97 | { | |
98 | } | |
99 | static inline void mmc_remove_host_debugfs(struct mmc_host *host) | |
100 | { | |
101 | } | |
102 | static inline void mmc_add_card_debugfs(struct mmc_card *card) | |
103 | { | |
104 | } | |
105 | static inline void mmc_remove_card_debugfs(struct mmc_card *card) | |
106 | { | |
107 | } | |
108 | #endif | |
f4b7f927 | 109 | |
63e415c6 | 110 | int mmc_execute_tuning(struct mmc_card *card); |
6376f69d AH |
111 | int mmc_hs200_to_hs400(struct mmc_card *card); |
112 | int mmc_hs400_to_hs200(struct mmc_card *card); | |
63e415c6 | 113 | |
55244c56 UH |
114 | void mmc_wait_for_req_done(struct mmc_host *host, struct mmc_request *mrq); |
115 | bool mmc_is_req_done(struct mmc_host *host, struct mmc_request *mrq); | |
116 | ||
cb39f61e AH |
117 | int mmc_start_request(struct mmc_host *host, struct mmc_request *mrq); |
118 | ||
55244c56 UH |
119 | int mmc_erase(struct mmc_card *card, unsigned int from, unsigned int nr, |
120 | unsigned int arg); | |
121 | int mmc_can_erase(struct mmc_card *card); | |
122 | int mmc_can_trim(struct mmc_card *card); | |
123 | int mmc_can_discard(struct mmc_card *card); | |
124 | int mmc_can_sanitize(struct mmc_card *card); | |
125 | int mmc_can_secure_erase_trim(struct mmc_card *card); | |
126 | int mmc_erase_group_aligned(struct mmc_card *card, unsigned int from, | |
127 | unsigned int nr); | |
128 | unsigned int mmc_calc_max_discard(struct mmc_card *card); | |
129 | ||
130 | int mmc_set_blocklen(struct mmc_card *card, unsigned int blocklen); | |
55244c56 | 131 | |
6c0cedd1 AH |
132 | int __mmc_claim_host(struct mmc_host *host, struct mmc_ctx *ctx, |
133 | atomic_t *abort); | |
55244c56 | 134 | void mmc_release_host(struct mmc_host *host); |
6c0cedd1 AH |
135 | void mmc_get_card(struct mmc_card *card, struct mmc_ctx *ctx); |
136 | void mmc_put_card(struct mmc_card *card, struct mmc_ctx *ctx); | |
55244c56 | 137 | |
dc913385 DO |
138 | int mmc_card_alternative_gpt_sector(struct mmc_card *card, sector_t *sector); |
139 | ||
55244c56 UH |
140 | /** |
141 | * mmc_claim_host - exclusively claim a host | |
142 | * @host: mmc host to claim | |
143 | * | |
144 | * Claim a host for a set of operations. | |
145 | */ | |
146 | static inline void mmc_claim_host(struct mmc_host *host) | |
147 | { | |
6c0cedd1 | 148 | __mmc_claim_host(host, NULL, NULL); |
55244c56 | 149 | } |
da7fbe58 | 150 | |
72a5af55 AH |
151 | int mmc_cqe_start_req(struct mmc_host *host, struct mmc_request *mrq); |
152 | void mmc_cqe_post_req(struct mmc_host *host, struct mmc_request *mrq); | |
153 | int mmc_cqe_recovery(struct mmc_host *host); | |
154 | ||
afab1bb8 AH |
155 | /** |
156 | * mmc_pre_req - Prepare for a new request | |
157 | * @host: MMC host to prepare command | |
158 | * @mrq: MMC request to prepare for | |
159 | * | |
160 | * mmc_pre_req() is called in prior to mmc_start_req() to let | |
161 | * host prepare for the new request. Preparation of a request may be | |
162 | * performed while another request is running on the host. | |
163 | */ | |
164 | static inline void mmc_pre_req(struct mmc_host *host, struct mmc_request *mrq) | |
165 | { | |
166 | if (host->ops->pre_req) | |
167 | host->ops->pre_req(host, mrq); | |
168 | } | |
169 | ||
170 | /** | |
171 | * mmc_post_req - Post process a completed request | |
172 | * @host: MMC host to post process command | |
173 | * @mrq: MMC request to post process for | |
174 | * @err: Error, if non zero, clean up any resources made in pre_req | |
175 | * | |
176 | * Let the host post process a completed request. Post processing of | |
177 | * a request may be performed while another request is running. | |
178 | */ | |
179 | static inline void mmc_post_req(struct mmc_host *host, struct mmc_request *mrq, | |
180 | int err) | |
181 | { | |
182 | if (host->ops->post_req) | |
183 | host->ops->post_req(host, mrq, err); | |
184 | } | |
185 | ||
97fce126 AA |
186 | static inline bool mmc_cache_enabled(struct mmc_host *host) |
187 | { | |
188 | if (host->bus_ops->cache_enabled) | |
189 | return host->bus_ops->cache_enabled(host); | |
190 | ||
191 | return false; | |
192 | } | |
193 | ||
8ae11ede UH |
194 | static inline int mmc_flush_cache(struct mmc_host *host) |
195 | { | |
196 | if (host->bus_ops->flush_cache) | |
197 | return host->bus_ops->flush_cache(host); | |
198 | ||
199 | return 0; | |
200 | } | |
201 | ||
55244c56 | 202 | #endif |