adi,ad5770r.yaml

  1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
  2# Copyright 2020 Analog Devices Inc.
  3%YAML 1.2
  4---
  5$id: http://devicetree.org/schemas/iio/dac/adi,ad5770r.yaml#
  6$schema: http://devicetree.org/meta-schemas/core.yaml#
  7
  8title: Analog Devices AD5770R DAC device driver
  9
 10maintainers:
 11  - Marcelo Schmitt <marcelo.schmitt@analog.com>
 12  - Nuno Sá <nuno.sa@analog.com>
 13
 14description: |
 15  Bindings for the Analog Devices AD5770R current DAC device. Datasheet can be
 16  found here:
 17    https://www.analog.com/media/en/technical-documentation/data-sheets/AD5770R.pdf
 18
 19properties:
 20  compatible:
 21    enum:
 22      - adi,ad5770r
 23
 24  reg:
 25    maxItems: 1
 26
 27  avdd-supply:
 28    description:
 29      AVdd voltage supply. Represents two different supplies in the datasheet
 30      that are in fact the same.
 31
 32  iovdd-supply:
 33    description:
 34      Voltage supply for the chip interface.
 35
 36  vref-supply:
 37    description: Specify the voltage of the external reference used.
 38      Available reference options are 1.25 V or 2.5 V. If no
 39      external reference declared then the device will use the
 40      internal reference of 1.25 V.
 41
 42  adi,external-resistor:
 43    description: Specify if an external 2.5k ohm resistor is used. If not
 44      specified the device will use an internal 2.5k ohm resistor.
 45      The precision resistor is used for reference current generation.
 46    type: boolean
 47
 48  reset-gpios:
 49    description: GPIO spec for the RESET pin. If specified, it will be
 50      asserted during driver probe.
 51    maxItems: 1
 52
 53  '#address-cells':
 54    const: 1
 55
 56  '#size-cells':
 57    const: 0
 58
 59  channel@0:
 60    description: Represents an external channel which are
 61      connected to the DAC. Channel 0 can act both as a current
 62      source and sink.
 63    type: object
 64    additionalProperties: false
 65
 66    properties:
 67      reg:
 68        description: This represents the channel number.
 69        const: 0
 70
 71      adi,range-microamp:
 72        description: Output range of the channel.
 73        oneOf:
 74          - items:
 75              - const: 0
 76              - const: 300000
 77          - items:
 78              - const: -60000
 79              - const: 0
 80          - items:
 81              - const: -60000
 82              - const: 300000
 83
 84  channel@1:
 85    description: Represents an external channel which are
 86      connected to the DAC.
 87    type: object
 88    additionalProperties: false
 89
 90    properties:
 91      reg:
 92        description: This represents the channel number.
 93        const: 1
 94
 95      adi,range-microamp:
 96        description: Output range of the channel.
 97        items:
 98          - const: 0
 99          - enum: [140000, 250000]
100
101  channel@2:
102    description: Represents an external channel which are
103      connected to the DAC.
104    type: object
105    additionalProperties: false
106
107    properties:
108      reg:
109        description: This represents the channel number.
110        const: 2
111
112      adi,range-microamp:
113        description: Output range of the channel.
114        items:
115          - const: 0
116          - enum: [55000, 150000]
117
118patternProperties:
119  "^channel@([3-5])$":
120    type: object
121    additionalProperties: false
122    description: Represents the external channels which are connected to the DAC.
123    properties:
124      reg:
125        description: This represents the channel number.
126        minimum: 3
127        maximum: 5
128
129      adi,range-microamp:
130        description: Output range of the channel.
131        items:
132          - const: 0
133          - enum: [45000, 100000]
134
135required:
136  - reg
137  - channel@0
138  - channel@1
139  - channel@2
140  - channel@3
141  - channel@4
142  - channel@5
143
144allOf:
145  - $ref: /schemas/spi/spi-peripheral-props.yaml#
146
147unevaluatedProperties: false
148
149examples:
150  - |
151    spi {
152        #address-cells = <1>;
153        #size-cells = <0>;
154
155        ad5770r@0 {
156            compatible = "adi,ad5770r";
157            reg = <0>;
158            spi-max-frequency = <1000000>;
159            vref-supply = <&vref>;
160            adi,external-resistor;
161            reset-gpios = <&gpio 22 0>;
162            #address-cells = <1>;
163            #size-cells = <0>;
164
165            channel@0 {
166                reg = <0>;
167                adi,range-microamp = <0 300000>;
168            };
169
170            channel@1 {
171                reg = <1>;
172                adi,range-microamp = <0 140000>;
173            };
174
175            channel@2 {
176                reg = <2>;
177                adi,range-microamp = <0 55000>;
178            };
179
180            channel@3 {
181                reg = <3>;
182                adi,range-microamp = <0 45000>;
183            };
184
185            channel@4 {
186                reg = <4>;
187                adi,range-microamp = <0 45000>;
188            };
189
190            channel@5 {
191                reg = <5>;
192                adi,range-microamp = <0 45000>;
193            };
194        };
195    };
196...