Re: [PATCH v12 1/4] battery: Add the battery hooking API

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, Jan 3, 2018 at 1:58 PM, Ognjen Galic <smclt30p@xxxxxxxxx> wrote:
> This is a patch that implements a generic hooking API for the
> generic ACPI battery driver.
>
> With this new generic API, drivers can expose platform specific
> behaviour via sysfs attributes in /sys/class/power_supply/BATn/
> in a generic way.
>
> A perfect example of the need for this API are Lenovo ThinkPads.
>
> Lenovo ThinkPads have a ACPI extension that allows the setting of
> start and stop charge thresholds in the EC and battery firmware
> via ACPI. The thinkpad_acpi module can use this API to expose
> sysfs attributes that it controls inside the ACPI battery driver
> sysfs tree, under /sys/class/power_supply/BATN/.
>
> The file drivers/acpi/battery.h has been moved to
> include/acpi/battery.h and the includes inside ac.c, sbs.c, and
> battery.c have been adjusted to reflect that.
>
> When drivers hooks into the API, the API calls add_battery() for
> each battery in the system that passes it a acpi_battery
> struct. Then, the drivers can use device_create_file() to create
> new sysfs attributes with that struct and identify the batteries
> for per-battery attributes.

Thanks for an update. I have couple of minors. Otherwise look pretty much good!

>  drivers/acpi/battery.h |  11 ----
>  include/acpi/battery.h |  21 +++++++

There are -M and -C command line parameters to git format-patch.
They can take an optional argument (percentage) of threshold.

Playing with those numbers you can achieve

rename ...

line and see actual diff.

No need to resend because of this. Just an explanation for the future Git work.

> +void __battery_hook_unregister(struct acpi_battery_hook *hook, int lock)
> +{
> +       struct list_head *position;
> +       struct acpi_battery *battery;

Missed empty line?

> +       /*
> +        * In order to remove a hook, we first need to
> +        * de-register all the batteries that are registered.
> +        */
> +       if (lock)
> +               mutex_lock(&hook_mutex);

> +       list_for_each(position, &acpi_battery_list) {
> +               battery = list_entry(position, struct acpi_battery, list);

list_for_each_enrty() ?

Or I'm missing something why it can't be used?

> +               hook->remove_battery(battery->bat);
> +       }

> +void battery_hook_register(struct acpi_battery_hook *hook)
> +{
> +       struct acpi_battery *battery;

> +       list_for_each_entry(battery, &acpi_battery_list, list) {
> +               if (hook->add_battery(battery->bat)) {
> +                       /*
> +                        * If a add-battery returns non-zero,
> +                        * the registration of the extension has failed,
> +                        * and we will not add it to the list of loaded
> +                        * hooks.
> +                        */

> +                       pr_err("extension failed to load: %s",
> +                                       hook->name);

Can it fit 80 characters?
I mean if it would be one line...

> +                       __battery_hook_unregister(hook, 0);
> +                       return;
> +               }
> +       }
> +       pr_info("new extension: %s\n", hook->name);
> +       mutex_unlock(&hook_mutex);
> +}

> +static void battery_hook_add_battery(struct acpi_battery *battery)
> +{

> +       /*
> +        * This function gets called right after the battery sysfs
> +        * attributes have been added, so that the drivers that
> +        * define custom sysfs attributes can add their own.
> +        */

Perhaps it should go before function definition.

> +       struct acpi_battery_hook *hook_node;

> +}


> +static void __exit battery_hook_exit(void)
> +{
> +       struct acpi_battery_hook *hook;
> +       struct acpi_battery_hook *ptr;

Missed empty line?

> +       /*
> +        * At this point, the acpi_bus_unregister_driver
> +        * has called remove for all batteries. We just
> +        * need to remove the hooks.
> +        */

A common pattern to use func() [note parens] when refer to function.

> +       list_for_each_entry_safe(hook, ptr, &battery_hook_list, list) {
> +               __battery_hook_unregister(hook, 1);
> +       }
> +       mutex_destroy(&hook_mutex);
> +}

>         battery->bat = power_supply_register_no_ws(&battery->device->dev,
>                                 &battery->bat_desc, &psy_cfg);
>
> +       battery_hook_add_battery(battery);
> +
>         if (IS_ERR(battery->bat)) {
>                 int result = PTR_ERR(battery->bat);

I'm not sure why you need to add hook when power_supply_register_no_ws() failed.

>         }
> -
> +       battery_hook_remove_battery(battery);

No need to remove an empty line.

-- 
With Best Regards,
Andy Shevchenko



[Index of Archives]     [Linux Kernel Development]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Yosemite News]     [Linux Kernel]     [Linux SCSI]

  Powered by Linux