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

8
title: Analog Devices AD5770R DAC device driver
9

10
maintainers:
11
  - Marcelo Schmitt <marcelo.schmitt@analog.com>
12
  - Nuno Sá <nuno.sa@analog.com>
13

14
description: |
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

19
properties:
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

118
patternProperties:
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

135
required:
136
  - reg
137
  - channel@0
138
  - channel@1
139
  - channel@2
140
  - channel@3
141
  - channel@4
142
  - channel@5
143

144
allOf:
145
  - $ref: /schemas/spi/spi-peripheral-props.yaml#
146

147
unevaluatedProperties: false
148

149
examples:
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
...
197

198