1 /* 2 * Driver for the Atmel USBA high speed USB device controller 3 * 4 * Copyright (C) 2005-2007 Atmel Corporation 5 * 6 * This program is free software; you can redistribute it and/or modify 7 * it under the terms of the GNU General Public License version 2 as 8 * published by the Free Software Foundation. 9 */ 10 #ifndef __LINUX_USB_GADGET_USBA_UDC_H__ 11 #define __LINUX_USB_GADGET_USBA_UDC_H__ 12 13 /* USB register offsets */ 14 #define USBA_CTRL 0x0000 15 #define USBA_FNUM 0x0004 16 #define USBA_INT_ENB 0x0010 17 #define USBA_INT_STA 0x0014 18 #define USBA_INT_CLR 0x0018 19 #define USBA_EPT_RST 0x001c 20 #define USBA_TST 0x00e0 21 22 /* USB endpoint register offsets */ 23 #define USBA_EPT_CFG 0x0000 24 #define USBA_EPT_CTL_ENB 0x0004 25 #define USBA_EPT_CTL_DIS 0x0008 26 #define USBA_EPT_CTL 0x000c 27 #define USBA_EPT_SET_STA 0x0014 28 #define USBA_EPT_CLR_STA 0x0018 29 #define USBA_EPT_STA 0x001c 30 31 /* USB DMA register offsets */ 32 #define USBA_DMA_NXT_DSC 0x0000 33 #define USBA_DMA_ADDRESS 0x0004 34 #define USBA_DMA_CONTROL 0x0008 35 #define USBA_DMA_STATUS 0x000c 36 37 /* Bitfields in CTRL */ 38 #define USBA_DEV_ADDR_OFFSET 0 39 #define USBA_DEV_ADDR_SIZE 7 40 #define USBA_FADDR_EN (1 << 7) 41 #define USBA_EN_USBA (1 << 8) 42 #define USBA_DETACH (1 << 9) 43 #define USBA_REMOTE_WAKE_UP (1 << 10) 44 #define USBA_PULLD_DIS (1 << 11) 45 46 #if defined(CONFIG_AVR32) 47 #define USBA_ENABLE_MASK USBA_EN_USBA 48 #define USBA_DISABLE_MASK 0 49 #elif defined(CONFIG_ARCH_AT91) 50 #define USBA_ENABLE_MASK (USBA_EN_USBA | USBA_PULLD_DIS) 51 #define USBA_DISABLE_MASK USBA_DETACH 52 #endif /* CONFIG_ARCH_AT91 */ 53 54 /* Bitfields in FNUM */ 55 #define USBA_MICRO_FRAME_NUM_OFFSET 0 56 #define USBA_MICRO_FRAME_NUM_SIZE 3 57 #define USBA_FRAME_NUMBER_OFFSET 3 58 #define USBA_FRAME_NUMBER_SIZE 11 59 #define USBA_FRAME_NUM_ERROR (1 << 31) 60 61 /* Bitfields in INT_ENB/INT_STA/INT_CLR */ 62 #define USBA_HIGH_SPEED (1 << 0) 63 #define USBA_DET_SUSPEND (1 << 1) 64 #define USBA_MICRO_SOF (1 << 2) 65 #define USBA_SOF (1 << 3) 66 #define USBA_END_OF_RESET (1 << 4) 67 #define USBA_WAKE_UP (1 << 5) 68 #define USBA_END_OF_RESUME (1 << 6) 69 #define USBA_UPSTREAM_RESUME (1 << 7) 70 #define USBA_EPT_INT_OFFSET 8 71 #define USBA_EPT_INT_SIZE 16 72 #define USBA_DMA_INT_OFFSET 24 73 #define USBA_DMA_INT_SIZE 8 74 75 /* Bitfields in EPT_RST */ 76 #define USBA_RST_OFFSET 0 77 #define USBA_RST_SIZE 16 78 79 /* Bitfields in USBA_TST */ 80 #define USBA_SPEED_CFG_OFFSET 0 81 #define USBA_SPEED_CFG_SIZE 2 82 #define USBA_TST_J_MODE (1 << 2) 83 #define USBA_TST_K_MODE (1 << 3) 84 #define USBA_TST_PKT_MODE (1 << 4) 85 #define USBA_OPMODE2 (1 << 5) 86 87 /* Bitfields in EPT_CFG */ 88 #define USBA_EPT_SIZE_OFFSET 0 89 #define USBA_EPT_SIZE_SIZE 3 90 #define USBA_EPT_DIR_IN (1 << 3) 91 #define USBA_EPT_TYPE_OFFSET 4 92 #define USBA_EPT_TYPE_SIZE 2 93 #define USBA_BK_NUMBER_OFFSET 6 94 #define USBA_BK_NUMBER_SIZE 2 95 #define USBA_NB_TRANS_OFFSET 8 96 #define USBA_NB_TRANS_SIZE 2 97 #define USBA_EPT_MAPPED (1 << 31) 98 99 /* Bitfields in EPT_CTL/EPT_CTL_ENB/EPT_CTL_DIS */ 100 #define USBA_EPT_ENABLE (1 << 0) 101 #define USBA_AUTO_VALID (1 << 1) 102 #define USBA_INTDIS_DMA (1 << 3) 103 #define USBA_NYET_DIS (1 << 4) 104 #define USBA_DATAX_RX (1 << 6) 105 #define USBA_MDATA_RX (1 << 7) 106 /* Bits 8-15 and 31 enable interrupts for respective bits in EPT_STA */ 107 #define USBA_BUSY_BANK_IE (1 << 18) 108 109 /* Bitfields in EPT_SET_STA/EPT_CLR_STA/EPT_STA */ 110 #define USBA_FORCE_STALL (1 << 5) 111 #define USBA_TOGGLE_CLR (1 << 6) 112 #define USBA_TOGGLE_SEQ_OFFSET 6 113 #define USBA_TOGGLE_SEQ_SIZE 2 114 #define USBA_ERR_OVFLW (1 << 8) 115 #define USBA_RX_BK_RDY (1 << 9) 116 #define USBA_KILL_BANK (1 << 9) 117 #define USBA_TX_COMPLETE (1 << 10) 118 #define USBA_TX_PK_RDY (1 << 11) 119 #define USBA_ISO_ERR_TRANS (1 << 11) 120 #define USBA_RX_SETUP (1 << 12) 121 #define USBA_ISO_ERR_FLOW (1 << 12) 122 #define USBA_STALL_SENT (1 << 13) 123 #define USBA_ISO_ERR_CRC (1 << 13) 124 #define USBA_ISO_ERR_NBTRANS (1 << 13) 125 #define USBA_NAK_IN (1 << 14) 126 #define USBA_ISO_ERR_FLUSH (1 << 14) 127 #define USBA_NAK_OUT (1 << 15) 128 #define USBA_CURRENT_BANK_OFFSET 16 129 #define USBA_CURRENT_BANK_SIZE 2 130 #define USBA_BUSY_BANKS_OFFSET 18 131 #define USBA_BUSY_BANKS_SIZE 2 132 #define USBA_BYTE_COUNT_OFFSET 20 133 #define USBA_BYTE_COUNT_SIZE 11 134 #define USBA_SHORT_PACKET (1 << 31) 135 136 /* Bitfields in DMA_CONTROL */ 137 #define USBA_DMA_CH_EN (1 << 0) 138 #define USBA_DMA_LINK (1 << 1) 139 #define USBA_DMA_END_TR_EN (1 << 2) 140 #define USBA_DMA_END_BUF_EN (1 << 3) 141 #define USBA_DMA_END_TR_IE (1 << 4) 142 #define USBA_DMA_END_BUF_IE (1 << 5) 143 #define USBA_DMA_DESC_LOAD_IE (1 << 6) 144 #define USBA_DMA_BURST_LOCK (1 << 7) 145 #define USBA_DMA_BUF_LEN_OFFSET 16 146 #define USBA_DMA_BUF_LEN_SIZE 16 147 148 /* Bitfields in DMA_STATUS */ 149 #define USBA_DMA_CH_ACTIVE (1 << 1) 150 #define USBA_DMA_END_TR_ST (1 << 4) 151 #define USBA_DMA_END_BUF_ST (1 << 5) 152 #define USBA_DMA_DESC_LOAD_ST (1 << 6) 153 154 /* Constants for SPEED_CFG */ 155 #define USBA_SPEED_CFG_NORMAL 0 156 #define USBA_SPEED_CFG_FORCE_HIGH 2 157 #define USBA_SPEED_CFG_FORCE_FULL 3 158 159 /* Constants for EPT_SIZE */ 160 #define USBA_EPT_SIZE_8 0 161 #define USBA_EPT_SIZE_16 1 162 #define USBA_EPT_SIZE_32 2 163 #define USBA_EPT_SIZE_64 3 164 #define USBA_EPT_SIZE_128 4 165 #define USBA_EPT_SIZE_256 5 166 #define USBA_EPT_SIZE_512 6 167 #define USBA_EPT_SIZE_1024 7 168 169 /* Constants for EPT_TYPE */ 170 #define USBA_EPT_TYPE_CONTROL 0 171 #define USBA_EPT_TYPE_ISO 1 172 #define USBA_EPT_TYPE_BULK 2 173 #define USBA_EPT_TYPE_INT 3 174 175 /* Constants for BK_NUMBER */ 176 #define USBA_BK_NUMBER_ZERO 0 177 #define USBA_BK_NUMBER_ONE 1 178 #define USBA_BK_NUMBER_DOUBLE 2 179 #define USBA_BK_NUMBER_TRIPLE 3 180 181 /* Bit manipulation macros */ 182 #define USBA_BF(name, value) \ 183 (((value) & ((1 << USBA_##name##_SIZE) - 1)) \ 184 << USBA_##name##_OFFSET) 185 #define USBA_BFEXT(name, value) \ 186 (((value) >> USBA_##name##_OFFSET) \ 187 & ((1 << USBA_##name##_SIZE) - 1)) 188 #define USBA_BFINS(name, value, old) \ 189 (((old) & ~(((1 << USBA_##name##_SIZE) - 1) \ 190 << USBA_##name##_OFFSET)) \ 191 | USBA_BF(name, value)) 192 193 /* Register access macros */ 194 #ifdef CONFIG_AVR32 195 #define usba_io_readl __raw_readl 196 #define usba_io_writel __raw_writel 197 #define usba_io_writew __raw_writew 198 #else 199 #define usba_io_readl readl_relaxed 200 #define usba_io_writel writel_relaxed 201 #define usba_io_writew writew_relaxed 202 #endif 203 204 #define usba_readl(udc, reg) \ 205 usba_io_readl((udc)->regs + USBA_##reg) 206 #define usba_writel(udc, reg, value) \ 207 usba_io_writel((value), (udc)->regs + USBA_##reg) 208 #define usba_ep_readl(ep, reg) \ 209 usba_io_readl((ep)->ep_regs + USBA_EPT_##reg) 210 #define usba_ep_writel(ep, reg, value) \ 211 usba_io_writel((value), (ep)->ep_regs + USBA_EPT_##reg) 212 #define usba_dma_readl(ep, reg) \ 213 usba_io_readl((ep)->dma_regs + USBA_DMA_##reg) 214 #define usba_dma_writel(ep, reg, value) \ 215 usba_io_writel((value), (ep)->dma_regs + USBA_DMA_##reg) 216 217 /* Calculate base address for a given endpoint or DMA controller */ 218 #define USBA_EPT_BASE(x) (0x100 + (x) * 0x20) 219 #define USBA_DMA_BASE(x) (0x300 + (x) * 0x10) 220 #define USBA_FIFO_BASE(x) ((x) << 16) 221 222 /* Synth parameters */ 223 #define USBA_NR_DMAS 7 224 225 #define EP0_FIFO_SIZE 64 226 #define EP0_EPT_SIZE USBA_EPT_SIZE_64 227 #define EP0_NR_BANKS 1 228 229 #define FIFO_IOMEM_ID 0 230 #define CTRL_IOMEM_ID 1 231 232 #define DBG_ERR 0x0001 /* report all error returns */ 233 #define DBG_HW 0x0002 /* debug hardware initialization */ 234 #define DBG_GADGET 0x0004 /* calls to/from gadget driver */ 235 #define DBG_INT 0x0008 /* interrupts */ 236 #define DBG_BUS 0x0010 /* report changes in bus state */ 237 #define DBG_QUEUE 0x0020 /* debug request queue processing */ 238 #define DBG_FIFO 0x0040 /* debug FIFO contents */ 239 #define DBG_DMA 0x0080 /* debug DMA handling */ 240 #define DBG_REQ 0x0100 /* print out queued request length */ 241 #define DBG_ALL 0xffff 242 #define DBG_NONE 0x0000 243 244 #define DEBUG_LEVEL (DBG_ERR) 245 246 #define DBG(level, fmt, ...) \ 247 do { \ 248 if ((level) & DEBUG_LEVEL) \ 249 pr_debug("udc: " fmt, ## __VA_ARGS__); \ 250 } while (0) 251 252 enum usba_ctrl_state { 253 WAIT_FOR_SETUP, 254 DATA_STAGE_IN, 255 DATA_STAGE_OUT, 256 STATUS_STAGE_IN, 257 STATUS_STAGE_OUT, 258 STATUS_STAGE_ADDR, 259 STATUS_STAGE_TEST, 260 }; 261 /* 262 EP_STATE_IDLE, 263 EP_STATE_SETUP, 264 EP_STATE_IN_DATA, 265 EP_STATE_OUT_DATA, 266 EP_STATE_SET_ADDR_STATUS, 267 EP_STATE_RX_STATUS, 268 EP_STATE_TX_STATUS, 269 EP_STATE_HALT, 270 */ 271 272 struct usba_dma_desc { 273 dma_addr_t next; 274 dma_addr_t addr; 275 u32 ctrl; 276 }; 277 278 struct usba_ep { 279 int state; 280 void __iomem *ep_regs; 281 void __iomem *dma_regs; 282 void __iomem *fifo; 283 struct usb_ep ep; 284 struct usba_udc *udc; 285 286 struct list_head queue; 287 288 u16 fifo_size; 289 u8 nr_banks; 290 u8 index; 291 unsigned int can_dma:1; 292 unsigned int can_isoc:1; 293 unsigned int is_isoc:1; 294 unsigned int is_in:1; 295 296 #ifdef CONFIG_USB_GADGET_DEBUG_FS 297 u32 last_dma_status; 298 struct dentry *debugfs_dir; 299 struct dentry *debugfs_queue; 300 struct dentry *debugfs_dma_status; 301 struct dentry *debugfs_state; 302 #endif 303 }; 304 305 struct usba_request { 306 struct usb_request req; 307 struct list_head queue; 308 309 u32 ctrl; 310 311 unsigned int submitted:1; 312 unsigned int last_transaction:1; 313 unsigned int using_dma:1; 314 unsigned int mapped:1; 315 }; 316 317 struct usba_udc_errata { 318 void (*toggle_bias)(struct usba_udc *udc, int is_on); 319 void (*pulse_bias)(struct usba_udc *udc); 320 }; 321 322 struct usba_udc { 323 /* Protect hw registers from concurrent modifications */ 324 spinlock_t lock; 325 326 /* Mutex to prevent concurrent start or stop */ 327 struct mutex vbus_mutex; 328 329 void __iomem *regs; 330 void __iomem *fifo; 331 332 struct usb_gadget gadget; 333 struct usb_gadget_driver *driver; 334 struct platform_device *pdev; 335 const struct usba_udc_errata *errata; 336 int irq; 337 int vbus_pin; 338 int vbus_pin_inverted; 339 int num_ep; 340 struct clk *pclk; 341 struct clk *hclk; 342 struct usba_ep *usba_ep; 343 bool bias_pulse_needed; 344 bool clocked; 345 346 u16 devstatus; 347 348 u16 test_mode; 349 int vbus_prev; 350 351 u32 int_enb_cache; 352 353 #ifdef CONFIG_USB_GADGET_DEBUG_FS 354 struct dentry *debugfs_root; 355 struct dentry *debugfs_regs; 356 #endif 357 }; 358 359 static inline struct usba_ep *to_usba_ep(struct usb_ep *ep) 360 { 361 return container_of(ep, struct usba_ep, ep); 362 } 363 364 static inline struct usba_request *to_usba_req(struct usb_request *req) 365 { 366 return container_of(req, struct usba_request, req); 367 } 368 369 static inline struct usba_udc *to_usba_udc(struct usb_gadget *gadget) 370 { 371 return container_of(gadget, struct usba_udc, gadget); 372 } 373 374 #define ep_is_control(ep) ((ep)->index == 0) 375 #define ep_is_idle(ep) ((ep)->state == EP_STATE_IDLE) 376 377 #endif /* __LINUX_USB_GADGET_USBA_UDC_H */ 378