2 * File: linux/drivers/serial/bfin_sport_uart.c
4 * Based on: drivers/serial/bfin_5xx.c by Aubrey Li.
5 * Author: Roy Huang <roy.huang@analog.com>
7 * Created: Nov 22, 2006
8 * Copyright: (c) 2006-2007 Analog Devices Inc.
9 * Description: this driver enable SPORTs on Blackfin emulate UART.
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this program; if not, see the file COPYING, or write
23 * to the Free Software Foundation, Inc.,
24 * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
28 * This driver and the hardware supported are in term of EE-191 of ADI.
29 * http://www.analog.com/UploadedFiles/Application_Notes/399447663EE191.pdf
30 * This application note describe how to implement a UART on a Sharc DSP,
31 * but this driver is implemented on Blackfin Processor.
34 /* After reset, there is a prelude of low level pulse when transmit data first
35 * time. No addtional pulse in following transmit.
36 * According to document:
37 * The SPORTs are ready to start transmitting or receiving data no later than
38 * three serial clock cycles after they are enabled in the SPORTx_TCR1 or
39 * SPORTx_RCR1 register. No serial clock cycles are lost from this point on.
40 * The first internal frame sync will occur one frame sync delay after the
41 * SPORTs are ready. External frame syncs can occur as soon as the SPORT is
45 /* Thanks to Axel Alatalo <axel@rubico.se> for fixing sport rx bug. Sometimes
46 * sport receives data incorrectly. The following is Axel's words.
47 * As EE-191, sport rx samples 3 times of the UART baudrate and takes the
48 * middle smaple of every 3 samples as the data bit. For a 8-N-1 UART setting,
49 * 30 samples will be required for a byte. If transmitter sends a 1/3 bit short
50 * byte due to buadrate drift, then the 30th sample of a byte, this sample is
51 * also the third sample of the stop bit, will happens on the immediately
52 * following start bit which will be thrown away and missed. Thus since parts
53 * of the startbit will be missed and the receiver will begin to drift, the
54 * effect accumulates over time until synchronization is lost.
55 * If only require 2 samples of the stopbit (by sampling in total 29 samples),
56 * then a to short byte as in the case above will be tolerated. Then the 1/3
57 * early startbit will trigger a framesync since the last read is complete
58 * after only 2/3 stopbit and framesync is active during the last 1/3 looking
59 * for a possible early startbit. */
63 #include <linux/module.h>
64 #include <linux/ioport.h>
65 #include <linux/init.h>
66 #include <linux/console.h>
67 #include <linux/sysrq.h>
68 #include <linux/platform_device.h>
69 #include <linux/tty.h>
70 #include <linux/tty_flip.h>
71 #include <linux/serial_core.h>
73 #include <asm/delay.h>
74 #include <asm/portmux.h>
76 #include "bfin_sport_uart.h"
78 unsigned short bfin_uart_pin_req_sport0[] =
79 {P_SPORT0_TFS, P_SPORT0_DTPRI, P_SPORT0_TSCLK, P_SPORT0_RFS, \
80 P_SPORT0_DRPRI, P_SPORT0_RSCLK, P_SPORT0_DRSEC, P_SPORT0_DTSEC, 0};
82 unsigned short bfin_uart_pin_req_sport1[] =
83 {P_SPORT1_TFS, P_SPORT1_DTPRI, P_SPORT1_TSCLK, P_SPORT1_RFS, \
84 P_SPORT1_DRPRI, P_SPORT1_RSCLK, P_SPORT1_DRSEC, P_SPORT1_DTSEC, 0};
86 #define DRV_NAME "bfin-sport-uart"
88 struct sport_uart_port {
89 struct uart_port port;
97 static void sport_uart_tx_chars(struct sport_uart_port *up);
98 static void sport_stop_tx(struct uart_port *port);
100 static inline void tx_one_byte(struct sport_uart_port *up, unsigned int value)
102 pr_debug("%s value:%x\n", __func__, value);
103 /* Place a Start and Stop bit */
104 __asm__ __volatile__ (
105 "R2 = b#01111111100;"
106 "R3 = b#10000000001;"
112 : "ASTAT", "R2", "R3"
114 pr_debug("%s value:%x\n", __func__, value);
116 SPORT_PUT_TX(up, value);
119 static inline unsigned int rx_one_byte(struct sport_uart_port *up)
121 unsigned int value, extract;
122 u32 tmp_mask1, tmp_mask2, tmp_shift, tmp;
124 value = SPORT_GET_RX32(up);
125 pr_debug("%s value:%x\n", __func__, value);
127 /* Extract 8 bits data */
128 __asm__ __volatile__ (
130 "%[mask1] = 0x1801(Z);"
131 "%[mask2] = 0x0300(Z);"
133 "LSETUP(.Lloop_s, .Lloop_e) LC0 = %[lc];"
135 "%[tmp] = extract(%[val], %[mask1].L)(Z);"
136 "%[tmp] <<= %[shift];"
137 "%[extr] = %[extr] | %[tmp];"
138 "%[mask1] = %[mask1] - %[mask2];"
141 : [val]"=d"(value), [extr]"=d"(extract), [shift]"=d"(tmp_shift), [tmp]"=d"(tmp),
142 [mask1]"=d"(tmp_mask1), [mask2]"=d"(tmp_mask2)
143 : "d"(value), [lc]"a"(8)
144 : "ASTAT", "LB0", "LC0", "LT0"
147 pr_debug(" extract:%x\n", extract);
151 static int sport_uart_setup(struct sport_uart_port *up, int sclk, int baud_rate)
153 int tclkdiv, tfsdiv, rclkdiv;
155 /* Set TCR1 and TCR2 */
156 SPORT_PUT_TCR1(up, (LATFS | ITFS | TFSR | TLSBIT | ITCLK));
157 SPORT_PUT_TCR2(up, 10);
158 pr_debug("%s TCR1:%x, TCR2:%x\n", __func__, SPORT_GET_TCR1(up), SPORT_GET_TCR2(up));
160 /* Set RCR1 and RCR2 */
161 SPORT_PUT_RCR1(up, (RCKFE | LARFS | LRFS | RFSR | IRCLK));
162 SPORT_PUT_RCR2(up, 28);
163 pr_debug("%s RCR1:%x, RCR2:%x\n", __func__, SPORT_GET_RCR1(up), SPORT_GET_RCR2(up));
165 tclkdiv = sclk/(2 * baud_rate) - 1;
167 rclkdiv = sclk/(2 * baud_rate * 3) - 1;
168 SPORT_PUT_TCLKDIV(up, tclkdiv);
169 SPORT_PUT_TFSDIV(up, tfsdiv);
170 SPORT_PUT_RCLKDIV(up, rclkdiv);
172 pr_debug("%s sclk:%d, baud_rate:%d, tclkdiv:%d, tfsdiv:%d, rclkdiv:%d\n",
173 __func__, sclk, baud_rate, tclkdiv, tfsdiv, rclkdiv);
178 static irqreturn_t sport_uart_rx_irq(int irq, void *dev_id)
180 struct sport_uart_port *up = dev_id;
181 struct tty_struct *tty = up->port.info->port.tty;
185 ch = rx_one_byte(up);
186 up->port.icount.rx++;
188 if (uart_handle_sysrq_char(&up->port, ch))
191 tty_insert_flip_char(tty, ch, TTY_NORMAL);
192 } while (SPORT_GET_STAT(up) & RXNE);
193 tty_flip_buffer_push(tty);
198 static irqreturn_t sport_uart_tx_irq(int irq, void *dev_id)
200 sport_uart_tx_chars(dev_id);
205 static irqreturn_t sport_uart_err_irq(int irq, void *dev_id)
207 struct sport_uart_port *up = dev_id;
208 struct tty_struct *tty = up->port.info->port.tty;
209 unsigned int stat = SPORT_GET_STAT(up);
211 /* Overflow in RX FIFO */
213 up->port.icount.overrun++;
214 tty_insert_flip_char(tty, 0, TTY_OVERRUN);
215 SPORT_PUT_STAT(up, ROVF); /* Clear ROVF bit */
217 /* These should not happen */
218 if (stat & (TOVF | TUVF | RUVF)) {
219 printk(KERN_ERR "SPORT Error:%s %s %s\n",
220 (stat & TOVF)?"TX overflow":"",
221 (stat & TUVF)?"TX underflow":"",
222 (stat & RUVF)?"RX underflow":"");
223 SPORT_PUT_TCR1(up, SPORT_GET_TCR1(up) & ~TSPEN);
224 SPORT_PUT_RCR1(up, SPORT_GET_RCR1(up) & ~RSPEN);
231 /* Reqeust IRQ, Setup clock */
232 static int sport_startup(struct uart_port *port)
234 struct sport_uart_port *up = (struct sport_uart_port *)port;
238 pr_debug("%s enter\n", __func__);
239 memset(buffer, 20, '\0');
240 snprintf(buffer, 20, "%s rx", up->name);
241 retval = request_irq(up->rx_irq, sport_uart_rx_irq, IRQF_SAMPLE_RANDOM, buffer, up);
243 printk(KERN_ERR "Unable to request interrupt %s\n", buffer);
247 snprintf(buffer, 20, "%s tx", up->name);
248 retval = request_irq(up->tx_irq, sport_uart_tx_irq, IRQF_SAMPLE_RANDOM, buffer, up);
250 printk(KERN_ERR "Unable to request interrupt %s\n", buffer);
254 snprintf(buffer, 20, "%s err", up->name);
255 retval = request_irq(up->err_irq, sport_uart_err_irq, IRQF_SAMPLE_RANDOM, buffer, up);
257 printk(KERN_ERR "Unable to request interrupt %s\n", buffer);
262 if (peripheral_request_list(bfin_uart_pin_req_sport1, DRV_NAME))
265 if (peripheral_request_list(bfin_uart_pin_req_sport0, DRV_NAME))
269 sport_uart_setup(up, get_sclk(), port->uartclk);
271 /* Enable receive interrupt */
272 SPORT_PUT_RCR1(up, (SPORT_GET_RCR1(up) | RSPEN));
279 printk(KERN_ERR DRV_NAME
280 ": Requesting Peripherals failed\n");
282 free_irq(up->err_irq, up);
284 free_irq(up->tx_irq, up);
286 free_irq(up->rx_irq, up);
292 static void sport_uart_tx_chars(struct sport_uart_port *up)
294 struct circ_buf *xmit = &up->port.info->xmit;
296 if (SPORT_GET_STAT(up) & TXF)
299 if (up->port.x_char) {
300 tx_one_byte(up, up->port.x_char);
301 up->port.icount.tx++;
306 if (uart_circ_empty(xmit) || uart_tx_stopped(&up->port)) {
307 sport_stop_tx(&up->port);
311 while(!(SPORT_GET_STAT(up) & TXF) && !uart_circ_empty(xmit)) {
312 tx_one_byte(up, xmit->buf[xmit->tail]);
313 xmit->tail = (xmit->tail + 1) & (UART_XMIT_SIZE -1);
314 up->port.icount.tx++;
317 if (uart_circ_chars_pending(xmit) < WAKEUP_CHARS)
318 uart_write_wakeup(&up->port);
321 static unsigned int sport_tx_empty(struct uart_port *port)
323 struct sport_uart_port *up = (struct sport_uart_port *)port;
326 stat = SPORT_GET_STAT(up);
327 pr_debug("%s stat:%04x\n", __func__, stat);
334 static unsigned int sport_get_mctrl(struct uart_port *port)
336 pr_debug("%s enter\n", __func__);
337 return (TIOCM_CTS | TIOCM_CD | TIOCM_DSR);
340 static void sport_set_mctrl(struct uart_port *port, unsigned int mctrl)
342 pr_debug("%s enter\n", __func__);
345 static void sport_stop_tx(struct uart_port *port)
347 struct sport_uart_port *up = (struct sport_uart_port *)port;
350 pr_debug("%s enter\n", __func__);
352 stat = SPORT_GET_STAT(up);
353 while(!(stat & TXHRE)) {
355 stat = SPORT_GET_STAT(up);
357 /* Although the hold register is empty, last byte is still in shift
358 * register and not sent out yet. If baud rate is lower than default,
359 * delay should be longer. For example, if the baud rate is 9600,
360 * the delay must be at least 2ms by experience */
363 SPORT_PUT_TCR1(up, (SPORT_GET_TCR1(up) & ~TSPEN));
369 static void sport_start_tx(struct uart_port *port)
371 struct sport_uart_port *up = (struct sport_uart_port *)port;
373 pr_debug("%s enter\n", __func__);
374 /* Write data into SPORT FIFO before enable SPROT to transmit */
375 sport_uart_tx_chars(up);
377 /* Enable transmit, then an interrupt will generated */
378 SPORT_PUT_TCR1(up, (SPORT_GET_TCR1(up) | TSPEN));
380 pr_debug("%s exit\n", __func__);
383 static void sport_stop_rx(struct uart_port *port)
385 struct sport_uart_port *up = (struct sport_uart_port *)port;
387 pr_debug("%s enter\n", __func__);
388 /* Disable sport to stop rx */
389 SPORT_PUT_RCR1(up, (SPORT_GET_RCR1(up) & ~RSPEN));
393 static void sport_enable_ms(struct uart_port *port)
395 pr_debug("%s enter\n", __func__);
398 static void sport_break_ctl(struct uart_port *port, int break_state)
400 pr_debug("%s enter\n", __func__);
403 static void sport_shutdown(struct uart_port *port)
405 struct sport_uart_port *up = (struct sport_uart_port *)port;
407 pr_debug("%s enter\n", __func__);
410 SPORT_PUT_TCR1(up, (SPORT_GET_TCR1(up) & ~TSPEN));
411 SPORT_PUT_RCR1(up, (SPORT_GET_RCR1(up) & ~RSPEN));
415 peripheral_free_list(bfin_uart_pin_req_sport1);
417 peripheral_free_list(bfin_uart_pin_req_sport0);
420 free_irq(up->rx_irq, up);
421 free_irq(up->tx_irq, up);
422 free_irq(up->err_irq, up);
425 static void sport_set_termios(struct uart_port *port,
426 struct ktermios *termios, struct ktermios *old)
428 pr_debug("%s enter, c_cflag:%08x\n", __func__, termios->c_cflag);
429 uart_update_timeout(port, CS8 ,port->uartclk);
432 static const char *sport_type(struct uart_port *port)
434 struct sport_uart_port *up = (struct sport_uart_port *)port;
436 pr_debug("%s enter\n", __func__);
440 static void sport_release_port(struct uart_port *port)
442 pr_debug("%s enter\n", __func__);
445 static int sport_request_port(struct uart_port *port)
447 pr_debug("%s enter\n", __func__);
451 static void sport_config_port(struct uart_port *port, int flags)
453 struct sport_uart_port *up = (struct sport_uart_port *)port;
455 pr_debug("%s enter\n", __func__);
456 up->port.type = PORT_BFIN_SPORT;
459 static int sport_verify_port(struct uart_port *port, struct serial_struct *ser)
461 pr_debug("%s enter\n", __func__);
465 struct uart_ops sport_uart_ops = {
466 .tx_empty = sport_tx_empty,
467 .set_mctrl = sport_set_mctrl,
468 .get_mctrl = sport_get_mctrl,
469 .stop_tx = sport_stop_tx,
470 .start_tx = sport_start_tx,
471 .stop_rx = sport_stop_rx,
472 .enable_ms = sport_enable_ms,
473 .break_ctl = sport_break_ctl,
474 .startup = sport_startup,
475 .shutdown = sport_shutdown,
476 .set_termios = sport_set_termios,
478 .release_port = sport_release_port,
479 .request_port = sport_request_port,
480 .config_port = sport_config_port,
481 .verify_port = sport_verify_port,
484 static struct sport_uart_port sport_uart_ports[] = {
487 .tx_irq = IRQ_SPORT0_TX,
488 .rx_irq = IRQ_SPORT0_RX,
489 .err_irq= IRQ_SPORT0_ERROR,
491 .type = PORT_BFIN_SPORT,
493 .membase = (void __iomem *)SPORT0_TCR1,
494 .mapbase = SPORT0_TCR1,
495 .irq = IRQ_SPORT0_RX,
496 .uartclk = CONFIG_SPORT_BAUD_RATE,
498 .ops = &sport_uart_ops,
503 .tx_irq = IRQ_SPORT1_TX,
504 .rx_irq = IRQ_SPORT1_RX,
505 .err_irq= IRQ_SPORT1_ERROR,
507 .type = PORT_BFIN_SPORT,
509 .membase = (void __iomem *)SPORT1_TCR1,
510 .mapbase = SPORT1_TCR1,
511 .irq = IRQ_SPORT1_RX,
512 .uartclk = CONFIG_SPORT_BAUD_RATE,
514 .ops = &sport_uart_ops,
520 static struct uart_driver sport_uart_reg = {
521 .owner = THIS_MODULE,
522 .driver_name = "SPORT-UART",
526 .nr = ARRAY_SIZE(sport_uart_ports),
530 static int sport_uart_suspend(struct platform_device *dev, pm_message_t state)
532 struct sport_uart_port *sport = platform_get_drvdata(dev);
534 pr_debug("%s enter\n", __func__);
536 uart_suspend_port(&sport_uart_reg, &sport->port);
541 static int sport_uart_resume(struct platform_device *dev)
543 struct sport_uart_port *sport = platform_get_drvdata(dev);
545 pr_debug("%s enter\n", __func__);
547 uart_resume_port(&sport_uart_reg, &sport->port);
552 static int sport_uart_probe(struct platform_device *dev)
554 pr_debug("%s enter\n", __func__);
555 sport_uart_ports[dev->id].port.dev = &dev->dev;
556 uart_add_one_port(&sport_uart_reg, &sport_uart_ports[dev->id].port);
557 platform_set_drvdata(dev, &sport_uart_ports[dev->id]);
562 static int sport_uart_remove(struct platform_device *dev)
564 struct sport_uart_port *sport = platform_get_drvdata(dev);
566 pr_debug("%s enter\n", __func__);
567 platform_set_drvdata(dev, NULL);
570 uart_remove_one_port(&sport_uart_reg, &sport->port);
575 static struct platform_driver sport_uart_driver = {
576 .probe = sport_uart_probe,
577 .remove = sport_uart_remove,
578 .suspend = sport_uart_suspend,
579 .resume = sport_uart_resume,
585 static int __init sport_uart_init(void)
589 pr_debug("%s enter\n", __func__);
590 ret = uart_register_driver(&sport_uart_reg);
592 printk(KERN_ERR "Failed to register %s:%d\n",
593 sport_uart_reg.driver_name, ret);
597 ret = platform_driver_register(&sport_uart_driver);
599 printk(KERN_ERR "Failed to register sport uart driver:%d\n", ret);
600 uart_unregister_driver(&sport_uart_reg);
604 pr_debug("%s exit\n", __func__);
608 static void __exit sport_uart_exit(void)
610 pr_debug("%s enter\n", __func__);
611 platform_driver_unregister(&sport_uart_driver);
612 uart_unregister_driver(&sport_uart_reg);
615 module_init(sport_uart_init);
616 module_exit(sport_uart_exit);
618 MODULE_LICENSE("GPL");