Commit 6c47a3e0 authored by Anton Vorontsov's avatar Anton Vorontsov

bq2415x_charger: Fix style issues

I hate doing these style fixups myself, but I also hate inconsitent code.
Normally I just ask to resubmit the patch with the issues fixed, but N900
is special: I have a selfish interest in it. :)
Signed-off-by: default avatarAnton Vorontsov <cbouatmailru@gmail.com>
parent 7ad85830
This diff is collapsed.
/* /*
bq2415x_charger.h - bq2415x charger driver * bq2415x charger driver
Copyright (C) 2011-2012 Pali Rohár <pali.rohar@gmail.com> *
* Copyright (C) 2011-2012 Pali Rohár <pali.rohar@gmail.com>
This program is free software; you can redistribute it and/or modify *
it under the terms of the GNU General Public License as published by * This program is free software; you can redistribute it and/or modify
the Free Software Foundation; either version 2 of the License, or * it under the terms of the GNU General Public License as published by
(at your option) any later version. * the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
This program is distributed in the hope that it will be useful, *
but WITHOUT ANY WARRANTY; without even the implied warranty of * This program is distributed in the hope that it will be useful,
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
You should have received a copy of the GNU General Public License along *
with this program; if not, write to the Free Software Foundation, Inc., * You should have received a copy of the GNU General Public License along
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. * with this program; if not, write to the Free Software Foundation, Inc.,
*/ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
#ifndef BQ2415X_CHARGER_H #ifndef BQ2415X_CHARGER_H
#define BQ2415X_CHARGER_H #define BQ2415X_CHARGER_H
/* /*
This is platform data for bq2415x chip. It contains default board voltages * This is platform data for bq2415x chip. It contains default board
and currents which can be also later configured via sysfs. If value is -1 * voltages and currents which can be also later configured via sysfs. If
then default chip value (specified in datasheet) will be used. * value is -1 then default chip value (specified in datasheet) will be
* used.
Value resistor_sense is needed for for configuring charge and termination *
current. It it is less or equal to zero, configuring charge and termination * Value resistor_sense is needed for for configuring charge and
current will not be possible. * termination current. It it is less or equal to zero, configuring charge
* and termination current will not be possible.
Function set_mode_hook is needed for automode (setting correct current limit *
when charger is connected/disconnected or setting boost mode). When is NULL, * Function set_mode_hook is needed for automode (setting correct current
automode function is disabled. When is not NULL, it must have this prototype: * limit when charger is connected/disconnected or setting boost mode).
* When is NULL, automode function is disabled. When is not NULL, it must
int (*set_mode_hook)( * have this prototype:
void (*hook)(enum bq2415x_mode mode, void *data), *
void *data) * int (*set_mode_hook)(
* void (*hook)(enum bq2415x_mode mode, void *data),
hook is hook function (see below) and data is pointer to driver private data * void *data)
*
bq2415x driver will call it as: * hook is hook function (see below) and data is pointer to driver private
* data
platform_data->set_mode_hook(bq2415x_hook_function, bq2415x_device); *
* bq2415x driver will call it as:
Board/platform function set_mode_hook return non zero value when hook *
function was successful registered. Platform code should call that hook * platform_data->set_mode_hook(bq2415x_hook_function, bq2415x_device);
function (which get from pointer, with data) every time when charger was *
connected/disconnected or require to enable boost mode. bq2415x driver then * Board/platform function set_mode_hook return non zero value when hook
will set correct current limit, enable/disable charger or boost mode. * function was successful registered. Platform code should call that hook
* function (which get from pointer, with data) every time when charger
Hook function has this prototype: * was connected/disconnected or require to enable boost mode. bq2415x
* driver then will set correct current limit, enable/disable charger or
void hook(enum bq2415x_mode mode, void *data); * boost mode.
*
mode is bq2415x mode (charger or boost) * Hook function has this prototype:
data is pointer to driver private data (which get from set_charger_type_hook) *
* void hook(enum bq2415x_mode mode, void *data);
When bq driver is being unloaded, it call function: *
* mode is bq2415x mode (charger or boost)
platform_data->set_mode_hook(NULL, NULL); * data is pointer to driver private data (which get from
* set_charger_type_hook)
(hook function and driver private data are NULL) *
* When bq driver is being unloaded, it call function:
After that board/platform code must not call driver hook function! It is *
possible that pointer to hook function will not be valid and calling will * platform_data->set_mode_hook(NULL, NULL);
cause undefined result. *
* (hook function and driver private data are NULL)
*/ *
* After that board/platform code must not call driver hook function! It
* is possible that pointer to hook function will not be valid and calling
* will cause undefined result.
*/
/* Supported modes with maximal current limit */ /* Supported modes with maximal current limit */
enum bq2415x_mode { enum bq2415x_mode {
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment