diff mbox series

[3/8] spi: imx: use 'time_left' variable with wait_for_completion_timeout()

Message ID 20240429112843.67628-4-wsa+renesas@sang-engineering.com (mailing list archive)
State Superseded
Headers show
Series spi: use 'time_left' instead of 'timeout' with wait_for_*() functions | expand

Commit Message

Wolfram Sang April 29, 2024, 11:28 a.m. UTC
There is a confusing pattern in the kernel to use a variable named 'timeout' to
store the result of wait_for_completion_timeout() causing patterns like:

	timeout = wait_for_completion_timeout(...)
	if (!timeout) return -ETIMEDOUT;

with all kinds of permutations. Use 'time_left' as a variable to make the code
self explaining.

Signed-off-by: Wolfram Sang <wsa+renesas@sang-engineering.com>
---
 drivers/spi/spi-imx.c | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

Comments

Peng Fan April 30, 2024, 1:35 a.m. UTC | #1
> Subject: [PATCH 3/8] spi: imx: use 'time_left' variable with
> wait_for_completion_timeout()
> 
> There is a confusing pattern in the kernel to use a variable named 'timeout' to
> store the result of wait_for_completion_timeout() causing patterns like:
> 
> 	timeout = wait_for_completion_timeout(...)
> 	if (!timeout) return -ETIMEDOUT;
> 
> with all kinds of permutations. Use 'time_left' as a variable to make the code
> self explaining.
> 
> Signed-off-by: Wolfram Sang <wsa+renesas@sang-engineering.com>

Reviewed-by: Peng Fan <peng.fan@nxp.com>
> ---
>  drivers/spi/spi-imx.c | 20 ++++++++++----------
>  1 file changed, 10 insertions(+), 10 deletions(-)
> 
> diff --git a/drivers/spi/spi-imx.c b/drivers/spi/spi-imx.c index
> c3e5cee18bea..f4006c82f867 100644
> --- a/drivers/spi/spi-imx.c
> +++ b/drivers/spi/spi-imx.c
> @@ -1405,7 +1405,7 @@ static int spi_imx_dma_transfer(struct
> spi_imx_data *spi_imx,  {
>  	struct dma_async_tx_descriptor *desc_tx, *desc_rx;
>  	unsigned long transfer_timeout;
> -	unsigned long timeout;
> +	unsigned long time_left;
>  	struct spi_controller *controller = spi_imx->controller;
>  	struct sg_table *tx = &transfer->tx_sg, *rx = &transfer->rx_sg;
>  	struct scatterlist *last_sg = sg_last(rx->sgl, rx->nents); @@ -1471,18
> +1471,18 @@ static int spi_imx_dma_transfer(struct spi_imx_data *spi_imx,
>  	transfer_timeout = spi_imx_calculate_timeout(spi_imx, transfer->len);
> 
>  	/* Wait SDMA to finish the data transfer.*/
> -	timeout = wait_for_completion_timeout(&spi_imx-
> >dma_tx_completion,
> +	time_left = wait_for_completion_timeout(&spi_imx-
> >dma_tx_completion,
>  						transfer_timeout);
> -	if (!timeout) {
> +	if (!time_left) {
>  		dev_err(spi_imx->dev, "I/O Error in DMA TX\n");
>  		dmaengine_terminate_all(controller->dma_tx);
>  		dmaengine_terminate_all(controller->dma_rx);
>  		return -ETIMEDOUT;
>  	}
> 
> -	timeout = wait_for_completion_timeout(&spi_imx-
> >dma_rx_completion,
> -					      transfer_timeout);
> -	if (!timeout) {
> +	time_left = wait_for_completion_timeout(&spi_imx-
> >dma_rx_completion,
> +						transfer_timeout);
> +	if (!time_left) {
>  		dev_err(&controller->dev, "I/O Error in DMA RX\n");
>  		spi_imx->devtype_data->reset(spi_imx);
>  		dmaengine_terminate_all(controller->dma_rx);
> @@ -1501,7 +1501,7 @@ static int spi_imx_pio_transfer(struct spi_device
> *spi,  {
>  	struct spi_imx_data *spi_imx = spi_controller_get_devdata(spi-
> >controller);
>  	unsigned long transfer_timeout;
> -	unsigned long timeout;
> +	unsigned long time_left;
> 
>  	spi_imx->tx_buf = transfer->tx_buf;
>  	spi_imx->rx_buf = transfer->rx_buf;
> @@ -1517,9 +1517,9 @@ static int spi_imx_pio_transfer(struct spi_device
> *spi,
> 
>  	transfer_timeout = spi_imx_calculate_timeout(spi_imx, transfer->len);
> 
> -	timeout = wait_for_completion_timeout(&spi_imx->xfer_done,
> -					      transfer_timeout);
> -	if (!timeout) {
> +	time_left = wait_for_completion_timeout(&spi_imx->xfer_done,
> +						transfer_timeout);
> +	if (!time_left) {
>  		dev_err(&spi->dev, "I/O Error in PIO\n");
>  		spi_imx->devtype_data->reset(spi_imx);
>  		return -ETIMEDOUT;
> --
> 2.43.0
>
diff mbox series

Patch

diff --git a/drivers/spi/spi-imx.c b/drivers/spi/spi-imx.c
index c3e5cee18bea..f4006c82f867 100644
--- a/drivers/spi/spi-imx.c
+++ b/drivers/spi/spi-imx.c
@@ -1405,7 +1405,7 @@  static int spi_imx_dma_transfer(struct spi_imx_data *spi_imx,
 {
 	struct dma_async_tx_descriptor *desc_tx, *desc_rx;
 	unsigned long transfer_timeout;
-	unsigned long timeout;
+	unsigned long time_left;
 	struct spi_controller *controller = spi_imx->controller;
 	struct sg_table *tx = &transfer->tx_sg, *rx = &transfer->rx_sg;
 	struct scatterlist *last_sg = sg_last(rx->sgl, rx->nents);
@@ -1471,18 +1471,18 @@  static int spi_imx_dma_transfer(struct spi_imx_data *spi_imx,
 	transfer_timeout = spi_imx_calculate_timeout(spi_imx, transfer->len);
 
 	/* Wait SDMA to finish the data transfer.*/
-	timeout = wait_for_completion_timeout(&spi_imx->dma_tx_completion,
+	time_left = wait_for_completion_timeout(&spi_imx->dma_tx_completion,
 						transfer_timeout);
-	if (!timeout) {
+	if (!time_left) {
 		dev_err(spi_imx->dev, "I/O Error in DMA TX\n");
 		dmaengine_terminate_all(controller->dma_tx);
 		dmaengine_terminate_all(controller->dma_rx);
 		return -ETIMEDOUT;
 	}
 
-	timeout = wait_for_completion_timeout(&spi_imx->dma_rx_completion,
-					      transfer_timeout);
-	if (!timeout) {
+	time_left = wait_for_completion_timeout(&spi_imx->dma_rx_completion,
+						transfer_timeout);
+	if (!time_left) {
 		dev_err(&controller->dev, "I/O Error in DMA RX\n");
 		spi_imx->devtype_data->reset(spi_imx);
 		dmaengine_terminate_all(controller->dma_rx);
@@ -1501,7 +1501,7 @@  static int spi_imx_pio_transfer(struct spi_device *spi,
 {
 	struct spi_imx_data *spi_imx = spi_controller_get_devdata(spi->controller);
 	unsigned long transfer_timeout;
-	unsigned long timeout;
+	unsigned long time_left;
 
 	spi_imx->tx_buf = transfer->tx_buf;
 	spi_imx->rx_buf = transfer->rx_buf;
@@ -1517,9 +1517,9 @@  static int spi_imx_pio_transfer(struct spi_device *spi,
 
 	transfer_timeout = spi_imx_calculate_timeout(spi_imx, transfer->len);
 
-	timeout = wait_for_completion_timeout(&spi_imx->xfer_done,
-					      transfer_timeout);
-	if (!timeout) {
+	time_left = wait_for_completion_timeout(&spi_imx->xfer_done,
+						transfer_timeout);
+	if (!time_left) {
 		dev_err(&spi->dev, "I/O Error in PIO\n");
 		spi_imx->devtype_data->reset(spi_imx);
 		return -ETIMEDOUT;