xref: /freebsd/sys/contrib/device-tree/Bindings/iio/adc/adi,ad7192.yaml (revision ebacd8013fe5f7fdf9f6a5b286f6680dd2891036) 
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
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  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
86required:
87  - compatible
88  - reg
89  - clocks
90  - clock-names
91  - interrupts
92  - dvdd-supply
93  - avdd-supply
94  - spi-cpol
95  - spi-cpha
96
97additionalProperties: false
98
99examples:
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    };
124