2 * uartlite.c: Serial driver for Xilinx uartlite serial controller
4 * Copyright (C) 2006 Peter Korsgaard <jacmet@sunsite.dk>
5 * Copyright (C) 2007 Secret Lab Technologies Ltd.
7 * This file is licensed under the terms of the GNU General Public License
8 * version 2. This program is licensed "as is" without any warranty of any
9 * kind, whether express or implied.
12 #include <linux/platform_device.h>
13 #include <linux/module.h>
14 #include <linux/console.h>
15 #include <linux/serial.h>
16 #include <linux/serial_core.h>
17 #include <linux/tty.h>
18 #include <linux/delay.h>
19 #include <linux/interrupt.h>
20 #include <linux/init.h>
23 #include <linux/of_address.h>
24 #include <linux/of_device.h>
25 #include <linux/of_platform.h>
27 #define ULITE_NAME "ttyUL"
28 #define ULITE_MAJOR 204
29 #define ULITE_MINOR 187
30 #define ULITE_NR_UARTS 4
32 /* ---------------------------------------------------------------------
33 * Register definitions
35 * For register details see datasheet:
36 * http://www.xilinx.com/support/documentation/ip_documentation/opb_uartlite.pdf
41 #define ULITE_STATUS 0x08
42 #define ULITE_CONTROL 0x0c
44 #define ULITE_REGION 16
46 #define ULITE_STATUS_RXVALID 0x01
47 #define ULITE_STATUS_RXFULL 0x02
48 #define ULITE_STATUS_TXEMPTY 0x04
49 #define ULITE_STATUS_TXFULL 0x08
50 #define ULITE_STATUS_IE 0x10
51 #define ULITE_STATUS_OVERRUN 0x20
52 #define ULITE_STATUS_FRAME 0x40
53 #define ULITE_STATUS_PARITY 0x80
55 #define ULITE_CONTROL_RST_TX 0x01
56 #define ULITE_CONTROL_RST_RX 0x02
57 #define ULITE_CONTROL_IE 0x10
60 static struct uart_port ulite_ports
[ULITE_NR_UARTS
];
62 /* ---------------------------------------------------------------------
63 * Core UART driver operations
66 static int ulite_receive(struct uart_port
*port
, int stat
)
68 struct tty_struct
*tty
= port
->state
->port
.tty
;
70 char flag
= TTY_NORMAL
;
72 if ((stat
& (ULITE_STATUS_RXVALID
| ULITE_STATUS_OVERRUN
73 | ULITE_STATUS_FRAME
)) == 0)
77 if (stat
& ULITE_STATUS_RXVALID
) {
79 ch
= ioread32be(port
->membase
+ ULITE_RX
);
81 if (stat
& ULITE_STATUS_PARITY
)
82 port
->icount
.parity
++;
85 if (stat
& ULITE_STATUS_OVERRUN
)
86 port
->icount
.overrun
++;
88 if (stat
& ULITE_STATUS_FRAME
)
92 /* drop byte with parity error if IGNPAR specificed */
93 if (stat
& port
->ignore_status_mask
& ULITE_STATUS_PARITY
)
94 stat
&= ~ULITE_STATUS_RXVALID
;
96 stat
&= port
->read_status_mask
;
98 if (stat
& ULITE_STATUS_PARITY
)
102 stat
&= ~port
->ignore_status_mask
;
104 if (stat
& ULITE_STATUS_RXVALID
)
105 tty_insert_flip_char(tty
, ch
, flag
);
107 if (stat
& ULITE_STATUS_FRAME
)
108 tty_insert_flip_char(tty
, 0, TTY_FRAME
);
110 if (stat
& ULITE_STATUS_OVERRUN
)
111 tty_insert_flip_char(tty
, 0, TTY_OVERRUN
);
116 static int ulite_transmit(struct uart_port
*port
, int stat
)
118 struct circ_buf
*xmit
= &port
->state
->xmit
;
120 if (stat
& ULITE_STATUS_TXFULL
)
124 iowrite32be(port
->x_char
, port
->membase
+ ULITE_TX
);
130 if (uart_circ_empty(xmit
) || uart_tx_stopped(port
))
133 iowrite32be(xmit
->buf
[xmit
->tail
], port
->membase
+ ULITE_TX
);
134 xmit
->tail
= (xmit
->tail
+ 1) & (UART_XMIT_SIZE
-1);
138 if (uart_circ_chars_pending(xmit
) < WAKEUP_CHARS
)
139 uart_write_wakeup(port
);
144 static irqreturn_t
ulite_isr(int irq
, void *dev_id
)
146 struct uart_port
*port
= dev_id
;
150 int stat
= ioread32be(port
->membase
+ ULITE_STATUS
);
151 busy
= ulite_receive(port
, stat
);
152 busy
|= ulite_transmit(port
, stat
);
158 tty_flip_buffer_push(port
->state
->port
.tty
);
165 static unsigned int ulite_tx_empty(struct uart_port
*port
)
170 spin_lock_irqsave(&port
->lock
, flags
);
171 ret
= ioread32be(port
->membase
+ ULITE_STATUS
);
172 spin_unlock_irqrestore(&port
->lock
, flags
);
174 return ret
& ULITE_STATUS_TXEMPTY
? TIOCSER_TEMT
: 0;
177 static unsigned int ulite_get_mctrl(struct uart_port
*port
)
179 return TIOCM_CTS
| TIOCM_DSR
| TIOCM_CAR
;
182 static void ulite_set_mctrl(struct uart_port
*port
, unsigned int mctrl
)
187 static void ulite_stop_tx(struct uart_port
*port
)
192 static void ulite_start_tx(struct uart_port
*port
)
194 ulite_transmit(port
, ioread32be(port
->membase
+ ULITE_STATUS
));
197 static void ulite_stop_rx(struct uart_port
*port
)
199 /* don't forward any more data (like !CREAD) */
200 port
->ignore_status_mask
= ULITE_STATUS_RXVALID
| ULITE_STATUS_PARITY
201 | ULITE_STATUS_FRAME
| ULITE_STATUS_OVERRUN
;
204 static void ulite_enable_ms(struct uart_port
*port
)
209 static void ulite_break_ctl(struct uart_port
*port
, int ctl
)
214 static int ulite_startup(struct uart_port
*port
)
218 ret
= request_irq(port
->irq
, ulite_isr
,
219 IRQF_SHARED
| IRQF_SAMPLE_RANDOM
, "uartlite", port
);
223 iowrite32be(ULITE_CONTROL_RST_RX
| ULITE_CONTROL_RST_TX
,
224 port
->membase
+ ULITE_CONTROL
);
225 iowrite32be(ULITE_CONTROL_IE
, port
->membase
+ ULITE_CONTROL
);
230 static void ulite_shutdown(struct uart_port
*port
)
232 iowrite32be(0, port
->membase
+ ULITE_CONTROL
);
233 ioread32be(port
->membase
+ ULITE_CONTROL
); /* dummy */
234 free_irq(port
->irq
, port
);
237 static void ulite_set_termios(struct uart_port
*port
, struct ktermios
*termios
,
238 struct ktermios
*old
)
243 spin_lock_irqsave(&port
->lock
, flags
);
245 port
->read_status_mask
= ULITE_STATUS_RXVALID
| ULITE_STATUS_OVERRUN
246 | ULITE_STATUS_TXFULL
;
248 if (termios
->c_iflag
& INPCK
)
249 port
->read_status_mask
|=
250 ULITE_STATUS_PARITY
| ULITE_STATUS_FRAME
;
252 port
->ignore_status_mask
= 0;
253 if (termios
->c_iflag
& IGNPAR
)
254 port
->ignore_status_mask
|= ULITE_STATUS_PARITY
255 | ULITE_STATUS_FRAME
| ULITE_STATUS_OVERRUN
;
257 /* ignore all characters if CREAD is not set */
258 if ((termios
->c_cflag
& CREAD
) == 0)
259 port
->ignore_status_mask
|=
260 ULITE_STATUS_RXVALID
| ULITE_STATUS_PARITY
261 | ULITE_STATUS_FRAME
| ULITE_STATUS_OVERRUN
;
264 baud
= uart_get_baud_rate(port
, termios
, old
, 0, 460800);
265 uart_update_timeout(port
, termios
->c_cflag
, baud
);
267 spin_unlock_irqrestore(&port
->lock
, flags
);
270 static const char *ulite_type(struct uart_port
*port
)
272 return port
->type
== PORT_UARTLITE
? "uartlite" : NULL
;
275 static void ulite_release_port(struct uart_port
*port
)
277 release_mem_region(port
->mapbase
, ULITE_REGION
);
278 iounmap(port
->membase
);
279 port
->membase
= NULL
;
282 static int ulite_request_port(struct uart_port
*port
)
284 pr_debug("ulite console: port=%p; port->mapbase=%llx\n",
285 port
, (unsigned long long) port
->mapbase
);
287 if (!request_mem_region(port
->mapbase
, ULITE_REGION
, "uartlite")) {
288 dev_err(port
->dev
, "Memory region busy\n");
292 port
->membase
= ioremap(port
->mapbase
, ULITE_REGION
);
293 if (!port
->membase
) {
294 dev_err(port
->dev
, "Unable to map registers\n");
295 release_mem_region(port
->mapbase
, ULITE_REGION
);
302 static void ulite_config_port(struct uart_port
*port
, int flags
)
304 if (!ulite_request_port(port
))
305 port
->type
= PORT_UARTLITE
;
308 static int ulite_verify_port(struct uart_port
*port
, struct serial_struct
*ser
)
310 /* we don't want the core code to modify any port params */
314 #ifdef CONFIG_CONSOLE_POLL
315 static int ulite_get_poll_char(struct uart_port
*port
)
317 if (!(ioread32be(port
->membase
+ ULITE_STATUS
)
318 & ULITE_STATUS_RXVALID
))
321 return ioread32be(port
->membase
+ ULITE_RX
);
324 static void ulite_put_poll_char(struct uart_port
*port
, unsigned char ch
)
326 while (ioread32be(port
->membase
+ ULITE_STATUS
) & ULITE_STATUS_TXFULL
)
329 /* write char to device */
330 iowrite32be(ch
, port
->membase
+ ULITE_TX
);
334 static struct uart_ops ulite_ops
= {
335 .tx_empty
= ulite_tx_empty
,
336 .set_mctrl
= ulite_set_mctrl
,
337 .get_mctrl
= ulite_get_mctrl
,
338 .stop_tx
= ulite_stop_tx
,
339 .start_tx
= ulite_start_tx
,
340 .stop_rx
= ulite_stop_rx
,
341 .enable_ms
= ulite_enable_ms
,
342 .break_ctl
= ulite_break_ctl
,
343 .startup
= ulite_startup
,
344 .shutdown
= ulite_shutdown
,
345 .set_termios
= ulite_set_termios
,
347 .release_port
= ulite_release_port
,
348 .request_port
= ulite_request_port
,
349 .config_port
= ulite_config_port
,
350 .verify_port
= ulite_verify_port
,
351 #ifdef CONFIG_CONSOLE_POLL
352 .poll_get_char
= ulite_get_poll_char
,
353 .poll_put_char
= ulite_put_poll_char
,
357 /* ---------------------------------------------------------------------
358 * Console driver operations
361 #ifdef CONFIG_SERIAL_UARTLITE_CONSOLE
362 static void ulite_console_wait_tx(struct uart_port
*port
)
367 /* Spin waiting for TX fifo to have space available */
368 for (i
= 0; i
< 100000; i
++) {
369 val
= ioread32be(port
->membase
+ ULITE_STATUS
);
370 if ((val
& ULITE_STATUS_TXFULL
) == 0)
376 static void ulite_console_putchar(struct uart_port
*port
, int ch
)
378 ulite_console_wait_tx(port
);
379 iowrite32be(ch
, port
->membase
+ ULITE_TX
);
382 static void ulite_console_write(struct console
*co
, const char *s
,
385 struct uart_port
*port
= &ulite_ports
[co
->index
];
390 if (oops_in_progress
) {
391 locked
= spin_trylock_irqsave(&port
->lock
, flags
);
393 spin_lock_irqsave(&port
->lock
, flags
);
395 /* save and disable interrupt */
396 ier
= ioread32be(port
->membase
+ ULITE_STATUS
) & ULITE_STATUS_IE
;
397 iowrite32be(0, port
->membase
+ ULITE_CONTROL
);
399 uart_console_write(port
, s
, count
, ulite_console_putchar
);
401 ulite_console_wait_tx(port
);
403 /* restore interrupt state */
405 iowrite32be(ULITE_CONTROL_IE
, port
->membase
+ ULITE_CONTROL
);
408 spin_unlock_irqrestore(&port
->lock
, flags
);
411 static int __devinit
ulite_console_setup(struct console
*co
, char *options
)
413 struct uart_port
*port
;
419 if (co
->index
< 0 || co
->index
>= ULITE_NR_UARTS
)
422 port
= &ulite_ports
[co
->index
];
424 /* Has the device been initialized yet? */
425 if (!port
->mapbase
) {
426 pr_debug("console on ttyUL%i not present\n", co
->index
);
430 /* not initialized yet? */
431 if (!port
->membase
) {
432 if (ulite_request_port(port
))
437 uart_parse_options(options
, &baud
, &parity
, &bits
, &flow
);
439 return uart_set_options(port
, co
, baud
, parity
, bits
, flow
);
442 static struct uart_driver ulite_uart_driver
;
444 static struct console ulite_console
= {
446 .write
= ulite_console_write
,
447 .device
= uart_console_device
,
448 .setup
= ulite_console_setup
,
449 .flags
= CON_PRINTBUFFER
,
450 .index
= -1, /* Specified on the cmdline (e.g. console=ttyUL0 ) */
451 .data
= &ulite_uart_driver
,
454 static int __init
ulite_console_init(void)
456 register_console(&ulite_console
);
460 console_initcall(ulite_console_init
);
462 #endif /* CONFIG_SERIAL_UARTLITE_CONSOLE */
464 static struct uart_driver ulite_uart_driver
= {
465 .owner
= THIS_MODULE
,
466 .driver_name
= "uartlite",
467 .dev_name
= ULITE_NAME
,
468 .major
= ULITE_MAJOR
,
469 .minor
= ULITE_MINOR
,
470 .nr
= ULITE_NR_UARTS
,
471 #ifdef CONFIG_SERIAL_UARTLITE_CONSOLE
472 .cons
= &ulite_console
,
476 /* ---------------------------------------------------------------------
477 * Port assignment functions (mapping devices to uart_port structures)
480 /** ulite_assign: register a uartlite device with the driver
482 * @dev: pointer to device structure
483 * @id: requested id number. Pass -1 for automatic port assignment
484 * @base: base address of uartlite registers
485 * @irq: irq number for uartlite
487 * Returns: 0 on success, <0 otherwise
489 static int __devinit
ulite_assign(struct device
*dev
, int id
, u32 base
, int irq
)
491 struct uart_port
*port
;
494 /* if id = -1; then scan for a free id and use that */
496 for (id
= 0; id
< ULITE_NR_UARTS
; id
++)
497 if (ulite_ports
[id
].mapbase
== 0)
500 if (id
< 0 || id
>= ULITE_NR_UARTS
) {
501 dev_err(dev
, "%s%i too large\n", ULITE_NAME
, id
);
505 if ((ulite_ports
[id
].mapbase
) && (ulite_ports
[id
].mapbase
!= base
)) {
506 dev_err(dev
, "cannot assign to %s%i; it is already in use\n",
511 port
= &ulite_ports
[id
];
513 spin_lock_init(&port
->lock
);
516 port
->iotype
= UPIO_MEM
;
517 port
->iobase
= 1; /* mark port in use */
518 port
->mapbase
= base
;
519 port
->membase
= NULL
;
520 port
->ops
= &ulite_ops
;
522 port
->flags
= UPF_BOOT_AUTOCONF
;
524 port
->type
= PORT_UNKNOWN
;
527 dev_set_drvdata(dev
, port
);
529 /* Register the port */
530 rc
= uart_add_one_port(&ulite_uart_driver
, port
);
532 dev_err(dev
, "uart_add_one_port() failed; err=%i\n", rc
);
534 dev_set_drvdata(dev
, NULL
);
541 /** ulite_release: register a uartlite device with the driver
543 * @dev: pointer to device structure
545 static int __devexit
ulite_release(struct device
*dev
)
547 struct uart_port
*port
= dev_get_drvdata(dev
);
551 rc
= uart_remove_one_port(&ulite_uart_driver
, port
);
552 dev_set_drvdata(dev
, NULL
);
559 /* ---------------------------------------------------------------------
560 * Platform bus binding
563 #if defined(CONFIG_OF)
564 /* Match table for of_platform binding */
565 static struct of_device_id ulite_of_match
[] __devinitdata
= {
566 { .compatible
= "xlnx,opb-uartlite-1.00.b", },
567 { .compatible
= "xlnx,xps-uartlite-1.00.a", },
570 MODULE_DEVICE_TABLE(of
, ulite_of_match
);
571 #else /* CONFIG_OF */
572 #define ulite_of_match NULL
573 #endif /* CONFIG_OF */
575 static int __devinit
ulite_probe(struct platform_device
*pdev
)
577 struct resource
*res
, *res2
;
582 prop
= of_get_property(pdev
->dev
.of_node
, "port-number", NULL
);
584 id
= be32_to_cpup(prop
);
587 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
591 res2
= platform_get_resource(pdev
, IORESOURCE_IRQ
, 0);
595 return ulite_assign(&pdev
->dev
, id
, res
->start
, res2
->start
);
598 static int __devexit
ulite_remove(struct platform_device
*pdev
)
600 return ulite_release(&pdev
->dev
);
603 /* work with hotplug and coldplug */
604 MODULE_ALIAS("platform:uartlite");
606 static struct platform_driver ulite_platform_driver
= {
607 .probe
= ulite_probe
,
608 .remove
= __devexit_p(ulite_remove
),
610 .owner
= THIS_MODULE
,
612 .of_match_table
= ulite_of_match
,
616 /* ---------------------------------------------------------------------
617 * Module setup/teardown
620 int __init
ulite_init(void)
624 pr_debug("uartlite: calling uart_register_driver()\n");
625 ret
= uart_register_driver(&ulite_uart_driver
);
629 pr_debug("uartlite: calling platform_driver_register()\n");
630 ret
= platform_driver_register(&ulite_platform_driver
);
637 uart_unregister_driver(&ulite_uart_driver
);
639 printk(KERN_ERR
"registering uartlite driver failed: err=%i", ret
);
643 void __exit
ulite_exit(void)
645 platform_driver_unregister(&ulite_platform_driver
);
646 uart_unregister_driver(&ulite_uart_driver
);
649 module_init(ulite_init
);
650 module_exit(ulite_exit
);
652 MODULE_AUTHOR("Peter Korsgaard <jacmet@sunsite.dk>");
653 MODULE_DESCRIPTION("Xilinx uartlite serial driver");
654 MODULE_LICENSE("GPL");