adi,ad4851.yaml

  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...