Re: [RFC PATCH 1/3] ASoC: Add platforms directory

[Mark Brown]

On Wed, Dec 06, 2017 at 10:06:34AM -0600, Andrew F. Davis wrote:

> Your wording seems a bit inconsistent to me, what do you mean by "IP
> drivers", CODEC or SoC internal IP? For clarity I'll try to use only the
> three driver type labels: codec, platform, and machine. This is all in
> Documentation/sound/soc/overview.rst which I'm sure you are familiar
> with as you seem to have had a hand in writing it.

IPs in SoCs.

> Anyway, I'm working under the assumption that we should try to enforce a
> logical separation between component drivers: codec drivers should be
> agnostic to what machine they are placed, platform drivers should do the
> same and not make special arrangements to work with one machine in
> particular. Machine drivers on the other hand will need to dig into
> specifics of the codec and platform drivers that they use and connect.

Machine and drivers for SoC internal stuff tend to be bound fairly
closely together, simiarly the various drivers for an IP on a SoC often
know things about each other for various reasons.

> With this in mind I do not see any reason not to have platform drivers
> in a platforms/ directory just like we do with codecs/. In case there
> was any confusion, I still want to keep the platform drivers' files all
> grouped in directories by IP holder, just moved under this platforms/.

Moving everything around is at the very least going to be a pain for
anyone doing backports and anyone actively working on patches, splitting
the machine drivers from the rest of the drivers for systems based on
that SoC means it's going to be a little harder for people to find
relevant system specific machine drivers.  Generic machine drivers are
already split out.

Any benefits seem very weak here and it's an awfully disruptive change.

> This has the benefit of reducing exactly what you are talking about,
> platform drivers working in concert with machine drivers, instead of the
> other way around.

What I am saying is that they go together very closely.  Moving the code
around isn't going to change that.

> This isn't only confusing to me, but other first time ASoC devs:
> https://stackoverflow.com/questions/20110801/asoc-drivers-which-files-are-platform-machine-and-codec-drivers

I rather suspect the confusion they're having is more to do with the
fact that the documentation isn't very good than it is to do with where
the files are.

> even the answerer seems to assume there is a
> sound/soc/platforms/, for the same reason we have sound/soc/codecs/.

Or possibly just because they're not very familiar with what they're
talking about here.

> > If you want to make a common directory for TI stuff do that, there's no
> > need to mess up all the other platforms to do that though.

> Do you mean sounds/soc/ti/{platforms,machines}/ ? I could do this, but I
> don't see how what I've done in my example patches has any effect on
> other IP holders, they are free to migrate as the please.

Oh, right.  Your commit message sounded like you wanted to dump
everything into a single directory for all SoC side drivers which
doesn't seem like an obviously useful thing, my best guess had been that
you were trying to get all the TI drivers into one directory.  I don't
see a pressing need to do that, but I can see it might potentially be
causing issues for people.

If we were going to do this reshuffling then we *really* shouldn't be
doing it randomly for only a few vendors.  Doing it inconsistently is
not going to make anything clearer.

Attachment: signature.asc
Description: PGP signature