2020-01-02 17:29:11

by Andreas Klinger

[permalink] [raw]
Subject: [PATCH 1/2] dt-bindings: devantech-srf04.yaml: add pm feature

Add GPIO line and startup time for usage of power management

Signed-off-by: Andreas Klinger <[email protected]>
---
.../bindings/iio/proximity/devantech-srf04.yaml | 16 ++++++++++++++++
1 file changed, 16 insertions(+)

diff --git a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
index 4e80ea7c1475..b3fcb3b79485 100644
--- a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
+++ b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
@@ -51,6 +51,22 @@ properties:
the time between two interrupts is measured in the driver.
maxItems: 1

+ power-gpios:
+ description:
+ Definition of the GPIO for power management of connected peripheral
+ (output).
+ This GPIO can be used by the external hardware for power management.
+ When the device gets suspended it's switched off and when it resumes
+ it's switched on again. After some period of inactivity the driver
+ get suspended automatically (autosuspend feature).
+ maxItems: 1
+
+ startup-time-ms:
+ $ref: /schemas/types.yaml#/definitions/uint32
+ description:
+ This is the startup time the device needs after a resume to be up and
+ running.
+
required:
- compatible
- trig-gpios
--
2.11.0


2020-01-08 16:59:40

by Rob Herring

[permalink] [raw]
Subject: Re: [PATCH 1/2] dt-bindings: devantech-srf04.yaml: add pm feature

On Thu, Jan 02, 2020 at 06:27:51PM +0100, Andreas Klinger wrote:
> Add GPIO line and startup time for usage of power management
>
> Signed-off-by: Andreas Klinger <[email protected]>
> ---
> .../bindings/iio/proximity/devantech-srf04.yaml | 16 ++++++++++++++++
> 1 file changed, 16 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
> index 4e80ea7c1475..b3fcb3b79485 100644
> --- a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
> +++ b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
> @@ -51,6 +51,22 @@ properties:
> the time between two interrupts is measured in the driver.
> maxItems: 1
>
> + power-gpios:
> + description:
> + Definition of the GPIO for power management of connected peripheral
> + (output).
> + This GPIO can be used by the external hardware for power management.
> + When the device gets suspended it's switched off and when it resumes
> + it's switched on again. After some period of inactivity the driver
> + get suspended automatically (autosuspend feature).
> + maxItems: 1
> +
> + startup-time-ms:

Why isn't this implied by the compatible string?

> + $ref: /schemas/types.yaml#/definitions/uint32

You can drop this for standard units.

0-2^32 is valid?

> + description:
> + This is the startup time the device needs after a resume to be up and
> + running.
> +
> required:
> - compatible
> - trig-gpios
> --
> 2.11.0

2020-01-09 07:12:00

by Andreas Klinger

[permalink] [raw]
Subject: Re: [PATCH 1/2] dt-bindings: devantech-srf04.yaml: add pm feature

Hi Rob,

see below.

Rob Herring <[email protected]> schrieb am Mi, 08. Jan 10:58:
> On Thu, Jan 02, 2020 at 06:27:51PM +0100, Andreas Klinger wrote:
> > Add GPIO line and startup time for usage of power management
> >
> > Signed-off-by: Andreas Klinger <[email protected]>
> > ---
> > .../bindings/iio/proximity/devantech-srf04.yaml | 16 ++++++++++++++++
> > 1 file changed, 16 insertions(+)
> >
> > diff --git a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
> > index 4e80ea7c1475..b3fcb3b79485 100644
> > --- a/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
> > +++ b/Documentation/devicetree/bindings/iio/proximity/devantech-srf04.yaml
> > @@ -51,6 +51,22 @@ properties:
> > the time between two interrupts is measured in the driver.
> > maxItems: 1
> >
> > + power-gpios:
> > + description:
> > + Definition of the GPIO for power management of connected peripheral
> > + (output).
> > + This GPIO can be used by the external hardware for power management.
> > + When the device gets suspended it's switched off and when it resumes
> > + it's switched on again. After some period of inactivity the driver
> > + get suspended automatically (autosuspend feature).
> > + maxItems: 1
> > +
> > + startup-time-ms:
>
> Why isn't this implied by the compatible string?

Under the same trade name "SRF-04" there are many different sensors on the
market which are clones of the original one from Devantech. They are equipped
with different hardware components and they have a slightly different behavior,
such as the startup time.

>
> > + $ref: /schemas/types.yaml#/definitions/uint32
>
> You can drop this for standard units.
>
> 0-2^32 is valid?

I can add boundaries here.

>
> > + description:
> > + This is the startup time the device needs after a resume to be up and
> > + running.
> > +
> > required:
> > - compatible
> > - trig-gpios
> > --
> > 2.11.0

Andreas