Unverified Commit c9de2e5c authored by Armin Wolf's avatar Armin Wolf Committed by Ilpo Järvinen
Browse files

Documentation: ABI: Update WMI device paths in ABI docs 



The WMI driver core might append an ID to the WMI device name to avoid
name collisions in case multiple WMI devices with the same GUID are
present. Update all sysfs path referring to WMI devices to inform
users about this important detail.

Signed-off-by: default avatarArmin Wolf <W_Armin@gmx.de>
Link: https://lore.kernel.org/r/20250610055526.23688-1-W_Armin@gmx.de


Reviewed-by: default avatarIlpo Järvinen <ilpo.jarvinen@linux.intel.com>
Signed-off-by: default avatarIlpo Järvinen <ilpo.jarvinen@linux.intel.com>
parent d2b16853

Documentation/ABI/testing/sysfs-platform-dell-privacy-wmi

+4 −4
Original line number Diff line number Diff line 
What:		/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type

What:		/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919[-X]/dell_privacy_supported_type

Date:		Apr 2021

KernelVersion:	5.13

Contact:	"<perry.yuan@dell.com>"
@@ -29,12 +29,12 @@ Description: 


		For example to check which privacy devices are supported::



		    # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_supported_type

		    # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919*/dell_privacy_supported_type

		    [Microphone Mute] [supported]

		    [Camera Shutter] [supported]

		    [ePrivacy Screen] [unsupported]



What:		/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state

What:		/sys/bus/wmi/devices/6932965F-1671-4CEB-B988-D3AB0A901919[-X]/dell_privacy_current_state

Date:		Apr 2021

KernelVersion:	5.13

Contact:	"<perry.yuan@dell.com>"
@@ -66,6 +66,6 @@ Description: 


		For example to check all supported current privacy device states::



		    # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919/dell_privacy_current_state

		    # cat /sys/bus/wmi/drivers/dell-privacy/6932965F-1671-4CEB-B988-D3AB0A901919*/dell_privacy_current_state

		    [Microphone] [unmuted]

		    [Camera Shutter] [unmuted]

Documentation/ABI/testing/sysfs-platform-intel-wmi-sbl-fw-update

+1 −1
Original line number Diff line number Diff line 
What:		/sys/bus/wmi/devices/44FADEB1-B204-40F2-8581-394BBDC1B651/firmware_update_request

What:		/sys/bus/wmi/devices/44FADEB1-B204-40F2-8581-394BBDC1B651[-X]/firmware_update_request

Date:		April 2020

KernelVersion:	5.7

Contact:	"Jithu Joseph" <jithu.joseph@intel.com>

Documentation/ABI/testing/sysfs-platform-intel-wmi-thunderbolt

+1 −1
Original line number Diff line number Diff line 
What:		/sys/devices/platform/<platform>/force_power

What:		/sys/bus/wmi/devices/86CCFD48-205E-4A77-9C48-2021CBEDE341[-X]/force_power

Date:		September 2017

KernelVersion:	4.15

Contact:	"Mario Limonciello" <mario.limonciello@outlook.com>

Documentation/admin-guide/thunderbolt.rst

+2 −7
Original line number Diff line number Diff line
@@ -358,12 +358,7 @@ Forcing power 
Many OEMs include a method that can be used to force the power of a

Thunderbolt controller to an "On" state even if nothing is connected.

If supported by your machine this will be exposed by the WMI bus with

a sysfs attribute called "force_power".



For example the intel-wmi-thunderbolt driver exposes this attribute in:

  /sys/bus/wmi/devices/86CCFD48-205E-4A77-9C48-2021CBEDE341/force_power



  To force the power to on, write 1 to this attribute file.

  To disable force power, write 0 to this attribute file.

a sysfs attribute called "force_power", see

Documentation/ABI/testing/sysfs-platform-intel-wmi-thunderbolt for details.



Note: it's currently not possible to query the force power state of a platform.