| .. | .. |
|---|
| 1 | | -===== General Properties ===== |
|---|
| 1 | +**General Properties** |
|---|
| 2 | 2 | |
|---|
| 3 | 3 | What: /sys/class/power_supply/<supply_name>/manufacturer |
|---|
| 4 | 4 | Date: May 2007 |
|---|
| .. | .. |
|---|
| 34 | 34 | Describes the main type of the supply. |
|---|
| 35 | 35 | |
|---|
| 36 | 36 | Access: Read |
|---|
| 37 | | - Valid values: "Battery", "UPS", "Mains", "USB" |
|---|
| 37 | + Valid values: "Battery", "UPS", "Mains", "USB", "Wireless" |
|---|
| 38 | 38 | |
|---|
| 39 | | -===== Battery Properties ===== |
|---|
| 39 | +**Battery and USB properties** |
|---|
| 40 | + |
|---|
| 41 | +What: /sys/class/power_supply/<supply_name>/current_avg |
|---|
| 42 | +Date: May 2007 |
|---|
| 43 | +Contact: linux-pm@vger.kernel.org |
|---|
| 44 | +Description: |
|---|
| 45 | + Battery: |
|---|
| 46 | + |
|---|
| 47 | + Reports an average IBAT current reading for the battery, over |
|---|
| 48 | + a fixed period. Normally devices will provide a fixed interval |
|---|
| 49 | + in which they average readings to smooth out the reported |
|---|
| 50 | + value. |
|---|
| 51 | + |
|---|
| 52 | + USB: |
|---|
| 53 | + |
|---|
| 54 | + Reports an average IBUS current reading over a fixed period. |
|---|
| 55 | + Normally devices will provide a fixed interval in which they |
|---|
| 56 | + average readings to smooth out the reported value. |
|---|
| 57 | + |
|---|
| 58 | + Access: Read |
|---|
| 59 | + |
|---|
| 60 | + Valid values: Represented in microamps. Negative values are |
|---|
| 61 | + used for discharging batteries, positive values for charging |
|---|
| 62 | + batteries and for USB IBUS current. |
|---|
| 63 | + |
|---|
| 64 | +What: /sys/class/power_supply/<supply_name>/current_max |
|---|
| 65 | +Date: October 2010 |
|---|
| 66 | +Contact: linux-pm@vger.kernel.org |
|---|
| 67 | +Description: |
|---|
| 68 | + Battery: |
|---|
| 69 | + |
|---|
| 70 | + Reports the maximum IBAT current allowed into the battery. |
|---|
| 71 | + |
|---|
| 72 | + USB: |
|---|
| 73 | + |
|---|
| 74 | + Reports the maximum IBUS current the supply can support. |
|---|
| 75 | + |
|---|
| 76 | + Access: Read |
|---|
| 77 | + Valid values: Represented in microamps |
|---|
| 78 | + |
|---|
| 79 | +What: /sys/class/power_supply/<supply_name>/current_now |
|---|
| 80 | +Date: May 2007 |
|---|
| 81 | +Contact: linux-pm@vger.kernel.org |
|---|
| 82 | +Description: |
|---|
| 83 | + |
|---|
| 84 | + Battery: |
|---|
| 85 | + |
|---|
| 86 | + Reports an instant, single IBAT current reading for the |
|---|
| 87 | + battery. This value is not averaged/smoothed. |
|---|
| 88 | + |
|---|
| 89 | + Access: Read |
|---|
| 90 | + |
|---|
| 91 | + USB: |
|---|
| 92 | + |
|---|
| 93 | + Reports the IBUS current supplied now. This value is generally |
|---|
| 94 | + read-only reporting, unless the 'online' state of the supply |
|---|
| 95 | + is set to be programmable, in which case this value can be set |
|---|
| 96 | + within the reported min/max range. |
|---|
| 97 | + |
|---|
| 98 | + Access: Read, Write |
|---|
| 99 | + |
|---|
| 100 | + Valid values: Represented in microamps. Negative values are |
|---|
| 101 | + used for discharging batteries, positive values for charging |
|---|
| 102 | + batteries and for USB IBUS current. |
|---|
| 103 | + |
|---|
| 104 | +What: /sys/class/power_supply/<supply_name>/temp |
|---|
| 105 | +Date: May 2007 |
|---|
| 106 | +Contact: linux-pm@vger.kernel.org |
|---|
| 107 | +Description: |
|---|
| 108 | + Battery: |
|---|
| 109 | + |
|---|
| 110 | + Reports the current TBAT battery temperature reading. |
|---|
| 111 | + |
|---|
| 112 | + USB: |
|---|
| 113 | + |
|---|
| 114 | + Reports the current supply temperature reading. This would |
|---|
| 115 | + normally be the internal temperature of the device itself |
|---|
| 116 | + (e.g TJUNC temperature of an IC) |
|---|
| 117 | + |
|---|
| 118 | + Access: Read |
|---|
| 119 | + |
|---|
| 120 | + Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 121 | + |
|---|
| 122 | +What: /sys/class/power_supply/<supply_name>/temp_alert_max |
|---|
| 123 | +Date: July 2012 |
|---|
| 124 | +Contact: linux-pm@vger.kernel.org |
|---|
| 125 | +Description: |
|---|
| 126 | + Battery: |
|---|
| 127 | + |
|---|
| 128 | + Maximum TBAT temperature trip-wire value where the supply will |
|---|
| 129 | + notify user-space of the event. |
|---|
| 130 | + |
|---|
| 131 | + USB: |
|---|
| 132 | + |
|---|
| 133 | + Maximum supply temperature trip-wire value where the supply |
|---|
| 134 | + will notify user-space of the event. |
|---|
| 135 | + |
|---|
| 136 | + This is normally used for the charging scenario where |
|---|
| 137 | + user-space needs to know if the temperature has crossed an |
|---|
| 138 | + upper threshold so it can take appropriate action (e.g. warning |
|---|
| 139 | + user that the temperature is critically high, and charging has |
|---|
| 140 | + stopped). |
|---|
| 141 | + |
|---|
| 142 | + Access: Read |
|---|
| 143 | + |
|---|
| 144 | + Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 145 | + |
|---|
| 146 | +What: /sys/class/power_supply/<supply_name>/temp_alert_min |
|---|
| 147 | +Date: July 2012 |
|---|
| 148 | +Contact: linux-pm@vger.kernel.org |
|---|
| 149 | +Description: |
|---|
| 150 | + |
|---|
| 151 | + Battery: |
|---|
| 152 | + |
|---|
| 153 | + Minimum TBAT temperature trip-wire value where the supply will |
|---|
| 154 | + notify user-space of the event. |
|---|
| 155 | + |
|---|
| 156 | + USB: |
|---|
| 157 | + |
|---|
| 158 | + Minimum supply temperature trip-wire value where the supply |
|---|
| 159 | + will notify user-space of the event. |
|---|
| 160 | + |
|---|
| 161 | + This is normally used for the charging scenario where user-space |
|---|
| 162 | + needs to know if the temperature has crossed a lower threshold |
|---|
| 163 | + so it can take appropriate action (e.g. warning user that |
|---|
| 164 | + temperature level is high, and charging current has been |
|---|
| 165 | + reduced accordingly to remedy the situation). |
|---|
| 166 | + |
|---|
| 167 | + Access: Read |
|---|
| 168 | + |
|---|
| 169 | + Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 170 | + |
|---|
| 171 | +What: /sys/class/power_supply/<supply_name>/temp_max |
|---|
| 172 | +Date: July 2014 |
|---|
| 173 | +Contact: linux-pm@vger.kernel.org |
|---|
| 174 | +Description: |
|---|
| 175 | + Battery: |
|---|
| 176 | + |
|---|
| 177 | + Reports the maximum allowed TBAT battery temperature for |
|---|
| 178 | + charging. |
|---|
| 179 | + |
|---|
| 180 | + USB: |
|---|
| 181 | + |
|---|
| 182 | + Reports the maximum allowed supply temperature for operation. |
|---|
| 183 | + |
|---|
| 184 | + Access: Read |
|---|
| 185 | + |
|---|
| 186 | + Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 187 | + |
|---|
| 188 | +What: /sys/class/power_supply/<supply_name>/temp_min |
|---|
| 189 | +Date: July 2014 |
|---|
| 190 | +Contact: linux-pm@vger.kernel.org |
|---|
| 191 | +Description: |
|---|
| 192 | + Battery: |
|---|
| 193 | + |
|---|
| 194 | + Reports the minimum allowed TBAT battery temperature for |
|---|
| 195 | + charging. |
|---|
| 196 | + |
|---|
| 197 | + USB: |
|---|
| 198 | + |
|---|
| 199 | + Reports the minimum allowed supply temperature for operation. |
|---|
| 200 | + |
|---|
| 201 | + Access: Read |
|---|
| 202 | + |
|---|
| 203 | + Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 204 | + |
|---|
| 205 | +What: /sys/class/power_supply/<supply_name>/voltage_max, |
|---|
| 206 | +Date: January 2008 |
|---|
| 207 | +Contact: linux-pm@vger.kernel.org |
|---|
| 208 | +Description: |
|---|
| 209 | + Battery: |
|---|
| 210 | + |
|---|
| 211 | + Reports the maximum safe VBAT voltage permitted for the |
|---|
| 212 | + battery, during charging. |
|---|
| 213 | + |
|---|
| 214 | + USB: |
|---|
| 215 | + |
|---|
| 216 | + Reports the maximum VBUS voltage the supply can support. |
|---|
| 217 | + |
|---|
| 218 | + Access: Read |
|---|
| 219 | + |
|---|
| 220 | + Valid values: Represented in microvolts |
|---|
| 221 | + |
|---|
| 222 | +What: /sys/class/power_supply/<supply_name>/voltage_min, |
|---|
| 223 | +Date: January 2008 |
|---|
| 224 | +Contact: linux-pm@vger.kernel.org |
|---|
| 225 | +Description: |
|---|
| 226 | + Battery: |
|---|
| 227 | + |
|---|
| 228 | + Reports the minimum safe VBAT voltage permitted for the |
|---|
| 229 | + battery, during discharging. |
|---|
| 230 | + |
|---|
| 231 | + USB: |
|---|
| 232 | + |
|---|
| 233 | + Reports the minimum VBUS voltage the supply can support. |
|---|
| 234 | + |
|---|
| 235 | + Access: Read |
|---|
| 236 | + |
|---|
| 237 | + Valid values: Represented in microvolts |
|---|
| 238 | + |
|---|
| 239 | +What: /sys/class/power_supply/<supply_name>/voltage_now, |
|---|
| 240 | +Date: May 2007 |
|---|
| 241 | +Contact: linux-pm@vger.kernel.org |
|---|
| 242 | +Description: |
|---|
| 243 | + Battery: |
|---|
| 244 | + |
|---|
| 245 | + Reports an instant, single VBAT voltage reading for the |
|---|
| 246 | + battery. This value is not averaged/smoothed. |
|---|
| 247 | + |
|---|
| 248 | + Access: Read |
|---|
| 249 | + |
|---|
| 250 | + USB: |
|---|
| 251 | + |
|---|
| 252 | + Reports the VBUS voltage supplied now. This value is generally |
|---|
| 253 | + read-only reporting, unless the 'online' state of the supply |
|---|
| 254 | + is set to be programmable, in which case this value can be set |
|---|
| 255 | + within the reported min/max range. |
|---|
| 256 | + |
|---|
| 257 | + Access: Read, Write |
|---|
| 258 | + |
|---|
| 259 | + Valid values: Represented in microvolts |
|---|
| 260 | + |
|---|
| 261 | +**Battery Properties** |
|---|
| 40 | 262 | |
|---|
| 41 | 263 | What: /sys/class/power_supply/<supply_name>/capacity |
|---|
| 42 | 264 | Date: May 2007 |
|---|
| 43 | 265 | Contact: linux-pm@vger.kernel.org |
|---|
| 44 | 266 | Description: |
|---|
| 45 | 267 | Fine grain representation of battery capacity. |
|---|
| 268 | + |
|---|
| 46 | 269 | Access: Read |
|---|
| 270 | + |
|---|
| 47 | 271 | Valid values: 0 - 100 (percent) |
|---|
| 48 | 272 | |
|---|
| 49 | 273 | What: /sys/class/power_supply/<supply_name>/capacity_alert_max |
|---|
| .. | .. |
|---|
| 58 | 282 | low). |
|---|
| 59 | 283 | |
|---|
| 60 | 284 | Access: Read, Write |
|---|
| 285 | + |
|---|
| 61 | 286 | Valid values: 0 - 100 (percent) |
|---|
| 62 | 287 | |
|---|
| 63 | 288 | What: /sys/class/power_supply/<supply_name>/capacity_alert_min |
|---|
| .. | .. |
|---|
| 72 | 297 | critically low). |
|---|
| 73 | 298 | |
|---|
| 74 | 299 | Access: Read, Write |
|---|
| 300 | + |
|---|
| 301 | + Valid values: 0 - 100 (percent) |
|---|
| 302 | + |
|---|
| 303 | +What: /sys/class/power_supply/<supply_name>/capacity_error_margin |
|---|
| 304 | +Date: April 2019 |
|---|
| 305 | +Contact: linux-pm@vger.kernel.org |
|---|
| 306 | +Description: |
|---|
| 307 | + Battery capacity measurement becomes unreliable without |
|---|
| 308 | + recalibration. This values provides the maximum error |
|---|
| 309 | + margin expected to exist by the fuel gauge in percent. |
|---|
| 310 | + Values close to 0% will be returned after (re-)calibration |
|---|
| 311 | + has happened. Over time the error margin will increase. |
|---|
| 312 | + 100% means, that the capacity related values are basically |
|---|
| 313 | + completely useless. |
|---|
| 314 | + |
|---|
| 315 | + Access: Read |
|---|
| 316 | + |
|---|
| 75 | 317 | Valid values: 0 - 100 (percent) |
|---|
| 76 | 318 | |
|---|
| 77 | 319 | What: /sys/class/power_supply/<supply_name>/capacity_level |
|---|
| .. | .. |
|---|
| 81 | 323 | Coarse representation of battery capacity. |
|---|
| 82 | 324 | |
|---|
| 83 | 325 | Access: Read |
|---|
| 84 | | - Valid values: "Unknown", "Critical", "Low", "Normal", "High", |
|---|
| 326 | + |
|---|
| 327 | + Valid values: |
|---|
| 328 | + "Unknown", "Critical", "Low", "Normal", "High", |
|---|
| 85 | 329 | "Full" |
|---|
| 86 | 330 | |
|---|
| 87 | | -What: /sys/class/power_supply/<supply_name>/current_avg |
|---|
| 88 | | -Date: May 2007 |
|---|
| 331 | +What: /sys/class/power_supply/<supply_name>/charge_control_limit |
|---|
| 332 | +Date: Oct 2012 |
|---|
| 89 | 333 | Contact: linux-pm@vger.kernel.org |
|---|
| 90 | 334 | Description: |
|---|
| 91 | | - Reports an average IBAT current reading for the battery, over a |
|---|
| 92 | | - fixed period. Normally devices will provide a fixed interval in |
|---|
| 93 | | - which they average readings to smooth out the reported value. |
|---|
| 335 | + Maximum allowable charging current. Used for charge rate |
|---|
| 336 | + throttling for thermal cooling or improving battery health. |
|---|
| 94 | 337 | |
|---|
| 95 | | - Access: Read |
|---|
| 338 | + Access: Read, Write |
|---|
| 339 | + |
|---|
| 96 | 340 | Valid values: Represented in microamps |
|---|
| 97 | 341 | |
|---|
| 98 | | -What: /sys/class/power_supply/<supply_name>/current_max |
|---|
| 99 | | -Date: October 2010 |
|---|
| 342 | +What: /sys/class/power_supply/<supply_name>/charge_control_limit_max |
|---|
| 343 | +Date: Oct 2012 |
|---|
| 100 | 344 | Contact: linux-pm@vger.kernel.org |
|---|
| 101 | 345 | Description: |
|---|
| 102 | | - Reports the maximum IBAT current allowed into the battery. |
|---|
| 346 | + Maximum legal value for the charge_control_limit property. |
|---|
| 103 | 347 | |
|---|
| 104 | 348 | Access: Read |
|---|
| 349 | + |
|---|
| 105 | 350 | Valid values: Represented in microamps |
|---|
| 106 | 351 | |
|---|
| 107 | | -What: /sys/class/power_supply/<supply_name>/current_now |
|---|
| 108 | | -Date: May 2007 |
|---|
| 352 | +What: /sys/class/power_supply/<supply_name>/charge_control_start_threshold |
|---|
| 353 | +Date: April 2019 |
|---|
| 109 | 354 | Contact: linux-pm@vger.kernel.org |
|---|
| 110 | 355 | Description: |
|---|
| 111 | | - Reports an instant, single IBAT current reading for the battery. |
|---|
| 112 | | - This value is not averaged/smoothed. |
|---|
| 356 | + Represents a battery percentage level, below which charging will |
|---|
| 357 | + begin. |
|---|
| 113 | 358 | |
|---|
| 114 | | - Access: Read |
|---|
| 115 | | - Valid values: Represented in microamps |
|---|
| 359 | + Access: Read, Write |
|---|
| 360 | + Valid values: 0 - 100 (percent) |
|---|
| 361 | + |
|---|
| 362 | +What: /sys/class/power_supply/<supply_name>/charge_control_end_threshold |
|---|
| 363 | +Date: April 2019 |
|---|
| 364 | +Contact: linux-pm@vger.kernel.org |
|---|
| 365 | +Description: |
|---|
| 366 | + Represents a battery percentage level, above which charging will |
|---|
| 367 | + stop. |
|---|
| 368 | + |
|---|
| 369 | + Access: Read, Write |
|---|
| 370 | + |
|---|
| 371 | + Valid values: 0 - 100 (percent) |
|---|
| 116 | 372 | |
|---|
| 117 | 373 | What: /sys/class/power_supply/<supply_name>/charge_type |
|---|
| 118 | 374 | Date: July 2009 |
|---|
| 119 | 375 | Contact: linux-pm@vger.kernel.org |
|---|
| 120 | 376 | Description: |
|---|
| 121 | 377 | Represents the type of charging currently being applied to the |
|---|
| 122 | | - battery. |
|---|
| 378 | + battery. "Trickle", "Fast", and "Standard" all mean different |
|---|
| 379 | + charging speeds. "Adaptive" means that the charger uses some |
|---|
| 380 | + algorithm to adjust the charge rate dynamically, without |
|---|
| 381 | + any user configuration required. "Custom" means that the charger |
|---|
| 382 | + uses the charge_control_* properties as configuration for some |
|---|
| 383 | + different algorithm. |
|---|
| 123 | 384 | |
|---|
| 124 | | - Access: Read |
|---|
| 125 | | - Valid values: "Unknown", "N/A", "Trickle", "Fast" |
|---|
| 385 | + Access: Read, Write |
|---|
| 386 | + |
|---|
| 387 | + Valid values: |
|---|
| 388 | + "Unknown", "N/A", "Trickle", "Fast", "Standard", |
|---|
| 389 | + "Adaptive", "Custom" |
|---|
| 126 | 390 | |
|---|
| 127 | 391 | What: /sys/class/power_supply/<supply_name>/charge_term_current |
|---|
| 128 | 392 | Date: July 2014 |
|---|
| .. | .. |
|---|
| 132 | 396 | when the battery is considered full and charging should end. |
|---|
| 133 | 397 | |
|---|
| 134 | 398 | Access: Read |
|---|
| 399 | + |
|---|
| 135 | 400 | Valid values: Represented in microamps |
|---|
| 136 | 401 | |
|---|
| 137 | 402 | What: /sys/class/power_supply/<supply_name>/health |
|---|
| .. | .. |
|---|
| 142 | 407 | functionality. |
|---|
| 143 | 408 | |
|---|
| 144 | 409 | Access: Read |
|---|
| 145 | | - Valid values: "Unknown", "Good", "Overheat", "Dead", |
|---|
| 410 | + |
|---|
| 411 | + Valid values: |
|---|
| 412 | + "Unknown", "Good", "Overheat", "Dead", |
|---|
| 146 | 413 | "Over voltage", "Unspecified failure", "Cold", |
|---|
| 147 | 414 | "Watchdog timer expire", "Safety timer expire", |
|---|
| 148 | | - "Over current", "Warm", "Cool", "Hot" |
|---|
| 415 | + "Over current", "Calibration required", "Warm", |
|---|
| 416 | + "Cool", "Hot" |
|---|
| 149 | 417 | |
|---|
| 150 | 418 | What: /sys/class/power_supply/<supply_name>/precharge_current |
|---|
| 151 | 419 | Date: June 2017 |
|---|
| .. | .. |
|---|
| 155 | 423 | for a battery charge cycle. |
|---|
| 156 | 424 | |
|---|
| 157 | 425 | Access: Read |
|---|
| 426 | + |
|---|
| 158 | 427 | Valid values: Represented in microamps |
|---|
| 159 | 428 | |
|---|
| 160 | 429 | What: /sys/class/power_supply/<supply_name>/present |
|---|
| .. | .. |
|---|
| 164 | 433 | Reports whether a battery is present or not in the system. |
|---|
| 165 | 434 | |
|---|
| 166 | 435 | Access: Read |
|---|
| 436 | + |
|---|
| 167 | 437 | Valid values: |
|---|
| 438 | + |
|---|
| 439 | + == ======= |
|---|
| 168 | 440 | 0: Absent |
|---|
| 169 | 441 | 1: Present |
|---|
| 442 | + == ======= |
|---|
| 170 | 443 | |
|---|
| 171 | 444 | What: /sys/class/power_supply/<supply_name>/status |
|---|
| 172 | 445 | Date: May 2007 |
|---|
| .. | .. |
|---|
| 177 | 450 | used to enable/disable charging to the battery. |
|---|
| 178 | 451 | |
|---|
| 179 | 452 | Access: Read, Write |
|---|
| 180 | | - Valid values: "Unknown", "Charging", "Discharging", |
|---|
| 453 | + |
|---|
| 454 | + Valid values: |
|---|
| 455 | + "Unknown", "Charging", "Discharging", |
|---|
| 181 | 456 | "Not charging", "Full" |
|---|
| 182 | 457 | |
|---|
| 183 | 458 | What: /sys/class/power_supply/<supply_name>/technology |
|---|
| .. | .. |
|---|
| 187 | 462 | Describes the battery technology supported by the supply. |
|---|
| 188 | 463 | |
|---|
| 189 | 464 | Access: Read |
|---|
| 190 | | - Valid values: "Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe", |
|---|
| 465 | + |
|---|
| 466 | + Valid values: |
|---|
| 467 | + "Unknown", "NiMH", "Li-ion", "Li-poly", "LiFe", |
|---|
| 191 | 468 | "NiCd", "LiMn" |
|---|
| 192 | 469 | |
|---|
| 193 | | -What: /sys/class/power_supply/<supply_name>/temp |
|---|
| 194 | | -Date: May 2007 |
|---|
| 195 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 196 | | -Description: |
|---|
| 197 | | - Reports the current TBAT battery temperature reading. |
|---|
| 198 | | - |
|---|
| 199 | | - Access: Read |
|---|
| 200 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 201 | | - |
|---|
| 202 | | -What: /sys/class/power_supply/<supply_name>/temp_alert_max |
|---|
| 203 | | -Date: July 2012 |
|---|
| 204 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 205 | | -Description: |
|---|
| 206 | | - Maximum TBAT temperature trip-wire value where the supply will |
|---|
| 207 | | - notify user-space of the event. This is normally used for the |
|---|
| 208 | | - battery charging scenario where user-space needs to know the |
|---|
| 209 | | - battery temperature has crossed an upper threshold so it can |
|---|
| 210 | | - take appropriate action (e.g. warning user that battery level is |
|---|
| 211 | | - critically high, and charging has stopped). |
|---|
| 212 | | - |
|---|
| 213 | | - Access: Read |
|---|
| 214 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 215 | | - |
|---|
| 216 | | -What: /sys/class/power_supply/<supply_name>/temp_alert_min |
|---|
| 217 | | -Date: July 2012 |
|---|
| 218 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 219 | | -Description: |
|---|
| 220 | | - Minimum TBAT temperature trip-wire value where the supply will |
|---|
| 221 | | - notify user-space of the event. This is normally used for the |
|---|
| 222 | | - battery charging scenario where user-space needs to know the |
|---|
| 223 | | - battery temperature has crossed a lower threshold so it can take |
|---|
| 224 | | - appropriate action (e.g. warning user that battery level is |
|---|
| 225 | | - high, and charging current has been reduced accordingly to |
|---|
| 226 | | - remedy the situation). |
|---|
| 227 | | - |
|---|
| 228 | | - Access: Read |
|---|
| 229 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 230 | | - |
|---|
| 231 | | -What: /sys/class/power_supply/<supply_name>/temp_max |
|---|
| 232 | | -Date: July 2014 |
|---|
| 233 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 234 | | -Description: |
|---|
| 235 | | - Reports the maximum allowed TBAT battery temperature for |
|---|
| 236 | | - charging. |
|---|
| 237 | | - |
|---|
| 238 | | - Access: Read |
|---|
| 239 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 240 | | - |
|---|
| 241 | | -What: /sys/class/power_supply/<supply_name>/temp_min |
|---|
| 242 | | -Date: July 2014 |
|---|
| 243 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 244 | | -Description: |
|---|
| 245 | | - Reports the minimum allowed TBAT battery temperature for |
|---|
| 246 | | - charging. |
|---|
| 247 | | - |
|---|
| 248 | | - Access: Read |
|---|
| 249 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 250 | 470 | |
|---|
| 251 | 471 | What: /sys/class/power_supply/<supply_name>/voltage_avg, |
|---|
| 252 | 472 | Date: May 2007 |
|---|
| .. | .. |
|---|
| 257 | 477 | which they average readings to smooth out the reported value. |
|---|
| 258 | 478 | |
|---|
| 259 | 479 | Access: Read |
|---|
| 480 | + |
|---|
| 260 | 481 | Valid values: Represented in microvolts |
|---|
| 261 | 482 | |
|---|
| 262 | | -What: /sys/class/power_supply/<supply_name>/voltage_max, |
|---|
| 263 | | -Date: January 2008 |
|---|
| 264 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 265 | | -Description: |
|---|
| 266 | | - Reports the maximum safe VBAT voltage permitted for the battery, |
|---|
| 267 | | - during charging. |
|---|
| 268 | | - |
|---|
| 269 | | - Access: Read |
|---|
| 270 | | - Valid values: Represented in microvolts |
|---|
| 271 | | - |
|---|
| 272 | | -What: /sys/class/power_supply/<supply_name>/voltage_min, |
|---|
| 273 | | -Date: January 2008 |
|---|
| 274 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 275 | | -Description: |
|---|
| 276 | | - Reports the minimum safe VBAT voltage permitted for the battery, |
|---|
| 277 | | - during discharging. |
|---|
| 278 | | - |
|---|
| 279 | | - Access: Read |
|---|
| 280 | | - Valid values: Represented in microvolts |
|---|
| 281 | | - |
|---|
| 282 | | -What: /sys/class/power_supply/<supply_name>/voltage_now, |
|---|
| 283 | | -Date: May 2007 |
|---|
| 284 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 285 | | -Description: |
|---|
| 286 | | - Reports an instant, single VBAT voltage reading for the battery. |
|---|
| 287 | | - This value is not averaged/smoothed. |
|---|
| 288 | | - |
|---|
| 289 | | - Access: Read |
|---|
| 290 | | - Valid values: Represented in microvolts |
|---|
| 291 | | - |
|---|
| 292 | | -===== USB Properties ===== |
|---|
| 293 | | - |
|---|
| 294 | | -What: /sys/class/power_supply/<supply_name>/current_avg |
|---|
| 295 | | -Date: May 2007 |
|---|
| 296 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 297 | | -Description: |
|---|
| 298 | | - Reports an average IBUS current reading over a fixed period. |
|---|
| 299 | | - Normally devices will provide a fixed interval in which they |
|---|
| 300 | | - average readings to smooth out the reported value. |
|---|
| 301 | | - |
|---|
| 302 | | - Access: Read |
|---|
| 303 | | - Valid values: Represented in microamps |
|---|
| 304 | | - |
|---|
| 305 | | - |
|---|
| 306 | | -What: /sys/class/power_supply/<supply_name>/current_max |
|---|
| 307 | | -Date: October 2010 |
|---|
| 308 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 309 | | -Description: |
|---|
| 310 | | - Reports the maximum IBUS current the supply can support. |
|---|
| 311 | | - |
|---|
| 312 | | - Access: Read |
|---|
| 313 | | - Valid values: Represented in microamps |
|---|
| 314 | | - |
|---|
| 315 | | -What: /sys/class/power_supply/<supply_name>/current_now |
|---|
| 316 | | -Date: May 2007 |
|---|
| 317 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 318 | | -Description: |
|---|
| 319 | | - Reports the IBUS current supplied now. This value is generally |
|---|
| 320 | | - read-only reporting, unless the 'online' state of the supply |
|---|
| 321 | | - is set to be programmable, in which case this value can be set |
|---|
| 322 | | - within the reported min/max range. |
|---|
| 323 | | - |
|---|
| 324 | | - Access: Read, Write |
|---|
| 325 | | - Valid values: Represented in microamps |
|---|
| 483 | +**USB Properties** |
|---|
| 326 | 484 | |
|---|
| 327 | 485 | What: /sys/class/power_supply/<supply_name>/input_current_limit |
|---|
| 328 | 486 | Date: July 2014 |
|---|
| .. | .. |
|---|
| 332 | 490 | supply. Normally this is configured based on the type of |
|---|
| 333 | 491 | connection made (e.g. A configured SDP should output a maximum |
|---|
| 334 | 492 | of 500mA so the input current limit is set to the same value). |
|---|
| 493 | + Use preferably input_power_limit, and for problems that can be |
|---|
| 494 | + solved using power limit use input_current_limit. |
|---|
| 335 | 495 | |
|---|
| 336 | 496 | Access: Read, Write |
|---|
| 497 | + |
|---|
| 337 | 498 | Valid values: Represented in microamps |
|---|
| 499 | + |
|---|
| 500 | +What: /sys/class/power_supply/<supply_name>/input_voltage_limit |
|---|
| 501 | +Date: May 2019 |
|---|
| 502 | +Contact: linux-pm@vger.kernel.org |
|---|
| 503 | +Description: |
|---|
| 504 | + This entry configures the incoming VBUS voltage limit currently |
|---|
| 505 | + set in the supply. Normally this is configured based on |
|---|
| 506 | + system-level knowledge or user input (e.g. This is part of the |
|---|
| 507 | + Pixel C's thermal management strategy to effectively limit the |
|---|
| 508 | + input power to 5V when the screen is on to meet Google's skin |
|---|
| 509 | + temperature targets). Note that this feature should not be |
|---|
| 510 | + used for safety critical things. |
|---|
| 511 | + Use preferably input_power_limit, and for problems that can be |
|---|
| 512 | + solved using power limit use input_voltage_limit. |
|---|
| 513 | + |
|---|
| 514 | + Access: Read, Write |
|---|
| 515 | + |
|---|
| 516 | + Valid values: Represented in microvolts |
|---|
| 517 | + |
|---|
| 518 | +What: /sys/class/power_supply/<supply_name>/input_power_limit |
|---|
| 519 | +Date: May 2019 |
|---|
| 520 | +Contact: linux-pm@vger.kernel.org |
|---|
| 521 | +Description: |
|---|
| 522 | + This entry configures the incoming power limit currently set |
|---|
| 523 | + in the supply. Normally this is configured based on |
|---|
| 524 | + system-level knowledge or user input. Use preferably this |
|---|
| 525 | + feature to limit the incoming power and use current/voltage |
|---|
| 526 | + limit only for problems that can be solved using power limit. |
|---|
| 527 | + |
|---|
| 528 | + Access: Read, Write |
|---|
| 529 | + |
|---|
| 530 | + Valid values: Represented in microwatts |
|---|
| 338 | 531 | |
|---|
| 339 | 532 | What: /sys/class/power_supply/<supply_name>/online, |
|---|
| 340 | 533 | Date: May 2007 |
|---|
| .. | .. |
|---|
| 346 | 539 | USB supply so voltage and current can be controlled). |
|---|
| 347 | 540 | |
|---|
| 348 | 541 | Access: Read, Write |
|---|
| 542 | + |
|---|
| 349 | 543 | Valid values: |
|---|
| 544 | + |
|---|
| 545 | + == ================================================== |
|---|
| 350 | 546 | 0: Offline |
|---|
| 351 | 547 | 1: Online Fixed - Fixed Voltage Supply |
|---|
| 352 | 548 | 2: Online Programmable - Programmable Voltage Supply |
|---|
| 353 | | - |
|---|
| 354 | | -What: /sys/class/power_supply/<supply_name>/temp |
|---|
| 355 | | -Date: May 2007 |
|---|
| 356 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 357 | | -Description: |
|---|
| 358 | | - Reports the current supply temperature reading. This would |
|---|
| 359 | | - normally be the internal temperature of the device itself (e.g |
|---|
| 360 | | - TJUNC temperature of an IC) |
|---|
| 361 | | - |
|---|
| 362 | | - Access: Read |
|---|
| 363 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 364 | | - |
|---|
| 365 | | -What: /sys/class/power_supply/<supply_name>/temp_alert_max |
|---|
| 366 | | -Date: July 2012 |
|---|
| 367 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 368 | | -Description: |
|---|
| 369 | | - Maximum supply temperature trip-wire value where the supply will |
|---|
| 370 | | - notify user-space of the event. This is normally used for the |
|---|
| 371 | | - charging scenario where user-space needs to know the supply |
|---|
| 372 | | - temperature has crossed an upper threshold so it can take |
|---|
| 373 | | - appropriate action (e.g. warning user that the supply |
|---|
| 374 | | - temperature is critically high, and charging has stopped to |
|---|
| 375 | | - remedy the situation). |
|---|
| 376 | | - |
|---|
| 377 | | - Access: Read |
|---|
| 378 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 379 | | - |
|---|
| 380 | | -What: /sys/class/power_supply/<supply_name>/temp_alert_min |
|---|
| 381 | | -Date: July 2012 |
|---|
| 382 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 383 | | -Description: |
|---|
| 384 | | - Minimum supply temperature trip-wire value where the supply will |
|---|
| 385 | | - notify user-space of the event. This is normally used for the |
|---|
| 386 | | - charging scenario where user-space needs to know the supply |
|---|
| 387 | | - temperature has crossed a lower threshold so it can take |
|---|
| 388 | | - appropriate action (e.g. warning user that the supply |
|---|
| 389 | | - temperature is high, and charging current has been reduced |
|---|
| 390 | | - accordingly to remedy the situation). |
|---|
| 391 | | - |
|---|
| 392 | | - Access: Read |
|---|
| 393 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 394 | | - |
|---|
| 395 | | -What: /sys/class/power_supply/<supply_name>/temp_max |
|---|
| 396 | | -Date: July 2014 |
|---|
| 397 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 398 | | -Description: |
|---|
| 399 | | - Reports the maximum allowed supply temperature for operation. |
|---|
| 400 | | - |
|---|
| 401 | | - Access: Read |
|---|
| 402 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 403 | | - |
|---|
| 404 | | -What: /sys/class/power_supply/<supply_name>/temp_min |
|---|
| 405 | | -Date: July 2014 |
|---|
| 406 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 407 | | -Description: |
|---|
| 408 | | - Reports the mainimum allowed supply temperature for operation. |
|---|
| 409 | | - |
|---|
| 410 | | - Access: Read |
|---|
| 411 | | - Valid values: Represented in 1/10 Degrees Celsius |
|---|
| 549 | + == ================================================== |
|---|
| 412 | 550 | |
|---|
| 413 | 551 | What: /sys/class/power_supply/<supply_name>/usb_type |
|---|
| 414 | 552 | Date: March 2018 |
|---|
| .. | .. |
|---|
| 419 | 557 | is attached. |
|---|
| 420 | 558 | |
|---|
| 421 | 559 | Access: Read-Only |
|---|
| 422 | | - Valid values: "Unknown", "SDP", "DCP", "CDP", "ACA", "C", "PD", |
|---|
| 560 | + |
|---|
| 561 | + Valid values: |
|---|
| 562 | + "Unknown", "SDP", "DCP", "CDP", "ACA", "C", "PD", |
|---|
| 423 | 563 | "PD_DRP", "PD_PPS", "BrickID" |
|---|
| 424 | 564 | |
|---|
| 425 | | -What: /sys/class/power_supply/<supply_name>/voltage_max |
|---|
| 426 | | -Date: January 2008 |
|---|
| 427 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 428 | | -Description: |
|---|
| 429 | | - Reports the maximum VBUS voltage the supply can support. |
|---|
| 430 | | - |
|---|
| 431 | | - Access: Read |
|---|
| 432 | | - Valid values: Represented in microvolts |
|---|
| 433 | | - |
|---|
| 434 | | -What: /sys/class/power_supply/<supply_name>/voltage_min |
|---|
| 435 | | -Date: January 2008 |
|---|
| 436 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 437 | | -Description: |
|---|
| 438 | | - Reports the minimum VBUS voltage the supply can support. |
|---|
| 439 | | - |
|---|
| 440 | | - Access: Read |
|---|
| 441 | | - Valid values: Represented in microvolts |
|---|
| 442 | | - |
|---|
| 443 | | -What: /sys/class/power_supply/<supply_name>/voltage_now |
|---|
| 444 | | -Date: May 2007 |
|---|
| 445 | | -Contact: linux-pm@vger.kernel.org |
|---|
| 446 | | -Description: |
|---|
| 447 | | - Reports the VBUS voltage supplied now. This value is generally |
|---|
| 448 | | - read-only reporting, unless the 'online' state of the supply |
|---|
| 449 | | - is set to be programmable, in which case this value can be set |
|---|
| 450 | | - within the reported min/max range. |
|---|
| 451 | | - |
|---|
| 452 | | - Access: Read, Write |
|---|
| 453 | | - Valid values: Represented in microvolts |
|---|
| 454 | | - |
|---|
| 455 | | -===== Device Specific Properties ===== |
|---|
| 565 | +**Device Specific Properties** |
|---|
| 456 | 566 | |
|---|
| 457 | 567 | What: /sys/class/power/ds2760-battery.*/charge_now |
|---|
| 458 | 568 | Date: May 2010 |
|---|
| .. | .. |
|---|
| 486 | 596 | will drop to 0 A) and will trigger interrupt. |
|---|
| 487 | 597 | |
|---|
| 488 | 598 | Valid values: |
|---|
| 599 | + |
|---|
| 489 | 600 | - 5, 6 or 7 (hours), |
|---|
| 490 | 601 | - 0: disabled. |
|---|
| 491 | 602 | |
|---|
| .. | .. |
|---|
| 500 | 611 | will drop to 0 A) and will trigger interrupt. |
|---|
| 501 | 612 | |
|---|
| 502 | 613 | Valid values: |
|---|
| 614 | + |
|---|
| 503 | 615 | - 4 - 16 (hours), step by 2 (rounded down) |
|---|
| 504 | 616 | - 0: disabled. |
|---|
| 505 | 617 | |
|---|
| .. | .. |
|---|
| 514 | 626 | interrupt and start top-off charging mode. |
|---|
| 515 | 627 | |
|---|
| 516 | 628 | Valid values: |
|---|
| 629 | + |
|---|
| 517 | 630 | - 100000 - 200000 (microamps), step by 25000 (rounded down) |
|---|
| 518 | 631 | - 200000 - 350000 (microamps), step by 50000 (rounded down) |
|---|
| 519 | 632 | - 0: disabled. |
|---|
| .. | .. |
|---|
| 529 | 642 | will drop to 0 A) and will trigger interrupt. |
|---|
| 530 | 643 | |
|---|
| 531 | 644 | Valid values: |
|---|
| 645 | + |
|---|
| 532 | 646 | - 0 - 70 (minutes), step by 10 (rounded down) |
|---|
| 533 | 647 | |
|---|
| 534 | 648 | What: /sys/class/power_supply/bq24257-charger/ovp_voltage |
|---|
| .. | .. |
|---|
| 542 | 656 | device datasheet for details. |
|---|
| 543 | 657 | |
|---|
| 544 | 658 | Valid values: |
|---|
| 659 | + |
|---|
| 545 | 660 | - 6000000, 6500000, 7000000, 8000000, 9000000, 9500000, 10000000, |
|---|
| 546 | 661 | 10500000 (all uV) |
|---|
| 547 | 662 | |
|---|
| .. | .. |
|---|
| 557 | 672 | lower than the set value. See device datasheet for details. |
|---|
| 558 | 673 | |
|---|
| 559 | 674 | Valid values: |
|---|
| 675 | + |
|---|
| 560 | 676 | - 4200000, 4280000, 4360000, 4440000, 4520000, 4600000, 4680000, |
|---|
| 561 | 677 | 4760000 (all uV) |
|---|
| 562 | 678 | |
|---|
| .. | .. |
|---|
| 571 | 687 | the charger operates normally. See device datasheet for details. |
|---|
| 572 | 688 | |
|---|
| 573 | 689 | Valid values: |
|---|
| 690 | + |
|---|
| 574 | 691 | - 1: enabled |
|---|
| 575 | 692 | - 0: disabled |
|---|
| 576 | 693 | |
|---|
| .. | .. |
|---|
| 586 | 703 | from the system. See device datasheet for details. |
|---|
| 587 | 704 | |
|---|
| 588 | 705 | Valid values: |
|---|
| 706 | + |
|---|
| 589 | 707 | - 1: enabled |
|---|
| 590 | 708 | - 0: disabled |
|---|
| 709 | + |
|---|
| 710 | +What: /sys/class/power_supply/<supply_name>/manufacture_year |
|---|
| 711 | +Date: January 2020 |
|---|
| 712 | +Contact: linux-pm@vger.kernel.org |
|---|
| 713 | +Description: |
|---|
| 714 | + Reports the year (following Gregorian calendar) when the device has been |
|---|
| 715 | + manufactured. |
|---|
| 716 | + |
|---|
| 717 | + Access: Read |
|---|
| 718 | + |
|---|
| 719 | + Valid values: Reported as integer |
|---|
| 720 | + |
|---|
| 721 | +What: /sys/class/power_supply/<supply_name>/manufacture_month |
|---|
| 722 | +Date: January 2020 |
|---|
| 723 | +Contact: linux-pm@vger.kernel.org |
|---|
| 724 | +Description: |
|---|
| 725 | + Reports the month when the device has been manufactured. |
|---|
| 726 | + |
|---|
| 727 | + Access: Read |
|---|
| 728 | + |
|---|
| 729 | + Valid values: 1-12 |
|---|
| 730 | + |
|---|
| 731 | +What: /sys/class/power_supply/<supply_name>/manufacture_day |
|---|
| 732 | +Date: January 2020 |
|---|
| 733 | +Contact: linux-pm@vger.kernel.org |
|---|
| 734 | +Description: |
|---|
| 735 | + Reports the day of month when the device has been manufactured. |
|---|
| 736 | + |
|---|
| 737 | + Access: Read |
|---|
| 738 | + Valid values: 1-31 |
|---|