0001 What: /sys/class/usb_power_delivery
0002 Date: May 2022
0003 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0004 Description:
0005 Directory for USB Power Delivery devices.
0006
0007 What: /sys/class/usb_power_delivery/.../revision
0008 Date: May 2022
0009 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0010 Description:
0011 File showing the USB Power Delivery Specification Revision used
0012 in communication.
0013
0014 What: /sys/class/usb_power_delivery/.../version
0015 Date: May 2022
0016 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0017 Description:
0018 This is an optional attribute file showing the version of the
0019 specific revision of the USB Power Delivery Specification. In
0020 most cases the specification version is not known and the file
0021 is not available.
0022
0023 What: /sys/class/usb_power_delivery/.../source-capabilities
0024 Date: May 2022
0025 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0026 Description:
0027 The source capabilities message "Source_Capabilities" contains a
0028 set of Power Data Objects (PDO), each representing a type of
0029 power supply. The order of the PDO objects is defined in the USB
0030 Power Delivery Specification. Each PDO - power supply - will
0031 have its own device, and the PDO device name will start with the
0032 object position number as the first character followed by the
0033 power supply type name (":" as delimiter).
0034
0035 /sys/class/usb_power_delivery/.../source_capabilities/<position>:<type>
0036
0037 What: /sys/class/usb_power_delivery/.../sink-capabilities
0038 Date: May 2022
0039 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0040 Description:
0041 The sink capability message "Sink_Capabilities" contains a set
0042 of Power Data Objects (PDO) just like with source capabilities,
0043 but instead of describing the power capabilities, these objects
0044 describe the power requirements.
0045
0046 The order of the objects in the sink capability message is the
0047 same as with the source capabilities message.
0048
0049 Fixed Supplies
0050
0051 What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply
0052 Date: May 2022
0053 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0054 Description:
0055 Devices containing the attributes (the bit fields) defined for
0056 Fixed Supplies.
0057
0058 The device "1:fixed_supply" is special. USB Power Delivery
0059 Specification dictates that the first PDO (at object position
0060 1), and the only mandatory PDO, is always the vSafe5V Fixed
0061 Supply Object. vSafe5V Object has additional fields defined for
0062 it that the other Fixed Supply Objects do not have and that are
0063 related to the USB capabilities rather than power capabilities.
0064
0065 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_power
0066 Date: May 2022
0067 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0068 Description:
0069 This file contains boolean value that tells does the device
0070 support both source and sink power roles.
0071
0072 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_suspend_supported
0073 Date: May 2022
0074 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0075 Description:
0076 This file shows the value of the USB Suspend Supported bit in
0077 vSafe5V Fixed Supply Object. If the bit is set then the device
0078 will follow the USB 2.0 and USB 3.2 rules for suspend and
0079 resume.
0080
0081 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unconstrained_power
0082 Date: May 2022
0083 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0084 Description:
0085 This file shows the value of the Unconstrained Power bit in
0086 vSafe5V Fixed Supply Object. The bit is set when an external
0087 source of power, powerful enough to power the entire system on
0088 its own, is available for the device.
0089
0090 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_communication_capable
0091 Date: May 2022
0092 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0093 Description:
0094 This file shows the value of the USB Communication Capable bit in
0095 vSafe5V Fixed Supply Object.
0096
0097 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_data
0098 Date: May 2022
0099 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0100 Description:
0101 This file shows the value of the Dual-Role Data bit in vSafe5V
0102 Fixed Supply Object. Dual role data means ability act as both
0103 USB host and USB device.
0104
0105 What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unchunked_extended_messages_supported
0106 Date: May 2022
0107 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0108 Description:
0109 This file shows the value of the Unchunked Extended Messages
0110 Supported bit in vSafe5V Fixed Supply Object.
0111
0112 What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply/voltage
0113 Date: May 2022
0114 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0115 Description:
0116 The voltage the supply supports in millivolts.
0117
0118 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:fixed_supply/maximum_current
0119 Date: May 2022
0120 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0121 Description:
0122 Maximum current of the fixed source supply in milliamperes.
0123
0124 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/operational_current
0125 Date: May 2022
0126 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0127 Description:
0128 Operational current of the sink in milliamperes.
0129
0130 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/fast_role_swap_current
0131 Date: May 2022
0132 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0133 Description:
0134 This file contains the value of the "Fast Role Swap USB Type-C
0135 Current" field that tells the current level the sink requires
0136 after a Fast Role Swap.
0137 0 - Fast Swap not supported"
0138 1 - Default USB Power"
0139 2 - 1.5A@5V"
0140 3 - 3.0A@5V"
0141
0142 Variable Supplies
0143
0144 What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply
0145 Date: May 2022
0146 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0147 Description:
0148 Variable Power Supply PDO.
0149
0150 What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/maximum_voltage
0151 Date: May 2022
0152 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0153 Description:
0154 Maximum Voltage in millivolts.
0155
0156 What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/minimum_voltage
0157 Date: May 2022
0158 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0159 Description:
0160 Minimum Voltage in millivolts.
0161
0162 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:variable_supply/maximum_current
0163 Date: May 2022
0164 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0165 Description:
0166 The maximum current in milliamperes that the source can supply
0167 at the given Voltage range.
0168
0169 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:variable_supply/operational_current
0170 Date: May 2022
0171 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0172 Description:
0173 The operational current in milliamperes that the sink requires
0174 at the given Voltage range.
0175
0176 Battery Supplies
0177
0178 What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery
0179 Date: May 2022
0180 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0181 Description:
0182 Battery PDO.
0183
0184 What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/maximum_voltage
0185 Date: May 2022
0186 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0187 Description:
0188 Maximum Voltage in millivolts.
0189
0190 What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/minimum_voltage
0191 Date: May 2022
0192 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0193 Description:
0194 Minimum Voltage in millivolts.
0195
0196 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:battery/maximum_power
0197 Date: May 2022
0198 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0199 Description:
0200 Maximum allowable Power in milliwatts.
0201
0202 What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:battery/operational_power
0203 Date: May 2022
0204 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0205 Description:
0206 The operational power that the sink requires at the given
0207 voltage range.
0208
0209 Standard Power Range (SPR) Programmable Power Supplies
0210
0211 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply
0212 Date: May 2022
0213 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0214 Description:
0215 Programmable Power Supply (PPS) Augmented PDO (APDO).
0216
0217 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_voltage
0218 Date: May 2022
0219 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0220 Description:
0221 Maximum Voltage in millivolts.
0222
0223 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/minimum_voltage
0224 Date: May 2022
0225 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0226 Description:
0227 Minimum Voltage in millivolts.
0228
0229 What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_current
0230 Date: May 2022
0231 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0232 Description:
0233 Maximum Current in milliamperes.
0234
0235 What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:programmable_supply/pps_power_limited
0236 Date: May 2022
0237 Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
0238 Description:
0239 The PPS Power Limited bit indicates whether or not the source
0240 supply will exceed the rated output power if requested.
