Re: [PATCH RFC 3/7] dt-bindings: i3c: renesas,i3c: Add binding for Renesas I3C controller

Rob Herring
2025-06-25T21:38:57Z

On Thu, Jun 12, 2025 at 04:51:42PM +0200, Tommaso Merciai wrote:
> Hi Frank, Wolfram,
>
> Thanks both for your work.
>
> On 12/06/25 16:31, Wolfram Sang wrote:
> > Hi Frank,
> >
> > > > + clock-names:
> > > > + oneOf:
> > > > + - items:
> > > > + - const: pclk
> > > > + - const: tclk
> > > > + - items:
> > > > + - const: pclk
> > > > + - const: pclkrw
> > > > + - const: tclk
> > >
> > > Suggested clock name is, apb, trans, srfs.

Suggested by who?

> > > Needn't clk surfix and provide meanful name.
> >
> > ? Why can't we have the name from the datasheets? It will be
> > unnecessarily hard for users to verify the correctness of the clock
> > assignments if they need an artifical mapping of these names. If they
> > are the same as in the datasheet, the same task becomes very easy.
> >
>
> Agreed.
> Since the name comes from the hw manual I think is better to leave it as is.

Agreed.

While 'clk' is considered redundant, naming clocks 'p' and 't' is too
terse even for me. So the rule is clk is redundant unless it is with a
single letter. The rules apply to s/w folks making up names, not h/w
manuals.

Rob