include/linux/usb/musb.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * This is used to for host and peripheral modes of the driver for
   4  * Inventra (Multidrop) Highspeed Dual-Role Controllers:  (M)HDRC.
   5  *
   6  * Board initialization should put one of these into dev->platform_data,
   7  * probably on some platform_device named "musb-hdrc".  It encapsulates
   8  * key configuration differences between boards.
   9  */
  10
  11 #ifndef __LINUX_USB_MUSB_H
  12 #define __LINUX_USB_MUSB_H
  13
  14 /* The USB role is defined by the connector used on the board, so long as
  15  * standards are being followed.  (Developer boards sometimes won't.)
  16  */
  17 enum musb_mode {
  18         MUSB_UNDEFINED = 0,
  19         MUSB_HOST,              /* A or Mini-A connector */
  20         MUSB_PERIPHERAL,        /* B or Mini-B connector */
  21         MUSB_OTG                /* Mini-AB connector */
  22 };
  23
  24 struct clk;
  25
  26 enum musb_fifo_style {
  27         FIFO_RXTX,
  28         FIFO_TX,
  29         FIFO_RX
  30 } __attribute__ ((packed));
  31
  32 enum musb_buf_mode {
  33         BUF_SINGLE,
  34         BUF_DOUBLE
  35 } __attribute__ ((packed));
  36
  37 struct musb_fifo_cfg {
  38         u8                      hw_ep_num;
  39         enum musb_fifo_style    style;
  40         enum musb_buf_mode      mode;
  41         u16                     maxpacket;
  42 };
  43
  44 #define MUSB_EP_FIFO(ep, st, m, pkt)            \
  45 {                                               \
  46         .hw_ep_num      = ep,                   \
  47         .style          = st,                   \
  48         .mode           = m,                    \
  49         .maxpacket      = pkt,                  \
  50 }
  51
  52 #define MUSB_EP_FIFO_SINGLE(ep, st, pkt)        \
  53         MUSB_EP_FIFO(ep, st, BUF_SINGLE, pkt)
  54
  55 #define MUSB_EP_FIFO_DOUBLE(ep, st, pkt)        \
  56         MUSB_EP_FIFO(ep, st, BUF_DOUBLE, pkt)
  57
  58 struct musb_hdrc_eps_bits {
  59         const char      name[16];
  60         u8              bits;
  61 };
  62
  63 struct musb_hdrc_config {
  64         struct musb_fifo_cfg    *fifo_cfg;      /* board fifo configuration */
  65         unsigned                fifo_cfg_size;  /* size of the fifo configuration */
  66
  67         /* MUSB configuration-specific details */
  68         unsigned        multipoint:1;   /* multipoint device */
  69         unsigned        dyn_fifo:1 __deprecated; /* supports dynamic fifo sizing */
  70
  71         /* need to explicitly de-assert the port reset after resume? */
  72         unsigned        host_port_deassert_reset_at_resume:1;
  73
  74         u8              num_eps;        /* number of endpoints _with_ ep0 */
  75         u8              ram_bits;       /* ram address size */
  76
  77         u32             maximum_speed;
  78 };
  79
  80 struct musb_hdrc_platform_data {
  81         /* MUSB_HOST, MUSB_PERIPHERAL, or MUSB_OTG */
  82         u8              mode;
  83
  84         /* for clk_get() */
  85         const char      *clock;
  86
  87         /* (HOST or OTG) switch VBUS on/off */
  88         int             (*set_vbus)(struct device *dev, int is_on);
  89
  90         /* (HOST or OTG) mA/2 power supplied on (default = 8mA) */
  91         u8              power;
  92
  93         /* (PERIPHERAL) mA/2 max power consumed (default = 100mA) */
  94         u8              min_power;
  95
  96         /* (HOST or OTG) msec/2 after VBUS on till power good */
  97         u8              potpgt;
  98
  99         /* (HOST or OTG) program PHY for external Vbus */
 100         unsigned        extvbus:1;
 101
 102         /* Power the device on or off */
 103         int             (*set_power)(int state);
 104
 105         /* MUSB configuration-specific details */
 106         const struct musb_hdrc_config *config;
 107
 108         /* Architecture specific board data     */
 109         void            *board_data;
 110
 111         /* Platform specific struct musb_ops pointer */
 112         const void      *platform_ops;
 113 };
 114
 115 enum musb_vbus_id_status {
 116         MUSB_UNKNOWN = 0,
 117         MUSB_ID_GROUND,
 118         MUSB_ID_FLOAT,
 119         MUSB_VBUS_VALID,
 120         MUSB_VBUS_OFF,
 121 };
 122
 123 #if IS_ENABLED(CONFIG_USB_MUSB_HDRC)
 124 int musb_mailbox(enum musb_vbus_id_status status);
 125 #else
 126 static inline int musb_mailbox(enum musb_vbus_id_status status)
 127 {
 128         return 0;
 129 }
 130 #endif
 131
 132 /* TUSB 6010 support */
 133
 134 #define TUSB6010_OSCCLK_60      16667   /* psec/clk @ 60.0 MHz */
 135 #define TUSB6010_REFCLK_24      41667   /* psec/clk @ 24.0 MHz XI */
 136 #define TUSB6010_REFCLK_19      52083   /* psec/clk @ 19.2 MHz CLKIN */
 137
 138 #ifdef  CONFIG_ARCH_OMAP2
 139
 140 extern int __init tusb6010_setup_interface(
 141                 struct musb_hdrc_platform_data *data,
 142                 unsigned ps_refclk, unsigned waitpin,
 143                 unsigned async_cs, unsigned sync_cs,
 144                 unsigned irq, unsigned dmachan);
 145
 146 extern int tusb6010_platform_retime(unsigned is_refclk);
 147
 148 #endif  /* OMAP2 */
 149
 150 #endif /* __LINUX_USB_MUSB_H */