linux/drivers/tty/serial/sifive.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0+
   2/*
   3 * SiFive UART driver
   4 * Copyright (C) 2018 Paul Walmsley <paul@pwsan.com>
   5 * Copyright (C) 2018-2019 SiFive
   6 *
   7 * This program is free software; you can redistribute it and/or modify
   8 * it under the terms of the GNU General Public License as published by
   9 * the Free Software Foundation; either version 2 of the License, or
  10 * (at your option) any later version.
  11 *
  12 * This program is distributed in the hope that it will be useful,
  13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 * GNU General Public License for more details.
  16 *
  17 * Based partially on:
  18 * - drivers/tty/serial/pxa.c
  19 * - drivers/tty/serial/amba-pl011.c
  20 * - drivers/tty/serial/uartlite.c
  21 * - drivers/tty/serial/omap-serial.c
  22 * - drivers/pwm/pwm-sifive.c
  23 *
  24 * See the following sources for further documentation:
  25 * - Chapter 19 "Universal Asynchronous Receiver/Transmitter (UART)" of
  26 *   SiFive FE310-G000 v2p3
  27 * - The tree/master/src/main/scala/devices/uart directory of
  28 *   https://github.com/sifive/sifive-blocks/
  29 *
  30 * The SiFive UART design is not 8250-compatible.  The following common
  31 * features are not supported:
  32 * - Word lengths other than 8 bits
  33 * - Break handling
  34 * - Parity
  35 * - Flow control
  36 * - Modem signals (DSR, RI, etc.)
  37 * On the other hand, the design is free from the baggage of the 8250
  38 * programming model.
  39 */
  40
  41#include <linux/clk.h>
  42#include <linux/console.h>
  43#include <linux/delay.h>
  44#include <linux/init.h>
  45#include <linux/io.h>
  46#include <linux/irq.h>
  47#include <linux/module.h>
  48#include <linux/of.h>
  49#include <linux/of_irq.h>
  50#include <linux/platform_device.h>
  51#include <linux/serial_core.h>
  52#include <linux/serial_reg.h>
  53#include <linux/slab.h>
  54#include <linux/tty.h>
  55#include <linux/tty_flip.h>
  56
  57/*
  58 * Register offsets
  59 */
  60
  61/* TXDATA */
  62#define SIFIVE_SERIAL_TXDATA_OFFS               0x0
  63#define SIFIVE_SERIAL_TXDATA_FULL_SHIFT         31
  64#define SIFIVE_SERIAL_TXDATA_FULL_MASK          (1 << SIFIVE_SERIAL_TXDATA_FULL_SHIFT)
  65#define SIFIVE_SERIAL_TXDATA_DATA_SHIFT         0
  66#define SIFIVE_SERIAL_TXDATA_DATA_MASK          (0xff << SIFIVE_SERIAL_TXDATA_DATA_SHIFT)
  67
  68/* RXDATA */
  69#define SIFIVE_SERIAL_RXDATA_OFFS               0x4
  70#define SIFIVE_SERIAL_RXDATA_EMPTY_SHIFT        31
  71#define SIFIVE_SERIAL_RXDATA_EMPTY_MASK         (1 << SIFIVE_SERIAL_RXDATA_EMPTY_SHIFT)
  72#define SIFIVE_SERIAL_RXDATA_DATA_SHIFT         0
  73#define SIFIVE_SERIAL_RXDATA_DATA_MASK          (0xff << SIFIVE_SERIAL_RXDATA_DATA_SHIFT)
  74
  75/* TXCTRL */
  76#define SIFIVE_SERIAL_TXCTRL_OFFS               0x8
  77#define SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT        16
  78#define SIFIVE_SERIAL_TXCTRL_TXCNT_MASK         (0x7 << SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT)
  79#define SIFIVE_SERIAL_TXCTRL_NSTOP_SHIFT        1
  80#define SIFIVE_SERIAL_TXCTRL_NSTOP_MASK         (1 << SIFIVE_SERIAL_TXCTRL_NSTOP_SHIFT)
  81#define SIFIVE_SERIAL_TXCTRL_TXEN_SHIFT         0
  82#define SIFIVE_SERIAL_TXCTRL_TXEN_MASK          (1 << SIFIVE_SERIAL_TXCTRL_TXEN_SHIFT)
  83
  84/* RXCTRL */
  85#define SIFIVE_SERIAL_RXCTRL_OFFS               0xC
  86#define SIFIVE_SERIAL_RXCTRL_RXCNT_SHIFT        16
  87#define SIFIVE_SERIAL_RXCTRL_RXCNT_MASK         (0x7 << SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT)
  88#define SIFIVE_SERIAL_RXCTRL_RXEN_SHIFT         0
  89#define SIFIVE_SERIAL_RXCTRL_RXEN_MASK          (1 << SIFIVE_SERIAL_RXCTRL_RXEN_SHIFT)
  90
  91/* IE */
  92#define SIFIVE_SERIAL_IE_OFFS                   0x10
  93#define SIFIVE_SERIAL_IE_RXWM_SHIFT             1
  94#define SIFIVE_SERIAL_IE_RXWM_MASK              (1 << SIFIVE_SERIAL_IE_RXWM_SHIFT)
  95#define SIFIVE_SERIAL_IE_TXWM_SHIFT             0
  96#define SIFIVE_SERIAL_IE_TXWM_MASK              (1 << SIFIVE_SERIAL_IE_TXWM_SHIFT)
  97
  98/* IP */
  99#define SIFIVE_SERIAL_IP_OFFS                   0x14
 100#define SIFIVE_SERIAL_IP_RXWM_SHIFT             1
 101#define SIFIVE_SERIAL_IP_RXWM_MASK              (1 << SIFIVE_SERIAL_IP_RXWM_SHIFT)
 102#define SIFIVE_SERIAL_IP_TXWM_SHIFT             0
 103#define SIFIVE_SERIAL_IP_TXWM_MASK              (1 << SIFIVE_SERIAL_IP_TXWM_SHIFT)
 104
 105/* DIV */
 106#define SIFIVE_SERIAL_DIV_OFFS                  0x18
 107#define SIFIVE_SERIAL_DIV_DIV_SHIFT             0
 108#define SIFIVE_SERIAL_DIV_DIV_MASK              (0xffff << SIFIVE_SERIAL_IP_DIV_SHIFT)
 109
 110/*
 111 * Config macros
 112 */
 113
 114/*
 115 * SIFIVE_SERIAL_MAX_PORTS: maximum number of UARTs on a device that can
 116 *                          host a serial console
 117 */
 118#define SIFIVE_SERIAL_MAX_PORTS                 8
 119
 120/*
 121 * SIFIVE_DEFAULT_BAUD_RATE: default baud rate that the driver should
 122 *                           configure itself to use
 123 */
 124#define SIFIVE_DEFAULT_BAUD_RATE                115200
 125
 126/* SIFIVE_SERIAL_NAME: our driver's name that we pass to the operating system */
 127#define SIFIVE_SERIAL_NAME                      "sifive-serial"
 128
 129/* SIFIVE_TTY_PREFIX: tty name prefix for SiFive serial ports */
 130#define SIFIVE_TTY_PREFIX                       "ttySIF"
 131
 132/* SIFIVE_TX_FIFO_DEPTH: depth of the TX FIFO (in bytes) */
 133#define SIFIVE_TX_FIFO_DEPTH                    8
 134
 135/* SIFIVE_RX_FIFO_DEPTH: depth of the TX FIFO (in bytes) */
 136#define SIFIVE_RX_FIFO_DEPTH                    8
 137
 138#if (SIFIVE_TX_FIFO_DEPTH != SIFIVE_RX_FIFO_DEPTH)
 139#error Driver does not support configurations with different TX, RX FIFO sizes
 140#endif
 141
 142/*
 143 *
 144 */
 145
 146/**
 147 * struct sifive_serial_port - driver-specific data extension to struct uart_port
 148 * @port: struct uart_port embedded in this struct
 149 * @dev: struct device *
 150 * @ier: shadowed copy of the interrupt enable register
 151 * @clkin_rate: input clock to the UART IP block.
 152 * @baud_rate: UART serial line rate (e.g., 115200 baud)
 153 * @clk: reference to this device's clock
 154 * @clk_notifier: clock rate change notifier for upstream clock changes
 155 *
 156 * Configuration data specific to this SiFive UART.
 157 */
 158struct sifive_serial_port {
 159        struct uart_port        port;
 160        struct device           *dev;
 161        unsigned char           ier;
 162        unsigned long           clkin_rate;
 163        unsigned long           baud_rate;
 164        struct clk              *clk;
 165        struct notifier_block   clk_notifier;
 166};
 167
 168/*
 169 * Structure container-of macros
 170 */
 171
 172#define port_to_sifive_serial_port(p) (container_of((p), \
 173                                                    struct sifive_serial_port, \
 174                                                    port))
 175
 176#define notifier_to_sifive_serial_port(nb) (container_of((nb), \
 177                                                         struct sifive_serial_port, \
 178                                                         clk_notifier))
 179
 180/*
 181 * Forward declarations
 182 */
 183static void sifive_serial_stop_tx(struct uart_port *port);
 184
 185/*
 186 * Internal functions
 187 */
 188
 189/**
 190 * __ssp_early_writel() - write to a SiFive serial port register (early)
 191 * @port: pointer to a struct uart_port record
 192 * @offs: register address offset from the IP block base address
 193 * @v: value to write to the register
 194 *
 195 * Given a pointer @port to a struct uart_port record, write the value
 196 * @v to the IP block register address offset @offs.  This function is
 197 * intended for early console use.
 198 *
 199 * Context: Intended to be used only by the earlyconsole code.
 200 */
 201static void __ssp_early_writel(u32 v, u16 offs, struct uart_port *port)
 202{
 203        writel_relaxed(v, port->membase + offs);
 204}
 205
 206/**
 207 * __ssp_early_readl() - read from a SiFive serial port register (early)
 208 * @port: pointer to a struct uart_port record
 209 * @offs: register address offset from the IP block base address
 210 *
 211 * Given a pointer @port to a struct uart_port record, read the
 212 * contents of the IP block register located at offset @offs from the
 213 * IP block base and return it.  This function is intended for early
 214 * console use.
 215 *
 216 * Context: Intended to be called only by the earlyconsole code or by
 217 *          __ssp_readl() or __ssp_writel() (in this driver)
 218 *
 219 * Returns: the register value read from the UART.
 220 */
 221static u32 __ssp_early_readl(struct uart_port *port, u16 offs)
 222{
 223        return readl_relaxed(port->membase + offs);
 224}
 225
 226/**
 227 * __ssp_writel() - write to a SiFive serial port register
 228 * @v: value to write to the register
 229 * @offs: register address offset from the IP block base address
 230 * @ssp: pointer to a struct sifive_serial_port record
 231 *
 232 * Write the value @v to the IP block register located at offset @offs from the
 233 * IP block base, given a pointer @ssp to a struct sifive_serial_port record.
 234 *
 235 * Context: Any context.
 236 */
 237static void __ssp_writel(u32 v, u16 offs, struct sifive_serial_port *ssp)
 238{
 239        __ssp_early_writel(v, offs, &ssp->port);
 240}
 241
 242/**
 243 * __ssp_readl() - read from a SiFive serial port register
 244 * @ssp: pointer to a struct sifive_serial_port record
 245 * @offs: register address offset from the IP block base address
 246 *
 247 * Read the contents of the IP block register located at offset @offs from the
 248 * IP block base, given a pointer @ssp to a struct sifive_serial_port record.
 249 *
 250 * Context: Any context.
 251 *
 252 * Returns: the value of the UART register
 253 */
 254static u32 __ssp_readl(struct sifive_serial_port *ssp, u16 offs)
 255{
 256        return __ssp_early_readl(&ssp->port, offs);
 257}
 258
 259/**
 260 * sifive_serial_is_txfifo_full() - is the TXFIFO full?
 261 * @ssp: pointer to a struct sifive_serial_port
 262 *
 263 * Read the transmit FIFO "full" bit, returning a non-zero value if the
 264 * TX FIFO is full, or zero if space remains.  Intended to be used to prevent
 265 * writes to the TX FIFO when it's full.
 266 *
 267 * Returns: SIFIVE_SERIAL_TXDATA_FULL_MASK (non-zero) if the transmit FIFO
 268 * is full, or 0 if space remains.
 269 */
 270static int sifive_serial_is_txfifo_full(struct sifive_serial_port *ssp)
 271{
 272        return __ssp_readl(ssp, SIFIVE_SERIAL_TXDATA_OFFS) &
 273                SIFIVE_SERIAL_TXDATA_FULL_MASK;
 274}
 275
 276/**
 277 * __ssp_transmit_char() - enqueue a byte to transmit onto the TX FIFO
 278 * @ssp: pointer to a struct sifive_serial_port
 279 * @ch: character to transmit
 280 *
 281 * Enqueue a byte @ch onto the transmit FIFO, given a pointer @ssp to the
 282 * struct sifive_serial_port * to transmit on.  Caller should first check to
 283 * ensure that the TXFIFO has space; see sifive_serial_is_txfifo_full().
 284 *
 285 * Context: Any context.
 286 */
 287static void __ssp_transmit_char(struct sifive_serial_port *ssp, int ch)
 288{
 289        __ssp_writel(ch, SIFIVE_SERIAL_TXDATA_OFFS, ssp);
 290}
 291
 292/**
 293 * __ssp_transmit_chars() - enqueue multiple bytes onto the TX FIFO
 294 * @ssp: pointer to a struct sifive_serial_port
 295 *
 296 * Transfer up to a TX FIFO size's worth of characters from the Linux serial
 297 * transmit buffer to the SiFive UART TX FIFO.
 298 *
 299 * Context: Any context.  Expects @ssp->port.lock to be held by caller.
 300 */
 301static void __ssp_transmit_chars(struct sifive_serial_port *ssp)
 302{
 303        struct circ_buf *xmit = &ssp->port.state->xmit;
 304        int count;
 305
 306        if (ssp->port.x_char) {
 307                __ssp_transmit_char(ssp, ssp->port.x_char);
 308                ssp->port.icount.tx++;
 309                ssp->port.x_char = 0;
 310                return;
 311        }
 312        if (uart_circ_empty(xmit) || uart_tx_stopped(&ssp->port)) {
 313                sifive_serial_stop_tx(&ssp->port);
 314                return;
 315        }
 316        count = SIFIVE_TX_FIFO_DEPTH;
 317        do {
 318                __ssp_transmit_char(ssp, xmit->buf[xmit->tail]);
 319                xmit->tail = (xmit->tail + 1) & (UART_XMIT_SIZE - 1);
 320                ssp->port.icount.tx++;
 321                if (uart_circ_empty(xmit))
 322                        break;
 323        } while (--count > 0);
 324
 325        if (uart_circ_chars_pending(xmit) < WAKEUP_CHARS)
 326                uart_write_wakeup(&ssp->port);
 327
 328        if (uart_circ_empty(xmit))
 329                sifive_serial_stop_tx(&ssp->port);
 330}
 331
 332/**
 333 * __ssp_enable_txwm() - enable transmit watermark interrupts
 334 * @ssp: pointer to a struct sifive_serial_port
 335 *
 336 * Enable interrupt generation when the transmit FIFO watermark is reached
 337 * on the SiFive UART referred to by @ssp.
 338 */
 339static void __ssp_enable_txwm(struct sifive_serial_port *ssp)
 340{
 341        if (ssp->ier & SIFIVE_SERIAL_IE_TXWM_MASK)
 342                return;
 343
 344        ssp->ier |= SIFIVE_SERIAL_IE_TXWM_MASK;
 345        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
 346}
 347
 348/**
 349 * __ssp_enable_rxwm() - enable receive watermark interrupts
 350 * @ssp: pointer to a struct sifive_serial_port
 351 *
 352 * Enable interrupt generation when the receive FIFO watermark is reached
 353 * on the SiFive UART referred to by @ssp.
 354 */
 355static void __ssp_enable_rxwm(struct sifive_serial_port *ssp)
 356{
 357        if (ssp->ier & SIFIVE_SERIAL_IE_RXWM_MASK)
 358                return;
 359
 360        ssp->ier |= SIFIVE_SERIAL_IE_RXWM_MASK;
 361        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
 362}
 363
 364/**
 365 * __ssp_disable_txwm() - disable transmit watermark interrupts
 366 * @ssp: pointer to a struct sifive_serial_port
 367 *
 368 * Disable interrupt generation when the transmit FIFO watermark is reached
 369 * on the UART referred to by @ssp.
 370 */
 371static void __ssp_disable_txwm(struct sifive_serial_port *ssp)
 372{
 373        if (!(ssp->ier & SIFIVE_SERIAL_IE_TXWM_MASK))
 374                return;
 375
 376        ssp->ier &= ~SIFIVE_SERIAL_IE_TXWM_MASK;
 377        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
 378}
 379
 380/**
 381 * __ssp_disable_rxwm() - disable receive watermark interrupts
 382 * @ssp: pointer to a struct sifive_serial_port
 383 *
 384 * Disable interrupt generation when the receive FIFO watermark is reached
 385 * on the UART referred to by @ssp.
 386 */
 387static void __ssp_disable_rxwm(struct sifive_serial_port *ssp)
 388{
 389        if (!(ssp->ier & SIFIVE_SERIAL_IE_RXWM_MASK))
 390                return;
 391
 392        ssp->ier &= ~SIFIVE_SERIAL_IE_RXWM_MASK;
 393        __ssp_writel(ssp->ier, SIFIVE_SERIAL_IE_OFFS, ssp);
 394}
 395
 396/**
 397 * __ssp_receive_char() - receive a byte from the UART
 398 * @ssp: pointer to a struct sifive_serial_port
 399 * @is_empty: char pointer to return whether the RX FIFO is empty
 400 *
 401 * Try to read a byte from the SiFive UART RX FIFO, referenced by
 402 * @ssp, and to return it.  Also returns the RX FIFO empty bit in
 403 * the char pointed to by @ch.  The caller must pass the byte back to the
 404 * Linux serial layer if needed.
 405 *
 406 * Returns: the byte read from the UART RX FIFO.
 407 */
 408static char __ssp_receive_char(struct sifive_serial_port *ssp, char *is_empty)
 409{
 410        u32 v;
 411        u8 ch;
 412
 413        v = __ssp_readl(ssp, SIFIVE_SERIAL_RXDATA_OFFS);
 414
 415        if (!is_empty)
 416                WARN_ON(1);
 417        else
 418                *is_empty = (v & SIFIVE_SERIAL_RXDATA_EMPTY_MASK) >>
 419                        SIFIVE_SERIAL_RXDATA_EMPTY_SHIFT;
 420
 421        ch = (v & SIFIVE_SERIAL_RXDATA_DATA_MASK) >>
 422                SIFIVE_SERIAL_RXDATA_DATA_SHIFT;
 423
 424        return ch;
 425}
 426
 427/**
 428 * __ssp_receive_chars() - receive multiple bytes from the UART
 429 * @ssp: pointer to a struct sifive_serial_port
 430 *
 431 * Receive up to an RX FIFO's worth of bytes from the SiFive UART referred
 432 * to by @ssp and pass them up to the Linux serial layer.
 433 *
 434 * Context: Expects ssp->port.lock to be held by caller.
 435 */
 436static void __ssp_receive_chars(struct sifive_serial_port *ssp)
 437{
 438        unsigned char ch;
 439        char is_empty;
 440        int c;
 441
 442        for (c = SIFIVE_RX_FIFO_DEPTH; c > 0; --c) {
 443                ch = __ssp_receive_char(ssp, &is_empty);
 444                if (is_empty)
 445                        break;
 446
 447                ssp->port.icount.rx++;
 448                uart_insert_char(&ssp->port, 0, 0, ch, TTY_NORMAL);
 449        }
 450
 451        spin_unlock(&ssp->port.lock);
 452        tty_flip_buffer_push(&ssp->port.state->port);
 453        spin_lock(&ssp->port.lock);
 454}
 455
 456/**
 457 * __ssp_update_div() - calculate the divisor setting by the line rate
 458 * @ssp: pointer to a struct sifive_serial_port
 459 *
 460 * Calculate the appropriate value of the clock divisor for the UART
 461 * and target line rate referred to by @ssp and write it into the
 462 * hardware.
 463 */
 464static void __ssp_update_div(struct sifive_serial_port *ssp)
 465{
 466        u16 div;
 467
 468        div = DIV_ROUND_UP(ssp->clkin_rate, ssp->baud_rate) - 1;
 469
 470        __ssp_writel(div, SIFIVE_SERIAL_DIV_OFFS, ssp);
 471}
 472
 473/**
 474 * __ssp_update_baud_rate() - set the UART "baud rate"
 475 * @ssp: pointer to a struct sifive_serial_port
 476 * @rate: new target bit rate
 477 *
 478 * Calculate the UART divisor value for the target bit rate @rate for the
 479 * SiFive UART described by @ssp and program it into the UART.  There may
 480 * be some error between the target bit rate and the actual bit rate implemented
 481 * by the UART due to clock ratio granularity.
 482 */
 483static void __ssp_update_baud_rate(struct sifive_serial_port *ssp,
 484                                   unsigned int rate)
 485{
 486        if (ssp->baud_rate == rate)
 487                return;
 488
 489        ssp->baud_rate = rate;
 490        __ssp_update_div(ssp);
 491}
 492
 493/**
 494 * __ssp_set_stop_bits() - set the number of stop bits
 495 * @ssp: pointer to a struct sifive_serial_port
 496 * @nstop: 1 or 2 (stop bits)
 497 *
 498 * Program the SiFive UART referred to by @ssp to use @nstop stop bits.
 499 */
 500static void __ssp_set_stop_bits(struct sifive_serial_port *ssp, char nstop)
 501{
 502        u32 v;
 503
 504        if (nstop < 1 || nstop > 2) {
 505                WARN_ON(1);
 506                return;
 507        }
 508
 509        v = __ssp_readl(ssp, SIFIVE_SERIAL_TXCTRL_OFFS);
 510        v &= ~SIFIVE_SERIAL_TXCTRL_NSTOP_MASK;
 511        v |= (nstop - 1) << SIFIVE_SERIAL_TXCTRL_NSTOP_SHIFT;
 512        __ssp_writel(v, SIFIVE_SERIAL_TXCTRL_OFFS, ssp);
 513}
 514
 515/**
 516 * __ssp_wait_for_xmitr() - wait for an empty slot on the TX FIFO
 517 * @ssp: pointer to a struct sifive_serial_port
 518 *
 519 * Delay while the UART TX FIFO referred to by @ssp is marked as full.
 520 *
 521 * Context: Any context.
 522 */
 523static void __maybe_unused __ssp_wait_for_xmitr(struct sifive_serial_port *ssp)
 524{
 525        while (sifive_serial_is_txfifo_full(ssp))
 526                udelay(1); /* XXX Could probably be more intelligent here */
 527}
 528
 529/*
 530 * Linux serial API functions
 531 */
 532
 533static void sifive_serial_stop_tx(struct uart_port *port)
 534{
 535        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 536
 537        __ssp_disable_txwm(ssp);
 538}
 539
 540static void sifive_serial_stop_rx(struct uart_port *port)
 541{
 542        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 543
 544        __ssp_disable_rxwm(ssp);
 545}
 546
 547static void sifive_serial_start_tx(struct uart_port *port)
 548{
 549        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 550
 551        __ssp_enable_txwm(ssp);
 552}
 553
 554static irqreturn_t sifive_serial_irq(int irq, void *dev_id)
 555{
 556        struct sifive_serial_port *ssp = dev_id;
 557        u32 ip;
 558
 559        spin_lock(&ssp->port.lock);
 560
 561        ip = __ssp_readl(ssp, SIFIVE_SERIAL_IP_OFFS);
 562        if (!ip) {
 563                spin_unlock(&ssp->port.lock);
 564                return IRQ_NONE;
 565        }
 566
 567        if (ip & SIFIVE_SERIAL_IP_RXWM_MASK)
 568                __ssp_receive_chars(ssp);
 569        if (ip & SIFIVE_SERIAL_IP_TXWM_MASK)
 570                __ssp_transmit_chars(ssp);
 571
 572        spin_unlock(&ssp->port.lock);
 573
 574        return IRQ_HANDLED;
 575}
 576
 577static unsigned int sifive_serial_tx_empty(struct uart_port *port)
 578{
 579        return TIOCSER_TEMT;
 580}
 581
 582static unsigned int sifive_serial_get_mctrl(struct uart_port *port)
 583{
 584        return TIOCM_CAR | TIOCM_CTS | TIOCM_DSR;
 585}
 586
 587static void sifive_serial_set_mctrl(struct uart_port *port, unsigned int mctrl)
 588{
 589        /* IP block does not support these signals */
 590}
 591
 592static void sifive_serial_break_ctl(struct uart_port *port, int break_state)
 593{
 594        /* IP block does not support sending a break */
 595}
 596
 597static int sifive_serial_startup(struct uart_port *port)
 598{
 599        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 600
 601        __ssp_enable_rxwm(ssp);
 602
 603        return 0;
 604}
 605
 606static void sifive_serial_shutdown(struct uart_port *port)
 607{
 608        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 609
 610        __ssp_disable_rxwm(ssp);
 611        __ssp_disable_txwm(ssp);
 612}
 613
 614/**
 615 * sifive_serial_clk_notifier() - clock post-rate-change notifier
 616 * @nb: pointer to the struct notifier_block, from the notifier code
 617 * @event: event mask from the notifier code
 618 * @data: pointer to the struct clk_notifier_data from the notifier code
 619 *
 620 * On the V0 SoC, the UART IP block is derived from the CPU clock source
 621 * after a synchronous divide-by-two divider, so any CPU clock rate change
 622 * requires the UART baud rate to be updated.  This presumably corrupts any
 623 * serial word currently being transmitted or received.  In order to avoid
 624 * corrupting the output data stream, we drain the transmit queue before
 625 * allowing the clock's rate to be changed.
 626 */
 627static int sifive_serial_clk_notifier(struct notifier_block *nb,
 628                                      unsigned long event, void *data)
 629{
 630        struct clk_notifier_data *cnd = data;
 631        struct sifive_serial_port *ssp = notifier_to_sifive_serial_port(nb);
 632
 633        if (event == PRE_RATE_CHANGE) {
 634                /*
 635                 * The TX watermark is always set to 1 by this driver, which
 636                 * means that the TX busy bit will lower when there are 0 bytes
 637                 * left in the TX queue -- in other words, when the TX FIFO is
 638                 * empty.
 639                 */
 640                __ssp_wait_for_xmitr(ssp);
 641                /*
 642                 * On the cycle the TX FIFO goes empty there is still a full
 643                 * UART frame left to be transmitted in the shift register.
 644                 * The UART provides no way for software to directly determine
 645                 * when that last frame has been transmitted, so we just sleep
 646                 * here instead.  As we're not tracking the number of stop bits
 647                 * they're just worst cased here.  The rest of the serial
 648                 * framing parameters aren't configurable by software.
 649                 */
 650                udelay(DIV_ROUND_UP(12 * 1000 * 1000, ssp->baud_rate));
 651        }
 652
 653        if (event == POST_RATE_CHANGE && ssp->clkin_rate != cnd->new_rate) {
 654                ssp->clkin_rate = cnd->new_rate;
 655                __ssp_update_div(ssp);
 656        }
 657
 658        return NOTIFY_OK;
 659}
 660
 661static void sifive_serial_set_termios(struct uart_port *port,
 662                                      struct ktermios *termios,
 663                                      struct ktermios *old)
 664{
 665        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 666        unsigned long flags;
 667        u32 v, old_v;
 668        int rate;
 669        char nstop;
 670
 671        if ((termios->c_cflag & CSIZE) != CS8)
 672                dev_err_once(ssp->port.dev, "only 8-bit words supported\n");
 673        if (termios->c_iflag & (INPCK | PARMRK))
 674                dev_err_once(ssp->port.dev, "parity checking not supported\n");
 675        if (termios->c_iflag & BRKINT)
 676                dev_err_once(ssp->port.dev, "BREAK detection not supported\n");
 677
 678        /* Set number of stop bits */
 679        nstop = (termios->c_cflag & CSTOPB) ? 2 : 1;
 680        __ssp_set_stop_bits(ssp, nstop);
 681
 682        /* Set line rate */
 683        rate = uart_get_baud_rate(port, termios, old, 0, ssp->clkin_rate / 16);
 684        __ssp_update_baud_rate(ssp, rate);
 685
 686        spin_lock_irqsave(&ssp->port.lock, flags);
 687
 688        /* Update the per-port timeout */
 689        uart_update_timeout(port, termios->c_cflag, rate);
 690
 691        ssp->port.read_status_mask = 0;
 692
 693        /* Ignore all characters if CREAD is not set */
 694        v = __ssp_readl(ssp, SIFIVE_SERIAL_RXCTRL_OFFS);
 695        old_v = v;
 696        if ((termios->c_cflag & CREAD) == 0)
 697                v &= SIFIVE_SERIAL_RXCTRL_RXEN_MASK;
 698        else
 699                v |= SIFIVE_SERIAL_RXCTRL_RXEN_MASK;
 700        if (v != old_v)
 701                __ssp_writel(v, SIFIVE_SERIAL_RXCTRL_OFFS, ssp);
 702
 703        spin_unlock_irqrestore(&ssp->port.lock, flags);
 704}
 705
 706static void sifive_serial_release_port(struct uart_port *port)
 707{
 708}
 709
 710static int sifive_serial_request_port(struct uart_port *port)
 711{
 712        return 0;
 713}
 714
 715static void sifive_serial_config_port(struct uart_port *port, int flags)
 716{
 717        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 718
 719        ssp->port.type = PORT_SIFIVE_V0;
 720}
 721
 722static int sifive_serial_verify_port(struct uart_port *port,
 723                                     struct serial_struct *ser)
 724{
 725        return -EINVAL;
 726}
 727
 728static const char *sifive_serial_type(struct uart_port *port)
 729{
 730        return port->type == PORT_SIFIVE_V0 ? "SiFive UART v0" : NULL;
 731}
 732
 733#ifdef CONFIG_CONSOLE_POLL
 734static int sifive_serial_poll_get_char(struct uart_port *port)
 735{
 736        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 737        char is_empty, ch;
 738
 739        ch = __ssp_receive_char(ssp, &is_empty);
 740        if (is_empty)
 741                return NO_POLL_CHAR;
 742
 743        return ch;
 744}
 745
 746static void sifive_serial_poll_put_char(struct uart_port *port,
 747                                        unsigned char c)
 748{
 749        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 750
 751        __ssp_wait_for_xmitr(ssp);
 752        __ssp_transmit_char(ssp, c);
 753}
 754#endif /* CONFIG_CONSOLE_POLL */
 755
 756/*
 757 * Early console support
 758 */
 759
 760#ifdef CONFIG_SERIAL_EARLYCON
 761static void early_sifive_serial_putc(struct uart_port *port, int c)
 762{
 763        while (__ssp_early_readl(port, SIFIVE_SERIAL_TXDATA_OFFS) &
 764               SIFIVE_SERIAL_TXDATA_FULL_MASK)
 765                cpu_relax();
 766
 767        __ssp_early_writel(c, SIFIVE_SERIAL_TXDATA_OFFS, port);
 768}
 769
 770static void early_sifive_serial_write(struct console *con, const char *s,
 771                                      unsigned int n)
 772{
 773        struct earlycon_device *dev = con->data;
 774        struct uart_port *port = &dev->port;
 775
 776        uart_console_write(port, s, n, early_sifive_serial_putc);
 777}
 778
 779static int __init early_sifive_serial_setup(struct earlycon_device *dev,
 780                                            const char *options)
 781{
 782        struct uart_port *port = &dev->port;
 783
 784        if (!port->membase)
 785                return -ENODEV;
 786
 787        dev->con->write = early_sifive_serial_write;
 788
 789        return 0;
 790}
 791
 792OF_EARLYCON_DECLARE(sifive, "sifive,uart0", early_sifive_serial_setup);
 793OF_EARLYCON_DECLARE(sifive, "sifive,fu540-c000-uart0",
 794                    early_sifive_serial_setup);
 795#endif /* CONFIG_SERIAL_EARLYCON */
 796
 797/*
 798 * Linux console interface
 799 */
 800
 801#ifdef CONFIG_SERIAL_SIFIVE_CONSOLE
 802
 803static struct sifive_serial_port *sifive_serial_console_ports[SIFIVE_SERIAL_MAX_PORTS];
 804
 805static void sifive_serial_console_putchar(struct uart_port *port, int ch)
 806{
 807        struct sifive_serial_port *ssp = port_to_sifive_serial_port(port);
 808
 809        __ssp_wait_for_xmitr(ssp);
 810        __ssp_transmit_char(ssp, ch);
 811}
 812
 813static void sifive_serial_console_write(struct console *co, const char *s,
 814                                        unsigned int count)
 815{
 816        struct sifive_serial_port *ssp = sifive_serial_console_ports[co->index];
 817        unsigned long flags;
 818        unsigned int ier;
 819        int locked = 1;
 820
 821        if (!ssp)
 822                return;
 823
 824        local_irq_save(flags);
 825        if (ssp->port.sysrq)
 826                locked = 0;
 827        else if (oops_in_progress)
 828                locked = spin_trylock(&ssp->port.lock);
 829        else
 830                spin_lock(&ssp->port.lock);
 831
 832        ier = __ssp_readl(ssp, SIFIVE_SERIAL_IE_OFFS);
 833        __ssp_writel(0, SIFIVE_SERIAL_IE_OFFS, ssp);
 834
 835        uart_console_write(&ssp->port, s, count, sifive_serial_console_putchar);
 836
 837        __ssp_writel(ier, SIFIVE_SERIAL_IE_OFFS, ssp);
 838
 839        if (locked)
 840                spin_unlock(&ssp->port.lock);
 841        local_irq_restore(flags);
 842}
 843
 844static int __init sifive_serial_console_setup(struct console *co, char *options)
 845{
 846        struct sifive_serial_port *ssp;
 847        int baud = SIFIVE_DEFAULT_BAUD_RATE;
 848        int bits = 8;
 849        int parity = 'n';
 850        int flow = 'n';
 851
 852        if (co->index < 0 || co->index >= SIFIVE_SERIAL_MAX_PORTS)
 853                return -ENODEV;
 854
 855        ssp = sifive_serial_console_ports[co->index];
 856        if (!ssp)
 857                return -ENODEV;
 858
 859        if (options)
 860                uart_parse_options(options, &baud, &parity, &bits, &flow);
 861
 862        return uart_set_options(&ssp->port, co, baud, parity, bits, flow);
 863}
 864
 865static struct uart_driver sifive_serial_uart_driver;
 866
 867static struct console sifive_serial_console = {
 868        .name           = SIFIVE_TTY_PREFIX,
 869        .write          = sifive_serial_console_write,
 870        .device         = uart_console_device,
 871        .setup          = sifive_serial_console_setup,
 872        .flags          = CON_PRINTBUFFER,
 873        .index          = -1,
 874        .data           = &sifive_serial_uart_driver,
 875};
 876
 877static int __init sifive_console_init(void)
 878{
 879        register_console(&sifive_serial_console);
 880        return 0;
 881}
 882
 883console_initcall(sifive_console_init);
 884
 885static void __ssp_add_console_port(struct sifive_serial_port *ssp)
 886{
 887        sifive_serial_console_ports[ssp->port.line] = ssp;
 888}
 889
 890static void __ssp_remove_console_port(struct sifive_serial_port *ssp)
 891{
 892        sifive_serial_console_ports[ssp->port.line] = 0;
 893}
 894
 895#define SIFIVE_SERIAL_CONSOLE   (&sifive_serial_console)
 896
 897#else
 898
 899#define SIFIVE_SERIAL_CONSOLE   NULL
 900
 901static void __ssp_add_console_port(struct sifive_serial_port *ssp)
 902{}
 903static void __ssp_remove_console_port(struct sifive_serial_port *ssp)
 904{}
 905
 906#endif
 907
 908static const struct uart_ops sifive_serial_uops = {
 909        .tx_empty       = sifive_serial_tx_empty,
 910        .set_mctrl      = sifive_serial_set_mctrl,
 911        .get_mctrl      = sifive_serial_get_mctrl,
 912        .stop_tx        = sifive_serial_stop_tx,
 913        .start_tx       = sifive_serial_start_tx,
 914        .stop_rx        = sifive_serial_stop_rx,
 915        .break_ctl      = sifive_serial_break_ctl,
 916        .startup        = sifive_serial_startup,
 917        .shutdown       = sifive_serial_shutdown,
 918        .set_termios    = sifive_serial_set_termios,
 919        .type           = sifive_serial_type,
 920        .release_port   = sifive_serial_release_port,
 921        .request_port   = sifive_serial_request_port,
 922        .config_port    = sifive_serial_config_port,
 923        .verify_port    = sifive_serial_verify_port,
 924#ifdef CONFIG_CONSOLE_POLL
 925        .poll_get_char  = sifive_serial_poll_get_char,
 926        .poll_put_char  = sifive_serial_poll_put_char,
 927#endif
 928};
 929
 930static struct uart_driver sifive_serial_uart_driver = {
 931        .owner          = THIS_MODULE,
 932        .driver_name    = SIFIVE_SERIAL_NAME,
 933        .dev_name       = SIFIVE_TTY_PREFIX,
 934        .nr             = SIFIVE_SERIAL_MAX_PORTS,
 935        .cons           = SIFIVE_SERIAL_CONSOLE,
 936};
 937
 938static int sifive_serial_probe(struct platform_device *pdev)
 939{
 940        struct sifive_serial_port *ssp;
 941        struct resource *mem;
 942        struct clk *clk;
 943        void __iomem *base;
 944        int irq, id, r;
 945
 946        irq = platform_get_irq(pdev, 0);
 947        if (irq < 0)
 948                return -EPROBE_DEFER;
 949
 950        mem = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 951        base = devm_ioremap_resource(&pdev->dev, mem);
 952        if (IS_ERR(base)) {
 953                dev_err(&pdev->dev, "could not acquire device memory\n");
 954                return PTR_ERR(base);
 955        }
 956
 957        clk = devm_clk_get(&pdev->dev, NULL);
 958        if (IS_ERR(clk)) {
 959                dev_err(&pdev->dev, "unable to find controller clock\n");
 960                return PTR_ERR(clk);
 961        }
 962
 963        id = of_alias_get_id(pdev->dev.of_node, "serial");
 964        if (id < 0) {
 965                dev_err(&pdev->dev, "missing aliases entry\n");
 966                return id;
 967        }
 968
 969#ifdef CONFIG_SERIAL_SIFIVE_CONSOLE
 970        if (id > SIFIVE_SERIAL_MAX_PORTS) {
 971                dev_err(&pdev->dev, "too many UARTs (%d)\n", id);
 972                return -EINVAL;
 973        }
 974#endif
 975
 976        ssp = devm_kzalloc(&pdev->dev, sizeof(*ssp), GFP_KERNEL);
 977        if (!ssp)
 978                return -ENOMEM;
 979
 980        ssp->port.dev = &pdev->dev;
 981        ssp->port.type = PORT_SIFIVE_V0;
 982        ssp->port.iotype = UPIO_MEM;
 983        ssp->port.irq = irq;
 984        ssp->port.fifosize = SIFIVE_TX_FIFO_DEPTH;
 985        ssp->port.ops = &sifive_serial_uops;
 986        ssp->port.line = id;
 987        ssp->port.mapbase = mem->start;
 988        ssp->port.membase = base;
 989        ssp->dev = &pdev->dev;
 990        ssp->clk = clk;
 991        ssp->clk_notifier.notifier_call = sifive_serial_clk_notifier;
 992
 993        r = clk_notifier_register(ssp->clk, &ssp->clk_notifier);
 994        if (r) {
 995                dev_err(&pdev->dev, "could not register clock notifier: %d\n",
 996                        r);
 997                goto probe_out1;
 998        }
 999
1000        /* Set up clock divider */
1001        ssp->clkin_rate = clk_get_rate(ssp->clk);
1002        ssp->baud_rate = SIFIVE_DEFAULT_BAUD_RATE;
1003        ssp->port.uartclk = ssp->baud_rate * 16;
1004        __ssp_update_div(ssp);
1005
1006        platform_set_drvdata(pdev, ssp);
1007
1008        /* Enable transmits and set the watermark level to 1 */
1009        __ssp_writel((1 << SIFIVE_SERIAL_TXCTRL_TXCNT_SHIFT) |
1010                     SIFIVE_SERIAL_TXCTRL_TXEN_MASK,
1011                     SIFIVE_SERIAL_TXCTRL_OFFS, ssp);
1012
1013        /* Enable receives and set the watermark level to 0 */
1014        __ssp_writel((0 << SIFIVE_SERIAL_RXCTRL_RXCNT_SHIFT) |
1015                     SIFIVE_SERIAL_RXCTRL_RXEN_MASK,
1016                     SIFIVE_SERIAL_RXCTRL_OFFS, ssp);
1017
1018        r = request_irq(ssp->port.irq, sifive_serial_irq, ssp->port.irqflags,
1019                        dev_name(&pdev->dev), ssp);
1020        if (r) {
1021                dev_err(&pdev->dev, "could not attach interrupt: %d\n", r);
1022                goto probe_out2;
1023        }
1024
1025        __ssp_add_console_port(ssp);
1026
1027        r = uart_add_one_port(&sifive_serial_uart_driver, &ssp->port);
1028        if (r != 0) {
1029                dev_err(&pdev->dev, "could not add uart: %d\n", r);
1030                goto probe_out3;
1031        }
1032
1033        return 0;
1034
1035probe_out3:
1036        __ssp_remove_console_port(ssp);
1037        free_irq(ssp->port.irq, ssp);
1038probe_out2:
1039        clk_notifier_unregister(ssp->clk, &ssp->clk_notifier);
1040probe_out1:
1041        return r;
1042}
1043
1044static int sifive_serial_remove(struct platform_device *dev)
1045{
1046        struct sifive_serial_port *ssp = platform_get_drvdata(dev);
1047
1048        __ssp_remove_console_port(ssp);
1049        uart_remove_one_port(&sifive_serial_uart_driver, &ssp->port);
1050        free_irq(ssp->port.irq, ssp);
1051        clk_notifier_unregister(ssp->clk, &ssp->clk_notifier);
1052
1053        return 0;
1054}
1055
1056static const struct of_device_id sifive_serial_of_match[] = {
1057        { .compatible = "sifive,fu540-c000-uart0" },
1058        { .compatible = "sifive,uart0" },
1059        {},
1060};
1061MODULE_DEVICE_TABLE(of, sifive_serial_of_match);
1062
1063static struct platform_driver sifive_serial_platform_driver = {
1064        .probe          = sifive_serial_probe,
1065        .remove         = sifive_serial_remove,
1066        .driver         = {
1067                .name   = SIFIVE_SERIAL_NAME,
1068                .of_match_table = of_match_ptr(sifive_serial_of_match),
1069        },
1070};
1071
1072static int __init sifive_serial_init(void)
1073{
1074        int r;
1075
1076        r = uart_register_driver(&sifive_serial_uart_driver);
1077        if (r)
1078                goto init_out1;
1079
1080        r = platform_driver_register(&sifive_serial_platform_driver);
1081        if (r)
1082                goto init_out2;
1083
1084        return 0;
1085
1086init_out2:
1087        uart_unregister_driver(&sifive_serial_uart_driver);
1088init_out1:
1089        return r;
1090}
1091
1092static void __exit sifive_serial_exit(void)
1093{
1094        platform_driver_unregister(&sifive_serial_platform_driver);
1095        uart_unregister_driver(&sifive_serial_uart_driver);
1096}
1097
1098module_init(sifive_serial_init);
1099module_exit(sifive_serial_exit);
1100
1101MODULE_DESCRIPTION("SiFive UART serial driver");
1102MODULE_LICENSE("GPL");
1103MODULE_AUTHOR("Paul Walmsley <paul@pwsan.com>");
1104