lkml.org 
[lkml]   [2020]   [Mar]   [18]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
From
SubjectRe: [PATCH v4 3/9] drivers: base: add linear ranges helpers
Date
Hello Greg,

On Wed, 2020-03-18 at 14:08 +0100, Greg Kroah-Hartman wrote:
> On Tue, Feb 25, 2020 at 10:53:01AM +0200, Matti Vaittinen wrote:
> > Many devices have control registers which control some measurable
> > property. Often a register contains control field so that change in
> > this field causes linear change in the controlled property. It is
> > not
> > a rare case that user wants to give 'meaningful' control values and
> > driver needs to convert them to register field values. Even more
> > often user wants to 'see' the currently set value - again in
> > meaningful units - and driver needs to convert the values it reads
> > from register to these meaningful units. Examples of this include:
> >
> > - regulators, voltage/current configurations
> > - power, voltage/current configurations
> > - clk(?) NCOs
> >
> > and maybe others I can't think of right now.
> >
> > Provide a linear_range helper which can do conversion from user
> > value
> > to register value 'selector'.
> >
> > The idea here is stolen from regulator framework and patches
> > refactoring
> > the regulator helpers to use this are following.
> >
> > Signed-off-by: Matti Vaittinen <matti.vaittinen@fi.rohmeurope.com>
> > ---
> >
> > Changes since rfc-v3:
> > - Kerneldoc fixes
> > - Corrected commit message typo meaningfull => meaningful
> >
> > drivers/base/Kconfig | 3 +
> > drivers/base/Makefile | 1 +
> > drivers/base/linear_ranges.c | 246
> > +++++++++++++++++++++++++++++++++++
>
> Why in drivers/base/ ?
>
> Why not in lib/ ?

I was pondering which of these would be better. I decided to do with
drivers/base because - in it's current form - this is really a driver
related stuff. I see it somehow in same position as regmap code -
although this is just a tiny helper compared to regmap. But this also
has pretty driver specific audience :)

And... I must admit I like things which I know. And I have been doing
driver development and "know" a few of the driver related colleagues -
hence working with them is easier for me ;) Getting to know the
colleagues maintaining lib is a bit scary :] Yep, I'm Finnish if you
happen to wonder why getting to know people is scary xD

>
> > include/linux/linear_range.h | 48 +++++++
> > 4 files changed, 298 insertions(+)
> > create mode 100644 drivers/base/linear_ranges.c
> > create mode 100644 include/linux/linear_range.h
> >
> > diff --git a/drivers/base/Kconfig b/drivers/base/Kconfig
> > index 5f0bc74d2409..636b6fa8e499 100644
> > --- a/drivers/base/Kconfig
> > +++ b/drivers/base/Kconfig
> > @@ -209,4 +209,7 @@ config GENERIC_ARCH_TOPOLOGY
> > appropriate scaling, sysfs interface for reading capacity
> > values at
> > runtime.
> >
> > +config LINEAR_RANGES
> > + tristate
>
> No help text at all???

Yes. The linear ranges has no meaning to be enabled alone. It only
plays a role if it is used by some driver/subsystem. And
drivers/subsystems should do
select LINEAR_RANGES. So showing help in any config tool is not needed.
This should actually not be visible in menuconfig or others. I think I
have seen a few examples like this.

Ayways, I have no obejctions to adding some text if absolutely needed.
Any suggestions for a text politely saying - "please, pretend I am not
here" - are welcome :) (Although, I think this really does not need
help text).

>
> > +EXPORT_SYMBOL(linear_range_values_in_range);
>
> EXPORT_SYMBOL_GPL() for all of these? I have to ask...

I personally have no objections towards EXPORT_SYMBOL_GPL. I guess
regulator helpers and the power supply modules which use this are GPL
modules. If no other (better) opinions, then I can change this in next
version. Thanks for pointing it out - I didn't even think about it.

>
> > @@ -0,0 +1,48 @@
> > +/* SPDX-License-Identifier: GPL-2.0-or-later */
>
> Are you sure about the "or later"? Again, I have to ask.

No. If you want to educate me on this topic - or point a link to some
nice explanation why to not use "later" - pretty please. I would like
to learn :)

>
> > +/* Copyright (C) 2020 ROHM Semiconductors */
> > +
> > +#ifndef LINEAR_RANGE_H
> > +#define LINEAR_RANGE_H
> > +
> > +#include <linux/types.h>
>
> Why is this needed?

I think it was the bool type which was missing without this. At least
on my ARM gcc toolchain.

Best Regards
Matti Vaittinen
\
 
 \ /
  Last update: 2020-03-18 14:43    [W:0.077 / U:1.868 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site