[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <CABgxDoKaVip=T5=s2Gd8qpX15cLD=_0TZtQoNodK1CCf+GTYZw@mail.gmail.com>
Date: Mon, 22 May 2023 13:27:21 +0200
From: Romain Perier <romain.perier@...il.com>
To: Krzysztof Kozlowski <krzk@...nel.org>
Cc: Alessandro Zummo <a.zummo@...ertech.it>,
Alexandre Belloni <alexandre.belloni@...tlin.com>,
Daniel Palmer <daniel@...f.com>,
Rob Herring <robh+dt@...nel.org>, linux-rtc@...r.kernel.org,
devicetree@...r.kernel.org, linux-kernel@...r.kernel.org,
linux-arm-kernel@...ts.infradead.org
Subject: Re: [PATCH 2/3] dt-bindings: rtc: Add Mstar SSD20xD RTC devicetree
bindings documentation
Le jeu. 18 mai 2023 à 10:24, Krzysztof Kozlowski <krzk@...nel.org> a écrit :
>
> On 17/05/2023 16:41, Romain Perier wrote:
> > This adds the documentation for the devicetree bindings of the Mstar
> > SSD20xD RTC driver.
> >
>
> Please use scripts/get_maintainers.pl to get a list of necessary people
> and lists to CC. It might happen, that command when run on an older
> kernel, gives you outdated entries. Therefore please be sure you base
> your patches on recent Linux kernel.
Hi,
This is usually what I do for all patches series, but possible I have
missed some person
>
> A nit, subject: drop second/last, redundant "devicetree bindings
> documentation". The "dt-bindings" prefix is already stating that these
> are bindings. You actually repeated everything...
Originally, it was just to write a simple sentence with words... it
gives context, you know...
Like here: https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/commit/?id=7647204c2e81b28b4a7c4eec7d539f998d48eaf0
or here: https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git/commit/?id=dd49cbedde8a0f1e0d09698f9cad791d37a8e03e
But honestly, I don't want to debate about this, yes I can remove
redundant "devicetree bindings documentation" ^^
>
> > Signed-off-by: Romain Perier <romain.perier@...il.com>
> > ---
> > .../bindings/rtc/mstar,ssd20xd-rtc.yaml | 37 +++++++++++++++++++
> > 1 file changed, 37 insertions(+)
> > create mode 100644 Documentation/devicetree/bindings/rtc/mstar,ssd20xd-rtc.yaml
> >
> > diff --git a/Documentation/devicetree/bindings/rtc/mstar,ssd20xd-rtc.yaml b/Documentation/devicetree/bindings/rtc/mstar,ssd20xd-rtc.yaml
> > new file mode 100644
> > index 000000000000..2acd86cce69f
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/rtc/mstar,ssd20xd-rtc.yaml
> > @@ -0,0 +1,37 @@
> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > +%YAML 1.2
> > +---
> > +$id: http://devicetree.org/schemas/rtc/mstar,ssd20xd-rtc.yaml#
> > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > +
> > +title: Mstar SSD20xD RTC
> > +
> > +allOf:
> > + - $ref: rtc.yaml#
>
> This goes just above properties:
>
ack
> > +
> > +maintainers:
> > + - Daniel Palmer <daniel@...f.com>
> > + - Romain Perier <romain.perier@...il.com>
> > +
> > +properties:
> > + compatible:
> > + enum:
> > + - mstar,ssd20xd-rtc
>
> Why rtc suffix? Can it be anything else?
Well, it is the dt-bindings for an RTC block ? suppose tomorrow we
have an ethernet block specific to the SoC SSD202D, it should be
"mstar,ssd202d-ethernet" , how do you make
the difference if you just put "mstar,sd202d" ? Plus a lot of rtc
dt-bindings have this suffix (when it is not an IP name). This is
exactly the case for rtc-msc313e and it was not an issue.
>
> Missing blank line
ack
>
> > + reg:
> > + maxItems: 1
> > +
> > + start-year: true
>
> Drop
>
> What about interrupt line?
There is currently no interrupt right now, we have not yet the irqchip
code for handling the alarm irq of this rtc block.
>
> > +
> > +required:
> > + - compatible
> > + - reg
> > +
> > +additionalProperties: false
>
> instead
> unevaluatedProperties: false
ack
Thanks,
Romain
Powered by blists - more mailing lists