xref: /linux/Documentation/devicetree/bindings/iio/dac/adi,ad3530r.yaml (revision c26f4fbd58375bd6ef74f95eb73d61762ad97c59)
1*6856e361SKim Seer Paller# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2*6856e361SKim Seer Paller%YAML 1.2
3*6856e361SKim Seer Paller---
4*6856e361SKim Seer Paller$id: http://devicetree.org/schemas/iio/dac/adi,ad3530r.yaml#
5*6856e361SKim Seer Paller$schema: http://devicetree.org/meta-schemas/core.yaml#
6*6856e361SKim Seer Paller
7*6856e361SKim Seer Pallertitle: Analog Devices AD3530R and Similar DACs
8*6856e361SKim Seer Paller
9*6856e361SKim Seer Pallermaintainers:
10*6856e361SKim Seer Paller  - Kim Seer Paller <kimseer.paller@analog.com>
11*6856e361SKim Seer Paller
12*6856e361SKim Seer Pallerdescription: |
13*6856e361SKim Seer Paller  The AD3530/AD3530R (8-channel) and AD3531/AD3531R (4-channel) are low-power,
14*6856e361SKim Seer Paller  16-bit, buffered voltage output digital-to-analog converters (DACs) with
15*6856e361SKim Seer Paller  software-programmable gain controls, providing full-scale output spans of 2.5V
16*6856e361SKim Seer Paller  or 5V for reference voltages of 2.5V. These devices operate from a single 2.7V
17*6856e361SKim Seer Paller  to 5.5V supply and are guaranteed monotonic by design. The "R" variants
18*6856e361SKim Seer Paller  include a 2.5V, 5ppmC internal reference, which is disabled by default.
19*6856e361SKim Seer Paller  Datasheet can be found here:
20*6856e361SKim Seer Paller  https://www.analog.com/media/en/technical-documentation/data-sheets/ad3530_ad530r.pdf
21*6856e361SKim Seer Paller  https://www.analog.com/media/en/technical-documentation/data-sheets/ad3531-ad3531r.pdf
22*6856e361SKim Seer Paller
23*6856e361SKim Seer Pallerproperties:
24*6856e361SKim Seer Paller  compatible:
25*6856e361SKim Seer Paller    enum:
26*6856e361SKim Seer Paller      - adi,ad3530
27*6856e361SKim Seer Paller      - adi,ad3530r
28*6856e361SKim Seer Paller      - adi,ad3531
29*6856e361SKim Seer Paller      - adi,ad3531r
30*6856e361SKim Seer Paller
31*6856e361SKim Seer Paller  reg:
32*6856e361SKim Seer Paller    maxItems: 1
33*6856e361SKim Seer Paller
34*6856e361SKim Seer Paller  spi-max-frequency:
35*6856e361SKim Seer Paller    maximum: 50000000
36*6856e361SKim Seer Paller
37*6856e361SKim Seer Paller  vdd-supply:
38*6856e361SKim Seer Paller    description: Power Supply Input.
39*6856e361SKim Seer Paller
40*6856e361SKim Seer Paller  iovdd-supply:
41*6856e361SKim Seer Paller    description: Digital Power Supply Input.
42*6856e361SKim Seer Paller
43*6856e361SKim Seer Paller  io-channels:
44*6856e361SKim Seer Paller    description:
45*6856e361SKim Seer Paller      ADC channel used to monitor internal die temperature, output voltages, and
46*6856e361SKim Seer Paller      current of a selected channel via the MUXOUT pin.
47*6856e361SKim Seer Paller    maxItems: 1
48*6856e361SKim Seer Paller
49*6856e361SKim Seer Paller  ref-supply:
50*6856e361SKim Seer Paller    description:
51*6856e361SKim Seer Paller      Reference Input/Output. The voltage at the REF pin sets the full-scale
52*6856e361SKim Seer Paller      range of all channels. If not provided the internal reference is used and
53*6856e361SKim Seer Paller      also provided on the VREF pin.
54*6856e361SKim Seer Paller
55*6856e361SKim Seer Paller  reset-gpios:
56*6856e361SKim Seer Paller    description:
57*6856e361SKim Seer Paller      Active low signal that is falling edge sensitive. When it is deasserted,
58*6856e361SKim Seer Paller      the digital core initialization is performed and all DAC registers except
59*6856e361SKim Seer Paller      the Interface Configuration A register are reset to their default values.
60*6856e361SKim Seer Paller    maxItems: 1
61*6856e361SKim Seer Paller
62*6856e361SKim Seer Paller  ldac-gpios:
63*6856e361SKim Seer Paller    description:
64*6856e361SKim Seer Paller      LDAC pin to be used as a hardware trigger to update the DAC channels. If
65*6856e361SKim Seer Paller      not present, the DAC channels are updated by Software LDAC.
66*6856e361SKim Seer Paller    maxItems: 1
67*6856e361SKim Seer Paller
68*6856e361SKim Seer Paller  adi,range-double:
69*6856e361SKim Seer Paller    description:
70*6856e361SKim Seer Paller      Configure the output range for all channels. If the property is present,
71*6856e361SKim Seer Paller      the output will range from 0V to 2Vref. If the property is not present,
72*6856e361SKim Seer Paller      the output will range from 0V to Vref.
73*6856e361SKim Seer Paller    type: boolean
74*6856e361SKim Seer Paller
75*6856e361SKim Seer Pallerrequired:
76*6856e361SKim Seer Paller  - compatible
77*6856e361SKim Seer Paller  - reg
78*6856e361SKim Seer Paller  - vdd-supply
79*6856e361SKim Seer Paller  - iovdd-supply
80*6856e361SKim Seer Paller
81*6856e361SKim Seer PallerallOf:
82*6856e361SKim Seer Paller  - $ref: /schemas/spi/spi-peripheral-props.yaml#
83*6856e361SKim Seer Paller
84*6856e361SKim Seer PallerunevaluatedProperties: false
85*6856e361SKim Seer Paller
86*6856e361SKim Seer Pallerexamples:
87*6856e361SKim Seer Paller  - |
88*6856e361SKim Seer Paller    spi {
89*6856e361SKim Seer Paller        #address-cells = <1>;
90*6856e361SKim Seer Paller        #size-cells = <0>;
91*6856e361SKim Seer Paller        dac@0 {
92*6856e361SKim Seer Paller            compatible = "adi,ad3530r";
93*6856e361SKim Seer Paller            reg = <0>;
94*6856e361SKim Seer Paller            spi-max-frequency = <1000000>;
95*6856e361SKim Seer Paller
96*6856e361SKim Seer Paller            vdd-supply = <&vdd>;
97*6856e361SKim Seer Paller            iovdd-supply = <&iovdd>;
98*6856e361SKim Seer Paller        };
99*6856e361SKim Seer Paller    };
100*6856e361SKim Seer Paller...
101