1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-C 1 # SPDX-License-Identifier: (GPL-2.0 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,ad5755.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Analog Devices AD5755 Multi-Channel DAC 7 title: Analog Devices AD5755 Multi-Channel DAC
8 8
9 maintainers: 9 maintainers:
10 - Sean Nyekjaer <sean.nyekjaer@prevas.dk> 10 - Sean Nyekjaer <sean.nyekjaer@prevas.dk>
11 11
12 properties: 12 properties:
13 compatible: 13 compatible:
14 enum: 14 enum:
15 - adi,ad5755 15 - adi,ad5755
16 - adi,ad5755-1 16 - adi,ad5755-1
17 - adi,ad5757 17 - adi,ad5757
18 - adi,ad5735 18 - adi,ad5735
19 - adi,ad5737 19 - adi,ad5737
20 20
21 reg: 21 reg:
22 maxItems: 1 22 maxItems: 1
23 23
24 spi-cpha: 24 spi-cpha:
25 description: Either this or spi-cpol but n 25 description: Either this or spi-cpol but not both.
26 spi-cpol: true 26 spi-cpol: true
27 27
28 adi,ext-dc-dc-compenstation-resistor: 28 adi,ext-dc-dc-compenstation-resistor:
29 $ref: /schemas/types.yaml#/definitions/fla 29 $ref: /schemas/types.yaml#/definitions/flag
30 description: 30 description:
31 Set if the hardware have an external res 31 Set if the hardware have an external resistor and thereby bypasses
32 the internal compensation resistor. 32 the internal compensation resistor.
33 33
34 adi,dc-dc-phase: 34 adi,dc-dc-phase:
35 $ref: /schemas/types.yaml#/definitions/uin 35 $ref: /schemas/types.yaml#/definitions/uint32
36 enum: [0, 1, 2, 3] 36 enum: [0, 1, 2, 3]
37 description: | 37 description: |
38 Valid values for DC DC Phase control is: 38 Valid values for DC DC Phase control is:
39 0: All dc-to-dc converters clock on the 39 0: All dc-to-dc converters clock on the same edge.
40 1: Channel A and Channel B clock on the 40 1: Channel A and Channel B clock on the same edge,
41 Channel C and Channel D clock on oppo 41 Channel C and Channel D clock on opposite edges.
42 2: Channel A and Channel C clock on the 42 2: Channel A and Channel C clock on the same edge,
43 Channel B and Channel D clock on oppo 43 Channel B and Channel D clock on opposite edges.
44 3: Channel A, Channel B, Channel C, and 44 3: Channel A, Channel B, Channel C, and Channel D
45 clock 90 degrees out of phase from ea 45 clock 90 degrees out of phase from each other.
46 46
47 adi,dc-dc-freq-hz: 47 adi,dc-dc-freq-hz:
48 enum: [250000, 410000, 650000] 48 enum: [250000, 410000, 650000]
49 49
50 adi,dc-dc-max-microvolt: 50 adi,dc-dc-max-microvolt:
51 description: 51 description:
52 Maximum allowed Vboost voltage supplied 52 Maximum allowed Vboost voltage supplied by the dc-to-dc converter.
53 enum: [23000000, 24500000, 27000000, 29500 53 enum: [23000000, 24500000, 27000000, 29500000]
54 54
55 "#address-cells": 55 "#address-cells":
56 const: 1 56 const: 1
57 57
58 "#size-cells": 58 "#size-cells":
59 const: 0 59 const: 0
60 60
61 "#io-channel-cells": 61 "#io-channel-cells":
62 const: 1 62 const: 1
63 63
64 required: 64 required:
65 - compatible 65 - compatible
66 - reg 66 - reg
67 67
68 patternProperties: 68 patternProperties:
69 "^channel@[0-7]$": 69 "^channel@[0-7]$":
70 type: object 70 type: object
71 description: Child node to describe a chan 71 description: Child node to describe a channel
72 properties: 72 properties:
73 reg: 73 reg:
74 maxItems: 1 74 maxItems: 1
75 75
76 adi,mode: 76 adi,mode:
77 $ref: /schemas/types.yaml#/definitions 77 $ref: /schemas/types.yaml#/definitions/uint32
78 minimum: 0 78 minimum: 0
79 maximum: 6 79 maximum: 6
80 description: | 80 description: |
81 Valid values for DAC modes is: 81 Valid values for DAC modes is:
82 0: 0 V to 5 V voltage range. 82 0: 0 V to 5 V voltage range.
83 1: 0 V to 10 V voltage range. 83 1: 0 V to 10 V voltage range.
84 2: Plus minus 5 V voltage range. 84 2: Plus minus 5 V voltage range.
85 3: Plus minus 10 V voltage range. 85 3: Plus minus 10 V voltage range.
86 4: 4 mA to 20 mA current range. 86 4: 4 mA to 20 mA current range.
87 5: 0 mA to 20 mA current range. 87 5: 0 mA to 20 mA current range.
88 6: 0 mA to 24 mA current range. 88 6: 0 mA to 24 mA current range.
89 89
90 adi,ext-current-sense-resistor: 90 adi,ext-current-sense-resistor:
91 $ref: /schemas/types.yaml#/definitions 91 $ref: /schemas/types.yaml#/definitions/flag
92 description: 92 description:
93 Set if the hardware has an external 93 Set if the hardware has an external current sense resistor
94 94
95 adi,enable-voltage-overrange: 95 adi,enable-voltage-overrange:
96 $ref: /schemas/types.yaml#/definitions 96 $ref: /schemas/types.yaml#/definitions/flag
97 description: Enable voltage overrange 97 description: Enable voltage overrange
98 98
99 adi,slew: 99 adi,slew:
100 $ref: /schemas/types.yaml#/definitions 100 $ref: /schemas/types.yaml#/definitions/uint32-array
101 description: | 101 description: |
102 Array of slewrate settings should co 102 Array of slewrate settings should contain 3 fields:
103 1: Should be either 0 or 1 in order 103 1: Should be either 0 or 1 in order to enable or disable slewrate.
104 2: Slew rate update frequency 104 2: Slew rate update frequency
105 3: Slew step size 105 3: Slew step size
106 items: 106 items:
107 - enum: [0, 1] 107 - enum: [0, 1]
108 - enum: [64000, 32000, 16000, 8000, 108 - enum: [64000, 32000, 16000, 8000, 4000, 2000, 1000, 500, 250, 125, 64, 32, 16, 8, 4, 0]
109 - enum: [1, 2, 4, 16, 32, 64, 128, 2 109 - enum: [1, 2, 4, 16, 32, 64, 128, 256]
110 110
111 required: 111 required:
112 - reg 112 - reg
113 113
114 additionalProperties: false 114 additionalProperties: false
115 115
116 oneOf: 116 oneOf:
117 - required: 117 - required:
118 - spi-cpha 118 - spi-cpha
119 - required: 119 - required:
120 - spi-cpol 120 - spi-cpol
121 121
122 allOf: 122 allOf:
123 - $ref: /schemas/spi/spi-peripheral-props.ya 123 - $ref: /schemas/spi/spi-peripheral-props.yaml#
124 124
125 unevaluatedProperties: false 125 unevaluatedProperties: false
126 126
127 examples: 127 examples:
128 - | 128 - |
129 spi { 129 spi {
130 #address-cells = <1>; 130 #address-cells = <1>;
131 #size-cells = <0>; 131 #size-cells = <0>;
132 132
133 dac@0 { 133 dac@0 {
134 #address-cells = <1>; 134 #address-cells = <1>;
135 #size-cells = <0>; 135 #size-cells = <0>;
136 compatible = "adi,ad5755"; 136 compatible = "adi,ad5755";
137 reg = <0>; 137 reg = <0>;
138 spi-max-frequency = <1000000>; 138 spi-max-frequency = <1000000>;
139 spi-cpha; 139 spi-cpha;
140 adi,dc-dc-phase = <0>; 140 adi,dc-dc-phase = <0>;
141 adi,dc-dc-freq-hz = <410000>; 141 adi,dc-dc-freq-hz = <410000>;
142 adi,dc-dc-max-microvolt = <2300000 142 adi,dc-dc-max-microvolt = <23000000>;
143 channel@0 { 143 channel@0 {
144 reg = <0>; 144 reg = <0>;
145 adi,mode = <4>; 145 adi,mode = <4>;
146 adi,ext-current-sense-resistor 146 adi,ext-current-sense-resistor;
147 adi,slew = <0 64000 1>; 147 adi,slew = <0 64000 1>;
148 }; 148 };
149 channel@1 { 149 channel@1 {
150 reg = <1>; 150 reg = <1>;
151 adi,mode = <4>; 151 adi,mode = <4>;
152 adi,ext-current-sense-resistor 152 adi,ext-current-sense-resistor;
153 adi,slew = <0 64000 1>; 153 adi,slew = <0 64000 1>;
154 }; 154 };
155 channel@2 { 155 channel@2 {
156 reg = <2>; 156 reg = <2>;
157 adi,mode = <4>; 157 adi,mode = <4>;
158 adi,ext-current-sense-resistor 158 adi,ext-current-sense-resistor;
159 adi,slew = <0 64000 1>; 159 adi,slew = <0 64000 1>;
160 }; 160 };
161 channel@3 { 161 channel@3 {
162 reg = <3>; 162 reg = <3>;
163 adi,mode = <4>; 163 adi,mode = <4>;
164 adi,ext-current-sense-resistor 164 adi,ext-current-sense-resistor;
165 adi,slew = <0 64000 1>; 165 adi,slew = <0 64000 1>;
166 }; 166 };
167 }; 167 };
168 }; 168 };
169 ... 169 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.