ADAQ4216 and ADAQ4224 are similar to AD4030 except ADAQ devices have a PGA (programmable gain amplifier) that scales the input signal prior to it reaching the ADC inputs. The PGA is controlled through a couple of pins (A0 and A1) that set one of four possible signal gain. Signed-off-by: Marcelo Schmitt <marcelo.schmitt@xxxxxxxxxx> --- The PGA doc was inspired on ad7191 dt-binding and uses the same properies (but with different values) to describe the hardware. .../bindings/iio/adc/adi,ad4030.yaml | 39 +++++++++++++++++++ 1 file changed, 39 insertions(+) diff --git a/Documentation/devicetree/bindings/iio/adc/adi,ad4030.yaml b/Documentation/devicetree/bindings/iio/adc/adi,ad4030.yaml index 9adb60629631..36fd2aa51922 100644 --- a/Documentation/devicetree/bindings/iio/adc/adi,ad4030.yaml +++ b/Documentation/devicetree/bindings/iio/adc/adi,ad4030.yaml @@ -19,6 +19,8 @@ description: | * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4030-24-4032-24.pdf * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4630-24_ad4632-24.pdf * https://www.analog.com/media/en/technical-documentation/data-sheets/ad4630-16-4632-16.pdf + * https://www.analog.com/media/en/technical-documentation/data-sheets/adaq4216.pdf + * https://www.analog.com/media/en/technical-documentation/data-sheets/adaq4224.pdf $ref: /schemas/spi/spi-peripheral-props.yaml# @@ -31,6 +33,8 @@ properties: - adi,ad4630-24 - adi,ad4632-16 - adi,ad4632-24 + - adi,adaq4216 + - adi,adaq4224 reg: maxItems: 1 @@ -64,6 +68,27 @@ properties: The Reset Input (/RST). Used for asynchronous device reset. maxItems: 1 + pga-gpios: + description: + A0 and A1 pins for gain selection. For devices that have PGA configuration + input pins, pga-gpios should be defined if adi,gain-milli is absent. + minItems: 2 + maxItems: 2 + + adi,pga-value: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + Should be present if PGA control inputs are pin-strapped. The values + specify the gain per mille. For example, 333 means the input signal is + scaled by a 0.333 factor (i.e. attenuated to one third of it's original + magnitude). Possible values: + Gain 333 (A1=0, A0=0) + Gain 556 (A1=0, A0=1) + Gain 2222 (A1=1, A0=0) + Gain 6667 (A1=1, A0=1) + If defined, pga-gpios must be absent. + enum: [333, 556, 2222, 6667] + pwms: description: PWM signal connected to the CNV pin. maxItems: 1 @@ -120,6 +145,20 @@ allOf: then: properties: adi,dual-data-rate: false + # ADAQ devices require a gain property to indicate how hardware PGA is set + - if: + properties: + compatible: + contains: + enum: + - adi,adaq4216 + - adi,adaq4224 + then: + oneOf: + - required: + - adi,pga-value + - required: + - pga-gpios unevaluatedProperties: false -- 2.39.2
