1 // SPDX-License-Identifier: GPL-2.0
2 /*
3 USB Driver layer for GSM modems
4
5 Copyright (C) 2005 Matthias Urlichs <smurf@smurf.noris.de>
6
7 Portions copied from the Keyspan driver by Hugh Blemings <hugh@blemings.org>
8
9 History: see the git log.
10
11 Work sponsored by: Sigos GmbH, Germany <info@sigos.de>
12
13 This driver exists because the "normal" serial driver doesn't work too well
14 with GSM modems. Issues:
15 - data loss -- one single Receive URB is not nearly enough
16 - controlling the baud rate doesn't make sense
17 */
18
19 #define DRIVER_AUTHOR "Matthias Urlichs <smurf@smurf.noris.de>"
20 #define DRIVER_DESC "USB Driver for GSM modems"
21
22 #include <linux/kernel.h>
23 #include <linux/jiffies.h>
24 #include <linux/errno.h>
25 #include <linux/slab.h>
26 #include <linux/tty.h>
27 #include <linux/tty_flip.h>
28 #include <linux/module.h>
29 #include <linux/bitops.h>
30 #include <linux/uaccess.h>
31 #include <linux/usb.h>
32 #include <linux/usb/serial.h>
33 #include <linux/serial.h>
34 #include "usb-wwan.h"
35
36 /*
37 * Generate DTR/RTS signals on the port using the SET_CONTROL_LINE_STATE request
38 * in CDC ACM.
39 */
usb_wwan_send_setup(struct usb_serial_port * port)40 static int usb_wwan_send_setup(struct usb_serial_port *port)
41 {
42 struct usb_serial *serial = port->serial;
43 struct usb_wwan_port_private *portdata;
44 int val = 0;
45 int ifnum;
46 int res;
47
48 portdata = usb_get_serial_port_data(port);
49
50 if (portdata->dtr_state)
51 val |= 0x01;
52 if (portdata->rts_state)
53 val |= 0x02;
54
55 ifnum = serial->interface->cur_altsetting->desc.bInterfaceNumber;
56
57 res = usb_autopm_get_interface(serial->interface);
58 if (res)
59 return res;
60
61 res = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
62 0x22, 0x21, val, ifnum, NULL, 0,
63 USB_CTRL_SET_TIMEOUT);
64
65 usb_autopm_put_interface(port->serial->interface);
66
67 return res;
68 }
69
usb_wwan_dtr_rts(struct usb_serial_port * port,int on)70 void usb_wwan_dtr_rts(struct usb_serial_port *port, int on)
71 {
72 struct usb_wwan_port_private *portdata;
73 struct usb_wwan_intf_private *intfdata;
74
75 intfdata = usb_get_serial_data(port->serial);
76
77 if (!intfdata->use_send_setup)
78 return;
79
80 portdata = usb_get_serial_port_data(port);
81 /* FIXME: locking */
82 portdata->rts_state = on;
83 portdata->dtr_state = on;
84
85 usb_wwan_send_setup(port);
86 }
87 EXPORT_SYMBOL(usb_wwan_dtr_rts);
88
usb_wwan_tiocmget(struct tty_struct * tty)89 int usb_wwan_tiocmget(struct tty_struct *tty)
90 {
91 struct usb_serial_port *port = tty->driver_data;
92 unsigned int value;
93 struct usb_wwan_port_private *portdata;
94
95 portdata = usb_get_serial_port_data(port);
96
97 value = ((portdata->rts_state) ? TIOCM_RTS : 0) |
98 ((portdata->dtr_state) ? TIOCM_DTR : 0) |
99 ((portdata->cts_state) ? TIOCM_CTS : 0) |
100 ((portdata->dsr_state) ? TIOCM_DSR : 0) |
101 ((portdata->dcd_state) ? TIOCM_CAR : 0) |
102 ((portdata->ri_state) ? TIOCM_RNG : 0);
103
104 return value;
105 }
106 EXPORT_SYMBOL(usb_wwan_tiocmget);
107
usb_wwan_tiocmset(struct tty_struct * tty,unsigned int set,unsigned int clear)108 int usb_wwan_tiocmset(struct tty_struct *tty,
109 unsigned int set, unsigned int clear)
110 {
111 struct usb_serial_port *port = tty->driver_data;
112 struct usb_wwan_port_private *portdata;
113 struct usb_wwan_intf_private *intfdata;
114
115 portdata = usb_get_serial_port_data(port);
116 intfdata = usb_get_serial_data(port->serial);
117
118 if (!intfdata->use_send_setup)
119 return -EINVAL;
120
121 /* FIXME: what locks portdata fields ? */
122 if (set & TIOCM_RTS)
123 portdata->rts_state = 1;
124 if (set & TIOCM_DTR)
125 portdata->dtr_state = 1;
126
127 if (clear & TIOCM_RTS)
128 portdata->rts_state = 0;
129 if (clear & TIOCM_DTR)
130 portdata->dtr_state = 0;
131 return usb_wwan_send_setup(port);
132 }
133 EXPORT_SYMBOL(usb_wwan_tiocmset);
134
usb_wwan_write(struct tty_struct * tty,struct usb_serial_port * port,const unsigned char * buf,int count)135 int usb_wwan_write(struct tty_struct *tty, struct usb_serial_port *port,
136 const unsigned char *buf, int count)
137 {
138 struct usb_wwan_port_private *portdata;
139 struct usb_wwan_intf_private *intfdata;
140 int i;
141 int left, todo;
142 struct urb *this_urb = NULL; /* spurious */
143 int err;
144 unsigned long flags;
145
146 portdata = usb_get_serial_port_data(port);
147 intfdata = usb_get_serial_data(port->serial);
148
149 dev_dbg(&port->dev, "%s: write (%d chars)\n", __func__, count);
150
151 left = count;
152 for (i = 0; left > 0 && i < N_OUT_URB; i++) {
153 todo = left;
154 if (todo > OUT_BUFLEN)
155 todo = OUT_BUFLEN;
156
157 this_urb = portdata->out_urbs[i];
158 if (test_and_set_bit(i, &portdata->out_busy)) {
159 if (time_before(jiffies,
160 portdata->tx_start_time[i] + 10 * HZ))
161 continue;
162 usb_unlink_urb(this_urb);
163 continue;
164 }
165 dev_dbg(&port->dev, "%s: endpoint %d buf %d\n", __func__,
166 usb_pipeendpoint(this_urb->pipe), i);
167
168 err = usb_autopm_get_interface_async(port->serial->interface);
169 if (err < 0) {
170 clear_bit(i, &portdata->out_busy);
171 break;
172 }
173
174 /* send the data */
175 memcpy(this_urb->transfer_buffer, buf, todo);
176 this_urb->transfer_buffer_length = todo;
177
178 spin_lock_irqsave(&intfdata->susp_lock, flags);
179 if (intfdata->suspended) {
180 usb_anchor_urb(this_urb, &portdata->delayed);
181 spin_unlock_irqrestore(&intfdata->susp_lock, flags);
182 } else {
183 intfdata->in_flight++;
184 spin_unlock_irqrestore(&intfdata->susp_lock, flags);
185 err = usb_submit_urb(this_urb, GFP_ATOMIC);
186 if (err) {
187 dev_err(&port->dev,
188 "%s: submit urb %d failed: %d\n",
189 __func__, i, err);
190 clear_bit(i, &portdata->out_busy);
191 spin_lock_irqsave(&intfdata->susp_lock, flags);
192 intfdata->in_flight--;
193 spin_unlock_irqrestore(&intfdata->susp_lock,
194 flags);
195 usb_autopm_put_interface_async(port->serial->interface);
196 break;
197 }
198 }
199
200 portdata->tx_start_time[i] = jiffies;
201 buf += todo;
202 left -= todo;
203 }
204
205 count -= left;
206 dev_dbg(&port->dev, "%s: wrote (did %d)\n", __func__, count);
207 return count;
208 }
209 EXPORT_SYMBOL(usb_wwan_write);
210
usb_wwan_indat_callback(struct urb * urb)211 static void usb_wwan_indat_callback(struct urb *urb)
212 {
213 int err;
214 int endpoint;
215 struct usb_serial_port *port;
216 struct device *dev;
217 unsigned char *data = urb->transfer_buffer;
218 int status = urb->status;
219
220 endpoint = usb_pipeendpoint(urb->pipe);
221 port = urb->context;
222 dev = &port->dev;
223
224 if (status) {
225 dev_dbg(dev, "%s: nonzero status: %d on endpoint %02x.\n",
226 __func__, status, endpoint);
227
228 /* don't resubmit on fatal errors */
229 if (status == -ESHUTDOWN || status == -ENOENT)
230 return;
231 } else {
232 if (urb->actual_length) {
233 tty_insert_flip_string(&port->port, data,
234 urb->actual_length);
235 tty_flip_buffer_push(&port->port);
236 } else
237 dev_dbg(dev, "%s: empty read urb received\n", __func__);
238 }
239 /* Resubmit urb so we continue receiving */
240 err = usb_submit_urb(urb, GFP_ATOMIC);
241 if (err) {
242 if (err != -EPERM && err != -ENODEV) {
243 dev_err(dev, "%s: resubmit read urb failed. (%d)\n",
244 __func__, err);
245 /* busy also in error unless we are killed */
246 usb_mark_last_busy(port->serial->dev);
247 }
248 } else {
249 usb_mark_last_busy(port->serial->dev);
250 }
251 }
252
usb_wwan_outdat_callback(struct urb * urb)253 static void usb_wwan_outdat_callback(struct urb *urb)
254 {
255 struct usb_serial_port *port;
256 struct usb_wwan_port_private *portdata;
257 struct usb_wwan_intf_private *intfdata;
258 unsigned long flags;
259 int i;
260
261 port = urb->context;
262 intfdata = usb_get_serial_data(port->serial);
263
264 usb_serial_port_softint(port);
265 usb_autopm_put_interface_async(port->serial->interface);
266 portdata = usb_get_serial_port_data(port);
267 spin_lock_irqsave(&intfdata->susp_lock, flags);
268 intfdata->in_flight--;
269 spin_unlock_irqrestore(&intfdata->susp_lock, flags);
270
271 for (i = 0; i < N_OUT_URB; ++i) {
272 if (portdata->out_urbs[i] == urb) {
273 smp_mb__before_atomic();
274 clear_bit(i, &portdata->out_busy);
275 break;
276 }
277 }
278 }
279
usb_wwan_write_room(struct tty_struct * tty)280 unsigned int usb_wwan_write_room(struct tty_struct *tty)
281 {
282 struct usb_serial_port *port = tty->driver_data;
283 struct usb_wwan_port_private *portdata;
284 int i;
285 unsigned int data_len = 0;
286 struct urb *this_urb;
287
288 portdata = usb_get_serial_port_data(port);
289
290 for (i = 0; i < N_OUT_URB; i++) {
291 this_urb = portdata->out_urbs[i];
292 if (this_urb && !test_bit(i, &portdata->out_busy))
293 data_len += OUT_BUFLEN;
294 }
295
296 dev_dbg(&port->dev, "%s: %u\n", __func__, data_len);
297 return data_len;
298 }
299 EXPORT_SYMBOL(usb_wwan_write_room);
300
usb_wwan_chars_in_buffer(struct tty_struct * tty)301 unsigned int usb_wwan_chars_in_buffer(struct tty_struct *tty)
302 {
303 struct usb_serial_port *port = tty->driver_data;
304 struct usb_wwan_port_private *portdata;
305 int i;
306 unsigned int data_len = 0;
307 struct urb *this_urb;
308
309 portdata = usb_get_serial_port_data(port);
310
311 for (i = 0; i < N_OUT_URB; i++) {
312 this_urb = portdata->out_urbs[i];
313 /* FIXME: This locking is insufficient as this_urb may
314 go unused during the test */
315 if (this_urb && test_bit(i, &portdata->out_busy))
316 data_len += this_urb->transfer_buffer_length;
317 }
318 dev_dbg(&port->dev, "%s: %u\n", __func__, data_len);
319 return data_len;
320 }
321 EXPORT_SYMBOL(usb_wwan_chars_in_buffer);
322
usb_wwan_open(struct tty_struct * tty,struct usb_serial_port * port)323 int usb_wwan_open(struct tty_struct *tty, struct usb_serial_port *port)
324 {
325 struct usb_wwan_port_private *portdata;
326 struct usb_wwan_intf_private *intfdata;
327 struct usb_serial *serial = port->serial;
328 int i, err;
329 struct urb *urb;
330
331 portdata = usb_get_serial_port_data(port);
332 intfdata = usb_get_serial_data(serial);
333
334 if (port->interrupt_in_urb) {
335 err = usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL);
336 if (err) {
337 dev_err(&port->dev, "%s: submit int urb failed: %d\n",
338 __func__, err);
339 }
340 }
341
342 /* Start reading from the IN endpoint */
343 for (i = 0; i < N_IN_URB; i++) {
344 urb = portdata->in_urbs[i];
345 if (!urb)
346 continue;
347 err = usb_submit_urb(urb, GFP_KERNEL);
348 if (err) {
349 dev_err(&port->dev,
350 "%s: submit read urb %d failed: %d\n",
351 __func__, i, err);
352 }
353 }
354
355 spin_lock_irq(&intfdata->susp_lock);
356 if (++intfdata->open_ports == 1)
357 serial->interface->needs_remote_wakeup = 1;
358 spin_unlock_irq(&intfdata->susp_lock);
359 /* this balances a get in the generic USB serial code */
360 usb_autopm_put_interface(serial->interface);
361
362 return 0;
363 }
364 EXPORT_SYMBOL(usb_wwan_open);
365
unbusy_queued_urb(struct urb * urb,struct usb_wwan_port_private * portdata)366 static void unbusy_queued_urb(struct urb *urb,
367 struct usb_wwan_port_private *portdata)
368 {
369 int i;
370
371 for (i = 0; i < N_OUT_URB; i++) {
372 if (urb == portdata->out_urbs[i]) {
373 clear_bit(i, &portdata->out_busy);
374 break;
375 }
376 }
377 }
378
usb_wwan_close(struct usb_serial_port * port)379 void usb_wwan_close(struct usb_serial_port *port)
380 {
381 int i;
382 struct usb_serial *serial = port->serial;
383 struct usb_wwan_port_private *portdata;
384 struct usb_wwan_intf_private *intfdata = usb_get_serial_data(serial);
385 struct urb *urb;
386
387 portdata = usb_get_serial_port_data(port);
388
389 /*
390 * Need to take susp_lock to make sure port is not already being
391 * resumed, but no need to hold it due to the tty-port initialized
392 * flag.
393 */
394 spin_lock_irq(&intfdata->susp_lock);
395 if (--intfdata->open_ports == 0)
396 serial->interface->needs_remote_wakeup = 0;
397 spin_unlock_irq(&intfdata->susp_lock);
398
399 for (;;) {
400 urb = usb_get_from_anchor(&portdata->delayed);
401 if (!urb)
402 break;
403 unbusy_queued_urb(urb, portdata);
404 usb_autopm_put_interface_async(serial->interface);
405 }
406
407 for (i = 0; i < N_IN_URB; i++)
408 usb_kill_urb(portdata->in_urbs[i]);
409 for (i = 0; i < N_OUT_URB; i++)
410 usb_kill_urb(portdata->out_urbs[i]);
411 usb_kill_urb(port->interrupt_in_urb);
412
413 usb_autopm_get_interface_no_resume(serial->interface);
414 }
415 EXPORT_SYMBOL(usb_wwan_close);
416
usb_wwan_setup_urb(struct usb_serial_port * port,int endpoint,int dir,void * ctx,char * buf,int len,void (* callback)(struct urb *))417 static struct urb *usb_wwan_setup_urb(struct usb_serial_port *port,
418 int endpoint,
419 int dir, void *ctx, char *buf, int len,
420 void (*callback) (struct urb *))
421 {
422 struct usb_serial *serial = port->serial;
423 struct usb_wwan_intf_private *intfdata = usb_get_serial_data(serial);
424 struct urb *urb;
425
426 urb = usb_alloc_urb(0, GFP_KERNEL); /* No ISO */
427 if (!urb)
428 return NULL;
429
430 usb_fill_bulk_urb(urb, serial->dev,
431 usb_sndbulkpipe(serial->dev, endpoint) | dir,
432 buf, len, callback, ctx);
433
434 if (intfdata->use_zlp && dir == USB_DIR_OUT)
435 urb->transfer_flags |= URB_ZERO_PACKET;
436
437 return urb;
438 }
439
usb_wwan_port_probe(struct usb_serial_port * port)440 int usb_wwan_port_probe(struct usb_serial_port *port)
441 {
442 struct usb_wwan_port_private *portdata;
443 struct urb *urb;
444 u8 *buffer;
445 int i;
446
447 if (!port->bulk_in_size || !port->bulk_out_size)
448 return -ENODEV;
449
450 portdata = kzalloc(sizeof(*portdata), GFP_KERNEL);
451 if (!portdata)
452 return -ENOMEM;
453
454 init_usb_anchor(&portdata->delayed);
455
456 for (i = 0; i < N_IN_URB; i++) {
457 buffer = (u8 *)__get_free_page(GFP_KERNEL);
458 if (!buffer)
459 goto bail_out_error;
460 portdata->in_buffer[i] = buffer;
461
462 urb = usb_wwan_setup_urb(port, port->bulk_in_endpointAddress,
463 USB_DIR_IN, port,
464 buffer, IN_BUFLEN,
465 usb_wwan_indat_callback);
466 portdata->in_urbs[i] = urb;
467 }
468
469 for (i = 0; i < N_OUT_URB; i++) {
470 buffer = kmalloc(OUT_BUFLEN, GFP_KERNEL);
471 if (!buffer)
472 goto bail_out_error2;
473 portdata->out_buffer[i] = buffer;
474
475 urb = usb_wwan_setup_urb(port, port->bulk_out_endpointAddress,
476 USB_DIR_OUT, port,
477 buffer, OUT_BUFLEN,
478 usb_wwan_outdat_callback);
479 portdata->out_urbs[i] = urb;
480 }
481
482 usb_set_serial_port_data(port, portdata);
483
484 return 0;
485
486 bail_out_error2:
487 for (i = 0; i < N_OUT_URB; i++) {
488 usb_free_urb(portdata->out_urbs[i]);
489 kfree(portdata->out_buffer[i]);
490 }
491 bail_out_error:
492 for (i = 0; i < N_IN_URB; i++) {
493 usb_free_urb(portdata->in_urbs[i]);
494 free_page((unsigned long)portdata->in_buffer[i]);
495 }
496 kfree(portdata);
497
498 return -ENOMEM;
499 }
500 EXPORT_SYMBOL_GPL(usb_wwan_port_probe);
501
usb_wwan_port_remove(struct usb_serial_port * port)502 void usb_wwan_port_remove(struct usb_serial_port *port)
503 {
504 int i;
505 struct usb_wwan_port_private *portdata;
506
507 portdata = usb_get_serial_port_data(port);
508 usb_set_serial_port_data(port, NULL);
509
510 for (i = 0; i < N_IN_URB; i++) {
511 usb_free_urb(portdata->in_urbs[i]);
512 free_page((unsigned long)portdata->in_buffer[i]);
513 }
514 for (i = 0; i < N_OUT_URB; i++) {
515 usb_free_urb(portdata->out_urbs[i]);
516 kfree(portdata->out_buffer[i]);
517 }
518
519 kfree(portdata);
520 }
521 EXPORT_SYMBOL(usb_wwan_port_remove);
522
523 #ifdef CONFIG_PM
stop_urbs(struct usb_serial * serial)524 static void stop_urbs(struct usb_serial *serial)
525 {
526 int i, j;
527 struct usb_serial_port *port;
528 struct usb_wwan_port_private *portdata;
529
530 for (i = 0; i < serial->num_ports; ++i) {
531 port = serial->port[i];
532 portdata = usb_get_serial_port_data(port);
533 if (!portdata)
534 continue;
535 for (j = 0; j < N_IN_URB; j++)
536 usb_kill_urb(portdata->in_urbs[j]);
537 for (j = 0; j < N_OUT_URB; j++)
538 usb_kill_urb(portdata->out_urbs[j]);
539 usb_kill_urb(port->interrupt_in_urb);
540 }
541 }
542
usb_wwan_suspend(struct usb_serial * serial,pm_message_t message)543 int usb_wwan_suspend(struct usb_serial *serial, pm_message_t message)
544 {
545 struct usb_wwan_intf_private *intfdata = usb_get_serial_data(serial);
546
547 spin_lock_irq(&intfdata->susp_lock);
548 if (PMSG_IS_AUTO(message)) {
549 if (intfdata->in_flight) {
550 spin_unlock_irq(&intfdata->susp_lock);
551 return -EBUSY;
552 }
553 }
554 intfdata->suspended = 1;
555 spin_unlock_irq(&intfdata->susp_lock);
556
557 stop_urbs(serial);
558
559 return 0;
560 }
561 EXPORT_SYMBOL(usb_wwan_suspend);
562
563 /* Caller must hold susp_lock. */
usb_wwan_submit_delayed_urbs(struct usb_serial_port * port)564 static int usb_wwan_submit_delayed_urbs(struct usb_serial_port *port)
565 {
566 struct usb_serial *serial = port->serial;
567 struct usb_wwan_intf_private *data = usb_get_serial_data(serial);
568 struct usb_wwan_port_private *portdata;
569 struct urb *urb;
570 int err_count = 0;
571 int err;
572
573 portdata = usb_get_serial_port_data(port);
574
575 for (;;) {
576 urb = usb_get_from_anchor(&portdata->delayed);
577 if (!urb)
578 break;
579
580 err = usb_submit_urb(urb, GFP_ATOMIC);
581 if (err) {
582 dev_err(&port->dev, "%s: submit urb failed: %d\n",
583 __func__, err);
584 err_count++;
585 unbusy_queued_urb(urb, portdata);
586 usb_autopm_put_interface_async(serial->interface);
587 continue;
588 }
589 data->in_flight++;
590 }
591
592 if (err_count)
593 return -EIO;
594
595 return 0;
596 }
597
usb_wwan_resume(struct usb_serial * serial)598 int usb_wwan_resume(struct usb_serial *serial)
599 {
600 int i, j;
601 struct usb_serial_port *port;
602 struct usb_wwan_intf_private *intfdata = usb_get_serial_data(serial);
603 struct usb_wwan_port_private *portdata;
604 struct urb *urb;
605 int err;
606 int err_count = 0;
607
608 spin_lock_irq(&intfdata->susp_lock);
609 for (i = 0; i < serial->num_ports; i++) {
610 port = serial->port[i];
611
612 if (!tty_port_initialized(&port->port))
613 continue;
614
615 portdata = usb_get_serial_port_data(port);
616
617 if (port->interrupt_in_urb) {
618 err = usb_submit_urb(port->interrupt_in_urb,
619 GFP_ATOMIC);
620 if (err) {
621 dev_err(&port->dev,
622 "%s: submit int urb failed: %d\n",
623 __func__, err);
624 err_count++;
625 }
626 }
627
628 err = usb_wwan_submit_delayed_urbs(port);
629 if (err)
630 err_count++;
631
632 for (j = 0; j < N_IN_URB; j++) {
633 urb = portdata->in_urbs[j];
634 err = usb_submit_urb(urb, GFP_ATOMIC);
635 if (err < 0) {
636 dev_err(&port->dev,
637 "%s: submit read urb %d failed: %d\n",
638 __func__, i, err);
639 err_count++;
640 }
641 }
642 }
643 intfdata->suspended = 0;
644 spin_unlock_irq(&intfdata->susp_lock);
645
646 if (err_count)
647 return -EIO;
648
649 return 0;
650 }
651 EXPORT_SYMBOL(usb_wwan_resume);
652 #endif
653
654 MODULE_AUTHOR(DRIVER_AUTHOR);
655 MODULE_DESCRIPTION(DRIVER_DESC);
656 MODULE_LICENSE("GPL v2");
657