Re: [PATCH 3/3] spi: apple: Add driver for Apple SPI controller

On 14/12/2021 00.56, Mark Brown wrote:

On Mon, Dec 13, 2021 at 12:50:49PM +0900, Hector Martin wrote:

quoted

On 13/12/2021 08.41, Mark Brown wrote:

quoted

On Sun, Dec 12, 2021 at 12:47:26PM +0900, Hector Martin wrote:

quoted

quoted

quoted

@@ -0,0 +1,566 @@
+// SPDX-License-Identifier: GPL-2.0
+/*
+ * Apple SoC SPI device driver
+ *

quoted

quoted

Please keep the entire comment a C++ one so things look more
intentional.

quoted

I thought this pattern was pretty much the standard style.

It's common, especially given all the automated conversions, but ugly.

Sure, I'll change it if you insist :)

quoted

quoted

Some brackets or an intermediate variable wouldn't hurt here, especially
given the line length.

quoted

How about this?

quoted

return (200000 * t->bits_per_word * APPLE_SPI_FIFO_DEPTH / 2) <= t->speed_hz;

That's better but it's still a very long line which is half the issue.

I think it's quite readable at this point (especially with the comment 
above explaining it anyway). Note that these days a lot of people 
consider lines up to 100 chars okay in the kernel, and checkpatch uses 
that limit. Do you have a specific change in mind?

quoted

quoted

quoted

+static const struct of_device_id apple_spi_of_match[] = {
+	{ .compatible = "apple,spi", },
+	{}
+};
+MODULE_DEVICE_TABLE(of, apple_spi_of_match);

quoted

quoted

This is an awfully generic compatible.  It's common to use the SoC name
for the IP compatibles when they're not otherwise identified?

quoted

Apple like to keep blocks compatible across SoC generations - I think this
one dates, at least to some extent, to the original iPhone or thereabouts.
We do use per-SoC compatibles in the DTs in case we need to throw in per-SoC
quirks in the future ("apple,t8103-spi", "apple,spi"), but for drivers like
this we prefer to use generic compatibles as long as backwards compatibility
doesn't break. If Apple do something totally incompatible (like they did
with AIC2 in the latest chips), we'll bump to something like apple,spi2.
This happens quite rarely, so it makes sense to just keep things generic
except for these instances. That way old kernels will happily bind to the
block in newer SoCs if it is compatible.

There's currently a bit of a fashion for people with very old SPI blocks
to make incompatible new versions recently, a lot of it seems to be
driven by things like flash engine support.  Sometimes these things end
up getting instantiated together as they have different purposes and the
incompatibilties make the IPs larger.

I think if they haven't changed it by now they probably won't; e.g. they 
tacked on DMA using a coprocessor instead of changing the block itself. 
I don't think Apple uses SPI for anything performance-critical. They 
don't even bother with QSPI for the NOR flash (which is mostly only used 
for bootloaders and variable storage).

quoted

If we had a detailed lineage of what SoCs used what blocks and when things
changed we could try something else, like using the first SoC where the
specific block version was introduced, but we don't... so I think it makes
sense to just go with generic ones where we don't think things have changed
much since the dark ages. FWIW, Apple calls this one spi-1,spimc and claims
"spi-version = 1" and the driver has Samsung in the name... so the history
of this block definitely goes back quite a ways :-)

Have you done a contrast and compare with the Samsung driver?  Given
both this and your comments above about this dating back to the original
iPhone...

You mean the *two* Samsung drivers? :-)

It seems Samsung like to keep making up incompatible SPI blocks. This 
one shares a *few* bits in a *couple* registers with spi-s3c24xx driver, 
which point to a common lineage, but those registers aren't even at the 
same addresses. Not enough in common for it to make sense to try to use 
one driver for both (unlike with UART, where it was close enough to be 
added as a new Samsung UART variant, or I2C, where we could refactor the 
pasemi driver to add a platform backend alongside the existing PCI 
support and mostly use it as-is).

-- 
Hector Martin (marcan@marcan.st)
Public Key: https://mrcn.st/pub