card.h 6.1 KB

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