summaryrefslogtreecommitdiff
path: root/Documentation/devicetree/bindings/iio/dac/adi,ltc2672.yaml
blob: 3c8e5781e42cfbc3934f04f8e257c1531ec2858d (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
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/iio/dac/adi,ltc2672.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Analog Devices LTC2672 DAC

maintainers:
  - Michael Hennerich <michael.hennerich@analog.com>
  - Kim Seer Paller <kimseer.paller@analog.com>

description: |
  Analog Devices LTC2672 5 channel, 12-/16-Bit, 300mA DAC
  https://www.analog.com/media/en/technical-documentation/data-sheets/ltc2672.pdf

properties:
  compatible:
    enum:
      - adi,ltc2672

  reg:
    maxItems: 1

  spi-max-frequency:
    maximum: 50000000

  vcc-supply:
    description: Analog Supply Voltage Input.

  v-neg-supply:
    description: Negative Supply Voltage Input.

  vdd0-supply:
    description: Positive Supply Voltage Input for DAC OUT0.

  vdd1-supply:
    description: Positive Supply Voltage Input for DAC OUT1.

  vdd2-supply:
    description: Positive Supply Voltage Input for DAC OUT2.

  vdd3-supply:
    description: Positive Supply Voltage Input for DAC OUT3.

  vdd4-supply:
    description: Positive Supply Voltage Input for DAC OUT4.

  iovcc-supply:
    description: Digital Input/Output Supply Voltage.

  ref-supply:
    description:
      Reference Input/Output. The voltage at the REF pin sets the full-scale
      range of all channels. If not provided the internal reference is used and
      also provided on the VREF pin.

  reset-gpios:
    description:
      Active Low Asynchronous Clear Input. A logic low at this level triggered
      input clears the device to the default reset code and output range, which
      is zero-scale with the outputs off. The control registers are cleared to
      zero.
    maxItems: 1

  adi,rfsadj-ohms:
    description:
      If FSADJ is tied to VCC, an internal RFSADJ (20 kΩ) is selected, which
      results in nominal output ranges. When an external resistor of 19 kΩ to
      41 kΩ can be used instead by connecting the resistor between FSADJ and GND
      it controls the scaling of the ranges, and the internal resistor is
      automatically disconnected.
    minimum: 19000
    maximum: 41000
    default: 20000

  io-channels:
    description:
      ADC channel to monitor voltages and currents at the MUX pin.
    maxItems: 1

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

patternProperties:
  "^channel@[0-4]$":
    $ref: dac.yaml
    type: object
    additionalProperties: false

    properties:
      reg:
        description: The channel number representing the DAC output channel.
        maximum: 4

      adi,toggle-mode:
        description:
          Set the channel as a toggle enabled channel. Toggle operation enables
          fast switching of a DAC output between two different DAC codes without
          any SPI transaction.
        type: boolean

      output-range-microamp:
        items:
          - const: 0
          - enum: [3125000, 6250000, 12500000, 25000000, 50000000, 100000000,
                   200000000, 300000000]

    required:
      - reg
      - output-range-microamp

required:
  - compatible
  - reg
  - spi-max-frequency
  - vcc-supply
  - iovcc-supply
  - v-neg-supply

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

unevaluatedProperties: false

examples:
  - |
    spi {
        #address-cells = <1>;
        #size-cells = <0>;
        dac@0 {
            compatible = "adi,ltc2672";
            reg = <0>;
            spi-max-frequency = <10000000>;

            vcc-supply = <&vcc>;
            iovcc-supply = <&vcc>;
            ref-supply = <&vref>;
            v-neg-supply = <&vneg>;

            io-channels = <&adc 0>;

            #address-cells = <1>;
            #size-cells = <0>;
            channel@0 {
                reg = <0>;
                adi,toggle-mode;
                output-range-microamp = <0 3125000>;
            };

            channel@1 {
                reg = <1>;
                output-range-microamp = <0 6250000>;
            };
        };
    };
...