adi,ad8460.yaml

  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...