| Message ID | 20220308072435.22460-6-trevor.wu@mediatek.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
| Series | ASoC: mediatek: Add support for MT8195 sound card with max98390 and rt5682 | expand |
On Tue, Mar 08, 2022 at 03:24:35PM +0800, Trevor Wu wrote: > This patch adds document for mt8195 board with mt6359, max98390 and > rt5682. > > Signed-off-by: Trevor Wu <trevor.wu@mediatek.com> > --- > .../sound/mt8195-mt6359-max98390-rt5682.yaml | 61 +++++++++++++++++++ > 1 file changed, 61 insertions(+) > create mode 100644 Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml > > diff --git a/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml b/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml > new file mode 100644 > index 000000000000..7ec14d61b109 > --- /dev/null > +++ b/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml > @@ -0,0 +1,61 @@ > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/sound/mt8195-mt6359-max98390-rt5682.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Mediatek MT8195 with MT6359, MAX98390 and RT5682 ASoC sound card driver > + > +maintainers: > + - Trevor Wu <trevor.wu@mediatek.com> > + > +description: > + This binding describes the MT8195 sound card. > + > +properties: > + compatible: > + const: mediatek,mt8195_mt6359_max98390_rt5682 You have nodes for each of these components, why do we need new compatible string for each combination. You can figure out the combination by looking at each of those nodes. Second, why does each combination need a new schema doc? Rob
On Thu, 2022-03-10 at 16:18 -0600, Rob Herring wrote: > On Tue, Mar 08, 2022 at 03:24:35PM +0800, Trevor Wu wrote: > > This patch adds document for mt8195 board with mt6359, max98390 and > > rt5682. > > > > Signed-off-by: Trevor Wu <trevor.wu@mediatek.com> > > --- > > .../sound/mt8195-mt6359-max98390-rt5682.yaml | 61 > > +++++++++++++++++++ > > 1 file changed, 61 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/sound/mt8195- > > mt6359-max98390-rt5682.yaml > > > > diff --git a/Documentation/devicetree/bindings/sound/mt8195-mt6359- > > max98390-rt5682.yaml > > b/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390- > > rt5682.yaml > > new file mode 100644 > > index 000000000000..7ec14d61b109 > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/sound/mt8195-mt6359- > > max98390-rt5682.yaml > > @@ -0,0 +1,61 @@ > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > > +%YAML 1.2 > > +--- > > +$id: > > https://urldefense.com/v3/__http://devicetree.org/schemas/sound/mt8195-mt6359-max98390-rt5682.yaml*__;Iw!!CTRNKA9wMg0ARbw!zb7eaqdAQfuyPpP5m31L3Q5pdCulclJgnygkkMgYh2M6segUZedd-cYz51-5Q2XDCA$ > > > > +$schema: > > https://urldefense.com/v3/__http://devicetree.org/meta-schemas/core.yaml*__;Iw!!CTRNKA9wMg0ARbw!zb7eaqdAQfuyPpP5m31L3Q5pdCulclJgnygkkMgYh2M6segUZedd-cYz5187C1ArQA$ > > > > + > > +title: Mediatek MT8195 with MT6359, MAX98390 and RT5682 ASoC sound > > card driver > > + > > +maintainers: > > + - Trevor Wu <trevor.wu@mediatek.com> > > + > > +description: > > + This binding describes the MT8195 sound card. > > + > > +properties: > > + compatible: > > + const: mediatek,mt8195_mt6359_max98390_rt5682 > > You have nodes for each of these components, why do we need new > compatible string for each combination. You can figure out the > combination by looking at each of those nodes. > > Second, why does each combination need a new schema doc? > > Rob Hi Rob, I'm not sure whether I can reuse the old schema doc because of the doc name and compatible string seems to be specifically for the codec combination. If I want to reuse the old schema doc, should I change the doc name or compatible string? Make the naming more general. Thanks, Trevor
On Sat, Mar 12, 2022 at 10:20:21PM +0800, Trevor Wu wrote: > On Thu, 2022-03-10 at 16:18 -0600, Rob Herring wrote: > > On Tue, Mar 08, 2022 at 03:24:35PM +0800, Trevor Wu wrote: > > > This patch adds document for mt8195 board with mt6359, max98390 and > > > rt5682. > > > > > > Signed-off-by: Trevor Wu <trevor.wu@mediatek.com> > > > --- > > > .../sound/mt8195-mt6359-max98390-rt5682.yaml | 61 > > > +++++++++++++++++++ > > > 1 file changed, 61 insertions(+) > > > create mode 100644 Documentation/devicetree/bindings/sound/mt8195- > > > mt6359-max98390-rt5682.yaml > > > > > > diff --git a/Documentation/devicetree/bindings/sound/mt8195-mt6359- > > > max98390-rt5682.yaml > > > b/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390- > > > rt5682.yaml > > > new file mode 100644 > > > index 000000000000..7ec14d61b109 > > > --- /dev/null > > > +++ b/Documentation/devicetree/bindings/sound/mt8195-mt6359- > > > max98390-rt5682.yaml > > > @@ -0,0 +1,61 @@ > > > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) > > > +%YAML 1.2 > > > +--- > > > +$id: > > > https://urldefense.com/v3/__http://devicetree.org/schemas/sound/mt8195-mt6359-max98390-rt5682.yaml*__;Iw!!CTRNKA9wMg0ARbw!zb7eaqdAQfuyPpP5m31L3Q5pdCulclJgnygkkMgYh2M6segUZedd-cYz51-5Q2XDCA$ > > > > > > +$schema: > > > https://urldefense.com/v3/__http://devicetree.org/meta-schemas/core.yaml*__;Iw!!CTRNKA9wMg0ARbw!zb7eaqdAQfuyPpP5m31L3Q5pdCulclJgnygkkMgYh2M6segUZedd-cYz5187C1ArQA$ > > > > > > + > > > +title: Mediatek MT8195 with MT6359, MAX98390 and RT5682 ASoC sound > > > card driver > > > + > > > +maintainers: > > > + - Trevor Wu <trevor.wu@mediatek.com> > > > + > > > +description: > > > + This binding describes the MT8195 sound card. > > > + > > > +properties: > > > + compatible: > > > + const: mediatek,mt8195_mt6359_max98390_rt5682 > > > > You have nodes for each of these components, why do we need new > > compatible string for each combination. You can figure out the > > combination by looking at each of those nodes. > > > > Second, why does each combination need a new schema doc? > > > > Rob > > Hi Rob, > > I'm not sure whether I can reuse the old schema doc because of the doc > name and compatible string seems to be specifically for the codec > combination. > If I want to reuse the old schema doc, should I change the doc name or > compatible string? Make the naming more general. It's fine to either leave it named after the first compatible string or rename it if you want. Rob
diff --git a/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml b/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml new file mode 100644 index 000000000000..7ec14d61b109 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml @@ -0,0 +1,61 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/sound/mt8195-mt6359-max98390-rt5682.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Mediatek MT8195 with MT6359, MAX98390 and RT5682 ASoC sound card driver + +maintainers: + - Trevor Wu <trevor.wu@mediatek.com> + +description: + This binding describes the MT8195 sound card. + +properties: + compatible: + const: mediatek,mt8195_mt6359_max98390_rt5682 + + model: + $ref: /schemas/types.yaml#/definitions/string + description: User specified audio sound card name + + mediatek,platform: + $ref: "/schemas/types.yaml#/definitions/phandle" + description: The phandle of MT8195 ASoC platform. + + mediatek,dptx-codec: + $ref: "/schemas/types.yaml#/definitions/phandle" + description: The phandle of MT8195 Display Port Tx codec node. + + mediatek,hdmi-codec: + $ref: "/schemas/types.yaml#/definitions/phandle" + description: The phandle of MT8195 HDMI codec node. + + mediatek,adsp: + $ref: "/schemas/types.yaml#/definitions/phandle" + description: The phandle of MT8195 ADSP platform. + + mediatek,dai-link: + $ref: /schemas/types.yaml#/definitions/string-array + description: + A list of the desired dai-links in the sound card. Each entry is a + name defined in the machine driver. + +additionalProperties: false + +required: + - compatible + - mediatek,platform + +examples: + - | + + sound: mt8195-sound { + compatible = "mediatek,mt8195_mt6359_max98390_rt5682"; + mediatek,platform = <&afe>; + pinctrl-names = "default"; + pinctrl-0 = <&aud_pins_default>; + }; + +...
This patch adds document for mt8195 board with mt6359, max98390 and rt5682. Signed-off-by: Trevor Wu <trevor.wu@mediatek.com> --- .../sound/mt8195-mt6359-max98390-rt5682.yaml | 61 +++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/mt8195-mt6359-max98390-rt5682.yaml