From Fedora Project Wiki
mNo edit summary
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{admon/important | Comments and Explanations | The page source contains comments providing guidance to fill out each section. They are invisible when viewing this page. To read it, choose the "view source" link.<br/> '''Copy the source to a ''new page'' before making changes!  DO NOT EDIT THIS TEMPLATE FOR YOUR CHANGE PROPOSAL.'''}}


{{admon/tip | Guidance | For details on how to fill out this form, see the [https://docs.fedoraproject.org/en-US/program_management/changes_guide/ documentation].}}


{{admon/tip | Report issues | To report an issue with this template, file an issue in the [https://pagure.io/fedora-pgm/pgm_docs pgm_docs repo].}}
= Make Tuned the Default Power Profile Management Daemon =


<!-- The actual name of your proposed change page should look something like: Changes/Your_Change_Proposal_Name.  This keeps all change proposals in the same namespace -->


= Change Proposal Name <!-- The name of your change proposal --> =
== Summary ==
<!-- A sentence or two summarizing what this change is and what it will do. This information is used for the overall changeset summary page for each release. Note that motivation for the change should be in the Benefit to Fedora section below, and this part should answer the question "What?" rather than "Why?". -->


{{Change_Proposal_Banner}}
This Change makes ‘tuned’ the default power profile management daemon in Fedora Workstation, KDE Plasma, and Budgie instead of power-profiles-daemon.


== Summary ==
* tuned-ppd provides a drop-in replacement for power-profiles-daemon, which allows it to be used with current desktops
<!-- A sentence or two summarizing what this change is and what it will do. This information is used for the overall changeset summary page for each release. Note that motivation for the change should be in the Benefit to Fedora section below, and this part should answer the question "What?" rather than "Why?". -->
* power users can customize the desktop-exposed power profiles by editing /etc/tuned/ppd.conf
Tuned and power-profiles-daemon provide a similar function to set and tune the power status of a system. Both of them have similar features, if they can be integrated into one, it allows the Fedora user to have more options for power settings of their system and benefits the users.In this proposal, we set up tuned to the default power profile management daemon for the Fedora workstation, including GNOME and KDE plasma. Tuned already provides power profiles for different use cases. Recently, tuned released the translation API layer called tuned-ppd which can translate the power-profiles-daemon API to tuned. The applications that use power-profiles-daemon API can access tuned without modifying the code. For now, the Fedora user can immediately switch to tuned by installing the tuned-ppd package without impacting the user experience. Therefore, tuned can be the default power profile management daemon for Fedora.


== Owner ==
== Owner ==
Line 28: Line 25:


== Current status ==
== Current status ==
[[Category:ChangePageIncomplete]]
[[Category:ChangeAcceptedF41]]
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
Line 35: Line 32:


<!-- Select proper category, default is Self Contained Change -->
<!-- Select proper category, default is Self Contained Change -->
[[Category:SelfContainedChange]]
[[Category:SystemWideChange]]
<!-- [[Category:SystemWideChange]] -->
<!-- [[Category:SystemWideChange]] -->


Line 46: Line 43:
ON_QA -> change is fully code complete
ON_QA -> change is fully code complete
-->
-->
* [Announced]
* [https://lists.fedoraproject.org/archives/list/devel-announce@lists.fedoraproject.org/thread/3LKYJVQTK4UFWY3JJFELN3WMN4UH63OS/ Announced]
* [<will be assigned by the Wrangler> Discussion thread]
* [https://discussion.fedoraproject.org/t/f41-change-proposal-make-tuned-the-default-power-profile-management-daemon-system-wide/118554 Discussion thread]
* FESCo issue: <will be assigned by the Wrangler>
* FESCo issue: [https://pagure.io/fesco/issue/3222 #3222]
* Tracker bug: <will be assigned by the Wrangler>
* Tracker bug: [https://bugzilla.redhat.com/show_bug.cgi?id=2293628 #2293628]
* Release notes tracker: <will be assigned by the Wrangler>
* Release notes tracker: [https://gitlab.com/fedora/docs/fedora-linux-documentation/release-notes/-/issues/100 #100]


== Detailed Description ==
== Detailed Description ==
<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. -->
<!-- Expand on the summary, if appropriate.  A couple sentences suffices to explain the goal, but the more details you can provide the better. -->
<p>
Tuned and power-profiles-daemon provide a similar function to set and tune the power status of a system. Both of them have similar features, if they can be integrated into one, it allows the Fedora user to have more options for power settings of their system and benefits the users. In this proposal, we set up tuned to the default power profile management daemon for the GNOME in Fedora Workstation and the KDE Plasma Spin. Tuned already provides power profiles for different use cases. Recently, tuned released the translation API layer called tuned-ppd which can translate the power-profiles-daemon API to tuned. The applications that use power-profiles-daemon API can access tuned without modifying the code. For now, the Fedora user can immediately switch to tuned by installing the tuned-ppd package without impacting the user experience. Therefore, tuned can be the default power profile management daemon for Fedora.
</p>
<p>
<p>
This work would replace power-profiles-daemon with tuned. Since tuned already provides a wide range of power profiles for different purposes, this allows the user to have more options for configuring the system power profile.
This work would replace power-profiles-daemon with tuned. Since tuned already provides a wide range of power profiles for different purposes, this allows the user to have more options for configuring the system power profile.
Tuned provides many kinds of advanced and basic profiles for different purposes. Power-profiles-daemon provides the basic power profiles and the profiles can be set to the system through platform_profiles, Intel p-state and AMD p-state. That is simple and clever. However, if the users want to ask for an advanced profile, they need to install another power utility, such as tuned to fine-tune their system. If tuned can be the default power profile management daemon, the users would have a wide range of profiles to fine-tune the system.
Tuned provides many kinds of advanced and basic profiles for different purposes. Power-profiles-daemon provides the basic power profiles and the profiles can be set to the system through platform_profiles, Intel p-state and AMD p-state. That is simple and clever. However, if the users want to ask for an advanced profile, they need to install another power utility, such as tuned to fine-tune their system. With tuned as the default power profile management daemon, users have a wider range of profiles to fine-tune the system.
</p>
</p>
<p>
<p>
Tuned released a new translation API service called tuned-ppd <ref>https://github.com/redhat-performance/tuned/tree/master/tuned/ppd</ref>. tuned-ppd can translate the power-profiles-daemon API to tuned API so the application can talk with tuned without modifying the codes. Moreover, the GUI settings, such as gnome-control-center can configure tuned profile through tuned-ppd. tuned-ppd also allows the user to override the basic three power profiles, including power-saver, balanced, and performance through the config file /etc/tuned/ppd.conf <ref>https://github.com/redhat-performance/tuned/blob/master/tuned/ppd/ppd.conf</ref>. If the user wants to use a customized profile, they can edit the config file and map the custom profile to the basic three power-profiles-daemon profile names. In this way, gnome-control-center can keep the original design to configure the customized profile.
Tuned released a new translation API service called tuned-ppd <ref>https://github.com/redhat-performance/tuned/tree/master/tuned/ppd</ref>. tuned-ppd can translate the power-profiles-daemon API to the tuned API so applications can talk with tuned without modification. Moreover, the GUI settings, such as gnome-control-center can configure tuned profiles through tuned-ppd. tuned-ppd also allows the user to override the basic three power profiles, including power-saver, balanced, and performance through the config file /etc/tuned/ppd.conf <ref>https://github.com/redhat-performance/tuned/blob/master/tuned/ppd/ppd.conf</ref>. If the user wants to use a customized profile, they can edit the config file and map the custom profile to the basic three power-profiles-daemon profile names. In this way, gnome-control-center can keep the original design to configure the customized profile.
</p>
</p>
<p>
<p>
The work expects the tuned to replace the power-profiles-daemons to offer a wide range of power profiles to the fedora users. tuned-ppd resolved the API translation issue so the application can access tuned service through power-profiles-daemon API without converting to tuned API. Moreover, The three basic profiles can be overridden when the user needs it for the use case. It also benefits GNOME applications that can keep the original design and designing a new GUI tool for custom profiles is unnecessary. Therefore, tuned can be the default power setting service for Fedora.
The work expects tuned to replace the power-profiles-daemons to offer a wider range of power profiles to Fedora users. tuned-ppd resolved the API translation issue so the application can access tuned service through power-profiles-daemon API without converting to the tuned API. Moreover, the three basic profiles can be overridden when the user needs it for their use case. It also benefits GNOME applications that can keep the original design and designing a new GUI tool for custom profiles is unnecessary. Therefore, tuned can be the default power setting service for Fedora.
</p>
</p>


Line 70: Line 70:
<p>
<p>
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/B3UJKFOCRAY3BEEPTHVPW4RY5GFBZWHU/#B3UJKFOCRAY3BEEPTHVPW4RY5GFBZWHU
https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/B3UJKFOCRAY3BEEPTHVPW4RY5GFBZWHU/#B3UJKFOCRAY3BEEPTHVPW4RY5GFBZWHU
1. The dependency concern. Since tuned is written by Python, that causes a dependency impact on Fedora installation.
1. The dependency concern. Since tuned is written in Python, that causes a dependency impact on Fedora installation.
2. The power-profiles-daemon API should be ported to tuned to provide the function to the application that uses power-profiles-daemon API, such as gnome-shell and gnome-control-center.
2. The power-profiles-daemon API should be ported to tuned to provide the function to the application that uses power-profiles-daemon API, such as gnome-shell and gnome-control-center.
</p>
</p>
Line 122: Line 122:
* Proposal owners:
* Proposal owners:
<!-- What work do the feature owners have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
<!-- What work do the feature owners have to accomplish to complete the feature in time for release?  Is it a large change affecting many parts of the distribution or is it a very isolated change? What are those changes?-->
** for GNOME: update gnome-control-center weak dependency on power-profile-daemon to tuned-ppd
** for KDE: update powerdevil weak dependency on power-profile-daemon to tuned-ppd
** for Budgie: update budgie-control-center weak dependency on power-profile-daemon to tuned-ppd


* Other developers: <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
* Other developers: <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
Line 169: Line 172:
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<ol>
<ol>
<li>Install tuned and tuned-ppd through the following command<br>
<li>
$ sudo dnf install tuned<br>
Replace `power-profiles-daemon` with `tuned-ppd`:<br>
$ sudo dnf install tuned-ppd
`$ sudo dnf swap power-profiles-daemon tuned-ppd`
</li>
</li>
<li>
<li>
Line 178: Line 181:
</li>
</li>
<li>
<li>
Run the following command to show the active profile. Since tuned-adm shows the tuned profile name, the profile name mapping can be found in /etc/tuned/ppd.conf.<br>
Since `tuned-adm` shows the tuned profile name, the profile name mapping can be found in `/etc/tuned/ppd.conf`. Run the following command to show the active profile:<br>
$ tuned-adm active
`$ tuned-adm active`
</li>
</li>
</ol>
</ol>
Line 207: Line 210:


<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 
budgie-control-center, gnome-control-center, and powerdevil can talk to tuned-ppd via dbus.


== Contingency Plan ==
== Contingency Plan ==
Line 213: Line 216:
<!-- If you cannot complete your feature by the final development freeze, what is the backup plan?  This might be as simple as "Revert the shipped configuration".  Or it might not (e.g. rebuilding a number of dependent packages).  If you feature is not completed in time we want to assure others that other parts of Fedora will not be in jeopardy.  -->
<!-- If you cannot complete your feature by the final development freeze, what is the backup plan?  This might be as simple as "Revert the shipped configuration".  Or it might not (e.g. rebuilding a number of dependent packages).  If you feature is not completed in time we want to assure others that other parts of Fedora will not be in jeopardy.  -->
* Contingency mechanism: (What to do?  Who will do it?) N/A (not a System Wide Change)  <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
* Contingency mechanism: (What to do?  Who will do it?) N/A (not a System Wide Change)  <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<p>
Use the original power-profiles-daemon
</p>
<!-- When is the last time the contingency mechanism can be put in place?  This will typically be the beta freeze. -->
<!-- When is the last time the contingency mechanism can be put in place?  This will typically be the beta freeze. -->
* Contingency deadline: N/A (not a System Wide Change)  <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
* Contingency deadline: N/A (not a System Wide Change)  <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<p>
Before F41 beta freeze.
</p>
<!-- Does finishing this feature block the release, or can we ship with the feature in incomplete state? -->
<!-- Does finishing this feature block the release, or can we ship with the feature in incomplete state? -->
* Blocks release? N/A (not a System Wide Change), Yes/No <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
* Blocks release? N/A (not a System Wide Change), Yes/No <!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
 
<p>
No, tuned-ppd provides all the power-profiles-daemon APIs otherwise the original power-profile-daemon can be used when the plan blocks the release.
</p>


== Documentation ==
== Documentation ==
Line 223: Line 234:


<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
<!-- REQUIRED FOR SYSTEM WIDE CHANGES -->
N/A (not a System Wide Change)
 
I have talked with tuned about this information.<br>
https://github.com/redhat-performance/tuned/issues/559


== Release Notes ==
== Release Notes ==

Latest revision as of 15:56, 2 October 2024


Make Tuned the Default Power Profile Management Daemon

Summary

This Change makes ‘tuned’ the default power profile management daemon in Fedora Workstation, KDE Plasma, and Budgie instead of power-profiles-daemon.

  • tuned-ppd provides a drop-in replacement for power-profiles-daemon, which allows it to be used with current desktops
  • power users can customize the desktop-exposed power profiles by editing /etc/tuned/ppd.conf

Owner

Current status

Detailed Description

Tuned and power-profiles-daemon provide a similar function to set and tune the power status of a system. Both of them have similar features, if they can be integrated into one, it allows the Fedora user to have more options for power settings of their system and benefits the users. In this proposal, we set up tuned to the default power profile management daemon for the GNOME in Fedora Workstation and the KDE Plasma Spin. Tuned already provides power profiles for different use cases. Recently, tuned released the translation API layer called tuned-ppd which can translate the power-profiles-daemon API to tuned. The applications that use power-profiles-daemon API can access tuned without modifying the code. For now, the Fedora user can immediately switch to tuned by installing the tuned-ppd package without impacting the user experience. Therefore, tuned can be the default power profile management daemon for Fedora.

This work would replace power-profiles-daemon with tuned. Since tuned already provides a wide range of power profiles for different purposes, this allows the user to have more options for configuring the system power profile. Tuned provides many kinds of advanced and basic profiles for different purposes. Power-profiles-daemon provides the basic power profiles and the profiles can be set to the system through platform_profiles, Intel p-state and AMD p-state. That is simple and clever. However, if the users want to ask for an advanced profile, they need to install another power utility, such as tuned to fine-tune their system. With tuned as the default power profile management daemon, users have a wider range of profiles to fine-tune the system.

Tuned released a new translation API service called tuned-ppd [1]. tuned-ppd can translate the power-profiles-daemon API to the tuned API so applications can talk with tuned without modification. Moreover, the GUI settings, such as gnome-control-center can configure tuned profiles through tuned-ppd. tuned-ppd also allows the user to override the basic three power profiles, including power-saver, balanced, and performance through the config file /etc/tuned/ppd.conf [2]. If the user wants to use a customized profile, they can edit the config file and map the custom profile to the basic three power-profiles-daemon profile names. In this way, gnome-control-center can keep the original design to configure the customized profile.

The work expects tuned to replace the power-profiles-daemons to offer a wider range of power profiles to Fedora users. tuned-ppd resolved the API translation issue so the application can access tuned service through power-profiles-daemon API without converting to the tuned API. Moreover, the three basic profiles can be overridden when the user needs it for their use case. It also benefits GNOME applications that can keep the original design and designing a new GUI tool for custom profiles is unnecessary. Therefore, tuned can be the default power setting service for Fedora.

Feedback

From fedora-devel

https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/thread/B3UJKFOCRAY3BEEPTHVPW4RY5GFBZWHU/#B3UJKFOCRAY3BEEPTHVPW4RY5GFBZWHU 1. The dependency concern. Since tuned is written in Python, that causes a dependency impact on Fedora installation. 2. The power-profiles-daemon API should be ported to tuned to provide the function to the application that uses power-profiles-daemon API, such as gnome-shell and gnome-control-center.

From the hardware vendor

Moreover, we discuss it with vendors through the mail. 1. Since tuned covers several kinds of system tuning schemes that allow the vendor to implement their power profile for different devices or workloads. For power-profile-daemon, it only has three profiles to set and every detail setting should be done through the firmware level. If tuned can replace power-profiles-daemon, they can imagine they can develop the profile in a much more flexible manner.

The previous discussions

https://discussion.fedoraproject.org/t/f40-change-proposal-tuned-replaces-power-profiles-daemon-self-contained/94995

Benefit to Fedora

  1. Benefits the user. The user would have more options to tune their system.
  2. Benefits the maintainer. Integrate similar software into one software to reduce the maintenance effort.

Scope

  • Proposal owners:
    • for GNOME: update gnome-control-center weak dependency on power-profile-daemon to tuned-ppd
    • for KDE: update powerdevil weak dependency on power-profile-daemon to tuned-ppd
    • for Budgie: update budgie-control-center weak dependency on power-profile-daemon to tuned-ppd
  • Other developers:
  • Policies and guidelines: N/A (not needed for this Change)
  • Trademark approval: N/A (not needed for this Change)
  • Alignment with the Fedora Strategy:

Upgrade/compatibility impact

Since tuned-ppd provides the ppd APIs and features, there is no impact on other applications.

Early Testing (Optional)

Do you require 'QA Blueprint' support? Y/N

How To Test

  1. Replace power-profiles-daemon with tuned-ppd:
    $ sudo dnf swap power-profiles-daemon tuned-ppd
  2. Run gnome-control-center and switch to the power panel and then select one of the three power profiles. Click the top-right corner of the screen and you can see the “Power Mode” shows the profile name that you selected previously.
  3. Since tuned-adm shows the tuned profile name, the profile name mapping can be found in /etc/tuned/ppd.conf. Run the following command to show the active profile:
    $ tuned-adm active

User Experience

  1. The workstation user can set the power profile through the gnome-control-center.
  2. The server users switch the profile through the tuned command line.

Dependencies

budgie-control-center, gnome-control-center, and powerdevil can talk to tuned-ppd via dbus.

Contingency Plan

  • Contingency mechanism: (What to do? Who will do it?) N/A (not a System Wide Change)

Use the original power-profiles-daemon

  • Contingency deadline: N/A (not a System Wide Change)

Before F41 beta freeze.

  • Blocks release? N/A (not a System Wide Change), Yes/No

No, tuned-ppd provides all the power-profiles-daemon APIs otherwise the original power-profile-daemon can be used when the plan blocks the release.

Documentation

I have talked with tuned about this information.
https://github.com/redhat-performance/tuned/issues/559

Release Notes

  1. ↑ https://github.com/redhat-performance/tuned/tree/master/tuned/ppd
  2. ↑ https://github.com/redhat-performance/tuned/blob/master/tuned/ppd/ppd.conf
Retrieved from "https://fedoraproject.org/w/index.php?title=Changes/TunedAsTheDefaultPowerProfileManagementDaemon&oldid=721296"