2013-03-12 10:38:24 +07:00
|
|
|
/*
|
|
|
|
* Driver for Broadcom BCM2835 SPI Controllers
|
|
|
|
*
|
|
|
|
* Copyright (C) 2012 Chris Boot
|
|
|
|
* Copyright (C) 2013 Stephen Warren
|
2015-03-26 17:08:36 +07:00
|
|
|
* Copyright (C) 2015 Martin Sperl
|
2013-03-12 10:38:24 +07:00
|
|
|
*
|
|
|
|
* This driver is inspired by:
|
|
|
|
* spi-ath79.c, Copyright (C) 2009-2011 Gabor Juhos <juhosg@openwrt.org>
|
|
|
|
* spi-atmel.c, Copyright (C) 2006 Atmel Corporation
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include <linux/clk.h>
|
|
|
|
#include <linux/completion.h>
|
|
|
|
#include <linux/delay.h>
|
2015-05-11 03:47:28 +07:00
|
|
|
#include <linux/dma-mapping.h>
|
|
|
|
#include <linux/dmaengine.h>
|
2013-03-12 10:38:24 +07:00
|
|
|
#include <linux/err.h>
|
|
|
|
#include <linux/interrupt.h>
|
|
|
|
#include <linux/io.h>
|
|
|
|
#include <linux/kernel.h>
|
|
|
|
#include <linux/module.h>
|
|
|
|
#include <linux/of.h>
|
2015-05-11 03:47:28 +07:00
|
|
|
#include <linux/of_address.h>
|
2013-03-12 10:38:24 +07:00
|
|
|
#include <linux/of_device.h>
|
2015-05-11 03:47:28 +07:00
|
|
|
#include <linux/of_gpio.h>
|
|
|
|
#include <linux/of_irq.h>
|
2013-03-12 10:38:24 +07:00
|
|
|
#include <linux/spi/spi.h>
|
|
|
|
|
|
|
|
/* SPI register offsets */
|
|
|
|
#define BCM2835_SPI_CS 0x00
|
|
|
|
#define BCM2835_SPI_FIFO 0x04
|
|
|
|
#define BCM2835_SPI_CLK 0x08
|
|
|
|
#define BCM2835_SPI_DLEN 0x0c
|
|
|
|
#define BCM2835_SPI_LTOH 0x10
|
|
|
|
#define BCM2835_SPI_DC 0x14
|
|
|
|
|
|
|
|
/* Bitfields in CS */
|
|
|
|
#define BCM2835_SPI_CS_LEN_LONG 0x02000000
|
|
|
|
#define BCM2835_SPI_CS_DMA_LEN 0x01000000
|
|
|
|
#define BCM2835_SPI_CS_CSPOL2 0x00800000
|
|
|
|
#define BCM2835_SPI_CS_CSPOL1 0x00400000
|
|
|
|
#define BCM2835_SPI_CS_CSPOL0 0x00200000
|
|
|
|
#define BCM2835_SPI_CS_RXF 0x00100000
|
|
|
|
#define BCM2835_SPI_CS_RXR 0x00080000
|
|
|
|
#define BCM2835_SPI_CS_TXD 0x00040000
|
|
|
|
#define BCM2835_SPI_CS_RXD 0x00020000
|
|
|
|
#define BCM2835_SPI_CS_DONE 0x00010000
|
|
|
|
#define BCM2835_SPI_CS_LEN 0x00002000
|
|
|
|
#define BCM2835_SPI_CS_REN 0x00001000
|
|
|
|
#define BCM2835_SPI_CS_ADCS 0x00000800
|
|
|
|
#define BCM2835_SPI_CS_INTR 0x00000400
|
|
|
|
#define BCM2835_SPI_CS_INTD 0x00000200
|
|
|
|
#define BCM2835_SPI_CS_DMAEN 0x00000100
|
|
|
|
#define BCM2835_SPI_CS_TA 0x00000080
|
|
|
|
#define BCM2835_SPI_CS_CSPOL 0x00000040
|
|
|
|
#define BCM2835_SPI_CS_CLEAR_RX 0x00000020
|
|
|
|
#define BCM2835_SPI_CS_CLEAR_TX 0x00000010
|
|
|
|
#define BCM2835_SPI_CS_CPOL 0x00000008
|
|
|
|
#define BCM2835_SPI_CS_CPHA 0x00000004
|
|
|
|
#define BCM2835_SPI_CS_CS_10 0x00000002
|
|
|
|
#define BCM2835_SPI_CS_CS_01 0x00000001
|
|
|
|
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
#define BCM2835_SPI_FIFO_SIZE 64
|
|
|
|
#define BCM2835_SPI_FIFO_SIZE_3_4 48
|
2015-04-07 00:16:30 +07:00
|
|
|
#define BCM2835_SPI_POLLING_LIMIT_US 30
|
2015-04-22 14:33:03 +07:00
|
|
|
#define BCM2835_SPI_POLLING_JIFFIES 2
|
2015-05-11 03:47:28 +07:00
|
|
|
#define BCM2835_SPI_DMA_MIN_LENGTH 96
|
2015-03-19 16:01:53 +07:00
|
|
|
#define BCM2835_SPI_MODE_BITS (SPI_CPOL | SPI_CPHA | SPI_CS_HIGH \
|
|
|
|
| SPI_NO_CS | SPI_3WIRE)
|
2013-03-12 10:38:24 +07:00
|
|
|
|
|
|
|
#define DRV_NAME "spi-bcm2835"
|
|
|
|
|
2018-11-08 14:06:10 +07:00
|
|
|
/**
|
|
|
|
* struct bcm2835_spi - BCM2835 SPI controller
|
|
|
|
* @regs: base address of register map
|
|
|
|
* @clk: core clock, divided to calculate serial clock
|
|
|
|
* @irq: interrupt, signals TX FIFO empty or RX FIFO ¾ full
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
* @tfr: SPI transfer currently processed
|
2018-11-08 14:06:10 +07:00
|
|
|
* @tx_buf: pointer whence next transmitted byte is read
|
|
|
|
* @rx_buf: pointer where next received byte is written
|
|
|
|
* @tx_len: remaining bytes to transmit
|
|
|
|
* @rx_len: remaining bytes to receive
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
* @tx_prologue: bytes transmitted without DMA if first TX sglist entry's
|
|
|
|
* length is not a multiple of 4 (to overcome hardware limitation)
|
|
|
|
* @rx_prologue: bytes received without DMA if first RX sglist entry's
|
|
|
|
* length is not a multiple of 4 (to overcome hardware limitation)
|
|
|
|
* @tx_spillover: whether @tx_prologue spills over to second TX sglist entry
|
2018-11-08 14:06:10 +07:00
|
|
|
* @dma_pending: whether a DMA transfer is in progress
|
|
|
|
*/
|
2013-03-12 10:38:24 +07:00
|
|
|
struct bcm2835_spi {
|
|
|
|
void __iomem *regs;
|
|
|
|
struct clk *clk;
|
|
|
|
int irq;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
struct spi_transfer *tfr;
|
2013-03-12 10:38:24 +07:00
|
|
|
const u8 *tx_buf;
|
|
|
|
u8 *rx_buf;
|
2015-03-26 17:08:36 +07:00
|
|
|
int tx_len;
|
|
|
|
int rx_len;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
int tx_prologue;
|
|
|
|
int rx_prologue;
|
2018-11-29 22:45:24 +07:00
|
|
|
unsigned int tx_spillover;
|
2018-11-29 21:14:49 +07:00
|
|
|
unsigned int dma_pending;
|
2013-03-12 10:38:24 +07:00
|
|
|
};
|
|
|
|
|
|
|
|
static inline u32 bcm2835_rd(struct bcm2835_spi *bs, unsigned reg)
|
|
|
|
{
|
|
|
|
return readl(bs->regs + reg);
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline void bcm2835_wr(struct bcm2835_spi *bs, unsigned reg, u32 val)
|
|
|
|
{
|
|
|
|
writel(val, bs->regs + reg);
|
|
|
|
}
|
|
|
|
|
2015-03-23 21:11:53 +07:00
|
|
|
static inline void bcm2835_rd_fifo(struct bcm2835_spi *bs)
|
2013-03-12 10:38:24 +07:00
|
|
|
{
|
|
|
|
u8 byte;
|
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
while ((bs->rx_len) &&
|
|
|
|
(bcm2835_rd(bs, BCM2835_SPI_CS) & BCM2835_SPI_CS_RXD)) {
|
2013-03-12 10:38:24 +07:00
|
|
|
byte = bcm2835_rd(bs, BCM2835_SPI_FIFO);
|
|
|
|
if (bs->rx_buf)
|
|
|
|
*bs->rx_buf++ = byte;
|
2015-03-26 17:08:36 +07:00
|
|
|
bs->rx_len--;
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-03-23 21:11:53 +07:00
|
|
|
static inline void bcm2835_wr_fifo(struct bcm2835_spi *bs)
|
2013-03-12 10:38:24 +07:00
|
|
|
{
|
|
|
|
u8 byte;
|
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
while ((bs->tx_len) &&
|
2015-03-23 21:11:53 +07:00
|
|
|
(bcm2835_rd(bs, BCM2835_SPI_CS) & BCM2835_SPI_CS_TXD)) {
|
2013-03-12 10:38:24 +07:00
|
|
|
byte = bs->tx_buf ? *bs->tx_buf++ : 0;
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_FIFO, byte);
|
2015-03-26 17:08:36 +07:00
|
|
|
bs->tx_len--;
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
/**
|
|
|
|
* bcm2835_rd_fifo_count() - blindly read exactly @count bytes from RX FIFO
|
|
|
|
* @bs: BCM2835 SPI controller
|
|
|
|
* @count: bytes to read from RX FIFO
|
|
|
|
*
|
|
|
|
* The caller must ensure that @bs->rx_len is greater than or equal to @count,
|
|
|
|
* that the RX FIFO contains at least @count bytes and that the DMA Enable flag
|
|
|
|
* in the CS register is set (such that a read from the FIFO register receives
|
2018-11-29 22:45:24 +07:00
|
|
|
* 32-bit instead of just 8-bit). Moreover @bs->rx_buf must not be %NULL.
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
*/
|
|
|
|
static inline void bcm2835_rd_fifo_count(struct bcm2835_spi *bs, int count)
|
|
|
|
{
|
|
|
|
u32 val;
|
2018-11-29 22:45:24 +07:00
|
|
|
int len;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
|
|
|
|
bs->rx_len -= count;
|
|
|
|
|
|
|
|
while (count > 0) {
|
|
|
|
val = bcm2835_rd(bs, BCM2835_SPI_FIFO);
|
2018-11-29 22:45:24 +07:00
|
|
|
len = min(count, 4);
|
|
|
|
memcpy(bs->rx_buf, &val, len);
|
|
|
|
bs->rx_buf += len;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
count -= 4;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* bcm2835_wr_fifo_count() - blindly write exactly @count bytes to TX FIFO
|
|
|
|
* @bs: BCM2835 SPI controller
|
|
|
|
* @count: bytes to write to TX FIFO
|
|
|
|
*
|
|
|
|
* The caller must ensure that @bs->tx_len is greater than or equal to @count,
|
|
|
|
* that the TX FIFO can accommodate @count bytes and that the DMA Enable flag
|
|
|
|
* in the CS register is set (such that a write to the FIFO register transmits
|
|
|
|
* 32-bit instead of just 8-bit).
|
|
|
|
*/
|
|
|
|
static inline void bcm2835_wr_fifo_count(struct bcm2835_spi *bs, int count)
|
|
|
|
{
|
|
|
|
u32 val;
|
2018-11-29 22:45:24 +07:00
|
|
|
int len;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
|
|
|
|
bs->tx_len -= count;
|
|
|
|
|
|
|
|
while (count > 0) {
|
|
|
|
if (bs->tx_buf) {
|
2018-11-29 22:45:24 +07:00
|
|
|
len = min(count, 4);
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
memcpy(&val, bs->tx_buf, len);
|
|
|
|
bs->tx_buf += len;
|
|
|
|
} else {
|
|
|
|
val = 0;
|
|
|
|
}
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_FIFO, val);
|
|
|
|
count -= 4;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* bcm2835_wait_tx_fifo_empty() - busy-wait for TX FIFO to empty
|
|
|
|
* @bs: BCM2835 SPI controller
|
2018-11-29 22:45:24 +07:00
|
|
|
*
|
|
|
|
* The caller must ensure that the RX FIFO can accommodate as many bytes
|
|
|
|
* as have been written to the TX FIFO: Transmission is halted once the
|
|
|
|
* RX FIFO is full, causing this function to spin forever.
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
*/
|
|
|
|
static inline void bcm2835_wait_tx_fifo_empty(struct bcm2835_spi *bs)
|
|
|
|
{
|
|
|
|
while (!(bcm2835_rd(bs, BCM2835_SPI_CS) & BCM2835_SPI_CS_DONE))
|
|
|
|
cpu_relax();
|
|
|
|
}
|
|
|
|
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
/**
|
|
|
|
* bcm2835_rd_fifo_blind() - blindly read up to @count bytes from RX FIFO
|
|
|
|
* @bs: BCM2835 SPI controller
|
|
|
|
* @count: bytes available for reading in RX FIFO
|
|
|
|
*/
|
|
|
|
static inline void bcm2835_rd_fifo_blind(struct bcm2835_spi *bs, int count)
|
|
|
|
{
|
|
|
|
u8 val;
|
|
|
|
|
|
|
|
count = min(count, bs->rx_len);
|
|
|
|
bs->rx_len -= count;
|
|
|
|
|
|
|
|
while (count) {
|
|
|
|
val = bcm2835_rd(bs, BCM2835_SPI_FIFO);
|
|
|
|
if (bs->rx_buf)
|
|
|
|
*bs->rx_buf++ = val;
|
|
|
|
count--;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* bcm2835_wr_fifo_blind() - blindly write up to @count bytes to TX FIFO
|
|
|
|
* @bs: BCM2835 SPI controller
|
|
|
|
* @count: bytes available for writing in TX FIFO
|
|
|
|
*/
|
|
|
|
static inline void bcm2835_wr_fifo_blind(struct bcm2835_spi *bs, int count)
|
|
|
|
{
|
|
|
|
u8 val;
|
|
|
|
|
|
|
|
count = min(count, bs->tx_len);
|
|
|
|
bs->tx_len -= count;
|
|
|
|
|
|
|
|
while (count) {
|
|
|
|
val = bs->tx_buf ? *bs->tx_buf++ : 0;
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_FIFO, val);
|
|
|
|
count--;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
static void bcm2835_spi_reset_hw(struct spi_master *master)
|
|
|
|
{
|
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
|
|
|
|
|
|
|
|
/* Disable SPI interrupts and transfer */
|
|
|
|
cs &= ~(BCM2835_SPI_CS_INTR |
|
|
|
|
BCM2835_SPI_CS_INTD |
|
2015-05-11 03:47:28 +07:00
|
|
|
BCM2835_SPI_CS_DMAEN |
|
2015-03-26 17:08:36 +07:00
|
|
|
BCM2835_SPI_CS_TA);
|
|
|
|
/* and reset RX/TX FIFOS */
|
|
|
|
cs |= BCM2835_SPI_CS_CLEAR_RX | BCM2835_SPI_CS_CLEAR_TX;
|
|
|
|
|
|
|
|
/* and reset the SPI_HW */
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs);
|
2015-05-11 03:47:28 +07:00
|
|
|
/* as well as DLEN */
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_DLEN, 0);
|
2015-03-26 17:08:36 +07:00
|
|
|
}
|
|
|
|
|
2013-03-12 10:38:24 +07:00
|
|
|
static irqreturn_t bcm2835_spi_interrupt(int irq, void *dev_id)
|
|
|
|
{
|
|
|
|
struct spi_master *master = dev_id;
|
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
|
|
|
|
|
|
|
|
/*
|
|
|
|
* An interrupt is signaled either if DONE is set (TX FIFO empty)
|
|
|
|
* or if RXR is set (RX FIFO >= ¾ full).
|
|
|
|
*/
|
|
|
|
if (cs & BCM2835_SPI_CS_RXF)
|
|
|
|
bcm2835_rd_fifo_blind(bs, BCM2835_SPI_FIFO_SIZE);
|
|
|
|
else if (cs & BCM2835_SPI_CS_RXR)
|
|
|
|
bcm2835_rd_fifo_blind(bs, BCM2835_SPI_FIFO_SIZE_3_4);
|
|
|
|
|
|
|
|
if (bs->tx_len && cs & BCM2835_SPI_CS_DONE)
|
|
|
|
bcm2835_wr_fifo_blind(bs, BCM2835_SPI_FIFO_SIZE);
|
2013-03-12 10:38:24 +07:00
|
|
|
|
2015-03-23 21:11:53 +07:00
|
|
|
/* Read as many bytes as possible from FIFO */
|
|
|
|
bcm2835_rd_fifo(bs);
|
2015-03-26 17:08:36 +07:00
|
|
|
/* Write as many bytes as possible to FIFO */
|
|
|
|
bcm2835_wr_fifo(bs);
|
|
|
|
|
2018-11-08 14:06:10 +07:00
|
|
|
if (!bs->rx_len) {
|
2015-03-26 17:08:36 +07:00
|
|
|
/* Transfer complete - reset SPI HW */
|
|
|
|
bcm2835_spi_reset_hw(master);
|
|
|
|
/* wake up the framework */
|
|
|
|
complete(&master->xfer_completion);
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
|
2015-03-23 21:11:53 +07:00
|
|
|
return IRQ_HANDLED;
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
|
2015-04-07 00:16:30 +07:00
|
|
|
static int bcm2835_spi_transfer_one_irq(struct spi_master *master,
|
|
|
|
struct spi_device *spi,
|
|
|
|
struct spi_transfer *tfr,
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
u32 cs, bool fifo_empty)
|
2015-04-07 00:16:30 +07:00
|
|
|
{
|
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
|
|
|
|
/*
|
2018-11-08 14:06:10 +07:00
|
|
|
* Enable HW block, but with interrupts still disabled.
|
|
|
|
* Otherwise the empty TX FIFO would immediately trigger an interrupt.
|
2015-04-07 00:16:30 +07:00
|
|
|
*/
|
2018-11-08 14:06:10 +07:00
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs | BCM2835_SPI_CS_TA);
|
|
|
|
|
|
|
|
/* fill TX FIFO as much as possible */
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
if (fifo_empty)
|
|
|
|
bcm2835_wr_fifo_blind(bs, BCM2835_SPI_FIFO_SIZE);
|
2018-11-08 14:06:10 +07:00
|
|
|
bcm2835_wr_fifo(bs);
|
|
|
|
|
|
|
|
/* enable interrupts */
|
2015-04-07 00:16:30 +07:00
|
|
|
cs |= BCM2835_SPI_CS_INTR | BCM2835_SPI_CS_INTD | BCM2835_SPI_CS_TA;
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs);
|
|
|
|
|
|
|
|
/* signal that we need to wait for completion */
|
|
|
|
return 1;
|
|
|
|
}
|
|
|
|
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
/**
|
|
|
|
* bcm2835_spi_transfer_prologue() - transfer first few bytes without DMA
|
|
|
|
* @master: SPI master
|
|
|
|
* @tfr: SPI transfer
|
|
|
|
* @bs: BCM2835 SPI controller
|
|
|
|
* @cs: CS register
|
|
|
|
*
|
|
|
|
* A limitation in DMA mode is that the FIFO must be accessed in 4 byte chunks.
|
|
|
|
* Only the final write access is permitted to transmit less than 4 bytes, the
|
|
|
|
* SPI controller deduces its intended size from the DLEN register.
|
|
|
|
*
|
|
|
|
* If a TX or RX sglist contains multiple entries, one per page, and the first
|
|
|
|
* entry starts in the middle of a page, that first entry's length may not be
|
|
|
|
* a multiple of 4. Subsequent entries are fine because they span an entire
|
|
|
|
* page, hence do have a length that's a multiple of 4.
|
|
|
|
*
|
|
|
|
* This cannot happen with kmalloc'ed buffers (which is what most clients use)
|
|
|
|
* because they are contiguous in physical memory and therefore not split on
|
|
|
|
* page boundaries by spi_map_buf(). But it *can* happen with vmalloc'ed
|
|
|
|
* buffers.
|
|
|
|
*
|
|
|
|
* The DMA engine is incapable of combining sglist entries into a continuous
|
|
|
|
* stream of 4 byte chunks, it treats every entry separately: A TX entry is
|
|
|
|
* rounded up a to a multiple of 4 bytes by transmitting surplus bytes, an RX
|
|
|
|
* entry is rounded up by throwing away received bytes.
|
|
|
|
*
|
|
|
|
* Overcome this limitation by transferring the first few bytes without DMA:
|
|
|
|
* E.g. if the first TX sglist entry's length is 23 and the first RX's is 42,
|
|
|
|
* write 3 bytes to the TX FIFO but read only 2 bytes from the RX FIFO.
|
|
|
|
* The residue of 1 byte in the RX FIFO is picked up by DMA. Together with
|
|
|
|
* the rest of the first RX sglist entry it makes up a multiple of 4 bytes.
|
|
|
|
*
|
|
|
|
* Should the RX prologue be larger, say, 3 vis-à-vis a TX prologue of 1,
|
|
|
|
* write 1 + 4 = 5 bytes to the TX FIFO and read 3 bytes from the RX FIFO.
|
|
|
|
* Caution, the additional 4 bytes spill over to the second TX sglist entry
|
|
|
|
* if the length of the first is *exactly* 1.
|
|
|
|
*
|
|
|
|
* At most 6 bytes are written and at most 3 bytes read. Do we know the
|
|
|
|
* transfer has this many bytes? Yes, see BCM2835_SPI_DMA_MIN_LENGTH.
|
|
|
|
*
|
|
|
|
* The FIFO is normally accessed with 8-bit width by the CPU and 32-bit width
|
|
|
|
* by the DMA engine. Toggling the DMA Enable flag in the CS register switches
|
|
|
|
* the width but also garbles the FIFO's contents. The prologue must therefore
|
|
|
|
* be transmitted in 32-bit width to ensure that the following DMA transfer can
|
|
|
|
* pick up the residue in the RX FIFO in ungarbled form.
|
|
|
|
*/
|
|
|
|
static void bcm2835_spi_transfer_prologue(struct spi_master *master,
|
|
|
|
struct spi_transfer *tfr,
|
|
|
|
struct bcm2835_spi *bs,
|
|
|
|
u32 cs)
|
|
|
|
{
|
|
|
|
int tx_remaining;
|
|
|
|
|
|
|
|
bs->tfr = tfr;
|
|
|
|
bs->tx_prologue = 0;
|
|
|
|
bs->rx_prologue = 0;
|
|
|
|
bs->tx_spillover = false;
|
|
|
|
|
|
|
|
if (!sg_is_last(&tfr->tx_sg.sgl[0]))
|
|
|
|
bs->tx_prologue = sg_dma_len(&tfr->tx_sg.sgl[0]) & 3;
|
|
|
|
|
|
|
|
if (!sg_is_last(&tfr->rx_sg.sgl[0])) {
|
|
|
|
bs->rx_prologue = sg_dma_len(&tfr->rx_sg.sgl[0]) & 3;
|
|
|
|
|
|
|
|
if (bs->rx_prologue > bs->tx_prologue) {
|
|
|
|
if (sg_is_last(&tfr->tx_sg.sgl[0])) {
|
|
|
|
bs->tx_prologue = bs->rx_prologue;
|
|
|
|
} else {
|
|
|
|
bs->tx_prologue += 4;
|
|
|
|
bs->tx_spillover =
|
|
|
|
!(sg_dma_len(&tfr->tx_sg.sgl[0]) & ~3);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* rx_prologue > 0 implies tx_prologue > 0, so check only the latter */
|
|
|
|
if (!bs->tx_prologue)
|
|
|
|
return;
|
|
|
|
|
|
|
|
/* Write and read RX prologue. Adjust first entry in RX sglist. */
|
|
|
|
if (bs->rx_prologue) {
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_DLEN, bs->rx_prologue);
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs | BCM2835_SPI_CS_TA
|
|
|
|
| BCM2835_SPI_CS_DMAEN);
|
|
|
|
bcm2835_wr_fifo_count(bs, bs->rx_prologue);
|
|
|
|
bcm2835_wait_tx_fifo_empty(bs);
|
|
|
|
bcm2835_rd_fifo_count(bs, bs->rx_prologue);
|
|
|
|
bcm2835_spi_reset_hw(master);
|
|
|
|
|
2018-11-29 22:45:24 +07:00
|
|
|
dma_sync_single_for_device(master->dma_rx->device->dev,
|
|
|
|
sg_dma_address(&tfr->rx_sg.sgl[0]),
|
|
|
|
bs->rx_prologue, DMA_FROM_DEVICE);
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
|
2018-11-29 22:45:24 +07:00
|
|
|
sg_dma_address(&tfr->rx_sg.sgl[0]) += bs->rx_prologue;
|
|
|
|
sg_dma_len(&tfr->rx_sg.sgl[0]) -= bs->rx_prologue;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Write remaining TX prologue. Adjust first entry in TX sglist.
|
|
|
|
* Also adjust second entry if prologue spills over to it.
|
|
|
|
*/
|
|
|
|
tx_remaining = bs->tx_prologue - bs->rx_prologue;
|
|
|
|
if (tx_remaining) {
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_DLEN, tx_remaining);
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs | BCM2835_SPI_CS_TA
|
|
|
|
| BCM2835_SPI_CS_DMAEN);
|
|
|
|
bcm2835_wr_fifo_count(bs, tx_remaining);
|
|
|
|
bcm2835_wait_tx_fifo_empty(bs);
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs | BCM2835_SPI_CS_CLEAR_TX);
|
|
|
|
}
|
|
|
|
|
|
|
|
if (likely(!bs->tx_spillover)) {
|
2018-11-29 22:45:24 +07:00
|
|
|
sg_dma_address(&tfr->tx_sg.sgl[0]) += bs->tx_prologue;
|
|
|
|
sg_dma_len(&tfr->tx_sg.sgl[0]) -= bs->tx_prologue;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
} else {
|
2018-11-29 22:45:24 +07:00
|
|
|
sg_dma_len(&tfr->tx_sg.sgl[0]) = 0;
|
|
|
|
sg_dma_address(&tfr->tx_sg.sgl[1]) += 4;
|
|
|
|
sg_dma_len(&tfr->tx_sg.sgl[1]) -= 4;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* bcm2835_spi_undo_prologue() - reconstruct original sglist state
|
|
|
|
* @bs: BCM2835 SPI controller
|
|
|
|
*
|
|
|
|
* Undo changes which were made to an SPI transfer's sglist when transmitting
|
|
|
|
* the prologue. This is necessary to ensure the same memory ranges are
|
|
|
|
* unmapped that were originally mapped.
|
|
|
|
*/
|
|
|
|
static void bcm2835_spi_undo_prologue(struct bcm2835_spi *bs)
|
|
|
|
{
|
|
|
|
struct spi_transfer *tfr = bs->tfr;
|
|
|
|
|
|
|
|
if (!bs->tx_prologue)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (bs->rx_prologue) {
|
2018-11-29 22:45:24 +07:00
|
|
|
sg_dma_address(&tfr->rx_sg.sgl[0]) -= bs->rx_prologue;
|
|
|
|
sg_dma_len(&tfr->rx_sg.sgl[0]) += bs->rx_prologue;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
}
|
|
|
|
|
|
|
|
if (likely(!bs->tx_spillover)) {
|
2018-11-29 22:45:24 +07:00
|
|
|
sg_dma_address(&tfr->tx_sg.sgl[0]) -= bs->tx_prologue;
|
|
|
|
sg_dma_len(&tfr->tx_sg.sgl[0]) += bs->tx_prologue;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
} else {
|
2018-11-29 22:45:24 +07:00
|
|
|
sg_dma_len(&tfr->tx_sg.sgl[0]) = bs->tx_prologue - 4;
|
|
|
|
sg_dma_address(&tfr->tx_sg.sgl[1]) -= 4;
|
|
|
|
sg_dma_len(&tfr->tx_sg.sgl[1]) += 4;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-05-11 03:47:28 +07:00
|
|
|
static void bcm2835_spi_dma_done(void *data)
|
|
|
|
{
|
|
|
|
struct spi_master *master = data;
|
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
|
|
|
|
/* reset fifo and HW */
|
|
|
|
bcm2835_spi_reset_hw(master);
|
|
|
|
|
|
|
|
/* and terminate tx-dma as we do not have an irq for it
|
|
|
|
* because when the rx dma will terminate and this callback
|
|
|
|
* is called the tx-dma must have finished - can't get to this
|
|
|
|
* situation otherwise...
|
|
|
|
*/
|
2018-11-08 14:06:10 +07:00
|
|
|
if (cmpxchg(&bs->dma_pending, true, false)) {
|
2018-11-29 22:45:24 +07:00
|
|
|
dmaengine_terminate_async(master->dma_tx);
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
bcm2835_spi_undo_prologue(bs);
|
2018-11-08 14:06:10 +07:00
|
|
|
}
|
2015-05-11 03:47:28 +07:00
|
|
|
|
|
|
|
/* and mark as completed */;
|
|
|
|
complete(&master->xfer_completion);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int bcm2835_spi_prepare_sg(struct spi_master *master,
|
|
|
|
struct spi_transfer *tfr,
|
|
|
|
bool is_tx)
|
|
|
|
{
|
|
|
|
struct dma_chan *chan;
|
|
|
|
struct scatterlist *sgl;
|
|
|
|
unsigned int nents;
|
|
|
|
enum dma_transfer_direction dir;
|
|
|
|
unsigned long flags;
|
|
|
|
|
|
|
|
struct dma_async_tx_descriptor *desc;
|
|
|
|
dma_cookie_t cookie;
|
|
|
|
|
|
|
|
if (is_tx) {
|
|
|
|
dir = DMA_MEM_TO_DEV;
|
|
|
|
chan = master->dma_tx;
|
|
|
|
nents = tfr->tx_sg.nents;
|
|
|
|
sgl = tfr->tx_sg.sgl;
|
|
|
|
flags = 0 /* no tx interrupt */;
|
|
|
|
|
|
|
|
} else {
|
|
|
|
dir = DMA_DEV_TO_MEM;
|
|
|
|
chan = master->dma_rx;
|
|
|
|
nents = tfr->rx_sg.nents;
|
|
|
|
sgl = tfr->rx_sg.sgl;
|
|
|
|
flags = DMA_PREP_INTERRUPT;
|
|
|
|
}
|
|
|
|
/* prepare the channel */
|
|
|
|
desc = dmaengine_prep_slave_sg(chan, sgl, nents, dir, flags);
|
|
|
|
if (!desc)
|
|
|
|
return -EINVAL;
|
|
|
|
|
|
|
|
/* set callback for rx */
|
|
|
|
if (!is_tx) {
|
|
|
|
desc->callback = bcm2835_spi_dma_done;
|
|
|
|
desc->callback_param = master;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* submit it to DMA-engine */
|
|
|
|
cookie = dmaengine_submit(desc);
|
|
|
|
|
|
|
|
return dma_submit_error(cookie);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int bcm2835_spi_transfer_one_dma(struct spi_master *master,
|
|
|
|
struct spi_device *spi,
|
|
|
|
struct spi_transfer *tfr,
|
|
|
|
u32 cs)
|
|
|
|
{
|
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
int ret;
|
|
|
|
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
/*
|
|
|
|
* Transfer first few bytes without DMA if length of first TX or RX
|
|
|
|
* sglist entry is not a multiple of 4 bytes (hardware limitation).
|
|
|
|
*/
|
|
|
|
bcm2835_spi_transfer_prologue(master, tfr, bs, cs);
|
2015-05-11 03:47:28 +07:00
|
|
|
|
|
|
|
/* setup tx-DMA */
|
|
|
|
ret = bcm2835_spi_prepare_sg(master, tfr, true);
|
|
|
|
if (ret)
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
goto err_reset_hw;
|
2015-05-11 03:47:28 +07:00
|
|
|
|
|
|
|
/* start TX early */
|
|
|
|
dma_async_issue_pending(master->dma_tx);
|
|
|
|
|
|
|
|
/* mark as dma pending */
|
|
|
|
bs->dma_pending = 1;
|
|
|
|
|
|
|
|
/* set the DMA length */
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
bcm2835_wr(bs, BCM2835_SPI_DLEN, bs->tx_len);
|
2015-05-11 03:47:28 +07:00
|
|
|
|
|
|
|
/* start the HW */
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS,
|
|
|
|
cs | BCM2835_SPI_CS_TA | BCM2835_SPI_CS_DMAEN);
|
|
|
|
|
|
|
|
/* setup rx-DMA late - to run transfers while
|
|
|
|
* mapping of the rx buffers still takes place
|
|
|
|
* this saves 10us or more.
|
|
|
|
*/
|
|
|
|
ret = bcm2835_spi_prepare_sg(master, tfr, false);
|
|
|
|
if (ret) {
|
|
|
|
/* need to reset on errors */
|
2018-11-29 22:45:24 +07:00
|
|
|
dmaengine_terminate_sync(master->dma_tx);
|
2018-11-08 14:06:10 +07:00
|
|
|
bs->dma_pending = false;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
goto err_reset_hw;
|
2015-05-11 03:47:28 +07:00
|
|
|
}
|
|
|
|
|
|
|
|
/* start rx dma late */
|
|
|
|
dma_async_issue_pending(master->dma_rx);
|
|
|
|
|
|
|
|
/* wait for wakeup in framework */
|
|
|
|
return 1;
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
|
|
|
|
err_reset_hw:
|
|
|
|
bcm2835_spi_reset_hw(master);
|
|
|
|
bcm2835_spi_undo_prologue(bs);
|
|
|
|
return ret;
|
2015-05-11 03:47:28 +07:00
|
|
|
}
|
|
|
|
|
|
|
|
static bool bcm2835_spi_can_dma(struct spi_master *master,
|
|
|
|
struct spi_device *spi,
|
|
|
|
struct spi_transfer *tfr)
|
|
|
|
{
|
|
|
|
/* we start DMA efforts only on bigger transfers */
|
|
|
|
if (tfr->len < BCM2835_SPI_DMA_MIN_LENGTH)
|
|
|
|
return false;
|
|
|
|
|
|
|
|
/* return OK */
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
|
2015-05-12 18:43:59 +07:00
|
|
|
static void bcm2835_dma_release(struct spi_master *master)
|
2015-05-11 03:47:28 +07:00
|
|
|
{
|
|
|
|
if (master->dma_tx) {
|
2018-11-29 22:45:24 +07:00
|
|
|
dmaengine_terminate_sync(master->dma_tx);
|
2015-05-11 03:47:28 +07:00
|
|
|
dma_release_channel(master->dma_tx);
|
|
|
|
master->dma_tx = NULL;
|
|
|
|
}
|
|
|
|
if (master->dma_rx) {
|
2018-11-29 22:45:24 +07:00
|
|
|
dmaengine_terminate_sync(master->dma_rx);
|
2015-05-11 03:47:28 +07:00
|
|
|
dma_release_channel(master->dma_rx);
|
|
|
|
master->dma_rx = NULL;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-05-12 18:43:59 +07:00
|
|
|
static void bcm2835_dma_init(struct spi_master *master, struct device *dev)
|
2015-05-11 03:47:28 +07:00
|
|
|
{
|
|
|
|
struct dma_slave_config slave_config;
|
|
|
|
const __be32 *addr;
|
|
|
|
dma_addr_t dma_reg_base;
|
|
|
|
int ret;
|
|
|
|
|
|
|
|
/* base address in dma-space */
|
|
|
|
addr = of_get_address(master->dev.of_node, 0, NULL, NULL);
|
|
|
|
if (!addr) {
|
|
|
|
dev_err(dev, "could not get DMA-register address - not using dma mode\n");
|
|
|
|
goto err;
|
|
|
|
}
|
|
|
|
dma_reg_base = be32_to_cpup(addr);
|
|
|
|
|
|
|
|
/* get tx/rx dma */
|
|
|
|
master->dma_tx = dma_request_slave_channel(dev, "tx");
|
|
|
|
if (!master->dma_tx) {
|
|
|
|
dev_err(dev, "no tx-dma configuration found - not using dma mode\n");
|
|
|
|
goto err;
|
|
|
|
}
|
|
|
|
master->dma_rx = dma_request_slave_channel(dev, "rx");
|
|
|
|
if (!master->dma_rx) {
|
|
|
|
dev_err(dev, "no rx-dma configuration found - not using dma mode\n");
|
|
|
|
goto err_release;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* configure DMAs */
|
|
|
|
slave_config.direction = DMA_MEM_TO_DEV;
|
|
|
|
slave_config.dst_addr = (u32)(dma_reg_base + BCM2835_SPI_FIFO);
|
|
|
|
slave_config.dst_addr_width = DMA_SLAVE_BUSWIDTH_4_BYTES;
|
|
|
|
|
|
|
|
ret = dmaengine_slave_config(master->dma_tx, &slave_config);
|
|
|
|
if (ret)
|
|
|
|
goto err_config;
|
|
|
|
|
|
|
|
slave_config.direction = DMA_DEV_TO_MEM;
|
|
|
|
slave_config.src_addr = (u32)(dma_reg_base + BCM2835_SPI_FIFO);
|
|
|
|
slave_config.src_addr_width = DMA_SLAVE_BUSWIDTH_4_BYTES;
|
|
|
|
|
|
|
|
ret = dmaengine_slave_config(master->dma_rx, &slave_config);
|
|
|
|
if (ret)
|
|
|
|
goto err_config;
|
|
|
|
|
|
|
|
/* all went well, so set can_dma */
|
|
|
|
master->can_dma = bcm2835_spi_can_dma;
|
|
|
|
/* need to do TX AND RX DMA, so we need dummy buffers */
|
|
|
|
master->flags = SPI_MASTER_MUST_RX | SPI_MASTER_MUST_TX;
|
|
|
|
|
|
|
|
return;
|
|
|
|
|
|
|
|
err_config:
|
|
|
|
dev_err(dev, "issue configuring dma: %d - not using DMA mode\n",
|
|
|
|
ret);
|
|
|
|
err_release:
|
|
|
|
bcm2835_dma_release(master);
|
|
|
|
err:
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
2015-04-22 14:33:03 +07:00
|
|
|
static int bcm2835_spi_transfer_one_poll(struct spi_master *master,
|
|
|
|
struct spi_device *spi,
|
|
|
|
struct spi_transfer *tfr,
|
2019-04-24 03:15:08 +07:00
|
|
|
u32 cs)
|
2015-04-22 14:33:03 +07:00
|
|
|
{
|
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
unsigned long timeout;
|
|
|
|
|
|
|
|
/* enable HW block without interrupts */
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs | BCM2835_SPI_CS_TA);
|
|
|
|
|
|
|
|
/* fill in the fifo before timeout calculations
|
|
|
|
* if we are interrupted here, then the data is
|
|
|
|
* getting transferred by the HW while we are interrupted
|
|
|
|
*/
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
bcm2835_wr_fifo_blind(bs, BCM2835_SPI_FIFO_SIZE);
|
2015-04-22 14:33:03 +07:00
|
|
|
|
|
|
|
/* set the timeout */
|
|
|
|
timeout = jiffies + BCM2835_SPI_POLLING_JIFFIES;
|
|
|
|
|
|
|
|
/* loop until finished the transfer */
|
|
|
|
while (bs->rx_len) {
|
|
|
|
/* fill in tx fifo with remaining data */
|
|
|
|
bcm2835_wr_fifo(bs);
|
|
|
|
|
|
|
|
/* read from fifo as much as possible */
|
|
|
|
bcm2835_rd_fifo(bs);
|
|
|
|
|
|
|
|
/* if there is still data pending to read
|
|
|
|
* then check the timeout
|
|
|
|
*/
|
|
|
|
if (bs->rx_len && time_after(jiffies, timeout)) {
|
|
|
|
dev_dbg_ratelimited(&spi->dev,
|
|
|
|
"timeout period reached: jiffies: %lu remaining tx/rx: %d/%d - falling back to interrupt mode\n",
|
|
|
|
jiffies - timeout,
|
|
|
|
bs->tx_len, bs->rx_len);
|
|
|
|
/* fall back to interrupt mode */
|
|
|
|
return bcm2835_spi_transfer_one_irq(master, spi,
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
tfr, cs, false);
|
2015-04-22 14:33:03 +07:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Transfer complete - reset SPI HW */
|
|
|
|
bcm2835_spi_reset_hw(master);
|
|
|
|
/* and return without waiting for completion */
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
static int bcm2835_spi_transfer_one(struct spi_master *master,
|
|
|
|
struct spi_device *spi,
|
|
|
|
struct spi_transfer *tfr)
|
2013-03-12 10:38:24 +07:00
|
|
|
{
|
2015-03-26 17:08:36 +07:00
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
2013-03-12 10:38:24 +07:00
|
|
|
unsigned long spi_hz, clk_hz, cdiv;
|
2015-07-29 14:34:10 +07:00
|
|
|
unsigned long spi_used_hz;
|
|
|
|
unsigned long long xfer_time_us;
|
2015-03-26 17:08:36 +07:00
|
|
|
u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
|
2013-03-12 10:38:24 +07:00
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
/* set clock */
|
2013-03-12 10:38:24 +07:00
|
|
|
spi_hz = tfr->speed_hz;
|
|
|
|
clk_hz = clk_get_rate(bs->clk);
|
|
|
|
|
|
|
|
if (spi_hz >= clk_hz / 2) {
|
|
|
|
cdiv = 2; /* clk_hz/2 is the fastest we can go */
|
|
|
|
} else if (spi_hz) {
|
2015-03-19 16:01:52 +07:00
|
|
|
/* CDIV must be a multiple of two */
|
|
|
|
cdiv = DIV_ROUND_UP(clk_hz, spi_hz);
|
|
|
|
cdiv += (cdiv % 2);
|
2013-03-12 10:38:24 +07:00
|
|
|
|
|
|
|
if (cdiv >= 65536)
|
|
|
|
cdiv = 0; /* 0 is the slowest we can go */
|
2015-03-20 21:26:11 +07:00
|
|
|
} else {
|
2013-03-12 10:38:24 +07:00
|
|
|
cdiv = 0; /* 0 is the slowest we can go */
|
2015-03-20 21:26:11 +07:00
|
|
|
}
|
2015-04-07 00:16:30 +07:00
|
|
|
spi_used_hz = cdiv ? (clk_hz / cdiv) : (clk_hz / 65536);
|
2015-03-26 17:08:36 +07:00
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CLK, cdiv);
|
2013-03-12 10:38:24 +07:00
|
|
|
|
2015-07-28 21:03:12 +07:00
|
|
|
/* handle all the 3-wire mode */
|
2015-03-19 16:01:53 +07:00
|
|
|
if ((spi->mode & SPI_3WIRE) && (tfr->rx_buf))
|
|
|
|
cs |= BCM2835_SPI_CS_REN;
|
2015-07-28 21:03:12 +07:00
|
|
|
else
|
|
|
|
cs &= ~BCM2835_SPI_CS_REN;
|
2013-03-12 10:38:24 +07:00
|
|
|
|
2018-11-08 14:06:10 +07:00
|
|
|
/*
|
|
|
|
* The driver always uses software-controlled GPIO Chip Select.
|
|
|
|
* Set the hardware-controlled native Chip Select to an invalid
|
|
|
|
* value to prevent it from interfering.
|
2015-03-26 17:08:36 +07:00
|
|
|
*/
|
2018-11-08 14:06:10 +07:00
|
|
|
cs |= BCM2835_SPI_CS_CS_10 | BCM2835_SPI_CS_CS_01;
|
2013-03-12 10:38:24 +07:00
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
/* set transmit buffers and length */
|
2013-03-12 10:38:24 +07:00
|
|
|
bs->tx_buf = tfr->tx_buf;
|
|
|
|
bs->rx_buf = tfr->rx_buf;
|
2015-03-26 17:08:36 +07:00
|
|
|
bs->tx_len = tfr->len;
|
|
|
|
bs->rx_len = tfr->len;
|
2013-03-12 10:38:24 +07:00
|
|
|
|
2015-04-07 00:16:30 +07:00
|
|
|
/* calculate the estimated time in us the transfer runs */
|
2015-07-29 14:34:10 +07:00
|
|
|
xfer_time_us = (unsigned long long)tfr->len
|
2015-04-07 00:16:30 +07:00
|
|
|
* 9 /* clocks/byte - SPI-HW waits 1 clock after each byte */
|
2015-07-29 14:34:10 +07:00
|
|
|
* 1000000;
|
|
|
|
do_div(xfer_time_us, spi_used_hz);
|
2015-03-29 21:03:25 +07:00
|
|
|
|
2015-04-07 00:16:30 +07:00
|
|
|
/* for short requests run polling*/
|
|
|
|
if (xfer_time_us <= BCM2835_SPI_POLLING_LIMIT_US)
|
2019-04-24 03:15:08 +07:00
|
|
|
return bcm2835_spi_transfer_one_poll(master, spi, tfr, cs);
|
2013-03-12 10:38:24 +07:00
|
|
|
|
2015-05-11 03:47:28 +07:00
|
|
|
/* run in dma mode if conditions are right */
|
|
|
|
if (master->can_dma && bcm2835_spi_can_dma(master, spi, tfr))
|
|
|
|
return bcm2835_spi_transfer_one_dma(master, spi, tfr, cs);
|
|
|
|
|
|
|
|
/* run in interrupt-mode */
|
spi: bcm2835: Speed up FIFO access if fill level is known
The RX and TX FIFO of the BCM2835 SPI master each accommodate 64 bytes
(16 32-bit dwords). The CS register provides hints on their fill level:
"Bit 19 RXR - RX FIFO needs Reading ([¾] full)
0 = RX FIFO is less than [¾] full (or not active TA = 0).
1 = RX FIFO is [¾] or more full. Cleared by reading sufficient
data from the RX FIFO or setting TA to 0."
"Bit 16 DONE - Transfer Done
0 = Transfer is in progress (or not active TA = 0).
1 = Transfer is complete. Cleared by writing more data to the
TX FIFO or setting TA to 0."
"If DONE is set [...], write up to 16 [dwords] to SPI_FIFO. [...]
If RXR is set read 12 [dwords] data from SPI_FIFO."
[Source: Pages 153, 154 and 158 of
https://www.raspberrypi.org/app/uploads/2012/02/BCM2835-ARM-Peripherals.pdf
Note: The spec is missing the "¾" character, presumably due to
copy-pasting from a different charset. It also incorrectly
refers to 16 and 12 "bytes" instead of 32-bit dwords.]
In short, the RXR bit indicates that 48 bytes can be read and the DONE
bit indicates 64 bytes can be written. Leverage this knowledge to read
or write bytes blindly to the FIFO, without polling whether data can be
read or free space is available to write. Moreover, when a transfer is
starting, the TX FIFO is known to be empty, likewise allowing a blind
write of 64 bytes.
This cuts the number of bus accesses in half if the fill level is known.
Also, the (posted) write accesses can be pipelined on the AXI bus since
they are no longer interleaved with (non-posted) reads.
bcm2835_spi_transfer_one_poll() switches to interrupt mode when a time
limit is exceeded by calling bcm2835_spi_transfer_one_irq(). The TX
FIFO may contain data in this case, but is known to be empty when the
function is called from bcm2835_spi_transfer_one(). Hence only blindly
fill the TX FIFO in the latter case but not the former.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Tested-by: Eric Anholt <eric@anholt.net>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-29 22:45:24 +07:00
|
|
|
return bcm2835_spi_transfer_one_irq(master, spi, tfr, cs, true);
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
|
2015-07-28 21:03:12 +07:00
|
|
|
static int bcm2835_spi_prepare_message(struct spi_master *master,
|
|
|
|
struct spi_message *msg)
|
|
|
|
{
|
|
|
|
struct spi_device *spi = msg->spi;
|
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
u32 cs = bcm2835_rd(bs, BCM2835_SPI_CS);
|
2019-04-14 01:24:14 +07:00
|
|
|
int ret;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* DMA transfers are limited to 16 bit (0 to 65535 bytes) by the SPI HW
|
|
|
|
* due to DLEN. Split up transfers (32-bit FIFO aligned) if the limit is
|
|
|
|
* exceeded.
|
|
|
|
*/
|
|
|
|
ret = spi_split_transfers_maxsize(master, msg, 65532,
|
|
|
|
GFP_KERNEL | GFP_DMA);
|
|
|
|
if (ret)
|
|
|
|
return ret;
|
2015-07-28 21:03:12 +07:00
|
|
|
|
|
|
|
cs &= ~(BCM2835_SPI_CS_CPOL | BCM2835_SPI_CS_CPHA);
|
|
|
|
|
|
|
|
if (spi->mode & SPI_CPOL)
|
|
|
|
cs |= BCM2835_SPI_CS_CPOL;
|
|
|
|
if (spi->mode & SPI_CPHA)
|
|
|
|
cs |= BCM2835_SPI_CS_CPHA;
|
|
|
|
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS, cs);
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
static void bcm2835_spi_handle_err(struct spi_master *master,
|
|
|
|
struct spi_message *msg)
|
2013-03-12 10:38:24 +07:00
|
|
|
{
|
2015-05-11 03:47:28 +07:00
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
|
|
|
|
/* if an error occurred and we have an active dma, then terminate */
|
2018-11-08 14:06:10 +07:00
|
|
|
if (cmpxchg(&bs->dma_pending, true, false)) {
|
2018-11-29 22:45:24 +07:00
|
|
|
dmaengine_terminate_sync(master->dma_tx);
|
|
|
|
dmaengine_terminate_sync(master->dma_rx);
|
spi: bcm2835: Overcome sglist entry length limitation
When in DMA mode, the BCM2835 SPI controller requires that the FIFO is
accessed in 4 byte chunks. This rule is not fulfilled if a transfer
consists of multiple sglist entries, one per page, and the first entry
starts in the middle of a page with an offset not a multiple of 4.
The driver currently falls back to programmed I/O for such transfers,
incurring a significant performance penalty.
Overcome this hardware limitation by transferring the first few bytes of
a transfer without DMA such that the remainder of the first sglist entry
becomes a multiple of 4. Specifics are provided in kerneldoc comments.
An alternative approach would have been to split transfers in the
->prepare_message hook, but this may necessitate two transfers per page,
defeating the goal of clustering multiple pages together in a single
transfer for efficiency. E.g. if the first TX sglist entry's length is
23 and the first RX's is 40, the first transfer would send and receive
23 bytes, the second 40 - 23 = 17 bytes, the third 4096 - 17 = 4079
bytes, the fourth 4096 - 4079 = 17 bytes and so on. In other words,
O(n) transfers are necessary (n = number of sglist entries), whereas
the algorithm implemented herein only requires O(1) additional work.
Signed-off-by: Lukas Wunner <lukas@wunner.de>
Cc: Mathias Duckeck <m.duckeck@kunbus.de>
Cc: Frank Pavlic <f.pavlic@kunbus.de>
Cc: Martin Sperl <kernel@martin.sperl.org>
Cc: Noralf Trønnes <noralf@tronnes.org>
Signed-off-by: Mark Brown <broonie@kernel.org>
2018-11-08 14:06:10 +07:00
|
|
|
bcm2835_spi_undo_prologue(bs);
|
2015-05-11 03:47:28 +07:00
|
|
|
}
|
|
|
|
/* and reset */
|
2015-03-26 17:08:36 +07:00
|
|
|
bcm2835_spi_reset_hw(master);
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
|
2015-04-07 00:16:31 +07:00
|
|
|
static int chip_match_name(struct gpio_chip *chip, void *data)
|
|
|
|
{
|
|
|
|
return !strcmp(chip->label, data);
|
|
|
|
}
|
|
|
|
|
2015-03-26 17:08:36 +07:00
|
|
|
static int bcm2835_spi_setup(struct spi_device *spi)
|
|
|
|
{
|
2015-04-07 00:16:31 +07:00
|
|
|
int err;
|
|
|
|
struct gpio_chip *chip;
|
2015-03-26 17:08:36 +07:00
|
|
|
/*
|
|
|
|
* sanity checking the native-chipselects
|
|
|
|
*/
|
|
|
|
if (spi->mode & SPI_NO_CS)
|
|
|
|
return 0;
|
|
|
|
if (gpio_is_valid(spi->cs_gpio))
|
|
|
|
return 0;
|
2015-04-07 00:16:31 +07:00
|
|
|
if (spi->chip_select > 1) {
|
|
|
|
/* error in the case of native CS requested with CS > 1
|
|
|
|
* officially there is a CS2, but it is not documented
|
|
|
|
* which GPIO is connected with that...
|
|
|
|
*/
|
|
|
|
dev_err(&spi->dev,
|
|
|
|
"setup: only two native chip-selects are supported\n");
|
|
|
|
return -EINVAL;
|
|
|
|
}
|
|
|
|
/* now translate native cs to GPIO */
|
|
|
|
|
|
|
|
/* get the gpio chip for the base */
|
|
|
|
chip = gpiochip_find("pinctrl-bcm2835", chip_match_name);
|
|
|
|
if (!chip)
|
2015-03-26 17:08:36 +07:00
|
|
|
return 0;
|
|
|
|
|
2015-04-07 00:16:31 +07:00
|
|
|
/* and calculate the real CS */
|
|
|
|
spi->cs_gpio = chip->base + 8 - spi->chip_select;
|
|
|
|
|
|
|
|
/* and set up the "mode" and level */
|
|
|
|
dev_info(&spi->dev, "setting up native-CS%i as GPIO %i\n",
|
|
|
|
spi->chip_select, spi->cs_gpio);
|
|
|
|
|
|
|
|
/* set up GPIO as output and pull to the correct level */
|
|
|
|
err = gpio_direction_output(spi->cs_gpio,
|
|
|
|
(spi->mode & SPI_CS_HIGH) ? 0 : 1);
|
|
|
|
if (err) {
|
|
|
|
dev_err(&spi->dev,
|
|
|
|
"could not set CS%i gpio %i as output: %i",
|
|
|
|
spi->chip_select, spi->cs_gpio, err);
|
|
|
|
return err;
|
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
|
|
|
|
static int bcm2835_spi_probe(struct platform_device *pdev)
|
|
|
|
{
|
|
|
|
struct spi_master *master;
|
|
|
|
struct bcm2835_spi *bs;
|
|
|
|
struct resource *res;
|
|
|
|
int err;
|
|
|
|
|
|
|
|
master = spi_alloc_master(&pdev->dev, sizeof(*bs));
|
|
|
|
if (!master) {
|
|
|
|
dev_err(&pdev->dev, "spi_alloc_master() failed\n");
|
|
|
|
return -ENOMEM;
|
|
|
|
}
|
|
|
|
|
|
|
|
platform_set_drvdata(pdev, master);
|
|
|
|
|
|
|
|
master->mode_bits = BCM2835_SPI_MODE_BITS;
|
2013-08-05 07:43:02 +07:00
|
|
|
master->bits_per_word_mask = SPI_BPW_MASK(8);
|
2013-03-12 10:38:24 +07:00
|
|
|
master->num_chipselect = 3;
|
2015-03-26 17:08:36 +07:00
|
|
|
master->setup = bcm2835_spi_setup;
|
|
|
|
master->transfer_one = bcm2835_spi_transfer_one;
|
|
|
|
master->handle_err = bcm2835_spi_handle_err;
|
2015-07-28 21:03:12 +07:00
|
|
|
master->prepare_message = bcm2835_spi_prepare_message;
|
2013-03-12 10:38:24 +07:00
|
|
|
master->dev.of_node = pdev->dev.of_node;
|
|
|
|
|
|
|
|
bs = spi_master_get_devdata(master);
|
|
|
|
|
|
|
|
res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
|
2013-05-02 19:13:30 +07:00
|
|
|
bs->regs = devm_ioremap_resource(&pdev->dev, res);
|
|
|
|
if (IS_ERR(bs->regs)) {
|
|
|
|
err = PTR_ERR(bs->regs);
|
2013-03-12 10:38:24 +07:00
|
|
|
goto out_master_put;
|
|
|
|
}
|
|
|
|
|
|
|
|
bs->clk = devm_clk_get(&pdev->dev, NULL);
|
|
|
|
if (IS_ERR(bs->clk)) {
|
|
|
|
err = PTR_ERR(bs->clk);
|
|
|
|
dev_err(&pdev->dev, "could not get clk: %d\n", err);
|
|
|
|
goto out_master_put;
|
|
|
|
}
|
|
|
|
|
2015-10-15 17:09:11 +07:00
|
|
|
bs->irq = platform_get_irq(pdev, 0);
|
2013-03-12 10:38:24 +07:00
|
|
|
if (bs->irq <= 0) {
|
|
|
|
dev_err(&pdev->dev, "could not get IRQ: %d\n", bs->irq);
|
|
|
|
err = bs->irq ? bs->irq : -ENODEV;
|
|
|
|
goto out_master_put;
|
|
|
|
}
|
|
|
|
|
|
|
|
clk_prepare_enable(bs->clk);
|
|
|
|
|
2015-10-15 17:09:11 +07:00
|
|
|
bcm2835_dma_init(master, &pdev->dev);
|
|
|
|
|
|
|
|
/* initialise the hardware with the default polarities */
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS,
|
|
|
|
BCM2835_SPI_CS_CLEAR_RX | BCM2835_SPI_CS_CLEAR_TX);
|
|
|
|
|
2013-12-09 17:25:00 +07:00
|
|
|
err = devm_request_irq(&pdev->dev, bs->irq, bcm2835_spi_interrupt, 0,
|
2015-03-20 21:26:11 +07:00
|
|
|
dev_name(&pdev->dev), master);
|
2013-03-12 10:38:24 +07:00
|
|
|
if (err) {
|
|
|
|
dev_err(&pdev->dev, "could not request IRQ: %d\n", err);
|
|
|
|
goto out_clk_disable;
|
|
|
|
}
|
|
|
|
|
2013-09-24 11:23:00 +07:00
|
|
|
err = devm_spi_register_master(&pdev->dev, master);
|
2013-03-12 10:38:24 +07:00
|
|
|
if (err) {
|
|
|
|
dev_err(&pdev->dev, "could not register SPI master: %d\n", err);
|
2013-12-09 17:25:00 +07:00
|
|
|
goto out_clk_disable;
|
2013-03-12 10:38:24 +07:00
|
|
|
}
|
|
|
|
|
|
|
|
return 0;
|
|
|
|
|
|
|
|
out_clk_disable:
|
|
|
|
clk_disable_unprepare(bs->clk);
|
|
|
|
out_master_put:
|
|
|
|
spi_master_put(master);
|
|
|
|
return err;
|
|
|
|
}
|
|
|
|
|
|
|
|
static int bcm2835_spi_remove(struct platform_device *pdev)
|
|
|
|
{
|
2013-11-15 14:43:27 +07:00
|
|
|
struct spi_master *master = platform_get_drvdata(pdev);
|
2013-03-12 10:38:24 +07:00
|
|
|
struct bcm2835_spi *bs = spi_master_get_devdata(master);
|
|
|
|
|
|
|
|
/* Clear FIFOs, and disable the HW block */
|
|
|
|
bcm2835_wr(bs, BCM2835_SPI_CS,
|
|
|
|
BCM2835_SPI_CS_CLEAR_RX | BCM2835_SPI_CS_CLEAR_TX);
|
|
|
|
|
|
|
|
clk_disable_unprepare(bs->clk);
|
|
|
|
|
2015-05-11 03:47:28 +07:00
|
|
|
bcm2835_dma_release(master);
|
|
|
|
|
2013-03-12 10:38:24 +07:00
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
static const struct of_device_id bcm2835_spi_match[] = {
|
|
|
|
{ .compatible = "brcm,bcm2835-spi", },
|
|
|
|
{}
|
|
|
|
};
|
|
|
|
MODULE_DEVICE_TABLE(of, bcm2835_spi_match);
|
|
|
|
|
|
|
|
static struct platform_driver bcm2835_spi_driver = {
|
|
|
|
.driver = {
|
|
|
|
.name = DRV_NAME,
|
|
|
|
.of_match_table = bcm2835_spi_match,
|
|
|
|
},
|
|
|
|
.probe = bcm2835_spi_probe,
|
|
|
|
.remove = bcm2835_spi_remove,
|
|
|
|
};
|
|
|
|
module_platform_driver(bcm2835_spi_driver);
|
|
|
|
|
|
|
|
MODULE_DESCRIPTION("SPI controller driver for Broadcom BCM2835");
|
|
|
|
MODULE_AUTHOR("Chris Boot <bootc@bootc.net>");
|
2018-10-23 18:06:08 +07:00
|
|
|
MODULE_LICENSE("GPL");
|