adi,ad7779.yaml

  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
 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
 94required:
 95  - compatible
 96  - reg
 97  - clocks
 98
 99allOf:
100  - if:
101      not:
102        required:
103          - io-backends
104    then:
105      properties:
106        adi,num-lanes: false
107
108oneOf:
109  - required:
110      - interrupts
111  - required:
112      - io-backends
113
114unevaluatedProperties: false
115
116examples:
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...