xref: /linux/Documentation/devicetree/bindings/iio/adc/adi,ad4851.yaml (revision 0d5ec7919f3747193f051036b2301734a4b5e1d6) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright 2024 Analog Devices Inc.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/iio/adc/adi,ad4851.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Analog Devices AD485X family
9
10maintainers:
11  - Sergiu Cuciurean <sergiu.cuciurean@analog.com>
12  - Dragos Bogdan <dragos.bogdan@analog.com>
13  - Antoniu Miclaus <antoniu.miclaus@analog.com>
14
15description: |
16  Analog Devices AD485X fully buffered, 8-channel simultaneous sampling,
17  16/20-bit, 1 MSPS data acquisition system (DAS) with differential, wide
18  common-mode range inputs.
19
20  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4855.pdf
21  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4856.pdf
22  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4857.pdf
23  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4858.pdf
24
25$ref: /schemas/spi/spi-peripheral-props.yaml#
26
27properties:
28  compatible:
29    enum:
30      - adi,ad4851
31      - adi,ad4852
32      - adi,ad4853
33      - adi,ad4854
34      - adi,ad4855
35      - adi,ad4856
36      - adi,ad4857
37      - adi,ad4858
38      - adi,ad4858i
39
40  reg:
41    maxItems: 1
42
43  vcc-supply: true
44
45  vee-supply: true
46
47  vdd-supply: true
48
49  vddh-supply: true
50
51  vddl-supply: true
52
53  vio-supply: true
54
55  vrefbuf-supply: true
56
57  vrefio-supply: true
58
59  pwms:
60    description: PWM connected to the CNV pin.
61    maxItems: 1
62
63  io-backends:
64    maxItems: 1
65
66  pd-gpios:
67    maxItems: 1
68
69  spi-max-frequency:
70    maximum: 25000000
71
72  spi-3wire: true
73
74  '#address-cells':
75    const: 1
76
77  '#size-cells':
78    const: 0
79
80patternProperties:
81  "^channel(@[0-7])?$":
82    $ref: adc.yaml
83    type: object
84    description: Represents the channels which are connected to the ADC.
85
86    properties:
87      reg:
88        description:
89          The channel number, as specified in the datasheet (from 0 to 7).
90        minimum: 0
91        maximum: 7
92
93      diff-channels:
94        description:
95          Each channel can be configured as a bipolar differential channel.
96          The ADC uses the same positive and negative inputs for this.
97          This property must be specified as 'reg' (or the channel number) for
98          both positive and negative inputs (i.e. diff-channels = <reg reg>).
99          Since the configuration is bipolar differential, the 'bipolar'
100          property is required.
101        items:
102          minimum: 0
103          maximum: 7
104
105      bipolar: true
106
107    required:
108      - reg
109
110    additionalProperties: false
111
112required:
113  - compatible
114  - reg
115  - vcc-supply
116  - vee-supply
117  - vdd-supply
118  - vio-supply
119  - pwms
120
121unevaluatedProperties: false
122
123examples:
124  - |
125    spi {
126        #address-cells = <1>;
127        #size-cells = <0>;
128
129        adc@0{
130            #address-cells = <1>;
131            #size-cells = <0>;
132            compatible = "adi,ad4858";
133            reg = <0>;
134            spi-max-frequency = <10000000>;
135            vcc-supply = <&vcc>;
136            vdd-supply = <&vdd>;
137            vee-supply = <&vee>;
138            vddh-supply = <&vddh>;
139            vddl-supply = <&vddl>;
140            vio-supply = <&vio>;
141            pwms = <&pwm_gen 0 0>;
142            io-backends = <&iio_backend>;
143
144            channel@0 {
145              reg = <0>;
146              diff-channels = <0 0>;
147              bipolar;
148            };
149
150            channel@1 {
151              reg = <1>;
152            };
153        };
154    };
155...
156