ASoC: dt-bindings: Convert TI TWL4030 sound bindings to schema

Hello,

This series converts the legacy TXT bindings for the TI TWL4030 sound-related modules to the modern YAML DT schema format.

This work was previously part of a larger series but is now being sent as a focused submission for the ASoC subsystem.

Link to v3 discussion:
https://lore.kernel.org/all/[email protected]/

Thank you,
Jihed

---
Changes in v4:

- Resending as a separate, focused series per maintainer feedback.

    v3 link:
      https://lore.kernel.org/all/[email protected]/

- (1/2) ti,twl4030-audio: No change to binding content, only updating commit message format.
- (2/2) ti,omap-twl4030.yaml: Deleted redundant pins list.

Changes in v3:

- Updated commit message format for omap-twl4030.yaml (PATCH v2 7/9).

Changes in v2:

- (1/9) ti,twl4030-audio: Moved binding to sound/, added enum for ti,enable-vibra, and simplified the example.
- (7/9) omap-twl4030: Minor cosmetic fixes, retaining Acked-by Mark Brown.

The following two patches are included in this series:

Jihed Chaibi (2):
ASoC: dt-bindings: ti,twl4030-audio: convert to DT schema
ASoC: dt-bindings: omap-twl4030: convert to DT schema

 .../devicetree/bindings/mfd/twl4030-audio.txt | 46 ---------
 .../bindings/sound/omap-twl4030.txt           | 62 ------------
 .../bindings/sound/ti,omap-twl4030.yaml       | 98 +++++++++++++++++++
 .../bindings/sound/ti,twl4030-audio.yaml      | 90 +++++++++++++++++
 4 files changed, 188 insertions(+), 108 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/mfd/twl4030-audio.txt
 delete mode 100644 Documentation/devicetree/bindings/sound/omap-twl4030.txt
 create mode 100644 Documentation/devicetree/bindings/sound/ti,omap-twl4030.yaml
 create mode 100644 Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml

2.39.5

Convert the TWL4030 audio module bindings from txt to YAML format and move them to the sound subsystem bindings directory. This patch also refines the schema by adding an enum constraint for ti,enable-vibra and updates the example to remove irrelevant I2C clock-frequency property.

---
Changes in v4:
- No change to binding content, only updating commit message format.
- Split from larger series per maintainer feedback.
- v3 link:
https://lore.kernel.org/all/[email protected]/

Changes in v3:
- No changes.

Changes in v2:
- Moved binding from mfd to sound directory.
- Added enum: [0, 1] to ti,enable-vibra for stricter validation.
- Removed clock-frequency from the example as it’s not relevant to the binding.
- Simplified example by removing unnecessary I2C node properties.

---
 .../devicetree/bindings/mfd/twl4030-audio.txt | 46 ----------
 .../bindings/sound/ti,twl4030-audio.yaml      | 90 +++++++++++++++++++
 2 files changed, 90 insertions(+), 46 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/mfd/twl4030-audio.txt
 create mode 100644 Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml

deleted file mode 100644
index 414d2ae0a..000000000
@@ -1,46 +0,0 @@
-Texas Instruments TWL family (twl4030) audio module
-
-The audio module inside the TWL family consist of an audio codec and a vibra
-driver.
-
-Required properties:
-- compatible : must be "ti,twl4030-audio"
-
-Optional properties, nodes:
-
-Audio functionality:
-- codec { }: Need to be present if the audio functionality is used. Within this
-	     section the following options can be used:
-- ti,digimic_delay: Delay need after enabling the digimic to reduce artifacts
-		    from the start of the recorded sample (in ms)
--ti,ramp_delay_value: HS ramp delay configuration to reduce pop noise
--ti,hs_extmute: Use external mute for HS pop reduction
--ti,hs_extmute_gpio: Use external GPIO to control the external mute
--ti,offset_cncl_path: Offset cancellation path selection, refer to TRM for the
-		      valid values.
-
-Vibra functionality
-- ti,enable-vibra: Need to be set to <1> if the vibra functionality is used. if
-		   missing or it is 0, the vibra functionality is disabled.
-
-Example:
-&i2c1 {
-	clock-frequency = <2600000>;
-
-	twl: twl@48 {
-		reg = <0x48>;
-		interrupts = <7>; /* SYS_NIRQ cascaded to intc */
-		interrupt-parent = <&intc>;
-
-		twl_audio: audio {
-			compatible = "ti,twl4030-audio";
-
-			ti,enable-vibra = <1>;
-
-			codec {
-				ti,ramp_delay_value = <3>;
-			};
-
-		};
-	};
-};

2.39.5

Convert the legacy TXT binding for the OMAP TWL4030 sound card to the modern YAML DT schema format. This adds formal validation and improves documentation.

---
Changes in v4:
- Deleted redundant pins list.
- Split from larger series per maintainer feedback.
- v3 link:
https://lore.kernel.org/all/[email protected]/

Changes in v3:
- No change to binding content, only updating commit message format.

Changes in v2:
- Fixed comment formatting (added spaces for better alignment).
- Updated commit subject to align with subsystem style.
- Retained Acked-by from v1 as changes are cosmetic.

---
 .../bindings/sound/omap-twl4030.txt           | 62 ------------
 .../bindings/sound/ti,omap-twl4030.yaml       | 98 +++++++++++++++++++
 2 files changed, 98 insertions(+), 62 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/sound/omap-twl4030.txt
 create mode 100644 Documentation/devicetree/bindings/sound/ti,omap-twl4030.yaml

deleted file mode 100644
index f6a715e4e..000000000
@@ -1,62 +0,0 @@
-* Texas Instruments SoC with twl4030 based audio setups
-
-Required properties:
-- compatible: "ti,omap-twl4030"
-- ti,model: Name of the sound card (for example "omap3beagle")
-- ti,mcbsp: phandle for the McBSP node
-
-Optional properties:
-- ti,codec: phandle for the twl4030 audio node
-- ti,mcbsp-voice: phandle for the McBSP node connected to the voice port of twl
-- ti, jack-det-gpio: Jack detect GPIO
-- ti,audio-routing: List of connections between audio components.
-  Each entry is a pair of strings, the first being the connection's sink,
-  the second being the connection's source.
-  If the routing is not provided all possible connection will be available
-
-Available audio endpoints for the audio-routing table:
-
-Board connectors:
- * Headset Stereophone
- * Earpiece Spk
- * Handsfree Spk
- * Ext Spk
- * Main Mic
- * Sub Mic
- * Headset Mic
- * Carkit Mic
- * Digital0 Mic
- * Digital1 Mic
- * Line In
-
-twl4030 pins:
- * HSOL
- * HSOR
- * EARPIECE
- * HFL
- * HFR
- * PREDRIVEL
- * PREDRIVER
- * CARKITL
- * CARKITR
- * MAINMIC
- * SUBMIC
- * HSMIC
- * DIGIMIC0
- * DIGIMIC1
- * CARKITMIC
- * AUXL
- * AUXR
-
- * Headset Mic Bias
- * Mic Bias 1 /* Used for Main Mic or Digimic0 */
- * Mic Bias 2 /* Used for Sub Mic or Digimic1 */
-
-Example:
-
-sound {
-	compatible = "ti,omap-twl4030";
-	ti,model = "omap3beagle";
-
-	ti,mcbsp = <&mcbsp2>;
-};

2.39.5

Applied to

https://git.kernel.org/pub/scm/linux/kernel/git/broonie/sound.git for-next

Thanks!

[1/2] ASoC: dt-bindings: ti,twl4030-audio: convert to DT schema

      commit: 04113322406b4763677922f80ba5ab44a8dae7bb
[2/2] ASoC: dt-bindings: omap-twl4030: convert to DT schema
      commit: c232495d28ca092d0c39b10e35d3d613bd2414ab

All being well this means that it will be integrated into the linux-next tree (usually sometime in the next 24 hours) and sent to Linus during the next merge window (or sooner if it is a bug fix), however if problems are discovered then the patch may be dropped or reverted.

You may get further e-mails resulting from automated or manual testing and review of the tree, please engage with people reporting problems and send followup patches addressing any issues that are reported if needed.

If any updates are required or you are submitting further changes they should be sent as incremental updates against current git, existing patches will not be replaced.

Please add any relevant lists and maintainers to the CCs when replying to this mail.

Thanks,
Mark