Skip to contentSkip to conversation

ASoC: dt-bindings: Document routing strings for various codecs

PATCH In review Jihed Chaibi 5 participants 10 messages Sep 3, 2025 – Sep 4, 2025

Subsystems (4)
lore
Share & tools
lore
#0 lore raw

v2 cover ASoC: dt-bindings: Document routing strings for various codecs

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(+)
Signature · 1 line
2.39.5
#1 lore raw

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

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.

---
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(+)
Documentation/devicetree/bindings/sound/everest,es8316.yaml +16 -0
index e4b2eb5fae2..81a0215050e 100644
@@ -12,6 +12,22 @@ maintainers:
   - Matteo Martelli <[email protected]>
   - Binbin Zhou <[email protected]>
 
+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#
 
Signature · 1 line
2.39.5
maintainer Acked-by on v2 1/3
#2 lore raw

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

Quoted 5 lines · 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.

Quoted 8 lines

---
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(+)
Reviewed-by on v2 1/3
#3 lore raw

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

In reply to Jihed Chaibi
Quoted 4 lines · 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.

Quoted 26 lines

---
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(+)
Documentation/devicetree/bindings/sound/everest,es8316.yaml +9 -0
index e4b2eb5fae2..81a0215050e 100644
@@ -12,6 +12,22 @@ maintainers:
    - Matteo Martelli <[email protected]>
    - Binbin Zhou <[email protected]>
 
+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

Documentation/devicetree/bindings/sound/everest,es8316.yaml maintainers: · line 33

Quoted 10 lines
Documentation/devicetree/bindings/sound/everest,es8316.yaml +7 -0
+
+    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

#4 lore raw

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

In reply to 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.

---
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(+)
Documentation/devicetree/bindings/sound/nuvoton,nau8825.yaml +14 -0
index a54f194a0b4..4ebbcb4e605 100644
@@ -9,6 +9,20 @@ title: NAU8825 audio CODEC
 maintainers:
   - John Hsu <[email protected]>
 
+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#
 
Signature · 1 line
2.39.5
maintainer Acked-by on v2 2/3
#5 lore raw

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

Quoted 5 lines · 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.

Quoted 8 lines

---
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(+)
#6 lore raw

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

In reply to 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.

---
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(+)
Documentation/devicetree/bindings/sound/wlf,wm8960.yaml +22 -0
index 3c2b9790ffc..c8c786cb6c4 100644
@@ -9,6 +9,28 @@ title: Wolfson WM8960 audio codec
 maintainers:
   - [email protected]
 
+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
Signature · 1 line
2.39.5
maintainer Acked-by on v2 3/3
#7 lore raw

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

Quoted 12 lines · 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.

---
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(+)
maintainer
#9 lore raw
In reply to Jihed Chaibi
Quoted 9 lines · Jihed Chaibi

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