c620f4d5b2
28th bit of fixed supply sink PDO represents higher capability. When this bit is set, the sink device needs more than vsafe5V (eg: 12 V) to provide full functionality. This patch adds this higher capability sysfs interface for sink PDO. 28th bit of fixed supply source PDO represents usb_suspend_supported attribute. This usb_suspend_supported sysfs is already exposed for source PDOs. This patch adds 'source-capabilities' in usb_suspend_supported sysfs documentation for additional clarity. Signed-off-by: Saranya Gopal <saranya.gopal@intel.com> Reviewed-by: Heikki Krogerus <heikki.krogerus@linux.intel.com> Link: https://lore.kernel.org/r/20230214114543.205103-2-saranya.gopal@intel.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
9.5 KiB
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/...//: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/...//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/...//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/...//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/...//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/...//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/...//: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/: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/: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/: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/...//:variable_supply Date: May 2022 Contact: Heikki Krogerus heikki.krogerus@linux.intel.com Description: Variable Power Supply PDO.
What: /sys/class/usb_power_delivery/...//: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/...//: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/: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/: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/...//:battery Date: May 2022 Contact: Heikki Krogerus heikki.krogerus@linux.intel.com Description: Battery PDO.
What: /sys/class/usb_power_delivery/...//: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/...//: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/: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/: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/...//: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/...//: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/...//: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/...//: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/: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.