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

title: Analog Devices LTC2664 DAC

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

description: |
  Analog Devices LTC2664 4 channel, 12-/16-Bit, +-10V DAC
  https://www.analog.com/media/en/technical-documentation/data-sheets/2664fa.pdf

properties:
  compatible:
    enum:
      - adi,ltc2664

  reg:
    maxItems: 1

  spi-max-frequency:
    maximum: 50000000

  vcc-supply:
    description: Analog Supply Voltage Input.

  v-pos-supply:
    description: Positive Supply Voltage Input.

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

  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 part to the reset code and range determined by the
      hardwired option chosen using the MSPAN pins. The control registers are
      cleared to zero.
    maxItems: 1

  adi,manual-span-operation-config:
    description:
      This property must mimic the MSPAN pin configurations. By tying the MSPAN
      pins (MSP2, MSP1 and MSP0) to GND and/or VCC, any output range can be
      hardware-configured with different mid-scale or zero-scale reset options.
      The hardware configuration is latched during power on reset for proper
      operation.
        0 - MPS2=GND, MPS1=GND, MSP0=GND (+-10V, reset to 0V)
        1 - MPS2=GND, MPS1=GND, MSP0=VCC (+-5V, reset to 0V)
        2 - MPS2=GND, MPS1=VCC, MSP0=GND (+-2.5V, reset to 0V)
        3 - MPS2=GND, MPS1=VCC, MSP0=VCC (0V to 10, reset to 0V)
        4 - MPS2=VCC, MPS1=GND, MSP0=GND (0V to 10V, reset to 5V)
        5 - MPS2=VCC, MPS1=GND, MSP0=VCC (0V to 5V, reset to 0V)
        6 - MPS2=VCC, MPS1=VCC, MSP0=GND (0V to 5V, reset to 2.5V)
        7 - MPS2=VCC, MPS1=VCC, MSP0=VCC (0V to 5V, reset to 0V, enables SoftSpan)
    $ref: /schemas/types.yaml#/definitions/uint32
    enum: [0, 1, 2, 3, 4, 5, 6, 7]
    default: 7

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

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

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

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

      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-microvolt:
        description:
          This property is only allowed when SoftSpan is enabled. If not present,
          [0, 5000000] is the default output range.
        oneOf:
          - items:
              - const: 0
              - enum: [5000000, 10000000]
          - items:
              - const: -5000000
              - const: 5000000
          - items:
              - const: -10000000
              - const: 10000000
          - items:
              - const: -2500000
              - const: 2500000

    required:
      - reg

    allOf:
      - if:
          not:
            properties:
              adi,manual-span-operation-config:
                const: 7
        then:
          patternProperties:
            "^channel@[0-3]$":
              properties:
                output-range-microvolt: false

required:
  - compatible
  - reg
  - spi-max-frequency
  - vcc-supply
  - iovcc-supply
  - v-pos-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,ltc2664";
            reg = <0>;
            spi-max-frequency = <10000000>;

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

            io-channels = <&adc 0>;

            #address-cells = <1>;
            #size-cells = <0>;
            channel@0 {
                reg = <0>;
                adi,toggle-mode;
                output-range-microvolt = <(-10000000) 10000000>;
            };

            channel@1 {
                reg = <1>;
                output-range-microvolt= <0 10000000>;
            };
        };
    };
...