1 /* 2 * linux/include/linux/mmc/card.h 3 * 4 * This program is free software; you can redistribute it and/or modify 5 * it under the terms of the GNU General Public License version 2 as 6 * published by the Free Software Foundation. 7 * 8 * Card driver specific definitions. 9 */ 10 #ifndef LINUX_MMC_CARD_H 11 #define LINUX_MMC_CARD_H 12 13 #include <linux/mmc/core.h> 14 15 struct mmc_cid { 16 unsigned int manfid; 17 char prod_name[8]; 18 unsigned int serial; 19 unsigned short oemid; 20 unsigned short year; 21 unsigned char hwrev; 22 unsigned char fwrev; 23 unsigned char month; 24 }; 25 26 struct mmc_csd { 27 unsigned char structure; 28 unsigned char mmca_vsn; 29 unsigned short cmdclass; 30 unsigned short tacc_clks; 31 unsigned int tacc_ns; 32 unsigned int r2w_factor; 33 unsigned int max_dtr; 34 unsigned int erase_size; /* In sectors */ 35 unsigned int read_blkbits; 36 unsigned int write_blkbits; 37 unsigned int capacity; 38 unsigned int read_partial:1, 39 read_misalign:1, 40 write_partial:1, 41 write_misalign:1; 42 }; 43 44 struct mmc_ext_csd { 45 u8 rev; 46 u8 erase_group_def; 47 u8 sec_feature_support; 48 unsigned int sa_timeout; /* Units: 100ns */ 49 unsigned int hs_max_dtr; 50 unsigned int sectors; 51 unsigned int hc_erase_size; /* In sectors */ 52 unsigned int hc_erase_timeout; /* In milliseconds */ 53 unsigned int sec_trim_mult; /* Secure trim multiplier */ 54 unsigned int sec_erase_mult; /* Secure erase multiplier */ 55 unsigned int trim_timeout; /* In milliseconds */ 56 }; 57 58 struct sd_scr { 59 unsigned char sda_vsn; 60 unsigned char bus_widths; 61 #define SD_SCR_BUS_WIDTH_1 (1<<0) 62 #define SD_SCR_BUS_WIDTH_4 (1<<2) 63 }; 64 65 struct sd_ssr { 66 unsigned int au; /* In sectors */ 67 unsigned int erase_timeout; /* In milliseconds */ 68 unsigned int erase_offset; /* In milliseconds */ 69 }; 70 71 struct sd_switch_caps { 72 unsigned int hs_max_dtr; 73 }; 74 75 struct sdio_cccr { 76 unsigned int sdio_vsn; 77 unsigned int sd_vsn; 78 unsigned int multi_block:1, 79 low_speed:1, 80 wide_bus:1, 81 high_power:1, 82 high_speed:1, 83 disable_cd:1; 84 }; 85 86 struct sdio_cis { 87 unsigned short vendor; 88 unsigned short device; 89 unsigned short blksize; 90 unsigned int max_dtr; 91 }; 92 93 struct mmc_host; 94 struct sdio_func; 95 struct sdio_func_tuple; 96 97 #define SDIO_MAX_FUNCS 7 98 99 /* 100 * MMC device 101 */ 102 struct mmc_card { 103 struct mmc_host *host; /* the host this device belongs to */ 104 struct device dev; /* the device */ 105 unsigned int rca; /* relative card address of device */ 106 unsigned int type; /* card type */ 107 #define MMC_TYPE_MMC 0 /* MMC card */ 108 #define MMC_TYPE_SD 1 /* SD card */ 109 #define MMC_TYPE_SDIO 2 /* SDIO card */ 110 #define MMC_TYPE_SD_COMBO 3 /* SD combo (IO+mem) card */ 111 unsigned int state; /* (our) card state */ 112 #define MMC_STATE_PRESENT (1<<0) /* present in sysfs */ 113 #define MMC_STATE_READONLY (1<<1) /* card is read-only */ 114 #define MMC_STATE_HIGHSPEED (1<<2) /* card is in high speed mode */ 115 #define MMC_STATE_BLOCKADDR (1<<3) /* card uses block-addressing */ 116 unsigned int quirks; /* card quirks */ 117 #define MMC_QUIRK_LENIENT_FN0 (1<<0) /* allow SDIO FN0 writes outside of the VS CCCR range */ 118 #define MMC_QUIRK_BLKSZ_FOR_BYTE_MODE (1<<1) /* use func->cur_blksize */ 119 /* for byte mode */ 120 #define MMC_QUIRK_NONSTD_SDIO (1<<2) /* non-standard SDIO card attached */ 121 /* (missing CIA registers) */ 122 123 unsigned int erase_size; /* erase size in sectors */ 124 unsigned int erase_shift; /* if erase unit is power 2 */ 125 unsigned int pref_erase; /* in sectors */ 126 u8 erased_byte; /* value of erased bytes */ 127 128 u32 raw_cid[4]; /* raw card CID */ 129 u32 raw_csd[4]; /* raw card CSD */ 130 u32 raw_scr[2]; /* raw card SCR */ 131 struct mmc_cid cid; /* card identification */ 132 struct mmc_csd csd; /* card specific */ 133 struct mmc_ext_csd ext_csd; /* mmc v4 extended card specific */ 134 struct sd_scr scr; /* extra SD information */ 135 struct sd_ssr ssr; /* yet more SD information */ 136 struct sd_switch_caps sw_caps; /* switch (CMD6) caps */ 137 138 unsigned int sdio_funcs; /* number of SDIO functions */ 139 struct sdio_cccr cccr; /* common card info */ 140 struct sdio_cis cis; /* common tuple info */ 141 struct sdio_func *sdio_func[SDIO_MAX_FUNCS]; /* SDIO functions (devices) */ 142 unsigned num_info; /* number of info strings */ 143 const char **info; /* info strings */ 144 struct sdio_func_tuple *tuples; /* unknown common tuples */ 145 146 struct dentry *debugfs_root; 147 }; 148 149 #define mmc_card_mmc(c) ((c)->type == MMC_TYPE_MMC) 150 #define mmc_card_sd(c) ((c)->type == MMC_TYPE_SD) 151 #define mmc_card_sdio(c) ((c)->type == MMC_TYPE_SDIO) 152 153 #define mmc_card_present(c) ((c)->state & MMC_STATE_PRESENT) 154 #define mmc_card_readonly(c) ((c)->state & MMC_STATE_READONLY) 155 #define mmc_card_highspeed(c) ((c)->state & MMC_STATE_HIGHSPEED) 156 #define mmc_card_blockaddr(c) ((c)->state & MMC_STATE_BLOCKADDR) 157 158 #define mmc_card_set_present(c) ((c)->state |= MMC_STATE_PRESENT) 159 #define mmc_card_set_readonly(c) ((c)->state |= MMC_STATE_READONLY) 160 #define mmc_card_set_highspeed(c) ((c)->state |= MMC_STATE_HIGHSPEED) 161 #define mmc_card_set_blockaddr(c) ((c)->state |= MMC_STATE_BLOCKADDR) 162 163 static inline int mmc_card_lenient_fn0(const struct mmc_card *c) 164 { 165 return c->quirks & MMC_QUIRK_LENIENT_FN0; 166 } 167 168 static inline int mmc_blksz_for_byte_mode(const struct mmc_card *c) 169 { 170 return c->quirks & MMC_QUIRK_BLKSZ_FOR_BYTE_MODE; 171 } 172 173 #define mmc_card_name(c) ((c)->cid.prod_name) 174 #define mmc_card_id(c) (dev_name(&(c)->dev)) 175 176 #define mmc_list_to_card(l) container_of(l, struct mmc_card, node) 177 #define mmc_get_drvdata(c) dev_get_drvdata(&(c)->dev) 178 #define mmc_set_drvdata(c,d) dev_set_drvdata(&(c)->dev, d) 179 180 /* 181 * MMC device driver (e.g., Flash card, I/O card...) 182 */ 183 struct mmc_driver { 184 struct device_driver drv; 185 int (*probe)(struct mmc_card *); 186 void (*remove)(struct mmc_card *); 187 int (*suspend)(struct mmc_card *, pm_message_t); 188 int (*resume)(struct mmc_card *); 189 }; 190 191 extern int mmc_register_driver(struct mmc_driver *); 192 extern void mmc_unregister_driver(struct mmc_driver *); 193 194 #endif 195