xref: /linux/Documentation/devicetree/bindings/iio/adc/adi,ad7192.yaml (revision 932bae3a5b4e9b9a40133e4dc989c2099f3d1823) 
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/bindings/iio/adc/adi,ad7192.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Analog Devices AD7192 ADC device driver
9
10maintainers:
11  - Michael Hennerich <michael.hennerich@analog.com>
12
13description: |
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
18properties:
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  clocks:
34    maxItems: 1
35    description: phandle to the master clock (mclk)
36
37  clock-names:
38    items:
39      - const: mclk
40
41  interrupts:
42    maxItems: 1
43
44  dvdd-supply:
45    description: DVdd voltage supply
46
47  avdd-supply:
48    description: AVdd voltage supply
49
50  adi,rejection-60-Hz-enable:
51    description: |
52      This bit enables a notch at 60 Hz when the first notch of the sinc
53      filter is at 50 Hz. When REJ60 is set, a filter notch is placed at
54      60 Hz when the sinc filter first notch is at 50 Hz. This allows
55      simultaneous 50 Hz/ 60 Hz rejection.
56    type: boolean
57
58  adi,refin2-pins-enable:
59    description: |
60      External reference applied between the P1/REFIN2(+) and P0/REFIN2(−) pins.
61    type: boolean
62
63  adi,buffer-enable:
64    description: |
65      Enables the buffer on the analog inputs. If cleared, the analog inputs
66      are unbuffered, lowering the power consumption of the device. If this
67      bit is set, the analog inputs are buffered, allowing the user to place
68      source impedances on the front end without contributing gain errors to
69      the system.
70    type: boolean
71
72  adi,burnout-currents-enable:
73    description: |
74      When this bit is set to 1, the 500 nA current sources in the signal
75      path are enabled. When BURN = 0, the burnout currents are disabled.
76      The burnout currents can be enabled only when the buffer is active
77      and when chop is disabled.
78    type: boolean
79
80  bipolar:
81    description: see Documentation/devicetree/bindings/iio/adc/adc.txt
82    type: boolean
83
84required:
85  - compatible
86  - reg
87  - clocks
88  - clock-names
89  - interrupts
90  - dvdd-supply
91  - avdd-supply
92  - spi-cpol
93  - spi-cpha
94
95examples:
96  - |
97    spi0 {
98      adc@0 {
99        compatible = "adi,ad7192";
100        reg = <0>;
101        spi-max-frequency = <1000000>;
102        spi-cpol;
103        spi-cpha;
104        clocks = <&ad7192_mclk>;
105        clock-names = "mclk";
106        #interrupt-cells = <2>;
107        interrupts = <25 0x2>;
108        interrupt-parent = <&gpio>;
109        dvdd-supply = <&dvdd>;
110        avdd-supply = <&avdd>;
111
112        adi,refin2-pins-enable;
113        adi,rejection-60-Hz-enable;
114        adi,buffer-enable;
115        adi,burnout-currents-enable;
116        };
117    };
118