sdhci.h 5.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144
  1. /*
  2. * linux/include/linux/mmc/sdhci.h - Secure Digital Host Controller Interface
  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. #ifndef __SDHCI_H
  12. #define __SDHCI_H
  13. #include <linux/scatterlist.h>
  14. #include <linux/compiler.h>
  15. #include <linux/types.h>
  16. #include <linux/io.h>
  17. #include <linux/mmc/host.h>
  18. struct sdhci_host {
  19. /* Data set by hardware interface driver */
  20. const char *hw_name; /* Hardware bus name */
  21. unsigned int quirks; /* Deviations from spec. */
  22. /* Controller doesn't honor resets unless we touch the clock register */
  23. #define SDHCI_QUIRK_CLOCK_BEFORE_RESET (1<<0)
  24. /* Controller has bad caps bits, but really supports DMA */
  25. #define SDHCI_QUIRK_FORCE_DMA (1<<1)
  26. /* Controller doesn't like to be reset when there is no card inserted. */
  27. #define SDHCI_QUIRK_NO_CARD_NO_RESET (1<<2)
  28. /* Controller doesn't like clearing the power reg before a change */
  29. #define SDHCI_QUIRK_SINGLE_POWER_WRITE (1<<3)
  30. /* Controller has flaky internal state so reset it on each ios change */
  31. #define SDHCI_QUIRK_RESET_CMD_DATA_ON_IOS (1<<4)
  32. /* Controller has an unusable DMA engine */
  33. #define SDHCI_QUIRK_BROKEN_DMA (1<<5)
  34. /* Controller has an unusable ADMA engine */
  35. #define SDHCI_QUIRK_BROKEN_ADMA (1<<6)
  36. /* Controller can only DMA from 32-bit aligned addresses */
  37. #define SDHCI_QUIRK_32BIT_DMA_ADDR (1<<7)
  38. /* Controller can only DMA chunk sizes that are a multiple of 32 bits */
  39. #define SDHCI_QUIRK_32BIT_DMA_SIZE (1<<8)
  40. /* Controller can only ADMA chunks that are a multiple of 32 bits */
  41. #define SDHCI_QUIRK_32BIT_ADMA_SIZE (1<<9)
  42. /* Controller needs to be reset after each request to stay stable */
  43. #define SDHCI_QUIRK_RESET_AFTER_REQUEST (1<<10)
  44. /* Controller needs voltage and power writes to happen separately */
  45. #define SDHCI_QUIRK_NO_SIMULT_VDD_AND_POWER (1<<11)
  46. /* Controller provides an incorrect timeout value for transfers */
  47. #define SDHCI_QUIRK_BROKEN_TIMEOUT_VAL (1<<12)
  48. /* Controller has an issue with buffer bits for small transfers */
  49. #define SDHCI_QUIRK_BROKEN_SMALL_PIO (1<<13)
  50. /* Controller does not provide transfer-complete interrupt when not busy */
  51. #define SDHCI_QUIRK_NO_BUSY_IRQ (1<<14)
  52. /* Controller has unreliable card detection */
  53. #define SDHCI_QUIRK_BROKEN_CARD_DETECTION (1<<15)
  54. /* Controller reports inverted write-protect state */
  55. #define SDHCI_QUIRK_INVERTED_WRITE_PROTECT (1<<16)
  56. /* Controller has nonstandard clock management */
  57. #define SDHCI_QUIRK_NONSTANDARD_CLOCK (1<<17)
  58. /* Controller does not like fast PIO transfers */
  59. #define SDHCI_QUIRK_PIO_NEEDS_DELAY (1<<18)
  60. /* Controller losing signal/interrupt enable states after reset */
  61. #define SDHCI_QUIRK_RESTORE_IRQS_AFTER_RESET (1<<19)
  62. /* Controller has to be forced to use block size of 2048 bytes */
  63. #define SDHCI_QUIRK_FORCE_BLK_SZ_2048 (1<<20)
  64. /* Controller cannot do multi-block transfers */
  65. #define SDHCI_QUIRK_NO_MULTIBLOCK (1<<21)
  66. /* Controller can only handle 1-bit data transfers */
  67. #define SDHCI_QUIRK_FORCE_1_BIT_DATA (1<<22)
  68. /* Controller needs 10ms delay between applying power and clock */
  69. #define SDHCI_QUIRK_DELAY_AFTER_POWER (1<<23)
  70. /* Controller uses SDCLK instead of TMCLK for data timeouts */
  71. #define SDHCI_QUIRK_DATA_TIMEOUT_USES_SDCLK (1<<24)
  72. /* Controller reports wrong base clock capability */
  73. #define SDHCI_QUIRK_CAP_CLOCK_BASE_BROKEN (1<<25)
  74. /* Controller cannot support End Attribute in NOP ADMA descriptor */
  75. #define SDHCI_QUIRK_NO_ENDATTR_IN_NOPDESC (1<<26)
  76. /* Controller is missing device caps. Use caps provided by host */
  77. #define SDHCI_QUIRK_MISSING_CAPS (1<<27)
  78. /* Controller uses Auto CMD12 command to stop the transfer */
  79. #define SDHCI_QUIRK_MULTIBLOCK_READ_ACMD12 (1<<28)
  80. /* Controller doesn't have HISPD bit field in HI-SPEED SD card */
  81. #define SDHCI_QUIRK_NO_HISPD_BIT (1<<29)
  82. int irq; /* Device IRQ */
  83. void __iomem *ioaddr; /* Mapped address */
  84. const struct sdhci_ops *ops; /* Low level hw interface */
  85. struct regulator *vmmc; /* Power regulator */
  86. /* Internal data */
  87. struct mmc_host *mmc; /* MMC structure */
  88. u64 dma_mask; /* custom DMA mask */
  89. #if defined(CONFIG_LEDS_CLASS) || defined(CONFIG_LEDS_CLASS_MODULE)
  90. struct led_classdev led; /* LED control */
  91. char led_name[32];
  92. #endif
  93. spinlock_t lock; /* Mutex */
  94. int flags; /* Host attributes */
  95. #define SDHCI_USE_SDMA (1<<0) /* Host is SDMA capable */
  96. #define SDHCI_USE_ADMA (1<<1) /* Host is ADMA capable */
  97. #define SDHCI_REQ_USE_DMA (1<<2) /* Use DMA for this req. */
  98. #define SDHCI_DEVICE_DEAD (1<<3) /* Device unresponsive */
  99. unsigned int version; /* SDHCI spec. version */
  100. unsigned int max_clk; /* Max possible freq (MHz) */
  101. unsigned int timeout_clk; /* Timeout freq (KHz) */
  102. unsigned int clock; /* Current clock (MHz) */
  103. u8 pwr; /* Current voltage */
  104. struct mmc_request *mrq; /* Current request */
  105. struct mmc_command *cmd; /* Current command */
  106. struct mmc_data *data; /* Current data request */
  107. unsigned int data_early:1; /* Data finished before cmd */
  108. struct sg_mapping_iter sg_miter; /* SG state for PIO */
  109. unsigned int blocks; /* remaining PIO blocks */
  110. int sg_count; /* Mapped sg entries */
  111. u8 *adma_desc; /* ADMA descriptor table */
  112. u8 *align_buffer; /* Bounce buffer */
  113. dma_addr_t adma_addr; /* Mapped ADMA descr. table */
  114. dma_addr_t align_addr; /* Mapped bounce buffer */
  115. struct tasklet_struct card_tasklet; /* Tasklet structures */
  116. struct tasklet_struct finish_tasklet;
  117. struct timer_list timer; /* Timer for timeouts */
  118. unsigned int caps; /* Alternative capabilities */
  119. unsigned long private[0] ____cacheline_aligned;
  120. };
  121. #endif /* __SDHCI_H */