Re: [PATCH v4 1/4] HID: i2c-hid: Reorganize so ACPI and OF are subclasses
Hi,
On Mon, Nov 9, 2020 at 6:44 AM Hans de Goede wrote:
>
> Hi,
>
> On 11/9/20 3:29 PM, Benjamin Tissoires wrote:
> > Hi,
> >
> > sorry for the delay. I have been heavily sidetracked and have a bunch
> > of internal deadlines coming in :/
> >
> > On Mon, Nov 9, 2020 at 12:24 PM Hans de Goede wrote:
> >>
> >> Hi,
> >>
> >> On 11/4/20 5:06 PM, Doug Anderson wrote:
> >>> Hi,
> >>>
> >>> On Wed, Nov 4, 2020 at 4:07 AM Hans de Goede wrote:
>
> > +#include "i2c-hid.h"
> > +
> > +struct i2c_hid_acpi {
> > + struct i2chid_subclass_data subclass;
>
> This feels a bit weird, we are the subclass so typically we would
> be embedding a base_class data struct here ...
>
> (more remarks below, note just my 2 cents you may want to wait
> for feedback from others).
>
> > + struct i2c_client *client;
>
> You pass this to i2c_hid_core_probe which then stores it own
> copy, why not just store it in the subclass (or even better
> baseclass) data struct ?
> >>>
> >>> My goal was to avoid moving the big structure to the header file.
> >>> Without doing that, I think you need something more like the setup I
> >>> have. I'll wait for Benjamin to comment on whether he'd prefer
> >>> something like what I have here or if I should move the structure.
> >>
> >> Ok, if Benjamin decides to keep things this way, can you consider
> >> renaming i2chid_subclass_data to i2chid_ops ?
> >>
> >> It just feels weird to have a struct with subclass in the name
> >> embedded inside as a member in another struct, usualy the kobject model
> >> works by having the the parent/base-class struct embedded inside
> >> the subclass data struct.
> >>
> >> This also avoids the need for a callback_priv_data pointer to the ops,
> >> as the ops get a pointer to the baseclass data struct as argument and
> >> you can then use container_of to get your own subclassdata struct
> >> since that encapsulates (contains) the baseclass struct.
> >>
> >> Note the dropping of the callback_priv_data pointer only works if you
> >> do move the entire struct to the header.
> >
> > I am not sure my opinion is the best in this case. However, the one
> > thing I'd like us to do is knowing which use cases we are solving, and
> > this should hopefully help us finding the best approach:
> >
> > - use case 1: fully upstream driver (like this one)
> >-> the OEM sets up the DT associated with the embedded devices
> >-> the kernel is compiled with the proper flags/configs
> > -> the device works out of the box (yay!)
> >
> > - use case 2: tinkerer in a garage
> > -> assembly of a generic SoC + Goodix v-next panel (that needs
> > modifications in the driver)
> > -> use of a generic (arm?) distribution
> > -> the user compiles the new (changed) goodix driver
> > -> the DT is populated (with overloads)
> > -> the device works
> > -> do we want to keep compatibility across kernel versions (not
> > recompile the custom module)
> >
> > - use case 3: Google fixed kernel
> > -> the kernel is built once for all platforms
> > -> OEMs can recompile a few drivers if they need, but can not touch
> > the core system
> > -> DT/goodix specific drivers are embedded
> > -> device works
> > -> do we want compatibility across major versions, and how "nice" we
> > want to be with OEM?
> >
> > I understand that use case 2 should in the end become use case 1, but
> > having a possibility for casual/enthusiasts developers to fix their
> > hardware is always nice.
> >
> > So to me, having the base struct in an external header means we are
> > adding a lot of ABI and putting a lot more weight to case 1.
> >
> > Personally, I am not that much in favour of being too strict and I
> > think we also want to help these external drivers. It is true that
> > i2c-hid should be relatively stable from now on, but we can never
> > predict the future, so maybe the external header is not so much a good
> > thing (for me).
> >
> > Anyway, if we were to extract the base struct, we would need to
> > provide allocators to be able to keep forward compatibility (I think).
> >
> > Does that help a bit?
> >
> > [mode bikeshedding on]
> > And to go back to Hans' suggestion, I really prefer i2chid_ops. This
> > whole architecture makes me think of a bus, not a subclass hierarchy.
> > In the same way we have the hid bus, we could have the i2c-hid bus,
> > with separate drivers in it (acpi, of, goodix).
> >
> > Note that I don't want the i2c-hid to be converted into an actual bus,
> > but just rely on the concepts.
> > [bikeshedding off]
>
> Ok, so TL;DR: keep as is but rename subclass to i2chid_ops. That works
> for me.
Done in v5.
> > @@ -156,10 +152,10 @@ struct i2c_hid {
> >
> > wait_queue_head_t wait; /* For waiting the
> > interrupt */
> >
> > - struct i2c_hid_platform_data pdata;
> > -
> > boolirq_wake_enabled;
> >
Re: [PATCH v4 1/4] HID: i2c-hid: Reorganize so ACPI and OF are subclasses
Hi,
On 11/9/20 3:29 PM, Benjamin Tissoires wrote:
> Hi,
>
> sorry for the delay. I have been heavily sidetracked and have a bunch
> of internal deadlines coming in :/
>
> On Mon, Nov 9, 2020 at 12:24 PM Hans de Goede wrote:
>>
>> Hi,
>>
>> On 11/4/20 5:06 PM, Doug Anderson wrote:
>>> Hi,
>>>
>>> On Wed, Nov 4, 2020 at 4:07 AM Hans de Goede wrote:
> +#include "i2c-hid.h"
> +
> +struct i2c_hid_acpi {
> + struct i2chid_subclass_data subclass;
This feels a bit weird, we are the subclass so typically we would
be embedding a base_class data struct here ...
(more remarks below, note just my 2 cents you may want to wait
for feedback from others).
> + struct i2c_client *client;
You pass this to i2c_hid_core_probe which then stores it own
copy, why not just store it in the subclass (or even better
baseclass) data struct ?
>>>
>>> My goal was to avoid moving the big structure to the header file.
>>> Without doing that, I think you need something more like the setup I
>>> have. I'll wait for Benjamin to comment on whether he'd prefer
>>> something like what I have here or if I should move the structure.
>>
>> Ok, if Benjamin decides to keep things this way, can you consider
>> renaming i2chid_subclass_data to i2chid_ops ?
>>
>> It just feels weird to have a struct with subclass in the name
>> embedded inside as a member in another struct, usualy the kobject model
>> works by having the the parent/base-class struct embedded inside
>> the subclass data struct.
>>
>> This also avoids the need for a callback_priv_data pointer to the ops,
>> as the ops get a pointer to the baseclass data struct as argument and
>> you can then use container_of to get your own subclassdata struct
>> since that encapsulates (contains) the baseclass struct.
>>
>> Note the dropping of the callback_priv_data pointer only works if you
>> do move the entire struct to the header.
>
> I am not sure my opinion is the best in this case. However, the one
> thing I'd like us to do is knowing which use cases we are solving, and
> this should hopefully help us finding the best approach:
>
> - use case 1: fully upstream driver (like this one)
>-> the OEM sets up the DT associated with the embedded devices
>-> the kernel is compiled with the proper flags/configs
> -> the device works out of the box (yay!)
>
> - use case 2: tinkerer in a garage
> -> assembly of a generic SoC + Goodix v-next panel (that needs
> modifications in the driver)
> -> use of a generic (arm?) distribution
> -> the user compiles the new (changed) goodix driver
> -> the DT is populated (with overloads)
> -> the device works
> -> do we want to keep compatibility across kernel versions (not
> recompile the custom module)
>
> - use case 3: Google fixed kernel
> -> the kernel is built once for all platforms
> -> OEMs can recompile a few drivers if they need, but can not touch
> the core system
> -> DT/goodix specific drivers are embedded
> -> device works
> -> do we want compatibility across major versions, and how "nice" we
> want to be with OEM?
>
> I understand that use case 2 should in the end become use case 1, but
> having a possibility for casual/enthusiasts developers to fix their
> hardware is always nice.
>
> So to me, having the base struct in an external header means we are
> adding a lot of ABI and putting a lot more weight to case 1.
>
> Personally, I am not that much in favour of being too strict and I
> think we also want to help these external drivers. It is true that
> i2c-hid should be relatively stable from now on, but we can never
> predict the future, so maybe the external header is not so much a good
> thing (for me).
>
> Anyway, if we were to extract the base struct, we would need to
> provide allocators to be able to keep forward compatibility (I think).
>
> Does that help a bit?
>
> [mode bikeshedding on]
> And to go back to Hans' suggestion, I really prefer i2chid_ops. This
> whole architecture makes me think of a bus, not a subclass hierarchy.
> In the same way we have the hid bus, we could have the i2c-hid bus,
> with separate drivers in it (acpi, of, goodix).
>
> Note that I don't want the i2c-hid to be converted into an actual bus,
> but just rely on the concepts.
> [bikeshedding off]
Ok, so TL;DR: keep as is but rename subclass to i2chid_ops. That works
for me.
> @@ -156,10 +152,10 @@ struct i2c_hid {
>
> wait_queue_head_t wait; /* For waiting the
> interrupt */
>
> - struct i2c_hid_platform_data pdata;
> -
> boolirq_wake_enabled;
> struct mutexreset_lock;
> +
> + struct i2chid_subclass_data *subclass;
> };
Personally, I would do things a bit differently here:
1. Just add the
int (*power_up_device)(struct i2chid_subclass_data *subclass);
void
Re: [PATCH v4 1/4] HID: i2c-hid: Reorganize so ACPI and OF are subclasses
Hi,
sorry for the delay. I have been heavily sidetracked and have a bunch
of internal deadlines coming in :/
On Mon, Nov 9, 2020 at 12:24 PM Hans de Goede wrote:
>
> Hi,
>
> On 11/4/20 5:06 PM, Doug Anderson wrote:
> > Hi,
> >
> > On Wed, Nov 4, 2020 at 4:07 AM Hans de Goede wrote:
> >>
> >>> +#include "i2c-hid.h"
> >>> +
> >>> +struct i2c_hid_acpi {
> >>> + struct i2chid_subclass_data subclass;
> >>
> >> This feels a bit weird, we are the subclass so typically we would
> >> be embedding a base_class data struct here ...
> >>
> >> (more remarks below, note just my 2 cents you may want to wait
> >> for feedback from others).
> >>
> >>> + struct i2c_client *client;
> >>
> >> You pass this to i2c_hid_core_probe which then stores it own
> >> copy, why not just store it in the subclass (or even better
> >> baseclass) data struct ?
> >
> > My goal was to avoid moving the big structure to the header file.
> > Without doing that, I think you need something more like the setup I
> > have. I'll wait for Benjamin to comment on whether he'd prefer
> > something like what I have here or if I should move the structure.
>
> Ok, if Benjamin decides to keep things this way, can you consider
> renaming i2chid_subclass_data to i2chid_ops ?
>
> It just feels weird to have a struct with subclass in the name
> embedded inside as a member in another struct, usualy the kobject model
> works by having the the parent/base-class struct embedded inside
> the subclass data struct.
>
> This also avoids the need for a callback_priv_data pointer to the ops,
> as the ops get a pointer to the baseclass data struct as argument and
> you can then use container_of to get your own subclassdata struct
> since that encapsulates (contains) the baseclass struct.
>
> Note the dropping of the callback_priv_data pointer only works if you
> do move the entire struct to the header.
I am not sure my opinion is the best in this case. However, the one
thing I'd like us to do is knowing which use cases we are solving, and
this should hopefully help us finding the best approach:
- use case 1: fully upstream driver (like this one)
-> the OEM sets up the DT associated with the embedded devices
-> the kernel is compiled with the proper flags/configs
-> the device works out of the box (yay!)
- use case 2: tinkerer in a garage
-> assembly of a generic SoC + Goodix v-next panel (that needs
modifications in the driver)
-> use of a generic (arm?) distribution
-> the user compiles the new (changed) goodix driver
-> the DT is populated (with overloads)
-> the device works
-> do we want to keep compatibility across kernel versions (not
recompile the custom module)
- use case 3: Google fixed kernel
-> the kernel is built once for all platforms
-> OEMs can recompile a few drivers if they need, but can not touch
the core system
-> DT/goodix specific drivers are embedded
-> device works
-> do we want compatibility across major versions, and how "nice" we
want to be with OEM?
I understand that use case 2 should in the end become use case 1, but
having a possibility for casual/enthusiasts developers to fix their
hardware is always nice.
So to me, having the base struct in an external header means we are
adding a lot of ABI and putting a lot more weight to case 1.
Personally, I am not that much in favour of being too strict and I
think we also want to help these external drivers. It is true that
i2c-hid should be relatively stable from now on, but we can never
predict the future, so maybe the external header is not so much a good
thing (for me).
Anyway, if we were to extract the base struct, we would need to
provide allocators to be able to keep forward compatibility (I think).
Does that help a bit?
[mode bikeshedding on]
And to go back to Hans' suggestion, I really prefer i2chid_ops. This
whole architecture makes me think of a bus, not a subclass hierarchy.
In the same way we have the hid bus, we could have the i2c-hid bus,
with separate drivers in it (acpi, of, goodix).
Note that I don't want the i2c-hid to be converted into an actual bus,
but just rely on the concepts.
[bikeshedding off]
>
>
>
> >
> >
> >>> @@ -156,10 +152,10 @@ struct i2c_hid {
> >>>
> >>> wait_queue_head_t wait; /* For waiting the
> >>> interrupt */
> >>>
> >>> - struct i2c_hid_platform_data pdata;
> >>> -
> >>> boolirq_wake_enabled;
> >>> struct mutexreset_lock;
> >>> +
> >>> + struct i2chid_subclass_data *subclass;
> >>> };
> >>
> >> Personally, I would do things a bit differently here:
> >>
> >> 1. Just add the
> >>
> >> int (*power_up_device)(struct i2chid_subclass_data *subclass);
> >> void (*power_down_device)(struct i2chid_subclass_data *subclass);
> >>
> >> members which you put in the subclass struct here.
> >>
> >> 2. Move the declaration of this complete struct to
> >> drivers/hid/i2c-hid/i2c-hid.h
> >> and use this as the base-class which I
Re: [PATCH v4 1/4] HID: i2c-hid: Reorganize so ACPI and OF are subclasses
Hi,
On 11/4/20 5:06 PM, Doug Anderson wrote:
> Hi,
>
> On Wed, Nov 4, 2020 at 4:07 AM Hans de Goede wrote:
>>
>>> +#include "i2c-hid.h"
>>> +
>>> +struct i2c_hid_acpi {
>>> + struct i2chid_subclass_data subclass;
>>
>> This feels a bit weird, we are the subclass so typically we would
>> be embedding a base_class data struct here ...
>>
>> (more remarks below, note just my 2 cents you may want to wait
>> for feedback from others).
>>
>>> + struct i2c_client *client;
>>
>> You pass this to i2c_hid_core_probe which then stores it own
>> copy, why not just store it in the subclass (or even better
>> baseclass) data struct ?
>
> My goal was to avoid moving the big structure to the header file.
> Without doing that, I think you need something more like the setup I
> have. I'll wait for Benjamin to comment on whether he'd prefer
> something like what I have here or if I should move the structure.
Ok, if Benjamin decides to keep things this way, can you consider
renaming i2chid_subclass_data to i2chid_ops ?
It just feels weird to have a struct with subclass in the name
embedded inside as a member in another struct, usualy the kobject model
works by having the the parent/base-class struct embedded inside
the subclass data struct.
This also avoids the need for a callback_priv_data pointer to the ops,
as the ops get a pointer to the baseclass data struct as argument and
you can then use container_of to get your own subclassdata struct
since that encapsulates (contains) the baseclass struct.
Note the dropping of the callback_priv_data pointer only works if you
do move the entire struct to the header.
>
>
>>> @@ -156,10 +152,10 @@ struct i2c_hid {
>>>
>>> wait_queue_head_t wait; /* For waiting the interrupt
>>> */
>>>
>>> - struct i2c_hid_platform_data pdata;
>>> -
>>> boolirq_wake_enabled;
>>> struct mutexreset_lock;
>>> +
>>> + struct i2chid_subclass_data *subclass;
>>> };
>>
>> Personally, I would do things a bit differently here:
>>
>> 1. Just add the
>>
>> int (*power_up_device)(struct i2chid_subclass_data *subclass);
>> void (*power_down_device)(struct i2chid_subclass_data *subclass);
>>
>> members which you put in the subclass struct here.
>>
>> 2. Move the declaration of this complete struct to
>> drivers/hid/i2c-hid/i2c-hid.h
>> and use this as the base-class which I described before (and store the client
>> pointer here).
>>
>> 3. And then kzalloc both this baseclass struct + the subclass-data
>> (only the bool "power_fixed" in the ACPI case) in one go in the subclass code
>> replacing 2 kzallocs (+ error checking with one, simplifying the code and
>> reducing memory fragmentation (by a tiny sliver).
>
> Sure, I'll do that if Benjamin likes moving the structure to the header.
>
>
>> About the power_*_device callbacks, I wonder if it would not be more
>> consistent
>> to also have a shutdown callback and make i2c_driver.shutdown point to
>> a (modified) i2c_hid_core_shutdown() function.
>
> Personally this doesn't seem cleaner to me, but I'm happy to do it if
> folks like it better. Coming up with a name for the callback would be
> a bit awkward, which is a sign that this isn't quite ideal? For the
> power_up()/power_down() those are sane concepts to abstract out. Here
> we'd be abstracting out "subclass_shutdown_tail()" or something?
> ...and if a subclass needs something at the head of shutdown, we'd
> need to add a "subclass_shutdown_head()"?
I have no real preference here either way.
>> You may also want to consider pointing that shutdown callback to the
>> power_off
>> function in the of case (in a separate commit as that is a behavioral
>> change).
>
> I don't think this is the point of shutdown, but I could be corrected.
> Shutdown isn't really supposed to be the same as driver remove or
> anything. IIUC the main point of shutdown is to support kexec and the
> goal is to quiesce DMA transactions. Turning off power has never been
> a requirement that I was aware of. We don't want to jam too much
> stuff in shutdown or else "shutdown" becomes as slow as boot for no
> good reason, right?
This sorta depends on if the regulators for the HID device are part of the
PMIC or not. If they are part of the PMIC then on shutdown they will
typically be turned off by the PMIC. But if they are separate they may
stay enabled on shutdown.
Anyways I again have no real preference here...
Regards,
Hans
>
>
>>> diff --git a/drivers/hid/i2c-hid/i2c-hid-of.c
>>> b/drivers/hid/i2c-hid/i2c-hid-of.c
>>> new file mode 100644
>>> index ..e1838cdef0aa
>>> --- /dev/null
>>> +++ b/drivers/hid/i2c-hid/i2c-hid-of.c
>>> @@ -0,0 +1,149 @@
>>> +/*
>>> + * HID over I2C Open Firmware Subclass
>>> + *
>>> + * Copyright (c) 2012 Benjamin Tissoires
>>> + * Copyright (c) 2012 Ecole Nationale de l'Aviation Civile, France
>>> + * Copyright (c) 2012 Red Hat, Inc
>>
>>
>>
>>>
Re: [PATCH v4 1/4] HID: i2c-hid: Reorganize so ACPI and OF are subclasses
Hi,
On Wed, Nov 4, 2020 at 4:07 AM Hans de Goede wrote:
>
> > +#include "i2c-hid.h"
> > +
> > +struct i2c_hid_acpi {
> > + struct i2chid_subclass_data subclass;
>
> This feels a bit weird, we are the subclass so typically we would
> be embedding a base_class data struct here ...
>
> (more remarks below, note just my 2 cents you may want to wait
> for feedback from others).
>
> > + struct i2c_client *client;
>
> You pass this to i2c_hid_core_probe which then stores it own
> copy, why not just store it in the subclass (or even better
> baseclass) data struct ?
My goal was to avoid moving the big structure to the header file.
Without doing that, I think you need something more like the setup I
have. I'll wait for Benjamin to comment on whether he'd prefer
something like what I have here or if I should move the structure.
> > @@ -156,10 +152,10 @@ struct i2c_hid {
> >
> > wait_queue_head_t wait; /* For waiting the interrupt
> > */
> >
> > - struct i2c_hid_platform_data pdata;
> > -
> > boolirq_wake_enabled;
> > struct mutexreset_lock;
> > +
> > + struct i2chid_subclass_data *subclass;
> > };
>
> Personally, I would do things a bit differently here:
>
> 1. Just add the
>
> int (*power_up_device)(struct i2chid_subclass_data *subclass);
> void (*power_down_device)(struct i2chid_subclass_data *subclass);
>
> members which you put in the subclass struct here.
>
> 2. Move the declaration of this complete struct to
> drivers/hid/i2c-hid/i2c-hid.h
> and use this as the base-class which I described before (and store the client
> pointer here).
>
> 3. And then kzalloc both this baseclass struct + the subclass-data
> (only the bool "power_fixed" in the ACPI case) in one go in the subclass code
> replacing 2 kzallocs (+ error checking with one, simplifying the code and
> reducing memory fragmentation (by a tiny sliver).
Sure, I'll do that if Benjamin likes moving the structure to the header.
> About the power_*_device callbacks, I wonder if it would not be more
> consistent
> to also have a shutdown callback and make i2c_driver.shutdown point to
> a (modified) i2c_hid_core_shutdown() function.
Personally this doesn't seem cleaner to me, but I'm happy to do it if
folks like it better. Coming up with a name for the callback would be
a bit awkward, which is a sign that this isn't quite ideal? For the
power_up()/power_down() those are sane concepts to abstract out. Here
we'd be abstracting out "subclass_shutdown_tail()" or something?
...and if a subclass needs something at the head of shutdown, we'd
need to add a "subclass_shutdown_head()"?
> You may also want to consider pointing that shutdown callback to the power_off
> function in the of case (in a separate commit as that is a behavioral change).
I don't think this is the point of shutdown, but I could be corrected.
Shutdown isn't really supposed to be the same as driver remove or
anything. IIUC the main point of shutdown is to support kexec and the
goal is to quiesce DMA transactions. Turning off power has never been
a requirement that I was aware of. We don't want to jam too much
stuff in shutdown or else "shutdown" becomes as slow as boot for no
good reason, right?
> > diff --git a/drivers/hid/i2c-hid/i2c-hid-of.c
> > b/drivers/hid/i2c-hid/i2c-hid-of.c
> > new file mode 100644
> > index ..e1838cdef0aa
> > --- /dev/null
> > +++ b/drivers/hid/i2c-hid/i2c-hid-of.c
> > @@ -0,0 +1,149 @@
> > +/*
> > + * HID over I2C Open Firmware Subclass
> > + *
> > + * Copyright (c) 2012 Benjamin Tissoires
> > + * Copyright (c) 2012 Ecole Nationale de l'Aviation Civile, France
> > + * Copyright (c) 2012 Red Hat, Inc
>
>
>
> > +MODULE_DESCRIPTION("HID over I2C OF driver");
> > +MODULE_AUTHOR("Benjamin Tissoires ");
>
> In case Benjamin misses this during his own review: I'm not sure if he
> will want to be set as AUTHOR of this, given that part of the plan is
> for someone else to be the primary point of contact for the of bits.
I can stick myself in as the author if needed. I'll wait for
Benjamin's feedback here.
-Doug
Re: [PATCH v4 1/4] HID: i2c-hid: Reorganize so ACPI and OF are subclasses
Hi,
On 11/4/20 2:29 AM, Douglas Anderson wrote:
> This patch rejiggers the i2c-hid code so that the OF (Device Tree) and
> ACPI support is separated out a bit. The OF and ACPI drivers are now
> effectively "subclasses" of the generic code.
>
> Essentially, what we're doing here:
> * Make "power up" and "power down" a virtual function that can be
> (optionally) implemented by subclasses.
> * Each subclass is a drive on its own, so it implements probe / remove
> / suspend / resume / shutdown. The core code provides
> implementations that the subclasses can call into, or fully use for
> their implementation if they don't have special needs.
>
> We'll organize this so that we now have 3 modules: the old i2c-hid
> module becomes the "core" module and two new modules will depend on
> it, handling probing the specific device.
>
> As part of this work, we'll remove the i2c-hid "platform data"
> concept since it's not needed.
>
> Signed-off-by: Douglas Anderson
Thank you for doing this, overall this looks pretty good to me.
Some small comments inline, not a full review.
> diff --git a/drivers/hid/i2c-hid/i2c-hid-acpi.c
> b/drivers/hid/i2c-hid/i2c-hid-acpi.c
> new file mode 100644
> index ..d4c29dc62297
> --- /dev/null
> +++ b/drivers/hid/i2c-hid/i2c-hid-acpi.c
> @@ -0,0 +1,167 @@
> +/*
> + * HID over I2C ACPI Subclass
> + *
> + * Copyright (c) 2012 Benjamin Tissoires
> + * Copyright (c) 2012 Ecole Nationale de l'Aviation Civile, France
> + * Copyright (c) 2012 Red Hat, Inc
> + *
> + * This code was forked out of the core code, which was partly based on
> + * "USB HID support for Linux":
> + *
> + * Copyright (c) 1999 Andreas Gal
> + * Copyright (c) 2000-2005 Vojtech Pavlik
> + * Copyright (c) 2005 Michael Haboustak for Concept2,
> Inc
> + * Copyright (c) 2007-2008 Oliver Neukum
> + * Copyright (c) 2006-2010 Jiri Kosina
> + *
> + * This file is subject to the terms and conditions of the GNU General Public
> + * License. See the file COPYING in the main directory of this archive for
> + * more details.
> + */
> +
> +#include
> +#include
> +#include
> +#include
> +#include
> +#include
> +
> +#include "i2c-hid.h"
> +
> +struct i2c_hid_acpi {
> + struct i2chid_subclass_data subclass;
This feels a bit weird, we are the subclass so typically we would
be embedding a base_class data struct here ...
(more remarks below, note just my 2 cents you may want to wait
for feedback from others).
> + struct i2c_client *client;
You pass this to i2c_hid_core_probe which then stores it own
copy, why not just store it in the subclass (or even better
baseclass) data struct ?
> + bool power_fixed;
> +};
> +
> +static const struct acpi_device_id i2c_hid_acpi_blacklist[] = {
> + /*
> + * The CHPN0001 ACPI device, which is used to describe the Chipone
> + * ICN8505 controller, has a _CID of PNP0C50 but is not HID compatible.
> + */
> + {"CHPN0001", 0 },
> + { },
> +};
> +
> +static int i2c_hid_acpi_get_descriptor(struct i2c_client *client)
> +{
> + static guid_t i2c_hid_guid =
> + GUID_INIT(0x3CDFF6F7, 0x4267, 0x4555,
> + 0xAD, 0x05, 0xB3, 0x0A, 0x3D, 0x89, 0x38, 0xDE);
> + union acpi_object *obj;
> + struct acpi_device *adev;
> + acpi_handle handle;
> + u16 hid_descriptor_address;
> +
> + handle = ACPI_HANDLE(>dev);
> + if (!handle || acpi_bus_get_device(handle, )) {
> + dev_err(>dev, "Error could not get ACPI device\n");
> + return -ENODEV;
> + }
> +
> + if (acpi_match_device_ids(adev, i2c_hid_acpi_blacklist) == 0)
> + return -ENODEV;
> +
> + obj = acpi_evaluate_dsm_typed(handle, _hid_guid, 1, 1, NULL,
> + ACPI_TYPE_INTEGER);
> + if (!obj) {
> + dev_err(>dev, "Error _DSM call to get HID descriptor
> address failed\n");
> + return -ENODEV;
> + }
> +
> + hid_descriptor_address = obj->integer.value;
> + ACPI_FREE(obj);
> +
> + return hid_descriptor_address;
> +}
> +
> +static int i2c_hid_acpi_power_up_device(struct i2chid_subclass_data
> *subclass)
> +{
> + struct i2c_hid_acpi *ihid_of =
> + container_of(subclass, struct i2c_hid_acpi, subclass);
> + struct device *dev = _of->client->dev;
> + struct acpi_device *adev;
> +
> + /* Only need to call acpi_device_fix_up_power() the first time */
> + if (ihid_of->power_fixed)
> + return 0;
> + ihid_of->power_fixed = true;
> +
> + adev = ACPI_COMPANION(dev);
> + if (adev)
> + acpi_device_fix_up_power(adev);
> +
> + return 0;
> +}
> +
> +int i2c_hid_acpi_probe(struct i2c_client *client,
> +const struct i2c_device_id *dev_id)
> +{
> + struct device *dev = >dev;
> + struct i2c_hid_acpi *ihid_acpi;
> + u16 hid_descriptor_address;
> + int ret;
> +
> + ihid_acpi = devm_kzalloc(>dev, sizeof(*ihid_acpi), GFP_KERNEL);
>
