2 * g_serial.c -- USB gadget serial driver
4 * Copyright 2003 (C) Al Borchers (alborchers@steinerpoint.com)
6 * This code is based in part on the Gadget Zero driver, which
7 * is Copyright (C) 2003 by David Brownell, all rights reserved.
9 * This code also borrows from usbserial.c, which is
10 * Copyright (C) 1999 - 2002 Greg Kroah-Hartman (greg@kroah.com)
11 * Copyright (C) 2000 Peter Berger (pberger@brimson.com)
12 * Copyright (C) 2000 Al Borchers (alborchers@steinerpoint.com)
14 * This software is distributed under the terms of the GNU General
15 * Public License ("GPL") as published by the Free Software Foundation,
16 * either version 2 of that License or (at your option) any later version.
20 #include <linux/config.h>
21 #include <linux/module.h>
22 #include <linux/kernel.h>
23 #include <linux/delay.h>
24 #include <linux/ioport.h>
25 #include <linux/sched.h>
26 #include <linux/slab.h>
27 #include <linux/smp_lock.h>
28 #include <linux/errno.h>
29 #include <linux/init.h>
30 #include <linux/timer.h>
31 #include <linux/list.h>
32 #include <linux/interrupt.h>
33 #include <linux/utsname.h>
34 #include <linux/wait.h>
35 #include <linux/proc_fs.h>
36 #include <linux/device.h>
37 #include <linux/tty.h>
38 #include <linux/tty_flip.h>
40 #include <asm/byteorder.h>
43 #include <asm/system.h>
44 #include <asm/unaligned.h>
45 #include <asm/uaccess.h>
47 #include <linux/usb_ch9.h>
48 #include <linux/usb_cdc.h>
49 #include <linux/usb_gadget.h>
51 #include "gadget_chips.h"
56 #define __wait_cond_interruptible(wq, condition, lock, flags, ret) \
58 wait_queue_t __wait; \
59 init_waitqueue_entry(&__wait, current); \
61 add_wait_queue(&wq, &__wait); \
63 set_current_state(TASK_INTERRUPTIBLE); \
66 if (!signal_pending(current)) { \
67 spin_unlock_irqrestore(lock, flags); \
69 spin_lock_irqsave(lock, flags); \
75 current->state = TASK_RUNNING; \
76 remove_wait_queue(&wq, &__wait); \
79 #define wait_cond_interruptible(wq, condition, lock, flags) \
83 __wait_cond_interruptible(wq, condition, lock, flags, \
88 #define __wait_cond_interruptible_timeout(wq, condition, lock, flags, \
91 signed long __timeout = timeout; \
92 wait_queue_t __wait; \
93 init_waitqueue_entry(&__wait, current); \
95 add_wait_queue(&wq, &__wait); \
97 set_current_state(TASK_INTERRUPTIBLE); \
102 if (!signal_pending(current)) { \
103 spin_unlock_irqrestore(lock, flags); \
104 __timeout = schedule_timeout(__timeout); \
105 spin_lock_irqsave(lock, flags); \
108 ret = -ERESTARTSYS; \
111 current->state = TASK_RUNNING; \
112 remove_wait_queue(&wq, &__wait); \
115 #define wait_cond_interruptible_timeout(wq, condition, lock, flags, \
120 __wait_cond_interruptible_timeout(wq, condition, lock, \
121 flags, timeout, __ret); \
128 #define GS_VERSION_STR "v2.0"
129 #define GS_VERSION_NUM 0x0200
131 #define GS_LONG_NAME "Gadget Serial"
132 #define GS_SHORT_NAME "g_serial"
135 #define GS_MINOR_START 0
137 #define GS_NUM_PORTS 16
139 #define GS_NUM_CONFIGS 1
140 #define GS_NO_CONFIG_ID 0
141 #define GS_BULK_CONFIG_ID 1
142 #define GS_ACM_CONFIG_ID 2
144 #define GS_MAX_NUM_INTERFACES 2
145 #define GS_BULK_INTERFACE_ID 0
146 #define GS_CONTROL_INTERFACE_ID 0
147 #define GS_DATA_INTERFACE_ID 1
149 #define GS_MAX_DESC_LEN 256
151 #define GS_DEFAULT_READ_Q_SIZE 32
152 #define GS_DEFAULT_WRITE_Q_SIZE 32
154 #define GS_DEFAULT_WRITE_BUF_SIZE 8192
155 #define GS_TMP_BUF_SIZE 8192
157 #define GS_CLOSE_TIMEOUT 15
159 #define GS_DEFAULT_USE_ACM 0
161 #define GS_DEFAULT_DTE_RATE 9600
162 #define GS_DEFAULT_DATA_BITS 8
163 #define GS_DEFAULT_PARITY USB_CDC_NO_PARITY
164 #define GS_DEFAULT_CHAR_FORMAT USB_CDC_1_STOP_BITS
166 /* select highspeed/fullspeed, hiding highspeed if not configured */
167 #ifdef CONFIG_USB_GADGET_DUALSPEED
168 #define GS_SPEED_SELECT(is_hs,hs,fs) ((is_hs) ? (hs) : (fs))
170 #define GS_SPEED_SELECT(is_hs,hs,fs) (fs)
171 #endif /* CONFIG_USB_GADGET_DUALSPEED */
175 static int debug = 1;
177 #define gs_debug(format, arg...) \
178 do { if (debug) printk(KERN_DEBUG format, ## arg); } while(0)
179 #define gs_debug_level(level, format, arg...) \
180 do { if (debug>=level) printk(KERN_DEBUG format, ## arg); } while(0)
184 #define gs_debug(format, arg...) \
186 #define gs_debug_level(level, format, arg...) \
189 #endif /* GS_DEBUG */
191 /* Thanks to NetChip Technologies for donating this product ID.
193 * DO NOT REUSE THESE IDs with a protocol-incompatible driver!! Ever!!
194 * Instead: allocate your own, using normal USB-IF procedures.
196 #define GS_VENDOR_ID 0x0525 /* NetChip */
197 #define GS_PRODUCT_ID 0xa4a6 /* Linux-USB Serial Gadget */
198 #define GS_CDC_PRODUCT_ID 0xa4a7 /* ... as CDC-ACM */
200 #define GS_LOG2_NOTIFY_INTERVAL 5 /* 1 << 5 == 32 msec */
201 #define GS_NOTIFY_MAXPACKET 8
208 /* circular buffer */
210 unsigned int buf_size;
216 /* list of requests */
217 struct gs_req_entry {
218 struct list_head re_entry;
219 struct usb_request *re_req;
222 /* the port structure holds info for each port, one for each minor number */
224 struct gs_dev *port_dev; /* pointer to device struct */
225 struct tty_struct *port_tty; /* pointer to tty struct */
226 spinlock_t port_lock;
229 int port_in_use; /* open/close in progress */
230 wait_queue_head_t port_write_wait;/* waiting to write */
231 struct gs_buf *port_write_buf;
232 struct usb_cdc_line_coding port_line_coding;
235 /* the device structure holds info for the USB device */
237 struct usb_gadget *dev_gadget; /* gadget device pointer */
238 spinlock_t dev_lock; /* lock for set/reset config */
239 int dev_config; /* configuration number */
240 struct usb_ep *dev_notify_ep; /* address of notify endpoint */
241 struct usb_ep *dev_in_ep; /* address of in endpoint */
242 struct usb_ep *dev_out_ep; /* address of out endpoint */
243 struct usb_endpoint_descriptor /* descriptor of notify ep */
245 struct usb_endpoint_descriptor /* descriptor of in endpoint */
247 struct usb_endpoint_descriptor /* descriptor of out endpoint */
249 struct usb_request *dev_ctrl_req; /* control request */
250 struct list_head dev_req_list; /* list of write requests */
251 int dev_sched_port; /* round robin port scheduled */
252 struct gs_port *dev_port[GS_NUM_PORTS]; /* the ports */
259 static int __init gs_module_init(void);
260 static void __exit gs_module_exit(void);
263 static int gs_open(struct tty_struct *tty, struct file *file);
264 static void gs_close(struct tty_struct *tty, struct file *file);
265 static int gs_write(struct tty_struct *tty,
266 const unsigned char *buf, int count);
267 static void gs_put_char(struct tty_struct *tty, unsigned char ch);
268 static void gs_flush_chars(struct tty_struct *tty);
269 static int gs_write_room(struct tty_struct *tty);
270 static int gs_chars_in_buffer(struct tty_struct *tty);
271 static void gs_throttle(struct tty_struct * tty);
272 static void gs_unthrottle(struct tty_struct * tty);
273 static void gs_break(struct tty_struct *tty, int break_state);
274 static int gs_ioctl(struct tty_struct *tty, struct file *file,
275 unsigned int cmd, unsigned long arg);
276 static void gs_set_termios(struct tty_struct *tty, struct termios *old);
278 static int gs_send(struct gs_dev *dev);
279 static int gs_send_packet(struct gs_dev *dev, char *packet,
281 static int gs_recv_packet(struct gs_dev *dev, char *packet,
283 static void gs_read_complete(struct usb_ep *ep, struct usb_request *req);
284 static void gs_write_complete(struct usb_ep *ep, struct usb_request *req);
287 static int gs_bind(struct usb_gadget *gadget);
288 static void gs_unbind(struct usb_gadget *gadget);
289 static int gs_setup(struct usb_gadget *gadget,
290 const struct usb_ctrlrequest *ctrl);
291 static int gs_setup_standard(struct usb_gadget *gadget,
292 const struct usb_ctrlrequest *ctrl);
293 static int gs_setup_class(struct usb_gadget *gadget,
294 const struct usb_ctrlrequest *ctrl);
295 static void gs_setup_complete(struct usb_ep *ep, struct usb_request *req);
296 static void gs_disconnect(struct usb_gadget *gadget);
297 static int gs_set_config(struct gs_dev *dev, unsigned config);
298 static void gs_reset_config(struct gs_dev *dev);
299 static int gs_build_config_buf(u8 *buf, enum usb_device_speed speed,
300 u8 type, unsigned int index, int is_otg);
302 static struct usb_request *gs_alloc_req(struct usb_ep *ep, unsigned int len,
303 gfp_t kmalloc_flags);
304 static void gs_free_req(struct usb_ep *ep, struct usb_request *req);
306 static struct gs_req_entry *gs_alloc_req_entry(struct usb_ep *ep, unsigned len,
307 gfp_t kmalloc_flags);
308 static void gs_free_req_entry(struct usb_ep *ep, struct gs_req_entry *req);
310 static int gs_alloc_ports(struct gs_dev *dev, gfp_t kmalloc_flags);
311 static void gs_free_ports(struct gs_dev *dev);
313 /* circular buffer */
314 static struct gs_buf *gs_buf_alloc(unsigned int size, gfp_t kmalloc_flags);
315 static void gs_buf_free(struct gs_buf *gb);
316 static void gs_buf_clear(struct gs_buf *gb);
317 static unsigned int gs_buf_data_avail(struct gs_buf *gb);
318 static unsigned int gs_buf_space_avail(struct gs_buf *gb);
319 static unsigned int gs_buf_put(struct gs_buf *gb, const char *buf,
321 static unsigned int gs_buf_get(struct gs_buf *gb, char *buf,
324 /* external functions */
325 extern int net2280_set_fifo_mode(struct usb_gadget *gadget, int mode);
330 static struct gs_dev *gs_device;
332 static const char *EP_IN_NAME;
333 static const char *EP_OUT_NAME;
334 static const char *EP_NOTIFY_NAME;
336 static struct semaphore gs_open_close_sem[GS_NUM_PORTS];
338 static unsigned int read_q_size = GS_DEFAULT_READ_Q_SIZE;
339 static unsigned int write_q_size = GS_DEFAULT_WRITE_Q_SIZE;
341 static unsigned int write_buf_size = GS_DEFAULT_WRITE_BUF_SIZE;
343 static unsigned int use_acm = GS_DEFAULT_USE_ACM;
346 /* tty driver struct */
347 static struct tty_operations gs_tty_ops = {
351 .put_char = gs_put_char,
352 .flush_chars = gs_flush_chars,
353 .write_room = gs_write_room,
355 .set_termios = gs_set_termios,
356 .throttle = gs_throttle,
357 .unthrottle = gs_unthrottle,
358 .break_ctl = gs_break,
359 .chars_in_buffer = gs_chars_in_buffer,
361 static struct tty_driver *gs_tty_driver;
363 /* gadget driver struct */
364 static struct usb_gadget_driver gs_gadget_driver = {
365 #ifdef CONFIG_USB_GADGET_DUALSPEED
366 .speed = USB_SPEED_HIGH,
368 .speed = USB_SPEED_FULL,
369 #endif /* CONFIG_USB_GADGET_DUALSPEED */
370 .function = GS_LONG_NAME,
372 .unbind = __exit_p(gs_unbind),
374 .disconnect = gs_disconnect,
376 .name = GS_SHORT_NAME,
381 /* USB descriptors */
383 #define GS_MANUFACTURER_STR_ID 1
384 #define GS_PRODUCT_STR_ID 2
385 #define GS_SERIAL_STR_ID 3
386 #define GS_BULK_CONFIG_STR_ID 4
387 #define GS_ACM_CONFIG_STR_ID 5
388 #define GS_CONTROL_STR_ID 6
389 #define GS_DATA_STR_ID 7
391 /* static strings, in UTF-8 */
392 static char manufacturer[50];
393 static struct usb_string gs_strings[] = {
394 { GS_MANUFACTURER_STR_ID, manufacturer },
395 { GS_PRODUCT_STR_ID, GS_LONG_NAME },
396 { GS_SERIAL_STR_ID, "0" },
397 { GS_BULK_CONFIG_STR_ID, "Gadget Serial Bulk" },
398 { GS_ACM_CONFIG_STR_ID, "Gadget Serial CDC ACM" },
399 { GS_CONTROL_STR_ID, "Gadget Serial Control" },
400 { GS_DATA_STR_ID, "Gadget Serial Data" },
401 { } /* end of list */
404 static struct usb_gadget_strings gs_string_table = {
405 .language = 0x0409, /* en-us */
406 .strings = gs_strings,
409 static struct usb_device_descriptor gs_device_desc = {
410 .bLength = USB_DT_DEVICE_SIZE,
411 .bDescriptorType = USB_DT_DEVICE,
412 .bcdUSB = __constant_cpu_to_le16(0x0200),
413 .bDeviceSubClass = 0,
414 .bDeviceProtocol = 0,
415 .idVendor = __constant_cpu_to_le16(GS_VENDOR_ID),
416 .idProduct = __constant_cpu_to_le16(GS_PRODUCT_ID),
417 .iManufacturer = GS_MANUFACTURER_STR_ID,
418 .iProduct = GS_PRODUCT_STR_ID,
419 .iSerialNumber = GS_SERIAL_STR_ID,
420 .bNumConfigurations = GS_NUM_CONFIGS,
423 static struct usb_otg_descriptor gs_otg_descriptor = {
424 .bLength = sizeof(gs_otg_descriptor),
425 .bDescriptorType = USB_DT_OTG,
426 .bmAttributes = USB_OTG_SRP,
429 static struct usb_config_descriptor gs_bulk_config_desc = {
430 .bLength = USB_DT_CONFIG_SIZE,
431 .bDescriptorType = USB_DT_CONFIG,
432 /* .wTotalLength computed dynamically */
434 .bConfigurationValue = GS_BULK_CONFIG_ID,
435 .iConfiguration = GS_BULK_CONFIG_STR_ID,
436 .bmAttributes = USB_CONFIG_ATT_ONE | USB_CONFIG_ATT_SELFPOWER,
440 static struct usb_config_descriptor gs_acm_config_desc = {
441 .bLength = USB_DT_CONFIG_SIZE,
442 .bDescriptorType = USB_DT_CONFIG,
443 /* .wTotalLength computed dynamically */
445 .bConfigurationValue = GS_ACM_CONFIG_ID,
446 .iConfiguration = GS_ACM_CONFIG_STR_ID,
447 .bmAttributes = USB_CONFIG_ATT_ONE | USB_CONFIG_ATT_SELFPOWER,
451 static const struct usb_interface_descriptor gs_bulk_interface_desc = {
452 .bLength = USB_DT_INTERFACE_SIZE,
453 .bDescriptorType = USB_DT_INTERFACE,
454 .bInterfaceNumber = GS_BULK_INTERFACE_ID,
456 .bInterfaceClass = USB_CLASS_CDC_DATA,
457 .bInterfaceSubClass = 0,
458 .bInterfaceProtocol = 0,
459 .iInterface = GS_DATA_STR_ID,
462 static const struct usb_interface_descriptor gs_control_interface_desc = {
463 .bLength = USB_DT_INTERFACE_SIZE,
464 .bDescriptorType = USB_DT_INTERFACE,
465 .bInterfaceNumber = GS_CONTROL_INTERFACE_ID,
467 .bInterfaceClass = USB_CLASS_COMM,
468 .bInterfaceSubClass = USB_CDC_SUBCLASS_ACM,
469 .bInterfaceProtocol = USB_CDC_ACM_PROTO_AT_V25TER,
470 .iInterface = GS_CONTROL_STR_ID,
473 static const struct usb_interface_descriptor gs_data_interface_desc = {
474 .bLength = USB_DT_INTERFACE_SIZE,
475 .bDescriptorType = USB_DT_INTERFACE,
476 .bInterfaceNumber = GS_DATA_INTERFACE_ID,
478 .bInterfaceClass = USB_CLASS_CDC_DATA,
479 .bInterfaceSubClass = 0,
480 .bInterfaceProtocol = 0,
481 .iInterface = GS_DATA_STR_ID,
484 static const struct usb_cdc_header_desc gs_header_desc = {
485 .bLength = sizeof(gs_header_desc),
486 .bDescriptorType = USB_DT_CS_INTERFACE,
487 .bDescriptorSubType = USB_CDC_HEADER_TYPE,
488 .bcdCDC = __constant_cpu_to_le16(0x0110),
491 static const struct usb_cdc_call_mgmt_descriptor gs_call_mgmt_descriptor = {
492 .bLength = sizeof(gs_call_mgmt_descriptor),
493 .bDescriptorType = USB_DT_CS_INTERFACE,
494 .bDescriptorSubType = USB_CDC_CALL_MANAGEMENT_TYPE,
496 .bDataInterface = 1, /* index of data interface */
499 static struct usb_cdc_acm_descriptor gs_acm_descriptor = {
500 .bLength = sizeof(gs_acm_descriptor),
501 .bDescriptorType = USB_DT_CS_INTERFACE,
502 .bDescriptorSubType = USB_CDC_ACM_TYPE,
506 static const struct usb_cdc_union_desc gs_union_desc = {
507 .bLength = sizeof(gs_union_desc),
508 .bDescriptorType = USB_DT_CS_INTERFACE,
509 .bDescriptorSubType = USB_CDC_UNION_TYPE,
510 .bMasterInterface0 = 0, /* index of control interface */
511 .bSlaveInterface0 = 1, /* index of data interface */
514 static struct usb_endpoint_descriptor gs_fullspeed_notify_desc = {
515 .bLength = USB_DT_ENDPOINT_SIZE,
516 .bDescriptorType = USB_DT_ENDPOINT,
517 .bEndpointAddress = USB_DIR_IN,
518 .bmAttributes = USB_ENDPOINT_XFER_INT,
519 .wMaxPacketSize = __constant_cpu_to_le16(GS_NOTIFY_MAXPACKET),
520 .bInterval = 1 << GS_LOG2_NOTIFY_INTERVAL,
523 static struct usb_endpoint_descriptor gs_fullspeed_in_desc = {
524 .bLength = USB_DT_ENDPOINT_SIZE,
525 .bDescriptorType = USB_DT_ENDPOINT,
526 .bEndpointAddress = USB_DIR_IN,
527 .bmAttributes = USB_ENDPOINT_XFER_BULK,
530 static struct usb_endpoint_descriptor gs_fullspeed_out_desc = {
531 .bLength = USB_DT_ENDPOINT_SIZE,
532 .bDescriptorType = USB_DT_ENDPOINT,
533 .bEndpointAddress = USB_DIR_OUT,
534 .bmAttributes = USB_ENDPOINT_XFER_BULK,
537 static const struct usb_descriptor_header *gs_bulk_fullspeed_function[] = {
538 (struct usb_descriptor_header *) &gs_otg_descriptor,
539 (struct usb_descriptor_header *) &gs_bulk_interface_desc,
540 (struct usb_descriptor_header *) &gs_fullspeed_in_desc,
541 (struct usb_descriptor_header *) &gs_fullspeed_out_desc,
545 static const struct usb_descriptor_header *gs_acm_fullspeed_function[] = {
546 (struct usb_descriptor_header *) &gs_otg_descriptor,
547 (struct usb_descriptor_header *) &gs_control_interface_desc,
548 (struct usb_descriptor_header *) &gs_header_desc,
549 (struct usb_descriptor_header *) &gs_call_mgmt_descriptor,
550 (struct usb_descriptor_header *) &gs_acm_descriptor,
551 (struct usb_descriptor_header *) &gs_union_desc,
552 (struct usb_descriptor_header *) &gs_fullspeed_notify_desc,
553 (struct usb_descriptor_header *) &gs_data_interface_desc,
554 (struct usb_descriptor_header *) &gs_fullspeed_in_desc,
555 (struct usb_descriptor_header *) &gs_fullspeed_out_desc,
559 #ifdef CONFIG_USB_GADGET_DUALSPEED
560 static struct usb_endpoint_descriptor gs_highspeed_notify_desc = {
561 .bLength = USB_DT_ENDPOINT_SIZE,
562 .bDescriptorType = USB_DT_ENDPOINT,
563 .bEndpointAddress = USB_DIR_IN,
564 .bmAttributes = USB_ENDPOINT_XFER_INT,
565 .wMaxPacketSize = __constant_cpu_to_le16(GS_NOTIFY_MAXPACKET),
566 .bInterval = GS_LOG2_NOTIFY_INTERVAL+4,
569 static struct usb_endpoint_descriptor gs_highspeed_in_desc = {
570 .bLength = USB_DT_ENDPOINT_SIZE,
571 .bDescriptorType = USB_DT_ENDPOINT,
572 .bmAttributes = USB_ENDPOINT_XFER_BULK,
573 .wMaxPacketSize = __constant_cpu_to_le16(512),
576 static struct usb_endpoint_descriptor gs_highspeed_out_desc = {
577 .bLength = USB_DT_ENDPOINT_SIZE,
578 .bDescriptorType = USB_DT_ENDPOINT,
579 .bmAttributes = USB_ENDPOINT_XFER_BULK,
580 .wMaxPacketSize = __constant_cpu_to_le16(512),
583 static struct usb_qualifier_descriptor gs_qualifier_desc = {
584 .bLength = sizeof(struct usb_qualifier_descriptor),
585 .bDescriptorType = USB_DT_DEVICE_QUALIFIER,
586 .bcdUSB = __constant_cpu_to_le16 (0x0200),
587 /* assumes ep0 uses the same value for both speeds ... */
588 .bNumConfigurations = GS_NUM_CONFIGS,
591 static const struct usb_descriptor_header *gs_bulk_highspeed_function[] = {
592 (struct usb_descriptor_header *) &gs_otg_descriptor,
593 (struct usb_descriptor_header *) &gs_bulk_interface_desc,
594 (struct usb_descriptor_header *) &gs_highspeed_in_desc,
595 (struct usb_descriptor_header *) &gs_highspeed_out_desc,
599 static const struct usb_descriptor_header *gs_acm_highspeed_function[] = {
600 (struct usb_descriptor_header *) &gs_otg_descriptor,
601 (struct usb_descriptor_header *) &gs_control_interface_desc,
602 (struct usb_descriptor_header *) &gs_header_desc,
603 (struct usb_descriptor_header *) &gs_call_mgmt_descriptor,
604 (struct usb_descriptor_header *) &gs_acm_descriptor,
605 (struct usb_descriptor_header *) &gs_union_desc,
606 (struct usb_descriptor_header *) &gs_highspeed_notify_desc,
607 (struct usb_descriptor_header *) &gs_data_interface_desc,
608 (struct usb_descriptor_header *) &gs_highspeed_in_desc,
609 (struct usb_descriptor_header *) &gs_highspeed_out_desc,
613 #endif /* CONFIG_USB_GADGET_DUALSPEED */
617 MODULE_DESCRIPTION(GS_LONG_NAME);
618 MODULE_AUTHOR("Al Borchers");
619 MODULE_LICENSE("GPL");
622 module_param(debug, int, S_IRUGO|S_IWUSR);
623 MODULE_PARM_DESC(debug, "Enable debugging, 0=off, 1=on");
626 module_param(read_q_size, uint, S_IRUGO);
627 MODULE_PARM_DESC(read_q_size, "Read request queue size, default=32");
629 module_param(write_q_size, uint, S_IRUGO);
630 MODULE_PARM_DESC(write_q_size, "Write request queue size, default=32");
632 module_param(write_buf_size, uint, S_IRUGO);
633 MODULE_PARM_DESC(write_buf_size, "Write buffer size, default=8192");
635 module_param(use_acm, uint, S_IRUGO);
636 MODULE_PARM_DESC(use_acm, "Use CDC ACM, 0=no, 1=yes, default=no");
638 module_init(gs_module_init);
639 module_exit(gs_module_exit);
644 * Register as a USB gadget driver and a tty driver.
646 static int __init gs_module_init(void)
651 retval = usb_gadget_register_driver(&gs_gadget_driver);
653 printk(KERN_ERR "gs_module_init: cannot register gadget driver, ret=%d\n", retval);
657 gs_tty_driver = alloc_tty_driver(GS_NUM_PORTS);
660 gs_tty_driver->owner = THIS_MODULE;
661 gs_tty_driver->driver_name = GS_SHORT_NAME;
662 gs_tty_driver->name = "ttygs";
663 gs_tty_driver->devfs_name = "usb/ttygs/";
664 gs_tty_driver->major = GS_MAJOR;
665 gs_tty_driver->minor_start = GS_MINOR_START;
666 gs_tty_driver->type = TTY_DRIVER_TYPE_SERIAL;
667 gs_tty_driver->subtype = SERIAL_TYPE_NORMAL;
668 gs_tty_driver->flags = TTY_DRIVER_REAL_RAW | TTY_DRIVER_NO_DEVFS;
669 gs_tty_driver->init_termios = tty_std_termios;
670 gs_tty_driver->init_termios.c_cflag = B9600 | CS8 | CREAD | HUPCL | CLOCAL;
671 tty_set_operations(gs_tty_driver, &gs_tty_ops);
673 for (i=0; i < GS_NUM_PORTS; i++)
674 sema_init(&gs_open_close_sem[i], 1);
676 retval = tty_register_driver(gs_tty_driver);
678 usb_gadget_unregister_driver(&gs_gadget_driver);
679 put_tty_driver(gs_tty_driver);
680 printk(KERN_ERR "gs_module_init: cannot register tty driver, ret=%d\n", retval);
684 printk(KERN_INFO "gs_module_init: %s %s loaded\n", GS_LONG_NAME, GS_VERSION_STR);
691 * Unregister as a tty driver and a USB gadget driver.
693 static void __exit gs_module_exit(void)
695 tty_unregister_driver(gs_tty_driver);
696 put_tty_driver(gs_tty_driver);
697 usb_gadget_unregister_driver(&gs_gadget_driver);
699 printk(KERN_INFO "gs_module_exit: %s %s unloaded\n", GS_LONG_NAME, GS_VERSION_STR);
707 static int gs_open(struct tty_struct *tty, struct file *file)
711 struct gs_port *port;
714 struct semaphore *sem;
717 port_num = tty->index;
719 gs_debug("gs_open: (%d,%p,%p)\n", port_num, tty, file);
721 if (port_num < 0 || port_num >= GS_NUM_PORTS) {
722 printk(KERN_ERR "gs_open: (%d,%p,%p) invalid port number\n",
723 port_num, tty, file);
730 printk(KERN_ERR "gs_open: (%d,%p,%p) NULL device pointer\n",
731 port_num, tty, file);
735 sem = &gs_open_close_sem[port_num];
736 if (down_interruptible(sem)) {
738 "gs_open: (%d,%p,%p) interrupted waiting for semaphore\n",
739 port_num, tty, file);
743 spin_lock_irqsave(&dev->dev_lock, flags);
745 if (dev->dev_config == GS_NO_CONFIG_ID) {
747 "gs_open: (%d,%p,%p) device is not connected\n",
748 port_num, tty, file);
750 goto exit_unlock_dev;
753 port = dev->dev_port[port_num];
756 printk(KERN_ERR "gs_open: (%d,%p,%p) NULL port pointer\n",
757 port_num, tty, file);
759 goto exit_unlock_dev;
762 spin_lock(&port->port_lock);
763 spin_unlock(&dev->dev_lock);
765 if (port->port_dev == NULL) {
766 printk(KERN_ERR "gs_open: (%d,%p,%p) port disconnected (1)\n",
767 port_num, tty, file);
769 goto exit_unlock_port;
772 if (port->port_open_count > 0) {
773 ++port->port_open_count;
774 gs_debug("gs_open: (%d,%p,%p) already open\n",
775 port_num, tty, file);
777 goto exit_unlock_port;
780 tty->driver_data = NULL;
782 /* mark port as in use, we can drop port lock and sleep if necessary */
783 port->port_in_use = 1;
785 /* allocate write buffer on first open */
786 if (port->port_write_buf == NULL) {
787 spin_unlock_irqrestore(&port->port_lock, flags);
788 buf = gs_buf_alloc(write_buf_size, GFP_KERNEL);
789 spin_lock_irqsave(&port->port_lock, flags);
791 /* might have been disconnected while asleep, check */
792 if (port->port_dev == NULL) {
794 "gs_open: (%d,%p,%p) port disconnected (2)\n",
795 port_num, tty, file);
796 port->port_in_use = 0;
798 goto exit_unlock_port;
801 if ((port->port_write_buf=buf) == NULL) {
802 printk(KERN_ERR "gs_open: (%d,%p,%p) cannot allocate port write buffer\n",
803 port_num, tty, file);
804 port->port_in_use = 0;
806 goto exit_unlock_port;
811 /* wait for carrier detect (not implemented) */
813 /* might have been disconnected while asleep, check */
814 if (port->port_dev == NULL) {
815 printk(KERN_ERR "gs_open: (%d,%p,%p) port disconnected (3)\n",
816 port_num, tty, file);
817 port->port_in_use = 0;
819 goto exit_unlock_port;
822 tty->driver_data = port;
823 port->port_tty = tty;
824 port->port_open_count = 1;
825 port->port_in_use = 0;
827 gs_debug("gs_open: (%d,%p,%p) completed\n", port_num, tty, file);
832 spin_unlock_irqrestore(&port->port_lock, flags);
837 spin_unlock_irqrestore(&dev->dev_lock, flags);
846 static void gs_close(struct tty_struct *tty, struct file *file)
849 struct gs_port *port = tty->driver_data;
850 struct semaphore *sem;
853 printk(KERN_ERR "gs_close: NULL port pointer\n");
857 gs_debug("gs_close: (%d,%p,%p)\n", port->port_num, tty, file);
859 sem = &gs_open_close_sem[port->port_num];
862 spin_lock_irqsave(&port->port_lock, flags);
864 if (port->port_open_count == 0) {
866 "gs_close: (%d,%p,%p) port is already closed\n",
867 port->port_num, tty, file);
871 if (port->port_open_count > 1) {
872 --port->port_open_count;
876 /* free disconnected port on final close */
877 if (port->port_dev == NULL) {
882 /* mark port as closed but in use, we can drop port lock */
883 /* and sleep if necessary */
884 port->port_in_use = 1;
885 port->port_open_count = 0;
887 /* wait for write buffer to drain, or */
888 /* at most GS_CLOSE_TIMEOUT seconds */
889 if (gs_buf_data_avail(port->port_write_buf) > 0) {
890 spin_unlock_irqrestore(&port->port_lock, flags);
891 wait_cond_interruptible_timeout(port->port_write_wait,
892 port->port_dev == NULL
893 || gs_buf_data_avail(port->port_write_buf) == 0,
894 &port->port_lock, flags, GS_CLOSE_TIMEOUT * HZ);
895 spin_lock_irqsave(&port->port_lock, flags);
898 /* free disconnected port on final close */
899 /* (might have happened during the above sleep) */
900 if (port->port_dev == NULL) {
905 gs_buf_clear(port->port_write_buf);
907 tty->driver_data = NULL;
908 port->port_tty = NULL;
909 port->port_in_use = 0;
911 gs_debug("gs_close: (%d,%p,%p) completed\n",
912 port->port_num, tty, file);
915 spin_unlock_irqrestore(&port->port_lock, flags);
922 static int gs_write(struct tty_struct *tty, const unsigned char *buf, int count)
925 struct gs_port *port = tty->driver_data;
929 printk(KERN_ERR "gs_write: NULL port pointer\n");
933 gs_debug("gs_write: (%d,%p) writing %d bytes\n", port->port_num, tty,
939 spin_lock_irqsave(&port->port_lock, flags);
941 if (port->port_dev == NULL) {
942 printk(KERN_ERR "gs_write: (%d,%p) port is not connected\n",
943 port->port_num, tty);
948 if (port->port_open_count == 0) {
949 printk(KERN_ERR "gs_write: (%d,%p) port is closed\n",
950 port->port_num, tty);
955 count = gs_buf_put(port->port_write_buf, buf, count);
957 spin_unlock_irqrestore(&port->port_lock, flags);
961 gs_debug("gs_write: (%d,%p) wrote %d bytes\n", port->port_num, tty,
967 spin_unlock_irqrestore(&port->port_lock, flags);
974 static void gs_put_char(struct tty_struct *tty, unsigned char ch)
977 struct gs_port *port = tty->driver_data;
980 printk(KERN_ERR "gs_put_char: NULL port pointer\n");
984 gs_debug("gs_put_char: (%d,%p) char=0x%x, called from %p, %p, %p\n", port->port_num, tty, ch, __builtin_return_address(0), __builtin_return_address(1), __builtin_return_address(2));
986 spin_lock_irqsave(&port->port_lock, flags);
988 if (port->port_dev == NULL) {
989 printk(KERN_ERR "gs_put_char: (%d,%p) port is not connected\n",
990 port->port_num, tty);
994 if (port->port_open_count == 0) {
995 printk(KERN_ERR "gs_put_char: (%d,%p) port is closed\n",
996 port->port_num, tty);
1000 gs_buf_put(port->port_write_buf, &ch, 1);
1003 spin_unlock_irqrestore(&port->port_lock, flags);
1009 static void gs_flush_chars(struct tty_struct *tty)
1011 unsigned long flags;
1012 struct gs_port *port = tty->driver_data;
1015 printk(KERN_ERR "gs_flush_chars: NULL port pointer\n");
1019 gs_debug("gs_flush_chars: (%d,%p)\n", port->port_num, tty);
1021 spin_lock_irqsave(&port->port_lock, flags);
1023 if (port->port_dev == NULL) {
1025 "gs_flush_chars: (%d,%p) port is not connected\n",
1026 port->port_num, tty);
1030 if (port->port_open_count == 0) {
1031 printk(KERN_ERR "gs_flush_chars: (%d,%p) port is closed\n",
1032 port->port_num, tty);
1036 spin_unlock_irqrestore(&port->port_lock, flags);
1043 spin_unlock_irqrestore(&port->port_lock, flags);
1049 static int gs_write_room(struct tty_struct *tty)
1053 unsigned long flags;
1054 struct gs_port *port = tty->driver_data;
1060 spin_lock_irqsave(&port->port_lock, flags);
1062 if (port->port_dev != NULL && port->port_open_count > 0
1063 && port->port_write_buf != NULL)
1064 room = gs_buf_space_avail(port->port_write_buf);
1066 spin_unlock_irqrestore(&port->port_lock, flags);
1068 gs_debug("gs_write_room: (%d,%p) room=%d\n",
1069 port->port_num, tty, room);
1075 * gs_chars_in_buffer
1077 static int gs_chars_in_buffer(struct tty_struct *tty)
1080 unsigned long flags;
1081 struct gs_port *port = tty->driver_data;
1086 spin_lock_irqsave(&port->port_lock, flags);
1088 if (port->port_dev != NULL && port->port_open_count > 0
1089 && port->port_write_buf != NULL)
1090 chars = gs_buf_data_avail(port->port_write_buf);
1092 spin_unlock_irqrestore(&port->port_lock, flags);
1094 gs_debug("gs_chars_in_buffer: (%d,%p) chars=%d\n",
1095 port->port_num, tty, chars);
1103 static void gs_throttle(struct tty_struct *tty)
1110 static void gs_unthrottle(struct tty_struct *tty)
1117 static void gs_break(struct tty_struct *tty, int break_state)
1124 static int gs_ioctl(struct tty_struct *tty, struct file *file, unsigned int cmd, unsigned long arg)
1126 struct gs_port *port = tty->driver_data;
1129 printk(KERN_ERR "gs_ioctl: NULL port pointer\n");
1133 gs_debug("gs_ioctl: (%d,%p,%p) cmd=0x%4.4x, arg=%lu\n",
1134 port->port_num, tty, file, cmd, arg);
1138 /* could not handle ioctl */
1139 return -ENOIOCTLCMD;
1145 static void gs_set_termios(struct tty_struct *tty, struct termios *old)
1152 * This function finds available write requests, calls
1153 * gs_send_packet to fill these packets with data, and
1154 * continues until either there are no more write requests
1155 * available or no more data to send. This function is
1156 * run whenever data arrives or write requests are available.
1158 static int gs_send(struct gs_dev *dev)
1161 unsigned long flags;
1163 struct usb_request *req;
1164 struct gs_req_entry *req_entry;
1167 printk(KERN_ERR "gs_send: NULL device pointer\n");
1171 spin_lock_irqsave(&dev->dev_lock, flags);
1173 ep = dev->dev_in_ep;
1175 while(!list_empty(&dev->dev_req_list)) {
1177 req_entry = list_entry(dev->dev_req_list.next,
1178 struct gs_req_entry, re_entry);
1180 req = req_entry->re_req;
1182 len = gs_send_packet(dev, req->buf, ep->maxpacket);
1185 gs_debug_level(3, "gs_send: len=%d, 0x%2.2x 0x%2.2x 0x%2.2x ...\n", len, *((unsigned char *)req->buf), *((unsigned char *)req->buf+1), *((unsigned char *)req->buf+2));
1186 list_del(&req_entry->re_entry);
1188 if ((ret=usb_ep_queue(ep, req, GFP_ATOMIC))) {
1190 "gs_send: cannot queue read request, ret=%d\n",
1200 spin_unlock_irqrestore(&dev->dev_lock, flags);
1208 * If there is data to send, a packet is built in the given
1209 * buffer and the size is returned. If there is no data to
1210 * send, 0 is returned. If there is any error a negative
1211 * error number is returned.
1213 * Called during USB completion routine, on interrupt time.
1215 * We assume that disconnect will not happen until all completion
1216 * routines have completed, so we can assume that the dev_port
1217 * array does not change during the lifetime of this function.
1219 static int gs_send_packet(struct gs_dev *dev, char *packet, unsigned int size)
1222 struct gs_port *port;
1224 /* TEMPORARY -- only port 0 is supported right now */
1225 port = dev->dev_port[0];
1229 "gs_send_packet: port=%d, NULL port pointer\n",
1234 spin_lock(&port->port_lock);
1236 len = gs_buf_data_avail(port->port_write_buf);
1243 size = gs_buf_get(port->port_write_buf, packet, size);
1246 wake_up_interruptible(&port->port_tty->write_wait);
1249 spin_unlock(&port->port_lock);
1256 * Called for each USB packet received. Reads the packet
1257 * header and stuffs the data in the appropriate tty buffer.
1258 * Returns 0 if successful, or a negative error number.
1260 * Called during USB completion routine, on interrupt time.
1262 * We assume that disconnect will not happen until all completion
1263 * routines have completed, so we can assume that the dev_port
1264 * array does not change during the lifetime of this function.
1266 static int gs_recv_packet(struct gs_dev *dev, char *packet, unsigned int size)
1269 struct gs_port *port;
1271 struct tty_struct *tty;
1273 /* TEMPORARY -- only port 0 is supported right now */
1274 port = dev->dev_port[0];
1277 printk(KERN_ERR "gs_recv_packet: port=%d, NULL port pointer\n",
1282 spin_lock(&port->port_lock);
1284 if (port->port_open_count == 0) {
1285 printk(KERN_ERR "gs_recv_packet: port=%d, port is closed\n",
1292 tty = port->port_tty;
1295 printk(KERN_ERR "gs_recv_packet: port=%d, NULL tty pointer\n",
1301 if (port->port_tty->magic != TTY_MAGIC) {
1302 printk(KERN_ERR "gs_recv_packet: port=%d, bad tty magic\n",
1308 len = tty_buffer_request_room(tty, size);
1310 tty_insert_flip_string(tty, packet, len);
1311 tty_flip_buffer_push(port->port_tty);
1312 wake_up_interruptible(&port->port_tty->read_wait);
1316 spin_unlock(&port->port_lock);
1323 static void gs_read_complete(struct usb_ep *ep, struct usb_request *req)
1326 struct gs_dev *dev = ep->driver_data;
1329 printk(KERN_ERR "gs_read_complete: NULL device pointer\n");
1333 switch(req->status) {
1335 /* normal completion */
1336 gs_recv_packet(dev, req->buf, req->actual);
1338 req->length = ep->maxpacket;
1339 if ((ret=usb_ep_queue(ep, req, GFP_ATOMIC))) {
1341 "gs_read_complete: cannot queue read request, ret=%d\n",
1348 gs_debug("gs_read_complete: shutdown\n");
1349 gs_free_req(ep, req);
1355 "gs_read_complete: unexpected status error, status=%d\n",
1365 static void gs_write_complete(struct usb_ep *ep, struct usb_request *req)
1367 struct gs_dev *dev = ep->driver_data;
1368 struct gs_req_entry *gs_req = req->context;
1371 printk(KERN_ERR "gs_write_complete: NULL device pointer\n");
1375 switch(req->status) {
1377 /* normal completion */
1379 if (gs_req == NULL) {
1381 "gs_write_complete: NULL request pointer\n");
1385 spin_lock(&dev->dev_lock);
1386 list_add(&gs_req->re_entry, &dev->dev_req_list);
1387 spin_unlock(&dev->dev_lock);
1395 gs_debug("gs_write_complete: shutdown\n");
1396 gs_free_req(ep, req);
1401 "gs_write_complete: unexpected status error, status=%d\n",
1413 * Called on module load. Allocates and initializes the device
1414 * structure and a control request.
1416 static int __init gs_bind(struct usb_gadget *gadget)
1423 /* Some controllers can't support CDC ACM:
1424 * - sh doesn't support multiple interfaces or configs;
1425 * - sa1100 doesn't have a third interrupt endpoint
1427 if (gadget_is_sh(gadget) || gadget_is_sa1100(gadget))
1430 gcnum = usb_gadget_controller_number(gadget);
1432 gs_device_desc.bcdDevice =
1433 cpu_to_le16(GS_VERSION_NUM | gcnum);
1435 printk(KERN_WARNING "gs_bind: controller '%s' not recognized\n",
1437 /* unrecognized, but safe unless bulk is REALLY quirky */
1438 gs_device_desc.bcdDevice =
1439 __constant_cpu_to_le16(GS_VERSION_NUM|0x0099);
1442 usb_ep_autoconfig_reset(gadget);
1444 ep = usb_ep_autoconfig(gadget, &gs_fullspeed_in_desc);
1447 EP_IN_NAME = ep->name;
1448 ep->driver_data = ep; /* claim the endpoint */
1450 ep = usb_ep_autoconfig(gadget, &gs_fullspeed_out_desc);
1453 EP_OUT_NAME = ep->name;
1454 ep->driver_data = ep; /* claim the endpoint */
1457 ep = usb_ep_autoconfig(gadget, &gs_fullspeed_notify_desc);
1459 printk(KERN_ERR "gs_bind: cannot run ACM on %s\n", gadget->name);
1462 gs_device_desc.idProduct = __constant_cpu_to_le16(
1464 EP_NOTIFY_NAME = ep->name;
1465 ep->driver_data = ep; /* claim the endpoint */
1468 gs_device_desc.bDeviceClass = use_acm
1469 ? USB_CLASS_COMM : USB_CLASS_VENDOR_SPEC;
1470 gs_device_desc.bMaxPacketSize0 = gadget->ep0->maxpacket;
1472 #ifdef CONFIG_USB_GADGET_DUALSPEED
1473 gs_qualifier_desc.bDeviceClass = use_acm
1474 ? USB_CLASS_COMM : USB_CLASS_VENDOR_SPEC;
1475 /* assume ep0 uses the same packet size for both speeds */
1476 gs_qualifier_desc.bMaxPacketSize0 = gs_device_desc.bMaxPacketSize0;
1477 /* assume endpoints are dual-speed */
1478 gs_highspeed_notify_desc.bEndpointAddress =
1479 gs_fullspeed_notify_desc.bEndpointAddress;
1480 gs_highspeed_in_desc.bEndpointAddress =
1481 gs_fullspeed_in_desc.bEndpointAddress;
1482 gs_highspeed_out_desc.bEndpointAddress =
1483 gs_fullspeed_out_desc.bEndpointAddress;
1484 #endif /* CONFIG_USB_GADGET_DUALSPEED */
1486 usb_gadget_set_selfpowered(gadget);
1488 if (gadget->is_otg) {
1489 gs_otg_descriptor.bmAttributes |= USB_OTG_HNP,
1490 gs_bulk_config_desc.bmAttributes |= USB_CONFIG_ATT_WAKEUP;
1491 gs_acm_config_desc.bmAttributes |= USB_CONFIG_ATT_WAKEUP;
1494 gs_device = dev = kmalloc(sizeof(struct gs_dev), GFP_KERNEL);
1498 snprintf(manufacturer, sizeof(manufacturer), "%s %s with %s",
1499 system_utsname.sysname, system_utsname.release,
1502 memset(dev, 0, sizeof(struct gs_dev));
1503 dev->dev_gadget = gadget;
1504 spin_lock_init(&dev->dev_lock);
1505 INIT_LIST_HEAD(&dev->dev_req_list);
1506 set_gadget_data(gadget, dev);
1508 if ((ret=gs_alloc_ports(dev, GFP_KERNEL)) != 0) {
1509 printk(KERN_ERR "gs_bind: cannot allocate ports\n");
1514 /* preallocate control response and buffer */
1515 dev->dev_ctrl_req = gs_alloc_req(gadget->ep0, GS_MAX_DESC_LEN,
1517 if (dev->dev_ctrl_req == NULL) {
1521 dev->dev_ctrl_req->complete = gs_setup_complete;
1523 gadget->ep0->driver_data = dev;
1525 printk(KERN_INFO "gs_bind: %s %s bound\n",
1526 GS_LONG_NAME, GS_VERSION_STR);
1531 printk(KERN_ERR "gs_bind: cannot autoconfigure on %s\n", gadget->name);
1538 * Called on module unload. Frees the control request and device
1541 static void __exit gs_unbind(struct usb_gadget *gadget)
1543 struct gs_dev *dev = get_gadget_data(gadget);
1547 /* read/write requests already freed, only control request remains */
1549 if (dev->dev_ctrl_req != NULL) {
1550 gs_free_req(gadget->ep0, dev->dev_ctrl_req);
1551 dev->dev_ctrl_req = NULL;
1555 set_gadget_data(gadget, NULL);
1558 printk(KERN_INFO "gs_unbind: %s %s unbound\n", GS_LONG_NAME,
1565 * Implements all the control endpoint functionality that's not
1566 * handled in hardware or the hardware driver.
1568 * Returns the size of the data sent to the host, or a negative
1571 static int gs_setup(struct usb_gadget *gadget,
1572 const struct usb_ctrlrequest *ctrl)
1574 int ret = -EOPNOTSUPP;
1575 struct gs_dev *dev = get_gadget_data(gadget);
1576 struct usb_request *req = dev->dev_ctrl_req;
1577 u16 wIndex = le16_to_cpu(ctrl->wIndex);
1578 u16 wValue = le16_to_cpu(ctrl->wValue);
1579 u16 wLength = le16_to_cpu(ctrl->wLength);
1581 switch (ctrl->bRequestType & USB_TYPE_MASK) {
1582 case USB_TYPE_STANDARD:
1583 ret = gs_setup_standard(gadget,ctrl);
1586 case USB_TYPE_CLASS:
1587 ret = gs_setup_class(gadget,ctrl);
1591 printk(KERN_ERR "gs_setup: unknown request, type=%02x, request=%02x, value=%04x, index=%04x, length=%d\n",
1592 ctrl->bRequestType, ctrl->bRequest,
1593 wValue, wIndex, wLength);
1597 /* respond with data transfer before status phase? */
1600 req->zero = ret < wLength
1601 && (ret % gadget->ep0->maxpacket) == 0;
1602 ret = usb_ep_queue(gadget->ep0, req, GFP_ATOMIC);
1604 printk(KERN_ERR "gs_setup: cannot queue response, ret=%d\n",
1607 gs_setup_complete(gadget->ep0, req);
1611 /* device either stalls (ret < 0) or reports success */
1615 static int gs_setup_standard(struct usb_gadget *gadget,
1616 const struct usb_ctrlrequest *ctrl)
1618 int ret = -EOPNOTSUPP;
1619 struct gs_dev *dev = get_gadget_data(gadget);
1620 struct usb_request *req = dev->dev_ctrl_req;
1621 u16 wIndex = le16_to_cpu(ctrl->wIndex);
1622 u16 wValue = le16_to_cpu(ctrl->wValue);
1623 u16 wLength = le16_to_cpu(ctrl->wLength);
1625 switch (ctrl->bRequest) {
1626 case USB_REQ_GET_DESCRIPTOR:
1627 if (ctrl->bRequestType != USB_DIR_IN)
1630 switch (wValue >> 8) {
1633 (u16)sizeof(struct usb_device_descriptor));
1634 memcpy(req->buf, &gs_device_desc, ret);
1637 #ifdef CONFIG_USB_GADGET_DUALSPEED
1638 case USB_DT_DEVICE_QUALIFIER:
1639 if (!gadget->is_dualspeed)
1642 (u16)sizeof(struct usb_qualifier_descriptor));
1643 memcpy(req->buf, &gs_qualifier_desc, ret);
1646 case USB_DT_OTHER_SPEED_CONFIG:
1647 if (!gadget->is_dualspeed)
1650 #endif /* CONFIG_USB_GADGET_DUALSPEED */
1652 ret = gs_build_config_buf(req->buf, gadget->speed,
1653 wValue >> 8, wValue & 0xff,
1656 ret = min(wLength, (u16)ret);
1660 /* wIndex == language code. */
1661 ret = usb_gadget_get_string(&gs_string_table,
1662 wValue & 0xff, req->buf);
1664 ret = min(wLength, (u16)ret);
1669 case USB_REQ_SET_CONFIGURATION:
1670 if (ctrl->bRequestType != 0)
1672 spin_lock(&dev->dev_lock);
1673 ret = gs_set_config(dev, wValue);
1674 spin_unlock(&dev->dev_lock);
1677 case USB_REQ_GET_CONFIGURATION:
1678 if (ctrl->bRequestType != USB_DIR_IN)
1680 *(u8 *)req->buf = dev->dev_config;
1681 ret = min(wLength, (u16)1);
1684 case USB_REQ_SET_INTERFACE:
1685 if (ctrl->bRequestType != USB_RECIP_INTERFACE
1687 || wIndex >= GS_MAX_NUM_INTERFACES)
1689 if (dev->dev_config == GS_BULK_CONFIG_ID
1690 && wIndex != GS_BULK_INTERFACE_ID)
1692 /* no alternate interface settings */
1695 spin_lock(&dev->dev_lock);
1696 /* PXA hardware partially handles SET_INTERFACE;
1697 * we need to kluge around that interference. */
1698 if (gadget_is_pxa(gadget)) {
1699 ret = gs_set_config(dev, use_acm ?
1700 GS_ACM_CONFIG_ID : GS_BULK_CONFIG_ID);
1701 goto set_interface_done;
1703 if (dev->dev_config != GS_BULK_CONFIG_ID
1704 && wIndex == GS_CONTROL_INTERFACE_ID) {
1705 if (dev->dev_notify_ep) {
1706 usb_ep_disable(dev->dev_notify_ep);
1707 usb_ep_enable(dev->dev_notify_ep, dev->dev_notify_ep_desc);
1710 usb_ep_disable(dev->dev_in_ep);
1711 usb_ep_disable(dev->dev_out_ep);
1712 usb_ep_enable(dev->dev_in_ep, dev->dev_in_ep_desc);
1713 usb_ep_enable(dev->dev_out_ep, dev->dev_out_ep_desc);
1717 spin_unlock(&dev->dev_lock);
1720 case USB_REQ_GET_INTERFACE:
1721 if (ctrl->bRequestType != (USB_DIR_IN|USB_RECIP_INTERFACE)
1722 || dev->dev_config == GS_NO_CONFIG_ID)
1724 if (wIndex >= GS_MAX_NUM_INTERFACES
1725 || (dev->dev_config == GS_BULK_CONFIG_ID
1726 && wIndex != GS_BULK_INTERFACE_ID)) {
1730 /* no alternate interface settings */
1731 *(u8 *)req->buf = 0;
1732 ret = min(wLength, (u16)1);
1736 printk(KERN_ERR "gs_setup: unknown standard request, type=%02x, request=%02x, value=%04x, index=%04x, length=%d\n",
1737 ctrl->bRequestType, ctrl->bRequest,
1738 wValue, wIndex, wLength);
1745 static int gs_setup_class(struct usb_gadget *gadget,
1746 const struct usb_ctrlrequest *ctrl)
1748 int ret = -EOPNOTSUPP;
1749 struct gs_dev *dev = get_gadget_data(gadget);
1750 struct gs_port *port = dev->dev_port[0]; /* ACM only has one port */
1751 struct usb_request *req = dev->dev_ctrl_req;
1752 u16 wIndex = le16_to_cpu(ctrl->wIndex);
1753 u16 wValue = le16_to_cpu(ctrl->wValue);
1754 u16 wLength = le16_to_cpu(ctrl->wLength);
1756 switch (ctrl->bRequest) {
1757 case USB_CDC_REQ_SET_LINE_CODING:
1759 (u16)sizeof(struct usb_cdc_line_coding));
1761 spin_lock(&port->port_lock);
1762 memcpy(&port->port_line_coding, req->buf, ret);
1763 spin_unlock(&port->port_lock);
1767 case USB_CDC_REQ_GET_LINE_CODING:
1768 port = dev->dev_port[0]; /* ACM only has one port */
1770 (u16)sizeof(struct usb_cdc_line_coding));
1772 spin_lock(&port->port_lock);
1773 memcpy(req->buf, &port->port_line_coding, ret);
1774 spin_unlock(&port->port_lock);
1778 case USB_CDC_REQ_SET_CONTROL_LINE_STATE:
1783 printk(KERN_ERR "gs_setup: unknown class request, type=%02x, request=%02x, value=%04x, index=%04x, length=%d\n",
1784 ctrl->bRequestType, ctrl->bRequest,
1785 wValue, wIndex, wLength);
1795 static void gs_setup_complete(struct usb_ep *ep, struct usb_request *req)
1797 if (req->status || req->actual != req->length) {
1798 printk(KERN_ERR "gs_setup_complete: status error, status=%d, actual=%d, length=%d\n",
1799 req->status, req->actual, req->length);
1806 * Called when the device is disconnected. Frees the closed
1807 * ports and disconnects open ports. Open ports will be freed
1808 * on close. Then reallocates the ports for the next connection.
1810 static void gs_disconnect(struct usb_gadget *gadget)
1812 unsigned long flags;
1813 struct gs_dev *dev = get_gadget_data(gadget);
1815 spin_lock_irqsave(&dev->dev_lock, flags);
1817 gs_reset_config(dev);
1819 /* free closed ports and disconnect open ports */
1820 /* (open ports will be freed when closed) */
1823 /* re-allocate ports for the next connection */
1824 if (gs_alloc_ports(dev, GFP_ATOMIC) != 0)
1825 printk(KERN_ERR "gs_disconnect: cannot re-allocate ports\n");
1827 spin_unlock_irqrestore(&dev->dev_lock, flags);
1829 printk(KERN_INFO "gs_disconnect: %s disconnected\n", GS_LONG_NAME);
1835 * Configures the device by enabling device specific
1836 * optimizations, setting up the endpoints, allocating
1837 * read and write requests and queuing read requests.
1839 * The device lock must be held when calling this function.
1841 static int gs_set_config(struct gs_dev *dev, unsigned config)
1845 struct usb_gadget *gadget = dev->dev_gadget;
1847 struct usb_endpoint_descriptor *ep_desc;
1848 struct usb_request *req;
1849 struct gs_req_entry *req_entry;
1852 printk(KERN_ERR "gs_set_config: NULL device pointer\n");
1856 if (config == dev->dev_config)
1859 gs_reset_config(dev);
1862 case GS_NO_CONFIG_ID:
1864 case GS_BULK_CONFIG_ID:
1867 /* device specific optimizations */
1868 if (gadget_is_net2280(gadget))
1869 net2280_set_fifo_mode(gadget, 1);
1871 case GS_ACM_CONFIG_ID:
1874 /* device specific optimizations */
1875 if (gadget_is_net2280(gadget))
1876 net2280_set_fifo_mode(gadget, 1);
1882 dev->dev_config = config;
1884 gadget_for_each_ep(ep, gadget) {
1887 && strcmp(ep->name, EP_NOTIFY_NAME) == 0) {
1888 ep_desc = GS_SPEED_SELECT(
1889 gadget->speed == USB_SPEED_HIGH,
1890 &gs_highspeed_notify_desc,
1891 &gs_fullspeed_notify_desc);
1892 ret = usb_ep_enable(ep,ep_desc);
1894 ep->driver_data = dev;
1895 dev->dev_notify_ep = ep;
1896 dev->dev_notify_ep_desc = ep_desc;
1898 printk(KERN_ERR "gs_set_config: cannot enable notify endpoint %s, ret=%d\n",
1900 goto exit_reset_config;
1904 else if (strcmp(ep->name, EP_IN_NAME) == 0) {
1905 ep_desc = GS_SPEED_SELECT(
1906 gadget->speed == USB_SPEED_HIGH,
1907 &gs_highspeed_in_desc,
1908 &gs_fullspeed_in_desc);
1909 ret = usb_ep_enable(ep,ep_desc);
1911 ep->driver_data = dev;
1912 dev->dev_in_ep = ep;
1913 dev->dev_in_ep_desc = ep_desc;
1915 printk(KERN_ERR "gs_set_config: cannot enable in endpoint %s, ret=%d\n",
1917 goto exit_reset_config;
1921 else if (strcmp(ep->name, EP_OUT_NAME) == 0) {
1922 ep_desc = GS_SPEED_SELECT(
1923 gadget->speed == USB_SPEED_HIGH,
1924 &gs_highspeed_out_desc,
1925 &gs_fullspeed_out_desc);
1926 ret = usb_ep_enable(ep,ep_desc);
1928 ep->driver_data = dev;
1929 dev->dev_out_ep = ep;
1930 dev->dev_out_ep_desc = ep_desc;
1932 printk(KERN_ERR "gs_set_config: cannot enable out endpoint %s, ret=%d\n",
1934 goto exit_reset_config;
1940 if (dev->dev_in_ep == NULL || dev->dev_out_ep == NULL
1941 || (config != GS_BULK_CONFIG_ID && dev->dev_notify_ep == NULL)) {
1942 printk(KERN_ERR "gs_set_config: cannot find endpoints\n");
1944 goto exit_reset_config;
1947 /* allocate and queue read requests */
1948 ep = dev->dev_out_ep;
1949 for (i=0; i<read_q_size && ret == 0; i++) {
1950 if ((req=gs_alloc_req(ep, ep->maxpacket, GFP_ATOMIC))) {
1951 req->complete = gs_read_complete;
1952 if ((ret=usb_ep_queue(ep, req, GFP_ATOMIC))) {
1953 printk(KERN_ERR "gs_set_config: cannot queue read request, ret=%d\n",
1957 printk(KERN_ERR "gs_set_config: cannot allocate read requests\n");
1959 goto exit_reset_config;
1963 /* allocate write requests, and put on free list */
1964 ep = dev->dev_in_ep;
1965 for (i=0; i<write_q_size; i++) {
1966 if ((req_entry=gs_alloc_req_entry(ep, ep->maxpacket, GFP_ATOMIC))) {
1967 req_entry->re_req->complete = gs_write_complete;
1968 list_add(&req_entry->re_entry, &dev->dev_req_list);
1970 printk(KERN_ERR "gs_set_config: cannot allocate write requests\n");
1972 goto exit_reset_config;
1976 printk(KERN_INFO "gs_set_config: %s configured, %s speed %s config\n",
1978 gadget->speed == USB_SPEED_HIGH ? "high" : "full",
1979 config == GS_BULK_CONFIG_ID ? "BULK" : "CDC-ACM");
1984 gs_reset_config(dev);
1991 * Mark the device as not configured, disable all endpoints,
1992 * which forces completion of pending I/O and frees queued
1993 * requests, and free the remaining write requests on the
1996 * The device lock must be held when calling this function.
1998 static void gs_reset_config(struct gs_dev *dev)
2000 struct gs_req_entry *req_entry;
2003 printk(KERN_ERR "gs_reset_config: NULL device pointer\n");
2007 if (dev->dev_config == GS_NO_CONFIG_ID)
2010 dev->dev_config = GS_NO_CONFIG_ID;
2012 /* free write requests on the free list */
2013 while(!list_empty(&dev->dev_req_list)) {
2014 req_entry = list_entry(dev->dev_req_list.next,
2015 struct gs_req_entry, re_entry);
2016 list_del(&req_entry->re_entry);
2017 gs_free_req_entry(dev->dev_in_ep, req_entry);
2020 /* disable endpoints, forcing completion of pending i/o; */
2021 /* completion handlers free their requests in this case */
2022 if (dev->dev_notify_ep) {
2023 usb_ep_disable(dev->dev_notify_ep);
2024 dev->dev_notify_ep = NULL;
2026 if (dev->dev_in_ep) {
2027 usb_ep_disable(dev->dev_in_ep);
2028 dev->dev_in_ep = NULL;
2030 if (dev->dev_out_ep) {
2031 usb_ep_disable(dev->dev_out_ep);
2032 dev->dev_out_ep = NULL;
2037 * gs_build_config_buf
2039 * Builds the config descriptors in the given buffer and returns the
2040 * length, or a negative error number.
2042 static int gs_build_config_buf(u8 *buf, enum usb_device_speed speed,
2043 u8 type, unsigned int index, int is_otg)
2047 const struct usb_config_descriptor *config_desc;
2048 const struct usb_descriptor_header **function;
2050 if (index >= gs_device_desc.bNumConfigurations)
2053 /* other speed switches high and full speed */
2054 high_speed = (speed == USB_SPEED_HIGH);
2055 if (type == USB_DT_OTHER_SPEED_CONFIG)
2056 high_speed = !high_speed;
2059 config_desc = &gs_acm_config_desc;
2060 function = GS_SPEED_SELECT(high_speed,
2061 gs_acm_highspeed_function,
2062 gs_acm_fullspeed_function);
2064 config_desc = &gs_bulk_config_desc;
2065 function = GS_SPEED_SELECT(high_speed,
2066 gs_bulk_highspeed_function,
2067 gs_bulk_fullspeed_function);
2070 /* for now, don't advertise srp-only devices */
2074 len = usb_gadget_config_buf(config_desc, buf, GS_MAX_DESC_LEN, function);
2078 ((struct usb_config_descriptor *)buf)->bDescriptorType = type;
2086 * Allocate a usb_request and its buffer. Returns a pointer to the
2087 * usb_request or NULL if there is an error.
2089 static struct usb_request *
2090 gs_alloc_req(struct usb_ep *ep, unsigned int len, gfp_t kmalloc_flags)
2092 struct usb_request *req;
2097 req = usb_ep_alloc_request(ep, kmalloc_flags);
2101 req->buf = kmalloc(len, kmalloc_flags);
2102 if (req->buf == NULL) {
2103 usb_ep_free_request(ep, req);
2114 * Free a usb_request and its buffer.
2116 static void gs_free_req(struct usb_ep *ep, struct usb_request *req)
2118 if (ep != NULL && req != NULL) {
2120 usb_ep_free_request(ep, req);
2125 * gs_alloc_req_entry
2127 * Allocates a request and its buffer, using the given
2128 * endpoint, buffer len, and kmalloc flags.
2130 static struct gs_req_entry *
2131 gs_alloc_req_entry(struct usb_ep *ep, unsigned len, gfp_t kmalloc_flags)
2133 struct gs_req_entry *req;
2135 req = kmalloc(sizeof(struct gs_req_entry), kmalloc_flags);
2139 req->re_req = gs_alloc_req(ep, len, kmalloc_flags);
2140 if (req->re_req == NULL) {
2145 req->re_req->context = req;
2153 * Frees a request and its buffer.
2155 static void gs_free_req_entry(struct usb_ep *ep, struct gs_req_entry *req)
2157 if (ep != NULL && req != NULL) {
2158 if (req->re_req != NULL)
2159 gs_free_req(ep, req->re_req);
2167 * Allocate all ports and set the gs_dev struct to point to them.
2168 * Return 0 if successful, or a negative error number.
2170 * The device lock is normally held when calling this function.
2172 static int gs_alloc_ports(struct gs_dev *dev, gfp_t kmalloc_flags)
2175 struct gs_port *port;
2180 for (i=0; i<GS_NUM_PORTS; i++) {
2181 if ((port=kzalloc(sizeof(struct gs_port), kmalloc_flags)) == NULL)
2184 port->port_dev = dev;
2186 port->port_line_coding.dwDTERate = cpu_to_le32(GS_DEFAULT_DTE_RATE);
2187 port->port_line_coding.bCharFormat = GS_DEFAULT_CHAR_FORMAT;
2188 port->port_line_coding.bParityType = GS_DEFAULT_PARITY;
2189 port->port_line_coding.bDataBits = GS_DEFAULT_DATA_BITS;
2190 spin_lock_init(&port->port_lock);
2191 init_waitqueue_head(&port->port_write_wait);
2193 dev->dev_port[i] = port;
2202 * Free all closed ports. Open ports are disconnected by
2203 * freeing their write buffers, setting their device pointers
2204 * and the pointers to them in the device to NULL. These
2205 * ports will be freed when closed.
2207 * The device lock is normally held when calling this function.
2209 static void gs_free_ports(struct gs_dev *dev)
2212 unsigned long flags;
2213 struct gs_port *port;
2218 for (i=0; i<GS_NUM_PORTS; i++) {
2219 if ((port=dev->dev_port[i]) != NULL) {
2220 dev->dev_port[i] = NULL;
2222 spin_lock_irqsave(&port->port_lock, flags);
2224 if (port->port_write_buf != NULL) {
2225 gs_buf_free(port->port_write_buf);
2226 port->port_write_buf = NULL;
2229 if (port->port_open_count > 0 || port->port_in_use) {
2230 port->port_dev = NULL;
2231 wake_up_interruptible(&port->port_write_wait);
2232 if (port->port_tty) {
2233 wake_up_interruptible(&port->port_tty->read_wait);
2234 wake_up_interruptible(&port->port_tty->write_wait);
2236 spin_unlock_irqrestore(&port->port_lock, flags);
2238 spin_unlock_irqrestore(&port->port_lock, flags);
2246 /* Circular Buffer */
2251 * Allocate a circular buffer and all associated memory.
2253 static struct gs_buf *gs_buf_alloc(unsigned int size, gfp_t kmalloc_flags)
2260 gb = (struct gs_buf *)kmalloc(sizeof(struct gs_buf), kmalloc_flags);
2264 gb->buf_buf = kmalloc(size, kmalloc_flags);
2265 if (gb->buf_buf == NULL) {
2270 gb->buf_size = size;
2271 gb->buf_get = gb->buf_put = gb->buf_buf;
2279 * Free the buffer and all associated memory.
2281 void gs_buf_free(struct gs_buf *gb)
2292 * Clear out all data in the circular buffer.
2294 void gs_buf_clear(struct gs_buf *gb)
2297 gb->buf_get = gb->buf_put;
2298 /* equivalent to a get of all data available */
2304 * Return the number of bytes of data available in the circular
2307 unsigned int gs_buf_data_avail(struct gs_buf *gb)
2310 return (gb->buf_size + gb->buf_put - gb->buf_get) % gb->buf_size;
2316 * gs_buf_space_avail
2318 * Return the number of bytes of space available in the circular
2321 unsigned int gs_buf_space_avail(struct gs_buf *gb)
2324 return (gb->buf_size + gb->buf_get - gb->buf_put - 1) % gb->buf_size;
2332 * Copy data data from a user buffer and put it into the circular buffer.
2333 * Restrict to the amount of space available.
2335 * Return the number of bytes copied.
2337 unsigned int gs_buf_put(struct gs_buf *gb, const char *buf, unsigned int count)
2344 len = gs_buf_space_avail(gb);
2351 len = gb->buf_buf + gb->buf_size - gb->buf_put;
2353 memcpy(gb->buf_put, buf, len);
2354 memcpy(gb->buf_buf, buf+len, count - len);
2355 gb->buf_put = gb->buf_buf + count - len;
2357 memcpy(gb->buf_put, buf, count);
2359 gb->buf_put += count;
2360 else /* count == len */
2361 gb->buf_put = gb->buf_buf;
2370 * Get data from the circular buffer and copy to the given buffer.
2371 * Restrict to the amount of data available.
2373 * Return the number of bytes copied.
2375 unsigned int gs_buf_get(struct gs_buf *gb, char *buf, unsigned int count)
2382 len = gs_buf_data_avail(gb);
2389 len = gb->buf_buf + gb->buf_size - gb->buf_get;
2391 memcpy(buf, gb->buf_get, len);
2392 memcpy(buf+len, gb->buf_buf, count - len);
2393 gb->buf_get = gb->buf_buf + count - len;
2395 memcpy(buf, gb->buf_get, count);
2397 gb->buf_get += count;
2398 else /* count == len */
2399 gb->buf_get = gb->buf_buf;