asan/acer-modules

Description

This repository collects projects made by various authors which allow users to properly configure and use an Acer Nitro/Predator laptop on a Fedora system.
I personally tested these projects against an Acer Nitro 5 AN515-57-70MT and they fully work. The packages hereby released have been set up to use akmods only, although some of them were initially meant to work with dkms.
Please make sure that your machine is 100% compatible to each of these projects before using them, as there is the risk that they could damage your system otherwise.
Also, please understand that these projects have been packaged in the hope that one day they will either be included in the upstream kernel or replaced with something safer to use.

USE AT YOUR OWN RISK.

The following are the projects included in this repository:

Acer Predator Turbo and RGB Keyboard Linux Module by JafarAkhondali

This module lets you activate the ability to customize the colors of the keyboard backlight AND enable the fan speed customization.

Acer WMI Battery by frederik-h

This module lets you activate the battery "safe mode" (which lets you charge it up to 80% of its full charge) and to recalibrate it.

Acpi_ec by musikid

This module brings back the ec_sys functionality to kernels that had it removed like Fedora's. It's necessary in order to use nbfc. Before installing this module, please be aware of the reasons behind the removal of ec_sys from Fedora's kernels. Use at your own risk.

Nbfc-linux

This is a C port of Stefan Hirschmann's NoteBook FanControl.

Installation Instructions

Firstly, you need to find out whether you booted in EFI or BIOS mode. This is how you can find it out:
$ [ -d /sys/firmware/efi ] && echo EFI || echo BIOS

In case the command above replied "EFI", then execute the following commands (do NOT in case it printed "BIOS"). If you already enabled automatic signing of kernel modules (for example, because you use proprietary Nvidia driver), you can safely skip this step:
$ sudo dnf -y install akmods mokutil
$ sudo [ ! -f /etc/pki/akmods/certs/public_key.der ] && sudo /usr/sbin/kmodgenca
$ sudo mokutil --import /etc/pki/akmods/certs/public_key.der

Now let's enable this repository. Please notice that the modules contained here use akmods so that they will be rebuilt for every newly installed kernel.
$ sudo dnf copr enable asan/acer-modules

In order to install the keyboard color backlight control and fan control module:
$ sudo dnf -y install acer-predator-turbo-and-rgb-keyboard-linux-module acer-predator-turbo-and-rgb-keyboard-linux-module-kmodsrc kmod-acer-predator-turbo-and-rgb-keyboard-linux-module

In order to install the battery health control WMI interface:
$ sudo dnf -y install acer-wmi-battery akmod-acer-wmi-battery kmod-acer-wmi-battery

Finally, in order to install the acpi_ec module and the nbfc port:
$ sudo dnf -y install acpi_ec akmod-acpi_ec kmod-acpi_ec nbfc-linux

Now you should be all set up, just reboot so that your modules will be rebuilt and loaded at boot.

In order to get all the customization options for the keyboard color:

1. make sure that the "facer" module is loaded:
   $ lsmod | awk '($1 == "facer"){ loaded = 1 } END { print (loaded)?"Module correctly loaded":"Module NOT loaded :-(" }'
   You should get the following output:
   Module correctly loaded
2. If you don't, then there's something wrong in the system configuration. Did you boot with your EFI mode on and did you set the system up to sign the modules?
3. Otherwise, just run:
   $ face_rgb.py -h
   Then choose the working mode, the colors and other settings. You can find out more on the project's page

In order to set the battery up, do as follows:

1. Make sure the "acer_wmi_battery" is loaded, just like you did above for the facer module:
   $ lsmod | awk '($1 == "acer_wmi_battery"){ loaded = 1 } END { print (loaded)?"Module correctly loaded":"Module NOT loaded :-(" }' \
2. To enable the battery "health mode" (which lets you charge the battery up to 80% to let its lifecycle last longer):
   $ echo 1 | sudo tee /sys/bus/wmi/drivers/acer-wmi-battery/health_mode
   To disable it:
   $ echo 0 | sudo tee /sys/bus/wmi/drivers/acer-wmi-battery/health_mode
3. To enable the battery calibration mode:
   $ echo 1 | sudo tee /sys/bus/wmi/drivers/acer-wmi-battery/calibration_mode
   To disable it:
   $ echo 0 | sudo tee /sys/bus/wmi/drivers/acer-wmi-battery/calibration_mode

In order to customize the fan speed, make sure the "acpi_ec" module is loaded:
$ lsmod | awk '($1 == "acpi_ec"){ loaded = 1 } END { print (loaded)?"Module correctly loaded":"Module NOT loaded :-(" }'
Then please check out nbfc-linux's project repository, where you will find out how to choose the best settings and start/stop the service.

Active Releases

The following unofficial repositories are provided as-is by owner of this project. Contact the owner directly for bugs or issues (IE: not bugzilla).

Release	Architectures	Repo Download
Fedora 38	x86_64 (244)*	Fedora 38 (0 downloads)
Fedora 39	x86_64 (345)*	Fedora 39 (52 downloads)
Fedora 40	x86_64 (424)*	Fedora 40 (60 downloads)
Fedora 41	x86_64 (182)*	Fedora 41 (13 downloads)
Fedora rawhide	x86_64 (109)*	Fedora rawhide (26 downloads)

* Total number of downloaded packages.