xref: /linux/drivers/mmc/core/mmc_ops.h (revision 3ea5eb68b9d624935108b5e696859304edfac202)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  *  linux/drivers/mmc/core/mmc_ops.h
4  *
5  *  Copyright 2006-2007 Pierre Ossman
6  */
7 
8 #ifndef _MMC_MMC_OPS_H
9 #define _MMC_MMC_OPS_H
10 
11 #include <linux/types.h>
12 
13 enum mmc_busy_cmd {
14 	MMC_BUSY_CMD6,
15 	MMC_BUSY_ERASE,
16 	MMC_BUSY_HPI,
17 	MMC_BUSY_EXTR_SINGLE,
18 	MMC_BUSY_IO,
19 };
20 
21 struct mmc_host;
22 struct mmc_card;
23 struct mmc_command;
24 
25 int mmc_select_card(struct mmc_card *card);
26 int mmc_deselect_cards(struct mmc_host *host);
27 int mmc_set_dsr(struct mmc_host *host);
28 int mmc_go_idle(struct mmc_host *host);
29 int mmc_send_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr);
30 int mmc_set_relative_addr(struct mmc_card *card);
31 int mmc_send_adtc_data(struct mmc_card *card, struct mmc_host *host, u32 opcode,
32 		       u32 args, void *buf, unsigned len);
33 int mmc_send_csd(struct mmc_card *card, u32 *csd);
34 int __mmc_send_status(struct mmc_card *card, u32 *status, unsigned int retries);
35 int mmc_send_cid(struct mmc_host *host, u32 *cid);
36 int mmc_spi_read_ocr(struct mmc_host *host, int highcap, u32 *ocrp);
37 int mmc_spi_set_crc(struct mmc_host *host, int use_crc);
38 int mmc_bus_test(struct mmc_card *card, u8 bus_width);
39 int mmc_can_ext_csd(struct mmc_card *card);
40 int mmc_switch_status(struct mmc_card *card, bool crc_err_fatal);
41 bool mmc_prepare_busy_cmd(struct mmc_host *host, struct mmc_command *cmd,
42 			  unsigned int timeout_ms);
43 int __mmc_poll_for_busy(struct mmc_host *host, unsigned int period_us,
44 			unsigned int timeout_ms,
45 			int (*busy_cb)(void *cb_data, bool *busy),
46 			void *cb_data);
47 int mmc_poll_for_busy(struct mmc_card *card, unsigned int timeout_ms,
48 		      bool retry_crc_err, enum mmc_busy_cmd busy_cmd);
49 int __mmc_switch(struct mmc_card *card, u8 set, u8 index, u8 value,
50 		unsigned int timeout_ms, unsigned char timing,
51 		bool send_status, bool retry_crc_err, unsigned int retries);
52 int mmc_switch(struct mmc_card *card, u8 set, u8 index, u8 value,
53 		unsigned int timeout_ms);
54 void mmc_run_bkops(struct mmc_card *card);
55 int mmc_cmdq_enable(struct mmc_card *card);
56 int mmc_cmdq_disable(struct mmc_card *card);
57 int mmc_sanitize(struct mmc_card *card, unsigned int timeout_ms);
58 
59 static inline u32 unstuff_bits(const u32 *resp, int start, int size)
60 {
61 	const int __size = size;
62 	const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1;
63 	const int __off = 3 - (start / 32);
64 	const int __shft = start & 31;
65 	u32 __res = resp[__off] >> __shft;
66 
67 	if (__size + __shft > 32)
68 		__res |= resp[__off - 1] << ((32 - __shft) % 32);
69 
70 	return __res & __mask;
71 }
72 
73 #endif
74 
75