drivers/usb/gadget/langwell_udc.h

   1 /*
   2  * Intel Langwell USB Device Controller driver
   3  * Copyright (C) 2008-2009, Intel Corporation.
   4  *
   5  * This program is free software; you can redistribute it and/or modify it
   6  * under the terms and conditions of the GNU General Public License,
   7  * version 2, as published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope it will be useful, but WITHOUT
  10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  12  * more details.
  13  *
  14  * You should have received a copy of the GNU General Public License along with
  15  * this program; if not, write to the Free Software Foundation, Inc.,
  16  * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
  17  *
  18  */
  19
  20 #include <linux/usb/langwell_udc.h>
  21
  22 #if defined(CONFIG_USB_LANGWELL_OTG)
  23 #include <linux/usb/langwell_otg.h>
  24 #endif
  25
  26
  27 /*-------------------------------------------------------------------------*/
  28
  29 /* driver data structures and utilities */
  30
  31 /*
  32  * dTD: Device Endpoint Transfer Descriptor
  33  * describe to the device controller the location and quantity of
  34  * data to be send/received for given transfer
  35  */
  36 struct langwell_dtd {
  37         u32     dtd_next;
  38 /* bits 31:5, next transfer element pointer */
  39 #define DTD_NEXT(d)     (((d)>>5)&0x7ffffff)
  40 #define DTD_NEXT_MASK   (0x7ffffff << 5)
  41 /* terminate */
  42 #define DTD_TERM        BIT(0)
  43         /* bits 7:0, execution back states */
  44         u32     dtd_status:8;
  45 #define DTD_STATUS(d)   (((d)>>0)&0xff)
  46 #define DTD_STS_ACTIVE  BIT(7)  /* active */
  47 #define DTD_STS_HALTED  BIT(6)  /* halted */
  48 #define DTD_STS_DBE     BIT(5)  /* data buffer error */
  49 #define DTD_STS_TRE     BIT(3)  /* transaction error  */
  50         /* bits 9:8 */
  51         u32     dtd_res0:2;
  52         /* bits 11:10, multipier override */
  53         u32     dtd_multo:2;
  54 #define DTD_MULTO       (BIT(11) | BIT(10))
  55         /* bits 14:12 */
  56         u32     dtd_res1:3;
  57         /* bit 15, interrupt on complete */
  58         u32     dtd_ioc:1;
  59 #define DTD_IOC         BIT(15)
  60         /* bits 30:16, total bytes */
  61         u32     dtd_total:15;
  62 #define DTD_TOTAL(d)    (((d)>>16)&0x7fff)
  63 #define DTD_MAX_TRANSFER_LENGTH 0x4000
  64         /* bit 31 */
  65         u32     dtd_res2:1;
  66         /* dTD buffer pointer page 0 to 4 */
  67         u32     dtd_buf[5];
  68 #define DTD_OFFSET_MASK 0xfff
  69 /* bits 31:12, buffer pointer */
  70 #define DTD_BUFFER(d)   (((d)>>12)&0x3ff)
  71 /* bits 11:0, current offset */
  72 #define DTD_C_OFFSET(d) (((d)>>0)&0xfff)
  73 /* bits 10:0, frame number */
  74 #define DTD_FRAME(d)    (((d)>>0)&0x7ff)
  75
  76         /* driver-private parts */
  77
  78         /* dtd dma address */
  79         dma_addr_t              dtd_dma;
  80         /* next dtd virtual address */
  81         struct langwell_dtd     *next_dtd_virt;
  82 };
  83
  84
  85 /*
  86  * dQH: Device Endpoint Queue Head
  87  * describe where all transfers are managed
  88  * 48-byte data structure, aligned on 64-byte boundary
  89  *
  90  * These are associated with dTD structure
  91  */
  92 struct langwell_dqh {
  93         /* endpoint capabilities and characteristics */
  94         u32     dqh_res0:15;    /* bits 14:0 */
  95         u32     dqh_ios:1;      /* bit 15, interrupt on setup */
  96 #define DQH_IOS         BIT(15)
  97         u32     dqh_mpl:11;     /* bits 26:16, maximum packet length */
  98 #define DQH_MPL         (0x7ff << 16)
  99         u32     dqh_res1:2;     /* bits 28:27 */
 100         u32     dqh_zlt:1;      /* bit 29, zero length termination */
 101 #define DQH_ZLT         BIT(29)
 102         u32     dqh_mult:2;     /* bits 31:30 */
 103 #define DQH_MULT        (BIT(30) | BIT(31))
 104
 105         /* current dTD pointer */
 106         u32     dqh_current;    /* locate the transfer in progress */
 107 #define DQH_C_DTD(e)    \
 108         (((e)>>5)&0x7ffffff)    /* bits 31:5, current dTD pointer */
 109
 110         /* transfer overlay, hardware parts of a struct langwell_dtd */
 111         u32     dtd_next;
 112         u32     dtd_status:8;   /* bits 7:0, execution back states */
 113         u32     dtd_res0:2;     /* bits 9:8 */
 114         u32     dtd_multo:2;    /* bits 11:10, multipier override */
 115         u32     dtd_res1:3;     /* bits 14:12 */
 116         u32     dtd_ioc:1;      /* bit 15, interrupt on complete */
 117         u32     dtd_total:15;   /* bits 30:16, total bytes */
 118         u32     dtd_res2:1;     /* bit 31 */
 119         u32     dtd_buf[5];     /* dTD buffer pointer page 0 to 4 */
 120
 121         u32     dqh_res2;
 122         struct usb_ctrlrequest  dqh_setup;      /* setup packet buffer */
 123 } __attribute__ ((aligned(64)));
 124
 125
 126 /* endpoint data structure */
 127 struct langwell_ep {
 128         struct usb_ep           ep;
 129         dma_addr_t              dma;
 130         struct langwell_udc     *dev;
 131         unsigned long           irqs;
 132         struct list_head        queue;
 133         struct langwell_dqh     *dqh;
 134         const struct usb_endpoint_descriptor    *desc;
 135         char                    name[14];
 136         unsigned                stopped:1,
 137                                 ep_type:2,
 138                                 ep_num:8;
 139 };
 140
 141
 142 /* request data structure */
 143 struct langwell_request {
 144         struct usb_request      req;
 145         struct langwell_dtd     *dtd, *head, *tail;
 146         struct langwell_ep      *ep;
 147         dma_addr_t              dtd_dma;
 148         struct list_head        queue;
 149         unsigned                dtd_count;
 150         unsigned                mapped:1;
 151 };
 152
 153
 154 /* ep0 transfer state */
 155 enum ep0_state {
 156         WAIT_FOR_SETUP,
 157         DATA_STATE_XMIT,
 158         DATA_STATE_NEED_ZLP,
 159         WAIT_FOR_OUT_STATUS,
 160         DATA_STATE_RECV,
 161 };
 162
 163
 164 /* device suspend state */
 165 enum lpm_state {
 166         LPM_L0, /* on */
 167         LPM_L1, /* LPM L1 sleep */
 168         LPM_L2, /* suspend */
 169         LPM_L3, /* off */
 170 };
 171
 172
 173 /* device data structure */
 174 struct langwell_udc {
 175         /* each pci device provides one gadget, several endpoints */
 176         struct usb_gadget       gadget;
 177         spinlock_t              lock;   /* device lock */
 178         struct langwell_ep      *ep;
 179         struct usb_gadget_driver        *driver;
 180         struct otg_transceiver  *transceiver;
 181         u8                      dev_addr;
 182         u32                     usb_state;
 183         u32                     resume_state;
 184         u32                     bus_reset;
 185         enum lpm_state          lpm_state;
 186         enum ep0_state          ep0_state;
 187         u32                     ep0_dir;
 188         u16                     dciversion;
 189         unsigned                ep_max;
 190         unsigned                devcap:1,
 191                                 enabled:1,
 192                                 region:1,
 193                                 got_irq:1,
 194                                 powered:1,
 195                                 remote_wakeup:1,
 196                                 rate:1,
 197                                 is_reset:1,
 198                                 softconnected:1,
 199                                 vbus_active:1,
 200                                 suspended:1,
 201                                 stopped:1,
 202                                 lpm:1;  /* LPM capability */
 203
 204         /* pci state used to access those endpoints */
 205         struct pci_dev          *pdev;
 206
 207         /* Langwell otg transceiver */
 208         struct langwell_otg     *lotg;
 209
 210         /* control registers */
 211         struct langwell_cap_regs        __iomem *cap_regs;
 212         struct langwell_op_regs         __iomem *op_regs;
 213
 214         struct usb_ctrlrequest  local_setup_buff;
 215         struct langwell_dqh     *ep_dqh;
 216         size_t                  ep_dqh_size;
 217         dma_addr_t              ep_dqh_dma;
 218
 219         /* ep0 status request */
 220         struct langwell_request *status_req;
 221
 222         /* dma pool */
 223         struct dma_pool         *dtd_pool;
 224
 225         /* make sure release() is done */
 226         struct completion       *done;
 227 };
 228