1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) 2# Copyright 2020 Analog Devices Inc. 3%YAML 1.2 4--- 5$id: http://devicetree.org/schemas/iio/dac/adi,ad3552r.yaml# 6$schema: http://devicetree.org/meta-schemas/core.yaml# 7 8title: Analog Devices AD2552R DAC device driver 9 10maintainers: 11 - Nuno Sá <nuno.sa@analog.com> 12 13description: | 14 Bindings for the Analog Devices AD3552R DAC device and similar. 15 Datasheet can be found here: 16 https://www.analog.com/media/en/technical-documentation/data-sheets/ad3542r.pdf 17 https://www.analog.com/media/en/technical-documentation/data-sheets/ad3552r.pdf 18 19properties: 20 compatible: 21 enum: 22 - adi,ad3542r 23 - adi,ad3552r 24 25 reg: 26 maxItems: 1 27 28 spi-max-frequency: 29 maximum: 30000000 30 31 reset-gpios: 32 maxItems: 1 33 34 ldac-gpios: 35 description: | 36 LDAC pin to be used as a hardware trigger to update the DAC channels. 37 maxItems: 1 38 39 vref-supply: 40 description: 41 The regulator to use as an external reference. If it does not exists the 42 internal reference will be used. External reference must be 2.5V 43 44 adi,vref-out-en: 45 description: Vref I/O driven by internal vref to 2.5V. If not set, Vref pin 46 will be floating. 47 type: boolean 48 49 adi,sdo-drive-strength: 50 description: | 51 Configure SDIO0 and SDIO1 strength levels: 52 - 0: low SDO drive strength. 53 - 1: medium low SDO drive strength. 54 - 2: medium high SDO drive strength. 55 - 3: high SDO drive strength 56 $ref: /schemas/types.yaml#/definitions/uint32 57 enum: [0, 1, 2, 3] 58 59 '#address-cells': 60 const: 1 61 62 '#size-cells': 63 const: 0 64 65patternProperties: 66 "^channel@([0-1])$": 67 type: object 68 description: Configurations of the DAC Channels 69 70 additionalProperties: false 71 72 properties: 73 reg: 74 description: Channel number 75 enum: [0, 1] 76 77 adi,output-range-microvolt: true 78 79 custom-output-range-config: 80 type: object 81 description: Configuration of custom range when 82 adi,output-range-microvolt is not present. 83 The formulas for calculation the output voltages are 84 Vout_fs = 2.5 + [(GainN + Offset/1024) * 2.5 * Rfbx * 1.03] 85 Vout_zs = 2.5 - [(GainP + Offset/1024) * 2.5 * Rfbx * 1.03] 86 87 properties: 88 adi,gain-offset: 89 description: Gain offset used in the above formula 90 $ref: /schemas/types.yaml#/definitions/int32 91 maximum: 511 92 minimum: -511 93 94 adi,gain-scaling-p-inv-log2: 95 description: GainP = 1 / ( 2 ^ adi,gain-scaling-p-inv-log2) 96 $ref: /schemas/types.yaml#/definitions/uint32 97 enum: [0, 1, 2, 3] 98 99 adi,gain-scaling-n-inv-log2: 100 description: GainN = 1 / ( 2 ^ adi,gain-scaling-n-inv-log2) 101 $ref: /schemas/types.yaml#/definitions/uint32 102 enum: [0, 1, 2, 3] 103 104 adi,rfb-ohms: 105 description: Feedback Resistor 106 107 required: 108 - adi,gain-offset 109 - adi,gain-scaling-p-inv-log2 110 - adi,gain-scaling-n-inv-log2 111 - adi,rfb-ohms 112 113 required: 114 - reg 115 116 oneOf: 117 # If adi,output-range-microvolt is missing, 118 # custom-output-range-config must be used 119 - required: 120 - adi,output-range-microvolt 121 122 - required: 123 - custom-output-range-config 124 125allOf: 126 - if: 127 properties: 128 compatible: 129 contains: 130 const: adi,ad3542r 131 then: 132 patternProperties: 133 "^channel@([0-1])$": 134 type: object 135 properties: 136 adi,output-range-microvolt: 137 description: | 138 Voltage output range of the channel as <minimum, maximum> 139 Required connections: 140 Rfb1x for: 0 to 2.5 V; 0 to 3V; 0 to 5 V; 141 Rfb2x for: 0 to 10 V; 2.5 to 7.5V; -5 to 5 V; 142 oneOf: 143 - items: 144 - const: 0 145 - enum: [2500000, 3000000, 5000000, 10000000] 146 - items: 147 - const: -2500000 148 - const: 7500000 149 - items: 150 - const: -5000000 151 - const: 5000000 152 153 required: 154 - adi,output-range-microvolt 155 156 - if: 157 properties: 158 compatible: 159 contains: 160 const: adi,ad3552r 161 then: 162 patternProperties: 163 "^channel@([0-1])$": 164 type: object 165 properties: 166 adi,output-range-microvolt: 167 description: | 168 Voltage output range of the channel as <minimum, maximum> 169 Required connections: 170 Rfb1x for: 0 to 2.5 V; 0 to 5 V; 171 Rfb2x for: 0 to 10 V; -5 to 5 V; 172 Rfb4x for: -10 to 10V 173 oneOf: 174 - items: 175 - const: 0 176 - enum: [2500000, 5000000, 10000000] 177 - items: 178 - const: -5000000 179 - const: 5000000 180 - items: 181 - const: -10000000 182 - const: 10000000 183 184required: 185 - compatible 186 - reg 187 - spi-max-frequency 188 189additionalProperties: false 190 191examples: 192 - | 193 spi { 194 #address-cells = <1>; 195 #size-cells = <0>; 196 ad3552r@0 { 197 compatible = "adi,ad3552r"; 198 reg = <0>; 199 spi-max-frequency = <20000000>; 200 #address-cells = <1>; 201 #size-cells = <0>; 202 channel@0 { 203 reg = <0>; 204 adi,output-range-microvolt = <0 10000000>; 205 }; 206 channel@1 { 207 reg = <1>; 208 custom-output-range-config { 209 adi,gain-offset = <5>; 210 adi,gain-scaling-p-inv-log2 = <1>; 211 adi,gain-scaling-n-inv-log2 = <2>; 212 adi,rfb-ohms = <1>; 213 }; 214 }; 215 }; 216 }; 217... 218