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 */ 158 struct 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 */ 183 static 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 */ 201 static 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 */ 221 static 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 */ 237 static 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 */ 254 static 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 */ 270 static 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 */ 287 static 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 */ 301 static 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 */ 339 static 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 */ 355 static 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 */ 371 static 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 */ 387 static 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 */ 408 static 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 */ 436 static 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 */ 464 static 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 */ 483 static 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 */ 500 static 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 */ 523 static 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 533 static 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 540 static 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 547 static 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 554 static 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 577 static unsigned int sifive_serial_tx_empty(struct uart_port *port) 578 { 579 return TIOCSER_TEMT; 580 } 581 582 static unsigned int sifive_serial_get_mctrl(struct uart_port *port) 583 { 584 return TIOCM_CAR | TIOCM_CTS | TIOCM_DSR; 585 } 586 587 static void sifive_serial_set_mctrl(struct uart_port *port, unsigned int mctrl) 588 { 589 /* IP block does not support these signals */ 590 } 591 592 static void sifive_serial_break_ctl(struct uart_port *port, int break_state) 593 { 594 /* IP block does not support sending a break */ 595 } 596 597 static 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 606 static 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 */ 627 static 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 661 static 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 706 static void sifive_serial_release_port(struct uart_port *port) 707 { 708 } 709 710 static int sifive_serial_request_port(struct uart_port *port) 711 { 712 return 0; 713 } 714 715 static 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 722 static int sifive_serial_verify_port(struct uart_port *port, 723 struct serial_struct *ser) 724 { 725 return -EINVAL; 726 } 727 728 static 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 734 static 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 746 static 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 761 static 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 770 static 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 779 static 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 792 OF_EARLYCON_DECLARE(sifive, "sifive,uart0", early_sifive_serial_setup); 793 OF_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 803 static struct sifive_serial_port *sifive_serial_console_ports[SIFIVE_SERIAL_MAX_PORTS]; 804 805 static 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 813 static 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 844 static 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 865 static struct uart_driver sifive_serial_uart_driver; 866 867 static 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 877 static int __init sifive_console_init(void) 878 { 879 register_console(&sifive_serial_console); 880 return 0; 881 } 882 883 console_initcall(sifive_console_init); 884 885 static void __ssp_add_console_port(struct sifive_serial_port *ssp) 886 { 887 sifive_serial_console_ports[ssp->port.line] = ssp; 888 } 889 890 static 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 901 static void __ssp_add_console_port(struct sifive_serial_port *ssp) 902 {} 903 static void __ssp_remove_console_port(struct sifive_serial_port *ssp) 904 {} 905 906 #endif 907 908 static 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 930 static 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 938 static 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 1035 probe_out3: 1036 __ssp_remove_console_port(ssp); 1037 free_irq(ssp->port.irq, ssp); 1038 probe_out2: 1039 clk_notifier_unregister(ssp->clk, &ssp->clk_notifier); 1040 probe_out1: 1041 return r; 1042 } 1043 1044 static 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 1056 static const struct of_device_id sifive_serial_of_match[] = { 1057 { .compatible = "sifive,fu540-c000-uart0" }, 1058 { .compatible = "sifive,uart0" }, 1059 {}, 1060 }; 1061 MODULE_DEVICE_TABLE(of, sifive_serial_of_match); 1062 1063 static 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 1072 static 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 1086 init_out2: 1087 uart_unregister_driver(&sifive_serial_uart_driver); 1088 init_out1: 1089 return r; 1090 } 1091 1092 static 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 1098 module_init(sifive_serial_init); 1099 module_exit(sifive_serial_exit); 1100 1101 MODULE_DESCRIPTION("SiFive UART serial driver"); 1102 MODULE_LICENSE("GPL"); 1103 MODULE_AUTHOR("Paul Walmsley <paul@pwsan.com>"); 1104