diff mbox series

[1/2] dt-bindings: spi: renesas,sh-msiof: Add r8a7742 support

Message ID 1591736054-568-2-git-send-email-prabhakar.mahadev-lad.rj@bp.renesas.com (mailing list archive)
State Accepted
Commit 6383b118efafff8cce8fc8fa5b7e893a523b698f
Headers show
Series Add MSIOF support for R8A7742 SOC | expand

Commit Message

Lad Prabhakar June 9, 2020, 8:54 p.m. UTC
Document RZ/G1H (R8A7742) SoC bindings.

Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
Reviewed-by: Marian-Cristian Rotariu <marian-cristian.rotariu.rb@bp.renesas.com>
---
 Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml | 1 +
 1 file changed, 1 insertion(+)

Comments

Geert Uytterhoeven June 10, 2020, 8:37 a.m. UTC | #1
On Tue, Jun 9, 2020 at 10:54 PM Lad Prabhakar
<prabhakar.mahadev-lad.rj@bp.renesas.com> wrote:
> Document RZ/G1H (R8A7742) SoC bindings.
>
> Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
> Reviewed-by: Marian-Cristian Rotariu <marian-cristian.rotariu.rb@bp.renesas.com>

Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>

Gr{oetje,eeting}s,

                        Geert
Mark Brown June 10, 2020, 11:08 a.m. UTC | #2
On Tue, Jun 09, 2020 at 09:54:13PM +0100, Lad Prabhakar wrote:
> Document RZ/G1H (R8A7742) SoC bindings.
> 
> Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
> Reviewed-by: Marian-Cristian Rotariu <marian-cristian.rotariu.rb@bp.renesas.com>
> ---
>  Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml | 1 +
>  1 file changed, 1 insertion(+)

To repeat my previous feedback I'd expect a driver update as well.
Geert Uytterhoeven June 10, 2020, 11:59 a.m. UTC | #3
Hi Mark,

On Wed, Jun 10, 2020 at 1:08 PM Mark Brown <broonie@kernel.org> wrote:
> On Tue, Jun 09, 2020 at 09:54:13PM +0100, Lad Prabhakar wrote:
> > Document RZ/G1H (R8A7742) SoC bindings.
> >
> > Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
> > Reviewed-by: Marian-Cristian Rotariu <marian-cristian.rotariu.rb@bp.renesas.com>
> > ---
> >  Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml | 1 +
> >  1 file changed, 1 insertion(+)
>
> To repeat my previous feedback I'd expect a driver update as well.

No driver update is needed.

Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml says:

  compatible:
    oneOf:
      - items:
          - enum:
             - renesas,msiof-r8a7742       # RZ/G1H
               ...
          - const: renesas,rcar-gen2-msiof  # generic R-Car Gen2 and RZ/G1
                                            # compatible device

drivers/spi/spi-sh-msiof.c matches against "renesas,rcar-gen2-msiof".

Gr{oetje,eeting}s,

                        Geert
Mark Brown June 10, 2020, 4:49 p.m. UTC | #4
On Wed, Jun 10, 2020 at 01:59:24PM +0200, Geert Uytterhoeven wrote:
> On Wed, Jun 10, 2020 at 1:08 PM Mark Brown <broonie@kernel.org> wrote:

> > To repeat my previous feedback I'd expect a driver update as well.

> No driver update is needed.

> Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml says:

I'm much more comfortable explicitly listing the new compatible so that
even if someone makes a DT that doesn't bother listing the fallbacks
things will work.
Geert Uytterhoeven June 10, 2020, 7:18 p.m. UTC | #5
Hi Mark,

On Wed, Jun 10, 2020 at 6:49 PM Mark Brown <broonie@kernel.org> wrote:
> On Wed, Jun 10, 2020 at 01:59:24PM +0200, Geert Uytterhoeven wrote:
> > On Wed, Jun 10, 2020 at 1:08 PM Mark Brown <broonie@kernel.org> wrote:
> > > To repeat my previous feedback I'd expect a driver update as well.
>
> > No driver update is needed.
>
> > Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml says:
>
> I'm much more comfortable explicitly listing the new compatible so that
> even if someone makes a DT that doesn't bother listing the fallbacks
> things will work.

Adding all of them would cause even more churn when adding support for
a new SoC... There are already more than 700 "renesas," compatible
values documented that are not directly matched by drivers.
Nowadays we have "make dtbs_check", so if a DTS doesn't conform to the
binding, it will be flagged.

Gr{oetje,eeting}s,

                        Geert
Mark Brown June 11, 2020, 8:50 a.m. UTC | #6
On Wed, Jun 10, 2020 at 09:18:19PM +0200, Geert Uytterhoeven wrote:
> On Wed, Jun 10, 2020 at 6:49 PM Mark Brown <broonie@kernel.org> wrote:

> > I'm much more comfortable explicitly listing the new compatible so that
> > even if someone makes a DT that doesn't bother listing the fallbacks
> > things will work.

> Adding all of them would cause even more churn when adding support for
> a new SoC... There are already more than 700 "renesas," compatible
> values documented that are not directly matched by drivers.

I'm not sure it's a particular concern, especially since you'll be
sending this stuff in the same series as a bindings update and an extra
patch in a series makes very little difference.

> Nowadays we have "make dtbs_check", so if a DTS doesn't conform to the
> binding, it will be flagged.

For things that are upstream.
Geert Uytterhoeven June 11, 2020, 12:09 p.m. UTC | #7
Hi Mark,

On Thu, Jun 11, 2020 at 10:50 AM Mark Brown <broonie@kernel.org> wrote:
> On Wed, Jun 10, 2020 at 09:18:19PM +0200, Geert Uytterhoeven wrote:
> > On Wed, Jun 10, 2020 at 6:49 PM Mark Brown <broonie@kernel.org> wrote:
>
> > > I'm much more comfortable explicitly listing the new compatible so that
> > > even if someone makes a DT that doesn't bother listing the fallbacks
> > > things will work.
>
> > Adding all of them would cause even more churn when adding support for
> > a new SoC... There are already more than 700 "renesas," compatible
> > values documented that are not directly matched by drivers.
>
> I'm not sure it's a particular concern, especially since you'll be
> sending this stuff in the same series as a bindings update and an extra
> patch in a series makes very little difference.

Until the DT bindings are split off into their own project...

Listing unneeded compatible values in drivers also increases binary size.
For RSPI and MSIOF that would be +2.5 KiB each.  Times tens of drivers.

Considering the RSPI driver itself is only 9 KiB, and some RZ/A1 systems
are really memory-constrained, I think it's better to avoid that.

> > Nowadays we have "make dtbs_check", so if a DTS doesn't conform to the
> > binding, it will be flagged.
>
> For things that are upstream.

The DT bindings apply to out-of-tree DTS files, too ;-)
If they're not compliant, all odds are off.

Gr{oetje,eeting}s,

                        Geert
Mark Brown June 16, 2020, 11:03 a.m. UTC | #8
On Thu, Jun 11, 2020 at 02:09:54PM +0200, Geert Uytterhoeven wrote:
> On Thu, Jun 11, 2020 at 10:50 AM Mark Brown <broonie@kernel.org> wrote:

> > I'm not sure it's a particular concern, especially since you'll be
> > sending this stuff in the same series as a bindings update and an extra
> > patch in a series makes very little difference.

> Until the DT bindings are split off into their own project...
> Listing unneeded compatible values in drivers also increases binary size.
> For RSPI and MSIOF that would be +2.5 KiB each.  Times tens of drivers.

> Considering the RSPI driver itself is only 9 KiB, and some RZ/A1 systems
> are really memory-constrained, I think it's better to avoid that.

That is an issue, though I can't help wondering if space constrained
systems could use some sort of automatic compaction of the ID tables
during install.  We're also bloating their DTs by adding fallbacks of
course!

> > > Nowadays we have "make dtbs_check", so if a DTS doesn't conform to the
> > > binding, it will be flagged.

> > For things that are upstream.

> The DT bindings apply to out-of-tree DTS files, too ;-)
> If they're not compliant, all odds are off.

The point here is to improve robustness and make the interface less
fragile.
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml b/Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml
index b6c1dd2..910be66 100644
--- a/Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml
+++ b/Documentation/devicetree/bindings/spi/renesas,sh-msiof.yaml
@@ -21,6 +21,7 @@  properties:
                                             # device
       - items:
           - enum:
+              - renesas,msiof-r8a7742       # RZ/G1H
               - renesas,msiof-r8a7743       # RZ/G1M
               - renesas,msiof-r8a7744       # RZ/G1N
               - renesas,msiof-r8a7745       # RZ/G1E