iio/adc/adi%2Cad7944.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Michael Hennerich <Michael.Hennerich@analog.com>
11   - Nuno Sá <nuno.sa@analog.com>
14   A family of pin-compatible single channel differential analog to digital
15   converters with SPI support in a LFCSP package.
21 $ref: /schemas/spi/spi-peripheral-props.yaml#
26       - adi,ad7944
27       - adi,ad7985
28       - adi,ad7986
33   spi-max-frequency:
36   spi-cpol: true
37   spi-cpha: true
39   adi,spi-mode:
43       This property indicates the SPI wiring configuration.
46       the datasheet calls "4-wire mode". This is the conventional SPI mode used
49       CS on the SPI controller.
54       * single: The datasheet calls this "3-wire mode". (NOTE: The datasheet's
55         definition of 3-wire mode is NOT at all related to the standard
56         spi-3wire property!) This mode is often used when the ADC is the only
58         can be connected to the CS line of the SPI controller or to a GPIO, in
59         which case the CS line of the controller is unused.
64         chain is connected to the SPI bus. The CNV line of all chips are tied
65         together. The CS line of the SPI controller can be used as the CNV line
66         only if it is active high.
68   '#daisy-chained-devices': true
70   avdd-supply:
73   dvdd-supply:
76   vio-supply:
80   bvdd-supply:
83       without an internal buffer (PDREF high, REFIN low), this should be
84       connected to the same supply as ref-supply. Otherwise, when using an
88   ref-supply:
93   refin-supply:
100   cnv-gpios:
103       the conversions and selects the SPI mode of the device (chain or CS). In
105       CS line of the SPI controller.
108   turbo-gpios:
111       line is hard-wired and the state is determined by the adi,always-turbo
115   adi,always-turbo:
118       When present, this property indicates that the TURBO line is hard-wired
119       and the state is always high. If neither this property nor turbo-gpios is
120       present, the TURBO line is assumed to be hard-wired and the state is
127       while the SDI line is high and the CNV line is low ('single' mode) or the
128       SDI line is low and the CNV line is high ('multi' mode); or when the SDO
129       line goes high while the SDI and CNV lines are high (chain mode),
133   - compatible
134   - reg
135   - avdd-supply
136   - dvdd-supply
137   - vio-supply
138   - bvdd-supply
141   # ref-supply and refin-supply are mutually exclusive (neither is also valid)
142   - if:
144         - ref-supply
147         refin-supply: false
148   - if:
150         - refin-supply
153         ref-supply: false
154   # in '4-wire' mode, cnv-gpios is required, for other modes it is optional
155   - if:
158           - adi,spi-mode
161         - cnv-gpios
163   - if:
165         - adi,spi-mode
167         adi,spi-mode:
171         spi-max-frequency:
173         adi,always-turbo: false
175         - '#daisy-chained-devices'
178         '#daisy-chained-devices': false
179   # turbo-gpios and adi,always-turbo are mutually exclusive
180   - if:
182         - turbo-gpios
185         adi,always-turbo: false
186   - if:
188         - adi,always-turbo
191         turbo-gpios: false
196   - |
197     #include <dt-bindings/gpio/gpio.h>
198     spi {
199         #address-cells = <1>;
200         #size-cells = <0>;
204             spi-cpha;
205             spi-max-frequency = <111111111>;
206             avdd-supply = <&supply_2_5V>;
207             dvdd-supply = <&supply_2_5V>;
208             vio-supply = <&supply_1_8V>;
209             bvdd-supply = <&supply_5V>;
210             cnv-gpios = <&gpio 0 GPIO_ACTIVE_HIGH>;
211             turbo-gpios = <&gpio 1 GPIO_ACTIVE_HIGH>;