xref: /freebsd/sys/contrib/device-tree/Bindings/iio/adc/adi,ad7780.yaml (revision 5ca8e32633c4ffbbcd6762e5888b6a4ba0708c6c) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/iio/adc/adi,ad7780.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Analog Devices AD7170/AD7171/AD7780/AD7781 analog to digital converters
8
9maintainers:
10  - Michael Hennerich <michael.hennerich@analog.com>
11
12description: |
13  The ad7780 is a sigma-delta analog to digital converter. This driver provides
14  reading voltage values and status bits from both the ad778x and ad717x series.
15  Its interface also allows writing on the FILTER and GAIN GPIO pins on the
16  ad778x.
17
18  Specifications on the converters can be found at:
19    AD7170:
20      https://www.analog.com/media/en/technical-documentation/data-sheets/AD7170.pdf
21    AD7171:
22      https://www.analog.com/media/en/technical-documentation/data-sheets/AD7171.pdf
23    AD7780:
24      https://www.analog.com/media/en/technical-documentation/data-sheets/ad7780.pdf
25    AD7781:
26      https://www.analog.com/media/en/technical-documentation/data-sheets/AD7781.pdf
27
28properties:
29  compatible:
30    enum:
31      - adi,ad7170
32      - adi,ad7171
33      - adi,ad7780
34      - adi,ad7781
35
36  reg:
37    maxItems: 1
38
39  avdd-supply:
40    description:
41      The regulator supply for the ADC reference voltage.
42
43  powerdown-gpios:
44    description:
45      Must be the device tree identifier of the PDRST pin. If
46      specified, it will be asserted during driver probe. As the
47      line is active high, it should be marked GPIO_ACTIVE_HIGH.
48    maxItems: 1
49
50  adi,gain-gpios:
51    description:
52      Must be the device tree identifier of the GAIN pin. Only for
53      the ad778x chips. If specified, it will be asserted during
54      driver probe. As the line is active low, it should be marked
55      GPIO_ACTIVE_LOW.
56    maxItems: 1
57
58  adi,filter-gpios:
59    description:
60      Must be the device tree identifier of the FILTER pin. Only
61      for the ad778x chips. If specified, it will be asserted
62      during driver probe. As the line is active low, it should be
63      marked GPIO_ACTIVE_LOW.
64    maxItems: 1
65
66required:
67  - compatible
68  - reg
69
70additionalProperties: false
71
72examples:
73  - |
74    #include <dt-bindings/gpio/gpio.h>
75    spi {
76        #address-cells = <1>;
77        #size-cells = <0>;
78
79        adc@0 {
80            compatible = "adi,ad7780";
81            reg = <0>;
82
83            avdd-supply      = <&vdd_supply>;
84            powerdown-gpios  = <&gpio0 12 GPIO_ACTIVE_HIGH>;
85            adi,gain-gpios   = <&gpio1  5 GPIO_ACTIVE_LOW>;
86            adi,filter-gpios = <&gpio2 15 GPIO_ACTIVE_LOW>;
87        };
88    };
89