Something went wrong. Try again.
Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189/* SPDX-License-Identifier: GPL-2.0-only *//* * linux/include/linux/mmc/core.h */#ifndef LINUX_MMC_CORE_H#define LINUX_MMC_CORE_H
#include <linux/completion.h>#include <linux/types.h>
struct mmc_data;struct mmc_request;
#define UHS2_MAX_PAYLOAD_LEN 2#define UHS2_MAX_RESP_LEN 20
struct uhs2_command { u16 header; u16 arg; __be32 payload[UHS2_MAX_PAYLOAD_LEN]; u8 payload_len; u8 packet_len; u8 tmode_half_duplex; u8 uhs2_resp[UHS2_MAX_RESP_LEN]; /* UHS2 native cmd resp */ u8 uhs2_resp_len; /* UHS2 native cmd resp len */};
struct mmc_command { u32 opcode; u32 arg;#define MMC_CMD23_ARG_REL_WR (1 << 31)#define MMC_CMD23_ARG_TAG_REQ (1 << 29) u32 resp[4]; unsigned int flags; /* expected response type */#define MMC_RSP_PRESENT (1 << 0)#define MMC_RSP_136 (1 << 1) /* 136 bit response */#define MMC_RSP_CRC (1 << 2) /* expect valid crc */#define MMC_RSP_BUSY (1 << 3) /* card may send busy */#define MMC_RSP_OPCODE (1 << 4) /* response contains opcode */
#define MMC_CMD_MASK (3 << 5) /* non-SPI command type */#define MMC_CMD_AC (0 << 5)#define MMC_CMD_ADTC (1 << 5)#define MMC_CMD_BC (2 << 5)#define MMC_CMD_BCR (3 << 5)
#define MMC_RSP_SPI_S1 (1 << 7) /* one status byte */#define MMC_RSP_SPI_S2 (1 << 8) /* second byte */#define MMC_RSP_SPI_B4 (1 << 9) /* four data bytes */#define MMC_RSP_SPI_BUSY (1 << 10) /* card may send busy */
/* * These are the native response types, and correspond to valid bit * patterns of the above flags. One additional valid pattern * is all zeros, which means we don't expect a response. */#define MMC_RSP_NONE (0)#define MMC_RSP_R1 (MMC_RSP_PRESENT|MMC_RSP_CRC|MMC_RSP_OPCODE)#define MMC_RSP_R1B (MMC_RSP_PRESENT|MMC_RSP_CRC|MMC_RSP_OPCODE|MMC_RSP_BUSY)#define MMC_RSP_R1B_NO_CRC (MMC_RSP_PRESENT|MMC_RSP_OPCODE|MMC_RSP_BUSY)#define MMC_RSP_R2 (MMC_RSP_PRESENT|MMC_RSP_136|MMC_RSP_CRC)#define MMC_RSP_R3 (MMC_RSP_PRESENT)#define MMC_RSP_R4 (MMC_RSP_PRESENT)#define MMC_RSP_R5 (MMC_RSP_PRESENT|MMC_RSP_CRC|MMC_RSP_OPCODE)#define MMC_RSP_R6 (MMC_RSP_PRESENT|MMC_RSP_CRC|MMC_RSP_OPCODE)#define MMC_RSP_R7 (MMC_RSP_PRESENT|MMC_RSP_CRC|MMC_RSP_OPCODE)
#define mmc_resp_type(cmd) ((cmd)->flags & (MMC_RSP_PRESENT|MMC_RSP_136|MMC_RSP_CRC|MMC_RSP_BUSY|MMC_RSP_OPCODE))
/* * These are the SPI response types for MMC, SD, and SDIO cards. * Commands return R1, with maybe more info. Zero is an error type; * callers must always provide the appropriate MMC_RSP_SPI_Rx flags. */#define MMC_RSP_SPI_R1 (MMC_RSP_SPI_S1)#define MMC_RSP_SPI_R1B (MMC_RSP_SPI_S1|MMC_RSP_SPI_BUSY)#define MMC_RSP_SPI_R2 (MMC_RSP_SPI_S1|MMC_RSP_SPI_S2)#define MMC_RSP_SPI_R3 (MMC_RSP_SPI_S1|MMC_RSP_SPI_B4)#define MMC_RSP_SPI_R4 (MMC_RSP_SPI_S1|MMC_RSP_SPI_B4)#define MMC_RSP_SPI_R5 (MMC_RSP_SPI_S1|MMC_RSP_SPI_S2)#define MMC_RSP_SPI_R7 (MMC_RSP_SPI_S1|MMC_RSP_SPI_B4)
#define mmc_spi_resp_type(cmd) ((cmd)->flags & \ (MMC_RSP_SPI_S1|MMC_RSP_SPI_BUSY|MMC_RSP_SPI_S2|MMC_RSP_SPI_B4))
/* * These are the command types. */#define mmc_cmd_type(cmd) ((cmd)->flags & MMC_CMD_MASK)
unsigned int retries; /* max number of retries */ int error; /* command error */
/* * Standard errno values are used for errors, but some have specific * meaning in the MMC layer: * * ETIMEDOUT Card took too long to respond * EILSEQ Basic format problem with the received or sent data * (e.g. CRC check failed, incorrect opcode in response * or bad end bit) * EINVAL Request cannot be performed because of restrictions * in hardware and/or the driver * ENOMEDIUM Host can determine that the slot is empty and is * actively failing requests */
unsigned int busy_timeout; /* busy detect timeout in ms */ struct mmc_data *data; /* data segment associated with cmd */ struct mmc_request *mrq; /* associated request */
struct uhs2_command *uhs2_cmd; /* UHS2 command */
/* for SDUC */ bool has_ext_addr; u8 ext_addr;};
struct mmc_data { unsigned int timeout_ns; /* data timeout (in ns, max 80ms) */ unsigned int timeout_clks; /* data timeout (in clocks) */ unsigned int blksz; /* data block size */ unsigned int blocks; /* number of blocks */ unsigned int blk_addr; /* block address */ int error; /* data error */ unsigned int flags;
#define MMC_DATA_WRITE BIT(8)#define MMC_DATA_READ BIT(9)/* Extra flags used by CQE */#define MMC_DATA_QBR BIT(10) /* CQE queue barrier*/#define MMC_DATA_PRIO BIT(11) /* CQE high priority */#define MMC_DATA_REL_WR BIT(12) /* Reliable write */#define MMC_DATA_DAT_TAG BIT(13) /* Tag request */#define MMC_DATA_FORCED_PRG BIT(14) /* Forced programming */
unsigned int bytes_xfered;
struct mmc_command *stop; /* stop command */ struct mmc_request *mrq; /* associated request */
unsigned int sg_len; /* size of scatter list */ int sg_count; /* mapped sg entries */ struct scatterlist *sg; /* I/O scatter list */ s32 host_cookie; /* host private data */};
struct mmc_host;struct mmc_request { struct mmc_command *sbc; /* SET_BLOCK_COUNT for multiblock */ struct mmc_command *cmd; struct mmc_data *data; struct mmc_command *stop;
struct completion completion; struct completion cmd_completion; void (*done)(struct mmc_request *);/* completion function */ /* * Notify uppers layers (e.g. mmc block driver) that recovery is needed * due to an error associated with the mmc_request. Currently used only * by CQE. */ void (*recovery_notifier)(struct mmc_request *); struct mmc_host *host;
/* Allow other commands during this ongoing data transfer or busy wait */ bool cap_cmd_during_tfr;
int tag;
#ifdef CONFIG_MMC_CRYPTO const struct bio_crypt_ctx *crypto_ctx; int crypto_key_slot;#endif struct uhs2_command uhs2_cmd;};
struct mmc_card;
void mmc_wait_for_req(struct mmc_host *host, struct mmc_request *mrq);int mmc_wait_for_cmd(struct mmc_host *host, struct mmc_command *cmd, int retries);
int mmc_hw_reset(struct mmc_card *card);int mmc_sw_reset(struct mmc_card *card);void mmc_set_data_timeout(struct mmc_data *data, const struct mmc_card *card);
#endif /* LINUX_MMC_CORE_H */