xref: /linux/Documentation/ABI/testing/sysfs-class-power (revision 1193e205dbb6feca917dc8e1862ffcdf2194234b)
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",
459*f4856c20SArmin 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
55634433332SMauro Carvalho Chehab**USB Properties**
55791dabc54SAdam Thomson
55891dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/input_current_limit
55991dabc54SAdam ThomsonDate:		July 2014
56091dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
56191dabc54SAdam ThomsonDescription:
56291dabc54SAdam Thomson		Details the incoming IBUS current limit currently set in the
56391dabc54SAdam Thomson		supply. Normally this is configured based on the type of
56491dabc54SAdam Thomson		connection made (e.g. A configured SDP should output a maximum
56591dabc54SAdam Thomson		of 500mA so the input current limit is set to the same value).
566a4496d52SEnric Balletbo i Serra		Use preferably input_power_limit, and for problems that can be
567a4496d52SEnric Balletbo i Serra		solved using power limit use input_current_limit.
56891dabc54SAdam Thomson
56991dabc54SAdam Thomson		Access: Read, Write
57034433332SMauro Carvalho Chehab
57191dabc54SAdam Thomson		Valid values: Represented in microamps
57291dabc54SAdam Thomson
573a4496d52SEnric Balletbo i SerraWhat:		/sys/class/power_supply/<supply_name>/input_voltage_limit
574a4496d52SEnric Balletbo i SerraDate:		May 2019
575a4496d52SEnric Balletbo i SerraContact:	linux-pm@vger.kernel.org
576a4496d52SEnric Balletbo i SerraDescription:
577a4496d52SEnric Balletbo i Serra		This entry configures the incoming VBUS voltage limit currently
578a4496d52SEnric Balletbo i Serra		set in the supply. Normally this is configured based on
579a4496d52SEnric Balletbo i Serra		system-level knowledge or user input (e.g. This is part of the
580a4496d52SEnric Balletbo i Serra		Pixel C's thermal management strategy to effectively limit the
581a4496d52SEnric Balletbo i Serra		input power to 5V when the screen is on to meet Google's skin
582a4496d52SEnric Balletbo i Serra		temperature targets). Note that this feature should not be
583a4496d52SEnric Balletbo i Serra		used for safety critical things.
584a4496d52SEnric Balletbo i Serra		Use preferably input_power_limit, and for problems that can be
585a4496d52SEnric Balletbo i Serra		solved using power limit use input_voltage_limit.
586a4496d52SEnric Balletbo i Serra
587a4496d52SEnric Balletbo i Serra		Access: Read, Write
58854a19b4dSMauro Carvalho Chehab
589a4496d52SEnric Balletbo i Serra		Valid values: Represented in microvolts
590a4496d52SEnric Balletbo i Serra
591a4496d52SEnric Balletbo i SerraWhat:		/sys/class/power_supply/<supply_name>/input_power_limit
592a4496d52SEnric Balletbo i SerraDate:		May 2019
593a4496d52SEnric Balletbo i SerraContact:	linux-pm@vger.kernel.org
594a4496d52SEnric Balletbo i SerraDescription:
595a4496d52SEnric Balletbo i Serra		This entry configures the incoming power limit currently set
596a4496d52SEnric Balletbo i Serra		in the supply. Normally this is configured based on
597a4496d52SEnric Balletbo i Serra		system-level knowledge or user input. Use preferably this
598a4496d52SEnric Balletbo i Serra		feature to limit the incoming power and use current/voltage
599a4496d52SEnric Balletbo i Serra		limit only for problems that can be solved using power limit.
600a4496d52SEnric Balletbo i Serra
601a4496d52SEnric Balletbo i Serra		Access: Read, Write
60254a19b4dSMauro Carvalho Chehab
603a4496d52SEnric Balletbo i Serra		Valid values: Represented in microwatts
604a4496d52SEnric Balletbo i Serra
60591dabc54SAdam ThomsonWhat:		/sys/class/power_supply/<supply_name>/online,
60691dabc54SAdam ThomsonDate:		May 2007
60791dabc54SAdam ThomsonContact:	linux-pm@vger.kernel.org
60891dabc54SAdam ThomsonDescription:
60991dabc54SAdam Thomson		Indicates if VBUS is present for the supply. When the supply is
61091dabc54SAdam Thomson		online, and the supply allows it, then it's possible to switch
61191dabc54SAdam Thomson		between online states (e.g. Fixed -> Programmable for a PD_PPS
61291dabc54SAdam Thomson		USB supply so voltage and current can be controlled).
61391dabc54SAdam Thomson
61491dabc54SAdam Thomson		Access: Read, Write
61534433332SMauro Carvalho Chehab
61691dabc54SAdam Thomson		Valid values:
61734433332SMauro Carvalho Chehab
61834433332SMauro Carvalho Chehab			== ==================================================
61991dabc54SAdam Thomson			0: Offline
62091dabc54SAdam Thomson			1: Online Fixed - Fixed Voltage Supply
62191dabc54SAdam Thomson			2: Online Programmable - Programmable Voltage Supply
62234433332SMauro Carvalho Chehab			== ==================================================
62391dabc54SAdam Thomson
624cf450041SAdam ThomsonWhat: 		/sys/class/power_supply/<supply_name>/usb_type
625cf450041SAdam ThomsonDate:		March 2018
626cf450041SAdam ThomsonContact:	linux-pm@vger.kernel.org
627cf450041SAdam ThomsonDescription:
628cf450041SAdam Thomson		Reports what type of USB connection is currently active for
629cf450041SAdam Thomson		the supply, for example it can show if USB-PD capable source
630cf450041SAdam Thomson		is attached.
631cf450041SAdam Thomson
6320d9af1e1SHans de Goede		Access: For power-supplies which consume USB power such
6330d9af1e1SHans de Goede		as battery charger chips, this indicates the type of
6340d9af1e1SHans de Goede		the connected USB power source and is Read-Only.
6350d9af1e1SHans de Goede
6360d9af1e1SHans de Goede		For power-supplies which act as a USB power-source such as
6370d9af1e1SHans de Goede		e.g. the UCS1002 USB Port Power Controller this is writable.
63834433332SMauro Carvalho Chehab
63934433332SMauro Carvalho Chehab		Valid values:
64034433332SMauro Carvalho Chehab			      "Unknown", "SDP", "DCP", "CDP", "ACA", "C", "PD",
641cf450041SAdam Thomson			      "PD_DRP", "PD_PPS", "BrickID"
642cf450041SAdam Thomson
64334433332SMauro Carvalho Chehab**Device Specific Properties**
64491dabc54SAdam Thomson
64524af3202SDaniel MackWhat:		/sys/class/power/ds2760-battery.*/charge_now
64624af3202SDaniel MackDate:		May 2010
64724af3202SDaniel MackKernelVersion:	2.6.35
64824af3202SDaniel MackContact:	Daniel Mack <daniel@caiaq.de>
64924af3202SDaniel MackDescription:
65024af3202SDaniel Mack		This file is writeable and can be used to set the current
65124af3202SDaniel Mack		coloumb counter value inside the battery monitor chip. This
65224af3202SDaniel Mack		is needed for unavoidable corrections of aging batteries.
65324af3202SDaniel Mack		A userspace daemon can monitor the battery charging logic
65424af3202SDaniel Mack		and once the counter drops out of considerable bounds, take
65524af3202SDaniel Mack		appropriate action.
65624af3202SDaniel Mack
65724af3202SDaniel MackWhat:		/sys/class/power/ds2760-battery.*/charge_full
65824af3202SDaniel MackDate:		May 2010
65924af3202SDaniel MackKernelVersion:	2.6.35
66024af3202SDaniel MackContact:	Daniel Mack <daniel@caiaq.de>
66124af3202SDaniel MackDescription:
66224af3202SDaniel Mack		This file is writeable and can be used to set the assumed
66324af3202SDaniel Mack		battery 'full level'. As batteries age, this value has to be
66424af3202SDaniel Mack		amended over time.
665d6cc1f58SKrzysztof Kozlowski
666d6cc1f58SKrzysztof KozlowskiWhat:		/sys/class/power_supply/max14577-charger/device/fast_charge_timer
667c8c5ebccSKrzysztof KozlowskiDate:		October 2014
668d6cc1f58SKrzysztof KozlowskiKernelVersion:	3.18.0
6691c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
670d6cc1f58SKrzysztof KozlowskiDescription:
671d6cc1f58SKrzysztof Kozlowski		This entry shows and sets the maximum time the max14577
672d6cc1f58SKrzysztof Kozlowski		charger operates in fast-charge mode. When the timer expires
673d6cc1f58SKrzysztof Kozlowski		the device will terminate fast-charge mode (charging current
674d6cc1f58SKrzysztof Kozlowski		will drop to 0 A) and will trigger interrupt.
675d6cc1f58SKrzysztof Kozlowski
676d6cc1f58SKrzysztof Kozlowski		Valid values:
67734433332SMauro Carvalho Chehab
678d6cc1f58SKrzysztof Kozlowski		- 5, 6 or 7 (hours),
679d6cc1f58SKrzysztof Kozlowski		- 0: disabled.
6806b23becdSKrzysztof Kozlowski
6816b23becdSKrzysztof KozlowskiWhat:		/sys/class/power_supply/max77693-charger/device/fast_charge_timer
6826b23becdSKrzysztof KozlowskiDate:		January 2015
6836b23becdSKrzysztof KozlowskiKernelVersion:	3.19.0
6841c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
6856b23becdSKrzysztof KozlowskiDescription:
6866b23becdSKrzysztof Kozlowski		This entry shows and sets the maximum time the max77693
6876b23becdSKrzysztof Kozlowski		charger operates in fast-charge mode. When the timer expires
6886b23becdSKrzysztof Kozlowski		the device will terminate fast-charge mode (charging current
6896b23becdSKrzysztof Kozlowski		will drop to 0 A) and will trigger interrupt.
6906b23becdSKrzysztof Kozlowski
6916b23becdSKrzysztof Kozlowski		Valid values:
69234433332SMauro Carvalho Chehab
6936b23becdSKrzysztof Kozlowski		- 4 - 16 (hours), step by 2 (rounded down)
6946b23becdSKrzysztof Kozlowski		- 0: disabled.
6956b23becdSKrzysztof Kozlowski
6966b23becdSKrzysztof KozlowskiWhat:		/sys/class/power_supply/max77693-charger/device/top_off_threshold_current
6976b23becdSKrzysztof KozlowskiDate:		January 2015
6986b23becdSKrzysztof KozlowskiKernelVersion:	3.19.0
6991c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
7006b23becdSKrzysztof KozlowskiDescription:
7016b23becdSKrzysztof Kozlowski		This entry shows and sets the charging current threshold for
7026b23becdSKrzysztof Kozlowski		entering top-off charging mode. When charging current in fast
7036b23becdSKrzysztof Kozlowski		charge mode drops below this value, the charger will trigger
7046b23becdSKrzysztof Kozlowski		interrupt and start top-off charging mode.
7056b23becdSKrzysztof Kozlowski
7066b23becdSKrzysztof Kozlowski		Valid values:
70734433332SMauro Carvalho Chehab
7086b23becdSKrzysztof Kozlowski		- 100000 - 200000 (microamps), step by 25000 (rounded down)
7096b23becdSKrzysztof Kozlowski		- 200000 - 350000 (microamps), step by 50000 (rounded down)
7106b23becdSKrzysztof Kozlowski		- 0: disabled.
7116b23becdSKrzysztof Kozlowski
7126b23becdSKrzysztof KozlowskiWhat:		/sys/class/power_supply/max77693-charger/device/top_off_timer
7136b23becdSKrzysztof KozlowskiDate:		January 2015
7146b23becdSKrzysztof KozlowskiKernelVersion:	3.19.0
7151c4593edSKrzysztof KozlowskiContact:	Krzysztof Kozlowski <krzk@kernel.org>
7166b23becdSKrzysztof KozlowskiDescription:
7176b23becdSKrzysztof Kozlowski		This entry shows and sets the maximum time the max77693
7186b23becdSKrzysztof Kozlowski		charger operates in top-off charge mode. When the timer expires
7196b23becdSKrzysztof Kozlowski		the device will terminate top-off charge mode (charging current
7206b23becdSKrzysztof Kozlowski		will drop to 0 A) and will trigger interrupt.
7216b23becdSKrzysztof Kozlowski
7226b23becdSKrzysztof Kozlowski		Valid values:
72334433332SMauro Carvalho Chehab
7246b23becdSKrzysztof Kozlowski		- 0 - 70 (minutes), step by 10 (rounded down)
7256169588fSAndreas Dannenberg
7266169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/ovp_voltage
7276169588fSAndreas DannenbergDate:		October 2015
7286169588fSAndreas DannenbergKernelVersion:	4.4.0
7296169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
7306169588fSAndreas DannenbergDescription:
7316169588fSAndreas Dannenberg		This entry configures the overvoltage protection feature of bq24257-
7326169588fSAndreas Dannenberg		type charger devices. This feature protects the device and other
7336169588fSAndreas Dannenberg		components against damage from overvoltage on the input supply. See
7346169588fSAndreas Dannenberg		device datasheet for details.
7356169588fSAndreas Dannenberg
7366169588fSAndreas Dannenberg		Valid values:
73734433332SMauro Carvalho Chehab
7386169588fSAndreas Dannenberg		- 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000,
7396169588fSAndreas Dannenberg		  10500000 (all uV)
7406169588fSAndreas Dannenberg
7416169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/in_dpm_voltage
7426169588fSAndreas DannenbergDate:		October 2015
7436169588fSAndreas DannenbergKernelVersion:	4.4.0
7446169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
7456169588fSAndreas DannenbergDescription:
7466169588fSAndreas Dannenberg		This entry configures the input dynamic power path management voltage of
7476169588fSAndreas Dannenberg		bq24257-type charger devices. Once the supply drops to the configured
7486169588fSAndreas Dannenberg		voltage, the input current limit is reduced down to prevent the further
7496169588fSAndreas Dannenberg		drop of the supply. When the IC enters this mode, the charge current is
7506169588fSAndreas Dannenberg		lower than the set value. See device datasheet for details.
7516169588fSAndreas Dannenberg
7526169588fSAndreas Dannenberg		Valid values:
75334433332SMauro Carvalho Chehab
7546169588fSAndreas Dannenberg		- 4200000, 4280000, 4360000, 4440000, 4520000, 4600000, 4680000,
7556169588fSAndreas Dannenberg		  4760000 (all uV)
7566169588fSAndreas Dannenberg
7576169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/high_impedance_enable
7586169588fSAndreas DannenbergDate:		October 2015
7596169588fSAndreas DannenbergKernelVersion:	4.4.0
7606169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
7616169588fSAndreas DannenbergDescription:
7626169588fSAndreas Dannenberg		This entry allows enabling the high-impedance mode of bq24257-type
7636169588fSAndreas Dannenberg		charger devices. If enabled, it places the charger IC into low power
7646169588fSAndreas Dannenberg		standby mode with the switch mode controller disabled. When disabled,
7656169588fSAndreas Dannenberg		the charger operates normally. See device datasheet for details.
7666169588fSAndreas Dannenberg
7676169588fSAndreas Dannenberg		Valid values:
76834433332SMauro Carvalho Chehab
7696169588fSAndreas Dannenberg		- 1: enabled
7706169588fSAndreas Dannenberg		- 0: disabled
7716169588fSAndreas Dannenberg
7726169588fSAndreas DannenbergWhat:		/sys/class/power_supply/bq24257-charger/sysoff_enable
7736169588fSAndreas DannenbergDate:		October 2015
7746169588fSAndreas DannenbergKernelVersion:	4.4.0
7756169588fSAndreas DannenbergContact:	Andreas Dannenberg <dannenberg@ti.com>
7766169588fSAndreas DannenbergDescription:
7776169588fSAndreas Dannenberg		This entry allows enabling the sysoff mode of bq24257-type charger
7786169588fSAndreas Dannenberg		devices. If enabled and the input is removed, the internal battery FET
7796169588fSAndreas Dannenberg		is turned off in order to reduce the leakage from the BAT pin to less
7806169588fSAndreas Dannenberg		than 1uA. Note that on some devices/systems this disconnects the battery
7816169588fSAndreas Dannenberg		from the system. See device datasheet for details.
7826169588fSAndreas Dannenberg
7836169588fSAndreas Dannenberg		Valid values:
78434433332SMauro Carvalho Chehab
7856169588fSAndreas Dannenberg		- 1: enabled
7866169588fSAndreas Dannenberg		- 0: disabled
787feabe49eSSebastian Reichel
788feabe49eSSebastian ReichelWhat:		/sys/class/power_supply/<supply_name>/manufacture_year
789feabe49eSSebastian ReichelDate:		January 2020
790feabe49eSSebastian ReichelContact:	linux-pm@vger.kernel.org
791feabe49eSSebastian ReichelDescription:
792feabe49eSSebastian Reichel		Reports the year (following Gregorian calendar) when the device has been
793feabe49eSSebastian Reichel		manufactured.
794feabe49eSSebastian Reichel
795feabe49eSSebastian Reichel		Access: Read
79654a19b4dSMauro Carvalho Chehab
797feabe49eSSebastian Reichel		Valid values: Reported as integer
798feabe49eSSebastian Reichel
799feabe49eSSebastian ReichelWhat:		/sys/class/power_supply/<supply_name>/manufacture_month
800feabe49eSSebastian ReichelDate:		January 2020
801feabe49eSSebastian ReichelContact:	linux-pm@vger.kernel.org
802feabe49eSSebastian ReichelDescription:
803feabe49eSSebastian Reichel		Reports the month when the device has been manufactured.
804feabe49eSSebastian Reichel
805feabe49eSSebastian Reichel		Access: Read
80654a19b4dSMauro Carvalho Chehab
807feabe49eSSebastian Reichel		Valid values: 1-12
808feabe49eSSebastian Reichel
809feabe49eSSebastian ReichelWhat:		/sys/class/power_supply/<supply_name>/manufacture_day
810feabe49eSSebastian ReichelDate:		January 2020
811feabe49eSSebastian ReichelContact:	linux-pm@vger.kernel.org
812feabe49eSSebastian ReichelDescription:
813feabe49eSSebastian Reichel		Reports the day of month when the device has been manufactured.
814feabe49eSSebastian Reichel
815feabe49eSSebastian Reichel		Access: Read
816feabe49eSSebastian Reichel		Valid values: 1-31
817288a2cabSThomas Weißschuh
818288a2cabSThomas WeißschuhWhat:		/sys/class/power_supply/<supply_name>/extensions/<extension_name>
819288a2cabSThomas WeißschuhDate:		March 2025
820288a2cabSThomas WeißschuhContact:	linux-pm@vger.kernel.org
821288a2cabSThomas WeißschuhDescription:
822288a2cabSThomas Weißschuh		Reports the extensions registered to the power supply.
823288a2cabSThomas Weißschuh		Each entry is a link to the device which registered the extension.
824288a2cabSThomas Weißschuh
825288a2cabSThomas Weißschuh		Access: Read
82660cd40eeSSvyatoslav Ryhel
82760cd40eeSSvyatoslav RyhelWhat:		/sys/class/power_supply/max8971-charger/fast_charge_timer
82860cd40eeSSvyatoslav RyhelDate:		May 2025
82960cd40eeSSvyatoslav RyhelKernelVersion:	6.15.0
83060cd40eeSSvyatoslav RyhelContact:	Svyatoslav Ryhel <clamor95@gmail.com>
83160cd40eeSSvyatoslav RyhelDescription:
83260cd40eeSSvyatoslav Ryhel		This entry shows and sets the maximum time the max8971
83360cd40eeSSvyatoslav Ryhel		charger operates in fast-charge mode. When the timer expires
83460cd40eeSSvyatoslav Ryhel		the device will terminate fast-charge mode (charging current
83560cd40eeSSvyatoslav Ryhel		will drop to 0 A) and will trigger interrupt.
83660cd40eeSSvyatoslav Ryhel
83760cd40eeSSvyatoslav Ryhel		Valid values:
83860cd40eeSSvyatoslav Ryhel
83960cd40eeSSvyatoslav Ryhel		- 4 - 10 (hours), step by 1
84060cd40eeSSvyatoslav Ryhel		- 0: disabled.
84160cd40eeSSvyatoslav Ryhel
84260cd40eeSSvyatoslav RyhelWhat:		/sys/class/power_supply/max8971-charger/top_off_threshold_current
84360cd40eeSSvyatoslav RyhelDate:		May 2025
84460cd40eeSSvyatoslav RyhelKernelVersion:	6.15.0
84560cd40eeSSvyatoslav RyhelContact:	Svyatoslav Ryhel <clamor95@gmail.com>
84660cd40eeSSvyatoslav RyhelDescription:
84760cd40eeSSvyatoslav Ryhel		This entry shows and sets the charging current threshold for
84860cd40eeSSvyatoslav Ryhel		entering top-off charging mode. When charging current in fast
84960cd40eeSSvyatoslav Ryhel		charge mode drops below this value, the charger will trigger
85060cd40eeSSvyatoslav Ryhel		interrupt and start top-off charging mode.
85160cd40eeSSvyatoslav Ryhel
85260cd40eeSSvyatoslav Ryhel		Valid values:
85360cd40eeSSvyatoslav Ryhel
85460cd40eeSSvyatoslav Ryhel		- 50000 - 200000 (microamps), step by 50000 (rounded down)
85560cd40eeSSvyatoslav Ryhel
85660cd40eeSSvyatoslav RyhelWhat:		/sys/class/power_supply/max8971-charger/top_off_timer
85760cd40eeSSvyatoslav RyhelDate:		May 2025
85860cd40eeSSvyatoslav RyhelKernelVersion:	6.15.0
85960cd40eeSSvyatoslav RyhelContact:	Svyatoslav Ryhel <clamor95@gmail.com>
86060cd40eeSSvyatoslav RyhelDescription:
86160cd40eeSSvyatoslav Ryhel		This entry shows and sets the maximum time the max8971
86260cd40eeSSvyatoslav Ryhel		charger operates in top-off charge mode. When the timer expires
86360cd40eeSSvyatoslav Ryhel		the device will terminate top-off charge mode (charging current
86460cd40eeSSvyatoslav Ryhel		will drop to 0 A) and will trigger interrupt.
86560cd40eeSSvyatoslav Ryhel
86660cd40eeSSvyatoslav Ryhel		Valid values:
86760cd40eeSSvyatoslav Ryhel
86860cd40eeSSvyatoslav Ryhel		- 0 - 70 (minutes), step by 10 (rounded down)
869