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 #ifndef __LINUX_USB_MUSB_H 11 #define __LINUX_USB_MUSB_H 12 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 }; 22 23 struct clk; 24 25 enum musb_fifo_style { 26 FIFO_RXTX, 27 FIFO_TX, 28 FIFO_RX 29 } __attribute__ ((packed)); 30 31 enum musb_buf_mode { 32 BUF_SINGLE, 33 BUF_DOUBLE 34 } __attribute__ ((packed)); 35 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 }; 42 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 } 50 51 #define MUSB_EP_FIFO_SINGLE(ep, st, pkt) \ 52 MUSB_EP_FIFO(ep, st, BUF_SINGLE, pkt) 53 54 #define MUSB_EP_FIFO_DOUBLE(ep, st, pkt) \ 55 MUSB_EP_FIFO(ep, st, BUF_DOUBLE, pkt) 56 57 struct musb_hdrc_eps_bits { 58 const char name[16]; 59 u8 bits; 60 }; 61 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 66 /* MUSB configuration-specific details */ 67 unsigned multipoint:1; /* multipoint device */ 68 unsigned dyn_fifo:1 __deprecated; /* supports dynamic fifo sizing */ 69 unsigned soft_con:1 __deprecated; /* soft connect required */ 70 unsigned utm_16:1 __deprecated; /* utm data witdh is 16 bits */ 71 unsigned big_endian:1; /* true if CPU uses big-endian */ 72 unsigned mult_bulk_tx:1; /* Tx ep required for multbulk pkts */ 73 unsigned mult_bulk_rx:1; /* Rx ep required for multbulk pkts */ 74 unsigned high_iso_tx:1; /* Tx ep required for HB iso */ 75 unsigned high_iso_rx:1; /* Rx ep required for HD iso */ 76 unsigned dma:1 __deprecated; /* supports DMA */ 77 unsigned vendor_req:1 __deprecated; /* vendor registers required */ 78 79 /* need to explicitly de-assert the port reset after resume? */ 80 unsigned host_port_deassert_reset_at_resume:1; 81 82 u8 num_eps; /* number of endpoints _with_ ep0 */ 83 u8 dma_channels __deprecated; /* number of dma channels */ 84 u8 dyn_fifo_size; /* dynamic size in bytes */ 85 u8 vendor_ctrl __deprecated; /* vendor control reg width */ 86 u8 vendor_stat __deprecated; /* vendor status reg witdh */ 87 u8 dma_req_chan __deprecated; /* bitmask for required dma channels */ 88 u8 ram_bits; /* ram address size */ 89 90 struct musb_hdrc_eps_bits *eps_bits __deprecated; 91 #ifdef CONFIG_BLACKFIN 92 /* A GPIO controlling VRSEL in Blackfin */ 93 unsigned int gpio_vrsel; 94 unsigned int gpio_vrsel_active; 95 /* musb CLKIN in Blackfin in MHZ */ 96 unsigned char clkin; 97 #endif 98 u32 maximum_speed; 99 }; 100 101 struct musb_hdrc_platform_data { 102 /* MUSB_HOST, MUSB_PERIPHERAL, or MUSB_OTG */ 103 u8 mode; 104 105 /* for clk_get() */ 106 const char *clock; 107 108 /* (HOST or OTG) switch VBUS on/off */ 109 int (*set_vbus)(struct device *dev, int is_on); 110 111 /* (HOST or OTG) mA/2 power supplied on (default = 8mA) */ 112 u8 power; 113 114 /* (PERIPHERAL) mA/2 max power consumed (default = 100mA) */ 115 u8 min_power; 116 117 /* (HOST or OTG) msec/2 after VBUS on till power good */ 118 u8 potpgt; 119 120 /* (HOST or OTG) program PHY for external Vbus */ 121 unsigned extvbus:1; 122 123 /* Power the device on or off */ 124 int (*set_power)(int state); 125 126 /* MUSB configuration-specific details */ 127 const struct musb_hdrc_config *config; 128 129 /* Architecture specific board data */ 130 void *board_data; 131 132 /* Platform specific struct musb_ops pointer */ 133 const void *platform_ops; 134 }; 135 136 enum musb_vbus_id_status { 137 MUSB_UNKNOWN = 0, 138 MUSB_ID_GROUND, 139 MUSB_ID_FLOAT, 140 MUSB_VBUS_VALID, 141 MUSB_VBUS_OFF, 142 }; 143 144 #if IS_ENABLED(CONFIG_USB_MUSB_HDRC) 145 void musb_mailbox(enum musb_vbus_id_status status); 146 #else 147 static inline void musb_mailbox(enum musb_vbus_id_status status) 148 { 149 } 150 #endif 151 152 /* TUSB 6010 support */ 153 154 #define TUSB6010_OSCCLK_60 16667 /* psec/clk @ 60.0 MHz */ 155 #define TUSB6010_REFCLK_24 41667 /* psec/clk @ 24.0 MHz XI */ 156 #define TUSB6010_REFCLK_19 52083 /* psec/clk @ 19.2 MHz CLKIN */ 157 158 #ifdef CONFIG_ARCH_OMAP2 159 160 extern int __init tusb6010_setup_interface( 161 struct musb_hdrc_platform_data *data, 162 unsigned ps_refclk, unsigned waitpin, 163 unsigned async_cs, unsigned sync_cs, 164 unsigned irq, unsigned dmachan); 165 166 extern int tusb6010_platform_retime(unsigned is_refclk); 167 168 #endif /* OMAP2 */ 169 170 #endif /* __LINUX_USB_MUSB_H */ 171