Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dt-bindings: iio: dac: adi,ad5064: Document bindings for many different DACs
Note this is documenting bindings that have effectively existing ever
since this driver was merged. The naming conventions for the ADI
parts are inconsistent on the data sheets which has lead to a mixture
of -X and -reference voltage part naming. We could attempt to clean this
up, but as we are stuck supporting the existing binding it is probably
not worthwhile.
Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Cc: Lars-Peter Clausen <lars@metafoo.de>
Reviewed-by: Rob Herring <robh@kernel.org>
Acked-by: Nuno Sá <nuno.sa@analog.com>
Link: https://lore.kernel.org/r/20210627163244.1090296-3-jic23@kernel.org
+268
+268
Documentation/devicetree/bindings/iio/dac/adi,ad5064.yaml
+268
Documentation/devicetree/bindings/iio/dac/adi,ad5064.yaml
···
1
+
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2
+
%YAML 1.2
3
+
---
4
+
$id: http://devicetree.org/schemas/iio/dac/adi,ad5064.yaml#
5
+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6
+
7
+
title: Analog Devices AD5064 and similar DACs
8
+
9
+
maintainers:
10
+
- Lars-Peter Clausen <lars@metafoo.de>
11
+
- Jonathan Cameron <jic23@kernel.org>
12
+
13
+
description: |
14
+
A range of similar DAC devices with between 1 and 12 channels. Some parts
15
+
have internal references, others require a single shared external reference
16
+
and the remainder have a separate reference pin for each DAC.
17
+
18
+
properties:
19
+
compatible:
20
+
oneOf:
21
+
- description: I2C devics
22
+
enum:
23
+
- adi,ad5024
24
+
- adi,ad5025
25
+
- adi,ad5044
26
+
- adi,ad5045
27
+
- adi,ad5064
28
+
- adi,ad5064-1
29
+
- adi,ad5065
30
+
- adi,ad5628-1
31
+
- adi,ad5628-2
32
+
- adi,ad5648-1
33
+
- adi,ad5648-2
34
+
- adi,ad5666-1
35
+
- adi,ad5666-2
36
+
- adi,ad5668-1
37
+
- adi,ad5668-2
38
+
- adi,ad5668-3
39
+
- description: SPI devices
40
+
enum:
41
+
- adi,ad5625
42
+
- adi,ad5625r-1v25
43
+
- adi,ad5625r-2v5
44
+
- adi,ad5627
45
+
- adi,ad5627r-1v25
46
+
- adi,ad5627r-2v5
47
+
- adi,ad5629-1
48
+
- adi,ad5629-2
49
+
- adi,ad5629-3
50
+
- adi,ad5645r-1v25
51
+
- adi,ad5645r-2v5
52
+
- adi,ad5665
53
+
- adi,ad5665r-1v25
54
+
- adi,ad5665r-2v5
55
+
- adi,ad5667
56
+
- adi,ad5667r-1v25
57
+
- adi,ad5667r-2v5
58
+
- adi,ad5669-1
59
+
- adi,ad5669-2
60
+
- adi,ad5669-3
61
+
- lltc,ltc2606
62
+
- lltc,ltc2607
63
+
- lltc,ltc2609
64
+
- lltc,ltc2616
65
+
- lltc,ltc2617
66
+
- lltc,ltc2619
67
+
- lltc,ltc2626
68
+
- lltc,ltc2627
69
+
- lltc,ltc2629
70
+
- lltc,ltc2631-l12
71
+
- lltc,ltc2631-h12
72
+
- lltc,ltc2631-l10
73
+
- lltc,ltc2631-h10
74
+
- lltc,ltc2631-l8
75
+
- lltc,ltc2631-h8
76
+
- lltc,ltc2633-l12
77
+
- lltc,ltc2633-h12
78
+
- lltc,ltc2633-l10
79
+
- lltc,ltc2633-h10
80
+
- lltc,ltc2633-l8
81
+
- lltc,ltc2633-h8
82
+
- lltc,ltc2635-l12
83
+
- lltc,ltc2635-h12
84
+
- lltc,ltc2635-l10
85
+
- lltc,ltc2635-h10
86
+
- lltc,ltc2635-l8
87
+
- lltc,ltc2635-h8
88
+
89
+
reg:
90
+
maxItems: 1
91
+
92
+
vrefA-supply: true
93
+
vrefB-supply: true
94
+
vrefC-supply: true
95
+
vrefD-supply: true
96
+
vref-supply: true
97
+
98
+
spi-max-frequency: true
99
+
100
+
additionalProperties: false
101
+
102
+
required:
103
+
- compatible
104
+
- reg
105
+
106
+
allOf:
107
+
- # Shared external vref, no internal reference
108
+
if:
109
+
properties:
110
+
compatible:
111
+
contains:
112
+
enum:
113
+
- adi,ad5064-1
114
+
- adi,ad5625
115
+
- adi,ad5627
116
+
- adi,ad5665
117
+
- adi,ad5667
118
+
- lltc,ltc2606
119
+
- lltc,ltc2607
120
+
- lltc,ltc2616
121
+
- lltc,ltc2617
122
+
- lltc,ltc2626
123
+
- lltc,ltc2627
124
+
then:
125
+
properties:
126
+
vref-supply: true
127
+
vrefA-supply: false
128
+
vrefB-supply: false
129
+
vrefC-supply: false
130
+
vrefD-supply: false
131
+
required:
132
+
- vref-supply
133
+
- # Shared external vref, internal reference available
134
+
if:
135
+
properties:
136
+
compatible:
137
+
contains:
138
+
enum:
139
+
- adi,ad5625r-1v25
140
+
- adi,ad5625r-2v5
141
+
- adi,ad5627r-1v25
142
+
- adi,ad5627r-2v5
143
+
- adi,ad5628-1
144
+
- adi,ad5628-2
145
+
- adi,ad5629-1
146
+
- adi,ad5629-2
147
+
- adi,ad5629-3
148
+
- adi,ad5645r-1v25
149
+
- adi,ad5645r-2v5
150
+
- adi,ad5647r-1v25
151
+
- adi,ad5647r-2v5
152
+
- adi,ad5648-1
153
+
- adi,ad5648-2
154
+
- adi,ad5665r-1v25
155
+
- adi,ad5665r-2v5
156
+
- adi,ad5666-1
157
+
- adi,ad5666-2
158
+
- adi,ad5667r-1v25
159
+
- adi,ad5667r-2v5
160
+
- adi,ad5668-1
161
+
- adi,ad5668-2
162
+
- adi,ad5668-3
163
+
- adi,ad5669-1
164
+
- adi,ad5669-2
165
+
- adi,ad5669-3
166
+
- lltc,ltc2631-l12
167
+
- lltc,ltc2631-h12
168
+
- lltc,ltc2631-l10
169
+
- lltc,ltc2631-h10
170
+
- lltc,ltc2631-l8
171
+
- lltc,ltc2631-h8
172
+
- lltc,ltc2633-l12
173
+
- lltc,ltc2633-h12
174
+
- lltc,ltc2633-l10
175
+
- lltc,ltc2633-h10
176
+
- lltc,ltc2633-l8
177
+
- lltc,ltc2633-h8
178
+
- lltc,ltc2635-l12
179
+
- lltc,ltc2635-h12
180
+
- lltc,ltc2635-l10
181
+
- lltc,ltc2635-h10
182
+
- lltc,ltc2635-l8
183
+
- lltc,ltc2635-h8
184
+
then:
185
+
properties:
186
+
vref-supply: true
187
+
vrefA-supply: false
188
+
vrefB-supply: false
189
+
vrefC-supply: false
190
+
vrefD-supply: false
191
+
- # 4 input devices, separate vrefs, no internal reference
192
+
if:
193
+
properties:
194
+
compatible:
195
+
contains:
196
+
enum:
197
+
- adi,ad5024
198
+
- adi,ad5044
199
+
- adi,ad5064
200
+
- lltc,ltc2609
201
+
- lltc,ltc2619
202
+
- lltc,ltc2629
203
+
then:
204
+
properties:
205
+
vrefA-supply: true
206
+
vrefB-supply: true
207
+
vrefC-supply: true
208
+
vrefD-supply: true
209
+
vref-supply: false
210
+
required:
211
+
- vrefA-supply
212
+
- vrefB-supply
213
+
- vrefC-supply
214
+
- vrefD-supply
215
+
- # 2 input devices, separate vrefs, no internal reference
216
+
if:
217
+
properties:
218
+
compatible:
219
+
contains:
220
+
enum:
221
+
- adi,ad5025
222
+
- adi,ad5045
223
+
- adi,ad5065
224
+
then:
225
+
properties:
226
+
vrefA-supply: true
227
+
vrefB-supply: true
228
+
vrefC-supply: false
229
+
vrefD-supply: false
230
+
vref-supply: false
231
+
required:
232
+
- vrefA-supply
233
+
- vrefB-supply
234
+
235
+
examples:
236
+
- |
237
+
spi {
238
+
#address-cells = <1>;
239
+
#size-cells = <0>;
240
+
dac@0 {
241
+
reg = <0>;
242
+
compatible = "adi,ad5625";
243
+
vref-supply = <&dac_vref>;
244
+
};
245
+
};
246
+
- |
247
+
spi {
248
+
#address-cells = <1>;
249
+
#size-cells = <0>;
250
+
dac@0 {
251
+
reg = <0>;
252
+
compatible = "adi,ad5625r-1v25";
253
+
};
254
+
};
255
+
- |
256
+
i2c {
257
+
#address-cells = <1>;
258
+
#size-cells = <0>;
259
+
dac@42 {
260
+
reg = <0x42>;
261
+
compatible = "adi,ad5024";
262
+
vrefA-supply = <&dac_vref>;
263
+
vrefB-supply = <&dac_vref>;
264
+
vrefC-supply = <&dac_vref2>;
265
+
vrefD-supply = <&dac_vref2>;
266
+
};
267
+
};
268
+
...