Re: [PATCH v2 19/22] ASoC: dt-bindings: mt8192: Document audio-routing and dai-link subnode

[AngeloGioacchino Del Regno <angelogioacchino.delregno@xxxxxxxxxxxxx>]

Il 07/03/24 15:12, Rob Herring ha scritto:
> On Thu, Mar 07, 2024 at 12:44:42PM +0100, AngeloGioacchino Del Regno wrote:
> > Document the dai-link subnodes and the audio-routing property, allowing
> > to describe machine specific audio hardware and links in device tree.
> >
> > While at it, also deprecate the old properties which were previously
> > used with the driver's partially hardcoded configuration.
>
> I replied on v1, but one more thing here.
>
> > Signed-off-by: AngeloGioacchino Del Regno <angelogioacchino.delregno@xxxxxxxxxxxxx>
> > ---
> >   .../sound/mt8192-mt6359-rt1015-rt5682.yaml    | 124 ++++++++++++++++--
> >   1 file changed, 115 insertions(+), 9 deletions(-)
> >
> > diff --git a/Documentation/devicetree/bindings/sound/mt8192-mt6359-rt1015-rt5682.yaml b/Documentation/devicetree/bindings/sound/mt8192-mt6359-rt1015-rt5682.yaml
> > index 7e50f5d65c8f..449454c50dcc 100644
> > --- a/Documentation/devicetree/bindings/sound/mt8192-mt6359-rt1015-rt5682.yaml
> > +++ b/Documentation/devicetree/bindings/sound/mt8192-mt6359-rt1015-rt5682.yaml
> > @@ -13,6 +13,9 @@ maintainers:
> >   description:
> >     This binding describes the MT8192 sound card.
> >   
> > +allOf:
> > +  - $ref: sound-card-common.yaml#
> > +
> >   properties:
> >     compatible:
> >       enum:
> > @@ -20,6 +23,14 @@ properties:
> >         - mediatek,mt8192_mt6359_rt1015p_rt5682
> >         - mediatek,mt8192_mt6359_rt1015p_rt5682s
> >   
> > +  audio-routing:
> > +    description:
> > +      A list of the connections between audio components. Each entry is a
> > +      pair of strings, the first being the connection's sink, the second
> > +      being the connection's source.
> > +      Valid names could be the input or output widgets of audio components,
> > +      power supplies, MicBias of codec and the software switch.
> > +
> >     mediatek,platform:
> >       $ref: /schemas/types.yaml#/definitions/phandle
> >       description: The phandle of MT8192 ASoC platform.
> > @@ -27,10 +38,12 @@ properties:
> >     mediatek,hdmi-codec:
> >       $ref: /schemas/types.yaml#/definitions/phandle
> >       description: The phandle of HDMI codec.
> > +    deprecated: true
>
> The deprecated keyword doesn't do anything at the moment, but my plan
> there is to add a mode to the tools which disables all deprecated
> properties. That will give you want you want in terms of disallowing
> these properties.

That would definitely be awesome - looking forward to it!

> That would require dropping them from "required" which I'm fine with you
> doing. (Though technically that's still an ABI change)

Then instead of waiting for you to add that mode and then remove stuff later,
I'll just omit the `else: required:` block on v3, so that we avoid commit
noise and all the warnings when the deprecated check gets released.

I guess that's fine, right?

Cheers,
Angelo