250 lines
9.5 KiB
Plaintext
250 lines
9.5 KiB
Plaintext
|
What: /sys/class/usb_power_delivery
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Directory for USB Power Delivery devices.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../revision
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
File showing the USB Power Delivery Specification Revision used
|
||
|
|
in communication.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../version
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This is an optional attribute file showing the version of the
|
||
|
|
specific revision of the USB Power Delivery Specification. In
|
||
|
|
most cases the specification version is not known and the file
|
||
|
|
is not available.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../source-capabilities
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
The source capabilities message "Source_Capabilities" contains a
|
||
|
|
set of Power Data Objects (PDO), each representing a type of
|
||
|
|
power supply. The order of the PDO objects is defined in the USB
|
||
|
|
Power Delivery Specification. Each PDO - power supply - will
|
||
|
|
have its own device, and the PDO device name will start with the
|
||
|
|
object position number as the first character followed by the
|
||
|
|
power supply type name (":" as delimiter).
|
||
|
|
|
||
|
|
/sys/class/usb_power_delivery/.../source_capabilities/<position>:<type>
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../sink-capabilities
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
The sink capability message "Sink_Capabilities" contains a set
|
||
|
|
of Power Data Objects (PDO) just like with source capabilities,
|
||
|
|
but instead of describing the power capabilities, these objects
|
||
|
|
describe the power requirements.
|
||
|
|
|
||
|
|
The order of the objects in the sink capability message is the
|
||
|
|
same as with the source capabilities message.
|
||
|
|
|
||
|
|
Fixed Supplies
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Devices containing the attributes (the bit fields) defined for
|
||
|
|
Fixed Supplies.
|
||
|
|
|
||
|
|
The device "1:fixed_supply" is special. USB Power Delivery
|
||
|
|
Specification dictates that the first PDO (at object position
|
||
|
|
1), and the only mandatory PDO, is always the vSafe5V Fixed
|
||
|
|
Supply Object. vSafe5V Object has additional fields defined for
|
||
|
|
it that the other Fixed Supply Objects do not have and that are
|
||
|
|
related to the USB capabilities rather than power capabilities.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_power
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file contains boolean value that tells does the device
|
||
|
|
support both source and sink power roles.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../source-capabilities/1:fixed_supply/usb_suspend_supported
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file shows the value of the USB Suspend Supported bit in
|
||
|
|
vSafe5V Fixed Supply Object. If the bit is set then the device
|
||
|
|
will follow the USB 2.0 and USB 3.2 rules for suspend and
|
||
|
|
resume.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../sink-capabilities/1:fixed_supply/higher_capability
|
||
|
|
Date: February 2023
|
||
|
|
Contact: Saranya Gopal <saranya.gopal@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file shows the value of the Higher capability bit in
|
||
|
|
vsafe5V Fixed Supply Object. If the bit is set, then the sink
|
||
|
|
needs more than vsafe5V(eg. 12 V) to provide full functionality.
|
||
|
|
Valid values: 0, 1
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unconstrained_power
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file shows the value of the Unconstrained Power bit in
|
||
|
|
vSafe5V Fixed Supply Object. The bit is set when an external
|
||
|
|
source of power, powerful enough to power the entire system on
|
||
|
|
its own, is available for the device.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/usb_communication_capable
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file shows the value of the USB Communication Capable bit in
|
||
|
|
vSafe5V Fixed Supply Object.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/dual_role_data
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file shows the value of the Dual-Role Data bit in vSafe5V
|
||
|
|
Fixed Supply Object. Dual role data means ability act as both
|
||
|
|
USB host and USB device.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/1:fixed_supply/unchunked_extended_messages_supported
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file shows the value of the Unchunked Extended Messages
|
||
|
|
Supported bit in vSafe5V Fixed Supply Object.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:fixed_supply/voltage
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
The voltage the supply supports in millivolts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:fixed_supply/maximum_current
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Maximum current of the fixed source supply in milliamperes.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/operational_current
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Operational current of the sink in milliamperes.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:fixed_supply/fast_role_swap_current
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
This file contains the value of the "Fast Role Swap USB Type-C
|
||
|
|
Current" field that tells the current level the sink requires
|
||
|
|
after a Fast Role Swap.
|
||
|
|
0 - Fast Swap not supported"
|
||
|
|
1 - Default USB Power"
|
||
|
|
2 - 1.5A@5V"
|
||
|
|
3 - 3.0A@5V"
|
||
|
|
|
||
|
|
Variable Supplies
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Variable Power Supply PDO.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/maximum_voltage
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Maximum Voltage in millivolts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:variable_supply/minimum_voltage
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Minimum Voltage in millivolts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:variable_supply/maximum_current
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
The maximum current in milliamperes that the source can supply
|
||
|
|
at the given Voltage range.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:variable_supply/operational_current
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
The operational current in milliamperes that the sink requires
|
||
|
|
at the given Voltage range.
|
||
|
|
|
||
|
|
Battery Supplies
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Battery PDO.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/maximum_voltage
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Maximum Voltage in millivolts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:battery/minimum_voltage
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Minimum Voltage in millivolts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:battery/maximum_power
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Maximum allowable Power in milliwatts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../sink-capabilities/<position>:battery/operational_power
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
The operational power that the sink requires at the given
|
||
|
|
voltage range.
|
||
|
|
|
||
|
|
Standard Power Range (SPR) Programmable Power Supplies
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Programmable Power Supply (PPS) Augmented PDO (APDO).
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_voltage
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Maximum Voltage in millivolts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/minimum_voltage
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Minimum Voltage in millivolts.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../<capability>/<position>:programmable_supply/maximum_current
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
Maximum Current in milliamperes.
|
||
|
|
|
||
|
|
What: /sys/class/usb_power_delivery/.../source-capabilities/<position>:programmable_supply/pps_power_limited
|
||
|
|
Date: May 2022
|
||
|
|
Contact: Heikki Krogerus <heikki.krogerus@linux.intel.com>
|
||
|
|
Description:
|
||
|
|
The PPS Power Limited bit indicates whether or not the source
|
||
|
|
supply will exceed the rated output power if requested.
|