1 // SPDX-License-Identifier: GPL-2.0-only
3 * Rockchip Serial Flash Controller Driver
5 * Copyright (c) 2017-2021, Rockchip Inc.
11 #include <linux/bitops.h>
12 #include <linux/clk.h>
13 #include <linux/completion.h>
14 #include <linux/dma-mapping.h>
15 #include <linux/iopoll.h>
17 #include <linux/module.h>
19 #include <linux/platform_device.h>
20 #include <linux/slab.h>
21 #include <linux/interrupt.h>
22 #include <linux/spi/spi-mem.h>
26 #define SFC_CTRL_PHASE_SEL_NEGETIVE BIT(1)
27 #define SFC_CTRL_CMD_BITS_SHIFT 8
28 #define SFC_CTRL_ADDR_BITS_SHIFT 10
29 #define SFC_CTRL_DATA_BITS_SHIFT 12
33 #define SFC_IMR_RX_FULL BIT(0)
34 #define SFC_IMR_RX_UFLOW BIT(1)
35 #define SFC_IMR_TX_OFLOW BIT(2)
36 #define SFC_IMR_TX_EMPTY BIT(3)
37 #define SFC_IMR_TRAN_FINISH BIT(4)
38 #define SFC_IMR_BUS_ERR BIT(5)
39 #define SFC_IMR_NSPI_ERR BIT(6)
40 #define SFC_IMR_DMA BIT(7)
44 #define SFC_ICLR_RX_FULL BIT(0)
45 #define SFC_ICLR_RX_UFLOW BIT(1)
46 #define SFC_ICLR_TX_OFLOW BIT(2)
47 #define SFC_ICLR_TX_EMPTY BIT(3)
48 #define SFC_ICLR_TRAN_FINISH BIT(4)
49 #define SFC_ICLR_BUS_ERR BIT(5)
50 #define SFC_ICLR_NSPI_ERR BIT(6)
51 #define SFC_ICLR_DMA BIT(7)
53 /* FIFO threshold level */
55 #define SFC_FTLR_TX_SHIFT 0
56 #define SFC_FTLR_TX_MASK 0x1f
57 #define SFC_FTLR_RX_SHIFT 8
58 #define SFC_FTLR_RX_MASK 0x1f
60 /* Reset FSM and FIFO */
62 #define SFC_RCVR_RESET BIT(0)
67 /* Address Bit number */
70 /* Interrupt status */
72 #define SFC_ISR_RX_FULL_SHIFT BIT(0)
73 #define SFC_ISR_RX_UFLOW_SHIFT BIT(1)
74 #define SFC_ISR_TX_OFLOW_SHIFT BIT(2)
75 #define SFC_ISR_TX_EMPTY_SHIFT BIT(3)
76 #define SFC_ISR_TX_FINISH_SHIFT BIT(4)
77 #define SFC_ISR_BUS_ERR_SHIFT BIT(5)
78 #define SFC_ISR_NSPI_ERR_SHIFT BIT(6)
79 #define SFC_ISR_DMA_SHIFT BIT(7)
83 #define SFC_FSR_TX_IS_FULL BIT(0)
84 #define SFC_FSR_TX_IS_EMPTY BIT(1)
85 #define SFC_FSR_RX_IS_EMPTY BIT(2)
86 #define SFC_FSR_RX_IS_FULL BIT(3)
87 #define SFC_FSR_TXLV_MASK GENMASK(12, 8)
88 #define SFC_FSR_TXLV_SHIFT 8
89 #define SFC_FSR_RXLV_MASK GENMASK(20, 16)
90 #define SFC_FSR_RXLV_SHIFT 16
94 #define SFC_SR_IS_IDLE 0x0
95 #define SFC_SR_IS_BUSY 0x1
97 /* Raw interrupt status */
99 #define SFC_RISR_RX_FULL BIT(0)
100 #define SFC_RISR_RX_UNDERFLOW BIT(1)
101 #define SFC_RISR_TX_OVERFLOW BIT(2)
102 #define SFC_RISR_TX_EMPTY BIT(3)
103 #define SFC_RISR_TRAN_FINISH BIT(4)
104 #define SFC_RISR_BUS_ERR BIT(5)
105 #define SFC_RISR_NSPI_ERR BIT(6)
106 #define SFC_RISR_DMA BIT(7)
110 #define SFC_VER_3 0x3
111 #define SFC_VER_4 0x4
112 #define SFC_VER_5 0x5
114 /* Delay line controller register */
115 #define SFC_DLL_CTRL0 0x3C
116 #define SFC_DLL_CTRL0_SCLK_SMP_DLL BIT(15)
117 #define SFC_DLL_CTRL0_DLL_MAX_VER4 0xFFU
118 #define SFC_DLL_CTRL0_DLL_MAX_VER5 0x1FFU
121 #define SFC_DMA_TRIGGER 0x80
122 #define SFC_DMA_TRIGGER_START 1
124 /* Src or Dst addr for master */
125 #define SFC_DMA_ADDR 0x84
127 /* Length control register extension 32GB */
128 #define SFC_LEN_CTRL 0x88
129 #define SFC_LEN_CTRL_TRB_SEL 1
130 #define SFC_LEN_EXT 0x8C
133 #define SFC_CMD 0x100
134 #define SFC_CMD_IDX_SHIFT 0
135 #define SFC_CMD_DUMMY_SHIFT 8
136 #define SFC_CMD_DIR_SHIFT 12
137 #define SFC_CMD_DIR_RD 0
138 #define SFC_CMD_DIR_WR 1
139 #define SFC_CMD_ADDR_SHIFT 14
140 #define SFC_CMD_ADDR_0BITS 0
141 #define SFC_CMD_ADDR_24BITS 1
142 #define SFC_CMD_ADDR_32BITS 2
143 #define SFC_CMD_ADDR_XBITS 3
144 #define SFC_CMD_TRAN_BYTES_SHIFT 16
145 #define SFC_CMD_CS_SHIFT 30
148 #define SFC_ADDR 0x104
151 #define SFC_DATA 0x108
153 /* The controller and documentation reports that it supports up to 4 CS
154 * devices (0-3), however I have only been able to test a single CS (CS 0)
155 * due to the configuration of my device.
157 #define SFC_MAX_CHIPSELECT_NUM 4
159 /* The SFC can transfer max 16KB - 1 at one time
160 * we set it to 15.5KB here for alignment.
162 #define SFC_MAX_IOSIZE_VER3 (512 * 31)
164 /* DMA is only enabled for large data transmission */
165 #define SFC_DMA_TRANS_THRETHOLD (0x40)
167 /* Maximum clock values from datasheet suggest keeping clock value under
168 * 150MHz. No minimum or average value is suggested.
170 #define SFC_MAX_SPEED (150 * 1000 * 1000)
172 struct rockchip_sfc {
174 void __iomem *regbase;
178 /* virtual mapped addr for dma_buffer */
180 dma_addr_t dma_buffer;
181 struct completion cp;
185 struct spi_controller *host;
188 static int rockchip_sfc_reset(struct rockchip_sfc *sfc)
193 writel_relaxed(SFC_RCVR_RESET, sfc->regbase + SFC_RCVR);
195 err = readl_poll_timeout(sfc->regbase + SFC_RCVR, status,
196 !(status & SFC_RCVR_RESET), 20,
197 jiffies_to_usecs(HZ));
199 dev_err(sfc->dev, "SFC reset never finished\n");
201 /* Still need to clear the masked interrupt from RISR */
202 writel_relaxed(0xFFFFFFFF, sfc->regbase + SFC_ICLR);
204 dev_dbg(sfc->dev, "reset\n");
209 static u16 rockchip_sfc_get_version(struct rockchip_sfc *sfc)
211 return (u16)(readl(sfc->regbase + SFC_VER) & 0xffff);
214 static u32 rockchip_sfc_get_max_iosize(struct rockchip_sfc *sfc)
216 return SFC_MAX_IOSIZE_VER3;
219 static void rockchip_sfc_irq_unmask(struct rockchip_sfc *sfc, u32 mask)
223 /* Enable transfer complete interrupt */
224 reg = readl(sfc->regbase + SFC_IMR);
226 writel(reg, sfc->regbase + SFC_IMR);
229 static void rockchip_sfc_irq_mask(struct rockchip_sfc *sfc, u32 mask)
233 /* Disable transfer finish interrupt */
234 reg = readl(sfc->regbase + SFC_IMR);
236 writel(reg, sfc->regbase + SFC_IMR);
239 static int rockchip_sfc_init(struct rockchip_sfc *sfc)
241 writel(0, sfc->regbase + SFC_CTRL);
242 writel(0xFFFFFFFF, sfc->regbase + SFC_ICLR);
243 rockchip_sfc_irq_mask(sfc, 0xFFFFFFFF);
244 if (rockchip_sfc_get_version(sfc) >= SFC_VER_4)
245 writel(SFC_LEN_CTRL_TRB_SEL, sfc->regbase + SFC_LEN_CTRL);
250 static int rockchip_sfc_wait_txfifo_ready(struct rockchip_sfc *sfc, u32 timeout_us)
255 ret = readl_poll_timeout(sfc->regbase + SFC_FSR, status,
256 status & SFC_FSR_TXLV_MASK, 0,
259 dev_dbg(sfc->dev, "sfc wait tx fifo timeout\n");
264 return (status & SFC_FSR_TXLV_MASK) >> SFC_FSR_TXLV_SHIFT;
267 static int rockchip_sfc_wait_rxfifo_ready(struct rockchip_sfc *sfc, u32 timeout_us)
272 ret = readl_poll_timeout(sfc->regbase + SFC_FSR, status,
273 status & SFC_FSR_RXLV_MASK, 0,
276 dev_dbg(sfc->dev, "sfc wait rx fifo timeout\n");
281 return (status & SFC_FSR_RXLV_MASK) >> SFC_FSR_RXLV_SHIFT;
284 static void rockchip_sfc_adjust_op_work(struct spi_mem_op *op)
286 if (unlikely(op->dummy.nbytes && !op->addr.nbytes)) {
288 * SFC not support output DUMMY cycles right after CMD cycles, so
289 * treat it as ADDR cycles.
291 op->addr.nbytes = op->dummy.nbytes;
292 op->addr.buswidth = op->dummy.buswidth;
293 op->addr.val = 0xFFFFFFFFF;
295 op->dummy.nbytes = 0;
299 static int rockchip_sfc_xfer_setup(struct rockchip_sfc *sfc,
301 const struct spi_mem_op *op,
304 u32 ctrl = 0, cmd = 0;
307 cmd = op->cmd.opcode;
308 ctrl |= ((op->cmd.buswidth >> 1) << SFC_CTRL_CMD_BITS_SHIFT);
311 if (op->addr.nbytes) {
312 if (op->addr.nbytes == 4) {
313 cmd |= SFC_CMD_ADDR_32BITS << SFC_CMD_ADDR_SHIFT;
314 } else if (op->addr.nbytes == 3) {
315 cmd |= SFC_CMD_ADDR_24BITS << SFC_CMD_ADDR_SHIFT;
317 cmd |= SFC_CMD_ADDR_XBITS << SFC_CMD_ADDR_SHIFT;
318 writel(op->addr.nbytes * 8 - 1, sfc->regbase + SFC_ABIT);
321 ctrl |= ((op->addr.buswidth >> 1) << SFC_CTRL_ADDR_BITS_SHIFT);
325 if (op->dummy.nbytes) {
326 if (op->dummy.buswidth == 4)
327 cmd |= op->dummy.nbytes * 2 << SFC_CMD_DUMMY_SHIFT;
328 else if (op->dummy.buswidth == 2)
329 cmd |= op->dummy.nbytes * 4 << SFC_CMD_DUMMY_SHIFT;
331 cmd |= op->dummy.nbytes * 8 << SFC_CMD_DUMMY_SHIFT;
335 if (sfc->version >= SFC_VER_4) /* Clear it if no data to transfer */
336 writel(len, sfc->regbase + SFC_LEN_EXT);
338 cmd |= len << SFC_CMD_TRAN_BYTES_SHIFT;
340 if (op->data.dir == SPI_MEM_DATA_OUT)
341 cmd |= SFC_CMD_DIR_WR << SFC_CMD_DIR_SHIFT;
343 ctrl |= ((op->data.buswidth >> 1) << SFC_CTRL_DATA_BITS_SHIFT);
345 if (!len && op->addr.nbytes)
346 cmd |= SFC_CMD_DIR_WR << SFC_CMD_DIR_SHIFT;
348 /* set the Controller */
349 ctrl |= SFC_CTRL_PHASE_SEL_NEGETIVE;
350 cmd |= spi_get_chipselect(mem->spi, 0) << SFC_CMD_CS_SHIFT;
352 dev_dbg(sfc->dev, "sfc addr.nbytes=%x(x%d) dummy.nbytes=%x(x%d)\n",
353 op->addr.nbytes, op->addr.buswidth,
354 op->dummy.nbytes, op->dummy.buswidth);
355 dev_dbg(sfc->dev, "sfc ctrl=%x cmd=%x addr=%llx len=%x\n",
356 ctrl, cmd, op->addr.val, len);
358 writel(ctrl, sfc->regbase + SFC_CTRL);
359 writel(cmd, sfc->regbase + SFC_CMD);
361 writel(op->addr.val, sfc->regbase + SFC_ADDR);
366 static int rockchip_sfc_write_fifo(struct rockchip_sfc *sfc, const u8 *buf, int len)
368 u8 bytes = len & 0x3;
376 tx_level = rockchip_sfc_wait_txfifo_ready(sfc, 1000);
379 write_words = min_t(u32, tx_level, dwords);
380 iowrite32_rep(sfc->regbase + SFC_DATA, buf, write_words);
381 buf += write_words << 2;
382 dwords -= write_words;
385 /* write the rest non word aligned bytes */
387 tx_level = rockchip_sfc_wait_txfifo_ready(sfc, 1000);
390 memcpy(&tmp, buf, bytes);
391 writel(tmp, sfc->regbase + SFC_DATA);
397 static int rockchip_sfc_read_fifo(struct rockchip_sfc *sfc, u8 *buf, int len)
399 u8 bytes = len & 0x3;
405 /* word aligned access only */
408 rx_level = rockchip_sfc_wait_rxfifo_ready(sfc, 1000);
411 read_words = min_t(u32, rx_level, dwords);
412 ioread32_rep(sfc->regbase + SFC_DATA, buf, read_words);
413 buf += read_words << 2;
414 dwords -= read_words;
417 /* read the rest non word aligned bytes */
419 rx_level = rockchip_sfc_wait_rxfifo_ready(sfc, 1000);
422 tmp = readl(sfc->regbase + SFC_DATA);
423 memcpy(buf, &tmp, bytes);
429 static int rockchip_sfc_fifo_transfer_dma(struct rockchip_sfc *sfc, dma_addr_t dma_buf, size_t len)
431 writel(0xFFFFFFFF, sfc->regbase + SFC_ICLR);
432 writel((u32)dma_buf, sfc->regbase + SFC_DMA_ADDR);
433 writel(SFC_DMA_TRIGGER_START, sfc->regbase + SFC_DMA_TRIGGER);
438 static int rockchip_sfc_xfer_data_poll(struct rockchip_sfc *sfc,
439 const struct spi_mem_op *op, u32 len)
441 dev_dbg(sfc->dev, "sfc xfer_poll len=%x\n", len);
443 if (op->data.dir == SPI_MEM_DATA_OUT)
444 return rockchip_sfc_write_fifo(sfc, op->data.buf.out, len);
446 return rockchip_sfc_read_fifo(sfc, op->data.buf.in, len);
449 static int rockchip_sfc_xfer_data_dma(struct rockchip_sfc *sfc,
450 const struct spi_mem_op *op, u32 len)
454 dev_dbg(sfc->dev, "sfc xfer_dma len=%x\n", len);
456 if (op->data.dir == SPI_MEM_DATA_OUT)
457 memcpy(sfc->buffer, op->data.buf.out, len);
459 ret = rockchip_sfc_fifo_transfer_dma(sfc, sfc->dma_buffer, len);
460 if (!wait_for_completion_timeout(&sfc->cp, msecs_to_jiffies(2000))) {
461 dev_err(sfc->dev, "DMA wait for transfer finish timeout\n");
464 rockchip_sfc_irq_mask(sfc, SFC_IMR_DMA);
465 if (op->data.dir == SPI_MEM_DATA_IN)
466 memcpy(op->data.buf.in, sfc->buffer, len);
471 static int rockchip_sfc_xfer_done(struct rockchip_sfc *sfc, u32 timeout_us)
476 ret = readl_poll_timeout(sfc->regbase + SFC_SR, status,
477 !(status & SFC_SR_IS_BUSY),
480 dev_err(sfc->dev, "wait sfc idle timeout\n");
481 rockchip_sfc_reset(sfc);
489 static int rockchip_sfc_exec_mem_op(struct spi_mem *mem, const struct spi_mem_op *op)
491 struct rockchip_sfc *sfc = spi_controller_get_devdata(mem->spi->controller);
492 u32 len = op->data.nbytes;
495 if (unlikely(mem->spi->max_speed_hz != sfc->frequency)) {
496 ret = clk_set_rate(sfc->clk, mem->spi->max_speed_hz);
499 sfc->frequency = mem->spi->max_speed_hz;
500 dev_dbg(sfc->dev, "set_freq=%dHz real_freq=%ldHz\n",
501 sfc->frequency, clk_get_rate(sfc->clk));
504 rockchip_sfc_adjust_op_work((struct spi_mem_op *)op);
505 rockchip_sfc_xfer_setup(sfc, mem, op, len);
507 if (likely(sfc->use_dma) && len >= SFC_DMA_TRANS_THRETHOLD && !(len & 0x3)) {
508 init_completion(&sfc->cp);
509 rockchip_sfc_irq_unmask(sfc, SFC_IMR_DMA);
510 ret = rockchip_sfc_xfer_data_dma(sfc, op, len);
512 ret = rockchip_sfc_xfer_data_poll(sfc, op, len);
516 dev_err(sfc->dev, "xfer data failed ret %d dir %d\n", ret, op->data.dir);
522 return rockchip_sfc_xfer_done(sfc, 100000);
525 static int rockchip_sfc_adjust_op_size(struct spi_mem *mem, struct spi_mem_op *op)
527 struct rockchip_sfc *sfc = spi_controller_get_devdata(mem->spi->controller);
529 op->data.nbytes = min(op->data.nbytes, sfc->max_iosize);
534 static const struct spi_controller_mem_ops rockchip_sfc_mem_ops = {
535 .exec_op = rockchip_sfc_exec_mem_op,
536 .adjust_op_size = rockchip_sfc_adjust_op_size,
539 static irqreturn_t rockchip_sfc_irq_handler(int irq, void *dev_id)
541 struct rockchip_sfc *sfc = dev_id;
544 reg = readl(sfc->regbase + SFC_RISR);
546 /* Clear interrupt */
547 writel_relaxed(reg, sfc->regbase + SFC_ICLR);
549 if (reg & SFC_RISR_DMA) {
558 static int rockchip_sfc_probe(struct platform_device *pdev)
560 struct device *dev = &pdev->dev;
561 struct spi_controller *host;
562 struct rockchip_sfc *sfc;
565 host = devm_spi_alloc_host(&pdev->dev, sizeof(*sfc));
569 host->flags = SPI_CONTROLLER_HALF_DUPLEX;
570 host->mem_ops = &rockchip_sfc_mem_ops;
571 host->dev.of_node = pdev->dev.of_node;
572 host->mode_bits = SPI_TX_QUAD | SPI_TX_DUAL | SPI_RX_QUAD | SPI_RX_DUAL;
573 host->max_speed_hz = SFC_MAX_SPEED;
574 host->num_chipselect = SFC_MAX_CHIPSELECT_NUM;
576 sfc = spi_controller_get_devdata(host);
580 sfc->regbase = devm_platform_ioremap_resource(pdev, 0);
581 if (IS_ERR(sfc->regbase))
582 return PTR_ERR(sfc->regbase);
584 sfc->clk = devm_clk_get(&pdev->dev, "clk_sfc");
585 if (IS_ERR(sfc->clk))
586 return dev_err_probe(&pdev->dev, PTR_ERR(sfc->clk),
587 "Failed to get sfc interface clk\n");
589 sfc->hclk = devm_clk_get(&pdev->dev, "hclk_sfc");
590 if (IS_ERR(sfc->hclk))
591 return dev_err_probe(&pdev->dev, PTR_ERR(sfc->hclk),
592 "Failed to get sfc ahb clk\n");
594 sfc->use_dma = !of_property_read_bool(sfc->dev->of_node, "rockchip,sfc-no-dma");
597 ret = dma_set_mask_and_coherent(dev, DMA_BIT_MASK(32));
599 dev_warn(dev, "Unable to set dma mask\n");
603 sfc->buffer = dmam_alloc_coherent(dev, SFC_MAX_IOSIZE_VER3,
604 &sfc->dma_buffer, GFP_KERNEL);
609 ret = clk_prepare_enable(sfc->hclk);
611 dev_err(&pdev->dev, "Failed to enable ahb clk\n");
615 ret = clk_prepare_enable(sfc->clk);
617 dev_err(&pdev->dev, "Failed to enable interface clk\n");
622 ret = platform_get_irq(pdev, 0);
626 ret = devm_request_irq(dev, ret, rockchip_sfc_irq_handler,
629 dev_err(dev, "Failed to request irq\n");
633 ret = rockchip_sfc_init(sfc);
637 sfc->max_iosize = rockchip_sfc_get_max_iosize(sfc);
638 sfc->version = rockchip_sfc_get_version(sfc);
640 ret = spi_register_controller(host);
647 clk_disable_unprepare(sfc->clk);
649 clk_disable_unprepare(sfc->hclk);
654 static void rockchip_sfc_remove(struct platform_device *pdev)
656 struct rockchip_sfc *sfc = platform_get_drvdata(pdev);
657 struct spi_controller *host = sfc->host;
659 spi_unregister_controller(host);
661 clk_disable_unprepare(sfc->clk);
662 clk_disable_unprepare(sfc->hclk);
665 static const struct of_device_id rockchip_sfc_dt_ids[] = {
666 { .compatible = "rockchip,sfc"},
669 MODULE_DEVICE_TABLE(of, rockchip_sfc_dt_ids);
671 static struct platform_driver rockchip_sfc_driver = {
673 .name = "rockchip-sfc",
674 .of_match_table = rockchip_sfc_dt_ids,
676 .probe = rockchip_sfc_probe,
677 .remove = rockchip_sfc_remove,
679 module_platform_driver(rockchip_sfc_driver);
681 MODULE_LICENSE("GPL v2");
682 MODULE_DESCRIPTION("Rockchip Serial Flash Controller Driver");