This repository contains an experimental Linux kernel driver for the battery health control WMI interface and fan control modes of Acer laptops. It can be used to control two battery-related features of Acer laptops that Acer provides through the Acer Care Center/AcerSense on Windows: a health mode that limits the battery charge to 80% with the goal of preserving your battery's capacity and a battery calibration mode which puts your battery through a controlled charge-discharge cycle to provide more accurate battery capacity estimates.
On the Acer Swift Go 14 (SFG14-73), it can also set fan profiles (Balanced, Quiet, Performance) based on the currently-set platform power profile by the system (used by power-profiles-daemon). The EC offsets were provided by @YFHD-osu in their repository and has been verified to be functional on my SFG14-73 as well (Fedora 42).
Make sure that you have the kernel headers for your kernel installed
and type make in the cloned project directory. In more detail,
on a Debian or Ubuntu system, you can build by:
sudo apt install build-essential linux-headers-$(uname -r) git
git clone https://github.com/TenSeventy7/acer-wmi-ext.git
cd acer-wmi-ext
make
Loading the module without any parameters does not change any health or calibration mode settings of your system:
sudo insmod acer-wmi-ext.ko
The charge limit can then be enabled as follows:
echo 1 | sudo tee /sys/bus/wmi/drivers/acer-wmi-ext/health_mode
Alternatively, you can enable it at module initialization time:
sudo insmod acer-wmi-ext.ko enable_health_mode=1
Before attempting the battery calibration, connect your laptop to a power supply. The calibration mode can be started as follows:
echo 1 | sudo tee /sys/bus/wmi/drivers/acer-wmi-ext/calibration_mode
The calibration disables health mode and charges to 100%. Then it discharges and recharges the battery once. This can take a long time and for accurate capacity estimates the laptop should not be used during this process. After the discharge-charge cycle the calibration mode should be manually disabled since the WMI event that indicates the completion of the calibration is not yet handled by the module:
echo 0 | sudo tee /sys/bus/wmi/drivers/acer-wmi-ext/calibration_mode
The fan profiles can then be set as follows:
echo 1 | sudo tee /sys/bus/wmi/drivers/acer-wmi-ext/system_control_mode
The following profiles are as follows:
1: Balanced2: Quiet3: Performance
They are also hooked into platform power profiles and thus can be controlled using power-profiles-daemon and the desktop environment.
Alternatively, you can set it at module initialization time:
sudo insmod acer-wmi-ext.ko enable_system_control_mode=1
The EC setting for the SFG14-73's fan profiles were from @YFHD-osu and can be found in their repository. This is only tested functional on the said device and thus is disabled for others.
There exists another driver with similar functionality of which I have not been aware when starting the work on this driver. See this issue for discussion.