summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/iio/adc/adi,ad4851.yaml
blob: c6676d91b4e62b1ec9a24db4ef48d8521961bd09 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
# Copyright 2024 Analog Devices Inc.
%YAML 1.2
---
$id: http://devicetree.org/schemas/iio/adc/adi,ad4851.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Analog Devices AD485X family

maintainers:
  - Sergiu Cuciurean <sergiu.cuciurean@analog.com>
  - Dragos Bogdan <dragos.bogdan@analog.com>
  - Antoniu Miclaus <antoniu.miclaus@analog.com>

description: |
  Analog Devices AD485X fully buffered, 8-channel simultaneous sampling,
  16/20-bit, 1 MSPS data acquisition system (DAS) with differential, wide
  common-mode range inputs.

  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4855.pdf
  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4856.pdf
  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4857.pdf
  https://www.analog.com/media/en/technical-documentation/data-sheets/ad4858.pdf

$ref: /schemas/spi/spi-peripheral-props.yaml#

properties:
  compatible:
    enum:
      - adi,ad4851
      - adi,ad4852
      - adi,ad4853
      - adi,ad4854
      - adi,ad4855
      - adi,ad4856
      - adi,ad4857
      - adi,ad4858
      - adi,ad4858i

  reg:
    maxItems: 1

  vcc-supply: true

  vee-supply: true

  vdd-supply: true

  vddh-supply: true

  vddl-supply: true

  vio-supply: true

  vrefbuf-supply: true

  vrefio-supply: true

  pwms:
    description: PWM connected to the CNV pin.
    maxItems: 1

  io-backends:
    maxItems: 1

  pd-gpios:
    maxItems: 1

  spi-max-frequency:
    maximum: 25000000

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

patternProperties:
  "^channel(@[0-7])?$":
    $ref: adc.yaml
    type: object
    description: Represents the channels which are connected to the ADC.

    properties:
      reg:
        description:
          The channel number, as specified in the datasheet (from 0 to 7).
        minimum: 0
        maximum: 7

      diff-channels:
        description:
          Each channel can be configured as a bipolar differential channel.
          The ADC uses the same positive and negative inputs for this.
          This property must be specified as 'reg' (or the channel number) for
          both positive and negative inputs (i.e. diff-channels = <reg reg>).
          Since the configuration is bipolar differential, the 'bipolar'
          property is required.
        items:
          minimum: 0
          maximum: 7

      bipolar: true

    required:
      - reg

    additionalProperties: false

required:
  - compatible
  - reg
  - vcc-supply
  - vee-supply
  - vdd-supply
  - vio-supply
  - pwms

unevaluatedProperties: false

examples:
  - |
    spi {
        #address-cells = <1>;
        #size-cells = <0>;

        adc@0{
            #address-cells = <1>;
            #size-cells = <0>;
            compatible = "adi,ad4858";
            reg = <0>;
            spi-max-frequency = <10000000>;
            vcc-supply = <&vcc>;
            vdd-supply = <&vdd>;
            vee-supply = <&vee>;
            vddh-supply = <&vddh>;
            vddl-supply = <&vddl>;
            vio-supply = <&vio>;
            pwms = <&pwm_gen 0 0>;
            io-backends = <&iio_backend>;

            channel@0 {
              reg = <0>;
              diff-channels = <0 0>;
              bipolar;
            };

            channel@1 {
              reg = <1>;
            };
        };
    };
...