github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-05-27 00:22:00 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

ASoC: dt-bindings: omap-twl4030: convert to DT schema

Browse Source 
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.

Acked-by: Mark Brown <broonie@kernel.org>
Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>
Reviewed-by: Rob Herring (Arm) <robh@kernel.org>
Link: https://patch.msgid.link/20250819201302.80712-3-jihed.chaibi.dev@gmail.com
Signed-off-by: Mark Brown <broonie@kernel.org>
This commit is contained in:
Jihed Chaibi 2025-08-19 22:13:02 +02:00 committed by Mark Brown
parent 0411332240
commit c232495d28
No known key found for this signature in database
GPG Key ID: 24D68B725D5487D0
2 changed files with 98 additions and 62 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

62
Documentation/devicetree/bindings/sound/omap-twl4030.txt
View File

@ -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>;
};

98
Documentation/devicetree/bindings/sound/ti,omap-twl4030.yaml Normal file
View File

@ -0,0 +1,98 @@
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/sound/ti,omap-twl4030.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Texas Instruments SoC with twl4030 based audio setups
maintainers:
- Peter Ujfalusi <peter.ujfalusi@gmail.com>
description:
Audio setups on TI OMAP SoCs using TWL4030-family
audio codec connected via a McBSP port.
properties:
compatible:
const: ti,omap-twl4030
ti,model:
$ref: /schemas/types.yaml#/definitions/string
description: Name of the sound card (for example "omap3beagle").
ti,mcbsp:
$ref: /schemas/types.yaml#/definitions/phandle
description: phandle for the McBSP node.
ti,codec:
$ref: /schemas/types.yaml#/definitions/phandle
description: phandle for the twl4030 audio node.
ti,mcbsp-voice:
$ref: /schemas/types.yaml#/definitions/phandle
description: phandle to the McBSP node connected to the voice port.
ti,jack-det-gpio:
description: GPIO specifier for jack detection.
maxItems: 1
ti,audio-routing:
description: |
A list of audio routing connections. Each entry is a pair of strings,
with the first being the connection's sink and the second being the
source. If not provided, all possible connections are available.
$ref: /schemas/types.yaml#/definitions/non-unique-string-array
items:
enum:
# Board Connectors
- Headset Stereophone
- Earpiece Spk
- Handsfree Spk
- Ext Spk
- Main Mic
- Sub Mic
- Headset Mic
- Carkit Mic
- Digital0 Mic
- Digital1 Mic
- Line In
# CODEC 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
required:
- compatible
- ti,model
- ti,mcbsp
additionalProperties: false
examples:
- |
sound {
compatible = "ti,omap-twl4030";
ti,model = "omap3beagle";
ti,mcbsp = <&mcbsp2>;
};