Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * linux/include/linux/mmc/host.h |
| 3 | * |
| 4 | * This program is free software; you can redistribute it and/or modify |
| 5 | * it under the terms of the GNU General Public License version 2 as |
| 6 | * published by the Free Software Foundation. |
| 7 | * |
| 8 | * Host driver specific definitions. |
| 9 | */ |
| 10 | #ifndef LINUX_MMC_HOST_H |
| 11 | #define LINUX_MMC_HOST_H |
| 12 | |
Pierre Ossman | aaac1b4 | 2007-02-28 15:33:10 +0100 | [diff] [blame] | 13 | #include <linux/mmc/core.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 14 | |
| 15 | struct mmc_ios { |
| 16 | unsigned int clock; /* clock rate */ |
| 17 | unsigned short vdd; |
| 18 | |
Philip Langdale | 4be34c9 | 2007-03-11 17:15:15 -0700 | [diff] [blame] | 19 | /* vdd stores the bit number of the selected voltage range from below. */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 20 | |
| 21 | unsigned char bus_mode; /* command output mode */ |
| 22 | |
| 23 | #define MMC_BUSMODE_OPENDRAIN 1 |
| 24 | #define MMC_BUSMODE_PUSHPULL 2 |
| 25 | |
Pierre Ossman | 865e9f1 | 2005-09-03 16:45:02 +0100 | [diff] [blame] | 26 | unsigned char chip_select; /* SPI chip select */ |
| 27 | |
| 28 | #define MMC_CS_DONTCARE 0 |
| 29 | #define MMC_CS_HIGH 1 |
| 30 | #define MMC_CS_LOW 2 |
| 31 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 32 | unsigned char power_mode; /* power supply mode */ |
| 33 | |
| 34 | #define MMC_POWER_OFF 0 |
| 35 | #define MMC_POWER_UP 1 |
| 36 | #define MMC_POWER_ON 2 |
Pierre Ossman | f218278 | 2005-09-06 15:18:55 -0700 | [diff] [blame] | 37 | |
| 38 | unsigned char bus_width; /* data bus width */ |
| 39 | |
| 40 | #define MMC_BUS_WIDTH_1 0 |
| 41 | #define MMC_BUS_WIDTH_4 2 |
Pierre Ossman | cd9277c | 2007-02-18 12:07:47 +0100 | [diff] [blame] | 42 | |
| 43 | unsigned char timing; /* timing specification used */ |
| 44 | |
| 45 | #define MMC_TIMING_LEGACY 0 |
| 46 | #define MMC_TIMING_MMC_HS 1 |
| 47 | #define MMC_TIMING_SD_HS 2 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 48 | }; |
| 49 | |
| 50 | struct mmc_host_ops { |
| 51 | void (*request)(struct mmc_host *host, struct mmc_request *req); |
| 52 | void (*set_ios)(struct mmc_host *host, struct mmc_ios *ios); |
Pierre Ossman | a00fc09 | 2005-09-06 15:18:52 -0700 | [diff] [blame] | 53 | int (*get_ro)(struct mmc_host *host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 54 | }; |
| 55 | |
| 56 | struct mmc_card; |
| 57 | struct device; |
| 58 | |
| 59 | struct mmc_host { |
Greg Kroah-Hartman | fcaf71f | 2006-09-12 17:00:10 +0200 | [diff] [blame] | 60 | struct device *parent; |
| 61 | struct device class_dev; |
Russell King | dce7737 | 2005-08-19 09:42:52 +0100 | [diff] [blame] | 62 | int index; |
David Brownell | f57b225 | 2006-09-03 06:43:33 -0700 | [diff] [blame] | 63 | const struct mmc_host_ops *ops; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 64 | unsigned int f_min; |
| 65 | unsigned int f_max; |
| 66 | u32 ocr_avail; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 67 | |
Philip Langdale | 55556da | 2007-03-16 19:39:00 -0700 | [diff] [blame] | 68 | #define MMC_VDD_165_195 0x00000080 /* VDD voltage 1.65 - 1.95 */ |
Pierre Ossman | f74d132 | 2007-02-09 22:49:31 +0100 | [diff] [blame] | 69 | #define MMC_VDD_20_21 0x00000100 /* VDD voltage 2.0 ~ 2.1 */ |
| 70 | #define MMC_VDD_21_22 0x00000200 /* VDD voltage 2.1 ~ 2.2 */ |
| 71 | #define MMC_VDD_22_23 0x00000400 /* VDD voltage 2.2 ~ 2.3 */ |
| 72 | #define MMC_VDD_23_24 0x00000800 /* VDD voltage 2.3 ~ 2.4 */ |
| 73 | #define MMC_VDD_24_25 0x00001000 /* VDD voltage 2.4 ~ 2.5 */ |
| 74 | #define MMC_VDD_25_26 0x00002000 /* VDD voltage 2.5 ~ 2.6 */ |
| 75 | #define MMC_VDD_26_27 0x00004000 /* VDD voltage 2.6 ~ 2.7 */ |
| 76 | #define MMC_VDD_27_28 0x00008000 /* VDD voltage 2.7 ~ 2.8 */ |
| 77 | #define MMC_VDD_28_29 0x00010000 /* VDD voltage 2.8 ~ 2.9 */ |
| 78 | #define MMC_VDD_29_30 0x00020000 /* VDD voltage 2.9 ~ 3.0 */ |
| 79 | #define MMC_VDD_30_31 0x00040000 /* VDD voltage 3.0 ~ 3.1 */ |
| 80 | #define MMC_VDD_31_32 0x00080000 /* VDD voltage 3.1 ~ 3.2 */ |
| 81 | #define MMC_VDD_32_33 0x00100000 /* VDD voltage 3.2 ~ 3.3 */ |
| 82 | #define MMC_VDD_33_34 0x00200000 /* VDD voltage 3.3 ~ 3.4 */ |
| 83 | #define MMC_VDD_34_35 0x00400000 /* VDD voltage 3.4 ~ 3.5 */ |
| 84 | #define MMC_VDD_35_36 0x00800000 /* VDD voltage 3.5 ~ 3.6 */ |
| 85 | |
Pierre Ossman | f218278 | 2005-09-06 15:18:55 -0700 | [diff] [blame] | 86 | unsigned long caps; /* Host capabilities */ |
| 87 | |
| 88 | #define MMC_CAP_4_BIT_DATA (1 << 0) /* Can the host do 4 bit transfers */ |
Russell King | db53f28 | 2006-08-30 15:14:56 +0100 | [diff] [blame] | 89 | #define MMC_CAP_MULTIWRITE (1 << 1) /* Can accurately report bytes sent to card on error */ |
Pierre Ossman | 255d01a | 2007-07-24 20:38:53 +0200 | [diff] [blame] | 90 | #define MMC_CAP_MMC_HIGHSPEED (1 << 2) /* Can do MMC high-speed timing */ |
| 91 | #define MMC_CAP_SD_HIGHSPEED (1 << 3) /* Can do SD high-speed timing */ |
Pierre Ossman | f218278 | 2005-09-06 15:18:55 -0700 | [diff] [blame] | 92 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 93 | /* host specific block data */ |
| 94 | unsigned int max_seg_size; /* see blk_queue_max_segment_size */ |
| 95 | unsigned short max_hw_segs; /* see blk_queue_max_hw_segments */ |
| 96 | unsigned short max_phys_segs; /* see blk_queue_max_phys_segments */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 97 | unsigned short unused; |
Pierre Ossman | 55db890 | 2006-11-21 17:55:45 +0100 | [diff] [blame] | 98 | unsigned int max_req_size; /* maximum number of bytes in one req */ |
Pierre Ossman | fe4a3c7 | 2006-11-21 17:54:23 +0100 | [diff] [blame] | 99 | unsigned int max_blk_size; /* maximum size of one mmc block */ |
Pierre Ossman | 55db890 | 2006-11-21 17:55:45 +0100 | [diff] [blame] | 100 | unsigned int max_blk_count; /* maximum number of blocks in one req */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 101 | |
| 102 | /* private data */ |
Pierre Ossman | 7ea239d | 2006-12-31 00:11:32 +0100 | [diff] [blame] | 103 | spinlock_t lock; /* lock for claim and bus ops */ |
| 104 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 105 | struct mmc_ios ios; /* current io bus settings */ |
| 106 | u32 ocr; /* the current OCR setting */ |
| 107 | |
Pierre Ossman | 335eadf | 2005-09-06 15:18:50 -0700 | [diff] [blame] | 108 | unsigned int mode; /* current card mode of host */ |
| 109 | #define MMC_MODE_MMC 0 |
| 110 | #define MMC_MODE_SD 1 |
| 111 | |
Pierre Ossman | b855885 | 2007-01-03 19:47:29 +0100 | [diff] [blame] | 112 | struct mmc_card *card; /* device attached to this host */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 113 | |
| 114 | wait_queue_head_t wq; |
Pierre Ossman | f22ee4e | 2006-12-26 15:11:23 +0100 | [diff] [blame] | 115 | unsigned int claimed:1; /* host exclusively claimed */ |
| 116 | |
David Howells | c402895 | 2006-11-22 14:57:56 +0000 | [diff] [blame] | 117 | struct delayed_work detect; |
Pierre Ossman | 3b91e55 | 2007-02-11 20:43:19 +0100 | [diff] [blame] | 118 | #ifdef CONFIG_MMC_DEBUG |
| 119 | unsigned int removed:1; /* host is being removed */ |
| 120 | #endif |
Russell King | 01357dc | 2005-09-08 22:46:00 +0100 | [diff] [blame] | 121 | |
Pierre Ossman | 7ea239d | 2006-12-31 00:11:32 +0100 | [diff] [blame] | 122 | const struct mmc_bus_ops *bus_ops; /* current bus driver */ |
| 123 | unsigned int bus_refs; /* reference counter */ |
| 124 | unsigned int bus_dead:1; /* bus has been released */ |
| 125 | |
Nicolas Pitre | d1496c3 | 2007-06-30 16:29:41 +0200 | [diff] [blame] | 126 | unsigned int sdio_irqs; |
| 127 | struct task_struct *sdio_irq_thread; |
| 128 | atomic_t sdio_irq_thread_abort; |
| 129 | |
Russell King | 01357dc | 2005-09-08 22:46:00 +0100 | [diff] [blame] | 130 | unsigned long private[0] ____cacheline_aligned; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 131 | }; |
| 132 | |
| 133 | extern struct mmc_host *mmc_alloc_host(int extra, struct device *); |
| 134 | extern int mmc_add_host(struct mmc_host *); |
| 135 | extern void mmc_remove_host(struct mmc_host *); |
| 136 | extern void mmc_free_host(struct mmc_host *); |
| 137 | |
Russell King | 01357dc | 2005-09-08 22:46:00 +0100 | [diff] [blame] | 138 | static inline void *mmc_priv(struct mmc_host *host) |
| 139 | { |
| 140 | return (void *)host->private; |
| 141 | } |
| 142 | |
Greg Kroah-Hartman | fcaf71f | 2006-09-12 17:00:10 +0200 | [diff] [blame] | 143 | #define mmc_dev(x) ((x)->parent) |
Pierre Ossman | 11354d0 | 2007-01-14 01:41:45 +0100 | [diff] [blame] | 144 | #define mmc_classdev(x) (&(x)->class_dev) |
Greg Kroah-Hartman | fcaf71f | 2006-09-12 17:00:10 +0200 | [diff] [blame] | 145 | #define mmc_hostname(x) ((x)->class_dev.bus_id) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 146 | |
Pavel Machek | 3bfffd9 | 2005-04-16 15:25:37 -0700 | [diff] [blame] | 147 | extern int mmc_suspend_host(struct mmc_host *, pm_message_t); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 148 | extern int mmc_resume_host(struct mmc_host *); |
| 149 | |
Richard Purdie | 8dc0033 | 2005-09-08 17:53:01 +0100 | [diff] [blame] | 150 | extern void mmc_detect_change(struct mmc_host *, unsigned long delay); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 151 | extern void mmc_request_done(struct mmc_host *, struct mmc_request *); |
| 152 | |
| 153 | #endif |
| 154 | |