subsys: console: Refactor code to allow per-UART "tty" wrapper

Instead of having just one static "UART console" device, allow to
instantiate buffered, interrupt-driven POSIX-like "tty" wrapper for
any underlying device. Then, use this functionality to provide
compatible "console API".

Signed-off-by: Paul Sokolovsky <paul.sokolovsky@linaro.org>
This commit is contained in:
Paul Sokolovsky 2018-07-16 21:57:07 +03:00 committed by Anas Nashif
commit 95b64fb776

View file

@ -11,27 +11,31 @@
#include <drivers/console/console.h> #include <drivers/console/console.h>
#include <drivers/console/uart_console.h> #include <drivers/console/uart_console.h>
#if (CONFIG_CONSOLE_GETCHAR_BUFSIZE & (CONFIG_CONSOLE_GETCHAR_BUFSIZE - 1)) != 0 struct tty_serial {
#error CONFIG_CONSOLE_GETCHAR_BUFSIZE must be power of 2 struct device *uart_dev;
#endif
#if (CONFIG_CONSOLE_PUTCHAR_BUFSIZE & (CONFIG_CONSOLE_PUTCHAR_BUFSIZE - 1)) != 0 struct k_sem rx_sem;
#error CONFIG_CONSOLE_PUTCHAR_BUFSIZE must be power of 2 u8_t *rx_ringbuf;
#endif u32_t rx_ringbuf_sz;
u16_t rx_get, rx_put;
static K_SEM_DEFINE(rx_sem, 0, UINT_MAX); u8_t *tx_ringbuf;
static u8_t rx_ringbuf[CONFIG_CONSOLE_GETCHAR_BUFSIZE]; u32_t tx_ringbuf_sz;
static u8_t rx_get, rx_put; u16_t tx_get, tx_put;
};
static u8_t tx_ringbuf[CONFIG_CONSOLE_PUTCHAR_BUFSIZE]; static u8_t console_rxbuf[CONFIG_CONSOLE_GETCHAR_BUFSIZE];
static u8_t tx_get, tx_put; static u8_t console_txbuf[CONFIG_CONSOLE_PUTCHAR_BUFSIZE];
static struct device *uart_dev; static int tty_irq_input_hook(struct tty_serial *tty, u8_t c);
static int console_irq_input_hook(u8_t c); static struct tty_serial console_serial;
static void uart_isr(struct device *dev) static void tty_uart_isr(void *user_data)
{ {
struct tty_serial *tty = user_data;
struct device *dev = tty->uart_dev;
uart_irq_update(dev); uart_irq_update(dev);
if (uart_irq_rx_ready(dev)) { if (uart_irq_rx_ready(dev)) {
@ -41,78 +45,119 @@ static void uart_isr(struct device *dev)
if (uart_fifo_read(dev, &c, 1) == 0) { if (uart_fifo_read(dev, &c, 1) == 0) {
break; break;
} }
console_irq_input_hook(c); tty_irq_input_hook(tty, c);
} }
} }
if (uart_irq_tx_ready(dev)) { if (uart_irq_tx_ready(dev)) {
if (tx_get == tx_put) { if (tty->tx_get == tty->tx_put) {
/* Output buffer empty, don't bother /* Output buffer empty, don't bother
* us with tx interrupts * us with tx interrupts
*/ */
uart_irq_tx_disable(dev); uart_irq_tx_disable(dev);
} else { } else {
uart_fifo_fill(dev, &tx_ringbuf[tx_get++], 1); uart_fifo_fill(dev, &tty->tx_ringbuf[tty->tx_get++], 1);
tx_get &= CONFIG_CONSOLE_PUTCHAR_BUFSIZE - 1; if (tty->tx_get >= tty->tx_ringbuf_sz) {
tty->tx_get = 0;
}
} }
} }
} }
static int console_irq_input_hook(u8_t c) static int tty_irq_input_hook(struct tty_serial *tty, u8_t c)
{ {
int rx_next = (rx_put + 1) & (CONFIG_CONSOLE_GETCHAR_BUFSIZE - 1); int rx_next = tty->rx_put + 1;
if (rx_next >= tty->rx_ringbuf_sz) {
rx_next = 0;
}
if (rx_next == rx_get) { if (rx_next == tty->rx_get) {
/* Try to give a clue to user that some input was lost */ /* Try to give a clue to user that some input was lost */
console_putchar('~'); console_putchar('~');
console_putchar('\n'); console_putchar('\n');
return 1; return 1;
} }
rx_ringbuf[rx_put] = c; tty->rx_ringbuf[tty->rx_put] = c;
rx_put = rx_next; tty->rx_put = rx_next;
k_sem_give(&rx_sem); k_sem_give(&tty->rx_sem);
return 1; return 1;
} }
int console_putchar(char c) int tty_putchar(struct tty_serial *tty, char c)
{ {
unsigned int key; unsigned int key;
int tx_next; int tx_next;
key = irq_lock(); key = irq_lock();
tx_next = (tx_put + 1) & (CONFIG_CONSOLE_PUTCHAR_BUFSIZE - 1); tx_next = tty->tx_put + 1;
if (tx_next == tx_get) { if (tx_next >= tty->tx_ringbuf_sz) {
tx_next = 0;
}
if (tx_next == tty->tx_get) {
irq_unlock(key); irq_unlock(key);
return -1; return -1;
} }
tx_ringbuf[tx_put] = (u8_t)c; tty->tx_ringbuf[tty->tx_put] = (u8_t)c;
tx_put = tx_next; tty->tx_put = tx_next;
irq_unlock(key); irq_unlock(key);
uart_irq_tx_enable(uart_dev); uart_irq_tx_enable(tty->uart_dev);
return 0; return 0;
} }
u8_t console_getchar(void) u8_t tty_getchar(struct tty_serial *tty)
{ {
unsigned int key; unsigned int key;
u8_t c; u8_t c;
k_sem_take(&rx_sem, K_FOREVER); k_sem_take(&tty->rx_sem, K_FOREVER);
key = irq_lock(); key = irq_lock();
c = rx_ringbuf[rx_get++]; c = tty->rx_ringbuf[tty->rx_get++];
rx_get &= CONFIG_CONSOLE_GETCHAR_BUFSIZE - 1; if (tty->rx_get >= tty->rx_ringbuf_sz) {
tty->rx_get = 0;
}
irq_unlock(key); irq_unlock(key);
return c; return c;
} }
void console_init(void) void tty_init(struct tty_serial *tty, struct device *uart_dev,
u8_t *rxbuf, u16_t rxbuf_sz,
u8_t *txbuf, u16_t txbuf_sz)
{ {
uart_dev = device_get_binding(CONFIG_UART_CONSOLE_ON_DEV_NAME); tty->uart_dev = uart_dev;
uart_irq_callback_set(uart_dev, uart_isr); tty->rx_ringbuf = rxbuf;
tty->rx_ringbuf_sz = rxbuf_sz;
tty->tx_ringbuf = txbuf;
tty->tx_ringbuf_sz = txbuf_sz;
tty->rx_get = tty->rx_put = tty->tx_get = tty->tx_put = 0;
k_sem_init(&tty->rx_sem, 0, UINT_MAX);
uart_irq_callback_user_data_set(uart_dev, tty_uart_isr, tty);
uart_irq_rx_enable(uart_dev); uart_irq_rx_enable(uart_dev);
} }
int console_putchar(char c)
{
return tty_putchar(&console_serial, c);
}
u8_t console_getchar(void)
{
return tty_getchar(&console_serial);
}
void console_init(void)
{
struct device *uart_dev;
uart_dev = device_get_binding(CONFIG_UART_CONSOLE_ON_DEV_NAME);
tty_init(&console_serial, uart_dev,
console_rxbuf, sizeof(console_rxbuf),
console_txbuf, sizeof(console_txbuf));
}