Re: [PATCH v3 09/13] ASoC: dt-bindings: tegra: Add schema for audio graph card

[Sameer Pujar]

> > Add YAML schema for Tegra audio graph sound card DT bindings. It uses the
> > same DT bindings provided by generic audio graph driver. Along with this
> > few standard clock DT bindings are added which are specifically required
> > for Tegra audio.
> >
> > Signed-off-by: Sameer Pujar <spujar@xxxxxxxxxx>
> > ---
> >   .../sound/nvidia,tegra-audio-graph-card.yaml       | 70 ++++++++++++++++++++++
> >   1 file changed, 70 insertions(+)
> >   create mode 100644 Documentation/devicetree/bindings/sound/nvidia,tegra-audio-graph-card.yaml
> >
> > diff --git a/Documentation/devicetree/bindings/sound/nvidia,tegra-audio-graph-card.yaml b/Documentation/devicetree/bindings/sound/nvidia,tegra-audio-graph-card.yaml
> > new file mode 100644
> > index 0000000..b73fbe5
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/sound/nvidia,tegra-audio-graph-card.yaml
> > @@ -0,0 +1,70 @@
> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > +%YAML 1.2
> > +---
> > +$id: http://devicetree.org/schemas/sound/nvidia,tegra-audio-graph-card.yaml#
> > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > +
> > +title: Audio Graph based Tegra sound card driver
> > +
> > +description: |
> > +  This is based on generic audio graph card driver along with additional
> > +  customizations for Tegra platforms. It uses the same bindings with
> > +  additional standard clock DT bindings required for Tegra.
> > +
> > +  See{LINUX}/Documentation/devicetree/bindings/sound/audio-graph-card.txt
> > +
> > +maintainers:
> > +  - Jon Hunter <jonathanh@xxxxxxxxxx>
> > +  - Sameer Pujar <spujar@xxxxxxxxxx>
> > +
> > +properties:
> > +  compatible:
> > +    oneOf:
> > +      - const: nvidia,tegra210-audio-graph-card
> > +      - const: nvidia,tegra186-audio-graph-card
> > +
> > +  clocks:
> > +   minItems: 2
> > +
> > +  clock-names:
> > +   minItems: 2
> > +   items:
> > +     - const: pll_a
> > +     - const: plla_out0
> > +
> > +  assigned-clocks:
> > +    minItems: 1
> > +    maxItems: 3
> > +
> > +  assigned-clock-parents:
> > +    minItems: 1
> > +    maxItems: 3
> > +
> > +  assigned-clock-rates:
> > +    minItems: 1
> > +    maxItems: 3
> > +
> > +required:
> > +  - compatible
> > +  - clocks
> > +  - clock-names
> > +  - assigned-clocks
> > +  - assigned-clock-parents
> Where's the graph? You need to define the ports and reference the common
> schema.

I am looking to reference the bindings used in below doc which is not 
yet in YAML format. Only additional properties I listed here.
{LINUX}/Documentation/devicetree/bindings/sound/audio-graph-card.txt

Should I keep this doc to *.txt format as well and later move to YAML or 
is there a way to reference *.txt doc here?