ASoC: dt-bindings: Document routing strings for various codecs
Subsystems (4)
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
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
@@ -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
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.
Signed-off-by Jihed Chaibi <[email protected]>
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(+)
Re: [PATCH v2 1/3] ASoC: dt-bindings: everest,es8316: Document routing strings
In reply to Jihed ChaibiQuoted 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.
Signed-off-by Jihed Chaibi <[email protected]>
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@@ -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
PATCH v2 2/3 ASoC: dt-bindings: nuvoton,nau8825: Document routing strings
In reply to Jihed ChaibiAdd 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
@@ -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
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.
Signed-off-by Jihed Chaibi <[email protected]>
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(+)
PATCH v2 3/3 ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names)
In reply to Jihed ChaibiAdd 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
@@ -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
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.
Signed-off-by Jihed Chaibi <[email protected]>---
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(+)
Re: [PATCH v2 3/3] ASoC: dt-bindings: wlf,wm8960: Document routing strings (pin names)
In reply to Jihed ChaibiQuoted 6 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.
Signed-off-by Jihed Chaibi <[email protected]>---
Thanks,
Charles
Mark Brown
maintainerQuoted 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: 0ccc1eeda155c947d88ef053e0b54e434e218ee2All 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