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