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

7
title: Analog Devices AD777X family 8-Channel, 24-Bit, Simultaneous Sampling ADCs
8

9
maintainers:
10
  - Ramona Nechita <ramona.nechita@analog.com>
11

12
description: |
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

27
properties:
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

83
  io-backends:
84
    maxItems: 1
85

86
  adi,num-lanes:
87
    description:
88
      Number of lanes on which the data is sent on the output when the data
89
      output interface is used.
90
    $ref: /schemas/types.yaml#/definitions/uint32
91
    enum: [1, 2, 4]
92
    default: 4
93

94
required:
95
  - compatible
96
  - reg
97
  - clocks
98

99
allOf:
100
  - if:
101
      not:
102
        required:
103
          - io-backends
104
    then:
105
      properties:
106
        adi,num-lanes: false
107

108
oneOf:
109
  - required:
110
      - interrupts
111
  - required:
112
      - io-backends
113

114
unevaluatedProperties: false
115

116
examples:
117
  - |
118
    #include <dt-bindings/gpio/gpio.h>
119
    #include <dt-bindings/interrupt-controller/irq.h>
120
    spi {
121
        #address-cells = <1>;
122
        #size-cells = <0>;
123

124
        adc@0 {
125
          compatible = "adi,ad7779";
126
          reg = <0>;
127
          start-gpios = <&gpio0 87 GPIO_ACTIVE_LOW>;
128
          reset-gpios = <&gpio0 93 GPIO_ACTIVE_LOW>;
129
          interrupt-parent = <&intc>;
130
          interrupts = <0 56 IRQ_TYPE_LEVEL_HIGH>;
131
          interrupt-names = "adc_rdy";
132
          clocks = <&adc_clk>;
133
        };
134
    };
135

136
  - |
137
    #include <dt-bindings/gpio/gpio.h>
138
    spi {
139
        #address-cells = <1>;
140
        #size-cells = <0>;
141

142
        adc@0 {
143
          compatible = "adi,ad7779";
144
          reg = <0>;
145
          start-gpios = <&gpio0 87 GPIO_ACTIVE_LOW>;
146
          reset-gpios = <&gpio0 93 GPIO_ACTIVE_LOW>;
147
          clocks = <&adc_clk>;
148
          io-backends = <&iio_backend>;
149
          adi,num-lanes = <4>;
150
        };
151
    };
152
...
153

154