1 /* 2 * Private header for the mmc subsystem 3 * 4 * Copyright (C) 2016 Linaro Ltd 5 * 6 * Author: Ulf Hansson <ulf.hansson@linaro.org> 7 * 8 * License terms: GNU General Public License (GPL) version 2 9 */ 10 11 #ifndef _MMC_CORE_CARD_H 12 #define _MMC_CORE_CARD_H 13 14 #include <linux/mmc/card.h> 15 16 #define mmc_card_name(c) ((c)->cid.prod_name) 17 #define mmc_card_id(c) (dev_name(&(c)->dev)) 18 #define mmc_dev_to_card(d) container_of(d, struct mmc_card, dev) 19 20 /* Card states */ 21 #define MMC_STATE_PRESENT (1<<0) /* present in sysfs */ 22 #define MMC_STATE_READONLY (1<<1) /* card is read-only */ 23 #define MMC_STATE_BLOCKADDR (1<<2) /* card uses block-addressing */ 24 #define MMC_CARD_SDXC (1<<3) /* card is SDXC */ 25 #define MMC_CARD_REMOVED (1<<4) /* card has been removed */ 26 #define MMC_STATE_DOING_BKOPS (1<<5) /* card is doing BKOPS */ 27 #define MMC_STATE_SUSPENDED (1<<6) /* card is suspended */ 28 29 #define mmc_card_present(c) ((c)->state & MMC_STATE_PRESENT) 30 #define mmc_card_readonly(c) ((c)->state & MMC_STATE_READONLY) 31 #define mmc_card_blockaddr(c) ((c)->state & MMC_STATE_BLOCKADDR) 32 #define mmc_card_ext_capacity(c) ((c)->state & MMC_CARD_SDXC) 33 #define mmc_card_removed(c) ((c) && ((c)->state & MMC_CARD_REMOVED)) 34 #define mmc_card_doing_bkops(c) ((c)->state & MMC_STATE_DOING_BKOPS) 35 #define mmc_card_suspended(c) ((c)->state & MMC_STATE_SUSPENDED) 36 37 #define mmc_card_set_present(c) ((c)->state |= MMC_STATE_PRESENT) 38 #define mmc_card_set_readonly(c) ((c)->state |= MMC_STATE_READONLY) 39 #define mmc_card_set_blockaddr(c) ((c)->state |= MMC_STATE_BLOCKADDR) 40 #define mmc_card_set_ext_capacity(c) ((c)->state |= MMC_CARD_SDXC) 41 #define mmc_card_set_removed(c) ((c)->state |= MMC_CARD_REMOVED) 42 #define mmc_card_set_doing_bkops(c) ((c)->state |= MMC_STATE_DOING_BKOPS) 43 #define mmc_card_clr_doing_bkops(c) ((c)->state &= ~MMC_STATE_DOING_BKOPS) 44 #define mmc_card_set_suspended(c) ((c)->state |= MMC_STATE_SUSPENDED) 45 #define mmc_card_clr_suspended(c) ((c)->state &= ~MMC_STATE_SUSPENDED) 46 47 /* 48 * The world is not perfect and supplies us with broken mmc/sdio devices. 49 * For at least some of these bugs we need a work-around. 50 */ 51 struct mmc_fixup { 52 /* CID-specific fields. */ 53 const char *name; 54 55 /* Valid revision range */ 56 u64 rev_start, rev_end; 57 58 unsigned int manfid; 59 unsigned short oemid; 60 61 /* SDIO-specific fields. You can use SDIO_ANY_ID here of course */ 62 u16 cis_vendor, cis_device; 63 64 /* for MMC cards */ 65 unsigned int ext_csd_rev; 66 67 void (*vendor_fixup)(struct mmc_card *card, int data); 68 int data; 69 }; 70 71 #define CID_MANFID_ANY (-1u) 72 #define CID_OEMID_ANY ((unsigned short) -1) 73 #define CID_NAME_ANY (NULL) 74 75 #define EXT_CSD_REV_ANY (-1u) 76 77 #define CID_MANFID_SANDISK 0x2 78 #define CID_MANFID_ATP 0x9 79 #define CID_MANFID_TOSHIBA 0x11 80 #define CID_MANFID_MICRON 0x13 81 #define CID_MANFID_SAMSUNG 0x15 82 #define CID_MANFID_APACER 0x27 83 #define CID_MANFID_KINGSTON 0x70 84 #define CID_MANFID_HYNIX 0x90 85 #define CID_MANFID_NUMONYX 0xFE 86 87 #define END_FIXUP { NULL } 88 89 #define _FIXUP_EXT(_name, _manfid, _oemid, _rev_start, _rev_end, \ 90 _cis_vendor, _cis_device, \ 91 _fixup, _data, _ext_csd_rev) \ 92 { \ 93 .name = (_name), \ 94 .manfid = (_manfid), \ 95 .oemid = (_oemid), \ 96 .rev_start = (_rev_start), \ 97 .rev_end = (_rev_end), \ 98 .cis_vendor = (_cis_vendor), \ 99 .cis_device = (_cis_device), \ 100 .vendor_fixup = (_fixup), \ 101 .data = (_data), \ 102 .ext_csd_rev = (_ext_csd_rev), \ 103 } 104 105 #define MMC_FIXUP_REV(_name, _manfid, _oemid, _rev_start, _rev_end, \ 106 _fixup, _data, _ext_csd_rev) \ 107 _FIXUP_EXT(_name, _manfid, \ 108 _oemid, _rev_start, _rev_end, \ 109 SDIO_ANY_ID, SDIO_ANY_ID, \ 110 _fixup, _data, _ext_csd_rev) \ 111 112 #define MMC_FIXUP(_name, _manfid, _oemid, _fixup, _data) \ 113 MMC_FIXUP_REV(_name, _manfid, _oemid, 0, -1ull, _fixup, _data, \ 114 EXT_CSD_REV_ANY) 115 116 #define MMC_FIXUP_EXT_CSD_REV(_name, _manfid, _oemid, _fixup, _data, \ 117 _ext_csd_rev) \ 118 MMC_FIXUP_REV(_name, _manfid, _oemid, 0, -1ull, _fixup, _data, \ 119 _ext_csd_rev) 120 121 #define SDIO_FIXUP(_vendor, _device, _fixup, _data) \ 122 _FIXUP_EXT(CID_NAME_ANY, CID_MANFID_ANY, \ 123 CID_OEMID_ANY, 0, -1ull, \ 124 _vendor, _device, \ 125 _fixup, _data, EXT_CSD_REV_ANY) \ 126 127 #define cid_rev(hwrev, fwrev, year, month) \ 128 (((u64) hwrev) << 40 | \ 129 ((u64) fwrev) << 32 | \ 130 ((u64) year) << 16 | \ 131 ((u64) month)) 132 133 #define cid_rev_card(card) \ 134 cid_rev(card->cid.hwrev, \ 135 card->cid.fwrev, \ 136 card->cid.year, \ 137 card->cid.month) 138 139 /* 140 * Unconditionally quirk add/remove. 141 */ 142 static inline void __maybe_unused add_quirk(struct mmc_card *card, int data) 143 { 144 card->quirks |= data; 145 } 146 147 static inline void __maybe_unused remove_quirk(struct mmc_card *card, int data) 148 { 149 card->quirks &= ~data; 150 } 151 152 /* 153 * Quirk add/remove for MMC products. 154 */ 155 static inline void __maybe_unused add_quirk_mmc(struct mmc_card *card, int data) 156 { 157 if (mmc_card_mmc(card)) 158 card->quirks |= data; 159 } 160 161 static inline void __maybe_unused remove_quirk_mmc(struct mmc_card *card, 162 int data) 163 { 164 if (mmc_card_mmc(card)) 165 card->quirks &= ~data; 166 } 167 168 /* 169 * Quirk add/remove for SD products. 170 */ 171 static inline void __maybe_unused add_quirk_sd(struct mmc_card *card, int data) 172 { 173 if (mmc_card_sd(card)) 174 card->quirks |= data; 175 } 176 177 static inline void __maybe_unused remove_quirk_sd(struct mmc_card *card, 178 int data) 179 { 180 if (mmc_card_sd(card)) 181 card->quirks &= ~data; 182 } 183 184 static inline int mmc_card_lenient_fn0(const struct mmc_card *c) 185 { 186 return c->quirks & MMC_QUIRK_LENIENT_FN0; 187 } 188 189 static inline int mmc_blksz_for_byte_mode(const struct mmc_card *c) 190 { 191 return c->quirks & MMC_QUIRK_BLKSZ_FOR_BYTE_MODE; 192 } 193 194 static inline int mmc_card_disable_cd(const struct mmc_card *c) 195 { 196 return c->quirks & MMC_QUIRK_DISABLE_CD; 197 } 198 199 static inline int mmc_card_nonstd_func_interface(const struct mmc_card *c) 200 { 201 return c->quirks & MMC_QUIRK_NONSTD_FUNC_IF; 202 } 203 204 static inline int mmc_card_broken_byte_mode_512(const struct mmc_card *c) 205 { 206 return c->quirks & MMC_QUIRK_BROKEN_BYTE_MODE_512; 207 } 208 209 static inline int mmc_card_long_read_time(const struct mmc_card *c) 210 { 211 return c->quirks & MMC_QUIRK_LONG_READ_TIME; 212 } 213 214 static inline int mmc_card_broken_irq_polling(const struct mmc_card *c) 215 { 216 return c->quirks & MMC_QUIRK_BROKEN_IRQ_POLLING; 217 } 218 219 static inline int mmc_card_broken_hpi(const struct mmc_card *c) 220 { 221 return c->quirks & MMC_QUIRK_BROKEN_HPI; 222 } 223 224 #endif 225