root/drivers/tty/serial/sifive.c
// SPDX-License-Identifier: GPL-2.0+
/*
 * SiFive UART driver
 * Copyright (C) 2018 Paul Walmsley <paul@pwsan.com>
 * Copyright (C) 2018-2019 SiFive
 *
 * Based partially on:
 * - drivers/tty/serial/pxa.c
 * - drivers/tty/serial/amba-pl011.c
 * - drivers/tty/serial/uartlite.c
 * - drivers/tty/serial/omap-serial.c
 * - drivers/pwm/pwm-sifive.c
 *
 * See the following sources for further documentation:
 * - Chapter 19 "Universal Asynchronous Receiver/Transmitter (UART)" of
 *   SiFive FE310-G000 v2p3
 * - The tree/master/src/main/scala/devices/uart directory of
 *   https://github.com/sifive/sifive-blocks/
 *
 * The SiFive UART design is not 8250-compatible.  The following common
 * features are not supported:
 * - Word lengths other than 8 bits
 * - Break handling
 * - Parity
 * - Flow control
 * - Modem signals (DSR, RI, etc.)
 * On the other hand, the design is free from the baggage of the 8250
 * programming model.
 */

#include <linux/clk.h>
#include <linux/console.h>
#include <linux/delay.h>
#include <linux/init.h>
#include <linux/io.h>
#include <linux/irq.h>
#include <linux/module.h>
#include <linux/of.h>
#include <linux/of_irq.h>
#include <linux/platform_device.h>
#include <linux/serial_core.h>
#include <linux/serial_reg.h>
#include <linux/slab.h>
#include <linux/tty.h>
#include <linux/tty_flip.h>

/*
 * Register offsets
 */

/* TXDATA */
#define SIFIVE_SERIAL_TXDATA_OFFS               0x0
#define SIFIVE_SERIAL_TXDATA_FULL_SHIFT         31
#define SIFIVE_SERIAL_TXDATA_FULL_MASK          (1 << SIFIVE_SERIAL_TXDATA_FULL_SHIFT)
#define SIFIVE_SERIAL_TXDATA_DATA_SHIFT         0
#define SIFIVE_SERIAL_TXDATA_DATA_MASK          (0xff << SIFIVE_SERIAL_TXDATA_DATA_SHIFT)

/* RXDATA */
#define SIFIVE_SERIAL_RXDATA_OFFS               0x4
#define SIFIVE_SERIAL_RXDATA_EMPTY_SHIFT        31
#define SIFIVE_SERIAL_RXDATA_EMPTY_MASK         (1 << SIFIVE_SERIAL_RXDATA_EMPTY_SHIFT)
#define SIFIVE_SERIAL_RXDATA_DATA_SHIFT         0
#define SIFIVE_SERIAL_RXDATA_DATA_MASK          (0xff << SIFIVE_SERIAL_RXDATA_DATA_SHIFT)

/* TXCTRL */
#define SIFIVE_SERIAL_TXCTRL_OFFS               0x8
#define SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT        16
#define SIFIVE_SERIAL_TXCTRL_TXCNT_MASK         (0x7 << SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT)
#define SIFIVE_SERIAL_TXCTRL_NSTOP_SHIFT        1
#define SIFIVE_SERIAL_TXCTRL_NSTOP_MASK         (1 << SIFIVE_SERIAL_TXCTRL_NSTOP_SHIFT)
#define SIFIVE_SERIAL_TXCTRL_TXEN_SHIFT         0
#define SIFIVE_SERIAL_TXCTRL_TXEN_MASK          (1 << SIFIVE_SERIAL_TXCTRL_TXEN_SHIFT)

/* RXCTRL */
#define SIFIVE_SERIAL_RXCTRL_OFFS               0xC
#define SIFIVE_SERIAL_RXCTRL_RXCNT_SHIFT        16
#define SIFIVE_SERIAL_RXCTRL_RXCNT_MASK         (0x7 << SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT)
#define SIFIVE_SERIAL_RXCTRL_RXEN_SHIFT         0
#define SIFIVE_SERIAL_RXCTRL_RXEN_MASK          (1 << SIFIVE_SERIAL_RXCTRL_RXEN_SHIFT)

/* IE */
#define SIFIVE_SERIAL_IE_OFFS                   0x10
#define SIFIVE_SERIAL_IE_RXWM_SHIFT             1
#define SIFIVE_SERIAL_IE_RXWM_MASK              (1 << SIFIVE_SERIAL_IE_RXWM_SHIFT)
#define SIFIVE_SERIAL_IE_TXWM_SHIFT             0
#define SIFIVE_SERIAL_IE_TXWM_MASK              (1 << SIFIVE_SERIAL_IE_TXWM_SHIFT)

/* IP */
#define SIFIVE_SERIAL_IP_OFFS                   0x14
#define SIFIVE_SERIAL_IP_RXWM_SHIFT             1
#define SIFIVE_SERIAL_IP_RXWM_MASK              (1 << SIFIVE_SERIAL_IP_RXWM_SHIFT)
#define SIFIVE_SERIAL_IP_TXWM_SHIFT             0
#define SIFIVE_SERIAL_IP_TXWM_MASK              (1 << SIFIVE_SERIAL_IP_TXWM_SHIFT)

/* DIV */
#define SIFIVE_SERIAL_DIV_OFFS                  0x18
#define SIFIVE_SERIAL_DIV_DIV_SHIFT             0
#define SIFIVE_SERIAL_DIV_DIV_MASK              (0xffff << SIFIVE_SERIAL_IP_DIV_SHIFT)

/*
 * Config macros
 */

/*
 * SIFIVE_SERIAL_MAX_PORTS: maximum number of UARTs on a device that can
 *                          host a serial console
 */
#define SIFIVE_SERIAL_MAX_PORTS                 8

/*
 * SIFIVE_DEFAULT_BAUD_RATE: default baud rate that the driver should
 *                           configure itself to use
 */
#define SIFIVE_DEFAULT_BAUD_RATE                115200

/* SIFIVE_SERIAL_NAME: our driver's name that we pass to the operating system */
#define SIFIVE_SERIAL_NAME                      "sifive-serial"

/* SIFIVE_TTY_PREFIX: tty name prefix for SiFive serial ports */
#define SIFIVE_TTY_PREFIX                       "ttySIF"

/* SIFIVE_TX_FIFO_DEPTH: depth of the TX FIFO (in bytes) */
#define SIFIVE_TX_FIFO_DEPTH                    8

/* SIFIVE_RX_FIFO_DEPTH: depth of the TX FIFO (in bytes) */
#define SIFIVE_RX_FIFO_DEPTH                    8

#if (SIFIVE_TX_FIFO_DEPTH != SIFIVE_RX_FIFO_DEPTH)
#error Driver does not support configurations with different TX, RX FIFO sizes
#endif

/*
 *
 */

/**
 * struct sifive_serial_port - driver-specific data extension to struct uart_port
 * @port: struct uart_port embedded in this struct
 * @dev: struct device *
 * @ier: shadowed copy of the interrupt enable register
 * @baud_rate: UART serial line rate (e.g., 115200 baud)
 * @clk: reference to this device's clock
 * @clk_notifier: clock rate change notifier for upstream clock changes
 * @console_line_ended: indicate that the console line is fully written
 *
 * Configuration data specific to this SiFive UART.
 */
struct sifive_serial_port {
        struct uart_port        port;
        struct device           *dev;
        unsigned char           ier;
        unsigned long           baud_rate;
        struct clk              *clk;
        struct notifier_block   clk_notifier;
        bool                    console_line_ended;
};

/*
 * Structure container-of macros
 */

#define port_to_sifive_serial_port(p) (container_of((p), \
                                                    struct sifive_serial_port, \
                                                    port))

#define notifier_to_sifive_serial_port(nb) (container_of((nb), \
                                                         struct sifive_serial_port, \
                                                         clk_notifier))

/*
 * Forward declarations
 */
static void sifive_serial_stop_tx(struct uart_port *port);

/*
 * Internal functions
 */

/**
 * __ssp_early_writel() - write to a SiFive serial port register (early)
 * @port: pointer to a struct uart_port record
 * @offs: register address offset from the IP block base address
 * @v: value to write to the register
 *
 * Given a pointer @port to a struct uart_port record, write the value
 * @v to the IP block register address offset @offs.  This function is
 * intended for early console use.
 *
 * Context: Intended to be used only by the earlyconsole code.
 */
static void __ssp_early_writel(u32 v, u16 offs, struct uart_port *port)
{
        writel_relaxed(v, port->membase + offs);
}

/**
 * __ssp_early_readl() - read from a SiFive serial port register (early)
 * @port: pointer to a struct uart_port record
 * @offs: register address offset from the IP block base address
 *
 * Given a pointer @port to a struct uart_port record, read the
 * contents of the IP block register located at offset @offs from the
 * IP block base and return it.  This function is intended for early
 * console use.
 *
 * Context: Intended to be called only by the earlyconsole code or by
 *          __ssp_readl() or __ssp_writel() (in this driver)
 *
 * Returns: the register value read from the UART.
 */
static u32 __ssp_early_readl(struct uart_port *port, u16 offs)
{
        return readl_relaxed(port->membase + offs);
}

/**
 * __ssp_writel() - write to a SiFive serial port register
 * @v: value to write to the register
 * @offs: register address offset from the IP block base address
 * @ssp: pointer to a struct sifive_serial_port record
 *
 * Write the value @v to the IP block register located at offset @offs from the
 * IP block base, given a pointer @ssp to a struct sifive_serial_port record.
 *
 * Context: Any context.
 */
static void __ssp_writel(u32 v, u16 offs, struct sifive_serial_port *ssp)
{
        __ssp_early_writel(v, offs, &ssp->port);
}

/**
 * __ssp_readl() - read from a SiFive serial port register
 * @ssp: pointer to a struct sifive_serial_port record
 * @offs: register address offset from the IP block base address
 *
 * Read the contents of the IP block register located at offset @offs from the
 * IP block base, given a pointer @ssp to a struct sifive_serial_port record.
 *
 * Context: Any context.
 *
 * Returns: the value of the UART register
 */
static u32 __ssp_readl(struct sifive_serial_port *ssp, u16 offs)
{
        return __ssp_early_readl(&ssp->port, offs);
}

/**
 * sifive_serial_is_txfifo_full() - is the TXFIFO full?
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Read the transmit FIFO "full" bit, returning a non-zero value if the
 * TX FIFO is full, or zero if space remains.  Intended to be used to prevent
 * writes to the TX FIFO when it's full.
 *
 * Returns: SIFIVE_SERIAL_TXDATA_FULL_MASK (non-zero) if the transmit FIFO
 * is full, or 0 if space remains.
 */
static int sifive_serial_is_txfifo_full(struct sifive_serial_port *ssp)
{
        return __ssp_readl(ssp, SIFIVE_SERIAL_TXDATA_OFFS) &
                SIFIVE_SERIAL_TXDATA_FULL_MASK;
}

/**
 * __ssp_transmit_char() - enqueue a byte to transmit onto the TX FIFO
 * @ssp: pointer to a struct sifive_serial_port
 * @ch: character to transmit
 *
 * Enqueue a byte @ch onto the transmit FIFO, given a pointer @ssp to the
 * struct sifive_serial_port * to transmit on.  Caller should first check to
 * ensure that the TXFIFO has space; see sifive_serial_is_txfifo_full().
 *
 * Context: Any context.
 */
static void __ssp_transmit_char(struct sifive_serial_port *ssp, int ch)
{
        __ssp_writel(ch, SIFIVE_SERIAL_TXDATA_OFFS, ssp);
}

/**
 * __ssp_transmit_chars() - enqueue multiple bytes onto the TX FIFO
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Transfer up to a TX FIFO size's worth of characters from the Linux serial
 * transmit buffer to the SiFive UART TX FIFO.
 *
 * Context: Any context.  Expects @ssp->port.lock to be held by caller.
 */
static void __ssp_transmit_chars(struct sifive_serial_port *ssp)
{
        u8 ch;

        uart_port_tx_limited(&ssp->port, ch, SIFIVE_TX_FIFO_DEPTH,
                true,
                __ssp_transmit_char(ssp, ch),
                ({}));
}

/**
 * __ssp_enable_txwm() - enable transmit watermark interrupts
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Enable interrupt generation when the transmit FIFO watermark is reached
 * on the SiFive UART referred to by @ssp.
 */
static void __ssp_enable_txwm(struct sifive_serial_port *ssp)
{
        if (ssp->ier & SIFIVE_SERIAL_IE_TXWM_MASK)
                return;

        ssp->ier |= SIFIVE_SERIAL_IE_TXWM_MASK;
        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
}

/**
 * __ssp_enable_rxwm() - enable receive watermark interrupts
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Enable interrupt generation when the receive FIFO watermark is reached
 * on the SiFive UART referred to by @ssp.
 */
static void __ssp_enable_rxwm(struct sifive_serial_port *ssp)
{
        if (ssp->ier & SIFIVE_SERIAL_IE_RXWM_MASK)
                return;

        ssp->ier |= SIFIVE_SERIAL_IE_RXWM_MASK;
        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
}

/**
 * __ssp_disable_txwm() - disable transmit watermark interrupts
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Disable interrupt generation when the transmit FIFO watermark is reached
 * on the UART referred to by @ssp.
 */
static void __ssp_disable_txwm(struct sifive_serial_port *ssp)
{
        if (!(ssp->ier & SIFIVE_SERIAL_IE_TXWM_MASK))
                return;

        ssp->ier &= ~SIFIVE_SERIAL_IE_TXWM_MASK;
        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
}

/**
 * __ssp_disable_rxwm() - disable receive watermark interrupts
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Disable interrupt generation when the receive FIFO watermark is reached
 * on the UART referred to by @ssp.
 */
static void __ssp_disable_rxwm(struct sifive_serial_port *ssp)
{
        if (!(ssp->ier & SIFIVE_SERIAL_IE_RXWM_MASK))
                return;

        ssp->ier &= ~SIFIVE_SERIAL_IE_RXWM_MASK;
        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
}

/**
 * __ssp_receive_char() - receive a byte from the UART
 * @ssp: pointer to a struct sifive_serial_port
 * @is_empty: char pointer to return whether the RX FIFO is empty
 *
 * Try to read a byte from the SiFive UART RX FIFO, referenced by
 * @ssp, and to return it.  Also returns the RX FIFO empty bit in
 * the char pointed to by @ch.  The caller must pass the byte back to the
 * Linux serial layer if needed.
 *
 * Returns: the byte read from the UART RX FIFO.
 */
static char __ssp_receive_char(struct sifive_serial_port *ssp, char *is_empty)
{
        u32 v;
        u8 ch;

        v = __ssp_readl(ssp, SIFIVE_SERIAL_RXDATA_OFFS);

        if (!is_empty)
                WARN_ON(1);
        else
                *is_empty = (v & SIFIVE_SERIAL_RXDATA_EMPTY_MASK) >>
                        SIFIVE_SERIAL_RXDATA_EMPTY_SHIFT;

        ch = (v & SIFIVE_SERIAL_RXDATA_DATA_MASK) >>
                SIFIVE_SERIAL_RXDATA_DATA_SHIFT;

        return ch;
}

/**
 * __ssp_receive_chars() - receive multiple bytes from the UART
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Receive up to an RX FIFO's worth of bytes from the SiFive UART referred
 * to by @ssp and pass them up to the Linux serial layer.
 *
 * Context: Expects ssp->port.lock to be held by caller.
 */
static void __ssp_receive_chars(struct sifive_serial_port *ssp)
{
        char is_empty;
        int c;
        u8 ch;

        for (c = SIFIVE_RX_FIFO_DEPTH; c > 0; --c) {
                ch = __ssp_receive_char(ssp, &is_empty);
                if (is_empty)
                        break;

                ssp->port.icount.rx++;
                if (!uart_prepare_sysrq_char(&ssp->port, ch))
                        uart_insert_char(&ssp->port, 0, 0, ch, TTY_NORMAL);
        }

        tty_flip_buffer_push(&ssp->port.state->port);
}

/**
 * __ssp_update_div() - calculate the divisor setting by the line rate
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Calculate the appropriate value of the clock divisor for the UART
 * and target line rate referred to by @ssp and write it into the
 * hardware.
 */
static void __ssp_update_div(struct sifive_serial_port *ssp)
{
        u16 div;

        div = DIV_ROUND_UP(ssp->port.uartclk, ssp->baud_rate) - 1;

        __ssp_writel(div, SIFIVE_SERIAL_DIV_OFFS, ssp);
}

/**
 * __ssp_update_baud_rate() - set the UART "baud rate"
 * @ssp: pointer to a struct sifive_serial_port
 * @rate: new target bit rate
 *
 * Calculate the UART divisor value for the target bit rate @rate for the
 * SiFive UART described by @ssp and program it into the UART.  There may
 * be some error between the target bit rate and the actual bit rate implemented
 * by the UART due to clock ratio granularity.
 */
static void __ssp_update_baud_rate(struct sifive_serial_port *ssp,
                                   unsigned int rate)
{
        if (ssp->baud_rate == rate)
                return;

        ssp->baud_rate = rate;
        __ssp_update_div(ssp);
}

/**
 * __ssp_set_stop_bits() - set the number of stop bits
 * @ssp: pointer to a struct sifive_serial_port
 * @nstop: 1 or 2 (stop bits)
 *
 * Program the SiFive UART referred to by @ssp to use @nstop stop bits.
 */
static void __ssp_set_stop_bits(struct sifive_serial_port *ssp, char nstop)
{
        u32 v;

        if (nstop < 1 || nstop > 2) {
                WARN_ON(1);
                return;
        }

        v = __ssp_readl(ssp, SIFIVE_SERIAL_TXCTRL_OFFS);
        v &= ~SIFIVE_SERIAL_TXCTRL_NSTOP_MASK;
        v |= (nstop - 1) << SIFIVE_SERIAL_TXCTRL_NSTOP_SHIFT;
        __ssp_writel(v, SIFIVE_SERIAL_TXCTRL_OFFS, ssp);
}

/**
 * __ssp_wait_for_xmitr() - wait for an empty slot on the TX FIFO
 * @ssp: pointer to a struct sifive_serial_port
 *
 * Delay while the UART TX FIFO referred to by @ssp is marked as full.
 *
 * Context: Any context.
 */
static void __maybe_unused __ssp_wait_for_xmitr(struct sifive_serial_port *ssp)
{
        while (sifive_serial_is_txfifo_full(ssp))
                udelay(1); /* XXX Could probably be more intelligent here */
}

/*
 * Linux serial API functions
 */

static void sifive_serial_stop_tx(struct uart_port *port)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);

        __ssp_disable_txwm(ssp);
}

static void sifive_serial_stop_rx(struct uart_port *port)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);

        __ssp_disable_rxwm(ssp);
}

static void sifive_serial_start_tx(struct uart_port *port)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);

        __ssp_enable_txwm(ssp);
}

static irqreturn_t sifive_serial_irq(int irq, void *dev_id)
{
        struct sifive_serial_port *ssp = dev_id;
        u32 ip;

        uart_port_lock(&ssp->port);

        ip = __ssp_readl(ssp, SIFIVE_SERIAL_IP_OFFS);
        if (!ip) {
                uart_port_unlock(&ssp->port);
                return IRQ_NONE;
        }

        if (ip & SIFIVE_SERIAL_IP_RXWM_MASK)
                __ssp_receive_chars(ssp);
        if (ip & SIFIVE_SERIAL_IP_TXWM_MASK)
                __ssp_transmit_chars(ssp);

        uart_unlock_and_check_sysrq(&ssp->port);

        return IRQ_HANDLED;
}

static unsigned int sifive_serial_tx_empty(struct uart_port *port)
{
        return TIOCSER_TEMT;
}

static unsigned int sifive_serial_get_mctrl(struct uart_port *port)
{
        return TIOCM_CAR | TIOCM_CTS | TIOCM_DSR;
}

static void sifive_serial_set_mctrl(struct uart_port *port, unsigned int mctrl)
{
        /* IP block does not support these signals */
}

static void sifive_serial_break_ctl(struct uart_port *port, int break_state)
{
        /* IP block does not support sending a break */
}

static int sifive_serial_startup(struct uart_port *port)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
        unsigned long flags;

        uart_port_lock_irqsave(&ssp->port, &flags);
        __ssp_enable_rxwm(ssp);
        uart_port_unlock_irqrestore(&ssp->port, flags);

        return 0;
}

static void sifive_serial_shutdown(struct uart_port *port)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
        unsigned long flags;

        uart_port_lock_irqsave(&ssp->port, &flags);
        __ssp_disable_rxwm(ssp);
        __ssp_disable_txwm(ssp);
        uart_port_unlock_irqrestore(&ssp->port, flags);
}

/**
 * sifive_serial_clk_notifier() - clock post-rate-change notifier
 * @nb: pointer to the struct notifier_block, from the notifier code
 * @event: event mask from the notifier code
 * @data: pointer to the struct clk_notifier_data from the notifier code
 *
 * On the V0 SoC, the UART IP block is derived from the CPU clock source
 * after a synchronous divide-by-two divider, so any CPU clock rate change
 * requires the UART baud rate to be updated.  This presumably corrupts any
 * serial word currently being transmitted or received.  In order to avoid
 * corrupting the output data stream, we drain the transmit queue before
 * allowing the clock's rate to be changed.
 */
static int sifive_serial_clk_notifier(struct notifier_block *nb,
                                      unsigned long event, void *data)
{
        struct clk_notifier_data *cnd = data;
        struct sifive_serial_port *ssp = notifier_to_sifive_serial_port(nb);

        if (event == PRE_RATE_CHANGE) {
                /*
                 * The TX watermark is always set to 1 by this driver, which
                 * means that the TX busy bit will lower when there are 0 bytes
                 * left in the TX queue -- in other words, when the TX FIFO is
                 * empty.
                 */
                __ssp_wait_for_xmitr(ssp);
                /*
                 * On the cycle the TX FIFO goes empty there is still a full
                 * UART frame left to be transmitted in the shift register.
                 * The UART provides no way for software to directly determine
                 * when that last frame has been transmitted, so we just sleep
                 * here instead.  As we're not tracking the number of stop bits
                 * they're just worst cased here.  The rest of the serial
                 * framing parameters aren't configurable by software.
                 */
                udelay(DIV_ROUND_UP(12 * 1000 * 1000, ssp->baud_rate));
        }

        if (event == POST_RATE_CHANGE && ssp->port.uartclk != cnd->new_rate) {
                ssp->port.uartclk = cnd->new_rate;
                __ssp_update_div(ssp);
        }

        return NOTIFY_OK;
}

static void sifive_serial_set_termios(struct uart_port *port,
                                      struct ktermios *termios,
                                      const struct ktermios *old)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
        unsigned long flags;
        u32 v, old_v;
        int rate;
        char nstop;

        if ((termios->c_cflag & CSIZE) != CS8) {
                dev_err_once(ssp->port.dev, "only 8-bit words supported\n");
                termios->c_cflag &= ~CSIZE;
                termios->c_cflag |= CS8;
        }
        if (termios->c_iflag & (INPCK | PARMRK))
                dev_err_once(ssp->port.dev, "parity checking not supported\n");
        if (termios->c_iflag & BRKINT)
                dev_err_once(ssp->port.dev, "BREAK detection not supported\n");
        termios->c_iflag &= ~(INPCK|PARMRK|BRKINT);

        /* Set number of stop bits */
        nstop = (termios->c_cflag & CSTOPB) ? 2 : 1;
        __ssp_set_stop_bits(ssp, nstop);

        /* Set line rate */
        rate = uart_get_baud_rate(port, termios, old, 0,
                                  ssp->port.uartclk / 16);
        __ssp_update_baud_rate(ssp, rate);

        uart_port_lock_irqsave(&ssp->port, &flags);

        /* Update the per-port timeout */
        uart_update_timeout(port, termios->c_cflag, rate);

        ssp->port.read_status_mask = 0;

        /* Ignore all characters if CREAD is not set */
        v = __ssp_readl(ssp, SIFIVE_SERIAL_RXCTRL_OFFS);
        old_v = v;
        if ((termios->c_cflag & CREAD) == 0)
                v &= SIFIVE_SERIAL_RXCTRL_RXEN_MASK;
        else
                v |= SIFIVE_SERIAL_RXCTRL_RXEN_MASK;
        if (v != old_v)
                __ssp_writel(v, SIFIVE_SERIAL_RXCTRL_OFFS, ssp);

        uart_port_unlock_irqrestore(&ssp->port, flags);
}

static void sifive_serial_release_port(struct uart_port *port)
{
}

static int sifive_serial_request_port(struct uart_port *port)
{
        return 0;
}

static void sifive_serial_config_port(struct uart_port *port, int flags)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);

        ssp->port.type = PORT_SIFIVE_V0;
}

static int sifive_serial_verify_port(struct uart_port *port,
                                     struct serial_struct *ser)
{
        return -EINVAL;
}

static const char *sifive_serial_type(struct uart_port *port)
{
        return port->type == PORT_SIFIVE_V0 ? "SiFive UART v0" : NULL;
}

#ifdef CONFIG_CONSOLE_POLL
static int sifive_serial_poll_get_char(struct uart_port *port)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
        char is_empty, ch;

        ch = __ssp_receive_char(ssp, &is_empty);
        if (is_empty)
                return NO_POLL_CHAR;

        return ch;
}

static void sifive_serial_poll_put_char(struct uart_port *port,
                                        unsigned char c)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);

        __ssp_wait_for_xmitr(ssp);
        __ssp_transmit_char(ssp, c);
}
#endif /* CONFIG_CONSOLE_POLL */

/*
 * Early console support
 */

#ifdef CONFIG_SERIAL_EARLYCON
static void early_sifive_serial_putc(struct uart_port *port, unsigned char c)
{
        while (__ssp_early_readl(port, SIFIVE_SERIAL_TXDATA_OFFS) &
               SIFIVE_SERIAL_TXDATA_FULL_MASK)
                cpu_relax();

        __ssp_early_writel(c, SIFIVE_SERIAL_TXDATA_OFFS, port);
}

static void early_sifive_serial_write(struct console *con, const char *s,
                                      unsigned int n)
{
        struct earlycon_device *dev = con->data;
        struct uart_port *port = &dev->port;

        uart_console_write(port, s, n, early_sifive_serial_putc);
}

static int __init early_sifive_serial_setup(struct earlycon_device *dev,
                                            const char *options)
{
        struct uart_port *port = &dev->port;

        if (!port->membase)
                return -ENODEV;

        dev->con->write = early_sifive_serial_write;

        return 0;
}

OF_EARLYCON_DECLARE(sifive, "sifive,uart0", early_sifive_serial_setup);
OF_EARLYCON_DECLARE(sifive, "sifive,fu540-c000-uart",
                    early_sifive_serial_setup);
#endif /* CONFIG_SERIAL_EARLYCON */

/*
 * Linux console interface
 */

#ifdef CONFIG_SERIAL_SIFIVE_CONSOLE

static struct sifive_serial_port *sifive_serial_console_ports[SIFIVE_SERIAL_MAX_PORTS];

static void sifive_serial_console_putchar(struct uart_port *port, unsigned char ch)
{
        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);

        __ssp_wait_for_xmitr(ssp);
        __ssp_transmit_char(ssp, ch);

        ssp->console_line_ended = (ch == '\n');
}

static void sifive_serial_device_lock(struct console *co, unsigned long *flags)
{
        struct uart_port *up = &sifive_serial_console_ports[co->index]->port;

        __uart_port_lock_irqsave(up, flags);
}

static void sifive_serial_device_unlock(struct console *co, unsigned long flags)
{
        struct uart_port *up = &sifive_serial_console_ports[co->index]->port;

        __uart_port_unlock_irqrestore(up, flags);
}

static void sifive_serial_console_write_atomic(struct console *co,
                                               struct nbcon_write_context *wctxt)
{
        struct sifive_serial_port *ssp = sifive_serial_console_ports[co->index];
        struct uart_port *port = &ssp->port;
        unsigned int ier;

        if (!ssp)
                return;

        if (!nbcon_enter_unsafe(wctxt))
                return;

        ier = __ssp_readl(ssp, SIFIVE_SERIAL_IE_OFFS);
        __ssp_writel(0, SIFIVE_SERIAL_IE_OFFS, ssp);

        if (!ssp->console_line_ended)
                uart_console_write(port, "\n", 1, sifive_serial_console_putchar);
        uart_console_write(port, wctxt->outbuf, wctxt->len,
                           sifive_serial_console_putchar);

        __ssp_writel(ier, SIFIVE_SERIAL_IE_OFFS, ssp);

        nbcon_exit_unsafe(wctxt);
}

static void sifive_serial_console_write_thread(struct console *co,
                                               struct nbcon_write_context *wctxt)
{
        struct sifive_serial_port *ssp = sifive_serial_console_ports[co->index];
        struct uart_port *port = &ssp->port;
        unsigned int ier;

        if (!ssp)
                return;

        if (!nbcon_enter_unsafe(wctxt))
                return;

        ier = __ssp_readl(ssp, SIFIVE_SERIAL_IE_OFFS);
        __ssp_writel(0, SIFIVE_SERIAL_IE_OFFS, ssp);

        if (nbcon_exit_unsafe(wctxt)) {
                int len = READ_ONCE(wctxt->len);
                int i;

                for (i = 0; i < len; i++) {
                        if (!nbcon_enter_unsafe(wctxt))
                                break;

                        uart_console_write(port, wctxt->outbuf + i, 1,
                                           sifive_serial_console_putchar);

                        if (!nbcon_exit_unsafe(wctxt))
                                break;
                }
        }

        while (!nbcon_enter_unsafe(wctxt))
                nbcon_reacquire_nobuf(wctxt);

        __ssp_writel(ier, SIFIVE_SERIAL_IE_OFFS, ssp);

        nbcon_exit_unsafe(wctxt);
}

static int sifive_serial_console_setup(struct console *co, char *options)
{
        struct sifive_serial_port *ssp;
        int baud = SIFIVE_DEFAULT_BAUD_RATE;
        int bits = 8;
        int parity = 'n';
        int flow = 'n';

        if (co->index < 0 || co->index >= SIFIVE_SERIAL_MAX_PORTS)
                return -ENODEV;

        ssp = sifive_serial_console_ports[co->index];
        if (!ssp)
                return -ENODEV;

        ssp->console_line_ended = true;

        if (options)
                uart_parse_options(options, &baud, &parity, &bits, &flow);

        return uart_set_options(&ssp->port, co, baud, parity, bits, flow);
}

static struct uart_driver sifive_serial_uart_driver;

static struct console sifive_serial_console = {
        .name           = SIFIVE_TTY_PREFIX,
        .write_atomic   = sifive_serial_console_write_atomic,
        .write_thread   = sifive_serial_console_write_thread,
        .device_lock    = sifive_serial_device_lock,
        .device_unlock  = sifive_serial_device_unlock,
        .device         = uart_console_device,
        .setup          = sifive_serial_console_setup,
        .flags          = CON_PRINTBUFFER | CON_NBCON,
        .index          = -1,
        .data           = &sifive_serial_uart_driver,
};

static int __init sifive_console_init(void)
{
        register_console(&sifive_serial_console);
        return 0;
}

console_initcall(sifive_console_init);

static void __ssp_add_console_port(struct sifive_serial_port *ssp)
{
        sifive_serial_console_ports[ssp->port.line] = ssp;
}

static void __ssp_remove_console_port(struct sifive_serial_port *ssp)
{
        sifive_serial_console_ports[ssp->port.line] = NULL;
}

#define SIFIVE_SERIAL_CONSOLE   (&sifive_serial_console)

#else

#define SIFIVE_SERIAL_CONSOLE   NULL

static void __ssp_add_console_port(struct sifive_serial_port *ssp)
{}
static void __ssp_remove_console_port(struct sifive_serial_port *ssp)
{}

#endif

static const struct uart_ops sifive_serial_uops = {
        .tx_empty       = sifive_serial_tx_empty,
        .set_mctrl      = sifive_serial_set_mctrl,
        .get_mctrl      = sifive_serial_get_mctrl,
        .stop_tx        = sifive_serial_stop_tx,
        .start_tx       = sifive_serial_start_tx,
        .stop_rx        = sifive_serial_stop_rx,
        .break_ctl      = sifive_serial_break_ctl,
        .startup        = sifive_serial_startup,
        .shutdown       = sifive_serial_shutdown,
        .set_termios    = sifive_serial_set_termios,
        .type           = sifive_serial_type,
        .release_port   = sifive_serial_release_port,
        .request_port   = sifive_serial_request_port,
        .config_port    = sifive_serial_config_port,
        .verify_port    = sifive_serial_verify_port,
#ifdef CONFIG_CONSOLE_POLL
        .poll_get_char  = sifive_serial_poll_get_char,
        .poll_put_char  = sifive_serial_poll_put_char,
#endif
};

static struct uart_driver sifive_serial_uart_driver = {
        .owner          = THIS_MODULE,
        .driver_name    = SIFIVE_SERIAL_NAME,
        .dev_name       = SIFIVE_TTY_PREFIX,
        .nr             = SIFIVE_SERIAL_MAX_PORTS,
        .cons           = SIFIVE_SERIAL_CONSOLE,
};

static int sifive_serial_probe(struct platform_device *pdev)
{
        struct sifive_serial_port *ssp;
        struct resource *mem;
        struct clk *clk;
        void __iomem *base;
        int irq, id, r;

        irq = platform_get_irq(pdev, 0);
        if (irq < 0)
                return -EPROBE_DEFER;

        base = devm_platform_get_and_ioremap_resource(pdev, 0, &mem);
        if (IS_ERR(base))
                return PTR_ERR(base);

        clk = devm_clk_get_enabled(&pdev->dev, NULL);
        if (IS_ERR(clk)) {
                dev_err(&pdev->dev, "unable to find controller clock\n");
                return PTR_ERR(clk);
        }

        id = of_alias_get_id(pdev->dev.of_node, "serial");
        if (id < 0) {
                dev_err(&pdev->dev, "missing aliases entry\n");
                return id;
        }

#ifdef CONFIG_SERIAL_SIFIVE_CONSOLE
        if (id > SIFIVE_SERIAL_MAX_PORTS) {
                dev_err(&pdev->dev, "too many UARTs (%d)\n", id);
                return -EINVAL;
        }
#endif

        ssp = devm_kzalloc(&pdev->dev, sizeof(*ssp), GFP_KERNEL);
        if (!ssp)
                return -ENOMEM;

        ssp->port.dev = &pdev->dev;
        ssp->port.type = PORT_SIFIVE_V0;
        ssp->port.iotype = UPIO_MEM;
        ssp->port.irq = irq;
        ssp->port.fifosize = SIFIVE_TX_FIFO_DEPTH;
        ssp->port.ops = &sifive_serial_uops;
        ssp->port.line = id;
        ssp->port.mapbase = mem->start;
        ssp->port.membase = base;
        ssp->dev = &pdev->dev;
        ssp->clk = clk;
        ssp->clk_notifier.notifier_call = sifive_serial_clk_notifier;

        r = clk_notifier_register(ssp->clk, &ssp->clk_notifier);
        if (r) {
                dev_err(&pdev->dev, "could not register clock notifier: %d\n",
                        r);
                goto probe_out1;
        }

        /* Set up clock divider */
        ssp->port.uartclk = clk_get_rate(ssp->clk);
        ssp->baud_rate = SIFIVE_DEFAULT_BAUD_RATE;
        __ssp_update_div(ssp);

        platform_set_drvdata(pdev, ssp);

        /* Enable transmits and set the watermark level to 1 */
        __ssp_writel((1 << SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT) |
                     SIFIVE_SERIAL_TXCTRL_TXEN_MASK,
                     SIFIVE_SERIAL_TXCTRL_OFFS, ssp);

        /* Enable receives and set the watermark level to 0 */
        __ssp_writel((0 << SIFIVE_SERIAL_RXCTRL_RXCNT_SHIFT) |
                     SIFIVE_SERIAL_RXCTRL_RXEN_MASK,
                     SIFIVE_SERIAL_RXCTRL_OFFS, ssp);

        r = request_irq(ssp->port.irq, sifive_serial_irq, ssp->port.irqflags,
                        dev_name(&pdev->dev), ssp);
        if (r) {
                dev_err(&pdev->dev, "could not attach interrupt: %d\n", r);
                goto probe_out2;
        }

        __ssp_add_console_port(ssp);

        r = uart_add_one_port(&sifive_serial_uart_driver, &ssp->port);
        if (r != 0) {
                dev_err(&pdev->dev, "could not add uart: %d\n", r);
                goto probe_out3;
        }

        return 0;

probe_out3:
        __ssp_remove_console_port(ssp);
        free_irq(ssp->port.irq, ssp);
probe_out2:
        clk_notifier_unregister(ssp->clk, &ssp->clk_notifier);
probe_out1:
        return r;
}

static void sifive_serial_remove(struct platform_device *dev)
{
        struct sifive_serial_port *ssp = platform_get_drvdata(dev);

        __ssp_remove_console_port(ssp);
        uart_remove_one_port(&sifive_serial_uart_driver, &ssp->port);
        free_irq(ssp->port.irq, ssp);
        clk_notifier_unregister(ssp->clk, &ssp->clk_notifier);
}

static int sifive_serial_suspend(struct device *dev)
{
        struct sifive_serial_port *ssp = dev_get_drvdata(dev);

        return uart_suspend_port(&sifive_serial_uart_driver, &ssp->port);
}

static int sifive_serial_resume(struct device *dev)
{
        struct sifive_serial_port *ssp = dev_get_drvdata(dev);

        return uart_resume_port(&sifive_serial_uart_driver, &ssp->port);
}

static DEFINE_SIMPLE_DEV_PM_OPS(sifive_uart_pm_ops, sifive_serial_suspend,
                                sifive_serial_resume);

static const struct of_device_id sifive_serial_of_match[] = {
        { .compatible = "sifive,fu540-c000-uart" },
        { .compatible = "sifive,uart0" },
        {},
};
MODULE_DEVICE_TABLE(of, sifive_serial_of_match);

static struct platform_driver sifive_serial_platform_driver = {
        .probe          = sifive_serial_probe,
        .remove         = sifive_serial_remove,
        .driver         = {
                .name   = SIFIVE_SERIAL_NAME,
                .pm = pm_sleep_ptr(&sifive_uart_pm_ops),
                .of_match_table = sifive_serial_of_match,
        },
};

static int __init sifive_serial_init(void)
{
        int r;

        r = uart_register_driver(&sifive_serial_uart_driver);
        if (r)
                goto init_out1;

        r = platform_driver_register(&sifive_serial_platform_driver);
        if (r)
                goto init_out2;

        return 0;

init_out2:
        uart_unregister_driver(&sifive_serial_uart_driver);
init_out1:
        return r;
}

static void __exit sifive_serial_exit(void)
{
        platform_driver_unregister(&sifive_serial_platform_driver);
        uart_unregister_driver(&sifive_serial_uart_driver);
}

module_init(sifive_serial_init);
module_exit(sifive_serial_exit);

MODULE_DESCRIPTION("SiFive UART serial driver");
MODULE_LICENSE("GPL");
MODULE_AUTHOR("Paul Walmsley <paul@pwsan.com>");