From: Yinbo Zhu <zhuyinbo@loongson.cn>
To: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>,
Rob Herring <robh+dt@kernel.org>,
Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
zhuyinbo@loongson.cn, Arnd Bergmann <arnd@arndb.de>,
Hector Martin <marcan@marcan.st>, Lubomir Rintel <lkundrak@v3.sk>,
Conor Dooley <conor.dooley@microchip.com>,
Linus Walleij <linus.walleij@linaro.org>,
Hitomi Hasegawa <hasegawa-hitomi@fujitsu.com>,
Heiko Stuebner <heiko@sntech.de>,
Brian Norris <briannorris@chromium.org>,
Sven Peter <sven@svenpeter.dev>,
loongarch@lists.linux.dev, devicetree@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: Re: [PATCH v2 2/2] dt-bindings: soc: add loongson2 guts
Date: Wed, 26 Oct 2022 15:22:09 +0800 [thread overview]
Message-ID: <52de60bd-8aa5-a461-9bca-ce8e6f82ead8@loongson.cn> (raw)
In-Reply-To: <7c67c721-685a-fa0e-ab4b-41b7de3ea0a0@linaro.org>
在 2022/10/26 上午3:40, Krzysztof Kozlowski 写道:
> On 24/10/2022 23:51, Yinbo Zhu wrote:
>> Add the loongson2 soc guts driver binding with DT schema format
>> using json-schema.
>>
>> Signed-off-by: Yinbo Zhu <zhuyinbo@loongson.cn>
>> ---
>> .../soc/loongson/loongson,ls2k-guts.yaml | 37 +++++++++++++++++++
>
> Looks like wrong location, although difficult to judge because you did
> not describe the hardware at all. If this is chipinfo-like device, then
> Documentation/devicetree/bindings/hwinfo/.
My guts driver is refer fsl platform. It was was to manage and access
global utilities register block for SoC and it was only used in SoC
platform. when driver need use Soc ops to do some function the this
driver was needed. the dcfg (device config) was a function in guts
(global utilities) block.
For these type of driver, other platforms were initially placed on
Documentation/devicetree/bindings/arm/ if it is arm/arm64
architecture. Later, move it to the soc directory.
Documentation/devicetree/bindings/soc/fsl/fsl,layerscape-dcfg.yaml
So, do you still think it is inappropriate to place it in the soc dir?
>
>
>> MAINTAINERS | 1 +
>> 2 files changed, 38 insertions(+)
>> create mode 100644 Documentation/devicetree/bindings/soc/loongson/loongson,ls2k-guts.yaml
>>
>> diff --git a/Documentation/devicetree/bindings/soc/loongson/loongson,ls2k-guts.yaml b/Documentation/devicetree/bindings/soc/loongson/loongson,ls2k-guts.yaml
>> new file mode 100644
>> index 000000000000..2502f8aeb74d
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/soc/loongson/loongson,ls2k-guts.yaml
>> @@ -0,0 +1,37 @@
>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>> +%YAML 1.2
>> +---
>> +$id: http://devicetree.org/schemas/soc/loongson/loongson,ls2k-guts.yaml#
>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
>> +
>> +title: Loongson2 GUTS driver.
>
> Drop "driver." unless you refer to some hardware (like motor driver?).
this need refer hardware soc datasheet to gain soc register (global
utilities register block ).
so keep "driver" string that whether was more appropriate?
>
>> +
>> +maintainers:
>> + - Yinbo Zhu <zhuyinbo@loongson.cn>
>> +
>> +description: |
>> + GUTS driver was to manage and access global utilities block. Initially
>
> Drop "driver" and describe instead what is GUTS, including its acronym,
>
>> + only reading SVR and registering soc device are supported.
>
> Entire sentence describe Linux driver - drop it. Instead describe the
> device, the hardware.
>
>> +
>> +properties:
>> + compatible:
>> + const: loongson,ls2k-guts
>> +
>> + reg:
>> + maxItems: 1
>> +
>> + little-endian: true
>> +
>> +required:
>> + - compatible
>> + - reg
>> +
>> +additionalProperties: false
>> +
>> +examples:
>> + - |
>> + guts: guts@1fe00000 {
>
> Node names should be generic.
dcfg/scfg (device cfg/ soc cfg)was the key function of guts (global
utilities) block. and guts name I was refer fsl soc driver.
"drivers/soc/fsl/guts.c"
this binding file was follows of fsl guts.
Documentation/devicetree/bindings/soc/fsl/fsl,layerscape-dcfg.yaml
Documentation/devicetree/bindings/soc/fsl/fsl,layerscape-scfg.yaml
or, I was use scfg as node name, Do you think it's appropriate?
> https://devicetree-specification.readthedocs.io/en/latest/chapter2-devicetree-basics.html#generic-names-recommendation
>
>
> Best regards,
> Krzysztof
>
next prev parent reply other threads:[~2022-10-26 7:22 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-10-25 3:51 [PATCH v2 1/2] soc: loongson: add GUTS driver for loongson2 platforms Yinbo Zhu
2022-10-25 3:51 ` [PATCH v2 2/2] dt-bindings: soc: add loongson2 guts Yinbo Zhu
2022-10-25 19:40 ` Krzysztof Kozlowski
2022-10-26 7:22 ` Yinbo Zhu [this message]
2022-10-26 14:10 ` Krzysztof Kozlowski
2022-10-27 3:52 ` Yinbo Zhu
2022-10-27 12:56 ` Krzysztof Kozlowski
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=52de60bd-8aa5-a461-9bca-ce8e6f82ead8@loongson.cn \
--to=zhuyinbo@loongson.cn \
--cc=arnd@arndb.de \
--cc=briannorris@chromium.org \
--cc=conor.dooley@microchip.com \
--cc=devicetree@vger.kernel.org \
--cc=hasegawa-hitomi@fujitsu.com \
--cc=heiko@sntech.de \
--cc=krzysztof.kozlowski+dt@linaro.org \
--cc=krzysztof.kozlowski@linaro.org \
--cc=linus.walleij@linaro.org \
--cc=linux-kernel@vger.kernel.org \
--cc=lkundrak@v3.sk \
--cc=loongarch@lists.linux.dev \
--cc=marcan@marcan.st \
--cc=robh+dt@kernel.org \
--cc=sven@svenpeter.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®