mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/chenhuacai/linux-loongson
synced 2025-09-05 20:30:41 +00:00
c54b909481
Extend the AD4000 series device tree documentation to also describe PulSAR devices. The single-channel series of PulSAR devices is similar to the AD4000 series except PulSAR devices sample at slower rates and don't have a configuration register. Because PulSAR devices don't have a configuration register, they don't support all features of AD4000 devices and thus fewer interfaces are provided to user space. Also, while AD4000 may have their SDI pin connected to SPI host MOSI line, PulSAR SDI pin is never connected to MOSI. Some devices within the PulSAR series are just faster versions of others. >From fastest to slowest, AD7980, AD7988-5, AD7686, AD7685, and AD7988-1 are all 16-bit pseudo-differential pin-for-pin compatible ADCs. Devices that only vary on the sample rate are documented with a common fallback compatible. Signed-off-by: Marcelo Schmitt <marcelo.schmitt@analog.com> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Link: https://patch.msgid.link/cc05f1471c409ab38722cd0e80fd5857ff9ce5db.1733147444.git.marcelo.schmitt@analog.com Signed-off-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
247 lines
7.7 KiB
YAML
247 lines
7.7 KiB
YAML
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/iio/adc/adi,ad4000.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: Analog Devices AD4000 and similar Analog to Digital Converters
|
|
|
|
maintainers:
|
|
- Marcelo Schmitt <marcelo.schmitt@analog.com>
|
|
|
|
description: |
|
|
Analog Devices AD4000 family of Analog to Digital Converters with SPI support.
|
|
Specifications can be found at:
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad4000-4004-4008.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad4001-4005.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad4002-4006-4010.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad4003-4007-4011.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad4020-4021-4022.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/adaq4001.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/adaq4003.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7685.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7686.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7687.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7688.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7690.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7691.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7693.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7942.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7946.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7980.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7982.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7983.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7984.pdf
|
|
https://www.analog.com/media/en/technical-documentation/data-sheets/ad7988-1_7988-5.pdf
|
|
|
|
$ref: /schemas/spi/spi-peripheral-props.yaml#
|
|
|
|
properties:
|
|
compatible:
|
|
oneOf:
|
|
- enum:
|
|
- adi,ad4000
|
|
- adi,ad4001
|
|
- adi,ad4002
|
|
- adi,ad4003
|
|
- adi,ad4020
|
|
- adi,adaq4001
|
|
- adi,adaq4003
|
|
- adi,ad7687
|
|
- adi,ad7691
|
|
- adi,ad7942
|
|
- adi,ad7946
|
|
- adi,ad7983
|
|
- items:
|
|
- enum:
|
|
- adi,ad4004
|
|
- adi,ad4008
|
|
- const: adi,ad4000
|
|
- items:
|
|
- enum:
|
|
- adi,ad4005
|
|
- const: adi,ad4001
|
|
- items:
|
|
- enum:
|
|
- adi,ad4006
|
|
- adi,ad4010
|
|
- const: adi,ad4002
|
|
- items:
|
|
- enum:
|
|
- adi,ad4007
|
|
- adi,ad4011
|
|
- const: adi,ad4003
|
|
- items:
|
|
- enum:
|
|
- adi,ad4021
|
|
- adi,ad4022
|
|
- const: adi,ad4020
|
|
- items:
|
|
- enum:
|
|
- adi,ad7685
|
|
- adi,ad7686
|
|
- adi,ad7980
|
|
- adi,ad7988-1
|
|
- adi,ad7988-5
|
|
- const: adi,ad7983
|
|
- items:
|
|
- enum:
|
|
- adi,ad7688
|
|
- adi,ad7693
|
|
- const: adi,ad7687
|
|
- items:
|
|
- enum:
|
|
- adi,ad7690
|
|
- adi,ad7982
|
|
- adi,ad7984
|
|
- const: adi,ad7691
|
|
|
|
reg:
|
|
maxItems: 1
|
|
|
|
spi-max-frequency:
|
|
maximum: 102040816 # for VIO > 2.7 V, 81300813 for VIO > 1.7 V
|
|
|
|
adi,sdi-pin:
|
|
$ref: /schemas/types.yaml#/definitions/string
|
|
enum: [ high, low, cs, sdi ]
|
|
default: sdi
|
|
description:
|
|
Describes how the ADC SDI pin is wired. A value of "sdi" indicates that
|
|
the ADC SDI is connected to host SDO. "high" indicates that the ADC SDI
|
|
pin is hard-wired to logic high (VIO). "low" indicates that it is
|
|
hard-wired low (GND). "cs" indicates that the ADC SDI pin is connected to
|
|
the host CS line.
|
|
|
|
'#daisy-chained-devices': true
|
|
|
|
vdd-supply:
|
|
description: A 1.8V supply that powers the chip (VDD).
|
|
|
|
vio-supply:
|
|
description:
|
|
A 1.8V to 5.5V supply for the digital inputs and outputs (VIO).
|
|
|
|
ref-supply:
|
|
description:
|
|
A 2.5 to 5V supply for the external reference voltage (REF).
|
|
|
|
cnv-gpios:
|
|
description:
|
|
When provided, this property indicates the GPIO that is connected to the
|
|
CNV pin.
|
|
maxItems: 1
|
|
|
|
adi,high-z-input:
|
|
type: boolean
|
|
description:
|
|
High-Z mode allows the amplifier and RC filter in front of the ADC to be
|
|
chosen based on the signal bandwidth of interest, rather than the settling
|
|
requirements of the switched capacitor SAR ADC inputs.
|
|
|
|
adi,gain-milli:
|
|
description: |
|
|
The hardware gain applied to the ADC input (in milli units).
|
|
The gain provided by the ADC input scaler is defined by the hardware
|
|
connections between chip pins OUT+, R1K-, R1K1-, R1K+, R1K1+, and OUT-.
|
|
If not present, default to 1000 (no actual gain applied).
|
|
$ref: /schemas/types.yaml#/definitions/uint16
|
|
enum: [454, 909, 1000, 1900]
|
|
default: 1000
|
|
|
|
interrupts:
|
|
description:
|
|
The SDO pin can also function as a busy indicator. This node should be
|
|
connected to an interrupt that is triggered when the SDO line goes low
|
|
while the SDI line is high and the CNV line is low ("3-wire" mode) or the
|
|
SDI line is low and the CNV line is high ("4-wire" mode); or when the SDO
|
|
line goes high while the SDI and CNV lines are high (chain mode),
|
|
maxItems: 1
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
- vdd-supply
|
|
- vio-supply
|
|
- ref-supply
|
|
|
|
allOf:
|
|
# Single-channel PulSAR devices have SDI either tied to VIO, GND, or host CS.
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
contains:
|
|
enum:
|
|
- adi,ad7687
|
|
- adi,ad7691
|
|
- adi,ad7942
|
|
- adi,ad7946
|
|
- adi,ad7983
|
|
then:
|
|
properties:
|
|
adi,sdi-pin:
|
|
enum: [ high, low, cs ]
|
|
default: cs
|
|
# The configuration register can only be accessed if SDI is connected to MOSI
|
|
- if:
|
|
required:
|
|
- adi,sdi-pin
|
|
then:
|
|
properties:
|
|
adi,high-z-input: false
|
|
# chain mode has lower SCLK max rate
|
|
- if:
|
|
required:
|
|
- '#daisy-chained-devices'
|
|
then:
|
|
properties:
|
|
spi-max-frequency:
|
|
maximum: 50000000 # for VIO > 2.7 V, 40000000 for VIO > 1.7 V
|
|
# Gain property only applies to ADAQ devices
|
|
- if:
|
|
properties:
|
|
compatible:
|
|
not:
|
|
contains:
|
|
enum:
|
|
- adi,adaq4001
|
|
- adi,adaq4003
|
|
then:
|
|
properties:
|
|
adi,gain-milli: false
|
|
|
|
unevaluatedProperties: false
|
|
|
|
examples:
|
|
- |
|
|
#include <dt-bindings/gpio/gpio.h>
|
|
spi {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
adc@0 {
|
|
compatible = "adi,ad4020";
|
|
reg = <0>;
|
|
spi-max-frequency = <71000000>;
|
|
vdd-supply = <&supply_1_8V>;
|
|
vio-supply = <&supply_1_8V>;
|
|
ref-supply = <&supply_5V>;
|
|
adi,sdi-pin = "cs";
|
|
cnv-gpios = <&gpio0 88 GPIO_ACTIVE_HIGH>;
|
|
};
|
|
};
|
|
- |
|
|
spi {
|
|
#address-cells = <1>;
|
|
#size-cells = <0>;
|
|
adc@0 {
|
|
compatible = "adi,adaq4003";
|
|
reg = <0>;
|
|
spi-max-frequency = <80000000>;
|
|
vdd-supply = <&supply_1_8V>;
|
|
vio-supply = <&supply_1_8V>;
|
|
ref-supply = <&supply_5V>;
|
|
adi,high-z-input;
|
|
adi,gain-milli = /bits/ 16 <454>;
|
|
};
|
|
};
|