[PATCH 1/2] dt-bindings: media: i2c: add Giantec GT9764 camera lens actuator

[Qianhui Xu]

Add DT binding for the Giantec GT9764 I2C lens actuator. It provides a
10-bit position DAC and module-dependent advanced actuator control (AAC)
parameters.

Signed-off-by: Qianhui Xu <xiaqinghuan@xxxxxxxxxxxxxxxx>
 MAINTAINERS                                        |    6 ++
 .../bindings/media/i2c/giantec,gt9764.yaml         |   71 ++++++++++++++++++++
 2 files changed, 77 insertions(+)
---
 .../bindings/media/i2c/giantec,gt9764.yaml    | 71 +++++++++++++++++++
 MAINTAINERS                                   |  6 ++
 2 files changed, 77 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/media/i2c/giantec,gt9764.yaml

diff --git a/Documentation/devicetree/bindings/media/i2c/giantec,gt9764.yaml b/Documentation/devicetree/bindings/media/i2c/giantec,gt9764.yaml
new file mode 100644
index 000000000..febffa359
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/i2c/giantec,gt9764.yaml
@@ -0,0 +1,71 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/media/i2c/giantec,gt9764.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Giantec GT9764 camera lens actuator
+
+maintainers:
+  - Qianhui Xu <xiaqinghuan@xxxxxxxxxxxxxxxx>
+
+description:
+  I2C-controlled lens actuator with a 10-bit position DAC and advanced actuator
+  control (AAC). AAC parameters depend on the lens module's mechanical response.
+
+properties:
+  compatible:
+    const: giantec,gt9764
+
+  reg:
+    maxItems: 1
+
+  vddio-supply:
+    description: Digital I/O supply.
+
+  vdd-supply:
+    description: Actuator supply, independently switched for the lens.
+
+  giantec,aac-mode:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    maximum: 255
+    description: Module-specified AAC mode configuration (register 0x06).
+
+  giantec,aac-timing:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    maximum: 255
+    description: Module-specified AAC timing configuration (register 0x07).
+
+  settling-time-us:
+    minimum: 1
+    description:
+      Minimum interval after programming a lens position before issuing
+      another position command, based on the lens module's damping response.
+
+required:
+  - compatible
+  - reg
+  - vddio-supply
+  - vdd-supply
+  - giantec,aac-mode
+  - giantec,aac-timing
+  - settling-time-us
+
+additionalProperties: false
+
+examples:
+  - |
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        lens@c {
+            compatible = "giantec,gt9764";
+            reg = <0x0c>;
+            vddio-supply = <&camera_io>;
+            vdd-supply = <&camera_af>;
+            giantec,aac-mode = <0x40>;
+            giantec,aac-timing = <0x7c>;
+            settling-time-us = <7000>;
+        };
+    };
diff --git a/MAINTAINERS b/MAINTAINERS
index f53047aa8..6872ad5fe 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -10866,6 +10866,12 @@ S:	Maintained
 F:	Documentation/devicetree/bindings/media/i2c/galaxycore,gc08a3.yaml
 F:	drivers/media/i2c/gc08a3.c
 
+GIANTEC GT9764 LENS VOICE COIL DRIVER
+M:	Qianhui Xu <xiaqinghuan@xxxxxxxxxxxxxxxx>
+L:	linux-media@xxxxxxxxxxxxxxx
+S:	Maintained
+F:	Documentation/devicetree/bindings/media/i2c/giantec,gt9764.yaml
+
 GALAXYCORE GC2145 SENSOR DRIVER
 M:	Alain Volmat <alain.volmat@xxxxxxxxxxx>
 L:	linux-media@xxxxxxxxxxxxxxx
-- 
2.53.0