]> git.ipfire.org Git - thirdparty/kernel/linux.git/commitdiff
iio: adc: ad7768-1: add support for ADAQ776x-1 ADC Family
authorJonathan Santos <Jonathan.Santos@analog.com>
Wed, 14 Jan 2026 09:27:29 +0000 (06:27 -0300)
committerJonathan Cameron <Jonathan.Cameron@huawei.com>
Thu, 22 Jan 2026 20:53:18 +0000 (20:53 +0000)
Add support for ADAQ7767/68/69-1 series, which includes PGIA and
Anti-aliasing filter (AAF) gains. Unlike the AD7768-1, they do not
provide a VCM regulator interface.

The PGA gain is configured in run-time through the scale attribute,
if supported by the device. PGA is controlled by GPIOs provided in
the device tree.

The AAF gain is defined by hardware connections and should be specified
in the device tree.

Signed-off-by: Jonathan Santos <Jonathan.Santos@analog.com>
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
drivers/iio/adc/Kconfig
drivers/iio/adc/ad7768-1.c

index b4295aa415bf7857c76ef7cf63e6a12c2a6e16ca..60038ae8dfc4d13a033190af6b0e1070dacea58c 100644 (file)
@@ -411,6 +411,7 @@ config AD7768_1
        depends on SPI
        select REGULATOR
        select REGMAP_SPI
+       select RATIONAL
        select IIO_BUFFER
        select IIO_TRIGGER
        select IIO_TRIGGERED_BUFFER
index bd4b2e090c5bb39bc43acf3b78e7088249c3627d..980c079ab41ae7ab08d902b84666ed24819d7389 100644 (file)
@@ -6,6 +6,7 @@
  */
 #include <linux/array_size.h>
 #include <linux/bitfield.h>
+#include <linux/cleanup.h>
 #include <linux/clk.h>
 #include <linux/completion.h>
 #include <linux/delay.h>
 #include <linux/gpio/driver.h>
 #include <linux/gpio/consumer.h>
 #include <linux/interrupt.h>
+#include <linux/limits.h>
+#include <linux/math.h>
 #include <linux/minmax.h>
 #include <linux/module.h>
+#include <linux/mutex.h>
+#include <linux/rational.h>
 #include <linux/regmap.h>
 #include <linux/regulator/consumer.h>
 #include <linux/regulator/driver.h>
 
 #define AD7768_VCM_OFF                 0x07
 
+#define ADAQ776X_GAIN_MAX_NANO         (128 * NANO)
+#define ADAQ776X_MAX_GAIN_MODES                8
+
 #define AD7768_TRIGGER_SOURCE_SYNC_IDX 0
 
 #define AD7768_MAX_CHANNELS 1
 
+#define ADAQ7768_PGA_PINS 3
+
 enum ad7768_conv_mode {
        AD7768_CONTINUOUS,
        AD7768_ONE_SHOT,
@@ -153,6 +163,51 @@ enum ad7768_scan_type {
        AD7768_SCAN_TYPE_HIGH_SPEED,
 };
 
+enum {
+       AD7768_PGA_GAIN_0,
+       AD7768_PGA_GAIN_1,
+       AD7768_PGA_GAIN_2,
+       AD7768_PGA_GAIN_3,
+       AD7768_PGA_GAIN_4,
+       AD7768_PGA_GAIN_5,
+       AD7768_PGA_GAIN_6,
+       AD7768_PGA_GAIN_7,
+};
+
+enum {
+       AD7768_AAF_IN1,
+       AD7768_AAF_IN2,
+       AD7768_AAF_IN3,
+};
+
+/* PGA and AAF gains in V/V */
+static const int adaq7768_gains[] = {
+       [AD7768_PGA_GAIN_0] = 325,      /* 0.325 */
+       [AD7768_PGA_GAIN_1] = 650,      /* 0.650 */
+       [AD7768_PGA_GAIN_2] = 1300,     /* 1.300 */
+       [AD7768_PGA_GAIN_3] = 2600,     /* 2.600 */
+       [AD7768_PGA_GAIN_4] = 5200,     /* 5.200 */
+       [AD7768_PGA_GAIN_5] = 10400,    /* 10.400 */
+       [AD7768_PGA_GAIN_6] = 20800,    /* 20.800 */
+};
+
+static const int adaq7769_gains[] = {
+       [AD7768_PGA_GAIN_0] = 1000,     /* 1.000 */
+       [AD7768_PGA_GAIN_1] = 2000,     /* 2.000 */
+       [AD7768_PGA_GAIN_2] = 4000,     /* 4.000 */
+       [AD7768_PGA_GAIN_3] = 8000,     /* 8.000 */
+       [AD7768_PGA_GAIN_4] = 16000,    /* 16.000 */
+       [AD7768_PGA_GAIN_5] = 32000,    /* 32.000 */
+       [AD7768_PGA_GAIN_6] = 64000,    /* 64.000 */
+       [AD7768_PGA_GAIN_7] = 128000,   /* 128.000 */
+};
+
+static const int ad7768_aaf_gains_bp[] = {
+       [AD7768_AAF_IN1] = 10000,       /* 1.000 */
+       [AD7768_AAF_IN2] = 3640,        /* 0.364 */
+       [AD7768_AAF_IN3] = 1430,        /* 0.143 */
+};
+
 /* -3dB cutoff frequency multipliers (relative to ODR) for each filter type. */
 static const int ad7768_filter_3db_odr_multiplier[] = {
        [AD7768_FILTER_SINC5] = 204,            /* 0.204 */
@@ -217,6 +272,13 @@ struct ad7768_chip_info {
        const char *name;
        const struct iio_chan_spec *channel_spec;
        int num_channels;
+       const int *pga_gains;
+       int num_pga_modes;
+       int default_pga_mode;
+       int pgia_mode2pin_offset;
+       bool has_pga;
+       bool has_variable_aaf;
+       bool has_vcm_regulator;
 };
 
 struct ad7768_state {
@@ -234,14 +296,19 @@ struct ad7768_state {
        unsigned int samp_freq;
        unsigned int samp_freq_avail[ARRAY_SIZE(ad7768_mclk_div_rates)];
        unsigned int samp_freq_avail_len;
+       unsigned int pga_gain_mode;
+       unsigned int aaf_gain;
+       int scale_tbl[ADAQ776X_MAX_GAIN_MODES][2];
        struct completion completion;
        struct iio_trigger *trig;
+       struct gpio_descs *pga_gpios;
        struct gpio_desc *gpio_sync_in;
        struct gpio_desc *gpio_reset;
        const char *labels[AD7768_MAX_CHANNELS];
        struct gpio_chip gpiochip;
        const struct ad7768_chip_info *chip;
        bool en_spi_sync;
+       struct mutex pga_lock; /* protect device internal state (PGA) */
        /*
         * DMA (thus cache coherency maintenance) may require the
         * transfer buffers to live in their own cache lines.
@@ -464,6 +531,42 @@ static int ad7768_reg_access(struct iio_dev *indio_dev,
        return ret;
 }
 
+static void ad7768_fill_scale_tbl(struct iio_dev *dev)
+{
+       struct ad7768_state *st = iio_priv(dev);
+       const struct iio_scan_type *scan_type;
+       int val, val2, tmp0, tmp1, i;
+       struct u32_fract fract;
+       unsigned long n, d;
+       u64 tmp2;
+
+       scan_type = iio_get_current_scan_type(dev, &dev->channels[0]);
+       if (scan_type->sign == 's')
+               val2 = scan_type->realbits - 1;
+       else
+               val2 = scan_type->realbits;
+
+       for (i = 0; i < st->chip->num_pga_modes; i++) {
+               /* Convert gain to a fraction format */
+               fract.numerator = st->chip->pga_gains[i];
+               fract.denominator = MILLI;
+               if (st->chip->has_variable_aaf) {
+                       fract.numerator *= ad7768_aaf_gains_bp[st->aaf_gain];
+                       fract.denominator *= PERMYRIAD;
+               }
+
+               rational_best_approximation(fract.numerator, fract.denominator,
+                                           INT_MAX, INT_MAX, &n, &d);
+
+               val = mult_frac(st->vref_uv, d, n);
+               /* Would multiply by NANO here, but value is already in milli */
+               tmp2 = ((u64)val * MICRO) >> val2;
+               tmp0 = div_u64_rem(tmp2, NANO, &tmp1);
+               st->scale_tbl[i][0] = tmp0; /* Integer part */
+               st->scale_tbl[i][1] = abs(tmp1); /* Fractional part */
+       }
+}
+
 static int ad7768_set_sinc3_dec_rate(struct ad7768_state *st,
                                     unsigned int dec_rate)
 {
@@ -565,12 +668,66 @@ static int ad7768_configure_dig_fil(struct iio_dev *dev,
                st->oversampling_ratio = ad7768_dec_rate_values[dec_rate_idx];
        }
 
+       /* Update scale table: scale values vary according to the precision */
+       ad7768_fill_scale_tbl(dev);
+
        ad7768_fill_samp_freq_tbl(st);
 
        /* A sync-in pulse is required after every configuration change */
        return ad7768_send_sync_pulse(st);
 }
 
+static int ad7768_setup_pga(struct device *dev, struct ad7768_state *st)
+{
+       st->pga_gpios = devm_gpiod_get_array(dev, "pga", GPIOD_OUT_LOW);
+       if (IS_ERR(st->pga_gpios))
+               return dev_err_probe(dev, PTR_ERR(st->pga_gpios),
+                                    "Failed to get PGA gpios.\n");
+
+       if (st->pga_gpios->ndescs != ADAQ7768_PGA_PINS)
+               return dev_err_probe(dev, -EINVAL,
+                                    "Expected %d GPIOs for PGA control.\n",
+                                    ADAQ7768_PGA_PINS);
+       return 0;
+}
+
+static int ad7768_calc_pga_gain(struct ad7768_state *st, int gain_int,
+                               int gain_fract, int precision)
+{
+       u64 gain_nano;
+       u32 tmp;
+
+       gain_nano = gain_int * NANO + gain_fract;
+       gain_nano = clamp(gain_nano, 0, ADAQ776X_GAIN_MAX_NANO);
+       tmp = DIV_ROUND_CLOSEST_ULL(gain_nano << precision, NANO);
+       gain_nano = DIV_ROUND_CLOSEST(st->vref_uv, tmp);
+       if (st->chip->has_variable_aaf)
+               gain_nano = DIV_ROUND_CLOSEST_ULL(gain_nano * PERMYRIAD,
+                                                 ad7768_aaf_gains_bp[st->aaf_gain]);
+
+       return find_closest(gain_nano, st->chip->pga_gains,
+                           (int)st->chip->num_pga_modes);
+}
+
+static int ad7768_set_pga_gain(struct ad7768_state *st,
+                              int gain_mode)
+{
+       int pgia_pins_value = abs(gain_mode - st->chip->pgia_mode2pin_offset);
+       DECLARE_BITMAP(bitmap, ADAQ7768_PGA_PINS) = { };
+       int ret;
+
+       guard(mutex)(&st->pga_lock);
+
+       bitmap_write(bitmap, pgia_pins_value, 0, ADAQ7768_PGA_PINS);
+       ret = gpiod_multi_set_value_cansleep(st->pga_gpios, bitmap);
+       if (ret)
+               return ret;
+
+       st->pga_gain_mode = gain_mode;
+
+       return 0;
+}
+
 static int ad7768_gpio_direction_input(struct gpio_chip *chip, unsigned int offset)
 {
        struct iio_dev *indio_dev = gpiochip_get_data(chip);
@@ -792,6 +949,10 @@ static const struct iio_chan_spec ad7768_channels[] = {
        AD7768_CHAN(0, 0),
 };
 
+static const struct iio_chan_spec adaq776x_channels[] = {
+       AD7768_CHAN(0, BIT(IIO_CHAN_INFO_SCALE)),
+};
+
 static int ad7768_read_raw(struct iio_dev *indio_dev,
                           struct iio_chan_spec const *chan,
                           int *val, int *val2, long info)
@@ -819,7 +980,19 @@ static int ad7768_read_raw(struct iio_dev *indio_dev,
                return IIO_VAL_INT;
 
        case IIO_CHAN_INFO_SCALE:
-               *val = (st->vref_uv * 2) / 1000;
+               if (st->chip->has_pga) {
+                       guard(mutex)(&st->pga_lock);
+
+                       *val = st->scale_tbl[st->pga_gain_mode][0];
+                       *val2 = st->scale_tbl[st->pga_gain_mode][1];
+                       return IIO_VAL_INT_PLUS_NANO;
+               }
+
+               temp = (st->vref_uv * 2) / 1000;
+               if (st->chip->has_variable_aaf)
+                       temp = (temp * PERMYRIAD) / ad7768_aaf_gains_bp[st->aaf_gain];
+
+               *val = temp;
                *val2 = scan_type->realbits;
 
                return IIO_VAL_FRACTIONAL_LOG2;
@@ -875,18 +1048,39 @@ static int ad7768_read_avail(struct iio_dev *indio_dev,
                *length = st->samp_freq_avail_len;
                *type = IIO_VAL_INT;
                return IIO_AVAIL_LIST;
+       case IIO_CHAN_INFO_SCALE:
+               *vals = (int *)st->scale_tbl;
+               *length = st->chip->num_pga_modes * 2;
+               *type = IIO_VAL_INT_PLUS_NANO;
+               return IIO_AVAIL_LIST;
        default:
                return -EINVAL;
        }
 }
 
+static int ad7768_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_INT_PLUS_NANO;
+       default:
+               return IIO_VAL_INT_PLUS_MICRO;
+       }
+}
+
 static int ad7768_write_raw(struct iio_dev *indio_dev,
                            struct iio_chan_spec const *chan,
                            int val, int val2, long info)
 {
        struct ad7768_state *st = iio_priv(indio_dev);
+       const struct iio_scan_type *scan_type;
        int ret;
 
+       scan_type = iio_get_current_scan_type(indio_dev, chan);
+       if (IS_ERR(scan_type))
+               return PTR_ERR(scan_type);
+
        switch (info) {
        case IIO_CHAN_INFO_SAMP_FREQ:
                if (!iio_device_claim_direct(indio_dev))
@@ -902,6 +1096,21 @@ static int ad7768_write_raw(struct iio_dev *indio_dev,
                ret = ad7768_update_dec_rate(indio_dev, val);
                iio_device_release_direct(indio_dev);
                return ret;
+       case IIO_CHAN_INFO_SCALE: {
+               int gain_mode;
+
+               if (!st->chip->has_pga)
+                       return -EOPNOTSUPP;
+
+               if (scan_type->sign == 's')
+                       gain_mode = ad7768_calc_pga_gain(st, val, val2,
+                                                        scan_type->realbits - 1);
+               else
+                       gain_mode = ad7768_calc_pga_gain(st, val, val2,
+                                                        scan_type->realbits);
+
+               return ad7768_set_pga_gain(st, gain_mode);
+       }
        default:
                return -EINVAL;
        }
@@ -928,6 +1137,7 @@ static const struct iio_info ad7768_info = {
        .read_raw = &ad7768_read_raw,
        .read_avail = &ad7768_read_avail,
        .write_raw = &ad7768_write_raw,
+       .write_raw_get_fmt = &ad7768_write_raw_get_fmt,
        .read_label = ad7768_read_label,
        .get_current_scan_type = &ad7768_get_current_scan_type,
        .debugfs_reg_access = &ad7768_reg_access,
@@ -1311,8 +1521,9 @@ static const struct regulator_desc vcm_desc = {
        .owner = THIS_MODULE,
 };
 
-static int ad7768_register_regulators(struct device *dev, struct ad7768_state *st,
-                                     struct iio_dev *indio_dev)
+static int ad7768_register_vcm_regulator(struct device *dev,
+                                        struct ad7768_state *st,
+                                        struct iio_dev *indio_dev)
 {
        struct regulator_config config = {
                .dev = dev,
@@ -1334,10 +1545,77 @@ static int ad7768_register_regulators(struct device *dev, struct ad7768_state *s
        return 0;
 }
 
+static int ad7768_parse_aaf_gain(struct device *dev, struct ad7768_state *st)
+{
+       u32 val;
+       int ret;
+
+       ret = device_property_read_u32(dev, "adi,aaf-gain-bp", &val);
+       if (ret == -EINVAL) {
+               /* If controllable, use default */
+               if (st->chip->has_variable_aaf)
+                       st->aaf_gain = AD7768_AAF_IN1;
+               return 0;
+       }
+       if (ret)
+               return dev_err_probe(dev, ret, "Failed to get AAF gain value\n");
+
+       if (!st->chip->has_variable_aaf)
+               return dev_err_probe(dev, -EOPNOTSUPP,
+                                    "AAF gain provided, but not supported for %s\n", st->chip->name);
+
+       switch (val) {
+       case 10000:
+               st->aaf_gain = AD7768_AAF_IN1;
+               break;
+       case 3640:
+               st->aaf_gain = AD7768_AAF_IN2;
+               break;
+       case 1430:
+               st->aaf_gain = AD7768_AAF_IN3;
+               break;
+       default:
+               return dev_err_probe(dev, -EINVAL, "Invalid firmware provided AAF gain\n");
+       }
+
+       return 0;
+}
+
 static const struct ad7768_chip_info ad7768_chip_info = {
        .name = "ad7768-1",
        .channel_spec = ad7768_channels,
        .num_channels = ARRAY_SIZE(ad7768_channels),
+       .has_vcm_regulator = true,
+};
+
+static const struct ad7768_chip_info adaq7767_chip_info = {
+       .name = "adaq7767-1",
+       .channel_spec = ad7768_channels,
+       .num_channels = ARRAY_SIZE(ad7768_channels),
+       .has_variable_aaf = true,
+};
+
+static const struct ad7768_chip_info adaq7768_chip_info = {
+       .name = "adaq7768-1",
+       .channel_spec = adaq776x_channels,
+       .num_channels = ARRAY_SIZE(adaq776x_channels),
+       .pga_gains = adaq7768_gains,
+       .default_pga_mode = AD7768_PGA_GAIN_2,
+       .num_pga_modes = ARRAY_SIZE(adaq7768_gains),
+       .pgia_mode2pin_offset = 6,
+       .has_pga = true,
+};
+
+static const struct ad7768_chip_info adaq7769_chip_info = {
+       .name = "adaq7769-1",
+       .channel_spec = adaq776x_channels,
+       .num_channels = ARRAY_SIZE(adaq776x_channels),
+       .pga_gains = adaq7769_gains,
+       .default_pga_mode = AD7768_PGA_GAIN_0,
+       .num_pga_modes = ARRAY_SIZE(adaq7769_gains),
+       .pgia_mode2pin_offset = 0,
+       .has_pga = true,
+       .has_variable_aaf = true,
 };
 
 static int ad7768_probe(struct spi_device *spi)
@@ -1398,7 +1676,13 @@ static int ad7768_probe(struct spi_device *spi)
        indio_dev->modes = INDIO_DIRECT_MODE;
 
        /* Register VCM output regulator */
-       ret = ad7768_register_regulators(&spi->dev, st, indio_dev);
+       if (st->chip->has_vcm_regulator) {
+               ret = ad7768_register_vcm_regulator(&spi->dev, st, indio_dev);
+               if (ret)
+                       return ret;
+       }
+
+       ret = ad7768_parse_aaf_gain(&spi->dev, st);
        if (ret)
                return ret;
 
@@ -1409,6 +1693,19 @@ static int ad7768_probe(struct spi_device *spi)
        }
 
        init_completion(&st->completion);
+       ret = devm_mutex_init(&spi->dev, &st->pga_lock);
+       if (ret)
+               return ret;
+
+       if (st->chip->has_pga) {
+               ret = ad7768_setup_pga(&spi->dev, st);
+               if (ret)
+                       return ret;
+
+               ret = ad7768_set_pga_gain(st, st->chip->default_pga_mode);
+               if (ret)
+                       return ret;
+       }
 
        ret = ad7768_set_channel_label(indio_dev, st->chip->num_channels);
        if (ret)
@@ -1430,12 +1727,18 @@ static int ad7768_probe(struct spi_device *spi)
 
 static const struct spi_device_id ad7768_id_table[] = {
        { "ad7768-1", (kernel_ulong_t)&ad7768_chip_info },
+       { "adaq7767-1", (kernel_ulong_t)&adaq7767_chip_info },
+       { "adaq7768-1", (kernel_ulong_t)&adaq7768_chip_info },
+       { "adaq7769-1", (kernel_ulong_t)&adaq7769_chip_info },
        { }
 };
 MODULE_DEVICE_TABLE(spi, ad7768_id_table);
 
 static const struct of_device_id ad7768_of_match[] = {
        { .compatible = "adi,ad7768-1", .data = &ad7768_chip_info },
+       { .compatible = "adi,adaq7767-1", .data = &adaq7767_chip_info },
+       { .compatible = "adi,adaq7768-1", .data = &adaq7768_chip_info },
+       { .compatible = "adi,adaq7769-1", .data = &adaq7769_chip_info },
        { }
 };
 MODULE_DEVICE_TABLE(of, ad7768_of_match);