Devicetree
 help / color / mirror / Atom feed
From: David Lechner <dlechner@baylibre.com>
To: Kurt Borja <kuurtb@gmail.com>,
	Jonathan Cameron <jic23@kernel.org>,
	Rob Herring <robh@kernel.org>,
	Krzysztof Kozlowski <krzk+dt@kernel.org>,
	Conor Dooley <conor+dt@kernel.org>,
	Linus Walleij <linusw@kernel.org>,
	Bartosz Golaszewski <brgl@kernel.org>
Cc: "Nuno Sá" <nuno.sa@analog.com>,
	"Andy Shevchenko" <andy@kernel.org>,
	linux-iio@vger.kernel.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org, linux-gpio@vger.kernel.org
Subject: Re: [PATCH v3 4/9] iio: adc: ti-ads1262: support per-channel reference and gain
Date: Sat, 8 Aug 2026 13:39:28 -0500	[thread overview]
Message-ID: <ff566148-b3fb-49fc-9e87-6c5a317e1a2f@baylibre.com> (raw)
In-Reply-To: <20260807-ads126x-v3-4-f89925d72792@gmail.com>

On 8/7/26 10:58 PM, Kurt Borja wrote:
> Allow each channel to select its voltage reference through the
> "reference-sources" firmware property. Then, use the reference voltage
> to calculate available scales.

It looks like this is also implementing PGA gain at the same time, but
isn't mentioned in ght commit messsage. I would also expect something
here about how we should handle PGA bypass (even if it just says default
works always and we can consdier controlling it later).

> 
> The ADS1262 allows single-ended supply configurations or bipolar supply
> configurations. In single ended configurations both the analog and
> digital rails share the same ground, i.e. AVSS = DGND = 0 V. In bipolar
> supply configurations, AVSS can go below ground, e.g. AVSS = -2.5 V.
> 
> If AVSS is below ground, the ADC can achieve true bipolar measurements
> and the external references can also have voltage levels below ground.
> This is currently an issue because the regulator subsystem doesn't
> support negative voltages.
> 
> The ad4170-4 driver faces this problem too and the same workaround is
> used in this case: assume every regulator reports magnitudes (absolute
> values). If the chip has a bipolar supply configuration, then assume
> positive references are above ground (>= 0 V) and negative references
> are below ground (<= 0 V). This is not a hardware constraint, but it is
> the most common wiring.
> 
> Signed-off-by: Kurt Borja <kuurtb@gmail.com>
> ---
>  drivers/iio/adc/ti-ads1262.c | 417 +++++++++++++++++++++++++++++++++++++++++--
>  1 file changed, 406 insertions(+), 11 deletions(-)
> 
> diff --git a/drivers/iio/adc/ti-ads1262.c b/drivers/iio/adc/ti-ads1262.c
> index b3b7b1249102..360ce01a5871 100644
> --- a/drivers/iio/adc/ti-ads1262.c
> +++ b/drivers/iio/adc/ti-ads1262.c
> @@ -8,6 +8,7 @@
>  #include <linux/array_size.h>
>  #include <linux/bitfield.h>
>  #include <linux/bitops.h>
> +#include <linux/bitmap.h>
>  #include <linux/cleanup.h>
>  #include <linux/clk.h>
>  #include <linux/completion.h>
> @@ -18,6 +19,7 @@
>  #include <linux/interrupt.h>
>  #include <linux/lockdep.h>
>  #include <linux/math64.h>
> +#include <linux/minmax.h>
>  #include <linux/module.h>
>  #include <linux/mod_devicetable.h>
>  #include <linux/mutex.h>
> @@ -25,6 +27,7 @@
>  #include <linux/regmap.h>
>  #include <linux/regulator/consumer.h>
>  #include <linux/spi/spi.h>
> +#include <linux/string.h>
>  #include <linux/types.h>
>  #include <linux/units.h>
>  
> @@ -97,6 +100,9 @@
>  #define ADS1262_IDACMAG_REG			0x0E
>  
>  #define ADS1262_REFMUX_REG			0x0F
> +#define   ADS1262_REFMUX_RMUXP_MASK		GENMASK(5, 3)
> +#define   ADS1262_REFMUX_RMUXN_MASK		GENMASK(2, 0)
> +
>  #define ADS1262_TDACP_REG			0x10
>  #define ADS1262_TDACN_REG			0x11
>  #define ADS1262_GPIOCON_REG			0x12
> @@ -117,8 +123,12 @@
>  
>  #define ADS1262_MAX_CHANNEL_COUNT		16
>  #define ADS1262_MAX_REGMAP_WRITE		8
> +#define ADS1262_EXT_REF_COUNT			3
>  #define ADS1262_ADC1_RESOLUTION			32
>  
> +#define ADS1262_TEMP_SLOPE_uV_C			420ULL
> +#define ADS1262_TEMP_ZERO_C			111900ULL
> +
>  enum {
>  	ADS1262_RUNMODE_CONTINUOUS,
>  	ADS1262_RUNMODE_PULSE,
> @@ -171,12 +181,38 @@ enum {
>  	ADS1262_INPMUX_FLOAT,
>  };
>  
> +enum {
> +	ADS1262_RMUXP_INTERNAL,
> +	ADS1262_RMUXP_REFP1,
> +	ADS1262_RMUXP_REFP2,
> +	ADS1262_RMUXP_REFP3,
> +	ADS1262_RMUXP_AVDD,
> +	ADS1262_RMUXP_COUNT
> +};
> +
> +enum {
> +	ADS1262_RMUXN_INTERNAL,
> +	ADS1262_RMUXN_REFN1,
> +	ADS1262_RMUXN_REFN2,
> +	ADS1262_RMUXN_REFN3,
> +	ADS1262_RMUXN_AVSS,
> +	ADS1262_RMUXN_COUNT
> +};
> +
>  struct ads1262_chip_info {
>  	const char *name;
>  };
>  
>  struct ads1262_channel {
>  	u8 data_rate;
> +	u8 gain;
> +	u8 ref_p;
> +	u8 ref_n;
> +	bool ref_reversal;
> +	bool is_resistance;
> +	int offset;
> +	int scales[6][2];

I would add a macro for 6 to explain that it is the number of possible
gains for the PGA. And that the gain multipler is the index in the array
to the power of 2.

> +	size_t num_scales;
>  	int samp_freqs[ADS1262_DR_COUNT][2];
>  };
>  
> @@ -192,6 +228,12 @@ struct ads1262 {
>  	unsigned int num_channels;
>  	struct ads1262_channel *channels;
>  	struct completion drdy;
> +	u32 rref_ohms[ADS1262_EXT_REF_COUNT][ADS1262_EXT_REF_COUNT];
> +	int refp_uV[ADS1262_RMUXP_COUNT];
> +	int refn_uV[ADS1262_RMUXN_COUNT];
> +	bool need_avdd_uV;
> +	bool need_avss_uV;
> +	bool bipolar_supply;
>  
>  	/* Protects transfer buffers and concurrent SPI transfers */
>  	struct mutex xfer_lock;
> @@ -216,6 +258,24 @@ static const u32 ads1262_data_rate_div[] = {
>  	[ADS1262_DR_38400_SPS]	= 8 * 24 * 1,
>  };
>  
> +static const char * const ads1262_ref_sources_pos[] = {
> +	[ADS1262_RMUXP_INTERNAL] = "internal",
> +	[ADS1262_RMUXP_REFP1] = "refp1",
> +	[ADS1262_RMUXP_REFP2] = "refp2",
> +	[ADS1262_RMUXP_REFP3] = "refp3",
> +	[ADS1262_RMUXP_AVDD] = "avdd",
> +	NULL
> +};
> +
> +static const char * const ads1262_ref_sources_neg[] = {
> +	[ADS1262_RMUXN_INTERNAL] = "internal",
> +	[ADS1262_RMUXN_REFN1] = "refn1",
> +	[ADS1262_RMUXN_REFN2] = "refn2",
> +	[ADS1262_RMUXN_REFN3] = "refn3",
> +	[ADS1262_RMUXN_AVSS] = "avss",
> +	NULL
> +};
> +
>  static int ads1262_find_two(const int (*array)[2], size_t num_elements, int val,
>  			    int val2)
>  {
> @@ -231,6 +291,12 @@ static int ads1262_find_two(const int (*array)[2], size_t num_elements, int val,
>  	return i;
>  }
>  
> +static bool ads1262_ref_is_external(int ref_p, int ref_n)
> +{
> +	return in_range(ref_p, ADS1262_RMUXP_REFP1, ADS1262_EXT_REF_COUNT) &&
> +	       in_range(ref_n, ADS1262_RMUXN_REFN1, ADS1262_EXT_REF_COUNT);
> +}
> +
>  static int ads1262_dev_cmd(struct ads1262 *st, u8 opcode)
>  {
>  	guard(mutex)(&st->xfer_lock);
> @@ -365,17 +431,33 @@ static int ads1262_channel_enable(struct ads1262 *st,
>  	guard(mutex)(&st->xfer_lock);
>  	guard(mutex)(&st->chan_lock);
>  
> -	val = FIELD_PREP(ADS1262_MODE2_DR_MASK, chan->data_rate);
> +	val = FIELD_PREP(ADS1262_MODE0_REFREV_MASK, chan->ref_reversal);
> +	ret = regmap_update_bits(st->regmap, ADS1262_MODE0_REG,
> +				 ADS1262_MODE0_REFREV_MASK, val);
> +	if (ret)
> +		return ret;
> +
> +	val = FIELD_PREP(ADS1262_MODE2_DR_MASK, chan->data_rate) |
> +	      FIELD_PREP(ADS1262_MODE2_GAIN_MASK, chan->gain);
>  	ret = regmap_update_bits(st->regmap, ADS1262_MODE2_REG,
> -				 ADS1262_MODE2_DR_MASK, val);
> +				 ADS1262_MODE2_DR_MASK |
> +				 ADS1262_MODE2_GAIN_MASK, val);
>  	if (ret)
>  		return ret;
>  
>  	val = FIELD_PREP(ADS1262_INPMUX_MUXN_MASK, spec->channel2) |
>  	      FIELD_PREP(ADS1262_INPMUX_MUXP_MASK, spec->channel);
> -	return regmap_update_bits(st->regmap, ADS1262_INPMUX_REG,
> +	ret = regmap_update_bits(st->regmap, ADS1262_INPMUX_REG,
>  				 ADS1262_INPMUX_MUXN_MASK |
>  				 ADS1262_INPMUX_MUXP_MASK, val);

Do we need to fix alignment of these lines too?

> +	if (ret)
> +		return ret;
> +
> +	val = FIELD_PREP(ADS1262_REFMUX_RMUXN_MASK, chan->ref_n) |
> +	      FIELD_PREP(ADS1262_REFMUX_RMUXP_MASK, chan->ref_p);
> +	return regmap_update_bits(st->regmap, ADS1262_REFMUX_REG,
> +				  ADS1262_REFMUX_RMUXN_MASK |
> +				  ADS1262_REFMUX_RMUXP_MASK, val);
>  }
>  
>  static int ads1262_set_runmode(struct ads1262 *st, u8 runmode)
> @@ -436,6 +518,26 @@ static int ads1262_read_raw(struct iio_dev *indio_dev,
>  
>  		return IIO_VAL_INT;
>  
> +	case IIO_CHAN_INFO_SCALE: {
> +		guard(mutex)(&st->chan_lock);
> +
> +		*val = chan_data->scales[chan_data->gain][0];
> +		*val2 = chan_data->scales[chan_data->gain][1];
> +
> +		return IIO_VAL_DECIMAL64_PICO;
> +	}
> +
> +	case IIO_CHAN_INFO_OFFSET: {
> +		if (chan->type != IIO_TEMP)
> +			return -EPERM;

Dont' return EPERM. That would lead people to belive it is a permission
issue that can be fixed with chown. Typically we just return -EINVAL.

> +
> +		guard(mutex)(&st->chan_lock);
> +
> +		*val = chan_data->offset;
> +
> +		return IIO_VAL_INT;
> +	}
> +
>  	case IIO_CHAN_INFO_SAMP_FREQ: {
>  		guard(mutex)(&st->chan_lock);
>  
> @@ -458,6 +560,12 @@ static int ads1262_read_avail(struct iio_dev *indio_dev,
>  	struct ads1262_channel *chan_data = &st->channels[chan->scan_index];
>  
>  	switch (mask) {
> +	case IIO_CHAN_INFO_SCALE:
> +		*type = IIO_VAL_DECIMAL64_PICO;
> +		*vals = (const int *)chan_data->scales;
> +		*length = chan_data->num_scales * 2;
> +		return IIO_AVAIL_LIST;
> +
>  	case IIO_CHAN_INFO_SAMP_FREQ:
>  		*type = IIO_VAL_INT_PLUS_MICRO;
>  		*vals = (const int *)chan_data->samp_freqs;
> @@ -484,6 +592,16 @@ static int ads1262_write_raw(struct iio_dev *indio_dev,
>  	guard(mutex)(&st->chan_lock);
>  
>  	switch (mask) {
> +	case IIO_CHAN_INFO_SCALE:
> +		ret = ads1262_find_two(chan_data->scales, chan_data->num_scales,
> +				       val, val2);
> +		if (ret < 0)
> +			return ret;
> +
> +		chan_data->gain = ret;
> +
> +		return 0;
> +
>  	case IIO_CHAN_INFO_SAMP_FREQ:
>  		ret = ads1262_find_two(chan_data->samp_freqs,
>  				       ARRAY_SIZE(chan_data->samp_freqs),
> @@ -513,10 +631,22 @@ static int ads1262_debugfs_reg_access(struct iio_dev *indio_dev, unsigned int re
>  	return regmap_write(st->regmap, reg, writeval);
>  }
>  
> +static int ads1262_write_raw_get_fmt(struct iio_dev *indio_dev,
> +				     struct iio_chan_spec const *chan, long mask)
> +{
> +	switch (mask) {
> +	case IIO_CHAN_INFO_SCALE:
> +		return IIO_VAL_DECIMAL64_PICO;
> +	default:
> +		return IIO_VAL_INT_PLUS_MICRO;
> +	}
> +}
> +
>  static const struct iio_info ads1262_iio_info = {
>  	.read_raw = ads1262_read_raw,
>  	.read_avail = ads1262_read_avail,
>  	.write_raw = ads1262_write_raw,
> +	.write_raw_get_fmt = ads1262_write_raw_get_fmt,
>  	.debugfs_reg_access = ads1262_debugfs_reg_access,
>  };
>  
> @@ -688,6 +818,91 @@ static const struct regmap_bus ads1262_regmap_bus = {
>  	.max_raw_write = ADS1262_MAX_REGMAP_WRITE,
>  };
>  
> +static void ads1262_calculate_scales(int (*scales)[2], size_t num_scales,
> +				     u32 full_scale, u64 mult,
> +				     u32 resolution)
> +{
> +	unsigned int i;
> +	s64 val;
> +
> +	for (i = 0; i < num_scales; i++) {

This could use a comment explaining the relasionship of the index in the
array to the PGA multipier.

> +		val = mul_u64_u64_shr(full_scale, mult, resolution - 1 + i);
> +		iio_val_s64_decompose(val, &scales[i][0], &scales[i][1]);
> +	}
> +}
> +
> +static int ads1262_populate_scales_resistance(struct ads1262 *st,
> +					      const struct iio_chan_spec *spec)
> +{
> +	struct ads1262_channel *chan = &st->channels[spec->scan_index];
> +	u32 full_scale;
> +
> +	if (WARN_ON(!ads1262_ref_is_external(chan->ref_p, chan->ref_n)))
> +		return -EINVAL;

WARN_ON() is a bit strong for something that is coming from the devicetree.
I would just fail the parse() function with an appropriate error message
so that we don't have to check here.

> +
> +	full_scale = st->rref_ohms[chan->ref_p - 1][chan->ref_n - 1];
> +
> +	chan->num_scales = ARRAY_SIZE(chan->scales);
> +
> +	ads1262_calculate_scales(chan->scales, chan->num_scales, full_scale,
> +				 PICO, ADS1262_ADC1_RESOLUTION);
> +
> +	return 0;
> +}
> +
> +static int ads1262_populate_scales_temp(struct ads1262 *st,
> +					const struct iio_chan_spec *spec)
> +{
> +	struct device *dev = &st->spi->dev;
> +	struct ads1262_channel *chan = &st->channels[spec->scan_index];
> +	u32 full_scale;
> +	u64 mult;
> +
> +	full_scale = abs(st->refp_uV[chan->ref_p] - st->refn_uV[chan->ref_n]);
> +	if (full_scale < 900000)
> +		return dev_err_probe(dev, -EINVAL, "channel@%u: reference voltage below 0.9V\n",
> +				     spec->scan_index);
> +
> +	chan->offset = -div_s64(ADS1262_TEMP_ZERO_C <<
> +				(ADS1262_ADC1_RESOLUTION - 1), full_scale);
> +
> +	chan->num_scales = 1;
> +
> +	mult = PICO * MILLIDEGREE_PER_DEGREE / ADS1262_TEMP_SLOPE_uV_C;
> +	ads1262_calculate_scales(chan->scales, chan->num_scales, full_scale,
> +				 mult, ADS1262_ADC1_RESOLUTION);
> +
> +	return 0;
> +}
> +
> +static int ads1262_populate_scales_voltage(struct ads1262 *st,
> +					   const struct iio_chan_spec *spec)
> +{
> +	struct device *dev = &st->spi->dev;
> +	struct ads1262_channel *chan = &st->channels[spec->scan_index];
> +	u32 full_scale;

full_scale_uV

> +	u64 mult;
> +
> +	full_scale = abs(st->refp_uV[chan->ref_p] - st->refn_uV[chan->ref_n]);
> +	if (full_scale < 900000)
> +		return dev_err_probe(dev, -EINVAL, "channel@%u: reference voltage below 0.9V\n",
> +				     spec->scan_index);
> +
> +	if (spec->channel >= ADS1262_INPMUX_AVDD &&
> +	    spec->channel <= ADS1262_INPMUX_DVDD) {
> +		chan->num_scales = 1;
> +		mult = 4;

Could use a comment to explain where this 4 comes from.

> +	} else {
> +		chan->num_scales = ARRAY_SIZE(chan->scales);
> +		mult = 1;
> +	}
> +
> +	ads1262_calculate_scales(chan->scales, chan->num_scales, full_scale,
> +				 NANO * mult, ADS1262_ADC1_RESOLUTION);
> +
> +	return 0;
> +}
> +
>  static void ads1262_populate_samp_freqs(struct ads1262 *st,
>  					struct ads1262_channel *chan)
>  {
> @@ -707,12 +922,102 @@ static void ads1262_populate_samp_freqs(struct ads1262 *st,
>  static int ads1262_populate_tables(struct iio_dev *indio_dev)
>  {
>  	struct ads1262 *st = iio_priv(indio_dev);
> +	const struct iio_chan_spec *spec;
>  	struct ads1262_channel *chan;
> +	int ret;
> +
>  
>  	for (unsigned int i = 0; i < st->num_channels; i++) {
> +		spec = &indio_dev->channels[i];
>  		chan = &st->channels[i];
>  
>  		ads1262_populate_samp_freqs(st, chan);
> +
> +		switch (spec->type) {
> +		case IIO_VOLTAGE:
> +			ret = ads1262_populate_scales_voltage(st, spec);
> +			if (ret)
> +				return ret;
> +			break;
> +		case IIO_TEMP:
> +			ret = ads1262_populate_scales_temp(st, spec);
> +			if (ret)
> +				return ret;
> +			break;
> +		case IIO_RESISTANCE:
> +			ret = ads1262_populate_scales_resistance(st, spec);
> +			if (ret)
> +				return ret;
> +			break;
> +		default:
> +			return -EOPNOTSUPP;
> +		}
> +	}
> +
> +	return 0;
> +}
> +
> +static int ads1262_parse_references(struct ads1262 *st)
> +{
> +	struct device *dev = &st->spi->dev;
> +	unsigned int i, j;
> +	char name[sizeof("ti,refpN-refnM-resistor-ohms")];
> +	u32 ohms;
> +	int ret;
> +
> +	st->refp_uV[ADS1262_RMUXP_INTERNAL] = st->refn_uV[ADS1262_RMUXN_AVSS] + 2500000;

Could use a comment explaining why the extra 2.5V.

> +	st->refn_uV[ADS1262_RMUXN_INTERNAL] = st->refn_uV[ADS1262_RMUXN_AVSS];
> +
> +	for (i = ADS1262_RMUXP_REFP1; i <= ADS1262_RMUXP_REFP3; i++) {
> +		scnprintf(name, sizeof(name), "refp%u", i);
> +		ret = devm_regulator_get_enable_read_voltage(dev, name);
> +		if (ret < 0 && ret != -ENODEV)
> +			return dev_err_probe(dev, ret, "failed to read reference voltage: %s\n",
> +					     name);
> +
> +		st->refp_uV[i] = ret == -ENODEV ? 0 : ret;
> +	}
> +
> +	for (i = ADS1262_RMUXN_REFN1; i <= ADS1262_RMUXN_REFN3; i++) {
> +		scnprintf(name, sizeof(name), "refn%u", i);
> +		ret = devm_regulator_get_enable_read_voltage(dev, name);
> +		if (ret < 0 && ret != -ENODEV)
> +			return dev_err_probe(dev, ret, "failed to read reference voltage: %s\n",
> +					     name);
> +
> +		/*
> +		 * REVISIT: Currently the regulator subsystem doesn't support
> +		 * reading negative voltages. If we have a bipolar supply
> +		 * configuration (AVSS < 0), then we are forced to assume that
> +		 * negative references are either 0V (no regulator) or below
> +		 * ground magnitudes.
> +		 */
> +		if (st->bipolar_supply)
> +			st->refn_uV[i] = ret == -ENODEV ? 0 : -ret;
> +		else
> +			st->refn_uV[i] = ret == -ENODEV ? 0 : ret;
> +	}
> +
> +	for (i = ADS1262_RMUXP_REFP1; i <= ADS1262_RMUXP_REFP3; i++) {
> +		for (j = ADS1262_RMUXN_REFN1; j <= ADS1262_RMUXN_REFN3; j++) {
> +			scnprintf(name, sizeof(name),
> +				  "ti,refp%u-refn%u-resistor-ohms", i, j);
> +
> +			if (!device_property_present(dev, name))
> +				continue;
> +
> +			ret = device_property_read_u32(dev, name, &ohms);
> +			if (ret)
> +				return dev_err_probe(dev, ret,
> +						     "failed to read reference resistor: %s\n",
> +						     name);
> +			if (!ohms)
> +				return dev_err_probe(dev, -EINVAL,
> +						     "reference resistor can't be 0 ohms: %s\n",
> +						     name);
> +
> +			st->rref_ohms[i - 1][j - 1] = ohms;
> +		}
>  	}
>  
>  	return 0;
> @@ -745,7 +1050,10 @@ static int ads1262_parse_channel_node(struct ads1262 *st,
>  				      struct iio_chan_spec *spec,
>  				      struct fwnode_handle *node)
>  {
> +	struct ads1262_channel *chan = &st->channels[spec->scan_index];
>  	struct device *dev = &st->spi->dev;
> +	const char *sources[2];
> +	char name[sizeof("ti,refpN-refnM-resistor-ohms")];
>  	u32 pins[2];
>  	int ret;
>  
> @@ -785,6 +1093,49 @@ static int ads1262_parse_channel_node(struct ads1262 *st,
>  	spec->channel = pins[0];
>  	spec->channel2 = pins[1];
>  
> +	if (fwnode_property_present(node, "reference-sources")) {
> +		ret = fwnode_property_read_string_array(node, "reference-sources",
> +							sources, ARRAY_SIZE(sources));
> +		if (ret < 0)
> +			return dev_err_probe(dev, ret, "%s: failed to read reference-sources\n",
> +					     fwnode_get_name(node));
> +		if (ret < 2)
> +			return dev_err_probe(dev, -EINVAL, "%s: missing reference-sources\n",
> +					     fwnode_get_name(node));
> +
> +		ret = match_string(ads1262_ref_sources_pos, -1, sources[0]);
> +		if (ret < 0)
> +			return dev_err_probe(dev, ret, "%s: invalid positive reference source\n",
> +					     fwnode_get_name(node));
> +		chan->ref_p = ret;
> +
> +		ret = match_string(ads1262_ref_sources_neg, -1, sources[1]);
> +		if (ret < 0)
> +			return dev_err_probe(dev, ret, "%s: invalid negative reference source\n",
> +					     fwnode_get_name(node));
> +		chan->ref_n = ret;
> +
> +		if ((chan->ref_p == ADS1262_RMUXP_INTERNAL ||
> +		     chan->ref_n == ADS1262_RMUXN_INTERNAL) && chan->ref_p != chan->ref_n)
> +			return dev_err_probe(dev, -EINVAL,
> +					     "%s: the internal reference must be selected symmetrically\n",
> +					     fwnode_get_name(node));
> +
> +		if (chan->ref_p == ADS1262_RMUXP_AVDD)
> +			st->need_avdd_uV = true;
> +		if (chan->ref_n == ADS1262_RMUXN_AVSS)
> +			st->need_avss_uV = true;
> +
> +		if (ads1262_ref_is_external(chan->ref_p, chan->ref_n)) {
> +			scnprintf(name, sizeof(name), "ti,refp%u-refn%u-resistor-ohms",
> +				  chan->ref_p, chan->ref_n);
> +			if (device_property_present(dev, name))
> +				chan->is_resistance = true;
> +		}
> +	}
> +
> +	chan->ref_reversal = fwnode_property_read_bool(node, "ti,reference-reversal");
> +
>  	return 0;
>  }
>  
> @@ -845,6 +1196,8 @@ static int ads1262_parse_channels(struct iio_dev *indio_dev)
>  
>  		if (specs[reg].channel == ADS1262_INPMUX_TEMP)
>  			specs[reg].type = IIO_TEMP;
> +		else if (st->channels[reg].is_resistance)
> +			specs[reg].type = IIO_RESISTANCE;
>  		else
>  			specs[reg].type = IIO_VOLTAGE;
>  
> @@ -852,9 +1205,14 @@ static int ads1262_parse_channels(struct iio_dev *indio_dev)
>  			specs[reg].indexed = true;
>  
>  		specs[reg].info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |
> -						BIT(IIO_CHAN_INFO_SAMP_FREQ);
> +						BIT(IIO_CHAN_INFO_SAMP_FREQ) |
> +						BIT(IIO_CHAN_INFO_SCALE);
> +		if (specs[reg].channel == ADS1262_INPMUX_TEMP)
> +			specs[reg].info_mask_separate |= BIT(IIO_CHAN_INFO_OFFSET);
> +
>  		specs[reg].info_mask_separate_available =
> -				BIT(IIO_CHAN_INFO_SAMP_FREQ);
> +			BIT(IIO_CHAN_INFO_SAMP_FREQ) |
> +			BIT(IIO_CHAN_INFO_SCALE);
>  	}
>  
>  	specs[num_specs - 1] = IIO_CHAN_SOFT_TIMESTAMP(num_specs - 1);
> @@ -874,13 +1232,46 @@ static int ads1262_supply_setup(struct ads1262 *st)
>  	if (ret)
>  		return dev_err_probe(dev, ret, "failed to get dvdd regulator\n");
>  
> -	ret = devm_regulator_get_enable(dev, "avdd");
> -	if (ret < 0)
> -		return dev_err_probe(dev, ret, "failed to get avdd regulator\n");
> +	if (st->need_avdd_uV) {
> +		ret = devm_regulator_get_enable_read_voltage(dev, "avdd");
> +		if (ret < 0)
> +			return dev_err_probe(dev, ret, "failed to get avdd voltage\n");
>  
> -	ret = devm_regulator_get_enable_optional(dev, "avss");
> -	if (ret < 0 && ret != -ENODEV)
> -		return dev_err_probe(dev, ret, "failed to get avss regulator\n");
> +		st->refp_uV[ADS1262_RMUXP_AVDD] = ret;
> +	} else {
> +		ret = devm_regulator_get_enable(dev, "avdd");
> +		if (ret < 0)
> +			return dev_err_probe(dev, ret, "failed to get avdd regulator\n");
> +	}
> +
> +	/*
> +	 * REVISIT: The AVSS supply has a minimum of -2.5V and maximum of 0V.
> +	 * Currently the regulator subsystem doesn't support negative voltages,
> +	 * so we assume the value returned here is actually the magnitude
> +	 * (absolute value).
> +	 *
> +	 * This limitation forces us to assume that, if we have a bipolar supply
> +	 * (AVSS < 0V), all negative references are below ground (REFN <= 0V)
> +	 * and positive references are above ground (REFP >= 0V), as this is the
> +	 * most common configuration.
> +	 */
> +	if (st->need_avss_uV) {
> +		ret = devm_regulator_get_enable_read_voltage(dev, "avss");
> +		if (ret < 0 && ret != -ENODEV)
> +			return dev_err_probe(dev, ret, "failed to get avss voltage\n");
> +
> +		if (ret != -ENODEV) {
> +			st->refn_uV[ADS1262_RMUXN_AVSS] = -ret;
> +			st->bipolar_supply = true;
> +		}
> +	} else {
> +		ret = devm_regulator_get_enable_optional(dev, "avss");
> +		if (ret < 0 && ret != -ENODEV)
> +			return dev_err_probe(dev, ret, "failed to get avss regulator\n");
> +
> +		if (ret != -ENODEV)
> +			st->bipolar_supply = true;
> +	}
>  
>  	return 0;
>  }
> @@ -939,6 +1330,10 @@ static int ads1262_spi_probe(struct spi_device *spi)
>  	if (ret)
>  		return ret;
>  
> +	ret = ads1262_parse_references(st);
> +	if (ret)
> +		return ret;
> +
>  	ret = ads1262_populate_tables(indio_dev);
>  	if (ret)
>  		return ret;
> 


  reply	other threads:[~2026-08-08 18:39 UTC|newest]

Thread overview: 36+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-08-08  3:58 [PATCH v3 0/9] iio: adc: Add TI ADS126X ADC family support Kurt Borja
2026-08-08  3:58 ` [PATCH v3 1/9] dt-bindings: iio: adc: support the TI ADS126x ADC family Kurt Borja
2026-08-08  4:08   ` sashiko-bot
2026-08-08 18:38   ` David Lechner
2026-08-09  8:26     ` Kurt Borja
2026-08-08  3:58 ` [PATCH v3 2/9] iio: adc: add the ti-ads1262 driver Kurt Borja
2026-08-08  4:11   ` sashiko-bot
2026-08-08 18:39   ` David Lechner
2026-08-09  8:26     ` Kurt Borja
2026-08-08 22:28   ` Uwe Kleine-König
2026-08-09 16:24     ` Kurt Borja
2026-08-08  3:58 ` [PATCH v3 3/9] iio: adc: ti-ads1262: support per-channel sampling frequency Kurt Borja
2026-08-08  4:11   ` sashiko-bot
2026-08-08 18:39   ` David Lechner
2026-08-09  8:27     ` Kurt Borja
2026-08-08  3:58 ` [PATCH v3 4/9] iio: adc: ti-ads1262: support per-channel reference and gain Kurt Borja
2026-08-08 18:39   ` David Lechner [this message]
2026-08-09  8:28     ` Kurt Borja
2026-08-08  3:58 ` [PATCH v3 5/9] iio: adc: ti-ads1262: support input chopping Kurt Borja
2026-08-08 18:39   ` David Lechner
2026-08-08  3:58 ` [PATCH v3 6/9] iio: adc: ti-ads1262: support excitation currents Kurt Borja
2026-08-08  4:13   ` sashiko-bot
2026-08-08 18:39   ` David Lechner
2026-08-08  3:58 ` [PATCH v3 7/9] iio: adc: ti-ads1262: support triggered buffer sampling Kurt Borja
2026-08-08  4:09   ` sashiko-bot
2026-08-08 18:39   ` David Lechner
2026-08-09  8:28     ` Kurt Borja
2026-08-08  3:58 ` [PATCH v3 8/9] iio: adc: ti-ads1262: support REFOUT and VBIAS regulators Kurt Borja
2026-08-08  4:11   ` sashiko-bot
2026-08-08 18:40   ` David Lechner
2026-08-09  8:28     ` Kurt Borja
2026-08-08  3:58 ` [PATCH v3 9/9] iio: adc: ti-ads1262: support common mode supplies Kurt Borja
2026-08-08 18:40   ` David Lechner
2026-08-09  8:29     ` Kurt Borja
2026-08-08 18:37 ` [PATCH v3 0/9] iio: adc: Add TI ADS126X ADC family support David Lechner
2026-08-09  8:29   ` Kurt Borja

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=ff566148-b3fb-49fc-9e87-6c5a317e1a2f@baylibre.com \
    --to=dlechner@baylibre.com \
    --cc=andy@kernel.org \
    --cc=brgl@kernel.org \
    --cc=conor+dt@kernel.org \
    --cc=devicetree@vger.kernel.org \
    --cc=jic23@kernel.org \
    --cc=krzk+dt@kernel.org \
    --cc=kuurtb@gmail.com \
    --cc=linusw@kernel.org \
    --cc=linux-gpio@vger.kernel.org \
    --cc=linux-iio@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=nuno.sa@analog.com \
    --cc=robh@kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox