xref: /freebsd/sys/contrib/device-tree/Bindings/iio/adc/adi,ad4030.yaml (revision 8ccc0d235c226d84112561d453c49904398d085c) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright 2024 Analog Devices Inc.
3# Copyright 2024 BayLibre, SAS.
4%YAML 1.2
5---
6$id: http://devicetree.org/schemas/iio/adc/adi,ad4030.yaml#
7$schema: http://devicetree.org/meta-schemas/core.yaml#
8
9title: Analog Devices AD4030 and AD4630 ADC families
10
11maintainers:
12  - Michael Hennerich <michael.hennerich@analog.com>
13  - Nuno Sa <nuno.sa@analog.com>
14
15description: |
16  Analog Devices AD4030 single channel and AD4630/AD4632 dual channel precision
17  SAR ADC families
18
19  * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4030-24-4032-24.pdf
20  * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4630-24_ad4632-24.pdf
21  * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4630-16-4632-16.pdf
22
23properties:
24  compatible:
25    enum:
26      - adi,ad4030-24
27      - adi,ad4032-24
28      - adi,ad4630-16
29      - adi,ad4630-24
30      - adi,ad4632-16
31      - adi,ad4632-24
32
33  reg:
34    maxItems: 1
35
36  spi-max-frequency:
37    maximum: 102040816
38
39  spi-rx-bus-width:
40    enum: [1, 2, 4]
41
42  vdd-5v-supply: true
43  vdd-1v8-supply: true
44  vio-supply: true
45
46  ref-supply:
47    description:
48      Optional External unbuffered reference. Used when refin-supply is not
49      connected.
50
51  refin-supply:
52    description:
53      Internal buffered Reference. Used when ref-supply is not connected.
54
55  cnv-gpios:
56    description:
57      The Convert Input (CNV). It initiates the sampling conversions.
58    maxItems: 1
59
60  reset-gpios:
61    description:
62      The Reset Input (/RST). Used for asynchronous device reset.
63    maxItems: 1
64
65  interrupts:
66    description:
67      The BUSY pin is used to signal that the conversions results are available
68      to be transferred when in SPI Clocking Mode. This nodes should be
69      connected to an interrupt that is triggered when the BUSY line goes low.
70    maxItems: 1
71
72  interrupt-names:
73    const: busy
74
75required:
76  - compatible
77  - reg
78  - vdd-5v-supply
79  - vdd-1v8-supply
80  - vio-supply
81  - cnv-gpios
82
83oneOf:
84  - required:
85      - ref-supply
86  - required:
87      - refin-supply
88
89unevaluatedProperties: false
90
91examples:
92  - |
93    #include <dt-bindings/gpio/gpio.h>
94
95    spi {
96        #address-cells = <1>;
97        #size-cells = <0>;
98
99        adc@0 {
100            compatible = "adi,ad4030-24";
101            reg = <0>;
102            spi-max-frequency = <80000000>;
103            vdd-5v-supply = <&supply_5V>;
104            vdd-1v8-supply = <&supply_1_8V>;
105            vio-supply = <&supply_1_8V>;
106            ref-supply = <&supply_5V>;
107            cnv-gpios = <&gpio0 0 GPIO_ACTIVE_HIGH>;
108            reset-gpios = <&gpio0 1 GPIO_ACTIVE_LOW>;
109        };
110    };
111