Skip to contentSkip to conversation

Documentation: Add documentation for new platform_profile sysfs attribute

RFC PATCH In review Mark Pearson 3 participants 9 messages Oct 26, 2020 – Oct 27, 2020

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

RFC PATCH 1/1 Documentation: Add documentation for new platform_profile sysfs attribute

From: Hans de Goede <[email protected]>

On modern systems the platform performance, temperature, fan and other hardware related characteristics are often dynamically configurable. The profile is often automatically adjusted to the load by somei automatic-mechanism (which may very well live outside the kernel).

These auto platform-adjustment mechanisms often can be configured with one of several 'platform-profiles', with either a bias towards low-power consumption or towards performance (and higher power consumption and thermals).

Introduce a new platform_profile sysfs API which offers a generic API for selecting the performance-profile of these automatic-mechanisms.

---
 .../ABI/testing/sysfs-platform_profile        | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-platform_profile
Documentation/ABI/testing/sysfs-platform_profile new file +85 -0
new file mode 100644
index 000000000000..37cb6275946c
@@ -0,0 +1,85 @@
+Platform-profile selection (e.g. /sys/firmware/acpi/platform_profile)
+
+On modern systems the platform performance, temperature, fan and other
+hardware related characteristics are often dynamically configurable. The
+profile is often automatically adjusted to the load by some
+automatic-mechanism (which may very well live outside the kernel).
+
+These auto platform-adjustment mechanisms often can be configured with
+one of several 'platform-profiles', with either a bias towards low-power
+consumption or towards performance (and higher power consumption and
+thermals).
+
+The purpose of the platform_profile attribute is to offer a generic sysfs
+API for selecting the platform-profile of these automatic-mechanisms.
+
+Note that this API is only for selecting the platform-profile, it is
+NOT a goal of this API to allow monitoring the resulting performance
+characteristics. Monitoring performance is best done with device/vendor
+specific tools such as e.g. turbostat.
+
+Specifically when selecting a high-performance profile the actual achieved
+performance may be limited by various factors such as: the heat generated
+by other components, room temperature, free air flow at the bottom of a
+laptop, etc. It is explicitly NOT a goal of this API to let userspace know
+about any sub-optimal conditions which are impeding reaching the requested
+performance level.
+
+Since numbers are a rather meaningless way to describe platform-profiles
+this API uses strings to describe the various profiles. To make sure that
+userspace gets a consistent experience when using this API this API
+document defines a fixed set of profile-names. Drivers *must* map their
+internal profile representation/names onto this fixed set.
+
+If for some reason there is no good match when mapping then a new profile-name
+may be added. Drivers which wish to introduce new profile-names must:
+1. Have very good reasons to do so.
+2. Add the new profile-name to this document, so that future drivers which also
+   have a similar problem can use the same new. Usually new profile-names will
+   be added to the "extra profile-names" section of this document. But in some
+   cases the set of standard profile-names may be extended.
+
+What:		/sys/firmware/acpi/platform_profile_choices
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:
+		Reading this file gives a space separated list of profiles
+		supported for this device.
+
+		Drivers must use the following standard profile-names whenever
+		possible:
+
+		low-power:		Emphasises low power consumption
+		quiet:			Offers quieter operation (lower fan
+					speed but with higher performance and
+					temperatures then seen in low-power
+		balanced:		Balance between low power consumption
+					and performance
+		performance:		Emphasises performance (and may lead to
+					higher temperatures and fan speeds)
+
+		Userspace may expect drivers to offer at least several of these
+		standard profile-names! If none of the above are a good match
+		for some of the drivers profiles, then drivers may use one of
+		these extra profile-names:
+		<reserved for future use>
+
+What:		/sys/firmware/acpi/platform_profile
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:
+		Reading this file gives the current selected profile for this
+		device. Writing this file with one of the strings from
+		available_profiles changes the profile to the new value.
+
+		Reading this file may also return "custom". This is intended for
+		drivers which have and export multiple knobs. Such drivers may
+		very well still want to offer a set of profiles for easy of use
+		and to be able to offer a consistent standard API (this API) to
+		userspace for configuring their performance. The "custom" value
+		is intended for when ai user has directly configured the knobs
+		(through e.g. some advanced control-panel for a GPU) and the
+		knob values do not match any of the presets represented by the
+		platform-profiles. In this case writing this file will
+		override the modifications and restore the selected presets.
+
Signature · 1 line
2.28.0
#1 lore raw

Hi Mark,

Thank you for this new version.

Quoted 57 lines · Mark Pearson

From: Hans de Goede <[email protected]>

On modern systems the platform performance, temperature, fan and other hardware related characteristics are often dynamically configurable. The profile is often automatically adjusted to the load by somei automatic-mechanism (which may very well live outside the kernel).

These auto platform-adjustment mechanisms often can be configured with one of several 'platform-profiles', with either a bias towards low-power consumption or towards performance (and higher power consumption and thermals).

Introduce a new platform_profile sysfs API which offers a generic API for selecting the performance-profile of these automatic-mechanisms.

---
 .../ABI/testing/sysfs-platform_profile        | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-platform_profile
Documentation/ABI/testing/sysfs-platform_profile new file +28 -0
new file mode 100644
index 000000000000..37cb6275946c
@@ -0,0 +1,85 @@
+Platform-profile selection (e.g. /sys/firmware/acpi/platform_profile)
+
+On modern systems the platform performance, temperature, fan and other
+hardware related characteristics are often dynamically configurable. The
+profile is often automatically adjusted to the load by some
+automatic-mechanism (which may very well live outside the kernel).
+
+These auto platform-adjustment mechanisms often can be configured with
+one of several 'platform-profiles', with either a bias towards low-power
+consumption or towards performance (and higher power consumption and
+thermals).
+
+The purpose of the platform_profile attribute is to offer a generic sysfs
+API for selecting the platform-profile of these automatic-mechanisms.
+
+Note that this API is only for selecting the platform-profile, it is
+NOT a goal of this API to allow monitoring the resulting performance
+characteristics. Monitoring performance is best done with device/vendor
+specific tools such as e.g. turbostat.
+
+Specifically when selecting a high-performance profile the actual achieved
+performance may be limited by various factors such as: the heat generated
+by other components, room temperature, free air flow at the bottom of a
+laptop, etc. It is explicitly NOT a goal of this API to let userspace know
+about any sub-optimal conditions which are impeding reaching the requested
+performance level.
+
+Since numbers are a rather meaningless way to describe platform-profiles

Documentation/ABI/testing/sysfs-platform_profile line 38

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+this API uses strings to describe the various profiles. To make sure that
+userspace gets a consistent experience when using this API this API
+document defines a fixed set of profile-names. Drivers *must* map their
+internal profile representation/names onto this fixed set.
+
+If for some reason there is no good match when mapping then a new profile-name
+may be added. Drivers which wish to introduce new profile-names must:
+1. Have very good reasons to do so.
+2. Add the new profile-name to this document, so that future drivers which also
+   have a similar problem can use the same new.

s/same new/same name/

Documentation/ABI/testing/sysfs-platform_profile line 40

Quoted 3 lines
Documentation/ABI/testing/sysfs-platform_profile new file +3 -0
+ Usually new profile-names will
+   be added to the "extra profile-names" section of this document. But in some
+   cases the set of standard profile-names may be extended.

With the change from a more generic API to this new one more targeted towards DPTF I would drop this part.

Quoted 5 lines
Documentation/ABI/testing/sysfs-platform_profile new file +5 -0
+
+What:		/sys/firmware/acpi/platform_profile_choices
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:

Documentation/ABI/testing/sysfs-platform_profile line 55

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+		Reading this file gives a space separated list of profiles
+		supported for this device.
+
+		Drivers must use the following standard profile-names whenever
+		possible:
+
+		low-power:		Emphasises low power consumption
+		quiet:			Offers quieter operation (lower fan
+					speed but with higher performance and
+					temperatures then seen in low-power

I think the description here is a bit too specific, this may cause userspace to have expectations which are not necessary true. I would describe this as just:

quiet: Emphasises quieter operation

Quoted 8 lines
Documentation/ABI/testing/sysfs-platform_profile new file +8 -0
+		balanced:		Balance between low power consumption
+					and performance
+		performance:		Emphasises performance (and may lead to
+					higher temperatures and fan speeds)
+
+		Userspace may expect drivers to offer at least several of these
+		standard profile-names! If none of the above are a good match
+		for some of the drivers profiles, then drivers may use one of

Documentation/ABI/testing/sysfs-platform_profile line 73

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+		these extra profile-names:
+		<reserved for future use>
+
+What:		/sys/firmware/acpi/platform_profile
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:
+		Reading this file gives the current selected profile for this
+		device. Writing this file with one of the strings from
+		available_profiles changes the profile to the new value.

The part about custom profiles below may be dropped. That was intended for use with e.g. GPUs but since this now strictly is a system-level profile API, the part below can be dropped now.

Documentation/ABI/testing/sysfs-platform_profile line 85

Quoted 13 lines
Documentation/ABI/testing/sysfs-platform_profile new file +12 -0
+
+		Reading this file may also return "custom". This is intended for
+		drivers which have and export multiple knobs. Such drivers may
+		very well still want to offer a set of profiles for easy of use
+		and to be able to offer a consistent standard API (this API) to
+		userspace for configuring their performance. The "custom" value
+		is intended for when ai user has directly configured the knobs
+		(through e.g. some advanced control-panel for a GPU) and the
+		knob values do not match any of the presets represented by the
+		platform-profiles. In this case writing this file will
+		override the modifications and restore the selected presets.
+

Regards,

Hans

#2 lore raw
In reply to Mark Pearson

Hi Mark,

Thank you for this new version.

Quoted 57 lines · Mark Pearson

From: Hans de Goede <[email protected]>

On modern systems the platform performance, temperature, fan and other hardware related characteristics are often dynamically configurable. The profile is often automatically adjusted to the load by somei automatic-mechanism (which may very well live outside the kernel).

These auto platform-adjustment mechanisms often can be configured with one of several 'platform-profiles', with either a bias towards low-power consumption or towards performance (and higher power consumption and thermals).

Introduce a new platform_profile sysfs API which offers a generic API for selecting the performance-profile of these automatic-mechanisms.

---
 .../ABI/testing/sysfs-platform_profile        | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-platform_profile
Documentation/ABI/testing/sysfs-platform_profile new file +28 -0
new file mode 100644
index 000000000000..37cb6275946c
@@ -0,0 +1,85 @@
+Platform-profile selection (e.g. /sys/firmware/acpi/platform_profile)
+
+On modern systems the platform performance, temperature, fan and other
+hardware related characteristics are often dynamically configurable. The
+profile is often automatically adjusted to the load by some
+automatic-mechanism (which may very well live outside the kernel).
+
+These auto platform-adjustment mechanisms often can be configured with
+one of several 'platform-profiles', with either a bias towards low-power
+consumption or towards performance (and higher power consumption and
+thermals).
+
+The purpose of the platform_profile attribute is to offer a generic sysfs
+API for selecting the platform-profile of these automatic-mechanisms.
+
+Note that this API is only for selecting the platform-profile, it is
+NOT a goal of this API to allow monitoring the resulting performance
+characteristics. Monitoring performance is best done with device/vendor
+specific tools such as e.g. turbostat.
+
+Specifically when selecting a high-performance profile the actual achieved
+performance may be limited by various factors such as: the heat generated
+by other components, room temperature, free air flow at the bottom of a
+laptop, etc. It is explicitly NOT a goal of this API to let userspace know
+about any sub-optimal conditions which are impeding reaching the requested
+performance level.
+
+Since numbers are a rather meaningless way to describe platform-profiles

Documentation/ABI/testing/sysfs-platform_profile line 38

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+this API uses strings to describe the various profiles. To make sure that
+userspace gets a consistent experience when using this API this API
+document defines a fixed set of profile-names. Drivers *must* map their
+internal profile representation/names onto this fixed set.
+
+If for some reason there is no good match when mapping then a new profile-name
+may be added. Drivers which wish to introduce new profile-names must:
+1. Have very good reasons to do so.
+2. Add the new profile-name to this document, so that future drivers which also
+   have a similar problem can use the same new.

s/same new/same name/

Documentation/ABI/testing/sysfs-platform_profile line 40

Quoted 3 lines
Documentation/ABI/testing/sysfs-platform_profile new file +3 -0
+ Usually new profile-names will
+   be added to the "extra profile-names" section of this document. But in some
+   cases the set of standard profile-names may be extended.

With the change from a more generic API to this new one more targeted towards DPTF I would drop this part.

Quoted 5 lines
Documentation/ABI/testing/sysfs-platform_profile new file +5 -0
+
+What:		/sys/firmware/acpi/platform_profile_choices
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:

Documentation/ABI/testing/sysfs-platform_profile line 55

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+		Reading this file gives a space separated list of profiles
+		supported for this device.
+
+		Drivers must use the following standard profile-names whenever
+		possible:
+
+		low-power:		Emphasises low power consumption
+		quiet:			Offers quieter operation (lower fan
+					speed but with higher performance and
+					temperatures then seen in low-power

I think the description here is a bit too specific, this may cause userspace to have expectations which are not necessary true. I would describe this as just:

quiet: Emphasises quieter operation

Quoted 8 lines
Documentation/ABI/testing/sysfs-platform_profile new file +8 -0
+		balanced:		Balance between low power consumption
+					and performance
+		performance:		Emphasises performance (and may lead to
+					higher temperatures and fan speeds)
+
+		Userspace may expect drivers to offer at least several of these
+		standard profile-names! If none of the above are a good match
+		for some of the drivers profiles, then drivers may use one of

Documentation/ABI/testing/sysfs-platform_profile line 73

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+		these extra profile-names:
+		<reserved for future use>
+
+What:		/sys/firmware/acpi/platform_profile
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:
+		Reading this file gives the current selected profile for this
+		device. Writing this file with one of the strings from
+		available_profiles changes the profile to the new value.

The part about custom profiles below may be dropped. That was intended for use with e.g. GPUs but since this now strictly is a system-level profile API, the part below can be dropped now.

Documentation/ABI/testing/sysfs-platform_profile line 85

Quoted 13 lines
Documentation/ABI/testing/sysfs-platform_profile new file +12 -0
+
+		Reading this file may also return "custom". This is intended for
+		drivers which have and export multiple knobs. Such drivers may
+		very well still want to offer a set of profiles for easy of use
+		and to be able to offer a consistent standard API (this API) to
+		userspace for configuring their performance. The "custom" value
+		is intended for when ai user has directly configured the knobs
+		(through e.g. some advanced control-panel for a GPU) and the
+		knob values do not match any of the presets represented by the
+		platform-profiles. In this case writing this file will
+		override the modifications and restore the selected presets.
+

Regards,

Hans

#3 lore raw

Thanks Hans

Quoted 7 lines · Hans de Goede

Hi Mark,

Thank you for this new version.

Quoted 2 lines · Mark Pearson

From: Hans de Goede <[email protected]>

<snip>

Quoted 8 lines

Documentation/ABI/testing/sysfs-platform_profile

Quoted 6 lines
Documentation/ABI/testing/sysfs-platform_profile new file +6 -0
+
+If for some reason there is no good match when mapping then a new profile-name
+may be added. Drivers which wish to introduce new profile-names must:
+1. Have very good reasons to do so.
+2. Add the new profile-name to this document, so that future drivers which also
+   have a similar problem can use the same new.

s/same new/same name/

I've read this document so many times...I'm not sure how I missed that one. Thanks.

Quoted 7 lines

Documentation/ABI/testing/sysfs-platform_profile line 40

Quoted 4 lines

+ Usually new profile-names will

Documentation/ABI/testing/sysfs-platform_profile new file +2 -0
+   be added to the "extra profile-names" section of this document. But in some
+   cases the set of standard profile-names may be extended.

With the change from a more generic API to this new one more targeted towards DPTF I would drop this part.

OK - I have some questions then related to this change, below

Quoted 22 lines
Quoted 7 lines
Documentation/ABI/testing/sysfs-platform_profile new file +5 -0
+
+What:		/sys/firmware/acpi/platform_profile_choices
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:

Documentation/ABI/testing/sysfs-platform_profile line 55

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+		Reading this file gives a space separated list of profiles
+		supported for this device.
+
+		Drivers must use the following standard profile-names whenever
+		possible:
+
+		low-power:		Emphasises low power consumption
+		quiet:			Offers quieter operation (lower fan
+					speed but with higher performance and
+					temperatures then seen in low-power

I think the description here is a bit too specific, this may cause userspace to have expectations which are not necessary true. I would describe this as just:

Quoted 2 lines

quiet: Emphasises quieter operation

Agreed. I'll update

Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 66

Quoted 11 lines
Documentation/ABI/testing/sysfs-platform_profile new file +11 -0
+		balanced:		Balance between low power consumption
+					and performance
+		performance:		Emphasises performance (and may lead to
+					higher temperatures and fan speeds)
+
+		Userspace may expect drivers to offer at least several of these
+		standard profile-names! If none of the above are a good match
+		for some of the drivers profiles, then drivers may use one of
+		these extra profile-names:
+		<reserved for future use>
+

If we remove the extra profile-names section above then I think it should be removed here too. If someone wants to add a new 'mode' then it would be added to the list of 'standard names', and becomes a new option. Wanted to check I'm not missing something important.

Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 73

Quoted 7 lines
Documentation/ABI/testing/sysfs-platform_profile new file +7 -0
+What:		/sys/firmware/acpi/platform_profile
+Date:		October 2020
+Contact:	Hans de Goede <[email protected]>
+Description:
+		Reading this file gives the current selected profile for this
+		device. Writing this file with one of the strings from
+		available_profiles changes the profile to the new value.

The part about custom profiles below may be dropped. That was intended for use with e.g. GPUs but since this now strictly is a system-level profile API, the part below can be dropped now.

Agreed

Quoted 18 lines
Quoted 5 lines
Documentation/ABI/testing/sysfs-platform_profile new file +2 -0
+
+		Reading this file may also return "custom". This is intended for

Documentation/ABI/testing/sysfs-platform_profile line 85

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+		drivers which have and export multiple knobs. Such drivers may
+		very well still want to offer a set of profiles for easy of use
+		and to be able to offer a consistent standard API (this API) to
+		userspace for configuring their performance. The "custom" value
+		is intended for when ai user has directly configured the knobs
+		(through e.g. some advanced control-panel for a GPU) and the
+		knob values do not match any of the presets represented by the
+		platform-profiles. In this case writing this file will
+		override the modifications and restore the selected presets.
+

Regards,

Quoted 2 lines

Hans

Thanks!
mark

#4 lore raw

Hi,

Quoted 55 lines · Mark Pearson

Thanks Hans

Quoted 7 lines · Hans de Goede

Hi Mark,

Thank you for this new version.

Quoted 2 lines · Mark Pearson

From: Hans de Goede <[email protected]>

<snip>

Quoted 8 lines

Documentation/ABI/testing/sysfs-platform_profile

Quoted 6 lines
Documentation/ABI/testing/sysfs-platform_profile new file +6 -0
+
+If for some reason there is no good match when mapping then a new profile-name
+may be added. Drivers which wish to introduce new profile-names must:
+1. Have very good reasons to do so.
+2. Add the new profile-name to this document, so that future drivers which also
+   have a similar problem can use the same new.

s/same new/same name/

I've read this document so many times...I'm not sure how I missed that one. Thanks.

Quoted 7 lines
Quoted 4 lines

+ Usually new profile-names will
+   be added to the "extra profile-names" section of this document. But in some +   cases the set of standard profile-names may be extended.

With the change from a more generic API to this new one more targeted towards DPTF I would drop this part.

OK - I have some questions then related to this change, below

Quoted 22 lines
Quoted 7 lines
Documentation/ABI/testing/sysfs-platform_profile new file +5 -0
+
+What:        /sys/firmware/acpi/platform_profile_choices
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:

Documentation/ABI/testing/sysfs-platform_profile line 55

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+        Reading this file gives a space separated list of profiles
+        supported for this device.
+
+        Drivers must use the following standard profile-names whenever
+        possible:
+
+        low-power:        Emphasises low power consumption
+        quiet:            Offers quieter operation (lower fan
+                    speed but with higher performance and
+                    temperatures then seen in low-power

I think the description here is a bit too specific, this may cause userspace to have expectations which are not necessary true. I would describe this as just:

Quoted 2 lines

        quiet:            Emphasises quieter operation

Agreed. I'll update

Quoted 12 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 66

Quoted 11 lines

+        balanced:        Balance between low power consumption +                    and performance
+        performance:        Emphasises performance (and may lead to +                    higher temperatures and fan speeds)

Documentation/ABI/testing/sysfs-platform_profile new file +7 -0
+
+        Userspace may expect drivers to offer at least several of these
+        standard profile-names! If none of the above are a good match
+        for some of the drivers profiles, then drivers may use one of
+        these extra profile-names:
+        <reserved for future use>
+

If we remove the extra profile-names section above then I think it should be removed here too. If someone wants to add a new 'mode' then it would be added to the list of 'standard names', and becomes a new option. Wanted to check I'm not missing something important.

You are completely right, any references to an extra profile-names section should be removed here too. I did intend to add that it should be removed here too, but I forgot.

Quoted 30 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 73

Quoted 7 lines
Documentation/ABI/testing/sysfs-platform_profile new file +7 -0
+What:        /sys/firmware/acpi/platform_profile
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:
+        Reading this file gives the current selected profile for this
+        device. Writing this file with one of the strings from
+        available_profiles changes the profile to the new value.

The part about custom profiles below may be dropped. That was intended for use with e.g. GPUs but since this now strictly is a system-level profile API, the part below can be dropped now.

Agreed

Quoted 18 lines
Quoted 5 lines
Documentation/ABI/testing/sysfs-platform_profile new file +2 -0
+
+        Reading this file may also return "custom". This is intended for

Documentation/ABI/testing/sysfs-platform_profile line 85

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+        drivers which have and export multiple knobs. Such drivers may
+        very well still want to offer a set of profiles for easy of use
+        and to be able to offer a consistent standard API (this API) to
+        userspace for configuring their performance. The "custom" value
+        is intended for when ai user has directly configured the knobs
+        (through e.g. some advanced control-panel for a GPU) and the
+        knob values do not match any of the presets represented by the
+        platform-profiles. In this case writing this file will
+        override the modifications and restore the selected presets.
+

Regards,

Quoted 4 lines
Quoted 2 lines

Hans

Thanks!
mark

Regards,

Hans

#5 lore raw

Hi to all,

In data martedì 27 ottobre 2020 08:54:44 CET, Hans de Goede ha scritto:

Quoted 109 lines

Hi,

Quoted 56 lines · Mark Pearson

Thanks Hans

Quoted 6 lines · Hans de Goede

Hi Mark,

Thank you for this new version.

Quoted 1 line · Mark Pearson

From: Hans de Goede <[email protected]>

<snip>

Quoted 8 lines
Quoted 6 lines
(quoted diff) +2 -0
+
+If for some reason there is no good match when mapping then a new

profile-name +may be added. Drivers which wish to introduce new profile-names must: +1. Have very good reasons to do so. +2. Add the new profile-name to this document, so that future drivers
which also + have a similar problem can use the same new.

s/same new/same name/

I've read this document so many times...I'm not sure how I missed that one. Thanks.>

Quoted 6 lines
Quoted 3 lines

+ Usually new profile-names will
+ be added to the "extra profile-names" section of this document. But
in some + cases the set of standard profile-names may be extended.

With the change from a more generic API to this new one more targeted towards DPTF I would drop this part.

OK - I have some questions then related to this change, below

Quoted 20 lines
Quoted 5 lines
Documentation/ABI/testing/sysfs-platform_profile new file +5 -0
+
+What:        /sys/firmware/acpi/platform_profile_choices
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:

Documentation/ABI/testing/sysfs-platform_profile line 55

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+        Reading this file gives a space separated list of profiles
+        supported for this device.
+
+        Drivers must use the following standard profile-names whenever
+        possible:
+
+        low-power:        Emphasises low power consumption
+        quiet:            Offers quieter operation (lower fan
+                    speed but with higher performance and
+                    temperatures then seen in low-power

I think the description here is a bit too specific, this may cause userspace to have expectations which are not necessary true. I would describe this as just:

Quoted 1 line

quiet: Emphasises quieter operation

Agreed. I'll update

Quoted 16 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 66

Quoted 11 lines
Documentation/ABI/testing/sysfs-platform_profile new file +11 -0
+        balanced:        Balance between low power consumption
+                    and performance
+        performance:        Emphasises performance (and may lead to
+                    higher temperatures and fan speeds)
+
+        Userspace may expect drivers to offer at least several of these
+        standard profile-names! If none of the above are a good match
+        for some of the drivers profiles, then drivers may use one of
+        these extra profile-names:
+        <reserved for future use>
+

If we remove the extra profile-names section above then I think it should be removed here too. If someone wants to add a new 'mode' then it would be added to the list of 'standard names', and becomes a new option. Wanted to check I'm not missing something important.

You are completely right, any references to an extra profile-names section should be removed here too. I did intend to add that it should be removed here too, but I forgot.

Quoted 30 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 73

Quoted 7 lines
Documentation/ABI/testing/sysfs-platform_profile new file +7 -0
+What:        /sys/firmware/acpi/platform_profile
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:
+        Reading this file gives the current selected profile for this
+        device. Writing this file with one of the strings from
+        available_profiles changes the profile to the new value.

The part about custom profiles below may be dropped. That was intended for use with e.g. GPUs but since this now strictly is a system-level profile API, the part below can be dropped now.

Agreed

Quoted 16 lines

Documentation/ABI/testing/sysfs-platform_profile line 85

Quoted 13 lines
(quoted diff) +2 -0
+
+        Reading this file may also return "custom". This is intended

for

Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+        drivers which have and export multiple knobs. Such drivers may
+        very well still want to offer a set of profiles for easy of use
+        and to be able to offer a consistent standard API (this API) to
+        userspace for configuring their performance. The "custom" value
+        is intended for when ai user has directly configured the knobs
+        (through e.g. some advanced control-panel for a GPU) and the
+        knob values do not match any of the presets represented by the
+        platform-profiles. In this case writing this file will
+        override the modifications and restore the selected presets.
+

Regards,

Quoted 8 lines
Quoted 4 lines
Quoted 1 line

Hans

Thanks!
mark

Regards,

Hans

This look good,
only thing is that hp-wmi driver need a cool profile (Emphasises the computer cool to touch), if you can add it would be perfect.

Regards
Elia

#6 lore raw

Hi Elia

Quoted 119 lines · Elia Devito

Hi to all,

In data martedì 27 ottobre 2020 08:54:44 CET, Hans de Goede ha scritto:

Quoted 116 lines

Hi,

Quoted 56 lines · Mark Pearson

Thanks Hans

Quoted 6 lines · Hans de Goede

Hi Mark,

Thank you for this new version.

Quoted 1 line · Mark Pearson

From: Hans de Goede <[email protected]>

<snip>

Quoted 8 lines
Quoted 6 lines
(quoted diff) +2 -0
+
+If for some reason there is no good match when mapping then a new

profile-name +may be added. Drivers which wish to introduce new profile-names must: +1. Have very good reasons to do so. +2. Add the new profile-name to this document, so that future drivers
which also + have a similar problem can use the same new.

s/same new/same name/

I've read this document so many times...I'm not sure how I missed that one. Thanks.>

Quoted 6 lines
Quoted 3 lines

+ Usually new profile-names will
+ be added to the "extra profile-names" section of this document. But
in some + cases the set of standard profile-names may be extended.

With the change from a more generic API to this new one more targeted towards DPTF I would drop this part.

OK - I have some questions then related to this change, below

Quoted 20 lines
Quoted 5 lines
Documentation/ABI/testing/sysfs-platform_profile new file +5 -0
+
+What:        /sys/firmware/acpi/platform_profile_choices
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:

Documentation/ABI/testing/sysfs-platform_profile line 55

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+        Reading this file gives a space separated list of profiles
+        supported for this device.
+
+        Drivers must use the following standard profile-names whenever
+        possible:
+
+        low-power:        Emphasises low power consumption
+        quiet:            Offers quieter operation (lower fan
+                    speed but with higher performance and
+                    temperatures then seen in low-power

I think the description here is a bit too specific, this may cause userspace to have expectations which are not necessary true. I would describe this as just:

Quoted 1 line

quiet: Emphasises quieter operation

Agreed. I'll update

Quoted 16 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 66

Quoted 11 lines
Documentation/ABI/testing/sysfs-platform_profile new file +11 -0
+        balanced:        Balance between low power consumption
+                    and performance
+        performance:        Emphasises performance (and may lead to
+                    higher temperatures and fan speeds)
+
+        Userspace may expect drivers to offer at least several of these
+        standard profile-names! If none of the above are a good match
+        for some of the drivers profiles, then drivers may use one of
+        these extra profile-names:
+        <reserved for future use>
+

If we remove the extra profile-names section above then I think it should be removed here too. If someone wants to add a new 'mode' then it would be added to the list of 'standard names', and becomes a new option. Wanted to check I'm not missing something important.

You are completely right, any references to an extra profile-names section should be removed here too. I did intend to add that it should be removed here too, but I forgot.

Quoted 30 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 73

Quoted 7 lines
Documentation/ABI/testing/sysfs-platform_profile new file +7 -0
+What:        /sys/firmware/acpi/platform_profile
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:
+        Reading this file gives the current selected profile for this
+        device. Writing this file with one of the strings from
+        available_profiles changes the profile to the new value.

The part about custom profiles below may be dropped. That was intended for use with e.g. GPUs but since this now strictly is a system-level profile API, the part below can be dropped now.

Agreed

Quoted 16 lines

Documentation/ABI/testing/sysfs-platform_profile line 85

Quoted 13 lines
(quoted diff) +2 -0
+
+        Reading this file may also return "custom". This is intended

for

Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+        drivers which have and export multiple knobs. Such drivers may
+        very well still want to offer a set of profiles for easy of use
+        and to be able to offer a consistent standard API (this API) to
+        userspace for configuring their performance. The "custom" value
+        is intended for when ai user has directly configured the knobs
+        (through e.g. some advanced control-panel for a GPU) and the
+        knob values do not match any of the presets represented by the
+        platform-profiles. In this case writing this file will
+        override the modifications and restore the selected presets.
+

Regards,

Quoted 4 lines
Quoted 1 line

Hans

Thanks!
mark

Regards,

Quoted 11 lines
Quoted 1 line

Hans

This look good,
only thing is that hp-wmi driver need a cool profile (Emphasises the computer cool to touch), if you can add it would be perfect.

Regards
Elia

Is low-power is different to cool? I figured low-power was going to be cool so combined them.
I could call it low-power-cool if that helps? It seems a little clunky but not too bad. I'm sure the user space folks can put sunglasses on it or something ;)

Mark

#7 lore raw

Hi Mark,

Quoted 128 lines · Mark Pearson

Hi Elia

Quoted 125 lines · Elia Devito

Hi to all,

In data martedì 27 ottobre 2020 08:54:44 CET, Hans de Goede ha scritto:

Quoted 109 lines

Hi,

Quoted 56 lines · Mark Pearson

Thanks Hans

Quoted 6 lines · Hans de Goede

Hi Mark,

Thank you for this new version.

Quoted 1 line · Mark Pearson

From: Hans de Goede <[email protected]>

<snip>

Quoted 8 lines
Quoted 6 lines
(quoted diff) +2 -0
+
+If for some reason there is no good match when mapping then a new

profile-name +may be added. Drivers which wish to introduce new profile-names must: +1. Have very good reasons to do so. +2. Add the new profile-name to this document, so that future drivers which also +   have a similar problem can use the same new.

s/same new/same name/

I've read this document so many times...I'm not sure how I missed that one. Thanks.>

Quoted 6 lines
Quoted 3 lines

+ Usually new profile-names will
+   be added to the "extra profile-names" section of this document. But in some +   cases the set of standard profile-names may be extended.

With the change from a more generic API to this new one more targeted towards DPTF I would drop this part.

OK - I have some questions then related to this change, below

Quoted 20 lines
Quoted 5 lines
Documentation/ABI/testing/sysfs-platform_profile new file +5 -0
+
+What:        /sys/firmware/acpi/platform_profile_choices
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:

Documentation/ABI/testing/sysfs-platform_profile line 55

Quoted 10 lines
Documentation/ABI/testing/sysfs-platform_profile new file +10 -0
+        Reading this file gives a space separated list of profiles
+        supported for this device.
+
+        Drivers must use the following standard profile-names whenever
+        possible:
+
+        low-power:        Emphasises low power consumption
+        quiet:            Offers quieter operation (lower fan
+                    speed but with higher performance and
+                    temperatures then seen in low-power

I think the description here is a bit too specific, this may cause userspace to have expectations which are not necessary true. I would describe this as just:

Quoted 1 line

         quiet:            Emphasises quieter operation

Agreed. I'll update

Quoted 16 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 66

Quoted 11 lines

+        balanced:        Balance between low power consumption +                    and performance
+        performance:        Emphasises performance (and may lead to +                    higher temperatures and fan speeds)

Documentation/ABI/testing/sysfs-platform_profile new file +7 -0
+
+        Userspace may expect drivers to offer at least several of these
+        standard profile-names! If none of the above are a good match
+        for some of the drivers profiles, then drivers may use one of
+        these extra profile-names:
+        <reserved for future use>
+

If we remove the extra profile-names section above then I think it should be removed here too. If someone wants to add a new 'mode' then it would be added to the list of 'standard names', and becomes a new option. Wanted to check I'm not missing something important.

You are completely right, any references to an extra profile-names section should be removed here too. I did intend to add that it should be removed here too, but I forgot.

Quoted 30 lines
Quoted 11 lines

Documentation/ABI/testing/sysfs-platform_profile line 73

Quoted 7 lines
Documentation/ABI/testing/sysfs-platform_profile new file +7 -0
+What:        /sys/firmware/acpi/platform_profile
+Date:        October 2020
+Contact:    Hans de Goede <[email protected]>
+Description:
+        Reading this file gives the current selected profile for this
+        device. Writing this file with one of the strings from
+        available_profiles changes the profile to the new value.

The part about custom profiles below may be dropped. That was intended for use with e.g. GPUs but since this now strictly is a system-level profile API, the part below can be dropped now.

Agreed

Quoted 16 lines
Quoted 5 lines

+
+        Reading this file may also return "custom". This is intended for
+        drivers which have and export multiple knobs. Such drivers may +        very well still want to offer a set of profiles for easy of use

Quoted 8 lines

+        and to be able to offer a consistent standard API (this API) to +        userspace for configuring their performance. The "custom" value +        is intended for when ai user has directly configured the knobs +        (through e.g. some advanced control-panel for a GPU) and the +        knob values do not match any of the presets represented by the +        platform-profiles. In this case writing this file will +        override the modifications and restore the selected presets. +

Regards,

Quoted 8 lines
Quoted 4 lines
Quoted 1 line

Hans

Thanks!
mark

Regards,

Hans

This look good,
only thing is that hp-wmi driver need a cool profile (Emphasises the computer cool to touch), if you can add it would be perfect.

Quoted 7 lines
Quoted 5 lines

Regards
Elia

Is low-power is different to cool? I figured low-power was going to be cool so combined them.
I could call it low-power-cool if that helps? It seems a little clunky but not too bad. I'm sure the user space folks can put sunglasses on it or something ;)

IIRC we already had this discussion, cool means cool-to-touch, so could be done by e.g. extra aggressive ramping up of the fans, so this is not necessarily the same as low-power.

Yes this is all somewhat confusing. Luckily (for us kernel folks) we have already sorta decided to just use the profile-names from the vendors more or less as is and leave figuring this out further to userspace.

The reason to use the enum + try to have a fixed list of choices is to try and limit the proliferation of profile-names to keep things somewhat manageable.

But as I discussed previously with Elia (*) we really need all 3 of low-power cool and quiet.

Regards,

Hans

*) I was coming at this discussion from the same angle you (Mark) are

#8 lore raw
Quoted 9 lines · Hans de Goede

Hi Mark,

Quoted 6 lines · Mark Pearson

Hi Elia

Quoted 3 lines · Elia Devito

Hi to all,

In data martedì 27 ottobre 2020 08:54:44 CET, Hans de Goede ha scritto:

<snip>

Quoted 27 lines
Quoted 5 lines
Quoted 5 lines

This look good,
only thing is that hp-wmi driver need a cool profile (Emphasises the computer cool to touch), if you can add it would be perfect.

Quoted 7 lines
Quoted 5 lines

Regards
Elia

Is low-power is different to cool? I figured low-power was going to be cool so combined them.
I could call it low-power-cool if that helps? It seems a little clunky but not too bad. I'm sure the user space folks can put sunglasses on it or something ;)

IIRC we already had this discussion, cool means cool-to-touch, so could be done by e.g. extra aggressive ramping up of the fans, so this is not necessarily the same as low-power.

Yes this is all somewhat confusing. Luckily (for us kernel folks) we have already sorta decided to just use the profile-names from the vendors more or less as is and leave figuring this out further to userspace.

The reason to use the enum + try to have a fixed list of choices is to try and limit the proliferation of profile-names to keep things somewhat manageable.

But as I discussed previously with Elia (*) we really need all 3 of low-power cool and quiet.

Quoted 8 lines

Regards,

Hans

*) I was coming at this discussion from the same angle you (Mark) are

OK, I can add a cool option.

I'll get that out later today (unless Elia corrects me :))

Thanks all
Mark