1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * MMC definitions for OMAP2
4 *
5 * Copyright (C) 2006 Nokia Corporation
6 */
7
8#define OMAP_MMC_MAX_SLOTS	2
9
10struct mmc_card;
11
12struct omap_mmc_platform_data {
13	/* back-link to device */
14	struct device *dev;
15
16	/* number of slots per controller */
17	unsigned nr_slots:2;
18
19	/* set if your board has components or wiring that limits the
20	 * maximum frequency on the MMC bus */
21	unsigned int max_freq;
22
23	/* initialize board-specific MMC functionality, can be NULL if
24	 * not supported */
25	int (*init)(struct device *dev);
26	void (*cleanup)(struct device *dev);
27	void (*shutdown)(struct device *dev);
28
29	/* Return context loss count due to PM states changing */
30	int (*get_context_loss_count)(struct device *dev);
31
32	/* Integrating attributes from the omap_hwmod layer */
33	u8 controller_flags;
34
35	/* Register offset deviation */
36	u16 reg_offset;
37
38	struct omap_mmc_slot_data {
39
40		/*
41		 * 4/8 wires and any additional host capabilities
42		 * need to OR'd all capabilities (ref. linux/mmc/host.h)
43		 */
44		u8  wires;	/* Used for the MMC driver on omap1 and 2420 */
45		u32 caps;	/* Used for the MMC driver on 2430 and later */
46		u32 pm_caps;	/* PM capabilities of the mmc */
47
48		/*
49		 * nomux means "standard" muxing is wrong on this board, and
50		 * that board-specific code handled it before common init logic.
51		 */
52		unsigned nomux:1;
53
54		/* switch pin can be for card detect (default) or card cover */
55		unsigned cover:1;
56
57		/* use the internal clock */
58		unsigned internal_clock:1;
59
60		/* nonremovable e.g. eMMC */
61		unsigned nonremovable:1;
62
63		/* Try to sleep or power off when possible */
64		unsigned power_saving:1;
65
66		/* If using power_saving and the MMC power is not to go off */
67		unsigned no_off:1;
68
69		/* eMMC does not handle power off when not in sleep state */
70		unsigned no_regulator_off_init:1;
71
72		/* Regulator off remapped to sleep */
73		unsigned vcc_aux_disable_is_sleep:1;
74
75		/* we can put the features above into this variable */
76#define MMC_OMAP7XX		(1 << 3)
77#define MMC_OMAP15XX		(1 << 4)
78#define MMC_OMAP16XX		(1 << 5)
79		unsigned features;
80
81		int switch_pin;			/* gpio (card detect) */
82		int gpio_wp;			/* gpio (write protect) */
83
84		int (*set_bus_mode)(struct device *dev, int slot, int bus_mode);
85		int (*set_power)(struct device *dev, int slot,
86				 int power_on, int vdd);
87		int (*get_ro)(struct device *dev, int slot);
88		void (*remux)(struct device *dev, int slot, int power_on);
89		/* Call back before enabling / disabling regulators */
90		void (*before_set_reg)(struct device *dev, int slot,
91				       int power_on, int vdd);
92		/* Call back after enabling / disabling regulators */
93		void (*after_set_reg)(struct device *dev, int slot,
94				      int power_on, int vdd);
95		/* if we have special card, init it using this callback */
96		void (*init_card)(struct mmc_card *card);
97
98		/* return MMC cover switch state, can be NULL if not supported.
99		 *
100		 * possible return values:
101		 *   0 - closed
102		 *   1 - open
103		 */
104		int (*get_cover_state)(struct device *dev, int slot);
105
106		const char *name;
107		u32 ocr_mask;
108
109		/* Card detection */
110		int (*card_detect)(struct device *dev, int slot);
111
112		unsigned int ban_openended:1;
113
114	} slots[OMAP_MMC_MAX_SLOTS];
115};
116
117extern void omap_mmc_notify_cover_event(struct device *dev, int slot,
118					int is_closed);
119