Re: [PATCH 2/3] dt-bindings: SPI: Add Ingenic SFC bindings.

From: Zhou Yanjie
Date: Sun Jul 24 2022 - 11:33:20 EST


Hi Mike,

On 2022/7/24 上午4:49, Mike Yang wrote:
On 7/24/22 04:07, Krzysztof Kozlowski wrote:
On 23/07/2022 21:27, Mark Brown wrote:
On Sun, Jul 24, 2022 at 02:47:14AM +0800, Mike Yang wrote:
On 7/24/22 01:43, Krzysztof Kozlowski wrote:
On 23/07/2022 18:50, Zhou Yanjie wrote:
No offense, does it really need to be named that way?
I can't seem to find documentation with instructions on this :(
...

All bindings are to follow this rule, so I don't understand why you
think it is an exception for you?
Zhou didn't ask you to make an exception. They have a valid
point and they're asking why.
You may want to avoid further incidents of this kind by stop
being bossy and actually writing a guideline of naming these
.yaml files and publish it somewhere online.
Yeah, I do have to say that I was also completely unaware that
there was any enforced convention here.
Indeed, it's not a enforced pattern. But there are many other
insignificant ones which we also tend to forget during review, like
using words "Device Tree bindings" in title or using unnecessary quotes
around "refs" (also in ID of schema). It's not a big deal, but I ask
when I notice it.
Good. Thanks for paying attention to these details.


Zhou already mentioned he was unable find the naming guidelines of these .yaml files.

Apparently you think it's unacceptable for new contributors of a certain subsystem to use existing code as examples, and/or they're responsible for figuring out what's a good example and what's a bad one in the existing codebase.
It's everywhere in the kernel, what can I say? If you copy existing
code, you might copy poor code...
Still, it shouldn't be a responsibility of new contributors to determine the quality of an existing piece of code, unless there are clear guidelines (i.e. one should use the new "cs-gpios" attribute in SPI controllers).

It might never grow to new devices (because they might be different), so
that is not really an argument.
It is an argument. A very valid one.

"they *might* be different". You may want to get your hands on real hardware and try another word. Or at least read the datasheets instead of believing your imagination.

I would enjoy duplicating the st,stm32-spi.yaml into st,stm32{f,h}{0..7}-spi.yaml if I'm bored at a Sunday afternoon.

All bindings are to follow this rule, so I don't understand why you
think it is an exception for you?
Zhou didn't ask you to make an exception. They have a valid point and they're asking why.
Hm, everyone has the same valid point and such recommendation is to
everyone, although it is nothing serious.

You may want to avoid further incidents of this kind by stop being bossy and actually writing a guideline of naming these .yaml files and publish it somewhere online.
I did not see any incident here... Process of review includes comments
and there is nothing bad happening when you receive a comment. No
incident...

Okay. After careful inspection of the Ingenic datasheets, now I have the conclusion: The Ingenic X1000, X1021, X1500, X1501, X1520, X1600, X1800, X1830, X2000, X2100, X2500 have the same SFC controller.


Actually, you are also missing out the X1630 and X1660, and the upcoming X2600.



X1600 has a newer version (let's say v2) of the SFC, and X2000-2500 have v3. Others have the original version (let's say v1). Each new version introduced new features such as arbitrary DMA sizes, and the rest features are the same.


So IMO the name "ingenic,sfc.yaml" is perfectly logical.


Regards,
Mike Yang