[PATCH] ASoC: dt-bindings: ti,omap4-dmic: Convert TI OMAP4+ DMIC binding to YAML

[PATCH] ASoC: dt-bindings: ti,omap4-dmic: Convert TI OMAP4+ DMIC binding to YAML

[Charan Pedumuru]

Convert the ti,omap4-dmic text binding to DT schema format for
validation with dt_binding_check and dtbs_check.
Changes during conversion:
- dtbs_check flagged reg-names, dmas, and dma-names as undocumented
  on all four in-tree omap5 boards using this compatible (cm-t54,
  igep0050, sbc-t54, uevm)
- Add these as required properties to reflect actual hardware usage,
  since the original text binding was incomplete
- Drop ti,hwmods from required, as it is a legacy property tied to
  the OMAP hwmod framework and is not mandatory for DT schema
  validation going forward
- Update the example to exercise all newly documented properties so
  the schema validates cleanly against real board DTS files

Signed-off-by: Charan Pedumuru <charan.pedumuru@gmail.com>
---
 .../devicetree/bindings/sound/omap-dmic.txt        | 20 -------
 .../devicetree/bindings/sound/ti,omap4-dmic.yaml   | 68 ++++++++++++++++++++++
 2 files changed, 68 insertions(+), 20 deletions(-)

diff --git a/Documentation/devicetree/bindings/sound/omap-dmic.txt b/Documentation/devicetree/bindings/sound/omap-dmic.txt
deleted file mode 100644
index 418e30e72e89..000000000000
--- a/Documentation/devicetree/bindings/sound/omap-dmic.txt
+++ /dev/null
@@ -1,20 +0,0 @@
-* Texas Instruments OMAP4+ Digital Microphone Module
-
-Required properties:
-- compatible: "ti,omap4-dmic"
-- reg: Register location and size as an array:
-       <MPU access base address, size>,
-       <L3 interconnect address, size>;
-- interrupts: Interrupt number for DMIC
-- ti,hwmods: Name of the hwmod associated with OMAP dmic IP
-
-Example:
-
-dmic: dmic@4012e000 {
-	compatible = "ti,omap4-dmic";
-	reg = <0x4012e000 0x7f>, /* MPU private access */
-	      <0x4902e000 0x7f>; /* L3 Interconnect */
-	interrupts = <0 114 0x4>;
-	interrupt-parent = <&gic>;
-	ti,hwmods = "dmic";
-};
diff --git a/Documentation/devicetree/bindings/sound/ti,omap4-dmic.yaml b/Documentation/devicetree/bindings/sound/ti,omap4-dmic.yaml
new file mode 100644
index 000000000000..4719ac48238e
--- /dev/null
+++ b/Documentation/devicetree/bindings/sound/ti,omap4-dmic.yaml
@@ -0,0 +1,68 @@
+# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/sound/ti,omap4-dmic.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments OMAP4+ Digital Microphone Module
+
+maintainers:
+  - Peter Ujfalusi <peter.ujfalusi@ti.com>
+
+description:
+  The OMAP4+ Digital Microphone (DMIC) controller captures audio from
+  up to three stereo digital microphone pairs over an I2S-like
+  interface and transfers the resulting PCM data to memory via DMA.
+  The controller exposes two register regions, one for MPU-private
+  control and status access and one for the L3 interconnect side
+  used for data transfer, and is found on OMAP4, OMAP5 and DRA7xx
+  family SoCs.
+
+properties:
+  compatible:
+    const: ti,omap4-dmic
+
+  reg:
+    maxItems: 2
+
+  reg-names:
+    items:
+      - const: mpu
+      - const: dma
+
+  interrupts:
+    maxItems: 1
+
+  ti,hwmods:
+    description: Name of the hwmod associated with OMAP DMIC IP.
+    const: dmic
+
+  dmas:
+    maxItems: 1
+
+  dma-names:
+    const: up_link
+
+required:
+  - reg
+  - compatible
+  - reg-names
+  - interrupts
+  - dmas
+  - dma-names
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    dmic@4012e000 {
+        compatible = "ti,omap4-dmic";
+        reg = <0x4012e000 0x7f>, /* MPU private access */
+              <0x4902e000 0x7f>; /* L3 Interconnect */
+        reg-names = "mpu", "dma";
+        interrupts = <GIC_SPI 114 IRQ_TYPE_LEVEL_HIGH>;
+        dmas = <&sdma 67>;
+        dma-names = "up_link";
+        ti,hwmods = "dmic";
+    };

---
base-commit: 7de6ae9e12207ec146f2f3f1e58d1a99317e88bc
change-id: 20260630-ti-dmic-09ef117f987b

Best regards,
--  
Charan Pedumuru <charan.pedumuru@gmail.com>

Re: [PATCH] ASoC: dt-bindings: ti,omap4-dmic: Convert TI OMAP4+ DMIC binding to YAML

[Rob Herring (Arm)]

On Tue, 30 Jun 2026 12:25:49 +0000, Charan Pedumuru wrote:
> Convert the ti,omap4-dmic text binding to DT schema format for
> validation with dt_binding_check and dtbs_check.
> Changes during conversion:
> - dtbs_check flagged reg-names, dmas, and dma-names as undocumented
>   on all four in-tree omap5 boards using this compatible (cm-t54,
>   igep0050, sbc-t54, uevm)
> - Add these as required properties to reflect actual hardware usage,
>   since the original text binding was incomplete
> - Drop ti,hwmods from required, as it is a legacy property tied to
>   the OMAP hwmod framework and is not mandatory for DT schema
>   validation going forward
> - Update the example to exercise all newly documented properties so
>   the schema validates cleanly against real board DTS files
> 
> Signed-off-by: Charan Pedumuru <charan.pedumuru@gmail.com>
> ---
>  .../devicetree/bindings/sound/omap-dmic.txt        | 20 -------
>  .../devicetree/bindings/sound/ti,omap4-dmic.yaml   | 68 ++++++++++++++++++++++
>  2 files changed, 68 insertions(+), 20 deletions(-)
> 

Reviewed-by: Rob Herring (Arm) <robh@kernel.org>