1 What: /sys/class/usb_power_delivery
3 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
5 Directory for USB Power Delivery devices.
7 What: /sys/class/usb_power_delivery/.../revision
9 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
11 File showing the USB Power Delivery Specification Revision used
14 What: /sys/class/usb_power_delivery/.../version
16 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
18 This is an optional attribute file showing the version of the
19 specific revision of the USB Power Delivery Specification. In
20 most cases the specification version is not known and the file
23 What: /sys/class/usb_power_delivery/.../source-capabilities
25 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
27 The source capabilities message "Source_Capabilities" contains a
28 set of Power Data Objects (PDO), each representing a type of
29 power supply. The order of the PDO objects is defined in the USB
30 Power Delivery Specification. Each PDO - power supply - will
31 have its own device, and the PDO device name will start with the
32 object position number as the first character followed by the
33 power supply type name (":" as delimiter).
35 /sys/class/usb_power_delivery/.../source_capabilities/<position>:<type>
37 What: /sys/class/usb_power_delivery/.../sink-capabilities
39 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
41 The sink capability message "Sink_Capabilities" contains a set
42 of Power Data Objects (PDO) just like with source capabilities,
43 but instead of describing the power capabilities, these objects
44 describe the power requirements.
46 The order of the objects in the sink capability message is the
47 same as with the source capabilities message.
51 What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply
53 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
55 Devices containing the attributes (the bit fields) defined for
58 The device "1:fixed_supply" is special. USB Power Delivery
59 Specification dictates that the first PDO (at object position
60 1), and the only mandatory PDO, is always the vSafe5V Fixed
61 Supply Object. vSafe5V Object has additional fields defined for
62 it that the other Fixed Supply Objects do not have and that are
63 related to the USB capabilities rather than power capabilities.
65 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_power
67 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
69 This file contains boolean value that tells does the device
70 support both source and sink power roles.
72 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_suspend_supported
74 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
76 This file shows the value of the USB Suspend Supported bit in
77 vSafe5V Fixed Supply Object. If the bit is set then the device
78 will follow the USB 2.0 and USB 3.2 rules for suspend and
81 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unconstrained_power
83 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
85 This file shows the value of the Unconstrained Power bit in
86 vSafe5V Fixed Supply Object. The bit is set when an external
87 source of power, powerful enough to power the entire system on
88 its own, is available for the device.
90 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_communication_capable
92 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
94 This file shows the value of the USB Communication Capable bit in
95 vSafe5V Fixed Supply Object.
97 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_data
99 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
101 This file shows the value of the Dual-Role Data bit in vSafe5V
102 Fixed Supply Object. Dual role data means ability act as both
103 USB host and USB device.
105 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unchunked_extended_messages_supported
107 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
109 This file shows the value of the Unchunked Extended Messages
110 Supported bit in vSafe5V Fixed Supply Object.
112 What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply/voltage
114 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
116 The voltage the supply supports in millivolts.
118 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:fixed_supply/maximum_current
120 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
122 Maximum current of the fixed source supply in milliamperes.
124 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/operational_current
126 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
128 Operational current of the sink in milliamperes.
130 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/fast_role_swap_current
132 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
134 This file contains the value of the "Fast Role Swap USB Type-C
135 Current" field that tells the current level the sink requires
136 after a Fast Role Swap.
137 0 - Fast Swap not supported"
138 1 - Default USB Power"
144 What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply
146 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
148 Variable Power Supply PDO.
150 What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/maximum_voltage
152 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
154 Maximum Voltage in millivolts.
156 What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/minimum_voltage
158 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
160 Minimum Voltage in millivolts.
162 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:variable_supply/maximum_current
164 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
166 The maximum current in milliamperes that the source can supply
167 at the given Voltage range.
169 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:variable_supply/operational_current
171 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
173 The operational current in milliamperes that the sink requires
174 at the given Voltage range.
178 What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery
180 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
184 What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/maximum_voltage
186 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
188 Maximum Voltage in millivolts.
190 What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/minimum_voltage
192 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
194 Minimum Voltage in millivolts.
196 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:battery/maximum_power
198 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
200 Maximum allowable Power in milliwatts.
202 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:battery/operational_power
204 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
206 The operational power that the sink requires at the given
209 Standard Power Range (SPR) Programmable Power Supplies
211 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply
213 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
215 Programmable Power Supply (PPS) Augmented PDO (APDO).
217 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_voltage
219 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
221 Maximum Voltage in millivolts.
223 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/minimum_voltage
225 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
227 Minimum Voltage in millivolts.
229 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_current
231 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
233 Maximum Current in milliamperes.
235 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:programmable_supply/pps_power_limited
237 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
239 The PPS Power Limited bit indicates whether or not the source
240 supply will exceed the rated output power if requested.