include/linux/power_supply.h

1 /* SPDX-License-Identifier: GPL-2.0-only */
15 #include <linux/device.h>
226 /* Run-time specific power supply configuration */
234 	/* Device specific sysfs attributes */
264 	 * of power supply. If this happens during device probe then it must
265 	 * not access internal data of device (because probe did not end).
296 	struct device dev;
359  * struct power_supply_maintenance_charge_table - setting for maintenace charging
379  * below charge_term_current_ua, and then restart it (if the device is still
392  *  +-------------------------------------------------------------------> t
394  * Practically this means that the Li-ions are wandering back and forth in the
405  *  +-------------------------------------------------------------------> t
416  * As an example, a Samsung EB425161LA Lithium-Ion battery is CC/CV charged
423  * the user to disconnect the device and make use of it before both maintenance
430  * device is e.g. actively used during charging, so more current is drawn than
431  * the expected stand-by current. Also overvoltage protection will be applied
443  * struct power_supply_battery_info - information about batteries
516  *   the capacity for reasons of chemistry will be different at different
568  *   of mobile device batteries.
570  *   for example 10 for +/- 10%, if the bti_resistance is set to 7000 and the
579  * The default field value is -EINVAL or NULL for pointers.
588  * |                                               --- overvoltage_limit_uv
601  * +------------------------------------------------------------------> time
618  * +-----------------------------------------------------------------> time
629  * 2. Next a small initial pre-charge current (precharge_current_ua)
670  * many chargers uses a so-called fuel gauge or coloumb counter that measure
671  * how much charge goes into the battery and how much goes out (+/- leak
675  * the open circuit voltage with a look-up table to determine the rough
680  *      +-------> IBAT >----------------+
684  *      o <----------        |          |
686  *    .---.         |        |          |
688  *    '---'         |        |          |
690  *  GND +-------------------------------+
698  * chemistry involved.
705  *   OCV = VBAT - (IBAT * Ri)
784 				    struct device *dev, const char *property);
790 devm_power_supply_get_by_phandle(struct device *dev, const char *property)  in devm_power_supply_get_by_phandle()
841 	return ((info->vbat2ri_discharging != NULL) &&  in power_supply_supports_vbat2ri()
842 		info->vbat2ri_discharging_size > 0);  in power_supply_supports_vbat2ri()
848 	return ((info->resist_table != NULL) &&  in power_supply_supports_temp2ri()
849 		info->resist_table_size > 0);  in power_supply_supports_temp2ri()
855 static inline int power_supply_is_system_supplied(void) { return -ENOSYS; }  in power_supply_is_system_supplied()
876 power_supply_register(struct device *parent,
880 power_supply_register_no_ws(struct device *parent,
884 devm_power_supply_register(struct device *parent,
888 devm_power_supply_register_no_ws(struct device *parent,
892 extern int power_supply_powers(struct power_supply *psy, struct device *dev);
894 #define to_power_supply(device) container_of(device, struct power_supply, dev)  argument
968 ssize_t power_supply_charge_behaviour_show(struct device *dev,
976 ssize_t power_supply_charge_behaviour_show(struct device *dev,  in power_supply_charge_behaviour_show()
981 	return -EOPNOTSUPP;  in power_supply_charge_behaviour_show()
987 	return -EOPNOTSUPP;  in power_supply_charge_behaviour_parse()