jothi-prasath / auto-epp

auto-epp is a python script that manages the energy performance preferences (EPP) of amd-pstate-epp

auto-epp

auto-epp is a python script that manages the energy performance preferences (EPP) of your AMD CPU using the AMD-Pstate driver. It adjusts the EPP settings based on whether your system is running on AC power or battery power, helping optimize power consumption and performance.

Index

• Requirements
• Enable amd-pstate-epp
• Quick Install
  • For Archlinux
• Manual Install
• Usage
• Uninstall

Requirements

• AMD CPU with the AMD-Pstate-EPP driver enabled.
• Python 3.x

To enable amd-pstate-epp

This can be done by editing the GRUB_CMDLINE_LINUX_DEFAULT params in /etc/default/grub. Follow these steps:

1. Open the grub file using the following command:

sudo nano /etc/default/grub

2. Within the file, modify the GRUB_CMDLINE_LINUX_DEFAULT line to include the setting for AMD P-State EPP:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash amd_pstate=active"

Quick Install

To quickly install auto-epp, just copy and paste this to your terminal (if you have curl installed):

curl https://raw.githubusercontent.com/jothi-prasath/auto-epp/master/quick-install.sh | sudo bash

For Arch Linux

On Arch Linux, and Arch-based distributions, auto-epp can be found in the AUR. Install with an AUR helper like yay:

yay auto-epp

For NixOS

On NixOS (unstable for now) an option can be enabled to install and enable auto-epp.

To enable with the default configuration:

services.auto-epp.enable = true;

Detailed options available on nixos.org

Manual Install

git clone https://github.com/jothi-prasath/auto-epp
cd auto-epp
chmod +x ./install.sh
sudo ./install.sh

Usage

Monitor the service status

systemctl status auto-epp

To restart the service

sudo systemctl restart auto-epp

Edit the config file

sudo nano /etc/auto-epp.conf

uninstall

To uninstall auto-epp

chmod +x ./uninstall.sh
sudo ./uninstall.sh

auto-epp's Issues

question how to remove

Hi sir, how can i delete/remove the package from Ubuntu?

Failed to start auto-epp.service - auto-epp - Automatic amd-pstate epp.

× auto-epp.service - auto-epp - Automatic amd-pstate epp
     Loaded: loaded (/etc/systemd/system/auto-epp.service; enabled; preset: disabled)
    Drop-In: /usr/lib/systemd/system/service.d
             └─10-timeout-abort.conf
     Active: failed (Result: exit-code) since Fri 2023-09-29 21:49:45 CEST; 5s ago
   Duration: 1ms
    Process: 4456 ExecStart=/usr/bin/auto-epp (code=exited, status=203/EXEC)
   Main PID: 4456 (code=exited, status=203/EXEC)
        CPU: 1ms

Sep 29 21:49:45 fedora systemd[1]: auto-epp.service: Scheduled restart job, restart counter is at 5.
Sep 29 21:49:45 fedora systemd[1]: Stopped auto-epp.service - auto-epp - Automatic amd-pstate epp.
Sep 29 21:49:45 fedora systemd[1]: auto-epp.service: Start request repeated too quickly.
Sep 29 21:49:45 fedora systemd[1]: auto-epp.service: Failed with result 'exit-code'.
Sep 29 21:49:45 fedora systemd[1]: Failed to start auto-epp.service - auto-epp - Automatic amd-pstate epp.

Surface Laptop 15 AMD with surface kernel 6.4 Fedora 38 :(

Not forcing to run as root, instead check write permission on required files

I'm currently submitting this package for nixos ( see PR ) and one comment was raised that it would be better to run the service as DynamicUser and give it the permissions it needs through CapabilityBoundingSet which would make it more secure.

I believe that for this to work, it would need the main script to test write permission on the targeted files instead of checking if the user is root.

Issue when battery is plugged in, not full but not charging

So on my laptop there is a "conservative" which basically limits the charge to 80% and auto-epp reports it as on Battery because of this:

sbattery(percent=79.52387907112605, secsleft=<BatteryTime.POWER_TIME_UNKNOWN: -1>, power_plugged=None)

power_plugged is None, when on battery power_plugged=False and when charging power_plugged=True

I fixed it on my end by updating the condition

    if battery.power_plugged is None or battery.power_plugged:

but i'm not sure if that would apply to all the laptops that have similar modes hence i didn't make PR for now.

Any chance of it making it to the aur?

Would love it :) thanks

No change to amd_pstate_epp

Hi,

I have this working in tandem with auto-cpufreq and, after having enabled the auto_epp service and rebooting, the system doesnt seem to acknowledge my .conf file (eg. I wrote BAT=power, but it remains at BAT=balanced_power) even though it shows the service running.

Does this have to do with changing it to active/passive/guided mode?

forgive my ignorance if this is an obvious answer.

Cheers!

Are you aware of `TLP`?

It does almost the same.