Messages in this thread |  | | From | Jorge Marques <> | | Subject | [PATCH v2 0/9] Add support for AD4062 device family | | Date | Mon, 24 Nov 2025 10:17:59 +0100 |
| |
The AD4060/AD4062 are versatile, 16-bit/12-bit, successive approximation register (SAR) analog-to-digital converter (ADC).
The device uses a 2-wire I3C interface. The device simplifies acquisition by providing 4-bytes in the register map, signal-extending the sample reading accordingly.
The device has autonomous monitoring capabilities, that are exposed as IIO events. Since register access requires leaving the monitoring state and returning, any device access exits monitoring mode, disabling the IIO event.
The device contains two optional outputs:
- gp0: ADC conversion ready signal on the falling edge. The user should either invert the signal or set the IRQ as falling edge. - gp1: Threshold either event interrupt on the rising edge.
The devices utilizes PM to enter the low power mode.
The devices datasheet: https://www.analog.com/media/en/technical-documentation/data-sheets/ad4060.pdf https://www.analog.com/media/en/technical-documentation/data-sheets/ad4062.pdf
The monitoring capabilities, I3C protocol, and multiple GPIOs were the decision factor to have a standalone driver for this device family. The device is expected to work with any I3C Bus. I tested the device with with off-the-shelf I3C controllers STM32H7 (baremetal only) and the open-source ADI I3C Controller (with Linux driver): https://analogdevicesinc.github.io/hdl/library/i3c_controller/index.html ADI I3C Controller lore: https://lore.kernel.org/linux-i3c/175788312841.382502.16653824321627644225.b4-ty@bootlin.com/
The series is divided in 3 blocks, adding: - The base driver. - An software IIO trigger: captures samples continuously. - IIO events support: exposes the device's threshold monitoring capability.
The device internal clock register is exposed twice, as sampling_frequency and events/sampling_frequency, storing in distinct state variables, since the usage (burst averaging mode and monitor mode) cannot be executed at the same time.
Non-implemented features:
- Averaging mode: Similar to burst averaging mode used in the oversampling, but requiring a sequence of CNV triggers for each conversion. - Trigger mode: Similar to monitor mode used in the monitoring mode, but exits to configuration mode on event.
This device is almost identical to AD4052 family, but I decided to submit the AD4062 before re-submitting AD4052 to better contextualize the focus of the device family (high latency, medium-speed protocol, low-power autonomous monitoring rather than high-throughput acquisition).
Depending on the resolution of this driver, the AD4052 family may be added to it, by splitting into ad4062_i3c.c, ad4062_spi.c, ad4062_core.c, or as a standalone driver ad4052.c.
Depends on: https://lore.kernel.org/linux-i3c/aRYLc%2F+KAD13g7T7@lizhi-Precision-Tower-5810/T/#t (for devm ibi clean-up)
Signed-off-by: Jorge Marques <jorge.marques@analog.com> --- Changes in v2: - dt-bindings: * add a short description of all mode that can be configured to during runtime. * add gpio-controller, to expose GPs not listed in interrupt-names as a GPO. - sampling_frequency is the duration of a single sample (convert-start high edge until RDY falling edge) ((n_avg - 1) / fosc + tconv) - Remove .grade from chip_info, since the supported devices have a single speed grade. - Update state buffer to use dma-aligned union of __be32, __be16, u8 bytes[4]. - Use standard IIO_CHAN_INFO_SAMP_FREQ and _AVAIL - Add defines to magic numbers. - Ensure commits only contain code related to the particular commit. - Use new ACQUIRE pm macros. - Drop lock for debugfs, let user mess the state thorugh the debug interface. - Restructure vio, vdd, ref voltages, only read if needed. - Have error handling on top. - Drop unnecessary check_ids error message. - Use devm for IBI remove (requires patch on i3c subystem). - Use heap buffers for all i3c_priv_xfer. - Use CONV_READ if GP1 is routed (less overhead), use CONV_TRIGGER for IBI fallback. - Drop usage pm_runtime_mark_last_busy, since it is now internal to pm_runtime_put_autosuspend - Don't allow access if monitor mode is enabled, return -EBUSY. - Implement gpio-controller to expose GPs not listed in interrupt-names as a GPO. - Value in mv as ``raw * _scale`` (embed caliscale). - Link to v1: https://lore.kernel.org/r/20251013-staging-ad4062-v1-0-0f8ce7fef50c@analog.com
--- Jorge Marques (9): dt-bindings: iio: adc: Add adi,ad4062 docs: iio: New docs for ad4062 driver iio: adc: Add support for ad4062 docs: iio: ad4062: Add IIO Trigger support iio: adc: ad4062: Add IIO Trigger support docs: iio: ad4062: Add IIO Events support iio: adc: ad4062: Add IIO Events support docs: iio: ad4062: Add GPIO Controller support iio: adc: ad4062: Add GPIO Controller support
.../devicetree/bindings/iio/adc/adi,ad4062.yaml | 123 ++ Documentation/iio/ad4062.rst | 154 ++ Documentation/iio/index.rst | 1 + MAINTAINERS | 8 + drivers/iio/adc/Kconfig | 13 + drivers/iio/adc/Makefile | 1 + drivers/iio/adc/ad4062.c | 1531 ++++++++++++++++++++ 7 files changed, 1831 insertions(+) --- base-commit: f9e05791642810a0cf6237d39fafd6fec5e0b4bb change-id: 20251011-staging-ad4062-20d897d33ab6 prerequisite-change-id: 20251112-ibi-unsafe-48f343e178b8:v1 prerequisite-patch-id: 5f04cbbca0fcc3657c7a4d254656b03e289ad222
Best regards, -- Jorge Marques <jorge.marques@analog.com>
|  |