This is a C port of Stefan Hirschmann's NoteBook FanControl.
It provides the same utilities with the same interfaces as the original NBFC, although the implementation differs.
What | NBFC Mono | NBFC Linux |
---|---|---|
Portability | Crossplatform | Linux |
Configuration files | XML (956KB) | JSON (840KB) |
Runtime | Mono | Native |
Memory consumption (ps_mem) | ~50MB | ~350KB |
Package size (pkg.tar.gz) | 448K | 100K |
Service control rights | Any user | Only root |
IPC Concept | TCP/IP | Files |
IPC Protocol | Binary | JSON |
The service and the probing tool are written in C. The client is written in Python.
-
Arch Linux:
- Either via AUR (
yaourt -S nbfc-linux
) - Or by using one of the PKGBUILDs nbfc-linux-git / nbfc-linux
- Either via AUR (
-
In general:
make && sudo make install
When running NBFC for the first time, you need to give it a configuration file for your laptop model.
If you are lucky, sudo nbfc config --set auto
will find a matching one and set it.
sudo nbfc config --recommend
(required dmidecode
) will give a list of configuration files that may match your laptop.
With sudo nbfc config --set <MODEL>
a configuration is selected.
sudo nbfc start
will start the service.
It can be queried by sudo nbfc status -a
.
If you wish nbfc_service
to get started on boot, use sudo systemctl enable nbfc_service
.
Files | NBFC C# | NBFC C |
---|---|---|
Systemd service file | nbfc.service | nbfc_service.service |
EC Probing tool | ec-probe | ec_probe |
Notebook configuration files | /opt/nbfc/Configs/*.xml | /etc/nbfc/Configs/*.json |
Service binary | /opt/nbfc/nbfcservice.sh | /bin/nbfc_service |
PID File | /run/nbfc.pid | /run/nbfc_service.pid |
State file | - | /run/nbfc_service.state.json |
Config file | ? | /etc/nbfc/nbfc.json |
-
The original NBFC service is queried and controlled by the client using TCP/IP. - NBFC Linux does not implement any "real" IPC. Information about the service can be queried by reading its state file. The client controls the service by simply rewriting its configuration file and reloading it.
-
The original NBFC service adjusts the fan speeds in intervals of
EcPollIntervall
according toTemperatureThresholds
. - NBFC Linux directly sets the fan speed (also according toTemperatureThresholds
). -
The original NBFC service provided an
Autostart
option. - NBFC Linux dropped that option, it relies on the systemd service file only.
NBFC-Linux comes with shell completion scripts for bash, fish and zsh.
~ $ nbfc_service <TAB>
--config-file -c -- Use alternative config file (default /etc/nbfc/nbfc.json)
--debug -d -- Enable tracing of reads and writes of the embedded controller
--embedded-controller -e -- Specify embedded controller to use
--fork -f -- Switch process to background after sucessfully started
--help -h -- show this help message and exit
--readonly -r -- Start in read-only mode
--state-file -s -- Write state to an alternative file (default /var/run/nbfc_service.state.json)
~ $ nbfc <TAB>
config -- List or apply configs
help -- Show help
restart -- Restart the service
set -- Control fan speed
start -- Start the service
status -- Show the service status
stop -- Stop the service
See also the documentation about the nbfc configuration.