Subject: [PATCH v5 1/9] dt-bindings: iio: adc: Add common-mode-channel property

From: Dumitru Ceclan <[email protected]>

There are ADCs that are differential but support to measure single-ended
signals on the same channels by connecting a constant voltage to the
negative input pin.

This property allows to properly define a single-ended channel that
requires two inputs to be specified. Software can use the presence of
this property to mark the channel as not differential.

Signed-off-by: Dumitru Ceclan <[email protected]>
---
Documentation/devicetree/bindings/iio/adc/adc.yaml | 11 +++++++++++
1 file changed, 11 insertions(+)

diff --git a/Documentation/devicetree/bindings/iio/adc/adc.yaml b/Documentation/devicetree/bindings/iio/adc/adc.yaml
index 0a77592f7388..8e7835cf36fd 100644
--- a/Documentation/devicetree/bindings/iio/adc/adc.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/adc.yaml
@@ -46,6 +46,17 @@ properties:
differential channels). If this and diff-channels are not present reg
shall be used instead.

+ common-mode-channel:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description:
+ Some ADCs have differential input pins that can be used to measure
+ single-ended or pseudo-differential inputs. This property can be used
+ in addition to single-channel to signal software that this channel is
+ not differential but still specify two inputs.
+
+ The input pair is specified by setting single-channel to the positive
+ input pin and common-mode-channel to the negative pin.
+
settling-time-us:
description:
Time between enabling the channel and first stable readings.

--
2.43.0




2024-06-04 18:09:21

by Conor Dooley

[permalink] [raw]
Subject: Re: [PATCH v5 1/9] dt-bindings: iio: adc: Add common-mode-channel property

On Mon, Jun 03, 2024 at 07:22:59PM +0300, Dumitru Ceclan via B4 Relay wrote:
> From: Dumitru Ceclan <[email protected]>
>
> There are ADCs that are differential but support to measure single-ended
> signals on the same channels by connecting a constant voltage to the
> negative input pin.
>
> This property allows to properly define a single-ended channel that
> requires two inputs to be specified. Software can use the presence of
> this property to mark the channel as not differential.
>
> Signed-off-by: Dumitru Ceclan <[email protected]>

Reviewed-by: Conor Dooley <[email protected]>

Thanks,
Conor.

Attachments:
(No filename) (653.00 B)
 signature.asc (235.00 B)
 Download all attachments