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:
46       the datasheet calls "4-wire mode". This is the conventional SPI mode used
47       when there are multiple devices on the same bus. In this mode, the CNV
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
57         device on the bus. In this mode, SDI is tied to VIO, and the CNV line
58         can be connected to the CS line of the SPI controller or to a GPIO, in
61         on wiring when multiple ADCs are used. In this mode, the SDI line of
62         one chip is tied to the SDO of the next chip in the chain and the SDI of
63         the last chip in the chain is tied to GND. Only the first chip in the
68   '#daisy-chained-devices': true
70   avdd-supply:
71     description: A 2.5V supply that powers the analog circuitry.
73   dvdd-supply:
74     description: A 2.5V supply that powers the digital circuitry.
76   vio-supply:
78       A 1.8V to 2.7V supply for the digital inputs and outputs.
80   bvdd-supply:
82       A voltage supply for the buffered power. When using an external reference
84       connected to the same supply as ref-supply. Otherwise, when using an
86       is connected to a 5V supply.
88   ref-supply:
93   refin-supply:
97       1.2V external reference voltage supply. Otherwise, this property is
100   cnv-gpios:
103       the conversions and selects the SPI mode of the device (chain or CS). In
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
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>
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>;