include/linux/power_supply.h

1 /* SPDX-License-Identifier: GPL-2.0-only */
226 /* Run-time specific power supply configuration */
345 	int resistance;	/* internal resistance percent */  member
350 	int ri_uohm;	/* Internal resistance in microohm */
354  * struct power_supply_maintenance_charge_table - setting for maintenace charging
359  *   turned back on if we fall below this voltage.
387  *  +-------------------------------------------------------------------> t
389  * Practically this means that the Li-ions are wandering back and forth in the
393  * consuming power, thus lowering the wear on the battery:
400  *  +-------------------------------------------------------------------> t
404  * CC/CV charging. The maintenance charging will for safety reasons not go on
411  * As an example, a Samsung EB425161LA Lithium-Ion battery is CC/CV charged
426  * the expected stand-by current. Also overvoltage protection will be applied
438  * struct power_supply_battery_info - information about batteries
449  *   printed on the label of the battery.
497  * @factory_internal_resistance_uohm: the internal resistance of the battery
498  *   at fabrication time, expressed in microohms. This resistance will vary
499  *   depending on the lifetime and charge of the battery, so this is just a
500  *   nominal ballpark figure. This internal resistance is given for the state
502  * @factory_internal_resistance_charging_uohm: the internal resistance of the
504  *   The charging process will affect the internal resistance of the battery
505  *   so this value provides a better resistance under these circumstances.
506  *   This resistance will vary depending on the lifetime and charge of the
537  *   expected internal resistance at this temperature. The resistance is given
539  *   resistance of the battery is usually necessary for calculating the open
542  *   by temperature: highest temperature with lowest resistance first, lowest
543  *   temperature with highest resistance last.
546  *   to internal resistance (Ri). The resistance is given in microohm for the
547  *   corresponding voltage in microvolts. The internal resistance is used to
549  *   of the battery. These voltages to resistance tables apply when the battery
556  *   internal resistance characteristics so a separate table is needed.*
560  * @bti_resistance_ohm: The Battery Type Indicator (BIT) nominal resistance
564  * @bti_resistance_tolerance: The tolerance in percent of the BTI resistance,
565  *   for example 10 for +/- 10%, if the bti_resistance is set to 7000 and the
566  *   tolerance is 10% we will detect a proper battery if the BTI resistance
574  * The default field value is -EINVAL or NULL for pointers.
583  * |                                               --- overvoltage_limit_uv
596  * +------------------------------------------------------------------> time
613  * +-----------------------------------------------------------------> time
615  * These diagrams are synchronized on time and the voltage and current
624  * 2. Next a small initial pre-charge current (precharge_current_ua)
640  *    the voltage the same. A chemical reaction in the battery goes on
665  * many chargers uses a so-called fuel gauge or coloumb counter that measure
666  * how much charge goes into the battery and how much goes out (+/- leak
670  * the open circuit voltage with a look-up table to determine the rough
672  * with an ideal voltage source (V) in series with an internal resistance (Ri)
675  *      +-------> IBAT >----------------+
679  *      o <----------        |          |
681  *    .---.         |        |          |
683  *    '---'         |        |          |
685  *  GND +-------------------------------+
687  * If we disconnect the load (here simplified as a fixed resistance Rload)
691  * load is rarely that small and Ri is strongly nonlinear depending on
700  *   OCV = VBAT - (IBAT * Ri)
708  * resistance change, and it will affect the VBAT under load, so correlating
712  * is dependent on the battery temperature which is the main factor affecting
815 					      int resistance);
836 	return ((info->vbat2ri_discharging != NULL) &&  in power_supply_supports_vbat2ri()
837 		info->vbat2ri_discharging_size > 0);  in power_supply_supports_vbat2ri()
843 	return ((info->resist_table != NULL) &&  in power_supply_supports_temp2ri()
844 		info->resist_table_size > 0);  in power_supply_supports_temp2ri()
850 static inline int power_supply_is_system_supplied(void) { return -ENOSYS; }  in power_supply_is_system_supplied()
975 	return -EOPNOTSUPP;  in power_supply_charge_behaviour_show()
981 	return -EOPNOTSUPP;  in power_supply_charge_behaviour_parse()