1 // SPDX-License-Identifier: GPL-2.0-only
3 * SPI_PPC4XX SPI controller driver.
5 * Copyright (C) 2007 Gary Jennejohn <garyj@denx.de>
6 * Copyright 2008 Stefan Roese <sr@denx.de>, DENX Software Engineering
7 * Copyright 2009 Harris Corporation, Steven A. Falco <sfalco@harris.com>
9 * Based in part on drivers/spi/spi_s3c24xx.c
11 * Copyright (c) 2006 Ben Dooks
12 * Copyright (c) 2006 Simtec Electronics
13 * Ben Dooks <ben@simtec.co.uk>
17 * The PPC4xx SPI controller has no FIFO so each sent/received byte will
18 * generate an interrupt to the CPU. This can cause high CPU utilization.
19 * This driver allows platforms to reduce the interrupt load on the CPU
20 * during SPI transfers by setting max_speed_hz via the device tree.
23 #include <linux/delay.h>
24 #include <linux/errno.h>
25 #include <linux/interrupt.h>
27 #include <linux/module.h>
28 #include <linux/of_address.h>
29 #include <linux/of_platform.h>
30 #include <linux/platform_device.h>
31 #include <linux/sched.h>
32 #include <linux/slab.h>
33 #include <linux/wait.h>
35 #include <linux/spi/spi.h>
36 #include <linux/spi/spi_bitbang.h>
39 #include <asm/dcr-regs.h>
41 /* bits in mode register - bit 0 is MSb */
44 * SPI_PPC4XX_MODE_SCP = 0 means "data latched on trailing edge of clock"
45 * SPI_PPC4XX_MODE_SCP = 1 means "data latched on leading edge of clock"
46 * Note: This is the inverse of CPHA.
48 #define SPI_PPC4XX_MODE_SCP (0x80 >> 3)
50 /* SPI_PPC4XX_MODE_SPE = 1 means "port enabled" */
51 #define SPI_PPC4XX_MODE_SPE (0x80 >> 4)
54 * SPI_PPC4XX_MODE_RD = 0 means "MSB first" - this is the normal mode
55 * SPI_PPC4XX_MODE_RD = 1 means "LSB first" - this is bit-reversed mode
56 * Note: This is identical to SPI_LSB_FIRST.
58 #define SPI_PPC4XX_MODE_RD (0x80 >> 5)
61 * SPI_PPC4XX_MODE_CI = 0 means "clock idles low"
62 * SPI_PPC4XX_MODE_CI = 1 means "clock idles high"
63 * Note: This is identical to CPOL.
65 #define SPI_PPC4XX_MODE_CI (0x80 >> 6)
68 * SPI_PPC4XX_MODE_IL = 0 means "loopback disable"
69 * SPI_PPC4XX_MODE_IL = 1 means "loopback enable"
71 #define SPI_PPC4XX_MODE_IL (0x80 >> 7)
73 /* bits in control register */
74 /* starts a transfer when set */
75 #define SPI_PPC4XX_CR_STR (0x80 >> 7)
77 /* bits in status register */
78 /* port is busy with a transfer */
79 #define SPI_PPC4XX_SR_BSY (0x80 >> 6)
81 #define SPI_PPC4XX_SR_RBR (0x80 >> 7)
83 /* clock settings (SCP and CI) for various SPI modes */
84 #define SPI_CLK_MODE0 (SPI_PPC4XX_MODE_SCP | 0)
85 #define SPI_CLK_MODE1 (0 | 0)
86 #define SPI_CLK_MODE2 (SPI_PPC4XX_MODE_SCP | SPI_PPC4XX_MODE_CI)
87 #define SPI_CLK_MODE3 (0 | SPI_PPC4XX_MODE_CI)
89 #define DRIVER_NAME "spi_ppc4xx_of"
91 struct spi_ppc4xx_regs
{
99 * Clock divisor modulus register
100 * This uses the following formula:
101 * SCPClkOut = OPBCLK/(4(CDM + 1))
103 * CDM = (OPBCLK/4*SCPClkOut) - 1
109 /* SPI Controller driver's private data. */
111 /* bitbang has to be first */
112 struct spi_bitbang bitbang
;
113 struct completion done
;
118 /* need this to set the SPI clock */
119 unsigned int opb_freq
;
125 const unsigned char *tx
;
128 struct spi_ppc4xx_regs __iomem
*regs
; /* pointer to the registers */
129 struct spi_controller
*host
;
133 /* need this so we can set the clock in the chipselect routine */
134 struct spi_ppc4xx_cs
{
138 static int spi_ppc4xx_txrx(struct spi_device
*spi
, struct spi_transfer
*t
)
140 struct ppc4xx_spi
*hw
;
143 dev_dbg(&spi
->dev
, "txrx: tx %p, rx %p, len %d\n",
144 t
->tx_buf
, t
->rx_buf
, t
->len
);
146 hw
= spi_controller_get_devdata(spi
->controller
);
153 /* send the first byte */
154 data
= hw
->tx
? hw
->tx
[0] : 0;
155 out_8(&hw
->regs
->txd
, data
);
156 out_8(&hw
->regs
->cr
, SPI_PPC4XX_CR_STR
);
157 wait_for_completion(&hw
->done
);
162 static int spi_ppc4xx_setupxfer(struct spi_device
*spi
, struct spi_transfer
*t
)
164 struct ppc4xx_spi
*hw
= spi_controller_get_devdata(spi
->controller
);
165 struct spi_ppc4xx_cs
*cs
= spi
->controller_state
;
170 /* Start with the generic configuration for this device. */
171 speed
= spi
->max_speed_hz
;
174 * Modify the configuration if the transfer overrides it. Do not allow
175 * the transfer to overwrite the generic configuration with zeros.
179 speed
= min(t
->speed_hz
, spi
->max_speed_hz
);
182 if (!speed
|| (speed
> spi
->max_speed_hz
)) {
183 dev_err(&spi
->dev
, "invalid speed_hz (%d)\n", speed
);
187 /* Write new configuration */
188 out_8(&hw
->regs
->mode
, cs
->mode
);
191 /* opb_freq was already divided by 4 */
192 scr
= (hw
->opb_freq
/ speed
) - 1;
194 cdm
= min(scr
, 0xff);
196 dev_dbg(&spi
->dev
, "setting pre-scaler to %d (hz %d)\n", cdm
, speed
);
198 if (in_8(&hw
->regs
->cdm
) != cdm
)
199 out_8(&hw
->regs
->cdm
, cdm
);
201 mutex_lock(&hw
->bitbang
.lock
);
202 if (!hw
->bitbang
.busy
) {
203 hw
->bitbang
.chipselect(spi
, BITBANG_CS_INACTIVE
);
204 /* Need to ndelay here? */
206 mutex_unlock(&hw
->bitbang
.lock
);
211 static int spi_ppc4xx_setup(struct spi_device
*spi
)
213 struct spi_ppc4xx_cs
*cs
= spi
->controller_state
;
215 if (!spi
->max_speed_hz
) {
216 dev_err(&spi
->dev
, "invalid max_speed_hz (must be non-zero)\n");
221 cs
= kzalloc(sizeof(*cs
), GFP_KERNEL
);
224 spi
->controller_state
= cs
;
228 * We set all bits of the SPI0_MODE register, so,
229 * no need to read-modify-write
231 cs
->mode
= SPI_PPC4XX_MODE_SPE
;
233 switch (spi
->mode
& SPI_MODE_X_MASK
) {
235 cs
->mode
|= SPI_CLK_MODE0
;
238 cs
->mode
|= SPI_CLK_MODE1
;
241 cs
->mode
|= SPI_CLK_MODE2
;
244 cs
->mode
|= SPI_CLK_MODE3
;
248 if (spi
->mode
& SPI_LSB_FIRST
)
249 cs
->mode
|= SPI_PPC4XX_MODE_RD
;
254 static irqreturn_t
spi_ppc4xx_int(int irq
, void *dev_id
)
256 struct ppc4xx_spi
*hw
;
261 hw
= (struct ppc4xx_spi
*)dev_id
;
263 status
= in_8(&hw
->regs
->sr
);
268 * BSY de-asserts one cycle after the transfer is complete. The
269 * interrupt is asserted after the transfer is complete. The exact
270 * relationship is not documented, hence this code.
273 if (unlikely(status
& SPI_PPC4XX_SR_BSY
)) {
277 dev_dbg(hw
->dev
, "got interrupt but spi still busy?\n");
280 lstatus
= in_8(&hw
->regs
->sr
);
281 } while (++cnt
< 100 && lstatus
& SPI_PPC4XX_SR_BSY
);
284 dev_err(hw
->dev
, "busywait: too many loops!\n");
288 /* status is always 1 (RBR) here */
289 status
= in_8(&hw
->regs
->sr
);
290 dev_dbg(hw
->dev
, "loops %d status %x\n", cnt
, status
);
297 /* RBR triggered this interrupt. Therefore, data must be ready. */
298 data
= in_8(&hw
->regs
->rxd
);
300 hw
->rx
[count
] = data
;
304 if (count
< hw
->len
) {
305 data
= hw
->tx
? hw
->tx
[count
] : 0;
306 out_8(&hw
->regs
->txd
, data
);
307 out_8(&hw
->regs
->cr
, SPI_PPC4XX_CR_STR
);
315 static void spi_ppc4xx_cleanup(struct spi_device
*spi
)
317 kfree(spi
->controller_state
);
320 static void spi_ppc4xx_enable(struct ppc4xx_spi
*hw
)
323 * On all 4xx PPC's the SPI bus is shared/multiplexed with
324 * the 2nd I2C bus. We need to enable the SPI bus before
328 /* need to clear bit 14 to enable SPC */
329 dcri_clrset(SDR0
, SDR0_PFC1
, 0x80000000 >> 14, 0);
333 * platform_device layer stuff...
335 static int spi_ppc4xx_of_probe(struct platform_device
*op
)
337 struct ppc4xx_spi
*hw
;
338 struct spi_controller
*host
;
339 struct spi_bitbang
*bbp
;
340 struct resource resource
;
341 struct device_node
*np
= op
->dev
.of_node
;
342 struct device
*dev
= &op
->dev
;
343 struct device_node
*opbnp
;
345 const unsigned int *clk
;
347 host
= spi_alloc_host(dev
, sizeof(*hw
));
350 host
->dev
.of_node
= np
;
351 platform_set_drvdata(op
, host
);
352 hw
= spi_controller_get_devdata(host
);
356 init_completion(&hw
->done
);
358 /* Setup the state for the bitbang driver */
360 bbp
->ctlr
= hw
->host
;
361 bbp
->setup_transfer
= spi_ppc4xx_setupxfer
;
362 bbp
->txrx_bufs
= spi_ppc4xx_txrx
;
364 bbp
->ctlr
->setup
= spi_ppc4xx_setup
;
365 bbp
->ctlr
->cleanup
= spi_ppc4xx_cleanup
;
366 bbp
->ctlr
->bits_per_word_mask
= SPI_BPW_MASK(8);
367 bbp
->ctlr
->use_gpio_descriptors
= true;
369 * The SPI core will count the number of GPIO descriptors to figure
370 * out the number of chip selects available on the platform.
372 bbp
->ctlr
->num_chipselect
= 0;
374 /* the spi->mode bits understood by this driver: */
375 bbp
->ctlr
->mode_bits
=
376 SPI_CPHA
| SPI_CPOL
| SPI_CS_HIGH
| SPI_LSB_FIRST
;
378 /* Get the clock for the OPB */
379 opbnp
= of_find_compatible_node(NULL
, NULL
, "ibm,opb");
381 dev_err(dev
, "OPB: cannot find node\n");
385 /* Get the clock (Hz) for the OPB */
386 clk
= of_get_property(opbnp
, "clock-frequency", NULL
);
388 dev_err(dev
, "OPB: no clock-frequency property set\n");
397 ret
= of_address_to_resource(np
, 0, &resource
);
399 dev_err(dev
, "error while parsing device node resource\n");
402 hw
->mapbase
= resource
.start
;
403 hw
->mapsize
= resource_size(&resource
);
406 if (hw
->mapsize
< sizeof(struct spi_ppc4xx_regs
)) {
407 dev_err(dev
, "too small to map registers\n");
413 ret
= platform_get_irq(op
, 0);
418 ret
= request_irq(hw
->irqnum
, spi_ppc4xx_int
,
419 0, "spi_ppc4xx_of", (void *)hw
);
421 dev_err(dev
, "unable to allocate interrupt\n");
425 if (!request_mem_region(hw
->mapbase
, hw
->mapsize
, DRIVER_NAME
)) {
426 dev_err(dev
, "resource unavailable\n");
428 goto request_mem_error
;
431 hw
->regs
= ioremap(hw
->mapbase
, sizeof(struct spi_ppc4xx_regs
));
434 dev_err(dev
, "unable to memory map registers\n");
439 spi_ppc4xx_enable(hw
);
441 /* Finally register our spi controller */
443 ret
= spi_bitbang_start(bbp
);
445 dev_err(dev
, "failed to register SPI host\n");
449 dev_info(dev
, "driver initialized\n");
456 release_mem_region(hw
->mapbase
, hw
->mapsize
);
458 free_irq(hw
->irqnum
, hw
);
460 spi_controller_put(host
);
462 dev_err(dev
, "initialization failed\n");
466 static void spi_ppc4xx_of_remove(struct platform_device
*op
)
468 struct spi_controller
*host
= platform_get_drvdata(op
);
469 struct ppc4xx_spi
*hw
= spi_controller_get_devdata(host
);
471 spi_bitbang_stop(&hw
->bitbang
);
472 release_mem_region(hw
->mapbase
, hw
->mapsize
);
473 free_irq(hw
->irqnum
, hw
);
475 spi_controller_put(host
);
478 static const struct of_device_id spi_ppc4xx_of_match
[] = {
479 { .compatible
= "ibm,ppc4xx-spi", },
483 MODULE_DEVICE_TABLE(of
, spi_ppc4xx_of_match
);
485 static struct platform_driver spi_ppc4xx_of_driver
= {
486 .probe
= spi_ppc4xx_of_probe
,
487 .remove
= spi_ppc4xx_of_remove
,
490 .of_match_table
= spi_ppc4xx_of_match
,
493 module_platform_driver(spi_ppc4xx_of_driver
);
495 MODULE_AUTHOR("Gary Jennejohn & Stefan Roese");
496 MODULE_DESCRIPTION("Simple PPC4xx SPI Driver");
497 MODULE_LICENSE("GPL");