[PATCH v2 2/2] dt-bindings: mfd: twl4030-audio: document preferred name for external mute

From: Dmitry Torokhov

Date: Tue Oct 27 2026 - 17:33:04 EST


Proper names for GPIOs should use "-gpios" suffix. Now that the
twl4030 codec driver has been converted to use GPIO descriptors in
commit 178c169a30b0 ("ASoC: codec: twl4030: Convert to GPIO
descriptors"), update the binding documentation to list
"ti,hs_extmute-gpios" as the preferred property name and mark
"ti,hs_extmute_gpio" as deprecated.

Signed-off-by: Dmitry Torokhov <dmitry.torokhov@xxxxxxxxx>
---
Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml b/Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml
index c9c3f7513ad4..399693bed077 100644
--- a/Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml
+++ b/Documentation/devicetree/bindings/sound/ti,twl4030-audio.yaml
@@ -39,10 +39,16 @@ properties:
description:
Enable the use of an external mute for headset pop reduction.

+ ti,hs_extmute-gpios:
+ description:
+ The GPIO specifier for the external mute control.
+ maxItems: 1
+
ti,hs_extmute_gpio:
$ref: /schemas/types.yaml#/definitions/phandle-array
description:
- The GPIO specifier for the external mute control.
+ Deprecated legacy name for ti,hs_extmute-gpios.
+ deprecated: true
maxItems: 1

ti,offset_cncl_path:

--
2.56.0.307.g5fe7bd680c-goog