summaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree/bindings/iio/dac/adi,ad5770r.yaml
blob: d9c25cf4b92f2f17cc4488d5f8cde3ef74eb0caf (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
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
# Copyright 2020 Analog Devices Inc.
%YAML 1.2
---
$id: http://devicetree.org/schemas/bindings/iio/dac/adi,ad5770r.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Analog Devices AD5770R DAC device driver

maintainers:
  - Mircea Caprioru <mircea.caprioru@analog.com>

description: |
  Bindings for the Analog Devices AD5770R current DAC device. Datasheet can be
  found here:
    https://www.analog.com/media/en/technical-documentation/data-sheets/AD5770R.pdf

properties:
  compatible:
    enum:
      - adi,ad5770r

  reg:
    maxItems: 1

  avdd-supply:
    description:
      AVdd voltage supply. Represents two different supplies in the datasheet
      that are in fact the same.

  iovdd-supply:
    description:
      Voltage supply for the chip interface.

  vref-supply:
    description: Specify the voltage of the external reference used.
      Available reference options are 1.25 V or 2.5 V. If no
      external reference declared then the device will use the
      internal reference of 1.25 V.

  adi,external-resistor:
    description: Specify if an external 2.5k ohm resistor is used. If not
      specified the device will use an internal 2.5k ohm resistor.
      The precision resistor is used for reference current generation.
    type: boolean

  reset-gpios:
    description: GPIO spec for the RESET pin. If specified, it will be
      asserted during driver probe.
    maxItems: 1

  channel0:
    description: Represents an external channel which are
      connected to the DAC. Channel 0 can act both as a current
      source and sink.
    type: object

    properties:
      num:
        description: This represents the channel number.
        items:
          const: 0

      adi,range-microamp:
          description: Output range of the channel.
          oneOf:
            - $ref: /schemas/types.yaml#/definitions/int32-array
            - items:
                - enum: [0 300000]
                - enum: [-60000 0]
                - enum: [-60000 300000]

  channel1:
    description: Represents an external channel which are
      connected to the DAC.
    type: object

    properties:
      num:
        description: This represents the channel number.
        items:
          const: 1

      adi,range-microamp:
          description: Output range of the channel.
          oneOf:
            - $ref: /schemas/types.yaml#/definitions/uint32-array
            - items:
                - enum: [0 140000]
                - enum: [0 250000]

  channel2:
    description: Represents an external channel which are
      connected to the DAC.
    type: object

    properties:
      num:
        description: This represents the channel number.
        items:
          const: 2

      adi,range-microamp:
          description: Output range of the channel.
          oneOf:
            - $ref: /schemas/types.yaml#/definitions/uint32-array
            - items:
                - enum: [0 140000]
                - enum: [0 250000]

patternProperties:
  "^channel@([3-5])$":
    type: object
    description: Represents the external channels which are connected to the DAC.
    properties:
      num:
        description: This represents the channel number.
        items:
          minimum: 3
          maximum: 5

      adi,range-microamp:
          description: Output range of the channel.
          oneOf:
            - $ref: /schemas/types.yaml#/definitions/uint32-array
            - items:
                - enum: [0 45000]
                - enum: [0 100000]

required:
- reg
- diff-channels
- channel0
- channel1
- channel2
- channel3
- channel4
- channel5

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

                ad5770r@0 {
                        compatible = "ad5770r";
                        reg = <0>;
                        spi-max-frequency = <1000000>;
                        vref-supply = <&vref>;
                        adi,external-resistor;
                        reset-gpios = <&gpio 22 0>;

                        channel@0 {
                                num = <0>;
                                adi,range-microamp = <(-60000) 300000>;
                        };

                        channel@1 {
                                num = <1>;
                                adi,range-microamp = <0 140000>;
                        };

                        channel@2 {
                                num = <2>;
                                adi,range-microamp = <0 55000>;
                        };

                        channel@3 {
                                num = <3>;
                                adi,range-microamp = <0 45000>;
                        };

                        channel@4 {
                                num = <4>;
                                adi,range-microamp = <0 45000>;
                        };

                        channel@5 {
                                num = <5>;
                                adi,range-microamp = <0 45000>;
                        };
                };
        };
...