Re: [PATCH v3 2/2] drivers: hwmon: ltc2991: add driver support
From: Guenter Roeck
Date: Wed Oct 11 2023 - 10:00:57 EST
On Tue, Oct 10, 2023 at 10:44:44AM +0200, Nuno Sá wrote:
> Hi Antoniu,
>
> A few more comments from me. But essentially, I think you should revisit V1 and
> Guenter's comments. I'm fairly sure you are still missing his main points...
>
Yes. And there is no change log either.
Guenter
> On Tue, 2023-10-03 at 11:00 +0300, Antoniu Miclaus wrote:
> > Add support for LTC2991 Octal I2C Voltage, Current, and Temperature
> > Monitor.
> >
> > The LTC2991 is used to monitor system temperatures, voltages and
> > currents. Through the I2C serial interface, the eight monitors can
> > individually measure supply voltages and can be paired for
> > differential measurements of current sense resistors or temperature
> > sensing transistors. Additional measurements include internal
> > temperature and internal VCC.
> >
> > Signed-off-by: Antoniu Miclaus <antoniu.miclaus@xxxxxxxxxx>
> > ---
> > Documentation/hwmon/index.rst | 1 +
> > Documentation/hwmon/ltc2991.rst | 43 +++
> > MAINTAINERS | 8 +
> > drivers/hwmon/Kconfig | 11 +
> > drivers/hwmon/Makefile | 1 +
> > drivers/hwmon/ltc2991.c | 479 ++++++++++++++++++++++++++++++++
> > 6 files changed, 543 insertions(+)
> > create mode 100644 Documentation/hwmon/ltc2991.rst
> > create mode 100644 drivers/hwmon/ltc2991.c
> >
> > diff --git a/Documentation/hwmon/index.rst b/Documentation/hwmon/index.rst
> > index 88dadea85cfc..0ec96abe3f7d 100644
> > --- a/Documentation/hwmon/index.rst
> > +++ b/Documentation/hwmon/index.rst
> > @@ -121,6 +121,7 @@ Hardware Monitoring Kernel Drivers
> > ltc2947
> > ltc2978
> > ltc2990
> > + ltc2991
> > ltc3815
> > ltc4151
> > ltc4215
> > diff --git a/Documentation/hwmon/ltc2991.rst b/Documentation/hwmon/ltc2991.rst
> > new file mode 100644
> > index 000000000000..9ab29dd85012
> > --- /dev/null
> > +++ b/Documentation/hwmon/ltc2991.rst
> > @@ -0,0 +1,43 @@
> > +.. SPDX-License-Identifier: GPL-2.0
> > +
> > +Kernel driver ltc2991
> > +=====================
> > +
> > +Supported chips:
> > +
> > + * Analog Devices LTC2991
> > +
> > + Prefix: 'ltc2991'
> > +
> > + Addresses scanned: I2C 0x48 - 0x4f
> > +
> > + Datasheet:
> > https://www.analog.com/media/en/technical-documentation/data-sheets/2991ff.pdf
> > +
> > +Authors:
> > +
> > + - Antoniu Miclaus <antoniu.miclaus@xxxxxxxxxx>
> > +
> > +
> > +Description
> > +-----------
> > +
> > +This driver supports hardware monitoring for Analog Devices LTC2991 Octal I2C
> > +Voltage, Current and Temperature Monitor.
> > +
> > +The LTC2991 is used to monitor system temperatures, voltages and currents.
> > +Through the I2C serial interface, the eight monitors can individually measure
> > +supply voltages and can be paired for differential measurements of current
> > sense
> > +resistors or temperature sensing transistors. Additional measurements include
> > +internal temperatureand internal VCC.
> > +
> > +
> > +sysfs-Interface
> > +-------------
> > +
> > +The following attributes are supported. Limits are read-only.
> > +
> > +=============== =================
> > +inX_input: voltage input
> > +currX_input: current input
> > +tempX_input: temperature input
> > +=============== =================
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index b19995690904..98dd8a8e1f84 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -12451,6 +12451,14 @@ F: drivers/hwmon/ltc2947-i2c.c
> > F: drivers/hwmon/ltc2947-spi.c
> > F: drivers/hwmon/ltc2947.h
> >
> > +LTC2991 HARDWARE MONITOR DRIVER
> > +M: Antoniu Miclaus <antoniu.miclaus@xxxxxxxxxx>
> > +L: linux-hwmon@xxxxxxxxxxxxxxx
> > +S: Supported
> > +W: https://ez.analog.com/linux-software-drivers
> > +F: Documentation/devicetree/bindings/hwmon/adi,ltc2991.yaml
> > +F: drivers/hwmon/ltc2991.c
> > +
> > LTC2983 IIO TEMPERATURE DRIVER
> > M: Nuno Sá <nuno.sa@xxxxxxxxxx>
> > L: linux-iio@xxxxxxxxxxxxxxx
> > diff --git a/drivers/hwmon/Kconfig b/drivers/hwmon/Kconfig
> > index ec38c8892158..818a67328fcd 100644
> > --- a/drivers/hwmon/Kconfig
> > +++ b/drivers/hwmon/Kconfig
> > @@ -932,6 +932,17 @@ config SENSORS_LTC2990
> > This driver can also be built as a module. If so, the module will
> > be called ltc2990.
> >
> > +config SENSORS_LTC2991
> > + tristate "Analog Devices LTC2991"
> > + depends on I2C
> > + help
> > + If you say yes here you get support for Analog Devices LTC2991
> > + Octal I2C Voltage, Current, and Temperature Monitor. The LTC2991
> > + supports a combination of voltage, current and temperature
> > monitoring.
> > +
> > + This driver can also be built as a module. If so, the module will
> > + be called ltc2991.
> > +
> > config SENSORS_LTC2992
> > tristate "Linear Technology LTC2992"
> > depends on I2C
> > diff --git a/drivers/hwmon/Makefile b/drivers/hwmon/Makefile
> > index 4ac9452b5430..f324d057535a 100644
> > --- a/drivers/hwmon/Makefile
> > +++ b/drivers/hwmon/Makefile
> > @@ -127,6 +127,7 @@ obj-$(CONFIG_SENSORS_LTC2947) += ltc2947-core.o
> > obj-$(CONFIG_SENSORS_LTC2947_I2C) += ltc2947-i2c.o
> > obj-$(CONFIG_SENSORS_LTC2947_SPI) += ltc2947-spi.o
> > obj-$(CONFIG_SENSORS_LTC2990) += ltc2990.o
> > +obj-$(CONFIG_SENSORS_LTC2991) += ltc2991.o
> > obj-$(CONFIG_SENSORS_LTC2992) += ltc2992.o
> > obj-$(CONFIG_SENSORS_LTC4151) += ltc4151.o
> > obj-$(CONFIG_SENSORS_LTC4215) += ltc4215.o
> > diff --git a/drivers/hwmon/ltc2991.c b/drivers/hwmon/ltc2991.c
> > new file mode 100644
> > index 000000000000..b5333c25cb31
> > --- /dev/null
> > +++ b/drivers/hwmon/ltc2991.c
> > @@ -0,0 +1,479 @@
> > +// SPDX-License-Identifier: GPL-2.0
> > +/*
> > + * Copyright (C) 2023 Analog Devices, Inc.
> > + * Author: Antoniu Miclaus <antoniu.miclaus@xxxxxxxxxx>
> > + */
> > +
> > +#include <linux/bitops.h>
> > +#include <linux/err.h>
> > +#include <linux/hwmon.h>
> > +#include <linux/hwmon-sysfs.h>
> > +#include <linux/i2c.h>
> > +#include <linux/kernel.h>
> > +#include <linux/module.h>
> > +#include <linux/property.h>
> > +#include <linux/regmap.h>
> > +#include <linux/regulator/consumer.h>
> > +
> > +#include <asm/unaligned.h>
> > +
> > +#define LTC2991_STATUS_LOW 0x00
> > +#define LTC2991_CH_EN_TRIGGER 0x01
> > +#define LTC2991_V1_V4_CTRL 0x06
> > +#define LTC2991_V5_V8_CTRL 0x07
> > +#define LTC2991_PWM_TH_LSB_T_INT 0x08
> > +#define LTC2991_PWM_TH_MSB 0x09
> > +#define LTC2991_CHANNEL_V_MSB(x) (0x0A + ((x) * 2))
> > +#define LTC2991_CHANNEL_T_MSB(x) (0x0A + ((x) * 4))
> > +#define LTC2991_CHANNEL_C_MSB(x) (0x0C + ((x) * 4))
> > +#define LTC2991_T_INT_MSB 0x1A
> > +#define LTC2991_VCC_MSB 0x1C
> > +
> > +#define LTC2991_V7_V8_EN BIT(7)
> > +#define LTC2991_V5_V6_EN BIT(6)
> > +#define LTC2991_V3_V4_EN BIT(5)
> > +#define LTC2991_V1_V2_EN BIT(4)
> > +#define LTC2991_T_INT_VCC_EN BIT(3)
> > +
> > +#define LTC2991_V3_V4_FILT_EN BIT(7)
> > +#define LTC2991_V3_V4_TEMP_EN BIT(5)
> > +#define LTC2991_V3_V4_DIFF_EN BIT(4)
> > +#define LTC2991_V1_V2_FILT_EN BIT(3)
> > +#define LTC2991_V1_V2_TEMP_EN BIT(1)
> > +#define LTC2991_V1_V2_DIFF_EN BIT(0)
> > +
> > +#define LTC2991_V7_V8_FILT_EN BIT(7)
> > +#define LTC2991_V7_V8_TEMP_EN BIT(5)
> > +#define LTC2991_V7_V8_DIFF_EN BIT(4)
> > +#define LTC2991_V5_V6_FILT_EN BIT(7)
> > +#define LTC2991_V5_V6_TEMP_EN BIT(5)
> > +#define LTC2991_V5_V6_DIFF_EN BIT(4)
> > +
> > +#define LTC2991_REPEAT_ACQ_EN BIT(4)
> > +#define LTC2991_T_INT_FILT_EN BIT(3)
> > +
> > +#define LTC2991_MAX_CHANNEL 4
> > +#define LTC2991_T_INT_CH_NR 4
> > +#define LTC2991_VCC_CH_NR 0
> > +
> > +static const char *const label_voltages[] = {
> > + "vcc",
> > + "voltage1",
> > + "voltage2",
> > + "voltage3",
> > + "voltage4",
> > + "voltage5",
> > + "voltage6",
> > + "voltage7",
> > + "voltage8"
> > +};
> > +
> > +static const char *const label_temp[] = {
> > + "t1",
> > + "t2",
> > + "t3",
> > + "t4",
> > + "t_int"
> > +};
> > +
> > +static const char *const label_curr[] = {
> > + "v1-v2",
> > + "v3-v4",
> > + "v5-v6",
> > + "v7-v8"
> > +};
> > +
> > +struct ltc2991_state {
> > + struct i2c_client *client;
> > + struct regmap *regmap;
> > + u32 r_sense_uohm[LTC2991_MAX_CHANNEL];
> > + bool temp_en[LTC2991_MAX_CHANNEL];
> > +};
> > +
> > +static int ltc2991_read_reg(struct ltc2991_state *st, u8 addr, u8 reg_len,
> > + int *val)
> > +{
> > + u8 regvals[2];
> > + int ret;
> > +
> > + if (reg_len > 2 || !reg_len)
> > + return -EINVAL;
> > +
>
> IMO, this is too much checking... It's an internal API, just make sure to
> properly call it ;).
>
> > + ret = regmap_bulk_read(st->regmap, addr, regvals, reg_len);
> > + if (ret)
> > + return ret;
> > +
> > + if (reg_len == 2)
> > + *val = get_unaligned_be16(®vals[0]);
> > + else
> > + *val = regvals[0];
>
> not what I had in mind. Having unaligned access is overkill when you can go with
> typical __be16 + __be16_to_cpu(). If I'm not missing anything, you just have to
> shift out the LSB in case of 1byte registers. Alternatively, before the bulk()
> call you can:
>
> if (reg_len < 2)
> return regmap_read();
>
> and then just assume 2 byte reads...
>
> > + return 0;
> > +}
> > +
> > +static int ltc2991_get_voltage(struct ltc2991_state *st, u32 reg, long *val)
> > +{
> > + int reg_val, ret, offset = 0;
> > +
> > + ret = ltc2991_read_reg(st, reg, 2, ®_val);
> > + if (ret)
> > + return ret;
> > +
> > + if (reg == LTC2991_VCC_MSB)
> > + /* Vcc 2.5V offset */
> > + offset = 2500;
> > +
> > + /* Vx, 305.18uV/LSB */
> > + *val = DIV_ROUND_CLOSEST(sign_extend32(reg_val, 14) * 30518,
> > + 1000 * 100) + offset;
> > +
> > + return 0;
> > +}
> > +
> > +static int ltc2991_read_in(struct device *dev, u32 attr, int channel, long
> > *val)
> > +{
> > + struct ltc2991_state *st = dev_get_drvdata(dev);
> > + u32 reg;
> > +
> > + switch (attr) {
> > + case hwmon_in_input:
> > + if (channel == LTC2991_VCC_CH_NR)
> > + reg = LTC2991_VCC_MSB;
> > + else
> > + reg = LTC2991_CHANNEL_V_MSB(channel - 1);
> > + break;
> > + default:
> > + return -EOPNOTSUPP;
> > + }
> > +
> > + return ltc2991_get_voltage(st, reg, val);
> > +}
> > +
> > +static int ltc2991_get_curr(struct ltc2991_state *st, u32 reg, int channel,
> > + long *val)
> > +{
> > + int reg_val, ret;
> > +
> > + ret = ltc2991_read_reg(st, reg, 2, ®_val);
> > + if (ret)
> > + return ret;
> > +
> > + /* Vx-Vy, 19.075uV/LSB */
> > + *val = DIV_ROUND_CLOSEST(sign_extend32(reg_val, 14) * 19075, 1000)
> > + / (st->r_sense_uohm[channel] / 1000);
> > +
> > + return 0;
> > +}
> > +
> > +static int ltc2991_read_curr(struct device *dev, u32 attr, int channel,
> > + long *val)
> > +{
> > + struct ltc2991_state *st = dev_get_drvdata(dev);
> > + u32 reg;
> > +
> > + switch (attr) {
> > + case hwmon_curr_input:
> > + reg = LTC2991_CHANNEL_C_MSB(channel);
> > + return ltc2991_get_curr(st, reg, channel, val);
> > + default:
> > + return -EOPNOTSUPP;
> > + }
> > +}
> > +
> > +static int ltc2991_get_temp(struct ltc2991_state *st, u32 reg, int channel,
> > + long *val)
> > +{
> > + int reg_val, ret;
> > +
> > + ret = ltc2991_read_reg(st, reg, 2, ®_val);
> > + if (ret)
> > + return ret;
> > +
> > + /* Temp LSB = 0.0625 Degrees */
> > + *val = DIV_ROUND_CLOSEST(sign_extend32(reg_val, 12) * 1000, 16);
> > +
> > + return 0;
> > +}
> > +
> > +static int ltc2991_read_temp(struct device *dev, u32 attr, int channel,
> > + long *val)
> > +{
> > + struct ltc2991_state *st = dev_get_drvdata(dev);
> > + u32 reg;
> > +
> > + switch (attr) {
> > + case hwmon_temp_input:
> > + if (channel == LTC2991_T_INT_CH_NR)
> > + reg = LTC2991_T_INT_MSB;
> > + else
> > + reg = LTC2991_CHANNEL_T_MSB(channel);
> > +
> > + return ltc2991_get_temp(st, reg, channel, val);
> > + default:
> > + return -EOPNOTSUPP;
> > + }
> > +}
> > +
> > +static int ltc2991_read(struct device *dev, enum hwmon_sensor_types type,
> > + u32 attr, int channel, long *val)
> > +{
> > + switch (type) {
> > + case hwmon_in:
> > + return ltc2991_read_in(dev, attr, channel, val);
> > + case hwmon_curr:
> > + return ltc2991_read_curr(dev, attr, channel, val);
> > + case hwmon_temp:
> > + return ltc2991_read_temp(dev, attr, channel, val);
> > + default:
> > + return -EOPNOTSUPP;
> > + }
> > +}
> > +
> > +static umode_t ltc2991_is_visible(const void *data,
> > + enum hwmon_sensor_types type, u32 attr,
> > + int channel)
> > +{
> > + const struct ltc2991_state *st = data;
> > +
> > + switch (type) {
> > + case hwmon_in:
> > + switch (attr) {
> > + case hwmon_in_input:
> > + case hwmon_in_label:
> > + return 0444;
> > + }
> > + break;
> > + case hwmon_curr:
> > + switch (attr) {
> > + case hwmon_curr_input:
> > + case hwmon_curr_label:
> > + if (st->r_sense_uohm[channel])
> > + return 0444;
> > + break;
> > + }
>
> This is what I was speaking about... You should go read again v1 an try to
> understand the points made or continue the discussion.
>
> I didn't looked at the datasheet but what I understood from Guenter is that each
> channel can only be a specific type of sensor and you should be explicit about
> that (not using rsense as the deciding factor). Thus, your bindings should
> likely be refactored so you have a property that explicitly "defines" a channel
> (not forgetting to handle things like differential channels and overlaps etc...)
> and then you need to reflect the ABI according to what sensors OF/ACPI have
> defined.
>
> This looks a bit like the ltc2983 [1] I upstreamed where most of the fun was in
> defining the channels (and maybe that one was actually an hwmon driver but what
> did I know back then :))
>
> Also important is that in absence of OF/ACPI, you should read whatever
> configuration is the device holding so, once again, you export the correct ABI.
> But in this case, I'm not really sure what would be a sane (if there's one) for
> rsense in case of a current sensor.
>
> Hopefully I got it right...
>
> > + break;
> > + case hwmon_temp:
> > + switch (attr) {
> > + case hwmon_temp_input:
> > + case hwmon_temp_label:
> > + if (st->temp_en[channel] ||
> > + channel == LTC2991_T_INT_CH_NR)
> > + return 0444;
> > + break;
> > + }
> > + break;
> > + default:
> > + break;
> > + }
> > +
> > + return 0;
> > +}
> > +
> > +static int ltc2991_read_string(struct device *dev, enum hwmon_sensor_types
> > type,
> > + u32 attr, int channel, const char **str)
> > +{
> > + switch (type) {
> > + case hwmon_temp:
> > + *str = label_temp[channel];
> > + break;
> > + case hwmon_curr:
> > + *str = label_curr[channel];
> > + break;
> > + case hwmon_in:
> > + *str = label_voltages[channel];
> > + break;
> > + default:
> > + return -EOPNOTSUPP;
> > + }
> > +
> > + return 0;
> > +}
> > +
> > +static const struct hwmon_ops ltc2991_hwmon_ops = {
> > + .is_visible = ltc2991_is_visible,
> > + .read = ltc2991_read,
> > + .read_string = ltc2991_read_string,
> > +};
> > +
> > +static const struct hwmon_channel_info *ltc2991_info[] = {
> > + HWMON_CHANNEL_INFO(temp,
> > + HWMON_T_INPUT | HWMON_T_LABEL,
> > + HWMON_T_INPUT | HWMON_T_LABEL,
> > + HWMON_T_INPUT | HWMON_T_LABEL,
> > + HWMON_T_INPUT | HWMON_T_LABEL,
> > + HWMON_T_INPUT | HWMON_T_LABEL
> > + ),
> > + HWMON_CHANNEL_INFO(curr,
> > + HWMON_C_INPUT | HWMON_C_LABEL,
> > + HWMON_C_INPUT | HWMON_C_LABEL,
> > + HWMON_C_INPUT | HWMON_C_LABEL,
> > + HWMON_C_INPUT | HWMON_C_LABEL
> > + ),
> > + HWMON_CHANNEL_INFO(in,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL,
> > + HWMON_I_INPUT | HWMON_I_LABEL
> > + ),
> > + NULL
> > +};
> > +
> > +static const struct hwmon_chip_info ltc2991_chip_info = {
> > + .ops = <c2991_hwmon_ops,
> > + .info = ltc2991_info,
> > +};
> > +
> > +static const struct regmap_config ltc2991_regmap_config = {
> > + .reg_bits = 8,
> > + .val_bits = 8,
> > + .max_register = 0x1D,
> > +};
> > +
> > +static int ltc2991_init(struct ltc2991_state *st)
> > +{
> > + struct fwnode_handle *child;
> > + int ret;
> > + u32 val, addr;
> > + u8 v5_v8_reg_data = 0, v1_v4_reg_data = 0;
> > +
> > + ret = devm_regulator_get_enable(&st->client->dev, "vcc");
> > + if (ret)
> > + return dev_err_probe(&st->client->dev, ret,
> > + "failed to enable regulator\n");
> > +
> > + device_for_each_child_node(&st->client->dev, child) {
> > + ret = fwnode_property_read_u32(child, "reg", &addr);
> > + if (ret < 0) {
> > + fwnode_handle_put(child);
> > + return ret;
> > + }
> > +
> > + if (addr > 3) {
> > + fwnode_handle_put(child);
> > + return -EINVAL;
> > + }
> > +
> > + ret = fwnode_property_read_u32(child, "shunt-resistor-micro-
> > ohms", &val);
> > + if (!ret) {
> > + st->r_sense_uohm[addr] = val;
>
> This still allows 0 as a valid value which would lead to a divide by 0
> exception...
>
> [1]: https://elixir.bootlin.com/linux/v6.6-rc5/source/drivers/iio/temperature/ltc2983.c#L1371
>
> - Nuno Sá
>