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 #define OMAP_HSMMC_MAX_SLOTS	1
12 
13 /*
14  * struct omap_hsmmc_dev_attr.flags possibilities
15  *
16  * OMAP_HSMMC_SUPPORTS_DUAL_VOLT: Some HSMMC controller instances can
17  *    operate with either 1.8Vdc or 3.0Vdc card voltages; this flag
18  *    should be set if this is the case.  See for example Section 22.5.3
19  *    "MMC/SD/SDIO1 Bus Voltage Selection" of the OMAP34xx Multimedia
20  *    Device Silicon Revision 3.1.x Revision ZR (July 2011) (SWPU223R).
21  *
22  * OMAP_HSMMC_BROKEN_MULTIBLOCK_READ: Multiple-block read transfers
23  *    don't work correctly on some MMC controller instances on some
24  *    OMAP3 SoCs; this flag should be set if this is the case.  See
25  *    for example Advisory 2.1.1.128 "MMC: Multiple Block Read
26  *    Operation Issue" in _OMAP3530/3525/3515/3503 Silicon Errata_
27  *    Revision F (October 2010) (SPRZ278F).
28  */
29 #define OMAP_HSMMC_SUPPORTS_DUAL_VOLT		BIT(0)
30 #define OMAP_HSMMC_BROKEN_MULTIBLOCK_READ	BIT(1)
31 #define OMAP_HSMMC_SWAKEUP_MISSING		BIT(2)
32 
33 struct omap_hsmmc_dev_attr {
34 	u8 flags;
35 };
36 
37 struct mmc_card;
38 
39 struct omap_hsmmc_platform_data {
40 	/* back-link to device */
41 	struct device *dev;
42 
43 	/* number of slots per controller */
44 	unsigned nr_slots:2;
45 
46 	/* set if your board has components or wiring that limits the
47 	 * maximum frequency on the MMC bus */
48 	unsigned int max_freq;
49 
50 	/* To handle board related suspend/resume functionality for MMC */
51 	int (*suspend)(struct device *dev, int slot);
52 	int (*resume)(struct device *dev, int slot);
53 
54 	/* Return context loss count due to PM states changing */
55 	int (*get_context_loss_count)(struct device *dev);
56 
57 	/* Integrating attributes from the omap_hwmod layer */
58 	u8 controller_flags;
59 
60 	/* Register offset deviation */
61 	u16 reg_offset;
62 
63 	struct omap_hsmmc_slot_data {
64 		/*
65 		 * 4/8 wires and any additional host capabilities
66 		 * need to OR'd all capabilities (ref. linux/mmc/host.h)
67 		 */
68 		u32 caps;	/* Used for the MMC driver on 2430 and later */
69 		u32 pm_caps;	/* PM capabilities of the mmc */
70 
71 		/* switch pin can be for card detect (default) or card cover */
72 		unsigned cover:1;
73 
74 		/* use the internal clock */
75 		unsigned internal_clock:1;
76 
77 		/* nonremovable e.g. eMMC */
78 		unsigned nonremovable:1;
79 
80 		/* eMMC does not handle power off when not in sleep state */
81 		unsigned no_regulator_off_init:1;
82 
83 		/* we can put the features above into this variable */
84 #define HSMMC_HAS_PBIAS		(1 << 0)
85 #define HSMMC_HAS_UPDATED_RESET	(1 << 1)
86 #define HSMMC_HAS_HSPE_SUPPORT	(1 << 2)
87 		unsigned features;
88 
89 		int switch_pin;			/* gpio (card detect) */
90 		int gpio_wp;			/* gpio (write protect) */
91 
92 		int (*set_power)(struct device *dev, int slot,
93 				 int power_on, int vdd);
94 		int (*get_ro)(struct device *dev, int slot);
95 		void (*remux)(struct device *dev, int slot, int power_on);
96 		/* Call back before enabling / disabling regulators */
97 		void (*before_set_reg)(struct device *dev, int slot,
98 				       int power_on, int vdd);
99 		/* Call back after enabling / disabling regulators */
100 		void (*after_set_reg)(struct device *dev, int slot,
101 				      int power_on, int vdd);
102 		/* if we have special card, init it using this callback */
103 		void (*init_card)(struct mmc_card *card);
104 
105 		/* return MMC cover switch state, can be NULL if not supported.
106 		 *
107 		 * possible return values:
108 		 *   0 - closed
109 		 *   1 - open
110 		 */
111 		int (*get_cover_state)(struct device *dev, int slot);
112 
113 		const char *name;
114 		u32 ocr_mask;
115 
116 		/* Card detection IRQs */
117 		int card_detect_irq;
118 
119 		int (*card_detect)(struct device *dev, int slot);
120 	} slots[OMAP_HSMMC_MAX_SLOTS];
121 };
122