Add documentation for Texas Instruments ADS1018 and ADS1118
analog-to-digital converters.
Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>
Signed-off-by: Kurt Borja <kuurtb@gmail.com>
---
.../devicetree/bindings/iio/adc/ti,ads1018.yaml | 82 ++++++++++++++++++++++
MAINTAINERS | 6 ++
2 files changed, 88 insertions(+)
diff --git a/Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml b/Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml
new file mode 100644
index 000000000000..93c9b2921a54
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml
@@ -0,0 +1,82 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/adc/ti,ads1018.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: TI ADS1018/ADS1118 SPI analog to digital converter
+
+maintainers:
+ - Kurt Borja <kuurtb@gmail.com>
+
+description: |
+ The ADS1018/ADS1118 is a precision, low-power, 12-bit or 16-bit, noise-free,
+ analog-to-digital converter (ADC). It integrates a programmable gain amplifier
+ (PGA), voltage reference, oscillator and high-accuracy temperature sensor.
+
+ Datasheets:
+ - ADS1018: https://www.ti.com/lit/ds/symlink/ads1018.pdf
+ - ADS1118: https://www.ti.com/lit/ds/symlink/ads1118.pdf
+
+properties:
+ compatible:
+ enum:
+ - ti,ads1018
+ - ti,ads1118
+
+ reg:
+ maxItems: 1
+
+ vdd-supply: true
+
+ spi-max-frequency:
+ maximum: 4000000
+
+ spi-cpha: true
+
+ interrupts:
+ description: DOUT/DRDY (Data Out/Data Ready) line.
+ maxItems: 1
+
+ drdy-gpios:
+ description:
+ Extra GPIO line connected to DOUT/DRDY (Data Out/Data Ready). This allows
+ distinguishing between interrupts triggered by the data-ready signal and
+ interrupts triggered by an SPI transfer.
+ maxItems: 1
+
+ '#io-channel-cells':
+ const: 1
+
+required:
+ - compatible
+ - reg
+ - vdd-supply
+
+allOf:
+ - $ref: /schemas/spi/spi-peripheral-props.yaml#
+
+unevaluatedProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/irq.h>
+ #include <dt-bindings/gpio/gpio.h>
+
+ spi {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ adc@0 {
+ compatible = "ti,ads1118";
+ reg = <0>;
+
+ spi-max-frequency = <4000000>;
+ spi-cpha;
+
+ vdd-supply = <&vdd_3v3_reg>;
+
+ interrupts-extended = <&gpio 14 IRQ_TYPE_EDGE_FALLING>;
+ drdy-gpios = <&gpio 14 GPIO_ACTIVE_LOW>;
+ };
+ };
diff --git a/MAINTAINERS b/MAINTAINERS
index 31d98efb1ad1..3d5295b5d6eb 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -25646,6 +25646,12 @@ S: Maintained
F: Documentation/devicetree/bindings/iio/adc/ti,ads1119.yaml
F: drivers/iio/adc/ti-ads1119.c
+TI ADS1018 ADC DRIVER
+M: Kurt Borja <kuurtb@gmail.com>
+L: linux-iio@vger.kernel.org
+S: Maintained
+F: Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml
+
TI ADS7924 ADC DRIVER
M: Hugo Villeneuve <hvilleneuve@dimonoff.com>
L: linux-iio@vger.kernel.org
--
2.52.0On Thu, 04 Dec 2025 13:01:27 -0500
Kurt Borja <kuurtb@gmail.com> wrote:
> Add documentation for Texas Instruments ADS1018 and ADS1118
> analog-to-digital converters.
>
> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@oss.qualcomm.com>
> Signed-off-by: Kurt Borja <kuurtb@gmail.com>
A couple of trivial things that aren't worth a respin.
Thanks,
Jonathan
> ---
> .../devicetree/bindings/iio/adc/ti,ads1018.yaml | 82 ++++++++++++++++++++++
> MAINTAINERS | 6 ++
> 2 files changed, 88 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml b/Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml
> new file mode 100644
> index 000000000000..93c9b2921a54
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml
> @@ -0,0 +1,82 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/iio/adc/ti,ads1018.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: TI ADS1018/ADS1118 SPI analog to digital converter
> +
> +maintainers:
> + - Kurt Borja <kuurtb@gmail.com>
> +
> +description: |
> + The ADS1018/ADS1118 is a precision, low-power, 12-bit or 16-bit, noise-free,
If you spin again: 12-bit/16-bit
to align with ADS1018/ADS1118 earlier in the line.
Otherwise it sounds like each can do either mode.
I'd also drop the noise-free. To me that seems overly optimistic marketing and
it doesn't add anything useful.
> + analog-to-digital converter (ADC). It integrates a programmable gain amplifier
> + (PGA), voltage reference, oscillator and high-accuracy temperature sensor.
> +
> + Datasheets:
> + - ADS1018: https://www.ti.com/lit/ds/symlink/ads1018.pdf
> + - ADS1118: https://www.ti.com/lit/ds/symlink/ads1118.pdf
> +
> +properties:
> + compatible:
> + enum:
> + - ti,ads1018
> + - ti,ads1118
> +
> + reg:
> + maxItems: 1
> +
> + vdd-supply: true
> +
> + spi-max-frequency:
> + maximum: 4000000
> +
> + spi-cpha: true
> +
> + interrupts:
> + description: DOUT/DRDY (Data Out/Data Ready) line.
> + maxItems: 1
> +
> + drdy-gpios:
> + description:
> + Extra GPIO line connected to DOUT/DRDY (Data Out/Data Ready). This allows
> + distinguishing between interrupts triggered by the data-ready signal and
> + interrupts triggered by an SPI transfer.
> + maxItems: 1
> +
> + '#io-channel-cells':
> + const: 1
> +
> +required:
> + - compatible
> + - reg
> + - vdd-supply
> +
> +allOf:
> + - $ref: /schemas/spi/spi-peripheral-props.yaml#
> +
> +unevaluatedProperties: false
> +
> +examples:
> + - |
> + #include <dt-bindings/interrupt-controller/irq.h>
> + #include <dt-bindings/gpio/gpio.h>
> +
> + spi {
> + #address-cells = <1>;
> + #size-cells = <0>;
> +
> + adc@0 {
> + compatible = "ti,ads1118";
> + reg = <0>;
> +
> + spi-max-frequency = <4000000>;
> + spi-cpha;
> +
> + vdd-supply = <&vdd_3v3_reg>;
> +
> + interrupts-extended = <&gpio 14 IRQ_TYPE_EDGE_FALLING>;
> + drdy-gpios = <&gpio 14 GPIO_ACTIVE_LOW>;
> + };
> + };
© 2016 - 2025 Red Hat, Inc.