xref: /linux/Documentation/ABI/testing/sysfs-class-platform-profile (revision 9d588a1140b9ae211581a7a154d0b806d8cd8238)
1ee7f3e2bSKurt BorjaWhat:		/sys/class/platform-profile/platform-profile-X/name
2ee7f3e2bSKurt BorjaDate:		March 2025
3ee7f3e2bSKurt BorjaKernelVersion:	6.14
4ee7f3e2bSKurt BorjaDescription:	Name of the class device given by the driver.
5ee7f3e2bSKurt Borja
6ee7f3e2bSKurt Borja		RO
7ee7f3e2bSKurt Borja
8ee7f3e2bSKurt BorjaWhat:		/sys/class/platform-profile/platform-profile-X/choices
9ee7f3e2bSKurt BorjaDate:		March 2025
10ee7f3e2bSKurt BorjaKernelVersion:	6.14
11ee7f3e2bSKurt BorjaDescription:	This file contains a space-separated list of profiles supported
12ee7f3e2bSKurt Borja		for this device.
13ee7f3e2bSKurt Borja
14ee7f3e2bSKurt Borja		Drivers must use the following standard profile-names:
15ee7f3e2bSKurt Borja
16ee7f3e2bSKurt Borja		====================	========================================
17ee7f3e2bSKurt Borja		low-power		Low power consumption
18ee7f3e2bSKurt Borja		cool			Cooler operation
19ee7f3e2bSKurt Borja		quiet			Quieter operation
20ee7f3e2bSKurt Borja		balanced		Balance between low power consumption
21ee7f3e2bSKurt Borja					and performance
22ee7f3e2bSKurt Borja		balanced-performance	Balance between performance and low
23ee7f3e2bSKurt Borja					power consumption with a slight bias
24ee7f3e2bSKurt Borja					towards performance
25ee7f3e2bSKurt Borja		performance		High performance operation
26*5aefbf5bSDerek J. Clark		max-power		Higher performance operation that may exceed
27*5aefbf5bSDerek J. Clark					internal battery draw limits when on AC power
28ee7f3e2bSKurt Borja		custom			Driver defined custom profile
29ee7f3e2bSKurt Borja		====================	========================================
30ee7f3e2bSKurt Borja
31ee7f3e2bSKurt Borja		RO
32ee7f3e2bSKurt Borja
33ee7f3e2bSKurt BorjaWhat:		/sys/class/platform-profile/platform-profile-X/profile
34ee7f3e2bSKurt BorjaDate:		March 2025
35ee7f3e2bSKurt BorjaKernelVersion:	6.14
36ee7f3e2bSKurt BorjaDescription:	Reading this file gives the current selected profile for this
37ee7f3e2bSKurt Borja		device. Writing this file with one of the strings from
38ee7f3e2bSKurt Borja		platform_profile_choices changes the profile to the new value.
39ee7f3e2bSKurt Borja
40ee7f3e2bSKurt Borja		This file can be monitored for changes by polling for POLLPRI,
41ee7f3e2bSKurt Borja		POLLPRI will be signaled on any changes, independent of those
42ee7f3e2bSKurt Borja		changes coming from a userspace write; or coming from another
43ee7f3e2bSKurt Borja		source such as e.g. a hotkey triggered profile change handled
44ee7f3e2bSKurt Borja		either directly by the embedded-controller or fully handled
45ee7f3e2bSKurt Borja		inside the kernel.
46ee7f3e2bSKurt Borja
47ee7f3e2bSKurt Borja		This file may also emit the string 'custom' to indicate
48ee7f3e2bSKurt Borja		that the driver is using a driver defined custom profile.
49ee7f3e2bSKurt Borja
50ee7f3e2bSKurt Borja		RW
51