257 lines · plain
1What: /sys/class/usb_power_delivery2Date: May 20223Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>4Description:5 Directory for USB Power Delivery devices.6 7What: /sys/class/usb_power_delivery/.../revision8Date: May 20229Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>10Description:11 File showing the USB Power Delivery Specification Revision used12 in communication.13 14What: /sys/class/usb_power_delivery/.../version15Date: May 202216Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>17Description:18 This is an optional attribute file showing the version of the19 specific revision of the USB Power Delivery Specification. In20 most cases the specification version is not known and the file21 is not available.22 23What: /sys/class/usb_power_delivery/.../source-capabilities24Date: May 202225Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>26Description:27 The source capabilities message "Source_Capabilities" contains a28 set of Power Data Objects (PDO), each representing a type of29 power supply. The order of the PDO objects is defined in the USB30 Power Delivery Specification. Each PDO - power supply - will31 have its own device, and the PDO device name will start with the32 object position number as the first character followed by the33 power supply type name (":" as delimiter).34 35 /sys/class/usb_power_delivery/.../source_capabilities/<position>:<type>36 37What: /sys/class/usb_power_delivery/.../sink-capabilities38Date: May 202239Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>40Description:41 The sink capability message "Sink_Capabilities" contains a set42 of Power Data Objects (PDO) just like with source capabilities,43 but instead of describing the power capabilities, these objects44 describe the power requirements.45 46 The order of the objects in the sink capability message is the47 same as with the source capabilities message.48 49Fixed Supplies50 51What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply52Date: May 202253Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>54Description:55 Devices containing the attributes (the bit fields) defined for56 Fixed Supplies.57 58 The device "1:fixed_supply" is special. USB Power Delivery59 Specification dictates that the first PDO (at object position60 1), and the only mandatory PDO, is always the vSafe5V Fixed61 Supply Object. vSafe5V Object has additional fields defined for62 it that the other Fixed Supply Objects do not have and that are63 related to the USB capabilities rather than power capabilities.64 65What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_power66Date: May 202267Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>68Description:69 This file contains boolean value that tells does the device70 support both source and sink power roles.71 72What: /sys/class/usb_power_delivery/.../source-capabilities/1:fixed_supply/usb_suspend_supported73Date: May 202274Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>75Description:76 This file shows the value of the USB Suspend Supported bit in77 vSafe5V Fixed Supply Object. If the bit is set then the device78 will follow the USB 2.0 and USB 3.2 rules for suspend and79 resume.80 81What: /sys/class/usb_power_delivery/.../sink-capabilities/1:fixed_supply/higher_capability82Date: February 202383Contact: Saranya Gopal <saranya.gopal@linux.intel.com>84Description:85 This file shows the value of the Higher capability bit in86 vsafe5V Fixed Supply Object. If the bit is set, then the sink87 needs more than vsafe5V(eg. 12 V) to provide full functionality.88 Valid values: 0, 189 90What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unconstrained_power91Date: May 202292Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>93Description:94 This file shows the value of the Unconstrained Power bit in95 vSafe5V Fixed Supply Object. The bit is set when an external96 source of power, powerful enough to power the entire system on97 its own, is available for the device.98 99What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_communication_capable100Date: May 2022101Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>102Description:103 This file shows the value of the USB Communication Capable bit in104 vSafe5V Fixed Supply Object.105 106What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_data107Date: May 2022108Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>109Description:110 This file shows the value of the Dual-Role Data bit in vSafe5V111 Fixed Supply Object. Dual role data means ability act as both112 USB host and USB device.113 114What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unchunked_extended_messages_supported115Date: May 2022116Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>117Description:118 This file shows the value of the Unchunked Extended Messages119 Supported bit in vSafe5V Fixed Supply Object.120 121What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply/voltage122Date: May 2022123Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>124Description:125 The voltage the supply supports in millivolts.126 127What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:fixed_supply/peak_current128Date: October 2023129Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>130Description:131 This file shows the value of the Fixed Power Source Peak Current132 Capability field.133 134What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:fixed_supply/maximum_current135Date: May 2022136Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>137Description:138 Maximum current of the fixed source supply in milliamperes.139 140What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/operational_current141Date: May 2022142Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>143Description:144 Operational current of the sink in milliamperes.145 146What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/fast_role_swap_current147Date: May 2022148Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>149Description:150 This file contains the value of the "Fast Role Swap USB Type-C151 Current" field that tells the current level the sink requires152 after a Fast Role Swap.153 0 - Fast Swap not supported"154 1 - Default USB Power"155 2 - 1.5A@5V"156 3 - 3.0A@5V"157 158Variable Supplies159 160What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply161Date: May 2022162Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>163Description:164 Variable Power Supply PDO.165 166What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/maximum_voltage167Date: May 2022168Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>169Description:170 Maximum Voltage in millivolts.171 172What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/minimum_voltage173Date: May 2022174Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>175Description:176 Minimum Voltage in millivolts.177 178What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:variable_supply/maximum_current179Date: May 2022180Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>181Description:182 The maximum current in milliamperes that the source can supply183 at the given Voltage range.184 185What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:variable_supply/operational_current186Date: May 2022187Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>188Description:189 The operational current in milliamperes that the sink requires190 at the given Voltage range.191 192Battery Supplies193 194What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery195Date: May 2022196Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>197Description:198 Battery PDO.199 200What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/maximum_voltage201Date: May 2022202Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>203Description:204 Maximum Voltage in millivolts.205 206What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/minimum_voltage207Date: May 2022208Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>209Description:210 Minimum Voltage in millivolts.211 212What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:battery/maximum_power213Date: May 2022214Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>215Description:216 Maximum allowable Power in milliwatts.217 218What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:battery/operational_power219Date: May 2022220Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>221Description:222 The operational power that the sink requires at the given223 voltage range.224 225Standard Power Range (SPR) Programmable Power Supplies226 227What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply228Date: May 2022229Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>230Description:231 Programmable Power Supply (PPS) Augmented PDO (APDO).232 233What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_voltage234Date: May 2022235Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>236Description:237 Maximum Voltage in millivolts.238 239What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/minimum_voltage240Date: May 2022241Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>242Description:243 Minimum Voltage in millivolts.244 245What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_current246Date: May 2022247Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>248Description:249 Maximum Current in milliamperes.250 251What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:programmable_supply/pps_power_limited252Date: May 2022253Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>254Description:255 The PPS Power Limited bit indicates whether or not the source256 supply will exceed the rated output power if requested.257