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:   21 Feb 2020 09:30:04 +0900
Message-ID: <87tv3ksryd.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>,
        Linux-ALSA <alsa-devel@alsa-project.org>,
        devicetree@vger.kernel.org,
        "linux-kernel@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: <CAL_Jsq+VEQj9Nkyo_85RM3Ku1-D73_ot5BTAjidnJzJv7r1_Sw@mail.gmail.com>
References: <87d0ahzr9d.wl-kuninori.morimoto.gx@renesas.com>
        <20200219161732.GB25095@bogus>
        <874kvmt355.wl-kuninori.morimoto.gx@renesas.com>
        <CAL_Jsq+VEQj9Nkyo_85RM3Ku1-D73_ot5BTAjidnJzJv7r1_Sw@mail.gmail.com>
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 feedback

> > This needs clock array. Like this
> >
> >         clock-frequency = <12288000 11289600>;
> 
> Sorry, but the type is already defined in the spec. You'll still get
> warnings from the common schema and you can't override that here.
> 
> Not sure what to suggest. Leave it with a fixme or move to
> assigned-clocks-rates instead?

As you know, I'm not familiar with yaml base Documentation :/
I want leave it as your fixme if possible.

> > > > +  # For multi OF-graph
> > > > +  ports:
> > > > +    description: multi OF-Graph subnode
> > > > +    type: object
> > > > +    patternProperties:
> > > > +      "port(@.*)?":
(snip)
> > > > +        $ref: "#properties/port"
> > >
> > > Would be more simple to just always have 'ports'.
> >
> > Having "ports" or "port" are case-by-case, not always.
> 
> Why?
> 
> This:
> 
> port {};
> 
> and this:
> 
> ports {
>   port {};
> };
> 
> Are treated the same. It's perfectly valid to have 'ports' with a single port.

Yeah, if it needs only 1 port.
If I'm not misunderstanding, We are using it as

	ports {
		port@0 {
			endpoint {}
		};
		port@1 {
			endpoint {}
		};
		....
	};

or simply

	port {
			endpoint {}
	};

And here, sometimes, "port" and "endpoint" both need "reg".

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