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.
19 #include <linux/kernel.h>
20 #include <linux/utsname.h>
21 #include <linux/device.h>
22 #include <linux/tty.h>
23 #include <linux/tty_flip.h>
25 #include <linux/usb/ch9.h>
26 #include <linux/usb/cdc.h>
27 #include <linux/usb/gadget.h>
29 #include "gadget_chips.h"
34 #define GS_VERSION_STR "v2.2"
35 #define GS_VERSION_NUM 0x0202
37 #define GS_LONG_NAME "Gadget Serial"
38 #define GS_SHORT_NAME "g_serial"
41 #define GS_MINOR_START 0
43 /* REVISIT only one port is supported for now;
44 * see gs_{send,recv}_packet() ... no multiplexing,
45 * and no support for multiple ACM devices.
47 #define GS_NUM_PORTS 1
49 #define GS_NUM_CONFIGS 1
50 #define GS_NO_CONFIG_ID 0
51 #define GS_BULK_CONFIG_ID 1
52 #define GS_ACM_CONFIG_ID 2
54 #define GS_MAX_NUM_INTERFACES 2
55 #define GS_BULK_INTERFACE_ID 0
56 #define GS_CONTROL_INTERFACE_ID 0
57 #define GS_DATA_INTERFACE_ID 1
59 #define GS_MAX_DESC_LEN 256
61 #define GS_DEFAULT_READ_Q_SIZE 32
62 #define GS_DEFAULT_WRITE_Q_SIZE 32
64 #define GS_DEFAULT_WRITE_BUF_SIZE 8192
65 #define GS_TMP_BUF_SIZE 8192
67 #define GS_CLOSE_TIMEOUT 15
69 #define GS_DEFAULT_USE_ACM 0
71 /* 9600-8-N-1 ... matches init_termios.c_cflag and defaults
72 * expected by "usbser.sys" on MS-Windows.
74 #define GS_DEFAULT_DTE_RATE 9600
75 #define GS_DEFAULT_DATA_BITS 8
76 #define GS_DEFAULT_PARITY USB_CDC_NO_PARITY
77 #define GS_DEFAULT_CHAR_FORMAT USB_CDC_1_STOP_BITS
79 /* maxpacket and other transfer characteristics vary by speed. */
80 static inline struct usb_endpoint_descriptor
*
81 choose_ep_desc(struct usb_gadget
*g
, struct usb_endpoint_descriptor
*hs
,
82 struct usb_endpoint_descriptor
*fs
)
84 if (gadget_is_dualspeed(g
) && g
->speed
== USB_SPEED_HIGH
)
97 #define gs_debug(format, arg...) \
98 do { if (debug) pr_debug(format, ## arg); } while (0)
99 #define gs_debug_level(level, format, arg...) \
100 do { if (debug >= level) pr_debug(format, ## arg); } while (0)
103 /* Thanks to NetChip Technologies for donating this product ID.
105 * DO NOT REUSE THESE IDs with a protocol-incompatible driver!! Ever!!
106 * Instead: allocate your own, using normal USB-IF procedures.
108 #define GS_VENDOR_ID 0x0525 /* NetChip */
109 #define GS_PRODUCT_ID 0xa4a6 /* Linux-USB Serial Gadget */
110 #define GS_CDC_PRODUCT_ID 0xa4a7 /* ... as CDC-ACM */
112 #define GS_LOG2_NOTIFY_INTERVAL 5 /* 1 << 5 == 32 msec */
113 #define GS_NOTIFY_MAXPACKET 8
116 /* circular buffer */
118 unsigned int buf_size
;
124 /* the port structure holds info for each port, one for each minor number */
126 struct gs_dev
*port_dev
; /* pointer to device struct */
127 struct tty_struct
*port_tty
; /* pointer to tty struct */
128 spinlock_t port_lock
;
131 int port_in_use
; /* open/close in progress */
132 wait_queue_head_t port_write_wait
;/* waiting to write */
133 struct gs_buf
*port_write_buf
;
134 struct usb_cdc_line_coding port_line_coding
; /* 8-N-1 etc */
135 u16 port_handshake_bits
;
136 #define RS232_RTS (1 << 1)
137 #define RS232_DTE (1 << 0)
140 /* the device structure holds info for the USB device */
142 struct usb_gadget
*dev_gadget
; /* gadget device pointer */
143 spinlock_t dev_lock
; /* lock for set/reset config */
144 int dev_config
; /* configuration number */
145 struct usb_ep
*dev_notify_ep
; /* address of notify endpoint */
146 struct usb_ep
*dev_in_ep
; /* address of in endpoint */
147 struct usb_ep
*dev_out_ep
; /* address of out endpoint */
148 struct usb_endpoint_descriptor
/* descriptor of notify ep */
150 struct usb_endpoint_descriptor
/* descriptor of in endpoint */
152 struct usb_endpoint_descriptor
/* descriptor of out endpoint */
154 struct usb_request
*dev_ctrl_req
; /* control request */
155 struct list_head dev_req_list
; /* list of write requests */
156 int dev_sched_port
; /* round robin port scheduled */
157 struct gs_port
*dev_port
[GS_NUM_PORTS
]; /* the ports */
163 /* tty driver internals */
164 static int gs_send(struct gs_dev
*dev
);
165 static int gs_send_packet(struct gs_dev
*dev
, char *packet
,
167 static int gs_recv_packet(struct gs_dev
*dev
, char *packet
,
169 static void gs_read_complete(struct usb_ep
*ep
, struct usb_request
*req
);
170 static void gs_write_complete(struct usb_ep
*ep
, struct usb_request
*req
);
172 /* gadget driver internals */
173 static int gs_set_config(struct gs_dev
*dev
, unsigned config
);
174 static void gs_reset_config(struct gs_dev
*dev
);
175 static int gs_build_config_buf(u8
*buf
, struct usb_gadget
*g
,
176 u8 type
, unsigned int index
, int is_otg
);
178 static struct usb_request
*gs_alloc_req(struct usb_ep
*ep
, unsigned int len
,
179 gfp_t kmalloc_flags
);
180 static void gs_free_req(struct usb_ep
*ep
, struct usb_request
*req
);
182 static int gs_alloc_ports(struct gs_dev
*dev
, gfp_t kmalloc_flags
);
183 static void gs_free_ports(struct gs_dev
*dev
);
185 /* circular buffer */
186 static struct gs_buf
*gs_buf_alloc(unsigned int size
, gfp_t kmalloc_flags
);
187 static void gs_buf_free(struct gs_buf
*gb
);
188 static void gs_buf_clear(struct gs_buf
*gb
);
189 static unsigned int gs_buf_data_avail(struct gs_buf
*gb
);
190 static unsigned int gs_buf_space_avail(struct gs_buf
*gb
);
191 static unsigned int gs_buf_put(struct gs_buf
*gb
, const char *buf
,
193 static unsigned int gs_buf_get(struct gs_buf
*gb
, char *buf
,
199 static struct gs_dev
*gs_device
;
201 static const char *EP_IN_NAME
;
202 static const char *EP_OUT_NAME
;
203 static const char *EP_NOTIFY_NAME
;
205 static struct mutex gs_open_close_lock
[GS_NUM_PORTS
];
208 /*-------------------------------------------------------------------------*/
210 /* USB descriptors */
212 #define GS_MANUFACTURER_STR_ID 1
213 #define GS_PRODUCT_STR_ID 2
214 #define GS_SERIAL_STR_ID 3
215 #define GS_BULK_CONFIG_STR_ID 4
216 #define GS_ACM_CONFIG_STR_ID 5
217 #define GS_CONTROL_STR_ID 6
218 #define GS_DATA_STR_ID 7
220 /* static strings, in UTF-8 */
221 static char manufacturer
[50];
222 static struct usb_string gs_strings
[] = {
223 { GS_MANUFACTURER_STR_ID
, manufacturer
},
224 { GS_PRODUCT_STR_ID
, GS_LONG_NAME
},
225 { GS_SERIAL_STR_ID
, "0" },
226 { GS_BULK_CONFIG_STR_ID
, "Gadget Serial Bulk" },
227 { GS_ACM_CONFIG_STR_ID
, "Gadget Serial CDC ACM" },
228 { GS_CONTROL_STR_ID
, "Gadget Serial Control" },
229 { GS_DATA_STR_ID
, "Gadget Serial Data" },
230 { } /* end of list */
233 static struct usb_gadget_strings gs_string_table
= {
234 .language
= 0x0409, /* en-us */
235 .strings
= gs_strings
,
238 static struct usb_device_descriptor gs_device_desc
= {
239 .bLength
= USB_DT_DEVICE_SIZE
,
240 .bDescriptorType
= USB_DT_DEVICE
,
241 .bcdUSB
= __constant_cpu_to_le16(0x0200),
242 .bDeviceSubClass
= 0,
243 .bDeviceProtocol
= 0,
244 .idVendor
= __constant_cpu_to_le16(GS_VENDOR_ID
),
245 .idProduct
= __constant_cpu_to_le16(GS_PRODUCT_ID
),
246 .iManufacturer
= GS_MANUFACTURER_STR_ID
,
247 .iProduct
= GS_PRODUCT_STR_ID
,
248 .iSerialNumber
= GS_SERIAL_STR_ID
,
249 .bNumConfigurations
= GS_NUM_CONFIGS
,
252 static struct usb_otg_descriptor gs_otg_descriptor
= {
253 .bLength
= sizeof(gs_otg_descriptor
),
254 .bDescriptorType
= USB_DT_OTG
,
255 .bmAttributes
= USB_OTG_SRP
,
258 static struct usb_config_descriptor gs_bulk_config_desc
= {
259 .bLength
= USB_DT_CONFIG_SIZE
,
260 .bDescriptorType
= USB_DT_CONFIG
,
261 /* .wTotalLength computed dynamically */
263 .bConfigurationValue
= GS_BULK_CONFIG_ID
,
264 .iConfiguration
= GS_BULK_CONFIG_STR_ID
,
265 .bmAttributes
= USB_CONFIG_ATT_ONE
| USB_CONFIG_ATT_SELFPOWER
,
269 static struct usb_config_descriptor gs_acm_config_desc
= {
270 .bLength
= USB_DT_CONFIG_SIZE
,
271 .bDescriptorType
= USB_DT_CONFIG
,
272 /* .wTotalLength computed dynamically */
274 .bConfigurationValue
= GS_ACM_CONFIG_ID
,
275 .iConfiguration
= GS_ACM_CONFIG_STR_ID
,
276 .bmAttributes
= USB_CONFIG_ATT_ONE
| USB_CONFIG_ATT_SELFPOWER
,
280 static const struct usb_interface_descriptor gs_bulk_interface_desc
= {
281 .bLength
= USB_DT_INTERFACE_SIZE
,
282 .bDescriptorType
= USB_DT_INTERFACE
,
283 .bInterfaceNumber
= GS_BULK_INTERFACE_ID
,
285 .bInterfaceClass
= USB_CLASS_CDC_DATA
,
286 .bInterfaceSubClass
= 0,
287 .bInterfaceProtocol
= 0,
288 .iInterface
= GS_DATA_STR_ID
,
291 static const struct usb_interface_descriptor gs_control_interface_desc
= {
292 .bLength
= USB_DT_INTERFACE_SIZE
,
293 .bDescriptorType
= USB_DT_INTERFACE
,
294 .bInterfaceNumber
= GS_CONTROL_INTERFACE_ID
,
296 .bInterfaceClass
= USB_CLASS_COMM
,
297 .bInterfaceSubClass
= USB_CDC_SUBCLASS_ACM
,
298 .bInterfaceProtocol
= USB_CDC_ACM_PROTO_AT_V25TER
,
299 .iInterface
= GS_CONTROL_STR_ID
,
302 static const struct usb_interface_descriptor gs_data_interface_desc
= {
303 .bLength
= USB_DT_INTERFACE_SIZE
,
304 .bDescriptorType
= USB_DT_INTERFACE
,
305 .bInterfaceNumber
= GS_DATA_INTERFACE_ID
,
307 .bInterfaceClass
= USB_CLASS_CDC_DATA
,
308 .bInterfaceSubClass
= 0,
309 .bInterfaceProtocol
= 0,
310 .iInterface
= GS_DATA_STR_ID
,
313 static const struct usb_cdc_header_desc gs_header_desc
= {
314 .bLength
= sizeof(gs_header_desc
),
315 .bDescriptorType
= USB_DT_CS_INTERFACE
,
316 .bDescriptorSubType
= USB_CDC_HEADER_TYPE
,
317 .bcdCDC
= __constant_cpu_to_le16(0x0110),
320 static const struct usb_cdc_call_mgmt_descriptor gs_call_mgmt_descriptor
= {
321 .bLength
= sizeof(gs_call_mgmt_descriptor
),
322 .bDescriptorType
= USB_DT_CS_INTERFACE
,
323 .bDescriptorSubType
= USB_CDC_CALL_MANAGEMENT_TYPE
,
325 .bDataInterface
= 1, /* index of data interface */
328 static struct usb_cdc_acm_descriptor gs_acm_descriptor
= {
329 .bLength
= sizeof(gs_acm_descriptor
),
330 .bDescriptorType
= USB_DT_CS_INTERFACE
,
331 .bDescriptorSubType
= USB_CDC_ACM_TYPE
,
332 .bmCapabilities
= (1 << 1),
335 static const struct usb_cdc_union_desc gs_union_desc
= {
336 .bLength
= sizeof(gs_union_desc
),
337 .bDescriptorType
= USB_DT_CS_INTERFACE
,
338 .bDescriptorSubType
= USB_CDC_UNION_TYPE
,
339 .bMasterInterface0
= 0, /* index of control interface */
340 .bSlaveInterface0
= 1, /* index of data interface */
343 static struct usb_endpoint_descriptor gs_fullspeed_notify_desc
= {
344 .bLength
= USB_DT_ENDPOINT_SIZE
,
345 .bDescriptorType
= USB_DT_ENDPOINT
,
346 .bEndpointAddress
= USB_DIR_IN
,
347 .bmAttributes
= USB_ENDPOINT_XFER_INT
,
348 .wMaxPacketSize
= __constant_cpu_to_le16(GS_NOTIFY_MAXPACKET
),
349 .bInterval
= 1 << GS_LOG2_NOTIFY_INTERVAL
,
352 static struct usb_endpoint_descriptor gs_fullspeed_in_desc
= {
353 .bLength
= USB_DT_ENDPOINT_SIZE
,
354 .bDescriptorType
= USB_DT_ENDPOINT
,
355 .bEndpointAddress
= USB_DIR_IN
,
356 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
359 static struct usb_endpoint_descriptor gs_fullspeed_out_desc
= {
360 .bLength
= USB_DT_ENDPOINT_SIZE
,
361 .bDescriptorType
= USB_DT_ENDPOINT
,
362 .bEndpointAddress
= USB_DIR_OUT
,
363 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
366 static const struct usb_descriptor_header
*gs_bulk_fullspeed_function
[] = {
367 (struct usb_descriptor_header
*) &gs_otg_descriptor
,
368 (struct usb_descriptor_header
*) &gs_bulk_interface_desc
,
369 (struct usb_descriptor_header
*) &gs_fullspeed_in_desc
,
370 (struct usb_descriptor_header
*) &gs_fullspeed_out_desc
,
374 static const struct usb_descriptor_header
*gs_acm_fullspeed_function
[] = {
375 (struct usb_descriptor_header
*) &gs_otg_descriptor
,
376 (struct usb_descriptor_header
*) &gs_control_interface_desc
,
377 (struct usb_descriptor_header
*) &gs_header_desc
,
378 (struct usb_descriptor_header
*) &gs_call_mgmt_descriptor
,
379 (struct usb_descriptor_header
*) &gs_acm_descriptor
,
380 (struct usb_descriptor_header
*) &gs_union_desc
,
381 (struct usb_descriptor_header
*) &gs_fullspeed_notify_desc
,
382 (struct usb_descriptor_header
*) &gs_data_interface_desc
,
383 (struct usb_descriptor_header
*) &gs_fullspeed_in_desc
,
384 (struct usb_descriptor_header
*) &gs_fullspeed_out_desc
,
388 static struct usb_endpoint_descriptor gs_highspeed_notify_desc
= {
389 .bLength
= USB_DT_ENDPOINT_SIZE
,
390 .bDescriptorType
= USB_DT_ENDPOINT
,
391 .bEndpointAddress
= USB_DIR_IN
,
392 .bmAttributes
= USB_ENDPOINT_XFER_INT
,
393 .wMaxPacketSize
= __constant_cpu_to_le16(GS_NOTIFY_MAXPACKET
),
394 .bInterval
= GS_LOG2_NOTIFY_INTERVAL
+4,
397 static struct usb_endpoint_descriptor gs_highspeed_in_desc
= {
398 .bLength
= USB_DT_ENDPOINT_SIZE
,
399 .bDescriptorType
= USB_DT_ENDPOINT
,
400 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
401 .wMaxPacketSize
= __constant_cpu_to_le16(512),
404 static struct usb_endpoint_descriptor gs_highspeed_out_desc
= {
405 .bLength
= USB_DT_ENDPOINT_SIZE
,
406 .bDescriptorType
= USB_DT_ENDPOINT
,
407 .bmAttributes
= USB_ENDPOINT_XFER_BULK
,
408 .wMaxPacketSize
= __constant_cpu_to_le16(512),
411 static struct usb_qualifier_descriptor gs_qualifier_desc
= {
412 .bLength
= sizeof(struct usb_qualifier_descriptor
),
413 .bDescriptorType
= USB_DT_DEVICE_QUALIFIER
,
414 .bcdUSB
= __constant_cpu_to_le16 (0x0200),
415 /* assumes ep0 uses the same value for both speeds ... */
416 .bNumConfigurations
= GS_NUM_CONFIGS
,
419 static const struct usb_descriptor_header
*gs_bulk_highspeed_function
[] = {
420 (struct usb_descriptor_header
*) &gs_otg_descriptor
,
421 (struct usb_descriptor_header
*) &gs_bulk_interface_desc
,
422 (struct usb_descriptor_header
*) &gs_highspeed_in_desc
,
423 (struct usb_descriptor_header
*) &gs_highspeed_out_desc
,
427 static const struct usb_descriptor_header
*gs_acm_highspeed_function
[] = {
428 (struct usb_descriptor_header
*) &gs_otg_descriptor
,
429 (struct usb_descriptor_header
*) &gs_control_interface_desc
,
430 (struct usb_descriptor_header
*) &gs_header_desc
,
431 (struct usb_descriptor_header
*) &gs_call_mgmt_descriptor
,
432 (struct usb_descriptor_header
*) &gs_acm_descriptor
,
433 (struct usb_descriptor_header
*) &gs_union_desc
,
434 (struct usb_descriptor_header
*) &gs_highspeed_notify_desc
,
435 (struct usb_descriptor_header
*) &gs_data_interface_desc
,
436 (struct usb_descriptor_header
*) &gs_highspeed_in_desc
,
437 (struct usb_descriptor_header
*) &gs_highspeed_out_desc
,
442 /*-------------------------------------------------------------------------*/
445 MODULE_DESCRIPTION(GS_LONG_NAME
);
446 MODULE_AUTHOR("Al Borchers");
447 MODULE_LICENSE("GPL");
450 module_param(debug
, int, S_IRUGO
|S_IWUSR
);
451 MODULE_PARM_DESC(debug
, "Enable debugging, 0=off, 1=on");
454 static unsigned int read_q_size
= GS_DEFAULT_READ_Q_SIZE
;
455 module_param(read_q_size
, uint
, S_IRUGO
);
456 MODULE_PARM_DESC(read_q_size
, "Read request queue size, default=32");
458 static unsigned int write_q_size
= GS_DEFAULT_WRITE_Q_SIZE
;
459 module_param(write_q_size
, uint
, S_IRUGO
);
460 MODULE_PARM_DESC(write_q_size
, "Write request queue size, default=32");
462 static unsigned int write_buf_size
= GS_DEFAULT_WRITE_BUF_SIZE
;
463 module_param(write_buf_size
, uint
, S_IRUGO
);
464 MODULE_PARM_DESC(write_buf_size
, "Write buffer size, default=8192");
466 static unsigned int use_acm
= GS_DEFAULT_USE_ACM
;
467 module_param(use_acm
, uint
, S_IRUGO
);
468 MODULE_PARM_DESC(use_acm
, "Use CDC ACM, 0=no, 1=yes, default=no");
470 /*-------------------------------------------------------------------------*/
477 static int gs_open(struct tty_struct
*tty
, struct file
*file
)
481 struct gs_port
*port
;
487 port_num
= tty
->index
;
489 gs_debug("gs_open: (%d,%p,%p)\n", port_num
, tty
, file
);
491 if (port_num
< 0 || port_num
>= GS_NUM_PORTS
) {
492 pr_err("gs_open: (%d,%p,%p) invalid port number\n",
493 port_num
, tty
, file
);
500 pr_err("gs_open: (%d,%p,%p) NULL device pointer\n",
501 port_num
, tty
, file
);
505 mtx
= &gs_open_close_lock
[port_num
];
506 if (mutex_lock_interruptible(mtx
)) {
507 pr_err("gs_open: (%d,%p,%p) interrupted waiting for mutex\n",
508 port_num
, tty
, file
);
512 spin_lock_irqsave(&dev
->dev_lock
, flags
);
514 if (dev
->dev_config
== GS_NO_CONFIG_ID
) {
515 pr_err("gs_open: (%d,%p,%p) device is not connected\n",
516 port_num
, tty
, file
);
518 goto exit_unlock_dev
;
521 port
= dev
->dev_port
[port_num
];
524 pr_err("gs_open: (%d,%p,%p) NULL port pointer\n",
525 port_num
, tty
, file
);
527 goto exit_unlock_dev
;
530 spin_lock(&port
->port_lock
);
531 spin_unlock(&dev
->dev_lock
);
533 if (port
->port_dev
== NULL
) {
534 pr_err("gs_open: (%d,%p,%p) port disconnected (1)\n",
535 port_num
, tty
, file
);
537 goto exit_unlock_port
;
540 if (port
->port_open_count
> 0) {
541 ++port
->port_open_count
;
542 gs_debug("gs_open: (%d,%p,%p) already open\n",
543 port_num
, tty
, file
);
545 goto exit_unlock_port
;
548 tty
->driver_data
= NULL
;
550 /* mark port as in use, we can drop port lock and sleep if necessary */
551 port
->port_in_use
= 1;
553 /* allocate write buffer on first open */
554 if (port
->port_write_buf
== NULL
) {
555 spin_unlock_irqrestore(&port
->port_lock
, flags
);
556 buf
= gs_buf_alloc(write_buf_size
, GFP_KERNEL
);
557 spin_lock_irqsave(&port
->port_lock
, flags
);
559 /* might have been disconnected while asleep, check */
560 if (port
->port_dev
== NULL
) {
561 pr_err("gs_open: (%d,%p,%p) port disconnected (2)\n",
562 port_num
, tty
, file
);
563 port
->port_in_use
= 0;
565 goto exit_unlock_port
;
568 if ((port
->port_write_buf
=buf
) == NULL
) {
569 pr_err("gs_open: (%d,%p,%p) cannot allocate "
570 "port write buffer\n",
571 port_num
, tty
, file
);
572 port
->port_in_use
= 0;
574 goto exit_unlock_port
;
579 /* wait for carrier detect (not implemented) */
581 /* might have been disconnected while asleep, check */
582 if (port
->port_dev
== NULL
) {
583 pr_err("gs_open: (%d,%p,%p) port disconnected (3)\n",
584 port_num
, tty
, file
);
585 port
->port_in_use
= 0;
587 goto exit_unlock_port
;
590 tty
->driver_data
= port
;
591 port
->port_tty
= tty
;
592 port
->port_open_count
= 1;
593 port
->port_in_use
= 0;
595 gs_debug("gs_open: (%d,%p,%p) completed\n", port_num
, tty
, file
);
600 spin_unlock_irqrestore(&port
->port_lock
, flags
);
605 spin_unlock_irqrestore(&dev
->dev_lock
, flags
);
615 static int gs_write_finished_event_safely(struct gs_port
*p
)
619 spin_lock_irq(&(p
)->port_lock
);
620 cond
= !(p
)->port_dev
|| !gs_buf_data_avail((p
)->port_write_buf
);
621 spin_unlock_irq(&(p
)->port_lock
);
625 static void gs_close(struct tty_struct
*tty
, struct file
*file
)
627 struct gs_port
*port
= tty
->driver_data
;
631 pr_err("gs_close: NULL port pointer\n");
635 gs_debug("gs_close: (%d,%p,%p)\n", port
->port_num
, tty
, file
);
637 mtx
= &gs_open_close_lock
[port
->port_num
];
640 spin_lock_irq(&port
->port_lock
);
642 if (port
->port_open_count
== 0) {
643 pr_err("gs_close: (%d,%p,%p) port is already closed\n",
644 port
->port_num
, tty
, file
);
648 if (port
->port_open_count
> 1) {
649 --port
->port_open_count
;
653 /* free disconnected port on final close */
654 if (port
->port_dev
== NULL
) {
659 /* mark port as closed but in use, we can drop port lock */
660 /* and sleep if necessary */
661 port
->port_in_use
= 1;
662 port
->port_open_count
= 0;
664 /* wait for write buffer to drain, or */
665 /* at most GS_CLOSE_TIMEOUT seconds */
666 if (gs_buf_data_avail(port
->port_write_buf
) > 0) {
667 spin_unlock_irq(&port
->port_lock
);
668 wait_event_interruptible_timeout(port
->port_write_wait
,
669 gs_write_finished_event_safely(port
),
670 GS_CLOSE_TIMEOUT
* HZ
);
671 spin_lock_irq(&port
->port_lock
);
674 /* free disconnected port on final close */
675 /* (might have happened during the above sleep) */
676 if (port
->port_dev
== NULL
) {
681 gs_buf_clear(port
->port_write_buf
);
683 tty
->driver_data
= NULL
;
684 port
->port_tty
= NULL
;
685 port
->port_in_use
= 0;
687 gs_debug("gs_close: (%d,%p,%p) completed\n",
688 port
->port_num
, tty
, file
);
691 spin_unlock_irq(&port
->port_lock
);
698 static int gs_write(struct tty_struct
*tty
, const unsigned char *buf
, int count
)
701 struct gs_port
*port
= tty
->driver_data
;
705 pr_err("gs_write: NULL port pointer\n");
709 gs_debug("gs_write: (%d,%p) writing %d bytes\n", port
->port_num
, tty
,
715 spin_lock_irqsave(&port
->port_lock
, flags
);
717 if (port
->port_dev
== NULL
) {
718 pr_err("gs_write: (%d,%p) port is not connected\n",
719 port
->port_num
, tty
);
724 if (port
->port_open_count
== 0) {
725 pr_err("gs_write: (%d,%p) port is closed\n",
726 port
->port_num
, tty
);
731 count
= gs_buf_put(port
->port_write_buf
, buf
, count
);
733 spin_unlock_irqrestore(&port
->port_lock
, flags
);
737 gs_debug("gs_write: (%d,%p) wrote %d bytes\n", port
->port_num
, tty
,
743 spin_unlock_irqrestore(&port
->port_lock
, flags
);
750 static int gs_put_char(struct tty_struct
*tty
, unsigned char ch
)
753 struct gs_port
*port
= tty
->driver_data
;
757 pr_err("gs_put_char: NULL port pointer\n");
761 gs_debug("gs_put_char: (%d,%p) char=0x%x, called from %p\n",
762 port
->port_num
, tty
, ch
, __builtin_return_address(0));
764 spin_lock_irqsave(&port
->port_lock
, flags
);
766 if (port
->port_dev
== NULL
) {
767 pr_err("gs_put_char: (%d,%p) port is not connected\n",
768 port
->port_num
, tty
);
772 if (port
->port_open_count
== 0) {
773 pr_err("gs_put_char: (%d,%p) port is closed\n",
774 port
->port_num
, tty
);
778 ret
= gs_buf_put(port
->port_write_buf
, &ch
, 1);
781 spin_unlock_irqrestore(&port
->port_lock
, flags
);
788 static void gs_flush_chars(struct tty_struct
*tty
)
791 struct gs_port
*port
= tty
->driver_data
;
794 pr_err("gs_flush_chars: NULL port pointer\n");
798 gs_debug("gs_flush_chars: (%d,%p)\n", port
->port_num
, tty
);
800 spin_lock_irqsave(&port
->port_lock
, flags
);
802 if (port
->port_dev
== NULL
) {
803 pr_err("gs_flush_chars: (%d,%p) port is not connected\n",
804 port
->port_num
, tty
);
808 if (port
->port_open_count
== 0) {
809 pr_err("gs_flush_chars: (%d,%p) port is closed\n",
810 port
->port_num
, tty
);
814 spin_unlock_irqrestore(&port
->port_lock
, flags
);
821 spin_unlock_irqrestore(&port
->port_lock
, flags
);
827 static int gs_write_room(struct tty_struct
*tty
)
832 struct gs_port
*port
= tty
->driver_data
;
838 spin_lock_irqsave(&port
->port_lock
, flags
);
840 if (port
->port_dev
!= NULL
&& port
->port_open_count
> 0
841 && port
->port_write_buf
!= NULL
)
842 room
= gs_buf_space_avail(port
->port_write_buf
);
844 spin_unlock_irqrestore(&port
->port_lock
, flags
);
846 gs_debug("gs_write_room: (%d,%p) room=%d\n",
847 port
->port_num
, tty
, room
);
855 static int gs_chars_in_buffer(struct tty_struct
*tty
)
859 struct gs_port
*port
= tty
->driver_data
;
864 spin_lock_irqsave(&port
->port_lock
, flags
);
866 if (port
->port_dev
!= NULL
&& port
->port_open_count
> 0
867 && port
->port_write_buf
!= NULL
)
868 chars
= gs_buf_data_avail(port
->port_write_buf
);
870 spin_unlock_irqrestore(&port
->port_lock
, flags
);
872 gs_debug("gs_chars_in_buffer: (%d,%p) chars=%d\n",
873 port
->port_num
, tty
, chars
);
881 static void gs_throttle(struct tty_struct
*tty
)
888 static void gs_unthrottle(struct tty_struct
*tty
)
895 static void gs_break(struct tty_struct
*tty
, int break_state
)
902 static int gs_ioctl(struct tty_struct
*tty
, struct file
*file
, unsigned int cmd
, unsigned long arg
)
904 struct gs_port
*port
= tty
->driver_data
;
907 pr_err("gs_ioctl: NULL port pointer\n");
911 gs_debug("gs_ioctl: (%d,%p,%p) cmd=0x%4.4x, arg=%lu\n",
912 port
->port_num
, tty
, file
, cmd
, arg
);
916 /* could not handle ioctl */
923 static void gs_set_termios(struct tty_struct
*tty
, struct ktermios
*old
)
927 static const struct tty_operations gs_tty_ops
= {
931 .put_char
= gs_put_char
,
932 .flush_chars
= gs_flush_chars
,
933 .write_room
= gs_write_room
,
935 .set_termios
= gs_set_termios
,
936 .throttle
= gs_throttle
,
937 .unthrottle
= gs_unthrottle
,
938 .break_ctl
= gs_break
,
939 .chars_in_buffer
= gs_chars_in_buffer
,
942 /*-------------------------------------------------------------------------*/
947 * This function finds available write requests, calls
948 * gs_send_packet to fill these packets with data, and
949 * continues until either there are no more write requests
950 * available or no more data to send. This function is
951 * run whenever data arrives or write requests are available.
953 static int gs_send(struct gs_dev
*dev
)
958 struct usb_request
*req
;
961 pr_err("gs_send: NULL device pointer\n");
965 spin_lock_irqsave(&dev
->dev_lock
, flags
);
969 while(!list_empty(&dev
->dev_req_list
)) {
971 req
= list_entry(dev
->dev_req_list
.next
,
972 struct usb_request
, list
);
974 len
= gs_send_packet(dev
, req
->buf
, ep
->maxpacket
);
977 gs_debug_level(3, "gs_send: len=%d, 0x%2.2x "
978 "0x%2.2x 0x%2.2x ...\n", len
,
979 *((unsigned char *)req
->buf
),
980 *((unsigned char *)req
->buf
+1),
981 *((unsigned char *)req
->buf
+2));
982 list_del(&req
->list
);
984 spin_unlock_irqrestore(&dev
->dev_lock
, flags
);
985 if ((ret
=usb_ep_queue(ep
, req
, GFP_ATOMIC
))) {
987 "gs_send: cannot queue read request, ret=%d\n",
989 spin_lock_irqsave(&dev
->dev_lock
, flags
);
992 spin_lock_irqsave(&dev
->dev_lock
, flags
);
999 spin_unlock_irqrestore(&dev
->dev_lock
, flags
);
1007 * If there is data to send, a packet is built in the given
1008 * buffer and the size is returned. If there is no data to
1009 * send, 0 is returned. If there is any error a negative
1010 * error number is returned.
1012 * Called during USB completion routine, on interrupt time.
1014 * We assume that disconnect will not happen until all completion
1015 * routines have completed, so we can assume that the dev_port
1016 * array does not change during the lifetime of this function.
1018 static int gs_send_packet(struct gs_dev
*dev
, char *packet
, unsigned int size
)
1021 struct gs_port
*port
;
1023 /* TEMPORARY -- only port 0 is supported right now */
1024 port
= dev
->dev_port
[0];
1027 pr_err("gs_send_packet: port=%d, NULL port pointer\n", 0);
1031 spin_lock(&port
->port_lock
);
1033 len
= gs_buf_data_avail(port
->port_write_buf
);
1040 size
= gs_buf_get(port
->port_write_buf
, packet
, size
);
1043 wake_up_interruptible(&port
->port_tty
->write_wait
);
1046 spin_unlock(&port
->port_lock
);
1053 * Called for each USB packet received. Reads the packet
1054 * header and stuffs the data in the appropriate tty buffer.
1055 * Returns 0 if successful, or a negative error number.
1057 * Called during USB completion routine, on interrupt time.
1059 * We assume that disconnect will not happen until all completion
1060 * routines have completed, so we can assume that the dev_port
1061 * array does not change during the lifetime of this function.
1063 static int gs_recv_packet(struct gs_dev
*dev
, char *packet
, unsigned int size
)
1066 struct gs_port
*port
;
1068 struct tty_struct
*tty
;
1070 /* TEMPORARY -- only port 0 is supported right now */
1071 port
= dev
->dev_port
[0];
1074 pr_err("gs_recv_packet: port=%d, NULL port pointer\n",
1079 spin_lock(&port
->port_lock
);
1081 if (port
->port_open_count
== 0) {
1082 pr_err("gs_recv_packet: port=%d, port is closed\n",
1089 tty
= port
->port_tty
;
1092 pr_err("gs_recv_packet: port=%d, NULL tty pointer\n",
1098 if (port
->port_tty
->magic
!= TTY_MAGIC
) {
1099 pr_err("gs_recv_packet: port=%d, bad tty magic\n",
1105 len
= tty_buffer_request_room(tty
, size
);
1107 tty_insert_flip_string(tty
, packet
, len
);
1108 tty_flip_buffer_push(port
->port_tty
);
1109 wake_up_interruptible(&port
->port_tty
->read_wait
);
1113 spin_unlock(&port
->port_lock
);
1120 static void gs_read_complete(struct usb_ep
*ep
, struct usb_request
*req
)
1123 struct gs_dev
*dev
= ep
->driver_data
;
1126 pr_err("gs_read_complete: NULL device pointer\n");
1130 switch(req
->status
) {
1132 /* normal completion */
1133 gs_recv_packet(dev
, req
->buf
, req
->actual
);
1135 req
->length
= ep
->maxpacket
;
1136 if ((ret
=usb_ep_queue(ep
, req
, GFP_ATOMIC
))) {
1138 "gs_read_complete: cannot queue read request, ret=%d\n",
1145 gs_debug("gs_read_complete: shutdown\n");
1146 gs_free_req(ep
, req
);
1152 "gs_read_complete: unexpected status error, status=%d\n",
1162 static void gs_write_complete(struct usb_ep
*ep
, struct usb_request
*req
)
1164 struct gs_dev
*dev
= ep
->driver_data
;
1167 pr_err("gs_write_complete: NULL device pointer\n");
1171 switch(req
->status
) {
1173 /* normal completion */
1175 spin_lock(&dev
->dev_lock
);
1176 list_add(&req
->list
, &dev
->dev_req_list
);
1177 spin_unlock(&dev
->dev_lock
);
1185 gs_debug("gs_write_complete: shutdown\n");
1186 gs_free_req(ep
, req
);
1191 "gs_write_complete: unexpected status error, status=%d\n",
1198 /*-------------------------------------------------------------------------*/
1205 * Called on module unload. Frees the control request and device
1208 static void /* __init_or_exit */ gs_unbind(struct usb_gadget
*gadget
)
1210 struct gs_dev
*dev
= get_gadget_data(gadget
);
1214 /* read/write requests already freed, only control request remains */
1216 if (dev
->dev_ctrl_req
!= NULL
) {
1217 gs_free_req(gadget
->ep0
, dev
->dev_ctrl_req
);
1218 dev
->dev_ctrl_req
= NULL
;
1221 if (dev
->dev_notify_ep
)
1222 usb_ep_disable(dev
->dev_notify_ep
);
1224 usb_ep_disable(dev
->dev_in_ep
);
1225 if (dev
->dev_out_ep
)
1226 usb_ep_disable(dev
->dev_out_ep
);
1228 set_gadget_data(gadget
, NULL
);
1231 pr_info("gs_unbind: %s %s unbound\n", GS_LONG_NAME
,
1238 * Called on module load. Allocates and initializes the device
1239 * structure and a control request.
1241 static int __init
gs_bind(struct usb_gadget
*gadget
)
1248 /* Some controllers can't support CDC ACM:
1249 * - sh doesn't support multiple interfaces or configs;
1250 * - sa1100 doesn't have a third interrupt endpoint
1252 if (gadget_is_sh(gadget
) || gadget_is_sa1100(gadget
))
1255 gcnum
= usb_gadget_controller_number(gadget
);
1257 gs_device_desc
.bcdDevice
=
1258 cpu_to_le16(GS_VERSION_NUM
| gcnum
);
1260 pr_warning("gs_bind: controller '%s' not recognized\n",
1262 /* unrecognized, but safe unless bulk is REALLY quirky */
1263 gs_device_desc
.bcdDevice
=
1264 __constant_cpu_to_le16(GS_VERSION_NUM
|0x0099);
1267 usb_ep_autoconfig_reset(gadget
);
1269 ep
= usb_ep_autoconfig(gadget
, &gs_fullspeed_in_desc
);
1272 EP_IN_NAME
= ep
->name
;
1273 ep
->driver_data
= ep
; /* claim the endpoint */
1275 ep
= usb_ep_autoconfig(gadget
, &gs_fullspeed_out_desc
);
1278 EP_OUT_NAME
= ep
->name
;
1279 ep
->driver_data
= ep
; /* claim the endpoint */
1282 ep
= usb_ep_autoconfig(gadget
, &gs_fullspeed_notify_desc
);
1284 pr_err("gs_bind: cannot run ACM on %s\n", gadget
->name
);
1287 gs_device_desc
.idProduct
= __constant_cpu_to_le16(
1289 EP_NOTIFY_NAME
= ep
->name
;
1290 ep
->driver_data
= ep
; /* claim the endpoint */
1293 gs_device_desc
.bDeviceClass
= use_acm
1294 ? USB_CLASS_COMM
: USB_CLASS_VENDOR_SPEC
;
1295 gs_device_desc
.bMaxPacketSize0
= gadget
->ep0
->maxpacket
;
1297 if (gadget_is_dualspeed(gadget
)) {
1298 gs_qualifier_desc
.bDeviceClass
= use_acm
1299 ? USB_CLASS_COMM
: USB_CLASS_VENDOR_SPEC
;
1300 /* assume ep0 uses the same packet size for both speeds */
1301 gs_qualifier_desc
.bMaxPacketSize0
=
1302 gs_device_desc
.bMaxPacketSize0
;
1303 /* assume endpoints are dual-speed */
1304 gs_highspeed_notify_desc
.bEndpointAddress
=
1305 gs_fullspeed_notify_desc
.bEndpointAddress
;
1306 gs_highspeed_in_desc
.bEndpointAddress
=
1307 gs_fullspeed_in_desc
.bEndpointAddress
;
1308 gs_highspeed_out_desc
.bEndpointAddress
=
1309 gs_fullspeed_out_desc
.bEndpointAddress
;
1312 usb_gadget_set_selfpowered(gadget
);
1314 if (gadget_is_otg(gadget
)) {
1315 gs_otg_descriptor
.bmAttributes
|= USB_OTG_HNP
,
1316 gs_bulk_config_desc
.bmAttributes
|= USB_CONFIG_ATT_WAKEUP
;
1317 gs_acm_config_desc
.bmAttributes
|= USB_CONFIG_ATT_WAKEUP
;
1320 gs_device
= dev
= kzalloc(sizeof(struct gs_dev
), GFP_KERNEL
);
1324 snprintf(manufacturer
, sizeof(manufacturer
), "%s %s with %s",
1325 init_utsname()->sysname
, init_utsname()->release
,
1328 dev
->dev_gadget
= gadget
;
1329 spin_lock_init(&dev
->dev_lock
);
1330 INIT_LIST_HEAD(&dev
->dev_req_list
);
1331 set_gadget_data(gadget
, dev
);
1333 if ((ret
=gs_alloc_ports(dev
, GFP_KERNEL
)) != 0) {
1334 pr_err("gs_bind: cannot allocate ports\n");
1339 /* preallocate control response and buffer */
1340 dev
->dev_ctrl_req
= gs_alloc_req(gadget
->ep0
, GS_MAX_DESC_LEN
,
1342 if (dev
->dev_ctrl_req
== NULL
) {
1346 gadget
->ep0
->driver_data
= dev
;
1348 pr_info("gs_bind: %s %s bound\n",
1349 GS_LONG_NAME
, GS_VERSION_STR
);
1354 pr_err("gs_bind: cannot autoconfigure on %s\n", gadget
->name
);
1358 static int gs_setup_standard(struct usb_gadget
*gadget
,
1359 const struct usb_ctrlrequest
*ctrl
)
1361 int ret
= -EOPNOTSUPP
;
1362 struct gs_dev
*dev
= get_gadget_data(gadget
);
1363 struct usb_request
*req
= dev
->dev_ctrl_req
;
1364 u16 wIndex
= le16_to_cpu(ctrl
->wIndex
);
1365 u16 wValue
= le16_to_cpu(ctrl
->wValue
);
1366 u16 wLength
= le16_to_cpu(ctrl
->wLength
);
1368 switch (ctrl
->bRequest
) {
1369 case USB_REQ_GET_DESCRIPTOR
:
1370 if (ctrl
->bRequestType
!= USB_DIR_IN
)
1373 switch (wValue
>> 8) {
1376 (u16
)sizeof(struct usb_device_descriptor
));
1377 memcpy(req
->buf
, &gs_device_desc
, ret
);
1380 case USB_DT_DEVICE_QUALIFIER
:
1381 if (!gadget_is_dualspeed(gadget
))
1384 (u16
)sizeof(struct usb_qualifier_descriptor
));
1385 memcpy(req
->buf
, &gs_qualifier_desc
, ret
);
1388 case USB_DT_OTHER_SPEED_CONFIG
:
1389 if (!gadget_is_dualspeed(gadget
))
1393 ret
= gs_build_config_buf(req
->buf
, gadget
,
1394 wValue
>> 8, wValue
& 0xff,
1395 gadget_is_otg(gadget
));
1397 ret
= min(wLength
, (u16
)ret
);
1401 /* wIndex == language code. */
1402 ret
= usb_gadget_get_string(&gs_string_table
,
1403 wValue
& 0xff, req
->buf
);
1405 ret
= min(wLength
, (u16
)ret
);
1410 case USB_REQ_SET_CONFIGURATION
:
1411 if (ctrl
->bRequestType
!= 0)
1413 spin_lock(&dev
->dev_lock
);
1414 ret
= gs_set_config(dev
, wValue
);
1415 spin_unlock(&dev
->dev_lock
);
1418 case USB_REQ_GET_CONFIGURATION
:
1419 if (ctrl
->bRequestType
!= USB_DIR_IN
)
1421 *(u8
*)req
->buf
= dev
->dev_config
;
1422 ret
= min(wLength
, (u16
)1);
1425 case USB_REQ_SET_INTERFACE
:
1426 if (ctrl
->bRequestType
!= USB_RECIP_INTERFACE
1428 || wIndex
>= GS_MAX_NUM_INTERFACES
)
1430 if (dev
->dev_config
== GS_BULK_CONFIG_ID
1431 && wIndex
!= GS_BULK_INTERFACE_ID
)
1433 /* no alternate interface settings */
1436 spin_lock(&dev
->dev_lock
);
1437 /* PXA hardware partially handles SET_INTERFACE;
1438 * we need to kluge around that interference. */
1439 if (gadget_is_pxa(gadget
)) {
1440 ret
= gs_set_config(dev
, use_acm
?
1441 GS_ACM_CONFIG_ID
: GS_BULK_CONFIG_ID
);
1442 goto set_interface_done
;
1444 if (dev
->dev_config
!= GS_BULK_CONFIG_ID
1445 && wIndex
== GS_CONTROL_INTERFACE_ID
) {
1446 if (dev
->dev_notify_ep
) {
1447 usb_ep_disable(dev
->dev_notify_ep
);
1448 usb_ep_enable(dev
->dev_notify_ep
, dev
->dev_notify_ep_desc
);
1451 usb_ep_disable(dev
->dev_in_ep
);
1452 usb_ep_disable(dev
->dev_out_ep
);
1453 usb_ep_enable(dev
->dev_in_ep
, dev
->dev_in_ep_desc
);
1454 usb_ep_enable(dev
->dev_out_ep
, dev
->dev_out_ep_desc
);
1458 spin_unlock(&dev
->dev_lock
);
1461 case USB_REQ_GET_INTERFACE
:
1462 if (ctrl
->bRequestType
!= (USB_DIR_IN
|USB_RECIP_INTERFACE
)
1463 || dev
->dev_config
== GS_NO_CONFIG_ID
)
1465 if (wIndex
>= GS_MAX_NUM_INTERFACES
1466 || (dev
->dev_config
== GS_BULK_CONFIG_ID
1467 && wIndex
!= GS_BULK_INTERFACE_ID
)) {
1471 /* no alternate interface settings */
1472 *(u8
*)req
->buf
= 0;
1473 ret
= min(wLength
, (u16
)1);
1477 pr_err("gs_setup: unknown standard request, type=%02x, "
1478 "request=%02x, value=%04x, index=%04x, length=%d\n",
1479 ctrl
->bRequestType
, ctrl
->bRequest
,
1480 wValue
, wIndex
, wLength
);
1487 static void gs_setup_complete_set_line_coding(struct usb_ep
*ep
,
1488 struct usb_request
*req
)
1490 struct gs_dev
*dev
= ep
->driver_data
;
1491 struct gs_port
*port
= dev
->dev_port
[0]; /* ACM only has one port */
1493 switch (req
->status
) {
1495 /* normal completion */
1496 if (req
->actual
!= sizeof(port
->port_line_coding
))
1497 usb_ep_set_halt(ep
);
1499 struct usb_cdc_line_coding
*value
= req
->buf
;
1501 /* REVISIT: we currently just remember this data.
1502 * If we change that, (a) validate it first, then
1503 * (b) update whatever hardware needs updating.
1505 spin_lock(&port
->port_lock
);
1506 port
->port_line_coding
= *value
;
1507 spin_unlock(&port
->port_lock
);
1513 gs_free_req(ep
, req
);
1523 static int gs_setup_class(struct usb_gadget
*gadget
,
1524 const struct usb_ctrlrequest
*ctrl
)
1526 int ret
= -EOPNOTSUPP
;
1527 struct gs_dev
*dev
= get_gadget_data(gadget
);
1528 struct gs_port
*port
= dev
->dev_port
[0]; /* ACM only has one port */
1529 struct usb_request
*req
= dev
->dev_ctrl_req
;
1530 u16 wIndex
= le16_to_cpu(ctrl
->wIndex
);
1531 u16 wValue
= le16_to_cpu(ctrl
->wValue
);
1532 u16 wLength
= le16_to_cpu(ctrl
->wLength
);
1534 switch (ctrl
->bRequest
) {
1535 case USB_CDC_REQ_SET_LINE_CODING
:
1536 if (wLength
!= sizeof(struct usb_cdc_line_coding
))
1539 req
->complete
= gs_setup_complete_set_line_coding
;
1542 case USB_CDC_REQ_GET_LINE_CODING
:
1543 ret
= min_t(int, wLength
, sizeof(struct usb_cdc_line_coding
));
1545 spin_lock(&port
->port_lock
);
1546 memcpy(req
->buf
, &port
->port_line_coding
, ret
);
1547 spin_unlock(&port
->port_lock
);
1551 case USB_CDC_REQ_SET_CONTROL_LINE_STATE
:
1556 /* REVISIT: we currently just remember this data.
1557 * If we change that, update whatever hardware needs
1560 spin_lock(&port
->port_lock
);
1561 port
->port_handshake_bits
= wValue
;
1562 spin_unlock(&port
->port_lock
);
1567 /* NOTE: strictly speaking, we should accept AT-commands
1568 * using SEND_ENCPSULATED_COMMAND/GET_ENCAPSULATED_RESPONSE.
1569 * But our call management descriptor says we don't handle
1570 * call management, so we should be able to get by without
1571 * handling those "required" commands (except by stalling).
1573 pr_err("gs_setup: unknown class request, "
1574 "type=%02x, request=%02x, value=%04x, "
1575 "index=%04x, length=%d\n",
1576 ctrl
->bRequestType
, ctrl
->bRequest
,
1577 wValue
, wIndex
, wLength
);
1587 static void gs_setup_complete(struct usb_ep
*ep
, struct usb_request
*req
)
1589 if (req
->status
|| req
->actual
!= req
->length
) {
1590 pr_err("gs_setup_complete: status error, status=%d, "
1591 "actual=%d, length=%d\n",
1592 req
->status
, req
->actual
, req
->length
);
1599 * Implements all the control endpoint functionality that's not
1600 * handled in hardware or the hardware driver.
1602 * Returns the size of the data sent to the host, or a negative
1605 static int gs_setup(struct usb_gadget
*gadget
,
1606 const struct usb_ctrlrequest
*ctrl
)
1608 int ret
= -EOPNOTSUPP
;
1609 struct gs_dev
*dev
= get_gadget_data(gadget
);
1610 struct usb_request
*req
= dev
->dev_ctrl_req
;
1611 u16 wIndex
= le16_to_cpu(ctrl
->wIndex
);
1612 u16 wValue
= le16_to_cpu(ctrl
->wValue
);
1613 u16 wLength
= le16_to_cpu(ctrl
->wLength
);
1615 req
->complete
= gs_setup_complete
;
1617 switch (ctrl
->bRequestType
& USB_TYPE_MASK
) {
1618 case USB_TYPE_STANDARD
:
1619 ret
= gs_setup_standard(gadget
, ctrl
);
1622 case USB_TYPE_CLASS
:
1623 ret
= gs_setup_class(gadget
, ctrl
);
1627 pr_err("gs_setup: unknown request, type=%02x, request=%02x, "
1628 "value=%04x, index=%04x, length=%d\n",
1629 ctrl
->bRequestType
, ctrl
->bRequest
,
1630 wValue
, wIndex
, wLength
);
1634 /* respond with data transfer before status phase? */
1637 req
->zero
= ret
< wLength
1638 && (ret
% gadget
->ep0
->maxpacket
) == 0;
1639 ret
= usb_ep_queue(gadget
->ep0
, req
, GFP_ATOMIC
);
1641 pr_err("gs_setup: cannot queue response, ret=%d\n",
1644 gs_setup_complete(gadget
->ep0
, req
);
1648 /* device either stalls (ret < 0) or reports success */
1655 * Called when the device is disconnected. Frees the closed
1656 * ports and disconnects open ports. Open ports will be freed
1657 * on close. Then reallocates the ports for the next connection.
1659 static void gs_disconnect(struct usb_gadget
*gadget
)
1661 unsigned long flags
;
1662 struct gs_dev
*dev
= get_gadget_data(gadget
);
1664 spin_lock_irqsave(&dev
->dev_lock
, flags
);
1666 gs_reset_config(dev
);
1668 /* free closed ports and disconnect open ports */
1669 /* (open ports will be freed when closed) */
1672 /* re-allocate ports for the next connection */
1673 if (gs_alloc_ports(dev
, GFP_ATOMIC
) != 0)
1674 pr_err("gs_disconnect: cannot re-allocate ports\n");
1676 spin_unlock_irqrestore(&dev
->dev_lock
, flags
);
1678 pr_info("gs_disconnect: %s disconnected\n", GS_LONG_NAME
);
1681 static struct usb_gadget_driver gs_gadget_driver
= {
1682 #ifdef CONFIG_USB_GADGET_DUALSPEED
1683 .speed
= USB_SPEED_HIGH
,
1685 .speed
= USB_SPEED_FULL
,
1686 #endif /* CONFIG_USB_GADGET_DUALSPEED */
1687 .function
= GS_LONG_NAME
,
1689 .unbind
= gs_unbind
,
1691 .disconnect
= gs_disconnect
,
1693 .name
= GS_SHORT_NAME
,
1694 .owner
= THIS_MODULE
,
1701 * Configures the device by enabling device specific
1702 * optimizations, setting up the endpoints, allocating
1703 * read and write requests and queuing read requests.
1705 * The device lock must be held when calling this function.
1707 static int gs_set_config(struct gs_dev
*dev
, unsigned config
)
1711 struct usb_gadget
*gadget
= dev
->dev_gadget
;
1713 struct usb_endpoint_descriptor
*ep_desc
;
1714 struct usb_request
*req
;
1717 pr_err("gs_set_config: NULL device pointer\n");
1721 if (config
== dev
->dev_config
)
1724 gs_reset_config(dev
);
1727 case GS_NO_CONFIG_ID
:
1729 case GS_BULK_CONFIG_ID
:
1733 case GS_ACM_CONFIG_ID
:
1741 dev
->dev_config
= config
;
1743 gadget_for_each_ep(ep
, gadget
) {
1746 && strcmp(ep
->name
, EP_NOTIFY_NAME
) == 0) {
1747 ep_desc
= choose_ep_desc(gadget
,
1748 &gs_highspeed_notify_desc
,
1749 &gs_fullspeed_notify_desc
);
1750 ret
= usb_ep_enable(ep
,ep_desc
);
1752 ep
->driver_data
= dev
;
1753 dev
->dev_notify_ep
= ep
;
1754 dev
->dev_notify_ep_desc
= ep_desc
;
1756 pr_err("gs_set_config: cannot enable NOTIFY "
1757 "endpoint %s, ret=%d\n",
1759 goto exit_reset_config
;
1763 else if (strcmp(ep
->name
, EP_IN_NAME
) == 0) {
1764 ep_desc
= choose_ep_desc(gadget
,
1765 &gs_highspeed_in_desc
,
1766 &gs_fullspeed_in_desc
);
1767 ret
= usb_ep_enable(ep
,ep_desc
);
1769 ep
->driver_data
= dev
;
1770 dev
->dev_in_ep
= ep
;
1771 dev
->dev_in_ep_desc
= ep_desc
;
1773 pr_err("gs_set_config: cannot enable IN "
1774 "endpoint %s, ret=%d\n",
1776 goto exit_reset_config
;
1780 else if (strcmp(ep
->name
, EP_OUT_NAME
) == 0) {
1781 ep_desc
= choose_ep_desc(gadget
,
1782 &gs_highspeed_out_desc
,
1783 &gs_fullspeed_out_desc
);
1784 ret
= usb_ep_enable(ep
,ep_desc
);
1786 ep
->driver_data
= dev
;
1787 dev
->dev_out_ep
= ep
;
1788 dev
->dev_out_ep_desc
= ep_desc
;
1790 pr_err("gs_set_config: cannot enable OUT "
1791 "endpoint %s, ret=%d\n",
1793 goto exit_reset_config
;
1799 if (dev
->dev_in_ep
== NULL
|| dev
->dev_out_ep
== NULL
1800 || (config
!= GS_BULK_CONFIG_ID
&& dev
->dev_notify_ep
== NULL
)) {
1801 pr_err("gs_set_config: cannot find endpoints\n");
1803 goto exit_reset_config
;
1806 /* allocate and queue read requests */
1807 ep
= dev
->dev_out_ep
;
1808 for (i
=0; i
<read_q_size
&& ret
== 0; i
++) {
1809 if ((req
=gs_alloc_req(ep
, ep
->maxpacket
, GFP_ATOMIC
))) {
1810 req
->complete
= gs_read_complete
;
1811 if ((ret
=usb_ep_queue(ep
, req
, GFP_ATOMIC
))) {
1812 pr_err("gs_set_config: cannot queue read "
1813 "request, ret=%d\n", ret
);
1816 pr_err("gs_set_config: cannot allocate "
1819 goto exit_reset_config
;
1823 /* allocate write requests, and put on free list */
1824 ep
= dev
->dev_in_ep
;
1825 for (i
=0; i
<write_q_size
; i
++) {
1826 req
= gs_alloc_req(ep
, ep
->maxpacket
, GFP_ATOMIC
);
1828 req
->complete
= gs_write_complete
;
1829 list_add(&req
->list
, &dev
->dev_req_list
);
1831 pr_err("gs_set_config: cannot allocate "
1832 "write requests\n");
1834 goto exit_reset_config
;
1838 /* REVISIT the ACM mode should be able to actually *issue* some
1839 * notifications, for at least serial state change events if
1840 * not also for network connection; say so in bmCapabilities.
1843 pr_info("gs_set_config: %s configured, %s speed %s config\n",
1845 gadget
->speed
== USB_SPEED_HIGH
? "high" : "full",
1846 config
== GS_BULK_CONFIG_ID
? "BULK" : "CDC-ACM");
1851 gs_reset_config(dev
);
1858 * Mark the device as not configured, disable all endpoints,
1859 * which forces completion of pending I/O and frees queued
1860 * requests, and free the remaining write requests on the
1863 * The device lock must be held when calling this function.
1865 static void gs_reset_config(struct gs_dev
*dev
)
1867 struct usb_request
*req
;
1870 pr_err("gs_reset_config: NULL device pointer\n");
1874 if (dev
->dev_config
== GS_NO_CONFIG_ID
)
1877 dev
->dev_config
= GS_NO_CONFIG_ID
;
1879 /* free write requests on the free list */
1880 while(!list_empty(&dev
->dev_req_list
)) {
1881 req
= list_entry(dev
->dev_req_list
.next
,
1882 struct usb_request
, list
);
1883 list_del(&req
->list
);
1884 gs_free_req(dev
->dev_in_ep
, req
);
1887 /* disable endpoints, forcing completion of pending i/o; */
1888 /* completion handlers free their requests in this case */
1889 if (dev
->dev_notify_ep
) {
1890 usb_ep_disable(dev
->dev_notify_ep
);
1891 dev
->dev_notify_ep
= NULL
;
1893 if (dev
->dev_in_ep
) {
1894 usb_ep_disable(dev
->dev_in_ep
);
1895 dev
->dev_in_ep
= NULL
;
1897 if (dev
->dev_out_ep
) {
1898 usb_ep_disable(dev
->dev_out_ep
);
1899 dev
->dev_out_ep
= NULL
;
1904 * gs_build_config_buf
1906 * Builds the config descriptors in the given buffer and returns the
1907 * length, or a negative error number.
1909 static int gs_build_config_buf(u8
*buf
, struct usb_gadget
*g
,
1910 u8 type
, unsigned int index
, int is_otg
)
1914 const struct usb_config_descriptor
*config_desc
;
1915 const struct usb_descriptor_header
**function
;
1917 if (index
>= gs_device_desc
.bNumConfigurations
)
1920 /* other speed switches high and full speed */
1921 if (gadget_is_dualspeed(g
)) {
1922 high_speed
= (g
->speed
== USB_SPEED_HIGH
);
1923 if (type
== USB_DT_OTHER_SPEED_CONFIG
)
1924 high_speed
= !high_speed
;
1928 config_desc
= &gs_acm_config_desc
;
1929 function
= high_speed
1930 ? gs_acm_highspeed_function
1931 : gs_acm_fullspeed_function
;
1933 config_desc
= &gs_bulk_config_desc
;
1934 function
= high_speed
1935 ? gs_bulk_highspeed_function
1936 : gs_bulk_fullspeed_function
;
1939 /* for now, don't advertise srp-only devices */
1943 len
= usb_gadget_config_buf(config_desc
, buf
, GS_MAX_DESC_LEN
, function
);
1947 ((struct usb_config_descriptor
*)buf
)->bDescriptorType
= type
;
1955 * Allocate a usb_request and its buffer. Returns a pointer to the
1956 * usb_request or NULL if there is an error.
1958 static struct usb_request
*
1959 gs_alloc_req(struct usb_ep
*ep
, unsigned int len
, gfp_t kmalloc_flags
)
1961 struct usb_request
*req
;
1966 req
= usb_ep_alloc_request(ep
, kmalloc_flags
);
1970 req
->buf
= kmalloc(len
, kmalloc_flags
);
1971 if (req
->buf
== NULL
) {
1972 usb_ep_free_request(ep
, req
);
1983 * Free a usb_request and its buffer.
1985 static void gs_free_req(struct usb_ep
*ep
, struct usb_request
*req
)
1987 if (ep
!= NULL
&& req
!= NULL
) {
1989 usb_ep_free_request(ep
, req
);
1996 * Allocate all ports and set the gs_dev struct to point to them.
1997 * Return 0 if successful, or a negative error number.
1999 * The device lock is normally held when calling this function.
2001 static int gs_alloc_ports(struct gs_dev
*dev
, gfp_t kmalloc_flags
)
2004 struct gs_port
*port
;
2009 for (i
=0; i
<GS_NUM_PORTS
; i
++) {
2010 if ((port
=kzalloc(sizeof(struct gs_port
), kmalloc_flags
)) == NULL
)
2013 port
->port_dev
= dev
;
2015 port
->port_line_coding
.dwDTERate
= cpu_to_le32(GS_DEFAULT_DTE_RATE
);
2016 port
->port_line_coding
.bCharFormat
= GS_DEFAULT_CHAR_FORMAT
;
2017 port
->port_line_coding
.bParityType
= GS_DEFAULT_PARITY
;
2018 port
->port_line_coding
.bDataBits
= GS_DEFAULT_DATA_BITS
;
2019 spin_lock_init(&port
->port_lock
);
2020 init_waitqueue_head(&port
->port_write_wait
);
2022 dev
->dev_port
[i
] = port
;
2031 * Free all closed ports. Open ports are disconnected by
2032 * freeing their write buffers, setting their device pointers
2033 * and the pointers to them in the device to NULL. These
2034 * ports will be freed when closed.
2036 * The device lock is normally held when calling this function.
2038 static void gs_free_ports(struct gs_dev
*dev
)
2041 unsigned long flags
;
2042 struct gs_port
*port
;
2047 for (i
=0; i
<GS_NUM_PORTS
; i
++) {
2048 if ((port
=dev
->dev_port
[i
]) != NULL
) {
2049 dev
->dev_port
[i
] = NULL
;
2051 spin_lock_irqsave(&port
->port_lock
, flags
);
2053 if (port
->port_write_buf
!= NULL
) {
2054 gs_buf_free(port
->port_write_buf
);
2055 port
->port_write_buf
= NULL
;
2058 if (port
->port_open_count
> 0 || port
->port_in_use
) {
2059 port
->port_dev
= NULL
;
2060 wake_up_interruptible(&port
->port_write_wait
);
2061 if (port
->port_tty
) {
2062 tty_hangup(port
->port_tty
);
2064 spin_unlock_irqrestore(&port
->port_lock
, flags
);
2066 spin_unlock_irqrestore(&port
->port_lock
, flags
);
2074 /*-------------------------------------------------------------------------*/
2076 /* Circular Buffer */
2081 * Allocate a circular buffer and all associated memory.
2083 static struct gs_buf
*gs_buf_alloc(unsigned int size
, gfp_t kmalloc_flags
)
2090 gb
= kmalloc(sizeof(struct gs_buf
), kmalloc_flags
);
2094 gb
->buf_buf
= kmalloc(size
, kmalloc_flags
);
2095 if (gb
->buf_buf
== NULL
) {
2100 gb
->buf_size
= size
;
2101 gb
->buf_get
= gb
->buf_put
= gb
->buf_buf
;
2109 * Free the buffer and all associated memory.
2111 static void gs_buf_free(struct gs_buf
*gb
)
2122 * Clear out all data in the circular buffer.
2124 static void gs_buf_clear(struct gs_buf
*gb
)
2127 gb
->buf_get
= gb
->buf_put
;
2128 /* equivalent to a get of all data available */
2134 * Return the number of bytes of data available in the circular
2137 static unsigned int gs_buf_data_avail(struct gs_buf
*gb
)
2140 return (gb
->buf_size
+ gb
->buf_put
- gb
->buf_get
) % gb
->buf_size
;
2146 * gs_buf_space_avail
2148 * Return the number of bytes of space available in the circular
2151 static unsigned int gs_buf_space_avail(struct gs_buf
*gb
)
2154 return (gb
->buf_size
+ gb
->buf_get
- gb
->buf_put
- 1) % gb
->buf_size
;
2162 * Copy data data from a user buffer and put it into the circular buffer.
2163 * Restrict to the amount of space available.
2165 * Return the number of bytes copied.
2168 gs_buf_put(struct gs_buf
*gb
, const char *buf
, unsigned int count
)
2175 len
= gs_buf_space_avail(gb
);
2182 len
= gb
->buf_buf
+ gb
->buf_size
- gb
->buf_put
;
2184 memcpy(gb
->buf_put
, buf
, len
);
2185 memcpy(gb
->buf_buf
, buf
+len
, count
- len
);
2186 gb
->buf_put
= gb
->buf_buf
+ count
- len
;
2188 memcpy(gb
->buf_put
, buf
, count
);
2190 gb
->buf_put
+= count
;
2191 else /* count == len */
2192 gb
->buf_put
= gb
->buf_buf
;
2201 * Get data from the circular buffer and copy to the given buffer.
2202 * Restrict to the amount of data available.
2204 * Return the number of bytes copied.
2207 gs_buf_get(struct gs_buf
*gb
, char *buf
, unsigned int count
)
2214 len
= gs_buf_data_avail(gb
);
2221 len
= gb
->buf_buf
+ gb
->buf_size
- gb
->buf_get
;
2223 memcpy(buf
, gb
->buf_get
, len
);
2224 memcpy(buf
+len
, gb
->buf_buf
, count
- len
);
2225 gb
->buf_get
= gb
->buf_buf
+ count
- len
;
2227 memcpy(buf
, gb
->buf_get
, count
);
2229 gb
->buf_get
+= count
;
2230 else /* count == len */
2231 gb
->buf_get
= gb
->buf_buf
;
2237 /*-------------------------------------------------------------------------*/
2239 static struct tty_driver
*gs_tty_driver
;
2244 * Register as a USB gadget driver and a tty driver.
2246 static int __init
gs_module_init(void)
2251 retval
= usb_gadget_register_driver(&gs_gadget_driver
);
2253 pr_err("gs_module_init: cannot register gadget driver, "
2254 "ret=%d\n", retval
);
2258 gs_tty_driver
= alloc_tty_driver(GS_NUM_PORTS
);
2261 gs_tty_driver
->owner
= THIS_MODULE
;
2262 gs_tty_driver
->driver_name
= GS_SHORT_NAME
;
2263 gs_tty_driver
->name
= "ttygs";
2264 gs_tty_driver
->major
= GS_MAJOR
;
2265 gs_tty_driver
->minor_start
= GS_MINOR_START
;
2266 gs_tty_driver
->type
= TTY_DRIVER_TYPE_SERIAL
;
2267 gs_tty_driver
->subtype
= SERIAL_TYPE_NORMAL
;
2268 gs_tty_driver
->flags
= TTY_DRIVER_REAL_RAW
| TTY_DRIVER_DYNAMIC_DEV
;
2269 gs_tty_driver
->init_termios
= tty_std_termios
;
2270 /* must match GS_DEFAULT_DTE_RATE and friends */
2271 gs_tty_driver
->init_termios
.c_cflag
=
2272 B9600
| CS8
| CREAD
| HUPCL
| CLOCAL
;
2273 gs_tty_driver
->init_termios
.c_ispeed
= GS_DEFAULT_DTE_RATE
;
2274 gs_tty_driver
->init_termios
.c_ospeed
= GS_DEFAULT_DTE_RATE
;
2275 tty_set_operations(gs_tty_driver
, &gs_tty_ops
);
2277 for (i
= 0; i
< GS_NUM_PORTS
; i
++)
2278 mutex_init(&gs_open_close_lock
[i
]);
2280 retval
= tty_register_driver(gs_tty_driver
);
2282 usb_gadget_unregister_driver(&gs_gadget_driver
);
2283 put_tty_driver(gs_tty_driver
);
2284 pr_err("gs_module_init: cannot register tty driver, "
2285 "ret=%d\n", retval
);
2289 pr_info("gs_module_init: %s %s loaded\n",
2290 GS_LONG_NAME
, GS_VERSION_STR
);
2293 module_init(gs_module_init
);
2298 * Unregister as a tty driver and a USB gadget driver.
2300 static void __exit
gs_module_exit(void)
2302 tty_unregister_driver(gs_tty_driver
);
2303 put_tty_driver(gs_tty_driver
);
2304 usb_gadget_unregister_driver(&gs_gadget_driver
);
2306 pr_info("gs_module_exit: %s %s unloaded\n",
2307 GS_LONG_NAME
, GS_VERSION_STR
);
2309 module_exit(gs_module_exit
);