The 'Headphones Jack' name used in current simple-card and audio-graph
card driver can't be recognized by user space service daemon like
pulseaudio and pipewire, which only recognize the 'Headphone Jack',
so add 'hp-pin-name-headphone' property for this case and it won't block
original use cases for 'Headphones Jack'

Signed-off-by: Shengjiu Wang <shengjiu.wang@nxp.com>
---
 Documentation/devicetree/bindings/sound/audio-graph-card2.yaml | 3 +++
 Documentation/devicetree/bindings/sound/audio-graph.yaml       | 3 +++
 Documentation/devicetree/bindings/sound/simple-card.yaml       | 3 +++
 3 files changed, 9 insertions(+)

diff --git a/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml b/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml
index 40eb1d7d6cf1..803e0a960d2e 100644
--- a/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml
+++ b/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml
@@ -39,6 +39,9 @@ properties:
     $ref: audio-graph.yaml#/properties/mic-det-gpios
   widgets:
     $ref: audio-graph.yaml#/properties/widgets
+  hp-pin-name-headphone:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description: Specify 'Headphone' as headphone pin name.
 
 required:
   - compatible
diff --git a/Documentation/devicetree/bindings/sound/audio-graph.yaml b/Documentation/devicetree/bindings/sound/audio-graph.yaml
index 9899d9d1958d..8cb2be122a6c 100644
--- a/Documentation/devicetree/bindings/sound/audio-graph.yaml
+++ b/Documentation/devicetree/bindings/sound/audio-graph.yaml
@@ -46,6 +46,9 @@ properties:
     maxItems: 1
   mic-det-gpios:
     maxItems: 1
+  hp-pin-name-headphone:
+    $ref: /schemas/types.yaml#/definitions/flag
+    description: Specify 'Headphone' as headphone pin name.
 
 required:
   - dais
diff --git a/Documentation/devicetree/bindings/sound/simple-card.yaml b/Documentation/devicetree/bindings/sound/simple-card.yaml
index 533d0a1da56e..9453089dc5f2 100644
--- a/Documentation/devicetree/bindings/sound/simple-card.yaml
+++ b/Documentation/devicetree/bindings/sound/simple-card.yaml
@@ -271,6 +271,9 @@ patternProperties:
         maxItems: 1
       mic-det-gpios:
         maxItems: 1
+      hp-pin-name-headphone:
+        $ref: /schemas/types.yaml#/definitions/flag
+        description: Specify 'Headphone' as headphone pin name.
 
     patternProperties:
       "^cpu(-[0-9]+)?$":
-- 
2.34.1

On 29/12/2025 12:18, Shengjiu Wang wrote:
> The 'Headphones Jack' name used in current simple-card and audio-graph
> card driver can't be recognized by user space service daemon like
> pulseaudio and pipewire, which only recognize the 'Headphone Jack',
> so add 'hp-pin-name-headphone' property for this case and it won't block
> original use cases for 'Headphones Jack'
> 
> Signed-off-by: Shengjiu Wang <shengjiu.wang@nxp.com>
> ---
>  Documentation/devicetree/bindings/sound/audio-graph-card2.yaml | 3 +++
>  Documentation/devicetree/bindings/sound/audio-graph.yaml       | 3 +++
>  Documentation/devicetree/bindings/sound/simple-card.yaml       | 3 +++
>  3 files changed, 9 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml b/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml
> index 40eb1d7d6cf1..803e0a960d2e 100644
> --- a/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml
> +++ b/Documentation/devicetree/bindings/sound/audio-graph-card2.yaml
> @@ -39,6 +39,9 @@ properties:
>      $ref: audio-graph.yaml#/properties/mic-det-gpios
>    widgets:
>      $ref: audio-graph.yaml#/properties/widgets
> +  hp-pin-name-headphone:
> +    $ref: /schemas/types.yaml#/definitions/flag
> +    description: Specify 'Headphone' as headphone pin name.

Not a DT property. You described ASoC drivers / core code, not hardware.

Best regards,
Krzysztof