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

   1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
   2 # Copyright 2019 Analog Devices Inc.
   3 %YAML 1.2
   4 ---
   5 $id: http://devicetree.org/schemas/iio/adc/adi,ad7192.yaml#
   6 $schema: http://devicetree.org/meta-schemas/core.yaml#
   7
   8 title: Analog Devices AD7192 ADC device driver
   9
  10 maintainers:
  11   - Michael Hennerich <michael.hennerich@analog.com>
  12
  13 description: |
  14   Bindings for the Analog Devices AD7192 ADC device. Datasheet can be
  15   found here:
  16   https://www.analog.com/media/en/technical-documentation/data-sheets/AD7192.pdf
  17
  18 properties:
  19   compatible:
  20     enum:
  21       - adi,ad7190
  22       - adi,ad7192
  23       - adi,ad7193
  24       - adi,ad7195
  25
  26   reg:
  27     maxItems: 1
  28
  29   spi-cpol: true
  30
  31   spi-cpha: true
  32
  33   spi-max-frequency: true
  34
  35   clocks:
  36     maxItems: 1
  37     description: phandle to the master clock (mclk)
  38
  39   clock-names:
  40     items:
  41       - const: mclk
  42
  43   interrupts:
  44     maxItems: 1
  45
  46   dvdd-supply:
  47     description: DVdd voltage supply
  48
  49   avdd-supply:
  50     description: AVdd voltage supply
  51
  52   adi,rejection-60-Hz-enable:
  53     description: |
  54       This bit enables a notch at 60 Hz when the first notch of the sinc
  55       filter is at 50 Hz. When REJ60 is set, a filter notch is placed at
  56       60 Hz when the sinc filter first notch is at 50 Hz. This allows
  57       simultaneous 50 Hz/ 60 Hz rejection.
  58     type: boolean
  59
  60   adi,refin2-pins-enable:
  61     description: |
  62       External reference applied between the P1/REFIN2(+) and P0/REFIN2(−) pins.
  63     type: boolean
  64
  65   adi,buffer-enable:
  66     description: |
  67       Enables the buffer on the analog inputs. If cleared, the analog inputs
  68       are unbuffered, lowering the power consumption of the device. If this
  69       bit is set, the analog inputs are buffered, allowing the user to place
  70       source impedances on the front end without contributing gain errors to
  71       the system.
  72     type: boolean
  73
  74   adi,burnout-currents-enable:
  75     description: |
  76       When this bit is set to 1, the 500 nA current sources in the signal
  77       path are enabled. When BURN = 0, the burnout currents are disabled.
  78       The burnout currents can be enabled only when the buffer is active
  79       and when chop is disabled.
  80     type: boolean
  81
  82   bipolar:
  83     description: see Documentation/devicetree/bindings/iio/adc/adc.yaml
  84     type: boolean
  85
  86 required:
  87   - compatible
  88   - reg
  89   - clocks
  90   - clock-names
  91   - interrupts
  92   - dvdd-supply
  93   - avdd-supply
  94   - spi-cpol
  95   - spi-cpha
  96
  97 additionalProperties: false
  98
  99 examples:
 100   - |
 101     spi0 {
 102       #address-cells = <1>;
 103       #size-cells = <0>;
 104
 105       adc@0 {
 106         compatible = "adi,ad7192";
 107         reg = <0>;
 108         spi-max-frequency = <1000000>;
 109         spi-cpol;
 110         spi-cpha;
 111         clocks = <&ad7192_mclk>;
 112         clock-names = "mclk";
 113         interrupts = <25 0x2>;
 114         interrupt-parent = <&gpio>;
 115         dvdd-supply = <&dvdd>;
 116         avdd-supply = <&avdd>;
 117
 118         adi,refin2-pins-enable;
 119         adi,rejection-60-Hz-enable;
 120         adi,buffer-enable;
 121         adi,burnout-currents-enable;
 122         };
 123     };