spi: spi-geni-qcom: Add support for GPI dma
Subsystems (2)
PATCH v5 1/1 spi: spi-geni-qcom: Add support for GPI dma
We can use GPI DMA for devices where it is enabled by firmware. Add support for this mode
--
-Changes since v4:
- Fix the kbuild bot warning
-Changes since v3:
- Drop merged spi core, geni patches
- Remove global structs and use local variables instead
- modularize code more as suggested by Doug
- fix kbuild bot warning
drivers/spi/spi-geni-qcom.c | 254 +++++++++++++++++++++++++++++++++--- 1 file changed, 239 insertions(+), 15 deletions(-)
drivers/spi/spi-geni-qcom.c +239 -15
@@ -2,6 +2,9 @@// Copyright (c) 2017-2018, The Linux foundation. All rights reserved. #include <linux/clk.h> +#include <linux/dmaengine.h> +#include <linux/dma-mapping.h> +#include <linux/dma/qcom-gpi-dma.h> #include <linux/interrupt.h> #include <linux/io.h> #include <linux/log2.h>
@@ -63,6 +66,15 @@#define TIMESTAMP_AFTER BIT(3)#define POST_CMD_DELAY BIT(4) +#define GSI_LOOPBACK_EN BIT(0) +#define GSI_CS_TOGGLE BIT(3) +#define GSI_CPHA BIT(4) +#define GSI_CPOL BIT(5) + +#define MAX_TX_SG 3 +#define NUM_SPI_XFER 8 +#define SPI_XFER_TIMEOUT_MS 250 +struct spi_geni_master {struct geni_se se;struct device *dev;
@@ -84,6 +96,9 @@ struct spi_geni_master {int irq;bool cs_flag;bool abort_failed; +struct dma_chan *tx; +struct dma_chan *rx; +int cur_xfer_mode; }; static int get_spi_clk_cfg(unsigned int speed_hz,
@@ -330,34 +345,197 @@ static int setup_fifo_params(struct spi_device *spi_slv,return geni_spi_set_clock_and_bw (mas, spi_slv->max_speed_hz); } +static void +spi_gsi_callback_result (void *cb,const struct dmaengine_result *result) +{ +struct spi_master *spi = cb; + +if (result->result !=DMA_TRANS_NOERROR ) { +dev_err (&spi->dev,"DMA txn failed: %d\n" , result->result); +return ; + } + +if (!result->residue) { +dev_dbg (&spi->dev,"DMA txn completed\n" ); +spi_finalize_current_transfer (spi); + }else { +dev_err (&spi->dev,"DMA xfer has pending: %d\n" , result->residue); + } +} + +static int setup_gsi_xfer (struct spi_transfer *xfer,struct spi_geni_master *mas, +struct spi_device *spi_slv,struct spi_master *spi) +{ +unsigned long flags =DMA_PREP_INTERRUPT |DMA_CTRL_ACK ; +struct dma_slave_config config = {}; +struct gpi_spi_config peripheral = {}; +struct dma_async_tx_descriptor *tx_desc, *rx_desc; +int ret; + + config.peripheral_config = &peripheral; + config.peripheral_size =sizeof (peripheral); + peripheral.set_config = true; + +if (xfer->bits_per_word != mas->cur_bits_per_word || + xfer->speed_hz != mas->cur_speed_hz) { + mas->cur_bits_per_word = xfer->bits_per_word; + mas->cur_speed_hz = xfer->speed_hz; + } + +if (xfer->tx_buf && xfer->rx_buf) { + peripheral.cmd =SPI_DUPLEX ; + }else if (xfer->tx_buf) { + peripheral.cmd =SPI_TX ; + peripheral.rx_len =0 ; + }else if (xfer->rx_buf) { + peripheral.cmd =SPI_RX ; +if (!(mas->cur_bits_per_word %MIN_WORD_LEN )) { + peripheral.rx_len = ((xfer->len <<3 ) / mas->cur_bits_per_word); + }else { +int bytes_per_word = (mas->cur_bits_per_word /BITS_PER_BYTE ) +1 ; + + peripheral.rx_len = (xfer->len / bytes_per_word); + } + } + + peripheral.loopback_en = !!(spi_slv->mode &SPI_LOOP ); + peripheral.clock_pol_high = !!(spi_slv->mode &SPI_CPOL ); + peripheral.data_pol_high = !!(spi_slv->mode &SPI_CPHA ); + peripheral.cs = spi_slv->chip_select; + peripheral.pack_en = true; + peripheral.word_len = xfer->bits_per_word -MIN_WORD_LEN ; + + ret =get_spi_clk_cfg (mas->cur_speed_hz, mas, + &peripheral.clk_src, &peripheral.clk_div); +if (ret) { +dev_err (mas->dev,"Err in get_spi_clk_cfg() :%d\n" , ret); +return ret; + } + +if (!xfer->cs_change) { +if (!list_is_last (&xfer->transfer_list, &spi->cur_msg->transfers)) + peripheral.fragmentation =FRAGMENTATION ; + } + +if (peripheral.cmd &SPI_RX ) { +dmaengine_slave_config (mas->rx, &config); + rx_desc =dmaengine_prep_slave_sg (mas->rx, xfer->rx_sg.sgl, xfer->rx_sg.nents, +DMA_DEV_TO_MEM , flags); +if (!rx_desc) { +dev_err (mas->dev,"Err setting up rx desc\n" ); +return -EIO ; + } + } + +/* +* Prepare the TX always, even for RX or tx_buf being null, we would +* need TX to be prepared per GSI spec +*/ +dmaengine_slave_config (mas->tx, &config); + tx_desc =dmaengine_prep_slave_sg (mas->tx, xfer->tx_sg.sgl, xfer->tx_sg.nents, +DMA_MEM_TO_DEV , flags); +if (!tx_desc) { +dev_err (mas->dev,"Err setting up tx desc\n" ); +return -EIO ; + } + + tx_desc->callback_result = spi_gsi_callback_result; + tx_desc->callback_param = spi; + +if (peripheral.cmd &SPI_RX ) +dmaengine_submit (rx_desc); +dmaengine_submit (tx_desc); + +if (peripheral.cmd &SPI_RX ) +dma_async_issue_pending (mas->rx); + +dma_async_issue_pending (mas->tx); +return 1 ; +} + +static bool geni_can_dma (struct spi_controller *ctlr, +struct spi_device *slv,struct spi_transfer *xfer) +{ +struct spi_geni_master *mas =spi_master_get_devdata (slv->master); + +/* check if dma is supported */ +return mas->cur_xfer_mode !=GENI_SE_FIFO ; +} +static int spi_geni_prepare_message (struct spi_master *spi,struct spi_message *spi_msg) { -int ret;struct spi_geni_master *mas =spi_master_get_devdata (spi); +int ret; -if (spi_geni_is_abort_still_pending (mas)) -return -EBUSY ; +switch (mas->cur_xfer_mode) { +case GENI_SE_FIFO : +if (spi_geni_is_abort_still_pending (mas)) +return -EBUSY ; + ret =setup_fifo_params (spi_msg->spi, spi); +if (ret) +dev_err (mas->dev,"Couldn't select mode %d\n" , ret); +return ret; - ret =setup_fifo_params (spi_msg->spi, spi); -if (ret) -dev_err (mas->dev,"Couldn't select mode %d\n" , ret); +case GENI_GPI_DMA : +/* nothing to do for GPI DMA */ +return 0 ; + } + +dev_err (mas->dev,"Mode not supported %d" , mas->cur_xfer_mode); +return -EINVAL ; +} + +static int spi_geni_grab_gpi_chan (struct spi_geni_master *mas) +{ +int ret; + + mas->tx =dma_request_chan (mas->dev,"tx" ); + ret =dev_err_probe (mas->dev,IS_ERR (mas->tx),"Failed to get tx DMA ch\n" ); +if (ret <0 ) + goto err_tx; + + mas->rx =dma_request_chan (mas->dev,"rx" ); + ret =dev_err_probe (mas->dev,IS_ERR (mas->rx),"Failed to get rx DMA ch\n" ); +if (ret <0 ) + goto err_rx; + +return 0 ; + +err_rx: +dma_release_channel (mas->tx); + mas->tx =NULL ; +err_tx: + mas->rx =NULL ;return ret; } +static void spi_geni_release_dma_chan (struct spi_geni_master *mas) +{ +if (mas->rx) { +dma_release_channel (mas->rx); + mas->rx =NULL ; + } + +if (mas->tx) { +dma_release_channel (mas->tx); + mas->tx =NULL ; + } +} +static int spi_geni_init (struct spi_geni_master *mas) {struct geni_se *se = &mas->se;unsigned int proto, major, minor, ver; -u32 spi_tx_cfg; +u32 spi_tx_cfg, fifo_disable; +int ret = -ENXIO ;pm_runtime_get_sync (mas->dev); proto =geni_se_read_proto (se);if (proto !=GENI_SE_SPI ) {dev_err (mas->dev,"Invalid proto %d\n" , proto); -pm_runtime_put (mas->dev); -return -ENXIO ; + goto out_pm; } mas->tx_fifo_depth =geni_se_get_tx_fifo_depth (se);
@@ -380,15 +558,38 @@ static int spi_geni_init(struct spi_geni_master *mas)else mas->oversampling =1 ; -geni_se_select_mode (se,GENI_SE_FIFO ); + fifo_disable =readl (se->base +GENI_IF_DISABLE_RO ) &FIFO_IF_DISABLE ; +switch (fifo_disable) { +case 1 : + ret =spi_geni_grab_gpi_chan (mas); +if (!ret) {/* success case */ + mas->cur_xfer_mode =GENI_GPI_DMA ; +geni_se_select_mode (se,GENI_GPI_DMA ); +dev_dbg (mas->dev,"Using GPI DMA mode for SPI\n" ); +break ; + } +/* +* in case of failure to get dma channel, we can still do the +* FIFO mode, so fallthrough +*/ +dev_warn (mas->dev,"FIFO mode disabled, but couldn't get DMA, fall back to FIFO mode\n" ); + fallthrough; + +case 0 : + mas->cur_xfer_mode =GENI_SE_FIFO ; +geni_se_select_mode (se,GENI_SE_FIFO ); + ret =0 ; +break ; + }/* We always control CS manually */ spi_tx_cfg =readl (se->base +SE_SPI_TRANS_CFG ); spi_tx_cfg &= ~CS_TOGGLE ;writel (spi_tx_cfg, se->base +SE_SPI_TRANS_CFG ); +out_pm:pm_runtime_put (mas->dev); -return 0 ; +return ret; }static unsigned int geni_byte_per_fifo_word (struct spi_geni_master *mas)
@@ -569,8 +770,11 @@ static int spi_geni_transfer_one(struct spi_master *spi,if (!xfer->len)return 0 ; -setup_fifo_xfer (xfer, mas, slv->mode, spi); -return 1 ; +if (mas->cur_xfer_mode ==GENI_SE_FIFO ) { +setup_fifo_xfer (xfer, mas, slv->mode, spi); +return 1 ; + } +return setup_gsi_xfer (xfer, mas, slv, spi); }static irqreturn_t geni_spi_isr (int irq,void *data)
@@ -665,6 +869,13 @@ static int spi_geni_probe(struct platform_device *pdev)if (irq <0 )return irq; + ret =dma_set_mask_and_coherent (dev,DMA_BIT_MASK (64 )); +if (ret) { + ret =dma_set_mask_and_coherent (dev,DMA_BIT_MASK (32 )); +if (ret) +return dev_err_probe (dev, ret,"could not set DMA mask\n" ); + } + base =devm_platform_ioremap_resource (pdev,0 );if (IS_ERR (base))return PTR_ERR (base);
@@ -704,9 +915,10 @@ static int spi_geni_probe(struct platform_device *pdev) spi->max_speed_hz =50000000 ; spi->prepare_message = spi_geni_prepare_message; spi->transfer_one = spi_geni_transfer_one; + spi->can_dma = geni_can_dma; + spi->dma_map_dev = dev->parent; spi->auto_runtime_pm = true; spi->handle_err = handle_fifo_timeout; - spi->set_cs = spi_geni_set_cs; spi->use_gpio_descriptors = true;init_completion (&mas->cs_done);
@@ -732,9 +944,17 @@ static int spi_geni_probe(struct platform_device *pdev)if (ret) goto spi_geni_probe_runtime_disable; +/* +* check the mode supported and set_cs for fifo mode only +* for dma (gsi) mode, the gsi will set cs based on params passed in +* TRE +*/ +if (mas->cur_xfer_mode ==GENI_SE_FIFO ) + spi->set_cs = spi_geni_set_cs; + ret =request_irq (mas->irq, geni_spi_isr,0 ,dev_name (dev), spi);if (ret) - goto spi_geni_probe_runtime_disable; + goto spi_geni_release_dma; ret =spi_register_master (spi);if (ret)
@@ -743,6 +963,8 @@ static int spi_geni_probe(struct platform_device *pdev)return 0 ; spi_geni_probe_free_irq:free_irq (mas->irq, spi); +spi_geni_release_dma: +spi_geni_release_dma_chan (mas); spi_geni_probe_runtime_disable:pm_runtime_disable (dev);return ret;
@@ -756,6 +978,8 @@ static int spi_geni_remove(struct platform_device *pdev)/* Unregister _before_ disabling pm_runtime() so we stop transfers */ spi_unregister_master (spi); +spi_geni_release_dma_chan (mas); +free_irq (mas->irq, spi);pm_runtime_disable (&pdev->dev);return 0 ;
Signature · 1 line
2.31.1
Mark Brown
maintainerQuoted 9 lines · Vinod Koul
We can use GPI DMA for devices where it is enabled by firmware. Add support for this mode
Signed-off-by Vinod Koul <[email protected]>--
-Changes since v4:
- Fix the kbuild bot warning[...]
Applied to
https://git.kernel.org/pub/scm/linux/kernel/git/broonie/spi.git for-next
Thanks!
[1/1] spi: spi-geni-qcom: Add support for GPI dma
commit: b59c122484ecb1853882986e04d00bd879cfc051
All being well this means that it will be integrated into the linux-next tree (usually sometime in the next 24 hours) and sent to Linus during the next merge window (or sooner if it is a bug fix), however if problems are discovered then the patch may be dropped or reverted.
You may get further e-mails resulting from automated or manual testing and review of the tree, please engage with people reporting problems and send followup patches addressing any issues that are reported if needed.
If any updates are required or you are submitting further changes they should be sent as incremental updates against current git, existing patches will not be replaced.
Please add any relevant lists and maintainers to the CCs when replying to this mail.
Thanks,
Mark
Hi,
Quoted 7 lines · Vinod Koul
We can use GPI DMA for devices where it is enabled by firmware. Add support for this mode
Signed-off-by Vinod Koul <[email protected]>--
(quoted diff) +0
-1-Changes since v4:
Review
Quoted 10 lines
(quoted diff) +0
-1- Fix the kbuild bot warning -Changes since v3: - Drop merged spi core, geni patches - Remove global structs and use local variables instead - modularize code more as suggested by Doug - fix kbuild bot warning drivers/spi/spi-geni-qcom.c | 254 +++++++++++++++++++++++++++++++++--- 1 file changed, 239 insertions(+), 15 deletions(-)
This is already landed, but better review late than never? Maybe you can do a followup patch?
Quoted 16 lines
drivers/spi/spi-geni-qcom.c +3
-0@@ -2,6 +2,9 @@// Copyright (c) 2017-2018, The Linux foundation. All rights reserved. #include <linux/clk.h> +#include <linux/dmaengine.h> +#include <linux/dma-mapping.h> +#include <linux/dma/qcom-gpi-dma.h> #include <linux/interrupt.h> #include <linux/io.h> #include <linux/log2.h> @@ -63,6 +66,15 @@#define TIMESTAMP_AFTER BIT(3)
drivers/spi/spi-geni-qcom.c line 76
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +8
-0#define POST_CMD_DELAY BIT(4) +#define GSI_LOOPBACK_EN BIT(0) +#define GSI_CS_TOGGLE BIT(3) +#define GSI_CPHA BIT(4) +#define GSI_CPOL BIT(5) + +#define MAX_TX_SG 3 +#define NUM_SPI_XFER 8 +#define SPI_XFER_TIMEOUT_MS 250
Above three #defines are not used anywhere.
Quoted 9 lines
drivers/spi/spi-geni-qcom.c +5
-0@@ -330,34 +345,197 @@ static int setup_fifo_params(struct spi_device *spi_slv,return geni_spi_set_clock_and_bw (mas, spi_slv->max_speed_hz); } +static void +spi_gsi_callback_result (void *cb,const struct dmaengine_result *result) +{ +struct spi_master *spi = cb; +
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 362
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+if (result->result !=DMA_TRANS_NOERROR ) { +dev_err (&spi->dev,"DMA txn failed: %d\n" , result->result); +return ; + } + +if (!result->residue) { +dev_dbg (&spi->dev,"DMA txn completed\n" ); +spi_finalize_current_transfer (spi); + }else { +dev_err (&spi->dev,"DMA xfer has pending: %d\n" , result->residue);
Wouldn't hurt to add a comment above saying that you're relying on the SPI core to timeout to get the system back in a usage state.
nit that I'd also reorganize to make the two error cases to be more parallel:
if (result->result != DMA_TRANS_NOERROR) {
dev_err(...);
return;
}
if (result->residue) {
dev_err(...);
return;
}spi_finalize_current_transfer(...);
Quoted 8 lines
drivers/spi/spi-geni-qcom.c +8
-0+static int setup_gsi_xfer (struct spi_transfer *xfer,struct spi_geni_master *mas, +struct spi_device *spi_slv,struct spi_master *spi) +{ +unsigned long flags =DMA_PREP_INTERRUPT |DMA_CTRL_ACK ; +struct dma_slave_config config = {}; +struct gpi_spi_config peripheral = {}; +struct dma_async_tx_descriptor *tx_desc, *rx_desc; +int ret;
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 383
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+ + config.peripheral_config = &peripheral; + config.peripheral_size =sizeof (peripheral); + peripheral.set_config = true; + +if (xfer->bits_per_word != mas->cur_bits_per_word || + xfer->speed_hz != mas->cur_speed_hz) { + mas->cur_bits_per_word = xfer->bits_per_word; + mas->cur_speed_hz = xfer->speed_hz; + }
I'm pretty sure that "mas->cur_bits_per_word" isn't used in GSI mode (except below, where you could just use the values "xfer"), so you could get rid of this?
For "mas->cur_speed_hz" maybe you should be using this to avoid unnecessary calls to get_spi_clk_cfg() for when the clock didn't change?
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+ +if (xfer->tx_buf && xfer->rx_buf) { + peripheral.cmd =SPI_DUPLEX ; + }else if (xfer->tx_buf) { + peripheral.cmd =SPI_TX ; + peripheral.rx_len =0 ; + }else if (xfer->rx_buf) { + peripheral.cmd =SPI_RX ; +if (!(mas->cur_bits_per_word %MIN_WORD_LEN )) { + peripheral.rx_len = ((xfer->len <<3 ) / mas->cur_bits_per_word);
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 403
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+ }else { +int bytes_per_word = (mas->cur_bits_per_word /BITS_PER_BYTE ) +1 ; + + peripheral.rx_len = (xfer->len / bytes_per_word); + } + } + + peripheral.loopback_en = !!(spi_slv->mode &SPI_LOOP ); + peripheral.clock_pol_high = !!(spi_slv->mode &SPI_CPOL ); + peripheral.data_pol_high = !!(spi_slv->mode &SPI_CPHA );
The fact that the "!!" above is actually needed is a sign that the "struct gpi_spi_config" definition should be fixed. It should declare things as "bool", not "u8". Then you can get rid of the "!!" here.
Quoted 30 lines
drivers/spi/spi-geni-qcom.c +30
-0+ peripheral.cs = spi_slv->chip_select; + peripheral.pack_en = true; + peripheral.word_len = xfer->bits_per_word -MIN_WORD_LEN ; + + ret =get_spi_clk_cfg (mas->cur_speed_hz, mas, + &peripheral.clk_src, &peripheral.clk_div); +if (ret) { +dev_err (mas->dev,"Err in get_spi_clk_cfg() :%d\n" , ret); +return ret; + } + +if (!xfer->cs_change) { +if (!list_is_last (&xfer->transfer_list, &spi->cur_msg->transfers)) + peripheral.fragmentation =FRAGMENTATION ; + } + +if (peripheral.cmd &SPI_RX ) { +dmaengine_slave_config (mas->rx, &config); + rx_desc =dmaengine_prep_slave_sg (mas->rx, xfer->rx_sg.sgl, xfer->rx_sg.nents, +DMA_DEV_TO_MEM , flags); +if (!rx_desc) { +dev_err (mas->dev,"Err setting up rx desc\n" ); +return -EIO ; + } + } + +/* +* Prepare the TX always, even for RX or tx_buf being null, we would +* need TX to be prepared per GSI spec +*/
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 443
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+dmaengine_slave_config (mas->tx, &config); + tx_desc =dmaengine_prep_slave_sg (mas->tx, xfer->tx_sg.sgl, xfer->tx_sg.nents, +DMA_MEM_TO_DEV , flags); +if (!tx_desc) { +dev_err (mas->dev,"Err setting up tx desc\n" ); +return -EIO ; + } + + tx_desc->callback_result = spi_gsi_callback_result; + tx_desc->callback_param = spi;
I guess now when you get the TX callback then you assume that both the TX and RX are done. Is that truly safe? Perhaps I'm being paranoid (or maybe I just don't understand how things work), but I could sorta imagine that the peripheral has finished transmitting all the data but hasn't managed to DMA all the data that it received into main memory. If we were only going to pick one callback to register for and we have both TX and RX going, it seems like we should register for RX. Because of the way SPI works it seems like it would be impossible for TX to still be going if RX is fully done.
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 453
Quoted 9 lines
drivers/spi/spi-geni-qcom.c +9
-0+if (peripheral.cmd &SPI_RX ) +dmaengine_submit (rx_desc); +dmaengine_submit (tx_desc); + +if (peripheral.cmd &SPI_RX ) +dma_async_issue_pending (mas->rx); + +dma_async_issue_pending (mas->tx); +return 1 ;
You're returning "1" here which lets the SPI core do all the timeout handling, right? ...but that means you need to provide the SPI core with a way to abort your transfer if it times out. This should be in spi->handle_err(). Right now that points to handle_fifo_timeout(). I think you need to add code to handle errors for GPI mode too.
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 494
Quoted 6 lines
drivers/spi/spi-geni-qcom.c +6
-0+static int spi_geni_grab_gpi_chan (struct spi_geni_master *mas) +{ +int ret; + + mas->tx =dma_request_chan (mas->dev,"tx" ); + ret =dev_err_probe (mas->dev,IS_ERR (mas->tx),"Failed to get tx DMA ch\n" );
s/IS_ERR/ERR_PTR/
dev_err_probe takes an error code, not a boolean. The way you've coded it all errors will be reported as "error 1". You'll also never trip the "if" test below (I suppose a smarter compiler could even detect this?) since "ret" will always be either 0 or 1 (and neither of those is < 0)
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 499
Quoted 5 lines
drivers/spi/spi-geni-qcom.c +5
-0+if (ret <0 ) + goto err_tx; + + mas->rx =dma_request_chan (mas->dev,"rx" ); + ret =dev_err_probe (mas->dev,IS_ERR (mas->rx),"Failed to get rx DMA ch\n" );
s/IS_ERR/ERR_PTR/
dev_err_probe takes an error code, not a boolean. The way you've coded it all errors will be reported as "error 1".
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 523
Quoted 11 lines
drivers/spi/spi-geni-qcom.c +11
-0+static void spi_geni_release_dma_chan (struct spi_geni_master *mas) +{ +if (mas->rx) { +dma_release_channel (mas->rx); + mas->rx =NULL ; + } + +if (mas->tx) { +dma_release_channel (mas->tx); + mas->tx =NULL ; + }
nit: I would have skipped the setting to NULL. This is only used in the probe error and in the removal case and there's just no reason to NULL these out.
Quoted 8 lines
drivers/spi/spi-geni-qcom.c +3
-1@@ -380,15 +558,38 @@ static int spi_geni_init(struct spi_geni_master *mas)else mas->oversampling =1 ; -geni_se_select_mode (se,GENI_SE_FIFO ); + fifo_disable =readl (se->base +GENI_IF_DISABLE_RO ) &FIFO_IF_DISABLE ; +switch (fifo_disable) { +case 1 :
drivers/spi/spi-geni-qcom.c static int spi_geni_init(struct spi_geni_master *mas) · line 573
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+ ret =spi_geni_grab_gpi_chan (mas); +if (!ret) {/* success case */ + mas->cur_xfer_mode =GENI_GPI_DMA ; +geni_se_select_mode (se,GENI_GPI_DMA ); +dev_dbg (mas->dev,"Using GPI DMA mode for SPI\n" ); +break ; + } +/* +* in case of failure to get dma channel, we can still do the +* FIFO mode, so fallthrough
Maybe mention that "FIFO_IF_DISABLE" is poorly named in the comments?
Quoted 5 lines
drivers/spi/spi-geni-qcom.c +5
-0+*/ +dev_warn (mas->dev,"FIFO mode disabled, but couldn't get DMA, fall back to FIFO mode\n" ); + fallthrough; + +case 0 :
drivers/spi/spi-geni-qcom.c static int spi_geni_init(struct spi_geni_master *mas) · line 588
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +5
-0+ mas->cur_xfer_mode =GENI_SE_FIFO ; +geni_se_select_mode (se,GENI_SE_FIFO ); + ret =0 ; +break ; + }/* We always control CS manually */ spi_tx_cfg =readl (se->base +SE_SPI_TRANS_CFG ); spi_tx_cfg &= ~CS_TOGGLE ;writel (spi_tx_cfg, se->base +SE_SPI_TRANS_CFG );
Is the above "We always control CS manually" only for FIFO mode? It must be, right? Move this to the FIFO section?
drivers/spi/spi-geni-qcom.c static int spi_geni_probe(struct platform_device *pdev) · line 953
Quoted 11 lines
drivers/spi/spi-geni-qcom.c +7
-0@@ -732,9 +944,17 @@ static int spi_geni_probe(struct platform_device *pdev)if (ret) goto spi_geni_probe_runtime_disable; +/* +* check the mode supported and set_cs for fifo mode only +* for dma (gsi) mode, the gsi will set cs based on params passed in +* TRE +*/ +if (mas->cur_xfer_mode ==GENI_SE_FIFO ) + spi->set_cs = spi_geni_set_cs;
It occurs to me that the other thing that's broken about not being able to set chip select manually is that you can't handle the chip select polarity (SPI_CS_HIGH), right? Maybe in the GSI transfer code you should be error checking that wasn't set?
-Doug
Quoted 18 lines · Doug Anderson
Hi,
Quoted 15 lines · Vinod Koul
We can use GPI DMA for devices where it is enabled by firmware. Add support for this mode
Signed-off-by Vinod Koul <[email protected]>--
(quoted diff) +0
-2-Changes since v4: - Fix the kbuild bot warning -Changes since v3: - Drop merged spi core, geni patches - Remove global structs and use local variables instead - modularize code more as suggested by Doug - fix kbuild bot warning
Quoted 5 lines
Quoted 2 lines
drivers/spi/spi-geni-qcom.c | 254 +++++++++++++++++++++++++++++++++--- 1 file changed, 239 insertions(+), 15 deletions(-)This is already landed, but better review late than never? Maybe you can do a followup patch?
Thanks for the review, better late than never! I will follow up on this.
Quoted 18 lines
Quoted 18 lines
drivers/spi/spi-geni-qcom.c +3
-0@@ -2,6 +2,9 @@// Copyright (c) 2017-2018, The Linux foundation. All rights reserved. #include <linux/clk.h> +#include <linux/dmaengine.h> +#include <linux/dma-mapping.h> +#include <linux/dma/qcom-gpi-dma.h> #include <linux/interrupt.h> #include <linux/io.h> #include <linux/log2.h> @@ -63,6 +66,15 @@#define TIMESTAMP_AFTER BIT(3)#define POST_CMD_DELAY BIT(4)
Quoted 10 lines
drivers/spi/spi-geni-qcom.c line 76
Quoted 8 lines
drivers/spi/spi-geni-qcom.c +8
-0+#define GSI_LOOPBACK_EN BIT(0) +#define GSI_CS_TOGGLE BIT(3) +#define GSI_CPHA BIT(4) +#define GSI_CPOL BIT(5) + +#define MAX_TX_SG 3 +#define NUM_SPI_XFER 8 +#define SPI_XFER_TIMEOUT_MS 250Above three #defines are not used anywhere.
Yes will remove
Quoted 25 lines
Quoted 9 lines
drivers/spi/spi-geni-qcom.c +5
-0@@ -330,34 +345,197 @@ static int setup_fifo_params(struct spi_device *spi_slv,return geni_spi_set_clock_and_bw (mas, spi_slv->max_speed_hz); } +static void +spi_gsi_callback_result (void *cb,const struct dmaengine_result *result) +{ +struct spi_master *spi = cb; +drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 362
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+if (result->result !=DMA_TRANS_NOERROR ) { +dev_err (&spi->dev,"DMA txn failed: %d\n" , result->result); +return ; + } + +if (!result->residue) { +dev_dbg (&spi->dev,"DMA txn completed\n" ); +spi_finalize_current_transfer (spi); + }else { +dev_err (&spi->dev,"DMA xfer has pending: %d\n" , result->residue);Wouldn't hurt to add a comment above saying that you're relying on the SPI core to timeout to get the system back in a usage state.
nit that I'd also reorganize to make the two error cases to be more parallel:
Quoted 9 lines
if (
result->result!=DMA_TRANS_NOERROR) {
dev_err(...);
return;
}
if (result->residue) {
dev_err(...);
return;
}spi_finalize_current_transfer(...);
Should we always call spi_finalize_current_transfer() ? This way we timeout... What is the way to signal error has occurred..?
Quoted 14 lines
Quoted 14 lines
drivers/spi/spi-geni-qcom.c +14
-0+static int setup_gsi_xfer (struct spi_transfer *xfer,struct spi_geni_master *mas, +struct spi_device *spi_slv,struct spi_master *spi) +{ +unsigned long flags =DMA_PREP_INTERRUPT |DMA_CTRL_ACK ; +struct dma_slave_config config = {}; +struct gpi_spi_config peripheral = {}; +struct dma_async_tx_descriptor *tx_desc, *rx_desc; +int ret; + + config.peripheral_config = &peripheral; + config.peripheral_size =sizeof (peripheral); + peripheral.set_config = true; + + if (xfer->bits_per_word != mas->cur_bits_per_word ||
Quoted 8 lines
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 383
Quoted 4 lines
drivers/spi/spi-geni-qcom.c +4
-0+ xfer->speed_hz != mas->cur_speed_hz) { + mas->cur_bits_per_word = xfer->bits_per_word; + mas->cur_speed_hz = xfer->speed_hz; + }I'm pretty sure that "
mas->cur_bits_per_word" isn't used in GSI mode (except below, where you could just use the values "xfer"), so you could get rid of this?
It is used below to get rx_len, i can try changing this
Quoted 4 lines
For "
mas->cur_speed_hz" maybe you should be using this to avoid unnecessary calls toget_spi_clk_cfg()for when the clock didn't change?
Yeah we can do that
Quoted 16 lines
Quoted 16 lines
drivers/spi/spi-geni-qcom.c +16
-0+ +if (xfer->tx_buf && xfer->rx_buf) { + peripheral.cmd =SPI_DUPLEX ; + }else if (xfer->tx_buf) { + peripheral.cmd =SPI_TX ; + peripheral.rx_len =0 ; + }else if (xfer->rx_buf) { + peripheral.cmd =SPI_RX ; +if (!(mas->cur_bits_per_word %MIN_WORD_LEN )) { + peripheral.rx_len = ((xfer->len <<3 ) / mas->cur_bits_per_word); + }else { +int bytes_per_word = (mas->cur_bits_per_word /BITS_PER_BYTE ) +1 ; + + peripheral.rx_len = (xfer->len / bytes_per_word); + } + }
Quoted 8 lines
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 403
Quoted 4 lines
drivers/spi/spi-geni-qcom.c +4
-0+ + peripheral.loopback_en = !!(spi_slv->mode &SPI_LOOP ); + peripheral.clock_pol_high = !!(spi_slv->mode &SPI_CPOL ); + peripheral.data_pol_high = !!(spi_slv->mode &SPI_CPHA );The fact that the "!!" above is actually needed is a sign that the "struct
gpi_spi_config" definition should be fixed. It should declare things as "bool", not "u8". Then you can get rid of the "!!" here.
That is a good advice, yeah it should be a bool
Quoted 42 lines
Quoted 30 lines
drivers/spi/spi-geni-qcom.c +30
-0+ peripheral.cs = spi_slv->chip_select; + peripheral.pack_en = true; + peripheral.word_len = xfer->bits_per_word -MIN_WORD_LEN ; + + ret =get_spi_clk_cfg (mas->cur_speed_hz, mas, + &peripheral.clk_src, &peripheral.clk_div); +if (ret) { +dev_err (mas->dev,"Err in get_spi_clk_cfg() :%d\n" , ret); +return ret; + } + +if (!xfer->cs_change) { +if (!list_is_last (&xfer->transfer_list, &spi->cur_msg->transfers)) + peripheral.fragmentation =FRAGMENTATION ; + } + +if (peripheral.cmd &SPI_RX ) { +dmaengine_slave_config (mas->rx, &config); + rx_desc =dmaengine_prep_slave_sg (mas->rx, xfer->rx_sg.sgl, xfer->rx_sg.nents, +DMA_DEV_TO_MEM , flags); +if (!rx_desc) { +dev_err (mas->dev,"Err setting up rx desc\n" ); +return -EIO ; + } + } + +/* +* Prepare the TX always, even for RX or tx_buf being null, we would +* need TX to be prepared per GSI spec +*/ drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 443
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+dmaengine_slave_config (mas->tx, &config); + tx_desc =dmaengine_prep_slave_sg (mas->tx, xfer->tx_sg.sgl, xfer->tx_sg.nents, +DMA_MEM_TO_DEV , flags); +if (!tx_desc) { +dev_err (mas->dev,"Err setting up tx desc\n" ); +return -EIO ; + } + + tx_desc->callback_result = spi_gsi_callback_result; + tx_desc->callback_param = spi;I guess now when you get the TX callback then you assume that both the
Quoted 8 lines
TX and RX are done. Is that truly safe? Perhaps I'm being paranoid (or maybe I just don't understand how things work), but I could sorta imagine that the peripheral has finished transmitting all the data but hasn't managed to DMA all the data that it received into main memory. If we were only going to pick one callback to register for and we have both TX and RX going, it seems like we should register for RX. Because of the way SPI works it seems like it would be impossible for TX to still be going if RX is fully done.
So, the way GSI works it we submit TX and RX always and we would get the callback when the 'transfer' is completed, not when TX is done...
So it is perfectly fine to rely on one. Since we have TX always, it makes sense to do this on TX
Quoted 17 lines
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 453
Quoted 11 lines
drivers/spi/spi-geni-qcom.c +9
-0+if (peripheral.cmd &SPI_RX ) +dmaengine_submit (rx_desc); +dmaengine_submit (tx_desc); + +if (peripheral.cmd &SPI_RX ) +dma_async_issue_pending (mas->rx); + +dma_async_issue_pending (mas->tx); +return 1 ;You're returning "1" here which lets the SPI core do all the timeout handling, right? ...but that means you need to provide the SPI core with a way to abort your transfer if it times out. This should be in
spi->handle_err(). Right now that points tohandle_fifo_timeout(). I think you need to add code to handle errors for GPI mode too.
Missed that, we should handle that and do abort there
Quoted 22 lines
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 494
Quoted 6 lines
drivers/spi/spi-geni-qcom.c +6
-0+static int spi_geni_grab_gpi_chan (struct spi_geni_master *mas) +{ +int ret; + + mas->tx =dma_request_chan (mas->dev,"tx" ); + ret =dev_err_probe (mas->dev,IS_ERR (mas->tx),"Failed to get tx DMA ch\n" );s/IS_ERR/ERR_PTR/
dev_err_probetakes an error code, not a boolean. The way you've coded it all errors will be reported as "error 1". You'll also never trip the "if" test below (I suppose a smarter compiler could even detect this?) since "ret" will always be either 0 or 1 (and neither of those is < 0)drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 499
Quoted 5 lines
drivers/spi/spi-geni-qcom.c +5
-0+if (ret <0 ) + goto err_tx; + + mas->rx =dma_request_chan (mas->dev,"rx" ); + ret =dev_err_probe (mas->dev,IS_ERR (mas->rx),"Failed to get rx DMA ch\n" );
Quoted 4 lines
s/IS_ERR/ERR_PTR/
dev_err_probetakes an error code, not a boolean. The way you've coded it all errors will be reported as "error 1".
Yeah I messed that, though a patch has been made and merged already
Quoted 7 lines
Quoted 7 lines
drivers/spi/spi-geni-qcom.c +7
-0+static void spi_geni_release_dma_chan (struct spi_geni_master *mas) +{ +if (mas->rx) { +dma_release_channel (mas->rx); + mas->rx =NULL ; + } +
Quoted 8 lines
drivers/spi/spi-geni-qcom.c static int setup_fifo_params(struct spi_device *spi_slv, · line 523
Quoted 4 lines
drivers/spi/spi-geni-qcom.c +4
-0+if (mas->tx) { +dma_release_channel (mas->tx); + mas->tx =NULL ; + }nit: I would have skipped the setting to NULL. This is only used in the probe error and in the removal case and there's just no reason to NULL these out.
True, but eventually we should release channels when not in use, so I added this here for that eventuality...
Quoted 4 lines
Quoted 4 lines
drivers/spi/spi-geni-qcom.c +0
-0@@ -380,15 +558,38 @@ static int spi_geni_init(struct spi_geni_master *mas)else mas->oversampling =1 ;
Quoted 16 lines
Quoted 4 lines
drivers/spi/spi-geni-qcom.c +3
-1-geni_se_select_mode (se,GENI_SE_FIFO ); + fifo_disable =readl (se->base +GENI_IF_DISABLE_RO ) &FIFO_IF_DISABLE ; +switch (fifo_disable) { +case 1 :drivers/spi/spi-geni-qcom.c static int spi_geni_init(struct spi_geni_master *mas) · line 573
Quoted 10 lines
drivers/spi/spi-geni-qcom.c +10
-0+ ret =spi_geni_grab_gpi_chan (mas); +if (!ret) {/* success case */ + mas->cur_xfer_mode =GENI_GPI_DMA ; +geni_se_select_mode (se,GENI_GPI_DMA ); +dev_dbg (mas->dev,"Using GPI DMA mode for SPI\n" ); +break ; + } +/* +* in case of failure to get dma channel, we can still do the +* FIFO mode, so fallthrough Maybe mention that "
FIFO_IF_DISABLE" is poorly named in the comments?
ok
Quoted 13 lines
Quoted 13 lines
drivers/spi/spi-geni-qcom.c +10
-0+*/ +dev_warn (mas->dev,"FIFO mode disabled, but couldn't get DMA, fall back to FIFO mode\n" ); + fallthrough; + +case 0 : + mas->cur_xfer_mode =GENI_SE_FIFO ; +geni_se_select_mode (se,GENI_SE_FIFO ); + ret =0 ; +break ; + }
Quoted 7 lines
drivers/spi/spi-geni-qcom.c static int spi_geni_init(struct spi_geni_master *mas) · line 588
Quoted 4 lines
drivers/spi/spi-geni-qcom.c +0
-0/* We always control CS manually */ spi_tx_cfg =readl (se->base +SE_SPI_TRANS_CFG ); spi_tx_cfg &= ~CS_TOGGLE ;writel (spi_tx_cfg, se->base +SE_SPI_TRANS_CFG );Is the above "We always control CS manually" only for FIFO mode? It must be, right? Move this to the FIFO section?
yes it should be. CS is handled by gsi controller in GSI mode.
Quoted 6 lines
Quoted 6 lines
drivers/spi/spi-geni-qcom.c +0
-0@@ -732,9 +944,17 @@ static int spi_geni_probe(struct platform_device *pdev)if (ret) goto spi_geni_probe_runtime_disable;
Quoted 12 lines
drivers/spi/spi-geni-qcom.c static int spi_geni_probe(struct platform_device *pdev) · line 953
Quoted 7 lines
drivers/spi/spi-geni-qcom.c +7
-0+/* +* check the mode supported and set_cs for fifo mode only +* for dma (gsi) mode, the gsi will set cs based on params passed in +* TRE +*/ +if (mas->cur_xfer_mode ==GENI_SE_FIFO ) + spi->set_cs = spi_geni_set_cs;It occurs to me that the other thing that's broken about not being able to set chip select manually is that you can't handle the chip select polarity (
SPI_CS_HIGH), right? Maybe in the GSI transfer code you should be error checking that wasn't set?
I didnt find a way to pass polarity of CS thru flags in the Spec. Let me ask QC about that. I can see we have toggle and delay there, but not polarity..
Signature · 1 line
~Vinod
Mark Brown
maintainerQuoted 10 lines · Vinod Koul
Quoted 5 lines · Doug Anderson
if (
result->residue) {
dev_err(...);
return;
}spi_finalize_current_transfer(...);Should we always call
spi_finalize_current_transfer()? This way we timeout... What is the way to signal error has occurred..?
Yes, set an error in the transfer and then finalize it.
Quoted 9 lines · Mark Brown
Quoted 7 lines · Vinod Koul
Quoted 5 lines · Doug Anderson
if (
result->residue) {
dev_err(...);
return;
}spi_finalize_current_transfer(...);
Quoted 4 lines
Quoted 2 lines
Should we always call
spi_finalize_current_transfer()? This way we timeout... What is the way to signal error has occurred..?Yes, set an error in the transfer and then finalize it.
Sure will do, thanks for confirming Mark
Signature · 1 line
~Vinod