1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Freescale SPI controller driver.
5 * Maintainer: Kumar Gala
7 * Copyright (C) 2006 Polycom, Inc.
8 * Copyright 2010 Freescale Semiconductor, Inc.
10 * CPM SPI and QE buffer descriptors mode support:
11 * Copyright (c) 2009 MontaVista Software, Inc.
15 * Copyright (c) 2012 Aeroflex Gaisler AB.
18 #include <linux/delay.h>
19 #include <linux/dma-mapping.h>
20 #include <linux/fsl_devices.h>
21 #include <linux/gpio/consumer.h>
22 #include <linux/interrupt.h>
23 #include <linux/irq.h>
24 #include <linux/kernel.h>
26 #include <linux/module.h>
27 #include <linux/mutex.h>
29 #include <linux/of_address.h>
30 #include <linux/of_irq.h>
31 #include <linux/of_platform.h>
32 #include <linux/platform_device.h>
33 #include <linux/spi/spi.h>
34 #include <linux/spi/spi_bitbang.h>
35 #include <linux/types.h>
38 #include <sysdev/fsl_soc.h>
41 /* Specific to the MPC8306/MPC8309 */
42 #define IMMR_SPI_CS_OFFSET 0x14c
43 #define SPI_BOOT_SEL_BIT 0x80000000
45 #include "spi-fsl-lib.h"
46 #include "spi-fsl-cpm.h"
47 #include "spi-fsl-spi.h"
52 struct fsl_spi_match_data {
56 static struct fsl_spi_match_data of_fsl_spi_fsl_config = {
60 static struct fsl_spi_match_data of_fsl_spi_grlib_config = {
64 static const struct of_device_id of_fsl_spi_match[] = {
66 .compatible = "fsl,spi",
67 .data = &of_fsl_spi_fsl_config,
70 .compatible = "aeroflexgaisler,spictrl",
71 .data = &of_fsl_spi_grlib_config,
75 MODULE_DEVICE_TABLE(of, of_fsl_spi_match);
77 static int fsl_spi_get_type(struct device *dev)
79 const struct of_device_id *match;
82 match = of_match_node(of_fsl_spi_match, dev->of_node);
83 if (match && match->data)
84 return ((struct fsl_spi_match_data *)match->data)->type;
89 static void fsl_spi_change_mode(struct spi_device *spi)
91 struct mpc8xxx_spi *mspi = spi_master_get_devdata(spi->master);
92 struct spi_mpc8xxx_cs *cs = spi->controller_state;
93 struct fsl_spi_reg __iomem *reg_base = mspi->reg_base;
94 __be32 __iomem *mode = ®_base->mode;
97 if (cs->hw_mode == mpc8xxx_spi_read_reg(mode))
100 /* Turn off IRQs locally to minimize time that SPI is disabled. */
101 local_irq_save(flags);
103 /* Turn off SPI unit prior changing mode */
104 mpc8xxx_spi_write_reg(mode, cs->hw_mode & ~SPMODE_ENABLE);
106 /* When in CPM mode, we need to reinit tx and rx. */
107 if (mspi->flags & SPI_CPM_MODE) {
108 fsl_spi_cpm_reinit_txrx(mspi);
110 mpc8xxx_spi_write_reg(mode, cs->hw_mode);
111 local_irq_restore(flags);
114 static void fsl_spi_qe_cpu_set_shifts(u32 *rx_shift, u32 *tx_shift,
115 int bits_per_word, int msb_first)
120 if (bits_per_word <= 8) {
123 } else if (bits_per_word <= 16) {
128 if (bits_per_word <= 8)
133 static void fsl_spi_grlib_set_shifts(u32 *rx_shift, u32 *tx_shift,
134 int bits_per_word, int msb_first)
138 if (bits_per_word <= 16) {
140 *rx_shift = 16; /* LSB in bit 16 */
141 *tx_shift = 32 - bits_per_word; /* MSB in bit 31 */
143 *rx_shift = 16 - bits_per_word; /* MSB in bit 15 */
148 static int mspi_apply_cpu_mode_quirks(struct spi_mpc8xxx_cs *cs,
149 struct spi_device *spi,
150 struct mpc8xxx_spi *mpc8xxx_spi,
155 if (bits_per_word <= 8) {
156 cs->get_rx = mpc8xxx_spi_rx_buf_u8;
157 cs->get_tx = mpc8xxx_spi_tx_buf_u8;
158 } else if (bits_per_word <= 16) {
159 cs->get_rx = mpc8xxx_spi_rx_buf_u16;
160 cs->get_tx = mpc8xxx_spi_tx_buf_u16;
161 } else if (bits_per_word <= 32) {
162 cs->get_rx = mpc8xxx_spi_rx_buf_u32;
163 cs->get_tx = mpc8xxx_spi_tx_buf_u32;
167 if (mpc8xxx_spi->set_shifts)
168 mpc8xxx_spi->set_shifts(&cs->rx_shift, &cs->tx_shift,
170 !(spi->mode & SPI_LSB_FIRST));
172 mpc8xxx_spi->rx_shift = cs->rx_shift;
173 mpc8xxx_spi->tx_shift = cs->tx_shift;
174 mpc8xxx_spi->get_rx = cs->get_rx;
175 mpc8xxx_spi->get_tx = cs->get_tx;
177 return bits_per_word;
180 static int mspi_apply_qe_mode_quirks(struct spi_mpc8xxx_cs *cs,
181 struct spi_device *spi,
184 /* QE uses Little Endian for words > 8
185 * so transform all words > 8 into 8 bits
186 * Unfortnatly that doesn't work for LSB so
187 * reject these for now */
188 /* Note: 32 bits word, LSB works iff
189 * tfcr/rfcr is set to CPMFCR_GBL */
190 if (spi->mode & SPI_LSB_FIRST &&
193 if (bits_per_word > 8)
194 return 8; /* pretend its 8 bits */
195 return bits_per_word;
198 static int fsl_spi_setup_transfer(struct spi_device *spi,
199 struct spi_transfer *t)
201 struct mpc8xxx_spi *mpc8xxx_spi;
202 int bits_per_word = 0;
205 struct spi_mpc8xxx_cs *cs = spi->controller_state;
207 mpc8xxx_spi = spi_master_get_devdata(spi->master);
210 bits_per_word = t->bits_per_word;
214 /* spi_transfer level calls that work per-word */
216 bits_per_word = spi->bits_per_word;
219 hz = spi->max_speed_hz;
221 if (!(mpc8xxx_spi->flags & SPI_CPM_MODE))
222 bits_per_word = mspi_apply_cpu_mode_quirks(cs, spi,
225 else if (mpc8xxx_spi->flags & SPI_QE)
226 bits_per_word = mspi_apply_qe_mode_quirks(cs, spi,
229 if (bits_per_word < 0)
230 return bits_per_word;
232 if (bits_per_word == 32)
235 bits_per_word = bits_per_word - 1;
237 /* mask out bits we are going to set */
238 cs->hw_mode &= ~(SPMODE_LEN(0xF) | SPMODE_DIV16
241 cs->hw_mode |= SPMODE_LEN(bits_per_word);
243 if ((mpc8xxx_spi->spibrg / hz) > 64) {
244 cs->hw_mode |= SPMODE_DIV16;
245 pm = (mpc8xxx_spi->spibrg - 1) / (hz * 64) + 1;
247 "%s: Requested speed is too low: %d Hz. Will use %d Hz instead.\n",
248 dev_name(&spi->dev), hz, mpc8xxx_spi->spibrg / 1024);
252 pm = (mpc8xxx_spi->spibrg - 1) / (hz * 4) + 1;
257 cs->hw_mode |= SPMODE_PM(pm);
259 fsl_spi_change_mode(spi);
263 static int fsl_spi_cpu_bufs(struct mpc8xxx_spi *mspi,
264 struct spi_transfer *t, unsigned int len)
267 struct fsl_spi_reg __iomem *reg_base = mspi->reg_base;
272 mpc8xxx_spi_write_reg(®_base->mask, SPIM_NE);
275 word = mspi->get_tx(mspi);
276 mpc8xxx_spi_write_reg(®_base->transmit, word);
281 static int fsl_spi_bufs(struct spi_device *spi, struct spi_transfer *t,
284 struct mpc8xxx_spi *mpc8xxx_spi = spi_master_get_devdata(spi->master);
285 struct fsl_spi_reg __iomem *reg_base;
286 unsigned int len = t->len;
290 reg_base = mpc8xxx_spi->reg_base;
291 bits_per_word = spi->bits_per_word;
292 if (t->bits_per_word)
293 bits_per_word = t->bits_per_word;
295 if (bits_per_word > 8) {
296 /* invalid length? */
301 if (bits_per_word > 16) {
302 /* invalid length? */
308 mpc8xxx_spi->tx = t->tx_buf;
309 mpc8xxx_spi->rx = t->rx_buf;
311 reinit_completion(&mpc8xxx_spi->done);
313 if (mpc8xxx_spi->flags & SPI_CPM_MODE)
314 ret = fsl_spi_cpm_bufs(mpc8xxx_spi, t, is_dma_mapped);
316 ret = fsl_spi_cpu_bufs(mpc8xxx_spi, t, len);
320 wait_for_completion(&mpc8xxx_spi->done);
322 /* disable rx ints */
323 mpc8xxx_spi_write_reg(®_base->mask, 0);
325 if (mpc8xxx_spi->flags & SPI_CPM_MODE)
326 fsl_spi_cpm_bufs_complete(mpc8xxx_spi);
328 return mpc8xxx_spi->count;
331 static int fsl_spi_prepare_message(struct spi_controller *ctlr,
332 struct spi_message *m)
334 struct mpc8xxx_spi *mpc8xxx_spi = spi_controller_get_devdata(ctlr);
335 struct spi_transfer *t;
336 struct spi_transfer *first;
338 first = list_first_entry(&m->transfers, struct spi_transfer,
342 * In CPU mode, optimize large byte transfers to use larger
343 * bits_per_word values to reduce number of interrupts taken.
345 * Some glitches can appear on the SPI clock when the mode changes.
346 * Check that there is no speed change during the transfer and set it up
347 * now to change the mode without having a chip-select asserted.
349 list_for_each_entry(t, &m->transfers, transfer_list) {
350 if (t->speed_hz != first->speed_hz) {
351 dev_err(&m->spi->dev,
352 "speed_hz cannot change during message.\n");
355 if (!(mpc8xxx_spi->flags & SPI_CPM_MODE)) {
356 if (t->len < 256 || t->bits_per_word != 8)
358 if ((t->len & 3) == 0)
359 t->bits_per_word = 32;
360 else if ((t->len & 1) == 0)
361 t->bits_per_word = 16;
364 return fsl_spi_setup_transfer(m->spi, first);
367 static int fsl_spi_transfer_one(struct spi_controller *controller,
368 struct spi_device *spi,
369 struct spi_transfer *t)
373 status = fsl_spi_setup_transfer(spi, t);
377 status = fsl_spi_bufs(spi, t, !!t->tx_dma || !!t->rx_dma);
384 static int fsl_spi_unprepare_message(struct spi_controller *controller,
385 struct spi_message *msg)
387 return fsl_spi_setup_transfer(msg->spi, NULL);
390 static int fsl_spi_setup(struct spi_device *spi)
392 struct mpc8xxx_spi *mpc8xxx_spi;
393 struct fsl_spi_reg __iomem *reg_base;
394 bool initial_setup = false;
397 struct spi_mpc8xxx_cs *cs = spi_get_ctldata(spi);
399 if (!spi->max_speed_hz)
403 cs = kzalloc(sizeof(*cs), GFP_KERNEL);
406 spi_set_ctldata(spi, cs);
407 initial_setup = true;
409 mpc8xxx_spi = spi_master_get_devdata(spi->master);
411 reg_base = mpc8xxx_spi->reg_base;
413 hw_mode = cs->hw_mode; /* Save original settings */
414 cs->hw_mode = mpc8xxx_spi_read_reg(®_base->mode);
415 /* mask out bits we are going to set */
416 cs->hw_mode &= ~(SPMODE_CP_BEGIN_EDGECLK | SPMODE_CI_INACTIVEHIGH
417 | SPMODE_REV | SPMODE_LOOP);
419 if (spi->mode & SPI_CPHA)
420 cs->hw_mode |= SPMODE_CP_BEGIN_EDGECLK;
421 if (spi->mode & SPI_CPOL)
422 cs->hw_mode |= SPMODE_CI_INACTIVEHIGH;
423 if (!(spi->mode & SPI_LSB_FIRST))
424 cs->hw_mode |= SPMODE_REV;
425 if (spi->mode & SPI_LOOP)
426 cs->hw_mode |= SPMODE_LOOP;
428 retval = fsl_spi_setup_transfer(spi, NULL);
430 cs->hw_mode = hw_mode; /* Restore settings */
439 static void fsl_spi_cleanup(struct spi_device *spi)
441 struct spi_mpc8xxx_cs *cs = spi_get_ctldata(spi);
444 spi_set_ctldata(spi, NULL);
447 static void fsl_spi_cpu_irq(struct mpc8xxx_spi *mspi, u32 events)
449 struct fsl_spi_reg __iomem *reg_base = mspi->reg_base;
451 /* We need handle RX first */
452 if (events & SPIE_NE) {
453 u32 rx_data = mpc8xxx_spi_read_reg(®_base->receive);
456 mspi->get_rx(rx_data, mspi);
459 if ((events & SPIE_NF) == 0)
460 /* spin until TX is done */
462 mpc8xxx_spi_read_reg(®_base->event)) &
466 /* Clear the events */
467 mpc8xxx_spi_write_reg(®_base->event, events);
471 u32 word = mspi->get_tx(mspi);
473 mpc8xxx_spi_write_reg(®_base->transmit, word);
475 complete(&mspi->done);
479 static irqreturn_t fsl_spi_irq(s32 irq, void *context_data)
481 struct mpc8xxx_spi *mspi = context_data;
482 irqreturn_t ret = IRQ_NONE;
484 struct fsl_spi_reg __iomem *reg_base = mspi->reg_base;
486 /* Get interrupt events(tx/rx) */
487 events = mpc8xxx_spi_read_reg(®_base->event);
491 dev_dbg(mspi->dev, "%s: events %x\n", __func__, events);
493 if (mspi->flags & SPI_CPM_MODE)
494 fsl_spi_cpm_irq(mspi, events);
496 fsl_spi_cpu_irq(mspi, events);
501 static void fsl_spi_grlib_cs_control(struct spi_device *spi, bool on)
503 struct mpc8xxx_spi *mpc8xxx_spi = spi_master_get_devdata(spi->master);
504 struct fsl_spi_reg __iomem *reg_base = mpc8xxx_spi->reg_base;
506 u16 cs = spi->chip_select;
508 if (cs < mpc8xxx_spi->native_chipselects) {
509 slvsel = mpc8xxx_spi_read_reg(®_base->slvsel);
510 slvsel = on ? (slvsel | (1 << cs)) : (slvsel & ~(1 << cs));
511 mpc8xxx_spi_write_reg(®_base->slvsel, slvsel);
515 static void fsl_spi_grlib_probe(struct device *dev)
517 struct spi_master *master = dev_get_drvdata(dev);
518 struct mpc8xxx_spi *mpc8xxx_spi = spi_master_get_devdata(master);
519 struct fsl_spi_reg __iomem *reg_base = mpc8xxx_spi->reg_base;
523 capabilities = mpc8xxx_spi_read_reg(®_base->cap);
525 mpc8xxx_spi->set_shifts = fsl_spi_grlib_set_shifts;
526 mbits = SPCAP_MAXWLEN(capabilities);
528 mpc8xxx_spi->max_bits_per_word = mbits + 1;
530 mpc8xxx_spi->native_chipselects = 0;
531 if (SPCAP_SSEN(capabilities)) {
532 mpc8xxx_spi->native_chipselects = SPCAP_SSSZ(capabilities);
533 mpc8xxx_spi_write_reg(®_base->slvsel, 0xffffffff);
535 master->num_chipselect = mpc8xxx_spi->native_chipselects;
536 master->set_cs = fsl_spi_grlib_cs_control;
539 static void fsl_spi_cs_control(struct spi_device *spi, bool on)
541 struct device *dev = spi->dev.parent->parent;
542 struct fsl_spi_platform_data *pdata = dev_get_platdata(dev);
543 struct mpc8xxx_spi_probe_info *pinfo = to_of_pinfo(pdata);
545 if (WARN_ON_ONCE(!pinfo->immr_spi_cs))
547 iowrite32be(on ? 0 : SPI_BOOT_SEL_BIT, pinfo->immr_spi_cs);
550 static struct spi_master *fsl_spi_probe(struct device *dev,
551 struct resource *mem, unsigned int irq)
553 struct fsl_spi_platform_data *pdata = dev_get_platdata(dev);
554 struct spi_master *master;
555 struct mpc8xxx_spi *mpc8xxx_spi;
556 struct fsl_spi_reg __iomem *reg_base;
560 master = spi_alloc_master(dev, sizeof(struct mpc8xxx_spi));
561 if (master == NULL) {
566 dev_set_drvdata(dev, master);
568 mpc8xxx_spi_probe(dev, mem, irq);
570 master->setup = fsl_spi_setup;
571 master->cleanup = fsl_spi_cleanup;
572 master->prepare_message = fsl_spi_prepare_message;
573 master->transfer_one = fsl_spi_transfer_one;
574 master->unprepare_message = fsl_spi_unprepare_message;
575 master->use_gpio_descriptors = true;
576 master->set_cs = fsl_spi_cs_control;
578 mpc8xxx_spi = spi_master_get_devdata(master);
579 mpc8xxx_spi->max_bits_per_word = 32;
580 mpc8xxx_spi->type = fsl_spi_get_type(dev);
582 ret = fsl_spi_cpm_init(mpc8xxx_spi);
586 mpc8xxx_spi->reg_base = devm_ioremap_resource(dev, mem);
587 if (IS_ERR(mpc8xxx_spi->reg_base)) {
588 ret = PTR_ERR(mpc8xxx_spi->reg_base);
592 if (mpc8xxx_spi->type == TYPE_GRLIB)
593 fsl_spi_grlib_probe(dev);
595 master->bits_per_word_mask =
596 (SPI_BPW_RANGE_MASK(4, 16) | SPI_BPW_MASK(32)) &
597 SPI_BPW_RANGE_MASK(1, mpc8xxx_spi->max_bits_per_word);
599 if (mpc8xxx_spi->flags & SPI_QE_CPU_MODE)
600 mpc8xxx_spi->set_shifts = fsl_spi_qe_cpu_set_shifts;
602 if (mpc8xxx_spi->set_shifts)
603 /* 8 bits per word and MSB first */
604 mpc8xxx_spi->set_shifts(&mpc8xxx_spi->rx_shift,
605 &mpc8xxx_spi->tx_shift, 8, 1);
607 /* Register for SPI Interrupt */
608 ret = devm_request_irq(dev, mpc8xxx_spi->irq, fsl_spi_irq,
609 0, "fsl_spi", mpc8xxx_spi);
614 reg_base = mpc8xxx_spi->reg_base;
616 /* SPI controller initializations */
617 mpc8xxx_spi_write_reg(®_base->mode, 0);
618 mpc8xxx_spi_write_reg(®_base->mask, 0);
619 mpc8xxx_spi_write_reg(®_base->command, 0);
620 mpc8xxx_spi_write_reg(®_base->event, 0xffffffff);
622 /* Enable SPI interface */
623 regval = pdata->initial_spmode | SPMODE_INIT_VAL | SPMODE_ENABLE;
624 if (mpc8xxx_spi->max_bits_per_word < 8) {
625 regval &= ~SPMODE_LEN(0xF);
626 regval |= SPMODE_LEN(mpc8xxx_spi->max_bits_per_word - 1);
628 if (mpc8xxx_spi->flags & SPI_QE_CPU_MODE)
631 mpc8xxx_spi_write_reg(®_base->mode, regval);
633 ret = devm_spi_register_master(dev, master);
637 dev_info(dev, "at 0x%p (irq = %d), %s mode\n", reg_base,
638 mpc8xxx_spi->irq, mpc8xxx_spi_strmode(mpc8xxx_spi->flags));
643 fsl_spi_cpm_free(mpc8xxx_spi);
645 spi_master_put(master);
650 static int of_fsl_spi_probe(struct platform_device *ofdev)
652 struct device *dev = &ofdev->dev;
653 struct device_node *np = ofdev->dev.of_node;
654 struct spi_master *master;
658 bool spisel_boot = false;
659 #if IS_ENABLED(CONFIG_FSL_SOC)
660 struct mpc8xxx_spi_probe_info *pinfo = NULL;
664 ret = of_mpc8xxx_spi_probe(ofdev);
668 type = fsl_spi_get_type(&ofdev->dev);
669 if (type == TYPE_FSL) {
670 struct fsl_spi_platform_data *pdata = dev_get_platdata(dev);
671 #if IS_ENABLED(CONFIG_FSL_SOC)
672 pinfo = to_of_pinfo(pdata);
674 spisel_boot = of_property_read_bool(np, "fsl,spisel_boot");
676 pinfo->immr_spi_cs = ioremap(get_immrbase() + IMMR_SPI_CS_OFFSET, 4);
677 if (!pinfo->immr_spi_cs)
682 * Handle the case where we have one hardwired (always selected)
683 * device on the first "chipselect". Else we let the core code
684 * handle any GPIOs or native chip selects and assign the
685 * appropriate callback for dealing with the CS lines. This isn't
686 * supported on the GRLIB variant.
688 ret = gpiod_count(dev, "cs");
691 if (ret == 0 && !spisel_boot)
692 pdata->max_chipselect = 1;
694 pdata->max_chipselect = ret + spisel_boot;
697 ret = of_address_to_resource(np, 0, &mem);
701 irq = platform_get_irq(ofdev, 0);
707 master = fsl_spi_probe(dev, &mem, irq);
709 return PTR_ERR_OR_ZERO(master);
712 #if IS_ENABLED(CONFIG_FSL_SOC)
714 iounmap(pinfo->immr_spi_cs);
719 static int of_fsl_spi_remove(struct platform_device *ofdev)
721 struct spi_master *master = platform_get_drvdata(ofdev);
722 struct mpc8xxx_spi *mpc8xxx_spi = spi_master_get_devdata(master);
724 fsl_spi_cpm_free(mpc8xxx_spi);
728 static struct platform_driver of_fsl_spi_driver = {
731 .of_match_table = of_fsl_spi_match,
733 .probe = of_fsl_spi_probe,
734 .remove = of_fsl_spi_remove,
737 #ifdef CONFIG_MPC832x_RDB
740 * This is "legacy" platform driver, was used by the MPC8323E-RDB boards
741 * only. The driver should go away soon, since newer MPC8323E-RDB's device
742 * tree can work with OpenFirmware driver. But for now we support old trees
745 static int plat_mpc8xxx_spi_probe(struct platform_device *pdev)
747 struct resource *mem;
749 struct spi_master *master;
751 if (!dev_get_platdata(&pdev->dev))
754 mem = platform_get_resource(pdev, IORESOURCE_MEM, 0);
758 irq = platform_get_irq(pdev, 0);
762 master = fsl_spi_probe(&pdev->dev, mem, irq);
763 return PTR_ERR_OR_ZERO(master);
766 static int plat_mpc8xxx_spi_remove(struct platform_device *pdev)
768 struct spi_master *master = platform_get_drvdata(pdev);
769 struct mpc8xxx_spi *mpc8xxx_spi = spi_master_get_devdata(master);
771 fsl_spi_cpm_free(mpc8xxx_spi);
776 MODULE_ALIAS("platform:mpc8xxx_spi");
777 static struct platform_driver mpc8xxx_spi_driver = {
778 .probe = plat_mpc8xxx_spi_probe,
779 .remove = plat_mpc8xxx_spi_remove,
781 .name = "mpc8xxx_spi",
785 static bool legacy_driver_failed;
787 static void __init legacy_driver_register(void)
789 legacy_driver_failed = platform_driver_register(&mpc8xxx_spi_driver);
792 static void __exit legacy_driver_unregister(void)
794 if (legacy_driver_failed)
796 platform_driver_unregister(&mpc8xxx_spi_driver);
799 static void __init legacy_driver_register(void) {}
800 static void __exit legacy_driver_unregister(void) {}
801 #endif /* CONFIG_MPC832x_RDB */
803 static int __init fsl_spi_init(void)
805 legacy_driver_register();
806 return platform_driver_register(&of_fsl_spi_driver);
808 module_init(fsl_spi_init);
810 static void __exit fsl_spi_exit(void)
812 platform_driver_unregister(&of_fsl_spi_driver);
813 legacy_driver_unregister();
815 module_exit(fsl_spi_exit);
817 MODULE_AUTHOR("Kumar Gala");
818 MODULE_DESCRIPTION("Simple Freescale SPI Driver");
819 MODULE_LICENSE("GPL");