sdhci: describe quirks

Add a comment for each quirk to describe what it does and why.

Signed-off-by: Pierre Ossman <drzeus@drzeus.cx>

+10
+10
drivers/mmc/host/sdhci.c
··· 26 27 static unsigned int debug_quirks = 0; 28 29 #define SDHCI_QUIRK_CLOCK_BEFORE_RESET (1<<0) 30 #define SDHCI_QUIRK_FORCE_DMA (1<<1) 31 /* Controller doesn't like some resets when there is no card inserted. */ 32 #define SDHCI_QUIRK_NO_CARD_NO_RESET (1<<2) 33 #define SDHCI_QUIRK_SINGLE_POWER_WRITE (1<<3) 34 #define SDHCI_QUIRK_RESET_CMD_DATA_ON_IOS (1<<4) 35 #define SDHCI_QUIRK_BROKEN_DMA (1<<5) 36 37 static const struct pci_device_id pci_ids[] __devinitdata = {
··· 26 27 static unsigned int debug_quirks = 0; 28 29 + /* 30 + * Different quirks to handle when the hardware deviates from a strict 31 + * interpretation of the SDHCI specification. 32 + */ 33 + 34 + /* Controller doesn't honor resets unless we touch the clock register */ 35 #define SDHCI_QUIRK_CLOCK_BEFORE_RESET (1<<0) 36 + /* Controller has bad caps bits, but really supports DMA */ 37 #define SDHCI_QUIRK_FORCE_DMA (1<<1) 38 /* Controller doesn't like some resets when there is no card inserted. */ 39 #define SDHCI_QUIRK_NO_CARD_NO_RESET (1<<2) 40 + /* Controller doesn't like clearing the power reg before a change */ 41 #define SDHCI_QUIRK_SINGLE_POWER_WRITE (1<<3) 42 + /* Controller has flaky internal state so reset it on each ios change */ 43 #define SDHCI_QUIRK_RESET_CMD_DATA_ON_IOS (1<<4) 44 + /* Controller has an unusable DMA engine */ 45 #define SDHCI_QUIRK_BROKEN_DMA (1<<5) 46 47 static const struct pci_device_id pci_ids[] __devinitdata = {