Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
mmc.h
Go to the documentation of this file.
1 /*
2  * MMC definitions for OMAP2
3  *
4  * Copyright (C) 2006 Nokia Corporation
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 version 2 as
8  * published by the Free Software Foundation.
9  */
10 
11 #ifndef __OMAP2_MMC_H
12 #define __OMAP2_MMC_H
13 
14 #include <linux/types.h>
15 #include <linux/device.h>
16 #include <linux/mmc/host.h>
17 
18 #include <plat/omap_hwmod.h>
19 
20 #define OMAP15XX_NR_MMC 1
21 #define OMAP16XX_NR_MMC 2
22 #define OMAP1_MMC_SIZE 0x080
23 #define OMAP1_MMC1_BASE 0xfffb7800
24 #define OMAP1_MMC2_BASE 0xfffb7c00 /* omap16xx only */
25 
26 #define OMAP24XX_NR_MMC 2
27 #define OMAP2420_MMC_SIZE OMAP1_MMC_SIZE
28 #define OMAP2_MMC1_BASE 0x4809c000
29 
30 #define OMAP4_MMC_REG_OFFSET 0x100
31 
32 #define OMAP_MMC_MAX_SLOTS 2
33 
34 /*
35  * struct omap_mmc_dev_attr.flags possibilities
36  *
37  * OMAP_HSMMC_SUPPORTS_DUAL_VOLT: Some HSMMC controller instances can
38  * operate with either 1.8Vdc or 3.0Vdc card voltages; this flag
39  * should be set if this is the case. See for example Section 22.5.3
40  * "MMC/SD/SDIO1 Bus Voltage Selection" of the OMAP34xx Multimedia
41  * Device Silicon Revision 3.1.x Revision ZR (July 2011) (SWPU223R).
42  *
43  * OMAP_HSMMC_BROKEN_MULTIBLOCK_READ: Multiple-block read transfers
44  * don't work correctly on some MMC controller instances on some
45  * OMAP3 SoCs; this flag should be set if this is the case. See
46  * for example Advisory 2.1.1.128 "MMC: Multiple Block Read
47  * Operation Issue" in _OMAP3530/3525/3515/3503 Silicon Errata_
48  * Revision F (October 2010) (SPRZ278F).
49  */
50 #define OMAP_HSMMC_SUPPORTS_DUAL_VOLT BIT(0)
51 #define OMAP_HSMMC_BROKEN_MULTIBLOCK_READ BIT(1)
52 
53 struct omap_mmc_dev_attr {
54  u8 flags;
55 };
56 
57 struct omap_mmc_platform_data {
58  /* back-link to device */
59  struct device *dev;
60 
61  /* number of slots per controller */
62  unsigned nr_slots:2;
63 
64  /* set if your board has components or wiring that limits the
65  * maximum frequency on the MMC bus */
66  unsigned int max_freq;
67 
68  /* switch the bus to a new slot */
69  int (*switch_slot)(struct device *dev, int slot);
70  /* initialize board-specific MMC functionality, can be NULL if
71  * not supported */
72  int (*init)(struct device *dev);
73  void (*cleanup)(struct device *dev);
74  void (*shutdown)(struct device *dev);
75 
76  /* To handle board related suspend/resume functionality for MMC */
77  int (*suspend)(struct device *dev, int slot);
78  int (*resume)(struct device *dev, int slot);
79 
80  /* Return context loss count due to PM states changing */
81  int (*get_context_loss_count)(struct device *dev);
82 
83  /* Integrating attributes from the omap_hwmod layer */
84  u8 controller_flags;
85 
86  /* Register offset deviation */
87  u16 reg_offset;
88 
89  struct omap_mmc_slot_data {
90 
91  /*
92  * 4/8 wires and any additional host capabilities
93  * need to OR'd all capabilities (ref. linux/mmc/host.h)
94  */
95  u8 wires; /* Used for the MMC driver on omap1 and 2420 */
96  u32 caps; /* Used for the MMC driver on 2430 and later */
97  u32 pm_caps; /* PM capabilities of the mmc */
98 
99  /*
100  * nomux means "standard" muxing is wrong on this board, and
101  * that board-specific code handled it before common init logic.
102  */
103  unsigned nomux:1;
104 
105  /* switch pin can be for card detect (default) or card cover */
106  unsigned cover:1;
107 
108  /* use the internal clock */
109  unsigned internal_clock:1;
110 
111  /* nonremovable e.g. eMMC */
112  unsigned nonremovable:1;
113 
114  /* Try to sleep or power off when possible */
115  unsigned power_saving:1;
116 
117  /* If using power_saving and the MMC power is not to go off */
118  unsigned no_off:1;
119 
120  /* eMMC does not handle power off when not in sleep state */
121  unsigned no_regulator_off_init:1;
122 
123  /* Regulator off remapped to sleep */
124  unsigned vcc_aux_disable_is_sleep:1;
125 
126  /* we can put the features above into this variable */
127 #define HSMMC_HAS_PBIAS (1 << 0)
128 #define HSMMC_HAS_UPDATED_RESET (1 << 1)
129  unsigned features;
130 
131  int switch_pin; /* gpio (card detect) */
132  int gpio_wp; /* gpio (write protect) */
133 
134  int (*set_bus_mode)(struct device *dev, int slot, int bus_mode);
135  int (*set_power)(struct device *dev, int slot,
136  int power_on, int vdd);
137  int (*get_ro)(struct device *dev, int slot);
138  void (*remux)(struct device *dev, int slot, int power_on);
139  /* Call back before enabling / disabling regulators */
140  void (*before_set_reg)(struct device *dev, int slot,
141  int power_on, int vdd);
142  /* Call back after enabling / disabling regulators */
143  void (*after_set_reg)(struct device *dev, int slot,
144  int power_on, int vdd);
145  /* if we have special card, init it using this callback */
146  void (*init_card)(struct mmc_card *card);
147 
148  /* return MMC cover switch state, can be NULL if not supported.
149  *
150  * possible return values:
151  * 0 - closed
152  * 1 - open
153  */
154  int (*get_cover_state)(struct device *dev, int slot);
155 
156  const char *name;
157  u32 ocr_mask;
158 
159  /* Card detection IRQs */
160  int card_detect_irq;
161  int (*card_detect)(struct device *dev, int slot);
162 
163  unsigned int ban_openended:1;
164 
165  } slots[OMAP_MMC_MAX_SLOTS];
166 };
167 
168 /* called from board-specific card detection service routine */
169 extern void omap_mmc_notify_cover_event(struct device *dev, int slot,
170  int is_closed);
171 
172 #if defined(CONFIG_MMC_OMAP) || defined(CONFIG_MMC_OMAP_MODULE)
173 void omap1_init_mmc(struct omap_mmc_platform_data **mmc_data,
174  int nr_controllers);
175 void omap242x_init_mmc(struct omap_mmc_platform_data **mmc_data);
176 #else
177 static inline void omap1_init_mmc(struct omap_mmc_platform_data **mmc_data,
178  int nr_controllers)
179 {
180 }
181 static inline void omap242x_init_mmc(struct omap_mmc_platform_data **mmc_data)
182 {
183 }
184 #endif
185 
186 extern int omap_msdi_reset(struct omap_hwmod *oh);
187 
188 #endif
Generated on Thu Jan 10 2013 13:01:53 for Linux Kernel by   doxygen 1.8.2