[<prev] [next>] [<thread-prev] [day] [month] [year] [list]
Message-ID: <aLW0rgvKno3zpXDi@pie>
Date: Mon, 1 Sep 2025 14:58:54 +0000
From: Yao Zi <ziyao@...root.org>
To: Huacai Chen <chenhuacai@...nel.org>
Cc: Yinbo Zhu <zhuyinbo@...ngson.cn>,
Linus Walleij <linus.walleij@...aro.org>,
Bartosz Golaszewski <brgl@...ev.pl>, Rob Herring <robh@...nel.org>,
Krzysztof Kozlowski <krzk+dt@...nel.org>,
Conor Dooley <conor+dt@...nel.org>, WANG Xuerui <kernel@...0n.name>,
Philipp Zabel <p.zabel@...gutronix.de>, linux-gpio@...r.kernel.org,
devicetree@...r.kernel.org, linux-kernel@...r.kernel.org,
loongarch@...ts.linux.dev, Mingcong Bai <jeffbai@...c.io>,
Kexy Biscuit <kexybiscuit@...c.io>,
Krzysztof Kozlowski <krzysztof.kozlowski@...aro.org>
Subject: Re: [PATCH v2 1/3] dt-bindings: gpio: loongson: Document GPIO
controller of 2K0300 SoC
On Mon, Sep 01, 2025 at 10:22:04PM +0800, Huacai Chen wrote:
> Hi, Yao,
>
> On Mon, Sep 1, 2025 at 9:38 PM Yao Zi <ziyao@...root.org> wrote:
> >
> > Loongson 2K0300 ships a GPIO controller whose input/output control logic
> > is similar to previous generation of SoCs. Additionally, it acts as an
> > interrupt-controller supporting both level and edge interrupts and has a
> > distinct reset signal.
> >
> > Describe its compatible in devicetree. We enlarge the maximum value of
> > ngpios to 128, since the controller technically supports at most 128
> > pins, although only 106 are routed out of the package. Properties for
> > interrupt-controllers and resets are introduced and limited as 2K0300
> > only.
> Replace the full name with "Loongson-2K0300" and short name with
> "LS2K0300", others look good to me.
> Reviewed-by: Huacai Chen <chenhuacai@...ngson.cn>
I don't understand what is improved with this. For the fullname, I don't
see any difference between "Loongson 2K0300" and "Loongson-2K0300". And
for the short one, omitting the "LS" prefix doesn't introduce any
ambiguity, either.
I did a quick search through git log, and found many commits for Loongson
2K SoCs do include a hyphen for the fullname and "LS" prefix for
abbreviation in messages, while some merge commits don't do so.
Even the official production page for Loongson 2K0300 refers to it
without a hyphen[1]. Thus I cannot find out of the point of rewording...
> Loongson 2K0300 is a multi-function SoC build upon the LA264 processor
> core, ...
I'll appreciate and adapt it if you could explain why the change is
necessary. Thanks for your patience.
Best regards,
Yao Zi
[1]: https://loongson.cn/EN/product/show?id=35
> >
> > Signed-off-by: Yao Zi <ziyao@...root.org>
> > Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@...aro.org>
> > ---
> > .../bindings/gpio/loongson,ls-gpio.yaml | 28 ++++++++++++++++++-
> > 1 file changed, 27 insertions(+), 1 deletion(-)
> >
> > diff --git a/Documentation/devicetree/bindings/gpio/loongson,ls-gpio.yaml b/Documentation/devicetree/bindings/gpio/loongson,ls-gpio.yaml
> > index b68159600e2b..69852444df23 100644
> > --- a/Documentation/devicetree/bindings/gpio/loongson,ls-gpio.yaml
> > +++ b/Documentation/devicetree/bindings/gpio/loongson,ls-gpio.yaml
> > @@ -14,6 +14,7 @@ properties:
> > oneOf:
> > - enum:
> > - loongson,ls2k-gpio
> > + - loongson,ls2k0300-gpio
> > - loongson,ls2k0500-gpio0
> > - loongson,ls2k0500-gpio1
> > - loongson,ls2k2000-gpio0
> > @@ -36,7 +37,7 @@ properties:
> >
> > ngpios:
> > minimum: 1
> > - maximum: 64
> > + maximum: 128
> >
> > "#gpio-cells":
> > const: 2
> > @@ -49,6 +50,14 @@ properties:
> > minItems: 1
> > maxItems: 64
> >
> > + "#interrupt-cells":
> > + const: 2
> > +
> > + interrupt-controller: true
> > +
> > + resets:
> > + maxItems: 1
> > +
> > required:
> > - compatible
> > - reg
> > @@ -58,6 +67,23 @@ required:
> > - gpio-ranges
> > - interrupts
> >
> > +allOf:
> > + - if:
> > + properties:
> > + compatible:
> > + contains:
> > + const: loongson,ls2k0300-gpio
> > + then:
> > + required:
> > + - "#interrupt-cells"
> > + - interrupt-controller
> > + - resets
> > + else:
> > + properties:
> > + "#interrupts-cells": false
> > + interrupt-controller: false
> > + resets: false
> > +
> > additionalProperties: false
> >
> > examples:
> > --
> > 2.50.1
> >
> >
>
Powered by blists - more mailing lists