Skip to content

Commit e79347c

Browse files
MarielTinaconunojsa
MarielTinaco
authored and
nunojsa
committed
dt-bindings: iio: dac: add docs for ad8460
This adds the bindings documentation for the 14-bit High Voltage, High Current, Waveform Generator Digital-to-Analog converter. Signed-off-by: Mariel Tinaco <Mariel.Tinaco@analog.com> Reviewed-by: Krzysztof Kozlowski <krzk@kernel.org> Link: https://patch.msgid.link/20240912095435.18639-2-Mariel.Tinaco@analog.com Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
1 parent a679a20 commit e79347c

File tree

2 files changed

+171
-0
lines changed

2 files changed

+171
-0
lines changed

‎Documentation/devicetree/bindings/iio/dac/adi,ad8460.yaml

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
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+
8+
title: Analog Devices AD8460 DAC
9+
10+
maintainers:
11+
- Mariel Tinaco <mariel.tinaco@analog.com>
12+
13+
description: |
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+
18+
properties:
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+
110+
required:
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+
122+
allOf:
123+
- $ref: /schemas/spi/spi-peripheral-props.yaml#
124+
125+
unevaluatedProperties: false
126+
127+
examples:
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+
...

‎MAINTAINERS

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1341,6 +1341,13 @@ F: Documentation/devicetree/bindings/iio/addac/adi,ad74413r.yaml
13411341
F: drivers/iio/addac/ad74413r.c
13421342
F: include/dt-bindings/iio/addac/adi,ad74413r.h
13431343

1344+
ANALOG DEVICES INC AD8460 DRIVER
1345+
M: Mariel Tinaco <Mariel.Tinaco@analog.com>
1346+
L: linux-iio@vger.kernel.org
1347+
S: Supported
1348+
W: https://ez.analog.com/linux-software-drivers
1349+
F: Documentation/devicetree/bindings/iio/dac/adi,ad8460.yaml
1350+
13441351
ANALOG DEVICES INC AD9389B DRIVER
13451352
M: Hans Verkuil <hverkuil-cisco@xs4all.nl>
13461353
L: linux-media@vger.kernel.org

0 commit comments

Comments
 (0)