1 // SPDX-License-Identifier: GPL-2.0-only
3 * Designware SPI core controller driver (refer pxa2xx_spi.c)
5 * Copyright (c) 2009, Intel Corporation.
8 #include <linux/dma-mapping.h>
9 #include <linux/interrupt.h>
10 #include <linux/module.h>
11 #include <linux/highmem.h>
12 #include <linux/delay.h>
13 #include <linux/slab.h>
14 #include <linux/spi/spi.h>
18 #ifdef CONFIG_DEBUG_FS
19 #include <linux/debugfs.h>
22 /* Slave spi_dev related */
24 u8 tmode
; /* TR/TO/RO/EEPROM */
25 u8 type
; /* SPI/SSP/MicroWire */
27 u8 poll_mode
; /* 1 means use poll mode */
29 u16 clk_div
; /* baud rate divider */
30 u32 speed_hz
; /* baud rate */
31 void (*cs_control
)(u32 command
);
34 #ifdef CONFIG_DEBUG_FS
35 #define SPI_REGS_BUFSIZE 1024
36 static ssize_t
dw_spi_show_regs(struct file
*file
, char __user
*user_buf
,
37 size_t count
, loff_t
*ppos
)
39 struct dw_spi
*dws
= file
->private_data
;
44 buf
= kzalloc(SPI_REGS_BUFSIZE
, GFP_KERNEL
);
48 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
49 "%s registers:\n", dev_name(&dws
->master
->dev
));
50 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
51 "=================================\n");
52 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
53 "CTRL0: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_CTRL0
));
54 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
55 "CTRL1: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_CTRL1
));
56 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
57 "SSIENR: \t0x%08x\n", dw_readl(dws
, DW_SPI_SSIENR
));
58 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
59 "SER: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_SER
));
60 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
61 "BAUDR: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_BAUDR
));
62 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
63 "TXFTLR: \t0x%08x\n", dw_readl(dws
, DW_SPI_TXFLTR
));
64 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
65 "RXFTLR: \t0x%08x\n", dw_readl(dws
, DW_SPI_RXFLTR
));
66 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
67 "TXFLR: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_TXFLR
));
68 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
69 "RXFLR: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_RXFLR
));
70 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
71 "SR: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_SR
));
72 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
73 "IMR: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_IMR
));
74 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
75 "ISR: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_ISR
));
76 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
77 "DMACR: \t\t0x%08x\n", dw_readl(dws
, DW_SPI_DMACR
));
78 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
79 "DMATDLR: \t0x%08x\n", dw_readl(dws
, DW_SPI_DMATDLR
));
80 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
81 "DMARDLR: \t0x%08x\n", dw_readl(dws
, DW_SPI_DMARDLR
));
82 len
+= scnprintf(buf
+ len
, SPI_REGS_BUFSIZE
- len
,
83 "=================================\n");
85 ret
= simple_read_from_buffer(user_buf
, count
, ppos
, buf
, len
);
90 static const struct file_operations dw_spi_regs_ops
= {
93 .read
= dw_spi_show_regs
,
94 .llseek
= default_llseek
,
97 static int dw_spi_debugfs_init(struct dw_spi
*dws
)
101 snprintf(name
, 32, "dw_spi%d", dws
->master
->bus_num
);
102 dws
->debugfs
= debugfs_create_dir(name
, NULL
);
106 debugfs_create_file("registers", S_IFREG
| S_IRUGO
,
107 dws
->debugfs
, (void *)dws
, &dw_spi_regs_ops
);
111 static void dw_spi_debugfs_remove(struct dw_spi
*dws
)
113 debugfs_remove_recursive(dws
->debugfs
);
117 static inline int dw_spi_debugfs_init(struct dw_spi
*dws
)
122 static inline void dw_spi_debugfs_remove(struct dw_spi
*dws
)
125 #endif /* CONFIG_DEBUG_FS */
127 void dw_spi_set_cs(struct spi_device
*spi
, bool enable
)
129 struct dw_spi
*dws
= spi_controller_get_devdata(spi
->controller
);
130 struct chip_data
*chip
= spi_get_ctldata(spi
);
132 /* Chip select logic is inverted from spi_set_cs() */
133 if (chip
&& chip
->cs_control
)
134 chip
->cs_control(!enable
);
137 dw_writel(dws
, DW_SPI_SER
, BIT(spi
->chip_select
));
138 else if (dws
->cs_override
)
139 dw_writel(dws
, DW_SPI_SER
, 0);
141 EXPORT_SYMBOL_GPL(dw_spi_set_cs
);
143 /* Return the max entries we can fill into tx fifo */
144 static inline u32
tx_max(struct dw_spi
*dws
)
146 u32 tx_left
, tx_room
, rxtx_gap
;
148 tx_left
= (dws
->tx_end
- dws
->tx
) / dws
->n_bytes
;
149 tx_room
= dws
->fifo_len
- dw_readl(dws
, DW_SPI_TXFLR
);
152 * Another concern is about the tx/rx mismatch, we
153 * though to use (dws->fifo_len - rxflr - txflr) as
154 * one maximum value for tx, but it doesn't cover the
155 * data which is out of tx/rx fifo and inside the
156 * shift registers. So a control from sw point of
159 rxtx_gap
= ((dws
->rx_end
- dws
->rx
) - (dws
->tx_end
- dws
->tx
))
162 return min3(tx_left
, tx_room
, (u32
) (dws
->fifo_len
- rxtx_gap
));
165 /* Return the max entries we should read out of rx fifo */
166 static inline u32
rx_max(struct dw_spi
*dws
)
168 u32 rx_left
= (dws
->rx_end
- dws
->rx
) / dws
->n_bytes
;
170 return min_t(u32
, rx_left
, dw_readl(dws
, DW_SPI_RXFLR
));
173 static void dw_writer(struct dw_spi
*dws
)
178 spin_lock(&dws
->buf_lock
);
181 /* Set the tx word if the transfer's original "tx" is not null */
182 if (dws
->tx_end
- dws
->len
) {
183 if (dws
->n_bytes
== 1)
184 txw
= *(u8
*)(dws
->tx
);
186 txw
= *(u16
*)(dws
->tx
);
188 dw_write_io_reg(dws
, DW_SPI_DR
, txw
);
189 dws
->tx
+= dws
->n_bytes
;
191 spin_unlock(&dws
->buf_lock
);
194 static void dw_reader(struct dw_spi
*dws
)
199 spin_lock(&dws
->buf_lock
);
202 rxw
= dw_read_io_reg(dws
, DW_SPI_DR
);
203 /* Care rx only if the transfer's original "rx" is not null */
204 if (dws
->rx_end
- dws
->len
) {
205 if (dws
->n_bytes
== 1)
206 *(u8
*)(dws
->rx
) = rxw
;
208 *(u16
*)(dws
->rx
) = rxw
;
210 dws
->rx
+= dws
->n_bytes
;
212 spin_unlock(&dws
->buf_lock
);
215 static void int_error_stop(struct dw_spi
*dws
, const char *msg
)
219 dev_err(&dws
->master
->dev
, "%s\n", msg
);
220 dws
->master
->cur_msg
->status
= -EIO
;
221 spi_finalize_current_transfer(dws
->master
);
224 static irqreturn_t
interrupt_transfer(struct dw_spi
*dws
)
226 u16 irq_status
= dw_readl(dws
, DW_SPI_ISR
);
229 if (irq_status
& (SPI_INT_TXOI
| SPI_INT_RXOI
| SPI_INT_RXUI
)) {
230 dw_readl(dws
, DW_SPI_ICR
);
231 int_error_stop(dws
, "interrupt_transfer: fifo overrun/underrun");
236 if (dws
->rx_end
== dws
->rx
) {
237 spi_mask_intr(dws
, SPI_INT_TXEI
);
238 spi_finalize_current_transfer(dws
->master
);
241 if (irq_status
& SPI_INT_TXEI
) {
242 spi_mask_intr(dws
, SPI_INT_TXEI
);
244 /* Enable TX irq always, it will be disabled when RX finished */
245 spi_umask_intr(dws
, SPI_INT_TXEI
);
251 static irqreturn_t
dw_spi_irq(int irq
, void *dev_id
)
253 struct spi_controller
*master
= dev_id
;
254 struct dw_spi
*dws
= spi_controller_get_devdata(master
);
255 u16 irq_status
= dw_readl(dws
, DW_SPI_ISR
) & 0x3f;
260 if (!master
->cur_msg
) {
261 spi_mask_intr(dws
, SPI_INT_TXEI
);
265 return dws
->transfer_handler(dws
);
268 /* Must be called inside pump_transfers() */
269 static int poll_transfer(struct dw_spi
*dws
)
275 } while (dws
->rx_end
> dws
->rx
);
280 static int dw_spi_transfer_one(struct spi_controller
*master
,
281 struct spi_device
*spi
, struct spi_transfer
*transfer
)
283 struct dw_spi
*dws
= spi_controller_get_devdata(master
);
284 struct chip_data
*chip
= spi_get_ctldata(spi
);
292 spin_lock_irqsave(&dws
->buf_lock
, flags
);
293 dws
->tx
= (void *)transfer
->tx_buf
;
294 dws
->tx_end
= dws
->tx
+ transfer
->len
;
295 dws
->rx
= transfer
->rx_buf
;
296 dws
->rx_end
= dws
->rx
+ transfer
->len
;
297 dws
->len
= transfer
->len
;
298 spin_unlock_irqrestore(&dws
->buf_lock
, flags
);
300 /* Ensure dw->rx and dw->rx_end are visible */
303 spi_enable_chip(dws
, 0);
305 /* Handle per transfer options for bpw and speed */
306 if (transfer
->speed_hz
!= dws
->current_freq
) {
307 if (transfer
->speed_hz
!= chip
->speed_hz
) {
308 /* clk_div doesn't support odd number */
309 chip
->clk_div
= (DIV_ROUND_UP(dws
->max_freq
, transfer
->speed_hz
) + 1) & 0xfffe;
310 chip
->speed_hz
= transfer
->speed_hz
;
312 dws
->current_freq
= transfer
->speed_hz
;
313 spi_set_clk(dws
, chip
->clk_div
);
316 dws
->n_bytes
= DIV_ROUND_UP(transfer
->bits_per_word
, BITS_PER_BYTE
);
317 dws
->dma_width
= DIV_ROUND_UP(transfer
->bits_per_word
, BITS_PER_BYTE
);
319 /* Default SPI mode is SCPOL = 0, SCPH = 0 */
320 cr0
= (transfer
->bits_per_word
- 1)
321 | (chip
->type
<< SPI_FRF_OFFSET
)
322 | ((((spi
->mode
& SPI_CPOL
) ? 1 : 0) << SPI_SCOL_OFFSET
) |
323 (((spi
->mode
& SPI_CPHA
) ? 1 : 0) << SPI_SCPH_OFFSET
) |
324 (((spi
->mode
& SPI_LOOP
) ? 1 : 0) << SPI_SRL_OFFSET
))
325 | (chip
->tmode
<< SPI_TMOD_OFFSET
);
328 * Adjust transfer mode if necessary. Requires platform dependent
329 * chipselect mechanism.
331 if (chip
->cs_control
) {
332 if (dws
->rx
&& dws
->tx
)
333 chip
->tmode
= SPI_TMOD_TR
;
335 chip
->tmode
= SPI_TMOD_RO
;
337 chip
->tmode
= SPI_TMOD_TO
;
339 cr0
&= ~SPI_TMOD_MASK
;
340 cr0
|= (chip
->tmode
<< SPI_TMOD_OFFSET
);
343 dw_writel(dws
, DW_SPI_CTRL0
, cr0
);
345 /* Check if current transfer is a DMA transaction */
346 if (master
->can_dma
&& master
->can_dma(master
, spi
, transfer
))
347 dws
->dma_mapped
= master
->cur_msg_mapped
;
349 /* For poll mode just disable all interrupts */
350 spi_mask_intr(dws
, 0xff);
354 * we only need set the TXEI IRQ, as TX/RX always happen syncronizely
356 if (dws
->dma_mapped
) {
357 ret
= dws
->dma_ops
->dma_setup(dws
, transfer
);
359 spi_enable_chip(dws
, 1);
362 } else if (!chip
->poll_mode
) {
363 txlevel
= min_t(u16
, dws
->fifo_len
/ 2, dws
->len
/ dws
->n_bytes
);
364 dw_writel(dws
, DW_SPI_TXFLTR
, txlevel
);
366 /* Set the interrupt mask */
367 imask
|= SPI_INT_TXEI
| SPI_INT_TXOI
|
368 SPI_INT_RXUI
| SPI_INT_RXOI
;
369 spi_umask_intr(dws
, imask
);
371 dws
->transfer_handler
= interrupt_transfer
;
374 spi_enable_chip(dws
, 1);
376 if (dws
->dma_mapped
) {
377 ret
= dws
->dma_ops
->dma_transfer(dws
, transfer
);
383 return poll_transfer(dws
);
388 static void dw_spi_handle_err(struct spi_controller
*master
,
389 struct spi_message
*msg
)
391 struct dw_spi
*dws
= spi_controller_get_devdata(master
);
394 dws
->dma_ops
->dma_stop(dws
);
399 /* This may be called twice for each spi dev */
400 static int dw_spi_setup(struct spi_device
*spi
)
402 struct dw_spi_chip
*chip_info
= NULL
;
403 struct chip_data
*chip
;
405 /* Only alloc on first setup */
406 chip
= spi_get_ctldata(spi
);
408 chip
= kzalloc(sizeof(struct chip_data
), GFP_KERNEL
);
411 spi_set_ctldata(spi
, chip
);
415 * Protocol drivers may change the chip settings, so...
416 * if chip_info exists, use it
418 chip_info
= spi
->controller_data
;
420 /* chip_info doesn't always exist */
422 if (chip_info
->cs_control
)
423 chip
->cs_control
= chip_info
->cs_control
;
425 chip
->poll_mode
= chip_info
->poll_mode
;
426 chip
->type
= chip_info
->type
;
429 chip
->tmode
= SPI_TMOD_TR
;
434 static void dw_spi_cleanup(struct spi_device
*spi
)
436 struct chip_data
*chip
= spi_get_ctldata(spi
);
439 spi_set_ctldata(spi
, NULL
);
442 /* Restart the controller, disable all interrupts, clean rx fifo */
443 static void spi_hw_init(struct device
*dev
, struct dw_spi
*dws
)
448 * Try to detect the FIFO depth if not set by interface driver,
449 * the depth could be from 2 to 256 from HW spec
451 if (!dws
->fifo_len
) {
454 for (fifo
= 1; fifo
< 256; fifo
++) {
455 dw_writel(dws
, DW_SPI_TXFLTR
, fifo
);
456 if (fifo
!= dw_readl(dws
, DW_SPI_TXFLTR
))
459 dw_writel(dws
, DW_SPI_TXFLTR
, 0);
461 dws
->fifo_len
= (fifo
== 1) ? 0 : fifo
;
462 dev_dbg(dev
, "Detected FIFO size: %u bytes\n", dws
->fifo_len
);
465 /* enable HW fixup for explicit CS deselect for Amazon's alpine chip */
466 if (dws
->cs_override
)
467 dw_writel(dws
, DW_SPI_CS_OVERRIDE
, 0xF);
470 int dw_spi_add_host(struct device
*dev
, struct dw_spi
*dws
)
472 struct spi_controller
*master
;
478 master
= spi_alloc_master(dev
, 0);
482 dws
->master
= master
;
483 dws
->type
= SSI_MOTO_SPI
;
485 dws
->dma_addr
= (dma_addr_t
)(dws
->paddr
+ DW_SPI_DR
);
486 spin_lock_init(&dws
->buf_lock
);
488 spi_controller_set_devdata(master
, dws
);
490 ret
= request_irq(dws
->irq
, dw_spi_irq
, IRQF_SHARED
, dev_name(dev
),
493 dev_err(dev
, "can not get IRQ\n");
494 goto err_free_master
;
497 master
->use_gpio_descriptors
= true;
498 master
->mode_bits
= SPI_CPOL
| SPI_CPHA
| SPI_LOOP
;
499 master
->bits_per_word_mask
= SPI_BPW_RANGE_MASK(4, 16);
500 master
->bus_num
= dws
->bus_num
;
501 master
->num_chipselect
= dws
->num_cs
;
502 master
->setup
= dw_spi_setup
;
503 master
->cleanup
= dw_spi_cleanup
;
504 master
->set_cs
= dw_spi_set_cs
;
505 master
->transfer_one
= dw_spi_transfer_one
;
506 master
->handle_err
= dw_spi_handle_err
;
507 master
->max_speed_hz
= dws
->max_freq
;
508 master
->dev
.of_node
= dev
->of_node
;
509 master
->dev
.fwnode
= dev
->fwnode
;
510 master
->flags
= SPI_MASTER_GPIO_SS
;
511 master
->auto_runtime_pm
= true;
514 master
->set_cs
= dws
->set_cs
;
517 spi_hw_init(dev
, dws
);
519 if (dws
->dma_ops
&& dws
->dma_ops
->dma_init
) {
520 ret
= dws
->dma_ops
->dma_init(dws
);
522 dev_warn(dev
, "DMA init failed\n");
525 master
->can_dma
= dws
->dma_ops
->can_dma
;
529 ret
= devm_spi_register_controller(dev
, master
);
531 dev_err(&master
->dev
, "problem registering spi master\n");
535 dw_spi_debugfs_init(dws
);
539 if (dws
->dma_ops
&& dws
->dma_ops
->dma_exit
)
540 dws
->dma_ops
->dma_exit(dws
);
541 spi_enable_chip(dws
, 0);
542 free_irq(dws
->irq
, master
);
544 spi_controller_put(master
);
547 EXPORT_SYMBOL_GPL(dw_spi_add_host
);
549 void dw_spi_remove_host(struct dw_spi
*dws
)
551 dw_spi_debugfs_remove(dws
);
553 if (dws
->dma_ops
&& dws
->dma_ops
->dma_exit
)
554 dws
->dma_ops
->dma_exit(dws
);
556 spi_shutdown_chip(dws
);
558 free_irq(dws
->irq
, dws
->master
);
560 EXPORT_SYMBOL_GPL(dw_spi_remove_host
);
562 int dw_spi_suspend_host(struct dw_spi
*dws
)
566 ret
= spi_controller_suspend(dws
->master
);
570 spi_shutdown_chip(dws
);
573 EXPORT_SYMBOL_GPL(dw_spi_suspend_host
);
575 int dw_spi_resume_host(struct dw_spi
*dws
)
577 spi_hw_init(&dws
->master
->dev
, dws
);
578 return spi_controller_resume(dws
->master
);
580 EXPORT_SYMBOL_GPL(dw_spi_resume_host
);
582 MODULE_AUTHOR("Feng Tang <feng.tang@intel.com>");
583 MODULE_DESCRIPTION("Driver for DesignWare SPI controller core");
584 MODULE_LICENSE("GPL v2");