1 # SPDX-License-Identifier: (GPL-2.0-only OR BS 1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/iio/dac/adi 4 $id: http://devicetree.org/schemas/iio/dac/adi,ltc2688.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Analog Devices LTC2688 DAC 7 title: Analog Devices LTC2688 DAC
8 8
9 maintainers: 9 maintainers:
10 - Nuno Sá <nuno.sa@analog.com> 10 - Nuno Sá <nuno.sa@analog.com>
11 11
12 description: | 12 description: |
13 Analog Devices LTC2688 16 channel, 16 bit, + 13 Analog Devices LTC2688 16 channel, 16 bit, +-15V DAC
14 https://www.analog.com/media/en/technical-do 14 https://www.analog.com/media/en/technical-documentation/data-sheets/ltc2688.pdf
15 15
16 properties: 16 properties:
17 compatible: 17 compatible:
18 enum: 18 enum:
19 - adi,ltc2688 19 - adi,ltc2688
20 20
21 reg: 21 reg:
22 maxItems: 1 22 maxItems: 1
23 23
24 vcc-supply: 24 vcc-supply:
25 description: Analog Supply Voltage Input. 25 description: Analog Supply Voltage Input.
26 26
27 iovcc-supply: 27 iovcc-supply:
28 description: Digital Input/Output Supply V 28 description: Digital Input/Output Supply Voltage.
29 29
30 vref-supply: 30 vref-supply:
31 description: 31 description:
32 Reference Input/Output. The voltage at t 32 Reference Input/Output. The voltage at the REF pin sets the full-scale
33 range of all channels. If not provided t 33 range of all channels. If not provided the internal reference is used and
34 also provided on the VREF pin". 34 also provided on the VREF pin".
35 35
36 clr-gpios: 36 clr-gpios:
37 description: 37 description:
38 If specified, it will be asserted during 38 If specified, it will be asserted during driver probe. As the line is
39 active low, it should be marked GPIO_ACT 39 active low, it should be marked GPIO_ACTIVE_LOW.
40 maxItems: 1 40 maxItems: 1
41 41
42 '#address-cells': 42 '#address-cells':
43 const: 1 43 const: 1
44 44
45 '#size-cells': 45 '#size-cells':
46 const: 0 46 const: 0
47 47
48 patternProperties: 48 patternProperties:
49 "^channel@([0-9]|1[0-5])$": 49 "^channel@([0-9]|1[0-5])$":
50 type: object 50 type: object
51 additionalProperties: false 51 additionalProperties: false
52 52
53 properties: 53 properties:
54 reg: 54 reg:
55 description: The channel number repres 55 description: The channel number representing the DAC output channel.
56 maximum: 15 56 maximum: 15
57 57
58 adi,toggle-mode: 58 adi,toggle-mode:
59 description: 59 description:
60 Set the channel as a toggle enabled 60 Set the channel as a toggle enabled channel. Toggle operation enables
61 fast switching of a DAC output betwe 61 fast switching of a DAC output between two different DAC codes without
62 any SPI transaction. 62 any SPI transaction.
63 type: boolean 63 type: boolean
64 64
65 adi,output-range-microvolt: 65 adi,output-range-microvolt:
66 description: Specify the channel outpu 66 description: Specify the channel output full scale range.
67 oneOf: 67 oneOf:
68 - items: 68 - items:
69 - const: 0 69 - const: 0
70 - enum: [5000000, 10000000] 70 - enum: [5000000, 10000000]
71 - items: 71 - items:
72 - const: -5000000 72 - const: -5000000
73 - const: 5000000 73 - const: 5000000
74 - items: 74 - items:
75 - const: -10000000 75 - const: -10000000
76 - const: 10000000 76 - const: 10000000
77 - items: 77 - items:
78 - const: -15000000 78 - const: -15000000
79 - const: 15000000 79 - const: 15000000
80 80
81 adi,overrange: 81 adi,overrange:
82 description: Enable 5% overrange over 82 description: Enable 5% overrange over the selected full scale range.
83 type: boolean 83 type: boolean
84 84
85 clocks: 85 clocks:
86 maxItems: 1 86 maxItems: 1
87 87
88 adi,toggle-dither-input: 88 adi,toggle-dither-input:
89 description: 89 description:
90 Selects the TGPx pin to be associate 90 Selects the TGPx pin to be associated with this channel. This setting
91 only makes sense for toggle or dithe 91 only makes sense for toggle or dither enabled channels. If
92 @adi,toggle-mode is not set and this 92 @adi,toggle-mode is not set and this property is given, the channel is
93 assumed to be a dither capable chann 93 assumed to be a dither capable channel. Note that multiple channels
94 can be mapped to the same pin. If th 94 can be mapped to the same pin. If this setting is given, the
95 respective @clock must also be provi 95 respective @clock must also be provided. Mappings between this and
96 input pins 96 input pins
97 0 - TGP1 97 0 - TGP1
98 1 - TGP2 98 1 - TGP2
99 2 - TGP3 99 2 - TGP3
100 $ref: /schemas/types.yaml#/definitions 100 $ref: /schemas/types.yaml#/definitions/uint32
101 enum: [0, 1, 2] 101 enum: [0, 1, 2]
102 102
103 dependencies: 103 dependencies:
104 adi,toggle-dither-input: [ clocks ] 104 adi,toggle-dither-input: [ clocks ]
105 105
106 required: 106 required:
107 - reg 107 - reg
108 108
109 required: 109 required:
110 - compatible 110 - compatible
111 - reg 111 - reg
112 112
113 additionalProperties: false 113 additionalProperties: false
114 114
115 examples: 115 examples:
116 - | 116 - |
117 117
118 spi { 118 spi {
119 #address-cells = <1>; 119 #address-cells = <1>;
120 #size-cells = <0>; 120 #size-cells = <0>;
121 ltc2688: ltc2688@0 { 121 ltc2688: ltc2688@0 {
122 compatible = "adi,ltc2688"; 122 compatible = "adi,ltc2688";
123 reg = <0>; 123 reg = <0>;
124 124
125 vcc-supply = <&vcc>; 125 vcc-supply = <&vcc>;
126 iovcc-supply = <&vcc>; 126 iovcc-supply = <&vcc>;
127 vref-supply = <&vref>; 127 vref-supply = <&vref>;
128 128
129 #address-cells = <1>; 129 #address-cells = <1>;
130 #size-cells = <0>; 130 #size-cells = <0>;
131 channel@0 { 131 channel@0 {
132 reg = <0>; 132 reg = <0>;
133 adi,toggle-mode; 133 adi,toggle-mode;
134 adi,overrange; 134 adi,overrange;
135 }; 135 };
136 136
137 channel@1 { 137 channel@1 {
138 reg = <1>; 138 reg = <1>;
139 adi,output-range-microvolt = < 139 adi,output-range-microvolt = <0 10000000>;
140 140
141 clocks = <&clock_tgp3>; 141 clocks = <&clock_tgp3>;
142 adi,toggle-dither-input = <2>; 142 adi,toggle-dither-input = <2>;
143 }; 143 };
144 }; 144 };
145 }; 145 };
146 146
147 ... 147 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.