1What:		/sys/class/usb_power_delivery
2Date:		May 2022
3Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
4Description:
5		Directory for USB Power Delivery devices.
6
7What:		/sys/class/usb_power_delivery/.../revision
8Date:		May 2022
9Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
10Description:
11		File showing the USB Power Delivery Specification Revision used
12		in communication.
13
14What:		/sys/class/usb_power_delivery/.../version
15Date:		May 2022
16Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
17Description:
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
21		is not available.
22
23What:		/sys/class/usb_power_delivery/.../source-capabilities
24Date:		May 2022
25Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
26Description:
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).
34
35			/sys/class/usb_power_delivery/.../source_capabilities/<position>:<type>
36
37What:		/sys/class/usb_power_delivery/.../sink-capabilities
38Date:		May 2022
39Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
40Description:
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.
45
46		The order of the objects in the sink capability message is the
47		same as with the source capabilities message.
48
49Fixed Supplies
50
51What:		/sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply
52Date:		May 2022
53Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
54Description:
55		Devices containing the attributes (the bit fields) defined for
56		Fixed Supplies.
57
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.
64
65What:		/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_power
66Date:		May 2022
67Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
68Description:
69		This file contains boolean value that tells does the device
70		support both source and sink power roles.
71
72What:		/sys/class/usb_power_delivery/.../source-capabilities/1:fixed_supply/usb_suspend_supported
73Date:		May 2022
74Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
75Description:
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
79		resume.
80
81What:		/sys/class/usb_power_delivery/.../sink-capabilities/1:fixed_supply/higher_capability
82Date:		February 2023
83Contact:	Saranya Gopal <saranya.gopal@linux.intel.com>
84Description:
85		This file shows the value of the Higher capability bit in
86		vsafe5V Fixed Supply Object. If the bit is set, then the sink
87		needs more than vsafe5V(eg. 12 V) to provide full functionality.
88		Valid values: 0, 1
89
90What:		/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unconstrained_power
91Date:		May 2022
92Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
93Description:
94		This file shows the value of the Unconstrained Power bit in
95		vSafe5V Fixed Supply Object. The bit is set when an external
96		source of power, powerful enough to power the entire system on
97		its own, is available for the device.
98
99What:		/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_communication_capable
100Date:		May 2022
101Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
102Description:
103		This file shows the value of the USB Communication Capable bit in
104		vSafe5V Fixed Supply Object.
105
106What:		/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_data
107Date:		May 2022
108Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
109Description:
110		This file shows the value of the Dual-Role Data bit in vSafe5V
111		Fixed Supply Object. Dual role data means ability act as both
112		USB host and USB device.
113
114What:		/sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unchunked_extended_messages_supported
115Date:		May 2022
116Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
117Description:
118		This file shows the value of the Unchunked Extended Messages
119		Supported bit in vSafe5V Fixed Supply Object.
120
121What:		/sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply/voltage
122Date:		May 2022
123Contact:	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/maximum_current
128Date:		May 2022
129Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
130Description:
131		Maximum current of the fixed source supply in milliamperes.
132
133What:		/sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/operational_current
134Date:		May 2022
135Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
136Description:
137		Operational current of the sink in milliamperes.
138
139What:		/sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/fast_role_swap_current
140Date:		May 2022
141Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
142Description:
143		This file contains the value of the "Fast Role Swap USB Type-C
144		Current" field that tells the current level the sink requires
145		after a Fast Role Swap.
146		0 - Fast Swap not supported"
147		1 - Default USB Power"
148		2 - 1.5A@5V"
149		3 - 3.0A@5V"
150
151Variable Supplies
152
153What:		/sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply
154Date:		May 2022
155Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
156Description:
157		Variable Power Supply PDO.
158
159What:		/sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/maximum_voltage
160Date:		May 2022
161Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
162Description:
163		Maximum Voltage in millivolts.
164
165What:		/sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/minimum_voltage
166Date:		May 2022
167Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
168Description:
169		Minimum Voltage in millivolts.
170
171What:		/sys/class/usb_power_delivery/.../source-capabilities/<position>:variable_supply/maximum_current
172Date:		May 2022
173Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
174Description:
175		The maximum current in milliamperes that the source can supply
176		at the given Voltage range.
177
178What:		/sys/class/usb_power_delivery/.../sink-capabilities/<position>:variable_supply/operational_current
179Date:		May 2022
180Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
181Description:
182		The operational current in milliamperes that the sink requires
183		at the given Voltage range.
184
185Battery Supplies
186
187What:		/sys/class/usb_power_delivery/.../<capability>/<position>:battery
188Date:		May 2022
189Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
190Description:
191		Battery PDO.
192
193What:		/sys/class/usb_power_delivery/.../<capability>/<position>:battery/maximum_voltage
194Date:		May 2022
195Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
196Description:
197		Maximum Voltage in millivolts.
198
199What:		/sys/class/usb_power_delivery/.../<capability>/<position>:battery/minimum_voltage
200Date:		May 2022
201Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
202Description:
203		Minimum Voltage in millivolts.
204
205What:		/sys/class/usb_power_delivery/.../source-capabilities/<position>:battery/maximum_power
206Date:		May 2022
207Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
208Description:
209		Maximum allowable Power in milliwatts.
210
211What:		/sys/class/usb_power_delivery/.../sink-capabilities/<position>:battery/operational_power
212Date:		May 2022
213Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
214Description:
215		The operational power that the sink requires at the given
216		voltage range.
217
218Standard Power Range (SPR) Programmable Power Supplies
219
220What:		/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply
221Date:		May 2022
222Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
223Description:
224		Programmable Power Supply (PPS) Augmented PDO (APDO).
225
226What:		/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_voltage
227Date:		May 2022
228Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
229Description:
230		Maximum Voltage in millivolts.
231
232What:		/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/minimum_voltage
233Date:		May 2022
234Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
235Description:
236		Minimum Voltage in millivolts.
237
238What:		/sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_current
239Date:		May 2022
240Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
241Description:
242		Maximum Current in milliamperes.
243
244What:		/sys/class/usb_power_delivery/.../source-capabilities/<position>:programmable_supply/pps_power_limited
245Date:		May 2022
246Contact:	Heikki Krogerus <heikki.krogerus@linux.intel.com>
247Description:
248		The PPS Power Limited bit indicates whether or not the source
249		supply will exceed the rated output power if requested.
250