4 * Copyright (C) 2017, Ludovic Barre
6 * License terms: GNU General Public License (GPL), version 2
9 #include <linux/errno.h>
11 #include <linux/iopoll.h>
12 #include <linux/interrupt.h>
13 #include <linux/module.h>
14 #include <linux/mtd/mtd.h>
15 #include <linux/mtd/partitions.h>
16 #include <linux/mtd/spi-nor.h>
17 #include <linux/mutex.h>
19 #include <linux/of_device.h>
20 #include <linux/platform_device.h>
21 #include <linux/reset.h>
22 #include <linux/sizes.h>
24 #define QUADSPI_CR 0x00
26 #define CR_ABORT BIT(1)
27 #define CR_DMAEN BIT(2)
28 #define CR_TCEN BIT(3)
29 #define CR_SSHIFT BIT(4)
31 #define CR_FSEL BIT(7)
32 #define CR_FTHRES_SHIFT 8
33 #define CR_FTHRES_MASK GENMASK(12, 8)
34 #define CR_FTHRES(n) (((n) << CR_FTHRES_SHIFT) & CR_FTHRES_MASK)
35 #define CR_TEIE BIT(16)
36 #define CR_TCIE BIT(17)
37 #define CR_FTIE BIT(18)
38 #define CR_SMIE BIT(19)
39 #define CR_TOIE BIT(20)
40 #define CR_PRESC_SHIFT 24
41 #define CR_PRESC_MASK GENMASK(31, 24)
42 #define CR_PRESC(n) (((n) << CR_PRESC_SHIFT) & CR_PRESC_MASK)
44 #define QUADSPI_DCR 0x04
45 #define DCR_CSHT_SHIFT 8
46 #define DCR_CSHT_MASK GENMASK(10, 8)
47 #define DCR_CSHT(n) (((n) << DCR_CSHT_SHIFT) & DCR_CSHT_MASK)
48 #define DCR_FSIZE_SHIFT 16
49 #define DCR_FSIZE_MASK GENMASK(20, 16)
50 #define DCR_FSIZE(n) (((n) << DCR_FSIZE_SHIFT) & DCR_FSIZE_MASK)
52 #define QUADSPI_SR 0x08
58 #define SR_BUSY BIT(5)
59 #define SR_FLEVEL_SHIFT 8
60 #define SR_FLEVEL_MASK GENMASK(13, 8)
62 #define QUADSPI_FCR 0x0c
63 #define FCR_CTCF BIT(1)
65 #define QUADSPI_DLR 0x10
67 #define QUADSPI_CCR 0x14
68 #define CCR_INST_SHIFT 0
69 #define CCR_INST_MASK GENMASK(7, 0)
70 #define CCR_INST(n) (((n) << CCR_INST_SHIFT) & CCR_INST_MASK)
71 #define CCR_IMODE_NONE (0U << 8)
72 #define CCR_IMODE_1 (1U << 8)
73 #define CCR_IMODE_2 (2U << 8)
74 #define CCR_IMODE_4 (3U << 8)
75 #define CCR_ADMODE_NONE (0U << 10)
76 #define CCR_ADMODE_1 (1U << 10)
77 #define CCR_ADMODE_2 (2U << 10)
78 #define CCR_ADMODE_4 (3U << 10)
79 #define CCR_ADSIZE_SHIFT 12
80 #define CCR_ADSIZE_MASK GENMASK(13, 12)
81 #define CCR_ADSIZE(n) (((n) << CCR_ADSIZE_SHIFT) & CCR_ADSIZE_MASK)
82 #define CCR_ABMODE_NONE (0U << 14)
83 #define CCR_ABMODE_1 (1U << 14)
84 #define CCR_ABMODE_2 (2U << 14)
85 #define CCR_ABMODE_4 (3U << 14)
86 #define CCR_ABSIZE_8 (0U << 16)
87 #define CCR_ABSIZE_16 (1U << 16)
88 #define CCR_ABSIZE_24 (2U << 16)
89 #define CCR_ABSIZE_32 (3U << 16)
90 #define CCR_DCYC_SHIFT 18
91 #define CCR_DCYC_MASK GENMASK(22, 18)
92 #define CCR_DCYC(n) (((n) << CCR_DCYC_SHIFT) & CCR_DCYC_MASK)
93 #define CCR_DMODE_NONE (0U << 24)
94 #define CCR_DMODE_1 (1U << 24)
95 #define CCR_DMODE_2 (2U << 24)
96 #define CCR_DMODE_4 (3U << 24)
97 #define CCR_FMODE_INDW (0U << 26)
98 #define CCR_FMODE_INDR (1U << 26)
99 #define CCR_FMODE_APM (2U << 26)
100 #define CCR_FMODE_MM (3U << 26)
102 #define QUADSPI_AR 0x18
103 #define QUADSPI_ABR 0x1c
104 #define QUADSPI_DR 0x20
105 #define QUADSPI_PSMKR 0x24
106 #define QUADSPI_PSMAR 0x28
107 #define QUADSPI_PIR 0x2c
108 #define QUADSPI_LPTR 0x30
109 #define LPTR_DFT_TIMEOUT 0x10
111 #define FSIZE_VAL(size) (__fls(size) - 1)
113 #define STM32_MAX_MMAP_SZ SZ_256M
114 #define STM32_MAX_NORCHIP 2
116 #define STM32_QSPI_FIFO_TIMEOUT_US 30000
117 #define STM32_QSPI_BUSY_TIMEOUT_US 100000
119 struct stm32_qspi_flash {
121 struct stm32_qspi *qspi;
131 void __iomem *io_base;
132 void __iomem *mm_base;
133 resource_size_t mm_size;
137 struct stm32_qspi_flash flash[STM32_MAX_NORCHIP];
138 struct completion cmd_completion;
141 * to protect device configuration, could be different between
142 * 2 flash access (bk1, bk2)
147 struct stm32_qspi_cmd {
159 static int stm32_qspi_wait_cmd(struct stm32_qspi *qspi)
164 if (readl_relaxed(qspi->io_base + QUADSPI_SR) & SR_TCF)
167 reinit_completion(&qspi->cmd_completion);
168 cr = readl_relaxed(qspi->io_base + QUADSPI_CR);
169 writel_relaxed(cr | CR_TCIE, qspi->io_base + QUADSPI_CR);
171 if (!wait_for_completion_interruptible_timeout(&qspi->cmd_completion,
172 msecs_to_jiffies(1000)))
175 writel_relaxed(cr, qspi->io_base + QUADSPI_CR);
179 static int stm32_qspi_wait_nobusy(struct stm32_qspi *qspi)
183 return readl_relaxed_poll_timeout(qspi->io_base + QUADSPI_SR, sr,
185 STM32_QSPI_BUSY_TIMEOUT_US);
188 static void stm32_qspi_set_framemode(struct spi_nor *nor,
189 struct stm32_qspi_cmd *cmd, bool read)
191 u32 dmode = CCR_DMODE_1;
193 cmd->framemode = CCR_IMODE_1;
196 switch (nor->read_proto) {
198 case SNOR_PROTO_1_1_1:
201 case SNOR_PROTO_1_1_2:
204 case SNOR_PROTO_1_1_4:
210 cmd->framemode |= cmd->tx_data ? dmode : 0;
211 cmd->framemode |= cmd->addr_width ? CCR_ADMODE_1 : 0;
214 static void stm32_qspi_read_fifo(u8 *val, void __iomem *addr)
216 *val = readb_relaxed(addr);
219 static void stm32_qspi_write_fifo(u8 *val, void __iomem *addr)
221 writeb_relaxed(*val, addr);
224 static int stm32_qspi_tx_poll(struct stm32_qspi *qspi,
225 const struct stm32_qspi_cmd *cmd)
227 void (*tx_fifo)(u8 *, void __iomem *);
228 u32 len = cmd->len, sr;
232 if (cmd->qspimode == CCR_FMODE_INDW)
233 tx_fifo = stm32_qspi_write_fifo;
235 tx_fifo = stm32_qspi_read_fifo;
238 ret = readl_relaxed_poll_timeout(qspi->io_base + QUADSPI_SR,
239 sr, (sr & SR_FTF), 10,
240 STM32_QSPI_FIFO_TIMEOUT_US);
242 dev_err(qspi->dev, "fifo timeout (stat:%#x)\n", sr);
245 tx_fifo(buf++, qspi->io_base + QUADSPI_DR);
251 static int stm32_qspi_tx_mm(struct stm32_qspi *qspi,
252 const struct stm32_qspi_cmd *cmd)
254 memcpy_fromio(cmd->buf, qspi->mm_base + cmd->addr, cmd->len);
258 static int stm32_qspi_tx(struct stm32_qspi *qspi,
259 const struct stm32_qspi_cmd *cmd)
264 if (cmd->qspimode == CCR_FMODE_MM)
265 return stm32_qspi_tx_mm(qspi, cmd);
267 return stm32_qspi_tx_poll(qspi, cmd);
270 static int stm32_qspi_send(struct stm32_qspi_flash *flash,
271 const struct stm32_qspi_cmd *cmd)
273 struct stm32_qspi *qspi = flash->qspi;
277 err = stm32_qspi_wait_nobusy(qspi);
281 dcr = readl_relaxed(qspi->io_base + QUADSPI_DCR) & ~DCR_FSIZE_MASK;
282 dcr |= DCR_FSIZE(flash->fsize);
283 writel_relaxed(dcr, qspi->io_base + QUADSPI_DCR);
285 cr = readl_relaxed(qspi->io_base + QUADSPI_CR);
286 cr &= ~CR_PRESC_MASK & ~CR_FSEL;
287 cr |= CR_PRESC(flash->presc);
288 cr |= flash->cs ? CR_FSEL : 0;
289 writel_relaxed(cr, qspi->io_base + QUADSPI_CR);
292 writel_relaxed(cmd->len - 1, qspi->io_base + QUADSPI_DLR);
294 ccr = cmd->framemode | cmd->qspimode;
297 ccr |= CCR_DCYC(cmd->dummy);
300 ccr |= CCR_ADSIZE(cmd->addr_width - 1);
302 ccr |= CCR_INST(cmd->opcode);
303 writel_relaxed(ccr, qspi->io_base + QUADSPI_CCR);
305 if (cmd->addr_width && cmd->qspimode != CCR_FMODE_MM)
306 writel_relaxed(cmd->addr, qspi->io_base + QUADSPI_AR);
308 err = stm32_qspi_tx(qspi, cmd);
312 if (cmd->qspimode != CCR_FMODE_MM) {
313 err = stm32_qspi_wait_cmd(qspi);
316 writel_relaxed(FCR_CTCF, qspi->io_base + QUADSPI_FCR);
322 cr = readl_relaxed(qspi->io_base + QUADSPI_CR) | CR_ABORT;
323 writel_relaxed(cr, qspi->io_base + QUADSPI_CR);
325 dev_err(qspi->dev, "%s abort err:%d\n", __func__, err);
329 static int stm32_qspi_read_reg(struct spi_nor *nor,
330 u8 opcode, u8 *buf, int len)
332 struct stm32_qspi_flash *flash = nor->priv;
333 struct device *dev = flash->qspi->dev;
334 struct stm32_qspi_cmd cmd;
336 dev_dbg(dev, "read_reg: cmd:%#.2x buf:%p len:%#x\n", opcode, buf, len);
338 memset(&cmd, 0, sizeof(cmd));
343 cmd.qspimode = CCR_FMODE_INDR;
345 stm32_qspi_set_framemode(nor, &cmd, false);
347 return stm32_qspi_send(flash, &cmd);
350 static int stm32_qspi_write_reg(struct spi_nor *nor, u8 opcode,
353 struct stm32_qspi_flash *flash = nor->priv;
354 struct device *dev = flash->qspi->dev;
355 struct stm32_qspi_cmd cmd;
357 dev_dbg(dev, "write_reg: cmd:%#.2x buf:%p len:%#x\n", opcode, buf, len);
359 memset(&cmd, 0, sizeof(cmd));
361 cmd.tx_data = !!(buf && len > 0);
364 cmd.qspimode = CCR_FMODE_INDW;
366 stm32_qspi_set_framemode(nor, &cmd, false);
368 return stm32_qspi_send(flash, &cmd);
371 static ssize_t stm32_qspi_read(struct spi_nor *nor, loff_t from, size_t len,
374 struct stm32_qspi_flash *flash = nor->priv;
375 struct stm32_qspi *qspi = flash->qspi;
376 struct stm32_qspi_cmd cmd;
379 dev_dbg(qspi->dev, "read(%#.2x): buf:%p from:%#.8x len:%#zx\n",
380 nor->read_opcode, buf, (u32)from, len);
382 memset(&cmd, 0, sizeof(cmd));
383 cmd.opcode = nor->read_opcode;
384 cmd.addr_width = nor->addr_width;
385 cmd.addr = (u32)from;
387 cmd.dummy = nor->read_dummy;
390 cmd.qspimode = flash->read_mode;
392 stm32_qspi_set_framemode(nor, &cmd, true);
393 err = stm32_qspi_send(flash, &cmd);
395 return err ? err : len;
398 static ssize_t stm32_qspi_write(struct spi_nor *nor, loff_t to, size_t len,
401 struct stm32_qspi_flash *flash = nor->priv;
402 struct device *dev = flash->qspi->dev;
403 struct stm32_qspi_cmd cmd;
406 dev_dbg(dev, "write(%#.2x): buf:%p to:%#.8x len:%#zx\n",
407 nor->program_opcode, buf, (u32)to, len);
409 memset(&cmd, 0, sizeof(cmd));
410 cmd.opcode = nor->program_opcode;
411 cmd.addr_width = nor->addr_width;
415 cmd.buf = (void *)buf;
416 cmd.qspimode = CCR_FMODE_INDW;
418 stm32_qspi_set_framemode(nor, &cmd, false);
419 err = stm32_qspi_send(flash, &cmd);
421 return err ? err : len;
424 static int stm32_qspi_erase(struct spi_nor *nor, loff_t offs)
426 struct stm32_qspi_flash *flash = nor->priv;
427 struct device *dev = flash->qspi->dev;
428 struct stm32_qspi_cmd cmd;
430 dev_dbg(dev, "erase(%#.2x):offs:%#x\n", nor->erase_opcode, (u32)offs);
432 memset(&cmd, 0, sizeof(cmd));
433 cmd.opcode = nor->erase_opcode;
434 cmd.addr_width = nor->addr_width;
435 cmd.addr = (u32)offs;
436 cmd.qspimode = CCR_FMODE_INDW;
438 stm32_qspi_set_framemode(nor, &cmd, false);
440 return stm32_qspi_send(flash, &cmd);
443 static irqreturn_t stm32_qspi_irq(int irq, void *dev_id)
445 struct stm32_qspi *qspi = (struct stm32_qspi *)dev_id;
448 cr = readl_relaxed(qspi->io_base + QUADSPI_CR);
449 sr = readl_relaxed(qspi->io_base + QUADSPI_SR);
451 if ((cr & CR_TCIE) && (sr & SR_TCF)) {
454 complete(&qspi->cmd_completion);
456 dev_info_ratelimited(qspi->dev, "spurious interrupt\n");
459 writel_relaxed(fcr, qspi->io_base + QUADSPI_FCR);
464 static int stm32_qspi_prep(struct spi_nor *nor, enum spi_nor_ops ops)
466 struct stm32_qspi_flash *flash = nor->priv;
467 struct stm32_qspi *qspi = flash->qspi;
469 mutex_lock(&qspi->lock);
473 static void stm32_qspi_unprep(struct spi_nor *nor, enum spi_nor_ops ops)
475 struct stm32_qspi_flash *flash = nor->priv;
476 struct stm32_qspi *qspi = flash->qspi;
478 mutex_unlock(&qspi->lock);
481 static int stm32_qspi_flash_setup(struct stm32_qspi *qspi,
482 struct device_node *np)
484 struct spi_nor_hwcaps hwcaps = {
485 .mask = SNOR_HWCAPS_READ |
486 SNOR_HWCAPS_READ_FAST |
489 u32 width, presc, cs_num, max_rate = 0;
490 struct stm32_qspi_flash *flash;
491 struct mtd_info *mtd;
494 of_property_read_u32(np, "reg", &cs_num);
495 if (cs_num >= STM32_MAX_NORCHIP)
498 of_property_read_u32(np, "spi-max-frequency", &max_rate);
502 presc = DIV_ROUND_UP(qspi->clk_rate, max_rate) - 1;
504 if (of_property_read_u32(np, "spi-rx-bus-width", &width))
508 hwcaps.mask |= SNOR_HWCAPS_READ_1_1_4;
510 hwcaps.mask |= SNOR_HWCAPS_READ_1_1_2;
514 flash = &qspi->flash[cs_num];
517 flash->presc = presc;
519 flash->nor.dev = qspi->dev;
520 spi_nor_set_flash_node(&flash->nor, np);
521 flash->nor.priv = flash;
522 mtd = &flash->nor.mtd;
524 flash->nor.read = stm32_qspi_read;
525 flash->nor.write = stm32_qspi_write;
526 flash->nor.erase = stm32_qspi_erase;
527 flash->nor.read_reg = stm32_qspi_read_reg;
528 flash->nor.write_reg = stm32_qspi_write_reg;
529 flash->nor.prepare = stm32_qspi_prep;
530 flash->nor.unprepare = stm32_qspi_unprep;
532 writel_relaxed(LPTR_DFT_TIMEOUT, qspi->io_base + QUADSPI_LPTR);
534 writel_relaxed(CR_PRESC(presc) | CR_FTHRES(3) | CR_TCEN | CR_SSHIFT
535 | CR_EN, qspi->io_base + QUADSPI_CR);
538 * in stm32 qspi controller, QUADSPI_DCR register has a fsize field
539 * which define the size of nor flash.
540 * if fsize is NULL, the controller can't sent spi-nor command.
541 * set a temporary value just to discover the nor flash with
542 * "spi_nor_scan". After, the right value (mtd->size) can be set.
544 flash->fsize = FSIZE_VAL(SZ_1K);
546 ret = spi_nor_scan(&flash->nor, NULL, &hwcaps);
548 dev_err(qspi->dev, "device scan failed\n");
552 flash->fsize = FSIZE_VAL(mtd->size);
554 flash->read_mode = CCR_FMODE_MM;
555 if (mtd->size > qspi->mm_size)
556 flash->read_mode = CCR_FMODE_INDR;
558 writel_relaxed(DCR_CSHT(1), qspi->io_base + QUADSPI_DCR);
560 ret = mtd_device_register(mtd, NULL, 0);
562 dev_err(qspi->dev, "mtd device parse failed\n");
566 flash->registered = true;
568 dev_dbg(qspi->dev, "read mm:%s cs:%d bus:%d\n",
569 flash->read_mode == CCR_FMODE_MM ? "yes" : "no", cs_num, width);
574 static void stm32_qspi_mtd_free(struct stm32_qspi *qspi)
578 for (i = 0; i < STM32_MAX_NORCHIP; i++)
579 if (qspi->flash[i].registered)
580 mtd_device_unregister(&qspi->flash[i].nor.mtd);
583 static int stm32_qspi_probe(struct platform_device *pdev)
585 struct device *dev = &pdev->dev;
586 struct device_node *flash_np;
587 struct reset_control *rstc;
588 struct stm32_qspi *qspi;
589 struct resource *res;
592 qspi = devm_kzalloc(dev, sizeof(*qspi), GFP_KERNEL);
596 qspi->nor_num = of_get_child_count(dev->of_node);
597 if (!qspi->nor_num || qspi->nor_num > STM32_MAX_NORCHIP)
600 res = platform_get_resource_byname(pdev, IORESOURCE_MEM, "qspi");
601 qspi->io_base = devm_ioremap_resource(dev, res);
602 if (IS_ERR(qspi->io_base))
603 return PTR_ERR(qspi->io_base);
605 res = platform_get_resource_byname(pdev, IORESOURCE_MEM, "qspi_mm");
606 qspi->mm_base = devm_ioremap_resource(dev, res);
607 if (IS_ERR(qspi->mm_base))
608 return PTR_ERR(qspi->mm_base);
610 qspi->mm_size = resource_size(res);
612 irq = platform_get_irq(pdev, 0);
613 ret = devm_request_irq(dev, irq, stm32_qspi_irq, 0,
614 dev_name(dev), qspi);
616 dev_err(dev, "failed to request irq\n");
620 init_completion(&qspi->cmd_completion);
622 qspi->clk = devm_clk_get(dev, NULL);
623 if (IS_ERR(qspi->clk))
624 return PTR_ERR(qspi->clk);
626 qspi->clk_rate = clk_get_rate(qspi->clk);
630 ret = clk_prepare_enable(qspi->clk);
632 dev_err(dev, "can not enable the clock\n");
636 rstc = devm_reset_control_get(dev, NULL);
638 reset_control_assert(rstc);
640 reset_control_deassert(rstc);
644 platform_set_drvdata(pdev, qspi);
645 mutex_init(&qspi->lock);
647 for_each_available_child_of_node(dev->of_node, flash_np) {
648 ret = stm32_qspi_flash_setup(qspi, flash_np);
650 dev_err(dev, "unable to setup flash chip\n");
658 mutex_destroy(&qspi->lock);
659 stm32_qspi_mtd_free(qspi);
661 clk_disable_unprepare(qspi->clk);
665 static int stm32_qspi_remove(struct platform_device *pdev)
667 struct stm32_qspi *qspi = platform_get_drvdata(pdev);
670 writel_relaxed(0, qspi->io_base + QUADSPI_CR);
672 stm32_qspi_mtd_free(qspi);
673 mutex_destroy(&qspi->lock);
675 clk_disable_unprepare(qspi->clk);
679 static const struct of_device_id stm32_qspi_match[] = {
680 {.compatible = "st,stm32f469-qspi"},
683 MODULE_DEVICE_TABLE(of, stm32_qspi_match);
685 static struct platform_driver stm32_qspi_driver = {
686 .probe = stm32_qspi_probe,
687 .remove = stm32_qspi_remove,
689 .name = "stm32-quadspi",
690 .of_match_table = stm32_qspi_match,
693 module_platform_driver(stm32_qspi_driver);
695 MODULE_AUTHOR("Ludovic Barre <ludovic.barre@st.com>");
696 MODULE_DESCRIPTION("STMicroelectronics STM32 quad spi driver");
697 MODULE_LICENSE("GPL v2");