[PATCH v2 1/2] ASoC: dt-bindings: Add Iron Device MA5311

[Hyunuk Son]

The Iron Device MA5311 is an audio codec integrating digital speaker
amplification, analog-to-digital conversion, and audio DSP functionality.

The device uses two I2C slave addresses for separate control and ADC
register banks. It also provides an active-low reset input and an
interrupt output for fault and thermal warning notification.

Add the Device Tree binding to describe these hardware interfaces.

Signed-off-by: Hyunuk Son <hyunuk.son@xxxxxxxxxxxxxx>
---
 .../bindings/sound/irondevice,ma5311.yaml     | 83 +++++++++++++++++++
 1 file changed, 83 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/sound/irondevice,ma5311.yaml

diff --git a/Documentation/devicetree/bindings/sound/irondevice,ma5311.yaml b/Documentation/devicetree/bindings/sound/irondevice,ma5311.yaml
new file mode 100644
index 000000000000..db5f800ebbc3
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/irondevice,ma5311.yaml
@@ -0,0 +1,83 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/sound/irondevice,ma5311.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Iron Device MA5311 Audio Codec
+
+maintainers:
+  - Hyunuk Son <hyunuk.son@xxxxxxxxxxxxxx>
+
+description:
+  The Iron Device MA5311 integrates digital speaker amplification,
+  analog-to-digital conversion, and audio DSP functionality.
+
+  The device uses two I2C slave addresses. The first address
+  provides access to the control register bank, while the second
+  provides access to the ADC register bank.
+
+  The device provides an active-low reset input and an active-low
+  interrupt output for fault and thermal warning notification.
+
+allOf:
+  - $ref: dai-common.yaml#
+
+properties:
+  compatible:
+    enum:
+      - irondevice,ma5311
+
+  reg:
+    items:
+      - description: I2C address for control registers
+      - description: I2C address for ADC registers
+
+  reg-names:
+    items:
+      - const: control
+      - const: adc
+
+  reset-gpios:
+    maxItems: 1
+    description:
+      GPIO connected to the active-low RSTN pin.
+
+  interrupts:
+    maxItems: 1
+    description:
+      Interrupt from the active-low INTN fault and thermal warning output.
+
+  '#sound-dai-cells':
+    const: 1
+
+required:
+  - compatible
+  - reg
+  - reg-names
+  - '#sound-dai-cells'
+
+unevaluatedProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/gpio/gpio.h>
+    #include <dt-bindings/interrupt-controller/irq.h>
+
+    i2c {
+        #address-cells = <1>;
+        #size-cells = <0>;
+
+        audio-codec@3e {
+            compatible = "irondevice,ma5311";
+
+            reg = <0x3e>, <0x3f>;
+            reg-names = "control", "adc";
+
+            reset-gpios = <&gpio 2 GPIO_ACTIVE_LOW>;
+            interrupt-parent = <&gpio>;
+            interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
+
+            #sound-dai-cells = <1>;
+        };
+    };
-- 
2.43.0