GitHub-Mirror/linux-bl808
2
0
Fork 0
mirror of https://github.com/Fishwaldo/linux-bl808.git synced 2025-03-30 19:07:15 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

extcon: Fix indentation coding style to improve readability

Browse source 
Signed-off-by: Chanwoo Choi <cw00.choi@samsung.com>
Signed-off-by: Myungjoo Ham <myungjoo.ham@samsung.com>
This commit is contained in:
Chanwoo Choi 2013-08-31 13:16:49 +09:00
parent a33411b26e
commit a75e1c73a4
5 changed files with 87 additions and 84 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
drivers/extcon/extcon-adc-jack.c
View file

@ -27,16 +27,16 @@
/** /**
* struct adc_jack_data - internal data for adc_jack device driver * struct adc_jack_data - internal data for adc_jack device driver
* @edev - extcon device. * @edev: extcon device.
* @cable_names - list of supported cables. * @cable_names: list of supported cables.
* @num_cables - size of cable_names. * @num_cables: size of cable_names.
* @adc_conditions - list of adc value conditions. * @adc_conditions: list of adc value conditions.
* @num_conditions - size of adc_conditions. * @num_conditions: size of adc_conditions.
* @irq - irq number of attach/detach event (0 if not exist). * @irq: irq number of attach/detach event (0 if not exist).
* @handling_delay - interrupt handler will schedule extcon event * @handling_delay: interrupt handler will schedule extcon event
* handling at handling_delay jiffies. * handling at handling_delay jiffies.
* @handler - extcon event handler called by interrupt handler. * @handler: extcon event handler called by interrupt handler.
* @chan - iio channel being queried. * @chan: iio channel being queried.
*/ */
struct adc_jack_data { struct adc_jack_data {
struct extcon_dev edev; struct extcon_dev edev;

26
drivers/extcon/extcon-class.c
View file

@ -74,7 +74,7 @@ static DEFINE_MUTEX(extcon_dev_list_lock);
/** /**
* check_mutually_exclusive - Check if new_state violates mutually_exclusive * check_mutually_exclusive - Check if new_state violates mutually_exclusive
* condition. * condition.
* @edev: the extcon device * @edev: the extcon device
* @new_state: new cable attach status for @edev * @new_state: new cable attach status for @edev
* *
@ -189,7 +189,7 @@ static ssize_t cable_state_show(struct device *dev,
/** /**
* extcon_update_state() - Update the cable attach states of the extcon device * extcon_update_state() - Update the cable attach states of the extcon device
* only for the masked bits. * only for the masked bits.
* @edev: the extcon device * @edev: the extcon device
* @mask: the bit mask to designate updated bits. * @mask: the bit mask to designate updated bits.
* @state: new cable attach status for @edev * @state: new cable attach status for @edev
@ -227,7 +227,6 @@ int extcon_update_state(struct extcon_dev *edev, u32 mask, u32 state)
edev->state |= state & mask; edev->state |= state & mask;
raw_notifier_call_chain(&edev->nh, old_state, edev); raw_notifier_call_chain(&edev->nh, old_state, edev);
/* This could be in interrupt handler */ /* This could be in interrupt handler */
prop_buf = (char *)get_zeroed_page(GFP_ATOMIC); prop_buf = (char *)get_zeroed_page(GFP_ATOMIC);
if (prop_buf) { if (prop_buf) {
@ -339,8 +338,9 @@ EXPORT_SYMBOL_GPL(extcon_get_cable_state);
/** /**
* extcon_set_cable_state_() - Set the status of a specific cable. * extcon_set_cable_state_() - Set the status of a specific cable.
* @edev: the extcon device that has the cable. * @edev: the extcon device that has the cable.
* @index: cable index that can be retrieved by extcon_find_cable_index(). * @index: cable index that can be retrieved by
* extcon_find_cable_index().
* @cable_state: the new cable status. The default semantics is * @cable_state: the new cable status. The default semantics is
* true: attached / false: detached. * true: attached / false: detached.
*/ */
@ -359,8 +359,8 @@ EXPORT_SYMBOL_GPL(extcon_set_cable_state_);
/** /**
* extcon_set_cable_state() - Set the status of a specific cable. * extcon_set_cable_state() - Set the status of a specific cable.
* @edev: the extcon device that has the cable. * @edev: the extcon device that has the cable.
* @cable_name: cable name. * @cable_name: cable name.
* @cable_state: the new cable status. The default semantics is * @cable_state: the new cable status. The default semantics is
* true: attached / false: detached. * true: attached / false: detached.
* *
@ -419,14 +419,14 @@ static int _call_per_cable(struct notifier_block *nb, unsigned long val,
/** /**
* extcon_register_interest() - Register a notifier for a state change of a * extcon_register_interest() - Register a notifier for a state change of a
* specific cable, not an entier set of cables of a * specific cable, not an entier set of cables of a
* extcon device. * extcon device.
* @obj: an empty extcon_specific_cable_nb object to be returned. * @obj: an empty extcon_specific_cable_nb object to be returned.
* @extcon_name: the name of extcon device. * @extcon_name: the name of extcon device.
* if NULL, extcon_register_interest will register * if NULL, extcon_register_interest will register
* every cable with the target cable_name given. * every cable with the target cable_name given.
* @cable_name: the target cable name. * @cable_name: the target cable name.
* @nb: the notifier block to get notified. * @nb: the notifier block to get notified.
* *
* Provide an empty extcon_specific_cable_nb. extcon_register_interest() sets * Provide an empty extcon_specific_cable_nb. extcon_register_interest() sets
* the struct for you. * the struct for you.
@ -487,7 +487,7 @@ EXPORT_SYMBOL_GPL(extcon_register_interest);
/** /**
* extcon_unregister_interest() - Unregister the notifier registered by * extcon_unregister_interest() - Unregister the notifier registered by
* extcon_register_interest(). * extcon_register_interest().
* @obj: the extcon_specific_cable_nb object returned by * @obj: the extcon_specific_cable_nb object returned by
* extcon_register_interest(). * extcon_register_interest().
*/ */
@ -502,7 +502,7 @@ EXPORT_SYMBOL_GPL(extcon_unregister_interest);
/** /**
* extcon_register_notifier() - Register a notifiee to get notified by * extcon_register_notifier() - Register a notifiee to get notified by
* any attach status changes from the extcon. * any attach status changes from the extcon.
* @edev: the extcon device. * @edev: the extcon device.
* @nb: a notifier block to be registered. * @nb: a notifier block to be registered.
* *

67
include/linux/extcon.h
View file

@ -51,10 +51,10 @@
enum extcon_cable_name { enum extcon_cable_name {
EXTCON_USB = 0, EXTCON_USB = 0,
EXTCON_USB_HOST, EXTCON_USB_HOST,
EXTCON_TA, /* Travel Adaptor */ EXTCON_TA, /* Travel Adaptor */
EXTCON_FAST_CHARGER, EXTCON_FAST_CHARGER,
EXTCON_SLOW_CHARGER, EXTCON_SLOW_CHARGER,
EXTCON_CHARGE_DOWNSTREAM, /* Charging an external device */ EXTCON_CHARGE_DOWNSTREAM, /* Charging an external device */
EXTCON_HDMI, EXTCON_HDMI,
EXTCON_MHL, EXTCON_MHL,
EXTCON_DVI, EXTCON_DVI,
@ -76,8 +76,8 @@ struct extcon_cable;
/** /**
* struct extcon_dev - An extcon device represents one external connector. * struct extcon_dev - An extcon device represents one external connector.
* @name: The name of this extcon device. Parent device name is used * @name: The name of this extcon device. Parent device name is
* if NULL. * used if NULL.
* @supported_cable: Array of supported cable names ending with NULL. * @supported_cable: Array of supported cable names ending with NULL.
* If supported_cable is NULL, cable name related APIs * If supported_cable is NULL, cable name related APIs
* are disabled. * are disabled.
@ -89,21 +89,21 @@ struct extcon_cable;
* be attached simulataneously. {0x7, 0} is equivalent to * be attached simulataneously. {0x7, 0} is equivalent to
* {0x3, 0x6, 0x5, 0}. If it is {0xFFFFFFFF, 0}, there * {0x3, 0x6, 0x5, 0}. If it is {0xFFFFFFFF, 0}, there
* can be no simultaneous connections. * can be no simultaneous connections.
* @print_name: An optional callback to override the method to print the * @print_name: An optional callback to override the method to print the
* name of the extcon device. * name of the extcon device.
* @print_state: An optional callback to override the method to print the * @print_state: An optional callback to override the method to print the
* status of the extcon device. * status of the extcon device.
* @dev: Device of this extcon. Do not provide at register-time. * @dev: Device of this extcon. Do not provide at register-time.
* @state: Attach/detach state of this extcon. Do not provide at * @state: Attach/detach state of this extcon. Do not provide at
* register-time * register-time.
* @nh: Notifier for the state change events from this extcon * @nh: Notifier for the state change events from this extcon
* @entry: To support list of extcon devices so that users can search * @entry: To support list of extcon devices so that users can search
* for extcon devices based on the extcon name. * for extcon devices based on the extcon name.
* @lock: * @lock:
* @max_supported: Internal value to store the number of cables. * @max_supported: Internal value to store the number of cables.
* @extcon_dev_type: Device_type struct to provide attribute_groups * @extcon_dev_type: Device_type struct to provide attribute_groups
* customized for each extcon device. * customized for each extcon device.
* @cables: Sysfs subdirectories. Each represents one cable. * @cables: Sysfs subdirectories. Each represents one cable.
* *
* In most cases, users only need to provide "User initializing data" of * In most cases, users only need to provide "User initializing data" of
* this struct when registering an extcon. In some exceptional cases, * this struct when registering an extcon. In some exceptional cases,
@ -111,26 +111,27 @@ struct extcon_cable;
* are overwritten by register function. * are overwritten by register function.
*/ */
struct extcon_dev { struct extcon_dev {
/* --- Optional user initializing data --- */ /* Optional user initializing data */
const char *name; const char *name;
const char **supported_cable; const char **supported_cable;
const u32 *mutually_exclusive; const u32 *mutually_exclusive;
/* --- Optional callbacks to override class functions --- */ /* Optional callbacks to override class functions */
ssize_t (*print_name)(struct extcon_dev *edev, char *buf); ssize_t (*print_name)(struct extcon_dev *edev, char *buf);
ssize_t (*print_state)(struct extcon_dev *edev, char *buf); ssize_t (*print_state)(struct extcon_dev *edev, char *buf);
/* --- Internal data. Please do not set. --- */ /* Internal data. Please do not set. */
struct device *dev; struct device *dev;
u32 state;
struct raw_notifier_head nh; struct raw_notifier_head nh;
struct list_head entry; struct list_head entry;
spinlock_t lock; /* could be called by irq handler */
int max_supported; int max_supported;
spinlock_t lock; /* could be called by irq handler */
u32 state;
/* /sys/class/extcon/.../cable.n/... */ /* /sys/class/extcon/.../cable.n/... */
struct device_type extcon_dev_type; struct device_type extcon_dev_type;
struct extcon_cable *cables; struct extcon_cable *cables;
/* /sys/class/extcon/.../mutually_exclusive/... */ /* /sys/class/extcon/.../mutually_exclusive/... */
struct attribute_group attr_g_muex; struct attribute_group attr_g_muex;
struct attribute **attrs_muex; struct attribute **attrs_muex;
@ -138,13 +139,13 @@ struct extcon_dev {
}; };
/** /**
* struct extcon_cable - An internal data for each cable of extcon device. * struct extcon_cable - An internal data for each cable of extcon device.
* @edev: The extcon device * @edev: The extcon device
* @cable_index: Index of this cable in the edev * @cable_index: Index of this cable in the edev
* @attr_g: Attribute group for the cable * @attr_g: Attribute group for the cable
* @attr_name: "name" sysfs entry * @attr_name: "name" sysfs entry
* @attr_state: "state" sysfs entry * @attr_state: "state" sysfs entry
* @attrs: Array pointing to attr_name and attr_state for attr_g * @attrs: Array pointing to attr_name and attr_state for attr_g
*/ */
struct extcon_cable { struct extcon_cable {
struct extcon_dev *edev; struct extcon_dev *edev;
@ -159,11 +160,13 @@ struct extcon_cable {
/** /**
* struct extcon_specific_cable_nb - An internal data for * struct extcon_specific_cable_nb - An internal data for
* extcon_register_interest(). * extcon_register_interest().
* @internal_nb: a notifier block bridging extcon notifier and cable notifier. * @internal_nb: A notifier block bridging extcon notifier
* @user_nb: user provided notifier block for events from a specific cable. * and cable notifier.
* @user_nb: user provided notifier block for events from
* a specific cable.
* @cable_index: the target cable. * @cable_index: the target cable.
* @edev: the target extcon device. * @edev: the target extcon device.
* @previous_value: the saved previous event value. * @previous_value: the saved previous event value.
*/ */
struct extcon_specific_cable_nb { struct extcon_specific_cable_nb {

42
include/linux/extcon/extcon-adc-jack.h
View file

@ -20,10 +20,10 @@
/** /**
* struct adc_jack_cond - condition to use an extcon state * struct adc_jack_cond - condition to use an extcon state
* @state - the corresponding extcon state (if 0, this struct denotes * @state: the corresponding extcon state (if 0, this struct
* the last adc_jack_cond element among the array) * denotes the last adc_jack_cond element among the array)
* @min_adc - min adc value for this condition * @min_adc: min adc value for this condition
* @max_adc - max adc value for this condition * @max_adc: max adc value for this condition
* *
* For example, if { .state = 0x3, .min_adc = 100, .max_adc = 200}, it means * For example, if { .state = 0x3, .min_adc = 100, .max_adc = 200}, it means
* that if ADC value is between (inclusive) 100 and 200, than the cable 0 and * that if ADC value is between (inclusive) 100 and 200, than the cable 0 and
@ -33,34 +33,34 @@
* because when no adc_jack_cond is met, state = 0 is automatically chosen. * because when no adc_jack_cond is met, state = 0 is automatically chosen.
*/ */
struct adc_jack_cond { struct adc_jack_cond {
u32 state; /* extcon state value. 0 if invalid */ u32 state; /* extcon state value. 0 if invalid */
u32 min_adc; u32 min_adc;
u32 max_adc; u32 max_adc;
}; };
/** /**
* struct adc_jack_pdata - platform data for adc jack device. * struct adc_jack_pdata - platform data for adc jack device.
* @name - name of the extcon device. If null, "adc-jack" is used. * @name: name of the extcon device. If null, "adc-jack" is used.
* @consumer_channel - Unique name to identify the channel on the consumer * @consumer_channel: Unique name to identify the channel on the consumer
* side. This typically describes the channels used within * side. This typically describes the channels used within
* the consumer. E.g. 'battery_voltage' * the consumer. E.g. 'battery_voltage'
* @cable_names - array of cable names ending with null. * @cable_names: array of cable names ending with null.
* @adc_contitions - array of struct adc_jack_cond conditions ending * @adc_contitions: array of struct adc_jack_cond conditions ending
* with .state = 0 entry. This describes how to decode * with .state = 0 entry. This describes how to decode
* adc values into extcon state. * adc values into extcon state.
* @irq_flags - irq flags used for the @irq * @irq_flags: irq flags used for the @irq
* @handling_delay_ms - in some devices, we need to read ADC value some * @handling_delay_ms: in some devices, we need to read ADC value some
* milli-seconds after the interrupt occurs. You may * milli-seconds after the interrupt occurs. You may
* describe such delays with @handling_delay_ms, which * describe such delays with @handling_delay_ms, which
* is rounded-off by jiffies. * is rounded-off by jiffies.
*/ */
struct adc_jack_pdata { struct adc_jack_pdata {
const char *name; const char *name;
const char *consumer_channel; const char *consumer_channel;
/*
* The last entry should be NULL /* The last entry should be NULL */
*/
const char **cable_names; const char **cable_names;
/* The last entry's state should be 0 */ /* The last entry's state should be 0 */
struct adc_jack_cond *adc_conditions; struct adc_jack_cond *adc_conditions;

16
include/linux/extcon/extcon-gpio.h
View file

@ -25,14 +25,14 @@
/** /**
* struct gpio_extcon_platform_data - A simple GPIO-controlled extcon device. * struct gpio_extcon_platform_data - A simple GPIO-controlled extcon device.
* @name The name of this GPIO extcon device. * @name: The name of this GPIO extcon device.
* @gpio Corresponding GPIO. * @gpio: Corresponding GPIO.
* @debounce Debounce time for GPIO IRQ in ms. * @debounce: Debounce time for GPIO IRQ in ms.
* @irq_flags IRQ Flags (e.g., IRQF_TRIGGER_LOW). * @irq_flags: IRQ Flags (e.g., IRQF_TRIGGER_LOW).
* @state_on print_state is overriden with state_on if attached. If Null, * @state_on: print_state is overriden with state_on if attached.
* default method of extcon class is used. * If NULL, default method of extcon class is used.
* @state_off print_state is overriden with state_on if detached. If Null, * @state_off: print_state is overriden with state_on if detached.
* default method of extcon class is used. * If NUll, default method of extcon class is used.
* *
* Note that in order for state_on or state_off to be valid, both state_on * Note that in order for state_on or state_off to be valid, both state_on
* and state_off should be not NULL. If at least one of them is NULL, * and state_off should be not NULL. If at least one of them is NULL,