1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * A driver for the ARM PL022 PrimeCell SSP/SPI bus master.
5 * Copyright (C) 2008-2012 ST-Ericsson AB
6 * Copyright (C) 2006 STMicroelectronics Pvt. Ltd.
8 * Author: Linus Walleij <linus.walleij@stericsson.com>
10 * Initial version inspired by:
11 * linux-2.6.17-rc3-mm1/drivers/spi/pxa2xx_spi.c
12 * Initial adoption to PL022 by:
13 * Sachin Verma <sachin.verma@st.com>
16 #include <linux/init.h>
17 #include <linux/module.h>
18 #include <linux/device.h>
19 #include <linux/ioport.h>
20 #include <linux/errno.h>
21 #include <linux/interrupt.h>
22 #include <linux/spi/spi.h>
23 #include <linux/delay.h>
24 #include <linux/clk.h>
25 #include <linux/err.h>
26 #include <linux/amba/bus.h>
27 #include <linux/amba/pl022.h>
29 #include <linux/slab.h>
30 #include <linux/dmaengine.h>
31 #include <linux/dma-mapping.h>
32 #include <linux/scatterlist.h>
33 #include <linux/pm_runtime.h>
35 #include <linux/pinctrl/consumer.h>
38 * This macro is used to define some register default values.
39 * reg is masked with mask, the OR:ed with an (again masked)
40 * val shifted sb steps to the left.
42 #define SSP_WRITE_BITS(reg, val, mask, sb) \
43 ((reg) = (((reg) & ~(mask)) | (((val)<<(sb)) & (mask))))
46 * This macro is also used to define some default values.
47 * It will just shift val by sb steps to the left and mask
48 * the result with mask.
50 #define GEN_MASK_BITS(val, mask, sb) \
51 (((val)<<(sb)) & (mask))
54 #define DO_NOT_DRIVE_TX 1
56 #define DO_NOT_QUEUE_DMA 0
63 * Macros to access SSP Registers with their offsets
65 #define SSP_CR0(r) (r + 0x000)
66 #define SSP_CR1(r) (r + 0x004)
67 #define SSP_DR(r) (r + 0x008)
68 #define SSP_SR(r) (r + 0x00C)
69 #define SSP_CPSR(r) (r + 0x010)
70 #define SSP_IMSC(r) (r + 0x014)
71 #define SSP_RIS(r) (r + 0x018)
72 #define SSP_MIS(r) (r + 0x01C)
73 #define SSP_ICR(r) (r + 0x020)
74 #define SSP_DMACR(r) (r + 0x024)
75 #define SSP_CSR(r) (r + 0x030) /* vendor extension */
76 #define SSP_ITCR(r) (r + 0x080)
77 #define SSP_ITIP(r) (r + 0x084)
78 #define SSP_ITOP(r) (r + 0x088)
79 #define SSP_TDR(r) (r + 0x08C)
81 #define SSP_PID0(r) (r + 0xFE0)
82 #define SSP_PID1(r) (r + 0xFE4)
83 #define SSP_PID2(r) (r + 0xFE8)
84 #define SSP_PID3(r) (r + 0xFEC)
86 #define SSP_CID0(r) (r + 0xFF0)
87 #define SSP_CID1(r) (r + 0xFF4)
88 #define SSP_CID2(r) (r + 0xFF8)
89 #define SSP_CID3(r) (r + 0xFFC)
92 * SSP Control Register 0 - SSP_CR0
94 #define SSP_CR0_MASK_DSS (0x0FUL << 0)
95 #define SSP_CR0_MASK_FRF (0x3UL << 4)
96 #define SSP_CR0_MASK_SPO (0x1UL << 6)
97 #define SSP_CR0_MASK_SPH (0x1UL << 7)
98 #define SSP_CR0_MASK_SCR (0xFFUL << 8)
101 * The ST version of this block moves som bits
102 * in SSP_CR0 and extends it to 32 bits
104 #define SSP_CR0_MASK_DSS_ST (0x1FUL << 0)
105 #define SSP_CR0_MASK_HALFDUP_ST (0x1UL << 5)
106 #define SSP_CR0_MASK_CSS_ST (0x1FUL << 16)
107 #define SSP_CR0_MASK_FRF_ST (0x3UL << 21)
110 * SSP Control Register 0 - SSP_CR1
112 #define SSP_CR1_MASK_LBM (0x1UL << 0)
113 #define SSP_CR1_MASK_SSE (0x1UL << 1)
114 #define SSP_CR1_MASK_MS (0x1UL << 2)
115 #define SSP_CR1_MASK_SOD (0x1UL << 3)
118 * The ST version of this block adds some bits
121 #define SSP_CR1_MASK_RENDN_ST (0x1UL << 4)
122 #define SSP_CR1_MASK_TENDN_ST (0x1UL << 5)
123 #define SSP_CR1_MASK_MWAIT_ST (0x1UL << 6)
124 #define SSP_CR1_MASK_RXIFLSEL_ST (0x7UL << 7)
125 #define SSP_CR1_MASK_TXIFLSEL_ST (0x7UL << 10)
126 /* This one is only in the PL023 variant */
127 #define SSP_CR1_MASK_FBCLKDEL_ST (0x7UL << 13)
130 * SSP Status Register - SSP_SR
132 #define SSP_SR_MASK_TFE (0x1UL << 0) /* Transmit FIFO empty */
133 #define SSP_SR_MASK_TNF (0x1UL << 1) /* Transmit FIFO not full */
134 #define SSP_SR_MASK_RNE (0x1UL << 2) /* Receive FIFO not empty */
135 #define SSP_SR_MASK_RFF (0x1UL << 3) /* Receive FIFO full */
136 #define SSP_SR_MASK_BSY (0x1UL << 4) /* Busy Flag */
139 * SSP Clock Prescale Register - SSP_CPSR
141 #define SSP_CPSR_MASK_CPSDVSR (0xFFUL << 0)
144 * SSP Interrupt Mask Set/Clear Register - SSP_IMSC
146 #define SSP_IMSC_MASK_RORIM (0x1UL << 0) /* Receive Overrun Interrupt mask */
147 #define SSP_IMSC_MASK_RTIM (0x1UL << 1) /* Receive timeout Interrupt mask */
148 #define SSP_IMSC_MASK_RXIM (0x1UL << 2) /* Receive FIFO Interrupt mask */
149 #define SSP_IMSC_MASK_TXIM (0x1UL << 3) /* Transmit FIFO Interrupt mask */
152 * SSP Raw Interrupt Status Register - SSP_RIS
154 /* Receive Overrun Raw Interrupt status */
155 #define SSP_RIS_MASK_RORRIS (0x1UL << 0)
156 /* Receive Timeout Raw Interrupt status */
157 #define SSP_RIS_MASK_RTRIS (0x1UL << 1)
158 /* Receive FIFO Raw Interrupt status */
159 #define SSP_RIS_MASK_RXRIS (0x1UL << 2)
160 /* Transmit FIFO Raw Interrupt status */
161 #define SSP_RIS_MASK_TXRIS (0x1UL << 3)
164 * SSP Masked Interrupt Status Register - SSP_MIS
166 /* Receive Overrun Masked Interrupt status */
167 #define SSP_MIS_MASK_RORMIS (0x1UL << 0)
168 /* Receive Timeout Masked Interrupt status */
169 #define SSP_MIS_MASK_RTMIS (0x1UL << 1)
170 /* Receive FIFO Masked Interrupt status */
171 #define SSP_MIS_MASK_RXMIS (0x1UL << 2)
172 /* Transmit FIFO Masked Interrupt status */
173 #define SSP_MIS_MASK_TXMIS (0x1UL << 3)
176 * SSP Interrupt Clear Register - SSP_ICR
178 /* Receive Overrun Raw Clear Interrupt bit */
179 #define SSP_ICR_MASK_RORIC (0x1UL << 0)
180 /* Receive Timeout Clear Interrupt bit */
181 #define SSP_ICR_MASK_RTIC (0x1UL << 1)
184 * SSP DMA Control Register - SSP_DMACR
186 /* Receive DMA Enable bit */
187 #define SSP_DMACR_MASK_RXDMAE (0x1UL << 0)
188 /* Transmit DMA Enable bit */
189 #define SSP_DMACR_MASK_TXDMAE (0x1UL << 1)
192 * SSP Chip Select Control Register - SSP_CSR
195 #define SSP_CSR_CSVALUE_MASK (0x1FUL << 0)
198 * SSP Integration Test control Register - SSP_ITCR
200 #define SSP_ITCR_MASK_ITEN (0x1UL << 0)
201 #define SSP_ITCR_MASK_TESTFIFO (0x1UL << 1)
204 * SSP Integration Test Input Register - SSP_ITIP
206 #define ITIP_MASK_SSPRXD (0x1UL << 0)
207 #define ITIP_MASK_SSPFSSIN (0x1UL << 1)
208 #define ITIP_MASK_SSPCLKIN (0x1UL << 2)
209 #define ITIP_MASK_RXDMAC (0x1UL << 3)
210 #define ITIP_MASK_TXDMAC (0x1UL << 4)
211 #define ITIP_MASK_SSPTXDIN (0x1UL << 5)
214 * SSP Integration Test output Register - SSP_ITOP
216 #define ITOP_MASK_SSPTXD (0x1UL << 0)
217 #define ITOP_MASK_SSPFSSOUT (0x1UL << 1)
218 #define ITOP_MASK_SSPCLKOUT (0x1UL << 2)
219 #define ITOP_MASK_SSPOEn (0x1UL << 3)
220 #define ITOP_MASK_SSPCTLOEn (0x1UL << 4)
221 #define ITOP_MASK_RORINTR (0x1UL << 5)
222 #define ITOP_MASK_RTINTR (0x1UL << 6)
223 #define ITOP_MASK_RXINTR (0x1UL << 7)
224 #define ITOP_MASK_TXINTR (0x1UL << 8)
225 #define ITOP_MASK_INTR (0x1UL << 9)
226 #define ITOP_MASK_RXDMABREQ (0x1UL << 10)
227 #define ITOP_MASK_RXDMASREQ (0x1UL << 11)
228 #define ITOP_MASK_TXDMABREQ (0x1UL << 12)
229 #define ITOP_MASK_TXDMASREQ (0x1UL << 13)
232 * SSP Test Data Register - SSP_TDR
234 #define TDR_MASK_TESTDATA (0xFFFFFFFF)
238 * we use the spi_message.state (void *) pointer to
239 * hold a single state value, that's why all this
240 * (void *) casting is done here.
242 #define STATE_START ((void *) 0)
243 #define STATE_RUNNING ((void *) 1)
244 #define STATE_DONE ((void *) 2)
245 #define STATE_ERROR ((void *) -1)
246 #define STATE_TIMEOUT ((void *) -2)
249 * SSP State - Whether Enabled or Disabled
251 #define SSP_DISABLED (0)
252 #define SSP_ENABLED (1)
255 * SSP DMA State - Whether DMA Enabled or Disabled
257 #define SSP_DMA_DISABLED (0)
258 #define SSP_DMA_ENABLED (1)
263 #define SSP_DEFAULT_CLKRATE 0x2
264 #define SSP_DEFAULT_PRESCALE 0x40
267 * SSP Clock Parameter ranges
269 #define CPSDVR_MIN 0x02
270 #define CPSDVR_MAX 0xFE
275 * SSP Interrupt related Macros
277 #define DEFAULT_SSP_REG_IMSC 0x0UL
278 #define DISABLE_ALL_INTERRUPTS DEFAULT_SSP_REG_IMSC
279 #define ENABLE_ALL_INTERRUPTS ( \
280 SSP_IMSC_MASK_RORIM | \
281 SSP_IMSC_MASK_RTIM | \
282 SSP_IMSC_MASK_RXIM | \
286 #define CLEAR_ALL_INTERRUPTS 0x3
288 #define SPI_POLLING_TIMEOUT 1000
291 * The type of reading going on on this chip
301 * The type of writing going on on this chip
311 * struct vendor_data - vendor-specific config parameters
312 * for PL022 derivates
313 * @fifodepth: depth of FIFOs (both)
314 * @max_bpw: maximum number of bits per word
315 * @unidir: supports unidirection transfers
316 * @extended_cr: 32 bit wide control register 0 with extra
317 * features and extra features in CR1 as found in the ST variants
318 * @pl023: supports a subset of the ST extensions called "PL023"
319 * @loopback: supports loopback mode
320 * @internal_cs_ctrl: supports chip select control register
329 bool internal_cs_ctrl;
333 * struct pl022 - This is the private SSP driver data structure
334 * @adev: AMBA device model hookup
335 * @vendor: vendor data for the IP block
336 * @phybase: the physical memory where the SSP device resides
337 * @virtbase: the virtual memory where the SSP is mapped
338 * @clk: outgoing clock "SPICLK" for the SPI bus
339 * @master: SPI framework hookup
340 * @master_info: controller-specific data from machine setup
341 * @pump_transfers: Tasklet used in Interrupt Transfer mode
342 * @cur_msg: Pointer to current spi_message being processed
343 * @cur_transfer: Pointer to current spi_transfer
344 * @cur_chip: pointer to current clients chip(assigned from controller_state)
345 * @next_msg_cs_active: the next message in the queue has been examined
346 * and it was found that it uses the same chip select as the previous
347 * message, so we left it active after the previous transfer, and it's
349 * @tx: current position in TX buffer to be read
350 * @tx_end: end position in TX buffer to be read
351 * @rx: current position in RX buffer to be written
352 * @rx_end: end position in RX buffer to be written
353 * @read: the type of read currently going on
354 * @write: the type of write currently going on
355 * @exp_fifo_level: expected FIFO level
356 * @rx_lev_trig: receive FIFO watermark level which triggers IRQ
357 * @tx_lev_trig: transmit FIFO watermark level which triggers IRQ
358 * @dma_rx_channel: optional channel for RX DMA
359 * @dma_tx_channel: optional channel for TX DMA
360 * @sgt_rx: scattertable for the RX transfer
361 * @sgt_tx: scattertable for the TX transfer
362 * @dummypage: a dummy page used for driving data on the bus with DMA
363 * @dma_running: indicates whether DMA is in operation
364 * @cur_cs: current chip select index
365 * @cur_gpiod: current chip select GPIO descriptor
368 struct amba_device *adev;
369 struct vendor_data *vendor;
370 resource_size_t phybase;
371 void __iomem *virtbase;
373 struct spi_master *master;
374 struct pl022_ssp_controller *master_info;
375 /* Message per-transfer pump */
376 struct tasklet_struct pump_transfers;
377 struct spi_message *cur_msg;
378 struct spi_transfer *cur_transfer;
379 struct chip_data *cur_chip;
380 bool next_msg_cs_active;
385 enum ssp_reading read;
386 enum ssp_writing write;
388 enum ssp_rx_level_trig rx_lev_trig;
389 enum ssp_tx_level_trig tx_lev_trig;
391 #ifdef CONFIG_DMA_ENGINE
392 struct dma_chan *dma_rx_channel;
393 struct dma_chan *dma_tx_channel;
394 struct sg_table sgt_rx;
395 struct sg_table sgt_tx;
400 struct gpio_desc *cur_gpiod;
404 * struct chip_data - To maintain runtime state of SSP for each client chip
405 * @cr0: Value of control register CR0 of SSP - on later ST variants this
406 * register is 32 bits wide rather than just 16
407 * @cr1: Value of control register CR1 of SSP
408 * @dmacr: Value of DMA control Register of SSP
409 * @cpsr: Value of Clock prescale register
410 * @n_bytes: how many bytes(power of 2) reqd for a given data width of client
411 * @enable_dma: Whether to enable DMA or not
412 * @read: function ptr to be used to read when doing xfer for this chip
413 * @write: function ptr to be used to write when doing xfer for this chip
414 * @xfer_type: polling/interrupt/DMA
416 * Runtime state of the SSP controller, maintained per chip,
417 * This would be set according to the current message that would be served
426 enum ssp_reading read;
427 enum ssp_writing write;
432 * internal_cs_control - Control chip select signals via SSP_CSR.
433 * @pl022: SSP driver private data structure
434 * @command: select/delect the chip
436 * Used on controller with internal chip select control via SSP_CSR register
437 * (vendor extension). Each of the 5 LSB in the register controls one chip
440 static void internal_cs_control(struct pl022 *pl022, u32 command)
444 tmp = readw(SSP_CSR(pl022->virtbase));
445 if (command == SSP_CHIP_SELECT)
446 tmp &= ~BIT(pl022->cur_cs);
448 tmp |= BIT(pl022->cur_cs);
449 writew(tmp, SSP_CSR(pl022->virtbase));
452 static void pl022_cs_control(struct pl022 *pl022, u32 command)
454 if (pl022->vendor->internal_cs_ctrl)
455 internal_cs_control(pl022, command);
456 else if (pl022->cur_gpiod)
458 * This needs to be inverted since with GPIOLIB in
459 * control, the inversion will be handled by
460 * GPIOLIB's active low handling. The "command"
461 * passed into this function will be SSP_CHIP_SELECT
462 * which is enum:ed to 0, so we need the inverse
463 * (1) to activate chip select.
465 gpiod_set_value(pl022->cur_gpiod, !command);
469 * giveback - current spi_message is over, schedule next message and call
470 * callback of this message. Assumes that caller already
471 * set message->status; dma and pio irqs are blocked
472 * @pl022: SSP driver private data structure
474 static void giveback(struct pl022 *pl022)
476 struct spi_transfer *last_transfer;
477 pl022->next_msg_cs_active = false;
479 last_transfer = list_last_entry(&pl022->cur_msg->transfers,
480 struct spi_transfer, transfer_list);
482 /* Delay if requested before any change in chip select */
484 * FIXME: This runs in interrupt context.
485 * Is this really smart?
487 spi_transfer_delay_exec(last_transfer);
489 if (!last_transfer->cs_change) {
490 struct spi_message *next_msg;
493 * cs_change was not set. We can keep the chip select
494 * enabled if there is message in the queue and it is
495 * for the same spi device.
497 * We cannot postpone this until pump_messages, because
498 * after calling msg->complete (below) the driver that
499 * sent the current message could be unloaded, which
500 * could invalidate the cs_control() callback...
502 /* get a pointer to the next message, if any */
503 next_msg = spi_get_next_queued_message(pl022->master);
506 * see if the next and current messages point
507 * to the same spi device.
509 if (next_msg && next_msg->spi != pl022->cur_msg->spi)
511 if (!next_msg || pl022->cur_msg->state == STATE_ERROR)
512 pl022_cs_control(pl022, SSP_CHIP_DESELECT);
514 pl022->next_msg_cs_active = true;
518 pl022->cur_msg = NULL;
519 pl022->cur_transfer = NULL;
520 pl022->cur_chip = NULL;
522 /* disable the SPI/SSP operation */
523 writew((readw(SSP_CR1(pl022->virtbase)) &
524 (~SSP_CR1_MASK_SSE)), SSP_CR1(pl022->virtbase));
526 spi_finalize_current_message(pl022->master);
530 * flush - flush the FIFO to reach a clean state
531 * @pl022: SSP driver private data structure
533 static int flush(struct pl022 *pl022)
535 unsigned long limit = loops_per_jiffy << 1;
537 dev_dbg(&pl022->adev->dev, "flush\n");
539 while (readw(SSP_SR(pl022->virtbase)) & SSP_SR_MASK_RNE)
540 readw(SSP_DR(pl022->virtbase));
541 } while ((readw(SSP_SR(pl022->virtbase)) & SSP_SR_MASK_BSY) && limit--);
543 pl022->exp_fifo_level = 0;
549 * restore_state - Load configuration of current chip
550 * @pl022: SSP driver private data structure
552 static void restore_state(struct pl022 *pl022)
554 struct chip_data *chip = pl022->cur_chip;
556 if (pl022->vendor->extended_cr)
557 writel(chip->cr0, SSP_CR0(pl022->virtbase));
559 writew(chip->cr0, SSP_CR0(pl022->virtbase));
560 writew(chip->cr1, SSP_CR1(pl022->virtbase));
561 writew(chip->dmacr, SSP_DMACR(pl022->virtbase));
562 writew(chip->cpsr, SSP_CPSR(pl022->virtbase));
563 writew(DISABLE_ALL_INTERRUPTS, SSP_IMSC(pl022->virtbase));
564 writew(CLEAR_ALL_INTERRUPTS, SSP_ICR(pl022->virtbase));
568 * Default SSP Register Values
570 #define DEFAULT_SSP_REG_CR0 ( \
571 GEN_MASK_BITS(SSP_DATA_BITS_12, SSP_CR0_MASK_DSS, 0) | \
572 GEN_MASK_BITS(SSP_INTERFACE_MOTOROLA_SPI, SSP_CR0_MASK_FRF, 4) | \
573 GEN_MASK_BITS(SSP_CLK_POL_IDLE_LOW, SSP_CR0_MASK_SPO, 6) | \
574 GEN_MASK_BITS(SSP_CLK_SECOND_EDGE, SSP_CR0_MASK_SPH, 7) | \
575 GEN_MASK_BITS(SSP_DEFAULT_CLKRATE, SSP_CR0_MASK_SCR, 8) \
578 /* ST versions have slightly different bit layout */
579 #define DEFAULT_SSP_REG_CR0_ST ( \
580 GEN_MASK_BITS(SSP_DATA_BITS_12, SSP_CR0_MASK_DSS_ST, 0) | \
581 GEN_MASK_BITS(SSP_MICROWIRE_CHANNEL_FULL_DUPLEX, SSP_CR0_MASK_HALFDUP_ST, 5) | \
582 GEN_MASK_BITS(SSP_CLK_POL_IDLE_LOW, SSP_CR0_MASK_SPO, 6) | \
583 GEN_MASK_BITS(SSP_CLK_SECOND_EDGE, SSP_CR0_MASK_SPH, 7) | \
584 GEN_MASK_BITS(SSP_DEFAULT_CLKRATE, SSP_CR0_MASK_SCR, 8) | \
585 GEN_MASK_BITS(SSP_BITS_8, SSP_CR0_MASK_CSS_ST, 16) | \
586 GEN_MASK_BITS(SSP_INTERFACE_MOTOROLA_SPI, SSP_CR0_MASK_FRF_ST, 21) \
589 /* The PL023 version is slightly different again */
590 #define DEFAULT_SSP_REG_CR0_ST_PL023 ( \
591 GEN_MASK_BITS(SSP_DATA_BITS_12, SSP_CR0_MASK_DSS_ST, 0) | \
592 GEN_MASK_BITS(SSP_CLK_POL_IDLE_LOW, SSP_CR0_MASK_SPO, 6) | \
593 GEN_MASK_BITS(SSP_CLK_SECOND_EDGE, SSP_CR0_MASK_SPH, 7) | \
594 GEN_MASK_BITS(SSP_DEFAULT_CLKRATE, SSP_CR0_MASK_SCR, 8) \
597 #define DEFAULT_SSP_REG_CR1 ( \
598 GEN_MASK_BITS(LOOPBACK_DISABLED, SSP_CR1_MASK_LBM, 0) | \
599 GEN_MASK_BITS(SSP_DISABLED, SSP_CR1_MASK_SSE, 1) | \
600 GEN_MASK_BITS(SSP_MASTER, SSP_CR1_MASK_MS, 2) | \
601 GEN_MASK_BITS(DO_NOT_DRIVE_TX, SSP_CR1_MASK_SOD, 3) \
604 /* ST versions extend this register to use all 16 bits */
605 #define DEFAULT_SSP_REG_CR1_ST ( \
606 DEFAULT_SSP_REG_CR1 | \
607 GEN_MASK_BITS(SSP_RX_MSB, SSP_CR1_MASK_RENDN_ST, 4) | \
608 GEN_MASK_BITS(SSP_TX_MSB, SSP_CR1_MASK_TENDN_ST, 5) | \
609 GEN_MASK_BITS(SSP_MWIRE_WAIT_ZERO, SSP_CR1_MASK_MWAIT_ST, 6) |\
610 GEN_MASK_BITS(SSP_RX_1_OR_MORE_ELEM, SSP_CR1_MASK_RXIFLSEL_ST, 7) | \
611 GEN_MASK_BITS(SSP_TX_1_OR_MORE_EMPTY_LOC, SSP_CR1_MASK_TXIFLSEL_ST, 10) \
615 * The PL023 variant has further differences: no loopback mode, no microwire
616 * support, and a new clock feedback delay setting.
618 #define DEFAULT_SSP_REG_CR1_ST_PL023 ( \
619 GEN_MASK_BITS(SSP_DISABLED, SSP_CR1_MASK_SSE, 1) | \
620 GEN_MASK_BITS(SSP_MASTER, SSP_CR1_MASK_MS, 2) | \
621 GEN_MASK_BITS(DO_NOT_DRIVE_TX, SSP_CR1_MASK_SOD, 3) | \
622 GEN_MASK_BITS(SSP_RX_MSB, SSP_CR1_MASK_RENDN_ST, 4) | \
623 GEN_MASK_BITS(SSP_TX_MSB, SSP_CR1_MASK_TENDN_ST, 5) | \
624 GEN_MASK_BITS(SSP_RX_1_OR_MORE_ELEM, SSP_CR1_MASK_RXIFLSEL_ST, 7) | \
625 GEN_MASK_BITS(SSP_TX_1_OR_MORE_EMPTY_LOC, SSP_CR1_MASK_TXIFLSEL_ST, 10) | \
626 GEN_MASK_BITS(SSP_FEEDBACK_CLK_DELAY_NONE, SSP_CR1_MASK_FBCLKDEL_ST, 13) \
629 #define DEFAULT_SSP_REG_CPSR ( \
630 GEN_MASK_BITS(SSP_DEFAULT_PRESCALE, SSP_CPSR_MASK_CPSDVSR, 0) \
633 #define DEFAULT_SSP_REG_DMACR (\
634 GEN_MASK_BITS(SSP_DMA_DISABLED, SSP_DMACR_MASK_RXDMAE, 0) | \
635 GEN_MASK_BITS(SSP_DMA_DISABLED, SSP_DMACR_MASK_TXDMAE, 1) \
639 * load_ssp_default_config - Load default configuration for SSP
640 * @pl022: SSP driver private data structure
642 static void load_ssp_default_config(struct pl022 *pl022)
644 if (pl022->vendor->pl023) {
645 writel(DEFAULT_SSP_REG_CR0_ST_PL023, SSP_CR0(pl022->virtbase));
646 writew(DEFAULT_SSP_REG_CR1_ST_PL023, SSP_CR1(pl022->virtbase));
647 } else if (pl022->vendor->extended_cr) {
648 writel(DEFAULT_SSP_REG_CR0_ST, SSP_CR0(pl022->virtbase));
649 writew(DEFAULT_SSP_REG_CR1_ST, SSP_CR1(pl022->virtbase));
651 writew(DEFAULT_SSP_REG_CR0, SSP_CR0(pl022->virtbase));
652 writew(DEFAULT_SSP_REG_CR1, SSP_CR1(pl022->virtbase));
654 writew(DEFAULT_SSP_REG_DMACR, SSP_DMACR(pl022->virtbase));
655 writew(DEFAULT_SSP_REG_CPSR, SSP_CPSR(pl022->virtbase));
656 writew(DISABLE_ALL_INTERRUPTS, SSP_IMSC(pl022->virtbase));
657 writew(CLEAR_ALL_INTERRUPTS, SSP_ICR(pl022->virtbase));
661 * This will write to TX and read from RX according to the parameters
664 static void readwriter(struct pl022 *pl022)
668 * The FIFO depth is different between primecell variants.
669 * I believe filling in too much in the FIFO might cause
670 * errons in 8bit wide transfers on ARM variants (just 8 words
671 * FIFO, means only 8x8 = 64 bits in FIFO) at least.
673 * To prevent this issue, the TX FIFO is only filled to the
674 * unused RX FIFO fill length, regardless of what the TX
675 * FIFO status flag indicates.
677 dev_dbg(&pl022->adev->dev,
678 "%s, rx: %p, rxend: %p, tx: %p, txend: %p\n",
679 __func__, pl022->rx, pl022->rx_end, pl022->tx, pl022->tx_end);
681 /* Read as much as you can */
682 while ((readw(SSP_SR(pl022->virtbase)) & SSP_SR_MASK_RNE)
683 && (pl022->rx < pl022->rx_end)) {
684 switch (pl022->read) {
686 readw(SSP_DR(pl022->virtbase));
689 *(u8 *) (pl022->rx) =
690 readw(SSP_DR(pl022->virtbase)) & 0xFFU;
693 *(u16 *) (pl022->rx) =
694 (u16) readw(SSP_DR(pl022->virtbase));
697 *(u32 *) (pl022->rx) =
698 readl(SSP_DR(pl022->virtbase));
701 pl022->rx += (pl022->cur_chip->n_bytes);
702 pl022->exp_fifo_level--;
705 * Write as much as possible up to the RX FIFO size
707 while ((pl022->exp_fifo_level < pl022->vendor->fifodepth)
708 && (pl022->tx < pl022->tx_end)) {
709 switch (pl022->write) {
711 writew(0x0, SSP_DR(pl022->virtbase));
714 writew(*(u8 *) (pl022->tx), SSP_DR(pl022->virtbase));
717 writew((*(u16 *) (pl022->tx)), SSP_DR(pl022->virtbase));
720 writel(*(u32 *) (pl022->tx), SSP_DR(pl022->virtbase));
723 pl022->tx += (pl022->cur_chip->n_bytes);
724 pl022->exp_fifo_level++;
726 * This inner reader takes care of things appearing in the RX
727 * FIFO as we're transmitting. This will happen a lot since the
728 * clock starts running when you put things into the TX FIFO,
729 * and then things are continuously clocked into the RX FIFO.
731 while ((readw(SSP_SR(pl022->virtbase)) & SSP_SR_MASK_RNE)
732 && (pl022->rx < pl022->rx_end)) {
733 switch (pl022->read) {
735 readw(SSP_DR(pl022->virtbase));
738 *(u8 *) (pl022->rx) =
739 readw(SSP_DR(pl022->virtbase)) & 0xFFU;
742 *(u16 *) (pl022->rx) =
743 (u16) readw(SSP_DR(pl022->virtbase));
746 *(u32 *) (pl022->rx) =
747 readl(SSP_DR(pl022->virtbase));
750 pl022->rx += (pl022->cur_chip->n_bytes);
751 pl022->exp_fifo_level--;
755 * When we exit here the TX FIFO should be full and the RX FIFO
761 * next_transfer - Move to the Next transfer in the current spi message
762 * @pl022: SSP driver private data structure
764 * This function moves though the linked list of spi transfers in the
765 * current spi message and returns with the state of current spi
766 * message i.e whether its last transfer is done(STATE_DONE) or
767 * Next transfer is ready(STATE_RUNNING)
769 static void *next_transfer(struct pl022 *pl022)
771 struct spi_message *msg = pl022->cur_msg;
772 struct spi_transfer *trans = pl022->cur_transfer;
774 /* Move to next transfer */
775 if (trans->transfer_list.next != &msg->transfers) {
776 pl022->cur_transfer =
777 list_entry(trans->transfer_list.next,
778 struct spi_transfer, transfer_list);
779 return STATE_RUNNING;
785 * This DMA functionality is only compiled in if we have
786 * access to the generic DMA devices/DMA engine.
788 #ifdef CONFIG_DMA_ENGINE
789 static void unmap_free_dma_scatter(struct pl022 *pl022)
791 /* Unmap and free the SG tables */
792 dma_unmap_sg(pl022->dma_tx_channel->device->dev, pl022->sgt_tx.sgl,
793 pl022->sgt_tx.nents, DMA_TO_DEVICE);
794 dma_unmap_sg(pl022->dma_rx_channel->device->dev, pl022->sgt_rx.sgl,
795 pl022->sgt_rx.nents, DMA_FROM_DEVICE);
796 sg_free_table(&pl022->sgt_rx);
797 sg_free_table(&pl022->sgt_tx);
800 static void dma_callback(void *data)
802 struct pl022 *pl022 = data;
803 struct spi_message *msg = pl022->cur_msg;
805 BUG_ON(!pl022->sgt_rx.sgl);
809 * Optionally dump out buffers to inspect contents, this is
810 * good if you want to convince yourself that the loopback
811 * read/write contents are the same, when adopting to a new
815 struct scatterlist *sg;
818 dma_sync_sg_for_cpu(&pl022->adev->dev,
823 for_each_sg(pl022->sgt_rx.sgl, sg, pl022->sgt_rx.nents, i) {
824 dev_dbg(&pl022->adev->dev, "SPI RX SG ENTRY: %d", i);
825 print_hex_dump(KERN_ERR, "SPI RX: ",
833 for_each_sg(pl022->sgt_tx.sgl, sg, pl022->sgt_tx.nents, i) {
834 dev_dbg(&pl022->adev->dev, "SPI TX SG ENTRY: %d", i);
835 print_hex_dump(KERN_ERR, "SPI TX: ",
846 unmap_free_dma_scatter(pl022);
848 /* Update total bytes transferred */
849 msg->actual_length += pl022->cur_transfer->len;
850 /* Move to next transfer */
851 msg->state = next_transfer(pl022);
852 if (msg->state != STATE_DONE && pl022->cur_transfer->cs_change)
853 pl022_cs_control(pl022, SSP_CHIP_DESELECT);
854 tasklet_schedule(&pl022->pump_transfers);
857 static void setup_dma_scatter(struct pl022 *pl022,
860 struct sg_table *sgtab)
862 struct scatterlist *sg;
863 int bytesleft = length;
869 for_each_sg(sgtab->sgl, sg, sgtab->nents, i) {
871 * If there are less bytes left than what fits
872 * in the current page (plus page alignment offset)
873 * we just feed in this, else we stuff in as much
876 if (bytesleft < (PAGE_SIZE - offset_in_page(bufp)))
877 mapbytes = bytesleft;
879 mapbytes = PAGE_SIZE - offset_in_page(bufp);
880 sg_set_page(sg, virt_to_page(bufp),
881 mapbytes, offset_in_page(bufp));
883 bytesleft -= mapbytes;
884 dev_dbg(&pl022->adev->dev,
885 "set RX/TX target page @ %p, %d bytes, %d left\n",
886 bufp, mapbytes, bytesleft);
889 /* Map the dummy buffer on every page */
890 for_each_sg(sgtab->sgl, sg, sgtab->nents, i) {
891 if (bytesleft < PAGE_SIZE)
892 mapbytes = bytesleft;
894 mapbytes = PAGE_SIZE;
895 sg_set_page(sg, virt_to_page(pl022->dummypage),
897 bytesleft -= mapbytes;
898 dev_dbg(&pl022->adev->dev,
899 "set RX/TX to dummy page %d bytes, %d left\n",
900 mapbytes, bytesleft);
908 * configure_dma - configures the channels for the next transfer
909 * @pl022: SSP driver's private data structure
911 static int configure_dma(struct pl022 *pl022)
913 struct dma_slave_config rx_conf = {
914 .src_addr = SSP_DR(pl022->phybase),
915 .direction = DMA_DEV_TO_MEM,
918 struct dma_slave_config tx_conf = {
919 .dst_addr = SSP_DR(pl022->phybase),
920 .direction = DMA_MEM_TO_DEV,
925 int rx_sglen, tx_sglen;
926 struct dma_chan *rxchan = pl022->dma_rx_channel;
927 struct dma_chan *txchan = pl022->dma_tx_channel;
928 struct dma_async_tx_descriptor *rxdesc;
929 struct dma_async_tx_descriptor *txdesc;
931 /* Check that the channels are available */
932 if (!rxchan || !txchan)
936 * If supplied, the DMA burstsize should equal the FIFO trigger level.
937 * Notice that the DMA engine uses one-to-one mapping. Since we can
938 * not trigger on 2 elements this needs explicit mapping rather than
941 switch (pl022->rx_lev_trig) {
942 case SSP_RX_1_OR_MORE_ELEM:
943 rx_conf.src_maxburst = 1;
945 case SSP_RX_4_OR_MORE_ELEM:
946 rx_conf.src_maxburst = 4;
948 case SSP_RX_8_OR_MORE_ELEM:
949 rx_conf.src_maxburst = 8;
951 case SSP_RX_16_OR_MORE_ELEM:
952 rx_conf.src_maxburst = 16;
954 case SSP_RX_32_OR_MORE_ELEM:
955 rx_conf.src_maxburst = 32;
958 rx_conf.src_maxburst = pl022->vendor->fifodepth >> 1;
962 switch (pl022->tx_lev_trig) {
963 case SSP_TX_1_OR_MORE_EMPTY_LOC:
964 tx_conf.dst_maxburst = 1;
966 case SSP_TX_4_OR_MORE_EMPTY_LOC:
967 tx_conf.dst_maxburst = 4;
969 case SSP_TX_8_OR_MORE_EMPTY_LOC:
970 tx_conf.dst_maxburst = 8;
972 case SSP_TX_16_OR_MORE_EMPTY_LOC:
973 tx_conf.dst_maxburst = 16;
975 case SSP_TX_32_OR_MORE_EMPTY_LOC:
976 tx_conf.dst_maxburst = 32;
979 tx_conf.dst_maxburst = pl022->vendor->fifodepth >> 1;
983 switch (pl022->read) {
985 /* Use the same as for writing */
986 rx_conf.src_addr_width = DMA_SLAVE_BUSWIDTH_UNDEFINED;
989 rx_conf.src_addr_width = DMA_SLAVE_BUSWIDTH_1_BYTE;
992 rx_conf.src_addr_width = DMA_SLAVE_BUSWIDTH_2_BYTES;
995 rx_conf.src_addr_width = DMA_SLAVE_BUSWIDTH_4_BYTES;
999 switch (pl022->write) {
1001 /* Use the same as for reading */
1002 tx_conf.dst_addr_width = DMA_SLAVE_BUSWIDTH_UNDEFINED;
1005 tx_conf.dst_addr_width = DMA_SLAVE_BUSWIDTH_1_BYTE;
1008 tx_conf.dst_addr_width = DMA_SLAVE_BUSWIDTH_2_BYTES;
1011 tx_conf.dst_addr_width = DMA_SLAVE_BUSWIDTH_4_BYTES;
1015 /* SPI pecularity: we need to read and write the same width */
1016 if (rx_conf.src_addr_width == DMA_SLAVE_BUSWIDTH_UNDEFINED)
1017 rx_conf.src_addr_width = tx_conf.dst_addr_width;
1018 if (tx_conf.dst_addr_width == DMA_SLAVE_BUSWIDTH_UNDEFINED)
1019 tx_conf.dst_addr_width = rx_conf.src_addr_width;
1020 BUG_ON(rx_conf.src_addr_width != tx_conf.dst_addr_width);
1022 dmaengine_slave_config(rxchan, &rx_conf);
1023 dmaengine_slave_config(txchan, &tx_conf);
1025 /* Create sglists for the transfers */
1026 pages = DIV_ROUND_UP(pl022->cur_transfer->len, PAGE_SIZE);
1027 dev_dbg(&pl022->adev->dev, "using %d pages for transfer\n", pages);
1029 ret = sg_alloc_table(&pl022->sgt_rx, pages, GFP_ATOMIC);
1031 goto err_alloc_rx_sg;
1033 ret = sg_alloc_table(&pl022->sgt_tx, pages, GFP_ATOMIC);
1035 goto err_alloc_tx_sg;
1037 /* Fill in the scatterlists for the RX+TX buffers */
1038 setup_dma_scatter(pl022, pl022->rx,
1039 pl022->cur_transfer->len, &pl022->sgt_rx);
1040 setup_dma_scatter(pl022, pl022->tx,
1041 pl022->cur_transfer->len, &pl022->sgt_tx);
1043 /* Map DMA buffers */
1044 rx_sglen = dma_map_sg(rxchan->device->dev, pl022->sgt_rx.sgl,
1045 pl022->sgt_rx.nents, DMA_FROM_DEVICE);
1049 tx_sglen = dma_map_sg(txchan->device->dev, pl022->sgt_tx.sgl,
1050 pl022->sgt_tx.nents, DMA_TO_DEVICE);
1054 /* Send both scatterlists */
1055 rxdesc = dmaengine_prep_slave_sg(rxchan,
1059 DMA_PREP_INTERRUPT | DMA_CTRL_ACK);
1063 txdesc = dmaengine_prep_slave_sg(txchan,
1067 DMA_PREP_INTERRUPT | DMA_CTRL_ACK);
1071 /* Put the callback on the RX transfer only, that should finish last */
1072 rxdesc->callback = dma_callback;
1073 rxdesc->callback_param = pl022;
1075 /* Submit and fire RX and TX with TX last so we're ready to read! */
1076 dmaengine_submit(rxdesc);
1077 dmaengine_submit(txdesc);
1078 dma_async_issue_pending(rxchan);
1079 dma_async_issue_pending(txchan);
1080 pl022->dma_running = true;
1085 dmaengine_terminate_all(txchan);
1087 dmaengine_terminate_all(rxchan);
1088 dma_unmap_sg(txchan->device->dev, pl022->sgt_tx.sgl,
1089 pl022->sgt_tx.nents, DMA_TO_DEVICE);
1091 dma_unmap_sg(rxchan->device->dev, pl022->sgt_rx.sgl,
1092 pl022->sgt_rx.nents, DMA_FROM_DEVICE);
1094 sg_free_table(&pl022->sgt_tx);
1096 sg_free_table(&pl022->sgt_rx);
1101 static int pl022_dma_probe(struct pl022 *pl022)
1103 dma_cap_mask_t mask;
1105 /* Try to acquire a generic DMA engine slave channel */
1107 dma_cap_set(DMA_SLAVE, mask);
1109 * We need both RX and TX channels to do DMA, else do none
1112 pl022->dma_rx_channel = dma_request_channel(mask,
1113 pl022->master_info->dma_filter,
1114 pl022->master_info->dma_rx_param);
1115 if (!pl022->dma_rx_channel) {
1116 dev_dbg(&pl022->adev->dev, "no RX DMA channel!\n");
1120 pl022->dma_tx_channel = dma_request_channel(mask,
1121 pl022->master_info->dma_filter,
1122 pl022->master_info->dma_tx_param);
1123 if (!pl022->dma_tx_channel) {
1124 dev_dbg(&pl022->adev->dev, "no TX DMA channel!\n");
1128 pl022->dummypage = kmalloc(PAGE_SIZE, GFP_KERNEL);
1129 if (!pl022->dummypage)
1130 goto err_no_dummypage;
1132 dev_info(&pl022->adev->dev, "setup for DMA on RX %s, TX %s\n",
1133 dma_chan_name(pl022->dma_rx_channel),
1134 dma_chan_name(pl022->dma_tx_channel));
1139 dma_release_channel(pl022->dma_tx_channel);
1141 dma_release_channel(pl022->dma_rx_channel);
1142 pl022->dma_rx_channel = NULL;
1144 dev_err(&pl022->adev->dev,
1145 "Failed to work in dma mode, work without dma!\n");
1149 static int pl022_dma_autoprobe(struct pl022 *pl022)
1151 struct device *dev = &pl022->adev->dev;
1152 struct dma_chan *chan;
1155 /* automatically configure DMA channels from platform, normally using DT */
1156 chan = dma_request_chan(dev, "rx");
1158 err = PTR_ERR(chan);
1162 pl022->dma_rx_channel = chan;
1164 chan = dma_request_chan(dev, "tx");
1166 err = PTR_ERR(chan);
1170 pl022->dma_tx_channel = chan;
1172 pl022->dummypage = kmalloc(PAGE_SIZE, GFP_KERNEL);
1173 if (!pl022->dummypage) {
1175 goto err_no_dummypage;
1181 dma_release_channel(pl022->dma_tx_channel);
1182 pl022->dma_tx_channel = NULL;
1184 dma_release_channel(pl022->dma_rx_channel);
1185 pl022->dma_rx_channel = NULL;
1190 static void terminate_dma(struct pl022 *pl022)
1192 struct dma_chan *rxchan = pl022->dma_rx_channel;
1193 struct dma_chan *txchan = pl022->dma_tx_channel;
1195 dmaengine_terminate_all(rxchan);
1196 dmaengine_terminate_all(txchan);
1197 unmap_free_dma_scatter(pl022);
1198 pl022->dma_running = false;
1201 static void pl022_dma_remove(struct pl022 *pl022)
1203 if (pl022->dma_running)
1204 terminate_dma(pl022);
1205 if (pl022->dma_tx_channel)
1206 dma_release_channel(pl022->dma_tx_channel);
1207 if (pl022->dma_rx_channel)
1208 dma_release_channel(pl022->dma_rx_channel);
1209 kfree(pl022->dummypage);
1213 static inline int configure_dma(struct pl022 *pl022)
1218 static inline int pl022_dma_autoprobe(struct pl022 *pl022)
1223 static inline int pl022_dma_probe(struct pl022 *pl022)
1228 static inline void pl022_dma_remove(struct pl022 *pl022)
1234 * pl022_interrupt_handler - Interrupt handler for SSP controller
1236 * @dev_id: Local device data
1238 * This function handles interrupts generated for an interrupt based transfer.
1239 * If a receive overrun (ROR) interrupt is there then we disable SSP, flag the
1240 * current message's state as STATE_ERROR and schedule the tasklet
1241 * pump_transfers which will do the postprocessing of the current message by
1242 * calling giveback(). Otherwise it reads data from RX FIFO till there is no
1243 * more data, and writes data in TX FIFO till it is not full. If we complete
1244 * the transfer we move to the next transfer and schedule the tasklet.
1246 static irqreturn_t pl022_interrupt_handler(int irq, void *dev_id)
1248 struct pl022 *pl022 = dev_id;
1249 struct spi_message *msg = pl022->cur_msg;
1252 if (unlikely(!msg)) {
1253 dev_err(&pl022->adev->dev,
1254 "bad message state in interrupt handler");
1259 /* Read the Interrupt Status Register */
1260 irq_status = readw(SSP_MIS(pl022->virtbase));
1262 if (unlikely(!irq_status))
1266 * This handles the FIFO interrupts, the timeout
1267 * interrupts are flatly ignored, they cannot be
1270 if (unlikely(irq_status & SSP_MIS_MASK_RORMIS)) {
1272 * Overrun interrupt - bail out since our Data has been
1275 dev_err(&pl022->adev->dev, "FIFO overrun\n");
1276 if (readw(SSP_SR(pl022->virtbase)) & SSP_SR_MASK_RFF)
1277 dev_err(&pl022->adev->dev,
1278 "RXFIFO is full\n");
1281 * Disable and clear interrupts, disable SSP,
1282 * mark message with bad status so it can be
1285 writew(DISABLE_ALL_INTERRUPTS,
1286 SSP_IMSC(pl022->virtbase));
1287 writew(CLEAR_ALL_INTERRUPTS, SSP_ICR(pl022->virtbase));
1288 writew((readw(SSP_CR1(pl022->virtbase)) &
1289 (~SSP_CR1_MASK_SSE)), SSP_CR1(pl022->virtbase));
1290 msg->state = STATE_ERROR;
1292 /* Schedule message queue handler */
1293 tasklet_schedule(&pl022->pump_transfers);
1299 if (pl022->tx == pl022->tx_end) {
1300 /* Disable Transmit interrupt, enable receive interrupt */
1301 writew((readw(SSP_IMSC(pl022->virtbase)) &
1302 ~SSP_IMSC_MASK_TXIM) | SSP_IMSC_MASK_RXIM,
1303 SSP_IMSC(pl022->virtbase));
1307 * Since all transactions must write as much as shall be read,
1308 * we can conclude the entire transaction once RX is complete.
1309 * At this point, all TX will always be finished.
1311 if (pl022->rx >= pl022->rx_end) {
1312 writew(DISABLE_ALL_INTERRUPTS,
1313 SSP_IMSC(pl022->virtbase));
1314 writew(CLEAR_ALL_INTERRUPTS, SSP_ICR(pl022->virtbase));
1315 if (unlikely(pl022->rx > pl022->rx_end)) {
1316 dev_warn(&pl022->adev->dev, "read %u surplus "
1317 "bytes (did you request an odd "
1318 "number of bytes on a 16bit bus?)\n",
1319 (u32) (pl022->rx - pl022->rx_end));
1321 /* Update total bytes transferred */
1322 msg->actual_length += pl022->cur_transfer->len;
1323 /* Move to next transfer */
1324 msg->state = next_transfer(pl022);
1325 if (msg->state != STATE_DONE && pl022->cur_transfer->cs_change)
1326 pl022_cs_control(pl022, SSP_CHIP_DESELECT);
1327 tasklet_schedule(&pl022->pump_transfers);
1335 * This sets up the pointers to memory for the next message to
1336 * send out on the SPI bus.
1338 static int set_up_next_transfer(struct pl022 *pl022,
1339 struct spi_transfer *transfer)
1343 /* Sanity check the message for this bus width */
1344 residue = pl022->cur_transfer->len % pl022->cur_chip->n_bytes;
1345 if (unlikely(residue != 0)) {
1346 dev_err(&pl022->adev->dev,
1347 "message of %u bytes to transmit but the current "
1348 "chip bus has a data width of %u bytes!\n",
1349 pl022->cur_transfer->len,
1350 pl022->cur_chip->n_bytes);
1351 dev_err(&pl022->adev->dev, "skipping this message\n");
1354 pl022->tx = (void *)transfer->tx_buf;
1355 pl022->tx_end = pl022->tx + pl022->cur_transfer->len;
1356 pl022->rx = (void *)transfer->rx_buf;
1357 pl022->rx_end = pl022->rx + pl022->cur_transfer->len;
1359 pl022->tx ? pl022->cur_chip->write : WRITING_NULL;
1360 pl022->read = pl022->rx ? pl022->cur_chip->read : READING_NULL;
1365 * pump_transfers - Tasklet function which schedules next transfer
1366 * when running in interrupt or DMA transfer mode.
1367 * @data: SSP driver private data structure
1370 static void pump_transfers(unsigned long data)
1372 struct pl022 *pl022 = (struct pl022 *) data;
1373 struct spi_message *message = NULL;
1374 struct spi_transfer *transfer = NULL;
1375 struct spi_transfer *previous = NULL;
1377 /* Get current state information */
1378 message = pl022->cur_msg;
1379 transfer = pl022->cur_transfer;
1381 /* Handle for abort */
1382 if (message->state == STATE_ERROR) {
1383 message->status = -EIO;
1388 /* Handle end of message */
1389 if (message->state == STATE_DONE) {
1390 message->status = 0;
1395 /* Delay if requested at end of transfer before CS change */
1396 if (message->state == STATE_RUNNING) {
1397 previous = list_entry(transfer->transfer_list.prev,
1398 struct spi_transfer,
1401 * FIXME: This runs in interrupt context.
1402 * Is this really smart?
1404 spi_transfer_delay_exec(previous);
1406 /* Reselect chip select only if cs_change was requested */
1407 if (previous->cs_change)
1408 pl022_cs_control(pl022, SSP_CHIP_SELECT);
1411 message->state = STATE_RUNNING;
1414 if (set_up_next_transfer(pl022, transfer)) {
1415 message->state = STATE_ERROR;
1416 message->status = -EIO;
1420 /* Flush the FIFOs and let's go! */
1423 if (pl022->cur_chip->enable_dma) {
1424 if (configure_dma(pl022)) {
1425 dev_dbg(&pl022->adev->dev,
1426 "configuration of DMA failed, fall back to interrupt mode\n");
1427 goto err_config_dma;
1433 /* enable all interrupts except RX */
1434 writew(ENABLE_ALL_INTERRUPTS & ~SSP_IMSC_MASK_RXIM, SSP_IMSC(pl022->virtbase));
1437 static void do_interrupt_dma_transfer(struct pl022 *pl022)
1440 * Default is to enable all interrupts except RX -
1441 * this will be enabled once TX is complete
1443 u32 irqflags = (u32)(ENABLE_ALL_INTERRUPTS & ~SSP_IMSC_MASK_RXIM);
1445 /* Enable target chip, if not already active */
1446 if (!pl022->next_msg_cs_active)
1447 pl022_cs_control(pl022, SSP_CHIP_SELECT);
1449 if (set_up_next_transfer(pl022, pl022->cur_transfer)) {
1451 pl022->cur_msg->state = STATE_ERROR;
1452 pl022->cur_msg->status = -EIO;
1456 /* If we're using DMA, set up DMA here */
1457 if (pl022->cur_chip->enable_dma) {
1458 /* Configure DMA transfer */
1459 if (configure_dma(pl022)) {
1460 dev_dbg(&pl022->adev->dev,
1461 "configuration of DMA failed, fall back to interrupt mode\n");
1462 goto err_config_dma;
1464 /* Disable interrupts in DMA mode, IRQ from DMA controller */
1465 irqflags = DISABLE_ALL_INTERRUPTS;
1468 /* Enable SSP, turn on interrupts */
1469 writew((readw(SSP_CR1(pl022->virtbase)) | SSP_CR1_MASK_SSE),
1470 SSP_CR1(pl022->virtbase));
1471 writew(irqflags, SSP_IMSC(pl022->virtbase));
1474 static void print_current_status(struct pl022 *pl022)
1477 u16 read_cr1, read_dmacr, read_sr;
1479 if (pl022->vendor->extended_cr)
1480 read_cr0 = readl(SSP_CR0(pl022->virtbase));
1482 read_cr0 = readw(SSP_CR0(pl022->virtbase));
1483 read_cr1 = readw(SSP_CR1(pl022->virtbase));
1484 read_dmacr = readw(SSP_DMACR(pl022->virtbase));
1485 read_sr = readw(SSP_SR(pl022->virtbase));
1487 dev_warn(&pl022->adev->dev, "spi-pl022 CR0: %x\n", read_cr0);
1488 dev_warn(&pl022->adev->dev, "spi-pl022 CR1: %x\n", read_cr1);
1489 dev_warn(&pl022->adev->dev, "spi-pl022 DMACR: %x\n", read_dmacr);
1490 dev_warn(&pl022->adev->dev, "spi-pl022 SR: %x\n", read_sr);
1491 dev_warn(&pl022->adev->dev,
1492 "spi-pl022 exp_fifo_level/fifodepth: %u/%d\n",
1493 pl022->exp_fifo_level,
1494 pl022->vendor->fifodepth);
1498 static void do_polling_transfer(struct pl022 *pl022)
1500 struct spi_message *message = NULL;
1501 struct spi_transfer *transfer = NULL;
1502 struct spi_transfer *previous = NULL;
1503 unsigned long time, timeout;
1505 message = pl022->cur_msg;
1507 while (message->state != STATE_DONE) {
1508 /* Handle for abort */
1509 if (message->state == STATE_ERROR)
1511 transfer = pl022->cur_transfer;
1513 /* Delay if requested at end of transfer */
1514 if (message->state == STATE_RUNNING) {
1516 list_entry(transfer->transfer_list.prev,
1517 struct spi_transfer, transfer_list);
1518 spi_transfer_delay_exec(previous);
1519 if (previous->cs_change)
1520 pl022_cs_control(pl022, SSP_CHIP_SELECT);
1523 message->state = STATE_RUNNING;
1524 if (!pl022->next_msg_cs_active)
1525 pl022_cs_control(pl022, SSP_CHIP_SELECT);
1528 /* Configuration Changing Per Transfer */
1529 if (set_up_next_transfer(pl022, transfer)) {
1531 message->state = STATE_ERROR;
1534 /* Flush FIFOs and enable SSP */
1536 writew((readw(SSP_CR1(pl022->virtbase)) | SSP_CR1_MASK_SSE),
1537 SSP_CR1(pl022->virtbase));
1539 dev_dbg(&pl022->adev->dev, "polling transfer ongoing ...\n");
1541 timeout = jiffies + msecs_to_jiffies(SPI_POLLING_TIMEOUT);
1542 while (pl022->tx < pl022->tx_end || pl022->rx < pl022->rx_end) {
1545 if (time_after(time, timeout)) {
1546 dev_warn(&pl022->adev->dev,
1547 "%s: timeout!\n", __func__);
1548 message->state = STATE_TIMEOUT;
1549 print_current_status(pl022);
1555 /* Update total byte transferred */
1556 message->actual_length += pl022->cur_transfer->len;
1557 /* Move to next transfer */
1558 message->state = next_transfer(pl022);
1559 if (message->state != STATE_DONE
1560 && pl022->cur_transfer->cs_change)
1561 pl022_cs_control(pl022, SSP_CHIP_DESELECT);
1564 /* Handle end of message */
1565 if (message->state == STATE_DONE)
1566 message->status = 0;
1567 else if (message->state == STATE_TIMEOUT)
1568 message->status = -EAGAIN;
1570 message->status = -EIO;
1576 static int pl022_transfer_one_message(struct spi_master *master,
1577 struct spi_message *msg)
1579 struct pl022 *pl022 = spi_master_get_devdata(master);
1581 /* Initial message state */
1582 pl022->cur_msg = msg;
1583 msg->state = STATE_START;
1585 pl022->cur_transfer = list_entry(msg->transfers.next,
1586 struct spi_transfer, transfer_list);
1588 /* Setup the SPI using the per chip configuration */
1589 pl022->cur_chip = spi_get_ctldata(msg->spi);
1590 pl022->cur_cs = msg->spi->chip_select;
1591 /* This is always available but may be set to -ENOENT */
1592 pl022->cur_gpiod = msg->spi->cs_gpiod;
1594 restore_state(pl022);
1597 if (pl022->cur_chip->xfer_type == POLLING_TRANSFER)
1598 do_polling_transfer(pl022);
1600 do_interrupt_dma_transfer(pl022);
1605 static int pl022_unprepare_transfer_hardware(struct spi_master *master)
1607 struct pl022 *pl022 = spi_master_get_devdata(master);
1609 /* nothing more to do - disable spi/ssp and power off */
1610 writew((readw(SSP_CR1(pl022->virtbase)) &
1611 (~SSP_CR1_MASK_SSE)), SSP_CR1(pl022->virtbase));
1616 static int verify_controller_parameters(struct pl022 *pl022,
1617 struct pl022_config_chip const *chip_info)
1619 if ((chip_info->iface < SSP_INTERFACE_MOTOROLA_SPI)
1620 || (chip_info->iface > SSP_INTERFACE_UNIDIRECTIONAL)) {
1621 dev_err(&pl022->adev->dev,
1622 "interface is configured incorrectly\n");
1625 if ((chip_info->iface == SSP_INTERFACE_UNIDIRECTIONAL) &&
1626 (!pl022->vendor->unidir)) {
1627 dev_err(&pl022->adev->dev,
1628 "unidirectional mode not supported in this "
1629 "hardware version\n");
1632 if ((chip_info->hierarchy != SSP_MASTER)
1633 && (chip_info->hierarchy != SSP_SLAVE)) {
1634 dev_err(&pl022->adev->dev,
1635 "hierarchy is configured incorrectly\n");
1638 if ((chip_info->com_mode != INTERRUPT_TRANSFER)
1639 && (chip_info->com_mode != DMA_TRANSFER)
1640 && (chip_info->com_mode != POLLING_TRANSFER)) {
1641 dev_err(&pl022->adev->dev,
1642 "Communication mode is configured incorrectly\n");
1645 switch (chip_info->rx_lev_trig) {
1646 case SSP_RX_1_OR_MORE_ELEM:
1647 case SSP_RX_4_OR_MORE_ELEM:
1648 case SSP_RX_8_OR_MORE_ELEM:
1649 /* These are always OK, all variants can handle this */
1651 case SSP_RX_16_OR_MORE_ELEM:
1652 if (pl022->vendor->fifodepth < 16) {
1653 dev_err(&pl022->adev->dev,
1654 "RX FIFO Trigger Level is configured incorrectly\n");
1658 case SSP_RX_32_OR_MORE_ELEM:
1659 if (pl022->vendor->fifodepth < 32) {
1660 dev_err(&pl022->adev->dev,
1661 "RX FIFO Trigger Level is configured incorrectly\n");
1666 dev_err(&pl022->adev->dev,
1667 "RX FIFO Trigger Level is configured incorrectly\n");
1670 switch (chip_info->tx_lev_trig) {
1671 case SSP_TX_1_OR_MORE_EMPTY_LOC:
1672 case SSP_TX_4_OR_MORE_EMPTY_LOC:
1673 case SSP_TX_8_OR_MORE_EMPTY_LOC:
1674 /* These are always OK, all variants can handle this */
1676 case SSP_TX_16_OR_MORE_EMPTY_LOC:
1677 if (pl022->vendor->fifodepth < 16) {
1678 dev_err(&pl022->adev->dev,
1679 "TX FIFO Trigger Level is configured incorrectly\n");
1683 case SSP_TX_32_OR_MORE_EMPTY_LOC:
1684 if (pl022->vendor->fifodepth < 32) {
1685 dev_err(&pl022->adev->dev,
1686 "TX FIFO Trigger Level is configured incorrectly\n");
1691 dev_err(&pl022->adev->dev,
1692 "TX FIFO Trigger Level is configured incorrectly\n");
1695 if (chip_info->iface == SSP_INTERFACE_NATIONAL_MICROWIRE) {
1696 if ((chip_info->ctrl_len < SSP_BITS_4)
1697 || (chip_info->ctrl_len > SSP_BITS_32)) {
1698 dev_err(&pl022->adev->dev,
1699 "CTRL LEN is configured incorrectly\n");
1702 if ((chip_info->wait_state != SSP_MWIRE_WAIT_ZERO)
1703 && (chip_info->wait_state != SSP_MWIRE_WAIT_ONE)) {
1704 dev_err(&pl022->adev->dev,
1705 "Wait State is configured incorrectly\n");
1708 /* Half duplex is only available in the ST Micro version */
1709 if (pl022->vendor->extended_cr) {
1710 if ((chip_info->duplex !=
1711 SSP_MICROWIRE_CHANNEL_FULL_DUPLEX)
1712 && (chip_info->duplex !=
1713 SSP_MICROWIRE_CHANNEL_HALF_DUPLEX)) {
1714 dev_err(&pl022->adev->dev,
1715 "Microwire duplex mode is configured incorrectly\n");
1719 if (chip_info->duplex != SSP_MICROWIRE_CHANNEL_FULL_DUPLEX)
1720 dev_err(&pl022->adev->dev,
1721 "Microwire half duplex mode requested,"
1722 " but this is only available in the"
1723 " ST version of PL022\n");
1730 static inline u32 spi_rate(u32 rate, u16 cpsdvsr, u16 scr)
1732 return rate / (cpsdvsr * (1 + scr));
1735 static int calculate_effective_freq(struct pl022 *pl022, int freq, struct
1736 ssp_clock_params * clk_freq)
1738 /* Lets calculate the frequency parameters */
1739 u16 cpsdvsr = CPSDVR_MIN, scr = SCR_MIN;
1740 u32 rate, max_tclk, min_tclk, best_freq = 0, best_cpsdvsr = 0,
1741 best_scr = 0, tmp, found = 0;
1743 rate = clk_get_rate(pl022->clk);
1744 /* cpsdvscr = 2 & scr 0 */
1745 max_tclk = spi_rate(rate, CPSDVR_MIN, SCR_MIN);
1746 /* cpsdvsr = 254 & scr = 255 */
1747 min_tclk = spi_rate(rate, CPSDVR_MAX, SCR_MAX);
1749 if (freq > max_tclk)
1750 dev_warn(&pl022->adev->dev,
1751 "Max speed that can be programmed is %d Hz, you requested %d\n",
1754 if (freq < min_tclk) {
1755 dev_err(&pl022->adev->dev,
1756 "Requested frequency: %d Hz is less than minimum possible %d Hz\n",
1762 * best_freq will give closest possible available rate (<= requested
1763 * freq) for all values of scr & cpsdvsr.
1765 while ((cpsdvsr <= CPSDVR_MAX) && !found) {
1766 while (scr <= SCR_MAX) {
1767 tmp = spi_rate(rate, cpsdvsr, scr);
1770 /* we need lower freq */
1776 * If found exact value, mark found and break.
1777 * If found more closer value, update and break.
1779 if (tmp > best_freq) {
1781 best_cpsdvsr = cpsdvsr;
1788 * increased scr will give lower rates, which are not
1797 WARN(!best_freq, "pl022: Matching cpsdvsr and scr not found for %d Hz rate \n",
1800 clk_freq->cpsdvsr = (u8) (best_cpsdvsr & 0xFF);
1801 clk_freq->scr = (u8) (best_scr & 0xFF);
1802 dev_dbg(&pl022->adev->dev,
1803 "SSP Target Frequency is: %u, Effective Frequency is %u\n",
1805 dev_dbg(&pl022->adev->dev, "SSP cpsdvsr = %d, scr = %d\n",
1806 clk_freq->cpsdvsr, clk_freq->scr);
1812 * A piece of default chip info unless the platform
1815 static const struct pl022_config_chip pl022_default_chip_info = {
1816 .com_mode = INTERRUPT_TRANSFER,
1817 .iface = SSP_INTERFACE_MOTOROLA_SPI,
1818 .hierarchy = SSP_MASTER,
1819 .slave_tx_disable = DO_NOT_DRIVE_TX,
1820 .rx_lev_trig = SSP_RX_1_OR_MORE_ELEM,
1821 .tx_lev_trig = SSP_TX_1_OR_MORE_EMPTY_LOC,
1822 .ctrl_len = SSP_BITS_8,
1823 .wait_state = SSP_MWIRE_WAIT_ZERO,
1824 .duplex = SSP_MICROWIRE_CHANNEL_FULL_DUPLEX,
1828 * pl022_setup - setup function registered to SPI master framework
1829 * @spi: spi device which is requesting setup
1831 * This function is registered to the SPI framework for this SPI master
1832 * controller. If it is the first time when setup is called by this device,
1833 * this function will initialize the runtime state for this chip and save
1834 * the same in the device structure. Else it will update the runtime info
1835 * with the updated chip info. Nothing is really being written to the
1836 * controller hardware here, that is not done until the actual transfer
1839 static int pl022_setup(struct spi_device *spi)
1841 struct pl022_config_chip const *chip_info;
1842 struct pl022_config_chip chip_info_dt;
1843 struct chip_data *chip;
1844 struct ssp_clock_params clk_freq = { .cpsdvsr = 0, .scr = 0};
1846 struct pl022 *pl022 = spi_master_get_devdata(spi->master);
1847 unsigned int bits = spi->bits_per_word;
1849 struct device_node *np = spi->dev.of_node;
1851 if (!spi->max_speed_hz)
1854 /* Get controller_state if one is supplied */
1855 chip = spi_get_ctldata(spi);
1858 chip = kzalloc(sizeof(struct chip_data), GFP_KERNEL);
1862 "allocated memory for controller's runtime state\n");
1865 /* Get controller data if one is supplied */
1866 chip_info = spi->controller_data;
1868 if (chip_info == NULL) {
1870 chip_info_dt = pl022_default_chip_info;
1872 chip_info_dt.hierarchy = SSP_MASTER;
1873 of_property_read_u32(np, "pl022,interface",
1874 &chip_info_dt.iface);
1875 of_property_read_u32(np, "pl022,com-mode",
1876 &chip_info_dt.com_mode);
1877 of_property_read_u32(np, "pl022,rx-level-trig",
1878 &chip_info_dt.rx_lev_trig);
1879 of_property_read_u32(np, "pl022,tx-level-trig",
1880 &chip_info_dt.tx_lev_trig);
1881 of_property_read_u32(np, "pl022,ctrl-len",
1882 &chip_info_dt.ctrl_len);
1883 of_property_read_u32(np, "pl022,wait-state",
1884 &chip_info_dt.wait_state);
1885 of_property_read_u32(np, "pl022,duplex",
1886 &chip_info_dt.duplex);
1888 chip_info = &chip_info_dt;
1890 chip_info = &pl022_default_chip_info;
1891 /* spi_board_info.controller_data not is supplied */
1893 "using default controller_data settings\n");
1897 "using user supplied controller_data settings\n");
1900 * We can override with custom divisors, else we use the board
1903 if ((0 == chip_info->clk_freq.cpsdvsr)
1904 && (0 == chip_info->clk_freq.scr)) {
1905 status = calculate_effective_freq(pl022,
1909 goto err_config_params;
1911 memcpy(&clk_freq, &chip_info->clk_freq, sizeof(clk_freq));
1912 if ((clk_freq.cpsdvsr % 2) != 0)
1914 clk_freq.cpsdvsr - 1;
1916 if ((clk_freq.cpsdvsr < CPSDVR_MIN)
1917 || (clk_freq.cpsdvsr > CPSDVR_MAX)) {
1920 "cpsdvsr is configured incorrectly\n");
1921 goto err_config_params;
1924 status = verify_controller_parameters(pl022, chip_info);
1926 dev_err(&spi->dev, "controller data is incorrect");
1927 goto err_config_params;
1930 pl022->rx_lev_trig = chip_info->rx_lev_trig;
1931 pl022->tx_lev_trig = chip_info->tx_lev_trig;
1933 /* Now set controller state based on controller data */
1934 chip->xfer_type = chip_info->com_mode;
1936 /* Check bits per word with vendor specific range */
1937 if ((bits <= 3) || (bits > pl022->vendor->max_bpw)) {
1939 dev_err(&spi->dev, "illegal data size for this controller!\n");
1940 dev_err(&spi->dev, "This controller can only handle 4 <= n <= %d bit words\n",
1941 pl022->vendor->max_bpw);
1942 goto err_config_params;
1943 } else if (bits <= 8) {
1944 dev_dbg(&spi->dev, "4 <= n <=8 bits per word\n");
1946 chip->read = READING_U8;
1947 chip->write = WRITING_U8;
1948 } else if (bits <= 16) {
1949 dev_dbg(&spi->dev, "9 <= n <= 16 bits per word\n");
1951 chip->read = READING_U16;
1952 chip->write = WRITING_U16;
1954 dev_dbg(&spi->dev, "17 <= n <= 32 bits per word\n");
1956 chip->read = READING_U32;
1957 chip->write = WRITING_U32;
1960 /* Now Initialize all register settings required for this chip */
1965 if ((chip_info->com_mode == DMA_TRANSFER)
1966 && ((pl022->master_info)->enable_dma)) {
1967 chip->enable_dma = true;
1968 dev_dbg(&spi->dev, "DMA mode set in controller state\n");
1969 SSP_WRITE_BITS(chip->dmacr, SSP_DMA_ENABLED,
1970 SSP_DMACR_MASK_RXDMAE, 0);
1971 SSP_WRITE_BITS(chip->dmacr, SSP_DMA_ENABLED,
1972 SSP_DMACR_MASK_TXDMAE, 1);
1974 chip->enable_dma = false;
1975 dev_dbg(&spi->dev, "DMA mode NOT set in controller state\n");
1976 SSP_WRITE_BITS(chip->dmacr, SSP_DMA_DISABLED,
1977 SSP_DMACR_MASK_RXDMAE, 0);
1978 SSP_WRITE_BITS(chip->dmacr, SSP_DMA_DISABLED,
1979 SSP_DMACR_MASK_TXDMAE, 1);
1982 chip->cpsr = clk_freq.cpsdvsr;
1984 /* Special setup for the ST micro extended control registers */
1985 if (pl022->vendor->extended_cr) {
1988 if (pl022->vendor->pl023) {
1989 /* These bits are only in the PL023 */
1990 SSP_WRITE_BITS(chip->cr1, chip_info->clkdelay,
1991 SSP_CR1_MASK_FBCLKDEL_ST, 13);
1993 /* These bits are in the PL022 but not PL023 */
1994 SSP_WRITE_BITS(chip->cr0, chip_info->duplex,
1995 SSP_CR0_MASK_HALFDUP_ST, 5);
1996 SSP_WRITE_BITS(chip->cr0, chip_info->ctrl_len,
1997 SSP_CR0_MASK_CSS_ST, 16);
1998 SSP_WRITE_BITS(chip->cr0, chip_info->iface,
1999 SSP_CR0_MASK_FRF_ST, 21);
2000 SSP_WRITE_BITS(chip->cr1, chip_info->wait_state,
2001 SSP_CR1_MASK_MWAIT_ST, 6);
2003 SSP_WRITE_BITS(chip->cr0, bits - 1,
2004 SSP_CR0_MASK_DSS_ST, 0);
2006 if (spi->mode & SPI_LSB_FIRST) {
2013 SSP_WRITE_BITS(chip->cr1, tmp, SSP_CR1_MASK_RENDN_ST, 4);
2014 SSP_WRITE_BITS(chip->cr1, etx, SSP_CR1_MASK_TENDN_ST, 5);
2015 SSP_WRITE_BITS(chip->cr1, chip_info->rx_lev_trig,
2016 SSP_CR1_MASK_RXIFLSEL_ST, 7);
2017 SSP_WRITE_BITS(chip->cr1, chip_info->tx_lev_trig,
2018 SSP_CR1_MASK_TXIFLSEL_ST, 10);
2020 SSP_WRITE_BITS(chip->cr0, bits - 1,
2021 SSP_CR0_MASK_DSS, 0);
2022 SSP_WRITE_BITS(chip->cr0, chip_info->iface,
2023 SSP_CR0_MASK_FRF, 4);
2026 /* Stuff that is common for all versions */
2027 if (spi->mode & SPI_CPOL)
2028 tmp = SSP_CLK_POL_IDLE_HIGH;
2030 tmp = SSP_CLK_POL_IDLE_LOW;
2031 SSP_WRITE_BITS(chip->cr0, tmp, SSP_CR0_MASK_SPO, 6);
2033 if (spi->mode & SPI_CPHA)
2034 tmp = SSP_CLK_SECOND_EDGE;
2036 tmp = SSP_CLK_FIRST_EDGE;
2037 SSP_WRITE_BITS(chip->cr0, tmp, SSP_CR0_MASK_SPH, 7);
2039 SSP_WRITE_BITS(chip->cr0, clk_freq.scr, SSP_CR0_MASK_SCR, 8);
2040 /* Loopback is available on all versions except PL023 */
2041 if (pl022->vendor->loopback) {
2042 if (spi->mode & SPI_LOOP)
2043 tmp = LOOPBACK_ENABLED;
2045 tmp = LOOPBACK_DISABLED;
2046 SSP_WRITE_BITS(chip->cr1, tmp, SSP_CR1_MASK_LBM, 0);
2048 SSP_WRITE_BITS(chip->cr1, SSP_DISABLED, SSP_CR1_MASK_SSE, 1);
2049 SSP_WRITE_BITS(chip->cr1, chip_info->hierarchy, SSP_CR1_MASK_MS, 2);
2050 SSP_WRITE_BITS(chip->cr1, chip_info->slave_tx_disable, SSP_CR1_MASK_SOD,
2053 /* Save controller_state */
2054 spi_set_ctldata(spi, chip);
2057 spi_set_ctldata(spi, NULL);
2063 * pl022_cleanup - cleanup function registered to SPI master framework
2064 * @spi: spi device which is requesting cleanup
2066 * This function is registered to the SPI framework for this SPI master
2067 * controller. It will free the runtime state of chip.
2069 static void pl022_cleanup(struct spi_device *spi)
2071 struct chip_data *chip = spi_get_ctldata(spi);
2073 spi_set_ctldata(spi, NULL);
2077 static struct pl022_ssp_controller *
2078 pl022_platform_data_dt_get(struct device *dev)
2080 struct device_node *np = dev->of_node;
2081 struct pl022_ssp_controller *pd;
2084 dev_err(dev, "no dt node defined\n");
2088 pd = devm_kzalloc(dev, sizeof(struct pl022_ssp_controller), GFP_KERNEL);
2094 of_property_read_u32(np, "pl022,autosuspend-delay",
2095 &pd->autosuspend_delay);
2096 pd->rt = of_property_read_bool(np, "pl022,rt");
2101 static int pl022_probe(struct amba_device *adev, const struct amba_id *id)
2103 struct device *dev = &adev->dev;
2104 struct pl022_ssp_controller *platform_info =
2105 dev_get_platdata(&adev->dev);
2106 struct spi_master *master;
2107 struct pl022 *pl022 = NULL; /*Data for this driver */
2110 dev_info(&adev->dev,
2111 "ARM PL022 driver, device ID: 0x%08x\n", adev->periphid);
2112 if (!platform_info && IS_ENABLED(CONFIG_OF))
2113 platform_info = pl022_platform_data_dt_get(dev);
2115 if (!platform_info) {
2116 dev_err(dev, "probe: no platform data defined\n");
2120 /* Allocate master with space for data */
2121 master = spi_alloc_master(dev, sizeof(struct pl022));
2122 if (master == NULL) {
2123 dev_err(&adev->dev, "probe - cannot alloc SPI master\n");
2127 pl022 = spi_master_get_devdata(master);
2128 pl022->master = master;
2129 pl022->master_info = platform_info;
2131 pl022->vendor = id->data;
2134 * Bus Number Which has been Assigned to this SSP controller
2137 master->bus_num = platform_info->bus_id;
2138 master->cleanup = pl022_cleanup;
2139 master->setup = pl022_setup;
2140 master->auto_runtime_pm = true;
2141 master->transfer_one_message = pl022_transfer_one_message;
2142 master->unprepare_transfer_hardware = pl022_unprepare_transfer_hardware;
2143 master->rt = platform_info->rt;
2144 master->dev.of_node = dev->of_node;
2145 master->use_gpio_descriptors = true;
2148 * Supports mode 0-3, loopback, and active low CS. Transfers are
2149 * always MS bit first on the original pl022.
2151 master->mode_bits = SPI_CPOL | SPI_CPHA | SPI_CS_HIGH | SPI_LOOP;
2152 if (pl022->vendor->extended_cr)
2153 master->mode_bits |= SPI_LSB_FIRST;
2155 dev_dbg(&adev->dev, "BUSNO: %d\n", master->bus_num);
2157 status = amba_request_regions(adev, NULL);
2159 goto err_no_ioregion;
2161 pl022->phybase = adev->res.start;
2162 pl022->virtbase = devm_ioremap(dev, adev->res.start,
2163 resource_size(&adev->res));
2164 if (pl022->virtbase == NULL) {
2166 goto err_no_ioremap;
2168 dev_info(&adev->dev, "mapped registers from %pa to %p\n",
2169 &adev->res.start, pl022->virtbase);
2171 pl022->clk = devm_clk_get(&adev->dev, NULL);
2172 if (IS_ERR(pl022->clk)) {
2173 status = PTR_ERR(pl022->clk);
2174 dev_err(&adev->dev, "could not retrieve SSP/SPI bus clock\n");
2178 status = clk_prepare_enable(pl022->clk);
2180 dev_err(&adev->dev, "could not enable SSP/SPI bus clock\n");
2184 /* Initialize transfer pump */
2185 tasklet_init(&pl022->pump_transfers, pump_transfers,
2186 (unsigned long)pl022);
2189 writew((readw(SSP_CR1(pl022->virtbase)) & (~SSP_CR1_MASK_SSE)),
2190 SSP_CR1(pl022->virtbase));
2191 load_ssp_default_config(pl022);
2193 status = devm_request_irq(dev, adev->irq[0], pl022_interrupt_handler,
2196 dev_err(&adev->dev, "probe - cannot get IRQ (%d)\n", status);
2200 /* Get DMA channels, try autoconfiguration first */
2201 status = pl022_dma_autoprobe(pl022);
2202 if (status == -EPROBE_DEFER) {
2203 dev_dbg(dev, "deferring probe to get DMA channel\n");
2207 /* If that failed, use channels from platform_info */
2209 platform_info->enable_dma = 1;
2210 else if (platform_info->enable_dma) {
2211 status = pl022_dma_probe(pl022);
2213 platform_info->enable_dma = 0;
2216 /* Register with the SPI framework */
2217 amba_set_drvdata(adev, pl022);
2218 status = devm_spi_register_master(&adev->dev, master);
2221 "probe - problem registering spi master\n");
2222 goto err_spi_register;
2224 dev_dbg(dev, "probe succeeded\n");
2226 /* let runtime pm put suspend */
2227 if (platform_info->autosuspend_delay > 0) {
2228 dev_info(&adev->dev,
2229 "will use autosuspend for runtime pm, delay %dms\n",
2230 platform_info->autosuspend_delay);
2231 pm_runtime_set_autosuspend_delay(dev,
2232 platform_info->autosuspend_delay);
2233 pm_runtime_use_autosuspend(dev);
2235 pm_runtime_put(dev);
2240 if (platform_info->enable_dma)
2241 pl022_dma_remove(pl022);
2243 clk_disable_unprepare(pl022->clk);
2247 amba_release_regions(adev);
2249 spi_master_put(master);
2254 pl022_remove(struct amba_device *adev)
2256 struct pl022 *pl022 = amba_get_drvdata(adev);
2262 * undo pm_runtime_put() in probe. I assume that we're not
2263 * accessing the primecell here.
2265 pm_runtime_get_noresume(&adev->dev);
2267 load_ssp_default_config(pl022);
2268 if (pl022->master_info->enable_dma)
2269 pl022_dma_remove(pl022);
2271 clk_disable_unprepare(pl022->clk);
2272 amba_release_regions(adev);
2273 tasklet_disable(&pl022->pump_transfers);
2276 #ifdef CONFIG_PM_SLEEP
2277 static int pl022_suspend(struct device *dev)
2279 struct pl022 *pl022 = dev_get_drvdata(dev);
2282 ret = spi_master_suspend(pl022->master);
2286 ret = pm_runtime_force_suspend(dev);
2288 spi_master_resume(pl022->master);
2292 pinctrl_pm_select_sleep_state(dev);
2294 dev_dbg(dev, "suspended\n");
2298 static int pl022_resume(struct device *dev)
2300 struct pl022 *pl022 = dev_get_drvdata(dev);
2303 ret = pm_runtime_force_resume(dev);
2305 dev_err(dev, "problem resuming\n");
2307 /* Start the queue running */
2308 ret = spi_master_resume(pl022->master);
2310 dev_dbg(dev, "resumed\n");
2317 static int pl022_runtime_suspend(struct device *dev)
2319 struct pl022 *pl022 = dev_get_drvdata(dev);
2321 clk_disable_unprepare(pl022->clk);
2322 pinctrl_pm_select_idle_state(dev);
2327 static int pl022_runtime_resume(struct device *dev)
2329 struct pl022 *pl022 = dev_get_drvdata(dev);
2331 pinctrl_pm_select_default_state(dev);
2332 clk_prepare_enable(pl022->clk);
2338 static const struct dev_pm_ops pl022_dev_pm_ops = {
2339 SET_SYSTEM_SLEEP_PM_OPS(pl022_suspend, pl022_resume)
2340 SET_RUNTIME_PM_OPS(pl022_runtime_suspend, pl022_runtime_resume, NULL)
2343 static struct vendor_data vendor_arm = {
2347 .extended_cr = false,
2350 .internal_cs_ctrl = false,
2353 static struct vendor_data vendor_st = {
2357 .extended_cr = true,
2360 .internal_cs_ctrl = false,
2363 static struct vendor_data vendor_st_pl023 = {
2367 .extended_cr = true,
2370 .internal_cs_ctrl = false,
2373 static struct vendor_data vendor_lsi = {
2377 .extended_cr = false,
2380 .internal_cs_ctrl = true,
2383 static const struct amba_id pl022_ids[] = {
2386 * ARM PL022 variant, this has a 16bit wide
2387 * and 8 locations deep TX/RX FIFO
2391 .data = &vendor_arm,
2395 * ST Micro derivative, this has 32bit wide
2396 * and 32 locations deep TX/RX FIFO
2404 * ST-Ericsson derivative "PL023" (this is not
2405 * an official ARM number), this is a PL022 SSP block
2406 * stripped to SPI mode only, it has 32bit wide
2407 * and 32 locations deep TX/RX FIFO but no extended
2412 .data = &vendor_st_pl023,
2416 * PL022 variant that has a chip select control register whih
2417 * allows control of 5 output signals nCS[0:4].
2421 .data = &vendor_lsi,
2426 MODULE_DEVICE_TABLE(amba, pl022_ids);
2428 static struct amba_driver pl022_driver = {
2430 .name = "ssp-pl022",
2431 .pm = &pl022_dev_pm_ops,
2433 .id_table = pl022_ids,
2434 .probe = pl022_probe,
2435 .remove = pl022_remove,
2438 static int __init pl022_init(void)
2440 return amba_driver_register(&pl022_driver);
2442 subsys_initcall(pl022_init);
2444 static void __exit pl022_exit(void)
2446 amba_driver_unregister(&pl022_driver);
2448 module_exit(pl022_exit);
2450 MODULE_AUTHOR("Linus Walleij <linus.walleij@stericsson.com>");
2451 MODULE_DESCRIPTION("PL022 SSP Controller Driver");
2452 MODULE_LICENSE("GPL");