[1/2] dt-bindings: iio: tcs3490: Add bindings for AMS TCS3490 light sensor

Commit Message

Markuss Broks Jan. 23, 2023, 11:10 p.m. UTC

Add device-tree bindings for the AMS TCS3490 Color ALS.

Signed-off-by: Markuss Broks <[e-mail]>
---
 .../bindings/iio/light/ams,tcs3490.yaml       | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/iio/light/ams,tcs3490.yaml

Comments

Krzysztof Kozlowski Jan. 24, 2023, 10:32 a.m. UTC | #1

On 24/01/2023 00:10, Markuss Broks wrote:
> Add device-tree bindings for the AMS TCS3490 Color ALS.

If there is going to be new version:

Subject: drop second/last, redundant "bindings for". The "dt-bindings"
prefix is already stating that these are bindings.


Reviewed-by: Krzysztof Kozlowski <[e-mail]>

> 
> Signed-off-by: Markuss Broks <[e-mail]>
> ---

Best regards,
Krzysztof

Patch

diff --git a/Documentation/devicetree/bindings/iio/light/ams,tcs3490.yaml b/Documentation/devicetree/bindings/iio/light/ams,tcs3490.yaml
new file mode 100644
index 000000000000..0938d5edd791
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/light/ams,tcs3490.yaml
@@ -0,0 +1,52 @@ 
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/light/ams,tcs3490.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: AMS TCS3490 Color Light-to-Digital Converter
+
+maintainers:
+  - Markuss Broks <[e-mail]>
+
+description: |
+  This color and IR light sensor is typically used to adjust the backlight
+  intensity and correct the display color gamut. Additionally can be used
+  for light source type detection as it reports the IR content of the light.
+  It can sense four channels of visible light (red, green, blue, clear) and
+  IR light.
+
+properties:
+  compatible:
+    enum:
+      - ams,tcs3490
+
+  reg:
+    description:
+      I2C address of the device (typically 0x39).
+    maxItems: 1
+
+  vdd-supply: true
+
+required:
+  - compatible
+  - reg
+  - vdd-supply
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        light@39 {
+            compatible = "ams,tcs3490";
+            reg = <0x39>;
+            vdd-supply = <&cam_vio_vreg>;
+        };
+    };
+...