2 * ci13xxx_udc.c - MIPS USB IP core family device controller
4 * Copyright (C) 2008 Chipidea - MIPS Technologies, Inc. All rights reserved.
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
14 * Description: MIPS USB IP core family device controller
15 * Currently it only supports IP part number CI13412
17 * This driver is composed of several blocks:
18 * - HW: hardware interface
19 * - DBG: debug facilities (optional)
21 * - ISR: interrupts handling
22 * - ENDPT: endpoint operations (Gadget API)
23 * - GADGET: gadget operations (Gadget API)
24 * - BUS: bus glue code, bus abstraction layer
25 * - PCI: PCI core interface and PCI resources (interrupts, memory...)
28 * - CONFIG_USB_GADGET_DEBUG_FILES: enable debug facilities
29 * - STALL_IN: non-empty bulk-in pipes cannot be halted
30 * if defined mass storage compliance succeeds but with warnings
34 * if undefined usbtest 13 fails
35 * - TRACE: enable function tracing (depends on DEBUG)
38 * - Chapter 9 & Mass Storage Compliance with Gadget File Storage
39 * - Chapter 9 Compliance with Gadget Zero (STALL_IN undefined)
40 * - Normal & LPM support
43 * - OK: 0-12, 13 (STALL_IN defined) & 14
44 * - Not Supported: 15 & 16 (ISO)
48 * - Isochronous & Interrupt Traffic
49 * - Handle requests which spawns into several TDs
50 * - GET_STATUS(device) - always reports 0
51 * - Gadget API (majority of optional features)
52 * - Suspend & Remote Wakeup
54 #include <linux/device.h>
55 #include <linux/dmapool.h>
56 #include <linux/dma-mapping.h>
57 #include <linux/init.h>
58 #include <linux/interrupt.h>
59 #include <linux/interrupt.h>
61 #include <linux/irq.h>
62 #include <linux/kernel.h>
63 #include <linux/module.h>
64 #include <linux/pci.h>
65 #include <linux/usb/ch9.h>
66 #include <linux/usb/gadget.h>
68 #include "ci13xxx_udc.h"
71 /******************************************************************************
73 *****************************************************************************/
74 /* ctrl register bank access */
75 static DEFINE_SPINLOCK(udc_lock);
78 #define UDC_DRIVER_NAME "ci13xxx_udc"
80 /* control endpoint description */
81 static const struct usb_endpoint_descriptor
83 .bLength = USB_DT_ENDPOINT_SIZE,
84 .bDescriptorType = USB_DT_ENDPOINT,
86 .bmAttributes = USB_ENDPOINT_XFER_CONTROL,
87 .wMaxPacketSize = cpu_to_le16(CTRL_PAYLOAD_MAX),
91 static struct ci13xxx *_udc;
93 /* Interrupt statistics */
111 * ffs_nr: find first (least significant) bit set
112 * @x: the word to search
114 * This function returns bit number (instead of position)
116 static int ffs_nr(u32 x)
123 /******************************************************************************
125 *****************************************************************************/
126 /* register bank descriptor */
128 unsigned lpm; /* is LPM? */
129 void __iomem *abs; /* bus map offset */
130 void __iomem *cap; /* bus map offset + CAP offset + CAP data */
131 size_t size; /* bank size */
134 /* UDC register map */
135 #define ABS_CAPLENGTH (0x100UL)
136 #define ABS_HCCPARAMS (0x108UL)
137 #define ABS_DCCPARAMS (0x124UL)
138 #define ABS_TESTMODE (hw_bank.lpm ? 0x0FCUL : 0x138UL)
139 /* offset to CAPLENTGH (addr + data) */
140 #define CAP_USBCMD (0x000UL)
141 #define CAP_USBSTS (0x004UL)
142 #define CAP_USBINTR (0x008UL)
143 #define CAP_DEVICEADDR (0x014UL)
144 #define CAP_ENDPTLISTADDR (0x018UL)
145 #define CAP_PORTSC (0x044UL)
146 #define CAP_DEVLC (0x0B4UL)
147 #define CAP_USBMODE (hw_bank.lpm ? 0x0C8UL : 0x068UL)
148 #define CAP_ENDPTSETUPSTAT (hw_bank.lpm ? 0x0D8UL : 0x06CUL)
149 #define CAP_ENDPTPRIME (hw_bank.lpm ? 0x0DCUL : 0x070UL)
150 #define CAP_ENDPTFLUSH (hw_bank.lpm ? 0x0E0UL : 0x074UL)
151 #define CAP_ENDPTSTAT (hw_bank.lpm ? 0x0E4UL : 0x078UL)
152 #define CAP_ENDPTCOMPLETE (hw_bank.lpm ? 0x0E8UL : 0x07CUL)
153 #define CAP_ENDPTCTRL (hw_bank.lpm ? 0x0ECUL : 0x080UL)
154 #define CAP_LAST (hw_bank.lpm ? 0x12CUL : 0x0C0UL)
156 /* maximum number of enpoints: valid only after hw_device_reset() */
157 static unsigned hw_ep_max;
160 * hw_ep_bit: calculates the bit number
161 * @num: endpoint number
162 * @dir: endpoint direction
164 * This function returns bit number
166 static inline int hw_ep_bit(int num, int dir)
168 return num + (dir ? 16 : 0);
172 * hw_aread: reads from register bitfield
173 * @addr: address relative to bus map
174 * @mask: bitfield mask
176 * This function returns register bitfield data
178 static u32 hw_aread(u32 addr, u32 mask)
180 return ioread32(addr + hw_bank.abs) & mask;
184 * hw_awrite: writes to register bitfield
185 * @addr: address relative to bus map
186 * @mask: bitfield mask
189 static void hw_awrite(u32 addr, u32 mask, u32 data)
191 iowrite32(hw_aread(addr, ~mask) | (data & mask),
196 * hw_cread: reads from register bitfield
197 * @addr: address relative to CAP offset plus content
198 * @mask: bitfield mask
200 * This function returns register bitfield data
202 static u32 hw_cread(u32 addr, u32 mask)
204 return ioread32(addr + hw_bank.cap) & mask;
208 * hw_cwrite: writes to register bitfield
209 * @addr: address relative to CAP offset plus content
210 * @mask: bitfield mask
213 static void hw_cwrite(u32 addr, u32 mask, u32 data)
215 iowrite32(hw_cread(addr, ~mask) | (data & mask),
220 * hw_ctest_and_clear: tests & clears register bitfield
221 * @addr: address relative to CAP offset plus content
222 * @mask: bitfield mask
224 * This function returns register bitfield data
226 static u32 hw_ctest_and_clear(u32 addr, u32 mask)
228 u32 reg = hw_cread(addr, mask);
230 iowrite32(reg, addr + hw_bank.cap);
235 * hw_ctest_and_write: tests & writes register bitfield
236 * @addr: address relative to CAP offset plus content
237 * @mask: bitfield mask
240 * This function returns register bitfield data
242 static u32 hw_ctest_and_write(u32 addr, u32 mask, u32 data)
244 u32 reg = hw_cread(addr, ~0);
246 iowrite32((reg & ~mask) | (data & mask), addr + hw_bank.cap);
247 return (reg & mask) >> ffs_nr(mask);
251 * hw_device_reset: resets chip (execute without interruption)
252 * @base: register base address
254 * This function returns an error code
256 static int hw_device_reset(void __iomem *base)
260 /* bank is a module variable */
263 hw_bank.cap = hw_bank.abs;
264 hw_bank.cap += ABS_CAPLENGTH;
265 hw_bank.cap += ioread8(hw_bank.cap);
267 reg = hw_aread(ABS_HCCPARAMS, HCCPARAMS_LEN) >> ffs_nr(HCCPARAMS_LEN);
269 hw_bank.size = hw_bank.cap - hw_bank.abs;
270 hw_bank.size += CAP_LAST;
271 hw_bank.size /= sizeof(u32);
273 /* should flush & stop before reset */
274 hw_cwrite(CAP_ENDPTFLUSH, ~0, ~0);
275 hw_cwrite(CAP_USBCMD, USBCMD_RS, 0);
277 hw_cwrite(CAP_USBCMD, USBCMD_RST, USBCMD_RST);
278 while (hw_cread(CAP_USBCMD, USBCMD_RST))
279 udelay(10); /* not RTOS friendly */
281 /* USBMODE should be configured step by step */
282 hw_cwrite(CAP_USBMODE, USBMODE_CM, USBMODE_CM_IDLE);
283 hw_cwrite(CAP_USBMODE, USBMODE_CM, USBMODE_CM_DEVICE);
284 hw_cwrite(CAP_USBMODE, USBMODE_SLOM, USBMODE_SLOM); /* HW >= 2.3 */
286 if (hw_cread(CAP_USBMODE, USBMODE_CM) != USBMODE_CM_DEVICE) {
287 pr_err("cannot enter in device mode");
288 pr_err("lpm = %i", hw_bank.lpm);
292 reg = hw_aread(ABS_DCCPARAMS, DCCPARAMS_DEN) >> ffs_nr(DCCPARAMS_DEN);
293 if (reg == 0 || reg > ENDPT_MAX)
296 hw_ep_max = reg; /* cache hw ENDPT_MAX */
298 /* setup lock mode ? */
300 /* ENDPTSETUPSTAT is '0' by default */
302 /* HCSPARAMS.bf.ppc SHOULD BE zero for device */
308 * hw_device_state: enables/disables interrupts & starts/stops device (execute
309 * without interruption)
310 * @dma: 0 => disable, !0 => enable and set dma engine
312 * This function returns an error code
314 static int hw_device_state(u32 dma)
317 hw_cwrite(CAP_ENDPTLISTADDR, ~0, dma);
318 /* interrupt, error, port change, reset, sleep/suspend */
319 hw_cwrite(CAP_USBINTR, ~0,
320 USBi_UI|USBi_UEI|USBi_PCI|USBi_URI|USBi_SLI);
321 hw_cwrite(CAP_USBCMD, USBCMD_RS, USBCMD_RS);
323 hw_cwrite(CAP_USBCMD, USBCMD_RS, 0);
324 hw_cwrite(CAP_USBINTR, ~0, 0);
330 * hw_ep_flush: flush endpoint fifo (execute without interruption)
331 * @num: endpoint number
332 * @dir: endpoint direction
334 * This function returns an error code
336 static int hw_ep_flush(int num, int dir)
338 int n = hw_ep_bit(num, dir);
341 /* flush any pending transfer */
342 hw_cwrite(CAP_ENDPTFLUSH, BIT(n), BIT(n));
343 while (hw_cread(CAP_ENDPTFLUSH, BIT(n)))
345 } while (hw_cread(CAP_ENDPTSTAT, BIT(n)));
351 * hw_ep_disable: disables endpoint (execute without interruption)
352 * @num: endpoint number
353 * @dir: endpoint direction
355 * This function returns an error code
357 static int hw_ep_disable(int num, int dir)
359 hw_ep_flush(num, dir);
360 hw_cwrite(CAP_ENDPTCTRL + num * sizeof(u32),
361 dir ? ENDPTCTRL_TXE : ENDPTCTRL_RXE, 0);
366 * hw_ep_enable: enables endpoint (execute without interruption)
367 * @num: endpoint number
368 * @dir: endpoint direction
369 * @type: endpoint type
371 * This function returns an error code
373 static int hw_ep_enable(int num, int dir, int type)
378 mask = ENDPTCTRL_TXT; /* type */
379 data = type << ffs_nr(mask);
381 mask |= ENDPTCTRL_TXS; /* unstall */
382 mask |= ENDPTCTRL_TXR; /* reset data toggle */
383 data |= ENDPTCTRL_TXR;
384 mask |= ENDPTCTRL_TXE; /* enable */
385 data |= ENDPTCTRL_TXE;
387 mask = ENDPTCTRL_RXT; /* type */
388 data = type << ffs_nr(mask);
390 mask |= ENDPTCTRL_RXS; /* unstall */
391 mask |= ENDPTCTRL_RXR; /* reset data toggle */
392 data |= ENDPTCTRL_RXR;
393 mask |= ENDPTCTRL_RXE; /* enable */
394 data |= ENDPTCTRL_RXE;
396 hw_cwrite(CAP_ENDPTCTRL + num * sizeof(u32), mask, data);
401 * hw_ep_get_halt: return endpoint halt status
402 * @num: endpoint number
403 * @dir: endpoint direction
405 * This function returns 1 if endpoint halted
407 static int hw_ep_get_halt(int num, int dir)
409 u32 mask = dir ? ENDPTCTRL_TXS : ENDPTCTRL_RXS;
411 return hw_cread(CAP_ENDPTCTRL + num * sizeof(u32), mask) ? 1 : 0;
415 * hw_ep_is_primed: test if endpoint is primed (execute without interruption)
416 * @num: endpoint number
417 * @dir: endpoint direction
419 * This function returns true if endpoint primed
421 static int hw_ep_is_primed(int num, int dir)
423 u32 reg = hw_cread(CAP_ENDPTPRIME, ~0) | hw_cread(CAP_ENDPTSTAT, ~0);
425 return test_bit(hw_ep_bit(num, dir), (void *)®);
429 * hw_test_and_clear_setup_status: test & clear setup status (execute without
431 * @n: bit number (endpoint)
433 * This function returns setup status
435 static int hw_test_and_clear_setup_status(int n)
437 return hw_ctest_and_clear(CAP_ENDPTSETUPSTAT, BIT(n));
441 * hw_ep_prime: primes endpoint (execute without interruption)
442 * @num: endpoint number
443 * @dir: endpoint direction
444 * @is_ctrl: true if control endpoint
446 * This function returns an error code
448 static int hw_ep_prime(int num, int dir, int is_ctrl)
450 int n = hw_ep_bit(num, dir);
452 /* the caller should flush first */
453 if (hw_ep_is_primed(num, dir))
456 if (is_ctrl && dir == RX && hw_cread(CAP_ENDPTSETUPSTAT, BIT(num)))
459 hw_cwrite(CAP_ENDPTPRIME, BIT(n), BIT(n));
461 while (hw_cread(CAP_ENDPTPRIME, BIT(n)))
463 if (is_ctrl && dir == RX && hw_cread(CAP_ENDPTSETUPSTAT, BIT(num)))
466 /* status shoult be tested according with manual but it doesn't work */
471 * hw_ep_set_halt: configures ep halt & resets data toggle after clear (execute
472 * without interruption)
473 * @num: endpoint number
474 * @dir: endpoint direction
475 * @value: true => stall, false => unstall
477 * This function returns an error code
479 static int hw_ep_set_halt(int num, int dir, int value)
481 if (value != 0 && value != 1)
485 u32 addr = CAP_ENDPTCTRL + num * sizeof(u32);
486 u32 mask_xs = dir ? ENDPTCTRL_TXS : ENDPTCTRL_RXS;
487 u32 mask_xr = dir ? ENDPTCTRL_TXR : ENDPTCTRL_RXR;
489 /* data toggle - reserved for EP0 but it's in ESS */
490 hw_cwrite(addr, mask_xs|mask_xr, value ? mask_xs : mask_xr);
492 } while (value != hw_ep_get_halt(num, dir));
498 * hw_intr_clear: disables interrupt & clears interrupt status (execute without
502 * This function returns an error code
504 static int hw_intr_clear(int n)
509 hw_cwrite(CAP_USBINTR, BIT(n), 0);
510 hw_cwrite(CAP_USBSTS, BIT(n), BIT(n));
515 * hw_intr_force: enables interrupt & forces interrupt status (execute without
519 * This function returns an error code
521 static int hw_intr_force(int n)
526 hw_awrite(ABS_TESTMODE, TESTMODE_FORCE, TESTMODE_FORCE);
527 hw_cwrite(CAP_USBINTR, BIT(n), BIT(n));
528 hw_cwrite(CAP_USBSTS, BIT(n), BIT(n));
529 hw_awrite(ABS_TESTMODE, TESTMODE_FORCE, 0);
534 * hw_is_port_high_speed: test if port is high speed
536 * This function returns true if high speed port
538 static int hw_port_is_high_speed(void)
540 return hw_bank.lpm ? hw_cread(CAP_DEVLC, DEVLC_PSPD) :
541 hw_cread(CAP_PORTSC, PORTSC_HSP);
545 * hw_port_test_get: reads port test mode value
547 * This function returns port test mode value
549 static u8 hw_port_test_get(void)
551 return hw_cread(CAP_PORTSC, PORTSC_PTC) >> ffs_nr(PORTSC_PTC);
555 * hw_port_test_set: writes port test mode (execute without interruption)
558 * This function returns an error code
560 static int hw_port_test_set(u8 mode)
562 const u8 TEST_MODE_MAX = 7;
564 if (mode > TEST_MODE_MAX)
567 hw_cwrite(CAP_PORTSC, PORTSC_PTC, mode << ffs_nr(PORTSC_PTC));
572 * hw_read_intr_enable: returns interrupt enable register
574 * This function returns register data
576 static u32 hw_read_intr_enable(void)
578 return hw_cread(CAP_USBINTR, ~0);
582 * hw_read_intr_status: returns interrupt status register
584 * This function returns register data
586 static u32 hw_read_intr_status(void)
588 return hw_cread(CAP_USBSTS, ~0);
592 * hw_register_read: reads all device registers (execute without interruption)
593 * @buf: destination buffer
596 * This function returns number of registers read
598 static size_t hw_register_read(u32 *buf, size_t size)
602 if (size > hw_bank.size)
605 for (i = 0; i < size; i++)
606 buf[i] = hw_aread(i * sizeof(u32), ~0);
612 * hw_register_write: writes to register
613 * @addr: register address
614 * @data: register value
616 * This function returns an error code
618 static int hw_register_write(u16 addr, u32 data)
623 if (addr >= hw_bank.size)
629 hw_awrite(addr, ~0, data);
634 * hw_test_and_clear_complete: test & clear complete status (execute without
636 * @n: bit number (endpoint)
638 * This function returns complete status
640 static int hw_test_and_clear_complete(int n)
642 return hw_ctest_and_clear(CAP_ENDPTCOMPLETE, BIT(n));
646 * hw_test_and_clear_intr_active: test & clear active interrupts (execute
647 * without interruption)
649 * This function returns active interrutps
651 static u32 hw_test_and_clear_intr_active(void)
653 u32 reg = hw_read_intr_status() & hw_read_intr_enable();
655 hw_cwrite(CAP_USBSTS, ~0, reg);
660 * hw_test_and_clear_setup_guard: test & clear setup guard (execute without
663 * This function returns guard value
665 static int hw_test_and_clear_setup_guard(void)
667 return hw_ctest_and_write(CAP_USBCMD, USBCMD_SUTW, 0);
671 * hw_test_and_set_setup_guard: test & set setup guard (execute without
674 * This function returns guard value
676 static int hw_test_and_set_setup_guard(void)
678 return hw_ctest_and_write(CAP_USBCMD, USBCMD_SUTW, USBCMD_SUTW);
682 * hw_usb_set_address: configures USB address (execute without interruption)
683 * @value: new USB address
685 * This function returns an error code
687 static int hw_usb_set_address(u8 value)
690 hw_cwrite(CAP_DEVICEADDR, DEVICEADDR_USBADR | DEVICEADDR_USBADRA,
691 value << ffs_nr(DEVICEADDR_USBADR) | DEVICEADDR_USBADRA);
696 * hw_usb_reset: restart device after a bus reset (execute without
699 * This function returns an error code
701 static int hw_usb_reset(void)
703 hw_usb_set_address(0);
705 /* ESS flushes only at end?!? */
706 hw_cwrite(CAP_ENDPTFLUSH, ~0, ~0); /* flush all EPs */
708 /* clear setup token semaphores */
709 hw_cwrite(CAP_ENDPTSETUPSTAT, 0, 0); /* writes its content */
711 /* clear complete status */
712 hw_cwrite(CAP_ENDPTCOMPLETE, 0, 0); /* writes its content */
714 /* wait until all bits cleared */
715 while (hw_cread(CAP_ENDPTPRIME, ~0))
716 udelay(10); /* not RTOS friendly */
718 /* reset all endpoints ? */
720 /* reset internal status and wait for further instructions
721 no need to verify the port reset status (ESS does it) */
726 /******************************************************************************
728 *****************************************************************************/
730 * show_device: prints information about device capabilities and status
732 * Check "device.h" for details
734 static ssize_t show_device(struct device *dev, struct device_attribute *attr,
737 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
738 struct usb_gadget *gadget = &udc->gadget;
741 dbg_trace("[%s] %p\n", __func__, buf);
742 if (attr == NULL || buf == NULL) {
743 dev_err(dev, "[%s] EINVAL\n", __func__);
747 n += scnprintf(buf + n, PAGE_SIZE - n, "speed = %d\n",
749 n += scnprintf(buf + n, PAGE_SIZE - n, "is_dualspeed = %d\n",
750 gadget->is_dualspeed);
751 n += scnprintf(buf + n, PAGE_SIZE - n, "is_otg = %d\n",
753 n += scnprintf(buf + n, PAGE_SIZE - n, "is_a_peripheral = %d\n",
754 gadget->is_a_peripheral);
755 n += scnprintf(buf + n, PAGE_SIZE - n, "b_hnp_enable = %d\n",
756 gadget->b_hnp_enable);
757 n += scnprintf(buf + n, PAGE_SIZE - n, "a_hnp_support = %d\n",
758 gadget->a_hnp_support);
759 n += scnprintf(buf + n, PAGE_SIZE - n, "a_alt_hnp_support = %d\n",
760 gadget->a_alt_hnp_support);
761 n += scnprintf(buf + n, PAGE_SIZE - n, "name = %s\n",
762 (gadget->name ? gadget->name : ""));
766 static DEVICE_ATTR(device, S_IRUSR, show_device, NULL);
769 * show_driver: prints information about attached gadget (if any)
771 * Check "device.h" for details
773 static ssize_t show_driver(struct device *dev, struct device_attribute *attr,
776 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
777 struct usb_gadget_driver *driver = udc->driver;
780 dbg_trace("[%s] %p\n", __func__, buf);
781 if (attr == NULL || buf == NULL) {
782 dev_err(dev, "[%s] EINVAL\n", __func__);
787 return scnprintf(buf, PAGE_SIZE,
788 "There is no gadget attached!\n");
790 n += scnprintf(buf + n, PAGE_SIZE - n, "function = %s\n",
791 (driver->function ? driver->function : ""));
792 n += scnprintf(buf + n, PAGE_SIZE - n, "max speed = %d\n",
797 static DEVICE_ATTR(driver, S_IRUSR, show_driver, NULL);
799 /* Maximum event message length */
800 #define DBG_DATA_MSG 64UL
802 /* Maximum event messages */
803 #define DBG_DATA_MAX 128UL
805 /* Event buffer descriptor */
807 char (buf[DBG_DATA_MAX])[DBG_DATA_MSG]; /* buffer */
808 unsigned idx; /* index */
809 unsigned tty; /* print to console? */
810 rwlock_t lck; /* lock */
814 .lck = __RW_LOCK_UNLOCKED(lck)
818 * dbg_dec: decrements debug event index
821 static void dbg_dec(unsigned *idx)
823 *idx = (*idx - 1) & (DBG_DATA_MAX-1);
827 * dbg_inc: increments debug event index
830 static void dbg_inc(unsigned *idx)
832 *idx = (*idx + 1) & (DBG_DATA_MAX-1);
836 * dbg_print: prints the common part of the event
837 * @addr: endpoint address
840 * @extra: extra information
842 static void dbg_print(u8 addr, const char *name, int status, const char *extra)
848 write_lock_irqsave(&dbg_data.lck, flags);
850 do_gettimeofday(&tval);
851 stamp = tval.tv_sec & 0xFFFF; /* 2^32 = 4294967296. Limit to 4096s */
852 stamp = stamp * 1000000 + tval.tv_usec;
854 scnprintf(dbg_data.buf[dbg_data.idx], DBG_DATA_MSG,
855 "%04X\t» %02X %-7.7s %4i «\t%s\n",
856 stamp, addr, name, status, extra);
858 dbg_inc(&dbg_data.idx);
860 write_unlock_irqrestore(&dbg_data.lck, flags);
862 if (dbg_data.tty != 0)
863 pr_notice("%04X\t» %02X %-7.7s %4i «\t%s\n",
864 stamp, addr, name, status, extra);
868 * dbg_done: prints a DONE event
869 * @addr: endpoint address
870 * @td: transfer descriptor
873 static void dbg_done(u8 addr, const u32 token, int status)
875 char msg[DBG_DATA_MSG];
877 scnprintf(msg, sizeof(msg), "%d %02X",
878 (int)(token & TD_TOTAL_BYTES) >> ffs_nr(TD_TOTAL_BYTES),
879 (int)(token & TD_STATUS) >> ffs_nr(TD_STATUS));
880 dbg_print(addr, "DONE", status, msg);
884 * dbg_event: prints a generic event
885 * @addr: endpoint address
889 static void dbg_event(u8 addr, const char *name, int status)
892 dbg_print(addr, name, status, "");
896 * dbg_queue: prints a QUEUE event
897 * @addr: endpoint address
901 static void dbg_queue(u8 addr, const struct usb_request *req, int status)
903 char msg[DBG_DATA_MSG];
906 scnprintf(msg, sizeof(msg),
907 "%d %d", !req->no_interrupt, req->length);
908 dbg_print(addr, "QUEUE", status, msg);
913 * dbg_setup: prints a SETUP event
914 * @addr: endpoint address
915 * @req: setup request
917 static void dbg_setup(u8 addr, const struct usb_ctrlrequest *req)
919 char msg[DBG_DATA_MSG];
922 scnprintf(msg, sizeof(msg),
923 "%02X %02X %04X %04X %d", req->bRequestType,
924 req->bRequest, le16_to_cpu(req->wValue),
925 le16_to_cpu(req->wIndex), le16_to_cpu(req->wLength));
926 dbg_print(addr, "SETUP", 0, msg);
931 * show_events: displays the event buffer
933 * Check "device.h" for details
935 static ssize_t show_events(struct device *dev, struct device_attribute *attr,
939 unsigned i, j, n = 0;
941 dbg_trace("[%s] %p\n", __func__, buf);
942 if (attr == NULL || buf == NULL) {
943 dev_err(dev, "[%s] EINVAL\n", __func__);
947 read_lock_irqsave(&dbg_data.lck, flags);
950 for (dbg_dec(&i); i != dbg_data.idx; dbg_dec(&i)) {
951 n += strlen(dbg_data.buf[i]);
952 if (n >= PAGE_SIZE) {
953 n -= strlen(dbg_data.buf[i]);
957 for (j = 0, dbg_inc(&i); j < n; dbg_inc(&i))
958 j += scnprintf(buf + j, PAGE_SIZE - j,
959 "%s", dbg_data.buf[i]);
961 read_unlock_irqrestore(&dbg_data.lck, flags);
967 * store_events: configure if events are going to be also printed to console
969 * Check "device.h" for details
971 static ssize_t store_events(struct device *dev, struct device_attribute *attr,
972 const char *buf, size_t count)
976 dbg_trace("[%s] %p, %d\n", __func__, buf, count);
977 if (attr == NULL || buf == NULL) {
978 dev_err(dev, "[%s] EINVAL\n", __func__);
982 if (sscanf(buf, "%u", &tty) != 1 || tty > 1) {
983 dev_err(dev, "<1|0>: enable|disable console log\n");
988 dev_info(dev, "tty = %u", dbg_data.tty);
993 static DEVICE_ATTR(events, S_IRUSR | S_IWUSR, show_events, store_events);
996 * show_inters: interrupt status, enable status and historic
998 * Check "device.h" for details
1000 static ssize_t show_inters(struct device *dev, struct device_attribute *attr,
1003 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1004 unsigned long flags;
1006 unsigned i, j, n = 0;
1008 dbg_trace("[%s] %p\n", __func__, buf);
1009 if (attr == NULL || buf == NULL) {
1010 dev_err(dev, "[%s] EINVAL\n", __func__);
1014 spin_lock_irqsave(udc->lock, flags);
1016 n += scnprintf(buf + n, PAGE_SIZE - n,
1017 "status = %08x\n", hw_read_intr_status());
1018 n += scnprintf(buf + n, PAGE_SIZE - n,
1019 "enable = %08x\n", hw_read_intr_enable());
1021 n += scnprintf(buf + n, PAGE_SIZE - n, "*test = %d\n",
1022 isr_statistics.test);
1023 n += scnprintf(buf + n, PAGE_SIZE - n, "» ui = %d\n",
1025 n += scnprintf(buf + n, PAGE_SIZE - n, "» uei = %d\n",
1026 isr_statistics.uei);
1027 n += scnprintf(buf + n, PAGE_SIZE - n, "» pci = %d\n",
1028 isr_statistics.pci);
1029 n += scnprintf(buf + n, PAGE_SIZE - n, "» uri = %d\n",
1030 isr_statistics.uri);
1031 n += scnprintf(buf + n, PAGE_SIZE - n, "» sli = %d\n",
1032 isr_statistics.sli);
1033 n += scnprintf(buf + n, PAGE_SIZE - n, "*none = %d\n",
1034 isr_statistics.none);
1035 n += scnprintf(buf + n, PAGE_SIZE - n, "*hndl = %d\n",
1036 isr_statistics.hndl.cnt);
1038 for (i = isr_statistics.hndl.idx, j = 0; j <= ISR_MASK; j++, i++) {
1040 intr = isr_statistics.hndl.buf[i];
1043 n += scnprintf(buf + n, PAGE_SIZE - n, "ui ");
1045 if (USBi_UEI & intr)
1046 n += scnprintf(buf + n, PAGE_SIZE - n, "uei ");
1048 if (USBi_PCI & intr)
1049 n += scnprintf(buf + n, PAGE_SIZE - n, "pci ");
1051 if (USBi_URI & intr)
1052 n += scnprintf(buf + n, PAGE_SIZE - n, "uri ");
1054 if (USBi_SLI & intr)
1055 n += scnprintf(buf + n, PAGE_SIZE - n, "sli ");
1058 n += scnprintf(buf + n, PAGE_SIZE - n, "??? ");
1059 if (isr_statistics.hndl.buf[i])
1060 n += scnprintf(buf + n, PAGE_SIZE - n, "\n");
1063 spin_unlock_irqrestore(udc->lock, flags);
1069 * store_inters: enable & force or disable an individual interrutps
1070 * (to be used for test purposes only)
1072 * Check "device.h" for details
1074 static ssize_t store_inters(struct device *dev, struct device_attribute *attr,
1075 const char *buf, size_t count)
1077 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1078 unsigned long flags;
1081 dbg_trace("[%s] %p, %d\n", __func__, buf, count);
1082 if (attr == NULL || buf == NULL) {
1083 dev_err(dev, "[%s] EINVAL\n", __func__);
1087 if (sscanf(buf, "%u %u", &en, &bit) != 2 || en > 1) {
1088 dev_err(dev, "<1|0> <bit>: enable|disable interrupt");
1092 spin_lock_irqsave(udc->lock, flags);
1094 if (hw_intr_force(bit))
1095 dev_err(dev, "invalid bit number\n");
1097 isr_statistics.test++;
1099 if (hw_intr_clear(bit))
1100 dev_err(dev, "invalid bit number\n");
1102 spin_unlock_irqrestore(udc->lock, flags);
1107 static DEVICE_ATTR(inters, S_IRUSR | S_IWUSR, show_inters, store_inters);
1110 * show_port_test: reads port test mode
1112 * Check "device.h" for details
1114 static ssize_t show_port_test(struct device *dev,
1115 struct device_attribute *attr, char *buf)
1117 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1118 unsigned long flags;
1121 dbg_trace("[%s] %p\n", __func__, buf);
1122 if (attr == NULL || buf == NULL) {
1123 dev_err(dev, "[%s] EINVAL\n", __func__);
1127 spin_lock_irqsave(udc->lock, flags);
1128 mode = hw_port_test_get();
1129 spin_unlock_irqrestore(udc->lock, flags);
1131 return scnprintf(buf, PAGE_SIZE, "mode = %u\n", mode);
1135 * store_port_test: writes port test mode
1137 * Check "device.h" for details
1139 static ssize_t store_port_test(struct device *dev,
1140 struct device_attribute *attr,
1141 const char *buf, size_t count)
1143 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1144 unsigned long flags;
1147 dbg_trace("[%s] %p, %d\n", __func__, buf, count);
1148 if (attr == NULL || buf == NULL) {
1149 dev_err(dev, "[%s] EINVAL\n", __func__);
1153 if (sscanf(buf, "%u", &mode) != 1) {
1154 dev_err(dev, "<mode>: set port test mode");
1158 spin_lock_irqsave(udc->lock, flags);
1159 if (hw_port_test_set(mode))
1160 dev_err(dev, "invalid mode\n");
1161 spin_unlock_irqrestore(udc->lock, flags);
1166 static DEVICE_ATTR(port_test, S_IRUSR | S_IWUSR,
1167 show_port_test, store_port_test);
1170 * show_qheads: DMA contents of all queue heads
1172 * Check "device.h" for details
1174 static ssize_t show_qheads(struct device *dev, struct device_attribute *attr,
1177 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1178 unsigned long flags;
1179 unsigned i, j, n = 0;
1181 dbg_trace("[%s] %p\n", __func__, buf);
1182 if (attr == NULL || buf == NULL) {
1183 dev_err(dev, "[%s] EINVAL\n", __func__);
1187 spin_lock_irqsave(udc->lock, flags);
1188 for (i = 0; i < hw_ep_max; i++) {
1189 struct ci13xxx_ep *mEp = &udc->ci13xxx_ep[i];
1190 n += scnprintf(buf + n, PAGE_SIZE - n,
1191 "EP=%02i: RX=%08X TX=%08X\n",
1192 i, (u32)mEp->qh[RX].dma, (u32)mEp->qh[TX].dma);
1193 for (j = 0; j < (sizeof(struct ci13xxx_qh)/sizeof(u32)); j++) {
1194 n += scnprintf(buf + n, PAGE_SIZE - n,
1195 " %04X: %08X %08X\n", j,
1196 *((u32 *)mEp->qh[RX].ptr + j),
1197 *((u32 *)mEp->qh[TX].ptr + j));
1200 spin_unlock_irqrestore(udc->lock, flags);
1204 static DEVICE_ATTR(qheads, S_IRUSR, show_qheads, NULL);
1207 * show_registers: dumps all registers
1209 * Check "device.h" for details
1211 static ssize_t show_registers(struct device *dev,
1212 struct device_attribute *attr, char *buf)
1214 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1215 unsigned long flags;
1217 unsigned i, k, n = 0;
1219 dbg_trace("[%s] %p\n", __func__, buf);
1220 if (attr == NULL || buf == NULL) {
1221 dev_err(dev, "[%s] EINVAL\n", __func__);
1225 spin_lock_irqsave(udc->lock, flags);
1226 k = hw_register_read(dump, sizeof(dump)/sizeof(u32));
1227 spin_unlock_irqrestore(udc->lock, flags);
1229 for (i = 0; i < k; i++) {
1230 n += scnprintf(buf + n, PAGE_SIZE - n,
1231 "reg[0x%04X] = 0x%08X\n",
1232 i * (unsigned)sizeof(u32), dump[i]);
1239 * store_registers: writes value to register address
1241 * Check "device.h" for details
1243 static ssize_t store_registers(struct device *dev,
1244 struct device_attribute *attr,
1245 const char *buf, size_t count)
1247 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1248 unsigned long addr, data, flags;
1250 dbg_trace("[%s] %p, %d\n", __func__, buf, count);
1251 if (attr == NULL || buf == NULL) {
1252 dev_err(dev, "[%s] EINVAL\n", __func__);
1256 if (sscanf(buf, "%li %li", &addr, &data) != 2) {
1257 dev_err(dev, "<addr> <data>: write data to register address");
1261 spin_lock_irqsave(udc->lock, flags);
1262 if (hw_register_write(addr, data))
1263 dev_err(dev, "invalid address range\n");
1264 spin_unlock_irqrestore(udc->lock, flags);
1269 static DEVICE_ATTR(registers, S_IRUSR | S_IWUSR,
1270 show_registers, store_registers);
1273 * show_requests: DMA contents of all requests currently queued (all endpts)
1275 * Check "device.h" for details
1277 static ssize_t show_requests(struct device *dev, struct device_attribute *attr,
1280 struct ci13xxx *udc = container_of(dev, struct ci13xxx, gadget.dev);
1281 unsigned long flags;
1282 struct list_head *ptr = NULL;
1283 struct ci13xxx_req *req = NULL;
1284 unsigned i, j, k, n = 0, qSize = sizeof(struct ci13xxx_td)/sizeof(u32);
1286 dbg_trace("[%s] %p\n", __func__, buf);
1287 if (attr == NULL || buf == NULL) {
1288 dev_err(dev, "[%s] EINVAL\n", __func__);
1292 spin_lock_irqsave(udc->lock, flags);
1293 for (i = 0; i < hw_ep_max; i++)
1294 for (k = RX; k <= TX; k++)
1295 list_for_each(ptr, &udc->ci13xxx_ep[i].qh[k].queue)
1297 req = list_entry(ptr,
1298 struct ci13xxx_req, queue);
1300 n += scnprintf(buf + n, PAGE_SIZE - n,
1301 "EP=%02i: TD=%08X %s\n",
1303 ((k == RX) ? "RX" : "TX"));
1305 for (j = 0; j < qSize; j++)
1306 n += scnprintf(buf + n, PAGE_SIZE - n,
1308 *((u32 *)req->ptr + j));
1310 spin_unlock_irqrestore(udc->lock, flags);
1314 static DEVICE_ATTR(requests, S_IRUSR, show_requests, NULL);
1317 * dbg_create_files: initializes the attribute interface
1320 * This function returns an error code
1322 __maybe_unused static int dbg_create_files(struct device *dev)
1328 retval = device_create_file(dev, &dev_attr_device);
1331 retval = device_create_file(dev, &dev_attr_driver);
1334 retval = device_create_file(dev, &dev_attr_events);
1337 retval = device_create_file(dev, &dev_attr_inters);
1340 retval = device_create_file(dev, &dev_attr_port_test);
1343 retval = device_create_file(dev, &dev_attr_qheads);
1346 retval = device_create_file(dev, &dev_attr_registers);
1349 retval = device_create_file(dev, &dev_attr_requests);
1355 device_remove_file(dev, &dev_attr_registers);
1357 device_remove_file(dev, &dev_attr_qheads);
1359 device_remove_file(dev, &dev_attr_port_test);
1361 device_remove_file(dev, &dev_attr_inters);
1363 device_remove_file(dev, &dev_attr_events);
1365 device_remove_file(dev, &dev_attr_driver);
1367 device_remove_file(dev, &dev_attr_device);
1373 * dbg_remove_files: destroys the attribute interface
1376 * This function returns an error code
1378 __maybe_unused static int dbg_remove_files(struct device *dev)
1382 device_remove_file(dev, &dev_attr_requests);
1383 device_remove_file(dev, &dev_attr_registers);
1384 device_remove_file(dev, &dev_attr_qheads);
1385 device_remove_file(dev, &dev_attr_port_test);
1386 device_remove_file(dev, &dev_attr_inters);
1387 device_remove_file(dev, &dev_attr_events);
1388 device_remove_file(dev, &dev_attr_driver);
1389 device_remove_file(dev, &dev_attr_device);
1393 /******************************************************************************
1395 *****************************************************************************/
1397 * _usb_addr: calculates endpoint address from direction & number
1400 static inline u8 _usb_addr(struct ci13xxx_ep *ep)
1402 return ((ep->dir == TX) ? USB_ENDPOINT_DIR_MASK : 0) | ep->num;
1406 * _hardware_queue: configures a request at hardware level
1410 * This function returns an error code
1412 static int _hardware_enqueue(struct ci13xxx_ep *mEp, struct ci13xxx_req *mReq)
1416 trace("%p, %p", mEp, mReq);
1418 /* don't queue twice */
1419 if (mReq->req.status == -EALREADY)
1422 if (hw_ep_is_primed(mEp->num, mEp->dir))
1425 mReq->req.status = -EALREADY;
1427 if (mReq->req.length && !mReq->req.dma) {
1429 dma_map_single(mEp->device, mReq->req.buf,
1430 mReq->req.length, mEp->dir ?
1431 DMA_TO_DEVICE : DMA_FROM_DEVICE);
1432 if (mReq->req.dma == 0)
1440 * TODO - handle requests which spawns into several TDs
1442 memset(mReq->ptr, 0, sizeof(*mReq->ptr));
1443 mReq->ptr->next |= TD_TERMINATE;
1444 mReq->ptr->token = mReq->req.length << ffs_nr(TD_TOTAL_BYTES);
1445 mReq->ptr->token &= TD_TOTAL_BYTES;
1446 mReq->ptr->token |= TD_IOC;
1447 mReq->ptr->token |= TD_STATUS_ACTIVE;
1448 mReq->ptr->page[0] = mReq->req.dma;
1449 for (i = 1; i < 5; i++)
1450 mReq->ptr->page[i] =
1451 (mReq->req.dma + i * PAGE_SIZE) & ~TD_RESERVED_MASK;
1455 * At this point it's guaranteed exclusive access to qhead
1456 * (endpt is not primed) so it's no need to use tripwire
1458 mEp->qh[mEp->dir].ptr->td.next = mReq->dma; /* TERMINATE = 0 */
1459 mEp->qh[mEp->dir].ptr->td.token &= ~TD_STATUS; /* clear status */
1460 if (mReq->req.zero == 0)
1461 mEp->qh[mEp->dir].ptr->cap |= QH_ZLT;
1463 mEp->qh[mEp->dir].ptr->cap &= ~QH_ZLT;
1465 wmb(); /* synchronize before ep prime */
1467 return hw_ep_prime(mEp->num, mEp->dir,
1468 mEp->type == USB_ENDPOINT_XFER_CONTROL);
1472 * _hardware_dequeue: handles a request at hardware level
1476 * This function returns an error code
1478 static int _hardware_dequeue(struct ci13xxx_ep *mEp, struct ci13xxx_req *mReq)
1480 trace("%p, %p", mEp, mReq);
1482 if (mReq->req.status != -EALREADY)
1485 if (hw_ep_is_primed(mEp->num, mEp->dir))
1486 hw_ep_flush(mEp->num, mEp->dir);
1488 mReq->req.status = 0;
1491 dma_unmap_single(mEp->device, mReq->req.dma, mReq->req.length,
1492 mEp->dir ? DMA_TO_DEVICE : DMA_FROM_DEVICE);
1497 mReq->req.status = mReq->ptr->token & TD_STATUS;
1498 if ((TD_STATUS_ACTIVE & mReq->req.status) != 0)
1499 mReq->req.status = -ECONNRESET;
1500 else if ((TD_STATUS_HALTED & mReq->req.status) != 0)
1501 mReq->req.status = -1;
1502 else if ((TD_STATUS_DT_ERR & mReq->req.status) != 0)
1503 mReq->req.status = -1;
1504 else if ((TD_STATUS_TR_ERR & mReq->req.status) != 0)
1505 mReq->req.status = -1;
1507 mReq->req.actual = mReq->ptr->token & TD_TOTAL_BYTES;
1508 mReq->req.actual >>= ffs_nr(TD_TOTAL_BYTES);
1509 mReq->req.actual = mReq->req.length - mReq->req.actual;
1510 mReq->req.actual = mReq->req.status ? 0 : mReq->req.actual;
1512 return mReq->req.actual;
1516 * _ep_nuke: dequeues all endpoint requests
1519 * This function returns an error code
1520 * Caller must hold lock
1522 static int _ep_nuke(struct ci13xxx_ep *mEp)
1523 __releases(mEp->lock)
1524 __acquires(mEp->lock)
1531 hw_ep_flush(mEp->num, mEp->dir);
1533 while (!list_empty(&mEp->qh[mEp->dir].queue)) {
1535 /* pop oldest request */
1536 struct ci13xxx_req *mReq = \
1537 list_entry(mEp->qh[mEp->dir].queue.next,
1538 struct ci13xxx_req, queue);
1539 list_del_init(&mReq->queue);
1540 mReq->req.status = -ESHUTDOWN;
1542 if (!mReq->req.no_interrupt && mReq->req.complete != NULL) {
1543 spin_unlock(mEp->lock);
1544 mReq->req.complete(&mEp->ep, &mReq->req);
1545 spin_lock(mEp->lock);
1552 * _gadget_stop_activity: stops all USB activity, flushes & disables all endpts
1555 * This function returns an error code
1556 * Caller must hold lock
1558 static int _gadget_stop_activity(struct usb_gadget *gadget)
1559 __releases(udc->lock)
1560 __acquires(udc->lock)
1563 struct ci13xxx *udc = container_of(gadget, struct ci13xxx, gadget);
1564 struct ci13xxx_ep *mEp = container_of(gadget->ep0,
1565 struct ci13xxx_ep, ep);
1567 trace("%p", gadget);
1572 spin_unlock(udc->lock);
1574 /* flush all endpoints */
1575 gadget_for_each_ep(ep, gadget) {
1576 usb_ep_fifo_flush(ep);
1578 usb_ep_fifo_flush(gadget->ep0);
1580 udc->driver->disconnect(gadget);
1582 /* make sure to disable all endpoints */
1583 gadget_for_each_ep(ep, gadget) {
1586 usb_ep_disable(gadget->ep0);
1588 if (mEp->status != NULL) {
1589 usb_ep_free_request(gadget->ep0, mEp->status);
1593 spin_lock(udc->lock);
1598 /******************************************************************************
1600 *****************************************************************************/
1602 * isr_reset_handler: USB reset interrupt handler
1605 * This function resets USB engine after a bus reset occurred
1607 static void isr_reset_handler(struct ci13xxx *udc)
1608 __releases(udc->lock)
1609 __acquires(udc->lock)
1611 struct ci13xxx_ep *mEp = &udc->ci13xxx_ep[0];
1621 dbg_event(0xFF, "BUS RST", 0);
1623 retval = _gadget_stop_activity(&udc->gadget);
1627 retval = hw_usb_reset();
1631 spin_unlock(udc->lock);
1632 retval = usb_ep_enable(&mEp->ep, &ctrl_endpt_desc);
1634 mEp->status = usb_ep_alloc_request(&mEp->ep, GFP_KERNEL);
1635 if (mEp->status == NULL) {
1636 usb_ep_disable(&mEp->ep);
1640 spin_lock(udc->lock);
1644 err("error: %i", retval);
1648 * isr_get_status_complete: get_status request complete function
1650 * @req: request handled
1652 * Caller must release lock
1654 static void isr_get_status_complete(struct usb_ep *ep, struct usb_request *req)
1656 trace("%p, %p", ep, req);
1658 if (ep == NULL || req == NULL) {
1664 usb_ep_free_request(ep, req);
1668 * isr_get_status_response: get_status request response
1670 * @setup: setup request packet
1672 * This function returns an error code
1674 static int isr_get_status_response(struct ci13xxx_ep *mEp,
1675 struct usb_ctrlrequest *setup)
1676 __releases(mEp->lock)
1677 __acquires(mEp->lock)
1679 struct usb_request *req = NULL;
1680 gfp_t gfp_flags = GFP_ATOMIC;
1681 int dir, num, retval;
1683 trace("%p, %p", mEp, setup);
1685 if (mEp == NULL || setup == NULL)
1688 spin_unlock(mEp->lock);
1689 req = usb_ep_alloc_request(&mEp->ep, gfp_flags);
1690 spin_lock(mEp->lock);
1694 req->complete = isr_get_status_complete;
1696 req->buf = kzalloc(req->length, gfp_flags);
1697 if (req->buf == NULL) {
1702 if ((setup->bRequestType & USB_RECIP_MASK) == USB_RECIP_DEVICE) {
1703 /* TODO: D1 - Remote Wakeup; D0 - Self Powered */
1705 } else if ((setup->bRequestType & USB_RECIP_MASK) \
1706 == USB_RECIP_ENDPOINT) {
1707 dir = (le16_to_cpu(setup->wIndex) & USB_ENDPOINT_DIR_MASK) ?
1709 num = le16_to_cpu(setup->wIndex) & USB_ENDPOINT_NUMBER_MASK;
1710 *((u16 *)req->buf) = hw_ep_get_halt(num, dir);
1712 /* else do nothing; reserved for future use */
1714 spin_unlock(mEp->lock);
1715 retval = usb_ep_queue(&mEp->ep, req, gfp_flags);
1716 spin_lock(mEp->lock);
1725 spin_unlock(mEp->lock);
1726 usb_ep_free_request(&mEp->ep, req);
1727 spin_lock(mEp->lock);
1732 * isr_setup_status_phase: queues the status phase of a setup transation
1735 * This function returns an error code
1737 static int isr_setup_status_phase(struct ci13xxx_ep *mEp)
1738 __releases(mEp->lock)
1739 __acquires(mEp->lock)
1745 /* mEp is always valid & configured */
1747 if (mEp->type == USB_ENDPOINT_XFER_CONTROL)
1748 mEp->dir = (mEp->dir == TX) ? RX : TX;
1750 mEp->status->no_interrupt = 1;
1752 spin_unlock(mEp->lock);
1753 retval = usb_ep_queue(&mEp->ep, mEp->status, GFP_ATOMIC);
1754 spin_lock(mEp->lock);
1760 * isr_tr_complete_low: transaction complete low level handler
1763 * This function returns an error code
1764 * Caller must hold lock
1766 static int isr_tr_complete_low(struct ci13xxx_ep *mEp)
1767 __releases(mEp->lock)
1768 __acquires(mEp->lock)
1770 struct ci13xxx_req *mReq;
1775 if (list_empty(&mEp->qh[mEp->dir].queue))
1778 /* pop oldest request */
1779 mReq = list_entry(mEp->qh[mEp->dir].queue.next,
1780 struct ci13xxx_req, queue);
1781 list_del_init(&mReq->queue);
1783 retval = _hardware_dequeue(mEp, mReq);
1785 dbg_event(_usb_addr(mEp), "DONE", retval);
1789 dbg_done(_usb_addr(mEp), mReq->ptr->token, retval);
1791 if (!mReq->req.no_interrupt && mReq->req.complete != NULL) {
1792 spin_unlock(mEp->lock);
1793 mReq->req.complete(&mEp->ep, &mReq->req);
1794 spin_lock(mEp->lock);
1797 if (!list_empty(&mEp->qh[mEp->dir].queue)) {
1798 mReq = list_entry(mEp->qh[mEp->dir].queue.next,
1799 struct ci13xxx_req, queue);
1800 _hardware_enqueue(mEp, mReq);
1808 * isr_tr_complete_handler: transaction complete interrupt handler
1809 * @udc: UDC descriptor
1811 * This function handles traffic events
1813 static void isr_tr_complete_handler(struct ci13xxx *udc)
1814 __releases(udc->lock)
1815 __acquires(udc->lock)
1826 for (i = 0; i < hw_ep_max; i++) {
1827 struct ci13xxx_ep *mEp = &udc->ci13xxx_ep[i];
1828 int type, num, err = -EINVAL;
1829 struct usb_ctrlrequest req;
1832 if (mEp->desc == NULL)
1833 continue; /* not configured */
1835 if ((mEp->dir == RX && hw_test_and_clear_complete(i)) ||
1836 (mEp->dir == TX && hw_test_and_clear_complete(i + 16))) {
1837 err = isr_tr_complete_low(mEp);
1838 if (mEp->type == USB_ENDPOINT_XFER_CONTROL) {
1839 if (err > 0) /* needs status phase */
1840 err = isr_setup_status_phase(mEp);
1842 dbg_event(_usb_addr(mEp),
1844 spin_unlock(udc->lock);
1845 if (usb_ep_set_halt(&mEp->ep))
1846 err("error: ep_set_halt");
1847 spin_lock(udc->lock);
1852 if (mEp->type != USB_ENDPOINT_XFER_CONTROL ||
1853 !hw_test_and_clear_setup_status(i))
1857 warn("ctrl traffic received at endpoint");
1861 /* read_setup_packet */
1863 hw_test_and_set_setup_guard();
1864 memcpy(&req, &mEp->qh[RX].ptr->setup, sizeof(req));
1865 } while (!hw_test_and_clear_setup_guard());
1867 type = req.bRequestType;
1869 mEp->dir = (type & USB_DIR_IN) ? TX : RX;
1871 dbg_setup(_usb_addr(mEp), &req);
1873 switch (req.bRequest) {
1874 case USB_REQ_CLEAR_FEATURE:
1875 if (type != (USB_DIR_OUT|USB_RECIP_ENDPOINT) &&
1876 le16_to_cpu(req.wValue) != USB_ENDPOINT_HALT)
1878 if (req.wLength != 0)
1880 num = le16_to_cpu(req.wIndex);
1881 num &= USB_ENDPOINT_NUMBER_MASK;
1882 if (!udc->ci13xxx_ep[num].wedge) {
1883 spin_unlock(udc->lock);
1884 err = usb_ep_clear_halt(
1885 &udc->ci13xxx_ep[num].ep);
1886 spin_lock(udc->lock);
1890 err = isr_setup_status_phase(mEp);
1892 case USB_REQ_GET_STATUS:
1893 if (type != (USB_DIR_IN|USB_RECIP_DEVICE) &&
1894 type != (USB_DIR_IN|USB_RECIP_ENDPOINT) &&
1895 type != (USB_DIR_IN|USB_RECIP_INTERFACE))
1897 if (le16_to_cpu(req.wLength) != 2 ||
1898 le16_to_cpu(req.wValue) != 0)
1900 err = isr_get_status_response(mEp, &req);
1902 case USB_REQ_SET_ADDRESS:
1903 if (type != (USB_DIR_OUT|USB_RECIP_DEVICE))
1905 if (le16_to_cpu(req.wLength) != 0 ||
1906 le16_to_cpu(req.wIndex) != 0)
1908 err = hw_usb_set_address((u8)le16_to_cpu(req.wValue));
1911 err = isr_setup_status_phase(mEp);
1913 case USB_REQ_SET_FEATURE:
1914 if (type != (USB_DIR_OUT|USB_RECIP_ENDPOINT) &&
1915 le16_to_cpu(req.wValue) != USB_ENDPOINT_HALT)
1917 if (req.wLength != 0)
1919 num = le16_to_cpu(req.wIndex);
1920 num &= USB_ENDPOINT_NUMBER_MASK;
1922 spin_unlock(udc->lock);
1923 err = usb_ep_set_halt(&udc->ci13xxx_ep[num].ep);
1924 spin_lock(udc->lock);
1927 err = isr_setup_status_phase(mEp);
1931 if (req.wLength == 0) /* no data phase */
1934 spin_unlock(udc->lock);
1935 err = udc->driver->setup(&udc->gadget, &req);
1936 spin_lock(udc->lock);
1941 dbg_event(_usb_addr(mEp), "ERROR", err);
1943 spin_unlock(udc->lock);
1944 if (usb_ep_set_halt(&mEp->ep))
1945 err("error: ep_set_halt");
1946 spin_lock(udc->lock);
1951 /******************************************************************************
1953 *****************************************************************************/
1955 * ep_enable: configure endpoint, making it usable
1957 * Check usb_ep_enable() at "usb_gadget.h" for details
1959 static int ep_enable(struct usb_ep *ep,
1960 const struct usb_endpoint_descriptor *desc)
1962 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
1963 int direction, retval = 0;
1964 unsigned long flags;
1966 trace("%p, %p", ep, desc);
1968 if (ep == NULL || desc == NULL)
1971 spin_lock_irqsave(mEp->lock, flags);
1973 /* only internal SW should enable ctrl endpts */
1977 if (!list_empty(&mEp->qh[mEp->dir].queue))
1978 warn("enabling a non-empty endpoint!");
1980 mEp->dir = (desc->bEndpointAddress & USB_ENDPOINT_DIR_MASK) ? TX : RX;
1981 mEp->num = desc->bEndpointAddress & USB_ENDPOINT_NUMBER_MASK;
1982 mEp->type = desc->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK;
1984 mEp->ep.maxpacket = __constant_le16_to_cpu(desc->wMaxPacketSize);
1986 direction = mEp->dir;
1988 dbg_event(_usb_addr(mEp), "ENABLE", 0);
1990 if (mEp->type == USB_ENDPOINT_XFER_CONTROL)
1991 mEp->qh[mEp->dir].ptr->cap |= QH_IOS;
1992 else if (mEp->type == USB_ENDPOINT_XFER_ISOC)
1993 mEp->qh[mEp->dir].ptr->cap &= ~QH_MULT;
1995 mEp->qh[mEp->dir].ptr->cap &= ~QH_ZLT;
1997 mEp->qh[mEp->dir].ptr->cap |=
1998 (mEp->ep.maxpacket << ffs_nr(QH_MAX_PKT)) & QH_MAX_PKT;
1999 mEp->qh[mEp->dir].ptr->td.next |= TD_TERMINATE; /* needed? */
2001 retval |= hw_ep_enable(mEp->num, mEp->dir, mEp->type);
2003 if (mEp->type == USB_ENDPOINT_XFER_CONTROL)
2004 mEp->dir = (mEp->dir == TX) ? RX : TX;
2006 } while (mEp->dir != direction);
2008 spin_unlock_irqrestore(mEp->lock, flags);
2013 * ep_disable: endpoint is no longer usable
2015 * Check usb_ep_disable() at "usb_gadget.h" for details
2017 static int ep_disable(struct usb_ep *ep)
2019 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2020 int direction, retval = 0;
2021 unsigned long flags;
2027 else if (mEp->desc == NULL)
2030 spin_lock_irqsave(mEp->lock, flags);
2032 /* only internal SW should disable ctrl endpts */
2034 direction = mEp->dir;
2036 dbg_event(_usb_addr(mEp), "DISABLE", 0);
2038 retval |= _ep_nuke(mEp);
2039 retval |= hw_ep_disable(mEp->num, mEp->dir);
2041 if (mEp->type == USB_ENDPOINT_XFER_CONTROL)
2042 mEp->dir = (mEp->dir == TX) ? RX : TX;
2044 } while (mEp->dir != direction);
2048 spin_unlock_irqrestore(mEp->lock, flags);
2053 * ep_alloc_request: allocate a request object to use with this endpoint
2055 * Check usb_ep_alloc_request() at "usb_gadget.h" for details
2057 static struct usb_request *ep_alloc_request(struct usb_ep *ep, gfp_t gfp_flags)
2059 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2060 struct ci13xxx_req *mReq = NULL;
2061 unsigned long flags;
2063 trace("%p, %i", ep, gfp_flags);
2070 spin_lock_irqsave(mEp->lock, flags);
2072 mReq = kzalloc(sizeof(struct ci13xxx_req), gfp_flags);
2074 INIT_LIST_HEAD(&mReq->queue);
2076 mReq->ptr = dma_pool_alloc(mEp->td_pool, gfp_flags,
2078 if (mReq->ptr == NULL) {
2084 dbg_event(_usb_addr(mEp), "ALLOC", mReq == NULL);
2086 spin_unlock_irqrestore(mEp->lock, flags);
2088 return (mReq == NULL) ? NULL : &mReq->req;
2092 * ep_free_request: frees a request object
2094 * Check usb_ep_free_request() at "usb_gadget.h" for details
2096 static void ep_free_request(struct usb_ep *ep, struct usb_request *req)
2098 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2099 struct ci13xxx_req *mReq = container_of(req, struct ci13xxx_req, req);
2100 unsigned long flags;
2102 trace("%p, %p", ep, req);
2104 if (ep == NULL || req == NULL) {
2107 } else if (!list_empty(&mReq->queue)) {
2112 spin_lock_irqsave(mEp->lock, flags);
2115 dma_pool_free(mEp->td_pool, mReq->ptr, mReq->dma);
2118 dbg_event(_usb_addr(mEp), "FREE", 0);
2120 spin_unlock_irqrestore(mEp->lock, flags);
2124 * ep_queue: queues (submits) an I/O request to an endpoint
2126 * Check usb_ep_queue()* at usb_gadget.h" for details
2128 static int ep_queue(struct usb_ep *ep, struct usb_request *req,
2129 gfp_t __maybe_unused gfp_flags)
2131 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2132 struct ci13xxx_req *mReq = container_of(req, struct ci13xxx_req, req);
2134 unsigned long flags;
2136 trace("%p, %p, %X", ep, req, gfp_flags);
2138 if (ep == NULL || req == NULL || mEp->desc == NULL)
2141 spin_lock_irqsave(mEp->lock, flags);
2143 if (mEp->type == USB_ENDPOINT_XFER_CONTROL &&
2144 !list_empty(&mEp->qh[mEp->dir].queue)) {
2146 retval = -EOVERFLOW;
2147 warn("endpoint ctrl %X nuked", _usb_addr(mEp));
2150 /* first nuke then test link, e.g. previous status has not sent */
2151 if (!list_empty(&mReq->queue)) {
2153 err("request already in queue");
2157 if (req->length > (4 * PAGE_SIZE)) {
2158 req->length = (4 * PAGE_SIZE);
2160 warn("request length truncated");
2163 dbg_queue(_usb_addr(mEp), req, retval);
2166 mReq->req.status = -EINPROGRESS;
2167 mReq->req.actual = 0;
2168 list_add_tail(&mReq->queue, &mEp->qh[mEp->dir].queue);
2170 retval = _hardware_enqueue(mEp, mReq);
2171 if (retval == -EALREADY || retval == -EBUSY) {
2172 dbg_event(_usb_addr(mEp), "QUEUE", retval);
2177 spin_unlock_irqrestore(mEp->lock, flags);
2182 * ep_dequeue: dequeues (cancels, unlinks) an I/O request from an endpoint
2184 * Check usb_ep_dequeue() at "usb_gadget.h" for details
2186 static int ep_dequeue(struct usb_ep *ep, struct usb_request *req)
2188 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2189 struct ci13xxx_req *mReq = container_of(req, struct ci13xxx_req, req);
2190 unsigned long flags;
2192 trace("%p, %p", ep, req);
2194 if (ep == NULL || req == NULL || mEp->desc == NULL ||
2195 list_empty(&mReq->queue) || list_empty(&mEp->qh[mEp->dir].queue))
2198 spin_lock_irqsave(mEp->lock, flags);
2200 dbg_event(_usb_addr(mEp), "DEQUEUE", 0);
2202 if (mReq->req.status == -EALREADY)
2203 _hardware_dequeue(mEp, mReq);
2206 list_del_init(&mReq->queue);
2207 req->status = -ECONNRESET;
2209 if (!mReq->req.no_interrupt && mReq->req.complete != NULL) {
2210 spin_unlock(mEp->lock);
2211 mReq->req.complete(&mEp->ep, &mReq->req);
2212 spin_lock(mEp->lock);
2215 spin_unlock_irqrestore(mEp->lock, flags);
2220 * ep_set_halt: sets the endpoint halt feature
2222 * Check usb_ep_set_halt() at "usb_gadget.h" for details
2224 static int ep_set_halt(struct usb_ep *ep, int value)
2226 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2227 int direction, retval = 0;
2228 unsigned long flags;
2230 trace("%p, %i", ep, value);
2232 if (ep == NULL || mEp->desc == NULL)
2235 spin_lock_irqsave(mEp->lock, flags);
2238 /* g_file_storage MS compliant but g_zero fails chapter 9 compliance */
2239 if (value && mEp->type == USB_ENDPOINT_XFER_BULK && mEp->dir == TX &&
2240 !list_empty(&mEp->qh[mEp->dir].queue)) {
2241 spin_unlock_irqrestore(mEp->lock, flags);
2246 direction = mEp->dir;
2248 dbg_event(_usb_addr(mEp), "HALT", value);
2249 retval |= hw_ep_set_halt(mEp->num, mEp->dir, value);
2254 if (mEp->type == USB_ENDPOINT_XFER_CONTROL)
2255 mEp->dir = (mEp->dir == TX) ? RX : TX;
2257 } while (mEp->dir != direction);
2259 spin_unlock_irqrestore(mEp->lock, flags);
2264 * ep_set_wedge: sets the halt feature and ignores clear requests
2266 * Check usb_ep_set_wedge() at "usb_gadget.h" for details
2268 static int ep_set_wedge(struct usb_ep *ep)
2270 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2271 unsigned long flags;
2275 if (ep == NULL || mEp->desc == NULL)
2278 spin_lock_irqsave(mEp->lock, flags);
2280 dbg_event(_usb_addr(mEp), "WEDGE", 0);
2283 spin_unlock_irqrestore(mEp->lock, flags);
2285 return usb_ep_set_halt(ep);
2289 * ep_fifo_flush: flushes contents of a fifo
2291 * Check usb_ep_fifo_flush() at "usb_gadget.h" for details
2293 static void ep_fifo_flush(struct usb_ep *ep)
2295 struct ci13xxx_ep *mEp = container_of(ep, struct ci13xxx_ep, ep);
2296 unsigned long flags;
2301 err("%02X: -EINVAL", _usb_addr(mEp));
2305 spin_lock_irqsave(mEp->lock, flags);
2307 dbg_event(_usb_addr(mEp), "FFLUSH", 0);
2308 hw_ep_flush(mEp->num, mEp->dir);
2310 spin_unlock_irqrestore(mEp->lock, flags);
2314 * Endpoint-specific part of the API to the USB controller hardware
2315 * Check "usb_gadget.h" for details
2317 static const struct usb_ep_ops usb_ep_ops = {
2318 .enable = ep_enable,
2319 .disable = ep_disable,
2320 .alloc_request = ep_alloc_request,
2321 .free_request = ep_free_request,
2323 .dequeue = ep_dequeue,
2324 .set_halt = ep_set_halt,
2325 .set_wedge = ep_set_wedge,
2326 .fifo_flush = ep_fifo_flush,
2329 /******************************************************************************
2331 *****************************************************************************/
2333 * Device operations part of the API to the USB controller hardware,
2334 * which don't involve endpoints (or i/o)
2335 * Check "usb_gadget.h" for details
2337 static const struct usb_gadget_ops usb_gadget_ops;
2340 * usb_gadget_register_driver: register a gadget driver
2342 * Check usb_gadget_register_driver() at "usb_gadget.h" for details
2343 * Interrupts are enabled here
2345 int usb_gadget_register_driver(struct usb_gadget_driver *driver)
2347 struct ci13xxx *udc = _udc;
2348 unsigned long i, k, flags;
2349 int retval = -ENOMEM;
2351 trace("%p", driver);
2353 if (driver == NULL ||
2354 driver->bind == NULL ||
2355 driver->unbind == NULL ||
2356 driver->setup == NULL ||
2357 driver->disconnect == NULL ||
2358 driver->suspend == NULL ||
2359 driver->resume == NULL)
2361 else if (udc == NULL)
2363 else if (udc->driver != NULL)
2366 /* alloc resources */
2367 udc->qh_pool = dma_pool_create("ci13xxx_qh", &udc->gadget.dev,
2368 sizeof(struct ci13xxx_qh),
2370 if (udc->qh_pool == NULL)
2373 udc->td_pool = dma_pool_create("ci13xxx_td", &udc->gadget.dev,
2374 sizeof(struct ci13xxx_td),
2376 if (udc->td_pool == NULL) {
2377 dma_pool_destroy(udc->qh_pool);
2378 udc->qh_pool = NULL;
2382 spin_lock_irqsave(udc->lock, flags);
2384 info("hw_ep_max = %d", hw_ep_max);
2386 udc->driver = driver;
2387 udc->gadget.ops = NULL;
2388 udc->gadget.dev.driver = NULL;
2391 for (i = 0; i < hw_ep_max; i++) {
2392 struct ci13xxx_ep *mEp = &udc->ci13xxx_ep[i];
2394 scnprintf(mEp->name, sizeof(mEp->name), "ep%i", (int)i);
2396 mEp->lock = udc->lock;
2397 mEp->device = &udc->gadget.dev;
2398 mEp->td_pool = udc->td_pool;
2400 mEp->ep.name = mEp->name;
2401 mEp->ep.ops = &usb_ep_ops;
2402 mEp->ep.maxpacket = CTRL_PAYLOAD_MAX;
2404 /* this allocation cannot be random */
2405 for (k = RX; k <= TX; k++) {
2406 INIT_LIST_HEAD(&mEp->qh[k].queue);
2407 mEp->qh[k].ptr = dma_pool_alloc(udc->qh_pool,
2410 if (mEp->qh[k].ptr == NULL)
2413 memset(mEp->qh[k].ptr, 0,
2414 sizeof(*mEp->qh[k].ptr));
2417 udc->gadget.ep0 = &mEp->ep;
2419 list_add_tail(&mEp->ep.ep_list, &udc->gadget.ep_list);
2425 driver->driver.bus = NULL;
2426 udc->gadget.ops = &usb_gadget_ops;
2427 udc->gadget.dev.driver = &driver->driver;
2429 spin_unlock_irqrestore(udc->lock, flags);
2430 retval = driver->bind(&udc->gadget); /* MAY SLEEP */
2431 spin_lock_irqsave(udc->lock, flags);
2434 udc->gadget.ops = NULL;
2435 udc->gadget.dev.driver = NULL;
2439 retval = hw_device_state(udc->ci13xxx_ep[0].qh[RX].dma);
2442 spin_unlock_irqrestore(udc->lock, flags);
2444 usb_gadget_unregister_driver(driver);
2447 EXPORT_SYMBOL(usb_gadget_register_driver);
2450 * usb_gadget_unregister_driver: unregister a gadget driver
2452 * Check usb_gadget_unregister_driver() at "usb_gadget.h" for details
2454 int usb_gadget_unregister_driver(struct usb_gadget_driver *driver)
2456 struct ci13xxx *udc = _udc;
2457 unsigned long i, k, flags;
2459 trace("%p", driver);
2461 if (driver == NULL ||
2462 driver->bind == NULL ||
2463 driver->unbind == NULL ||
2464 driver->setup == NULL ||
2465 driver->disconnect == NULL ||
2466 driver->suspend == NULL ||
2467 driver->resume == NULL ||
2468 driver != udc->driver)
2471 spin_lock_irqsave(udc->lock, flags);
2476 if (udc->gadget.ops != NULL) {
2477 _gadget_stop_activity(&udc->gadget);
2479 spin_unlock_irqrestore(udc->lock, flags);
2480 driver->unbind(&udc->gadget); /* MAY SLEEP */
2481 spin_lock_irqsave(udc->lock, flags);
2483 udc->gadget.ops = NULL;
2484 udc->gadget.dev.driver = NULL;
2487 /* free resources */
2488 for (i = 0; i < hw_ep_max; i++) {
2489 struct ci13xxx_ep *mEp = &udc->ci13xxx_ep[i];
2492 udc->gadget.ep0 = NULL;
2493 else if (!list_empty(&mEp->ep.ep_list))
2494 list_del_init(&mEp->ep.ep_list);
2496 for (k = RX; k <= TX; k++)
2497 if (mEp->qh[k].ptr != NULL)
2498 dma_pool_free(udc->qh_pool,
2499 mEp->qh[k].ptr, mEp->qh[k].dma);
2504 spin_unlock_irqrestore(udc->lock, flags);
2506 if (udc->td_pool != NULL) {
2507 dma_pool_destroy(udc->td_pool);
2508 udc->td_pool = NULL;
2510 if (udc->qh_pool != NULL) {
2511 dma_pool_destroy(udc->qh_pool);
2512 udc->qh_pool = NULL;
2517 EXPORT_SYMBOL(usb_gadget_unregister_driver);
2519 /******************************************************************************
2521 *****************************************************************************/
2523 * udc_irq: global interrupt handler
2525 * This function returns IRQ_HANDLED if the IRQ has been handled
2526 * It locks access to registers
2528 static irqreturn_t udc_irq(void)
2530 struct ci13xxx *udc = _udc;
2541 spin_lock(udc->lock);
2542 intr = hw_test_and_clear_intr_active();
2544 isr_statistics.hndl.buf[isr_statistics.hndl.idx++] = intr;
2545 isr_statistics.hndl.idx &= ISR_MASK;
2546 isr_statistics.hndl.cnt++;
2548 /* order defines priority - do NOT change it */
2549 if (USBi_URI & intr) {
2550 isr_statistics.uri++;
2551 isr_reset_handler(udc);
2553 if (USBi_PCI & intr) {
2554 isr_statistics.pci++;
2555 udc->gadget.speed = hw_port_is_high_speed() ?
2556 USB_SPEED_HIGH : USB_SPEED_FULL;
2558 if (USBi_UEI & intr)
2559 isr_statistics.uei++;
2560 if (USBi_UI & intr) {
2561 isr_statistics.ui++;
2562 isr_tr_complete_handler(udc);
2564 if (USBi_SLI & intr)
2565 isr_statistics.sli++;
2566 retval = IRQ_HANDLED;
2568 isr_statistics.none++;
2571 spin_unlock(udc->lock);
2577 * udc_release: driver release function
2580 * Currently does nothing
2582 static void udc_release(struct device *dev)
2591 * udc_probe: parent probe must call this to initialize UDC
2592 * @dev: parent device
2593 * @regs: registers base address
2594 * @name: driver name
2596 * This function returns an error code
2597 * No interrupts active, the IRQ has not been requested yet
2598 * Kernel assumes 32-bit DMA operations by default, no need to dma_set_mask
2600 static int udc_probe(struct device *dev, void __iomem *regs, const char *name)
2602 struct ci13xxx *udc;
2605 trace("%p, %p, %p", dev, regs, name);
2607 if (dev == NULL || regs == NULL || name == NULL)
2610 udc = kzalloc(sizeof(struct ci13xxx), GFP_KERNEL);
2614 udc->lock = &udc_lock;
2616 retval = hw_device_reset(regs);
2620 udc->gadget.ops = NULL;
2621 udc->gadget.speed = USB_SPEED_UNKNOWN;
2622 udc->gadget.is_dualspeed = 1;
2623 udc->gadget.is_otg = 0;
2624 udc->gadget.name = name;
2626 INIT_LIST_HEAD(&udc->gadget.ep_list);
2627 udc->gadget.ep0 = NULL;
2629 strcpy(udc->gadget.dev.bus_id, "gadget");
2630 udc->gadget.dev.dma_mask = dev->dma_mask;
2631 udc->gadget.dev.parent = dev;
2632 udc->gadget.dev.release = udc_release;
2634 retval = device_register(&udc->gadget.dev);
2638 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
2639 retval = dbg_create_files(&udc->gadget.dev);
2642 device_unregister(&udc->gadget.dev);
2650 err("error = %i", retval);
2657 * udc_remove: parent remove must call this to remove UDC
2659 * No interrupts active, the IRQ has been released
2661 static void udc_remove(void)
2663 struct ci13xxx *udc = _udc;
2670 #ifdef CONFIG_USB_GADGET_DEBUG_FILES
2671 dbg_remove_files(&udc->gadget.dev);
2673 device_unregister(&udc->gadget.dev);
2679 /******************************************************************************
2681 *****************************************************************************/
2683 * ci13xxx_pci_irq: interrut handler
2685 * @pdev: USB Device Controller interrupt source
2687 * This function returns IRQ_HANDLED if the IRQ has been handled
2688 * This is an ISR don't trace, use attribute interface instead
2690 static irqreturn_t ci13xxx_pci_irq(int irq, void *pdev)
2693 dev_err(&((struct pci_dev *)pdev)->dev, "Invalid IRQ0 usage!");
2700 * ci13xxx_pci_probe: PCI probe
2701 * @pdev: USB device controller being probed
2702 * @id: PCI hotplug ID connecting controller to UDC framework
2704 * This function returns an error code
2705 * Allocates basic PCI resources for this USB device controller, and then
2706 * invokes the udc_probe() method to start the UDC associated with it
2708 static int __devinit ci13xxx_pci_probe(struct pci_dev *pdev,
2709 const struct pci_device_id *id)
2711 void __iomem *regs = NULL;
2717 retval = pci_enable_device(pdev);
2722 dev_err(&pdev->dev, "No IRQ, check BIOS/PCI setup!");
2724 goto disable_device;
2727 retval = pci_request_regions(pdev, UDC_DRIVER_NAME);
2729 goto disable_device;
2731 /* BAR 0 holds all the registers */
2732 regs = pci_iomap(pdev, 0, 0);
2734 dev_err(&pdev->dev, "Error mapping memory!");
2736 goto release_regions;
2738 pci_set_drvdata(pdev, (__force void *)regs);
2740 pci_set_master(pdev);
2741 pci_try_set_mwi(pdev);
2743 retval = udc_probe(&pdev->dev, regs, UDC_DRIVER_NAME);
2747 /* our device does not have MSI capability */
2749 retval = request_irq(pdev->irq, ci13xxx_pci_irq, IRQF_SHARED,
2750 UDC_DRIVER_NAME, pdev);
2759 pci_iounmap(pdev, regs);
2761 pci_release_regions(pdev);
2763 pci_disable_device(pdev);
2769 * ci13xxx_pci_remove: PCI remove
2770 * @pdev: USB Device Controller being removed
2772 * Reverses the effect of ci13xxx_pci_probe(),
2773 * first invoking the udc_remove() and then releases
2774 * all PCI resources allocated for this USB device controller
2776 static void __devexit ci13xxx_pci_remove(struct pci_dev *pdev)
2778 free_irq(pdev->irq, pdev);
2780 pci_iounmap(pdev, (__force void __iomem *)pci_get_drvdata(pdev));
2781 pci_release_regions(pdev);
2782 pci_disable_device(pdev);
2787 * PCI device structure
2789 * Check "pci.h" for details
2791 static DEFINE_PCI_DEVICE_TABLE(ci13xxx_pci_id_table) = {
2792 { PCI_DEVICE(0x153F, 0x1004) },
2793 { PCI_DEVICE(0x153F, 0x1006) },
2794 { 0, 0, 0, 0, 0, 0, 0 /* end: all zeroes */ }
2796 MODULE_DEVICE_TABLE(pci, ci13xxx_pci_id_table);
2798 static struct pci_driver ci13xxx_pci_driver = {
2799 .name = UDC_DRIVER_NAME,
2800 .id_table = ci13xxx_pci_id_table,
2801 .probe = ci13xxx_pci_probe,
2802 .remove = __devexit_p(ci13xxx_pci_remove),
2806 * ci13xxx_pci_init: module init
2810 static int __init ci13xxx_pci_init(void)
2812 return pci_register_driver(&ci13xxx_pci_driver);
2814 module_init(ci13xxx_pci_init);
2817 * ci13xxx_pci_exit: module exit
2821 static void __exit ci13xxx_pci_exit(void)
2823 pci_unregister_driver(&ci13xxx_pci_driver);
2825 module_exit(ci13xxx_pci_exit);
2827 MODULE_AUTHOR("MIPS - David Lopo <dlopo@chipidea.mips.com>");
2828 MODULE_DESCRIPTION("MIPS CI13XXX USB Peripheral Controller");
2829 MODULE_LICENSE("GPL");
2830 MODULE_VERSION("June 2008");