xref: /linux/Documentation/ABI/testing/sysfs-class-power (revision 4f38da1f027ea2c9f01bb71daa7a299c191b6940)
134433332SMauro Carvalho Chehab**General Properties**
291dabc54SAdam Thomson
391dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/manufacturer
491dabc54SAdam ThomsonDate:		May 2007
591dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
691dabc54SAdam ThomsonDescription:
791dabc54SAdam Thomson		Reports the name of the device manufacturer.
891dabc54SAdam Thomson
991dabc54SAdam Thomson		Access: Read
1091dabc54SAdam Thomson		Valid values: Represented as string
1191dabc54SAdam Thomson
1291dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/model_name
1391dabc54SAdam ThomsonDate:		May 2007
1491dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
1591dabc54SAdam ThomsonDescription:
1691dabc54SAdam Thomson		Reports the name of the device model.
1791dabc54SAdam Thomson
1891dabc54SAdam Thomson		Access: Read
1991dabc54SAdam Thomson		Valid values: Represented as string
2091dabc54SAdam Thomson
2191dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/serial_number
2291dabc54SAdam ThomsonDate:		January 2008
2391dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
2491dabc54SAdam ThomsonDescription:
2591dabc54SAdam Thomson		Reports the serial number of the device.
2691dabc54SAdam Thomson
2791dabc54SAdam Thomson		Access: Read
2891dabc54SAdam Thomson		Valid values: Represented as string
2991dabc54SAdam Thomson
3091dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/type
3191dabc54SAdam ThomsonDate:		May 2010
3291dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
3391dabc54SAdam ThomsonDescription:
3491dabc54SAdam Thomson		Describes the main type of the supply.
3591dabc54SAdam Thomson
3691dabc54SAdam Thomson		Access: Read
375ca937fbSSubbaraman Narayanamurthy		Valid values: "Battery", "UPS", "Mains", "USB", "Wireless"
3891dabc54SAdam Thomson
399e0b29adSMauro Carvalho Chehab**Battery and USB properties**
409e0b29adSMauro Carvalho Chehab
419e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/current_avg
429e0b29adSMauro Carvalho ChehabDate:		May 2007
439e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
449e0b29adSMauro Carvalho ChehabDescription:
459e0b29adSMauro Carvalho Chehab		Battery:
469e0b29adSMauro Carvalho Chehab
479e0b29adSMauro Carvalho Chehab		  Reports an average IBAT current reading for the battery, over
489e0b29adSMauro Carvalho Chehab		  a fixed period. Normally devices will provide a fixed interval
499e0b29adSMauro Carvalho Chehab		  in which they average readings to smooth out the reported
509e0b29adSMauro Carvalho Chehab		  value.
519e0b29adSMauro Carvalho Chehab
529e0b29adSMauro Carvalho Chehab		USB:
539e0b29adSMauro Carvalho Chehab
549e0b29adSMauro Carvalho Chehab		  Reports an average IBUS current reading over a fixed period.
559e0b29adSMauro Carvalho Chehab		  Normally devices will provide a fixed interval in which they
569e0b29adSMauro Carvalho Chehab		  average readings to smooth out the reported value.
579e0b29adSMauro Carvalho Chehab
589e0b29adSMauro Carvalho Chehab		Access: Read
599e0b29adSMauro Carvalho Chehab
609e0b29adSMauro Carvalho Chehab		Valid values: Represented in microamps. Negative values are
619e0b29adSMauro Carvalho Chehab		used for discharging batteries, positive values for charging
629e0b29adSMauro Carvalho Chehab		batteries and for USB IBUS current.
639e0b29adSMauro Carvalho Chehab
649e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/current_max
659e0b29adSMauro Carvalho ChehabDate:		October 2010
669e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
679e0b29adSMauro Carvalho ChehabDescription:
689e0b29adSMauro Carvalho Chehab		Battery:
699e0b29adSMauro Carvalho Chehab
709e0b29adSMauro Carvalho Chehab		  Reports the maximum IBAT current allowed into the battery.
719e0b29adSMauro Carvalho Chehab
729e0b29adSMauro Carvalho Chehab		USB:
739e0b29adSMauro Carvalho Chehab
749e0b29adSMauro Carvalho Chehab		  Reports the maximum IBUS current the supply can support.
759e0b29adSMauro Carvalho Chehab
769e0b29adSMauro Carvalho Chehab		Access: Read
779e0b29adSMauro Carvalho Chehab		Valid values: Represented in microamps
789e0b29adSMauro Carvalho Chehab
799e0b29adSMauro Carvalho ChehabWhat: 		/sys/class/power_supply/<supply_name>/current_now
809e0b29adSMauro Carvalho ChehabDate:		May 2007
819e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
829e0b29adSMauro Carvalho ChehabDescription:
839e0b29adSMauro Carvalho Chehab
849e0b29adSMauro Carvalho Chehab		Battery:
859e0b29adSMauro Carvalho Chehab
869e0b29adSMauro Carvalho Chehab		  Reports an instant, single IBAT current reading for the
879e0b29adSMauro Carvalho Chehab		  battery. This value is not averaged/smoothed.
889e0b29adSMauro Carvalho Chehab
899e0b29adSMauro Carvalho Chehab		  Access: Read
909e0b29adSMauro Carvalho Chehab
919e0b29adSMauro Carvalho Chehab		USB:
929e0b29adSMauro Carvalho Chehab
939e0b29adSMauro Carvalho Chehab		  Reports the IBUS current supplied now. This value is generally
949e0b29adSMauro Carvalho Chehab		  read-only reporting, unless the 'online' state of the supply
959e0b29adSMauro Carvalho Chehab		  is set to be programmable, in which case this value can be set
969e0b29adSMauro Carvalho Chehab		  within the reported min/max range.
979e0b29adSMauro Carvalho Chehab
989e0b29adSMauro Carvalho Chehab		  Access: Read, Write
999e0b29adSMauro Carvalho Chehab
1009e0b29adSMauro Carvalho Chehab		Valid values: Represented in microamps. Negative values are
1019e0b29adSMauro Carvalho Chehab		used for discharging batteries, positive values for charging
1029e0b29adSMauro Carvalho Chehab		batteries and for USB IBUS current.
1039e0b29adSMauro Carvalho Chehab
1049e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/temp
1059e0b29adSMauro Carvalho ChehabDate:		May 2007
1069e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
1079e0b29adSMauro Carvalho ChehabDescription:
1089e0b29adSMauro Carvalho Chehab		Battery:
1099e0b29adSMauro Carvalho Chehab
1109e0b29adSMauro Carvalho Chehab		  Reports the current TBAT battery temperature reading.
1119e0b29adSMauro Carvalho Chehab
1129e0b29adSMauro Carvalho Chehab		USB:
1139e0b29adSMauro Carvalho Chehab
1149e0b29adSMauro Carvalho Chehab		  Reports the current supply temperature reading. This would
1159e0b29adSMauro Carvalho Chehab		  normally be the internal temperature of the device itself
1169e0b29adSMauro Carvalho Chehab		  (e.g TJUNC temperature of an IC)
1179e0b29adSMauro Carvalho Chehab
1189e0b29adSMauro Carvalho Chehab		Access: Read
1199e0b29adSMauro Carvalho Chehab
1209e0b29adSMauro Carvalho Chehab		Valid values: Represented in 1/10 Degrees Celsius
1219e0b29adSMauro Carvalho Chehab
1229e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/temp_alert_max
1239e0b29adSMauro Carvalho ChehabDate:		July 2012
1249e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
1259e0b29adSMauro Carvalho ChehabDescription:
1269e0b29adSMauro Carvalho Chehab		Battery:
1279e0b29adSMauro Carvalho Chehab
1289e0b29adSMauro Carvalho Chehab		  Maximum TBAT temperature trip-wire value where the supply will
1299e0b29adSMauro Carvalho Chehab		  notify user-space of the event.
1309e0b29adSMauro Carvalho Chehab
1319e0b29adSMauro Carvalho Chehab		USB:
1329e0b29adSMauro Carvalho Chehab
1339e0b29adSMauro Carvalho Chehab		  Maximum supply temperature trip-wire value where the supply
1349e0b29adSMauro Carvalho Chehab		  will notify user-space of the event.
1359e0b29adSMauro Carvalho Chehab
1369e0b29adSMauro Carvalho Chehab		This is normally used for the charging scenario where
1379e0b29adSMauro Carvalho Chehab		user-space needs to know if the temperature has crossed an
1389e0b29adSMauro Carvalho Chehab		upper threshold so it can take appropriate action (e.g. warning
1399e0b29adSMauro Carvalho Chehab		user that the temperature is critically high, and charging has
1409e0b29adSMauro Carvalho Chehab		stopped).
1419e0b29adSMauro Carvalho Chehab
1429e0b29adSMauro Carvalho Chehab		Access: Read
1439e0b29adSMauro Carvalho Chehab
1449e0b29adSMauro Carvalho Chehab		Valid values: Represented in 1/10 Degrees Celsius
1459e0b29adSMauro Carvalho Chehab
1469e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/temp_alert_min
1479e0b29adSMauro Carvalho ChehabDate:		July 2012
1489e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
1499e0b29adSMauro Carvalho ChehabDescription:
1509e0b29adSMauro Carvalho Chehab
1519e0b29adSMauro Carvalho Chehab		Battery:
1529e0b29adSMauro Carvalho Chehab
1539e0b29adSMauro Carvalho Chehab		  Minimum TBAT temperature trip-wire value where the supply will
1549e0b29adSMauro Carvalho Chehab		  notify user-space of the event.
1559e0b29adSMauro Carvalho Chehab
1569e0b29adSMauro Carvalho Chehab		USB:
1579e0b29adSMauro Carvalho Chehab
1589e0b29adSMauro Carvalho Chehab		  Minimum supply temperature trip-wire value where the supply
1599e0b29adSMauro Carvalho Chehab		  will notify user-space of the event.
1609e0b29adSMauro Carvalho Chehab
1619e0b29adSMauro Carvalho Chehab		This is normally used for the charging scenario where user-space
1629e0b29adSMauro Carvalho Chehab		needs to know if the temperature has crossed a lower threshold
1639e0b29adSMauro Carvalho Chehab		so it can take appropriate action (e.g. warning user that
1649e0b29adSMauro Carvalho Chehab		temperature level is high, and charging current has been
1659e0b29adSMauro Carvalho Chehab		reduced accordingly to remedy the situation).
1669e0b29adSMauro Carvalho Chehab
1679e0b29adSMauro Carvalho Chehab		Access: Read
1689e0b29adSMauro Carvalho Chehab
1699e0b29adSMauro Carvalho Chehab		Valid values: Represented in 1/10 Degrees Celsius
1709e0b29adSMauro Carvalho Chehab
1719e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/temp_max
1729e0b29adSMauro Carvalho ChehabDate:		July 2014
1739e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
1749e0b29adSMauro Carvalho ChehabDescription:
1759e0b29adSMauro Carvalho Chehab		Battery:
1769e0b29adSMauro Carvalho Chehab
1779e0b29adSMauro Carvalho Chehab		  Reports the maximum allowed TBAT battery temperature for
1789e0b29adSMauro Carvalho Chehab		  charging.
1799e0b29adSMauro Carvalho Chehab
1809e0b29adSMauro Carvalho Chehab		USB:
1819e0b29adSMauro Carvalho Chehab
1829e0b29adSMauro Carvalho Chehab		  Reports the maximum allowed supply temperature for operation.
1839e0b29adSMauro Carvalho Chehab
1849e0b29adSMauro Carvalho Chehab		Access: Read
1859e0b29adSMauro Carvalho Chehab
1869e0b29adSMauro Carvalho Chehab		Valid values: Represented in 1/10 Degrees Celsius
1879e0b29adSMauro Carvalho Chehab
1889e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/temp_min
1899e0b29adSMauro Carvalho ChehabDate:		July 2014
1909e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
1919e0b29adSMauro Carvalho ChehabDescription:
1929e0b29adSMauro Carvalho Chehab		Battery:
1939e0b29adSMauro Carvalho Chehab
1949e0b29adSMauro Carvalho Chehab		  Reports the minimum allowed TBAT battery temperature for
1959e0b29adSMauro Carvalho Chehab		  charging.
1969e0b29adSMauro Carvalho Chehab
1979e0b29adSMauro Carvalho Chehab		USB:
1989e0b29adSMauro Carvalho Chehab
1999e0b29adSMauro Carvalho Chehab		  Reports the minimum allowed supply temperature for operation.
2009e0b29adSMauro Carvalho Chehab
2019e0b29adSMauro Carvalho Chehab		Access: Read
2029e0b29adSMauro Carvalho Chehab
2039e0b29adSMauro Carvalho Chehab		Valid values: Represented in 1/10 Degrees Celsius
2049e0b29adSMauro Carvalho Chehab
2059e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/voltage_max,
2069e0b29adSMauro Carvalho ChehabDate:		January 2008
2079e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
2089e0b29adSMauro Carvalho ChehabDescription:
2099e0b29adSMauro Carvalho Chehab		Battery:
2109e0b29adSMauro Carvalho Chehab
2119e0b29adSMauro Carvalho Chehab		  Reports the maximum safe VBAT voltage permitted for the
2129e0b29adSMauro Carvalho Chehab		  battery, during charging.
2139e0b29adSMauro Carvalho Chehab
2149e0b29adSMauro Carvalho Chehab		USB:
2159e0b29adSMauro Carvalho Chehab
2169e0b29adSMauro Carvalho Chehab		  Reports the maximum VBUS voltage the supply can support.
2179e0b29adSMauro Carvalho Chehab
2189e0b29adSMauro Carvalho Chehab		Access: Read
2199e0b29adSMauro Carvalho Chehab
2209e0b29adSMauro Carvalho Chehab		Valid values: Represented in microvolts
2219e0b29adSMauro Carvalho Chehab
2229e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/voltage_min,
2239e0b29adSMauro Carvalho ChehabDate:		January 2008
2249e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
2259e0b29adSMauro Carvalho ChehabDescription:
2269e0b29adSMauro Carvalho Chehab		Battery:
2279e0b29adSMauro Carvalho Chehab
2289e0b29adSMauro Carvalho Chehab		  Reports the minimum safe VBAT voltage permitted for the
2299e0b29adSMauro Carvalho Chehab		  battery, during discharging.
2309e0b29adSMauro Carvalho Chehab
2319e0b29adSMauro Carvalho Chehab		USB:
2329e0b29adSMauro Carvalho Chehab
2339e0b29adSMauro Carvalho Chehab		  Reports the minimum VBUS voltage the supply can support.
2349e0b29adSMauro Carvalho Chehab
2359e0b29adSMauro Carvalho Chehab		Access: Read
2369e0b29adSMauro Carvalho Chehab
2379e0b29adSMauro Carvalho Chehab		Valid values: Represented in microvolts
2389e0b29adSMauro Carvalho Chehab
2399e0b29adSMauro Carvalho ChehabWhat:		/sys/class/power_supply/<supply_name>/voltage_now,
2409e0b29adSMauro Carvalho ChehabDate:		May 2007
2419e0b29adSMauro Carvalho ChehabContact:	linux-pm@vger.kernel.org
2429e0b29adSMauro Carvalho ChehabDescription:
2439e0b29adSMauro Carvalho Chehab		Battery:
2449e0b29adSMauro Carvalho Chehab
2459e0b29adSMauro Carvalho Chehab		  Reports an instant, single VBAT voltage reading for the
2469e0b29adSMauro Carvalho Chehab		  battery. This value is not averaged/smoothed.
2479e0b29adSMauro Carvalho Chehab
2489e0b29adSMauro Carvalho Chehab		  Access: Read
2499e0b29adSMauro Carvalho Chehab
2509e0b29adSMauro Carvalho Chehab		USB:
2519e0b29adSMauro Carvalho Chehab
2529e0b29adSMauro Carvalho Chehab		  Reports the VBUS voltage supplied now. This value is generally
2539e0b29adSMauro Carvalho Chehab		  read-only reporting, unless the 'online' state of the supply
2549e0b29adSMauro Carvalho Chehab		  is set to be programmable, in which case this value can be set
2559e0b29adSMauro Carvalho Chehab		  within the reported min/max range.
2569e0b29adSMauro Carvalho Chehab
2579e0b29adSMauro Carvalho Chehab		  Access: Read, Write
2589e0b29adSMauro Carvalho Chehab
2599e0b29adSMauro Carvalho Chehab		Valid values: Represented in microvolts
2609e0b29adSMauro Carvalho Chehab
2619e0b29adSMauro Carvalho Chehab**Battery Properties**
26291dabc54SAdam Thomson
26391dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/capacity
26491dabc54SAdam ThomsonDate:		May 2007
26591dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
26691dabc54SAdam ThomsonDescription:
26791dabc54SAdam Thomson		Fine grain representation of battery capacity.
26854a19b4dSMauro Carvalho Chehab
26991dabc54SAdam Thomson		Access: Read
27054a19b4dSMauro Carvalho Chehab
27191dabc54SAdam Thomson		Valid values: 0 - 100 (percent)
27291dabc54SAdam Thomson
27391dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/capacity_alert_max
27491dabc54SAdam ThomsonDate:		July 2012
27591dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
27691dabc54SAdam ThomsonDescription:
27791dabc54SAdam Thomson		Maximum battery capacity trip-wire value where the supply will
27891dabc54SAdam Thomson		notify user-space of the event. This is normally used for the
27991dabc54SAdam Thomson		battery discharging scenario where user-space needs to know the
28091dabc54SAdam Thomson		battery has dropped to an upper level so it can take
28191dabc54SAdam Thomson		appropriate action (e.g. warning user that battery level is
28291dabc54SAdam Thomson		low).
28391dabc54SAdam Thomson
28491dabc54SAdam Thomson		Access: Read, Write
28554a19b4dSMauro Carvalho Chehab
28691dabc54SAdam Thomson		Valid values: 0 - 100 (percent)
28791dabc54SAdam Thomson
28891dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/capacity_alert_min
28991dabc54SAdam ThomsonDate:		July 2012
29091dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
29191dabc54SAdam ThomsonDescription:
29291dabc54SAdam Thomson		Minimum battery capacity trip-wire value where the supply will
29391dabc54SAdam Thomson		notify user-space of the event. This is normally used for the
29491dabc54SAdam Thomson		battery discharging scenario where user-space needs to know the
29591dabc54SAdam Thomson		battery has dropped to a lower level so it can take
29691dabc54SAdam Thomson		appropriate action (e.g. warning user that battery level is
29791dabc54SAdam Thomson		critically low).
29891dabc54SAdam Thomson
29991dabc54SAdam Thomson		Access: Read, Write
30034433332SMauro Carvalho Chehab
30191dabc54SAdam Thomson		Valid values: 0 - 100 (percent)
30291dabc54SAdam Thomson
303bac705abSSebastian ReichelWhat:		/sys/class/power_supply/<supply_name>/capacity_error_margin
304bac705abSSebastian ReichelDate:		April 2019
305bac705abSSebastian ReichelContact:	linux-pm@vger.kernel.org
306bac705abSSebastian ReichelDescription:
307bac705abSSebastian Reichel		Battery capacity measurement becomes unreliable without
308bac705abSSebastian Reichel		recalibration. This values provides the maximum error
309bac705abSSebastian Reichel		margin expected to exist by the fuel gauge in percent.
310bac705abSSebastian Reichel		Values close to 0% will be returned after (re-)calibration
311bac705abSSebastian Reichel		has happened. Over time the error margin will increase.
312bac705abSSebastian Reichel		100% means, that the capacity related values are basically
313bac705abSSebastian Reichel		completely useless.
314bac705abSSebastian Reichel
315bac705abSSebastian Reichel		Access: Read
31654a19b4dSMauro Carvalho Chehab
317bac705abSSebastian Reichel		Valid values: 0 - 100 (percent)
318bac705abSSebastian Reichel
31991dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/capacity_level
32091dabc54SAdam ThomsonDate:		June 2009
32191dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
32291dabc54SAdam ThomsonDescription:
32391dabc54SAdam Thomson		Coarse representation of battery capacity.
32491dabc54SAdam Thomson
32591dabc54SAdam Thomson		Access: Read
32634433332SMauro Carvalho Chehab
32734433332SMauro Carvalho Chehab		Valid values:
32834433332SMauro Carvalho Chehab			      "Unknown", "Critical", "Low", "Normal", "High",
32991dabc54SAdam Thomson			      "Full"
33091dabc54SAdam Thomson
33161e93655SNick CrewsWhat:		/sys/class/power_supply/<supply_name>/charge_control_limit
33261e93655SNick CrewsDate:		Oct 2012
33361e93655SNick CrewsContact:	linux-pm@vger.kernel.org
33461e93655SNick CrewsDescription:
33561e93655SNick Crews		Maximum allowable charging current. Used for charge rate
33661e93655SNick Crews		throttling for thermal cooling or improving battery health.
33761e93655SNick Crews
33861e93655SNick Crews		Access: Read, Write
33934433332SMauro Carvalho Chehab
34061e93655SNick Crews		Valid values: Represented in microamps
34161e93655SNick Crews
34261e93655SNick CrewsWhat:		/sys/class/power_supply/<supply_name>/charge_control_limit_max
34361e93655SNick CrewsDate:		Oct 2012
34461e93655SNick CrewsContact:	linux-pm@vger.kernel.org
34561e93655SNick CrewsDescription:
34661e93655SNick Crews		Maximum legal value for the charge_control_limit property.
34761e93655SNick Crews
34861e93655SNick Crews		Access: Read
34934433332SMauro Carvalho Chehab
35061e93655SNick Crews		Valid values: Represented in microamps
35161e93655SNick Crews
352813cab8fSNick CrewsWhat:		/sys/class/power_supply/<supply_name>/charge_control_start_threshold
353813cab8fSNick CrewsDate:		April 2019
354813cab8fSNick CrewsContact:	linux-pm@vger.kernel.org
355813cab8fSNick CrewsDescription:
356813cab8fSNick Crews		Represents a battery percentage level, below which charging will
357813cab8fSNick Crews		begin.
358813cab8fSNick Crews
359813cab8fSNick Crews		Access: Read, Write
360813cab8fSNick Crews		Valid values: 0 - 100 (percent)
361813cab8fSNick Crews
362813cab8fSNick CrewsWhat:		/sys/class/power_supply/<supply_name>/charge_control_end_threshold
363813cab8fSNick CrewsDate:		April 2019
364813cab8fSNick CrewsContact:	linux-pm@vger.kernel.org
365813cab8fSNick CrewsDescription:
366813cab8fSNick Crews		Represents a battery percentage level, above which charging will
36718ef1bb0SArvid Norlander		stop. Not all hardware is capable of setting this to an arbitrary
36818ef1bb0SArvid Norlander		percentage. Drivers will round written values to the nearest
36918ef1bb0SArvid Norlander		supported value. Reading back the value will show the actual
37018ef1bb0SArvid Norlander		threshold set by the driver.
371813cab8fSNick Crews
372813cab8fSNick Crews		Access: Read, Write
37334433332SMauro Carvalho Chehab
374813cab8fSNick Crews		Valid values: 0 - 100 (percent)
375813cab8fSNick Crews
37691dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/charge_type
37791dabc54SAdam ThomsonDate:		July 2009
37891dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
37991dabc54SAdam ThomsonDescription:
380919a4719SAndres Salomon		Select the charging algorithm to use for a battery.
381919a4719SAndres Salomon
382919a4719SAndres Salomon		Standard:
383919a4719SAndres Salomon			Fully charge the battery at a moderate rate.
384919a4719SAndres Salomon		Fast:
385919a4719SAndres Salomon			Quickly charge the battery using fast-charge
386919a4719SAndres Salomon			technology. This is typically harder on the battery
387919a4719SAndres Salomon			than standard charging and may lower its lifespan.
388919a4719SAndres Salomon		Trickle:
389919a4719SAndres Salomon			Users who primarily operate the system while
390919a4719SAndres Salomon			plugged into an external power source can extend
391919a4719SAndres Salomon			battery life with this mode. Vendor tooling may
392919a4719SAndres Salomon			call this "Primarily AC Use".
393919a4719SAndres Salomon		Adaptive:
394919a4719SAndres Salomon			Automatically optimize battery charge rate based
395919a4719SAndres Salomon			on typical usage pattern.
396919a4719SAndres Salomon		Custom:
397919a4719SAndres Salomon			Use the charge_control_* properties to determine
398919a4719SAndres Salomon			when to start and stop charging. Advanced users
399919a4719SAndres Salomon			can use this to drastically extend battery life.
400919a4719SAndres Salomon		Long Life:
401919a4719SAndres Salomon			The charger reduces its charging rate in order to
402919a4719SAndres Salomon			prolong the battery health.
403919a4719SAndres Salomon		Bypass:
404919a4719SAndres Salomon			The charger bypasses the charging path around the
405919a4719SAndres Salomon			integrated converter allowing for a "smart" wall
406919a4719SAndres Salomon			adaptor to perform the power conversion externally.
40791dabc54SAdam Thomson
408ba6cc850SNick Crews		Access: Read, Write
40934433332SMauro Carvalho Chehab
410d24bf992SHans de Goede		Reading this returns the current active value, e.g. 'Standard'.
411d24bf992SHans de Goede		Check charge_types to get the values supported by the battery.
412d24bf992SHans de Goede
41334433332SMauro Carvalho Chehab		Valid values:
41434433332SMauro Carvalho Chehab			      "Unknown", "N/A", "Trickle", "Fast", "Standard",
4151ff8cc2cSRicardo Rivera-Matos			      "Adaptive", "Custom", "Long Life", "Bypass"
41691dabc54SAdam Thomson
417d24bf992SHans de GoedeWhat:		/sys/class/power_supply/<supply_name>/charge_types
418d24bf992SHans de GoedeDate:		December 2024
419d24bf992SHans de GoedeContact:	linux-pm@vger.kernel.org
420d24bf992SHans de GoedeDescription:
421d24bf992SHans de Goede		Identical to charge_type but reading returns a list of supported
422d24bf992SHans de Goede		charge-types with the currently active type surrounded by square
423d24bf992SHans de Goede		brackets, e.g.: "Fast [Standard] Long_Life".
424d24bf992SHans de Goede
425d24bf992SHans de Goede		power_supply class devices may support both charge_type and
426d24bf992SHans de Goede		charge_types for backward compatibility. In this case both will
427d24bf992SHans de Goede		always have the same active value and the active value can be
428d24bf992SHans de Goede		changed by writing either property.
429d24bf992SHans de Goede
430d24bf992SHans de Goede		Note charge-types which contain a space such as "Long Life" will
431d24bf992SHans de Goede		have the space replaced by a '_' resulting in e.g. "Long_Life".
432d24bf992SHans de Goede		When writing charge-types both variants are accepted.
433d24bf992SHans de Goede
43491dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/charge_term_current
43591dabc54SAdam ThomsonDate:		July 2014
43691dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
43791dabc54SAdam ThomsonDescription:
43891dabc54SAdam Thomson		Reports the charging current value which is used to determine
43991dabc54SAdam Thomson		when the battery is considered full and charging should end.
44091dabc54SAdam Thomson
44191dabc54SAdam Thomson		Access: Read
44234433332SMauro Carvalho Chehab
44391dabc54SAdam Thomson		Valid values: Represented in microamps
44491dabc54SAdam Thomson
44591dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/health
44691dabc54SAdam ThomsonDate:		May 2007
44791dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
44891dabc54SAdam ThomsonDescription:
44991dabc54SAdam Thomson		Reports the health of the battery or battery side of charger
45091dabc54SAdam Thomson		functionality.
45191dabc54SAdam Thomson
45291dabc54SAdam Thomson		Access: Read
45334433332SMauro Carvalho Chehab
45434433332SMauro Carvalho Chehab		Valid values:
45534433332SMauro Carvalho Chehab			      "Unknown", "Good", "Overheat", "Dead",
456df998c22SDzmitry Sankouski			      "Over voltage", "Under voltage", "Unspecified failure", "Cold",
457333853beSDan Murphy			      "Watchdog timer expire", "Safety timer expire",
45898cc1b93SDan Murphy			      "Over current", "Calibration required", "Warm",
459f4856c20SArmin Wolf			      "Cool", "Hot", "No battery", "Blown fuse", "Cell imbalance"
46091dabc54SAdam Thomson
46191dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/precharge_current
46291dabc54SAdam ThomsonDate:		June 2017
46391dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
46491dabc54SAdam ThomsonDescription:
46591dabc54SAdam Thomson		Reports the charging current applied during pre-charging phase
46691dabc54SAdam Thomson		for a battery charge cycle.
46791dabc54SAdam Thomson
46891dabc54SAdam Thomson		Access: Read
46934433332SMauro Carvalho Chehab
47091dabc54SAdam Thomson		Valid values: Represented in microamps
47191dabc54SAdam Thomson
47291dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/present
47391dabc54SAdam ThomsonDate:		May 2007
47491dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
47591dabc54SAdam ThomsonDescription:
476f0cf0575SBastien Nocera		Reports whether a battery is present or not in the system. If the
477f0cf0575SBastien Nocera		property does not exist, the battery is considered to be present.
47891dabc54SAdam Thomson
47991dabc54SAdam Thomson		Access: Read
48034433332SMauro Carvalho Chehab
48191dabc54SAdam Thomson		Valid values:
48234433332SMauro Carvalho Chehab
48334433332SMauro Carvalho Chehab			== =======
48491dabc54SAdam Thomson			0: Absent
48591dabc54SAdam Thomson			1: Present
48634433332SMauro Carvalho Chehab			== =======
48791dabc54SAdam Thomson
48891dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/status
48991dabc54SAdam ThomsonDate:		May 2007
49091dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
49191dabc54SAdam ThomsonDescription:
49291dabc54SAdam Thomson		Represents the charging status of the battery. Normally this
49391dabc54SAdam Thomson		is read-only reporting although for some supplies this can be
49491dabc54SAdam Thomson		used to enable/disable charging to the battery.
49591dabc54SAdam Thomson
49691dabc54SAdam Thomson		Access: Read, Write
49734433332SMauro Carvalho Chehab
49834433332SMauro Carvalho Chehab		Valid values:
49934433332SMauro Carvalho Chehab			      "Unknown", "Charging", "Discharging",
50091dabc54SAdam Thomson			      "Not charging", "Full"
50191dabc54SAdam Thomson
5021b0b6cc8SThomas WeißschuhWhat:		/sys/class/power_supply/<supply_name>/charge_behaviour
5031b0b6cc8SThomas WeißschuhDate:		November 2021
5041b0b6cc8SThomas WeißschuhContact:	linux-pm@vger.kernel.org
5051b0b6cc8SThomas WeißschuhDescription:
5061b0b6cc8SThomas Weißschuh		Represents the charging behaviour.
5071b0b6cc8SThomas Weißschuh
5081b0b6cc8SThomas Weißschuh		Access: Read, Write
5091b0b6cc8SThomas Weißschuh
5101b0b6cc8SThomas Weißschuh		Valid values:
5116c9ffa2aSAntheas Kapenekakis			===================== ========================================
5121b0b6cc8SThomas Weißschuh			auto:                 Charge normally, respect thresholds
5131b0b6cc8SThomas Weißschuh			inhibit-charge:       Do not charge while AC is attached
5146c9ffa2aSAntheas Kapenekakis			inhibit-charge-awake: inhibit-charge only when device is awake
5151b0b6cc8SThomas Weißschuh			force-discharge:      Force discharge while AC is attached
5166c9ffa2aSAntheas Kapenekakis			===================== ========================================
5171b0b6cc8SThomas Weißschuh
51891dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/technology
51991dabc54SAdam ThomsonDate:		May 2007
52091dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
52191dabc54SAdam ThomsonDescription:
52291dabc54SAdam Thomson		Describes the battery technology supported by the supply.
52391dabc54SAdam Thomson
52491dabc54SAdam Thomson		Access: Read
52534433332SMauro Carvalho Chehab
52634433332SMauro Carvalho Chehab		Valid values:
52734433332SMauro Carvalho Chehab			      "Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe",
52891dabc54SAdam Thomson			      "NiCd", "LiMn"
52991dabc54SAdam Thomson
53091dabc54SAdam Thomson
53191dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/voltage_avg,
53291dabc54SAdam ThomsonDate:		May 2007
53391dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
53491dabc54SAdam ThomsonDescription:
53591dabc54SAdam Thomson		Reports an average VBAT voltage reading for the battery, over a
53691dabc54SAdam Thomson		fixed period. Normally devices will provide a fixed interval in
53791dabc54SAdam Thomson		which they average readings to smooth out the reported value.
53891dabc54SAdam Thomson
53991dabc54SAdam Thomson		Access: Read
54034433332SMauro Carvalho Chehab
54191dabc54SAdam Thomson		Valid values: Represented in microvolts
54291dabc54SAdam Thomson
5435d1f642aSHans de GoedeWhat:		/sys/class/power_supply/<supply_name>/cycle_count
5445d1f642aSHans de GoedeDate:		January 2010
5455d1f642aSHans de GoedeContact:	linux-pm@vger.kernel.org
5465d1f642aSHans de GoedeDescription:
5475d1f642aSHans de Goede		Reports the number of full charge + discharge cycles the
5485d1f642aSHans de Goede		battery has undergone.
5495d1f642aSHans de Goede
5505d1f642aSHans de Goede		Access: Read
5515d1f642aSHans de Goede
5525d1f642aSHans de Goede		Valid values:
5535d1f642aSHans de Goede			Integer > 0: representing full cycles
5545d1f642aSHans de Goede			Integer = 0: cycle_count info is not available
5555d1f642aSHans de Goede
556d69ae81eSFenglin WuWhat:		/sys/class/power_supply/<supply_name>/internal_resistance
557d69ae81eSFenglin WuDate:		August 2025
558d69ae81eSFenglin WuContact:	linux-arm-msm@vger.kernel.org
559d69ae81eSFenglin WuDescription:
560d69ae81eSFenglin Wu		Represent the battery's internal resistance, often referred
561d69ae81eSFenglin Wu		to as Equivalent Series Resistance (ESR). It is a dynamic
562d69ae81eSFenglin Wu		parameter that reflects the opposition to current flow within
563d69ae81eSFenglin Wu		the cell. It is not a fixed value but varies significantly
564d69ae81eSFenglin Wu		based on several operational conditions, including battery
565d69ae81eSFenglin Wu		state of charge (SoC), temperature, and whether the battery
566d69ae81eSFenglin Wu		is in a charging or discharging state.
567d69ae81eSFenglin Wu
568d69ae81eSFenglin Wu		Access: Read
569d69ae81eSFenglin Wu
570d69ae81eSFenglin Wu		Valid values: Represented in microohms
571d69ae81eSFenglin Wu
572*cd93fbdcSFenglin WuWhat:		/sys/class/power_supply/<supply_name>/state_of_health
573*cd93fbdcSFenglin WuDate:		August 2025
574*cd93fbdcSFenglin WuContact:	linux-arm-msm@vger.kernel.org
575*cd93fbdcSFenglin WuDescription:
576*cd93fbdcSFenglin Wu		The state_of_health parameter quantifies the overall condition
577*cd93fbdcSFenglin Wu		of a battery as a percentage, reflecting its ability to deliver
578*cd93fbdcSFenglin Wu		rated performance relative to its original specifications. It is
579*cd93fbdcSFenglin Wu		dynamically computed using a combination of learned capacity
580*cd93fbdcSFenglin Wu		and impedance-based degradation indicators, both of which evolve
581*cd93fbdcSFenglin Wu		over the battery's lifecycle.
582*cd93fbdcSFenglin Wu		Note that the exact algorithms are kept secret by most battery
583*cd93fbdcSFenglin Wu		vendors and the value from different battery vendors cannot be
584*cd93fbdcSFenglin Wu		compared with each other as there is no vendor-agnostic definition
585*cd93fbdcSFenglin Wu		of "performance". Also this usually cannot be used for any
586*cd93fbdcSFenglin Wu		calculations (i.e. this is not the factor between charge_full and
587*cd93fbdcSFenglin Wu		charge_full_design).
588*cd93fbdcSFenglin Wu
589*cd93fbdcSFenglin Wu		Access: Read
590*cd93fbdcSFenglin Wu
591*cd93fbdcSFenglin Wu		Valid values: 0 - 100 (percent)
592*cd93fbdcSFenglin Wu
59334433332SMauro Carvalho Chehab**USB Properties**
59491dabc54SAdam Thomson
59591dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/input_current_limit
59691dabc54SAdam ThomsonDate:		July 2014
59791dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
59891dabc54SAdam ThomsonDescription:
59991dabc54SAdam Thomson		Details the incoming IBUS current limit currently set in the
60091dabc54SAdam Thomson		supply. Normally this is configured based on the type of
60191dabc54SAdam Thomson		connection made (e.g. A configured SDP should output a maximum
60291dabc54SAdam Thomson		of 500mA so the input current limit is set to the same value).
603a4496d52SEnric Balletbo i Serra		Use preferably input_power_limit, and for problems that can be
604a4496d52SEnric Balletbo i Serra		solved using power limit use input_current_limit.
60591dabc54SAdam Thomson
60691dabc54SAdam Thomson		Access: Read, Write
60734433332SMauro Carvalho Chehab
60891dabc54SAdam Thomson		Valid values: Represented in microamps
60991dabc54SAdam Thomson
610a4496d52SEnric Balletbo i SerraWhat:		/sys/class/power_supply/<supply_name>/input_voltage_limit
611a4496d52SEnric Balletbo i SerraDate:		May 2019
612a4496d52SEnric Balletbo i SerraContact:	linux-pm@vger.kernel.org
613a4496d52SEnric Balletbo i SerraDescription:
614a4496d52SEnric Balletbo i Serra		This entry configures the incoming VBUS voltage limit currently
615a4496d52SEnric Balletbo i Serra		set in the supply. Normally this is configured based on
616a4496d52SEnric Balletbo i Serra		system-level knowledge or user input (e.g. This is part of the
617a4496d52SEnric Balletbo i Serra		Pixel C's thermal management strategy to effectively limit the
618a4496d52SEnric Balletbo i Serra		input power to 5V when the screen is on to meet Google's skin
619a4496d52SEnric Balletbo i Serra		temperature targets). Note that this feature should not be
620a4496d52SEnric Balletbo i Serra		used for safety critical things.
621a4496d52SEnric Balletbo i Serra		Use preferably input_power_limit, and for problems that can be
622a4496d52SEnric Balletbo i Serra		solved using power limit use input_voltage_limit.
623a4496d52SEnric Balletbo i Serra
624a4496d52SEnric Balletbo i Serra		Access: Read, Write
62554a19b4dSMauro Carvalho Chehab
626a4496d52SEnric Balletbo i Serra		Valid values: Represented in microvolts
627a4496d52SEnric Balletbo i Serra
628a4496d52SEnric Balletbo i SerraWhat:		/sys/class/power_supply/<supply_name>/input_power_limit
629a4496d52SEnric Balletbo i SerraDate:		May 2019
630a4496d52SEnric Balletbo i SerraContact:	linux-pm@vger.kernel.org
631a4496d52SEnric Balletbo i SerraDescription:
632a4496d52SEnric Balletbo i Serra		This entry configures the incoming power limit currently set
633a4496d52SEnric Balletbo i Serra		in the supply. Normally this is configured based on
634a4496d52SEnric Balletbo i Serra		system-level knowledge or user input. Use preferably this
635a4496d52SEnric Balletbo i Serra		feature to limit the incoming power and use current/voltage
636a4496d52SEnric Balletbo i Serra		limit only for problems that can be solved using power limit.
637a4496d52SEnric Balletbo i Serra
638a4496d52SEnric Balletbo i Serra		Access: Read, Write
63954a19b4dSMauro Carvalho Chehab
640a4496d52SEnric Balletbo i Serra		Valid values: Represented in microwatts
641a4496d52SEnric Balletbo i Serra
64291dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/online,
64391dabc54SAdam ThomsonDate:		May 2007
64491dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
64591dabc54SAdam ThomsonDescription:
64691dabc54SAdam Thomson		Indicates if VBUS is present for the supply. When the supply is
64791dabc54SAdam Thomson		online, and the supply allows it, then it's possible to switch
64891dabc54SAdam Thomson		between online states (e.g. Fixed -> Programmable for a PD_PPS
64991dabc54SAdam Thomson		USB supply so voltage and current can be controlled).
65091dabc54SAdam Thomson
65191dabc54SAdam Thomson		Access: Read, Write
65234433332SMauro Carvalho Chehab
65391dabc54SAdam Thomson		Valid values:
65434433332SMauro Carvalho Chehab
65534433332SMauro Carvalho Chehab			== ==================================================
65691dabc54SAdam Thomson			0: Offline
65791dabc54SAdam Thomson			1: Online Fixed - Fixed Voltage Supply
65891dabc54SAdam Thomson			2: Online Programmable - Programmable Voltage Supply
65934433332SMauro Carvalho Chehab			== ==================================================
66091dabc54SAdam Thomson
661cf450041SAdam ThomsonWhat: 		/sys/class/power_supply/<supply_name>/usb_type
662cf450041SAdam ThomsonDate:		March 2018
663cf450041SAdam ThomsonContact:	linux-pm@vger.kernel.org
664cf450041SAdam ThomsonDescription:
665cf450041SAdam Thomson		Reports what type of USB connection is currently active for
666cf450041SAdam Thomson		the supply, for example it can show if USB-PD capable source
667cf450041SAdam Thomson		is attached.
668cf450041SAdam Thomson
6690d9af1e1SHans de Goede		Access: For power-supplies which consume USB power such
6700d9af1e1SHans de Goede		as battery charger chips, this indicates the type of
6710d9af1e1SHans de Goede		the connected USB power source and is Read-Only.
6720d9af1e1SHans de Goede
6730d9af1e1SHans de Goede		For power-supplies which act as a USB power-source such as
6740d9af1e1SHans de Goede		e.g. the UCS1002 USB Port Power Controller this is writable.
67534433332SMauro Carvalho Chehab
67634433332SMauro Carvalho Chehab		Valid values:
67734433332SMauro Carvalho Chehab			      "Unknown", "SDP", "DCP", "CDP", "ACA", "C", "PD",
678cf450041SAdam Thomson			      "PD_DRP", "PD_PPS", "BrickID"
679cf450041SAdam Thomson
68034433332SMauro Carvalho Chehab**Device Specific Properties**
68191dabc54SAdam Thomson
68224af3202SDaniel MackWhat:		/sys/class/power/ds2760-battery.*/charge_now
68324af3202SDaniel MackDate:		May 2010
68424af3202SDaniel MackKernelVersion:	2.6.35
68524af3202SDaniel MackContact:	Daniel Mack <daniel@caiaq.de>
68624af3202SDaniel MackDescription:
68724af3202SDaniel Mack		This file is writeable and can be used to set the current
68824af3202SDaniel Mack		coloumb counter value inside the battery monitor chip. This
68924af3202SDaniel Mack		is needed for unavoidable corrections of aging batteries.
69024af3202SDaniel Mack		A userspace daemon can monitor the battery charging logic
69124af3202SDaniel Mack		and once the counter drops out of considerable bounds, take
69224af3202SDaniel Mack		appropriate action.
69324af3202SDaniel Mack
69424af3202SDaniel MackWhat:		/sys/class/power/ds2760-battery.*/charge_full
69524af3202SDaniel MackDate:		May 2010
69624af3202SDaniel MackKernelVersion:	2.6.35
69724af3202SDaniel MackContact:	Daniel Mack <daniel@caiaq.de>
69824af3202SDaniel MackDescription:
69924af3202SDaniel Mack		This file is writeable and can be used to set the assumed
70024af3202SDaniel Mack		battery 'full level'. As batteries age, this value has to be
70124af3202SDaniel Mack		amended over time.
702d6cc1f58SKrzysztof Kozlowski
703d6cc1f58SKrzysztof KozlowskiWhat:		/sys/class/power_supply/max14577-charger/device/fast_charge_timer
704c8c5ebccSKrzysztof KozlowskiDate:		October 2014
705d6cc1f58SKrzysztof KozlowskiKernelVersion:	3.18.0
7061c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
707d6cc1f58SKrzysztof KozlowskiDescription:
708d6cc1f58SKrzysztof Kozlowski		This entry shows and sets the maximum time the max14577
709d6cc1f58SKrzysztof Kozlowski		charger operates in fast-charge mode. When the timer expires
710d6cc1f58SKrzysztof Kozlowski		the device will terminate fast-charge mode (charging current
711d6cc1f58SKrzysztof Kozlowski		will drop to 0 A) and will trigger interrupt.
712d6cc1f58SKrzysztof Kozlowski
713d6cc1f58SKrzysztof Kozlowski		Valid values:
71434433332SMauro Carvalho Chehab
715d6cc1f58SKrzysztof Kozlowski		- 5, 6 or 7 (hours),
716d6cc1f58SKrzysztof Kozlowski		- 0: disabled.
7176b23becdSKrzysztof Kozlowski
7186b23becdSKrzysztof KozlowskiWhat:		/sys/class/power_supply/max77693-charger/device/fast_charge_timer
7196b23becdSKrzysztof KozlowskiDate:		January 2015
7206b23becdSKrzysztof KozlowskiKernelVersion:	3.19.0
7211c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
7226b23becdSKrzysztof KozlowskiDescription:
7236b23becdSKrzysztof Kozlowski		This entry shows and sets the maximum time the max77693
7246b23becdSKrzysztof Kozlowski		charger operates in fast-charge mode. When the timer expires
7256b23becdSKrzysztof Kozlowski		the device will terminate fast-charge mode (charging current
7266b23becdSKrzysztof Kozlowski		will drop to 0 A) and will trigger interrupt.
7276b23becdSKrzysztof Kozlowski
7286b23becdSKrzysztof Kozlowski		Valid values:
72934433332SMauro Carvalho Chehab
7306b23becdSKrzysztof Kozlowski		- 4 - 16 (hours), step by 2 (rounded down)
7316b23becdSKrzysztof Kozlowski		- 0: disabled.
7326b23becdSKrzysztof Kozlowski
7336b23becdSKrzysztof KozlowskiWhat:		/sys/class/power_supply/max77693-charger/device/top_off_threshold_current
7346b23becdSKrzysztof KozlowskiDate:		January 2015
7356b23becdSKrzysztof KozlowskiKernelVersion:	3.19.0
7361c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
7376b23becdSKrzysztof KozlowskiDescription:
7386b23becdSKrzysztof Kozlowski		This entry shows and sets the charging current threshold for
7396b23becdSKrzysztof Kozlowski		entering top-off charging mode. When charging current in fast
7406b23becdSKrzysztof Kozlowski		charge mode drops below this value, the charger will trigger
7416b23becdSKrzysztof Kozlowski		interrupt and start top-off charging mode.
7426b23becdSKrzysztof Kozlowski
7436b23becdSKrzysztof Kozlowski		Valid values:
74434433332SMauro Carvalho Chehab
7456b23becdSKrzysztof Kozlowski		- 100000 - 200000 (microamps), step by 25000 (rounded down)
7466b23becdSKrzysztof Kozlowski		- 200000 - 350000 (microamps), step by 50000 (rounded down)
7476b23becdSKrzysztof Kozlowski		- 0: disabled.
7486b23becdSKrzysztof Kozlowski
7496b23becdSKrzysztof KozlowskiWhat:		/sys/class/power_supply/max77693-charger/device/top_off_timer
7506b23becdSKrzysztof KozlowskiDate:		January 2015
7516b23becdSKrzysztof KozlowskiKernelVersion:	3.19.0
7521c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
7536b23becdSKrzysztof KozlowskiDescription:
7546b23becdSKrzysztof Kozlowski		This entry shows and sets the maximum time the max77693
7556b23becdSKrzysztof Kozlowski		charger operates in top-off charge mode. When the timer expires
7566b23becdSKrzysztof Kozlowski		the device will terminate top-off charge mode (charging current
7576b23becdSKrzysztof Kozlowski		will drop to 0 A) and will trigger interrupt.
7586b23becdSKrzysztof Kozlowski
7596b23becdSKrzysztof Kozlowski		Valid values:
76034433332SMauro Carvalho Chehab
7616b23becdSKrzysztof Kozlowski		- 0 - 70 (minutes), step by 10 (rounded down)
7626169588fSAndreas Dannenberg
7636169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/ovp_voltage
7646169588fSAndreas DannenbergDate:		October 2015
7656169588fSAndreas DannenbergKernelVersion:	4.4.0
7666169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
7676169588fSAndreas DannenbergDescription:
7686169588fSAndreas Dannenberg		This entry configures the overvoltage protection feature of bq24257-
7696169588fSAndreas Dannenberg		type charger devices. This feature protects the device and other
7706169588fSAndreas Dannenberg		components against damage from overvoltage on the input supply. See
7716169588fSAndreas Dannenberg		device datasheet for details.
7726169588fSAndreas Dannenberg
7736169588fSAndreas Dannenberg		Valid values:
77434433332SMauro Carvalho Chehab
7756169588fSAndreas Dannenberg		- 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000,
7766169588fSAndreas Dannenberg		  10500000 (all uV)
7776169588fSAndreas Dannenberg
7786169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/in_dpm_voltage
7796169588fSAndreas DannenbergDate:		October 2015
7806169588fSAndreas DannenbergKernelVersion:	4.4.0
7816169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
7826169588fSAndreas DannenbergDescription:
7836169588fSAndreas Dannenberg		This entry configures the input dynamic power path management voltage of
7846169588fSAndreas Dannenberg		bq24257-type charger devices. Once the supply drops to the configured
7856169588fSAndreas Dannenberg		voltage, the input current limit is reduced down to prevent the further
7866169588fSAndreas Dannenberg		drop of the supply. When the IC enters this mode, the charge current is
7876169588fSAndreas Dannenberg		lower than the set value. See device datasheet for details.
7886169588fSAndreas Dannenberg
7896169588fSAndreas Dannenberg		Valid values:
79034433332SMauro Carvalho Chehab
7916169588fSAndreas Dannenberg		- 4200000, 4280000, 4360000, 4440000, 4520000, 4600000, 4680000,
7926169588fSAndreas Dannenberg		  4760000 (all uV)
7936169588fSAndreas Dannenberg
7946169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/high_impedance_enable
7956169588fSAndreas DannenbergDate:		October 2015
7966169588fSAndreas DannenbergKernelVersion:	4.4.0
7976169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
7986169588fSAndreas DannenbergDescription:
7996169588fSAndreas Dannenberg		This entry allows enabling the high-impedance mode of bq24257-type
8006169588fSAndreas Dannenberg		charger devices. If enabled, it places the charger IC into low power
8016169588fSAndreas Dannenberg		standby mode with the switch mode controller disabled. When disabled,
8026169588fSAndreas Dannenberg		the charger operates normally. See device datasheet for details.
8036169588fSAndreas Dannenberg
8046169588fSAndreas Dannenberg		Valid values:
80534433332SMauro Carvalho Chehab
8066169588fSAndreas Dannenberg		- 1: enabled
8076169588fSAndreas Dannenberg		- 0: disabled
8086169588fSAndreas Dannenberg
8096169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/sysoff_enable
8106169588fSAndreas DannenbergDate:		October 2015
8116169588fSAndreas DannenbergKernelVersion:	4.4.0
8126169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
8136169588fSAndreas DannenbergDescription:
8146169588fSAndreas Dannenberg		This entry allows enabling the sysoff mode of bq24257-type charger
8156169588fSAndreas Dannenberg		devices. If enabled and the input is removed, the internal battery FET
8166169588fSAndreas Dannenberg		is turned off in order to reduce the leakage from the BAT pin to less
8176169588fSAndreas Dannenberg		than 1uA. Note that on some devices/systems this disconnects the battery
8186169588fSAndreas Dannenberg		from the system. See device datasheet for details.
8196169588fSAndreas Dannenberg
8206169588fSAndreas Dannenberg		Valid values:
82134433332SMauro Carvalho Chehab
8226169588fSAndreas Dannenberg		- 1: enabled
8236169588fSAndreas Dannenberg		- 0: disabled
824feabe49eSSebastian Reichel
825feabe49eSSebastian ReichelWhat:		/sys/class/power_supply/<supply_name>/manufacture_year
826feabe49eSSebastian ReichelDate:		January 2020
827feabe49eSSebastian ReichelContact:	linux-pm@vger.kernel.org
828feabe49eSSebastian ReichelDescription:
829feabe49eSSebastian Reichel		Reports the year (following Gregorian calendar) when the device has been
830feabe49eSSebastian Reichel		manufactured.
831feabe49eSSebastian Reichel
832feabe49eSSebastian Reichel		Access: Read
83354a19b4dSMauro Carvalho Chehab
834feabe49eSSebastian Reichel		Valid values: Reported as integer
835feabe49eSSebastian Reichel
836feabe49eSSebastian ReichelWhat:		/sys/class/power_supply/<supply_name>/manufacture_month
837feabe49eSSebastian ReichelDate:		January 2020
838feabe49eSSebastian ReichelContact:	linux-pm@vger.kernel.org
839feabe49eSSebastian ReichelDescription:
840feabe49eSSebastian Reichel		Reports the month when the device has been manufactured.
841feabe49eSSebastian Reichel
842feabe49eSSebastian Reichel		Access: Read
84354a19b4dSMauro Carvalho Chehab
844feabe49eSSebastian Reichel		Valid values: 1-12
845feabe49eSSebastian Reichel
846feabe49eSSebastian ReichelWhat:		/sys/class/power_supply/<supply_name>/manufacture_day
847feabe49eSSebastian ReichelDate:		January 2020
848feabe49eSSebastian ReichelContact:	linux-pm@vger.kernel.org
849feabe49eSSebastian ReichelDescription:
850feabe49eSSebastian Reichel		Reports the day of month when the device has been manufactured.
851feabe49eSSebastian Reichel
852feabe49eSSebastian Reichel		Access: Read
853feabe49eSSebastian Reichel		Valid values: 1-31
854288a2cabSThomas Weißschuh
855288a2cabSThomas WeißschuhWhat:		/sys/class/power_supply/<supply_name>/extensions/<extension_name>
856288a2cabSThomas WeißschuhDate:		March 2025
857288a2cabSThomas WeißschuhContact:	linux-pm@vger.kernel.org
858288a2cabSThomas WeißschuhDescription:
859288a2cabSThomas Weißschuh		Reports the extensions registered to the power supply.
860288a2cabSThomas Weißschuh		Each entry is a link to the device which registered the extension.
861288a2cabSThomas Weißschuh
862288a2cabSThomas Weißschuh		Access: Read
86360cd40eeSSvyatoslav Ryhel
86460cd40eeSSvyatoslav RyhelWhat:		/sys/class/power_supply/max8971-charger/fast_charge_timer
86560cd40eeSSvyatoslav RyhelDate:		May 2025
86660cd40eeSSvyatoslav RyhelKernelVersion:	6.15.0
86760cd40eeSSvyatoslav RyhelContact:	Svyatoslav Ryhel <clamor95@gmail.com>
86860cd40eeSSvyatoslav RyhelDescription:
86960cd40eeSSvyatoslav Ryhel		This entry shows and sets the maximum time the max8971
87060cd40eeSSvyatoslav Ryhel		charger operates in fast-charge mode. When the timer expires
87160cd40eeSSvyatoslav Ryhel		the device will terminate fast-charge mode (charging current
87260cd40eeSSvyatoslav Ryhel		will drop to 0 A) and will trigger interrupt.
87360cd40eeSSvyatoslav Ryhel
87460cd40eeSSvyatoslav Ryhel		Valid values:
87560cd40eeSSvyatoslav Ryhel
87660cd40eeSSvyatoslav Ryhel		- 4 - 10 (hours), step by 1
87760cd40eeSSvyatoslav Ryhel		- 0: disabled.
87860cd40eeSSvyatoslav Ryhel
87960cd40eeSSvyatoslav RyhelWhat:		/sys/class/power_supply/max8971-charger/top_off_threshold_current
88060cd40eeSSvyatoslav RyhelDate:		May 2025
88160cd40eeSSvyatoslav RyhelKernelVersion:	6.15.0
88260cd40eeSSvyatoslav RyhelContact:	Svyatoslav Ryhel <clamor95@gmail.com>
88360cd40eeSSvyatoslav RyhelDescription:
88460cd40eeSSvyatoslav Ryhel		This entry shows and sets the charging current threshold for
88560cd40eeSSvyatoslav Ryhel		entering top-off charging mode. When charging current in fast
88660cd40eeSSvyatoslav Ryhel		charge mode drops below this value, the charger will trigger
88760cd40eeSSvyatoslav Ryhel		interrupt and start top-off charging mode.
88860cd40eeSSvyatoslav Ryhel
88960cd40eeSSvyatoslav Ryhel		Valid values:
89060cd40eeSSvyatoslav Ryhel
89160cd40eeSSvyatoslav Ryhel		- 50000 - 200000 (microamps), step by 50000 (rounded down)
89260cd40eeSSvyatoslav Ryhel
89360cd40eeSSvyatoslav RyhelWhat:		/sys/class/power_supply/max8971-charger/top_off_timer
89460cd40eeSSvyatoslav RyhelDate:		May 2025
89560cd40eeSSvyatoslav RyhelKernelVersion:	6.15.0
89660cd40eeSSvyatoslav RyhelContact:	Svyatoslav Ryhel <clamor95@gmail.com>
89760cd40eeSSvyatoslav RyhelDescription:
89860cd40eeSSvyatoslav Ryhel		This entry shows and sets the maximum time the max8971
89960cd40eeSSvyatoslav Ryhel		charger operates in top-off charge mode. When the timer expires
90060cd40eeSSvyatoslav Ryhel		the device will terminate top-off charge mode (charging current
90160cd40eeSSvyatoslav Ryhel		will drop to 0 A) and will trigger interrupt.
90260cd40eeSSvyatoslav Ryhel
90360cd40eeSSvyatoslav Ryhel		Valid values:
90460cd40eeSSvyatoslav Ryhel
90560cd40eeSSvyatoslav Ryhel		- 0 - 70 (minutes), step by 10 (rounded down)
906