include/linux/usb/musb.h

   1 /*
   2  * This is used to for host and peripheral modes of the driver for
   3  * Inventra (Multidrop) Highspeed Dual-Role Controllers:  (M)HDRC.
   4  *
   5  * Board initialization should put one of these into dev->platform_data,
   6  * probably on some platform_device named "musb_hdrc".  It encapsulates
   7  * key configuration differences between boards.
   8  */
   9
  10 /* The USB role is defined by the connector used on the board, so long as
  11  * standards are being followed.  (Developer boards sometimes won't.)
  12  */
  13 enum musb_mode {
  14         MUSB_UNDEFINED = 0,
  15         MUSB_HOST,              /* A or Mini-A connector */
  16         MUSB_PERIPHERAL,        /* B or Mini-B connector */
  17         MUSB_OTG                /* Mini-AB connector */
  18 };
  19
  20 struct clk;
  21
  22 struct musb_hdrc_eps_bits {
  23         const char      name[16];
  24         u8              bits;
  25 };
  26
  27 struct musb_hdrc_config {
  28         /* MUSB configuration-specific details */
  29         unsigned        multipoint:1;   /* multipoint device */
  30         unsigned        dyn_fifo:1;     /* supports dynamic fifo sizing */
  31         unsigned        soft_con:1;     /* soft connect required */
  32         unsigned        utm_16:1;       /* utm data witdh is 16 bits */
  33         unsigned        big_endian:1;   /* true if CPU uses big-endian */
  34         unsigned        mult_bulk_tx:1; /* Tx ep required for multbulk pkts */
  35         unsigned        mult_bulk_rx:1; /* Rx ep required for multbulk pkts */
  36         unsigned        high_iso_tx:1;  /* Tx ep required for HB iso */
  37         unsigned        high_iso_rx:1;  /* Rx ep required for HD iso */
  38         unsigned        dma:1;          /* supports DMA */
  39         unsigned        vendor_req:1;   /* vendor registers required */
  40
  41         u8              num_eps;        /* number of endpoints _with_ ep0 */
  42         u8              dma_channels;   /* number of dma channels */
  43         u8              dyn_fifo_size;  /* dynamic size in bytes */
  44         u8              vendor_ctrl;    /* vendor control reg width */
  45         u8              vendor_stat;    /* vendor status reg witdh */
  46         u8              dma_req_chan;   /* bitmask for required dma channels */
  47         u8              ram_bits;       /* ram address size */
  48
  49         struct musb_hdrc_eps_bits *eps_bits;
  50 #ifdef CONFIG_BLACKFIN
  51         /* A GPIO controlling VRSEL in Blackfin */
  52         unsigned int    gpio_vrsel;
  53 #endif
  54
  55 };
  56
  57 struct musb_hdrc_platform_data {
  58         /* MUSB_HOST, MUSB_PERIPHERAL, or MUSB_OTG */
  59         u8              mode;
  60
  61         /* for clk_get() */
  62         const char      *clock;
  63
  64         /* (HOST or OTG) switch VBUS on/off */
  65         int             (*set_vbus)(struct device *dev, int is_on);
  66
  67         /* (HOST or OTG) mA/2 power supplied on (default = 8mA) */
  68         u8              power;
  69
  70         /* (PERIPHERAL) mA/2 max power consumed (default = 100mA) */
  71         u8              min_power;
  72
  73         /* (HOST or OTG) msec/2 after VBUS on till power good */
  74         u8              potpgt;
  75
  76         /* Power the device on or off */
  77         int             (*set_power)(int state);
  78
  79         /* Turn device clock on or off */
  80         int             (*set_clock)(struct clk *clock, int is_on);
  81
  82         /* MUSB configuration-specific details */
  83         struct musb_hdrc_config *config;
  84 };
  85
  86
  87 /* TUSB 6010 support */
  88
  89 #define TUSB6010_OSCCLK_60      16667   /* psec/clk @ 60.0 MHz */
  90 #define TUSB6010_REFCLK_24      41667   /* psec/clk @ 24.0 MHz XI */
  91 #define TUSB6010_REFCLK_19      52083   /* psec/clk @ 19.2 MHz CLKIN */
  92
  93 #ifdef  CONFIG_ARCH_OMAP2
  94
  95 extern int __init tusb6010_setup_interface(
  96                 struct musb_hdrc_platform_data *data,
  97                 unsigned ps_refclk, unsigned waitpin,
  98                 unsigned async_cs, unsigned sync_cs,
  99                 unsigned irq, unsigned dmachan);
 100
 101 extern int tusb6010_platform_retime(unsigned is_refclk);
 102
 103 #endif  /* OMAP2 */