xref: /linux/Documentation/devicetree/bindings/iio/dac/adi,ad8460.yaml (revision 2eff01ee2881becc9daaa0d53477ec202136b1f4)
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright 2024 Analog Devices Inc.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/iio/dac/adi,ad8460.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Analog Devices AD8460 DAC
9
10maintainers:
11  - Mariel Tinaco <mariel.tinaco@analog.com>
12
13description: |
14  Analog Devices AD8460 110 V High Voltage, 1 A High Current,
15  Arbitrary Waveform Generator with Integrated 14-Bit High Speed DAC
16  https://www.analog.com/media/en/technical-documentation/data-sheets/ad8460.pdf
17
18properties:
19  compatible:
20    enum:
21      - adi,ad8460
22
23  reg:
24    maxItems: 1
25
26  clocks:
27    maxItems: 1
28
29  dmas:
30    maxItems: 1
31
32  dma-names:
33    items:
34      - const: tx
35
36  spi-max-frequency:
37    maximum: 20000000
38
39  hvcc-supply:
40    description: Positive high voltage power supply line
41
42  hvee-supply:
43    description: Negative high voltage power supply line
44
45  vcc-5v-supply:
46    description: Low voltage power supply
47
48  vref-5v-supply:
49    description: Reference voltage for analog low voltage
50
51  dvdd-3p3v-supply:
52    description: Digital supply bypass
53
54  avdd-3p3v-supply:
55    description: Analog supply bypass
56
57  refio-1p2v-supply:
58    description: Drive voltage in the range of 1.2V maximum to as low as
59      low as 0.12V through the REF_IO pin to adjust full scale output span
60
61  adi,external-resistor-ohms:
62    description: Specify value of external resistor connected to FS_ADJ pin
63      to establish internal HVDAC's reference current I_REF
64    minimum: 2000
65    maximum: 20000
66    default: 2000
67
68  adi,range-microvolt:
69    description: Voltage output range specified as <minimum, maximum>
70    items:
71      - minimum: -55000000
72        maximum: 0
73        default: 0
74      - minimum: 0
75        maximum: 55000000
76        default: 0
77
78  adi,range-microamp:
79    description: Current output range specified as <minimum, maximum>
80    items:
81      - minimum: -1000000
82        maximum: 0
83        default: 0
84      - minimum: 0
85        maximum: 1000000
86        default: 0
87
88  adi,max-millicelsius:
89    description: Overtemperature threshold
90    minimum: 0
91    maximum: 150000
92    default: 0
93
94  shutdown-reset-gpios:
95    description: Corresponds to SDN_RESET pin. To exit shutdown
96      or sleep mode, pulse SDN_RESET HIGH, then leave LOW.
97    maxItems: 1
98
99  reset-gpios:
100    description: Manual Power On Reset (POR). Pull this GPIO pin
101      LOW and then HIGH to reset all digital registers to default
102    maxItems: 1
103
104  shutdown-gpios:
105    description: Corresponds to SDN_IO pin. Shutdown may be
106      initiated by the user, by pulsing SDN_IO high. To exit shutdown,
107      pulse SDN_IO low, then float.
108    maxItems: 1
109
110required:
111  - compatible
112  - reg
113  - clocks
114  - hvcc-supply
115  - hvee-supply
116  - vcc-5v-supply
117  - vref-5v-supply
118  - dvdd-3p3v-supply
119  - avdd-3p3v-supply
120  - refio-1p2v-supply
121
122allOf:
123  - $ref: /schemas/spi/spi-peripheral-props.yaml#
124
125unevaluatedProperties: false
126
127examples:
128  - |
129    #include <dt-bindings/gpio/gpio.h>
130
131    spi {
132        #address-cells = <1>;
133        #size-cells = <0>;
134
135        dac@0 {
136            compatible = "adi,ad8460";
137            reg = <0>;
138            spi-max-frequency = <8000000>;
139
140            dmas = <&tx_dma 0>;
141            dma-names = "tx";
142
143            shutdown-reset-gpios = <&gpio 86 GPIO_ACTIVE_HIGH>;
144            reset-gpios = <&gpio 91 GPIO_ACTIVE_LOW>;
145            shutdown-gpios = <&gpio 88 GPIO_ACTIVE_HIGH>;
146
147            clocks = <&sync_ext_clk>;
148
149            hvcc-supply = <&hvcc>;
150            hvee-supply = <&hvee>;
151            vcc-5v-supply = <&vcc_5>;
152            vref-5v-supply = <&vref_5>;
153            dvdd-3p3v-supply = <&dvdd_3_3>;
154            avdd-3p3v-supply = <&avdd_3_3>;
155            refio-1p2v-supply = <&refio_1_2>;
156
157            adi,external-resistor-ohms = <2000>;
158            adi,range-microvolt = <(-40000000) 40000000>;
159            adi,range-microamp = <0 50000>;
160            adi,max-millicelsius = <50000>;
161        };
162    };
163
164...
165