219 lines
5.9 KiB
YAML
219 lines
5.9 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
|
|
# Copyright 2020 Analog Devices Inc.
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/iio/dac/adi,ad3552r.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Analog Devices AD2552R DAC device driver
|
|
|
|
maintainers:
|
|
- Nuno Sá <nuno.sa@analog.com>
|
|
|
|
description: |
|
|
Bindings for the Analog Devices AD3552R DAC device and similar.
|
|
Datasheet can be found here:
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad3542r.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad3552r.pdf
|
|
|
|
properties:
|
|
compatible:
|
|
enum:
|
|
- adi,ad3542r
|
|
- adi,ad3552r
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
spi-max-frequency:
|
|
maximum: 30000000
|
|
|
|
reset-gpios:
|
|
maxItems: 1
|
|
|
|
ldac-gpios:
|
|
description: |
|
|
LDAC pin to be used as a hardware trigger to update the DAC channels.
|
|
maxItems: 1
|
|
|
|
vref-supply:
|
|
description:
|
|
The regulator to use as an external reference. If it does not exists the
|
|
internal reference will be used. External reference must be 2.5V
|
|
|
|
adi,vref-out-en:
|
|
description: Vref I/O driven by internal vref to 2.5V. If not set, Vref pin
|
|
will be floating.
|
|
type: boolean
|
|
|
|
adi,sdo-drive-strength:
|
|
description: |
|
|
Configure SDIO0 and SDIO1 strength levels:
|
|
- 0: low SDO drive strength.
|
|
- 1: medium low SDO drive strength.
|
|
- 2: medium high SDO drive strength.
|
|
- 3: high SDO drive strength
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [0, 1, 2, 3]
|
|
|
|
'#address-cells':
|
|
const: 1
|
|
|
|
'#size-cells':
|
|
const: 0
|
|
|
|
patternProperties:
|
|
"^channel@([0-1])$":
|
|
type: object
|
|
description: Configurations of the DAC Channels
|
|
|
|
additionalProperties: false
|
|
|
|
properties:
|
|
reg:
|
|
description: Channel number
|
|
enum: [0, 1]
|
|
|
|
adi,output-range-microvolt: true
|
|
|
|
custom-output-range-config:
|
|
type: object
|
|
additionalProperties: false
|
|
description: Configuration of custom range when
|
|
adi,output-range-microvolt is not present.
|
|
The formulas for calculation the output voltages are
|
|
Vout_fs = 2.5 + [(GainN + Offset/1024) * 2.5 * Rfbx * 1.03]
|
|
Vout_zs = 2.5 - [(GainP + Offset/1024) * 2.5 * Rfbx * 1.03]
|
|
|
|
properties:
|
|
adi,gain-offset:
|
|
description: Gain offset used in the above formula
|
|
$ref: /schemas/types.yaml#/definitions/int32
|
|
maximum: 511
|
|
minimum: -511
|
|
|
|
adi,gain-scaling-p-inv-log2:
|
|
description: GainP = 1 / ( 2 ^ adi,gain-scaling-p-inv-log2)
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [0, 1, 2, 3]
|
|
|
|
adi,gain-scaling-n-inv-log2:
|
|
description: GainN = 1 / ( 2 ^ adi,gain-scaling-n-inv-log2)
|
|
$ref: /schemas/types.yaml#/definitions/uint32
|
|
enum: [0, 1, 2, 3]
|
|
|
|
adi,rfb-ohms:
|
|
description: Feedback Resistor
|
|
|
|
required:
|
|
- adi,gain-offset
|
|
- adi,gain-scaling-p-inv-log2
|
|
- adi,gain-scaling-n-inv-log2
|
|
- adi,rfb-ohms
|
|
|
|
required:
|
|
- reg
|
|
|
|
oneOf:
|
|
# If adi,output-range-microvolt is missing,
|
|
# custom-output-range-config must be used
|
|
- required:
|
|
- adi,output-range-microvolt
|
|
|
|
- required:
|
|
- custom-output-range-config
|
|
|
|
allOf:
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: adi,ad3542r
|
|
then:
|
|
patternProperties:
|
|
"^channel@([0-1])$":
|
|
type: object
|
|
properties:
|
|
adi,output-range-microvolt:
|
|
description: |
|
|
Voltage output range of the channel as <minimum, maximum>
|
|
Required connections:
|
|
Rfb1x for: 0 to 2.5 V; 0 to 3V; 0 to 5 V;
|
|
Rfb2x for: 0 to 10 V; 2.5 to 7.5V; -5 to 5 V;
|
|
oneOf:
|
|
- items:
|
|
- const: 0
|
|
- enum: [2500000, 3000000, 5000000, 10000000]
|
|
- items:
|
|
- const: -2500000
|
|
- const: 7500000
|
|
- items:
|
|
- const: -5000000
|
|
- const: 5000000
|
|
|
|
required:
|
|
- adi,output-range-microvolt
|
|
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
const: adi,ad3552r
|
|
then:
|
|
patternProperties:
|
|
"^channel@([0-1])$":
|
|
type: object
|
|
properties:
|
|
adi,output-range-microvolt:
|
|
description: |
|
|
Voltage output range of the channel as <minimum, maximum>
|
|
Required connections:
|
|
Rfb1x for: 0 to 2.5 V; 0 to 5 V;
|
|
Rfb2x for: 0 to 10 V; -5 to 5 V;
|
|
Rfb4x for: -10 to 10V
|
|
oneOf:
|
|
- items:
|
|
- const: 0
|
|
- enum: [2500000, 5000000, 10000000]
|
|
- items:
|
|
- const: -5000000
|
|
- const: 5000000
|
|
- items:
|
|
- const: -10000000
|
|
- const: 10000000
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- spi-max-frequency
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
spi {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
ad3552r@0 {
|
|
compatible = "adi,ad3552r";
|
|
reg = <0>;
|
|
spi-max-frequency = <20000000>;
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
channel@0 {
|
|
reg = <0>;
|
|
adi,output-range-microvolt = <0 10000000>;
|
|
};
|
|
channel@1 {
|
|
reg = <1>;
|
|
custom-output-range-config {
|
|
adi,gain-offset = <5>;
|
|
adi,gain-scaling-p-inv-log2 = <1>;
|
|
adi,gain-scaling-n-inv-log2 = <2>;
|
|
adi,rfb-ohms = <1>;
|
|
};
|
|
};
|
|
};
|
|
};
|
|
...
|