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