xref: /freebsd/sys/contrib/device-tree/Bindings/iio/adc/adi,ad7949.yaml (revision 3a3af6b2a160bea72509a9d5ef84e25906b0478a) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/iio/adc/adi,ad7949.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Analog Devices AD7949/AD7682/AD7689 analog to digital converters
8
9maintainers:
10  - Charles-Antoine Couret <charles-antoine.couret@essensium.com>
11
12description: |
13  Specifications on the converters can be found at:
14    AD7949:
15      https://www.analog.com/media/en/technical-documentation/data-sheets/AD7949.pdf
16    AD7682/AD7698:
17      https://www.analog.com/media/en/technical-documentation/data-sheets/AD7682_7689.pdf
18
19properties:
20  compatible:
21    enum:
22      - adi,ad7682
23      - adi,ad7689
24      - adi,ad7949
25
26  reg:
27    maxItems: 1
28
29  vrefin-supply:
30    description:
31      Buffered ADC reference voltage supply.
32
33  vref-supply:
34    description:
35      Unbuffered ADC reference voltage supply.
36
37  adi,internal-ref-microvolt:
38    description: |
39      Internal reference voltage selection in microvolts.
40
41      If no internal reference is specified, the channel will default to the
42      external reference defined by vrefin-supply (or vref-supply).
43      vrefin-supply will take precedence over vref-supply if both are defined.
44
45      If no supplies are defined, the reference selection will default to
46      4096mV internal reference.
47
48    enum: [2500000, 4096000]
49    default: 4096000
50
51
52  spi-max-frequency: true
53
54  '#io-channel-cells':
55    const: 1
56
57  '#address-cells':
58    const: 1
59
60  '#size-cells':
61    const: 0
62
63required:
64  - compatible
65  - reg
66
67additionalProperties: false
68
69examples:
70  - |
71    spi {
72        #address-cells = <1>;
73        #size-cells = <0>;
74
75        adc@0 {
76            #address-cells = <1>;
77            #size-cells = <0>;
78
79            compatible = "adi,ad7949";
80            reg = <0>;
81            vref-supply = <&vdd_supply>;
82        };
83
84        adc@1 {
85            #address-cells = <1>;
86            #size-cells = <0>;
87
88            compatible = "adi,ad7949";
89            reg = <1>;
90            vrefin-supply = <&vdd_supply>;
91        };
92
93        adc@2 {
94            #address-cells = <1>;
95            #size-cells = <0>;
96
97            compatible = "adi,ad7949";
98            reg = <2>;
99            adi,internal-ref-microvolt = <4096000>;
100        };
101    };
102...
103