diff mbox series

[v2,09/10] mfd: bd9571mwv: Make the driver more generic

Message ID 1607686060-17448-10-git-send-email-yoshihiro.shimoda.uh@renesas.com
State New
Headers show
Series treewide: bd9571mwv: Add support for BD9574MWF | expand

Commit Message

Yoshihiro Shimoda Dec. 11, 2020, 11:27 a.m. UTC
From: Khiem Nguyen <khiem.nguyen.xt@renesas.com>

Since the driver supports BD9571MWV PMIC only,
this patch makes the functions and data structure become more generic
so that it can support other PMIC variants as well.

Signed-off-by: Khiem Nguyen <khiem.nguyen.xt@renesas.com>
[shimoda: rebase and refactor]
Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>
---
 drivers/mfd/bd9571mwv.c       | 71 +++++++++++++++++++++++++++++++++++--------
 include/linux/mfd/bd9571mwv.h | 18 ++---------
 2 files changed, 62 insertions(+), 27 deletions(-)

Comments

Vaittinen, Matti Dec. 11, 2020, 1:29 p.m. UTC | #1
Hi Yoshihiro-san,


On Fri, 2020-12-11 at 20:27 +0900, Yoshihiro Shimoda wrote:
> From: Khiem Nguyen <khiem.nguyen.xt@renesas.com>

> 

> Since the driver supports BD9571MWV PMIC only,

> this patch makes the functions and data structure become more generic

> so that it can support other PMIC variants as well.

> 

> Signed-off-by: Khiem Nguyen <khiem.nguyen.xt@renesas.com>

> [shimoda: rebase and refactor]

> Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>

> ---

>  drivers/mfd/bd9571mwv.c       | 71

> +++++++++++++++++++++++++++++++++++--------

>  include/linux/mfd/bd9571mwv.h | 18 ++---------

>  2 files changed, 62 insertions(+), 27 deletions(-)

> 

> diff --git a/drivers/mfd/bd9571mwv.c b/drivers/mfd/bd9571mwv.c

> index 80c6ef0..adb9e3d 100644

> --- a/drivers/mfd/bd9571mwv.c

> +++ b/drivers/mfd/bd9571mwv.c

> @@ -3,6 +3,7 @@

>   * ROHM BD9571MWV-M MFD driver

>   *

>   * Copyright (C) 2017 Marek Vasut <marek.vasut+renesas@gmail.com>

> + * Copyright (C) 2020 Renesas Electronics Corporation

>   *

>   * Based on the TPS65086 driver

>   */

> @@ -14,6 +15,34 @@

>  

>  #include <linux/mfd/bd9571mwv.h>

>  

> +/**

> + * struct bd957x_data - internal data for the bd957x driver

> + *

> + * Internal data to distinguish bd957x variants

> + */

> +struct bd957x_data {

> +	char *part_name;

> +	const struct regmap_config *regmap_config;

> +	const struct regmap_irq_chip *irq_chip;

> +	const struct mfd_cell *cells;

> +	int num_cells;

> +};

> +

> +/**

> + * struct bd9571mwv - state holder for the bd9571mwv driver

> + *

> + * Device data may be used to access the BD9571MWV chip

> + */

> +struct bd9571mwv {

> +	struct device *dev;

> +	struct regmap *regmap;

> +	const struct bd957x_data *data;

> +

> +	/* IRQ Data */

> +	int irq;

> +	struct regmap_irq_chip_data *irq_data;

> +};

> +


I still don't see why you actually need this structure?

>  static const struct mfd_cell bd9571mwv_cells[] = {

>  	{ .name = "bd9571mwv-regulator", },

>  	{ .name = "bd9571mwv-gpio", },

> @@ -102,6 +131,14 @@ static struct regmap_irq_chip bd9571mwv_irq_chip

> = {

>  	.num_irqs	= ARRAY_SIZE(bd9571mwv_irqs),

>  };

>  

> +static const struct bd957x_data bd9571mwv_data = {

> +	.part_name = BD9571MWV_PART_NAME,

> +	.regmap_config = &bd9571mwv_regmap_config,

> +	.irq_chip = &bd9571mwv_irq_chip,

> +	.cells = bd9571mwv_cells,

> +	.num_cells = ARRAY_SIZE(bd9571mwv_cells),

> +};

> +

>  static int bd9571mwv_identify(struct bd9571mwv *bd)

>  {

>  	struct device *dev = bd->dev;

> @@ -127,13 +164,6 @@ static int bd9571mwv_identify(struct bd9571mwv

> *bd)

>  			ret);

>  		return ret;

>  	}

> -

> -	if (value != BD9571MWV_PRODUCT_CODE_VAL) {

> -		dev_err(dev, "Invalid product code ID %02x (expected

> %02x)\n",

> -			value, BD9571MWV_PRODUCT_CODE_VAL);

> -		return -EINVAL;

> -	}

> -

>  	ret = regmap_read(bd->regmap, BD9571MWV_PRODUCT_REVISION,

> &value);

>  	if (ret) {

>  		dev_err(dev, "Failed to read revision register

> (ret=%i)\n",

> @@ -141,7 +171,8 @@ static int bd9571mwv_identify(struct bd9571mwv

> *bd)

>  		return ret;

>  	}

>  

> -	dev_info(dev, "Device: BD9571MWV rev. %d\n", value & 0xff);

> +	dev_info(dev, "Device: %s rev. %d\n", bd->data->part_name,

> +		 value & 0xff);

>  

>  	return 0;

>  }

> @@ -160,7 +191,23 @@ static int bd9571mwv_probe(struct i2c_client

> *client,

>  	bd->dev = &client->dev;

>  	bd->irq = client->irq;

>  

> -	bd->regmap = devm_regmap_init_i2c(client,

> &bd9571mwv_regmap_config);

> +	/* Read the PMIC product code */

> +	ret = i2c_smbus_read_byte_data(client, BD9571MWV_PRODUCT_CODE);

> +	if (ret < 0) {

> +		dev_err(&client->dev, "failed reading at 0x%02x\n",

> +			BD9571MWV_PRODUCT_CODE);

> +		return ret;

> +	}

> +	switch (ret) {

> +	case BD9571MWV_PRODUCT_CODE_VAL:

> +		bd->data = &bd9571mwv_data;

> +		break;

> +	default:

> +		dev_err(bd->dev, "Unsupported device 0x%x\n", ret);

> +		return -ENOENT;

> +	}

> +

> +	bd->regmap = devm_regmap_init_i2c(client, bd->data-

> >regmap_config);

>  	if (IS_ERR(bd->regmap)) {

>  		dev_err(bd->dev, "Failed to initialize register

> map\n");

>  		return PTR_ERR(bd->regmap);

> @@ -171,14 +218,14 @@ static int bd9571mwv_probe(struct i2c_client

> *client,

>  		return ret;

>  

>  	ret = regmap_add_irq_chip(bd->regmap, bd->irq, IRQF_ONESHOT, 0,

> -				  &bd9571mwv_irq_chip, &bd->irq_data);

> +				  bd->data->irq_chip, &bd->irq_data);


I think you already did the big task when you cleaned up the sub-
drivers from using the struct bd9571mwv. Thumbs up for that!

So, as I said in comment to previous version - I don't see this struct
bd9571mwv being really used anywhere else but as an argument to IC
identification function and argument for the remove. I think that by
switching regmap_add_irq_chip to devm_regmap_add_irq_chip you could get
rid of the remove, error cleanup path and the i2c_clientdata. And if
you revised the arguments for identification function you could
probably further clean the struct definitions.

But as I previously said - this is only a 'nit' from me. I appreciate
your work with these drivers!

>  	if (ret) {

>  		dev_err(bd->dev, "Failed to register IRQ chip\n");

>  		return ret;

>  	}

>  

> -	ret = mfd_add_devices(bd->dev, PLATFORM_DEVID_AUTO,

> bd9571mwv_cells,

> -			      ARRAY_SIZE(bd9571mwv_cells), NULL, 0,

> +	ret = mfd_add_devices(bd->dev, PLATFORM_DEVID_AUTO, bd->data-

> >cells,

> +			      bd->data->num_cells, NULL, 0,

>  			      regmap_irq_get_domain(bd->irq_data));

>  	if (ret) {

>  		regmap_del_irq_chip(bd->irq, bd->irq_data);

> diff --git a/include/linux/mfd/bd9571mwv.h

> b/include/linux/mfd/bd9571mwv.h

> index bcc7092..5ab976a 100644

> --- a/include/linux/mfd/bd9571mwv.h

> +++ b/include/linux/mfd/bd9571mwv.h

> @@ -3,6 +3,7 @@

>   * ROHM BD9571MWV-M driver

>   *

>   * Copyright (C) 2017 Marek Vasut <marek.vasut+renesas@gmail.com>

> + * Copyright (C) 2020 Renesas Electronics Corporation

>   *

>   * Based on the TPS65086 driver

>   */

> @@ -83,6 +84,8 @@

>  

>  #define BD9571MWV_ACCESS_KEY			0xff

>  

> +#define BD9571MWV_PART_NAME			"BD9571MWV"

> +

>  /* Define the BD9571MWV IRQ numbers */

>  enum bd9571mwv_irqs {

>  	BD9571MWV_IRQ_MD1,

> @@ -94,19 +97,4 @@ enum bd9571mwv_irqs {

>  	BD9571MWV_IRQ_WDT_OF,

>  	BD9571MWV_IRQ_BKUP_TRG,

>  };

> -

> -/**

> - * struct bd9571mwv - state holder for the bd9571mwv driver

> - *

> - * Device data may be used to access the BD9571MWV chip

> - */

> -struct bd9571mwv {

> -	struct device *dev;

> -	struct regmap *regmap;

> -

> -	/* IRQ Data */

> -	int irq;

> -	struct regmap_irq_chip_data *irq_data;

> -};

> -

>  #endif /* __LINUX_MFD_BD9571MWV_H */



Best Regards
    Matti Vaittinen
Yoshihiro Shimoda Dec. 14, 2020, 6:21 a.m. UTC | #2
Hi Matti-san,

Thank you for your review!

> From: Vaittinen, Matti, Sent: Friday, December 11, 2020 10:29 PM

> 

> Hi Yoshihiro-san,

> 

> On Fri, 2020-12-11 at 20:27 +0900, Yoshihiro Shimoda wrote:

> > From: Khiem Nguyen <khiem.nguyen.xt@renesas.com>

> >

> > Since the driver supports BD9571MWV PMIC only,

> > this patch makes the functions and data structure become more generic

> > so that it can support other PMIC variants as well.

> >

> > Signed-off-by: Khiem Nguyen <khiem.nguyen.xt@renesas.com>

> > [shimoda: rebase and refactor]

> > Signed-off-by: Yoshihiro Shimoda <yoshihiro.shimoda.uh@renesas.com>

> > ---

> >  drivers/mfd/bd9571mwv.c       | 71

> > +++++++++++++++++++++++++++++++++++--------

> >  include/linux/mfd/bd9571mwv.h | 18 ++---------

> >  2 files changed, 62 insertions(+), 27 deletions(-)

> >

> > diff --git a/drivers/mfd/bd9571mwv.c b/drivers/mfd/bd9571mwv.c

> > index 80c6ef0..adb9e3d 100644

> > --- a/drivers/mfd/bd9571mwv.c

> > +++ b/drivers/mfd/bd9571mwv.c

<snip>
> > +struct bd9571mwv {

> > +	struct device *dev;

> > +	struct regmap *regmap;

> > +	const struct bd957x_data *data;

> > +

> > +	/* IRQ Data */

> > +	int irq;

> > +	struct regmap_irq_chip_data *irq_data;

> > +};

> > +

> 

> I still don't see why you actually need this structure?


I'm sorry. I completely forgot that you said we can remove this
structure in the previous patch's review...

> >  static const struct mfd_cell bd9571mwv_cells[] = {

> >  	{ .name = "bd9571mwv-regulator", },

> >  	{ .name = "bd9571mwv-gpio", },

> > @@ -102,6 +131,14 @@ static struct regmap_irq_chip bd9571mwv_irq_chip

> > = {

> >  	.num_irqs	= ARRAY_SIZE(bd9571mwv_irqs),

> >  };

> >

> > +static const struct bd957x_data bd9571mwv_data = {

> > +	.part_name = BD9571MWV_PART_NAME,

> > +	.regmap_config = &bd9571mwv_regmap_config,

> > +	.irq_chip = &bd9571mwv_irq_chip,

> > +	.cells = bd9571mwv_cells,

> > +	.num_cells = ARRAY_SIZE(bd9571mwv_cells),

> > +};

> > +

> >  static int bd9571mwv_identify(struct bd9571mwv *bd)

> >  {

> >  	struct device *dev = bd->dev;

> > @@ -127,13 +164,6 @@ static int bd9571mwv_identify(struct bd9571mwv

> > *bd)

> >  			ret);

> >  		return ret;

> >  	}

> > -

> > -	if (value != BD9571MWV_PRODUCT_CODE_VAL) {

> > -		dev_err(dev, "Invalid product code ID %02x (expected

> > %02x)\n",

> > -			value, BD9571MWV_PRODUCT_CODE_VAL);

> > -		return -EINVAL;

> > -	}

> > -

> >  	ret = regmap_read(bd->regmap, BD9571MWV_PRODUCT_REVISION,

> > &value);

> >  	if (ret) {

> >  		dev_err(dev, "Failed to read revision register

> > (ret=%i)\n",

> > @@ -141,7 +171,8 @@ static int bd9571mwv_identify(struct bd9571mwv

> > *bd)

> >  		return ret;

> >  	}

> >

> > -	dev_info(dev, "Device: BD9571MWV rev. %d\n", value & 0xff);

> > +	dev_info(dev, "Device: %s rev. %d\n", bd->data->part_name,

> > +		 value & 0xff);

> >

> >  	return 0;

> >  }

> > @@ -160,7 +191,23 @@ static int bd9571mwv_probe(struct i2c_client

> > *client,

> >  	bd->dev = &client->dev;

> >  	bd->irq = client->irq;

> >

> > -	bd->regmap = devm_regmap_init_i2c(client,

> > &bd9571mwv_regmap_config);

> > +	/* Read the PMIC product code */

> > +	ret = i2c_smbus_read_byte_data(client, BD9571MWV_PRODUCT_CODE);

> > +	if (ret < 0) {

> > +		dev_err(&client->dev, "failed reading at 0x%02x\n",

> > +			BD9571MWV_PRODUCT_CODE);

> > +		return ret;

> > +	}

> > +	switch (ret) {

> > +	case BD9571MWV_PRODUCT_CODE_VAL:

> > +		bd->data = &bd9571mwv_data;

> > +		break;

> > +	default:

> > +		dev_err(bd->dev, "Unsupported device 0x%x\n", ret);

> > +		return -ENOENT;

> > +	}

> > +

> > +	bd->regmap = devm_regmap_init_i2c(client, bd->data-

> > >regmap_config);

> >  	if (IS_ERR(bd->regmap)) {

> >  		dev_err(bd->dev, "Failed to initialize register

> > map\n");

> >  		return PTR_ERR(bd->regmap);

> > @@ -171,14 +218,14 @@ static int bd9571mwv_probe(struct i2c_client

> > *client,

> >  		return ret;

> >

> >  	ret = regmap_add_irq_chip(bd->regmap, bd->irq, IRQF_ONESHOT, 0,

> > -				  &bd9571mwv_irq_chip, &bd->irq_data);

> > +				  bd->data->irq_chip, &bd->irq_data);

> 

> I think you already did the big task when you cleaned up the sub-

> drivers from using the struct bd9571mwv. Thumbs up for that!

> 

> So, as I said in comment to previous version - I don't see this struct

> bd9571mwv being really used anywhere else but as an argument to IC

> identification function and argument for the remove. I think that by

> switching regmap_add_irq_chip to devm_regmap_add_irq_chip you could get

> rid of the remove, error cleanup path and the i2c_clientdata. And if

> you revised the arguments for identification function you could

> probably further clean the struct definitions.


Thank you for the detailed comments. I agreed we can simplify the code
if we use devm_regmap_add_irq_chip. Also, I found a bug in the current
code which we should call devm_mfd_add_devices() instead of
mfd_add_devices(). So, I'll make a fixed patch too.

> But as I previously said - this is only a 'nit' from me. I appreciate

> your work with these drivers!


Thank you very much for your review!

Best regards,
Yoshihiro Shimoda
diff mbox series

Patch

diff --git a/drivers/mfd/bd9571mwv.c b/drivers/mfd/bd9571mwv.c
index 80c6ef0..adb9e3d 100644
--- a/drivers/mfd/bd9571mwv.c
+++ b/drivers/mfd/bd9571mwv.c
@@ -3,6 +3,7 @@ 
  * ROHM BD9571MWV-M MFD driver
  *
  * Copyright (C) 2017 Marek Vasut <marek.vasut+renesas@gmail.com>
+ * Copyright (C) 2020 Renesas Electronics Corporation
  *
  * Based on the TPS65086 driver
  */
@@ -14,6 +15,34 @@ 
 
 #include <linux/mfd/bd9571mwv.h>
 
+/**
+ * struct bd957x_data - internal data for the bd957x driver
+ *
+ * Internal data to distinguish bd957x variants
+ */
+struct bd957x_data {
+	char *part_name;
+	const struct regmap_config *regmap_config;
+	const struct regmap_irq_chip *irq_chip;
+	const struct mfd_cell *cells;
+	int num_cells;
+};
+
+/**
+ * struct bd9571mwv - state holder for the bd9571mwv driver
+ *
+ * Device data may be used to access the BD9571MWV chip
+ */
+struct bd9571mwv {
+	struct device *dev;
+	struct regmap *regmap;
+	const struct bd957x_data *data;
+
+	/* IRQ Data */
+	int irq;
+	struct regmap_irq_chip_data *irq_data;
+};
+
 static const struct mfd_cell bd9571mwv_cells[] = {
 	{ .name = "bd9571mwv-regulator", },
 	{ .name = "bd9571mwv-gpio", },
@@ -102,6 +131,14 @@  static struct regmap_irq_chip bd9571mwv_irq_chip = {
 	.num_irqs	= ARRAY_SIZE(bd9571mwv_irqs),
 };
 
+static const struct bd957x_data bd9571mwv_data = {
+	.part_name = BD9571MWV_PART_NAME,
+	.regmap_config = &bd9571mwv_regmap_config,
+	.irq_chip = &bd9571mwv_irq_chip,
+	.cells = bd9571mwv_cells,
+	.num_cells = ARRAY_SIZE(bd9571mwv_cells),
+};
+
 static int bd9571mwv_identify(struct bd9571mwv *bd)
 {
 	struct device *dev = bd->dev;
@@ -127,13 +164,6 @@  static int bd9571mwv_identify(struct bd9571mwv *bd)
 			ret);
 		return ret;
 	}
-
-	if (value != BD9571MWV_PRODUCT_CODE_VAL) {
-		dev_err(dev, "Invalid product code ID %02x (expected %02x)\n",
-			value, BD9571MWV_PRODUCT_CODE_VAL);
-		return -EINVAL;
-	}
-
 	ret = regmap_read(bd->regmap, BD9571MWV_PRODUCT_REVISION, &value);
 	if (ret) {
 		dev_err(dev, "Failed to read revision register (ret=%i)\n",
@@ -141,7 +171,8 @@  static int bd9571mwv_identify(struct bd9571mwv *bd)
 		return ret;
 	}
 
-	dev_info(dev, "Device: BD9571MWV rev. %d\n", value & 0xff);
+	dev_info(dev, "Device: %s rev. %d\n", bd->data->part_name,
+		 value & 0xff);
 
 	return 0;
 }
@@ -160,7 +191,23 @@  static int bd9571mwv_probe(struct i2c_client *client,
 	bd->dev = &client->dev;
 	bd->irq = client->irq;
 
-	bd->regmap = devm_regmap_init_i2c(client, &bd9571mwv_regmap_config);
+	/* Read the PMIC product code */
+	ret = i2c_smbus_read_byte_data(client, BD9571MWV_PRODUCT_CODE);
+	if (ret < 0) {
+		dev_err(&client->dev, "failed reading at 0x%02x\n",
+			BD9571MWV_PRODUCT_CODE);
+		return ret;
+	}
+	switch (ret) {
+	case BD9571MWV_PRODUCT_CODE_VAL:
+		bd->data = &bd9571mwv_data;
+		break;
+	default:
+		dev_err(bd->dev, "Unsupported device 0x%x\n", ret);
+		return -ENOENT;
+	}
+
+	bd->regmap = devm_regmap_init_i2c(client, bd->data->regmap_config);
 	if (IS_ERR(bd->regmap)) {
 		dev_err(bd->dev, "Failed to initialize register map\n");
 		return PTR_ERR(bd->regmap);
@@ -171,14 +218,14 @@  static int bd9571mwv_probe(struct i2c_client *client,
 		return ret;
 
 	ret = regmap_add_irq_chip(bd->regmap, bd->irq, IRQF_ONESHOT, 0,
-				  &bd9571mwv_irq_chip, &bd->irq_data);
+				  bd->data->irq_chip, &bd->irq_data);
 	if (ret) {
 		dev_err(bd->dev, "Failed to register IRQ chip\n");
 		return ret;
 	}
 
-	ret = mfd_add_devices(bd->dev, PLATFORM_DEVID_AUTO, bd9571mwv_cells,
-			      ARRAY_SIZE(bd9571mwv_cells), NULL, 0,
+	ret = mfd_add_devices(bd->dev, PLATFORM_DEVID_AUTO, bd->data->cells,
+			      bd->data->num_cells, NULL, 0,
 			      regmap_irq_get_domain(bd->irq_data));
 	if (ret) {
 		regmap_del_irq_chip(bd->irq, bd->irq_data);
diff --git a/include/linux/mfd/bd9571mwv.h b/include/linux/mfd/bd9571mwv.h
index bcc7092..5ab976a 100644
--- a/include/linux/mfd/bd9571mwv.h
+++ b/include/linux/mfd/bd9571mwv.h
@@ -3,6 +3,7 @@ 
  * ROHM BD9571MWV-M driver
  *
  * Copyright (C) 2017 Marek Vasut <marek.vasut+renesas@gmail.com>
+ * Copyright (C) 2020 Renesas Electronics Corporation
  *
  * Based on the TPS65086 driver
  */
@@ -83,6 +84,8 @@ 
 
 #define BD9571MWV_ACCESS_KEY			0xff
 
+#define BD9571MWV_PART_NAME			"BD9571MWV"
+
 /* Define the BD9571MWV IRQ numbers */
 enum bd9571mwv_irqs {
 	BD9571MWV_IRQ_MD1,
@@ -94,19 +97,4 @@  enum bd9571mwv_irqs {
 	BD9571MWV_IRQ_WDT_OF,
 	BD9571MWV_IRQ_BKUP_TRG,
 };
-
-/**
- * struct bd9571mwv - state holder for the bd9571mwv driver
- *
- * Device data may be used to access the BD9571MWV chip
- */
-struct bd9571mwv {
-	struct device *dev;
-	struct regmap *regmap;
-
-	/* IRQ Data */
-	int irq;
-	struct regmap_irq_chip_data *irq_data;
-};
-
 #endif /* __LINUX_MFD_BD9571MWV_H */