/* SPDX-License-Identifier: GPL-2.0-only */ /* Copyright (c) 2015, The Linux Foundation. All rights reserved. */ #ifndef LINUX_MMC_CQHCI_H #define LINUX_MMC_CQHCI_H #include #include #include #include #include #include #include #include /* registers */ /* version */ #define CQHCI_VER 0x00 #define CQHCI_VER_MAJOR(x) (((x) & GENMASK(11, 8)) >> 8) #define CQHCI_VER_MINOR1(x) (((x) & GENMASK(7, 4)) >> 4) #define CQHCI_VER_MINOR2(x) ((x) & GENMASK(3, 0)) /* capabilities */ #define CQHCI_CAP 0x04 #define CQHCI_CAP_CS 0x10000000 /* Crypto Support */ /* configuration */ #define CQHCI_CFG 0x08 #define CQHCI_DCMD 0x00001000 #define CQHCI_TASK_DESC_SZ 0x00000100 #define CQHCI_CRYPTO_GENERAL_ENABLE 0x00000002 #define CQHCI_ENABLE 0x00000001 /* control */ #define CQHCI_CTL 0x0C #define CQHCI_CLEAR_ALL_TASKS 0x00000100 #define CQHCI_HALT 0x00000001 /* interrupt status */ #define CQHCI_IS 0x10 #define CQHCI_IS_HAC BIT(0) #define CQHCI_IS_TCC BIT(1) #define CQHCI_IS_RED BIT(2) #define CQHCI_IS_TCL BIT(3) #define CQHCI_IS_GCE BIT(4) /* General Crypto Error */ #define CQHCI_IS_ICCE BIT(5) /* Invalid Crypto Config Error */ #define CQHCI_IS_MASK (CQHCI_IS_TCC | CQHCI_IS_RED | \ CQHCI_IS_GCE | CQHCI_IS_ICCE) /* interrupt status enable */ #define CQHCI_ISTE 0x14 /* interrupt signal enable */ #define CQHCI_ISGE 0x18 /* interrupt coalescing */ #define CQHCI_IC 0x1C #define CQHCI_IC_ENABLE BIT(31) #define CQHCI_IC_RESET BIT(16) #define CQHCI_IC_ICCTHWEN BIT(15) #define CQHCI_IC_ICCTH(x) (((x) & 0x1F) << 8) #define CQHCI_IC_ICTOVALWEN BIT(7) #define CQHCI_IC_ICTOVAL(x) ((x) & 0x7F) /* task list base address */ #define CQHCI_TDLBA 0x20 /* task list base address upper */ #define CQHCI_TDLBAU 0x24 /* door-bell */ #define CQHCI_TDBR 0x28 /* task completion notification */ #define CQHCI_TCN 0x2C /* device queue status */ #define CQHCI_DQS 0x30 /* device pending tasks */ #define CQHCI_DPT 0x34 /* task clear */ #define CQHCI_TCLR 0x38 /* task descriptor processing error */ #define CQHCI_TDPE 0x3c /* send status config 1 */ #define CQHCI_SSC1 0x40 #define CQHCI_SSC1_CBC_MASK GENMASK(19, 16) /* send status config 2 */ #define CQHCI_SSC2 0x44 /* response for dcmd */ #define CQHCI_CRDCT 0x48 /* response mode error mask */ #define CQHCI_RMEM 0x50 /* task error info */ #define CQHCI_TERRI 0x54 #define CQHCI_TERRI_C_INDEX(x) ((x) & GENMASK(5, 0)) #define CQHCI_TERRI_C_TASK(x) (((x) & GENMASK(12, 8)) >> 8) #define CQHCI_TERRI_C_VALID(x) ((x) & BIT(15)) #define CQHCI_TERRI_D_INDEX(x) (((x) & GENMASK(21, 16)) >> 16) #define CQHCI_TERRI_D_TASK(x) (((x) & GENMASK(28, 24)) >> 24) #define CQHCI_TERRI_D_VALID(x) ((x) & BIT(31)) /* command response index */ #define CQHCI_CRI 0x58 /* command response argument */ #define CQHCI_CRA 0x5C /* crypto capabilities */ #define CQHCI_CCAP 0x100 #define CQHCI_CRYPTOCAP 0x104 #define CQHCI_INT_ALL 0xF #define CQHCI_IC_DEFAULT_ICCTH 31 #define CQHCI_IC_DEFAULT_ICTOVAL 1 /* attribute fields */ #define CQHCI_VALID(x) (((x) & 1) << 0) #define CQHCI_END(x) (((x) & 1) << 1) #define CQHCI_INT(x) (((x) & 1) << 2) #define CQHCI_ACT(x) (((x) & 0x7) << 3) /* data command task descriptor fields */ #define CQHCI_FORCED_PROG(x) (((x) & 1) << 6) #define CQHCI_CONTEXT(x) (((x) & 0xF) << 7) #define CQHCI_DATA_TAG(x) (((x) & 1) << 11) #define CQHCI_DATA_DIR(x) (((x) & 1) << 12) #define CQHCI_PRIORITY(x) (((x) & 1) << 13) #define CQHCI_QBAR(x) (((x) & 1) << 14) #define CQHCI_REL_WRITE(x) (((x) & 1) << 15) #define CQHCI_BLK_COUNT(x) (((x) & 0xFFFF) << 16) #define CQHCI_BLK_ADDR(x) (((x) & 0xFFFFFFFF) << 32) /* direct command task descriptor fields */ #define CQHCI_CMD_INDEX(x) (((x) & 0x3F) << 16) #define CQHCI_CMD_TIMING(x) (((x) & 1) << 22) #define CQHCI_RESP_TYPE(x) (((x) & 0x3) << 23) /* crypto task descriptor fields (for bits 64-127 of task descriptor) */ #define CQHCI_CRYPTO_ENABLE_BIT (1ULL << 47) #define CQHCI_CRYPTO_KEYSLOT(x) ((u64)(x) << 32) /* transfer descriptor fields */ #define CQHCI_DAT_LENGTH(x) (((x) & 0xFFFF) << 16) #define CQHCI_DAT_ADDR_LO(x) (((x) & 0xFFFFFFFF) << 32) #define CQHCI_DAT_ADDR_HI(x) (((x) & 0xFFFFFFFF) << 0) /* CCAP - Crypto Capability 100h */ union cqhci_crypto_capabilities { __le32 reg_val; struct { u8 num_crypto_cap; u8 config_count; u8 reserved; u8 config_array_ptr; }; }; enum cqhci_crypto_key_size { CQHCI_CRYPTO_KEY_SIZE_INVALID = 0, CQHCI_CRYPTO_KEY_SIZE_128 = 1, CQHCI_CRYPTO_KEY_SIZE_192 = 2, CQHCI_CRYPTO_KEY_SIZE_256 = 3, CQHCI_CRYPTO_KEY_SIZE_512 = 4, }; enum cqhci_crypto_alg { CQHCI_CRYPTO_ALG_AES_XTS = 0, CQHCI_CRYPTO_ALG_BITLOCKER_AES_CBC = 1, CQHCI_CRYPTO_ALG_AES_ECB = 2, CQHCI_CRYPTO_ALG_ESSIV_AES_CBC = 3, }; /* x-CRYPTOCAP - Crypto Capability X */ union cqhci_crypto_cap_entry { __le32 reg_val; struct { u8 algorithm_id; u8 sdus_mask; /* Supported data unit size mask */ u8 key_size; u8 reserved; }; }; #define CQHCI_CRYPTO_CONFIGURATION_ENABLE (1 << 7) #define CQHCI_CRYPTO_KEY_MAX_SIZE 64 /* x-CRYPTOCFG - Crypto Configuration X */ union cqhci_crypto_cfg_entry { __le32 reg_val[32]; struct { u8 crypto_key[CQHCI_CRYPTO_KEY_MAX_SIZE]; u8 data_unit_size; u8 crypto_cap_idx; u8 reserved_1; u8 config_enable; u8 reserved_multi_host; u8 reserved_2; u8 vsb[2]; u8 reserved_3[56]; }; }; struct cqhci_host_ops; struct mmc_host; struct mmc_request; struct cqhci_slot; struct cqhci_host { const struct cqhci_host_ops *ops; void __iomem *mmio; struct mmc_host *mmc; spinlock_t lock; /* relative card address of device */ unsigned int rca; /* 64 bit DMA */ bool dma64; int num_slots; int qcnt; u32 dcmd_slot; u32 caps; #define CQHCI_TASK_DESC_SZ_128 0x1 u32 quirks; #define CQHCI_QUIRK_SHORT_TXFR_DESC_SZ 0x1 bool enabled; bool halted; bool init_done; bool activated; bool waiting_for_idle; bool recovery_halt; size_t desc_size; size_t data_size; u8 *desc_base; /* total descriptor size */ u8 slot_sz; /* 64/128 bit depends on CQHCI_CFG */ u8 task_desc_len; /* 64 bit on 32-bit arch, 128 bit on 64-bit */ u8 link_desc_len; u8 *trans_desc_base; /* same length as transfer descriptor */ u8 trans_desc_len; dma_addr_t desc_dma_base; dma_addr_t trans_desc_dma_base; struct completion halt_comp; wait_queue_head_t wait_queue; struct cqhci_slot *slot; #ifdef CONFIG_MMC_CRYPTO union cqhci_crypto_capabilities crypto_capabilities; union cqhci_crypto_cap_entry *crypto_cap_array; u32 crypto_cfg_register; #endif }; struct cqhci_host_ops { void (*dumpregs)(struct mmc_host *mmc); void (*write_l)(struct cqhci_host *host, u32 val, int reg); u32 (*read_l)(struct cqhci_host *host, int reg); void (*enable)(struct mmc_host *mmc); void (*disable)(struct mmc_host *mmc, bool recovery); void (*update_dcmd_desc)(struct mmc_host *mmc, struct mmc_request *mrq, u64 *data); void (*pre_enable)(struct mmc_host *mmc); void (*post_disable)(struct mmc_host *mmc); #ifdef CONFIG_MMC_CRYPTO int (*program_key)(struct cqhci_host *cq_host, const union cqhci_crypto_cfg_entry *cfg, int slot); #endif }; static inline void cqhci_writel(struct cqhci_host *host, u32 val, int reg) { if (unlikely(host->ops->write_l)) host->ops->write_l(host, val, reg); else writel_relaxed(val, host->mmio + reg); } static inline u32 cqhci_readl(struct cqhci_host *host, int reg) { if (unlikely(host->ops->read_l)) return host->ops->read_l(host, reg); else return readl_relaxed(host->mmio + reg); } struct platform_device; irqreturn_t cqhci_irq(struct mmc_host *mmc, u32 intmask, int cmd_error, int data_error); int cqhci_init(struct cqhci_host *cq_host, struct mmc_host *mmc, bool dma64); struct cqhci_host *cqhci_pltfm_init(struct platform_device *pdev); int cqhci_deactivate(struct mmc_host *mmc); static inline int cqhci_suspend(struct mmc_host *mmc) { return cqhci_deactivate(mmc); } int cqhci_resume(struct mmc_host *mmc); #endif