[v3,0/7] Add initial support for ATC260x PMICs

The ATC260x family of PMICs integrates Audio Codec, Power management,
Clock generation and GPIO controller blocks. There are currently 3
variants: ATC2603A, ATC2603C and ATC2609A.

This is re-spin of the v1 patch series submitted some time ago by
Mani, who provided the MFD and regulator drivers for ATC2609A:
https://lore.kernel.org/lkml/20190617155011.15376-1-manivannan.sadhasivam@linaro.org/

Since v2, I added support for ATC2603C, together with some new
functionalities for both chips: power controller and onkey input.
The ATC2603A chip type remains unsupported for the moment.

This has been tested on RoseapplePi, a SBC based on the Action Semi S500
SoC, which integrates the ATC2603C variant of the PMIC.

Note that enabling the ATC260x PMICs on compatible Actions Semi Owl SoC
based boards depends on:

* the Actions Semi SIRQ driver (for PMIC DTS setup), merged in v5.10:
  https://lore.kernel.org/lkml/cover.1600114378.git.cristian.ciocaltea@gmail.com/

* the atomic transfers in Owl I2C driver (for power controller), queued for v5.11:
  https://lore.kernel.org/lkml/cover.1602190168.git.cristian.ciocaltea@gmail.com/

Additionally, please note that I have taken the authorship for the MFD
and regulator drivers patches, considering the original code has been
modified to a large extent.

Thanks,
Cristi

Changes in v3:
- Integrated feedback from Mani, Rob, Mark, Sebastian, Dmitry
- Fixed issues reported by Lee's kernel test robot
- Added new patch for 'reset-time-sec' DT binding property
- Rebased patchset on v5.10-rc6

Changes in v2:
- Reworked MFD core & I2C driver
  * Integrated Lee's feedback
  * Added support for using the regmap within atomic contexts
  * Added support for ATC2603C chip variant
  * Reorganized KConfig entries
- Improved regulator driver
  * Added support for ATC2603C variant
  * Used helper macros for more compact specification of regulator_desc items
  * Added more regulator capabilities
- Added power controller driver
  * Provides system poweroff/reboot functionalities
  * Depends on atomic transfers in the Owl I2C driver
- Added onkey driver: exposes the power button as an input device
- Added yaml binding doc
- Rebased patchset on kernel v5.9-rc1

Cristian Ciocaltea (6):
  dt-bindings: input: Add reset-time-sec common property
  dt-bindings: mfd: Add Actions Semi ATC260x PMIC binding
  mfd: Add MFD driver for ATC260x PMICs
  regulator: Add regulator driver for ATC260x PMICs
  power: reset: Add poweroff driver for ATC260x PMICs
  input: atc260x: Add onkey driver for ATC260x PMICs

Manivannan Sadhasivam (1):
  MAINTAINERS: Add entry for ATC260x PMIC

 .../devicetree/bindings/input/input.yaml      |   7 +
 .../bindings/mfd/actions,atc260x.yaml         | 181 ++++++
 MAINTAINERS                                   |  12 +
 drivers/input/misc/Kconfig                    |  11 +
 drivers/input/misc/Makefile                   |   2 +-
 drivers/input/misc/atc260x-onkey.c            | 305 ++++++++++
 drivers/mfd/Kconfig                           |  18 +
 drivers/mfd/Makefile                          |   3 +
 drivers/mfd/atc260x-core.c                    | 290 ++++++++++
 drivers/mfd/atc260x-i2c.c                     |  73 +++
 drivers/power/reset/Kconfig                   |   8 +-
 drivers/power/reset/Makefile                  |   1 +
 drivers/power/reset/atc260x-poweroff.c        | 263 +++++++++
 drivers/regulator/Kconfig                     |   8 +
 drivers/regulator/Makefile                    |   1 +
 drivers/regulator/atc260x-regulator.c         | 524 ++++++++++++++++++
 include/linux/mfd/atc260x/atc2603c.h          | 281 ++++++++++
 include/linux/mfd/atc260x/atc2609a.h          | 308 ++++++++++
 include/linux/mfd/atc260x/core.h              |  86 +++
 19 files changed, 2380 insertions(+), 2 deletions(-)
 create mode 100644 Documentation/devicetree/bindings/mfd/actions,atc260x.yaml
 create mode 100644 drivers/input/misc/atc260x-onkey.c
 create mode 100644 drivers/mfd/atc260x-core.c
 create mode 100644 drivers/mfd/atc260x-i2c.c
 create mode 100644 drivers/power/reset/atc260x-poweroff.c
 create mode 100644 drivers/regulator/atc260x-regulator.c
 create mode 100644 include/linux/mfd/atc260x/atc2603c.h
 create mode 100644 include/linux/mfd/atc260x/atc2609a.h
 create mode 100644 include/linux/mfd/atc260x/core.h

On Sun, Dec 06, 2020 at 03:27:06AM +0200, Cristian Ciocaltea wrote:
> The Actions Semi ATC260x PMICs are able to manage an onkey button.
> This driver exposes the ATC260x onkey as an input device. It can also
> be configured to force a system reset on a long key-press with an
> adjustable duration.
> 
> The currently supported chip variants are ATC2603C and ATC2609A.
> 
> Signed-off-by: Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> ---
> Changes in v3: 
>  - Integrated Dmitry's review:
>    * Dropped the logic around the check for 'pdev->dev.of_node'
>    * Renamed 'ret' variable in 'atc260x_onkey_probe()' to 'error'
>    * Used 'dev_dbg' instead of 'dev_info' on status KEY_RESET_DISABLED
>    * Dropped 'input_dev->evbit[0] = BIT_MASK(EV_KEY);'
>    * Removed IRQF_TRIGGER_HIGH flag on 'devm_request_threaded_irq()'
>    * Implemented open/close to mitigate the racing issue in
>      'atc260x_onkey_remove()' which has been dropped now
>  - Removed the unnecessary driver compatibles
>  - Used 'reset-time-sec' property of the parent device instead of
>    'actions,reset-time-sec' of now obsolete and removed 'onkey' DT node

Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>

Please merge with the rest through MFD I suppose.

Thanks.

On Sat, Dec 05, 2020 at 07:13:19PM -0800, Dmitry Torokhov wrote:
> On Sun, Dec 06, 2020 at 03:27:06AM +0200, Cristian Ciocaltea wrote:
> > The Actions Semi ATC260x PMICs are able to manage an onkey button.
> > This driver exposes the ATC260x onkey as an input device. It can also
> > be configured to force a system reset on a long key-press with an
> > adjustable duration.
> > 
> > The currently supported chip variants are ATC2603C and ATC2609A.
> > 
> > Signed-off-by: Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> > ---
> > Changes in v3: 
> >  - Integrated Dmitry's review:
> >    * Dropped the logic around the check for 'pdev->dev.of_node'
> >    * Renamed 'ret' variable in 'atc260x_onkey_probe()' to 'error'
> >    * Used 'dev_dbg' instead of 'dev_info' on status KEY_RESET_DISABLED
> >    * Dropped 'input_dev->evbit[0] = BIT_MASK(EV_KEY);'
> >    * Removed IRQF_TRIGGER_HIGH flag on 'devm_request_threaded_irq()'
> >    * Implemented open/close to mitigate the racing issue in
> >      'atc260x_onkey_remove()' which has been dropped now
> >  - Removed the unnecessary driver compatibles
> >  - Used 'reset-time-sec' property of the parent device instead of
> >    'actions,reset-time-sec' of now obsolete and removed 'onkey' DT node
> 
> Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
> 
> Please merge with the rest through MFD I suppose.
> 
> Thanks.
> 
> -- 
> Dmitry

Thank you, Dmitry!

On Sun, Dec 06, 2020 at 03:27:04AM +0200, Cristian Ciocaltea wrote:

> +/*
> + * ATC2603C notes:
> + * - LDO8 is not documented in datasheet (v2.4), but supported
> + *   in the vendor's driver implementation (xapp-le-kernel).
> + * - LDO12 mentioned in datasheet is not programmable, hence not
> + *   handled in this driver.
> + */

No reason not to include LDO12 here, the framework supports fixed
regulators fine and the bindings should reflect the physical structure
of the hardware - if something is being supplied by LDO12 on the PMIC
then you'd expect the binding showing a connection from LDO12.

On Mon, Dec 07, 2020 at 01:30:03PM +0000, Mark Brown wrote:
> On Sun, Dec 06, 2020 at 03:27:04AM +0200, Cristian Ciocaltea wrote:
> 
> > +/*
> > + * ATC2603C notes:
> > + * - LDO8 is not documented in datasheet (v2.4), but supported
> > + *   in the vendor's driver implementation (xapp-le-kernel).
> > + * - LDO12 mentioned in datasheet is not programmable, hence not
> > + *   handled in this driver.
> > + */
> 
> No reason not to include LDO12 here, the framework supports fixed
> regulators fine and the bindings should reflect the physical structure
> of the hardware - if something is being supplied by LDO12 on the PMIC
> then you'd expect the binding showing a connection from LDO12.

Totally agree, I will handle this in the next revision.

Thanks,
Cristi

On Sun, 06 Dec 2020, Cristian Ciocaltea wrote:

> Add initial support for the Actions Semi ATC260x PMICs. ATC260x series
> PMICs integrates Audio Codec, Power management, Clock generation and

"which integrates"

> GPIO controller blocks.
> 
> For the moment this driver only supports Regulator, Poweroff and Onkey
> functionalities for the ATC2603C and ATC2609A chip variants.
> 
> Since the PMICs can be accessed using both I2C and SPI buses, the
> following driver structure has been adopted:
> 
>            -----> atc260x-core.c (Implements core functionalities)
>           /
> ATC260x --------> atc260x-i2c.c (Implements I2C interface)
>           \
>            -----> atc260x-spi.c (Implements SPI interface - TODO)
> 
> Co-developed-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> Signed-off-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> Signed-off-by: Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> ---
> Changes in v3:
>  - Fixed the issues reported by Lee's kernel test robot:
>    WARNING: modpost: missing MODULE_LICENSE() in drivers/mfd/atc260x-core.o
>    >> FATAL: modpost: drivers/mfd/atc260x-i2c: sizeof(struct i2c_device_id)=24 is
>       not a modulo of the size of section __mod_i2c__<identifier>_device_table=588.
>    >> Fix definition of struct i2c_device_id in mod_devicetable.h
>  - Dropped the usage of '.of_compatible' fields in {atc2603c,atc2609a}_mfd_cells[]
>  - Added 'Co-developed-by' tag in commit message and dropped [cristian: ...] line
> 
>  drivers/mfd/Kconfig                  |  18 ++
>  drivers/mfd/Makefile                 |   3 +
>  drivers/mfd/atc260x-core.c           | 290 +++++++++++++++++++++++++
>  drivers/mfd/atc260x-i2c.c            |  73 +++++++
>  include/linux/mfd/atc260x/atc2603c.h | 281 ++++++++++++++++++++++++
>  include/linux/mfd/atc260x/atc2609a.h | 308 +++++++++++++++++++++++++++
>  include/linux/mfd/atc260x/core.h     |  86 ++++++++
>  7 files changed, 1059 insertions(+)
>  create mode 100644 drivers/mfd/atc260x-core.c
>  create mode 100644 drivers/mfd/atc260x-i2c.c
>  create mode 100644 include/linux/mfd/atc260x/atc2603c.h
>  create mode 100644 include/linux/mfd/atc260x/atc2609a.h
>  create mode 100644 include/linux/mfd/atc260x/core.h
> 
> diff --git a/drivers/mfd/Kconfig b/drivers/mfd/Kconfig
> index 8b99a13669bf..5556182af41c 100644
> --- a/drivers/mfd/Kconfig
> +++ b/drivers/mfd/Kconfig
> @@ -2076,6 +2076,24 @@ config MFD_WCD934X
>  	  This driver provides common support WCD934x audio codec and its
>  	  associated Pin Controller, Soundwire Controller and Audio codec.
>  
> +config MFD_ATC260X
> +	tristate
> +	select MFD_CORE
> +	select REGMAP
> +	select REGMAP_IRQ
> +
> +config MFD_ATC260X_I2C
> +	tristate "Actions Semi ATC260x PMICs with I2C"
> +	select MFD_ATC260X
> +	select REGMAP_I2C
> +	depends on I2C
> +	help
> +	  Support for the Actions Semi ATC260x PMICs controlled via I2C.
> +
> +	  This driver provides common support for accessing the ATC2603C
> +	  and ATC2609A chip variants, additional drivers must be enabled
> +	  in order to use the functionality of the device.
> +
>  config MFD_KHADAS_MCU
>  	tristate "Support for Khadas System control Microcontroller"
>  	depends on I2C
> diff --git a/drivers/mfd/Makefile b/drivers/mfd/Makefile
> index 1780019d2474..d10362670ac3 100644
> --- a/drivers/mfd/Makefile
> +++ b/drivers/mfd/Makefile
> @@ -267,3 +267,6 @@ obj-$(CONFIG_MFD_KHADAS_MCU) 	+= khadas-mcu.o
>  obj-$(CONFIG_SGI_MFD_IOC3)	+= ioc3.o
>  obj-$(CONFIG_MFD_SIMPLE_MFD_I2C)	+= simple-mfd-i2c.o
>  obj-$(CONFIG_MFD_INTEL_M10_BMC)   += intel-m10-bmc.o
> +
> +obj-$(CONFIG_MFD_ATC260X)	+= atc260x-core.o
> +obj-$(CONFIG_MFD_ATC260X_I2C)	+= atc260x-i2c.o
> diff --git a/drivers/mfd/atc260x-core.c b/drivers/mfd/atc260x-core.c
> new file mode 100644
> index 000000000000..fd3a43b4030d
> --- /dev/null
> +++ b/drivers/mfd/atc260x-core.c
> @@ -0,0 +1,290 @@
> +// SPDX-License-Identifier: GPL-2.0+
> +/*
> + * Core MFD support for ATC260x PMICs

Drop the MFD part please.

> + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> + */
> +
> +#include <linux/interrupt.h>
> +#include <linux/mfd/atc260x/core.h>
> +#include <linux/mfd/core.h>
> +#include <linux/module.h>
> +#include <linux/of.h>
> +#include <linux/of_device.h>
> +#include <linux/regmap.h>
> +
> +static void regmap_lock_mutex(void *__mutex)
> +{
> +	struct mutex *mutex = __mutex;
> +
> +	/*
> +	 * Using regmap within an atomic context (e.g. accessing a PMIC when
> +	 * powering system down) is normally allowed only if the regmap type
> +	 * is MMIO and the regcache type is either REGCACHE_NONE or
> +	 * REGCACHE_FLAT. For slow buses like I2C and SPI, the regmap is
> +	 * internally protected by a mutex which is acquired non-atomically.
> +	 *
> +	 * Let's improve this by using a customized locking scheme inspired
> +	 * from I2C atomic transfer. See i2c_in_atomic_xfer_mode() for a
> +	 * starting point.
> +	 */
> +	if (system_state > SYSTEM_RUNNING && irqs_disabled())

Were does system_state come from?

> +		mutex_trylock(mutex);
> +	else
> +		mutex_lock(mutex);
> +}
> +
> +static void regmap_unlock_mutex(void *__mutex)
> +{
> +	struct mutex *mutex = __mutex;
> +
> +	mutex_unlock(mutex);
> +}
> +
> +static const struct regmap_config atc2603c_regmap_config = {
> +	.reg_bits = 8,
> +	.val_bits = 16,
> +	.max_register = ATC2603C_SADDR,
> +	.cache_type = REGCACHE_NONE,
> +};
> +
> +static const struct regmap_config atc2609a_regmap_config = {
> +	.reg_bits = 8,
> +	.val_bits = 16,
> +	.max_register = ATC2609A_SADDR,
> +	.cache_type = REGCACHE_NONE,
> +};
> +
> +static const struct regmap_irq atc2603c_regmap_irqs[] = {
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_AUDIO,	0, ATC2603C_INTS_MSK_AUDIO),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_OV,		0, ATC2603C_INTS_MSK_OV),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_OC,		0, ATC2603C_INTS_MSK_OC),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_OT,		0, ATC2603C_INTS_MSK_OT),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_UV,		0, ATC2603C_INTS_MSK_UV),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_ALARM,	0, ATC2603C_INTS_MSK_ALARM),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_ONOFF,	0, ATC2603C_INTS_MSK_ONOFF),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_SGPIO,	0, ATC2603C_INTS_MSK_SGPIO),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_IR,		0, ATC2603C_INTS_MSK_IR),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_REMCON,	0, ATC2603C_INTS_MSK_REMCON),
> +	REGMAP_IRQ_REG(ATC2603C_IRQ_POWER_IN,	0, ATC2603C_INTS_MSK_POWERIN),
> +};
> +
> +static const struct regmap_irq atc2609a_regmap_irqs[] = {
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_AUDIO,	0, ATC2609A_INTS_MSK_AUDIO),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_OV,		0, ATC2609A_INTS_MSK_OV),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_OC,		0, ATC2609A_INTS_MSK_OC),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_OT,		0, ATC2609A_INTS_MSK_OT),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_UV,		0, ATC2609A_INTS_MSK_UV),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_ALARM,	0, ATC2609A_INTS_MSK_ALARM),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_ONOFF,	0, ATC2609A_INTS_MSK_ONOFF),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_WKUP,	0, ATC2609A_INTS_MSK_WKUP),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_IR,		0, ATC2609A_INTS_MSK_IR),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_REMCON,	0, ATC2609A_INTS_MSK_REMCON),
> +	REGMAP_IRQ_REG(ATC2609A_IRQ_POWER_IN,	0, ATC2609A_INTS_MSK_POWERIN),
> +};
> +
> +static const struct regmap_irq_chip atc2603c_regmap_irq_chip = {
> +	.name = "atc2603c",
> +	.irqs = atc2603c_regmap_irqs,
> +	.num_irqs = ARRAY_SIZE(atc2603c_regmap_irqs),
> +	.num_regs = 1,
> +	.status_base = ATC2603C_INTS_PD,
> +	.mask_base = ATC2603C_INTS_MSK,
> +	.mask_invert = true,
> +};
> +
> +static const struct regmap_irq_chip atc2609a_regmap_irq_chip = {
> +	.name = "atc2609a",
> +	.irqs = atc2609a_regmap_irqs,
> +	.num_irqs = ARRAY_SIZE(atc2609a_regmap_irqs),
> +	.num_regs = 1,
> +	.status_base = ATC2609A_INTS_PD,
> +	.mask_base = ATC2609A_INTS_MSK,
> +	.mask_invert = true,
> +};
> +
> +static const struct resource atc2603c_onkey_resources[] = {
> +	DEFINE_RES_IRQ(ATC2603C_IRQ_ONOFF),
> +};
> +
> +static const struct resource atc2609a_onkey_resources[] = {
> +	DEFINE_RES_IRQ(ATC2609A_IRQ_ONOFF),
> +};
> +
> +static const struct mfd_cell atc2603c_mfd_cells[] = {
> +	{
> +		.name = "atc260x-regulator",
> +	}, {
> +		.name = "atc260x-pwrc",
> +	}, {

Please place single line entries on one line:

	{ .name = "atc260x-regulator" },
	{ .name = "atc260x-pwrc" },

> +	{
> +		.name = "atc260x-onkey",
> +		.num_resources = ARRAY_SIZE(atc2603c_onkey_resources),
> +		.resources = atc2603c_onkey_resources,
> +	},
> +};
> +
> +static const struct mfd_cell atc2609a_mfd_cells[] = {
> +	{
> +		.name = "atc260x-regulator",
> +	}, {
> +		.name = "atc260x-pwrc",

As above.

> +	}, {
> +		.name = "atc260x-onkey",
> +		.num_resources = ARRAY_SIZE(atc2609a_onkey_resources),
> +		.resources = atc2609a_onkey_resources,
> +	},
> +};
> +
> +static void atc260x_cmu_reset(struct atc260x *atc260x, u32 reg, u8 mask, u32 bit)
> +{
> +	/* Assert reset */
> +	regmap_update_bits(atc260x->regmap, reg, mask, ~bit);
> +
> +	/* De-assert reset */
> +	regmap_update_bits(atc260x->regmap, reg, mask, bit);
> +}
> +
> +static int atc2603c_dev_init(struct atc260x *atc260x)
> +{
> +	/* Initialize interrupt block */
> +	atc260x_cmu_reset(atc260x, ATC2603C_CMU_DEVRST,
> +			  ATC2603C_CMU_DEVRST_INTS, ATC2603C_CMU_DEVRST_INTS);
> +
> +	/* Disable all interrupt sources */
> +	regmap_write(atc260x->regmap, ATC2603C_INTS_MSK, 0);
> +
> +	/* Enable EXTIRQ pad */
> +	return regmap_update_bits(atc260x->regmap, ATC2603C_PAD_EN,
> +				  ATC2603C_PAD_EN_EXTIRQ, ATC2603C_PAD_EN_EXTIRQ);
> +}
> +
> +static int atc2609a_dev_init(struct atc260x *atc260x)
> +{
> +	/* Initialize interrupt block */
> +	atc260x_cmu_reset(atc260x, ATC2609A_CMU_DEVRST,
> +			  ATC2609A_CMU_DEVRST_INTS, ATC2609A_CMU_DEVRST_INTS);
> +
> +	/* Disable all interrupt sources */
> +	regmap_write(atc260x->regmap, ATC2609A_INTS_MSK, 0);
> +
> +	/* Enable EXTIRQ pad */
> +	return regmap_update_bits(atc260x->regmap, ATC2609A_PAD_EN,
> +				  ATC2609A_PAD_EN_EXTIRQ, ATC2609A_PAD_EN_EXTIRQ);
> +}
> +
> +int atc260x_match_device(struct atc260x *atc260x, struct regmap_config *regmap_cfg)
> +{
> +	struct device *dev = atc260x->dev;
> +	const void *of_data;
> +
> +	of_data = of_device_get_match_data(dev);
> +	if (!of_data)
> +		return -ENODEV;
> +
> +	atc260x->ic_type = (unsigned long)of_data;
> +
> +	switch (atc260x->ic_type) {
> +	case ATC2603C:
> +		*regmap_cfg = atc2603c_regmap_config;
> +		atc260x->regmap_irq_chip = &atc2603c_regmap_irq_chip;
> +		atc260x->cells = atc2603c_mfd_cells;
> +		atc260x->nr_cells = ARRAY_SIZE(atc2603c_mfd_cells);
> +		atc260x->type_name = "atc2603c";
> +		atc260x->rev_reg = ATC2603C_CHIP_VER;
> +		atc260x->dev_init = atc2603c_dev_init;
> +		break;
> +	case ATC2609A:
> +		*regmap_cfg = atc2609a_regmap_config;
> +		atc260x->regmap_irq_chip = &atc2609a_regmap_irq_chip;
> +		atc260x->cells = atc2609a_mfd_cells;
> +		atc260x->nr_cells = ARRAY_SIZE(atc2609a_mfd_cells);
> +		atc260x->type_name = "atc2609a";
> +		atc260x->rev_reg = ATC2609A_CHIP_VER;
> +		atc260x->dev_init = atc2609a_dev_init;
> +		break;
> +	default:
> +		dev_err(dev, "Unsupported ATC260x device type: %u\n",
> +			atc260x->ic_type);
> +		return -EINVAL;
> +	}
> +
> +	atc260x->regmap_mutex = devm_kzalloc(dev, sizeof(*atc260x->regmap_mutex),
> +					     GFP_KERNEL);
> +	if (!atc260x->regmap_mutex)
> +		return -ENOMEM;
> +
> +	mutex_init(atc260x->regmap_mutex);
> +
> +	regmap_cfg->lock = regmap_lock_mutex,
> +	regmap_cfg->unlock = regmap_unlock_mutex,
> +	regmap_cfg->lock_arg = atc260x->regmap_mutex;
> +
> +	return 0;
> +}
> +EXPORT_SYMBOL_GPL(atc260x_match_device);
> +
> +int atc260x_device_probe(struct atc260x *atc260x)
> +{
> +	struct device *dev = atc260x->dev;
> +	unsigned int chip_rev;
> +	int ret;
> +
> +	if (!atc260x->irq) {
> +		dev_err(dev, "No interrupt support\n");
> +		return -EINVAL;
> +	}
> +
> +	/* Initialize the hardware */
> +	if (atc260x->dev_init)
> +		atc260x->dev_init(atc260x);

Will this ever not be required?

If it will always be required, you can drop the if().

> +	ret = regmap_read(atc260x->regmap, atc260x->rev_reg, &chip_rev);
> +	if (ret) {
> +		dev_err(dev, "Failed to get chip revision\n");
> +		return ret;
> +	}
> +
> +	if (chip_rev < 0 || chip_rev > 31) {
> +		dev_err(dev, "Unknown chip revision: %d\n", ret);
> +		return -EINVAL;
> +	}

This still seems limiting.

> +	atc260x->ic_ver = __ffs(chip_rev + 1U);

This is still inefficient.

> +	dev_info(dev, "Detected chip type %s rev.%c\n",
> +		 atc260x->type_name, 'A' + atc260x->ic_ver);
> +
> +	ret = regmap_add_irq_chip(atc260x->regmap, atc260x->irq, IRQF_ONESHOT, -1,
> +				  atc260x->regmap_irq_chip, &atc260x->irq_data);

Why not use devm_*?

> +	if (ret) {
> +		dev_err(dev, "Failed to add IRQ chip: %d\n", ret);
> +		return ret;
> +	}
> +
> +	ret = devm_mfd_add_devices(dev, PLATFORM_DEVID_NONE,
> +				   atc260x->cells, atc260x->nr_cells, NULL, 0,
> +				   regmap_irq_get_domain(atc260x->irq_data));
> +	if (ret) {
> +		dev_err(dev, "Failed to add child devices: %d\n", ret);
> +		regmap_del_irq_chip(atc260x->irq, atc260x->irq_data);
> +		return ret;

Drop this return and always return ret at the end.

> +	}
> +
> +	return 0;
> +}
> +EXPORT_SYMBOL_GPL(atc260x_device_probe);
> +
> +int atc260x_device_remove(struct atc260x *atc260x)
> +{
> +	mfd_remove_devices(atc260x->dev);

No need to do this, since you used devm_*.

> +	regmap_del_irq_chip(atc260x->irq, atc260x->irq_data);

If you use devm_* you can omit this too.

> +	return 0;
> +}
> +EXPORT_SYMBOL_GPL(atc260x_device_remove);
> +
> +MODULE_DESCRIPTION("ATC260x PMICs Core MFD support");

Drop "MFD" please.

> +MODULE_AUTHOR("Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>");
> +MODULE_AUTHOR("Cristian Ciocaltea <cristian.ciocaltea@gmail.com>");
> +MODULE_LICENSE("GPL");
> diff --git a/drivers/mfd/atc260x-i2c.c b/drivers/mfd/atc260x-i2c.c
> new file mode 100644
> index 000000000000..40136a47feda
> --- /dev/null
> +++ b/drivers/mfd/atc260x-i2c.c
> @@ -0,0 +1,73 @@
> +// SPDX-License-Identifier: GPL-2.0+
> +/*
> + * I2C bus interface for ATC260x PMICs
> + *
> + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> + */
> +
> +#include <linux/i2c.h>
> +#include <linux/mfd/atc260x/core.h>
> +#include <linux/module.h>
> +#include <linux/of.h>
> +#include <linux/regmap.h>
> +
> +static int atc260x_i2c_probe(struct i2c_client *client,
> +			     const struct i2c_device_id *id)
> +{
> +	struct atc260x *atc260x;
> +	struct regmap_config regmap_cfg;
> +	int ret;
> +
> +	atc260x = devm_kzalloc(&client->dev, sizeof(*atc260x), GFP_KERNEL);
> +	if (!atc260x)
> +		return -ENOMEM;
> +
> +	atc260x->dev = &client->dev;
> +	atc260x->irq = client->irq;
> +
> +	ret = atc260x_match_device(atc260x, &regmap_cfg);
> +	if (ret)
> +		return ret;
> +
> +	i2c_set_clientdata(client, atc260x);
> +
> +	atc260x->regmap = devm_regmap_init_i2c(client, &regmap_cfg);
> +	if (IS_ERR(atc260x->regmap)) {
> +		ret = PTR_ERR(atc260x->regmap);
> +		dev_err(&client->dev, "failed to init regmap: %d\n", ret);
> +		return ret;
> +	}
> +
> +	return atc260x_device_probe(atc260x);
> +}
> +
> +static int atc260x_i2c_remove(struct i2c_client *client)
> +{
> +	struct atc260x *atc260x = i2c_get_clientdata(client)
> +
> +	return atc260x_device_remove(atc260x);
> +}
> +
> +const struct of_device_id atc260x_i2c_of_match[] = {
> +	{ .compatible = "actions,atc2603c", .data = (void *)ATC2603C },
> +	{ .compatible = "actions,atc2609a", .data = (void *)ATC2609A },
> +	{ /* sentinel */ }

I think you can drop the (void *) casts.

Please remove the /* sentinel */ comment, we know what NULL
terminators do.

> +};
> +MODULE_DEVICE_TABLE(of, atc260x_i2c_of_match);
> +
> +static struct i2c_driver atc260x_i2c_driver = {
> +	.driver = {
> +		.name	= "atc260x",
> +		.of_match_table	= of_match_ptr(atc260x_i2c_of_match),
> +	},
> +	.probe		= atc260x_i2c_probe,
> +	.remove		= atc260x_i2c_remove,
> +};
> +

Nit: Remove this line.

> +module_i2c_driver(atc260x_i2c_driver);
> +
> +MODULE_DESCRIPTION("ATC260x PMICs I2C bus interface");
> +MODULE_AUTHOR("Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>");
> +MODULE_AUTHOR("Cristian Ciocaltea <cristian.ciocaltea@gmail.com>");
> +MODULE_LICENSE("GPL");
> diff --git a/include/linux/mfd/atc260x/atc2603c.h b/include/linux/mfd/atc260x/atc2603c.h
> new file mode 100644
> index 000000000000..07ac640ef3e1
> --- /dev/null
> +++ b/include/linux/mfd/atc260x/atc2603c.h
> @@ -0,0 +1,281 @@
> +/* SPDX-License-Identifier: GPL-2.0+ */
> +/*
> + * ATC2603C PMIC register definitions
> + *
> + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> + */
> +
> +#ifndef __LINUX_MFD_ATC260X_ATC2603C_H
> +#define __LINUX_MFD_ATC260X_ATC2603C_H
> +
> +enum atc2603c_irq_def {
> +	ATC2603C_IRQ_AUDIO = 0,
> +	ATC2603C_IRQ_OV,
> +	ATC2603C_IRQ_OC,
> +	ATC2603C_IRQ_OT,
> +	ATC2603C_IRQ_UV,
> +	ATC2603C_IRQ_ALARM,
> +	ATC2603C_IRQ_ONOFF,
> +	ATC2603C_IRQ_SGPIO,
> +	ATC2603C_IRQ_IR,
> +	ATC2603C_IRQ_REMCON,
> +	ATC2603C_IRQ_POWER_IN,
> +};
> +
> +/* PMU Registers */
> +#define ATC2603C_PMU_SYS_CTL0			0x00
> +#define ATC2603C_PMU_SYS_CTL1			0x01
> +#define ATC2603C_PMU_SYS_CTL2			0x02
> +#define ATC2603C_PMU_SYS_CTL3			0x03
> +#define ATC2603C_PMU_SYS_CTL4			0x04
> +#define ATC2603C_PMU_SYS_CTL5			0x05
> +#define ATC2603C_PMU_SYS_CTL6			0x06
> +#define ATC2603C_PMU_SYS_CTL7			0x07
> +#define ATC2603C_PMU_SYS_CTL8			0x08
> +#define ATC2603C_PMU_SYS_CTL9			0x09
> +#define ATC2603C_PMU_BAT_CTL0			0x0A
> +#define ATC2603C_PMU_BAT_CTL1			0x0B
> +#define ATC2603C_PMU_VBUS_CTL0			0x0C
> +#define ATC2603C_PMU_VBUS_CTL1			0x0D
> +#define ATC2603C_PMU_WALL_CTL0			0x0E
> +#define ATC2603C_PMU_WALL_CTL1			0x0F
> +#define ATC2603C_PMU_SYS_PENDING		0x10
> +#define ATC2603C_PMU_DC1_CTL0			0x11
> +#define ATC2603C_PMU_DC1_CTL1			0x12 // Undocumented
> +#define ATC2603C_PMU_DC1_CTL2			0x13 // Undocumented
> +#define ATC2603C_PMU_DC2_CTL0			0x14
> +#define ATC2603C_PMU_DC2_CTL1			0x15 // Undocumented
> +#define ATC2603C_PMU_DC2_CTL2			0x16 // Undocumented
> +#define ATC2603C_PMU_DC3_CTL0			0x17
> +#define ATC2603C_PMU_DC3_CTL1			0x18 // Undocumented
> +#define ATC2603C_PMU_DC3_CTL2			0x19 // Undocumented
> +#define ATC2603C_PMU_DC4_CTL0			0x1A // Undocumented
> +#define ATC2603C_PMU_DC4_CTL1			0x1B // Undocumented
> +#define ATC2603C_PMU_DC5_CTL0			0x1C // Undocumented
> +#define ATC2603C_PMU_DC5_CTL1			0x1D // Undocumented
> +#define ATC2603C_PMU_LDO1_CTL			0x1E
> +#define ATC2603C_PMU_LDO2_CTL			0x1F
> +#define ATC2603C_PMU_LDO3_CTL			0x20
> +#define ATC2603C_PMU_LDO4_CTL			0x21 // Undocumented
> +#define ATC2603C_PMU_LDO5_CTL			0x22
> +#define ATC2603C_PMU_LDO6_CTL			0x23
> +#define ATC2603C_PMU_LDO7_CTL			0x24
> +#define ATC2603C_PMU_LDO8_CTL			0x25 // Undocumented
> +#define ATC2603C_PMU_LDO9_CTL			0x26 // Undocumented
> +#define ATC2603C_PMU_LDO10_CTL			0x27 // Undocumented
> +#define ATC2603C_PMU_LDO11_CTL			0x28
> +#define ATC2603C_PMU_SWITCH_CTL			0x29
> +#define ATC2603C_PMU_OV_CTL0			0x2A
> +#define ATC2603C_PMU_OV_CTL1			0x2B
> +#define ATC2603C_PMU_OV_STATUS			0x2C
> +#define ATC2603C_PMU_OV_EN			0x2D
> +#define ATC2603C_PMU_OV_INT_EN			0x2E
> +#define ATC2603C_PMU_OC_CTL			0x2F
> +#define ATC2603C_PMU_OC_STATUS			0x30
> +#define ATC2603C_PMU_OC_EN			0x31
> +#define ATC2603C_PMU_OC_INT_EN			0x32
> +#define ATC2603C_PMU_UV_CTL0			0x33
> +#define ATC2603C_PMU_UV_CTL1			0x34
> +#define ATC2603C_PMU_UV_STATUS			0x35
> +#define ATC2603C_PMU_UV_EN			0x36
> +#define ATC2603C_PMU_UV_INT_EN			0x37
> +#define ATC2603C_PMU_OT_CTL			0x38
> +#define ATC2603C_PMU_CHARGER_CTL0		0x39
> +#define ATC2603C_PMU_CHARGER_CTL1		0x3A
> +#define ATC2603C_PMU_CHARGER_CTL2		0x3B
> +#define ATC2603C_PMU_BAKCHARGER_CTL		0x3C // Undocumented
> +#define ATC2603C_PMU_APDS_CTL			0x3D
> +#define ATC2603C_PMU_AUXADC_CTL0		0x3E
> +#define ATC2603C_PMU_AUXADC_CTL1		0x3F
> +#define ATC2603C_PMU_BATVADC			0x40
> +#define ATC2603C_PMU_BATIADC			0x41
> +#define ATC2603C_PMU_WALLVADC			0x42
> +#define ATC2603C_PMU_WALLIADC			0x43
> +#define ATC2603C_PMU_VBUSVADC			0x44
> +#define ATC2603C_PMU_VBUSIADC			0x45
> +#define ATC2603C_PMU_SYSPWRADC			0x46
> +#define ATC2603C_PMU_REMCONADC			0x47
> +#define ATC2603C_PMU_SVCCADC			0x48
> +#define ATC2603C_PMU_CHGIADC			0x49
> +#define ATC2603C_PMU_IREFADC			0x4A
> +#define ATC2603C_PMU_BAKBATADC			0x4B
> +#define ATC2603C_PMU_ICTEMPADC			0x4C
> +#define ATC2603C_PMU_AUXADC0			0x4D
> +#define ATC2603C_PMU_AUXADC1			0x4E
> +#define ATC2603C_PMU_AUXADC2			0x4F
> +#define	ATC2603C_PMU_ICMADC			0x50
> +#define ATC2603C_PMU_BDG_CTL			0x51 // Undocumented
> +#define ATC2603C_RTC_CTL			0x52
> +#define ATC2603C_RTC_MSALM			0x53
> +#define ATC2603C_RTC_HALM			0x54
> +#define ATC2603C_RTC_YMDALM			0x55
> +#define ATC2603C_RTC_MS				0x56
> +#define ATC2603C_RTC_H				0x57
> +#define ATC2603C_RTC_DC				0x58
> +#define ATC2603C_RTC_YMD			0x59
> +#define ATC2603C_EFUSE_DAT			0x5A // Undocumented
> +#define ATC2603C_EFUSECRTL1			0x5B // Undocumented
> +#define ATC2603C_EFUSECRTL2			0x5C // Undocumented
> +#define ATC2603C_PMU_FW_USE0			0x5D // Undocumented
> +#define ATC2603C_PMU_FW_USE1			0x5E // Undocumented
> +#define ATC2603C_PMU_FW_USE2			0x5F // Undocumented
> +#define ATC2603C_PMU_FW_USE3			0x60 // Undocumented
> +#define ATC2603C_PMU_FW_USE4			0x61 // Undocumented
> +#define ATC2603C_PMU_ABNORMAL_STATUS		0x62
> +#define ATC2603C_PMU_WALL_APDS_CTL		0x63
> +#define ATC2603C_PMU_REMCON_CTL0		0x64
> +#define ATC2603C_PMU_REMCON_CTL1		0x65
> +#define ATC2603C_PMU_MUX_CTL0			0x66
> +#define ATC2603C_PMU_SGPIO_CTL0			0x67
> +#define ATC2603C_PMU_SGPIO_CTL1			0x68
> +#define ATC2603C_PMU_SGPIO_CTL2			0x69
> +#define ATC2603C_PMU_SGPIO_CTL3			0x6A
> +#define ATC2603C_PMU_SGPIO_CTL4			0x6B
> +#define ATC2603C_PWMCLK_CTL			0x6C
> +#define ATC2603C_PWM0_CTL			0x6D
> +#define ATC2603C_PWM1_CTL			0x6E
> +#define ATC2603C_PMU_ADC_DBG0			0x70
> +#define ATC2603C_PMU_ADC_DBG1			0x71
> +#define ATC2603C_PMU_ADC_DBG2			0x72
> +#define ATC2603C_PMU_ADC_DBG3			0x73
> +#define ATC2603C_PMU_ADC_DBG4			0x74
> +#define ATC2603C_IRC_CTL			0x80
> +#define ATC2603C_IRC_STAT			0x81
> +#define ATC2603C_IRC_CC				0x82
> +#define ATC2603C_IRC_KDC			0x83
> +#define ATC2603C_IRC_WK				0x84
> +#define ATC2603C_IRC_RCC			0x85
> +#define ATC2603C_IRC_FILTER			0x86
> +
> +/* AUDIO_OUT Registers */
> +#define ATC2603C_AUDIOINOUT_CTL			0xA0
> +#define ATC2603C_AUDIO_DEBUGOUTCTL		0xA1
> +#define ATC2603C_DAC_DIGITALCTL			0xA2
> +#define ATC2603C_DAC_VOLUMECTL0			0xA3
> +#define ATC2603C_DAC_ANALOG0			0xA4
> +#define ATC2603C_DAC_ANALOG1			0xA5
> +#define ATC2603C_DAC_ANALOG2			0xA6
> +#define ATC2603C_DAC_ANALOG3			0xA7
> +
> +/* AUDIO_IN Registers */
> +#define ATC2603C_ADC_DIGITALCTL			0xA8
> +#define ATC2603C_ADC_HPFCTL			0xA9
> +#define ATC2603C_ADC_CTL			0xAA
> +#define ATC2603C_AGC_CTL0			0xAB
> +#define ATC2603C_AGC_CTL1			0xAC // Undocumented
> +#define ATC2603C_AGC_CTL2			0xAD
> +#define ATC2603C_ADC_ANALOG0			0xAE
> +#define ATC2603C_ADC_ANALOG1			0xAF
> +
> +/* PCM_IF Registers */
> +#define ATC2603C_PCM0_CTL			0xB0 // Undocumented
> +#define ATC2603C_PCM1_CTL			0xB1 // Undocumented
> +#define ATC2603C_PCM2_CTL			0xB2 // Undocumented
> +#define ATC2603C_PCMIF_CTL			0xB3 // Undocumented
> +
> +/* CMU_CONTROL Registers */
> +#define ATC2603C_CMU_DEVRST			0xC1 // Undocumented
> +
> +/* INTS Registers */
> +#define ATC2603C_INTS_PD			0xC8
> +#define ATC2603C_INTS_MSK			0xC9
> +
> +/* MFP Registers */
> +#define ATC2603C_MFP_CTL			0xD0
> +#define ATC2603C_PAD_VSEL			0xD1 // Undocumented
> +#define ATC2603C_GPIO_OUTEN			0xD2
> +#define ATC2603C_GPIO_INEN			0xD3
> +#define ATC2603C_GPIO_DAT			0xD4
> +#define ATC2603C_PAD_DRV			0xD5
> +#define ATC2603C_PAD_EN				0xD6
> +#define ATC2603C_DEBUG_SEL			0xD7 // Undocumented
> +#define ATC2603C_DEBUG_IE			0xD8 // Undocumented
> +#define ATC2603C_DEBUG_OE			0xD9 // Undocumented
> +#define ATC2603C_BIST_START			0x0A // Undocumented
> +#define ATC2603C_BIST_RESULT			0x0B // Undocumented
> +#define ATC2603C_CHIP_VER			0xDC
> +
> +/* TWSI Registers */
> +#define ATC2603C_SADDR				0xFF
> +
> +/* PMU_SYS_CTL0 Register Mask Bits */
> +#define ATC2603C_PMU_SYS_CTL0_IR_WK_EN			BIT(5)
> +#define ATC2603C_PMU_SYS_CTL0_RESET_WK_EN		BIT(6)
> +#define ATC2603C_PMU_SYS_CTL0_HDSW_WK_EN		BIT(7)
> +#define ATC2603C_PMU_SYS_CTL0_ALARM_WK_EN		BIT(8)
> +#define ATC2603C_PMU_SYS_CTL0_REM_CON_WK_EN		BIT(9)
> +#define ATC2603C_PMU_SYS_CTL0_RESTART_EN		BIT(10)
> +#define ATC2603C_PMU_SYS_CTL0_SGPIOIRQ_WK_EN		BIT(11)
> +#define ATC2603C_PMU_SYS_CTL0_ONOFF_SHORT_WK_EN		BIT(12)
> +#define ATC2603C_PMU_SYS_CTL0_ONOFF_LONG_WK_EN		BIT(13)
> +#define ATC2603C_PMU_SYS_CTL0_WALL_WK_EN		BIT(14)
> +#define ATC2603C_PMU_SYS_CTL0_USB_WK_EN			BIT(15)
> +#define ATC2603C_PMU_SYS_CTL0_WK_ALL			(GENMASK(15, 5) & (~BIT(10)))
> +
> +/* PMU_SYS_CTL1 Register Mask Bits */
> +#define ATC2603C_PMU_SYS_CTL1_EN_S1			BIT(0)
> +#define ATC2603C_PMU_SYS_CTL1_LB_S4_EN			BIT(2)
> +#define ATC2603C_PMU_SYS_CTL1_LB_S4			GENMASK(4, 3)
> +#define ATC2603C_PMU_SYS_CTL1_LB_S4_3_1V		BIT(4)
> +#define ATC2603C_PMU_SYS_CTL1_IR_WK_FLAG		BIT(5)
> +#define ATC2603C_PMU_SYS_CTL1_RESET_WK_FLAG		BIT(6)
> +#define ATC2603C_PMU_SYS_CTL1_HDSW_WK_FLAG		BIT(7)
> +#define ATC2603C_PMU_SYS_CTL1_ALARM_WK_FLAG		BIT(8)
> +#define ATC2603C_PMU_SYS_CTL1_REM_CON_WK_FLAG		BIT(9)
> +#define ATC2603C_PMU_SYS_CTL1_ONOFF_PRESS_RESET_IRQ_PD	BIT(10)
> +#define ATC2603C_PMU_SYS_CTL1_SGPIOIRQ_WK_FLAG		BIT(11)
> +#define ATC2603C_PMU_SYS_CTL1_ONOFF_SHORT_WK_FLAG	BIT(12)
> +#define ATC2603C_PMU_SYS_CTL1_ONOFF_LONG_WK_FLAG	BIT(13)
> +#define ATC2603C_PMU_SYS_CTL1_WALL_WK_FLAG		BIT(14)
> +#define ATC2603C_PMU_SYS_CTL1_USB_WK_FLAG		BIT(15)
> +
> +/* PMU_SYS_CTL2 Register Mask Bits */
> +#define ATC2603C_PMU_SYS_CTL2_PMU_A_EN			BIT(0)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_INT_EN	BIT(1)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_PD		BIT(2)
> +#define ATC2603C_PMU_SYS_CTL2_S2TIMER			GENMASK(5, 3)
> +#define ATC2603C_PMU_SYS_CTL2_S2_TIMER_EN		BIT(6)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_RESET_TIME_SEL	GENMASK(8, 7)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_RESET_EN	BIT(9)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_TIME		GENMASK(11, 10)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_INT_EN		BIT(12)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_LONG_PRESS		BIT(13)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_SHORT_PRESS		BIT(14)
> +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS		BIT(15)
> +
> +/* PMU_SYS_CTL3 Register Mask Bits */
> +#define ATC2603C_PMU_SYS_CTL3_S2S3TOS1_TIMER		GENMASK(8, 7)
> +#define ATC2603C_PMU_SYS_CTL3_S2S3TOS1_TIMER_EN		BIT(9)
> +#define ATC2603C_PMU_SYS_CTL3_S3_TIMER			GENMASK(12, 10)
> +#define ATC2603C_PMU_SYS_CTL3_S3_TIMER_EN		BIT(13)
> +#define ATC2603C_PMU_SYS_CTL3_EN_S3			BIT(14)
> +#define ATC2603C_PMU_SYS_CTL3_EN_S2			BIT(15)
> +
> +/* PMU_SYS_CTL5 Register Mask Bits */
> +#define ATC2603C_PMU_SYS_CTL5_WALLWKDTEN		BIT(7)
> +#define ATC2603C_PMU_SYS_CTL5_VBUSWKDTEN		BIT(8)
> +#define ATC2603C_PMU_SYS_CTL5_REMCON_DECT_EN		BIT(9)
> +#define ATC2603C_PMU_SYS_CTL5_ONOFF_8S_SEL		BIT(10)
> +
> +/* INTS_MSK Register Mask Bits */
> +#define ATC2603C_INTS_MSK_AUDIO				BIT(0)
> +#define ATC2603C_INTS_MSK_OV				BIT(1)
> +#define ATC2603C_INTS_MSK_OC				BIT(2)
> +#define ATC2603C_INTS_MSK_OT				BIT(3)
> +#define ATC2603C_INTS_MSK_UV				BIT(4)
> +#define ATC2603C_INTS_MSK_ALARM				BIT(5)
> +#define ATC2603C_INTS_MSK_ONOFF				BIT(6)
> +#define ATC2603C_INTS_MSK_SGPIO				BIT(7)
> +#define ATC2603C_INTS_MSK_IR				BIT(8)
> +#define ATC2603C_INTS_MSK_REMCON			BIT(9)
> +#define ATC2603C_INTS_MSK_POWERIN			BIT(10)
> +
> +/* CMU_DEVRST Register Mask Bits */
> +#define ATC2603C_CMU_DEVRST_MFP				BIT(1)
> +#define ATC2603C_CMU_DEVRST_INTS			BIT(2)
> +#define ATC2603C_CMU_DEVRST_AUDIO			BIT(4)
> +
> +/* PAD_EN Register Mask Bits */
> +#define ATC2603C_PAD_EN_EXTIRQ				BIT(0)
> +
> +#endif /* __LINUX_MFD_ATC260X_ATC2603C_H */
> diff --git a/include/linux/mfd/atc260x/atc2609a.h b/include/linux/mfd/atc260x/atc2609a.h
> new file mode 100644
> index 000000000000..b957d7bd73e9
> --- /dev/null
> +++ b/include/linux/mfd/atc260x/atc2609a.h
> @@ -0,0 +1,308 @@
> +/* SPDX-License-Identifier: GPL-2.0+ */
> +/*
> + * ATC2609A PMIC register definitions
> + *
> + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> + */
> +
> +#ifndef __LINUX_MFD_ATC260X_ATC2609A_H
> +#define __LINUX_MFD_ATC260X_ATC2609A_H
> +
> +enum atc2609a_irq_def {
> +	ATC2609A_IRQ_AUDIO = 0,
> +	ATC2609A_IRQ_OV,
> +	ATC2609A_IRQ_OC,
> +	ATC2609A_IRQ_OT,
> +	ATC2609A_IRQ_UV,
> +	ATC2609A_IRQ_ALARM,
> +	ATC2609A_IRQ_ONOFF,
> +	ATC2609A_IRQ_WKUP,
> +	ATC2609A_IRQ_IR,
> +	ATC2609A_IRQ_REMCON,
> +	ATC2609A_IRQ_POWER_IN,
> +};
> +
> +/* PMU Registers */
> +#define ATC2609A_PMU_SYS_CTL0			0x00
> +#define ATC2609A_PMU_SYS_CTL1			0x01
> +#define ATC2609A_PMU_SYS_CTL2			0x02
> +#define ATC2609A_PMU_SYS_CTL3			0x03
> +#define ATC2609A_PMU_SYS_CTL4			0x04
> +#define ATC2609A_PMU_SYS_CTL5			0x05
> +#define ATC2609A_PMU_SYS_CTL6			0x06
> +#define ATC2609A_PMU_SYS_CTL7			0x07
> +#define ATC2609A_PMU_SYS_CTL8			0x08
> +#define ATC2609A_PMU_SYS_CTL9			0x09
> +#define ATC2609A_PMU_BAT_CTL0			0x0A
> +#define ATC2609A_PMU_BAT_CTL1			0x0B
> +#define ATC2609A_PMU_VBUS_CTL0			0x0C
> +#define ATC2609A_PMU_VBUS_CTL1			0x0D
> +#define ATC2609A_PMU_WALL_CTL0			0x0E
> +#define ATC2609A_PMU_WALL_CTL1			0x0F
> +#define ATC2609A_PMU_SYS_PENDING		0x10
> +#define ATC2609A_PMU_APDS_CTL0			0x11
> +#define ATC2609A_PMU_APDS_CTL1			0x12
> +#define ATC2609A_PMU_APDS_CTL2			0x13
> +#define ATC2609A_PMU_CHARGER_CTL		0x14
> +#define ATC2609A_PMU_BAKCHARGER_CTL		0x15
> +#define ATC2609A_PMU_SWCHG_CTL0			0x16
> +#define ATC2609A_PMU_SWCHG_CTL1			0x17
> +#define ATC2609A_PMU_SWCHG_CTL2			0x18
> +#define ATC2609A_PMU_SWCHG_CTL3			0x19
> +#define ATC2609A_PMU_SWCHG_CTL4			0x1A
> +#define ATC2609A_PMU_DC_OSC			0x1B
> +#define ATC2609A_PMU_DC0_CTL0			0x1C
> +#define ATC2609A_PMU_DC0_CTL1			0x1D
> +#define ATC2609A_PMU_DC0_CTL2			0x1E
> +#define ATC2609A_PMU_DC0_CTL3			0x1F
> +#define ATC2609A_PMU_DC0_CTL4			0x20
> +#define ATC2609A_PMU_DC0_CTL5			0x21
> +#define ATC2609A_PMU_DC0_CTL6			0x22
> +#define ATC2609A_PMU_DC1_CTL0			0x23
> +#define ATC2609A_PMU_DC1_CTL1			0x24
> +#define ATC2609A_PMU_DC1_CTL2			0x25
> +#define ATC2609A_PMU_DC1_CTL3			0x26
> +#define ATC2609A_PMU_DC1_CTL4			0x27
> +#define ATC2609A_PMU_DC1_CTL5			0x28
> +#define ATC2609A_PMU_DC1_CTL6			0x29
> +#define ATC2609A_PMU_DC2_CTL0			0x2A
> +#define ATC2609A_PMU_DC2_CTL1			0x2B
> +#define ATC2609A_PMU_DC2_CTL2			0x2C
> +#define ATC2609A_PMU_DC2_CTL3			0x2D
> +#define ATC2609A_PMU_DC2_CTL4			0x2E
> +#define ATC2609A_PMU_DC2_CTL5			0x2F
> +#define ATC2609A_PMU_DC2_CTL6			0x30
> +#define ATC2609A_PMU_DC3_CTL0			0x31
> +#define ATC2609A_PMU_DC3_CTL1			0x32
> +#define ATC2609A_PMU_DC3_CTL2			0x33
> +#define ATC2609A_PMU_DC3_CTL3			0x34
> +#define ATC2609A_PMU_DC3_CTL4			0x35
> +#define ATC2609A_PMU_DC3_CTL5			0x36
> +#define ATC2609A_PMU_DC3_CTL6			0x37
> +#define ATC2609A_PMU_DC_ZR			0x38
> +#define ATC2609A_PMU_LDO0_CTL0			0x39
> +#define ATC2609A_PMU_LDO0_CTL1			0x3A
> +#define ATC2609A_PMU_LDO1_CTL0			0x3B
> +#define ATC2609A_PMU_LDO1_CTL1			0x3C
> +#define ATC2609A_PMU_LDO2_CTL0			0x3D
> +#define ATC2609A_PMU_LDO2_CTL1			0x3E
> +#define ATC2609A_PMU_LDO3_CTL0			0x3F
> +#define ATC2609A_PMU_LDO3_CTL1			0x40
> +#define ATC2609A_PMU_LDO4_CTL0			0x41
> +#define ATC2609A_PMU_LDO4_CTL1			0x42
> +#define ATC2609A_PMU_LDO5_CTL0			0x43
> +#define ATC2609A_PMU_LDO5_CTL1			0x44
> +#define ATC2609A_PMU_LDO6_CTL0			0x45
> +#define ATC2609A_PMU_LDO6_CTL1			0x46
> +#define ATC2609A_PMU_LDO7_CTL0			0x47
> +#define ATC2609A_PMU_LDO7_CTL1			0x48
> +#define ATC2609A_PMU_LDO8_CTL0			0x49
> +#define ATC2609A_PMU_LDO8_CTL1			0x4A
> +#define ATC2609A_PMU_LDO9_CTL			0x4B
> +#define ATC2609A_PMU_OV_INT_EN			0x4C
> +#define ATC2609A_PMU_OV_STATUS			0x4D
> +#define ATC2609A_PMU_UV_INT_EN			0x4E
> +#define ATC2609A_PMU_UV_STATUS			0x4F
> +#define ATC2609A_PMU_OC_INT_EN			0x50
> +#define ATC2609A_PMU_OC_STATUS			0x51
> +#define ATC2609A_PMU_OT_CTL			0x52
> +#define ATC2609A_PMU_CM_CTL0			0x53
> +#define ATC2609A_PMU_FW_USE0			0x54
> +#define ATC2609A_PMU_FW_USE1			0x55
> +#define ATC2609A_PMU_ADC12B_I			0x56
> +#define ATC2609A_PMU_ADC12B_V			0x57
> +#define ATC2609A_PMU_ADC12B_DUMMY		0x58
> +#define ATC2609A_PMU_AUXADC_CTL0		0x59
> +#define ATC2609A_PMU_AUXADC_CTL1		0x5A
> +#define ATC2609A_PMU_BATVADC			0x5B
> +#define ATC2609A_PMU_BATIADC			0x5C
> +#define ATC2609A_PMU_WALLVADC			0x5D
> +#define ATC2609A_PMU_WALLIADC			0x5E
> +#define ATC2609A_PMU_VBUSVADC			0x5F
> +#define ATC2609A_PMU_VBUSIADC			0x60
> +#define ATC2609A_PMU_SYSPWRADC			0x61
> +#define ATC2609A_PMU_REMCONADC			0x62
> +#define ATC2609A_PMU_SVCCADC			0x63
> +#define ATC2609A_PMU_CHGIADC			0x64
> +#define ATC2609A_PMU_IREFADC			0x65
> +#define ATC2609A_PMU_BAKBATADC			0x66
> +#define ATC2609A_PMU_ICTEMPADC			0x67
> +#define ATC2609A_PMU_AUXADC0			0x68
> +#define ATC2609A_PMU_AUXADC1			0x69
> +#define ATC2609A_PMU_AUXADC2			0x6A
> +#define ATC2609A_PMU_AUXADC3			0x6B
> +#define ATC2609A_PMU_ICTEMPADC_ADJ		0x6C
> +#define ATC2609A_PMU_BDG_CTL			0x6D
> +#define ATC2609A_RTC_CTL			0x6E
> +#define ATC2609A_RTC_MSALM			0x6F
> +#define ATC2609A_RTC_HALM			0x70
> +#define ATC2609A_RTC_YMDALM			0x71
> +#define ATC2609A_RTC_MS				0x72
> +#define ATC2609A_RTC_H				0x73
> +#define ATC2609A_RTC_DC				0x74
> +#define ATC2609A_RTC_YMD			0x75
> +#define ATC2609A_EFUSE_DAT			0x76
> +#define ATC2609A_EFUSECRTL1			0x77
> +#define ATC2609A_EFUSECRTL2			0x78
> +#define ATC2609A_PMU_DC4_CTL0			0x79
> +#define ATC2609A_PMU_DC4_CTL1			0x7A
> +#define ATC2609A_PMU_DC4_CTL2			0x7B
> +#define ATC2609A_PMU_DC4_CTL3			0x7C
> +#define ATC2609A_PMU_DC4_CTL4			0x7D
> +#define ATC2609A_PMU_DC4_CTL5			0x7E
> +#define ATC2609A_PMU_DC4_CTL6			0x7F
> +#define ATC2609A_PMU_PWR_STATUS			0x80
> +#define ATC2609A_PMU_S2_PWR			0x81
> +#define ATC2609A_CLMT_CTL0			0x82
> +#define ATC2609A_CLMT_DATA0			0x83
> +#define ATC2609A_CLMT_DATA1			0x84
> +#define ATC2609A_CLMT_DATA2			0x85
> +#define ATC2609A_CLMT_DATA3			0x86
> +#define ATC2609A_CLMT_ADD0			0x87
> +#define ATC2609A_CLMT_ADD1			0x88
> +#define ATC2609A_CLMT_OCV_TABLE			0x89
> +#define ATC2609A_CLMT_R_TABLE			0x8A
> +#define ATC2609A_PMU_PWRON_CTL0			0x8D
> +#define ATC2609A_PMU_PWRON_CTL1			0x8E
> +#define ATC2609A_PMU_PWRON_CTL2			0x8F
> +#define ATC2609A_IRC_CTL			0x90
> +#define ATC2609A_IRC_STAT			0x91
> +#define ATC2609A_IRC_CC				0x92
> +#define ATC2609A_IRC_KDC			0x93
> +#define ATC2609A_IRC_WK				0x94
> +#define ATC2609A_IRC_RCC			0x95
> +
> +/* AUDIO_OUT Registers */
> +#define ATC2609A_AUDIOINOUT_CTL			0xA0
> +#define ATC2609A_AUDIO_DEBUGOUTCTL		0xA1
> +#define ATC2609A_DAC_DIGITALCTL			0xA2
> +#define ATC2609A_DAC_VOLUMECTL0			0xA3
> +#define ATC2609A_DAC_ANALOG0			0xA4
> +#define ATC2609A_DAC_ANALOG1			0xA5
> +#define ATC2609A_DAC_ANALOG2			0xA6
> +#define ATC2609A_DAC_ANALOG3			0xA7
> +
> +/* AUDIO_IN Registers */
> +#define ATC2609A_ADC_DIGITALCTL			0xA8
> +#define ATC2609A_ADC_HPFCTL			0xA9
> +#define ATC2609A_ADC_CTL			0xAA
> +#define ATC2609A_AGC_CTL0			0xAB
> +#define ATC2609A_AGC_CTL1			0xAC
> +#define ATC2609A_AGC_CTL2			0xAD
> +#define ATC2609A_ADC_ANALOG0			0xAE
> +#define ATC2609A_ADC_ANALOG1			0xAF
> +
> +/* PCM_IF Registers */
> +#define ATC2609A_PCM0_CTL			0xB0
> +#define ATC2609A_PCM1_CTL			0xB1
> +#define ATC2609A_PCM2_CTL			0xB2
> +#define ATC2609A_PCMIF_CTL			0xB3
> +
> +/* CMU_CONTROL Registers */
> +#define ATC2609A_CMU_DEVRST			0xC1
> +
> +/* INTS Registers */
> +#define ATC2609A_INTS_PD			0xC8
> +#define ATC2609A_INTS_MSK			0xC9
> +
> +/* MFP Registers */
> +#define ATC2609A_MFP_CTL			0xD0
> +#define ATC2609A_PAD_VSEL			0xD1
> +#define ATC2609A_GPIO_OUTEN			0xD2
> +#define ATC2609A_GPIO_INEN			0xD3
> +#define ATC2609A_GPIO_DAT			0xD4
> +#define ATC2609A_PAD_DRV			0xD5
> +#define ATC2609A_PAD_EN				0xD6
> +#define ATC2609A_DEBUG_SEL			0xD7
> +#define ATC2609A_DEBUG_IE			0xD8
> +#define ATC2609A_DEBUG_OE			0xD9
> +#define ATC2609A_CHIP_VER			0xDC
> +
> +/* PWSI Registers */
> +#define ATC2609A_PWSI_CTL			0xF0
> +#define ATC2609A_PWSI_STATUS			0xF1
> +
> +/* TWSI Registers */
> +#define ATC2609A_SADDR				0xFF
> +
> +/* PMU_SYS_CTL0 Register Mask Bits */
> +#define ATC2609A_PMU_SYS_CTL0_IR_WK_EN			BIT(5)
> +#define ATC2609A_PMU_SYS_CTL0_RESET_WK_EN		BIT(6)
> +#define ATC2609A_PMU_SYS_CTL0_HDSW_WK_EN		BIT(7)
> +#define ATC2609A_PMU_SYS_CTL0_ALARM_WK_EN		BIT(8)
> +#define ATC2609A_PMU_SYS_CTL0_REM_CON_WK_EN		BIT(9)
> +#define ATC2609A_PMU_SYS_CTL0_RESTART_EN		BIT(10)
> +#define ATC2609A_PMU_SYS_CTL0_WKIRQ_WK_EN		BIT(11)
> +#define ATC2609A_PMU_SYS_CTL0_ONOFF_SHORT_WK_EN		BIT(12)
> +#define ATC2609A_PMU_SYS_CTL0_ONOFF_LONG_WK_EN		BIT(13)
> +#define ATC2609A_PMU_SYS_CTL0_WALL_WK_EN		BIT(14)
> +#define ATC2609A_PMU_SYS_CTL0_USB_WK_EN			BIT(15)
> +#define ATC2609A_PMU_SYS_CTL0_WK_ALL			(GENMASK(15, 5) & (~BIT(10)))
> +
> +/* PMU_SYS_CTL1 Register Mask Bits */
> +#define ATC2609A_PMU_SYS_CTL1_EN_S1			BIT(0)
> +#define ATC2609A_PMU_SYS_CTL1_LB_S4_EN			BIT(2)
> +#define ATC2609A_PMU_SYS_CTL1_LB_S4			GENMASK(4, 3)
> +#define ATC2609A_PMU_SYS_CTL1_LB_S4_3_1V		BIT(4)
> +#define ATC2609A_PMU_SYS_CTL1_IR_WK_FLAG		BIT(5)
> +#define ATC2609A_PMU_SYS_CTL1_RESET_WK_FLAG		BIT(6)
> +#define ATC2609A_PMU_SYS_CTL1_HDSW_WK_FLAG		BIT(7)
> +#define ATC2609A_PMU_SYS_CTL1_ALARM_WK_FLAG		BIT(8)
> +#define ATC2609A_PMU_SYS_CTL1_REM_CON_WK_FLAG		BIT(9)
> +#define ATC2609A_PMU_SYS_CTL1_RESTART_WK_FLAG		BIT(10)
> +#define ATC2609A_PMU_SYS_CTL1_WKIRQ_WK_FLAG		BIT(11)
> +#define ATC2609A_PMU_SYS_CTL1_ONOFF_SHORT_WK_FLAG	BIT(12)
> +#define ATC2609A_PMU_SYS_CTL1_ONOFF_LONG_WK_FLAG	BIT(13)
> +#define ATC2609A_PMU_SYS_CTL1_WALL_WK_FLAG		BIT(14)
> +#define ATC2609A_PMU_SYS_CTL1_USB_WK_FLAG		BIT(15)
> +
> +/* PMU_SYS_CTL2 Register Mask Bits */
> +#define ATC2609A_PMU_SYS_CTL2_PMU_A_EN			BIT(0)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS_INT_EN	BIT(1)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS_PD		BIT(2)
> +#define ATC2609A_PMU_SYS_CTL2_S2TIMER			GENMASK(5, 3)
> +#define ATC2609A_PMU_SYS_CTL2_S2_TIMER_EN		BIT(6)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_RESET_TIME_SEL	GENMASK(8, 7)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_RESET_EN		BIT(9)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS_TIME		GENMASK(11, 10)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_LSP_INT_EN		BIT(12)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_LONG_PRESS		BIT(13)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_SHORT_PRESS		BIT(14)
> +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS		BIT(15)
> +
> +/* PMU_SYS_CTL3 Register Mask Bits */
> +#define ATC2609A_PMU_SYS_CTL3_S2S3TOS1_TIMER		GENMASK(8, 7)
> +#define ATC2609A_PMU_SYS_CTL3_S2S3TOS1_TIMER_EN		BIT(9)
> +#define ATC2609A_PMU_SYS_CTL3_S3_TIMER			GENMASK(12, 10)
> +#define ATC2609A_PMU_SYS_CTL3_S3_TIMER_EN		BIT(13)
> +#define ATC2609A_PMU_SYS_CTL3_EN_S3			BIT(14)
> +#define ATC2609A_PMU_SYS_CTL3_EN_S2			BIT(15)
> +
> +/* PMU_SYS_CTL5 Register Mask Bits */
> +#define ATC2609A_PMU_SYS_CTL5_WALLWKDTEN		BIT(7)
> +#define ATC2609A_PMU_SYS_CTL5_VBUSWKDTEN		BIT(8)
> +#define ATC2609A_PMU_SYS_CTL5_REMCON_DECT_EN		BIT(9)
> +#define ATC2609A_PMU_SYS_CTL5_ONOFF_8S_SEL		BIT(10)
> +
> +/* INTS_MSK Register Mask Bits */
> +#define ATC2609A_INTS_MSK_AUDIO				BIT(0)
> +#define ATC2609A_INTS_MSK_OV				BIT(1)
> +#define ATC2609A_INTS_MSK_OC				BIT(2)
> +#define ATC2609A_INTS_MSK_OT				BIT(3)
> +#define ATC2609A_INTS_MSK_UV				BIT(4)
> +#define ATC2609A_INTS_MSK_ALARM				BIT(5)
> +#define ATC2609A_INTS_MSK_ONOFF				BIT(6)
> +#define ATC2609A_INTS_MSK_WKUP				BIT(7)
> +#define ATC2609A_INTS_MSK_IR				BIT(8)
> +#define ATC2609A_INTS_MSK_REMCON			BIT(9)
> +#define ATC2609A_INTS_MSK_POWERIN			BIT(10)
> +
> +/* CMU_DEVRST Register Mask Bits */
> +#define ATC2609A_CMU_DEVRST_AUDIO			BIT(0)
> +#define ATC2609A_CMU_DEVRST_MFP				BIT(1)
> +#define ATC2609A_CMU_DEVRST_INTS			BIT(2)
> +
> +/* PAD_EN Register Mask Bits */
> +#define ATC2609A_PAD_EN_EXTIRQ				BIT(0)
> +
> +#endif /* __LINUX_MFD_ATC260X_ATC2609A_H */
> diff --git a/include/linux/mfd/atc260x/core.h b/include/linux/mfd/atc260x/core.h
> new file mode 100644
> index 000000000000..a87b976f48e3
> --- /dev/null
> +++ b/include/linux/mfd/atc260x/core.h
> @@ -0,0 +1,86 @@
> +/* SPDX-License-Identifier: GPL-2.0+ */
> +/*
> + * Core MFD defines for ATC260x PMICs
> + *
> + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> + */
> +
> +#ifndef __LINUX_MFD_ATC260X_CORE_H
> +#define __LINUX_MFD_ATC260X_CORE_H
> +
> +#include <linux/mfd/atc260x/atc2603c.h>
> +#include <linux/mfd/atc260x/atc2609a.h>
> +
> +enum atc260x_type {
> +	ATC2603A = 0,
> +	ATC2603C,
> +	ATC2609A,
> +};
> +
> +enum atc260x_ver {
> +	ATC260X_A = 0,
> +	ATC260X_B,
> +	ATC260X_C,
> +	ATC260X_D,
> +	ATC260X_E,
> +	ATC260X_F,
> +	ATC260X_G,
> +	ATC260X_H,
> +};
> +
> +struct atc260x {
> +	struct device *dev;
> +
> +	struct regmap *regmap;
> +	const struct regmap_irq_chip *regmap_irq_chip;
> +	struct regmap_irq_chip_data *irq_data;
> +
> +	struct mutex *regmap_mutex;	/* mutex for custom regmap locking */
> +
> +	const struct mfd_cell *cells;
> +	int nr_cells;
> +	int irq;
> +
> +	enum atc260x_type ic_type;
> +	enum atc260x_ver ic_ver;
> +	const char *type_name;
> +	unsigned int rev_reg;
> +
> +	int (*dev_init)(struct atc260x *atc260x);
> +};
> +
> +struct regmap_config;
> +
> +/**
> + * atc260x_match_device(): Setup atc260x variant related fields
> + *
> + * @atc260x: atc260x device to setup (.dev field must be set)
> + * @regmap_cfg: regmap config associated with this atc260x device
> + *
> + * This lets the atc260x core configure the mfd cells and register maps

Please capitalise abbreviations and model names:

"MFD"
"ATC260x"
"IRQChip"
"IRQ"

> + * for later use.
> + */
> +int atc260x_match_device(struct atc260x *atc260x, struct regmap_config *regmap_cfg);
> +
> +/**
> + * atc260x_device_probe(): Probe a configured atc260x device
> + *
> + * @atc260x: atc260x device to probe (must be configured)
> + *
> + * This function lets the atc260x core register the atc260x mfd devices
> + * and irqchip. The atc260x device passed in must be fully configured
> + * with atc260x_match_device, its irq set, and regmap created.
> + */
> +int atc260x_device_probe(struct atc260x *atc260x);
> +
> +/**
> + * atc260x_device_remove(): Remove a atc260x device

"an"

> + *
> + * @atc260x: atc260x device to remove
> + *
> + * This tells the atc260x core to remove the associated mfd devices
> + */
> +int atc260x_device_remove(struct atc260x *atc260x);

Not sure I've seen kerneldoc used on prototypes before.

Probably better to move them onto the real functions.

> +#endif /* __LINUX_MFD_ATC260X_CORE_H */

Hi Lee,

Thank you for the detailed review!

I will prepare a new revision, but there are still a couple of open
points..

On Wed, Dec 16, 2020 at 10:10:00AM +0000, Lee Jones wrote:
> On Sun, 06 Dec 2020, Cristian Ciocaltea wrote:
> 
> > Add initial support for the Actions Semi ATC260x PMICs. ATC260x series
> > PMICs integrates Audio Codec, Power management, Clock generation and
> 
> "which integrates"

Done.

> > GPIO controller blocks.
> > 
> > For the moment this driver only supports Regulator, Poweroff and Onkey
> > functionalities for the ATC2603C and ATC2609A chip variants.
> > 
> > Since the PMICs can be accessed using both I2C and SPI buses, the
> > following driver structure has been adopted:
> > 
> >            -----> atc260x-core.c (Implements core functionalities)
> >           /
> > ATC260x --------> atc260x-i2c.c (Implements I2C interface)
> >           \
> >            -----> atc260x-spi.c (Implements SPI interface - TODO)
> > 
> > Co-developed-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> > Signed-off-by: Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> > Signed-off-by: Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> > ---
> > Changes in v3:
> >  - Fixed the issues reported by Lee's kernel test robot:
> >    WARNING: modpost: missing MODULE_LICENSE() in drivers/mfd/atc260x-core.o
> >    >> FATAL: modpost: drivers/mfd/atc260x-i2c: sizeof(struct i2c_device_id)=24 is
> >       not a modulo of the size of section __mod_i2c__<identifier>_device_table=588.
> >    >> Fix definition of struct i2c_device_id in mod_devicetable.h
> >  - Dropped the usage of '.of_compatible' fields in {atc2603c,atc2609a}_mfd_cells[]
> >  - Added 'Co-developed-by' tag in commit message and dropped [cristian: ...] line
> > 
> >  drivers/mfd/Kconfig                  |  18 ++
> >  drivers/mfd/Makefile                 |   3 +
> >  drivers/mfd/atc260x-core.c           | 290 +++++++++++++++++++++++++
> >  drivers/mfd/atc260x-i2c.c            |  73 +++++++
> >  include/linux/mfd/atc260x/atc2603c.h | 281 ++++++++++++++++++++++++
> >  include/linux/mfd/atc260x/atc2609a.h | 308 +++++++++++++++++++++++++++
> >  include/linux/mfd/atc260x/core.h     |  86 ++++++++
> >  7 files changed, 1059 insertions(+)
> >  create mode 100644 drivers/mfd/atc260x-core.c
> >  create mode 100644 drivers/mfd/atc260x-i2c.c
> >  create mode 100644 include/linux/mfd/atc260x/atc2603c.h
> >  create mode 100644 include/linux/mfd/atc260x/atc2609a.h
> >  create mode 100644 include/linux/mfd/atc260x/core.h
> > 
> > diff --git a/drivers/mfd/Kconfig b/drivers/mfd/Kconfig
> > index 8b99a13669bf..5556182af41c 100644
> > --- a/drivers/mfd/Kconfig
> > +++ b/drivers/mfd/Kconfig
> > @@ -2076,6 +2076,24 @@ config MFD_WCD934X
> >  	  This driver provides common support WCD934x audio codec and its
> >  	  associated Pin Controller, Soundwire Controller and Audio codec.
> >  
> > +config MFD_ATC260X
> > +	tristate
> > +	select MFD_CORE
> > +	select REGMAP
> > +	select REGMAP_IRQ
> > +
> > +config MFD_ATC260X_I2C
> > +	tristate "Actions Semi ATC260x PMICs with I2C"
> > +	select MFD_ATC260X
> > +	select REGMAP_I2C
> > +	depends on I2C
> > +	help
> > +	  Support for the Actions Semi ATC260x PMICs controlled via I2C.
> > +
> > +	  This driver provides common support for accessing the ATC2603C
> > +	  and ATC2609A chip variants, additional drivers must be enabled
> > +	  in order to use the functionality of the device.
> > +
> >  config MFD_KHADAS_MCU
> >  	tristate "Support for Khadas System control Microcontroller"
> >  	depends on I2C
> > diff --git a/drivers/mfd/Makefile b/drivers/mfd/Makefile
> > index 1780019d2474..d10362670ac3 100644
> > --- a/drivers/mfd/Makefile
> > +++ b/drivers/mfd/Makefile
> > @@ -267,3 +267,6 @@ obj-$(CONFIG_MFD_KHADAS_MCU) 	+= khadas-mcu.o
> >  obj-$(CONFIG_SGI_MFD_IOC3)	+= ioc3.o
> >  obj-$(CONFIG_MFD_SIMPLE_MFD_I2C)	+= simple-mfd-i2c.o
> >  obj-$(CONFIG_MFD_INTEL_M10_BMC)   += intel-m10-bmc.o
> > +
> > +obj-$(CONFIG_MFD_ATC260X)	+= atc260x-core.o
> > +obj-$(CONFIG_MFD_ATC260X_I2C)	+= atc260x-i2c.o
> > diff --git a/drivers/mfd/atc260x-core.c b/drivers/mfd/atc260x-core.c
> > new file mode 100644
> > index 000000000000..fd3a43b4030d
> > --- /dev/null
> > +++ b/drivers/mfd/atc260x-core.c
> > @@ -0,0 +1,290 @@
> > +// SPDX-License-Identifier: GPL-2.0+
> > +/*
> > + * Core MFD support for ATC260x PMICs
> 
> Drop the MFD part please.

Done.

> > + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> > + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> > + */
> > +
> > +#include <linux/interrupt.h>
> > +#include <linux/mfd/atc260x/core.h>
> > +#include <linux/mfd/core.h>
> > +#include <linux/module.h>
> > +#include <linux/of.h>
> > +#include <linux/of_device.h>
> > +#include <linux/regmap.h>
> > +
> > +static void regmap_lock_mutex(void *__mutex)
> > +{
> > +	struct mutex *mutex = __mutex;
> > +
> > +	/*
> > +	 * Using regmap within an atomic context (e.g. accessing a PMIC when
> > +	 * powering system down) is normally allowed only if the regmap type
> > +	 * is MMIO and the regcache type is either REGCACHE_NONE or
> > +	 * REGCACHE_FLAT. For slow buses like I2C and SPI, the regmap is
> > +	 * internally protected by a mutex which is acquired non-atomically.
> > +	 *
> > +	 * Let's improve this by using a customized locking scheme inspired
> > +	 * from I2C atomic transfer. See i2c_in_atomic_xfer_mode() for a
> > +	 * starting point.
> > +	 */
> > +	if (system_state > SYSTEM_RUNNING && irqs_disabled())
> 
> Were does system_state come from?

It is declared in 'include/linux/kernel.h':

extern enum system_states {
	SYSTEM_BOOTING,
	SYSTEM_SCHEDULING,
	SYSTEM_RUNNING,
	SYSTEM_HALT,
	SYSTEM_POWER_OFF,
	SYSTEM_RESTART,
	SYSTEM_SUSPEND,
} system_state;

The definition is in 'init/main.c':

enum system_states system_state __read_mostly;
EXPORT_SYMBOL(system_state);

> > +		mutex_trylock(mutex);
> > +	else
> > +		mutex_lock(mutex);
> > +}
> > +
> > +static void regmap_unlock_mutex(void *__mutex)
> > +{
> > +	struct mutex *mutex = __mutex;
> > +
> > +	mutex_unlock(mutex);
> > +}
> > +
> > +static const struct regmap_config atc2603c_regmap_config = {
> > +	.reg_bits = 8,
> > +	.val_bits = 16,
> > +	.max_register = ATC2603C_SADDR,
> > +	.cache_type = REGCACHE_NONE,
> > +};
> > +
> > +static const struct regmap_config atc2609a_regmap_config = {
> > +	.reg_bits = 8,
> > +	.val_bits = 16,
> > +	.max_register = ATC2609A_SADDR,
> > +	.cache_type = REGCACHE_NONE,
> > +};
> > +
> > +static const struct regmap_irq atc2603c_regmap_irqs[] = {
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_AUDIO,	0, ATC2603C_INTS_MSK_AUDIO),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_OV,		0, ATC2603C_INTS_MSK_OV),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_OC,		0, ATC2603C_INTS_MSK_OC),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_OT,		0, ATC2603C_INTS_MSK_OT),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_UV,		0, ATC2603C_INTS_MSK_UV),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_ALARM,	0, ATC2603C_INTS_MSK_ALARM),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_ONOFF,	0, ATC2603C_INTS_MSK_ONOFF),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_SGPIO,	0, ATC2603C_INTS_MSK_SGPIO),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_IR,		0, ATC2603C_INTS_MSK_IR),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_REMCON,	0, ATC2603C_INTS_MSK_REMCON),
> > +	REGMAP_IRQ_REG(ATC2603C_IRQ_POWER_IN,	0, ATC2603C_INTS_MSK_POWERIN),
> > +};
> > +
> > +static const struct regmap_irq atc2609a_regmap_irqs[] = {
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_AUDIO,	0, ATC2609A_INTS_MSK_AUDIO),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_OV,		0, ATC2609A_INTS_MSK_OV),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_OC,		0, ATC2609A_INTS_MSK_OC),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_OT,		0, ATC2609A_INTS_MSK_OT),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_UV,		0, ATC2609A_INTS_MSK_UV),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_ALARM,	0, ATC2609A_INTS_MSK_ALARM),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_ONOFF,	0, ATC2609A_INTS_MSK_ONOFF),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_WKUP,	0, ATC2609A_INTS_MSK_WKUP),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_IR,		0, ATC2609A_INTS_MSK_IR),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_REMCON,	0, ATC2609A_INTS_MSK_REMCON),
> > +	REGMAP_IRQ_REG(ATC2609A_IRQ_POWER_IN,	0, ATC2609A_INTS_MSK_POWERIN),
> > +};
> > +
> > +static const struct regmap_irq_chip atc2603c_regmap_irq_chip = {
> > +	.name = "atc2603c",
> > +	.irqs = atc2603c_regmap_irqs,
> > +	.num_irqs = ARRAY_SIZE(atc2603c_regmap_irqs),
> > +	.num_regs = 1,
> > +	.status_base = ATC2603C_INTS_PD,
> > +	.mask_base = ATC2603C_INTS_MSK,
> > +	.mask_invert = true,
> > +};
> > +
> > +static const struct regmap_irq_chip atc2609a_regmap_irq_chip = {
> > +	.name = "atc2609a",
> > +	.irqs = atc2609a_regmap_irqs,
> > +	.num_irqs = ARRAY_SIZE(atc2609a_regmap_irqs),
> > +	.num_regs = 1,
> > +	.status_base = ATC2609A_INTS_PD,
> > +	.mask_base = ATC2609A_INTS_MSK,
> > +	.mask_invert = true,
> > +};
> > +
> > +static const struct resource atc2603c_onkey_resources[] = {
> > +	DEFINE_RES_IRQ(ATC2603C_IRQ_ONOFF),
> > +};
> > +
> > +static const struct resource atc2609a_onkey_resources[] = {
> > +	DEFINE_RES_IRQ(ATC2609A_IRQ_ONOFF),
> > +};
> > +
> > +static const struct mfd_cell atc2603c_mfd_cells[] = {
> > +	{
> > +		.name = "atc260x-regulator",
> > +	}, {
> > +		.name = "atc260x-pwrc",
> > +	}, {
> 
> Please place single line entries on one line:
> 
> 	{ .name = "atc260x-regulator" },
> 	{ .name = "atc260x-pwrc" },

Done.

> > +	{
> > +		.name = "atc260x-onkey",
> > +		.num_resources = ARRAY_SIZE(atc2603c_onkey_resources),
> > +		.resources = atc2603c_onkey_resources,
> > +	},
> > +};
> > +
> > +static const struct mfd_cell atc2609a_mfd_cells[] = {
> > +	{
> > +		.name = "atc260x-regulator",
> > +	}, {
> > +		.name = "atc260x-pwrc",
> 
> As above.

Done.

> > +	}, {
> > +		.name = "atc260x-onkey",
> > +		.num_resources = ARRAY_SIZE(atc2609a_onkey_resources),
> > +		.resources = atc2609a_onkey_resources,
> > +	},
> > +};
> > +
> > +static void atc260x_cmu_reset(struct atc260x *atc260x, u32 reg, u8 mask, u32 bit)
> > +{
> > +	/* Assert reset */
> > +	regmap_update_bits(atc260x->regmap, reg, mask, ~bit);
> > +
> > +	/* De-assert reset */
> > +	regmap_update_bits(atc260x->regmap, reg, mask, bit);
> > +}
> > +
> > +static int atc2603c_dev_init(struct atc260x *atc260x)
> > +{
> > +	/* Initialize interrupt block */
> > +	atc260x_cmu_reset(atc260x, ATC2603C_CMU_DEVRST,
> > +			  ATC2603C_CMU_DEVRST_INTS, ATC2603C_CMU_DEVRST_INTS);
> > +
> > +	/* Disable all interrupt sources */
> > +	regmap_write(atc260x->regmap, ATC2603C_INTS_MSK, 0);
> > +
> > +	/* Enable EXTIRQ pad */
> > +	return regmap_update_bits(atc260x->regmap, ATC2603C_PAD_EN,
> > +				  ATC2603C_PAD_EN_EXTIRQ, ATC2603C_PAD_EN_EXTIRQ);
> > +}
> > +
> > +static int atc2609a_dev_init(struct atc260x *atc260x)
> > +{
> > +	/* Initialize interrupt block */
> > +	atc260x_cmu_reset(atc260x, ATC2609A_CMU_DEVRST,
> > +			  ATC2609A_CMU_DEVRST_INTS, ATC2609A_CMU_DEVRST_INTS);
> > +
> > +	/* Disable all interrupt sources */
> > +	regmap_write(atc260x->regmap, ATC2609A_INTS_MSK, 0);
> > +
> > +	/* Enable EXTIRQ pad */
> > +	return regmap_update_bits(atc260x->regmap, ATC2609A_PAD_EN,
> > +				  ATC2609A_PAD_EN_EXTIRQ, ATC2609A_PAD_EN_EXTIRQ);
> > +}
> > +
> > +int atc260x_match_device(struct atc260x *atc260x, struct regmap_config *regmap_cfg)
> > +{
> > +	struct device *dev = atc260x->dev;
> > +	const void *of_data;
> > +
> > +	of_data = of_device_get_match_data(dev);
> > +	if (!of_data)
> > +		return -ENODEV;
> > +
> > +	atc260x->ic_type = (unsigned long)of_data;
> > +
> > +	switch (atc260x->ic_type) {
> > +	case ATC2603C:
> > +		*regmap_cfg = atc2603c_regmap_config;
> > +		atc260x->regmap_irq_chip = &atc2603c_regmap_irq_chip;
> > +		atc260x->cells = atc2603c_mfd_cells;
> > +		atc260x->nr_cells = ARRAY_SIZE(atc2603c_mfd_cells);
> > +		atc260x->type_name = "atc2603c";
> > +		atc260x->rev_reg = ATC2603C_CHIP_VER;
> > +		atc260x->dev_init = atc2603c_dev_init;
> > +		break;
> > +	case ATC2609A:
> > +		*regmap_cfg = atc2609a_regmap_config;
> > +		atc260x->regmap_irq_chip = &atc2609a_regmap_irq_chip;
> > +		atc260x->cells = atc2609a_mfd_cells;
> > +		atc260x->nr_cells = ARRAY_SIZE(atc2609a_mfd_cells);
> > +		atc260x->type_name = "atc2609a";
> > +		atc260x->rev_reg = ATC2609A_CHIP_VER;
> > +		atc260x->dev_init = atc2609a_dev_init;
> > +		break;
> > +	default:
> > +		dev_err(dev, "Unsupported ATC260x device type: %u\n",
> > +			atc260x->ic_type);
> > +		return -EINVAL;
> > +	}
> > +
> > +	atc260x->regmap_mutex = devm_kzalloc(dev, sizeof(*atc260x->regmap_mutex),
> > +					     GFP_KERNEL);
> > +	if (!atc260x->regmap_mutex)
> > +		return -ENOMEM;
> > +
> > +	mutex_init(atc260x->regmap_mutex);
> > +
> > +	regmap_cfg->lock = regmap_lock_mutex,
> > +	regmap_cfg->unlock = regmap_unlock_mutex,
> > +	regmap_cfg->lock_arg = atc260x->regmap_mutex;
> > +
> > +	return 0;
> > +}
> > +EXPORT_SYMBOL_GPL(atc260x_match_device);
> > +
> > +int atc260x_device_probe(struct atc260x *atc260x)
> > +{
> > +	struct device *dev = atc260x->dev;
> > +	unsigned int chip_rev;
> > +	int ret;
> > +
> > +	if (!atc260x->irq) {
> > +		dev_err(dev, "No interrupt support\n");
> > +		return -EINVAL;
> > +	}
> > +
> > +	/* Initialize the hardware */
> > +	if (atc260x->dev_init)
> > +		atc260x->dev_init(atc260x);
> 
> Will this ever not be required?
> 
> If it will always be required, you can drop the if().

Currently this is always mandatory, so I dropped the 'if' clause.

> > +	ret = regmap_read(atc260x->regmap, atc260x->rev_reg, &chip_rev);
> > +	if (ret) {
> > +		dev_err(dev, "Failed to get chip revision\n");
> > +		return ret;
> > +	}
> > +
> > +	if (chip_rev < 0 || chip_rev > 31) {
> > +		dev_err(dev, "Unknown chip revision: %d\n", ret);
> > +		return -EINVAL;
> > +	}
> 
> This still seems limiting.

This is based on the vendor implementation. Unfortunately I don't have
access to a data sheet or any other source of information about the
management of the chip revisions.

> > +	atc260x->ic_ver = __ffs(chip_rev + 1U);
> 
> This is still inefficient.

Please see above.

> > +	dev_info(dev, "Detected chip type %s rev.%c\n",
> > +		 atc260x->type_name, 'A' + atc260x->ic_ver);
> > +
> > +	ret = regmap_add_irq_chip(atc260x->regmap, atc260x->irq, IRQF_ONESHOT, -1,
> > +				  atc260x->regmap_irq_chip, &atc260x->irq_data);
> 
> Why not use devm_*?

Right, I replaced it with 'devm' counterpart.

> > +	if (ret) {
> > +		dev_err(dev, "Failed to add IRQ chip: %d\n", ret);
> > +		return ret;
> > +	}
> > +
> > +	ret = devm_mfd_add_devices(dev, PLATFORM_DEVID_NONE,
> > +				   atc260x->cells, atc260x->nr_cells, NULL, 0,
> > +				   regmap_irq_get_domain(atc260x->irq_data));
> > +	if (ret) {
> > +		dev_err(dev, "Failed to add child devices: %d\n", ret);
> > +		regmap_del_irq_chip(atc260x->irq, atc260x->irq_data);
> > +		return ret;
> 
> Drop this return and always return ret at the end.

Done.

> > +	}
> > +
> > +	return 0;
> > +}
> > +EXPORT_SYMBOL_GPL(atc260x_device_probe);
> > +
> > +int atc260x_device_remove(struct atc260x *atc260x)
> > +{
> > +	mfd_remove_devices(atc260x->dev);
> 
> No need to do this, since you used devm_*.
> 
> > +	regmap_del_irq_chip(atc260x->irq, atc260x->irq_data);
> 
> If you use devm_* you can omit this too.

Now 'atc260x_device_remove()' function is not needed anymore, so I
dropped it.

> > +	return 0;
> > +}
> > +EXPORT_SYMBOL_GPL(atc260x_device_remove);
> > +
> > +MODULE_DESCRIPTION("ATC260x PMICs Core MFD support");
> 
> Drop "MFD" please.

Done.
 
> > +MODULE_AUTHOR("Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>");
> > +MODULE_AUTHOR("Cristian Ciocaltea <cristian.ciocaltea@gmail.com>");
> > +MODULE_LICENSE("GPL");
> > diff --git a/drivers/mfd/atc260x-i2c.c b/drivers/mfd/atc260x-i2c.c
> > new file mode 100644
> > index 000000000000..40136a47feda
> > --- /dev/null
> > +++ b/drivers/mfd/atc260x-i2c.c
> > @@ -0,0 +1,73 @@
> > +// SPDX-License-Identifier: GPL-2.0+
> > +/*
> > + * I2C bus interface for ATC260x PMICs
> > + *
> > + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> > + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> > + */
> > +
> > +#include <linux/i2c.h>
> > +#include <linux/mfd/atc260x/core.h>
> > +#include <linux/module.h>
> > +#include <linux/of.h>
> > +#include <linux/regmap.h>
> > +
> > +static int atc260x_i2c_probe(struct i2c_client *client,
> > +			     const struct i2c_device_id *id)
> > +{
> > +	struct atc260x *atc260x;
> > +	struct regmap_config regmap_cfg;
> > +	int ret;
> > +
> > +	atc260x = devm_kzalloc(&client->dev, sizeof(*atc260x), GFP_KERNEL);
> > +	if (!atc260x)
> > +		return -ENOMEM;
> > +
> > +	atc260x->dev = &client->dev;
> > +	atc260x->irq = client->irq;
> > +
> > +	ret = atc260x_match_device(atc260x, &regmap_cfg);
> > +	if (ret)
> > +		return ret;
> > +
> > +	i2c_set_clientdata(client, atc260x);
> > +
> > +	atc260x->regmap = devm_regmap_init_i2c(client, &regmap_cfg);
> > +	if (IS_ERR(atc260x->regmap)) {
> > +		ret = PTR_ERR(atc260x->regmap);
> > +		dev_err(&client->dev, "failed to init regmap: %d\n", ret);
> > +		return ret;
> > +	}
> > +
> > +	return atc260x_device_probe(atc260x);
> > +}
> > +
> > +static int atc260x_i2c_remove(struct i2c_client *client)
> > +{
> > +	struct atc260x *atc260x = i2c_get_clientdata(client)
> > +
> > +	return atc260x_device_remove(atc260x);
> > +}
> > +
> > +const struct of_device_id atc260x_i2c_of_match[] = {
> > +	{ .compatible = "actions,atc2603c", .data = (void *)ATC2603C },
> > +	{ .compatible = "actions,atc2609a", .data = (void *)ATC2609A },
> > +	{ /* sentinel */ }
> 
> I think you can drop the (void *) casts.

Without the cast, I get the following compiler warning:

drivers/mfd/atc260x-i2c.c:46:46: warning: initialization of ‘const void *’
from ‘int’ makes pointer from integer without a cast [-Wint-conversion]
  { .compatible = "actions,atc2603c", .data = ATC2603C },

> Please remove the /* sentinel */ comment, we know what NULL
> terminators do.

Done.

> > +};
> > +MODULE_DEVICE_TABLE(of, atc260x_i2c_of_match);
> > +
> > +static struct i2c_driver atc260x_i2c_driver = {
> > +	.driver = {
> > +		.name	= "atc260x",
> > +		.of_match_table	= of_match_ptr(atc260x_i2c_of_match),
> > +	},
> > +	.probe		= atc260x_i2c_probe,
> > +	.remove		= atc260x_i2c_remove,
> > +};
> > +
> 
> Nit: Remove this line.

Done.

> > +module_i2c_driver(atc260x_i2c_driver);
> > +
> > +MODULE_DESCRIPTION("ATC260x PMICs I2C bus interface");
> > +MODULE_AUTHOR("Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>");
> > +MODULE_AUTHOR("Cristian Ciocaltea <cristian.ciocaltea@gmail.com>");
> > +MODULE_LICENSE("GPL");
> > diff --git a/include/linux/mfd/atc260x/atc2603c.h b/include/linux/mfd/atc260x/atc2603c.h
> > new file mode 100644
> > index 000000000000..07ac640ef3e1
> > --- /dev/null
> > +++ b/include/linux/mfd/atc260x/atc2603c.h
> > @@ -0,0 +1,281 @@
> > +/* SPDX-License-Identifier: GPL-2.0+ */
> > +/*
> > + * ATC2603C PMIC register definitions
> > + *
> > + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> > + */
> > +
> > +#ifndef __LINUX_MFD_ATC260X_ATC2603C_H
> > +#define __LINUX_MFD_ATC260X_ATC2603C_H
> > +
> > +enum atc2603c_irq_def {
> > +	ATC2603C_IRQ_AUDIO = 0,
> > +	ATC2603C_IRQ_OV,
> > +	ATC2603C_IRQ_OC,
> > +	ATC2603C_IRQ_OT,
> > +	ATC2603C_IRQ_UV,
> > +	ATC2603C_IRQ_ALARM,
> > +	ATC2603C_IRQ_ONOFF,
> > +	ATC2603C_IRQ_SGPIO,
> > +	ATC2603C_IRQ_IR,
> > +	ATC2603C_IRQ_REMCON,
> > +	ATC2603C_IRQ_POWER_IN,
> > +};
> > +
> > +/* PMU Registers */
> > +#define ATC2603C_PMU_SYS_CTL0			0x00
> > +#define ATC2603C_PMU_SYS_CTL1			0x01
> > +#define ATC2603C_PMU_SYS_CTL2			0x02
> > +#define ATC2603C_PMU_SYS_CTL3			0x03
> > +#define ATC2603C_PMU_SYS_CTL4			0x04
> > +#define ATC2603C_PMU_SYS_CTL5			0x05
> > +#define ATC2603C_PMU_SYS_CTL6			0x06
> > +#define ATC2603C_PMU_SYS_CTL7			0x07
> > +#define ATC2603C_PMU_SYS_CTL8			0x08
> > +#define ATC2603C_PMU_SYS_CTL9			0x09
> > +#define ATC2603C_PMU_BAT_CTL0			0x0A
> > +#define ATC2603C_PMU_BAT_CTL1			0x0B
> > +#define ATC2603C_PMU_VBUS_CTL0			0x0C
> > +#define ATC2603C_PMU_VBUS_CTL1			0x0D
> > +#define ATC2603C_PMU_WALL_CTL0			0x0E
> > +#define ATC2603C_PMU_WALL_CTL1			0x0F
> > +#define ATC2603C_PMU_SYS_PENDING		0x10
> > +#define ATC2603C_PMU_DC1_CTL0			0x11
> > +#define ATC2603C_PMU_DC1_CTL1			0x12 // Undocumented
> > +#define ATC2603C_PMU_DC1_CTL2			0x13 // Undocumented
> > +#define ATC2603C_PMU_DC2_CTL0			0x14
> > +#define ATC2603C_PMU_DC2_CTL1			0x15 // Undocumented
> > +#define ATC2603C_PMU_DC2_CTL2			0x16 // Undocumented
> > +#define ATC2603C_PMU_DC3_CTL0			0x17
> > +#define ATC2603C_PMU_DC3_CTL1			0x18 // Undocumented
> > +#define ATC2603C_PMU_DC3_CTL2			0x19 // Undocumented
> > +#define ATC2603C_PMU_DC4_CTL0			0x1A // Undocumented
> > +#define ATC2603C_PMU_DC4_CTL1			0x1B // Undocumented
> > +#define ATC2603C_PMU_DC5_CTL0			0x1C // Undocumented
> > +#define ATC2603C_PMU_DC5_CTL1			0x1D // Undocumented
> > +#define ATC2603C_PMU_LDO1_CTL			0x1E
> > +#define ATC2603C_PMU_LDO2_CTL			0x1F
> > +#define ATC2603C_PMU_LDO3_CTL			0x20
> > +#define ATC2603C_PMU_LDO4_CTL			0x21 // Undocumented
> > +#define ATC2603C_PMU_LDO5_CTL			0x22
> > +#define ATC2603C_PMU_LDO6_CTL			0x23
> > +#define ATC2603C_PMU_LDO7_CTL			0x24
> > +#define ATC2603C_PMU_LDO8_CTL			0x25 // Undocumented
> > +#define ATC2603C_PMU_LDO9_CTL			0x26 // Undocumented
> > +#define ATC2603C_PMU_LDO10_CTL			0x27 // Undocumented
> > +#define ATC2603C_PMU_LDO11_CTL			0x28
> > +#define ATC2603C_PMU_SWITCH_CTL			0x29
> > +#define ATC2603C_PMU_OV_CTL0			0x2A
> > +#define ATC2603C_PMU_OV_CTL1			0x2B
> > +#define ATC2603C_PMU_OV_STATUS			0x2C
> > +#define ATC2603C_PMU_OV_EN			0x2D
> > +#define ATC2603C_PMU_OV_INT_EN			0x2E
> > +#define ATC2603C_PMU_OC_CTL			0x2F
> > +#define ATC2603C_PMU_OC_STATUS			0x30
> > +#define ATC2603C_PMU_OC_EN			0x31
> > +#define ATC2603C_PMU_OC_INT_EN			0x32
> > +#define ATC2603C_PMU_UV_CTL0			0x33
> > +#define ATC2603C_PMU_UV_CTL1			0x34
> > +#define ATC2603C_PMU_UV_STATUS			0x35
> > +#define ATC2603C_PMU_UV_EN			0x36
> > +#define ATC2603C_PMU_UV_INT_EN			0x37
> > +#define ATC2603C_PMU_OT_CTL			0x38
> > +#define ATC2603C_PMU_CHARGER_CTL0		0x39
> > +#define ATC2603C_PMU_CHARGER_CTL1		0x3A
> > +#define ATC2603C_PMU_CHARGER_CTL2		0x3B
> > +#define ATC2603C_PMU_BAKCHARGER_CTL		0x3C // Undocumented
> > +#define ATC2603C_PMU_APDS_CTL			0x3D
> > +#define ATC2603C_PMU_AUXADC_CTL0		0x3E
> > +#define ATC2603C_PMU_AUXADC_CTL1		0x3F
> > +#define ATC2603C_PMU_BATVADC			0x40
> > +#define ATC2603C_PMU_BATIADC			0x41
> > +#define ATC2603C_PMU_WALLVADC			0x42
> > +#define ATC2603C_PMU_WALLIADC			0x43
> > +#define ATC2603C_PMU_VBUSVADC			0x44
> > +#define ATC2603C_PMU_VBUSIADC			0x45
> > +#define ATC2603C_PMU_SYSPWRADC			0x46
> > +#define ATC2603C_PMU_REMCONADC			0x47
> > +#define ATC2603C_PMU_SVCCADC			0x48
> > +#define ATC2603C_PMU_CHGIADC			0x49
> > +#define ATC2603C_PMU_IREFADC			0x4A
> > +#define ATC2603C_PMU_BAKBATADC			0x4B
> > +#define ATC2603C_PMU_ICTEMPADC			0x4C
> > +#define ATC2603C_PMU_AUXADC0			0x4D
> > +#define ATC2603C_PMU_AUXADC1			0x4E
> > +#define ATC2603C_PMU_AUXADC2			0x4F
> > +#define	ATC2603C_PMU_ICMADC			0x50
> > +#define ATC2603C_PMU_BDG_CTL			0x51 // Undocumented
> > +#define ATC2603C_RTC_CTL			0x52
> > +#define ATC2603C_RTC_MSALM			0x53
> > +#define ATC2603C_RTC_HALM			0x54
> > +#define ATC2603C_RTC_YMDALM			0x55
> > +#define ATC2603C_RTC_MS				0x56
> > +#define ATC2603C_RTC_H				0x57
> > +#define ATC2603C_RTC_DC				0x58
> > +#define ATC2603C_RTC_YMD			0x59
> > +#define ATC2603C_EFUSE_DAT			0x5A // Undocumented
> > +#define ATC2603C_EFUSECRTL1			0x5B // Undocumented
> > +#define ATC2603C_EFUSECRTL2			0x5C // Undocumented
> > +#define ATC2603C_PMU_FW_USE0			0x5D // Undocumented
> > +#define ATC2603C_PMU_FW_USE1			0x5E // Undocumented
> > +#define ATC2603C_PMU_FW_USE2			0x5F // Undocumented
> > +#define ATC2603C_PMU_FW_USE3			0x60 // Undocumented
> > +#define ATC2603C_PMU_FW_USE4			0x61 // Undocumented
> > +#define ATC2603C_PMU_ABNORMAL_STATUS		0x62
> > +#define ATC2603C_PMU_WALL_APDS_CTL		0x63
> > +#define ATC2603C_PMU_REMCON_CTL0		0x64
> > +#define ATC2603C_PMU_REMCON_CTL1		0x65
> > +#define ATC2603C_PMU_MUX_CTL0			0x66
> > +#define ATC2603C_PMU_SGPIO_CTL0			0x67
> > +#define ATC2603C_PMU_SGPIO_CTL1			0x68
> > +#define ATC2603C_PMU_SGPIO_CTL2			0x69
> > +#define ATC2603C_PMU_SGPIO_CTL3			0x6A
> > +#define ATC2603C_PMU_SGPIO_CTL4			0x6B
> > +#define ATC2603C_PWMCLK_CTL			0x6C
> > +#define ATC2603C_PWM0_CTL			0x6D
> > +#define ATC2603C_PWM1_CTL			0x6E
> > +#define ATC2603C_PMU_ADC_DBG0			0x70
> > +#define ATC2603C_PMU_ADC_DBG1			0x71
> > +#define ATC2603C_PMU_ADC_DBG2			0x72
> > +#define ATC2603C_PMU_ADC_DBG3			0x73
> > +#define ATC2603C_PMU_ADC_DBG4			0x74
> > +#define ATC2603C_IRC_CTL			0x80
> > +#define ATC2603C_IRC_STAT			0x81
> > +#define ATC2603C_IRC_CC				0x82
> > +#define ATC2603C_IRC_KDC			0x83
> > +#define ATC2603C_IRC_WK				0x84
> > +#define ATC2603C_IRC_RCC			0x85
> > +#define ATC2603C_IRC_FILTER			0x86
> > +
> > +/* AUDIO_OUT Registers */
> > +#define ATC2603C_AUDIOINOUT_CTL			0xA0
> > +#define ATC2603C_AUDIO_DEBUGOUTCTL		0xA1
> > +#define ATC2603C_DAC_DIGITALCTL			0xA2
> > +#define ATC2603C_DAC_VOLUMECTL0			0xA3
> > +#define ATC2603C_DAC_ANALOG0			0xA4
> > +#define ATC2603C_DAC_ANALOG1			0xA5
> > +#define ATC2603C_DAC_ANALOG2			0xA6
> > +#define ATC2603C_DAC_ANALOG3			0xA7
> > +
> > +/* AUDIO_IN Registers */
> > +#define ATC2603C_ADC_DIGITALCTL			0xA8
> > +#define ATC2603C_ADC_HPFCTL			0xA9
> > +#define ATC2603C_ADC_CTL			0xAA
> > +#define ATC2603C_AGC_CTL0			0xAB
> > +#define ATC2603C_AGC_CTL1			0xAC // Undocumented
> > +#define ATC2603C_AGC_CTL2			0xAD
> > +#define ATC2603C_ADC_ANALOG0			0xAE
> > +#define ATC2603C_ADC_ANALOG1			0xAF
> > +
> > +/* PCM_IF Registers */
> > +#define ATC2603C_PCM0_CTL			0xB0 // Undocumented
> > +#define ATC2603C_PCM1_CTL			0xB1 // Undocumented
> > +#define ATC2603C_PCM2_CTL			0xB2 // Undocumented
> > +#define ATC2603C_PCMIF_CTL			0xB3 // Undocumented
> > +
> > +/* CMU_CONTROL Registers */
> > +#define ATC2603C_CMU_DEVRST			0xC1 // Undocumented
> > +
> > +/* INTS Registers */
> > +#define ATC2603C_INTS_PD			0xC8
> > +#define ATC2603C_INTS_MSK			0xC9
> > +
> > +/* MFP Registers */
> > +#define ATC2603C_MFP_CTL			0xD0
> > +#define ATC2603C_PAD_VSEL			0xD1 // Undocumented
> > +#define ATC2603C_GPIO_OUTEN			0xD2
> > +#define ATC2603C_GPIO_INEN			0xD3
> > +#define ATC2603C_GPIO_DAT			0xD4
> > +#define ATC2603C_PAD_DRV			0xD5
> > +#define ATC2603C_PAD_EN				0xD6
> > +#define ATC2603C_DEBUG_SEL			0xD7 // Undocumented
> > +#define ATC2603C_DEBUG_IE			0xD8 // Undocumented
> > +#define ATC2603C_DEBUG_OE			0xD9 // Undocumented
> > +#define ATC2603C_BIST_START			0x0A // Undocumented
> > +#define ATC2603C_BIST_RESULT			0x0B // Undocumented
> > +#define ATC2603C_CHIP_VER			0xDC
> > +
> > +/* TWSI Registers */
> > +#define ATC2603C_SADDR				0xFF
> > +
> > +/* PMU_SYS_CTL0 Register Mask Bits */
> > +#define ATC2603C_PMU_SYS_CTL0_IR_WK_EN			BIT(5)
> > +#define ATC2603C_PMU_SYS_CTL0_RESET_WK_EN		BIT(6)
> > +#define ATC2603C_PMU_SYS_CTL0_HDSW_WK_EN		BIT(7)
> > +#define ATC2603C_PMU_SYS_CTL0_ALARM_WK_EN		BIT(8)
> > +#define ATC2603C_PMU_SYS_CTL0_REM_CON_WK_EN		BIT(9)
> > +#define ATC2603C_PMU_SYS_CTL0_RESTART_EN		BIT(10)
> > +#define ATC2603C_PMU_SYS_CTL0_SGPIOIRQ_WK_EN		BIT(11)
> > +#define ATC2603C_PMU_SYS_CTL0_ONOFF_SHORT_WK_EN		BIT(12)
> > +#define ATC2603C_PMU_SYS_CTL0_ONOFF_LONG_WK_EN		BIT(13)
> > +#define ATC2603C_PMU_SYS_CTL0_WALL_WK_EN		BIT(14)
> > +#define ATC2603C_PMU_SYS_CTL0_USB_WK_EN			BIT(15)
> > +#define ATC2603C_PMU_SYS_CTL0_WK_ALL			(GENMASK(15, 5) & (~BIT(10)))
> > +
> > +/* PMU_SYS_CTL1 Register Mask Bits */
> > +#define ATC2603C_PMU_SYS_CTL1_EN_S1			BIT(0)
> > +#define ATC2603C_PMU_SYS_CTL1_LB_S4_EN			BIT(2)
> > +#define ATC2603C_PMU_SYS_CTL1_LB_S4			GENMASK(4, 3)
> > +#define ATC2603C_PMU_SYS_CTL1_LB_S4_3_1V		BIT(4)
> > +#define ATC2603C_PMU_SYS_CTL1_IR_WK_FLAG		BIT(5)
> > +#define ATC2603C_PMU_SYS_CTL1_RESET_WK_FLAG		BIT(6)
> > +#define ATC2603C_PMU_SYS_CTL1_HDSW_WK_FLAG		BIT(7)
> > +#define ATC2603C_PMU_SYS_CTL1_ALARM_WK_FLAG		BIT(8)
> > +#define ATC2603C_PMU_SYS_CTL1_REM_CON_WK_FLAG		BIT(9)
> > +#define ATC2603C_PMU_SYS_CTL1_ONOFF_PRESS_RESET_IRQ_PD	BIT(10)
> > +#define ATC2603C_PMU_SYS_CTL1_SGPIOIRQ_WK_FLAG		BIT(11)
> > +#define ATC2603C_PMU_SYS_CTL1_ONOFF_SHORT_WK_FLAG	BIT(12)
> > +#define ATC2603C_PMU_SYS_CTL1_ONOFF_LONG_WK_FLAG	BIT(13)
> > +#define ATC2603C_PMU_SYS_CTL1_WALL_WK_FLAG		BIT(14)
> > +#define ATC2603C_PMU_SYS_CTL1_USB_WK_FLAG		BIT(15)
> > +
> > +/* PMU_SYS_CTL2 Register Mask Bits */
> > +#define ATC2603C_PMU_SYS_CTL2_PMU_A_EN			BIT(0)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_INT_EN	BIT(1)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_PD		BIT(2)
> > +#define ATC2603C_PMU_SYS_CTL2_S2TIMER			GENMASK(5, 3)
> > +#define ATC2603C_PMU_SYS_CTL2_S2_TIMER_EN		BIT(6)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_RESET_TIME_SEL	GENMASK(8, 7)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_RESET_EN	BIT(9)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS_TIME		GENMASK(11, 10)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_INT_EN		BIT(12)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_LONG_PRESS		BIT(13)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_SHORT_PRESS		BIT(14)
> > +#define ATC2603C_PMU_SYS_CTL2_ONOFF_PRESS		BIT(15)
> > +
> > +/* PMU_SYS_CTL3 Register Mask Bits */
> > +#define ATC2603C_PMU_SYS_CTL3_S2S3TOS1_TIMER		GENMASK(8, 7)
> > +#define ATC2603C_PMU_SYS_CTL3_S2S3TOS1_TIMER_EN		BIT(9)
> > +#define ATC2603C_PMU_SYS_CTL3_S3_TIMER			GENMASK(12, 10)
> > +#define ATC2603C_PMU_SYS_CTL3_S3_TIMER_EN		BIT(13)
> > +#define ATC2603C_PMU_SYS_CTL3_EN_S3			BIT(14)
> > +#define ATC2603C_PMU_SYS_CTL3_EN_S2			BIT(15)
> > +
> > +/* PMU_SYS_CTL5 Register Mask Bits */
> > +#define ATC2603C_PMU_SYS_CTL5_WALLWKDTEN		BIT(7)
> > +#define ATC2603C_PMU_SYS_CTL5_VBUSWKDTEN		BIT(8)
> > +#define ATC2603C_PMU_SYS_CTL5_REMCON_DECT_EN		BIT(9)
> > +#define ATC2603C_PMU_SYS_CTL5_ONOFF_8S_SEL		BIT(10)
> > +
> > +/* INTS_MSK Register Mask Bits */
> > +#define ATC2603C_INTS_MSK_AUDIO				BIT(0)
> > +#define ATC2603C_INTS_MSK_OV				BIT(1)
> > +#define ATC2603C_INTS_MSK_OC				BIT(2)
> > +#define ATC2603C_INTS_MSK_OT				BIT(3)
> > +#define ATC2603C_INTS_MSK_UV				BIT(4)
> > +#define ATC2603C_INTS_MSK_ALARM				BIT(5)
> > +#define ATC2603C_INTS_MSK_ONOFF				BIT(6)
> > +#define ATC2603C_INTS_MSK_SGPIO				BIT(7)
> > +#define ATC2603C_INTS_MSK_IR				BIT(8)
> > +#define ATC2603C_INTS_MSK_REMCON			BIT(9)
> > +#define ATC2603C_INTS_MSK_POWERIN			BIT(10)
> > +
> > +/* CMU_DEVRST Register Mask Bits */
> > +#define ATC2603C_CMU_DEVRST_MFP				BIT(1)
> > +#define ATC2603C_CMU_DEVRST_INTS			BIT(2)
> > +#define ATC2603C_CMU_DEVRST_AUDIO			BIT(4)
> > +
> > +/* PAD_EN Register Mask Bits */
> > +#define ATC2603C_PAD_EN_EXTIRQ				BIT(0)
> > +
> > +#endif /* __LINUX_MFD_ATC260X_ATC2603C_H */
> > diff --git a/include/linux/mfd/atc260x/atc2609a.h b/include/linux/mfd/atc260x/atc2609a.h
> > new file mode 100644
> > index 000000000000..b957d7bd73e9
> > --- /dev/null
> > +++ b/include/linux/mfd/atc260x/atc2609a.h
> > @@ -0,0 +1,308 @@
> > +/* SPDX-License-Identifier: GPL-2.0+ */
> > +/*
> > + * ATC2609A PMIC register definitions
> > + *
> > + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> > + */
> > +
> > +#ifndef __LINUX_MFD_ATC260X_ATC2609A_H
> > +#define __LINUX_MFD_ATC260X_ATC2609A_H
> > +
> > +enum atc2609a_irq_def {
> > +	ATC2609A_IRQ_AUDIO = 0,
> > +	ATC2609A_IRQ_OV,
> > +	ATC2609A_IRQ_OC,
> > +	ATC2609A_IRQ_OT,
> > +	ATC2609A_IRQ_UV,
> > +	ATC2609A_IRQ_ALARM,
> > +	ATC2609A_IRQ_ONOFF,
> > +	ATC2609A_IRQ_WKUP,
> > +	ATC2609A_IRQ_IR,
> > +	ATC2609A_IRQ_REMCON,
> > +	ATC2609A_IRQ_POWER_IN,
> > +};
> > +
> > +/* PMU Registers */
> > +#define ATC2609A_PMU_SYS_CTL0			0x00
> > +#define ATC2609A_PMU_SYS_CTL1			0x01
> > +#define ATC2609A_PMU_SYS_CTL2			0x02
> > +#define ATC2609A_PMU_SYS_CTL3			0x03
> > +#define ATC2609A_PMU_SYS_CTL4			0x04
> > +#define ATC2609A_PMU_SYS_CTL5			0x05
> > +#define ATC2609A_PMU_SYS_CTL6			0x06
> > +#define ATC2609A_PMU_SYS_CTL7			0x07
> > +#define ATC2609A_PMU_SYS_CTL8			0x08
> > +#define ATC2609A_PMU_SYS_CTL9			0x09
> > +#define ATC2609A_PMU_BAT_CTL0			0x0A
> > +#define ATC2609A_PMU_BAT_CTL1			0x0B
> > +#define ATC2609A_PMU_VBUS_CTL0			0x0C
> > +#define ATC2609A_PMU_VBUS_CTL1			0x0D
> > +#define ATC2609A_PMU_WALL_CTL0			0x0E
> > +#define ATC2609A_PMU_WALL_CTL1			0x0F
> > +#define ATC2609A_PMU_SYS_PENDING		0x10
> > +#define ATC2609A_PMU_APDS_CTL0			0x11
> > +#define ATC2609A_PMU_APDS_CTL1			0x12
> > +#define ATC2609A_PMU_APDS_CTL2			0x13
> > +#define ATC2609A_PMU_CHARGER_CTL		0x14
> > +#define ATC2609A_PMU_BAKCHARGER_CTL		0x15
> > +#define ATC2609A_PMU_SWCHG_CTL0			0x16
> > +#define ATC2609A_PMU_SWCHG_CTL1			0x17
> > +#define ATC2609A_PMU_SWCHG_CTL2			0x18
> > +#define ATC2609A_PMU_SWCHG_CTL3			0x19
> > +#define ATC2609A_PMU_SWCHG_CTL4			0x1A
> > +#define ATC2609A_PMU_DC_OSC			0x1B
> > +#define ATC2609A_PMU_DC0_CTL0			0x1C
> > +#define ATC2609A_PMU_DC0_CTL1			0x1D
> > +#define ATC2609A_PMU_DC0_CTL2			0x1E
> > +#define ATC2609A_PMU_DC0_CTL3			0x1F
> > +#define ATC2609A_PMU_DC0_CTL4			0x20
> > +#define ATC2609A_PMU_DC0_CTL5			0x21
> > +#define ATC2609A_PMU_DC0_CTL6			0x22
> > +#define ATC2609A_PMU_DC1_CTL0			0x23
> > +#define ATC2609A_PMU_DC1_CTL1			0x24
> > +#define ATC2609A_PMU_DC1_CTL2			0x25
> > +#define ATC2609A_PMU_DC1_CTL3			0x26
> > +#define ATC2609A_PMU_DC1_CTL4			0x27
> > +#define ATC2609A_PMU_DC1_CTL5			0x28
> > +#define ATC2609A_PMU_DC1_CTL6			0x29
> > +#define ATC2609A_PMU_DC2_CTL0			0x2A
> > +#define ATC2609A_PMU_DC2_CTL1			0x2B
> > +#define ATC2609A_PMU_DC2_CTL2			0x2C
> > +#define ATC2609A_PMU_DC2_CTL3			0x2D
> > +#define ATC2609A_PMU_DC2_CTL4			0x2E
> > +#define ATC2609A_PMU_DC2_CTL5			0x2F
> > +#define ATC2609A_PMU_DC2_CTL6			0x30
> > +#define ATC2609A_PMU_DC3_CTL0			0x31
> > +#define ATC2609A_PMU_DC3_CTL1			0x32
> > +#define ATC2609A_PMU_DC3_CTL2			0x33
> > +#define ATC2609A_PMU_DC3_CTL3			0x34
> > +#define ATC2609A_PMU_DC3_CTL4			0x35
> > +#define ATC2609A_PMU_DC3_CTL5			0x36
> > +#define ATC2609A_PMU_DC3_CTL6			0x37
> > +#define ATC2609A_PMU_DC_ZR			0x38
> > +#define ATC2609A_PMU_LDO0_CTL0			0x39
> > +#define ATC2609A_PMU_LDO0_CTL1			0x3A
> > +#define ATC2609A_PMU_LDO1_CTL0			0x3B
> > +#define ATC2609A_PMU_LDO1_CTL1			0x3C
> > +#define ATC2609A_PMU_LDO2_CTL0			0x3D
> > +#define ATC2609A_PMU_LDO2_CTL1			0x3E
> > +#define ATC2609A_PMU_LDO3_CTL0			0x3F
> > +#define ATC2609A_PMU_LDO3_CTL1			0x40
> > +#define ATC2609A_PMU_LDO4_CTL0			0x41
> > +#define ATC2609A_PMU_LDO4_CTL1			0x42
> > +#define ATC2609A_PMU_LDO5_CTL0			0x43
> > +#define ATC2609A_PMU_LDO5_CTL1			0x44
> > +#define ATC2609A_PMU_LDO6_CTL0			0x45
> > +#define ATC2609A_PMU_LDO6_CTL1			0x46
> > +#define ATC2609A_PMU_LDO7_CTL0			0x47
> > +#define ATC2609A_PMU_LDO7_CTL1			0x48
> > +#define ATC2609A_PMU_LDO8_CTL0			0x49
> > +#define ATC2609A_PMU_LDO8_CTL1			0x4A
> > +#define ATC2609A_PMU_LDO9_CTL			0x4B
> > +#define ATC2609A_PMU_OV_INT_EN			0x4C
> > +#define ATC2609A_PMU_OV_STATUS			0x4D
> > +#define ATC2609A_PMU_UV_INT_EN			0x4E
> > +#define ATC2609A_PMU_UV_STATUS			0x4F
> > +#define ATC2609A_PMU_OC_INT_EN			0x50
> > +#define ATC2609A_PMU_OC_STATUS			0x51
> > +#define ATC2609A_PMU_OT_CTL			0x52
> > +#define ATC2609A_PMU_CM_CTL0			0x53
> > +#define ATC2609A_PMU_FW_USE0			0x54
> > +#define ATC2609A_PMU_FW_USE1			0x55
> > +#define ATC2609A_PMU_ADC12B_I			0x56
> > +#define ATC2609A_PMU_ADC12B_V			0x57
> > +#define ATC2609A_PMU_ADC12B_DUMMY		0x58
> > +#define ATC2609A_PMU_AUXADC_CTL0		0x59
> > +#define ATC2609A_PMU_AUXADC_CTL1		0x5A
> > +#define ATC2609A_PMU_BATVADC			0x5B
> > +#define ATC2609A_PMU_BATIADC			0x5C
> > +#define ATC2609A_PMU_WALLVADC			0x5D
> > +#define ATC2609A_PMU_WALLIADC			0x5E
> > +#define ATC2609A_PMU_VBUSVADC			0x5F
> > +#define ATC2609A_PMU_VBUSIADC			0x60
> > +#define ATC2609A_PMU_SYSPWRADC			0x61
> > +#define ATC2609A_PMU_REMCONADC			0x62
> > +#define ATC2609A_PMU_SVCCADC			0x63
> > +#define ATC2609A_PMU_CHGIADC			0x64
> > +#define ATC2609A_PMU_IREFADC			0x65
> > +#define ATC2609A_PMU_BAKBATADC			0x66
> > +#define ATC2609A_PMU_ICTEMPADC			0x67
> > +#define ATC2609A_PMU_AUXADC0			0x68
> > +#define ATC2609A_PMU_AUXADC1			0x69
> > +#define ATC2609A_PMU_AUXADC2			0x6A
> > +#define ATC2609A_PMU_AUXADC3			0x6B
> > +#define ATC2609A_PMU_ICTEMPADC_ADJ		0x6C
> > +#define ATC2609A_PMU_BDG_CTL			0x6D
> > +#define ATC2609A_RTC_CTL			0x6E
> > +#define ATC2609A_RTC_MSALM			0x6F
> > +#define ATC2609A_RTC_HALM			0x70
> > +#define ATC2609A_RTC_YMDALM			0x71
> > +#define ATC2609A_RTC_MS				0x72
> > +#define ATC2609A_RTC_H				0x73
> > +#define ATC2609A_RTC_DC				0x74
> > +#define ATC2609A_RTC_YMD			0x75
> > +#define ATC2609A_EFUSE_DAT			0x76
> > +#define ATC2609A_EFUSECRTL1			0x77
> > +#define ATC2609A_EFUSECRTL2			0x78
> > +#define ATC2609A_PMU_DC4_CTL0			0x79
> > +#define ATC2609A_PMU_DC4_CTL1			0x7A
> > +#define ATC2609A_PMU_DC4_CTL2			0x7B
> > +#define ATC2609A_PMU_DC4_CTL3			0x7C
> > +#define ATC2609A_PMU_DC4_CTL4			0x7D
> > +#define ATC2609A_PMU_DC4_CTL5			0x7E
> > +#define ATC2609A_PMU_DC4_CTL6			0x7F
> > +#define ATC2609A_PMU_PWR_STATUS			0x80
> > +#define ATC2609A_PMU_S2_PWR			0x81
> > +#define ATC2609A_CLMT_CTL0			0x82
> > +#define ATC2609A_CLMT_DATA0			0x83
> > +#define ATC2609A_CLMT_DATA1			0x84
> > +#define ATC2609A_CLMT_DATA2			0x85
> > +#define ATC2609A_CLMT_DATA3			0x86
> > +#define ATC2609A_CLMT_ADD0			0x87
> > +#define ATC2609A_CLMT_ADD1			0x88
> > +#define ATC2609A_CLMT_OCV_TABLE			0x89
> > +#define ATC2609A_CLMT_R_TABLE			0x8A
> > +#define ATC2609A_PMU_PWRON_CTL0			0x8D
> > +#define ATC2609A_PMU_PWRON_CTL1			0x8E
> > +#define ATC2609A_PMU_PWRON_CTL2			0x8F
> > +#define ATC2609A_IRC_CTL			0x90
> > +#define ATC2609A_IRC_STAT			0x91
> > +#define ATC2609A_IRC_CC				0x92
> > +#define ATC2609A_IRC_KDC			0x93
> > +#define ATC2609A_IRC_WK				0x94
> > +#define ATC2609A_IRC_RCC			0x95
> > +
> > +/* AUDIO_OUT Registers */
> > +#define ATC2609A_AUDIOINOUT_CTL			0xA0
> > +#define ATC2609A_AUDIO_DEBUGOUTCTL		0xA1
> > +#define ATC2609A_DAC_DIGITALCTL			0xA2
> > +#define ATC2609A_DAC_VOLUMECTL0			0xA3
> > +#define ATC2609A_DAC_ANALOG0			0xA4
> > +#define ATC2609A_DAC_ANALOG1			0xA5
> > +#define ATC2609A_DAC_ANALOG2			0xA6
> > +#define ATC2609A_DAC_ANALOG3			0xA7
> > +
> > +/* AUDIO_IN Registers */
> > +#define ATC2609A_ADC_DIGITALCTL			0xA8
> > +#define ATC2609A_ADC_HPFCTL			0xA9
> > +#define ATC2609A_ADC_CTL			0xAA
> > +#define ATC2609A_AGC_CTL0			0xAB
> > +#define ATC2609A_AGC_CTL1			0xAC
> > +#define ATC2609A_AGC_CTL2			0xAD
> > +#define ATC2609A_ADC_ANALOG0			0xAE
> > +#define ATC2609A_ADC_ANALOG1			0xAF
> > +
> > +/* PCM_IF Registers */
> > +#define ATC2609A_PCM0_CTL			0xB0
> > +#define ATC2609A_PCM1_CTL			0xB1
> > +#define ATC2609A_PCM2_CTL			0xB2
> > +#define ATC2609A_PCMIF_CTL			0xB3
> > +
> > +/* CMU_CONTROL Registers */
> > +#define ATC2609A_CMU_DEVRST			0xC1
> > +
> > +/* INTS Registers */
> > +#define ATC2609A_INTS_PD			0xC8
> > +#define ATC2609A_INTS_MSK			0xC9
> > +
> > +/* MFP Registers */
> > +#define ATC2609A_MFP_CTL			0xD0
> > +#define ATC2609A_PAD_VSEL			0xD1
> > +#define ATC2609A_GPIO_OUTEN			0xD2
> > +#define ATC2609A_GPIO_INEN			0xD3
> > +#define ATC2609A_GPIO_DAT			0xD4
> > +#define ATC2609A_PAD_DRV			0xD5
> > +#define ATC2609A_PAD_EN				0xD6
> > +#define ATC2609A_DEBUG_SEL			0xD7
> > +#define ATC2609A_DEBUG_IE			0xD8
> > +#define ATC2609A_DEBUG_OE			0xD9
> > +#define ATC2609A_CHIP_VER			0xDC
> > +
> > +/* PWSI Registers */
> > +#define ATC2609A_PWSI_CTL			0xF0
> > +#define ATC2609A_PWSI_STATUS			0xF1
> > +
> > +/* TWSI Registers */
> > +#define ATC2609A_SADDR				0xFF
> > +
> > +/* PMU_SYS_CTL0 Register Mask Bits */
> > +#define ATC2609A_PMU_SYS_CTL0_IR_WK_EN			BIT(5)
> > +#define ATC2609A_PMU_SYS_CTL0_RESET_WK_EN		BIT(6)
> > +#define ATC2609A_PMU_SYS_CTL0_HDSW_WK_EN		BIT(7)
> > +#define ATC2609A_PMU_SYS_CTL0_ALARM_WK_EN		BIT(8)
> > +#define ATC2609A_PMU_SYS_CTL0_REM_CON_WK_EN		BIT(9)
> > +#define ATC2609A_PMU_SYS_CTL0_RESTART_EN		BIT(10)
> > +#define ATC2609A_PMU_SYS_CTL0_WKIRQ_WK_EN		BIT(11)
> > +#define ATC2609A_PMU_SYS_CTL0_ONOFF_SHORT_WK_EN		BIT(12)
> > +#define ATC2609A_PMU_SYS_CTL0_ONOFF_LONG_WK_EN		BIT(13)
> > +#define ATC2609A_PMU_SYS_CTL0_WALL_WK_EN		BIT(14)
> > +#define ATC2609A_PMU_SYS_CTL0_USB_WK_EN			BIT(15)
> > +#define ATC2609A_PMU_SYS_CTL0_WK_ALL			(GENMASK(15, 5) & (~BIT(10)))
> > +
> > +/* PMU_SYS_CTL1 Register Mask Bits */
> > +#define ATC2609A_PMU_SYS_CTL1_EN_S1			BIT(0)
> > +#define ATC2609A_PMU_SYS_CTL1_LB_S4_EN			BIT(2)
> > +#define ATC2609A_PMU_SYS_CTL1_LB_S4			GENMASK(4, 3)
> > +#define ATC2609A_PMU_SYS_CTL1_LB_S4_3_1V		BIT(4)
> > +#define ATC2609A_PMU_SYS_CTL1_IR_WK_FLAG		BIT(5)
> > +#define ATC2609A_PMU_SYS_CTL1_RESET_WK_FLAG		BIT(6)
> > +#define ATC2609A_PMU_SYS_CTL1_HDSW_WK_FLAG		BIT(7)
> > +#define ATC2609A_PMU_SYS_CTL1_ALARM_WK_FLAG		BIT(8)
> > +#define ATC2609A_PMU_SYS_CTL1_REM_CON_WK_FLAG		BIT(9)
> > +#define ATC2609A_PMU_SYS_CTL1_RESTART_WK_FLAG		BIT(10)
> > +#define ATC2609A_PMU_SYS_CTL1_WKIRQ_WK_FLAG		BIT(11)
> > +#define ATC2609A_PMU_SYS_CTL1_ONOFF_SHORT_WK_FLAG	BIT(12)
> > +#define ATC2609A_PMU_SYS_CTL1_ONOFF_LONG_WK_FLAG	BIT(13)
> > +#define ATC2609A_PMU_SYS_CTL1_WALL_WK_FLAG		BIT(14)
> > +#define ATC2609A_PMU_SYS_CTL1_USB_WK_FLAG		BIT(15)
> > +
> > +/* PMU_SYS_CTL2 Register Mask Bits */
> > +#define ATC2609A_PMU_SYS_CTL2_PMU_A_EN			BIT(0)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS_INT_EN	BIT(1)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS_PD		BIT(2)
> > +#define ATC2609A_PMU_SYS_CTL2_S2TIMER			GENMASK(5, 3)
> > +#define ATC2609A_PMU_SYS_CTL2_S2_TIMER_EN		BIT(6)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_RESET_TIME_SEL	GENMASK(8, 7)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_RESET_EN		BIT(9)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS_TIME		GENMASK(11, 10)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_LSP_INT_EN		BIT(12)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_LONG_PRESS		BIT(13)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_SHORT_PRESS		BIT(14)
> > +#define ATC2609A_PMU_SYS_CTL2_ONOFF_PRESS		BIT(15)
> > +
> > +/* PMU_SYS_CTL3 Register Mask Bits */
> > +#define ATC2609A_PMU_SYS_CTL3_S2S3TOS1_TIMER		GENMASK(8, 7)
> > +#define ATC2609A_PMU_SYS_CTL3_S2S3TOS1_TIMER_EN		BIT(9)
> > +#define ATC2609A_PMU_SYS_CTL3_S3_TIMER			GENMASK(12, 10)
> > +#define ATC2609A_PMU_SYS_CTL3_S3_TIMER_EN		BIT(13)
> > +#define ATC2609A_PMU_SYS_CTL3_EN_S3			BIT(14)
> > +#define ATC2609A_PMU_SYS_CTL3_EN_S2			BIT(15)
> > +
> > +/* PMU_SYS_CTL5 Register Mask Bits */
> > +#define ATC2609A_PMU_SYS_CTL5_WALLWKDTEN		BIT(7)
> > +#define ATC2609A_PMU_SYS_CTL5_VBUSWKDTEN		BIT(8)
> > +#define ATC2609A_PMU_SYS_CTL5_REMCON_DECT_EN		BIT(9)
> > +#define ATC2609A_PMU_SYS_CTL5_ONOFF_8S_SEL		BIT(10)
> > +
> > +/* INTS_MSK Register Mask Bits */
> > +#define ATC2609A_INTS_MSK_AUDIO				BIT(0)
> > +#define ATC2609A_INTS_MSK_OV				BIT(1)
> > +#define ATC2609A_INTS_MSK_OC				BIT(2)
> > +#define ATC2609A_INTS_MSK_OT				BIT(3)
> > +#define ATC2609A_INTS_MSK_UV				BIT(4)
> > +#define ATC2609A_INTS_MSK_ALARM				BIT(5)
> > +#define ATC2609A_INTS_MSK_ONOFF				BIT(6)
> > +#define ATC2609A_INTS_MSK_WKUP				BIT(7)
> > +#define ATC2609A_INTS_MSK_IR				BIT(8)
> > +#define ATC2609A_INTS_MSK_REMCON			BIT(9)
> > +#define ATC2609A_INTS_MSK_POWERIN			BIT(10)
> > +
> > +/* CMU_DEVRST Register Mask Bits */
> > +#define ATC2609A_CMU_DEVRST_AUDIO			BIT(0)
> > +#define ATC2609A_CMU_DEVRST_MFP				BIT(1)
> > +#define ATC2609A_CMU_DEVRST_INTS			BIT(2)
> > +
> > +/* PAD_EN Register Mask Bits */
> > +#define ATC2609A_PAD_EN_EXTIRQ				BIT(0)
> > +
> > +#endif /* __LINUX_MFD_ATC260X_ATC2609A_H */
> > diff --git a/include/linux/mfd/atc260x/core.h b/include/linux/mfd/atc260x/core.h
> > new file mode 100644
> > index 000000000000..a87b976f48e3
> > --- /dev/null
> > +++ b/include/linux/mfd/atc260x/core.h
> > @@ -0,0 +1,86 @@
> > +/* SPDX-License-Identifier: GPL-2.0+ */
> > +/*
> > + * Core MFD defines for ATC260x PMICs
> > + *
> > + * Copyright (C) 2019 Manivannan Sadhasivam <manivannan.sadhasivam@linaro.org>
> > + * Copyright (C) 2020 Cristian Ciocaltea <cristian.ciocaltea@gmail.com>
> > + */
> > +
> > +#ifndef __LINUX_MFD_ATC260X_CORE_H
> > +#define __LINUX_MFD_ATC260X_CORE_H
> > +
> > +#include <linux/mfd/atc260x/atc2603c.h>
> > +#include <linux/mfd/atc260x/atc2609a.h>
> > +
> > +enum atc260x_type {
> > +	ATC2603A = 0,
> > +	ATC2603C,
> > +	ATC2609A,
> > +};
> > +
> > +enum atc260x_ver {
> > +	ATC260X_A = 0,
> > +	ATC260X_B,
> > +	ATC260X_C,
> > +	ATC260X_D,
> > +	ATC260X_E,
> > +	ATC260X_F,
> > +	ATC260X_G,
> > +	ATC260X_H,
> > +};
> > +
> > +struct atc260x {
> > +	struct device *dev;
> > +
> > +	struct regmap *regmap;
> > +	const struct regmap_irq_chip *regmap_irq_chip;
> > +	struct regmap_irq_chip_data *irq_data;
> > +
> > +	struct mutex *regmap_mutex;	/* mutex for custom regmap locking */
> > +
> > +	const struct mfd_cell *cells;
> > +	int nr_cells;
> > +	int irq;
> > +
> > +	enum atc260x_type ic_type;
> > +	enum atc260x_ver ic_ver;
> > +	const char *type_name;
> > +	unsigned int rev_reg;
> > +
> > +	int (*dev_init)(struct atc260x *atc260x);
> > +};
> > +
> > +struct regmap_config;
> > +
> > +/**
> > + * atc260x_match_device(): Setup atc260x variant related fields
> > + *
> > + * @atc260x: atc260x device to setup (.dev field must be set)
> > + * @regmap_cfg: regmap config associated with this atc260x device
> > + *
> > + * This lets the atc260x core configure the mfd cells and register maps
> 
> Please capitalise abbreviations and model names:
> 
> "MFD"
> "ATC260x"
> "IRQChip"
> "IRQ"

Done.

> > + * for later use.
> > + */
> > +int atc260x_match_device(struct atc260x *atc260x, struct regmap_config *regmap_cfg);
> > +
> > +/**
> > + * atc260x_device_probe(): Probe a configured atc260x device
> > + *
> > + * @atc260x: atc260x device to probe (must be configured)
> > + *
> > + * This function lets the atc260x core register the atc260x mfd devices
> > + * and irqchip. The atc260x device passed in must be fully configured
> > + * with atc260x_match_device, its irq set, and regmap created.
> > + */
> > +int atc260x_device_probe(struct atc260x *atc260x);
> > +
> > +/**
> > + * atc260x_device_remove(): Remove a atc260x device
> 
> "an"

This function is not needed anymore, so I dropped it.

> > + *
> > + * @atc260x: atc260x device to remove
> > + *
> > + * This tells the atc260x core to remove the associated mfd devices
> > + */
> > +int atc260x_device_remove(struct atc260x *atc260x);
> 
> Not sure I've seen kerneldoc used on prototypes before.
> 
> Probably better to move them onto the real functions.

Done.

> > +#endif /* __LINUX_MFD_ATC260X_CORE_H */
> 
> -- 
> Lee Jones [李琼斯]
> Senior Technical Lead - Developer Services
> Linaro.org │ Open source software for Arm SoCs
> Follow Linaro: Facebook | Twitter | Blog

On Fri, 18 Dec 2020, Cristian Ciocaltea wrote:

> Hi Lee,
> 
> Thank you for the detailed review!
> 
> I will prepare a new revision, but there are still a couple of open
> points..

Could you please snip your replies, leaving only the open points.

Scrolling through lots of empty quotes or "done" comments is quite
time consuming.  Thanks.

[...]

> > > +	/*
> > > +	 * Using regmap within an atomic context (e.g. accessing a PMIC when
> > > +	 * powering system down) is normally allowed only if the regmap type
> > > +	 * is MMIO and the regcache type is either REGCACHE_NONE or
> > > +	 * REGCACHE_FLAT. For slow buses like I2C and SPI, the regmap is
> > > +	 * internally protected by a mutex which is acquired non-atomically.
> > > +	 *
> > > +	 * Let's improve this by using a customized locking scheme inspired
> > > +	 * from I2C atomic transfer. See i2c_in_atomic_xfer_mode() for a
> > > +	 * starting point.
> > > +	 */
> > > +	if (system_state > SYSTEM_RUNNING && irqs_disabled())
> > 
> > Were does system_state come from?
> 
> It is declared in 'include/linux/kernel.h':
> 
> extern enum system_states {
> 	SYSTEM_BOOTING,
> 	SYSTEM_SCHEDULING,
> 	SYSTEM_RUNNING,
> 	SYSTEM_HALT,
> 	SYSTEM_POWER_OFF,
> 	SYSTEM_RESTART,
> 	SYSTEM_SUSPEND,
> } system_state;
> 
> The definition is in 'init/main.c':
> 
> enum system_states system_state __read_mostly;
> EXPORT_SYMBOL(system_state);

Ah, it's a system wide thing.  No problem.

[...]

> > > +	ret = regmap_read(atc260x->regmap, atc260x->rev_reg, &chip_rev);
> > > +	if (ret) {
> > > +		dev_err(dev, "Failed to get chip revision\n");
> > > +		return ret;
> > > +	}
> > > +
> > > +	if (chip_rev < 0 || chip_rev > 31) {
> > > +		dev_err(dev, "Unknown chip revision: %d\n", ret);
> > > +		return -EINVAL;
> > > +	}
> > 
> > This still seems limiting.
> 
> This is based on the vendor implementation. Unfortunately I don't have
> access to a data sheet or any other source of information about the
> management of the chip revisions.

So which versions does this driver work with?  All 32?

[...]

> > > +const struct of_device_id atc260x_i2c_of_match[] = {
> > > +	{ .compatible = "actions,atc2603c", .data = (void *)ATC2603C },
> > > +	{ .compatible = "actions,atc2609a", .data = (void *)ATC2609A },
> > > +	{ /* sentinel */ }
> > 
> > I think you can drop the (void *) casts.
> 
> Without the cast, I get the following compiler warning:
> 
> drivers/mfd/atc260x-i2c.c:46:46: warning: initialization of ‘const void *’
> from ‘int’ makes pointer from integer without a cast [-Wint-conversion]
>   { .compatible = "actions,atc2603c", .data = ATC2603C },

Perhaps I'm getting confused with addresses of things.  Never mind.

On Fri, Dec 18, 2020 at 01:21:39PM +0000, Lee Jones wrote:
> On Fri, 18 Dec 2020, Cristian Ciocaltea wrote:
> 
> > Hi Lee,
> > 
> > Thank you for the detailed review!
> > 
> > I will prepare a new revision, but there are still a couple of open
> > points..
> 
> Could you please snip your replies, leaving only the open points.
> 
> Scrolling through lots of empty quotes or "done" comments is quite
> time consuming.  Thanks.

Sure, I'll take that into account.

> [...]
> 
> > > > +	ret = regmap_read(atc260x->regmap, atc260x->rev_reg, &chip_rev);
> > > > +	if (ret) {
> > > > +		dev_err(dev, "Failed to get chip revision\n");
> > > > +		return ret;
> > > > +	}
> > > > +
> > > > +	if (chip_rev < 0 || chip_rev > 31) {
> > > > +		dev_err(dev, "Unknown chip revision: %d\n", ret);
> > > > +		return -EINVAL;
> > > > +	}
> > > 
> > > This still seems limiting.
> > 
> > This is based on the vendor implementation. Unfortunately I don't have
> > access to a data sheet or any other source of information about the
> > management of the chip revisions.
> 
> So which versions does this driver work with?  All 32?

I'm not even sure there are so many revisions, I guess that's just a
rough validation for a vendor reserved range.

For the moment, the only place where the functionality is affected
by the chip revision is in the regulator driver - there is a special
handling for the ATC2603C rev.B chip variant.

I expect some additional handling might be required for new drivers
bringing support for the other functions provided by the hardware.

> [...]

Thanks,
Cristi

On Fri, 18 Dec 2020, Cristian Ciocaltea wrote:

> On Fri, Dec 18, 2020 at 01:21:39PM +0000, Lee Jones wrote:
> > On Fri, 18 Dec 2020, Cristian Ciocaltea wrote:
> > 
> > > Hi Lee,
> > > 
> > > Thank you for the detailed review!
> > > 
> > > I will prepare a new revision, but there are still a couple of open
> > > points..
> > 
> > Could you please snip your replies, leaving only the open points.
> > 
> > Scrolling through lots of empty quotes or "done" comments is quite
> > time consuming.  Thanks.
> 
> Sure, I'll take that into account.
> 
> > [...]
> > 
> > > > > +	ret = regmap_read(atc260x->regmap, atc260x->rev_reg, &chip_rev);
> > > > > +	if (ret) {
> > > > > +		dev_err(dev, "Failed to get chip revision\n");
> > > > > +		return ret;
> > > > > +	}
> > > > > +
> > > > > +	if (chip_rev < 0 || chip_rev > 31) {
> > > > > +		dev_err(dev, "Unknown chip revision: %d\n", ret);
> > > > > +		return -EINVAL;
> > > > > +	}
> > > > 
> > > > This still seems limiting.
> > > 
> > > This is based on the vendor implementation. Unfortunately I don't have
> > > access to a data sheet or any other source of information about the
> > > management of the chip revisions.
> > 
> > So which versions does this driver work with?  All 32?
> 
> I'm not even sure there are so many revisions, I guess that's just a
> rough validation for a vendor reserved range.
> 
> For the moment, the only place where the functionality is affected
> by the chip revision is in the regulator driver - there is a special
> handling for the ATC2603C rev.B chip variant.
> 
> I expect some additional handling might be required for new drivers
> bringing support for the other functions provided by the hardware.

The current patch seems to insinuate that 32 versions are currently
supported.  What is the chip_rev for the ATC2603C rev.B?

On Mon, Dec 21, 2020 at 08:10:15AM +0000, Lee Jones wrote:
> On Fri, 18 Dec 2020, Cristian Ciocaltea wrote:
> 
> > On Fri, Dec 18, 2020 at 01:21:39PM +0000, Lee Jones wrote:
> > > On Fri, 18 Dec 2020, Cristian Ciocaltea wrote:
> > > 
> > > > Hi Lee,
> > > > 
> > > > Thank you for the detailed review!
> > > > 
> > > > I will prepare a new revision, but there are still a couple of open
> > > > points..
> > > 
> > > Could you please snip your replies, leaving only the open points.
> > > 
> > > Scrolling through lots of empty quotes or "done" comments is quite
> > > time consuming.  Thanks.
> > 
> > Sure, I'll take that into account.
> > 
> > > [...]
> > > 
> > > > > > +	ret = regmap_read(atc260x->regmap, atc260x->rev_reg, &chip_rev);
> > > > > > +	if (ret) {
> > > > > > +		dev_err(dev, "Failed to get chip revision\n");
> > > > > > +		return ret;
> > > > > > +	}
> > > > > > +
> > > > > > +	if (chip_rev < 0 || chip_rev > 31) {
> > > > > > +		dev_err(dev, "Unknown chip revision: %d\n", ret);
> > > > > > +		return -EINVAL;
> > > > > > +	}
> > > > > 
> > > > > This still seems limiting.
> > > > 
> > > > This is based on the vendor implementation. Unfortunately I don't have
> > > > access to a data sheet or any other source of information about the
> > > > management of the chip revisions.
> > > 
> > > So which versions does this driver work with?  All 32?
> > 
> > I'm not even sure there are so many revisions, I guess that's just a
> > rough validation for a vendor reserved range.
> > 
> > For the moment, the only place where the functionality is affected
> > by the chip revision is in the regulator driver - there is a special
> > handling for the ATC2603C rev.B chip variant.
> > 
> > I expect some additional handling might be required for new drivers
> > bringing support for the other functions provided by the hardware.
> 
> The current patch seems to insinuate that 32 versions are currently
> supported.  What is the chip_rev for the ATC2603C rev.B?

I only own the rev.A for the ATC2603C variant, for which I read '0' from
the chip rev register.

However what really matters for the driver is not the raw value, but the
one computed via:

atc260x->ic_ver = __ffs(chip_rev + 1U);

This is basically a translation of the raw value to a chip version
that is used in the context of the special handling mentioned above:

enum atc260x_ver {
	ATC260X_A = 0,
	ATC260X_B,
	ATC260X_C,
	ATC260X_D,
	ATC260X_E,
	ATC260X_F,
	ATC260X_G,
	ATC260X_H,
};

So we actually could handle up to 8 chip versions with the current
management scheme.

> -- 
> Lee Jones [李琼斯]
> Senior Technical Lead - Developer Services
> Linaro.org │ Open source software for Arm SoCs
> Follow Linaro: Facebook | Twitter | Blog

On Mon, Dec 21, 2020 at 12:59 PM Cristian Ciocaltea
<cristian.ciocaltea@gmail.com> wrote:

> enum atc260x_ver {
>         ATC260X_A = 0,
>         ATC260X_B,
>         ATC260X_C,
>         ATC260X_D,
>         ATC260X_E,
>         ATC260X_F,
>         ATC260X_G,
>         ATC260X_H,
> };

This makes it look like the driver is actually so generic that it makes space
for all revisions back to ATC2603A which is in the Ainol Hero 10 tablet.

This is nice because there are millions of these devices (especially in
China) that people want to get to run the latest Linux.

I even wonder how much different the ATM7029 is from S500, I suspect
not super much apart from the ARM cores.

Good work overall! I'll be happy to deal with the GPIO
driver when you get there.

Yours,
Linus Walleij

On Mon, Dec 21, 2020 at 01:18:01PM +0100, Linus Walleij wrote:
> On Mon, Dec 21, 2020 at 12:59 PM Cristian Ciocaltea
> <cristian.ciocaltea@gmail.com> wrote:
> 
> > enum atc260x_ver {
> >         ATC260X_A = 0,
> >         ATC260X_B,
> >         ATC260X_C,
> >         ATC260X_D,
> >         ATC260X_E,
> >         ATC260X_F,
> >         ATC260X_G,
> >         ATC260X_H,
> > };
> 
> This makes it look like the driver is actually so generic that it makes space
> for all revisions back to ATC2603A which is in the Ainol Hero 10 tablet.

For ATC2603A we need an SPI driver, currently only the I2C interface is
supported.

> This is nice because there are millions of these devices (especially in
> China) that people want to get to run the latest Linux.
> 
> I even wonder how much different the ATM7029 is from S500, I suspect
> not super much apart from the ARM cores.

Cannot tell, for the moment I can only "play" with the S500..

> Good work overall! I'll be happy to deal with the GPIO
> driver when you get there.

Great, thanks!

> Yours,
> Linus Walleij