musb: select fifo_mode at runtime
[sitara-epos/sitara-epos-kernel.git] / 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  */
10 #ifndef __LINUX_USB_MUSB_H
11 #define __LINUX_USB_MUSB_H
13 /* The USB role is defined by the connector used on the board, so long as
14  * standards are being followed.  (Developer boards sometimes won't.)
15  */
16 enum musb_mode {
17         MUSB_UNDEFINED = 0,
18         MUSB_HOST,              /* A or Mini-A connector */
19         MUSB_PERIPHERAL,        /* B or Mini-B connector */
20         MUSB_OTG                /* Mini-AB connector */
21 };
23 struct clk;
25 enum musb_fifo_style {
26         FIFO_RXTX,
27         FIFO_TX,
28         FIFO_RX
29 } __attribute__ ((packed));
31 enum musb_buf_mode {
32         BUF_SINGLE,
33         BUF_DOUBLE
34 } __attribute__ ((packed));
36 struct musb_fifo_cfg {
37         u8                      hw_ep_num;
38         enum musb_fifo_style    style;
39         enum musb_buf_mode      mode;
40         u16                     maxpacket;
41 };
43 #define MUSB_EP_FIFO(ep, st, m, pkt)            \
44 {                                               \
45         .hw_ep_num      = ep,                   \
46         .style          = st,                   \
47         .mode           = m,                    \
48         .maxpacket      = pkt,                  \
49 }
51 #define MUSB_EP_FIFO_SINGLE(ep, st, pkt)        \
52         MUSB_EP_FIFO(ep, st, BUF_SINGLE, pkt)
54 #define MUSB_EP_FIFO_DOUBLE(ep, st, pkt)        \
55         MUSB_EP_FIFO(ep, st, BUF_DOUBLE, pkt)
57 struct musb_hdrc_eps_bits {
58         const char      name[16];
59         u8              bits;
60 };
62 struct musb_hdrc_config {
63         struct musb_fifo_cfg    *fifo_cfg;      /* board fifo configuration */
64         unsigned                fifo_cfg_size;  /* size of the fifo configuration */
65         unsigned short          fifo_mode;      /* fifo mode to be selected */
67         /* MUSB configuration-specific details */
68         unsigned        multipoint:1;   /* multipoint device */
69         unsigned        dyn_fifo:1 __deprecated; /* supports dynamic fifo sizing */
70         unsigned        soft_con:1 __deprecated; /* soft connect required */
71         unsigned        utm_16:1 __deprecated; /* utm data witdh is 16 bits */
72         unsigned        big_endian:1;   /* true if CPU uses big-endian */
73         unsigned        mult_bulk_tx:1; /* Tx ep required for multbulk pkts */
74         unsigned        mult_bulk_rx:1; /* Rx ep required for multbulk pkts */
75         unsigned        high_iso_tx:1;  /* Tx ep required for HB iso */
76         unsigned        high_iso_rx:1;  /* Rx ep required for HD iso */
77         unsigned        dma:1 __deprecated; /* supports DMA */
78         unsigned        vendor_req:1 __deprecated; /* vendor registers required */
80         u8              num_eps;        /* number of endpoints _with_ ep0 */
81         u8              dma_channels __deprecated; /* number of dma channels */
82         u8              dyn_fifo_size;  /* dynamic size in bytes */
83         u8              vendor_ctrl __deprecated; /* vendor control reg width */
84         u8              vendor_stat __deprecated; /* vendor status reg witdh */
85         u8              dma_req_chan __deprecated; /* bitmask for required dma channels */
86         u8              ram_bits;       /* ram address size */
88         struct musb_hdrc_eps_bits *eps_bits __deprecated;
89 #ifdef CONFIG_BLACKFIN
90         /* A GPIO controlling VRSEL in Blackfin */
91         unsigned int    gpio_vrsel;
92         unsigned int    gpio_vrsel_active;
93         /* musb CLKIN in Blackfin in MHZ */
94         unsigned char   clkin;
95 #endif
97 };
99 struct musb_hdrc_platform_data {
100         /* MUSB_HOST, MUSB_PERIPHERAL, or MUSB_OTG */
101         u8              mode;
103         /* for clk_get() */
104         const char      *clock;
106         /* (HOST or OTG) switch VBUS on/off */
107         int             (*set_vbus)(struct device *dev, int is_on);
109         /* (HOST or OTG) mA/2 power supplied on (default = 8mA) */
110         u8              power;
112         /* (PERIPHERAL) mA/2 max power consumed (default = 100mA) */
113         u8              min_power;
115         /* (HOST or OTG) msec/2 after VBUS on till power good */
116         u8              potpgt;
118         /* (HOST or OTG) program PHY for external Vbus */
119         unsigned        extvbus:1;
121         /* Power the device on or off */
122         int             (*set_power)(int state);
124         /* MUSB configuration-specific details */
125         struct musb_hdrc_config *config;
127         /* Architecture specific board data     */
128         void            *board_data;
130         /* Platform specific struct musb_ops pointer */
131         const void      *platform_ops;
132 };
135 /* TUSB 6010 support */
137 #define TUSB6010_OSCCLK_60      16667   /* psec/clk @ 60.0 MHz */
138 #define TUSB6010_REFCLK_24      41667   /* psec/clk @ 24.0 MHz XI */
139 #define TUSB6010_REFCLK_19      52083   /* psec/clk @ 19.2 MHz CLKIN */
141 #ifdef  CONFIG_ARCH_OMAP2
143 extern int __init tusb6010_setup_interface(
144                 struct musb_hdrc_platform_data *data,
145                 unsigned ps_refclk, unsigned waitpin,
146                 unsigned async_cs, unsigned sync_cs,
147                 unsigned irq, unsigned dmachan);
149 extern int tusb6010_platform_retime(unsigned is_refclk);
151 #endif  /* OMAP2 */
153 #endif /* __LINUX_USB_MUSB_H */