Linux Audio

Check our new training course

Linux kernel drivers training

Mar 31-Apr 9, 2025, special US time zones
Register
Loading...
v3.1
 
  1/*
  2 * usb-serial driver for Quatech SSU-100
  3 *
  4 * based on ftdi_sio.c and the original serqt_usb.c from Quatech
  5 *
  6 */
  7
  8#include <linux/errno.h>
  9#include <linux/init.h>
 10#include <linux/slab.h>
 11#include <linux/tty.h>
 12#include <linux/tty_driver.h>
 13#include <linux/tty_flip.h>
 14#include <linux/module.h>
 15#include <linux/serial.h>
 16#include <linux/usb.h>
 17#include <linux/usb/serial.h>
 18#include <linux/serial_reg.h>
 19#include <linux/uaccess.h>
 20
 21#define QT_OPEN_CLOSE_CHANNEL       0xca
 22#define QT_SET_GET_DEVICE           0xc2
 23#define QT_SET_GET_REGISTER         0xc0
 24#define QT_GET_SET_PREBUF_TRIG_LVL  0xcc
 25#define QT_SET_ATF                  0xcd
 26#define QT_GET_SET_UART             0xc1
 27#define QT_TRANSFER_IN              0xc0
 28#define QT_HW_FLOW_CONTROL_MASK     0xc5
 29#define QT_SW_FLOW_CONTROL_MASK     0xc6
 30
 31#define  SERIAL_MSR_MASK            0xf0
 32
 33#define  SERIAL_CRTSCTS ((UART_MCR_RTS << 8) | UART_MSR_CTS)
 34
 35#define  SERIAL_EVEN_PARITY         (UART_LCR_PARITY | UART_LCR_EPAR)
 36
 37#define  MAX_BAUD_RATE              460800
 38
 39#define ATC_DISABLED                0x00
 40#define DUPMODE_BITS        0xc0
 41#define RR_BITS             0x03
 42#define LOOPMODE_BITS       0x41
 43#define RS232_MODE          0x00
 44#define RTSCTS_TO_CONNECTOR 0x40
 45#define CLKS_X4             0x02
 46#define FULLPWRBIT          0x00000080
 47#define NEXT_BOARD_POWER_BIT        0x00000004
 48
 49static int debug;
 50
 51/* Version Information */
 52#define DRIVER_VERSION "v0.1"
 53#define DRIVER_DESC "Quatech SSU-100 USB to Serial Driver"
 54
 55#define	USB_VENDOR_ID_QUATECH	0x061d	/* Quatech VID */
 56#define QUATECH_SSU100	0xC020	/* SSU100 */
 57
 58static const struct usb_device_id id_table[] = {
 59	{USB_DEVICE(USB_VENDOR_ID_QUATECH, QUATECH_SSU100)},
 60	{}			/* Terminating entry */
 61};
 62
 63MODULE_DEVICE_TABLE(usb, id_table);
 64
 65
 66static struct usb_driver ssu100_driver = {
 67	.name			       = "ssu100",
 68	.probe			       = usb_serial_probe,
 69	.disconnect		       = usb_serial_disconnect,
 70	.id_table		       = id_table,
 71	.suspend		       = usb_serial_suspend,
 72	.resume			       = usb_serial_resume,
 73	.no_dynamic_id		       = 1,
 74	.supports_autosuspend	       = 1,
 75};
 76
 77struct ssu100_port_private {
 78	spinlock_t status_lock;
 79	u8 shadowLSR;
 80	u8 shadowMSR;
 81	wait_queue_head_t delta_msr_wait; /* Used for TIOCMIWAIT */
 82	struct async_icount icount;
 83};
 84
 85static void ssu100_release(struct usb_serial *serial)
 86{
 87	struct ssu100_port_private *priv = usb_get_serial_port_data(*serial->port);
 88
 89	dbg("%s", __func__);
 90	kfree(priv);
 91}
 92
 93static inline int ssu100_control_msg(struct usb_device *dev,
 94				     u8 request, u16 data, u16 index)
 95{
 96	return usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
 97			       request, 0x40, data, index,
 98			       NULL, 0, 300);
 99}
100
101static inline int ssu100_setdevice(struct usb_device *dev, u8 *data)
102{
103	u16 x = ((u16)(data[1] << 8) | (u16)(data[0]));
104
105	return ssu100_control_msg(dev, QT_SET_GET_DEVICE, x, 0);
106}
107
108
109static inline int ssu100_getdevice(struct usb_device *dev, u8 *data)
110{
111	return usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
112			       QT_SET_GET_DEVICE, 0xc0, 0, 0,
113			       data, 3, 300);
 
 
 
 
 
 
 
 
114}
115
116static inline int ssu100_getregister(struct usb_device *dev,
117				     unsigned short uart,
118				     unsigned short reg,
119				     u8 *data)
120{
121	return usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
122			       QT_SET_GET_REGISTER, 0xc0, reg,
123			       uart, data, sizeof(*data), 300);
124
 
 
 
 
 
 
 
 
 
125}
126
127
128static inline int ssu100_setregister(struct usb_device *dev,
129				     unsigned short uart,
130				     unsigned short reg,
131				     u16 data)
132{
133	u16 value = (data << 8) | reg;
134
135	return usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
136			       QT_SET_GET_REGISTER, 0x40, value, uart,
137			       NULL, 0, 300);
138
139}
140
141#define set_mctrl(dev, set)		update_mctrl((dev), (set), 0)
142#define clear_mctrl(dev, clear)	update_mctrl((dev), 0, (clear))
143
144/* these do not deal with device that have more than 1 port */
145static inline int update_mctrl(struct usb_device *dev, unsigned int set,
146			       unsigned int clear)
147{
148	unsigned urb_value;
149	int result;
150
151	if (((set | clear) & (TIOCM_DTR | TIOCM_RTS)) == 0) {
152		dbg("%s - DTR|RTS not being set|cleared", __func__);
153		return 0;	/* no change */
154	}
155
156	clear &= ~set;	/* 'set' takes precedence over 'clear' */
157	urb_value = 0;
158	if (set & TIOCM_DTR)
159		urb_value |= UART_MCR_DTR;
160	if (set & TIOCM_RTS)
161		urb_value |= UART_MCR_RTS;
162
163	result = ssu100_setregister(dev, 0, UART_MCR, urb_value);
164	if (result < 0)
165		dbg("%s Error from MODEM_CTRL urb", __func__);
166
167	return result;
168}
169
170static int ssu100_initdevice(struct usb_device *dev)
171{
172	u8 *data;
173	int result = 0;
174
175	dbg("%s", __func__);
176
177	data = kzalloc(3, GFP_KERNEL);
178	if (!data)
179		return -ENOMEM;
180
181	result = ssu100_getdevice(dev, data);
182	if (result < 0) {
183		dbg("%s - get_device failed %i", __func__, result);
184		goto out;
185	}
186
187	data[1] &= ~FULLPWRBIT;
188
189	result = ssu100_setdevice(dev, data);
190	if (result < 0) {
191		dbg("%s - setdevice failed %i", __func__, result);
192		goto out;
193	}
194
195	result = ssu100_control_msg(dev, QT_GET_SET_PREBUF_TRIG_LVL, 128, 0);
196	if (result < 0) {
197		dbg("%s - set prebuffer level failed %i", __func__, result);
198		goto out;
199	}
200
201	result = ssu100_control_msg(dev, QT_SET_ATF, ATC_DISABLED, 0);
202	if (result < 0) {
203		dbg("%s - set ATFprebuffer level failed %i", __func__, result);
204		goto out;
205	}
206
207	result = ssu100_getdevice(dev, data);
208	if (result < 0) {
209		dbg("%s - get_device failed %i", __func__, result);
210		goto out;
211	}
212
213	data[0] &= ~(RR_BITS | DUPMODE_BITS);
214	data[0] |= CLKS_X4;
215	data[1] &= ~(LOOPMODE_BITS);
216	data[1] |= RS232_MODE;
217
218	result = ssu100_setdevice(dev, data);
219	if (result < 0) {
220		dbg("%s - setdevice failed %i", __func__, result);
221		goto out;
222	}
223
224out:	kfree(data);
225	return result;
226
227}
228
229
230static void ssu100_set_termios(struct tty_struct *tty,
231			       struct usb_serial_port *port,
232			       struct ktermios *old_termios)
233{
234	struct usb_device *dev = port->serial->dev;
235	struct ktermios *termios = tty->termios;
236	u16 baud, divisor, remainder;
237	unsigned int cflag = termios->c_cflag;
238	u16 urb_value = 0; /* will hold the new flags */
239	int result;
240
241	dbg("%s", __func__);
242
243	if (cflag & PARENB) {
244		if (cflag & PARODD)
245			urb_value |= UART_LCR_PARITY;
246		else
247			urb_value |= SERIAL_EVEN_PARITY;
248	}
249
250	switch (cflag & CSIZE) {
251	case CS5:
252		urb_value |= UART_LCR_WLEN5;
253		break;
254	case CS6:
255		urb_value |= UART_LCR_WLEN6;
256		break;
257	case CS7:
258		urb_value |= UART_LCR_WLEN7;
259		break;
260	default:
261	case CS8:
262		urb_value |= UART_LCR_WLEN8;
263		break;
264	}
265
266	baud = tty_get_baud_rate(tty);
267	if (!baud)
268		baud = 9600;
269
270	dbg("%s - got baud = %d\n", __func__, baud);
271
272
273	divisor = MAX_BAUD_RATE / baud;
274	remainder = MAX_BAUD_RATE % baud;
275	if (((remainder * 2) >= baud) && (baud != 110))
276		divisor++;
277
278	urb_value = urb_value << 8;
279
280	result = ssu100_control_msg(dev, QT_GET_SET_UART, divisor, urb_value);
281	if (result < 0)
282		dbg("%s - set uart failed", __func__);
283
284	if (cflag & CRTSCTS)
285		result = ssu100_control_msg(dev, QT_HW_FLOW_CONTROL_MASK,
286					    SERIAL_CRTSCTS, 0);
287	else
288		result = ssu100_control_msg(dev, QT_HW_FLOW_CONTROL_MASK,
289					    0, 0);
290	if (result < 0)
291		dbg("%s - set HW flow control failed", __func__);
292
293	if (I_IXOFF(tty) || I_IXON(tty)) {
294		u16 x = ((u16)(START_CHAR(tty) << 8) | (u16)(STOP_CHAR(tty)));
295
296		result = ssu100_control_msg(dev, QT_SW_FLOW_CONTROL_MASK,
297					    x, 0);
298	} else
299		result = ssu100_control_msg(dev, QT_SW_FLOW_CONTROL_MASK,
300					    0, 0);
301
302	if (result < 0)
303		dbg("%s - set SW flow control failed", __func__);
304
305}
306
307
308static int ssu100_open(struct tty_struct *tty, struct usb_serial_port *port)
309{
310	struct usb_device *dev = port->serial->dev;
311	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
312	u8 *data;
313	int result;
314	unsigned long flags;
315
316	dbg("%s - port %d", __func__, port->number);
317
318	data = kzalloc(2, GFP_KERNEL);
319	if (!data)
320		return -ENOMEM;
321
322	result = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
323				 QT_OPEN_CLOSE_CHANNEL,
324				 QT_TRANSFER_IN, 0x01,
325				 0, data, 2, 300);
326	if (result < 0) {
327		dbg("%s - open failed %i", __func__, result);
 
 
328		kfree(data);
329		return result;
330	}
331
332	spin_lock_irqsave(&priv->status_lock, flags);
333	priv->shadowLSR = data[0];
334	priv->shadowMSR = data[1];
335	spin_unlock_irqrestore(&priv->status_lock, flags);
336
337	kfree(data);
338
339/* set to 9600 */
340	result = ssu100_control_msg(dev, QT_GET_SET_UART, 0x30, 0x0300);
341	if (result < 0)
342		dbg("%s - set uart failed", __func__);
343
344	if (tty)
345		ssu100_set_termios(tty, port, tty->termios);
346
347	return usb_serial_generic_open(tty, port);
348}
349
350static void ssu100_close(struct usb_serial_port *port)
351{
352	dbg("%s", __func__);
353	usb_serial_generic_close(port);
354}
355
356static int get_serial_info(struct usb_serial_port *port,
357			   struct serial_struct __user *retinfo)
358{
359	struct serial_struct tmp;
360
361	if (!retinfo)
362		return -EFAULT;
363
364	memset(&tmp, 0, sizeof(tmp));
365	tmp.line		= port->serial->minor;
366	tmp.port		= 0;
367	tmp.irq			= 0;
368	tmp.flags		= ASYNC_SKIP_TEST | ASYNC_AUTO_IRQ;
369	tmp.xmit_fifo_size	= port->bulk_out_size;
370	tmp.baud_base		= 9600;
371	tmp.close_delay		= 5*HZ;
372	tmp.closing_wait	= 30*HZ;
373
374	if (copy_to_user(retinfo, &tmp, sizeof(*retinfo)))
375		return -EFAULT;
376	return 0;
377}
378
379static int wait_modem_info(struct usb_serial_port *port, unsigned int arg)
380{
381	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
382	struct async_icount prev, cur;
383	unsigned long flags;
384
385	spin_lock_irqsave(&priv->status_lock, flags);
386	prev = priv->icount;
387	spin_unlock_irqrestore(&priv->status_lock, flags);
388
389	while (1) {
390		wait_event_interruptible(priv->delta_msr_wait,
391					 ((priv->icount.rng != prev.rng) ||
392					  (priv->icount.dsr != prev.dsr) ||
393					  (priv->icount.dcd != prev.dcd) ||
394					  (priv->icount.cts != prev.cts)));
395
396		if (signal_pending(current))
397			return -ERESTARTSYS;
398
399		spin_lock_irqsave(&priv->status_lock, flags);
400		cur = priv->icount;
401		spin_unlock_irqrestore(&priv->status_lock, flags);
402
403		if ((prev.rng == cur.rng) &&
404		    (prev.dsr == cur.dsr) &&
405		    (prev.dcd == cur.dcd) &&
406		    (prev.cts == cur.cts))
407			return -EIO;
408
409		if ((arg & TIOCM_RNG && (prev.rng != cur.rng)) ||
410		    (arg & TIOCM_DSR && (prev.dsr != cur.dsr)) ||
411		    (arg & TIOCM_CD  && (prev.dcd != cur.dcd)) ||
412		    (arg & TIOCM_CTS && (prev.cts != cur.cts)))
413			return 0;
414	}
415	return 0;
416}
417
418static int ssu100_get_icount(struct tty_struct *tty,
419			struct serial_icounter_struct *icount)
420{
421	struct usb_serial_port *port = tty->driver_data;
422	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
423	struct async_icount cnow = priv->icount;
424
425	icount->cts = cnow.cts;
426	icount->dsr = cnow.dsr;
427	icount->rng = cnow.rng;
428	icount->dcd = cnow.dcd;
429	icount->rx = cnow.rx;
430	icount->tx = cnow.tx;
431	icount->frame = cnow.frame;
432	icount->overrun = cnow.overrun;
433	icount->parity = cnow.parity;
434	icount->brk = cnow.brk;
435	icount->buf_overrun = cnow.buf_overrun;
436
437	return 0;
438}
439
440
441
442static int ssu100_ioctl(struct tty_struct *tty,
443		    unsigned int cmd, unsigned long arg)
444{
445	struct usb_serial_port *port = tty->driver_data;
446
447	dbg("%s cmd 0x%04x", __func__, cmd);
448
449	switch (cmd) {
450	case TIOCGSERIAL:
451		return get_serial_info(port,
452				       (struct serial_struct __user *) arg);
453
454	case TIOCMIWAIT:
455		return wait_modem_info(port, arg);
456
457	default:
458		break;
459	}
460
461	dbg("%s arg not supported", __func__);
462
463	return -ENOIOCTLCMD;
464}
465
466static int ssu100_attach(struct usb_serial *serial)
467{
468	struct ssu100_port_private *priv;
469	struct usb_serial_port *port = *serial->port;
470
471	dbg("%s", __func__);
 
 
472
473	priv = kzalloc(sizeof(*priv), GFP_KERNEL);
474	if (!priv) {
475		dev_err(&port->dev, "%s- kmalloc(%Zd) failed.\n", __func__,
476			sizeof(*priv));
477		return -ENOMEM;
478	}
479
480	spin_lock_init(&priv->status_lock);
481	init_waitqueue_head(&priv->delta_msr_wait);
482	usb_set_serial_port_data(port, priv);
483
484	return ssu100_initdevice(serial->dev);
 
 
 
 
 
 
 
 
 
 
485}
486
487static int ssu100_tiocmget(struct tty_struct *tty)
488{
489	struct usb_serial_port *port = tty->driver_data;
490	struct usb_device *dev = port->serial->dev;
491	u8 *d;
492	int r;
493
494	dbg("%s\n", __func__);
495
496	d = kzalloc(2, GFP_KERNEL);
497	if (!d)
498		return -ENOMEM;
499
500	r = ssu100_getregister(dev, 0, UART_MCR, d);
501	if (r < 0)
502		goto mget_out;
503
504	r = ssu100_getregister(dev, 0, UART_MSR, d+1);
505	if (r < 0)
506		goto mget_out;
507
508	r = (d[0] & UART_MCR_DTR ? TIOCM_DTR : 0) |
509		(d[0] & UART_MCR_RTS ? TIOCM_RTS : 0) |
510		(d[1] & UART_MSR_CTS ? TIOCM_CTS : 0) |
511		(d[1] & UART_MSR_DCD ? TIOCM_CAR : 0) |
512		(d[1] & UART_MSR_RI ? TIOCM_RI : 0) |
513		(d[1] & UART_MSR_DSR ? TIOCM_DSR : 0);
514
515mget_out:
516	kfree(d);
517	return r;
518}
519
520static int ssu100_tiocmset(struct tty_struct *tty,
521			   unsigned int set, unsigned int clear)
522{
523	struct usb_serial_port *port = tty->driver_data;
524	struct usb_device *dev = port->serial->dev;
525
526	dbg("%s\n", __func__);
527	return update_mctrl(dev, set, clear);
528}
529
530static void ssu100_dtr_rts(struct usb_serial_port *port, int on)
531{
532	struct usb_device *dev = port->serial->dev;
533
534	dbg("%s\n", __func__);
535
536	mutex_lock(&port->serial->disc_mutex);
537	if (!port->serial->disconnected) {
538		/* Disable flow control */
539		if (!on &&
540		    ssu100_setregister(dev, 0, UART_MCR, 0) < 0)
541			dev_err(&port->dev, "error from flowcontrol urb\n");
542		/* drop RTS and DTR */
543		if (on)
544			set_mctrl(dev, TIOCM_DTR | TIOCM_RTS);
545		else
546			clear_mctrl(dev, TIOCM_DTR | TIOCM_RTS);
547	}
548	mutex_unlock(&port->serial->disc_mutex);
 
 
 
 
549}
550
551static void ssu100_update_msr(struct usb_serial_port *port, u8 msr)
552{
553	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
554	unsigned long flags;
555
556	spin_lock_irqsave(&priv->status_lock, flags);
557	priv->shadowMSR = msr;
558	spin_unlock_irqrestore(&priv->status_lock, flags);
559
560	if (msr & UART_MSR_ANY_DELTA) {
561		/* update input line counters */
562		if (msr & UART_MSR_DCTS)
563			priv->icount.cts++;
564		if (msr & UART_MSR_DDSR)
565			priv->icount.dsr++;
566		if (msr & UART_MSR_DDCD)
567			priv->icount.dcd++;
568		if (msr & UART_MSR_TERI)
569			priv->icount.rng++;
570		wake_up_interruptible(&priv->delta_msr_wait);
571	}
572}
573
574static void ssu100_update_lsr(struct usb_serial_port *port, u8 lsr,
575			      char *tty_flag)
576{
577	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
578	unsigned long flags;
579
580	spin_lock_irqsave(&priv->status_lock, flags);
581	priv->shadowLSR = lsr;
582	spin_unlock_irqrestore(&priv->status_lock, flags);
583
584	*tty_flag = TTY_NORMAL;
585	if (lsr & UART_LSR_BRK_ERROR_BITS) {
586		/* we always want to update icount, but we only want to
587		 * update tty_flag for one case */
588		if (lsr & UART_LSR_BI) {
589			priv->icount.brk++;
590			*tty_flag = TTY_BREAK;
591			usb_serial_handle_break(port);
592		}
593		if (lsr & UART_LSR_PE) {
594			priv->icount.parity++;
595			if (*tty_flag == TTY_NORMAL)
596				*tty_flag = TTY_PARITY;
597		}
598		if (lsr & UART_LSR_FE) {
599			priv->icount.frame++;
600			if (*tty_flag == TTY_NORMAL)
601				*tty_flag = TTY_FRAME;
602		}
603		if (lsr & UART_LSR_OE){
604			priv->icount.overrun++;
605			if (*tty_flag == TTY_NORMAL)
606				*tty_flag = TTY_OVERRUN;
607		}
608	}
609
610}
611
612static int ssu100_process_packet(struct urb *urb,
613				 struct tty_struct *tty)
614{
615	struct usb_serial_port *port = urb->context;
616	char *packet = (char *)urb->transfer_buffer;
617	char flag = TTY_NORMAL;
618	u32 len = urb->actual_length;
619	int i;
620	char *ch;
621
622	dbg("%s - port %d", __func__, port->number);
623
624	if ((len >= 4) &&
625	    (packet[0] == 0x1b) && (packet[1] == 0x1b) &&
626	    ((packet[2] == 0x00) || (packet[2] == 0x01))) {
627		if (packet[2] == 0x00) {
628			ssu100_update_lsr(port, packet[3], &flag);
629			if (flag == TTY_OVERRUN)
630				tty_insert_flip_char(tty, 0, TTY_OVERRUN);
631		}
632		if (packet[2] == 0x01)
633			ssu100_update_msr(port, packet[3]);
634
635		len -= 4;
636		ch = packet + 4;
637	} else
638		ch = packet;
639
640	if (!len)
641		return 0;	/* status only */
642
643	if (port->port.console && port->sysrq) {
644		for (i = 0; i < len; i++, ch++) {
645			if (!usb_serial_handle_sysrq_char(port, *ch))
646				tty_insert_flip_char(tty, *ch, flag);
647		}
648	} else
649		tty_insert_flip_string_fixed_flag(tty, ch, flag, len);
650
651	return len;
652}
653
654static void ssu100_process_read_urb(struct urb *urb)
655{
656	struct usb_serial_port *port = urb->context;
657	struct tty_struct *tty;
658	int count;
659
660	dbg("%s", __func__);
661
662	tty = tty_port_tty_get(&port->port);
663	if (!tty)
664		return;
665
666	count = ssu100_process_packet(urb, tty);
667
668	if (count)
669		tty_flip_buffer_push(tty);
670	tty_kref_put(tty);
671}
672
673static struct usb_serial_driver ssu100_device = {
674	.driver = {
675		.owner = THIS_MODULE,
676		.name = "ssu100",
677	},
678	.description	     = DRIVER_DESC,
679	.id_table	     = id_table,
680	.usb_driver	     = &ssu100_driver,
681	.num_ports	     = 1,
682	.open		     = ssu100_open,
683	.close		     = ssu100_close,
684	.attach              = ssu100_attach,
685	.release             = ssu100_release,
 
686	.dtr_rts             = ssu100_dtr_rts,
687	.process_read_urb    = ssu100_process_read_urb,
688	.tiocmget            = ssu100_tiocmget,
689	.tiocmset            = ssu100_tiocmset,
690	.get_icount	     = ssu100_get_icount,
 
691	.ioctl               = ssu100_ioctl,
692	.set_termios         = ssu100_set_termios,
693	.disconnect          = usb_serial_generic_disconnect,
694};
695
696static int __init ssu100_init(void)
697{
698	int retval;
699
700	dbg("%s", __func__);
701
702	/* register with usb-serial */
703	retval = usb_serial_register(&ssu100_device);
704
705	if (retval)
706		goto failed_usb_sio_register;
707
708	retval = usb_register(&ssu100_driver);
709	if (retval)
710		goto failed_usb_register;
711
712	printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_VERSION ":"
713	       DRIVER_DESC "\n");
714
715	return 0;
716
717failed_usb_register:
718	usb_serial_deregister(&ssu100_device);
719failed_usb_sio_register:
720	return retval;
721}
722
723static void __exit ssu100_exit(void)
724{
725	usb_deregister(&ssu100_driver);
726	usb_serial_deregister(&ssu100_device);
727}
728
729module_init(ssu100_init);
730module_exit(ssu100_exit);
731
732MODULE_DESCRIPTION(DRIVER_DESC);
733MODULE_LICENSE("GPL");
734
735module_param(debug, bool, S_IRUGO | S_IWUSR);
736MODULE_PARM_DESC(debug, "Debug enabled or not");
v4.17
  1// SPDX-License-Identifier: GPL-2.0
  2/*
  3 * usb-serial driver for Quatech SSU-100
  4 *
  5 * based on ftdi_sio.c and the original serqt_usb.c from Quatech
  6 *
  7 */
  8
  9#include <linux/errno.h>
 
 10#include <linux/slab.h>
 11#include <linux/tty.h>
 12#include <linux/tty_driver.h>
 13#include <linux/tty_flip.h>
 14#include <linux/module.h>
 15#include <linux/serial.h>
 16#include <linux/usb.h>
 17#include <linux/usb/serial.h>
 18#include <linux/serial_reg.h>
 19#include <linux/uaccess.h>
 20
 21#define QT_OPEN_CLOSE_CHANNEL       0xca
 22#define QT_SET_GET_DEVICE           0xc2
 23#define QT_SET_GET_REGISTER         0xc0
 24#define QT_GET_SET_PREBUF_TRIG_LVL  0xcc
 25#define QT_SET_ATF                  0xcd
 26#define QT_GET_SET_UART             0xc1
 27#define QT_TRANSFER_IN              0xc0
 28#define QT_HW_FLOW_CONTROL_MASK     0xc5
 29#define QT_SW_FLOW_CONTROL_MASK     0xc6
 30
 31#define  SERIAL_MSR_MASK            0xf0
 32
 33#define  SERIAL_CRTSCTS ((UART_MCR_RTS << 8) | UART_MSR_CTS)
 34
 35#define  SERIAL_EVEN_PARITY         (UART_LCR_PARITY | UART_LCR_EPAR)
 36
 37#define  MAX_BAUD_RATE              460800
 38
 39#define ATC_DISABLED                0x00
 40#define DUPMODE_BITS        0xc0
 41#define RR_BITS             0x03
 42#define LOOPMODE_BITS       0x41
 43#define RS232_MODE          0x00
 44#define RTSCTS_TO_CONNECTOR 0x40
 45#define CLKS_X4             0x02
 46#define FULLPWRBIT          0x00000080
 47#define NEXT_BOARD_POWER_BIT        0x00000004
 48
 
 
 
 
 49#define DRIVER_DESC "Quatech SSU-100 USB to Serial Driver"
 50
 51#define	USB_VENDOR_ID_QUATECH	0x061d	/* Quatech VID */
 52#define QUATECH_SSU100	0xC020	/* SSU100 */
 53
 54static const struct usb_device_id id_table[] = {
 55	{USB_DEVICE(USB_VENDOR_ID_QUATECH, QUATECH_SSU100)},
 56	{}			/* Terminating entry */
 57};
 
 58MODULE_DEVICE_TABLE(usb, id_table);
 59
 
 
 
 
 
 
 
 
 
 
 
 
 60struct ssu100_port_private {
 61	spinlock_t status_lock;
 62	u8 shadowLSR;
 63	u8 shadowMSR;
 
 
 64};
 65
 
 
 
 
 
 
 
 
 66static inline int ssu100_control_msg(struct usb_device *dev,
 67				     u8 request, u16 data, u16 index)
 68{
 69	return usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
 70			       request, 0x40, data, index,
 71			       NULL, 0, 300);
 72}
 73
 74static inline int ssu100_setdevice(struct usb_device *dev, u8 *data)
 75{
 76	u16 x = ((u16)(data[1] << 8) | (u16)(data[0]));
 77
 78	return ssu100_control_msg(dev, QT_SET_GET_DEVICE, x, 0);
 79}
 80
 81
 82static inline int ssu100_getdevice(struct usb_device *dev, u8 *data)
 83{
 84	int ret;
 85
 86	ret = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
 87			      QT_SET_GET_DEVICE, 0xc0, 0, 0,
 88			      data, 3, 300);
 89	if (ret < 3) {
 90		if (ret >= 0)
 91			ret = -EIO;
 92	}
 93
 94	return ret;
 95}
 96
 97static inline int ssu100_getregister(struct usb_device *dev,
 98				     unsigned short uart,
 99				     unsigned short reg,
100				     u8 *data)
101{
102	int ret;
 
 
103
104	ret = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
105			      QT_SET_GET_REGISTER, 0xc0, reg,
106			      uart, data, sizeof(*data), 300);
107	if (ret < sizeof(*data)) {
108		if (ret >= 0)
109			ret = -EIO;
110	}
111
112	return ret;
113}
114
115
116static inline int ssu100_setregister(struct usb_device *dev,
117				     unsigned short uart,
118				     unsigned short reg,
119				     u16 data)
120{
121	u16 value = (data << 8) | reg;
122
123	return usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
124			       QT_SET_GET_REGISTER, 0x40, value, uart,
125			       NULL, 0, 300);
126
127}
128
129#define set_mctrl(dev, set)		update_mctrl((dev), (set), 0)
130#define clear_mctrl(dev, clear)	update_mctrl((dev), 0, (clear))
131
132/* these do not deal with device that have more than 1 port */
133static inline int update_mctrl(struct usb_device *dev, unsigned int set,
134			       unsigned int clear)
135{
136	unsigned urb_value;
137	int result;
138
139	if (((set | clear) & (TIOCM_DTR | TIOCM_RTS)) == 0) {
140		dev_dbg(&dev->dev, "%s - DTR|RTS not being set|cleared\n", __func__);
141		return 0;	/* no change */
142	}
143
144	clear &= ~set;	/* 'set' takes precedence over 'clear' */
145	urb_value = 0;
146	if (set & TIOCM_DTR)
147		urb_value |= UART_MCR_DTR;
148	if (set & TIOCM_RTS)
149		urb_value |= UART_MCR_RTS;
150
151	result = ssu100_setregister(dev, 0, UART_MCR, urb_value);
152	if (result < 0)
153		dev_dbg(&dev->dev, "%s Error from MODEM_CTRL urb\n", __func__);
154
155	return result;
156}
157
158static int ssu100_initdevice(struct usb_device *dev)
159{
160	u8 *data;
161	int result = 0;
162
 
 
163	data = kzalloc(3, GFP_KERNEL);
164	if (!data)
165		return -ENOMEM;
166
167	result = ssu100_getdevice(dev, data);
168	if (result < 0) {
169		dev_dbg(&dev->dev, "%s - get_device failed %i\n", __func__, result);
170		goto out;
171	}
172
173	data[1] &= ~FULLPWRBIT;
174
175	result = ssu100_setdevice(dev, data);
176	if (result < 0) {
177		dev_dbg(&dev->dev, "%s - setdevice failed %i\n", __func__, result);
178		goto out;
179	}
180
181	result = ssu100_control_msg(dev, QT_GET_SET_PREBUF_TRIG_LVL, 128, 0);
182	if (result < 0) {
183		dev_dbg(&dev->dev, "%s - set prebuffer level failed %i\n", __func__, result);
184		goto out;
185	}
186
187	result = ssu100_control_msg(dev, QT_SET_ATF, ATC_DISABLED, 0);
188	if (result < 0) {
189		dev_dbg(&dev->dev, "%s - set ATFprebuffer level failed %i\n", __func__, result);
190		goto out;
191	}
192
193	result = ssu100_getdevice(dev, data);
194	if (result < 0) {
195		dev_dbg(&dev->dev, "%s - get_device failed %i\n", __func__, result);
196		goto out;
197	}
198
199	data[0] &= ~(RR_BITS | DUPMODE_BITS);
200	data[0] |= CLKS_X4;
201	data[1] &= ~(LOOPMODE_BITS);
202	data[1] |= RS232_MODE;
203
204	result = ssu100_setdevice(dev, data);
205	if (result < 0) {
206		dev_dbg(&dev->dev, "%s - setdevice failed %i\n", __func__, result);
207		goto out;
208	}
209
210out:	kfree(data);
211	return result;
212
213}
214
215
216static void ssu100_set_termios(struct tty_struct *tty,
217			       struct usb_serial_port *port,
218			       struct ktermios *old_termios)
219{
220	struct usb_device *dev = port->serial->dev;
221	struct ktermios *termios = &tty->termios;
222	u16 baud, divisor, remainder;
223	unsigned int cflag = termios->c_cflag;
224	u16 urb_value = 0; /* will hold the new flags */
225	int result;
226
 
 
227	if (cflag & PARENB) {
228		if (cflag & PARODD)
229			urb_value |= UART_LCR_PARITY;
230		else
231			urb_value |= SERIAL_EVEN_PARITY;
232	}
233
234	switch (cflag & CSIZE) {
235	case CS5:
236		urb_value |= UART_LCR_WLEN5;
237		break;
238	case CS6:
239		urb_value |= UART_LCR_WLEN6;
240		break;
241	case CS7:
242		urb_value |= UART_LCR_WLEN7;
243		break;
244	default:
245	case CS8:
246		urb_value |= UART_LCR_WLEN8;
247		break;
248	}
249
250	baud = tty_get_baud_rate(tty);
251	if (!baud)
252		baud = 9600;
253
254	dev_dbg(&port->dev, "%s - got baud = %d\n", __func__, baud);
255
256
257	divisor = MAX_BAUD_RATE / baud;
258	remainder = MAX_BAUD_RATE % baud;
259	if (((remainder * 2) >= baud) && (baud != 110))
260		divisor++;
261
262	urb_value = urb_value << 8;
263
264	result = ssu100_control_msg(dev, QT_GET_SET_UART, divisor, urb_value);
265	if (result < 0)
266		dev_dbg(&port->dev, "%s - set uart failed\n", __func__);
267
268	if (cflag & CRTSCTS)
269		result = ssu100_control_msg(dev, QT_HW_FLOW_CONTROL_MASK,
270					    SERIAL_CRTSCTS, 0);
271	else
272		result = ssu100_control_msg(dev, QT_HW_FLOW_CONTROL_MASK,
273					    0, 0);
274	if (result < 0)
275		dev_dbg(&port->dev, "%s - set HW flow control failed\n", __func__);
276
277	if (I_IXOFF(tty) || I_IXON(tty)) {
278		u16 x = ((u16)(START_CHAR(tty) << 8) | (u16)(STOP_CHAR(tty)));
279
280		result = ssu100_control_msg(dev, QT_SW_FLOW_CONTROL_MASK,
281					    x, 0);
282	} else
283		result = ssu100_control_msg(dev, QT_SW_FLOW_CONTROL_MASK,
284					    0, 0);
285
286	if (result < 0)
287		dev_dbg(&port->dev, "%s - set SW flow control failed\n", __func__);
288
289}
290
291
292static int ssu100_open(struct tty_struct *tty, struct usb_serial_port *port)
293{
294	struct usb_device *dev = port->serial->dev;
295	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
296	u8 *data;
297	int result;
298	unsigned long flags;
299
 
 
300	data = kzalloc(2, GFP_KERNEL);
301	if (!data)
302		return -ENOMEM;
303
304	result = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
305				 QT_OPEN_CLOSE_CHANNEL,
306				 QT_TRANSFER_IN, 0x01,
307				 0, data, 2, 300);
308	if (result < 2) {
309		dev_dbg(&port->dev, "%s - open failed %i\n", __func__, result);
310		if (result >= 0)
311			result = -EIO;
312		kfree(data);
313		return result;
314	}
315
316	spin_lock_irqsave(&priv->status_lock, flags);
317	priv->shadowLSR = data[0];
318	priv->shadowMSR = data[1];
319	spin_unlock_irqrestore(&priv->status_lock, flags);
320
321	kfree(data);
322
323/* set to 9600 */
324	result = ssu100_control_msg(dev, QT_GET_SET_UART, 0x30, 0x0300);
325	if (result < 0)
326		dev_dbg(&port->dev, "%s - set uart failed\n", __func__);
327
328	if (tty)
329		ssu100_set_termios(tty, port, &tty->termios);
330
331	return usb_serial_generic_open(tty, port);
332}
333
 
 
 
 
 
 
334static int get_serial_info(struct usb_serial_port *port,
335			   struct serial_struct __user *retinfo)
336{
337	struct serial_struct tmp;
338
 
 
 
339	memset(&tmp, 0, sizeof(tmp));
340	tmp.line		= port->minor;
341	tmp.port		= 0;
342	tmp.irq			= 0;
 
343	tmp.xmit_fifo_size	= port->bulk_out_size;
344	tmp.baud_base		= 9600;
345	tmp.close_delay		= 5*HZ;
346	tmp.closing_wait	= 30*HZ;
347
348	if (copy_to_user(retinfo, &tmp, sizeof(*retinfo)))
349		return -EFAULT;
350	return 0;
351}
352
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
353static int ssu100_ioctl(struct tty_struct *tty,
354		    unsigned int cmd, unsigned long arg)
355{
356	struct usb_serial_port *port = tty->driver_data;
357
 
 
358	switch (cmd) {
359	case TIOCGSERIAL:
360		return get_serial_info(port,
361				       (struct serial_struct __user *) arg);
 
 
 
 
362	default:
363		break;
364	}
365
 
 
366	return -ENOIOCTLCMD;
367}
368
369static int ssu100_attach(struct usb_serial *serial)
370{
371	return ssu100_initdevice(serial->dev);
372}
373
374static int ssu100_port_probe(struct usb_serial_port *port)
375{
376	struct ssu100_port_private *priv;
377
378	priv = kzalloc(sizeof(*priv), GFP_KERNEL);
379	if (!priv)
 
 
380		return -ENOMEM;
 
381
382	spin_lock_init(&priv->status_lock);
383
384	usb_set_serial_port_data(port, priv);
385
386	return 0;
387}
388
389static int ssu100_port_remove(struct usb_serial_port *port)
390{
391	struct ssu100_port_private *priv;
392
393	priv = usb_get_serial_port_data(port);
394	kfree(priv);
395
396	return 0;
397}
398
399static int ssu100_tiocmget(struct tty_struct *tty)
400{
401	struct usb_serial_port *port = tty->driver_data;
402	struct usb_device *dev = port->serial->dev;
403	u8 *d;
404	int r;
405
 
 
406	d = kzalloc(2, GFP_KERNEL);
407	if (!d)
408		return -ENOMEM;
409
410	r = ssu100_getregister(dev, 0, UART_MCR, d);
411	if (r < 0)
412		goto mget_out;
413
414	r = ssu100_getregister(dev, 0, UART_MSR, d+1);
415	if (r < 0)
416		goto mget_out;
417
418	r = (d[0] & UART_MCR_DTR ? TIOCM_DTR : 0) |
419		(d[0] & UART_MCR_RTS ? TIOCM_RTS : 0) |
420		(d[1] & UART_MSR_CTS ? TIOCM_CTS : 0) |
421		(d[1] & UART_MSR_DCD ? TIOCM_CAR : 0) |
422		(d[1] & UART_MSR_RI ? TIOCM_RI : 0) |
423		(d[1] & UART_MSR_DSR ? TIOCM_DSR : 0);
424
425mget_out:
426	kfree(d);
427	return r;
428}
429
430static int ssu100_tiocmset(struct tty_struct *tty,
431			   unsigned int set, unsigned int clear)
432{
433	struct usb_serial_port *port = tty->driver_data;
434	struct usb_device *dev = port->serial->dev;
435
 
436	return update_mctrl(dev, set, clear);
437}
438
439static void ssu100_dtr_rts(struct usb_serial_port *port, int on)
440{
441	struct usb_device *dev = port->serial->dev;
442
443	/* Disable flow control */
444	if (!on) {
445		if (ssu100_setregister(dev, 0, UART_MCR, 0) < 0)
 
 
 
 
446			dev_err(&port->dev, "error from flowcontrol urb\n");
 
 
 
 
 
447	}
448	/* drop RTS and DTR */
449	if (on)
450		set_mctrl(dev, TIOCM_DTR | TIOCM_RTS);
451	else
452		clear_mctrl(dev, TIOCM_DTR | TIOCM_RTS);
453}
454
455static void ssu100_update_msr(struct usb_serial_port *port, u8 msr)
456{
457	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
458	unsigned long flags;
459
460	spin_lock_irqsave(&priv->status_lock, flags);
461	priv->shadowMSR = msr;
462	spin_unlock_irqrestore(&priv->status_lock, flags);
463
464	if (msr & UART_MSR_ANY_DELTA) {
465		/* update input line counters */
466		if (msr & UART_MSR_DCTS)
467			port->icount.cts++;
468		if (msr & UART_MSR_DDSR)
469			port->icount.dsr++;
470		if (msr & UART_MSR_DDCD)
471			port->icount.dcd++;
472		if (msr & UART_MSR_TERI)
473			port->icount.rng++;
474		wake_up_interruptible(&port->port.delta_msr_wait);
475	}
476}
477
478static void ssu100_update_lsr(struct usb_serial_port *port, u8 lsr,
479			      char *tty_flag)
480{
481	struct ssu100_port_private *priv = usb_get_serial_port_data(port);
482	unsigned long flags;
483
484	spin_lock_irqsave(&priv->status_lock, flags);
485	priv->shadowLSR = lsr;
486	spin_unlock_irqrestore(&priv->status_lock, flags);
487
488	*tty_flag = TTY_NORMAL;
489	if (lsr & UART_LSR_BRK_ERROR_BITS) {
490		/* we always want to update icount, but we only want to
491		 * update tty_flag for one case */
492		if (lsr & UART_LSR_BI) {
493			port->icount.brk++;
494			*tty_flag = TTY_BREAK;
495			usb_serial_handle_break(port);
496		}
497		if (lsr & UART_LSR_PE) {
498			port->icount.parity++;
499			if (*tty_flag == TTY_NORMAL)
500				*tty_flag = TTY_PARITY;
501		}
502		if (lsr & UART_LSR_FE) {
503			port->icount.frame++;
504			if (*tty_flag == TTY_NORMAL)
505				*tty_flag = TTY_FRAME;
506		}
507		if (lsr & UART_LSR_OE) {
508			port->icount.overrun++;
509			tty_insert_flip_char(&port->port, 0, TTY_OVERRUN);
 
510		}
511	}
512
513}
514
515static void ssu100_process_read_urb(struct urb *urb)
 
516{
517	struct usb_serial_port *port = urb->context;
518	char *packet = (char *)urb->transfer_buffer;
519	char flag = TTY_NORMAL;
520	u32 len = urb->actual_length;
521	int i;
522	char *ch;
523
 
 
524	if ((len >= 4) &&
525	    (packet[0] == 0x1b) && (packet[1] == 0x1b) &&
526	    ((packet[2] == 0x00) || (packet[2] == 0x01))) {
527		if (packet[2] == 0x00)
528			ssu100_update_lsr(port, packet[3], &flag);
 
 
 
529		if (packet[2] == 0x01)
530			ssu100_update_msr(port, packet[3]);
531
532		len -= 4;
533		ch = packet + 4;
534	} else
535		ch = packet;
536
537	if (!len)
538		return;	/* status only */
539
540	if (port->port.console && port->sysrq) {
541		for (i = 0; i < len; i++, ch++) {
542			if (!usb_serial_handle_sysrq_char(port, *ch))
543				tty_insert_flip_char(&port->port, *ch, flag);
544		}
545	} else
546		tty_insert_flip_string_fixed_flag(&port->port, ch, flag, len);
547
548	tty_flip_buffer_push(&port->port);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
549}
550
551static struct usb_serial_driver ssu100_device = {
552	.driver = {
553		.owner = THIS_MODULE,
554		.name = "ssu100",
555	},
556	.description	     = DRIVER_DESC,
557	.id_table	     = id_table,
 
558	.num_ports	     = 1,
559	.open		     = ssu100_open,
 
560	.attach              = ssu100_attach,
561	.port_probe          = ssu100_port_probe,
562	.port_remove         = ssu100_port_remove,
563	.dtr_rts             = ssu100_dtr_rts,
564	.process_read_urb    = ssu100_process_read_urb,
565	.tiocmget            = ssu100_tiocmget,
566	.tiocmset            = ssu100_tiocmset,
567	.tiocmiwait          = usb_serial_generic_tiocmiwait,
568	.get_icount	     = usb_serial_generic_get_icount,
569	.ioctl               = ssu100_ioctl,
570	.set_termios         = ssu100_set_termios,
 
571};
572
573static struct usb_serial_driver * const serial_drivers[] = {
574	&ssu100_device, NULL
575};
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
576
577module_usb_serial_driver(serial_drivers, id_table);
 
578
579MODULE_DESCRIPTION(DRIVER_DESC);
580MODULE_LICENSE("GPL v2");