2021-12-17 12:38:17

by Geert Uytterhoeven

[permalink] [raw]
Subject: [PATCH v3 0/2] dt-bindings: timer: sifive,clint: Miscellaneous improvements

Hi all,

This patch series contains two improvements for the SiFive CLINT DT
bindings.

Changes compared to v2[1]:
- Add Acked-by, Reviewed-by.

Changes compared to v1[2]:
- Split in two patches,
- Improve patch description and document limit rationale.

Thanks!

[1] https://lore.kernel.org/r/[email protected]
[2] https://lore.kernel.org/r/[email protected]


Geert Uytterhoeven (2):
dt-bindings: timer: sifive,clint: Fix number of interrupts
dt-bindings: timer: sifive,clint: Group interrupt tuples

.../devicetree/bindings/timer/sifive,clint.yaml | 9 +++++----
1 file changed, 5 insertions(+), 4 deletions(-)

--
2.25.1



2021-12-17 12:38:18

by Geert Uytterhoeven

[permalink] [raw]
Subject: [PATCH v3 1/2] dt-bindings: timer: sifive,clint: Fix number of interrupts

The number of interrupts lacks an upper bound, thus assuming one,
causing properly grouped "interrupts-extended" properties to be flagged
as an error by "make dtbs_check".

Fix this by adding the missing "maxItems". As the architectural maximum
is 4095 interrupts, using that as the limit would be unpractical. Hence
limit it to 10 interrupts (two interrupts for a system management core,
and two interrupts per core for other cores). This should be sufficient
for now, and the limit can always be increased when the need arises.

Signed-off-by: Geert Uytterhoeven <[email protected]>
Acked-by: Rob Herring <[email protected]>
---
v3:
- Add Acked-by,

v2:
- Split in two patches,
- Improve patch description and document limit rationale.
---
Documentation/devicetree/bindings/timer/sifive,clint.yaml | 1 +
1 file changed, 1 insertion(+)

diff --git a/Documentation/devicetree/bindings/timer/sifive,clint.yaml b/Documentation/devicetree/bindings/timer/sifive,clint.yaml
index 8d5f4687add9e81e..b75fd6f982b1ecb3 100644
--- a/Documentation/devicetree/bindings/timer/sifive,clint.yaml
+++ b/Documentation/devicetree/bindings/timer/sifive,clint.yaml
@@ -44,6 +44,7 @@ properties:

interrupts-extended:
minItems: 1
+ maxItems: 10

additionalProperties: false

--
2.25.1


2021-12-17 12:48:57

by Anup Patel

[permalink] [raw]
Subject: Re: [PATCH v3 1/2] dt-bindings: timer: sifive,clint: Fix number of interrupts

On Fri, Dec 17, 2021 at 6:08 PM Geert Uytterhoeven <[email protected]> wrote:
>
> The number of interrupts lacks an upper bound, thus assuming one,
> causing properly grouped "interrupts-extended" properties to be flagged
> as an error by "make dtbs_check".
>
> Fix this by adding the missing "maxItems". As the architectural maximum
> is 4095 interrupts, using that as the limit would be unpractical. Hence
> limit it to 10 interrupts (two interrupts for a system management core,
> and two interrupts per core for other cores). This should be sufficient
> for now, and the limit can always be increased when the need arises.

Same comment as the PLIC DT binding patch.

The "maxItems" should represent CLINT spec constraints so
please don't add any synthetic value here.

Regards,
Anup



>
> Signed-off-by: Geert Uytterhoeven <[email protected]>
> Acked-by: Rob Herring <[email protected]>
> ---
> v3:
> - Add Acked-by,
>
> v2:
> - Split in two patches,
> - Improve patch description and document limit rationale.
> ---
> Documentation/devicetree/bindings/timer/sifive,clint.yaml | 1 +
> 1 file changed, 1 insertion(+)
>
> diff --git a/Documentation/devicetree/bindings/timer/sifive,clint.yaml b/Documentation/devicetree/bindings/timer/sifive,clint.yaml
> index 8d5f4687add9e81e..b75fd6f982b1ecb3 100644
> --- a/Documentation/devicetree/bindings/timer/sifive,clint.yaml
> +++ b/Documentation/devicetree/bindings/timer/sifive,clint.yaml
> @@ -44,6 +44,7 @@ properties:
>
> interrupts-extended:
> minItems: 1
> + maxItems: 10
>
> additionalProperties: false
>
> --
> 2.25.1
>

2022-01-26 22:32:39

by Rob Herring

[permalink] [raw]
Subject: Re: [PATCH v3 1/2] dt-bindings: timer: sifive,clint: Fix number of interrupts

On Fri, Dec 17, 2021 at 6:48 AM Anup Patel <[email protected]> wrote:
>
> On Fri, Dec 17, 2021 at 6:08 PM Geert Uytterhoeven <[email protected]> wrote:
> >
> > The number of interrupts lacks an upper bound, thus assuming one,
> > causing properly grouped "interrupts-extended" properties to be flagged
> > as an error by "make dtbs_check".
> >
> > Fix this by adding the missing "maxItems". As the architectural maximum
> > is 4095 interrupts, using that as the limit would be unpractical. Hence
> > limit it to 10 interrupts (two interrupts for a system management core,
> > and two interrupts per core for other cores). This should be sufficient
> > for now, and the limit can always be increased when the need arises.
>
> Same comment as the PLIC DT binding patch.
>
> The "maxItems" should represent CLINT spec constraints so
> please don't add any synthetic value here.

I agree.

Geert, are you going to respin these?

Rob

2022-01-26 22:38:10

by Geert Uytterhoeven

[permalink] [raw]
Subject: Re: [PATCH v3 1/2] dt-bindings: timer: sifive,clint: Fix number of interrupts

Hi Rob,

On Wed, Jan 26, 2022 at 8:37 PM Rob Herring <[email protected]> wrote:
> On Fri, Dec 17, 2021 at 6:48 AM Anup Patel <[email protected]> wrote:
> > On Fri, Dec 17, 2021 at 6:08 PM Geert Uytterhoeven <[email protected]> wrote:
> > > The number of interrupts lacks an upper bound, thus assuming one,
> > > causing properly grouped "interrupts-extended" properties to be flagged
> > > as an error by "make dtbs_check".
> > >
> > > Fix this by adding the missing "maxItems". As the architectural maximum
> > > is 4095 interrupts, using that as the limit would be unpractical. Hence
> > > limit it to 10 interrupts (two interrupts for a system management core,
> > > and two interrupts per core for other cores). This should be sufficient
> > > for now, and the limit can always be increased when the need arises.
> >
> > Same comment as the PLIC DT binding patch.
> >
> > The "maxItems" should represent CLINT spec constraints so
> > please don't add any synthetic value here.
>
> I agree.
>
> Geert, are you going to respin these?

Sure, will do, now we have an agreement.

Gr{oetje,eeting}s,

Geert

--
Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- [email protected]

In personal conversations with technical people, I call myself a hacker. But
when I'm talking to journalists I just say "programmer" or something like that.
-- Linus Torvalds