Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67;
Date:   20 Feb 2020 11:16:08 +0900
Message-ID: <874kvmt355.wl-kuninori.morimoto.gx@renesas.com>
From:   Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
To:     Rob Herring <robh@kernel.org>
Cc:     Liam Girdwood <lgirdwood@gmail.com>,
        Mark Brown <broonie@kernel.org>,
        Mark Rutland <mark.rutland@arm.com>,
        alsa-devel@alsa-project.org, devicetree@vger.kernel.org,
        linux-kernel@vger.kernel.org
Subject: Re: [PATCH v2] ASoC: dt-bindings: renesas,rsnd: switch to yaml base Documentation
In-Reply-To: <20200219161732.GB25095@bogus>
References: <87d0ahzr9d.wl-kuninori.morimoto.gx@renesas.com>
        <20200219161732.GB25095@bogus>
User-Agent: Wanderlust/2.15.9 Emacs/25.2 Mule/6.0
MIME-Version: 1.0 (generated by SEMI-EPG 1.14.7 - "Harue")
Content-Type: text/plain; charset=US-ASCII
Sender: linux-kernel-owner@vger.kernel.org
Precedence: bulk


Hi Rob

Thank you for your review

> > From: Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
> > 
> > This patch switches from .txt base to .yaml base Document.
> > It is still keeping detail explanations at .txt
> > 
> > Signed-off-by: Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
> > ---
(snip)
> > +  compatible:
> > +    oneOf:
> > +      # for Gen1 SoC
> > +      - items:
> > +        - enum:
> 
> nit: Should be indented 2 more spaces.

I couldn't understand this.
Do you mean like this ??

   compatible:
     oneOf:
       # for Gen1 SoC
       - items:
=>         - enum:

> > +  clock-frequency:
> > +    description: for audio_clkout0/1/2/3
> > +    $ref: /schemas/types.yaml#/definitions/uint32-array
> 
> This already has a common definition and this conflicts with that. 
> 'clock-frequency' is a single uint32 or uint64.

This needs clock array. Like this

	clock-frequency = <12288000 11289600>;

> > +  # For OF-graph
> > +  port:
> > +    description: OF-Graph subnode
> > +    type: object
> > +    properties:
> > +      reg:
> > +        $ref: /schemas/types.yaml#/definitions/uint32
> 
> No unit-address for 'port', so you don't need 'reg' here.

But I got warning without reg ?
And, renesas,rsnd and/or simple-card sometimes needs reg for port
to handle sound path.

> > +  # For multi OF-graph
> > +  ports:
> > +    description: multi OF-Graph subnode
> > +    type: object
> > +    patternProperties:
> > +      "port(@.*)?":
> 
> ^port(@[0-9a-f])?$"
> 
> Perhaps there's max number of ports that's less than 0xf?
> 
> > +        $ref: "#properties/port"
> 
> Would be more simple to just always have 'ports'.

Having "ports" or "port" are case-by-case, not always.

Thank you for your help !!
Best regards
---
Kuninori Morimoto