blob: eab27d41ba83f3ae713b0fccecc02aacb226834d [file] [log] [blame]
Chris Bootf8043872013-03-11 21:38:24 -06001/*
2 * Driver for Broadcom BCM2835 SPI Controllers
3 *
4 * Copyright (C) 2012 Chris Boot
5 * Copyright (C) 2013 Stephen Warren
Martin Sperle34ff012015-03-26 11:08:36 +01006 * Copyright (C) 2015 Martin Sperl
Chris Bootf8043872013-03-11 21:38:24 -06007 *
8 * This driver is inspired by:
9 * spi-ath79.c, Copyright (C) 2009-2011 Gabor Juhos <juhosg@openwrt.org>
10 * spi-atmel.c, Copyright (C) 2006 Atmel Corporation
11 *
12 * This program is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
16 *
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
Chris Bootf8043872013-03-11 21:38:24 -060021 */
22
Martin Sperl7e52be02015-05-12 10:32:08 +000023#include <asm/page.h>
Chris Bootf8043872013-03-11 21:38:24 -060024#include <linux/clk.h>
25#include <linux/completion.h>
26#include <linux/delay.h>
Martin Sperl3ecd37e2015-05-10 20:47:28 +000027#include <linux/dma-mapping.h>
28#include <linux/dmaengine.h>
Chris Bootf8043872013-03-11 21:38:24 -060029#include <linux/err.h>
30#include <linux/interrupt.h>
31#include <linux/io.h>
32#include <linux/kernel.h>
33#include <linux/module.h>
34#include <linux/of.h>
Martin Sperl3ecd37e2015-05-10 20:47:28 +000035#include <linux/of_address.h>
Chris Bootf8043872013-03-11 21:38:24 -060036#include <linux/of_device.h>
Martin Sperl3ecd37e2015-05-10 20:47:28 +000037#include <linux/of_gpio.h>
38#include <linux/of_irq.h>
Chris Bootf8043872013-03-11 21:38:24 -060039#include <linux/spi/spi.h>
40
41/* SPI register offsets */
42#define BCM2835_SPI_CS 0x00
43#define BCM2835_SPI_FIFO 0x04
44#define BCM2835_SPI_CLK 0x08
45#define BCM2835_SPI_DLEN 0x0c
46#define BCM2835_SPI_LTOH 0x10
47#define BCM2835_SPI_DC 0x14
48
49/* Bitfields in CS */
50#define BCM2835_SPI_CS_LEN_LONG 0x02000000
51#define BCM2835_SPI_CS_DMA_LEN 0x01000000
52#define BCM2835_SPI_CS_CSPOL2 0x00800000
53#define BCM2835_SPI_CS_CSPOL1 0x00400000
54#define BCM2835_SPI_CS_CSPOL0 0x00200000
55#define BCM2835_SPI_CS_RXF 0x00100000
56#define BCM2835_SPI_CS_RXR 0x00080000
57#define BCM2835_SPI_CS_TXD 0x00040000
58#define BCM2835_SPI_CS_RXD 0x00020000
59#define BCM2835_SPI_CS_DONE 0x00010000
60#define BCM2835_SPI_CS_LEN 0x00002000
61#define BCM2835_SPI_CS_REN 0x00001000
62#define BCM2835_SPI_CS_ADCS 0x00000800
63#define BCM2835_SPI_CS_INTR 0x00000400
64#define BCM2835_SPI_CS_INTD 0x00000200
65#define BCM2835_SPI_CS_DMAEN 0x00000100
66#define BCM2835_SPI_CS_TA 0x00000080
67#define BCM2835_SPI_CS_CSPOL 0x00000040
68#define BCM2835_SPI_CS_CLEAR_RX 0x00000020
69#define BCM2835_SPI_CS_CLEAR_TX 0x00000010
70#define BCM2835_SPI_CS_CPOL 0x00000008
71#define BCM2835_SPI_CS_CPHA 0x00000004
72#define BCM2835_SPI_CS_CS_10 0x00000002
73#define BCM2835_SPI_CS_CS_01 0x00000001
74
Martin Sperl704f32d2015-04-06 17:16:30 +000075#define BCM2835_SPI_POLLING_LIMIT_US 30
Martin Sperla750b122015-04-22 07:33:03 +000076#define BCM2835_SPI_POLLING_JIFFIES 2
Martin Sperl3ecd37e2015-05-10 20:47:28 +000077#define BCM2835_SPI_DMA_MIN_LENGTH 96
Martin Sperl69352242015-03-19 09:01:53 +000078#define BCM2835_SPI_MODE_BITS (SPI_CPOL | SPI_CPHA | SPI_CS_HIGH \
79 | SPI_NO_CS | SPI_3WIRE)
Chris Bootf8043872013-03-11 21:38:24 -060080
81#define DRV_NAME "spi-bcm2835"
82
83struct bcm2835_spi {
84 void __iomem *regs;
85 struct clk *clk;
86 int irq;
Chris Bootf8043872013-03-11 21:38:24 -060087 const u8 *tx_buf;
88 u8 *rx_buf;
Martin Sperle34ff012015-03-26 11:08:36 +010089 int tx_len;
90 int rx_len;
Lukas Wunner0b7a7862018-11-29 15:14:49 +010091 unsigned int dma_pending;
Chris Bootf8043872013-03-11 21:38:24 -060092};
93
94static inline u32 bcm2835_rd(struct bcm2835_spi *bs, unsigned reg)
95{
96 return readl(bs->regs + reg);
97}
98
99static inline void bcm2835_wr(struct bcm2835_spi *bs, unsigned reg, u32 val)
100{
101 writel(val, bs->regs + reg);
102}
103
Martin Sperl4adf3122015-03-23 15:11:53 +0100104static inline void bcm2835_rd_fifo(struct bcm2835_spi *bs)
Chris Bootf8043872013-03-11 21:38:24 -0600105{
106 u8 byte;
107
Martin Sperle34ff012015-03-26 11:08:36 +0100108 while ((bs->rx_len) &&
109 (bcm2835_rd(bs, BCM2835_SPI_CS) & BCM2835_SPI_CS_RXD)) {
Chris Bootf8043872013-03-11 21:38:24 -0600110 byte = bcm2835_rd(bs, BCM2835_SPI_FIFO);
111 if (bs->rx_buf)
112 *bs->rx_buf++ = byte;
Martin Sperle34ff012015-03-26 11:08:36 +0100113 bs->rx_len--;
Chris Bootf8043872013-03-11 21:38:24 -0600114 }
115}
116
Martin Sperl4adf3122015-03-23 15:11:53 +0100117static inline void bcm2835_wr_fifo(struct bcm2835_spi *bs)
Chris Bootf8043872013-03-11 21:38:24 -0600118{
119 u8 byte;
120
Martin Sperle34ff012015-03-26 11:08:36 +0100121 while ((bs->tx_len) &&
Martin Sperl4adf3122015-03-23 15:11:53 +0100122 (bcm2835_rd(bs, BCM2835_SPI_CS) & BCM2835_SPI_CS_TXD)) {
Chris Bootf8043872013-03-11 21:38:24 -0600123 byte = bs->tx_buf ? *bs->tx_buf++ : 0;
124 bcm2835_wr(bs, BCM2835_SPI_FIFO, byte);
Martin Sperle34ff012015-03-26 11:08:36 +0100125 bs->tx_len--;
Chris Bootf8043872013-03-11 21:38:24 -0600126 }
127}
128
Martin Sperle34ff012015-03-26 11:08:36 +0100129static void bcm2835_spi_reset_hw(struct spi_master *master)
130{
131 struct bcm2835_spi *bs = spi_master_get_devdata(master);
132 u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
133
134 /* Disable SPI interrupts and transfer */
135 cs &= ~(BCM2835_SPI_CS_INTR |
136 BCM2835_SPI_CS_INTD |
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000137 BCM2835_SPI_CS_DMAEN |
Martin Sperle34ff012015-03-26 11:08:36 +0100138 BCM2835_SPI_CS_TA);
139 /* and reset RX/TX FIFOS */
140 cs |= BCM2835_SPI_CS_CLEAR_RX | BCM2835_SPI_CS_CLEAR_TX;
141
142 /* and reset the SPI_HW */
143 bcm2835_wr(bs, BCM2835_SPI_CS, cs);
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000144 /* as well as DLEN */
145 bcm2835_wr(bs, BCM2835_SPI_DLEN, 0);
Martin Sperle34ff012015-03-26 11:08:36 +0100146}
147
Chris Bootf8043872013-03-11 21:38:24 -0600148static irqreturn_t bcm2835_spi_interrupt(int irq, void *dev_id)
149{
150 struct spi_master *master = dev_id;
151 struct bcm2835_spi *bs = spi_master_get_devdata(master);
Chris Bootf8043872013-03-11 21:38:24 -0600152
Martin Sperl4adf3122015-03-23 15:11:53 +0100153 /* Read as many bytes as possible from FIFO */
154 bcm2835_rd_fifo(bs);
Martin Sperle34ff012015-03-26 11:08:36 +0100155 /* Write as many bytes as possible to FIFO */
156 bcm2835_wr_fifo(bs);
Chris Bootf8043872013-03-11 21:38:24 -0600157
Lukas Wunner31115f52018-11-08 08:06:10 +0100158 if (!bs->rx_len) {
Martin Sperle34ff012015-03-26 11:08:36 +0100159 /* Transfer complete - reset SPI HW */
160 bcm2835_spi_reset_hw(master);
161 /* wake up the framework */
162 complete(&master->xfer_completion);
Chris Bootf8043872013-03-11 21:38:24 -0600163 }
164
Martin Sperl4adf3122015-03-23 15:11:53 +0100165 return IRQ_HANDLED;
Chris Bootf8043872013-03-11 21:38:24 -0600166}
167
Martin Sperl704f32d2015-04-06 17:16:30 +0000168static int bcm2835_spi_transfer_one_irq(struct spi_master *master,
169 struct spi_device *spi,
170 struct spi_transfer *tfr,
171 u32 cs)
172{
173 struct bcm2835_spi *bs = spi_master_get_devdata(master);
Chris Bootf8043872013-03-11 21:38:24 -0600174
Martin Sperle3a2be32015-03-29 16:03:25 +0200175 /* fill in fifo if we have gpio-cs
176 * note that there have been rare events where the native-CS
177 * flapped for <1us which may change the behaviour
178 * with gpio-cs this does not happen, so it is implemented
179 * only for this case
180 */
181 if (gpio_is_valid(spi->cs_gpio)) {
182 /* enable HW block, but without interrupts enabled
183 * this would triggern an immediate interrupt
184 */
185 bcm2835_wr(bs, BCM2835_SPI_CS,
186 cs | BCM2835_SPI_CS_TA);
187 /* fill in tx fifo as much as possible */
188 bcm2835_wr_fifo(bs);
189 }
190
Chris Bootf8043872013-03-11 21:38:24 -0600191 /*
192 * Enable the HW block. This will immediately trigger a DONE (TX
193 * empty) interrupt, upon which we will fill the TX FIFO with the
194 * first TX bytes. Pre-filling the TX FIFO here to avoid the
195 * interrupt doesn't work:-(
196 */
Martin Sperle34ff012015-03-26 11:08:36 +0100197 cs |= BCM2835_SPI_CS_INTR | BCM2835_SPI_CS_INTD | BCM2835_SPI_CS_TA;
Chris Bootf8043872013-03-11 21:38:24 -0600198 bcm2835_wr(bs, BCM2835_SPI_CS, cs);
199
Martin Sperle34ff012015-03-26 11:08:36 +0100200 /* signal that we need to wait for completion */
201 return 1;
Chris Bootf8043872013-03-11 21:38:24 -0600202}
203
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000204/*
205 * DMA support
206 *
207 * this implementation has currently a few issues in so far as it does
208 * not work arrount limitations of the HW.
209 *
210 * the main one being that DMA transfers are limited to 16 bit
211 * (so 0 to 65535 bytes) by the SPI HW due to BCM2835_SPI_DLEN
212 *
213 * also we currently assume that the scatter-gather fragments are
214 * all multiple of 4 (except the last) - otherwise we would need
215 * to reset the FIFO before subsequent transfers...
216 * this also means that tx/rx transfers sg's need to be of equal size!
217 *
218 * there may be a few more border-cases we may need to address as well
219 * but unfortunately this would mean splitting up the scatter-gather
220 * list making it slightly unpractical...
221 */
222static void bcm2835_spi_dma_done(void *data)
223{
224 struct spi_master *master = data;
225 struct bcm2835_spi *bs = spi_master_get_devdata(master);
226
227 /* reset fifo and HW */
228 bcm2835_spi_reset_hw(master);
229
230 /* and terminate tx-dma as we do not have an irq for it
231 * because when the rx dma will terminate and this callback
232 * is called the tx-dma must have finished - can't get to this
233 * situation otherwise...
234 */
Lukas Wunner708f7422018-11-08 08:06:10 +0100235 if (cmpxchg(&bs->dma_pending, true, false)) {
236 dmaengine_terminate_all(master->dma_tx);
237 }
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000238
239 /* and mark as completed */;
240 complete(&master->xfer_completion);
241}
242
243static int bcm2835_spi_prepare_sg(struct spi_master *master,
244 struct spi_transfer *tfr,
245 bool is_tx)
246{
247 struct dma_chan *chan;
248 struct scatterlist *sgl;
249 unsigned int nents;
250 enum dma_transfer_direction dir;
251 unsigned long flags;
252
253 struct dma_async_tx_descriptor *desc;
254 dma_cookie_t cookie;
255
256 if (is_tx) {
257 dir = DMA_MEM_TO_DEV;
258 chan = master->dma_tx;
259 nents = tfr->tx_sg.nents;
260 sgl = tfr->tx_sg.sgl;
261 flags = 0 /* no tx interrupt */;
262
263 } else {
264 dir = DMA_DEV_TO_MEM;
265 chan = master->dma_rx;
266 nents = tfr->rx_sg.nents;
267 sgl = tfr->rx_sg.sgl;
268 flags = DMA_PREP_INTERRUPT;
269 }
270 /* prepare the channel */
271 desc = dmaengine_prep_slave_sg(chan, sgl, nents, dir, flags);
272 if (!desc)
273 return -EINVAL;
274
275 /* set callback for rx */
276 if (!is_tx) {
277 desc->callback = bcm2835_spi_dma_done;
278 desc->callback_param = master;
279 }
280
281 /* submit it to DMA-engine */
282 cookie = dmaengine_submit(desc);
283
284 return dma_submit_error(cookie);
285}
286
287static inline int bcm2835_check_sg_length(struct sg_table *sgt)
288{
289 int i;
290 struct scatterlist *sgl;
291
292 /* check that the sg entries are word-sized (except for last) */
293 for_each_sg(sgt->sgl, sgl, (int)sgt->nents - 1, i) {
294 if (sg_dma_len(sgl) % 4)
295 return -EFAULT;
296 }
297
298 return 0;
299}
300
301static int bcm2835_spi_transfer_one_dma(struct spi_master *master,
302 struct spi_device *spi,
303 struct spi_transfer *tfr,
304 u32 cs)
305{
306 struct bcm2835_spi *bs = spi_master_get_devdata(master);
307 int ret;
308
309 /* check that the scatter gather segments are all a multiple of 4 */
310 if (bcm2835_check_sg_length(&tfr->tx_sg) ||
311 bcm2835_check_sg_length(&tfr->rx_sg)) {
312 dev_warn_once(&spi->dev,
313 "scatter gather segment length is not a multiple of 4 - falling back to interrupt mode\n");
314 return bcm2835_spi_transfer_one_irq(master, spi, tfr, cs);
315 }
316
317 /* setup tx-DMA */
318 ret = bcm2835_spi_prepare_sg(master, tfr, true);
319 if (ret)
320 return ret;
321
322 /* start TX early */
323 dma_async_issue_pending(master->dma_tx);
324
325 /* mark as dma pending */
326 bs->dma_pending = 1;
327
328 /* set the DMA length */
329 bcm2835_wr(bs, BCM2835_SPI_DLEN, tfr->len);
330
331 /* start the HW */
332 bcm2835_wr(bs, BCM2835_SPI_CS,
333 cs | BCM2835_SPI_CS_TA | BCM2835_SPI_CS_DMAEN);
334
335 /* setup rx-DMA late - to run transfers while
336 * mapping of the rx buffers still takes place
337 * this saves 10us or more.
338 */
339 ret = bcm2835_spi_prepare_sg(master, tfr, false);
340 if (ret) {
341 /* need to reset on errors */
342 dmaengine_terminate_all(master->dma_tx);
Lukas Wunnera0049c02018-11-08 08:06:10 +0100343 bs->dma_pending = false;
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000344 bcm2835_spi_reset_hw(master);
345 return ret;
346 }
347
348 /* start rx dma late */
349 dma_async_issue_pending(master->dma_rx);
350
351 /* wait for wakeup in framework */
352 return 1;
353}
354
355static bool bcm2835_spi_can_dma(struct spi_master *master,
356 struct spi_device *spi,
357 struct spi_transfer *tfr)
358{
359 /* only run for gpio_cs */
360 if (!gpio_is_valid(spi->cs_gpio))
361 return false;
362
363 /* we start DMA efforts only on bigger transfers */
364 if (tfr->len < BCM2835_SPI_DMA_MIN_LENGTH)
365 return false;
366
367 /* BCM2835_SPI_DLEN has defined a max transfer size as
368 * 16 bit, so max is 65535
369 * we can revisit this by using an alternative transfer
370 * method - ideally this would get done without any more
371 * interaction...
372 */
373 if (tfr->len > 65535) {
374 dev_warn_once(&spi->dev,
375 "transfer size of %d too big for dma-transfer\n",
376 tfr->len);
377 return false;
378 }
379
380 /* if we run rx/tx_buf with word aligned addresses then we are OK */
Martin Sperl7e52be02015-05-12 10:32:08 +0000381 if ((((size_t)tfr->rx_buf & 3) == 0) &&
382 (((size_t)tfr->tx_buf & 3) == 0))
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000383 return true;
384
385 /* otherwise we only allow transfers within the same page
386 * to avoid wasting time on dma_mapping when it is not practical
387 */
Martin Sperl2a3fffd2015-09-10 09:32:14 +0000388 if (((size_t)tfr->tx_buf & (PAGE_SIZE - 1)) + tfr->len > PAGE_SIZE) {
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000389 dev_warn_once(&spi->dev,
390 "Unaligned spi tx-transfer bridging page\n");
391 return false;
392 }
Martin Sperl2a3fffd2015-09-10 09:32:14 +0000393 if (((size_t)tfr->rx_buf & (PAGE_SIZE - 1)) + tfr->len > PAGE_SIZE) {
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000394 dev_warn_once(&spi->dev,
Martin Sperl2a3fffd2015-09-10 09:32:14 +0000395 "Unaligned spi rx-transfer bridging page\n");
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000396 return false;
397 }
398
399 /* return OK */
400 return true;
401}
402
kbuild test robot29ad1a72015-05-12 19:43:59 +0800403static void bcm2835_dma_release(struct spi_master *master)
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000404{
405 if (master->dma_tx) {
406 dmaengine_terminate_all(master->dma_tx);
407 dma_release_channel(master->dma_tx);
408 master->dma_tx = NULL;
409 }
410 if (master->dma_rx) {
411 dmaengine_terminate_all(master->dma_rx);
412 dma_release_channel(master->dma_rx);
413 master->dma_rx = NULL;
414 }
415}
416
kbuild test robot29ad1a72015-05-12 19:43:59 +0800417static void bcm2835_dma_init(struct spi_master *master, struct device *dev)
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000418{
419 struct dma_slave_config slave_config;
420 const __be32 *addr;
421 dma_addr_t dma_reg_base;
422 int ret;
423
424 /* base address in dma-space */
425 addr = of_get_address(master->dev.of_node, 0, NULL, NULL);
426 if (!addr) {
427 dev_err(dev, "could not get DMA-register address - not using dma mode\n");
428 goto err;
429 }
430 dma_reg_base = be32_to_cpup(addr);
431
432 /* get tx/rx dma */
433 master->dma_tx = dma_request_slave_channel(dev, "tx");
434 if (!master->dma_tx) {
435 dev_err(dev, "no tx-dma configuration found - not using dma mode\n");
436 goto err;
437 }
438 master->dma_rx = dma_request_slave_channel(dev, "rx");
439 if (!master->dma_rx) {
440 dev_err(dev, "no rx-dma configuration found - not using dma mode\n");
441 goto err_release;
442 }
443
444 /* configure DMAs */
445 slave_config.direction = DMA_MEM_TO_DEV;
446 slave_config.dst_addr = (u32)(dma_reg_base + BCM2835_SPI_FIFO);
447 slave_config.dst_addr_width = DMA_SLAVE_BUSWIDTH_4_BYTES;
448
449 ret = dmaengine_slave_config(master->dma_tx, &slave_config);
450 if (ret)
451 goto err_config;
452
453 slave_config.direction = DMA_DEV_TO_MEM;
454 slave_config.src_addr = (u32)(dma_reg_base + BCM2835_SPI_FIFO);
455 slave_config.src_addr_width = DMA_SLAVE_BUSWIDTH_4_BYTES;
456
457 ret = dmaengine_slave_config(master->dma_rx, &slave_config);
458 if (ret)
459 goto err_config;
460
461 /* all went well, so set can_dma */
462 master->can_dma = bcm2835_spi_can_dma;
463 master->max_dma_len = 65535; /* limitation by BCM2835_SPI_DLEN */
464 /* need to do TX AND RX DMA, so we need dummy buffers */
465 master->flags = SPI_MASTER_MUST_RX | SPI_MASTER_MUST_TX;
466
467 return;
468
469err_config:
470 dev_err(dev, "issue configuring dma: %d - not using DMA mode\n",
471 ret);
472err_release:
473 bcm2835_dma_release(master);
474err:
475 return;
476}
477
Martin Sperla750b122015-04-22 07:33:03 +0000478static int bcm2835_spi_transfer_one_poll(struct spi_master *master,
479 struct spi_device *spi,
480 struct spi_transfer *tfr,
481 u32 cs,
Martin Sperl0122a512015-07-29 07:34:10 +0000482 unsigned long long xfer_time_us)
Martin Sperla750b122015-04-22 07:33:03 +0000483{
484 struct bcm2835_spi *bs = spi_master_get_devdata(master);
485 unsigned long timeout;
486
487 /* enable HW block without interrupts */
488 bcm2835_wr(bs, BCM2835_SPI_CS, cs | BCM2835_SPI_CS_TA);
489
490 /* fill in the fifo before timeout calculations
491 * if we are interrupted here, then the data is
492 * getting transferred by the HW while we are interrupted
493 */
494 bcm2835_wr_fifo(bs);
495
496 /* set the timeout */
497 timeout = jiffies + BCM2835_SPI_POLLING_JIFFIES;
498
499 /* loop until finished the transfer */
500 while (bs->rx_len) {
501 /* fill in tx fifo with remaining data */
502 bcm2835_wr_fifo(bs);
503
504 /* read from fifo as much as possible */
505 bcm2835_rd_fifo(bs);
506
507 /* if there is still data pending to read
508 * then check the timeout
509 */
510 if (bs->rx_len && time_after(jiffies, timeout)) {
511 dev_dbg_ratelimited(&spi->dev,
512 "timeout period reached: jiffies: %lu remaining tx/rx: %d/%d - falling back to interrupt mode\n",
513 jiffies - timeout,
514 bs->tx_len, bs->rx_len);
515 /* fall back to interrupt mode */
516 return bcm2835_spi_transfer_one_irq(master, spi,
517 tfr, cs);
518 }
519 }
520
521 /* Transfer complete - reset SPI HW */
522 bcm2835_spi_reset_hw(master);
523 /* and return without waiting for completion */
524 return 0;
525}
526
Martin Sperl704f32d2015-04-06 17:16:30 +0000527static int bcm2835_spi_transfer_one(struct spi_master *master,
528 struct spi_device *spi,
529 struct spi_transfer *tfr)
530{
531 struct bcm2835_spi *bs = spi_master_get_devdata(master);
532 unsigned long spi_hz, clk_hz, cdiv;
Martin Sperl0122a512015-07-29 07:34:10 +0000533 unsigned long spi_used_hz;
534 unsigned long long xfer_time_us;
Martin Sperl704f32d2015-04-06 17:16:30 +0000535 u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
536
537 /* set clock */
538 spi_hz = tfr->speed_hz;
539 clk_hz = clk_get_rate(bs->clk);
540
541 if (spi_hz >= clk_hz / 2) {
542 cdiv = 2; /* clk_hz/2 is the fastest we can go */
543 } else if (spi_hz) {
544 /* CDIV must be a multiple of two */
545 cdiv = DIV_ROUND_UP(clk_hz, spi_hz);
546 cdiv += (cdiv % 2);
547
548 if (cdiv >= 65536)
549 cdiv = 0; /* 0 is the slowest we can go */
550 } else {
551 cdiv = 0; /* 0 is the slowest we can go */
552 }
553 spi_used_hz = cdiv ? (clk_hz / cdiv) : (clk_hz / 65536);
554 bcm2835_wr(bs, BCM2835_SPI_CLK, cdiv);
555
Martin Sperlacace732015-07-28 14:03:12 +0000556 /* handle all the 3-wire mode */
Lukas Wunnera89b44e2019-07-03 12:29:31 +0200557 if (spi->mode & SPI_3WIRE && tfr->rx_buf &&
558 tfr->rx_buf != master->dummy_rx)
Martin Sperl704f32d2015-04-06 17:16:30 +0000559 cs |= BCM2835_SPI_CS_REN;
Martin Sperlacace732015-07-28 14:03:12 +0000560 else
561 cs &= ~BCM2835_SPI_CS_REN;
Martin Sperl704f32d2015-04-06 17:16:30 +0000562
563 /* for gpio_cs set dummy CS so that no HW-CS get changed
564 * we can not run this in bcm2835_spi_set_cs, as it does
565 * not get called for cs_gpio cases, so we need to do it here
566 */
567 if (gpio_is_valid(spi->cs_gpio) || (spi->mode & SPI_NO_CS))
568 cs |= BCM2835_SPI_CS_CS_10 | BCM2835_SPI_CS_CS_01;
569
570 /* set transmit buffers and length */
571 bs->tx_buf = tfr->tx_buf;
572 bs->rx_buf = tfr->rx_buf;
573 bs->tx_len = tfr->len;
574 bs->rx_len = tfr->len;
575
576 /* calculate the estimated time in us the transfer runs */
Martin Sperl0122a512015-07-29 07:34:10 +0000577 xfer_time_us = (unsigned long long)tfr->len
Martin Sperl704f32d2015-04-06 17:16:30 +0000578 * 9 /* clocks/byte - SPI-HW waits 1 clock after each byte */
Martin Sperl0122a512015-07-29 07:34:10 +0000579 * 1000000;
580 do_div(xfer_time_us, spi_used_hz);
Martin Sperl704f32d2015-04-06 17:16:30 +0000581
582 /* for short requests run polling*/
583 if (xfer_time_us <= BCM2835_SPI_POLLING_LIMIT_US)
584 return bcm2835_spi_transfer_one_poll(master, spi, tfr,
585 cs, xfer_time_us);
586
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000587 /* run in dma mode if conditions are right */
588 if (master->can_dma && bcm2835_spi_can_dma(master, spi, tfr))
589 return bcm2835_spi_transfer_one_dma(master, spi, tfr, cs);
590
591 /* run in interrupt-mode */
Martin Sperl704f32d2015-04-06 17:16:30 +0000592 return bcm2835_spi_transfer_one_irq(master, spi, tfr, cs);
593}
594
Martin Sperlacace732015-07-28 14:03:12 +0000595static int bcm2835_spi_prepare_message(struct spi_master *master,
596 struct spi_message *msg)
597{
598 struct spi_device *spi = msg->spi;
599 struct bcm2835_spi *bs = spi_master_get_devdata(master);
600 u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
601
602 cs &= ~(BCM2835_SPI_CS_CPOL | BCM2835_SPI_CS_CPHA);
603
604 if (spi->mode & SPI_CPOL)
605 cs |= BCM2835_SPI_CS_CPOL;
606 if (spi->mode & SPI_CPHA)
607 cs |= BCM2835_SPI_CS_CPHA;
608
609 bcm2835_wr(bs, BCM2835_SPI_CS, cs);
610
611 return 0;
612}
613
Martin Sperle34ff012015-03-26 11:08:36 +0100614static void bcm2835_spi_handle_err(struct spi_master *master,
615 struct spi_message *msg)
Chris Bootf8043872013-03-11 21:38:24 -0600616{
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000617 struct bcm2835_spi *bs = spi_master_get_devdata(master);
618
619 /* if an error occurred and we have an active dma, then terminate */
Lukas Wunner708f7422018-11-08 08:06:10 +0100620 if (cmpxchg(&bs->dma_pending, true, false)) {
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000621 dmaengine_terminate_all(master->dma_tx);
622 dmaengine_terminate_all(master->dma_rx);
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000623 }
624 /* and reset */
Martin Sperle34ff012015-03-26 11:08:36 +0100625 bcm2835_spi_reset_hw(master);
Chris Bootf8043872013-03-11 21:38:24 -0600626}
627
Martin Sperle34ff012015-03-26 11:08:36 +0100628static void bcm2835_spi_set_cs(struct spi_device *spi, bool gpio_level)
Chris Bootf8043872013-03-11 21:38:24 -0600629{
Martin Sperle34ff012015-03-26 11:08:36 +0100630 /*
631 * we can assume that we are "native" as per spi_set_cs
632 * calling us ONLY when cs_gpio is not set
633 * we can also assume that we are CS < 3 as per bcm2835_spi_setup
634 * we would not get called because of error handling there.
635 * the level passed is the electrical level not enabled/disabled
636 * so it has to get translated back to enable/disable
637 * see spi_set_cs in spi.c for the implementation
638 */
639
640 struct spi_master *master = spi->master;
Chris Bootf8043872013-03-11 21:38:24 -0600641 struct bcm2835_spi *bs = spi_master_get_devdata(master);
Martin Sperle34ff012015-03-26 11:08:36 +0100642 u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
643 bool enable;
Chris Bootf8043872013-03-11 21:38:24 -0600644
Martin Sperle34ff012015-03-26 11:08:36 +0100645 /* calculate the enable flag from the passed gpio_level */
646 enable = (spi->mode & SPI_CS_HIGH) ? gpio_level : !gpio_level;
Chris Bootf8043872013-03-11 21:38:24 -0600647
Martin Sperle34ff012015-03-26 11:08:36 +0100648 /* set flags for "reverse" polarity in the registers */
649 if (spi->mode & SPI_CS_HIGH) {
650 /* set the correct CS-bits */
651 cs |= BCM2835_SPI_CS_CSPOL;
652 cs |= BCM2835_SPI_CS_CSPOL0 << spi->chip_select;
653 } else {
654 /* clean the CS-bits */
655 cs &= ~BCM2835_SPI_CS_CSPOL;
656 cs &= ~(BCM2835_SPI_CS_CSPOL0 << spi->chip_select);
Chris Bootf8043872013-03-11 21:38:24 -0600657 }
658
Martin Sperle34ff012015-03-26 11:08:36 +0100659 /* select the correct chip_select depending on disabled/enabled */
660 if (enable) {
661 /* set cs correctly */
662 if (spi->mode & SPI_NO_CS) {
663 /* use the "undefined" chip-select */
664 cs |= BCM2835_SPI_CS_CS_10 | BCM2835_SPI_CS_CS_01;
665 } else {
666 /* set the chip select */
667 cs &= ~(BCM2835_SPI_CS_CS_10 | BCM2835_SPI_CS_CS_01);
668 cs |= spi->chip_select;
669 }
670 } else {
671 /* disable CSPOL which puts HW-CS into deselected state */
672 cs &= ~BCM2835_SPI_CS_CSPOL;
673 /* use the "undefined" chip-select as precaution */
674 cs |= BCM2835_SPI_CS_CS_10 | BCM2835_SPI_CS_CS_01;
675 }
Chris Bootf8043872013-03-11 21:38:24 -0600676
Martin Sperle34ff012015-03-26 11:08:36 +0100677 /* finally set the calculated flags in SPI_CS */
678 bcm2835_wr(bs, BCM2835_SPI_CS, cs);
679}
680
Martin Sperla30a5552015-04-06 17:16:31 +0000681static int chip_match_name(struct gpio_chip *chip, void *data)
682{
683 return !strcmp(chip->label, data);
684}
685
Martin Sperle34ff012015-03-26 11:08:36 +0100686static int bcm2835_spi_setup(struct spi_device *spi)
687{
Martin Sperla30a5552015-04-06 17:16:31 +0000688 int err;
689 struct gpio_chip *chip;
Martin Sperle34ff012015-03-26 11:08:36 +0100690 /*
691 * sanity checking the native-chipselects
692 */
693 if (spi->mode & SPI_NO_CS)
694 return 0;
695 if (gpio_is_valid(spi->cs_gpio))
696 return 0;
Martin Sperla30a5552015-04-06 17:16:31 +0000697 if (spi->chip_select > 1) {
698 /* error in the case of native CS requested with CS > 1
699 * officially there is a CS2, but it is not documented
700 * which GPIO is connected with that...
701 */
702 dev_err(&spi->dev,
703 "setup: only two native chip-selects are supported\n");
704 return -EINVAL;
705 }
706 /* now translate native cs to GPIO */
707
708 /* get the gpio chip for the base */
709 chip = gpiochip_find("pinctrl-bcm2835", chip_match_name);
710 if (!chip)
Martin Sperle34ff012015-03-26 11:08:36 +0100711 return 0;
712
Martin Sperla30a5552015-04-06 17:16:31 +0000713 /* and calculate the real CS */
714 spi->cs_gpio = chip->base + 8 - spi->chip_select;
715
716 /* and set up the "mode" and level */
717 dev_info(&spi->dev, "setting up native-CS%i as GPIO %i\n",
718 spi->chip_select, spi->cs_gpio);
719
720 /* set up GPIO as output and pull to the correct level */
721 err = gpio_direction_output(spi->cs_gpio,
722 (spi->mode & SPI_CS_HIGH) ? 0 : 1);
723 if (err) {
724 dev_err(&spi->dev,
725 "could not set CS%i gpio %i as output: %i",
726 spi->chip_select, spi->cs_gpio, err);
727 return err;
728 }
Martin Sperla30a5552015-04-06 17:16:31 +0000729
730 return 0;
Chris Bootf8043872013-03-11 21:38:24 -0600731}
732
733static int bcm2835_spi_probe(struct platform_device *pdev)
734{
735 struct spi_master *master;
736 struct bcm2835_spi *bs;
737 struct resource *res;
738 int err;
739
740 master = spi_alloc_master(&pdev->dev, sizeof(*bs));
741 if (!master) {
742 dev_err(&pdev->dev, "spi_alloc_master() failed\n");
743 return -ENOMEM;
744 }
745
746 platform_set_drvdata(pdev, master);
747
748 master->mode_bits = BCM2835_SPI_MODE_BITS;
Axel Linc2b6a3a2013-08-05 08:43:02 +0800749 master->bits_per_word_mask = SPI_BPW_MASK(8);
Chris Bootf8043872013-03-11 21:38:24 -0600750 master->num_chipselect = 3;
Martin Sperle34ff012015-03-26 11:08:36 +0100751 master->setup = bcm2835_spi_setup;
752 master->set_cs = bcm2835_spi_set_cs;
753 master->transfer_one = bcm2835_spi_transfer_one;
754 master->handle_err = bcm2835_spi_handle_err;
Martin Sperlacace732015-07-28 14:03:12 +0000755 master->prepare_message = bcm2835_spi_prepare_message;
Chris Bootf8043872013-03-11 21:38:24 -0600756 master->dev.of_node = pdev->dev.of_node;
757
758 bs = spi_master_get_devdata(master);
759
Chris Bootf8043872013-03-11 21:38:24 -0600760 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
Laurent Navet2d6e75e2013-05-02 14:13:30 +0200761 bs->regs = devm_ioremap_resource(&pdev->dev, res);
762 if (IS_ERR(bs->regs)) {
763 err = PTR_ERR(bs->regs);
Chris Bootf8043872013-03-11 21:38:24 -0600764 goto out_master_put;
765 }
766
767 bs->clk = devm_clk_get(&pdev->dev, NULL);
768 if (IS_ERR(bs->clk)) {
769 err = PTR_ERR(bs->clk);
770 dev_err(&pdev->dev, "could not get clk: %d\n", err);
771 goto out_master_put;
772 }
773
Martin Sperlddf0e1c2015-10-15 10:09:11 +0000774 bs->irq = platform_get_irq(pdev, 0);
Chris Bootf8043872013-03-11 21:38:24 -0600775 if (bs->irq <= 0) {
776 dev_err(&pdev->dev, "could not get IRQ: %d\n", bs->irq);
777 err = bs->irq ? bs->irq : -ENODEV;
778 goto out_master_put;
779 }
780
781 clk_prepare_enable(bs->clk);
782
Martin Sperlddf0e1c2015-10-15 10:09:11 +0000783 bcm2835_dma_init(master, &pdev->dev);
784
785 /* initialise the hardware with the default polarities */
786 bcm2835_wr(bs, BCM2835_SPI_CS,
787 BCM2835_SPI_CS_CLEAR_RX | BCM2835_SPI_CS_CLEAR_TX);
788
Jingoo Han08bc0542013-12-09 19:25:00 +0900789 err = devm_request_irq(&pdev->dev, bs->irq, bcm2835_spi_interrupt, 0,
Martin Sperl342f9482015-03-20 15:26:11 +0100790 dev_name(&pdev->dev), master);
Chris Bootf8043872013-03-11 21:38:24 -0600791 if (err) {
792 dev_err(&pdev->dev, "could not request IRQ: %d\n", err);
793 goto out_clk_disable;
794 }
795
Jingoo Han247263d2013-09-24 13:23:00 +0900796 err = devm_spi_register_master(&pdev->dev, master);
Chris Bootf8043872013-03-11 21:38:24 -0600797 if (err) {
798 dev_err(&pdev->dev, "could not register SPI master: %d\n", err);
Jingoo Han08bc0542013-12-09 19:25:00 +0900799 goto out_clk_disable;
Chris Bootf8043872013-03-11 21:38:24 -0600800 }
801
802 return 0;
803
Chris Bootf8043872013-03-11 21:38:24 -0600804out_clk_disable:
805 clk_disable_unprepare(bs->clk);
806out_master_put:
807 spi_master_put(master);
808 return err;
809}
810
811static int bcm2835_spi_remove(struct platform_device *pdev)
812{
Wei Yongjune0b35b82013-11-15 15:43:27 +0800813 struct spi_master *master = platform_get_drvdata(pdev);
Chris Bootf8043872013-03-11 21:38:24 -0600814 struct bcm2835_spi *bs = spi_master_get_devdata(master);
815
Chris Bootf8043872013-03-11 21:38:24 -0600816 /* Clear FIFOs, and disable the HW block */
817 bcm2835_wr(bs, BCM2835_SPI_CS,
818 BCM2835_SPI_CS_CLEAR_RX | BCM2835_SPI_CS_CLEAR_TX);
819
820 clk_disable_unprepare(bs->clk);
Chris Bootf8043872013-03-11 21:38:24 -0600821
Martin Sperl3ecd37e2015-05-10 20:47:28 +0000822 bcm2835_dma_release(master);
823
Chris Bootf8043872013-03-11 21:38:24 -0600824 return 0;
825}
826
827static const struct of_device_id bcm2835_spi_match[] = {
828 { .compatible = "brcm,bcm2835-spi", },
829 {}
830};
831MODULE_DEVICE_TABLE(of, bcm2835_spi_match);
832
833static struct platform_driver bcm2835_spi_driver = {
834 .driver = {
835 .name = DRV_NAME,
Chris Bootf8043872013-03-11 21:38:24 -0600836 .of_match_table = bcm2835_spi_match,
837 },
838 .probe = bcm2835_spi_probe,
839 .remove = bcm2835_spi_remove,
840};
841module_platform_driver(bcm2835_spi_driver);
842
843MODULE_DESCRIPTION("SPI controller driver for Broadcom BCM2835");
844MODULE_AUTHOR("Chris Boot <bootc@bootc.net>");
845MODULE_LICENSE("GPL v2");