sdhci.h 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248
  1. /*
  2. * linux/drivers/mmc/host/sdhci.h - Secure Digital Host Controller Interface driver
  3. *
  4. * Copyright (C) 2005-2008 Pierre Ossman, All Rights Reserved.
  5. *
  6. * This program is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU General Public License as published by
  8. * the Free Software Foundation; either version 2 of the License, or (at
  9. * your option) any later version.
  10. */
  11. /*
  12. * Controller registers
  13. */
  14. #define SDHCI_DMA_ADDRESS 0x00
  15. #define SDHCI_BLOCK_SIZE 0x04
  16. #define SDHCI_MAKE_BLKSZ(dma, blksz) (((dma & 0x7) << 12) | (blksz & 0xFFF))
  17. #define SDHCI_BLOCK_COUNT 0x06
  18. #define SDHCI_ARGUMENT 0x08
  19. #define SDHCI_TRANSFER_MODE 0x0C
  20. #define SDHCI_TRNS_DMA 0x01
  21. #define SDHCI_TRNS_BLK_CNT_EN 0x02
  22. #define SDHCI_TRNS_ACMD12 0x04
  23. #define SDHCI_TRNS_READ 0x10
  24. #define SDHCI_TRNS_MULTI 0x20
  25. #define SDHCI_COMMAND 0x0E
  26. #define SDHCI_CMD_RESP_MASK 0x03
  27. #define SDHCI_CMD_CRC 0x08
  28. #define SDHCI_CMD_INDEX 0x10
  29. #define SDHCI_CMD_DATA 0x20
  30. #define SDHCI_CMD_RESP_NONE 0x00
  31. #define SDHCI_CMD_RESP_LONG 0x01
  32. #define SDHCI_CMD_RESP_SHORT 0x02
  33. #define SDHCI_CMD_RESP_SHORT_BUSY 0x03
  34. #define SDHCI_MAKE_CMD(c, f) (((c & 0xff) << 8) | (f & 0xff))
  35. #define SDHCI_RESPONSE 0x10
  36. #define SDHCI_BUFFER 0x20
  37. #define SDHCI_PRESENT_STATE 0x24
  38. #define SDHCI_CMD_INHIBIT 0x00000001
  39. #define SDHCI_DATA_INHIBIT 0x00000002
  40. #define SDHCI_DOING_WRITE 0x00000100
  41. #define SDHCI_DOING_READ 0x00000200
  42. #define SDHCI_SPACE_AVAILABLE 0x00000400
  43. #define SDHCI_DATA_AVAILABLE 0x00000800
  44. #define SDHCI_CARD_PRESENT 0x00010000
  45. #define SDHCI_WRITE_PROTECT 0x00080000
  46. #define SDHCI_HOST_CONTROL 0x28
  47. #define SDHCI_CTRL_LED 0x01
  48. #define SDHCI_CTRL_4BITBUS 0x02
  49. #define SDHCI_CTRL_HISPD 0x04
  50. #define SDHCI_POWER_CONTROL 0x29
  51. #define SDHCI_POWER_ON 0x01
  52. #define SDHCI_POWER_180 0x0A
  53. #define SDHCI_POWER_300 0x0C
  54. #define SDHCI_POWER_330 0x0E
  55. #define SDHCI_BLOCK_GAP_CONTROL 0x2A
  56. #define SDHCI_WAKE_UP_CONTROL 0x2B
  57. #define SDHCI_CLOCK_CONTROL 0x2C
  58. #define SDHCI_DIVIDER_SHIFT 8
  59. #define SDHCI_CLOCK_CARD_EN 0x0004
  60. #define SDHCI_CLOCK_INT_STABLE 0x0002
  61. #define SDHCI_CLOCK_INT_EN 0x0001
  62. #define SDHCI_TIMEOUT_CONTROL 0x2E
  63. #define SDHCI_SOFTWARE_RESET 0x2F
  64. #define SDHCI_RESET_ALL 0x01
  65. #define SDHCI_RESET_CMD 0x02
  66. #define SDHCI_RESET_DATA 0x04
  67. #define SDHCI_INT_STATUS 0x30
  68. #define SDHCI_INT_ENABLE 0x34
  69. #define SDHCI_SIGNAL_ENABLE 0x38
  70. #define SDHCI_INT_RESPONSE 0x00000001
  71. #define SDHCI_INT_DATA_END 0x00000002
  72. #define SDHCI_INT_DMA_END 0x00000008
  73. #define SDHCI_INT_SPACE_AVAIL 0x00000010
  74. #define SDHCI_INT_DATA_AVAIL 0x00000020
  75. #define SDHCI_INT_CARD_INSERT 0x00000040
  76. #define SDHCI_INT_CARD_REMOVE 0x00000080
  77. #define SDHCI_INT_CARD_INT 0x00000100
  78. #define SDHCI_INT_ERROR 0x00008000
  79. #define SDHCI_INT_TIMEOUT 0x00010000
  80. #define SDHCI_INT_CRC 0x00020000
  81. #define SDHCI_INT_END_BIT 0x00040000
  82. #define SDHCI_INT_INDEX 0x00080000
  83. #define SDHCI_INT_DATA_TIMEOUT 0x00100000
  84. #define SDHCI_INT_DATA_CRC 0x00200000
  85. #define SDHCI_INT_DATA_END_BIT 0x00400000
  86. #define SDHCI_INT_BUS_POWER 0x00800000
  87. #define SDHCI_INT_ACMD12ERR 0x01000000
  88. #define SDHCI_INT_NORMAL_MASK 0x00007FFF
  89. #define SDHCI_INT_ERROR_MASK 0xFFFF8000
  90. #define SDHCI_INT_CMD_MASK (SDHCI_INT_RESPONSE | SDHCI_INT_TIMEOUT | \
  91. SDHCI_INT_CRC | SDHCI_INT_END_BIT | SDHCI_INT_INDEX)
  92. #define SDHCI_INT_DATA_MASK (SDHCI_INT_DATA_END | SDHCI_INT_DMA_END | \
  93. SDHCI_INT_DATA_AVAIL | SDHCI_INT_SPACE_AVAIL | \
  94. SDHCI_INT_DATA_TIMEOUT | SDHCI_INT_DATA_CRC | \
  95. SDHCI_INT_DATA_END_BIT)
  96. #define SDHCI_ACMD12_ERR 0x3C
  97. /* 3E-3F reserved */
  98. #define SDHCI_CAPABILITIES 0x40
  99. #define SDHCI_TIMEOUT_CLK_MASK 0x0000003F
  100. #define SDHCI_TIMEOUT_CLK_SHIFT 0
  101. #define SDHCI_TIMEOUT_CLK_UNIT 0x00000080
  102. #define SDHCI_CLOCK_BASE_MASK 0x00003F00
  103. #define SDHCI_CLOCK_BASE_SHIFT 8
  104. #define SDHCI_MAX_BLOCK_MASK 0x00030000
  105. #define SDHCI_MAX_BLOCK_SHIFT 16
  106. #define SDHCI_CAN_DO_HISPD 0x00200000
  107. #define SDHCI_CAN_DO_DMA 0x00400000
  108. #define SDHCI_CAN_VDD_330 0x01000000
  109. #define SDHCI_CAN_VDD_300 0x02000000
  110. #define SDHCI_CAN_VDD_180 0x04000000
  111. /* 44-47 reserved for more caps */
  112. #define SDHCI_MAX_CURRENT 0x48
  113. /* 4C-4F reserved for more max current */
  114. /* 50-FB reserved */
  115. #define SDHCI_SLOT_INT_STATUS 0xFC
  116. #define SDHCI_HOST_VERSION 0xFE
  117. #define SDHCI_VENDOR_VER_MASK 0xFF00
  118. #define SDHCI_VENDOR_VER_SHIFT 8
  119. #define SDHCI_SPEC_VER_MASK 0x00FF
  120. #define SDHCI_SPEC_VER_SHIFT 0
  121. struct sdhci_ops;
  122. struct sdhci_host {
  123. /* Data set by hardware interface driver */
  124. const char *hw_name; /* Hardware bus name */
  125. unsigned int quirks; /* Deviations from spec. */
  126. /* Controller doesn't honor resets unless we touch the clock register */
  127. #define SDHCI_QUIRK_CLOCK_BEFORE_RESET (1<<0)
  128. /* Controller has bad caps bits, but really supports DMA */
  129. #define SDHCI_QUIRK_FORCE_DMA (1<<1)
  130. /* Controller doesn't like to be reset when there is no card inserted. */
  131. #define SDHCI_QUIRK_NO_CARD_NO_RESET (1<<2)
  132. /* Controller doesn't like clearing the power reg before a change */
  133. #define SDHCI_QUIRK_SINGLE_POWER_WRITE (1<<3)
  134. /* Controller has flaky internal state so reset it on each ios change */
  135. #define SDHCI_QUIRK_RESET_CMD_DATA_ON_IOS (1<<4)
  136. /* Controller has an unusable DMA engine */
  137. #define SDHCI_QUIRK_BROKEN_DMA (1<<5)
  138. /* Controller can only DMA from 32-bit aligned addresses */
  139. #define SDHCI_QUIRK_32BIT_DMA_ADDR (1<<6)
  140. /* Controller can only DMA chunk sizes that are a multiple of 32 bits */
  141. #define SDHCI_QUIRK_32BIT_DMA_SIZE (1<<7)
  142. /* Controller needs to be reset after each request to stay stable */
  143. #define SDHCI_QUIRK_RESET_AFTER_REQUEST (1<<8)
  144. /* Controller needs voltage and power writes to happen separately */
  145. #define SDHCI_QUIRK_NO_SIMULT_VDD_AND_POWER (1<<9)
  146. /* Controller provides an incorrect timeout value for transfers */
  147. #define SDHCI_QUIRK_BROKEN_TIMEOUT_VAL (1<<10)
  148. int irq; /* Device IRQ */
  149. void __iomem * ioaddr; /* Mapped address */
  150. const struct sdhci_ops *ops; /* Low level hw interface */
  151. /* Internal data */
  152. struct mmc_host *mmc; /* MMC structure */
  153. #ifdef CONFIG_LEDS_CLASS
  154. struct led_classdev led; /* LED control */
  155. #endif
  156. spinlock_t lock; /* Mutex */
  157. int flags; /* Host attributes */
  158. #define SDHCI_USE_DMA (1<<0) /* Host is DMA capable */
  159. #define SDHCI_REQ_USE_DMA (1<<1) /* Use DMA for this req. */
  160. #define SDHCI_DEVICE_DEAD (1<<2) /* Device unresponsive */
  161. unsigned int max_clk; /* Max possible freq (MHz) */
  162. unsigned int timeout_clk; /* Timeout freq (KHz) */
  163. unsigned int clock; /* Current clock (MHz) */
  164. unsigned short power; /* Current voltage */
  165. struct mmc_request *mrq; /* Current request */
  166. struct mmc_command *cmd; /* Current command */
  167. struct mmc_data *data; /* Current data request */
  168. unsigned int data_early:1; /* Data finished before cmd */
  169. struct scatterlist *cur_sg; /* We're working on this */
  170. int num_sg; /* Entries left */
  171. int offset; /* Offset into current sg */
  172. int remain; /* Bytes left in current */
  173. struct tasklet_struct card_tasklet; /* Tasklet structures */
  174. struct tasklet_struct finish_tasklet;
  175. struct timer_list timer; /* Timer for timeouts */
  176. unsigned long private[0] ____cacheline_aligned;
  177. };
  178. struct sdhci_ops {
  179. int (*enable_dma)(struct sdhci_host *host);
  180. };
  181. extern struct sdhci_host *sdhci_alloc_host(struct device *dev,
  182. size_t priv_size);
  183. extern void sdhci_free_host(struct sdhci_host *host);
  184. static inline void *sdhci_priv(struct sdhci_host *host)
  185. {
  186. return (void *)host->private;
  187. }
  188. extern int sdhci_add_host(struct sdhci_host *host);
  189. extern void sdhci_remove_host(struct sdhci_host *host, int dead);
  190. #ifdef CONFIG_PM
  191. extern int sdhci_suspend_host(struct sdhci_host *host, pm_message_t state);
  192. extern int sdhci_resume_host(struct sdhci_host *host);
  193. #endif