397 lines
12 KiB
YAML
397 lines
12 KiB
YAML
|
# SPDX-License-Identifier: GPL-2.0
|
||
|
|
%YAML 1.2
|
||
|
|
---
|
||
|
|
$id: http://devicetree.org/schemas/iio/adc/adi,ad7606.yaml#
|
||
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
||
|
|
|
||
|
|
title: Analog Devices AD7606 Simultaneous Sampling ADC
|
||
|
|
|
||
|
|
maintainers:
|
||
|
|
- Michael Hennerich <michael.hennerich@analog.com>
|
||
|
|
|
||
|
|
description: |
|
||
|
|
Analog Devices AD7606 Simultaneous Sampling ADC
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/AD7605-4.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7606_7606-6_7606-4.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/AD7606B.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7606c-16.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7606c-18.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7607.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7608.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7609.pdf
|
||
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/AD7616.pdf
|
||
|
|
|
||
|
|
properties:
|
||
|
|
compatible:
|
||
|
|
enum:
|
||
|
|
- adi,ad7605-4
|
||
|
|
- adi,ad7606-4
|
||
|
|
- adi,ad7606-6
|
||
|
|
- adi,ad7606-8 # Referred to as AD7606 (without -8) in the datasheet
|
||
|
|
- adi,ad7606b
|
||
|
|
- adi,ad7606c-16
|
||
|
|
- adi,ad7606c-18
|
||
|
|
- adi,ad7607
|
||
|
|
- adi,ad7608
|
||
|
|
- adi,ad7609
|
||
|
|
- adi,ad7616
|
||
|
|
|
||
|
|
reg:
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
"#address-cells":
|
||
|
|
const: 1
|
||
|
|
|
||
|
|
"#size-cells":
|
||
|
|
const: 0
|
||
|
|
|
||
|
|
# According to the datasheet, "Data is clocked in from SDI on the falling
|
||
|
|
# edge of SCLK, while data is clocked out on DOUTA on the rising edge of
|
||
|
|
# SCLK". Also, even if not stated textually in the datasheet, it is made
|
||
|
|
# clear on the diagrams that sclk idles at high. Subsequently, in case SPI
|
||
|
|
# interface is used, the correct way is to only set spi-cpol.
|
||
|
|
spi-cpha: true
|
||
|
|
|
||
|
|
spi-cpol: true
|
||
|
|
|
||
|
|
avcc-supply: true
|
||
|
|
|
||
|
|
vdrive-supply:
|
||
|
|
description:
|
||
|
|
Determines the voltage level at which the interface logic pins will
|
||
|
|
operate.
|
||
|
|
|
||
|
|
refin-supply:
|
||
|
|
description:
|
||
|
|
The voltage supply for optional external reference voltage.
|
||
|
|
|
||
|
|
interrupts:
|
||
|
|
description:
|
||
|
|
The BUSY pin falling edge indicates that the conversion is over, and thus
|
||
|
|
new data is available.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
adi,conversion-start-gpios:
|
||
|
|
description:
|
||
|
|
Must be the device tree identifier of the CONVST pin(s). This logic input
|
||
|
|
is used to initiate conversions on the analog input channels. As the line
|
||
|
|
is active high, it should be marked GPIO_ACTIVE_HIGH.
|
||
|
|
minItems: 1
|
||
|
|
maxItems: 2
|
||
|
|
|
||
|
|
reset-gpios:
|
||
|
|
description:
|
||
|
|
Must be the device tree identifier of the RESET pin. If specified, it will
|
||
|
|
be asserted during driver probe. On the AD7606x, as the line is active
|
||
|
|
high, it should be marked GPIO_ACTIVE_HIGH. On the AD7616, as the line is
|
||
|
|
active low, it should be marked GPIO_ACTIVE_LOW.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
standby-gpios:
|
||
|
|
description:
|
||
|
|
Must be the device tree identifier of the STBY pin. This pin is used to
|
||
|
|
place the AD7606 into one of two power-down modes, Standby mode or
|
||
|
|
Shutdown mode. As the line is active low, it should be marked
|
||
|
|
GPIO_ACTIVE_LOW.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
adi,first-data-gpios:
|
||
|
|
description:
|
||
|
|
Must be the device tree identifier of the FRSTDATA pin. The FRSTDATA
|
||
|
|
output indicates when the first channel, V1, is being read back on either
|
||
|
|
the parallel, byte or serial interface. As the line is active high, it
|
||
|
|
should be marked GPIO_ACTIVE_HIGH.
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
adi,range-gpios:
|
||
|
|
description:
|
||
|
|
Must be the device tree identifier of the RANGE pin. The state on this
|
||
|
|
pin determines the input range of the analog input channels. If this pin
|
||
|
|
is tied to a logic high, the analog input range is ±10V for all channels.
|
||
|
|
On the AD760X, if this pin is tied to a logic low, the analog input range
|
||
|
|
is ±5V for all channels. As the line is active high, it should be marked
|
||
|
|
GPIO_ACTIVE_HIGH. On the AD7616, there are 2 pins, and if the 2 pins are
|
||
|
|
tied to a logic high, software mode is enabled, otherwise one of the 3
|
||
|
|
possible range values is selected.
|
||
|
|
minItems: 1
|
||
|
|
maxItems: 2
|
||
|
|
|
||
|
|
adi,oversampling-ratio-gpios:
|
||
|
|
description:
|
||
|
|
Must be the device tree identifier of the over-sampling mode pins. As the
|
||
|
|
line is active high, it should be marked GPIO_ACTIVE_HIGH. On the AD7606X
|
||
|
|
parts that support it, if all 3 pins are tied to a logic high, software
|
||
|
|
mode is enabled.
|
||
|
|
maxItems: 3
|
||
|
|
|
||
|
|
adi,sw-mode:
|
||
|
|
description:
|
||
|
|
Software mode of operation, so far available only for AD7616 and AD7606B.
|
||
|
|
It is enabled when all three oversampling mode pins are connected to high
|
||
|
|
level for the AD7606B, or both the range selection are connected to high
|
||
|
|
level for the AD7616. The device is configured by the corresponding
|
||
|
|
registers. If the adi,oversampling-ratio-gpios property is defined, then
|
||
|
|
the driver will set the oversampling gpios to high. Otherwise, it is
|
||
|
|
assumed that the pins are hardwired to VDD.
|
||
|
|
type: boolean
|
||
|
|
|
||
|
|
pwms:
|
||
|
|
description:
|
||
|
|
In case the conversion is triggered by a PWM instead of a GPIO plugged to
|
||
|
|
the CONVST pin, the PWM must be referenced.
|
||
|
|
The first is the PWM connected to CONVST or CONVST1 for the chips with the
|
||
|
|
2nd PWM connected to CONVST2, if CONVST2 is available and not shorted to
|
||
|
|
CONVST1.
|
||
|
|
minItems: 1
|
||
|
|
maxItems: 2
|
||
|
|
|
||
|
|
pwm-names:
|
||
|
|
items:
|
||
|
|
- const: convst1
|
||
|
|
- const: convst2
|
||
|
|
|
||
|
|
io-backends:
|
||
|
|
description:
|
||
|
|
A reference to the iio-backend, which is responsible handling the BUSY
|
||
|
|
pin's falling edge and communication.
|
||
|
|
An example of backend can be found at
|
||
|
|
http://analogdevicesinc.github.io/hdl/library/axi_ad7606x/index.html
|
||
|
|
|
||
|
|
|
||
|
|
patternProperties:
|
||
|
|
"^channel@[1-8]$":
|
||
|
|
type: object
|
||
|
|
$ref: adc.yaml
|
||
|
|
unevaluatedProperties: false
|
||
|
|
|
||
|
|
properties:
|
||
|
|
reg:
|
||
|
|
description:
|
||
|
|
The channel number, as specified in the datasheet (from 1 to 8).
|
||
|
|
minimum: 1
|
||
|
|
maximum: 8
|
||
|
|
|
||
|
|
diff-channels:
|
||
|
|
description:
|
||
|
|
Each channel can be configured as a bipolar differential channel.
|
||
|
|
The ADC uses the same positive and negative inputs for this.
|
||
|
|
This property must be specified as 'reg' (or the channel number) for
|
||
|
|
both positive and negative inputs (i.e. diff-channels = <reg reg>).
|
||
|
|
Since the configuration is bipolar differential, the 'bipolar'
|
||
|
|
property is required.
|
||
|
|
items:
|
||
|
|
minimum: 1
|
||
|
|
maximum: 8
|
||
|
|
|
||
|
|
bipolar:
|
||
|
|
description:
|
||
|
|
The ADC channels can be configured as
|
||
|
|
* Bipolar single-ended
|
||
|
|
* Unipolar single-ended
|
||
|
|
* Bipolar differential
|
||
|
|
Therefore in the DT, if no channel node is specified, it is considered
|
||
|
|
'unipolar single-ended'. So for the other configurations the 'bipolar'
|
||
|
|
property must be specified. If 'diff-channels' is specified, it is
|
||
|
|
considered a bipolar differential channel. Otherwise it is bipolar
|
||
|
|
single-ended.
|
||
|
|
|
||
|
|
required:
|
||
|
|
- reg
|
||
|
|
- bipolar
|
||
|
|
|
||
|
|
required:
|
||
|
|
- compatible
|
||
|
|
- reg
|
||
|
|
- avcc-supply
|
||
|
|
- vdrive-supply
|
||
|
|
|
||
|
|
allOf:
|
||
|
|
- $ref: /schemas/spi/spi-peripheral-props.yaml#
|
||
|
|
|
||
|
|
- oneOf:
|
||
|
|
- required:
|
||
|
|
- adi,conversion-start-gpios
|
||
|
|
- required:
|
||
|
|
- pwms
|
||
|
|
|
||
|
|
- oneOf:
|
||
|
|
- required:
|
||
|
|
- interrupts
|
||
|
|
- required:
|
||
|
|
- io-backends
|
||
|
|
|
||
|
|
- if:
|
||
|
|
properties:
|
||
|
|
compatible:
|
||
|
|
contains:
|
||
|
|
const: adi,ad7616
|
||
|
|
then:
|
||
|
|
properties:
|
||
|
|
adi,first-data-gpios: false
|
||
|
|
standby-gpios: false
|
||
|
|
adi,range-gpios:
|
||
|
|
maxItems: 2
|
||
|
|
else:
|
||
|
|
properties:
|
||
|
|
adi,range-gpios:
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
- if:
|
||
|
|
properties:
|
||
|
|
compatible:
|
||
|
|
contains:
|
||
|
|
enum:
|
||
|
|
- adi,ad7605-4
|
||
|
|
- adi,ad7616
|
||
|
|
then:
|
||
|
|
properties:
|
||
|
|
adi,oversampling-ratio-gpios: false
|
||
|
|
|
||
|
|
- if:
|
||
|
|
properties:
|
||
|
|
compatible:
|
||
|
|
contains:
|
||
|
|
enum:
|
||
|
|
- adi,ad7605-4
|
||
|
|
- adi,ad7606-4
|
||
|
|
- adi,ad7606-6
|
||
|
|
- adi,ad7606-8
|
||
|
|
- adi,ad7607
|
||
|
|
- adi,ad7608
|
||
|
|
- adi,ad7609
|
||
|
|
then:
|
||
|
|
properties:
|
||
|
|
adi,sw-mode: false
|
||
|
|
else:
|
||
|
|
properties:
|
||
|
|
pwms:
|
||
|
|
maxItems: 1
|
||
|
|
pwm-names:
|
||
|
|
maxItems: 1
|
||
|
|
adi,conversion-start-gpios:
|
||
|
|
maxItems: 1
|
||
|
|
|
||
|
|
- if:
|
||
|
|
not:
|
||
|
|
required:
|
||
|
|
- adi,sw-mode
|
||
|
|
then:
|
||
|
|
patternProperties:
|
||
|
|
"^channel@[1-8]$": false
|
||
|
|
|
||
|
|
- if:
|
||
|
|
not:
|
||
|
|
properties:
|
||
|
|
compatible:
|
||
|
|
enum:
|
||
|
|
- adi,ad7606c-16
|
||
|
|
- adi,ad7606c-18
|
||
|
|
then:
|
||
|
|
patternProperties:
|
||
|
|
"^channel@[1-8]$": false
|
||
|
|
|
||
|
|
unevaluatedProperties: false
|
||
|
|
|
||
|
|
examples:
|
||
|
|
- |
|
||
|
|
#include <dt-bindings/gpio/gpio.h>
|
||
|
|
iio-backend {
|
||
|
|
#address-cells = <1>;
|
||
|
|
#size-cells = <0>;
|
||
|
|
adi_adc@0 {
|
||
|
|
compatible = "adi,ad7606b";
|
||
|
|
reg = <0>;
|
||
|
|
pwms = <&axi_pwm_gen 0 0>;
|
||
|
|
|
||
|
|
avcc-supply = <&adc_vref>;
|
||
|
|
vdrive-supply = <&vdd_supply>;
|
||
|
|
|
||
|
|
reset-gpios = <&gpio0 91 GPIO_ACTIVE_HIGH>;
|
||
|
|
standby-gpios = <&gpio0 90 GPIO_ACTIVE_LOW>;
|
||
|
|
adi,range-gpios = <&gpio0 89 GPIO_ACTIVE_HIGH>;
|
||
|
|
adi,oversampling-ratio-gpios = <&gpio0 88 GPIO_ACTIVE_HIGH
|
||
|
|
&gpio0 87 GPIO_ACTIVE_HIGH
|
||
|
|
&gpio0 86 GPIO_ACTIVE_HIGH>;
|
||
|
|
io-backends = <&iio_backend>;
|
||
|
|
};
|
||
|
|
};
|
||
|
|
|
||
|
|
- |
|
||
|
|
#include <dt-bindings/gpio/gpio.h>
|
||
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
||
|
|
spi {
|
||
|
|
#address-cells = <1>;
|
||
|
|
#size-cells = <0>;
|
||
|
|
|
||
|
|
adc@0 {
|
||
|
|
compatible = "adi,ad7606-8";
|
||
|
|
reg = <0>;
|
||
|
|
spi-max-frequency = <1000000>;
|
||
|
|
spi-cpol;
|
||
|
|
|
||
|
|
avcc-supply = <&adc_vref>;
|
||
|
|
vdrive-supply = <&vdd_supply>;
|
||
|
|
|
||
|
|
interrupts = <25 IRQ_TYPE_EDGE_FALLING>;
|
||
|
|
interrupt-parent = <&gpio>;
|
||
|
|
|
||
|
|
adi,conversion-start-gpios = <&gpio 17 GPIO_ACTIVE_HIGH>;
|
||
|
|
reset-gpios = <&gpio 27 GPIO_ACTIVE_HIGH>;
|
||
|
|
adi,first-data-gpios = <&gpio 22 GPIO_ACTIVE_HIGH>;
|
||
|
|
adi,oversampling-ratio-gpios = <&gpio 18 GPIO_ACTIVE_HIGH>,
|
||
|
|
<&gpio 23 GPIO_ACTIVE_HIGH>,
|
||
|
|
<&gpio 26 GPIO_ACTIVE_HIGH>;
|
||
|
|
standby-gpios = <&gpio 24 GPIO_ACTIVE_LOW>;
|
||
|
|
};
|
||
|
|
};
|
||
|
|
- |
|
||
|
|
#include <dt-bindings/gpio/gpio.h>
|
||
|
|
#include <dt-bindings/interrupt-controller/irq.h>
|
||
|
|
spi {
|
||
|
|
#address-cells = <1>;
|
||
|
|
#size-cells = <0>;
|
||
|
|
|
||
|
|
adc@0 {
|
||
|
|
compatible = "adi,ad7606c-18";
|
||
|
|
reg = <0>;
|
||
|
|
|
||
|
|
#address-cells = <1>;
|
||
|
|
#size-cells = <0>;
|
||
|
|
|
||
|
|
spi-max-frequency = <1000000>;
|
||
|
|
spi-cpol;
|
||
|
|
|
||
|
|
avcc-supply = <&adc_vref>;
|
||
|
|
vdrive-supply = <&vdd_supply>;
|
||
|
|
|
||
|
|
interrupts = <25 IRQ_TYPE_EDGE_FALLING>;
|
||
|
|
interrupt-parent = <&gpio>;
|
||
|
|
|
||
|
|
adi,conversion-start-gpios = <&gpio 17 GPIO_ACTIVE_HIGH>;
|
||
|
|
reset-gpios = <&gpio 27 GPIO_ACTIVE_HIGH>;
|
||
|
|
adi,first-data-gpios = <&gpio 22 GPIO_ACTIVE_HIGH>;
|
||
|
|
standby-gpios = <&gpio 24 GPIO_ACTIVE_LOW>;
|
||
|
|
|
||
|
|
adi,sw-mode;
|
||
|
|
|
||
|
|
channel@1 {
|
||
|
|
reg = <1>;
|
||
|
|
diff-channels = <1 1>;
|
||
|
|
bipolar;
|
||
|
|
};
|
||
|
|
|
||
|
|
channel@3 {
|
||
|
|
reg = <3>;
|
||
|
|
bipolar;
|
||
|
|
};
|
||
|
|
|
||
|
|
channel@8 {
|
||
|
|
reg = <8>;
|
||
|
|
diff-channels = <8 8>;
|
||
|
|
bipolar;
|
||
|
|
};
|
||
|
|
|
||
|
|
};
|
||
|
|
};
|
||
|
|
...
|