xref: /linux/drivers/mmc/core/sdio_uart.c (revision b92dd11725a7c57f55e148c7d3ce58a86f480575)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * SDIO UART/GPS driver
4  *
5  * Based on drivers/serial/8250.c and drivers/serial/serial_core.c
6  * by Russell King.
7  *
8  * Author:	Nicolas Pitre
9  * Created:	June 15, 2007
10  * Copyright:	MontaVista Software, Inc.
11  */
12 
13 /*
14  * Note: Although this driver assumes a 16550A-like UART implementation,
15  * it is not possible to leverage the common 8250/16550 driver, nor the
16  * core UART infrastructure, as they assumes direct access to the hardware
17  * registers, often under a spinlock.  This is not possible in the SDIO
18  * context as SDIO access functions must be able to sleep.
19  *
20  * Because we need to lock the SDIO host to ensure an exclusive access to
21  * the card, we simply rely on that lock to also prevent and serialize
22  * concurrent access to the same port.
23  */
24 
25 #include <linux/module.h>
26 #include <linux/init.h>
27 #include <linux/kernel.h>
28 #include <linux/sched.h>
29 #include <linux/mutex.h>
30 #include <linux/seq_file.h>
31 #include <linux/serial.h>
32 #include <linux/serial_reg.h>
33 #include <linux/circ_buf.h>
34 #include <linux/tty.h>
35 #include <linux/tty_flip.h>
36 #include <linux/kfifo.h>
37 #include <linux/slab.h>
38 
39 #include <linux/mmc/core.h>
40 #include <linux/mmc/card.h>
41 #include <linux/mmc/sdio_func.h>
42 #include <linux/mmc/sdio_ids.h>
43 
44 
45 #define UART_NR		8	/* Number of UARTs this driver can handle */
46 
47 
48 #define FIFO_SIZE	PAGE_SIZE
49 #define WAKEUP_CHARS	256
50 
51 struct uart_icount {
52 	__u32	cts;
53 	__u32	dsr;
54 	__u32	rng;
55 	__u32	dcd;
56 	__u32	rx;
57 	__u32	tx;
58 	__u32	frame;
59 	__u32	overrun;
60 	__u32	parity;
61 	__u32	brk;
62 };
63 
64 struct sdio_uart_port {
65 	struct tty_port		port;
66 	unsigned int		index;
67 	struct sdio_func	*func;
68 	struct mutex		func_lock;
69 	struct task_struct	*in_sdio_uart_irq;
70 	unsigned int		regs_offset;
71 	struct kfifo		xmit_fifo;
72 	spinlock_t		write_lock;
73 	struct uart_icount	icount;
74 	unsigned int		uartclk;
75 	unsigned int		mctrl;
76 	unsigned int		rx_mctrl;
77 	unsigned int		read_status_mask;
78 	unsigned int		ignore_status_mask;
79 	unsigned char		x_char;
80 	unsigned char           ier;
81 	unsigned char           lcr;
82 };
83 
84 static struct sdio_uart_port *sdio_uart_table[UART_NR];
85 static DEFINE_SPINLOCK(sdio_uart_table_lock);
86 
87 static int sdio_uart_add_port(struct sdio_uart_port *port)
88 {
89 	int index, ret = -EBUSY;
90 
91 	mutex_init(&port->func_lock);
92 	spin_lock_init(&port->write_lock);
93 	if (kfifo_alloc(&port->xmit_fifo, FIFO_SIZE, GFP_KERNEL))
94 		return -ENOMEM;
95 
96 	spin_lock(&sdio_uart_table_lock);
97 	for (index = 0; index < UART_NR; index++) {
98 		if (!sdio_uart_table[index]) {
99 			port->index = index;
100 			sdio_uart_table[index] = port;
101 			ret = 0;
102 			break;
103 		}
104 	}
105 	spin_unlock(&sdio_uart_table_lock);
106 
107 	return ret;
108 }
109 
110 static struct sdio_uart_port *sdio_uart_port_get(unsigned index)
111 {
112 	struct sdio_uart_port *port;
113 
114 	if (index >= UART_NR)
115 		return NULL;
116 
117 	spin_lock(&sdio_uart_table_lock);
118 	port = sdio_uart_table[index];
119 	if (port)
120 		tty_port_get(&port->port);
121 	spin_unlock(&sdio_uart_table_lock);
122 
123 	return port;
124 }
125 
126 static void sdio_uart_port_put(struct sdio_uart_port *port)
127 {
128 	tty_port_put(&port->port);
129 }
130 
131 static void sdio_uart_port_remove(struct sdio_uart_port *port)
132 {
133 	struct sdio_func *func;
134 
135 	spin_lock(&sdio_uart_table_lock);
136 	sdio_uart_table[port->index] = NULL;
137 	spin_unlock(&sdio_uart_table_lock);
138 
139 	/*
140 	 * We're killing a port that potentially still is in use by
141 	 * the tty layer. Be careful to prevent any further access
142 	 * to the SDIO function and arrange for the tty layer to
143 	 * give up on that port ASAP.
144 	 * Beware: the lock ordering is critical.
145 	 */
146 	mutex_lock(&port->port.mutex);
147 	mutex_lock(&port->func_lock);
148 	func = port->func;
149 	sdio_claim_host(func);
150 	port->func = NULL;
151 	mutex_unlock(&port->func_lock);
152 	/* tty_hangup is async so is this safe as is ?? */
153 	tty_port_tty_hangup(&port->port, false);
154 	mutex_unlock(&port->port.mutex);
155 	sdio_release_irq(func);
156 	sdio_disable_func(func);
157 	sdio_release_host(func);
158 
159 	sdio_uart_port_put(port);
160 }
161 
162 static int sdio_uart_claim_func(struct sdio_uart_port *port)
163 {
164 	mutex_lock(&port->func_lock);
165 	if (unlikely(!port->func)) {
166 		mutex_unlock(&port->func_lock);
167 		return -ENODEV;
168 	}
169 	if (likely(port->in_sdio_uart_irq != current))
170 		sdio_claim_host(port->func);
171 	mutex_unlock(&port->func_lock);
172 	return 0;
173 }
174 
175 static inline void sdio_uart_release_func(struct sdio_uart_port *port)
176 {
177 	if (likely(port->in_sdio_uart_irq != current))
178 		sdio_release_host(port->func);
179 }
180 
181 static inline unsigned int sdio_in(struct sdio_uart_port *port, int offset)
182 {
183 	unsigned char c;
184 	c = sdio_readb(port->func, port->regs_offset + offset, NULL);
185 	return c;
186 }
187 
188 static inline void sdio_out(struct sdio_uart_port *port, int offset, int value)
189 {
190 	sdio_writeb(port->func, value, port->regs_offset + offset, NULL);
191 }
192 
193 static unsigned int sdio_uart_get_mctrl(struct sdio_uart_port *port)
194 {
195 	unsigned char status;
196 	unsigned int ret;
197 
198 	/* FIXME: What stops this losing the delta bits and breaking
199 	   sdio_uart_check_modem_status ? */
200 	status = sdio_in(port, UART_MSR);
201 
202 	ret = 0;
203 	if (status & UART_MSR_DCD)
204 		ret |= TIOCM_CAR;
205 	if (status & UART_MSR_RI)
206 		ret |= TIOCM_RNG;
207 	if (status & UART_MSR_DSR)
208 		ret |= TIOCM_DSR;
209 	if (status & UART_MSR_CTS)
210 		ret |= TIOCM_CTS;
211 	return ret;
212 }
213 
214 static void sdio_uart_write_mctrl(struct sdio_uart_port *port,
215 				  unsigned int mctrl)
216 {
217 	unsigned char mcr = 0;
218 
219 	if (mctrl & TIOCM_RTS)
220 		mcr |= UART_MCR_RTS;
221 	if (mctrl & TIOCM_DTR)
222 		mcr |= UART_MCR_DTR;
223 	if (mctrl & TIOCM_OUT1)
224 		mcr |= UART_MCR_OUT1;
225 	if (mctrl & TIOCM_OUT2)
226 		mcr |= UART_MCR_OUT2;
227 	if (mctrl & TIOCM_LOOP)
228 		mcr |= UART_MCR_LOOP;
229 
230 	sdio_out(port, UART_MCR, mcr);
231 }
232 
233 static inline void sdio_uart_update_mctrl(struct sdio_uart_port *port,
234 					  unsigned int set, unsigned int clear)
235 {
236 	unsigned int old;
237 
238 	old = port->mctrl;
239 	port->mctrl = (old & ~clear) | set;
240 	if (old != port->mctrl)
241 		sdio_uart_write_mctrl(port, port->mctrl);
242 }
243 
244 #define sdio_uart_set_mctrl(port, x)	sdio_uart_update_mctrl(port, x, 0)
245 #define sdio_uart_clear_mctrl(port, x)	sdio_uart_update_mctrl(port, 0, x)
246 
247 static void sdio_uart_change_speed(struct sdio_uart_port *port,
248 				   struct ktermios *termios,
249 				   const struct ktermios *old)
250 {
251 	unsigned char cval, fcr = 0;
252 	unsigned int baud, quot;
253 
254 	cval = UART_LCR_WLEN(tty_get_char_size(termios->c_cflag));
255 
256 	if (termios->c_cflag & CSTOPB)
257 		cval |= UART_LCR_STOP;
258 	if (termios->c_cflag & PARENB)
259 		cval |= UART_LCR_PARITY;
260 	if (!(termios->c_cflag & PARODD))
261 		cval |= UART_LCR_EPAR;
262 
263 	for (;;) {
264 		baud = tty_termios_baud_rate(termios);
265 		if (baud == 0)
266 			baud = 9600;  /* Special case: B0 rate. */
267 		if (baud <= port->uartclk)
268 			break;
269 		/*
270 		 * Oops, the quotient was zero.  Try again with the old
271 		 * baud rate if possible, otherwise default to 9600.
272 		 */
273 		termios->c_cflag &= ~CBAUD;
274 		if (old) {
275 			termios->c_cflag |= old->c_cflag & CBAUD;
276 			old = NULL;
277 		} else
278 			termios->c_cflag |= B9600;
279 	}
280 	quot = (2 * port->uartclk + baud) / (2 * baud);
281 
282 	if (baud < 2400)
283 		fcr = UART_FCR_ENABLE_FIFO | UART_FCR_TRIGGER_1;
284 	else
285 		fcr = UART_FCR_ENABLE_FIFO | UART_FCR_R_TRIG_10;
286 
287 	port->read_status_mask = UART_LSR_OE | UART_LSR_THRE | UART_LSR_DR;
288 	if (termios->c_iflag & INPCK)
289 		port->read_status_mask |= UART_LSR_FE | UART_LSR_PE;
290 	if (termios->c_iflag & (BRKINT | PARMRK))
291 		port->read_status_mask |= UART_LSR_BI;
292 
293 	/*
294 	 * Characters to ignore
295 	 */
296 	port->ignore_status_mask = 0;
297 	if (termios->c_iflag & IGNPAR)
298 		port->ignore_status_mask |= UART_LSR_PE | UART_LSR_FE;
299 	if (termios->c_iflag & IGNBRK) {
300 		port->ignore_status_mask |= UART_LSR_BI;
301 		/*
302 		 * If we're ignoring parity and break indicators,
303 		 * ignore overruns too (for real raw support).
304 		 */
305 		if (termios->c_iflag & IGNPAR)
306 			port->ignore_status_mask |= UART_LSR_OE;
307 	}
308 
309 	/*
310 	 * ignore all characters if CREAD is not set
311 	 */
312 	if ((termios->c_cflag & CREAD) == 0)
313 		port->ignore_status_mask |= UART_LSR_DR;
314 
315 	/*
316 	 * CTS flow control flag and modem status interrupts
317 	 */
318 	port->ier &= ~UART_IER_MSI;
319 	if ((termios->c_cflag & CRTSCTS) || !(termios->c_cflag & CLOCAL))
320 		port->ier |= UART_IER_MSI;
321 
322 	port->lcr = cval;
323 
324 	sdio_out(port, UART_IER, port->ier);
325 	sdio_out(port, UART_LCR, cval | UART_LCR_DLAB);
326 	sdio_out(port, UART_DLL, quot & 0xff);
327 	sdio_out(port, UART_DLM, quot >> 8);
328 	sdio_out(port, UART_LCR, cval);
329 	sdio_out(port, UART_FCR, fcr);
330 
331 	sdio_uart_write_mctrl(port, port->mctrl);
332 }
333 
334 static void sdio_uart_start_tx(struct sdio_uart_port *port)
335 {
336 	if (!(port->ier & UART_IER_THRI)) {
337 		port->ier |= UART_IER_THRI;
338 		sdio_out(port, UART_IER, port->ier);
339 	}
340 }
341 
342 static void sdio_uart_stop_tx(struct sdio_uart_port *port)
343 {
344 	if (port->ier & UART_IER_THRI) {
345 		port->ier &= ~UART_IER_THRI;
346 		sdio_out(port, UART_IER, port->ier);
347 	}
348 }
349 
350 static void sdio_uart_stop_rx(struct sdio_uart_port *port)
351 {
352 	port->ier &= ~UART_IER_RLSI;
353 	port->read_status_mask &= ~UART_LSR_DR;
354 	sdio_out(port, UART_IER, port->ier);
355 }
356 
357 static void sdio_uart_receive_chars(struct sdio_uart_port *port,
358 				    unsigned int *status)
359 {
360 	unsigned int ch, flag;
361 	int max_count = 256;
362 
363 	do {
364 		ch = sdio_in(port, UART_RX);
365 		flag = TTY_NORMAL;
366 		port->icount.rx++;
367 
368 		if (unlikely(*status & (UART_LSR_BI | UART_LSR_PE |
369 					UART_LSR_FE | UART_LSR_OE))) {
370 			/*
371 			 * For statistics only
372 			 */
373 			if (*status & UART_LSR_BI) {
374 				*status &= ~(UART_LSR_FE | UART_LSR_PE);
375 				port->icount.brk++;
376 			} else if (*status & UART_LSR_PE)
377 				port->icount.parity++;
378 			else if (*status & UART_LSR_FE)
379 				port->icount.frame++;
380 			if (*status & UART_LSR_OE)
381 				port->icount.overrun++;
382 
383 			/*
384 			 * Mask off conditions which should be ignored.
385 			 */
386 			*status &= port->read_status_mask;
387 			if (*status & UART_LSR_BI)
388 				flag = TTY_BREAK;
389 			else if (*status & UART_LSR_PE)
390 				flag = TTY_PARITY;
391 			else if (*status & UART_LSR_FE)
392 				flag = TTY_FRAME;
393 		}
394 
395 		if ((*status & port->ignore_status_mask & ~UART_LSR_OE) == 0)
396 			tty_insert_flip_char(&port->port, ch, flag);
397 
398 		/*
399 		 * Overrun is special.  Since it's reported immediately,
400 		 * it doesn't affect the current character.
401 		 */
402 		if (*status & ~port->ignore_status_mask & UART_LSR_OE)
403 			tty_insert_flip_char(&port->port, 0, TTY_OVERRUN);
404 
405 		*status = sdio_in(port, UART_LSR);
406 	} while ((*status & UART_LSR_DR) && (max_count-- > 0));
407 
408 	tty_flip_buffer_push(&port->port);
409 }
410 
411 static void sdio_uart_transmit_chars(struct sdio_uart_port *port)
412 {
413 	struct kfifo *xmit = &port->xmit_fifo;
414 	int count;
415 	struct tty_struct *tty;
416 	u8 iobuf[16];
417 	int len;
418 
419 	if (port->x_char) {
420 		sdio_out(port, UART_TX, port->x_char);
421 		port->icount.tx++;
422 		port->x_char = 0;
423 		return;
424 	}
425 
426 	tty = tty_port_tty_get(&port->port);
427 
428 	if (tty == NULL || !kfifo_len(xmit) ||
429 				tty->flow.stopped || tty->hw_stopped) {
430 		sdio_uart_stop_tx(port);
431 		tty_kref_put(tty);
432 		return;
433 	}
434 
435 	len = kfifo_out_locked(xmit, iobuf, 16, &port->write_lock);
436 	for (count = 0; count < len; count++) {
437 		sdio_out(port, UART_TX, iobuf[count]);
438 		port->icount.tx++;
439 	}
440 
441 	len = kfifo_len(xmit);
442 	if (len < WAKEUP_CHARS) {
443 		tty_wakeup(tty);
444 		if (len == 0)
445 			sdio_uart_stop_tx(port);
446 	}
447 	tty_kref_put(tty);
448 }
449 
450 static void sdio_uart_check_modem_status(struct sdio_uart_port *port)
451 {
452 	int status;
453 	struct tty_struct *tty;
454 
455 	status = sdio_in(port, UART_MSR);
456 
457 	if ((status & UART_MSR_ANY_DELTA) == 0)
458 		return;
459 
460 	if (status & UART_MSR_TERI)
461 		port->icount.rng++;
462 	if (status & UART_MSR_DDSR)
463 		port->icount.dsr++;
464 	if (status & UART_MSR_DDCD) {
465 		port->icount.dcd++;
466 		/* DCD raise - wake for open */
467 		if (status & UART_MSR_DCD)
468 			wake_up_interruptible(&port->port.open_wait);
469 		else {
470 			/* DCD drop - hang up if tty attached */
471 			tty_port_tty_hangup(&port->port, false);
472 		}
473 	}
474 	if (status & UART_MSR_DCTS) {
475 		port->icount.cts++;
476 		tty = tty_port_tty_get(&port->port);
477 		if (tty && C_CRTSCTS(tty)) {
478 			int cts = (status & UART_MSR_CTS);
479 			if (tty->hw_stopped) {
480 				if (cts) {
481 					tty->hw_stopped = 0;
482 					sdio_uart_start_tx(port);
483 					tty_wakeup(tty);
484 				}
485 			} else {
486 				if (!cts) {
487 					tty->hw_stopped = 1;
488 					sdio_uart_stop_tx(port);
489 				}
490 			}
491 		}
492 		tty_kref_put(tty);
493 	}
494 }
495 
496 /*
497  * This handles the interrupt from one port.
498  */
499 static void sdio_uart_irq(struct sdio_func *func)
500 {
501 	struct sdio_uart_port *port = sdio_get_drvdata(func);
502 	unsigned int iir, lsr;
503 
504 	/*
505 	 * In a few places sdio_uart_irq() is called directly instead of
506 	 * waiting for the actual interrupt to be raised and the SDIO IRQ
507 	 * thread scheduled in order to reduce latency.  However, some
508 	 * interaction with the tty core may end up calling us back
509 	 * (serial echo, flow control, etc.) through those same places
510 	 * causing undesirable effects.  Let's stop the recursion here.
511 	 */
512 	if (unlikely(port->in_sdio_uart_irq == current))
513 		return;
514 
515 	iir = sdio_in(port, UART_IIR);
516 	if (iir & UART_IIR_NO_INT)
517 		return;
518 
519 	port->in_sdio_uart_irq = current;
520 	lsr = sdio_in(port, UART_LSR);
521 	if (lsr & UART_LSR_DR)
522 		sdio_uart_receive_chars(port, &lsr);
523 	sdio_uart_check_modem_status(port);
524 	if (lsr & UART_LSR_THRE)
525 		sdio_uart_transmit_chars(port);
526 	port->in_sdio_uart_irq = NULL;
527 }
528 
529 static int uart_carrier_raised(struct tty_port *tport)
530 {
531 	struct sdio_uart_port *port =
532 			container_of(tport, struct sdio_uart_port, port);
533 	unsigned int ret = sdio_uart_claim_func(port);
534 	if (ret)	/* Missing hardware shouldn't block for carrier */
535 		return 1;
536 	ret = sdio_uart_get_mctrl(port);
537 	sdio_uart_release_func(port);
538 	if (ret & TIOCM_CAR)
539 		return 1;
540 	return 0;
541 }
542 
543 /**
544  *	uart_dtr_rts		-	 port helper to set uart signals
545  *	@tport: tty port to be updated
546  *	@onoff: set to turn on DTR/RTS
547  *
548  *	Called by the tty port helpers when the modem signals need to be
549  *	adjusted during an open, close and hangup.
550  */
551 
552 static void uart_dtr_rts(struct tty_port *tport, int onoff)
553 {
554 	struct sdio_uart_port *port =
555 			container_of(tport, struct sdio_uart_port, port);
556 	int ret = sdio_uart_claim_func(port);
557 	if (ret)
558 		return;
559 	if (onoff == 0)
560 		sdio_uart_clear_mctrl(port, TIOCM_DTR | TIOCM_RTS);
561 	else
562 		sdio_uart_set_mctrl(port, TIOCM_DTR | TIOCM_RTS);
563 	sdio_uart_release_func(port);
564 }
565 
566 /**
567  *	sdio_uart_activate	-	start up hardware
568  *	@tport: tty port to activate
569  *	@tty: tty bound to this port
570  *
571  *	Activate a tty port. The port locking guarantees us this will be
572  *	run exactly once per set of opens, and if successful will see the
573  *	shutdown method run exactly once to match. Start up and shutdown are
574  *	protected from each other by the internal locking and will not run
575  *	at the same time even during a hangup event.
576  *
577  *	If we successfully start up the port we take an extra kref as we
578  *	will keep it around until shutdown when the kref is dropped.
579  */
580 
581 static int sdio_uart_activate(struct tty_port *tport, struct tty_struct *tty)
582 {
583 	struct sdio_uart_port *port =
584 			container_of(tport, struct sdio_uart_port, port);
585 	int ret;
586 
587 	/*
588 	 * Set the TTY IO error marker - we will only clear this
589 	 * once we have successfully opened the port.
590 	 */
591 	set_bit(TTY_IO_ERROR, &tty->flags);
592 
593 	kfifo_reset(&port->xmit_fifo);
594 
595 	ret = sdio_uart_claim_func(port);
596 	if (ret)
597 		return ret;
598 	ret = sdio_enable_func(port->func);
599 	if (ret)
600 		goto err1;
601 	ret = sdio_claim_irq(port->func, sdio_uart_irq);
602 	if (ret)
603 		goto err2;
604 
605 	/*
606 	 * Clear the FIFO buffers and disable them.
607 	 * (they will be reenabled in sdio_change_speed())
608 	 */
609 	sdio_out(port, UART_FCR, UART_FCR_ENABLE_FIFO);
610 	sdio_out(port, UART_FCR, UART_FCR_ENABLE_FIFO |
611 		       UART_FCR_CLEAR_RCVR | UART_FCR_CLEAR_XMIT);
612 	sdio_out(port, UART_FCR, 0);
613 
614 	/*
615 	 * Clear the interrupt registers.
616 	 */
617 	(void) sdio_in(port, UART_LSR);
618 	(void) sdio_in(port, UART_RX);
619 	(void) sdio_in(port, UART_IIR);
620 	(void) sdio_in(port, UART_MSR);
621 
622 	/*
623 	 * Now, initialize the UART
624 	 */
625 	sdio_out(port, UART_LCR, UART_LCR_WLEN8);
626 
627 	port->ier = UART_IER_RLSI|UART_IER_RDI|UART_IER_RTOIE|UART_IER_UUE;
628 	port->mctrl = TIOCM_OUT2;
629 
630 	sdio_uart_change_speed(port, &tty->termios, NULL);
631 
632 	if (C_BAUD(tty))
633 		sdio_uart_set_mctrl(port, TIOCM_RTS | TIOCM_DTR);
634 
635 	if (C_CRTSCTS(tty))
636 		if (!(sdio_uart_get_mctrl(port) & TIOCM_CTS))
637 			tty->hw_stopped = 1;
638 
639 	clear_bit(TTY_IO_ERROR, &tty->flags);
640 
641 	/* Kick the IRQ handler once while we're still holding the host lock */
642 	sdio_uart_irq(port->func);
643 
644 	sdio_uart_release_func(port);
645 	return 0;
646 
647 err2:
648 	sdio_disable_func(port->func);
649 err1:
650 	sdio_uart_release_func(port);
651 	return ret;
652 }
653 
654 /**
655  *	sdio_uart_shutdown	-	stop hardware
656  *	@tport: tty port to shut down
657  *
658  *	Deactivate a tty port. The port locking guarantees us this will be
659  *	run only if a successful matching activate already ran. The two are
660  *	protected from each other by the internal locking and will not run
661  *	at the same time even during a hangup event.
662  */
663 
664 static void sdio_uart_shutdown(struct tty_port *tport)
665 {
666 	struct sdio_uart_port *port =
667 			container_of(tport, struct sdio_uart_port, port);
668 	int ret;
669 
670 	ret = sdio_uart_claim_func(port);
671 	if (ret)
672 		return;
673 
674 	sdio_uart_stop_rx(port);
675 
676 	/* Disable interrupts from this port */
677 	sdio_release_irq(port->func);
678 	port->ier = 0;
679 	sdio_out(port, UART_IER, 0);
680 
681 	sdio_uart_clear_mctrl(port, TIOCM_OUT2);
682 
683 	/* Disable break condition and FIFOs. */
684 	port->lcr &= ~UART_LCR_SBC;
685 	sdio_out(port, UART_LCR, port->lcr);
686 	sdio_out(port, UART_FCR, UART_FCR_ENABLE_FIFO |
687 				 UART_FCR_CLEAR_RCVR |
688 				 UART_FCR_CLEAR_XMIT);
689 	sdio_out(port, UART_FCR, 0);
690 
691 	sdio_disable_func(port->func);
692 
693 	sdio_uart_release_func(port);
694 }
695 
696 static void sdio_uart_port_destroy(struct tty_port *tport)
697 {
698 	struct sdio_uart_port *port =
699 		container_of(tport, struct sdio_uart_port, port);
700 	kfifo_free(&port->xmit_fifo);
701 	kfree(port);
702 }
703 
704 /**
705  *	sdio_uart_install	-	install method
706  *	@driver: the driver in use (sdio_uart in our case)
707  *	@tty: the tty being bound
708  *
709  *	Look up and bind the tty and the driver together. Initialize
710  *	any needed private data (in our case the termios)
711  */
712 
713 static int sdio_uart_install(struct tty_driver *driver, struct tty_struct *tty)
714 {
715 	int idx = tty->index;
716 	struct sdio_uart_port *port = sdio_uart_port_get(idx);
717 	int ret = tty_standard_install(driver, tty);
718 
719 	if (ret == 0)
720 		/* This is the ref sdio_uart_port get provided */
721 		tty->driver_data = port;
722 	else
723 		sdio_uart_port_put(port);
724 	return ret;
725 }
726 
727 /**
728  *	sdio_uart_cleanup	-	called on the last tty kref drop
729  *	@tty: the tty being destroyed
730  *
731  *	Called asynchronously when the last reference to the tty is dropped.
732  *	We cannot destroy the tty->driver_data port kref until this point
733  */
734 
735 static void sdio_uart_cleanup(struct tty_struct *tty)
736 {
737 	struct sdio_uart_port *port = tty->driver_data;
738 	tty->driver_data = NULL;	/* Bug trap */
739 	sdio_uart_port_put(port);
740 }
741 
742 /*
743  *	Open/close/hangup is now entirely boilerplate
744  */
745 
746 static int sdio_uart_open(struct tty_struct *tty, struct file *filp)
747 {
748 	struct sdio_uart_port *port = tty->driver_data;
749 	return tty_port_open(&port->port, tty, filp);
750 }
751 
752 static void sdio_uart_close(struct tty_struct *tty, struct file * filp)
753 {
754 	struct sdio_uart_port *port = tty->driver_data;
755 	tty_port_close(&port->port, tty, filp);
756 }
757 
758 static void sdio_uart_hangup(struct tty_struct *tty)
759 {
760 	struct sdio_uart_port *port = tty->driver_data;
761 	tty_port_hangup(&port->port);
762 }
763 
764 static int sdio_uart_write(struct tty_struct *tty, const unsigned char *buf,
765 			   int count)
766 {
767 	struct sdio_uart_port *port = tty->driver_data;
768 	int ret;
769 
770 	if (!port->func)
771 		return -ENODEV;
772 
773 	ret = kfifo_in_locked(&port->xmit_fifo, buf, count, &port->write_lock);
774 	if (!(port->ier & UART_IER_THRI)) {
775 		int err = sdio_uart_claim_func(port);
776 		if (!err) {
777 			sdio_uart_start_tx(port);
778 			sdio_uart_irq(port->func);
779 			sdio_uart_release_func(port);
780 		} else
781 			ret = err;
782 	}
783 
784 	return ret;
785 }
786 
787 static unsigned int sdio_uart_write_room(struct tty_struct *tty)
788 {
789 	struct sdio_uart_port *port = tty->driver_data;
790 	return FIFO_SIZE - kfifo_len(&port->xmit_fifo);
791 }
792 
793 static unsigned int sdio_uart_chars_in_buffer(struct tty_struct *tty)
794 {
795 	struct sdio_uart_port *port = tty->driver_data;
796 	return kfifo_len(&port->xmit_fifo);
797 }
798 
799 static void sdio_uart_send_xchar(struct tty_struct *tty, char ch)
800 {
801 	struct sdio_uart_port *port = tty->driver_data;
802 
803 	port->x_char = ch;
804 	if (ch && !(port->ier & UART_IER_THRI)) {
805 		if (sdio_uart_claim_func(port) != 0)
806 			return;
807 		sdio_uart_start_tx(port);
808 		sdio_uart_irq(port->func);
809 		sdio_uart_release_func(port);
810 	}
811 }
812 
813 static void sdio_uart_throttle(struct tty_struct *tty)
814 {
815 	struct sdio_uart_port *port = tty->driver_data;
816 
817 	if (!I_IXOFF(tty) && !C_CRTSCTS(tty))
818 		return;
819 
820 	if (sdio_uart_claim_func(port) != 0)
821 		return;
822 
823 	if (I_IXOFF(tty)) {
824 		port->x_char = STOP_CHAR(tty);
825 		sdio_uart_start_tx(port);
826 	}
827 
828 	if (C_CRTSCTS(tty))
829 		sdio_uart_clear_mctrl(port, TIOCM_RTS);
830 
831 	sdio_uart_irq(port->func);
832 	sdio_uart_release_func(port);
833 }
834 
835 static void sdio_uart_unthrottle(struct tty_struct *tty)
836 {
837 	struct sdio_uart_port *port = tty->driver_data;
838 
839 	if (!I_IXOFF(tty) && !C_CRTSCTS(tty))
840 		return;
841 
842 	if (sdio_uart_claim_func(port) != 0)
843 		return;
844 
845 	if (I_IXOFF(tty)) {
846 		if (port->x_char) {
847 			port->x_char = 0;
848 		} else {
849 			port->x_char = START_CHAR(tty);
850 			sdio_uart_start_tx(port);
851 		}
852 	}
853 
854 	if (C_CRTSCTS(tty))
855 		sdio_uart_set_mctrl(port, TIOCM_RTS);
856 
857 	sdio_uart_irq(port->func);
858 	sdio_uart_release_func(port);
859 }
860 
861 static void sdio_uart_set_termios(struct tty_struct *tty,
862 				  const struct ktermios *old_termios)
863 {
864 	struct sdio_uart_port *port = tty->driver_data;
865 	unsigned int cflag = tty->termios.c_cflag;
866 
867 	if (sdio_uart_claim_func(port) != 0)
868 		return;
869 
870 	sdio_uart_change_speed(port, &tty->termios, old_termios);
871 
872 	/* Handle transition to B0 status */
873 	if ((old_termios->c_cflag & CBAUD) && !(cflag & CBAUD))
874 		sdio_uart_clear_mctrl(port, TIOCM_RTS | TIOCM_DTR);
875 
876 	/* Handle transition away from B0 status */
877 	if (!(old_termios->c_cflag & CBAUD) && (cflag & CBAUD)) {
878 		unsigned int mask = TIOCM_DTR;
879 		if (!(cflag & CRTSCTS) || !tty_throttled(tty))
880 			mask |= TIOCM_RTS;
881 		sdio_uart_set_mctrl(port, mask);
882 	}
883 
884 	/* Handle turning off CRTSCTS */
885 	if ((old_termios->c_cflag & CRTSCTS) && !(cflag & CRTSCTS)) {
886 		tty->hw_stopped = 0;
887 		sdio_uart_start_tx(port);
888 	}
889 
890 	/* Handle turning on CRTSCTS */
891 	if (!(old_termios->c_cflag & CRTSCTS) && (cflag & CRTSCTS)) {
892 		if (!(sdio_uart_get_mctrl(port) & TIOCM_CTS)) {
893 			tty->hw_stopped = 1;
894 			sdio_uart_stop_tx(port);
895 		}
896 	}
897 
898 	sdio_uart_release_func(port);
899 }
900 
901 static int sdio_uart_break_ctl(struct tty_struct *tty, int break_state)
902 {
903 	struct sdio_uart_port *port = tty->driver_data;
904 	int result;
905 
906 	result = sdio_uart_claim_func(port);
907 	if (result != 0)
908 		return result;
909 
910 	if (break_state == -1)
911 		port->lcr |= UART_LCR_SBC;
912 	else
913 		port->lcr &= ~UART_LCR_SBC;
914 	sdio_out(port, UART_LCR, port->lcr);
915 
916 	sdio_uart_release_func(port);
917 	return 0;
918 }
919 
920 static int sdio_uart_tiocmget(struct tty_struct *tty)
921 {
922 	struct sdio_uart_port *port = tty->driver_data;
923 	int result;
924 
925 	result = sdio_uart_claim_func(port);
926 	if (!result) {
927 		result = port->mctrl | sdio_uart_get_mctrl(port);
928 		sdio_uart_release_func(port);
929 	}
930 
931 	return result;
932 }
933 
934 static int sdio_uart_tiocmset(struct tty_struct *tty,
935 			      unsigned int set, unsigned int clear)
936 {
937 	struct sdio_uart_port *port = tty->driver_data;
938 	int result;
939 
940 	result = sdio_uart_claim_func(port);
941 	if (!result) {
942 		sdio_uart_update_mctrl(port, set, clear);
943 		sdio_uart_release_func(port);
944 	}
945 
946 	return result;
947 }
948 
949 static int sdio_uart_proc_show(struct seq_file *m, void *v)
950 {
951 	int i;
952 
953 	seq_printf(m, "serinfo:1.0 driver%s%s revision:%s\n",
954 		       "", "", "");
955 	for (i = 0; i < UART_NR; i++) {
956 		struct sdio_uart_port *port = sdio_uart_port_get(i);
957 		if (port) {
958 			seq_printf(m, "%d: uart:SDIO", i);
959 			if (capable(CAP_SYS_ADMIN)) {
960 				seq_printf(m, " tx:%d rx:%d",
961 					      port->icount.tx, port->icount.rx);
962 				if (port->icount.frame)
963 					seq_printf(m, " fe:%d",
964 						      port->icount.frame);
965 				if (port->icount.parity)
966 					seq_printf(m, " pe:%d",
967 						      port->icount.parity);
968 				if (port->icount.brk)
969 					seq_printf(m, " brk:%d",
970 						      port->icount.brk);
971 				if (port->icount.overrun)
972 					seq_printf(m, " oe:%d",
973 						      port->icount.overrun);
974 				if (port->icount.cts)
975 					seq_printf(m, " cts:%d",
976 						      port->icount.cts);
977 				if (port->icount.dsr)
978 					seq_printf(m, " dsr:%d",
979 						      port->icount.dsr);
980 				if (port->icount.rng)
981 					seq_printf(m, " rng:%d",
982 						      port->icount.rng);
983 				if (port->icount.dcd)
984 					seq_printf(m, " dcd:%d",
985 						      port->icount.dcd);
986 			}
987 			sdio_uart_port_put(port);
988 			seq_putc(m, '\n');
989 		}
990 	}
991 	return 0;
992 }
993 
994 static const struct tty_port_operations sdio_uart_port_ops = {
995 	.dtr_rts = uart_dtr_rts,
996 	.carrier_raised = uart_carrier_raised,
997 	.shutdown = sdio_uart_shutdown,
998 	.activate = sdio_uart_activate,
999 	.destruct = sdio_uart_port_destroy,
1000 };
1001 
1002 static const struct tty_operations sdio_uart_ops = {
1003 	.open			= sdio_uart_open,
1004 	.close			= sdio_uart_close,
1005 	.write			= sdio_uart_write,
1006 	.write_room		= sdio_uart_write_room,
1007 	.chars_in_buffer	= sdio_uart_chars_in_buffer,
1008 	.send_xchar		= sdio_uart_send_xchar,
1009 	.throttle		= sdio_uart_throttle,
1010 	.unthrottle		= sdio_uart_unthrottle,
1011 	.set_termios		= sdio_uart_set_termios,
1012 	.hangup			= sdio_uart_hangup,
1013 	.break_ctl		= sdio_uart_break_ctl,
1014 	.tiocmget		= sdio_uart_tiocmget,
1015 	.tiocmset		= sdio_uart_tiocmset,
1016 	.install		= sdio_uart_install,
1017 	.cleanup		= sdio_uart_cleanup,
1018 	.proc_show		= sdio_uart_proc_show,
1019 };
1020 
1021 static struct tty_driver *sdio_uart_tty_driver;
1022 
1023 static int sdio_uart_probe(struct sdio_func *func,
1024 			   const struct sdio_device_id *id)
1025 {
1026 	struct sdio_uart_port *port;
1027 	int ret;
1028 
1029 	port = kzalloc(sizeof(struct sdio_uart_port), GFP_KERNEL);
1030 	if (!port)
1031 		return -ENOMEM;
1032 
1033 	if (func->class == SDIO_CLASS_UART) {
1034 		pr_warn("%s: need info on UART class basic setup\n",
1035 			sdio_func_id(func));
1036 		kfree(port);
1037 		return -ENOSYS;
1038 	} else if (func->class == SDIO_CLASS_GPS) {
1039 		/*
1040 		 * We need tuple 0x91.  It contains SUBTPL_SIOREG
1041 		 * and SUBTPL_RCVCAPS.
1042 		 */
1043 		struct sdio_func_tuple *tpl;
1044 		for (tpl = func->tuples; tpl; tpl = tpl->next) {
1045 			if (tpl->code != 0x91)
1046 				continue;
1047 			if (tpl->size < 10)
1048 				continue;
1049 			if (tpl->data[1] == 0)  /* SUBTPL_SIOREG */
1050 				break;
1051 		}
1052 		if (!tpl) {
1053 			pr_warn("%s: can't find tuple 0x91 subtuple 0 (SUBTPL_SIOREG) for GPS class\n",
1054 				sdio_func_id(func));
1055 			kfree(port);
1056 			return -EINVAL;
1057 		}
1058 		pr_debug("%s: Register ID = 0x%02x, Exp ID = 0x%02x\n",
1059 		       sdio_func_id(func), tpl->data[2], tpl->data[3]);
1060 		port->regs_offset = (tpl->data[4] << 0) |
1061 				    (tpl->data[5] << 8) |
1062 				    (tpl->data[6] << 16);
1063 		pr_debug("%s: regs offset = 0x%x\n",
1064 		       sdio_func_id(func), port->regs_offset);
1065 		port->uartclk = tpl->data[7] * 115200;
1066 		if (port->uartclk == 0)
1067 			port->uartclk = 115200;
1068 		pr_debug("%s: clk %d baudcode %u 4800-div %u\n",
1069 		       sdio_func_id(func), port->uartclk,
1070 		       tpl->data[7], tpl->data[8] | (tpl->data[9] << 8));
1071 	} else {
1072 		kfree(port);
1073 		return -EINVAL;
1074 	}
1075 
1076 	port->func = func;
1077 	sdio_set_drvdata(func, port);
1078 	tty_port_init(&port->port);
1079 	port->port.ops = &sdio_uart_port_ops;
1080 
1081 	ret = sdio_uart_add_port(port);
1082 	if (ret) {
1083 		kfree(port);
1084 	} else {
1085 		struct device *dev;
1086 		dev = tty_port_register_device(&port->port,
1087 				sdio_uart_tty_driver, port->index, &func->dev);
1088 		if (IS_ERR(dev)) {
1089 			sdio_uart_port_remove(port);
1090 			ret = PTR_ERR(dev);
1091 		}
1092 	}
1093 
1094 	return ret;
1095 }
1096 
1097 static void sdio_uart_remove(struct sdio_func *func)
1098 {
1099 	struct sdio_uart_port *port = sdio_get_drvdata(func);
1100 
1101 	tty_unregister_device(sdio_uart_tty_driver, port->index);
1102 	sdio_uart_port_remove(port);
1103 }
1104 
1105 static const struct sdio_device_id sdio_uart_ids[] = {
1106 	{ SDIO_DEVICE_CLASS(SDIO_CLASS_UART)		},
1107 	{ SDIO_DEVICE_CLASS(SDIO_CLASS_GPS)		},
1108 	{ /* end: all zeroes */				},
1109 };
1110 
1111 MODULE_DEVICE_TABLE(sdio, sdio_uart_ids);
1112 
1113 static struct sdio_driver sdio_uart_driver = {
1114 	.probe		= sdio_uart_probe,
1115 	.remove		= sdio_uart_remove,
1116 	.name		= "sdio_uart",
1117 	.id_table	= sdio_uart_ids,
1118 };
1119 
1120 static int __init sdio_uart_init(void)
1121 {
1122 	int ret;
1123 	struct tty_driver *tty_drv;
1124 
1125 	sdio_uart_tty_driver = tty_drv = tty_alloc_driver(UART_NR,
1126 			TTY_DRIVER_REAL_RAW | TTY_DRIVER_DYNAMIC_DEV);
1127 	if (IS_ERR(tty_drv))
1128 		return PTR_ERR(tty_drv);
1129 
1130 	tty_drv->driver_name = "sdio_uart";
1131 	tty_drv->name =   "ttySDIO";
1132 	tty_drv->major = 0;  /* dynamically allocated */
1133 	tty_drv->minor_start = 0;
1134 	tty_drv->type = TTY_DRIVER_TYPE_SERIAL;
1135 	tty_drv->subtype = SERIAL_TYPE_NORMAL;
1136 	tty_drv->init_termios = tty_std_termios;
1137 	tty_drv->init_termios.c_cflag = B4800 | CS8 | CREAD | HUPCL | CLOCAL;
1138 	tty_drv->init_termios.c_ispeed = 4800;
1139 	tty_drv->init_termios.c_ospeed = 4800;
1140 	tty_set_operations(tty_drv, &sdio_uart_ops);
1141 
1142 	ret = tty_register_driver(tty_drv);
1143 	if (ret)
1144 		goto err1;
1145 
1146 	ret = sdio_register_driver(&sdio_uart_driver);
1147 	if (ret)
1148 		goto err2;
1149 
1150 	return 0;
1151 
1152 err2:
1153 	tty_unregister_driver(tty_drv);
1154 err1:
1155 	tty_driver_kref_put(tty_drv);
1156 	return ret;
1157 }
1158 
1159 static void __exit sdio_uart_exit(void)
1160 {
1161 	sdio_unregister_driver(&sdio_uart_driver);
1162 	tty_unregister_driver(sdio_uart_tty_driver);
1163 	tty_driver_kref_put(sdio_uart_tty_driver);
1164 }
1165 
1166 module_init(sdio_uart_init);
1167 module_exit(sdio_uart_exit);
1168 
1169 MODULE_AUTHOR("Nicolas Pitre");
1170 MODULE_LICENSE("GPL");
1171