[PATCH v1 2/8] dt-bindings: pinctrl: Add bindings for TI TAC5x1x pinctrl

[Niranjan H Y <niranjan.hy@ti.com>]

Add device tree bindings for the Texas Instruments TAC5x1x family
pin controller. These bindings define the GPIO and pin control
configuration interface for the device.

Signed-off-by: Niranjan H Y <niranjan.hy@ti.com>
---
 .../bindings/pinctrl/ti,tac5x1x-pinctrl.yaml  | 163 ++++++++++++++++++
 include/dt-bindings/pinctrl/tac5x1x.h         |  44 +++++
 2 files changed, 207 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/pinctrl/ti,tac5x1x-pinctrl.yaml
 create mode 100644 include/dt-bindings/pinctrl/tac5x1x.h

diff --git a/Documentation/devicetree/bindings/pinctrl/ti,tac5x1x-pinctrl.yaml b/Documentation/devicetree/bindings/pinctrl/ti,tac5x1x-pinctrl.yaml
new file mode 100644
index 000000000000..3ccb262d6247
--- /dev/null
+++ b/Documentation/devicetree/bindings/pinctrl/ti,tac5x1x-pinctrl.yaml
@@ -0,0 +1,163 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/pinctrl/ti,tac5x1x-pinctrl.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: TI TAC5x1x Pin Controller
+
+maintainers:
+  - Niranjan H Y <niranjan.hy@ti.com>
+
+description: |
+  The TAC5x1x devices have 5 configurable pins that can be used for GPIO
+  or alternate functions like PDM (Pulse Density Modulation) and interrupt
+  generation. A subset of pins can be present in any variant of the HW.
+
+  This binding is used as a child node of the main TAC5x1x MFD device
+  described in Documentation/devicetree/bindings/mfd/ti,tac5x1x.yaml
+
+  Pin capabilities:
+  - GPIO1, GPIO2: Bidirectional, configurable as GPIO, PDM clock, or IRQ output
+  - GPO1: Output only, configurable as GPIO, PDM clock, or IRQ output.
+          Some variants use different name GPO1A.
+  - GPI1: Input only, configurable as GPIO or PDM data input
+          Some variants use different name GPI1A.
+  - GPI2A: Input only, configurable as GPIO or PDM data input
+
+properties:
+  compatible:
+    const: ti,tac5x1x-pinctrl
+
+  gpio-controller: true
+
+  '#gpio-cells':
+    const: 2
+    description: |
+      First cell is the pin number (0-4 corresponding to GPIO1, GPIO2, GPO1, GPI1, GPI2A)
+      Second cell is flags (GPIO_ACTIVE_HIGH or GPIO_ACTIVE_LOW)
+
+  gpio-ranges:
+    maxItems: 1
+    description: GPIO range mapping to pin controller
+
+  gpio-line-names:
+    minItems: 1
+    maxItems: 5
+    description: Names for the GPIO lines
+
+patternProperties:
+  '-state$':
+    type: object
+    description: Pin configuration state
+    $ref: /schemas/pinctrl/pinmux-node.yaml#
+
+    patternProperties:
+      '^.*$':
+        type: object
+        $ref: /schemas/pinctrl/pincfg-node.yaml#
+
+        properties:
+          groups:
+            description: Pin groups to configure
+            items:
+              enum:
+                - gpio1
+                - gpio2
+                - gpo1
+                - gpi1
+                - gpi2a
+                - pdm_gpio1_gpio2
+                - pdm_gpio1_gpi1
+                - pdm_gpio1_gpi2a
+                - pdm_gpio2_gpio1
+                - pdm_gpio2_gpi1
+                - pdm_gpio2_gpi2a
+                - pdm_gpo1_gpio1
+                - pdm_gpo1_gpio2
+                - pdm_gpo1_gpi1
+                - pdm_gpo1_gpi2a
+
+          function:
+            description: Function to assign
+            enum:
+              - gpio
+              - pdm
+              - irq
+
+          drive-push-pull:
+            type: boolean
+            description: Enable push-pull drive mode
+
+          drive-open-drain:
+            type: boolean
+            description: Enable open-drain drive mode
+
+          drive-open-source:
+            type: boolean
+            description: Enable open-source drive mode
+
+          bias-pull-up:
+            type: boolean
+            description: Enable pull-up bias
+
+          bias-pull-down:
+            type: boolean
+            description: Enable pull-down bias
+
+          bias-high-impedance:
+            type: boolean
+            description: Set pin to high impedance
+
+          input-enable:
+            type: boolean
+            description: Enable input buffer
+
+          output-enable:
+            type: boolean
+            description: Enable output buffer
+
+        required:
+          - groups
+          - function
+
+        additionalProperties: false
+
+    additionalProperties: false
+
+required:
+  - compatible
+  - gpio-controller
+  - '#gpio-cells'
+
+additionalProperties: false
+
+examples:
+  - |
+    pinctrl {
+        compatible = "ti,tac5x1x-pinctrl";
+        gpio-controller;
+        #gpio-cells = <2>;
+        gpio-ranges = <&pinctrl 0 0 5>;
+        gpio-line-names = "GPIO1", "GPIO2", "GPO1", "GPI1", "GPI2A";
+
+        default_state: default-state {
+            pdm_config {
+                groups = "pdm_gpo1_gpi1";
+                function = "pdm";
+                drive-push-pull;
+            };
+
+            gpio_config {
+                groups = "gpio1", "gpio2";
+                function = "gpio";
+                bias-pull-up;
+            };
+
+            irq_config {
+                groups = "gpo1";
+                function = "irq";
+                drive-open-drain;
+            };
+        };
+    };
diff --git a/include/dt-bindings/pinctrl/tac5x1x.h b/include/dt-bindings/pinctrl/tac5x1x.h
new file mode 100644
index 000000000000..8cc3fa0b7946
--- /dev/null
+++ b/include/dt-bindings/pinctrl/tac5x1x.h
@@ -0,0 +1,44 @@
+/* SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause */
+/*
+ * Device Tree binding constants for TAC5x1x pinctrl
+ *
+ * Copyright (C) 2025 Texas Instruments Incorporated
+ * Author: Niranjan H Y <niranjan.hy@ti.com>
+ */
+
+#ifndef _DT_BINDINGS_PINCTRL_TAC5X1X_H
+#define _DT_BINDINGS_PINCTRL_TAC5X1X_H
+
+/* Pin IDs */
+#define TAC5X1X_PIN_GPIO1 0
+#define TAC5X1X_PIN_GPIO2 1
+#define TAC5X1X_PIN_GPO1 2
+#define TAC5X1X_PIN_GPI1 3
+#define TAC5X1X_PIN_GPI2A 4
+
+/* Pin functions */
+#define TAC5X1X_FUNC_GPIO 0
+#define TAC5X1X_FUNC_PDM 1
+#define TAC5X1X_FUNC_IRQ 2
+
+/* Pin drive modes */
+#define TAC5X1X_DRIVE_HIZ 0
+#define TAC5X1X_DRIVE_PUSH_PULL 1
+#define TAC5X1X_DRIVE_PULL_DOWN 2
+#define TAC5X1X_DRIVE_OPEN_DRAIN 3
+#define TAC5X1X_DRIVE_PULL_UP 4
+#define TAC5X1X_DRIVE_OPEN_SOURCE 5
+
+/* PDM configurations */
+#define TAC5X1X_PDM_GPIO1_GPIO2 0
+#define TAC5X1X_PDM_GPIO1_GPI1 1
+#define TAC5X1X_PDM_GPIO1_GPI2A 2
+#define TAC5X1X_PDM_GPIO2_GPIO1 3
+#define TAC5X1X_PDM_GPIO2_GPI1 4
+#define TAC5X1X_PDM_GPIO2_GPI2A 5
+#define TAC5X1X_PDM_GPO1_GPIO1 6
+#define TAC5X1X_PDM_GPO1_GPIO2 7
+#define TAC5X1X_PDM_GPO1_GPI1 8
+#define TAC5X1X_PDM_GPO1_GPI2A 9
+
+#endif /* _DT_BINDINGS_PINCTRL_TAC5X1X_H */
-- 
2.34.1