xref: /linux/Documentation/devicetree/bindings/iio/adc/ti,ads1018.yaml (revision c17ee635fd3a482b2ad2bf5e269755c2eae5f25e)
1*43fabbb9SKurt Borja# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*43fabbb9SKurt Borja%YAML 1.2
3*43fabbb9SKurt Borja---
4*43fabbb9SKurt Borja$id: http://devicetree.org/schemas/iio/adc/ti,ads1018.yaml#
5*43fabbb9SKurt Borja$schema: http://devicetree.org/meta-schemas/core.yaml#
6*43fabbb9SKurt Borja
7*43fabbb9SKurt Borjatitle: TI ADS1018/ADS1118 SPI analog to digital converter
8*43fabbb9SKurt Borja
9*43fabbb9SKurt Borjamaintainers:
10*43fabbb9SKurt Borja  - Kurt Borja <kuurtb@gmail.com>
11*43fabbb9SKurt Borja
12*43fabbb9SKurt Borjadescription: |
13*43fabbb9SKurt Borja  The ADS1018/ADS1118 is a precision, low-power, 12-bit/16-bit, analog to
14*43fabbb9SKurt Borja  digital converter (ADC). It integrates a programmable gain amplifier (PGA),
15*43fabbb9SKurt Borja  internal voltage reference, oscillator and high-accuracy temperature sensor.
16*43fabbb9SKurt Borja
17*43fabbb9SKurt Borja  Datasheets:
18*43fabbb9SKurt Borja    - ADS1018: https://www.ti.com/lit/ds/symlink/ads1018.pdf
19*43fabbb9SKurt Borja    - ADS1118: https://www.ti.com/lit/ds/symlink/ads1118.pdf
20*43fabbb9SKurt Borja
21*43fabbb9SKurt Borjaproperties:
22*43fabbb9SKurt Borja  compatible:
23*43fabbb9SKurt Borja    enum:
24*43fabbb9SKurt Borja      - ti,ads1018
25*43fabbb9SKurt Borja      - ti,ads1118
26*43fabbb9SKurt Borja
27*43fabbb9SKurt Borja  reg:
28*43fabbb9SKurt Borja    maxItems: 1
29*43fabbb9SKurt Borja
30*43fabbb9SKurt Borja  vdd-supply: true
31*43fabbb9SKurt Borja
32*43fabbb9SKurt Borja  spi-max-frequency:
33*43fabbb9SKurt Borja    maximum: 4000000
34*43fabbb9SKurt Borja
35*43fabbb9SKurt Borja  spi-cpha: true
36*43fabbb9SKurt Borja
37*43fabbb9SKurt Borja  interrupts:
38*43fabbb9SKurt Borja    description: DOUT/DRDY (Data Out/Data Ready) line.
39*43fabbb9SKurt Borja    maxItems: 1
40*43fabbb9SKurt Borja
41*43fabbb9SKurt Borja  drdy-gpios:
42*43fabbb9SKurt Borja    description:
43*43fabbb9SKurt Borja      Extra GPIO line connected to DOUT/DRDY (Data Out/Data Ready). This allows
44*43fabbb9SKurt Borja      distinguishing between interrupts triggered by the data-ready signal and
45*43fabbb9SKurt Borja      interrupts triggered by an SPI transfer.
46*43fabbb9SKurt Borja    maxItems: 1
47*43fabbb9SKurt Borja
48*43fabbb9SKurt Borja  '#io-channel-cells':
49*43fabbb9SKurt Borja    const: 1
50*43fabbb9SKurt Borja
51*43fabbb9SKurt Borjarequired:
52*43fabbb9SKurt Borja  - compatible
53*43fabbb9SKurt Borja  - reg
54*43fabbb9SKurt Borja  - vdd-supply
55*43fabbb9SKurt Borja
56*43fabbb9SKurt BorjaallOf:
57*43fabbb9SKurt Borja  - $ref: /schemas/spi/spi-peripheral-props.yaml#
58*43fabbb9SKurt Borja
59*43fabbb9SKurt BorjaunevaluatedProperties: false
60*43fabbb9SKurt Borja
61*43fabbb9SKurt Borjaexamples:
62*43fabbb9SKurt Borja  - |
63*43fabbb9SKurt Borja    #include <dt-bindings/interrupt-controller/irq.h>
64*43fabbb9SKurt Borja    #include <dt-bindings/gpio/gpio.h>
65*43fabbb9SKurt Borja
66*43fabbb9SKurt Borja    spi {
67*43fabbb9SKurt Borja        #address-cells = <1>;
68*43fabbb9SKurt Borja        #size-cells = <0>;
69*43fabbb9SKurt Borja
70*43fabbb9SKurt Borja        adc@0 {
71*43fabbb9SKurt Borja            compatible = "ti,ads1118";
72*43fabbb9SKurt Borja            reg = <0>;
73*43fabbb9SKurt Borja
74*43fabbb9SKurt Borja            spi-max-frequency = <4000000>;
75*43fabbb9SKurt Borja            spi-cpha;
76*43fabbb9SKurt Borja
77*43fabbb9SKurt Borja            vdd-supply = <&vdd_3v3_reg>;
78*43fabbb9SKurt Borja
79*43fabbb9SKurt Borja            interrupts-extended = <&gpio 14 IRQ_TYPE_EDGE_FALLING>;
80*43fabbb9SKurt Borja            drdy-gpios = <&gpio 14 GPIO_ACTIVE_LOW>;
81*43fabbb9SKurt Borja        };
82*43fabbb9SKurt Borja    };
83