xref: /linux/Documentation/ABI/testing/sysfs-platform_profile (revision 1260ed77798502de9c98020040d2995008de10cc)
18e0cbf35SMark PearsonWhat:		/sys/firmware/acpi/platform_profile_choices
28e0cbf35SMark PearsonDate:		October 2020
38e0cbf35SMark PearsonContact:	Hans de Goede <hdegoede@redhat.com>
48e0cbf35SMark PearsonDescription:	This file contains a space-separated list of profiles supported for this device.
58e0cbf35SMark Pearson
68e0cbf35SMark Pearson		Drivers must use the following standard profile-names:
78e0cbf35SMark Pearson
86c0b5e3fSMaximilian Luz		====================	========================================
98e0cbf35SMark Pearson		low-power		Low power consumption
108e0cbf35SMark Pearson		cool			Cooler operation
118e0cbf35SMark Pearson		quiet			Quieter operation
126c0b5e3fSMaximilian Luz		balanced		Balance between low power consumption
136c0b5e3fSMaximilian Luz					and performance
146c0b5e3fSMaximilian Luz		balanced-performance	Balance between performance and low
156c0b5e3fSMaximilian Luz					power consumption with a slight bias
166c0b5e3fSMaximilian Luz					towards performance
178e0cbf35SMark Pearson		performance		High performance operation
186c0b5e3fSMaximilian Luz		====================	========================================
198e0cbf35SMark Pearson
208e0cbf35SMark Pearson		Userspace may expect drivers to offer more than one of these
218e0cbf35SMark Pearson		standard profile names.
228e0cbf35SMark Pearson
238e0cbf35SMark PearsonWhat:		/sys/firmware/acpi/platform_profile
248e0cbf35SMark PearsonDate:		October 2020
258e0cbf35SMark PearsonContact:	Hans de Goede <hdegoede@redhat.com>
268e0cbf35SMark PearsonDescription:	Reading this file gives the current selected profile for this
278e0cbf35SMark Pearson		device. Writing this file with one of the strings from
288e0cbf35SMark Pearson		platform_profile_choices changes the profile to the new value.
29b25d5a1cSHans de Goede
30b25d5a1cSHans de Goede		This file can be monitored for changes by polling for POLLPRI,
31b25d5a1cSHans de Goede		POLLPRI will be signalled on any changes, independent of those
32b25d5a1cSHans de Goede		changes coming from a userspace write; or coming from another
33b25d5a1cSHans de Goede		source such as e.g. a hotkey triggered profile change handled
34b25d5a1cSHans de Goede		either directly by the embedded-controller or fully handled
35b25d5a1cSHans de Goede		inside the kernel.
36*0056b085SMario Limonciello
37*0056b085SMario Limonciello		This file may also emit the string 'custom' to indicate
38*0056b085SMario Limonciello		that multiple platform profiles drivers are in use but
39*0056b085SMario Limonciello		have different values.  This string can not be written to
40*0056b085SMario Limonciello		this interface and is solely for informational purposes.
41