[PATCH v2 0/3] ASoC: dt-bindings: Document routing strings for various codecs

[PATCH v2 0/3] ASoC: dt-bindings: Document routing strings for various codecs

[Jihed Chaibi]

Hello,

The series adds pin names for the es8316, wm8960, and nau8825
codecs to their respective binding files to improve the user
experience for board developers.

This v2 series addresses maintainer's feedback to rephrase the
description to refer to the device's pins and ports rather than the
driver.

Thank you,
Jihed

---
Changes in v2:
  - Rephrased description to refer to device pins instead of the
    driver.

Jihed Chaibi (3):
  ASoC: dt-bindings: everest,es8316: Document routing strings
  ASoC: dt-bindings: nuvoton,nau8825: Document routing strings
  ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names)

 .../bindings/sound/everest,es8316.yaml        | 16 ++++++++++++++
 .../bindings/sound/nuvoton,nau8825.yaml       | 14 ++++++++++++
 .../devicetree/bindings/sound/wlf,wm8960.yaml | 22 +++++++++++++++++++
 3 files changed, 52 insertions(+)

-- 
2.39.5

[PATCH v2 1/3] ASoC: dt-bindings: everest,es8316: Document routing strings

[Jihed Chaibi]

Add a list of the es8316 pin names to the binding's description to make
it self-contained and improve the user experience for board developers.

Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>

---
Changes in v2:
 - Rephrased description to refer to device pins instead of the
   driver.
---
 .../bindings/sound/everest,es8316.yaml           | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/Documentation/devicetree/bindings/sound/everest,es8316.yaml b/Documentation/devicetree/bindings/sound/everest,es8316.yaml
index e4b2eb5fae2..81a0215050e 100644
--- a/Documentation/devicetree/bindings/sound/everest,es8316.yaml
+++ b/Documentation/devicetree/bindings/sound/everest,es8316.yaml
@@ -12,6 +12,22 @@ maintainers:
   - Matteo Martelli <matteomartelli3@gmail.com>
   - Binbin Zhou <zhoubinbin@loongson.cn>
 
+description: |
+  Everest ES8311, ES8316 and ES8323 audio CODECs
+
+  Pins on the device (for linking into audio routes):
+
+    Outputs:
+      * LOUT:     Left Analog Output
+      * ROUT:     Right Analog Output
+      * MICBIAS:  Microphone Bias
+
+    Inputs:
+      * MIC1P:    Microphone 1 Positive Analog Input
+      * MIC1N:    Microphone 1 Negative Analog Input
+      * MIC2P:    Microphone 2 Positive Analog Input
+      * MIC2N:    Microphone 2 Negative Analog Input
+
 allOf:
   - $ref: dai-common.yaml#
 
-- 
2.39.5

[PATCH v2 2/3] ASoC: dt-bindings: nuvoton,nau8825: Document routing strings

[Jihed Chaibi]

Add a list of the nau8825 pin names to the binding's description to make
it self-contained and improve the user experience for board developers.

Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>

---
Changes in v2:
 - Rephrased description to refer to device pins  instead of the
   driver.
---
 .../devicetree/bindings/sound/nuvoton,nau8825.yaml | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml b/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml
index a54f194a0b4..4ebbcb4e605 100644
--- a/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml
+++ b/Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml
@@ -9,6 +9,20 @@ title: NAU8825 audio CODEC
 maintainers:
   - John Hsu <KCHSU0@nuvoton.com>
 
+description: |
+  NAU8825 audio CODEC
+
+  Pins on the device (for linking into audio routes):
+
+    Outputs:
+      * HPOL    : Headphone Left Output
+      * HPOR    : Headphone Right Output
+      * MICBIAS : Microphone Bias Output
+
+    Inputs:
+      * MICP    : Analog Microphone Positive Input
+      * MICN    : Analog Microphone Negative Input
+
 allOf:
   - $ref: dai-common.yaml#
 
-- 
2.39.5

[PATCH v2 3/3] ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names)

[Jihed Chaibi]

Add a list of the wm8960 pin names to the binding's description to make
it self-contained and improve the user experience for board developers.

Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>

---
Changes in v2:
 - No changes, this file is already refering to device pins.
---
 .../devicetree/bindings/sound/wlf,wm8960.yaml | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/Documentation/devicetree/bindings/sound/wlf,wm8960.yaml b/Documentation/devicetree/bindings/sound/wlf,wm8960.yaml
index 3c2b9790ffc..c8c786cb6c4 100644
--- a/Documentation/devicetree/bindings/sound/wlf,wm8960.yaml
+++ b/Documentation/devicetree/bindings/sound/wlf,wm8960.yaml
@@ -9,6 +9,28 @@ title: Wolfson WM8960 audio codec
 maintainers:
   - patches@opensource.cirrus.com
 
+description: |
+  Wolfson WM8960 audio codec
+
+  Pins on the device (for linking into audio routes):
+
+    Outputs:
+      * HP_L    : Left Headphone/Line Output
+      * HP_R    : Right Headphone/Line Output
+      * SPK_LP  : Left Speaker Output (Positive)
+      * SPK_LN  : Left Speaker Output (Negative)
+      * SPK_RP  : Right Speaker Output (Positive)
+      * SPK_RN  : Right Speaker Output (Negative)
+      * OUT3    : Mono, Left, Right or buffered midrail output for capless mode
+
+    Inputs:
+      * LINPUT1 : Left single-ended or negative differential microphone input
+      * RINPUT1 : Right single-ended or negative differential microphone input
+      * LINPUT2 : Left line input or positive differential microphone input
+      * RINPUT2 : Right line input or positive differential microphone input
+      * LINPUT3 : Left line input, positive differential microphone, or Jack Detect 2
+      * RINPUT3 : Right line input, positive differential microphone, or Jack Detect 3
+
 properties:
   compatible:
     const: wlf,wm8960
-- 
2.39.5

Re: [PATCH v2 1/3] ASoC: dt-bindings: everest,es8316: Document routing strings

[Rob Herring (Arm)]

On Wed, 03 Sep 2025 18:01:17 +0200, Jihed Chaibi wrote:
> Add a list of the es8316 pin names to the binding's description to make
> it self-contained and improve the user experience for board developers.
> 
> Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>
> 
> ---
> Changes in v2:
>  - Rephrased description to refer to device pins instead of the
>    driver.
> ---
>  .../bindings/sound/everest,es8316.yaml           | 16 ++++++++++++++++
>  1 file changed, 16 insertions(+)
> 

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

Re: [PATCH v2 2/3] ASoC: dt-bindings: nuvoton,nau8825: Document routing strings

[Rob Herring (Arm)]

On Wed, 03 Sep 2025 18:01:18 +0200, Jihed Chaibi wrote:
> Add a list of the nau8825 pin names to the binding's description to make
> it self-contained and improve the user experience for board developers.
> 
> Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>
> 
> ---
> Changes in v2:
>  - Rephrased description to refer to device pins  instead of the
>    driver.
> ---
>  .../devicetree/bindings/sound/nuvoton,nau8825.yaml | 14 ++++++++++++++
>  1 file changed, 14 insertions(+)
> 

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

Re: [PATCH v2 3/3] ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names)

[Rob Herring (Arm)]

On Wed, 03 Sep 2025 18:01:19 +0200, Jihed Chaibi wrote:
> Add a list of the wm8960 pin names to the binding's description to make
> it self-contained and improve the user experience for board developers.
> 
> Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>
> 
> ---
> Changes in v2:
>  - No changes, this file is already refering to device pins.
> ---
>  .../devicetree/bindings/sound/wlf,wm8960.yaml | 22 +++++++++++++++++++
>  1 file changed, 22 insertions(+)
> 

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

Re: [PATCH v2 3/3] ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names)

[Charles Keepax]

On Wed, Sep 03, 2025 at 06:01:19PM +0200, Jihed Chaibi wrote:
> Add a list of the wm8960 pin names to the binding's description to make
> it self-contained and improve the user experience for board developers.
> 
> Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>
> 
> ---

Reviewed-by: Charles Keepax <ckeepax@opensource.cirrus.com>

Thanks,
Charles

Re: [PATCH v2 1/3] ASoC: dt-bindings: everest,es8316: Document routing strings

[Binbin Zhou]

On 2025/9/4 00:01, Jihed Chaibi wrote:
> Add a list of the es8316 pin names to the binding's description to make
> it self-contained and improve the user experience for board developers.
>
> Signed-off-by: Jihed Chaibi <jihed.chaibi.dev@gmail.com>


Reviewed-by: Binbin Zhou <zhoubinbin@loongson.cn>

>
> ---
> Changes in v2:
>   - Rephrased description to refer to device pins instead of the
>     driver.
> ---
>   .../bindings/sound/everest,es8316.yaml           | 16 ++++++++++++++++
>   1 file changed, 16 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/sound/everest,es8316.yaml b/Documentation/devicetree/bindings/sound/everest,es8316.yaml
> index e4b2eb5fae2..81a0215050e 100644
> --- a/Documentation/devicetree/bindings/sound/everest,es8316.yaml
> +++ b/Documentation/devicetree/bindings/sound/everest,es8316.yaml
> @@ -12,6 +12,22 @@ maintainers:
>     - Matteo Martelli <matteomartelli3@gmail.com>
>     - Binbin Zhou <zhoubinbin@loongson.cn>
>   
> +description: |
> +  Everest ES8311, ES8316 and ES8323 audio CODECs
> +
> +  Pins on the device (for linking into audio routes):
> +
> +    Outputs:
> +      * LOUT:     Left Analog Output
> +      * ROUT:     Right Analog Output
> +      * MICBIAS:  Microphone Bias
> +
> +    Inputs:
> +      * MIC1P:    Microphone 1 Positive Analog Input
> +      * MIC1N:    Microphone 1 Negative Analog Input
> +      * MIC2P:    Microphone 2 Positive Analog Input
> +      * MIC2N:    Microphone 2 Negative Analog Input
> +
>   allOf:
>     - $ref: dai-common.yaml#
>   

Thanks.
Binbin

Re: [PATCH v2 0/3] ASoC: dt-bindings: Document routing strings for various codecs

[Mark Brown]

On Wed, 03 Sep 2025 18:01:16 +0200, Jihed Chaibi wrote:
> The series adds pin names for the es8316, wm8960, and nau8825
> codecs to their respective binding files to improve the user
> experience for board developers.
> 
> This v2 series addresses maintainer's feedback to rephrase the
> description to refer to the device's pins and ports rather than the
> driver.
> 
> [...]

Applied to

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

Thanks!

[1/3] ASoC: dt-bindings: everest,es8316: Document routing strings
      commit: acd2fa47aac568052bd8321586be64958e3e93b2
[2/3] ASoC: dt-bindings: nuvoton,nau8825: Document routing strings
      commit: 118ddab8bb4a06fd5e13446d11d69e301044087d
[3/3] ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names)
      commit: 0ccc1eeda155c947d88ef053e0b54e434e218ee2

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