xref: /linux/Documentation/devicetree/bindings/iio/adc/adi,ad7779.yaml (revision c34e9ab9a612ee8b18273398ef75c207b01f516d) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/iio/adc/adi,ad7779.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Analog Devices AD777X family 8-Channel, 24-Bit, Simultaneous Sampling ADCs
8
9maintainers:
10  - Ramona Nechita <ramona.nechita@analog.com>
11
12description: |
13  The AD777X family consist of 8-channel, simultaneous sampling analog-to-
14  digital converter (ADC). Eight full Σ-Δ ADCs are on-chip. The
15  AD7771 provides an ultralow input current to allow direct sensor
16  connection. Each input channel has a programmable gain stage
17  allowing gains of 1, 2, 4, and 8 to map lower amplitude sensor
18  outputs into the full-scale ADC input range, maximizing the
19  dynamic range of the signal chain.
20
21  https://www.analog.com/media/en/technical-documentation/data-sheets/ad7770.pdf
22  https://www.analog.com/media/en/technical-documentation/data-sheets/ad7771.pdf
23  https://www.analog.com/media/en/technical-documentation/data-sheets/ad7779.pdf
24
25$ref: /schemas/spi/spi-peripheral-props.yaml#
26
27properties:
28  compatible:
29    enum:
30      - adi,ad7770
31      - adi,ad7771
32      - adi,ad7779
33
34  reg:
35    maxItems: 1
36
37  '#address-cells':
38    const: 1
39
40  '#size-cells':
41    const: 0
42
43  clocks:
44    maxItems: 1
45
46  avdd1-supply:
47    description: Front-End analog supply AVDD1. Can be used as conversion ref.
48
49  avdd2-supply:
50    description: AVDD2 Analog Supply from 2.2 V to 3.6 V.
51
52  avdd4-supply:
53    description: AVDD4 SAR Analog Supply and Reference Source.
54
55  interrupts:
56    minItems: 1
57    items:
58      - description: |
59          adc_rdy: Interrupt line for DRDY signal which indicates the end of
60          conversion independently of the interface selected to read back the
61          Σ-∆ conversion.
62      - description: |
63          Alert: The chip includes self diagnostic features to guarantee the
64          correct operation. If an error is detected, the ALERT pin is pulled
65          high to generate an external interruption to the controller.
66
67  interrupt-names:
68    minItems: 1
69    maxItems: 2
70    items:
71      enum:
72        - adc_rdy
73        - alert
74
75  start-gpios:
76    description:
77      Pin that controls start synchronization pulse.
78    maxItems: 1
79
80  reset-gpios:
81    maxItems: 1
82
83required:
84  - compatible
85  - reg
86  - clocks
87  - interrupts
88
89unevaluatedProperties: false
90
91examples:
92  - |
93    #include <dt-bindings/gpio/gpio.h>
94    #include <dt-bindings/interrupt-controller/irq.h>
95    spi {
96        #address-cells = <1>;
97        #size-cells = <0>;
98
99        adc@0 {
100          compatible = "adi,ad7779";
101          reg = <0>;
102          start-gpios = <&gpio0 87 GPIO_ACTIVE_LOW>;
103          reset-gpios = <&gpio0 93 GPIO_ACTIVE_LOW>;
104          interrupt-parent = <&intc>;
105          interrupts = <0 56 IRQ_TYPE_LEVEL_HIGH>;
106          interrupt-names = "adc_rdy";
107          clocks = <&adc_clk>;
108        };
109    };
110...
111