Re: [PATCH v6 1/4] mfd: rt5033: Add Richtek RT5033 driver core.

Beomho Seo
2014-12-02T00:10:38Z

Thank you for advices.
On 12/01/2014 09:39 PM, Lee Jones wrote:
> Sorry for the delay.
>
>> This patch adds a new driver for Richtek RT5033 driver.
>> RT5033 is a Multifunction device which includes battery charger, fuel gauge,
>> flash LED current source, LDO and synchronous Buck converter. It is interfaced
>> to host controller using I2C interface.
>>
>> Cc: Samuel Ortiz <sameo@linux.intel.com>
>> Cc: Lee Jones <lee.jone@linaro.org>
>> Signed-off-by: Beomho Seo <beomho.seo@samsung.com>
>> Acked-by: Chanwoo Choi <cw00.choi@samsung.com>
>> ---
>> Changes in v6
>> - Fix white space issue in mfd cell struct.
>>
>> Changes in v5
>> - Change possible built as a module.
>> - Revise rt5033_dev mfd cell entry.
>> - Fix incorrect typo.
>> - Add module alias.
>>
>> Changes in v4
>> - none.
>>
>> Changes in v3
>> - Correct sentence errors.
>> - Add author information the top of each drivers.
>> - Remove unnecessary pre-initialise, struct member(rt5033->i2c) and blink.
>> - Change some return check.
>> - Use bool and of_match_ptr().
>>
>> Changes in v2
>> - Remove volatile_reg callback. Because this driver not in use regmap cache.
>> - Revmoe unnecessary subnode of_compatible.
>> - Add define for set_high impedance mode of charger.
>>
>> drivers/mfd/Kconfig | 12 ++
>> drivers/mfd/Makefile | 1 +
>> drivers/mfd/rt5033.c | 141 +++++++++++++++++++
>> include/linux/mfd/rt5033-private.h | 260 ++++++++++++++++++++++++++++++++++++
>> include/linux/mfd/rt5033.h | 62 +++++++++
>> 5 files changed, 476 insertions(+)
>> create mode 100644 drivers/mfd/rt5033.c
>> create mode 100644 include/linux/mfd/rt5033-private.h
>> create mode 100644 include/linux/mfd/rt5033.h
>>
>> diff --git a/drivers/mfd/Kconfig b/drivers/mfd/Kconfig
>> index 72d3808..9c13170 100644
>> --- a/drivers/mfd/Kconfig
>> +++ b/drivers/mfd/Kconfig
>> @@ -618,6 +618,18 @@ config MFD_RTSX_PCI
>> types of memory cards, such as Memory Stick, Memory Stick Pro,
>> Secure Digital and MultiMediaCard.
>>
>> +config MFD_RT5033
>> + tristate "Richtek RT5033 Power Management IC"
>> + depends on I2C=y
>> + select MFD_CORE
>> + select REGMAP_I2C
>> + help
>> + This driver provides for the Richtek RT5033 Power Management IC,
>> + which includes the I2C driver and the Core APIs. This driver provides
>> + common support for accessing the device. The device supports multiple
>> + sub-devices like charger, fuel gauge, flash LED, current source,
>> + LDO and Buck.
>> +
>> config MFD_RTSX_USB
>> tristate "Realtek USB card reader"
>> depends on USB
>> diff --git a/drivers/mfd/Makefile b/drivers/mfd/Makefile
>> index 53467e2..4059c24 100644
>> --- a/drivers/mfd/Makefile
>> +++ b/drivers/mfd/Makefile
>> @@ -176,6 +176,7 @@ obj-$(CONFIG_MFD_IPAQ_MICRO) += ipaq-micro.o
>> obj-$(CONFIG_MFD_MENF21BMC) += menf21bmc.o
>> obj-$(CONFIG_MFD_HI6421_PMIC) += hi6421-pmic-core.o
>> obj-$(CONFIG_MFD_DLN2) += dln2.o
>> +obj-$(CONFIG_MFD_RT5033) += rt5033.o
>>
>> intel-soc-pmic-objs := intel_soc_pmic_core.o intel_soc_pmic_crc.o
>> obj-$(CONFIG_INTEL_SOC_PMIC) += intel-soc-pmic.o
>> diff --git a/drivers/mfd/rt5033.c b/drivers/mfd/rt5033.c
>> new file mode 100644
>> index 0000000..e2877c0
>> --- /dev/null
>> +++ b/drivers/mfd/rt5033.c
>> @@ -0,0 +1,141 @@
>> +/*
>> + * MFD core driver for the Richtek RT5033.
>
> Nicer to put a small description of the h/w here.
>

OK. I will put a small description.

>> + * Copyright (C) 2014 Samsung Electronics, Co., Ltd.
>> + * Author: Beomho Seo <beomho.seo@samsung.com>
>> + *
>> + * This program is free software; you can redistribute it and/or modify
>> + * it under the terms of the GNU General Public License version 2 as
>> + * published bythe Free Software Foundation.
>> + */
>> +
>> +#include <linux/err.h>
>> +#include <linux/module.h>
>> +#include <linux/interrupt.h>
>> +#include <linux/of_device.h>
>> +#include <linux/mfd/core.h>
>> +#include <linux/mfd/rt5033.h>
>> +#include <linux/mfd/rt5033-private.h>
>> +
>> +static const struct regmap_irq rt5033_irqs[] = {
>> + { .mask = RT5033_PMIC_IRQ_BUCKOCP, },
>> + { .mask = RT5033_PMIC_IRQ_BUCKLV, },
>> + { .mask = RT5033_PMIC_IRQ_SAFELDOLV, },
>> + { .mask = RT5033_PMIC_IRQ_LDOLV, },
>> + { .mask = RT5033_PMIC_IRQ_OT, },
>> + { .mask = RT5033_PMIC_IRQ_VDDA_UV, },
>> +};
>> +
>> +static const struct regmap_irq_chip rt5033_irq_chip = {
>> + .name = "rt5033",
>> + .status_base = RT5033_REG_PMIC_IRQ_STAT,
>> + .mask_base = RT5033_REG_PMIC_IRQ_CTRL,
>> + .mask_invert = true,
>> + .num_regs = 1,
>> + .irqs = rt5033_irqs,
>> + .num_irqs = ARRAY_SIZE(rt5033_irqs),
>> +};
>> +
>> +static const struct mfd_cell rt5033_devs[] = {
>> + { .name = "rt5033-regulator", },
>> + {
>> + .name = "rt5033-charger",
>> + .of_compatible = "richtek,rt5033-charger",
>> + }, {
>> + .name = "rt5033-battery",
>> + .of_compatible = "richtek,rt5033-battery",
>> + },
>> +};
>> +
>> +static const struct of_device_id rt5033_dt_match[] = {
>> + { .compatible = "richtek,rt5033", },
>> + { }
>> +};
>
> Put this just above where you use it for the first time.
>

I will be changed next version.

>> +static const struct regmap_config rt5033_regmap_config = {
>> + .reg_bits = 8,
>> + .val_bits = 8,
>> + .max_register = RT5033_REG_END,
>> +};
>> +
>> +static int rt5033_i2c_probe(struct i2c_client *i2c,
>> + const struct i2c_device_id *id)
>> +{
>> + struct rt5033_dev *rt5033;
>> + unsigned int data;
>
> 'data' is not a very good name for a variable.
>
> "devid" or "id" would be better in this case.
>

I will use "devid" or "id".

>> + int ret;
>> +
>> + rt5033 = devm_kzalloc(&i2c->dev, sizeof(*rt5033), GFP_KERNEL);
>> + if (!rt5033)
>> + return -ENOMEM;
>> +
>> + i2c_set_clientdata(i2c, rt5033);
>> + rt5033->dev = &i2c->dev;
>> + rt5033->irq = i2c->irq;
>> + rt5033->wakeup = true;
>> +
>> + rt5033->regmap = devm_regmap_init_i2c(i2c, &rt5033_regmap_config);
>> + if (IS_ERR(rt5033->regmap)) {
>> + dev_err(&i2c->dev, "Failed to allocate register map.\n");
>> + return PTR_ERR(rt5033->regmap);
>> + }
>> +
>> + ret = regmap_read(rt5033->regmap, RT5033_REG_DEVICE_ID, &data);
>> + if (ret) {
>> + dev_err(&i2c->dev, "Device not found\n");
>> + return -ENODEV;
>> + }
>> + dev_info(&i2c->dev, "Device found Device ID: %04x\n", data);
>> +
>> + ret = regmap_add_irq_chip(rt5033->regmap, rt5033->irq,
>> + IRQF_TRIGGER_FALLING | IRQF_ONESHOT,
>> + 0, &rt5033_irq_chip, &rt5033->irq_data);
>> + if (ret) {
>> + dev_err(&i2c->dev, "Failed to request IRQ %d: %d\n",
>> + rt5033->irq, ret);
>> + return ret;
>> + }
>> +
>> + ret = mfd_add_devices(rt5033->dev, -1, rt5033_devs,
>> + ARRAY_SIZE(rt5033_devs), NULL, 0,
>> + regmap_irq_get_domain(rt5033->irq_data));
>> + if (ret < 0) {
>> + dev_err(&i2c->dev, "Failed to add RT5033 child devices.\n");
>> + return ret;
>> + }
>> +
>> + device_init_wakeup(rt5033->dev, rt5033->wakeup);
>> +
>> + return 0;
>> +}
>> +
>> +static int rt5033_i2c_remove(struct i2c_client *i2c)
>> +{
>> + struct rt5033_dev *rt5033 = i2c_get_clientdata(i2c);
>> +
>> + mfd_remove_devices(rt5033->dev);
>
> &i2c->dev?
>

It will be changed.

>> + return 0;
>> +}
>> +
>> +static const struct i2c_device_id rt5033_i2c_id[] = {
>> + { "rt5033", },
>> + { }
>> +};
>> +MODULE_DEVICE_TABLE(i2c, rt5033_i2c_id);
>> +
>> +static struct i2c_driver rt5033_driver = {
>> + .driver = {
>> + .name = "rt5033",
>> + .of_match_table = of_match_ptr(rt5033_dt_match),
>> + },
>> + .probe = rt5033_i2c_probe,
>> + .remove = rt5033_i2c_remove,
>> + .id_table = rt5033_i2c_id,
>> +};
>> +module_i2c_driver(rt5033_driver);
>> +
>> +MODULE_ALIAS("i2c:rt5033");
>> +MODULE_DESCRIPTION("Richtek RT5033 multi-function core driver");
>> +MODULE_AUTHOR("Beomho Seo <beomho.seo@samsung.com>");
>> +MODULE_LICENSE("GPL");
>
> [...]
>
>> +#endif /* __RT5033_PRIVATE_H__ */
>> diff --git a/include/linux/mfd/rt5033.h b/include/linux/mfd/rt5033.h
>> new file mode 100644
>> index 0000000..bd06415
>> --- /dev/null
>> +++ b/include/linux/mfd/rt5033.h
>
> [...]
>
>> +struct rt5033_charger {
>> + struct device *dev;
>> + struct rt5033_dev *rt5033;
>> + struct power_supply psy;
>> +
>> + struct rt5033_charger_data *data;
>
> 'data' is not a good name for a variable.
>

I will change variable name.

>> +};
>> +
>> +#endif /* __RT5033_H__ */
>

Best regards,
Beomho Seo