adi,ad4030.yaml

  1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
  2# Copyright 2024 Analog Devices Inc.
  3# Copyright 2024 BayLibre, SAS.
  4%YAML 1.2
  5---
  6$id: http://devicetree.org/schemas/iio/adc/adi,ad4030.yaml#
  7$schema: http://devicetree.org/meta-schemas/core.yaml#
  8
  9title: Analog Devices AD4030 and AD4630 ADC families
 10
 11maintainers:
 12  - Michael Hennerich <michael.hennerich@analog.com>
 13  - Nuno Sa <nuno.sa@analog.com>
 14
 15description: |
 16  Analog Devices AD4030 single channel and AD4630/AD4632 dual channel precision
 17  SAR ADC families
 18
 19  * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4030-24-4032-24.pdf
 20  * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4630-24_ad4632-24.pdf
 21  * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4630-16-4632-16.pdf
 22
 23properties:
 24  compatible:
 25    enum:
 26      - adi,ad4030-24
 27      - adi,ad4032-24
 28      - adi,ad4630-16
 29      - adi,ad4630-24
 30      - adi,ad4632-16
 31      - adi,ad4632-24
 32
 33  reg:
 34    maxItems: 1
 35
 36  spi-max-frequency:
 37    maximum: 102040816
 38
 39  spi-rx-bus-width:
 40    enum: [1, 2, 4]
 41
 42  vdd-5v-supply: true
 43  vdd-1v8-supply: true
 44  vio-supply: true
 45
 46  ref-supply:
 47    description:
 48      Optional External unbuffered reference. Used when refin-supply is not
 49      connected.
 50
 51  refin-supply:
 52    description:
 53      Internal buffered Reference. Used when ref-supply is not connected.
 54
 55  cnv-gpios:
 56    description:
 57      The Convert Input (CNV). It initiates the sampling conversions.
 58    maxItems: 1
 59
 60  reset-gpios:
 61    description:
 62      The Reset Input (/RST). Used for asynchronous device reset.
 63    maxItems: 1
 64
 65  interrupts:
 66    description:
 67      The BUSY pin is used to signal that the conversions results are available
 68      to be transferred when in SPI Clocking Mode. This nodes should be
 69      connected to an interrupt that is triggered when the BUSY line goes low.
 70    maxItems: 1
 71
 72  interrupt-names:
 73    const: busy
 74
 75required:
 76  - compatible
 77  - reg
 78  - vdd-5v-supply
 79  - vdd-1v8-supply
 80  - vio-supply
 81  - cnv-gpios
 82
 83oneOf:
 84  - required:
 85      - ref-supply
 86  - required:
 87      - refin-supply
 88
 89unevaluatedProperties: false
 90
 91examples:
 92  - |
 93    #include <dt-bindings/gpio/gpio.h>
 94
 95    spi {
 96        #address-cells = <1>;
 97        #size-cells = <0>;
 98
 99        adc@0 {
100            compatible = "adi,ad4030-24";
101            reg = <0>;
102            spi-max-frequency = <80000000>;
103            vdd-5v-supply = <&supply_5V>;
104            vdd-1v8-supply = <&supply_1_8V>;
105            vio-supply = <&supply_1_8V>;
106            ref-supply = <&supply_5V>;
107            cnv-gpios = <&gpio0 0 GPIO_ACTIVE_HIGH>;
108            reset-gpios = <&gpio0 1 GPIO_ACTIVE_LOW>;
109        };
110    };