Re: [PATCH v2 3/5] mfd: ti_am335x_tscadc: Unify variable naming when referencing ti_tscadc_dev

From: Lee Jones
Date: Thu Jun 09 2016 - 10:48:23 EST


On Wed, 08 Jun 2016, Andrew F. Davis wrote:

> All functions in this driver reference the same ti_tscadc_dev per device
> but use several different names for this structure pointer, this can
> be confusing when following the code. Use the name 'tscadc' everywhere.
>
> Signed-off-by: Andrew F. Davis <afd@xxxxxx>
> Acked-by: Lee Jones <lee.jones@xxxxxxxxxx>
> ---
> drivers/mfd/ti_am335x_tscadc.c | 88 +++++++++++++++++++++---------------------
> 1 file changed, 44 insertions(+), 44 deletions(-)

Applied, thanks.

> diff --git a/drivers/mfd/ti_am335x_tscadc.c b/drivers/mfd/ti_am335x_tscadc.c
> index 613f15d..9b293b1 100644
> --- a/drivers/mfd/ti_am335x_tscadc.c
> +++ b/drivers/mfd/ti_am335x_tscadc.c
> @@ -34,89 +34,89 @@ static const struct regmap_config tscadc_regmap_config = {
> .val_bits = 32,
> };
>
> -void am335x_tsc_se_set_cache(struct ti_tscadc_dev *tsadc, u32 val)
> +void am335x_tsc_se_set_cache(struct ti_tscadc_dev *tscadc, u32 val)
> {
> unsigned long flags;
>
> - spin_lock_irqsave(&tsadc->reg_lock, flags);
> - tsadc->reg_se_cache |= val;
> - if (tsadc->adc_waiting)
> - wake_up(&tsadc->reg_se_wait);
> - else if (!tsadc->adc_in_use)
> - regmap_write(tsadc->regmap_tscadc, REG_SE, tsadc->reg_se_cache);
> + spin_lock_irqsave(&tscadc->reg_lock, flags);
> + tscadc->reg_se_cache |= val;
> + if (tscadc->adc_waiting)
> + wake_up(&tscadc->reg_se_wait);
> + else if (!tscadc->adc_in_use)
> + regmap_write(tscadc->regmap_tscadc, REG_SE, tscadc->reg_se_cache);
>
> - spin_unlock_irqrestore(&tsadc->reg_lock, flags);
> + spin_unlock_irqrestore(&tscadc->reg_lock, flags);
> }
> EXPORT_SYMBOL_GPL(am335x_tsc_se_set_cache);
>
> -static void am335x_tscadc_need_adc(struct ti_tscadc_dev *tsadc)
> +static void am335x_tscadc_need_adc(struct ti_tscadc_dev *tscadc)
> {
> DEFINE_WAIT(wait);
> u32 reg;
>
> - regmap_read(tsadc->regmap_tscadc, REG_ADCFSM, &reg);
> + regmap_read(tscadc->regmap_tscadc, REG_ADCFSM, &reg);
> if (reg & SEQ_STATUS) {
> - tsadc->adc_waiting = true;
> - prepare_to_wait(&tsadc->reg_se_wait, &wait,
> + tscadc->adc_waiting = true;
> + prepare_to_wait(&tscadc->reg_se_wait, &wait,
> TASK_UNINTERRUPTIBLE);
> - spin_unlock_irq(&tsadc->reg_lock);
> + spin_unlock_irq(&tscadc->reg_lock);
>
> schedule();
>
> - spin_lock_irq(&tsadc->reg_lock);
> - finish_wait(&tsadc->reg_se_wait, &wait);
> + spin_lock_irq(&tscadc->reg_lock);
> + finish_wait(&tscadc->reg_se_wait, &wait);
>
> /*
> * Sequencer should either be idle or
> * busy applying the charge step.
> */
> - regmap_read(tsadc->regmap_tscadc, REG_ADCFSM, &reg);
> + regmap_read(tscadc->regmap_tscadc, REG_ADCFSM, &reg);
> WARN_ON((reg & SEQ_STATUS) && !(reg & CHARGE_STEP));
> - tsadc->adc_waiting = false;
> + tscadc->adc_waiting = false;
> }
> - tsadc->adc_in_use = true;
> + tscadc->adc_in_use = true;
> }
>
> -void am335x_tsc_se_set_once(struct ti_tscadc_dev *tsadc, u32 val)
> +void am335x_tsc_se_set_once(struct ti_tscadc_dev *tscadc, u32 val)
> {
> - spin_lock_irq(&tsadc->reg_lock);
> - am335x_tscadc_need_adc(tsadc);
> + spin_lock_irq(&tscadc->reg_lock);
> + am335x_tscadc_need_adc(tscadc);
>
> - regmap_write(tsadc->regmap_tscadc, REG_SE, val);
> - spin_unlock_irq(&tsadc->reg_lock);
> + regmap_write(tscadc->regmap_tscadc, REG_SE, val);
> + spin_unlock_irq(&tscadc->reg_lock);
> }
> EXPORT_SYMBOL_GPL(am335x_tsc_se_set_once);
>
> -void am335x_tsc_se_adc_done(struct ti_tscadc_dev *tsadc)
> +void am335x_tsc_se_adc_done(struct ti_tscadc_dev *tscadc)
> {
> unsigned long flags;
>
> - spin_lock_irqsave(&tsadc->reg_lock, flags);
> - tsadc->adc_in_use = false;
> - regmap_write(tsadc->regmap_tscadc, REG_SE, tsadc->reg_se_cache);
> - spin_unlock_irqrestore(&tsadc->reg_lock, flags);
> + spin_lock_irqsave(&tscadc->reg_lock, flags);
> + tscadc->adc_in_use = false;
> + regmap_write(tscadc->regmap_tscadc, REG_SE, tscadc->reg_se_cache);
> + spin_unlock_irqrestore(&tscadc->reg_lock, flags);
> }
> EXPORT_SYMBOL_GPL(am335x_tsc_se_adc_done);
>
> -void am335x_tsc_se_clr(struct ti_tscadc_dev *tsadc, u32 val)
> +void am335x_tsc_se_clr(struct ti_tscadc_dev *tscadc, u32 val)
> {
> unsigned long flags;
>
> - spin_lock_irqsave(&tsadc->reg_lock, flags);
> - tsadc->reg_se_cache &= ~val;
> - regmap_write(tsadc->regmap_tscadc, REG_SE, tsadc->reg_se_cache);
> - spin_unlock_irqrestore(&tsadc->reg_lock, flags);
> + spin_lock_irqsave(&tscadc->reg_lock, flags);
> + tscadc->reg_se_cache &= ~val;
> + regmap_write(tscadc->regmap_tscadc, REG_SE, tscadc->reg_se_cache);
> + spin_unlock_irqrestore(&tscadc->reg_lock, flags);
> }
> EXPORT_SYMBOL_GPL(am335x_tsc_se_clr);
>
> -static void tscadc_idle_config(struct ti_tscadc_dev *config)
> +static void tscadc_idle_config(struct ti_tscadc_dev *tscadc)
> {
> unsigned int idleconfig;
>
> idleconfig = STEPCONFIG_YNN | STEPCONFIG_INM_ADCREFM |
> STEPCONFIG_INP_ADCREFM | STEPCONFIG_YPN;
>
> - regmap_write(config->regmap_tscadc, REG_IDLECONFIG, idleconfig);
> + regmap_write(tscadc->regmap_tscadc, REG_IDLECONFIG, idleconfig);
> }
>
> static int ti_tscadc_probe(struct platform_device *pdev)
> @@ -298,9 +298,9 @@ static int ti_tscadc_remove(struct platform_device *pdev)
>
> static int __maybe_unused tscadc_suspend(struct device *dev)
> {
> - struct ti_tscadc_dev *tscadc_dev = dev_get_drvdata(dev);
> + struct ti_tscadc_dev *tscadc = dev_get_drvdata(dev);
>
> - regmap_write(tscadc_dev->regmap_tscadc, REG_SE, 0x00);
> + regmap_write(tscadc->regmap_tscadc, REG_SE, 0x00);
> pm_runtime_put_sync(dev);
>
> return 0;
> @@ -308,26 +308,26 @@ static int __maybe_unused tscadc_suspend(struct device *dev)
>
> static int __maybe_unused tscadc_resume(struct device *dev)
> {
> - struct ti_tscadc_dev *tscadc_dev = dev_get_drvdata(dev);
> + struct ti_tscadc_dev *tscadc = dev_get_drvdata(dev);
> u32 ctrl;
>
> pm_runtime_get_sync(dev);
>
> /* context restore */
> ctrl = CNTRLREG_STEPCONFIGWRT | CNTRLREG_STEPID;
> - regmap_write(tscadc_dev->regmap_tscadc, REG_CTRL, ctrl);
> + regmap_write(tscadc->regmap_tscadc, REG_CTRL, ctrl);
>
> - if (tscadc_dev->tsc_cell != -1) {
> - if (tscadc_dev->tsc_wires == 5)
> + if (tscadc->tsc_cell != -1) {
> + if (tscadc->tsc_wires == 5)
> ctrl |= CNTRLREG_5WIRE | CNTRLREG_TSCENB;
> else
> ctrl |= CNTRLREG_4WIRE | CNTRLREG_TSCENB;
> - tscadc_idle_config(tscadc_dev);
> + tscadc_idle_config(tscadc);
> }
> ctrl |= CNTRLREG_TSCSSENB;
> - regmap_write(tscadc_dev->regmap_tscadc, REG_CTRL, ctrl);
> + regmap_write(tscadc->regmap_tscadc, REG_CTRL, ctrl);
>
> - regmap_write(tscadc_dev->regmap_tscadc, REG_CLKDIV, tscadc_dev->clk_div);
> + regmap_write(tscadc->regmap_tscadc, REG_CLKDIV, tscadc->clk_div);
>
> return 0;
> }

--
Lee Jones
Linaro STMicroelectronics Landing Team Lead
Linaro.org â Open source software for ARM SoCs
Follow Linaro: Facebook | Twitter | Blog