A Linux kernel module providing direct access to ACPI Embedded Controller (EC) with multi-EC support, particularly useful for MSI laptops.
- Direct ACPI EC register access
- Multi-EC device support
- Independent read/write operations
- Cooler Boost control for MSI laptops
- User-space interface via device files
- Automatic module loading on boot
Before installing, ensure you have the following packages installed:
sudo apt update
sudo apt install build-essential linux-headers-$(uname -r).
├── src/ # Source code directory
│ ├── acpi_ec.c # Main module source
│ └── acpi_ec.h # Module header
├── install.sh # Installation script
├── uninstall.sh # Uninstallation script
├── cooler_boost.sh # MSI Cooler Boost control utility
├── Makefile # Build system
└── _variables.sh # Configuration variables
-
Clone the repository:
git clone https://github.com/agnath18K/acpi_ec.git cd acpi_ec -
Install the module:
sudo ./install.sh
This will:
- Build the kernel module
- Install it to the appropriate kernel directory
- Load the module
- Configure automatic loading on boot
After installation, two device files will be created:
/dev/ec0- Primary EC/dev/ec1- Secondary EC (if present)
By default, these files are only accessible by root. To allow user access:
sudo chmod 666 /dev/ec*
# Or add your user to the ec group (recommended)
sudo usermod -a -G ec $USER# Read from offset 0x98 (152 decimal)
sudo dd if=/dev/ec0 bs=1 count=1 skip=152 2>/dev/null | hexdump -C# Write 0x80 to offset 0x98 (152 decimal)
echo -ne "\x80" | sudo dd of=/dev/ec0 bs=1 count=1 seek=152 2>/dev/nullThe cooler_boost.sh script provides easy control of the Cooler Boost feature:
./cooler_boost.sh status # Check current status
./cooler_boost.sh on # Enable Cooler Boost
./cooler_boost.sh off # Disable Cooler BoostTo remove the module:
sudo ./uninstall.shThis will:
- Unload the module
- Remove it from the kernel directory
- Remove auto-loading configuration
-
Check module status:
lsmod | grep acpi_ec dmesg | grep acpi_ec
-
Check kernel logs:
sudo journalctl -k | grep acpi_ec -
Permission issues:
# Check device file permissions ls -l /dev/ec* # Check your group membership groups
- Fork the repository
- Create your feature branch
- Make your changes
- Submit a pull request
This project is licensed under the GPL v2 License - see the LICENSE file for details.
- Thomas Renninger (ec_sys.c)
- Sayafdine Said (Out-of-tree port)