[PATCH 1/2] dt-bindings: iio: light: Add AMS TCS3472 and TCS3400

[HuskerMinion via B4 Relay <devnull+mocker-mug-unwoven.duck.com@kernel.org>]

From: HuskerMinion <mocker-mug-unwoven@duck.com>

The tcs3472 driver has no binding yet. It matches DT nodes only through
its I2C device ID.

Document the TCS3472 family and the AMS TCS3400 family, which the next
patch adds to the driver. Both are I2C color sensors with one threshold
interrupt and a VDD supply.

Signed-off-by: HuskerMinion <mocker-mug-unwoven@duck.com>
---
 .../devicetree/bindings/iio/light/ams,tcs3472.yaml | 57 ++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/Documentation/devicetree/bindings/iio/light/ams,tcs3472.yaml b/Documentation/devicetree/bindings/iio/light/ams,tcs3472.yaml
new file mode 100644
index 000000000..cd4a0516e
--- /dev/null
+++ b/Documentation/devicetree/bindings/iio/light/ams,tcs3472.yaml
@@ -0,0 +1,57 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/iio/light/ams,tcs3472.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: AMS TCS3472 and TCS3400 color light-to-digital converters
+
+maintainers:
+  - HuskerMinion <mocker-mug-unwoven@duck.com>
+
+description: |
+  Color light sensors with 16-bit clear, red, green and blue channels, an
+  I2C interface and a threshold interrupt.
+
+  The TCS3472 family covers the TCS34721, TCS34723, TCS34725 and TCS34727.
+  The TCS3400 family covers the TCS34001, TCS34003, TCS34005 and TCS34007.
+  The variants differ in I2C address and interface voltage.
+
+properties:
+  compatible:
+    enum:
+      - ams,tcs3400
+      - ams,tcs3472
+
+  reg:
+    maxItems: 1
+
+  interrupts:
+    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-sensor@29 {
+            compatible = "ams,tcs3400";
+            reg = <0x29>;
+            interrupt-parent = <&pio>;
+            interrupts = <6 IRQ_TYPE_EDGE_FALLING>;
+            vdd-supply = <&reg_3v3>;
+        };
+    };
+...

-- 
2.43.0