include/linux/platform_data/mmc-omap.h

   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_MMC_MAX_SLOTS      2
  12
  13 /*
  14  * struct omap_mmc_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 mmc_card;
  34
  35 struct omap_mmc_dev_attr {
  36         u8 flags;
  37 };
  38
  39 struct omap_mmc_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         /* switch the bus to a new slot */
  51         int (*switch_slot)(struct device *dev, int slot);
  52         /* initialize board-specific MMC functionality, can be NULL if
  53          * not supported */
  54         int (*init)(struct device *dev);
  55         void (*cleanup)(struct device *dev);
  56         void (*shutdown)(struct device *dev);
  57
  58         /* To handle board related suspend/resume functionality for MMC */
  59         int (*suspend)(struct device *dev, int slot);
  60         int (*resume)(struct device *dev, int slot);
  61
  62         /* Return context loss count due to PM states changing */
  63         int (*get_context_loss_count)(struct device *dev);
  64
  65         /* Integrating attributes from the omap_hwmod layer */
  66         u8 controller_flags;
  67
  68         /* Register offset deviation */
  69         u16 reg_offset;
  70
  71         struct omap_mmc_slot_data {
  72
  73                 /*
  74                  * 4/8 wires and any additional host capabilities
  75                  * need to OR'd all capabilities (ref. linux/mmc/host.h)
  76                  */
  77                 u8  wires;      /* Used for the MMC driver on omap1 and 2420 */
  78                 u32 caps;       /* Used for the MMC driver on 2430 and later */
  79                 u32 pm_caps;    /* PM capabilities of the mmc */
  80
  81                 /*
  82                  * nomux means "standard" muxing is wrong on this board, and
  83                  * that board-specific code handled it before common init logic.
  84                  */
  85                 unsigned nomux:1;
  86
  87                 /* switch pin can be for card detect (default) or card cover */
  88                 unsigned cover:1;
  89
  90                 /* use the internal clock */
  91                 unsigned internal_clock:1;
  92
  93                 /* nonremovable e.g. eMMC */
  94                 unsigned nonremovable:1;
  95
  96                 /* Try to sleep or power off when possible */
  97                 unsigned power_saving:1;
  98
  99                 /* If using power_saving and the MMC power is not to go off */
 100                 unsigned no_off:1;
 101
 102                 /* eMMC does not handle power off when not in sleep state */
 103                 unsigned no_regulator_off_init:1;
 104
 105                 /* Regulator off remapped to sleep */
 106                 unsigned vcc_aux_disable_is_sleep:1;
 107
 108                 /* we can put the features above into this variable */
 109 #define HSMMC_HAS_PBIAS         (1 << 0)
 110 #define HSMMC_HAS_UPDATED_RESET (1 << 1)
 111 #define HSMMC_HAS_HSPE_SUPPORT  (1 << 2)
 112 #define MMC_OMAP7XX             (1 << 3)
 113 #define MMC_OMAP15XX            (1 << 4)
 114 #define MMC_OMAP16XX            (1 << 5)
 115                 unsigned features;
 116
 117                 int switch_pin;                 /* gpio (card detect) */
 118                 int gpio_wp;                    /* gpio (write protect) */
 119
 120                 int (*set_bus_mode)(struct device *dev, int slot, int bus_mode);
 121                 int (*set_power)(struct device *dev, int slot,
 122                                  int power_on, int vdd);
 123                 int (*get_ro)(struct device *dev, int slot);
 124                 void (*remux)(struct device *dev, int slot, int power_on);
 125                 /* Call back before enabling / disabling regulators */
 126                 void (*before_set_reg)(struct device *dev, int slot,
 127                                        int power_on, int vdd);
 128                 /* Call back after enabling / disabling regulators */
 129                 void (*after_set_reg)(struct device *dev, int slot,
 130                                       int power_on, int vdd);
 131                 /* if we have special card, init it using this callback */
 132                 void (*init_card)(struct mmc_card *card);
 133
 134                 /* return MMC cover switch state, can be NULL if not supported.
 135                  *
 136                  * possible return values:
 137                  *   0 - closed
 138                  *   1 - open
 139                  */
 140                 int (*get_cover_state)(struct device *dev, int slot);
 141
 142                 const char *name;
 143                 u32 ocr_mask;
 144
 145                 /* Card detection IRQs */
 146                 int card_detect_irq;
 147                 int (*card_detect)(struct device *dev, int slot);
 148
 149                 unsigned int ban_openended:1;
 150
 151         } slots[OMAP_MMC_MAX_SLOTS];
 152 };