xref: /linux/drivers/mmc/core/mmc_ops.h (revision 7f71507851fc7764b36a3221839607d3a45c2025)
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_go_idle(struct mmc_host *host);
30 int mmc_send_op_cond(struct mmc_host *host, u32 ocr, u32 *rocr);
31 int mmc_set_relative_addr(struct mmc_card *card);
32 int mmc_send_adtc_data(struct mmc_card *card, struct mmc_host *host, u32 opcode,
33 		       u32 args, void *buf, unsigned len);
34 int mmc_send_csd(struct mmc_card *card, u32 *csd);
35 int __mmc_send_status(struct mmc_card *card, u32 *status, unsigned int retries);
36 int mmc_send_cid(struct mmc_host *host, u32 *cid);
37 int mmc_spi_read_ocr(struct mmc_host *host, int highcap, u32 *ocrp);
38 int mmc_spi_set_crc(struct mmc_host *host, int use_crc);
39 int mmc_bus_test(struct mmc_card *card, u8 bus_width);
40 int mmc_can_ext_csd(struct mmc_card *card);
41 int mmc_switch_status(struct mmc_card *card, bool crc_err_fatal);
42 bool mmc_prepare_busy_cmd(struct mmc_host *host, struct mmc_command *cmd,
43 			  unsigned int timeout_ms);
44 int __mmc_poll_for_busy(struct mmc_host *host, unsigned int period_us,
45 			unsigned int timeout_ms,
46 			int (*busy_cb)(void *cb_data, bool *busy),
47 			void *cb_data);
48 int mmc_poll_for_busy(struct mmc_card *card, unsigned int timeout_ms,
49 		      bool retry_crc_err, enum mmc_busy_cmd busy_cmd);
50 int __mmc_switch(struct mmc_card *card, u8 set, u8 index, u8 value,
51 		unsigned int timeout_ms, unsigned char timing,
52 		bool send_status, bool retry_crc_err, unsigned int retries);
53 int mmc_switch(struct mmc_card *card, u8 set, u8 index, u8 value,
54 		unsigned int timeout_ms);
55 void mmc_run_bkops(struct mmc_card *card);
56 int mmc_cmdq_enable(struct mmc_card *card);
57 int mmc_cmdq_disable(struct mmc_card *card);
58 int mmc_sanitize(struct mmc_card *card, unsigned int timeout_ms);
59 
60 static inline u32 unstuff_bits(const u32 *resp, int start, int size)
61 {
62 	const int __size = size;
63 	const u32 __mask = (__size < 32 ? 1 << __size : 0) - 1;
64 	const int __off = 3 - (start / 32);
65 	const int __shft = start & 31;
66 	u32 __res = resp[__off] >> __shft;
67 
68 	if (__size + __shft > 32)
69 		__res |= resp[__off - 1] << ((32 - __shft) % 32);
70 
71 	return __res & __mask;
72 }
73 
74 #endif
75 
76