Documentation/devicetree/bindings/iio/adc/adi,ad7780.yaml

   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
   7 title: Analog Devices AD7170/AD7171/AD7780/AD7781 analog to digital converters
   8
   9 maintainers:
  10   - Michael Hennerich <michael.hennerich@analog.com>
  11
  12 description: |
  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
  28 properties:
  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
  66 required:
  67   - compatible
  68   - reg
  69
  70 examples:
  71   - |
  72     #include <dt-bindings/gpio/gpio.h>
  73     spi0 {
  74         #address-cells = <1>;
  75         #size-cells = <0>;
  76
  77         adc@0 {
  78             compatible = "adi,ad7780";
  79             reg = <0>;
  80
  81             avdd-supply      = <&vdd_supply>;
  82             powerdown-gpios  = <&gpio0 12 GPIO_ACTIVE_HIGH>;
  83             adi,gain-gpios   = <&gpio1  5 GPIO_ACTIVE_LOW>;
  84             adi,filter-gpios = <&gpio2 15 GPIO_ACTIVE_LOW>;
  85         };
  86     };