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