2021-03-22 15:08:18

by Oleksij Rempel

Subject: [PATCH v4 1/3] dt-bindings:iio:adc: add generic settling-time-us and oversampling-ratio channel properties

Settling time and over sampling is a typical challenge for different IIO ADC
devices. So, introduce channel specific settling-time-us and oversampling-ratio
properties to cover this use case.

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

diff --git a/Documentation/devicetree/bindings/iio/adc/adc.yaml b/Documentation/devicetree/bindings/iio/adc/adc.yaml
index 912a7635edc4..66fd4b45f097 100644
--- a/Documentation/devicetree/bindings/iio/adc/adc.yaml
+++ b/Documentation/devicetree/bindings/iio/adc/adc.yaml
@@ -39,4 +39,13 @@ properties:
The first value specifies the positive input pin, the second
specifies the negative input pin.

+ settling-time-us:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description:
+ Time between enabling the channel and firs stable readings.
+
+ oversampling-ratio:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description: Number of data samples which are averaged for each read.
+
additionalProperties: true
--
2.29.2

2021-03-26 21:21:08

by Rob Herring (Arm)

Subject: Re: [PATCH v4 1/3] dt-bindings:iio:adc: add generic settling-time-us and oversampling-ratio channel properties

On Mon, Mar 22, 2021 at 04:06:06PM +0100, Oleksij Rempel wrote:
> Settling time and over sampling is a typical challenge for different IIO ADC
> devices. So, introduce channel specific settling-time-us and oversampling-ratio
> properties to cover this use case.
>
> Signed-off-by: Oleksij Rempel <[email protected]>
> ---
> Documentation/devicetree/bindings/iio/adc/adc.yaml | 9 +++++++++
> 1 file changed, 9 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/iio/adc/adc.yaml b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> index 912a7635edc4..66fd4b45f097 100644
> --- a/Documentation/devicetree/bindings/iio/adc/adc.yaml
> +++ b/Documentation/devicetree/bindings/iio/adc/adc.yaml
> @@ -39,4 +39,13 @@ properties:
> The first value specifies the positive input pin, the second
> specifies the negative input pin.
>
> + settling-time-us:
> + $ref: /schemas/types.yaml#/definitions/uint32

Don't need a type for properties with a standard unit suffix.

> + description:
> + Time between enabling the channel and firs stable readings.
> +
> + oversampling-ratio:
> + $ref: /schemas/types.yaml#/definitions/uint32
> + description: Number of data samples which are averaged for each read.
> +
> additionalProperties: true
> --
> 2.29.2
>