2 * Xilinx Zynq UltraScale+ MPSoC Quad-SPI (QSPI) controller driver
5 * Copyright (C) 2009 - 2015 Xilinx, Inc.
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License version 2 as published
9 * by the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
13 #include <linux/clk.h>
14 #include <linux/delay.h>
15 #include <linux/dma-mapping.h>
16 #include <linux/dmaengine.h>
17 #include <linux/interrupt.h>
19 #include <linux/module.h>
20 #include <linux/of_irq.h>
21 #include <linux/of_address.h>
22 #include <linux/platform_device.h>
23 #include <linux/spi/spi.h>
24 #include <linux/spinlock.h>
25 #include <linux/workqueue.h>
27 /* Generic QSPI register offsets */
28 #define GQSPI_CONFIG_OFST 0x00000100
29 #define GQSPI_ISR_OFST 0x00000104
30 #define GQSPI_IDR_OFST 0x0000010C
31 #define GQSPI_IER_OFST 0x00000108
32 #define GQSPI_IMASK_OFST 0x00000110
33 #define GQSPI_EN_OFST 0x00000114
34 #define GQSPI_TXD_OFST 0x0000011C
35 #define GQSPI_RXD_OFST 0x00000120
36 #define GQSPI_TX_THRESHOLD_OFST 0x00000128
37 #define GQSPI_RX_THRESHOLD_OFST 0x0000012C
38 #define GQSPI_LPBK_DLY_ADJ_OFST 0x00000138
39 #define GQSPI_GEN_FIFO_OFST 0x00000140
40 #define GQSPI_SEL_OFST 0x00000144
41 #define GQSPI_GF_THRESHOLD_OFST 0x00000150
42 #define GQSPI_FIFO_CTRL_OFST 0x0000014C
43 #define GQSPI_QSPIDMA_DST_CTRL_OFST 0x0000080C
44 #define GQSPI_QSPIDMA_DST_SIZE_OFST 0x00000804
45 #define GQSPI_QSPIDMA_DST_STS_OFST 0x00000808
46 #define GQSPI_QSPIDMA_DST_I_STS_OFST 0x00000814
47 #define GQSPI_QSPIDMA_DST_I_EN_OFST 0x00000818
48 #define GQSPI_QSPIDMA_DST_I_DIS_OFST 0x0000081C
49 #define GQSPI_QSPIDMA_DST_I_MASK_OFST 0x00000820
50 #define GQSPI_QSPIDMA_DST_ADDR_OFST 0x00000800
51 #define GQSPI_QSPIDMA_DST_ADDR_MSB_OFST 0x00000828
53 /* GQSPI register bit masks */
54 #define GQSPI_SEL_MASK 0x00000001
55 #define GQSPI_EN_MASK 0x00000001
56 #define GQSPI_LPBK_DLY_ADJ_USE_LPBK_MASK 0x00000020
57 #define GQSPI_ISR_WR_TO_CLR_MASK 0x00000002
58 #define GQSPI_IDR_ALL_MASK 0x00000FBE
59 #define GQSPI_CFG_MODE_EN_MASK 0xC0000000
60 #define GQSPI_CFG_GEN_FIFO_START_MODE_MASK 0x20000000
61 #define GQSPI_CFG_ENDIAN_MASK 0x04000000
62 #define GQSPI_CFG_EN_POLL_TO_MASK 0x00100000
63 #define GQSPI_CFG_WP_HOLD_MASK 0x00080000
64 #define GQSPI_CFG_BAUD_RATE_DIV_MASK 0x00000038
65 #define GQSPI_CFG_CLK_PHA_MASK 0x00000004
66 #define GQSPI_CFG_CLK_POL_MASK 0x00000002
67 #define GQSPI_CFG_START_GEN_FIFO_MASK 0x10000000
68 #define GQSPI_GENFIFO_IMM_DATA_MASK 0x000000FF
69 #define GQSPI_GENFIFO_DATA_XFER 0x00000100
70 #define GQSPI_GENFIFO_EXP 0x00000200
71 #define GQSPI_GENFIFO_MODE_SPI 0x00000400
72 #define GQSPI_GENFIFO_MODE_DUALSPI 0x00000800
73 #define GQSPI_GENFIFO_MODE_QUADSPI 0x00000C00
74 #define GQSPI_GENFIFO_MODE_MASK 0x00000C00
75 #define GQSPI_GENFIFO_CS_LOWER 0x00001000
76 #define GQSPI_GENFIFO_CS_UPPER 0x00002000
77 #define GQSPI_GENFIFO_BUS_LOWER 0x00004000
78 #define GQSPI_GENFIFO_BUS_UPPER 0x00008000
79 #define GQSPI_GENFIFO_BUS_BOTH 0x0000C000
80 #define GQSPI_GENFIFO_BUS_MASK 0x0000C000
81 #define GQSPI_GENFIFO_TX 0x00010000
82 #define GQSPI_GENFIFO_RX 0x00020000
83 #define GQSPI_GENFIFO_STRIPE 0x00040000
84 #define GQSPI_GENFIFO_POLL 0x00080000
85 #define GQSPI_GENFIFO_EXP_START 0x00000100
86 #define GQSPI_FIFO_CTRL_RST_RX_FIFO_MASK 0x00000004
87 #define GQSPI_FIFO_CTRL_RST_TX_FIFO_MASK 0x00000002
88 #define GQSPI_FIFO_CTRL_RST_GEN_FIFO_MASK 0x00000001
89 #define GQSPI_ISR_RXEMPTY_MASK 0x00000800
90 #define GQSPI_ISR_GENFIFOFULL_MASK 0x00000400
91 #define GQSPI_ISR_GENFIFONOT_FULL_MASK 0x00000200
92 #define GQSPI_ISR_TXEMPTY_MASK 0x00000100
93 #define GQSPI_ISR_GENFIFOEMPTY_MASK 0x00000080
94 #define GQSPI_ISR_RXFULL_MASK 0x00000020
95 #define GQSPI_ISR_RXNEMPTY_MASK 0x00000010
96 #define GQSPI_ISR_TXFULL_MASK 0x00000008
97 #define GQSPI_ISR_TXNOT_FULL_MASK 0x00000004
98 #define GQSPI_ISR_POLL_TIME_EXPIRE_MASK 0x00000002
99 #define GQSPI_IER_TXNOT_FULL_MASK 0x00000004
100 #define GQSPI_IER_RXEMPTY_MASK 0x00000800
101 #define GQSPI_IER_POLL_TIME_EXPIRE_MASK 0x00000002
102 #define GQSPI_IER_RXNEMPTY_MASK 0x00000010
103 #define GQSPI_IER_GENFIFOEMPTY_MASK 0x00000080
104 #define GQSPI_IER_TXEMPTY_MASK 0x00000100
105 #define GQSPI_QSPIDMA_DST_INTR_ALL_MASK 0x000000FE
106 #define GQSPI_QSPIDMA_DST_STS_WTC 0x0000E000
107 #define GQSPI_CFG_MODE_EN_DMA_MASK 0x80000000
108 #define GQSPI_ISR_IDR_MASK 0x00000994
109 #define GQSPI_QSPIDMA_DST_I_EN_DONE_MASK 0x00000002
110 #define GQSPI_QSPIDMA_DST_I_STS_DONE_MASK 0x00000002
111 #define GQSPI_IRQ_MASK 0x00000980
113 #define GQSPI_CFG_BAUD_RATE_DIV_SHIFT 3
114 #define GQSPI_GENFIFO_CS_SETUP 0x4
115 #define GQSPI_GENFIFO_CS_HOLD 0x3
116 #define GQSPI_TXD_DEPTH 64
117 #define GQSPI_RX_FIFO_THRESHOLD 32
118 #define GQSPI_RX_FIFO_FILL (GQSPI_RX_FIFO_THRESHOLD * 4)
119 #define GQSPI_TX_FIFO_THRESHOLD_RESET_VAL 32
120 #define GQSPI_TX_FIFO_FILL (GQSPI_TXD_DEPTH -\
121 GQSPI_TX_FIFO_THRESHOLD_RESET_VAL)
122 #define GQSPI_GEN_FIFO_THRESHOLD_RESET_VAL 0X10
123 #define GQSPI_QSPIDMA_DST_CTRL_RESET_VAL 0x803FFA00
124 #define GQSPI_SELECT_FLASH_CS_LOWER 0x1
125 #define GQSPI_SELECT_FLASH_CS_UPPER 0x2
126 #define GQSPI_SELECT_FLASH_CS_BOTH 0x3
127 #define GQSPI_SELECT_FLASH_BUS_LOWER 0x1
128 #define GQSPI_SELECT_FLASH_BUS_UPPER 0x2
129 #define GQSPI_SELECT_FLASH_BUS_BOTH 0x3
130 #define GQSPI_BAUD_DIV_MAX 7 /* Baud rate divisor maximum */
131 #define GQSPI_BAUD_DIV_SHIFT 2 /* Baud rate divisor shift */
132 #define GQSPI_SELECT_MODE_SPI 0x1
133 #define GQSPI_SELECT_MODE_DUALSPI 0x2
134 #define GQSPI_SELECT_MODE_QUADSPI 0x4
135 #define GQSPI_DMA_UNALIGN 0x3
136 #define GQSPI_DEFAULT_NUM_CS 1 /* Default number of chip selects */
138 enum mode_type
{GQSPI_MODE_IO
, GQSPI_MODE_DMA
};
141 * struct zynqmp_qspi - Defines qspi driver instance
142 * @regs: Virtual address of the QSPI controller registers
143 * @refclk: Pointer to the peripheral clock
144 * @pclk: Pointer to the APB clock
146 * @dev: Pointer to struct device
147 * @txbuf: Pointer to the TX buffer
148 * @rxbuf: Pointer to the RX buffer
149 * @bytes_to_transfer: Number of bytes left to transfer
150 * @bytes_to_receive: Number of bytes left to receive
151 * @genfifocs: Used for chip select
152 * @genfifobus: Used to select the upper or lower bus
153 * @dma_rx_bytes: Remaining bytes to receive by DMA mode
154 * @dma_addr: DMA address after mapping the kernel buffer
155 * @genfifoentry: Used for storing the genfifoentry instruction.
156 * @mode: Defines the mode in which QSPI is operating
166 int bytes_to_transfer
;
167 int bytes_to_receive
;
177 * zynqmp_gqspi_read: For GQSPI controller read operation
178 * @xqspi: Pointer to the zynqmp_qspi structure
179 * @offset: Offset from where to read
181 static u32
zynqmp_gqspi_read(struct zynqmp_qspi
*xqspi
, u32 offset
)
183 return readl_relaxed(xqspi
->regs
+ offset
);
187 * zynqmp_gqspi_write: For GQSPI controller write operation
188 * @xqspi: Pointer to the zynqmp_qspi structure
189 * @offset: Offset where to write
190 * @val: Value to be written
192 static inline void zynqmp_gqspi_write(struct zynqmp_qspi
*xqspi
, u32 offset
,
195 writel_relaxed(val
, (xqspi
->regs
+ offset
));
199 * zynqmp_gqspi_selectslave: For selection of slave device
200 * @instanceptr: Pointer to the zynqmp_qspi structure
201 * @flashcs: For chip select
202 * @flashbus: To check which bus is selected- upper or lower
204 static void zynqmp_gqspi_selectslave(struct zynqmp_qspi
*instanceptr
,
205 u8 slavecs
, u8 slavebus
)
208 * Bus and CS lines selected here will be updated in the instance and
209 * used for subsequent GENFIFO entries during transfer.
212 /* Choose slave select line */
214 case GQSPI_SELECT_FLASH_CS_BOTH
:
215 instanceptr
->genfifocs
= GQSPI_GENFIFO_CS_LOWER
|
216 GQSPI_GENFIFO_CS_UPPER
;
218 case GQSPI_SELECT_FLASH_CS_UPPER
:
219 instanceptr
->genfifocs
= GQSPI_GENFIFO_CS_UPPER
;
221 case GQSPI_SELECT_FLASH_CS_LOWER
:
222 instanceptr
->genfifocs
= GQSPI_GENFIFO_CS_LOWER
;
225 dev_warn(instanceptr
->dev
, "Invalid slave select\n");
230 case GQSPI_SELECT_FLASH_BUS_BOTH
:
231 instanceptr
->genfifobus
= GQSPI_GENFIFO_BUS_LOWER
|
232 GQSPI_GENFIFO_BUS_UPPER
;
234 case GQSPI_SELECT_FLASH_BUS_UPPER
:
235 instanceptr
->genfifobus
= GQSPI_GENFIFO_BUS_UPPER
;
237 case GQSPI_SELECT_FLASH_BUS_LOWER
:
238 instanceptr
->genfifobus
= GQSPI_GENFIFO_BUS_LOWER
;
241 dev_warn(instanceptr
->dev
, "Invalid slave bus\n");
246 * zynqmp_qspi_init_hw: Initialize the hardware
247 * @xqspi: Pointer to the zynqmp_qspi structure
249 * The default settings of the QSPI controller's configurable parameters on
252 * - TX threshold set to 1
253 * - RX threshold set to 1
254 * - Flash memory interface mode enabled
255 * This function performs the following actions
256 * - Disable and clear all the interrupts
257 * - Enable manual slave select
258 * - Enable manual start
259 * - Deselect all the chip select lines
260 * - Set the little endian mode of TX FIFO and
261 * - Enable the QSPI controller
263 static void zynqmp_qspi_init_hw(struct zynqmp_qspi
*xqspi
)
267 /* Select the GQSPI mode */
268 zynqmp_gqspi_write(xqspi
, GQSPI_SEL_OFST
, GQSPI_SEL_MASK
);
269 /* Clear and disable interrupts */
270 zynqmp_gqspi_write(xqspi
, GQSPI_ISR_OFST
,
271 zynqmp_gqspi_read(xqspi
, GQSPI_ISR_OFST
) |
272 GQSPI_ISR_WR_TO_CLR_MASK
);
273 /* Clear the DMA STS */
274 zynqmp_gqspi_write(xqspi
, GQSPI_QSPIDMA_DST_I_STS_OFST
,
275 zynqmp_gqspi_read(xqspi
,
276 GQSPI_QSPIDMA_DST_I_STS_OFST
));
277 zynqmp_gqspi_write(xqspi
, GQSPI_QSPIDMA_DST_STS_OFST
,
278 zynqmp_gqspi_read(xqspi
,
279 GQSPI_QSPIDMA_DST_STS_OFST
) |
280 GQSPI_QSPIDMA_DST_STS_WTC
);
281 zynqmp_gqspi_write(xqspi
, GQSPI_IDR_OFST
, GQSPI_IDR_ALL_MASK
);
282 zynqmp_gqspi_write(xqspi
,
283 GQSPI_QSPIDMA_DST_I_DIS_OFST
,
284 GQSPI_QSPIDMA_DST_INTR_ALL_MASK
);
285 /* Disable the GQSPI */
286 zynqmp_gqspi_write(xqspi
, GQSPI_EN_OFST
, 0x0);
287 config_reg
= zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
);
288 config_reg
&= ~GQSPI_CFG_MODE_EN_MASK
;
290 config_reg
|= GQSPI_CFG_GEN_FIFO_START_MODE_MASK
;
291 /* Little endian by default */
292 config_reg
&= ~GQSPI_CFG_ENDIAN_MASK
;
293 /* Disable poll time out */
294 config_reg
&= ~GQSPI_CFG_EN_POLL_TO_MASK
;
296 config_reg
|= GQSPI_CFG_WP_HOLD_MASK
;
297 /* Clear pre-scalar by default */
298 config_reg
&= ~GQSPI_CFG_BAUD_RATE_DIV_MASK
;
300 config_reg
&= ~GQSPI_CFG_CLK_PHA_MASK
;
302 config_reg
&= ~GQSPI_CFG_CLK_POL_MASK
;
303 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
, config_reg
);
305 /* Clear the TX and RX FIFO */
306 zynqmp_gqspi_write(xqspi
, GQSPI_FIFO_CTRL_OFST
,
307 GQSPI_FIFO_CTRL_RST_RX_FIFO_MASK
|
308 GQSPI_FIFO_CTRL_RST_TX_FIFO_MASK
|
309 GQSPI_FIFO_CTRL_RST_GEN_FIFO_MASK
);
310 /* Set by default to allow for high frequencies */
311 zynqmp_gqspi_write(xqspi
, GQSPI_LPBK_DLY_ADJ_OFST
,
312 zynqmp_gqspi_read(xqspi
, GQSPI_LPBK_DLY_ADJ_OFST
) |
313 GQSPI_LPBK_DLY_ADJ_USE_LPBK_MASK
);
314 /* Reset thresholds */
315 zynqmp_gqspi_write(xqspi
, GQSPI_TX_THRESHOLD_OFST
,
316 GQSPI_TX_FIFO_THRESHOLD_RESET_VAL
);
317 zynqmp_gqspi_write(xqspi
, GQSPI_RX_THRESHOLD_OFST
,
318 GQSPI_RX_FIFO_THRESHOLD
);
319 zynqmp_gqspi_write(xqspi
, GQSPI_GF_THRESHOLD_OFST
,
320 GQSPI_GEN_FIFO_THRESHOLD_RESET_VAL
);
321 zynqmp_gqspi_selectslave(xqspi
,
322 GQSPI_SELECT_FLASH_CS_LOWER
,
323 GQSPI_SELECT_FLASH_BUS_LOWER
);
325 zynqmp_gqspi_write(xqspi
,
326 GQSPI_QSPIDMA_DST_CTRL_OFST
,
327 GQSPI_QSPIDMA_DST_CTRL_RESET_VAL
);
329 /* Enable the GQSPI */
330 zynqmp_gqspi_write(xqspi
, GQSPI_EN_OFST
, GQSPI_EN_MASK
);
334 * zynqmp_qspi_copy_read_data: Copy data to RX buffer
335 * @xqspi: Pointer to the zynqmp_qspi structure
336 * @data: The variable where data is stored
337 * @size: Number of bytes to be copied from data to RX buffer
339 static void zynqmp_qspi_copy_read_data(struct zynqmp_qspi
*xqspi
,
342 memcpy(xqspi
->rxbuf
, &data
, size
);
343 xqspi
->rxbuf
+= size
;
344 xqspi
->bytes_to_receive
-= size
;
348 * zynqmp_prepare_transfer_hardware: Prepares hardware for transfer.
349 * @master: Pointer to the spi_master structure which provides
350 * information about the controller.
352 * This function enables SPI master controller.
354 * Return: 0 on success; error value otherwise
356 static int zynqmp_prepare_transfer_hardware(struct spi_master
*master
)
358 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(master
);
361 ret
= clk_enable(xqspi
->refclk
);
365 ret
= clk_enable(xqspi
->pclk
);
369 zynqmp_gqspi_write(xqspi
, GQSPI_EN_OFST
, GQSPI_EN_MASK
);
372 clk_disable(xqspi
->refclk
);
377 * zynqmp_unprepare_transfer_hardware: Relaxes hardware after transfer
378 * @master: Pointer to the spi_master structure which provides
379 * information about the controller.
381 * This function disables the SPI master controller.
385 static int zynqmp_unprepare_transfer_hardware(struct spi_master
*master
)
387 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(master
);
389 zynqmp_gqspi_write(xqspi
, GQSPI_EN_OFST
, 0x0);
390 clk_disable(xqspi
->refclk
);
391 clk_disable(xqspi
->pclk
);
396 * zynqmp_qspi_chipselect: Select or deselect the chip select line
397 * @qspi: Pointer to the spi_device structure
398 * @is_high: Select(0) or deselect (1) the chip select line
400 static void zynqmp_qspi_chipselect(struct spi_device
*qspi
, bool is_high
)
402 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(qspi
->master
);
404 u32 genfifoentry
= 0x0, statusreg
;
406 genfifoentry
|= GQSPI_GENFIFO_MODE_SPI
;
407 genfifoentry
|= xqspi
->genfifobus
;
410 genfifoentry
|= xqspi
->genfifocs
;
411 genfifoentry
|= GQSPI_GENFIFO_CS_SETUP
;
413 genfifoentry
|= GQSPI_GENFIFO_CS_HOLD
;
416 zynqmp_gqspi_write(xqspi
, GQSPI_GEN_FIFO_OFST
, genfifoentry
);
418 /* Dummy generic FIFO entry */
419 zynqmp_gqspi_write(xqspi
, GQSPI_GEN_FIFO_OFST
, 0x0);
421 /* Manually start the generic FIFO command */
422 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
,
423 zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
) |
424 GQSPI_CFG_START_GEN_FIFO_MASK
);
426 timeout
= jiffies
+ msecs_to_jiffies(1000);
428 /* Wait until the generic FIFO command is empty */
430 statusreg
= zynqmp_gqspi_read(xqspi
, GQSPI_ISR_OFST
);
432 if ((statusreg
& GQSPI_ISR_GENFIFOEMPTY_MASK
) &&
433 (statusreg
& GQSPI_ISR_TXEMPTY_MASK
))
437 } while (!time_after_eq(jiffies
, timeout
));
439 if (time_after_eq(jiffies
, timeout
))
440 dev_err(xqspi
->dev
, "Chip select timed out\n");
444 * zynqmp_qspi_setup_transfer: Configure QSPI controller for specified
446 * @qspi: Pointer to the spi_device structure
447 * @transfer: Pointer to the spi_transfer structure which provides
448 * information about next transfer setup parameters
450 * Sets the operational mode of QSPI controller for the next QSPI transfer and
451 * sets the requested clock frequency.
456 * If the requested frequency is not an exact match with what can be
457 * obtained using the pre-scalar value, the driver sets the clock
458 * frequency which is lower than the requested frequency (maximum lower)
461 * If the requested frequency is higher or lower than that is supported
462 * by the QSPI controller the driver will set the highest or lowest
463 * frequency supported by controller.
465 static int zynqmp_qspi_setup_transfer(struct spi_device
*qspi
,
466 struct spi_transfer
*transfer
)
468 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(qspi
->master
);
470 u32 config_reg
, req_hz
, baud_rate_val
= 0;
473 req_hz
= transfer
->speed_hz
;
475 req_hz
= qspi
->max_speed_hz
;
477 /* Set the clock frequency */
478 /* If req_hz == 0, default to lowest speed */
479 clk_rate
= clk_get_rate(xqspi
->refclk
);
481 while ((baud_rate_val
< GQSPI_BAUD_DIV_MAX
) &&
483 (GQSPI_BAUD_DIV_SHIFT
<< baud_rate_val
)) > req_hz
)
486 config_reg
= zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
);
488 /* Set the QSPI clock phase and clock polarity */
489 config_reg
&= (~GQSPI_CFG_CLK_PHA_MASK
) & (~GQSPI_CFG_CLK_POL_MASK
);
491 if (qspi
->mode
& SPI_CPHA
)
492 config_reg
|= GQSPI_CFG_CLK_PHA_MASK
;
493 if (qspi
->mode
& SPI_CPOL
)
494 config_reg
|= GQSPI_CFG_CLK_POL_MASK
;
496 config_reg
&= ~GQSPI_CFG_BAUD_RATE_DIV_MASK
;
497 config_reg
|= (baud_rate_val
<< GQSPI_CFG_BAUD_RATE_DIV_SHIFT
);
498 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
, config_reg
);
503 * zynqmp_qspi_setup: Configure the QSPI controller
504 * @qspi: Pointer to the spi_device structure
506 * Sets the operational mode of QSPI controller for the next QSPI transfer,
507 * baud rate and divisor value to setup the requested qspi clock.
509 * Return: 0 on success; error value otherwise.
511 static int zynqmp_qspi_setup(struct spi_device
*qspi
)
513 if (qspi
->master
->busy
)
519 * zynqmp_qspi_filltxfifo: Fills the TX FIFO as long as there is room in
520 * the FIFO or the bytes required to be
522 * @xqspi: Pointer to the zynqmp_qspi structure
523 * @size: Number of bytes to be copied from TX buffer to TX FIFO
525 static void zynqmp_qspi_filltxfifo(struct zynqmp_qspi
*xqspi
, int size
)
527 u32 count
= 0, intermediate
;
529 while ((xqspi
->bytes_to_transfer
> 0) && (count
< size
)) {
530 memcpy(&intermediate
, xqspi
->txbuf
, 4);
531 zynqmp_gqspi_write(xqspi
, GQSPI_TXD_OFST
, intermediate
);
533 if (xqspi
->bytes_to_transfer
>= 4) {
535 xqspi
->bytes_to_transfer
-= 4;
537 xqspi
->txbuf
+= xqspi
->bytes_to_transfer
;
538 xqspi
->bytes_to_transfer
= 0;
545 * zynqmp_qspi_readrxfifo: Fills the RX FIFO as long as there is room in
547 * @xqspi: Pointer to the zynqmp_qspi structure
548 * @size: Number of bytes to be copied from RX buffer to RX FIFO
550 static void zynqmp_qspi_readrxfifo(struct zynqmp_qspi
*xqspi
, u32 size
)
555 while ((count
< size
) && (xqspi
->bytes_to_receive
> 0)) {
556 if (xqspi
->bytes_to_receive
>= 4) {
557 (*(u32
*) xqspi
->rxbuf
) =
558 zynqmp_gqspi_read(xqspi
, GQSPI_RXD_OFST
);
560 xqspi
->bytes_to_receive
-= 4;
563 data
= zynqmp_gqspi_read(xqspi
, GQSPI_RXD_OFST
);
564 count
+= xqspi
->bytes_to_receive
;
565 zynqmp_qspi_copy_read_data(xqspi
, data
,
566 xqspi
->bytes_to_receive
);
567 xqspi
->bytes_to_receive
= 0;
573 * zynqmp_process_dma_irq: Handler for DMA done interrupt of QSPI
575 * @xqspi: zynqmp_qspi instance pointer
577 * This function handles DMA interrupt only.
579 static void zynqmp_process_dma_irq(struct zynqmp_qspi
*xqspi
)
581 u32 config_reg
, genfifoentry
;
583 dma_unmap_single(xqspi
->dev
, xqspi
->dma_addr
,
584 xqspi
->dma_rx_bytes
, DMA_FROM_DEVICE
);
585 xqspi
->rxbuf
+= xqspi
->dma_rx_bytes
;
586 xqspi
->bytes_to_receive
-= xqspi
->dma_rx_bytes
;
587 xqspi
->dma_rx_bytes
= 0;
589 /* Disabling the DMA interrupts */
590 zynqmp_gqspi_write(xqspi
, GQSPI_QSPIDMA_DST_I_DIS_OFST
,
591 GQSPI_QSPIDMA_DST_I_EN_DONE_MASK
);
593 if (xqspi
->bytes_to_receive
> 0) {
594 /* Switch to IO mode,for remaining bytes to receive */
595 config_reg
= zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
);
596 config_reg
&= ~GQSPI_CFG_MODE_EN_MASK
;
597 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
, config_reg
);
599 /* Initiate the transfer of remaining bytes */
600 genfifoentry
= xqspi
->genfifoentry
;
601 genfifoentry
|= xqspi
->bytes_to_receive
;
602 zynqmp_gqspi_write(xqspi
, GQSPI_GEN_FIFO_OFST
, genfifoentry
);
604 /* Dummy generic FIFO entry */
605 zynqmp_gqspi_write(xqspi
, GQSPI_GEN_FIFO_OFST
, 0x0);
608 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
,
609 (zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
) |
610 GQSPI_CFG_START_GEN_FIFO_MASK
));
612 /* Enable the RX interrupts for IO mode */
613 zynqmp_gqspi_write(xqspi
, GQSPI_IER_OFST
,
614 GQSPI_IER_GENFIFOEMPTY_MASK
|
615 GQSPI_IER_RXNEMPTY_MASK
|
616 GQSPI_IER_RXEMPTY_MASK
);
621 * zynqmp_qspi_irq: Interrupt service routine of the QSPI controller
623 * @dev_id: Pointer to the xqspi structure
625 * This function handles TX empty only.
626 * On TX empty interrupt this function reads the received data from RX FIFO
627 * and fills the TX FIFO if there is any data remaining to be transferred.
629 * Return: IRQ_HANDLED when interrupt is handled
630 * IRQ_NONE otherwise.
632 static irqreturn_t
zynqmp_qspi_irq(int irq
, void *dev_id
)
634 struct spi_master
*master
= dev_id
;
635 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(master
);
637 u32 status
, mask
, dma_status
= 0;
639 status
= zynqmp_gqspi_read(xqspi
, GQSPI_ISR_OFST
);
640 zynqmp_gqspi_write(xqspi
, GQSPI_ISR_OFST
, status
);
641 mask
= (status
& ~(zynqmp_gqspi_read(xqspi
, GQSPI_IMASK_OFST
)));
643 /* Read and clear DMA status */
644 if (xqspi
->mode
== GQSPI_MODE_DMA
) {
646 zynqmp_gqspi_read(xqspi
, GQSPI_QSPIDMA_DST_I_STS_OFST
);
647 zynqmp_gqspi_write(xqspi
, GQSPI_QSPIDMA_DST_I_STS_OFST
,
651 if (mask
& GQSPI_ISR_TXNOT_FULL_MASK
) {
652 zynqmp_qspi_filltxfifo(xqspi
, GQSPI_TX_FIFO_FILL
);
656 if (dma_status
& GQSPI_QSPIDMA_DST_I_STS_DONE_MASK
) {
657 zynqmp_process_dma_irq(xqspi
);
659 } else if (!(mask
& GQSPI_IER_RXEMPTY_MASK
) &&
660 (mask
& GQSPI_IER_GENFIFOEMPTY_MASK
)) {
661 zynqmp_qspi_readrxfifo(xqspi
, GQSPI_RX_FIFO_FILL
);
665 if ((xqspi
->bytes_to_receive
== 0) && (xqspi
->bytes_to_transfer
== 0)
666 && ((status
& GQSPI_IRQ_MASK
) == GQSPI_IRQ_MASK
)) {
667 zynqmp_gqspi_write(xqspi
, GQSPI_IDR_OFST
, GQSPI_ISR_IDR_MASK
);
668 spi_finalize_current_transfer(master
);
675 * zynqmp_qspi_selectspimode: Selects SPI mode - x1 or x2 or x4.
676 * @xqspi: xqspi is a pointer to the GQSPI instance
677 * @spimode: spimode - SPI or DUAL or QUAD.
678 * Return: Mask to set desired SPI mode in GENFIFO entry.
680 static inline u32
zynqmp_qspi_selectspimode(struct zynqmp_qspi
*xqspi
,
686 case GQSPI_SELECT_MODE_DUALSPI
:
687 mask
= GQSPI_GENFIFO_MODE_DUALSPI
;
689 case GQSPI_SELECT_MODE_QUADSPI
:
690 mask
= GQSPI_GENFIFO_MODE_QUADSPI
;
692 case GQSPI_SELECT_MODE_SPI
:
693 mask
= GQSPI_GENFIFO_MODE_SPI
;
696 dev_warn(xqspi
->dev
, "Invalid SPI mode\n");
703 * zynq_qspi_setuprxdma: This function sets up the RX DMA operation
704 * @xqspi: xqspi is a pointer to the GQSPI instance.
706 static void zynq_qspi_setuprxdma(struct zynqmp_qspi
*xqspi
)
708 u32 rx_bytes
, rx_rem
, config_reg
;
710 u64 dma_align
= (u64
)(uintptr_t)xqspi
->rxbuf
;
712 if ((xqspi
->bytes_to_receive
< 8) ||
713 ((dma_align
& GQSPI_DMA_UNALIGN
) != 0x0)) {
714 /* Setting to IO mode */
715 config_reg
= zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
);
716 config_reg
&= ~GQSPI_CFG_MODE_EN_MASK
;
717 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
, config_reg
);
718 xqspi
->mode
= GQSPI_MODE_IO
;
719 xqspi
->dma_rx_bytes
= 0;
723 rx_rem
= xqspi
->bytes_to_receive
% 4;
724 rx_bytes
= (xqspi
->bytes_to_receive
- rx_rem
);
726 addr
= dma_map_single(xqspi
->dev
, (void *)xqspi
->rxbuf
,
727 rx_bytes
, DMA_FROM_DEVICE
);
728 if (dma_mapping_error(xqspi
->dev
, addr
))
729 dev_err(xqspi
->dev
, "ERR:rxdma:memory not mapped\n");
731 xqspi
->dma_rx_bytes
= rx_bytes
;
732 xqspi
->dma_addr
= addr
;
733 zynqmp_gqspi_write(xqspi
, GQSPI_QSPIDMA_DST_ADDR_OFST
,
734 (u32
)(addr
& 0xffffffff));
735 addr
= ((addr
>> 16) >> 16);
736 zynqmp_gqspi_write(xqspi
, GQSPI_QSPIDMA_DST_ADDR_MSB_OFST
,
737 ((u32
)addr
) & 0xfff);
739 /* Enabling the DMA mode */
740 config_reg
= zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
);
741 config_reg
&= ~GQSPI_CFG_MODE_EN_MASK
;
742 config_reg
|= GQSPI_CFG_MODE_EN_DMA_MASK
;
743 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
, config_reg
);
745 /* Switch to DMA mode */
746 xqspi
->mode
= GQSPI_MODE_DMA
;
748 /* Write the number of bytes to transfer */
749 zynqmp_gqspi_write(xqspi
, GQSPI_QSPIDMA_DST_SIZE_OFST
, rx_bytes
);
753 * zynqmp_qspi_txrxsetup: This function checks the TX/RX buffers in
754 * the transfer and sets up the GENFIFO entries,
755 * TX FIFO as required.
756 * @xqspi: xqspi is a pointer to the GQSPI instance.
757 * @transfer: It is a pointer to the structure containing transfer data.
758 * @genfifoentry: genfifoentry is pointer to the variable in which
759 * GENFIFO mask is returned to calling function
761 static void zynqmp_qspi_txrxsetup(struct zynqmp_qspi
*xqspi
,
762 struct spi_transfer
*transfer
,
768 if ((xqspi
->txbuf
!= NULL
) && (xqspi
->rxbuf
== NULL
)) {
769 /* Setup data to be TXed */
770 *genfifoentry
&= ~GQSPI_GENFIFO_RX
;
771 *genfifoentry
|= GQSPI_GENFIFO_DATA_XFER
;
772 *genfifoentry
|= GQSPI_GENFIFO_TX
;
774 zynqmp_qspi_selectspimode(xqspi
, transfer
->tx_nbits
);
775 xqspi
->bytes_to_transfer
= transfer
->len
;
776 if (xqspi
->mode
== GQSPI_MODE_DMA
) {
777 config_reg
= zynqmp_gqspi_read(xqspi
,
779 config_reg
&= ~GQSPI_CFG_MODE_EN_MASK
;
780 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
,
782 xqspi
->mode
= GQSPI_MODE_IO
;
784 zynqmp_qspi_filltxfifo(xqspi
, GQSPI_TXD_DEPTH
);
785 /* Discard RX data */
786 xqspi
->bytes_to_receive
= 0;
787 } else if ((xqspi
->txbuf
== NULL
) && (xqspi
->rxbuf
!= NULL
)) {
791 *genfifoentry
&= ~GQSPI_GENFIFO_TX
;
793 *genfifoentry
|= GQSPI_GENFIFO_DATA_XFER
;
794 *genfifoentry
|= GQSPI_GENFIFO_RX
;
796 zynqmp_qspi_selectspimode(xqspi
, transfer
->rx_nbits
);
797 xqspi
->bytes_to_transfer
= 0;
798 xqspi
->bytes_to_receive
= transfer
->len
;
799 zynq_qspi_setuprxdma(xqspi
);
804 * zynqmp_qspi_start_transfer: Initiates the QSPI transfer
805 * @master: Pointer to the spi_master structure which provides
806 * information about the controller.
807 * @qspi: Pointer to the spi_device structure
808 * @transfer: Pointer to the spi_transfer structure which provide information
809 * about next transfer parameters
811 * This function fills the TX FIFO, starts the QSPI transfer, and waits for the
812 * transfer to be completed.
814 * Return: Number of bytes transferred in the last transfer
816 static int zynqmp_qspi_start_transfer(struct spi_master
*master
,
817 struct spi_device
*qspi
,
818 struct spi_transfer
*transfer
)
820 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(master
);
821 u32 genfifoentry
= 0x0, transfer_len
;
823 xqspi
->txbuf
= transfer
->tx_buf
;
824 xqspi
->rxbuf
= transfer
->rx_buf
;
826 zynqmp_qspi_setup_transfer(qspi
, transfer
);
828 genfifoentry
|= xqspi
->genfifocs
;
829 genfifoentry
|= xqspi
->genfifobus
;
831 zynqmp_qspi_txrxsetup(xqspi
, transfer
, &genfifoentry
);
833 if (xqspi
->mode
== GQSPI_MODE_DMA
)
834 transfer_len
= xqspi
->dma_rx_bytes
;
836 transfer_len
= transfer
->len
;
838 xqspi
->genfifoentry
= genfifoentry
;
839 if ((transfer_len
) < GQSPI_GENFIFO_IMM_DATA_MASK
) {
840 genfifoentry
&= ~GQSPI_GENFIFO_IMM_DATA_MASK
;
841 genfifoentry
|= transfer_len
;
842 zynqmp_gqspi_write(xqspi
, GQSPI_GEN_FIFO_OFST
, genfifoentry
);
844 int tempcount
= transfer_len
;
845 u32 exponent
= 8; /* 2^8 = 256 */
846 u8 imm_data
= tempcount
& 0xFF;
848 tempcount
&= ~(tempcount
& 0xFF);
849 /* Immediate entry */
850 if (tempcount
!= 0) {
851 /* Exponent entries */
852 genfifoentry
|= GQSPI_GENFIFO_EXP
;
853 while (tempcount
!= 0) {
854 if (tempcount
& GQSPI_GENFIFO_EXP_START
) {
856 ~GQSPI_GENFIFO_IMM_DATA_MASK
;
857 genfifoentry
|= exponent
;
858 zynqmp_gqspi_write(xqspi
,
862 tempcount
= tempcount
>> 1;
867 genfifoentry
&= ~GQSPI_GENFIFO_EXP
;
868 genfifoentry
&= ~GQSPI_GENFIFO_IMM_DATA_MASK
;
869 genfifoentry
|= (u8
) (imm_data
& 0xFF);
870 zynqmp_gqspi_write(xqspi
,
871 GQSPI_GEN_FIFO_OFST
, genfifoentry
);
875 if ((xqspi
->mode
== GQSPI_MODE_IO
) &&
876 (xqspi
->rxbuf
!= NULL
)) {
877 /* Dummy generic FIFO entry */
878 zynqmp_gqspi_write(xqspi
, GQSPI_GEN_FIFO_OFST
, 0x0);
881 /* Since we are using manual mode */
882 zynqmp_gqspi_write(xqspi
, GQSPI_CONFIG_OFST
,
883 zynqmp_gqspi_read(xqspi
, GQSPI_CONFIG_OFST
) |
884 GQSPI_CFG_START_GEN_FIFO_MASK
);
886 if (xqspi
->txbuf
!= NULL
)
887 /* Enable interrupts for TX */
888 zynqmp_gqspi_write(xqspi
, GQSPI_IER_OFST
,
889 GQSPI_IER_TXEMPTY_MASK
|
890 GQSPI_IER_GENFIFOEMPTY_MASK
|
891 GQSPI_IER_TXNOT_FULL_MASK
);
893 if (xqspi
->rxbuf
!= NULL
) {
894 /* Enable interrupts for RX */
895 if (xqspi
->mode
== GQSPI_MODE_DMA
) {
896 /* Enable DMA interrupts */
897 zynqmp_gqspi_write(xqspi
,
898 GQSPI_QSPIDMA_DST_I_EN_OFST
,
899 GQSPI_QSPIDMA_DST_I_EN_DONE_MASK
);
901 zynqmp_gqspi_write(xqspi
, GQSPI_IER_OFST
,
902 GQSPI_IER_GENFIFOEMPTY_MASK
|
903 GQSPI_IER_RXNEMPTY_MASK
|
904 GQSPI_IER_RXEMPTY_MASK
);
908 return transfer
->len
;
912 * zynqmp_qspi_suspend: Suspend method for the QSPI driver
913 * @_dev: Address of the platform_device structure
915 * This function stops the QSPI driver queue and disables the QSPI controller
919 static int __maybe_unused
zynqmp_qspi_suspend(struct device
*dev
)
921 struct platform_device
*pdev
= to_platform_device(dev
);
922 struct spi_master
*master
= platform_get_drvdata(pdev
);
924 spi_master_suspend(master
);
926 zynqmp_unprepare_transfer_hardware(master
);
932 * zynqmp_qspi_resume: Resume method for the QSPI driver
933 * @dev: Address of the platform_device structure
935 * The function starts the QSPI driver queue and initializes the QSPI
938 * Return: 0 on success; error value otherwise
940 static int __maybe_unused
zynqmp_qspi_resume(struct device
*dev
)
942 struct platform_device
*pdev
= to_platform_device(dev
);
943 struct spi_master
*master
= platform_get_drvdata(pdev
);
944 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(master
);
947 ret
= clk_enable(xqspi
->pclk
);
949 dev_err(dev
, "Cannot enable APB clock.\n");
953 ret
= clk_enable(xqspi
->refclk
);
955 dev_err(dev
, "Cannot enable device clock.\n");
956 clk_disable(xqspi
->pclk
);
960 spi_master_resume(master
);
965 static SIMPLE_DEV_PM_OPS(zynqmp_qspi_dev_pm_ops
, zynqmp_qspi_suspend
,
969 * zynqmp_qspi_probe: Probe method for the QSPI driver
970 * @pdev: Pointer to the platform_device structure
972 * This function initializes the driver data structures and the hardware.
974 * Return: 0 on success; error value otherwise
976 static int zynqmp_qspi_probe(struct platform_device
*pdev
)
979 struct spi_master
*master
;
980 struct zynqmp_qspi
*xqspi
;
981 struct resource
*res
;
982 struct device
*dev
= &pdev
->dev
;
984 master
= spi_alloc_master(&pdev
->dev
, sizeof(*xqspi
));
988 xqspi
= spi_master_get_devdata(master
);
989 master
->dev
.of_node
= pdev
->dev
.of_node
;
990 platform_set_drvdata(pdev
, master
);
992 res
= platform_get_resource(pdev
, IORESOURCE_MEM
, 0);
993 xqspi
->regs
= devm_ioremap_resource(&pdev
->dev
, res
);
994 if (IS_ERR(xqspi
->regs
)) {
995 ret
= PTR_ERR(xqspi
->regs
);
1000 xqspi
->pclk
= devm_clk_get(&pdev
->dev
, "pclk");
1001 if (IS_ERR(xqspi
->pclk
)) {
1002 dev_err(dev
, "pclk clock not found.\n");
1003 ret
= PTR_ERR(xqspi
->pclk
);
1007 ret
= clk_prepare_enable(xqspi
->pclk
);
1009 dev_err(dev
, "Unable to enable APB clock.\n");
1013 xqspi
->refclk
= devm_clk_get(&pdev
->dev
, "ref_clk");
1014 if (IS_ERR(xqspi
->refclk
)) {
1015 dev_err(dev
, "ref_clk clock not found.\n");
1016 ret
= PTR_ERR(xqspi
->refclk
);
1020 ret
= clk_prepare_enable(xqspi
->refclk
);
1022 dev_err(dev
, "Unable to enable device clock.\n");
1026 /* QSPI controller initializations */
1027 zynqmp_qspi_init_hw(xqspi
);
1029 xqspi
->irq
= platform_get_irq(pdev
, 0);
1030 if (xqspi
->irq
<= 0) {
1032 dev_err(dev
, "irq resource not found\n");
1035 ret
= devm_request_irq(&pdev
->dev
, xqspi
->irq
, zynqmp_qspi_irq
,
1036 0, pdev
->name
, master
);
1039 dev_err(dev
, "request_irq failed\n");
1043 master
->num_chipselect
= GQSPI_DEFAULT_NUM_CS
;
1045 master
->setup
= zynqmp_qspi_setup
;
1046 master
->set_cs
= zynqmp_qspi_chipselect
;
1047 master
->transfer_one
= zynqmp_qspi_start_transfer
;
1048 master
->prepare_transfer_hardware
= zynqmp_prepare_transfer_hardware
;
1049 master
->unprepare_transfer_hardware
=
1050 zynqmp_unprepare_transfer_hardware
;
1051 master
->max_speed_hz
= clk_get_rate(xqspi
->refclk
) / 2;
1052 master
->bits_per_word_mask
= SPI_BPW_MASK(8);
1053 master
->mode_bits
= SPI_CPOL
| SPI_CPHA
| SPI_RX_DUAL
| SPI_RX_QUAD
|
1054 SPI_TX_DUAL
| SPI_TX_QUAD
;
1056 if (master
->dev
.parent
== NULL
)
1057 master
->dev
.parent
= &master
->dev
;
1059 ret
= spi_register_master(master
);
1066 clk_disable_unprepare(xqspi
->refclk
);
1068 clk_disable_unprepare(xqspi
->pclk
);
1070 spi_master_put(master
);
1076 * zynqmp_qspi_remove: Remove method for the QSPI driver
1077 * @pdev: Pointer to the platform_device structure
1079 * This function is called if a device is physically removed from the system or
1080 * if the driver module is being unloaded. It frees all resources allocated to
1085 static int zynqmp_qspi_remove(struct platform_device
*pdev
)
1087 struct spi_master
*master
= platform_get_drvdata(pdev
);
1088 struct zynqmp_qspi
*xqspi
= spi_master_get_devdata(master
);
1090 zynqmp_gqspi_write(xqspi
, GQSPI_EN_OFST
, 0x0);
1091 clk_disable_unprepare(xqspi
->refclk
);
1092 clk_disable_unprepare(xqspi
->pclk
);
1094 spi_unregister_master(master
);
1099 static const struct of_device_id zynqmp_qspi_of_match
[] = {
1100 { .compatible
= "xlnx,zynqmp-qspi-1.0", },
1101 { /* End of table */ }
1104 MODULE_DEVICE_TABLE(of
, zynqmp_qspi_of_match
);
1106 static struct platform_driver zynqmp_qspi_driver
= {
1107 .probe
= zynqmp_qspi_probe
,
1108 .remove
= zynqmp_qspi_remove
,
1110 .name
= "zynqmp-qspi",
1111 .of_match_table
= zynqmp_qspi_of_match
,
1112 .pm
= &zynqmp_qspi_dev_pm_ops
,
1116 module_platform_driver(zynqmp_qspi_driver
);
1118 MODULE_AUTHOR("Xilinx, Inc.");
1119 MODULE_DESCRIPTION("Xilinx Zynqmp QSPI driver");
1120 MODULE_LICENSE("GPL");