diff mbox series

[v8,2/2] Added AMS tsl2591 device tree binding

Message ID 20210416174902.9036-2-joe.g.sandom@gmail.com
State Accepted
Commit afa2b78f1e58eaca820f32c124e5655f43583eb1
Headers show
Series [v8,1/2] Added AMS tsl2591 driver implementation | expand

Commit Message

Joe Sandom April 16, 2021, 5:49 p.m. UTC
Device tree binding for AMS/TAOS tsl2591 ambient light sensor.

This driver supports configuration via device tree and sysfs.
Supported channels for raw infrared light intensity,
raw combined light intensity and illuminance in lux.
The driver additionally supports iio events on lower and
upper thresholds.

This is a very-high sensitivity light-to-digital converter that
transforms light intensity into a digital signal.

Signed-off-by: Joe Sandom <joe.g.sandom@gmail.com>
Reviewed-by: Rob Herring <robh@kernel.org>
---
Changes in v8:
- No changes

Notes:
- Re-submitted to align the version with part 1 of the patch series

 .../bindings/iio/light/amstaos,tsl2591.yaml   | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml

Comments

Andy Shevchenko April 17, 2021, 12:40 p.m. UTC | #1
On Fri, Apr 16, 2021 at 8:49 PM Joe Sandom <joe.g.sandom@gmail.com> wrote:
>

> Device tree binding for AMS/TAOS tsl2591 ambient light sensor.

>

> This driver supports configuration via device tree and sysfs.

> Supported channels for raw infrared light intensity,

> raw combined light intensity and illuminance in lux.

> The driver additionally supports iio events on lower and

> upper thresholds.

>

> This is a very-high sensitivity light-to-digital converter that

> transforms light intensity into a digital signal.


Subject should be something like dt-bindings: iio: ...


-- 
With Best Regards,
Andy Shevchenko
Andy Shevchenko April 17, 2021, 12:51 p.m. UTC | #2
On Fri, Apr 16, 2021 at 8:49 PM Joe Sandom <joe.g.sandom@gmail.com> wrote:
>

> Device tree binding for AMS/TAOS tsl2591 ambient light sensor.

>

> This driver supports configuration via device tree and sysfs.

> Supported channels for raw infrared light intensity,

> raw combined light intensity and illuminance in lux.

> The driver additionally supports iio events on lower and

> upper thresholds.

>

> This is a very-high sensitivity light-to-digital converter that

> transforms light intensity into a digital signal.


With subject line fixed (other comments up to you)
Reviewed-by: Andy Shevchenko <andy.shevchenko@gmail.com>


> Signed-off-by: Joe Sandom <joe.g.sandom@gmail.com>

> Reviewed-by: Rob Herring <robh@kernel.org>

> ---

> Changes in v8:

> - No changes

>

> Notes:

> - Re-submitted to align the version with part 1 of the patch series

>

>  .../bindings/iio/light/amstaos,tsl2591.yaml   | 50 +++++++++++++++++++

>  1 file changed, 50 insertions(+)

>  create mode 100644 Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml

>

> diff --git a/Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml b/Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml

> new file mode 100644

> index 000000000000..596a3bc770f4

> --- /dev/null

> +++ b/Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml

> @@ -0,0 +1,50 @@

> +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

> +%YAML 1.2

> +---

> +$id: http://devicetree.org/schemas/iio/light/amstaos,tsl2591.yaml#

> +$schema: http://devicetree.org/meta-schemas/core.yaml#

> +

> +title: AMS/TAOS TSL2591 Ambient Light Sensor (ALS)

> +

> +maintainers:

> +  - Joe Sandom <joe.g.sandom@gmail.com>

> +

> +description: |

> +  AMS/TAOS TSL2591 is a very-high sensitivity

> +  light-to-digital converter that transforms light intensity into a digital

> +  signal.

> +

> +properties:

> +  compatible:

> +    const: amstaos,tsl2591

> +

> +  reg:

> +    maxItems: 1

> +

> +  interrupts:

> +    maxItems: 1

> +    description:

> +      Interrupt (INT:Pin 2) Active low. Should be set to IRQ_TYPE_EDGE_FALLING.

> +      interrupt is used to detect if the light intensity has fallen below

> +      or reached above the configured threshold values.

> +

> +required:

> +  - compatible

> +  - reg

> +

> +additionalProperties: false

> +

> +examples:

> +  - |

> +    #include <dt-bindings/interrupt-controller/irq.h>

> +    i2c {

> +        #address-cells = <1>;

> +        #size-cells = <0>;

> +

> +        tsl2591@29 {

> +            compatible = "amstaos,tsl2591";

> +            reg = <0x29>;

> +            interrupts = <20 IRQ_TYPE_EDGE_FALLING>;

> +       };

> +    };

> +...

> --

> 2.17.1

>



-- 
With Best Regards,
Andy Shevchenko
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml b/Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml
new file mode 100644
index 000000000000..596a3bc770f4
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/light/amstaos,tsl2591.yaml
@@ -0,0 +1,50 @@ 
+# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/light/amstaos,tsl2591.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: AMS/TAOS TSL2591 Ambient Light Sensor (ALS)
+
+maintainers:
+  - Joe Sandom <joe.g.sandom@gmail.com>
+
+description: |
+  AMS/TAOS TSL2591 is a very-high sensitivity
+  light-to-digital converter that transforms light intensity into a digital
+  signal.
+
+properties:
+  compatible:
+    const: amstaos,tsl2591
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    maxItems: 1
+    description:
+      Interrupt (INT:Pin 2) Active low. Should be set to IRQ_TYPE_EDGE_FALLING.
+      interrupt is used to detect if the light intensity has fallen below
+      or reached above the configured threshold values.
+
+required:
+  - compatible
+  - reg
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        tsl2591@29 {
+            compatible = "amstaos,tsl2591";
+            reg = <0x29>;
+            interrupts = <20 IRQ_TYPE_EDGE_FALLING>;
+       };
+    };
+...