| Name | smfc JSON |
| Version |
4.0.0
JSON |
| download |
| home_page | None |
| Summary | Super Micro Fan Control for Linux |
| upload_time | 2025-07-08 16:28:07 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <4,>=3.9 |
| license | None |
| keywords |
supermicro
linux
daemon
fancontrol
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# smfc
[
](https://github.com/petersulyok/smfc/actions/workflows/tests.yml) [
](https://app.codecov.io/gh/petersulyok/smfc) [
](https://github.com/petersulyok/smfc/issues) [](https://pypi.org/project/smfc)
[](https://badge.fury.io/py/smfc)
Super Micro fan control for Linux (home) servers.
## TL;DR
This is a `systemd service` running on Linux and can control fans with help of IPMI on Super Micro X10-X13 (and some X9) motherboards.
You can also run `smfc` in docker, see more details in [Docker.md](docker/Docker.md).
### 1. Prerequisites
- a Super Micro motherboard with ASPEED AST2400/2500/2600 chip
- Python 3.9-3.13
- a Linux distribution with:
- `systemd` and `bash`
- `coretemp` kernel module for Intel CPUs or `k10temp` kernel module for AMD CPUs
- `drivetemp` kernel module (kernel version 5.6+ required) modules for SATA HDDs/SSDs
- `ipmitool`
- optional: `smartmontools` for SAS/SCSI disks and *standby guard* feature
- optional: `nvidia-smi` for GPU fan controller
### 2. Installation and configuration
1. Set up the IPMI threshold values for your fans (see [chapter 6.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#6-ipmi-fan-control-and-sensor-thresholds) for more details).
2. Optional: enable advanced power management features for your CPU and SATA hard disks for lower power consumption, heat generation and fan noise.
3. Load kernel modules (`coretemp/k10temp` and `drivetemp`).
4. Install `smfc` service (see [chapter 9.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#9-installation) for more details).
5. Edit the configuration file `/etc/smfc/smfc.conf` and command line options in `/etc/default/smfc` (see [chapters 10.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#10-configuration-file) for more details).
6. Start `smfc` service (see [chapter 11.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#11-how-to-run-smfc) for more details).
7. Check results in system log
8. Leave a feedback in [discussion #55](https://github.com/petersulyok/smfc/discussions/55)
Feel free to visit [Discussions](https://github.com/petersulyok/smfc/discussions) and raise your questions or share your experience on this project.
## Details
### 1. How does it work?
This service was designed for Super Micro motherboards with IPMI functionality, implementing different fan controllers connected to one or more IPMI zones.
In `smfc`, the following fan controllers are implemented:
| Fan controller | Temperature source | Configuration | Default IPMI zone |
|----------------|-------------------------|-------------------------------------------------------------------------|---------------------|
| CPU zone | Intel/AMD CPU(s) | CPUs are identified automatically | 0 (CPU zone) |
| HD zone | SATA and SCSI HDDs/SSDs | Hard disks' names must be specified in `[HD zone] hd_names=` parameter | 1 (Peripheral zone) |
| GPU zone | Nvidia GPUs | GPU indices must be specified in `[GPU zone] gpu_device_ids=` parameter | 1 (Peripheral zone) |
| Constant zone | None | Constant fan level can be specified in `[CONST zone] level=` parameter | 1 (Peripheral zone) |
These fan controllers can be enabled and disabled independently. They can be used in a free combination with on or more IPMI zones, but different fan controllers should control different IPMI zones (i.e. no overlapping is allowed)!
_Constant zone_ is an exception here, it does not require a temperature source, it can provide a constant fan level for one or more IPMI zones.
The _IPMI zone_ is a logical term, representing a cooling zone, where there are predefined fans having the same rotation speed. Please note that the fan assignment to an IPMI zone is predefined on the motherboard, it cannot be changed!
On a typical Super Micro motherboard, there are two IPMI zones:
- CPU or System zone (IPMI zone 0) with fan names: FAN1, FAN2, etc.
- Peripheral or HD zone (IPMI zone 1) with fan names: FANA, FANB, etc.
On Super Micro server motherboards, there could be more IPMI zones with different fan names (see [issue #31](https://github.com/petersulyok/smfc/issues/31)).
Note: `smfc v3.8.0` and previous versions implemented _Swapped Zones_ feature to swap IPMI zone 0 and 1. From `smfc v4.0.0` the IPMI zones can be assigned freely to fan controllers providing more freedom and convince for the user (see `ipmi_zone=` parameter for more detail).
In `smfc`, a temperature-driven fan controller implements the following control logic:
1. it reads the zone's temperature
2. it calculates a new fan level based on the user-defined control function and the temperature value of the zone
3. it configures the new fan level for the zone(s) with IPMI commands (i.e. `ipmitool`)
<img src="https://github.com/petersulyok/smfc/raw/main/doc/smfc_overview.png" align="center" width="600">
If there are multiple heat sources (e.g. multiple CPUs, HDDs or GPUs) defined in the fan controller, then the user can configure a calculation method (i.e. minimum, average, maximum) for the temperature calculation (see `temp_calc=` parameter in the configuration).
Please note that `smfc` will set all fans back to 100% speed at service termination to avoid overheating!
#### 2. User-defined control function
Fan controllers are using user-defined control functions where a temperature interval is being mapped to a fan rotation level interval.
<img src="https://github.com/petersulyok/smfc/raw/main/doc/userdefined_control_function.png" align="center" width="500">
The following five parameters will define such a function:
min_temp=
max_temp=
min_level=
max_level=
steps=
In this way, a fan controller can map any new temperature value to a fan level (from Celsius degrees to % value).
Changing the fan rotational speed is a very slow process (it could take several seconds depending on the fan type and the requested amount of change), so we try to minimize these kinds of actions. Instead of setting fan rotational speed continuously, we define discrete fan levels based on `steps=` parameter.
<img src="https://github.com/petersulyok/smfc/raw/main/doc/fan_output_levels.png" align="center" width="500">
The fan controllers implement the following strategies to avoid/minimize the unnecessary change of fan rotation speed:
1. When the fan rotational speed is changed, it always applies a delay time (defined in `[IPMI] fan_level_delay=` configuration parameter) to let the fan implement the physical change.
2. There is a sensitivity threshold parameter (`sensitivity=`) in the fan controller configuration. While the temperature change is below this value, the fan controller does not react.
3. The configuration parameter `polling=` defines the frequency of the temperature reading. The bigger polling time, the lower frequency of the fan speed change.
#### 3. Standby guard
For HD zone fan controller, an additional optional feature was implemented, called *Standby guard*, with the following assumptions:
- SATA hard disks are organized into a RAID array
- the RAID array will go to standby mode recurrently
This feature is monitoring the power state of SATA hard disks (with the help of the `smartctl`) and will put the whole array to standby mode if a few members are already stepped into that. With this feature, the situation can be avoided where the array is partially in standby mode while other members are still active.
SCSI disks are not compatible with this feature.
#### 5. Hard disk compatibility
The `smfc` service was originally designed for `SATA` hard drives, but `smfc v3.0.0` is also compatible with `NVME` and `SAS/SCSI` disks. The following table summarizes how the temperature is read for different disk types:
| Disk type | Temperature source | Kernel module | Command |
|------------|----------------------|---------------|------------|
| `SATA` | Linux kernel (HWMON) | `drivetemp` | - |
| `NVME` | Linux kernel (HWMON) | - | - |
| `SAS/SCSI` | `smartctl` | - | `smartctl` |
Some additional notes:
- For `NVME` SSDs no kernel driver needs to be loaded the kernel can handle this disk type automatically
- For `SATA` disks the `drivetemp` kernel module should be loaded. **This is the fastest way to read disk temperature**, and the kernel module can report the temperature while hard disks are in sleep mode!
- For `SAS/SCSI` disks the `smartctl` command will be used to read disk temperature
- If `drivetemp` module is not loaded or an HDD is not compatible with `drivetemp` module then `smfc` will use `smartctl` automatically.
- Different disks types can be mixed in `hd_names=` configuration parameter but the *Standby guard* feature will not be supported in this case.
- It is NOT RECOMMENDED to mix NVME SSD and SATA/SCSI disks in `hd_names=` parameter, because they are operating in quite different temperature intervals (e.g. 30-40C vs 40-80C).
### 5. Super Micro compatibility
This software was designed to work with Super Micro X10 and X11 motherboards with a BMC chip (i.e. ASPEED AST2400/2500/2600) and IPMI functionality. Unfortunately, there are some motherboards (e.g. X10QBi see issue #69) not compatible with `smfc`.
In case of X9 motherboards the compatibility is not guaranteed, it depends on the hardware components of the motherboard (i.e. not all X9 motherboards employ BMC chip).
The earlier X8 motherboards are NOT compatible with this software. They do not implement `IPMI_FULL` mode, and they cannot control fan levels how it is implemented in `smfc`.
X13 motherboards (with AST2600 BMC chips) seem to be compatible with smfc (see mode details in [issue #33](https://github.com/petersulyok/smfc/issues/33) about an X13SAE-F motherboard).
Fan control and `IPMI_FULL` mode are working properly. The only difference is in using thresholds, AST2600 implements only `Lower Critical` threshold, so setting up thresholds is different in this case.
Feel free to create a short feedback in [discussion #55](https://github.com/petersulyok/smfc/discussions/55) on your compatibility experience.
### 6. IPMI fan control and sensor thresholds
On Super Micro X10-X11 motherboards IPMI uses six sensor thresholds to specify the safe and unsafe fan rotational speed intervals (these are RPM values rounded to nearest hundreds, defined for each fan separately):
```
Lower Non-Recoverable
Lower Critical
Lower Non-Critical
Upper Non-Critical
Upper Critical
Upper Non-Recoverable
```
but newer Super Micro X13 motherboards (with AST2600 BMC chip) have only one sensor threshold:
```
Lower Critical
```
Originally, this chapter was created Super Micro X10-X11 motherboards, but can be easily adopted to X13 motherboards as well (see more details in #33).
Like many other utilities (created by NAS and home server community), `smfc` also uses **IPMI FULL mode** for fan control, where all fans in the zone:
1. initially configured to full speed (100%)
2. then their speed can be safely configured in `[Lower Critical, Upper Critical]` interval
3. if any fan speed oversteps either `Lower Critical` or `Upper Critical` threshold then IPMI will generate an _assertion event_ and will set the all fan speeds back to 100% in the zone
Please also consider the fact that **fans are mechanical devices, their rotational speed is not stable** (it could be fluctuating). To avoid IPMI's assertion mechanism described here please follow the next steps:
1. Per fan: check the minimum and maximum rotational speeds of your fan on its vendor website
2. Per fan: configure proper IMPI sensor thresholds adjusted to the fan speed interval
3. Per zone: define safe `min_level`/`max_level` values for `smfc` respecting the variance of the all fans in the IPMI zone (it could take several iterations and adjustments)
<img src="https://github.com/petersulyok/smfc/raw/main/doc/ipmi_sensor_threshold.png" align="center" width="600">
Here is a real-life example for a [Noctua NF-F12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm) fan:
```
Upper Non-Recoverable = 1800 rpm
Upper Critical = 1700 rpm
Upper Non-Critical = 1600 rpm
Lower Non-Critical = 200 rpm
Lower Critical = 100 rpm
Lower Non-Recoverable = 0 rpm
Max RPM = 1500 rpm
Min PRM = 300 rpm
max_level = 100 (i.e. 1500 rpm)
min_level = 35 (i.e. 500 rpm)
```
Notes:
- Use the following `ipmitool` command to display the current IMPI sensor thresholds for fans:
```
root@home:~# ipmitool sensor|grep FAN
FAN1 | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000
FAN2 | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000
FAN3 | na | | na | na | na | na | na | na | na
FAN4 | 400.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000
FANA | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000
FANB | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000
```
- Use the following `ipmitool` command to list assertion events:
```
root@home:~# ipmitool sel list
1 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Critical going low | Asserted
2 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Asserted
3 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Deasserted
4 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Critical going low | Deasserted
5 | 10/19/2023 | 05:20:59 PM CEST | Fan #0x46 | Lower Critical going low | Asserted
```
- Use the following `ipmitool` commands to specify all six sensor thresholds for FAN1:
```
root@home:~# ipmitool sensor thresh FAN1 lower 0 100 200
root@home:~# ipmitool sensor thresh FAN1 upper 1600 1700 1800
```
- You can also edit and run `ipmi/set_ipmi_treshold.sh` to configure all IPMI sensor thresholds
- If you install new BMC firmware on your Super Micro motherboard, you have to configure IPMI thresholds again
- If you do not see fans when executing `ipmitool sensors`, you may want to reset the BMC to factory default using the Web UI or using `ipmitool mc reset cold`
- Noctua specifies the variance of minimum and maximum fan rotational speeds (e.g. see the [specification of Noctua NF-F12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm/specification)). For example:
- `Rotational speed (+/- 10%) 1500 RPM`: 1350-1650 RPM interval
- `Min. rotational speed @ 20% PWM (+/-20%) 300 RPM`: 240-360 RPM interval
Please note that [LNA](https://noctua.at/en/na-src10)/ULNA cables or [Y-cables](https://noctua.at/en/na-syc1) can modify the rotational speed calculations here and the required IPMI sensor thresholds too.
You can read more about:
- IPMI fan control: [STH Forums](https://forums.servethehome.com/index.php?resources/supermicro-x9-x10-x11-fan-speed-control.20/) and [TrueNAS Forums](https://www.truenas.com/community/threads/pid-fan-controller-perl-script.50908/)
- Change IPMI sensors thresholds: [TrueNAS Forums](https://www.truenas.com/community/resources/how-to-change-ipmi-sensor-thresholds-using-ipmitool.35/)
### 7. Power management
If low noise and low heat generation are important attributes of your Linux box, then you may consider the following chapters.
#### 7.1 CPU
Most of the modern CPUs has multiple energy saving features. You can check your BIOS and enable them to minimize the heat generation.
Intel(R) CPUs:
- Intel(R) Speed Shift Technology
- Intel(R) SpeedStep
- C-states
- Boot performance mode
AMD(R) CPUs:
- PowerNow!
- Cool\`n\`quiet
- Turbo Core
With this setup the CPU will change its base frequency and power consumption dynamically based on the load.
#### 7.2 SATA hard disks
In case of SATA hard disks, you may enable:
- advanced power management
- spin down timer
With the help of command `hdparm` you can enable advanced power management and specify a spin down timer (read more [here](https://en.wikipedia.org/wiki/Hdparm)):
hdparm -B 127 /dev/sda
hdparm -S 240 /dev/sda
In file `/etc/hdparm.conf` you can specify all parameters persistently:
quiet
/dev/sda {
apm = 127
spindown_time = 240
}
/dev/sdb {
apm = 127
spindown_time = 240
}
...
Important notes:
1. If you plan to spin down your hard disks or RAID array (i.e. put them to standby mode) you have to set up the configuration parameter `[HD zone] polling=` minimum twice bigger as the `spindown_time` specified here.
2. In file `/etc/hdparm.conf` you must define HD names in `/dev/disk/by-id/...` form to avoid inconsistency.
### 8. Kernel modules
We need to load the following important Linux kernel modules:
- [`coretemp`](https://www.kernel.org/doc/html/latest/hwmon/coretemp.html): temperature report for Intel(R) CPUs
- [`k10temp`](https://docs.kernel.org/hwmon/k10temp.html): temperature report for AMD(R) CPUs
- [`drivetemp`](https://www.kernel.org/doc/html/latest/hwmon/drivetemp.html): temperature report for SATA hard disks (available from kernel 5.6+ version)
Use `/etc/modules` file for persistent loading of these modules.
Here are some sample HWMON file locations for these kernel modules:
- `coretemp`: `/sys/devices/platform/coretemp.0/hwmon/hwmon*/temp1_input`
- `k10temp`: `/sys/bus/pci/drivers/k10temp/0000*/hwmon/hwmon*/temp1_input`
- `drivetemp`: `/sys/class/scsi_disk/0:0:0:0/device/hwmon/hwmon*/temp1_input`
Notes:
- `smfc` is able to find the proper HWMON file automatically for Intel(R) CPUs, AMD(R) CPUs, SATA drives, or NVMe drives, but users may also specify the files manually (see `hwmon_path=` parameter in the config file)
- Reading `drivetemp` module is the fastest way to get the temperature of the hard disks, and it can read temperature of the SATA hard disks even in standby mode, too.
#### 9. Installation
For the installation, you need root privileges. There are several ways to install `smfc`, this chapter
#### 9.1. Manual installation
There is an installation script ([`bin/install.sh`](https://raw.githubusercontent.com/petersulyok/smfc/refs/heads/main/bin/install.sh)) which can install `smfc` remotely from the GitHub repository (without cloning or downloading).
The installation script requires `curl` and `pip` commands and can be executed in this way:
`curl --silent https://raw.githubusercontent.com/petersulyok/smfc/refs/heads/main/bin/install.sh|bash`
or if you want to preserve your existing configuration file, this way:
`curl --silent https://raw.githubusercontent.com/petersulyok/smfc/refs/heads/main/bin/install.sh|bash /dev/stdin --keep-config`
The installation script has the following command line parameters:
```
user@host:~$ ./install.sh --help
usage: install.sh [-h|--help] [-k|--keep-config] [-v|--verbose]
-h, --help help text
-k, --keep-config keep original configuration file
-v, --verbose verbose output
```
The default locations of the installation files:
| Files | Installation folder | Description |
|-----------------|---------------------------------------------------|---------------------------------|
| `smfc.service` | `/etc/systemd/system` | systemd service definition file |
| `smfc` | `/etc/default` | service command line options |
| `smfc.conf` | `/etc/smfc` | service configuration file |
| `smfc package` | `/usr/local/bin`<br/> `/usr/local/lib/python3.xx` | python package |
Further manual steps after a successful installation:
- install program dependencies (`ipmitool`, `smartctl` or `nvidia-smi`)
- load proper kernel modules (`coretemp` or `k10temp` and `drivetemp`)
#### 9.2. Docker installation
`smfc` is also available as a docker image, see more details in [Docker.md](../docker/Docker.md). In this case, your job is only to provide your configuration file on host computer, `smfc` will be executed automatically when the container is starting.
### 10. Configuration file
After successful installation, create your new configuration file. If you just upgrade to a new `smfc` version, you can preserve the existing one.
#### 10.1 Right strategy to create your configuration file
You have to think over and answer the following questions:
1. What are the most important heat sources in your machine? Typically, these could be CPU(s), hard disks, or GPUs.
2. Which fan controllers would you like to use and configure in `smfc`?
3. What is the expected temperature interval (minimum/maximum C degree) for the selected temperature source(s)? Use some test tools to measure it (e.g. [`s-tui`](https://github.com/amanusk/s-tui), [`fio`](https://fio.readthedocs.io/en/latest/fio_doc.html), [`iozone`](https://www.iozone.org/)) if you don't have their track records.
4. Which IPMI zone(s) will be connected to these fan controllers/temperate sources)? Check how many IPMI zones you have, how the fans are connected on your motherboard, and how they are cooling the selected temperature source(s).
5. What is the stable level interval for fans in the selected IPMI zone(s)? Probably this part requires the most patience! You have assumptions here, you will try them. If there are IPMI assertions and your fans are spinning up then you will refine the interval and try again. You might have several cycles here, this is normal.
#### 10.2 Sample configuration file
Edit `/etc/smfc/smfc.conf` and specify your configuration parameters here:
```
#
# smfc.conf (C) 2020-2025, Peter Sulyok
# smfc 4.x service configuration parameters
#
# Please read the documentation here: https://github.com/petersulyok/smfc
#
# Ipmi specific parameters.
[Ipmi]
# Path for ipmitool (str, default=/usr/bin/ipmitool)
command=/usr/bin/ipmitool
# Delay time after changing IPMI fan mode (int, seconds, default=10)
fan_mode_delay=10
# Delay time after changing IPMI fan level (int, seconds, default=2)
fan_level_delay=2
# IPMI parameters for remote access (string, default='')
#remote_parameters=-U USERNAME -P PASSWORD -H HOST
# CPU zone: this fan controller works based on CPU(s) temperature.
[CPU zone]
# Fan controller enabled (bool, default=0)
enabled=1
# IPMI zone(s) (comma- or space-separated list of int, default=0))
ipmi_zone=0
# Calculation method for CPU temperatures (int, [0-minimum, 1-average, 2-maximum], default=1)
temp_calc=1
# Discrete steps in mapping of temperatures to fan level (int, default=6)
steps=6
# Threshold in temperature change before the fan controller reacts (float, C, default=3.0)
sensitivity=3.0
# Polling time interval for reading temperature (int, sec, default=2)
polling=2
# Minimum CPU temperature (float, C, default=30.0)
min_temp=30.0
# Maximum CPU temperature (float, C, default=60.0)
max_temp=60.0
# Minimum CPU fan level (int, %, default=35)
min_level=35
# Maximum CPU fan level (int, %, default=100)
max_level=100
# HD zone: this fan controller works based on HDDs/SSDs temperature.
[HD zone]
# Fan controller enabled (bool, default=0)
enabled=1
# IPMI zone(s) (comma- or space-separated list of int, default=1))
ipmi_zone=1
# Calculation of HD temperatures (int, [0-minimum, 1-average, 2-maximum], default=1)
temp_calc=1
# Discrete steps in mapping of temperatures to fan level (int, default=4)
steps=4
# Threshold in temperature change before the fan controller reacts (float, C, default=2.0)
sensitivity=2.0
# Polling interval for reading temperature (int, sec, default=10)
polling=10
# Minimum HD temperature (float, C, default=32.0)
min_temp=32.0
# Maximum HD temperature (float, C, default=46.0)
max_temp=46.0
# Minimum HD fan level (int, %, default=35)
min_level=35
# Maximum HD fan level (int, %, default=100)
max_level=100
# Names of the HDs (str multi-line list, default=)
# These names MUST BE specified in '/dev/disk/by-id/...' form!
hd_names=
# Path for 'smartctl' command (str, default=/usr/sbin/smartctl).
smartctl_path=/usr/sbin/smartctl
# Standby guard feature for RAID arrays (bool, default=0)
standby_guard_enabled=0
# Number of HDs already in STANDBY state before the full RAID array will be forced to it (int, default=1)
standby_hd_limit=1
# GPU zone: this fan controller works based on GPU(s) temperature.
[GPU zone]
# Fan controller enabled (bool, default=0)
enabled=0
# IPMI zone(s) (comma- or space-separated list of int, default=1))
ipmi_zone=1
# Calculation of GPU temperatures (int, [0-minimum, 1-average, 2-maximum], default=1)
temp_calc=1
# Discrete steps in mapping of temperatures to fan level (int, default=5)
steps=5
# Threshold in temperature change before the fan controller reacts (float, C, default=2.0)
sensitivity=2.0
# Polling interval for reading temperature (int, sec, default=10)
polling=2
# Minimum GPU temperature (float, C, default=40.0)
min_temp=40.0
# Maximum GPU temperature (float, C, default=70.0)
max_temp=70.0
# Minimum GPU zone fan level (int, %, default=35)
min_level=35
# Maximum GPU zone fan level (int, %, default=100)
max_level=100
# GPU device IDs (comma- or space-separated list of int, default=0)
# These are indices in nvidia-smi temperature report.
gpu_device_ids=0
# Path for 'nvidia-smi' command (str, default=/usr/bin/nvidia-smi).
nvidia_smi_path=/usr/bin/nvidia-smi
# Const zone: this fan controller sets constant fan level (without any heat source) for IPMI zones(s).
[CONST zone]
# Fan controller enabled (bool, default=0)
enabled=0
# IPMI zone(s) (comma- or space-separated list of int, default=1))
ipmi_zone=1
# Polling interval for checking/resetting level if needed (int, sec, default=30)
polling=30
# Constant fan level (int, %, default=50)
level=50
```
Important notes:
1. `[IPMI zone] remote_parameters=-U USERNAME -P PASSWORD -H HOST` parameter can be used for remote access for the IPMI interface. It could be useful for a VM setup where the hard disks are configured with PCI passthrough (e.g. a TrueNAS running in a VM on Proxmox), but IPMI needs to be accessed "remotely". Please note that the HOST is the BMC network address (not the VM host address).
2. `[HD zone] hd_names=` is a compulsory parameter for this fan controller, and it must be specified in `/dev/disk/by-id/...` form. Please note that the `/dev/sda` form is not persistent could be changed after a reboot!
3. `[CPU zone] / [HD zone] min_level= / max_level=` should be configured in alignment with threshold configuration (see more in [this chapter](https://github.com/petersulyok/smfc/blob/main/README.md#6-ipmi-fan-control-and-sensor-thresholds)). Be patient, several refinement cycles could happen.
4. Several sample configuration files are provided in `./config/samples` folder.
5. Save/backup your configuration file when you've got the final version. Avoid overwriting if you upgrade to a new version of `smfc`.
### 11. How to run `smfc`?
After a manual installation `smfc` can be started and stopped as a standard `systemd` service. Remember to reload `systemd` configuration after a new installation or if you changed the service definition file:
```
systemctl daemon-reload
systemctl start smfc.service
systemctl stop smfc.service
systemctl restart smfc.service
systemctl status smfc.service
root@nas:~# systemctl status smfc
● smfc.service - Super Micro Fan Control
Loaded: loaded (/etc/systemd/system/smfc.service; enabled; preset: enabled)
Active: active (running) since Mon 2025-06-23 17:55:50 CEST; 6 days ago
Main PID: 8464 (smfc)
Tasks: 1 (limit: 76863)
Memory: 10.4M
CPU: 7min 35.345s
CGroup: /system.slice/smfc.service
└─8464 /usr/bin/python3 /usr/local/bin/smfc -c /etc/smfc/smfc.conf -l 3
Jun 29 19:17:29 nas smfc.service[8464]: CPU zone: new fan level > 48%/34.0C @ IPMI [0] zone(s).
Jun 29 19:21:07 nas smfc.service[8464]: CPU zone: new fan level > 61%/38.0C @ IPMI [0] zone(s).
Jun 29 19:21:11 nas smfc.service[8464]: CPU zone: new fan level > 48%/34.0C @ IPMI [0] zone(s).
```
The `smfc` program has the following parameters:
```
root@nas$ smfc --help
usage: smfc [-h] [-c CONFIG_FILE] [-v] [-l {0,1,2,3,4}] [-o {0,1,2}] [-nd] [-s] [-ne]
options:
-h, --help show this help message and exit
-c CONFIG_FILE configuration file
-v show program's version number and exit
-l {0,1,2,3,4} log level: 0-NONE, 1-ERROR(default), 2-CONFIG, 3-INFO, 4-DEBUG
-o {0,1,2} log output: 0-stdout, 1-stderr, 2-syslog(default)
-nd no dependency checking
-s use sudo command
-ne no fan speed recovery at exit
```
`smfc` command-line options can be specified in `/etc/default/smfc` file if you run `smfc` as a systemd service.
If you are testing your configuration, you can start `smfc.py` directly in a terminal (logging to the standard output on debug log level):
smfc -o 0 -l 3
In case of Docker installation, `smfc` will be executed automatically when the container is started. Its command-line parameters can be specified in the docker-compose file.
### 12. Checking the results and monitoring the logs
All messages will be logged to the specific output and the specific level.
With the help of command `journalctl` you can check logs easily. For example:
1. listing service logs of the last two hours:
journalctl -u smfc --since "2 hours ago"
2. listing service logs from the last boot:
journalctl -b -u smfc
## 13. FAQ
### Q: My fans are spinning up and loud. What's wrong?
Most probably, there was an assertion (i.e the rotational speed of a fan went above or below of a IPMI threshold) and IPMI switched back that zone to full rotational speed.
You can check the current fan rotational speeds:
ipmitool sdr
and you can also check IPMI event log and list assertion events:
```
root@home:~# ipmitool sel list
1 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Critical going low | Asserted
2 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Asserted
3 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Deasserted
4 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Critical going low | Deasserted
5 | 10/19/2023 | 05:20:59 PM CEST | Fan #0x46 | Lower Critical going low | Asserted
```
If the problematic fan (causing the alert) is identified, then you must adjust its threshold. This process could take several adjustment cycle. Be patent :)
You may read [this chapter](https://github.com/petersulyok/smfc#7-ipmi-fan-control-and-sensor-thresholds) for more details.
### Q: How does the author test/use this service?
The configuration is the following:
- [Super Micro X11SCH-F motherboard](https://www.supermicro.com/en/products/motherboard/X11SCH-F)
- [Intel Core i3-9300T CPU](https://ark.intel.com/content/www/us/en/ark/products/134875/intel-core-i39300t-processor-8m-cache-up-to-3-80-ghz.html)
- 64 GB ECC DDR4 RAM
- [Fractal Design Node 804 case](https://www.fractal-design.com/products/cases/node/node-804/black/), with separate chambers for the motherboard and the hard disks:
<img src="https://www.legitreviews.com/wp-content/uploads/2014/05/fractal-design-node-804-vendor-fans.jpg" align="center" width="500">
- Debian Linux LTS (actually bookworm with backported Linux kernel 6.5)
- 8 x [WD Red 12TB (WD120EFAX)](https://shop.westerndigital.com/en-ie/products/outlet/internal-drives/wd-red-plus-sata-3-5-hdd#WD120EFAX) hard disks in ZFS RAID
- 3 x [Noctua NF-12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm) fans (FAN1, FAN2, FAN4) in CPU zone
- 2 x [Noctua NF-12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm) fans (FANA, FANB) in HD zone
## 15. References
Further readings:
### Super Micro
- [BMC IPMI User's Guide 1.1b (X10/X11/H11)](https://www.supermicro.com/manuals/other/IPMI_Users_Guide.pdf)
- [BMC resources](https://www.supermicro.com/en/solutions/management-software/bmc-resources)
- [IPMI Utilities](https://www.supermicro.com/en/solutions/management-software/ipmi-utilities)
- [IPMICFG download](https://www.supermicro.com/wdl/utility/IPMICFG/)
- [IPMICFG User's Guide 1.15 ](https://www.supermicro.com/wdl/utility/IPMICFG/IPMICFG_UserGuide.pdf)
### Forums/blogs
- [\[STH forums\] Reference Material: Supermicro X9/X10/X11 Fan Speed Control](https://forums.servethehome.com/index.php?resources/supermicro-x9-x10-x11-fan-speed-control.20/)
- [\[STH forums\] Addition to X9 motherboards](https://forums.servethehome.com/index.php?threads/supermicro-x9-x10-x11-fan-speed-control.10059/post-339801)
- [\[TrueNAS forums\] How To: Change IPMI Sensor Thresholds using ipmitool](https://www.truenas.com/community/resources/how-to-change-ipmi-sensor-thresholds-using-ipmitool.35/)
- [\[TrueNAS forums\] Script to control fan speed in response to hard drive temperatures](https://www.truenas.com/community/threads/script-to-control-fan-speed-in-response-to-hard-drive-temperatures.41294/)
- [\[Pcfe's blog\] Set fan thresholds on my Super Micro H11DSi-NT](https://blog.pcfe.net/hugo/posts/2018-08-14-epyc-ipmi-fans/)
### Linux kernel
- [coretemp] [documentation](https://www.kernel.org/doc/html/latest/hwmon/coretemp.html)
- [drivetemp] [documentation](https://www.kernel.org/doc/html/latest/hwmon/drivetemp.html) and its [GitHub respository](https://github.com/groeck/drivetemp)
- How to install [hddtemp](https://www.cyberciti.biz/tips/howto-monitor-hard-drive-temperature.html) from a source package
### Similar projects
- [\[GitHub\] Kevin Horton's nas_fan_control](https://github.com/khorton/nas_fan_control)
- [\[GitHub\] Rob Urban's fork nas_fan control](https://github.com/roburban/nas_fan_control)
- [\[GitHub\] sretalla's fork nas_fan control](https://github.com/sretalla/nas_fan_control)
- [\[GitHub\] Andrew Gunnerson's ipmi-fan-control](https://github.com/chenxiaolong/ipmi-fan-control)
> Written with [StackEdit](https://stackedit.io/).
Raw data
{
"_id": null,
"home_page": null,
"name": "smfc",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.9",
"maintainer_email": null,
"keywords": "supermicro, linux, daemon, fancontrol",
"author": null,
"author_email": "Peter Sulyok <peter@sulyok.net>",
"download_url": "https://files.pythonhosted.org/packages/28/03/39092bad1cd05b655b2f3f7f2295847b8d7b6ba0ef6d24b0f55c224f6c33/smfc-4.0.0.tar.gz",
"platform": null,
"description": "\ufeff\n# smfc\n[\n](https://github.com/petersulyok/smfc/actions/workflows/tests.yml) [\n](https://app.codecov.io/gh/petersulyok/smfc) [\n](https://github.com/petersulyok/smfc/issues) [](https://pypi.org/project/smfc)\n[](https://badge.fury.io/py/smfc)\n\nSuper Micro fan control for Linux (home) servers.\n\n## TL;DR\n\nThis is a `systemd service` running on Linux and can control fans with help of IPMI on Super Micro X10-X13 (and some X9) motherboards.\n\nYou can also run `smfc` in docker, see more details in [Docker.md](docker/Docker.md).\n\n### 1. Prerequisites\n - a Super Micro motherboard with ASPEED AST2400/2500/2600 chip\n - Python 3.9-3.13\n - a Linux distribution with:\n - `systemd` and `bash`\n - `coretemp` kernel module for Intel CPUs or `k10temp` kernel module for AMD CPUs\n - `drivetemp` kernel module (kernel version 5.6+ required) modules for SATA HDDs/SSDs\n - `ipmitool`\n - optional: `smartmontools` for SAS/SCSI disks and *standby guard* feature\n - optional: `nvidia-smi` for GPU fan controller \n\n\n### 2. Installation and configuration\n 1. Set up the IPMI threshold values for your fans (see [chapter 6.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#6-ipmi-fan-control-and-sensor-thresholds) for more details). \n 2. Optional: enable advanced power management features for your CPU and SATA hard disks for lower power consumption, heat generation and fan noise. \n 3. Load kernel modules (`coretemp/k10temp` and `drivetemp`).\n 4. Install `smfc` service (see [chapter 9.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#9-installation) for more details).\n 5. Edit the configuration file `/etc/smfc/smfc.conf` and command line options in `/etc/default/smfc` (see [chapters 10.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#10-configuration-file) for more details).\n 6. Start `smfc` service (see [chapter 11.](https://github.com/petersulyok/smfc/tree/main?tab=readme-ov-file#11-how-to-run-smfc) for more details).\n 7. Check results in system log\n 8. Leave a feedback in [discussion #55](https://github.com/petersulyok/smfc/discussions/55)\n\nFeel free to visit [Discussions](https://github.com/petersulyok/smfc/discussions) and raise your questions or share your experience on this project.\n\n## Details\n### 1. How does it work?\nThis service was designed for Super Micro motherboards with IPMI functionality, implementing different fan controllers connected to one or more IPMI zones.\nIn `smfc`, the following fan controllers are implemented:\n\n| Fan controller | Temperature source | Configuration | Default IPMI zone |\n|----------------|-------------------------|-------------------------------------------------------------------------|---------------------|\n| CPU zone | Intel/AMD CPU(s) | CPUs are identified automatically | 0 (CPU zone) |\n| HD zone | SATA and SCSI HDDs/SSDs | Hard disks' names must be specified in `[HD zone] hd_names=` parameter | 1 (Peripheral zone) | \n| GPU zone | Nvidia GPUs | GPU indices must be specified in `[GPU zone] gpu_device_ids=` parameter | 1 (Peripheral zone) |\n| Constant zone | None | Constant fan level can be specified in `[CONST zone] level=` parameter | 1 (Peripheral zone) |\n\nThese fan controllers can be enabled and disabled independently. They can be used in a free combination with on or more IPMI zones, but different fan controllers should control different IPMI zones (i.e. no overlapping is allowed)!\n_Constant zone_ is an exception here, it does not require a temperature source, it can provide a constant fan level for one or more IPMI zones.\n\nThe _IPMI zone_ is a logical term, representing a cooling zone, where there are predefined fans having the same rotation speed. Please note that the fan assignment to an IPMI zone is predefined on the motherboard, it cannot be changed! \nOn a typical Super Micro motherboard, there are two IPMI zones:\n\n- CPU or System zone (IPMI zone 0) with fan names: FAN1, FAN2, etc.\n- Peripheral or HD zone (IPMI zone 1) with fan names: FANA, FANB, etc.\n\nOn Super Micro server motherboards, there could be more IPMI zones with different fan names (see [issue #31](https://github.com/petersulyok/smfc/issues/31)). \n\nNote: `smfc v3.8.0` and previous versions implemented _Swapped Zones_ feature to swap IPMI zone 0 and 1. From `smfc v4.0.0` the IPMI zones can be assigned freely to fan controllers providing more freedom and convince for the user (see `ipmi_zone=` parameter for more detail). \n\nIn `smfc`, a temperature-driven fan controller implements the following control logic:\n\n 1. it reads the zone's temperature\n 2. it calculates a new fan level based on the user-defined control function and the temperature value of the zone \n 3. it configures the new fan level for the zone(s) with IPMI commands (i.e. `ipmitool`)\n\n<img src=\"https://github.com/petersulyok/smfc/raw/main/doc/smfc_overview.png\" align=\"center\" width=\"600\">\n\nIf there are multiple heat sources (e.g. multiple CPUs, HDDs or GPUs) defined in the fan controller, then the user can configure a calculation method (i.e. minimum, average, maximum) for the temperature calculation (see `temp_calc=` parameter in the configuration).\n\nPlease note that `smfc` will set all fans back to 100% speed at service termination to avoid overheating! \n\n#### 2. User-defined control function\nFan controllers are using user-defined control functions where a temperature interval is being mapped to a fan rotation level interval.\n\n <img src=\"https://github.com/petersulyok/smfc/raw/main/doc/userdefined_control_function.png\" align=\"center\" width=\"500\">\n\nThe following five parameters will define such a function:\n\n min_temp=\n max_temp=\n min_level=\n max_level=\n steps=\n\nIn this way, a fan controller can map any new temperature value to a fan level (from Celsius degrees to % value). \nChanging the fan rotational speed is a very slow process (it could take several seconds depending on the fan type and the requested amount of change), so we try to minimize these kinds of actions. Instead of setting fan rotational speed continuously, we define discrete fan levels based on `steps=` parameter.\n\n <img src=\"https://github.com/petersulyok/smfc/raw/main/doc/fan_output_levels.png\" align=\"center\" width=\"500\">\n\nThe fan controllers implement the following strategies to avoid/minimize the unnecessary change of fan rotation speed:\n\n 1. When the fan rotational speed is changed, it always applies a delay time (defined in `[IPMI] fan_level_delay=` configuration parameter) to let the fan implement the physical change.\n 2. There is a sensitivity threshold parameter (`sensitivity=`) in the fan controller configuration. While the temperature change is below this value, the fan controller does not react. \n 3. The configuration parameter `polling=` defines the frequency of the temperature reading. The bigger polling time, the lower frequency of the fan speed change.\n\n#### 3. Standby guard\nFor HD zone fan controller, an additional optional feature was implemented, called *Standby guard*, with the following assumptions:\n\t\n - SATA hard disks are organized into a RAID array\n - the RAID array will go to standby mode recurrently\n\nThis feature is monitoring the power state of SATA hard disks (with the help of the `smartctl`) and will put the whole array to standby mode if a few members are already stepped into that. With this feature, the situation can be avoided where the array is partially in standby mode while other members are still active.\nSCSI disks are not compatible with this feature.\n\n#### 5. Hard disk compatibility\nThe `smfc` service was originally designed for `SATA` hard drives, but `smfc v3.0.0` is also compatible with `NVME` and `SAS/SCSI` disks. The following table summarizes how the temperature is read for different disk types: \n\n| Disk type | Temperature source | Kernel module | Command |\n|------------|----------------------|---------------|------------|\n| `SATA` | Linux kernel (HWMON) | `drivetemp` | - |\n| `NVME` | Linux kernel (HWMON) | - | - |\n| `SAS/SCSI` | `smartctl` | - | `smartctl` |\n\nSome additional notes:\n\n- For `NVME` SSDs no kernel driver needs to be loaded the kernel can handle this disk type automatically\n- For `SATA` disks the `drivetemp` kernel module should be loaded. **This is the fastest way to read disk temperature**, and the kernel module can report the temperature while hard disks are in sleep mode!\n- For `SAS/SCSI` disks the `smartctl` command will be used to read disk temperature\n- If `drivetemp` module is not loaded or an HDD is not compatible with `drivetemp` module then `smfc` will use `smartctl` automatically. \n- Different disks types can be mixed in `hd_names=` configuration parameter but the *Standby guard* feature will not be supported in this case.\n- It is NOT RECOMMENDED to mix NVME SSD and SATA/SCSI disks in `hd_names=` parameter, because they are operating in quite different temperature intervals (e.g. 30-40C vs 40-80C).\n\n\n### 5. Super Micro compatibility\nThis software was designed to work with Super Micro X10 and X11 motherboards with a BMC chip (i.e. ASPEED AST2400/2500/2600) and IPMI functionality. Unfortunately, there are some motherboards (e.g. X10QBi see issue #69) not compatible with `smfc`.\n\nIn case of X9 motherboards the compatibility is not guaranteed, it depends on the hardware components of the motherboard (i.e. not all X9 motherboards employ BMC chip). \n\nThe earlier X8 motherboards are NOT compatible with this software. They do not implement `IPMI_FULL` mode, and they cannot control fan levels how it is implemented in `smfc`.\n\nX13 motherboards (with AST2600 BMC chips) seem to be compatible with smfc (see mode details in [issue #33](https://github.com/petersulyok/smfc/issues/33) about an X13SAE-F motherboard).\nFan control and `IPMI_FULL` mode are working properly. The only difference is in using thresholds, AST2600 implements only `Lower Critical` threshold, so setting up thresholds is different in this case. \n\nFeel free to create a short feedback in [discussion #55](https://github.com/petersulyok/smfc/discussions/55) on your compatibility experience.\n\n\n### 6. IPMI fan control and sensor thresholds\nOn Super Micro X10-X11 motherboards IPMI uses six sensor thresholds to specify the safe and unsafe fan rotational speed intervals (these are RPM values rounded to nearest hundreds, defined for each fan separately):\n\n```\nLower Non-Recoverable \nLower Critical \nLower Non-Critical\nUpper Non-Critical \nUpper Critical \nUpper Non-Recoverable\n```\n\nbut newer Super Micro X13 motherboards (with AST2600 BMC chip) have only one sensor threshold:\n\n```\nLower Critical \n```\n\nOriginally, this chapter was created Super Micro X10-X11 motherboards, but can be easily adopted to X13 motherboards as well (see more details in #33).\n\nLike many other utilities (created by NAS and home server community), `smfc` also uses **IPMI FULL mode** for fan control, where all fans in the zone:\n\n 1. initially configured to full speed (100%)\n 2. then their speed can be safely configured in `[Lower Critical, Upper Critical]` interval\n 3. if any fan speed oversteps either `Lower Critical` or `Upper Critical` threshold then IPMI will generate an _assertion event_ and will set the all fan speeds back to 100% in the zone\n\nPlease also consider the fact that **fans are mechanical devices, their rotational speed is not stable** (it could be fluctuating). To avoid IPMI's assertion mechanism described here please follow the next steps: \n\n 1. Per fan: check the minimum and maximum rotational speeds of your fan on its vendor website\n 2. Per fan: configure proper IMPI sensor thresholds adjusted to the fan speed interval\n 3. Per zone: define safe `min_level`/`max_level` values for `smfc` respecting the variance of the all fans in the IPMI zone (it could take several iterations and adjustments) \n\n<img src=\"https://github.com/petersulyok/smfc/raw/main/doc/ipmi_sensor_threshold.png\" align=\"center\" width=\"600\">\n\nHere is a real-life example for a [Noctua NF-F12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm) fan:\n\n```\nUpper Non-Recoverable = 1800 rpm\nUpper Critical = 1700 rpm\nUpper Non-Critical = 1600 rpm\nLower Non-Critical = 200 rpm\nLower Critical = 100 rpm\nLower Non-Recoverable = 0 rpm\nMax RPM = 1500 rpm\nMin PRM = 300 rpm\nmax_level = 100 (i.e. 1500 rpm)\nmin_level = 35 (i.e. 500 rpm)\n```\n\n\nNotes:\n - Use the following `ipmitool` command to display the current IMPI sensor thresholds for fans:\n ```\n root@home:~# ipmitool sensor|grep FAN\n FAN1 | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000 \n FAN2 | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000 \n FAN3 | na | | na | na | na | na | na | na | na \n FAN4 | 400.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000 \n FANA | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000 \n FANB | 500.000 | RPM | ok | 0.000 | 100.000 | 200.000 | 1600.000 | 1700.000 | 1800.000 \n ```\n - Use the following `ipmitool` command to list assertion events:\n ```\n root@home:~# ipmitool sel list\n 1 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Critical going low | Asserted\n 2 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Asserted\n 3 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Deasserted\n 4 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Critical going low | Deasserted\n 5 | 10/19/2023 | 05:20:59 PM CEST | Fan #0x46 | Lower Critical going low | Asserted\n ```\n - Use the following `ipmitool` commands to specify all six sensor thresholds for FAN1:\n ```\n root@home:~# ipmitool sensor thresh FAN1 lower 0 100 200\n root@home:~# ipmitool sensor thresh FAN1 upper 1600 1700 1800\n ```\n - You can also edit and run `ipmi/set_ipmi_treshold.sh` to configure all IPMI sensor thresholds\n - If you install new BMC firmware on your Super Micro motherboard, you have to configure IPMI thresholds again\n - If you do not see fans when executing `ipmitool sensors`, you may want to reset the BMC to factory default using the Web UI or using `ipmitool mc reset cold`\n - Noctua specifies the variance of minimum and maximum fan rotational speeds (e.g. see the [specification of Noctua NF-F12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm/specification)). For example:\n\n - `Rotational speed (+/- 10%) 1500 RPM`: 1350-1650 RPM interval\n - `Min. rotational speed @ 20% PWM (+/-20%) 300 RPM`: 240-360 RPM interval\n \n Please note that [LNA](https://noctua.at/en/na-src10)/ULNA cables or [Y-cables](https://noctua.at/en/na-syc1) can modify the rotational speed calculations here and the required IPMI sensor thresholds too. \n\nYou can read more about:\n\n - IPMI fan control: [STH Forums](https://forums.servethehome.com/index.php?resources/supermicro-x9-x10-x11-fan-speed-control.20/) and [TrueNAS Forums](https://www.truenas.com/community/threads/pid-fan-controller-perl-script.50908/)\n - Change IPMI sensors thresholds: [TrueNAS Forums](https://www.truenas.com/community/resources/how-to-change-ipmi-sensor-thresholds-using-ipmitool.35/)\n\n### 7. Power management\nIf low noise and low heat generation are important attributes of your Linux box, then you may consider the following chapters.\n\n#### 7.1 CPU\nMost of the modern CPUs has multiple energy saving features. You can check your BIOS and enable them to minimize the heat generation.\n\nIntel(R) CPUs:\n - Intel(R) Speed Shift Technology\n - Intel(R) SpeedStep\n - C-states\n - Boot performance mode\n\nAMD(R) CPUs:\n - PowerNow!\n - Cool\\`n\\`quiet\n - Turbo Core\n\nWith this setup the CPU will change its base frequency and power consumption dynamically based on the load.\n\n#### 7.2 SATA hard disks\nIn case of SATA hard disks, you may enable:\n\n - advanced power management\n - spin down timer\n\nWith the help of command `hdparm` you can enable advanced power management and specify a spin down timer (read more [here](https://en.wikipedia.org/wiki/Hdparm)):\n\n\thdparm -B 127 /dev/sda\n\thdparm -S 240 /dev/sda\n\t\nIn file `/etc/hdparm.conf` you can specify all parameters persistently:\n\n\tquiet\n\n\t/dev/sda {\n apm = 127\n spindown_time = 240\n\t}\n\t/dev/sdb {\n apm = 127\n spindown_time = 240\n\t}\n\t...\n\nImportant notes: \n 1. If you plan to spin down your hard disks or RAID array (i.e. put them to standby mode) you have to set up the configuration parameter `[HD zone] polling=` minimum twice bigger as the `spindown_time` specified here.\n 2. In file `/etc/hdparm.conf` you must define HD names in `/dev/disk/by-id/...` form to avoid inconsistency.\n\n### 8. Kernel modules\nWe need to load the following important Linux kernel modules:\n\n - [`coretemp`](https://www.kernel.org/doc/html/latest/hwmon/coretemp.html): temperature report for Intel(R) CPUs\n - [`k10temp`](https://docs.kernel.org/hwmon/k10temp.html): temperature report for AMD(R) CPUs\n - [`drivetemp`](https://www.kernel.org/doc/html/latest/hwmon/drivetemp.html): temperature report for SATA hard disks (available from kernel 5.6+ version)\n\nUse `/etc/modules` file for persistent loading of these modules. \nHere are some sample HWMON file locations for these kernel modules:\n\n - `coretemp`: `/sys/devices/platform/coretemp.0/hwmon/hwmon*/temp1_input`\n - `k10temp`: `/sys/bus/pci/drivers/k10temp/0000*/hwmon/hwmon*/temp1_input`\n - `drivetemp`: `/sys/class/scsi_disk/0:0:0:0/device/hwmon/hwmon*/temp1_input`\n\nNotes:\n- `smfc` is able to find the proper HWMON file automatically for Intel(R) CPUs, AMD(R) CPUs, SATA drives, or NVMe drives, but users may also specify the files manually (see `hwmon_path=` parameter in the config file)\n- Reading `drivetemp` module is the fastest way to get the temperature of the hard disks, and it can read temperature of the SATA hard disks even in standby mode, too. \n\n#### 9. Installation\nFor the installation, you need root privileges. There are several ways to install `smfc`, this chapter\n\n#### 9.1. Manual installation\nThere is an installation script ([`bin/install.sh`](https://raw.githubusercontent.com/petersulyok/smfc/refs/heads/main/bin/install.sh)) which can install `smfc` remotely from the GitHub repository (without cloning or downloading).\nThe installation script requires `curl` and `pip` commands and can be executed in this way:\n\n`curl --silent https://raw.githubusercontent.com/petersulyok/smfc/refs/heads/main/bin/install.sh|bash`\n\nor if you want to preserve your existing configuration file, this way:\n\n`curl --silent https://raw.githubusercontent.com/petersulyok/smfc/refs/heads/main/bin/install.sh|bash /dev/stdin --keep-config`\n\nThe installation script has the following command line parameters:\n\n```\nuser@host:~$ ./install.sh --help\nusage: install.sh [-h|--help] [-k|--keep-config] [-v|--verbose]\n -h, --help help text\n -k, --keep-config keep original configuration file\n -v, --verbose verbose output\n```\n\nThe default locations of the installation files: \n\n| Files | Installation folder | Description |\n|-----------------|---------------------------------------------------|---------------------------------|\n| `smfc.service` | `/etc/systemd/system` | systemd service definition file |\n| `smfc` | `/etc/default` | service command line options |\n| `smfc.conf` | `/etc/smfc` | service configuration file |\n| `smfc package` | `/usr/local/bin`<br/> `/usr/local/lib/python3.xx` | python package |\n\nFurther manual steps after a successful installation:\n - install program dependencies (`ipmitool`, `smartctl` or `nvidia-smi`)\n - load proper kernel modules (`coretemp` or `k10temp` and `drivetemp`)\n\n#### 9.2. Docker installation\n`smfc` is also available as a docker image, see more details in [Docker.md](../docker/Docker.md). In this case, your job is only to provide your configuration file on host computer, `smfc` will be executed automatically when the container is starting. \n\n\n### 10. Configuration file\nAfter successful installation, create your new configuration file. If you just upgrade to a new `smfc` version, you can preserve the existing one. \n\n#### 10.1 Right strategy to create your configuration file\nYou have to think over and answer the following questions:\n\n1. What are the most important heat sources in your machine? Typically, these could be CPU(s), hard disks, or GPUs.\n2. Which fan controllers would you like to use and configure in `smfc`?\n3. What is the expected temperature interval (minimum/maximum C degree) for the selected temperature source(s)? Use some test tools to measure it (e.g. [`s-tui`](https://github.com/amanusk/s-tui), [`fio`](https://fio.readthedocs.io/en/latest/fio_doc.html), [`iozone`](https://www.iozone.org/)) if you don't have their track records. \n4. Which IPMI zone(s) will be connected to these fan controllers/temperate sources)? Check how many IPMI zones you have, how the fans are connected on your motherboard, and how they are cooling the selected temperature source(s). \n5. What is the stable level interval for fans in the selected IPMI zone(s)? Probably this part requires the most patience! You have assumptions here, you will try them. If there are IPMI assertions and your fans are spinning up then you will refine the interval and try again. You might have several cycles here, this is normal. \n\n#### 10.2 Sample configuration file\nEdit `/etc/smfc/smfc.conf` and specify your configuration parameters here:\n\n```\n#\n# smfc.conf (C) 2020-2025, Peter Sulyok\n# smfc 4.x service configuration parameters\n#\n# Please read the documentation here: https://github.com/petersulyok/smfc\n#\n\n# Ipmi specific parameters.\n[Ipmi]\n# Path for ipmitool (str, default=/usr/bin/ipmitool)\ncommand=/usr/bin/ipmitool \n# Delay time after changing IPMI fan mode (int, seconds, default=10)\nfan_mode_delay=10\n# Delay time after changing IPMI fan level (int, seconds, default=2)\nfan_level_delay=2\n# IPMI parameters for remote access (string, default='')\n#remote_parameters=-U USERNAME -P PASSWORD -H HOST\n\n\n# CPU zone: this fan controller works based on CPU(s) temperature.\n[CPU zone]\n# Fan controller enabled (bool, default=0)\nenabled=1\n# IPMI zone(s) (comma- or space-separated list of int, default=0))\nipmi_zone=0\n# Calculation method for CPU temperatures (int, [0-minimum, 1-average, 2-maximum], default=1)\ntemp_calc=1\n# Discrete steps in mapping of temperatures to fan level (int, default=6)\nsteps=6\n# Threshold in temperature change before the fan controller reacts (float, C, default=3.0)\nsensitivity=3.0\n# Polling time interval for reading temperature (int, sec, default=2)\npolling=2\n# Minimum CPU temperature (float, C, default=30.0)\nmin_temp=30.0\n# Maximum CPU temperature (float, C, default=60.0)\nmax_temp=60.0\n# Minimum CPU fan level (int, %, default=35)\nmin_level=35\n# Maximum CPU fan level (int, %, default=100)\nmax_level=100\n\n\n# HD zone: this fan controller works based on HDDs/SSDs temperature.\n[HD zone]\n# Fan controller enabled (bool, default=0)\nenabled=1\n# IPMI zone(s) (comma- or space-separated list of int, default=1))\nipmi_zone=1\n# Calculation of HD temperatures (int, [0-minimum, 1-average, 2-maximum], default=1)\ntemp_calc=1\n# Discrete steps in mapping of temperatures to fan level (int, default=4)\nsteps=4\n# Threshold in temperature change before the fan controller reacts (float, C, default=2.0)\nsensitivity=2.0\n# Polling interval for reading temperature (int, sec, default=10)\npolling=10\n# Minimum HD temperature (float, C, default=32.0)\nmin_temp=32.0\n# Maximum HD temperature (float, C, default=46.0)\nmax_temp=46.0\n# Minimum HD fan level (int, %, default=35)\nmin_level=35\n# Maximum HD fan level (int, %, default=100)\nmax_level=100\n# Names of the HDs (str multi-line list, default=)\n# These names MUST BE specified in '/dev/disk/by-id/...' form!\nhd_names=\n# Path for 'smartctl' command (str, default=/usr/sbin/smartctl).\nsmartctl_path=/usr/sbin/smartctl\n# Standby guard feature for RAID arrays (bool, default=0)\nstandby_guard_enabled=0\n# Number of HDs already in STANDBY state before the full RAID array will be forced to it (int, default=1)\nstandby_hd_limit=1\n\n\n# GPU zone: this fan controller works based on GPU(s) temperature.\n[GPU zone]\n# Fan controller enabled (bool, default=0)\nenabled=0\n# IPMI zone(s) (comma- or space-separated list of int, default=1))\nipmi_zone=1\n# Calculation of GPU temperatures (int, [0-minimum, 1-average, 2-maximum], default=1)\ntemp_calc=1\n# Discrete steps in mapping of temperatures to fan level (int, default=5)\nsteps=5\n# Threshold in temperature change before the fan controller reacts (float, C, default=2.0)\nsensitivity=2.0\n# Polling interval for reading temperature (int, sec, default=10)\npolling=2\n# Minimum GPU temperature (float, C, default=40.0)\nmin_temp=40.0\n# Maximum GPU temperature (float, C, default=70.0)\nmax_temp=70.0\n# Minimum GPU zone fan level (int, %, default=35)\nmin_level=35\n# Maximum GPU zone fan level (int, %, default=100)\nmax_level=100\n# GPU device IDs (comma- or space-separated list of int, default=0)\n# These are indices in nvidia-smi temperature report.\ngpu_device_ids=0\n# Path for 'nvidia-smi' command (str, default=/usr/bin/nvidia-smi).\nnvidia_smi_path=/usr/bin/nvidia-smi\n\n\n# Const zone: this fan controller sets constant fan level (without any heat source) for IPMI zones(s).\n[CONST zone]\n# Fan controller enabled (bool, default=0)\nenabled=0\n# IPMI zone(s) (comma- or space-separated list of int, default=1))\nipmi_zone=1\n# Polling interval for checking/resetting level if needed (int, sec, default=30)\npolling=30\n# Constant fan level (int, %, default=50)\nlevel=50\n```\n\nImportant notes:\n1. `[IPMI zone] remote_parameters=-U USERNAME -P PASSWORD -H HOST` parameter can be used for remote access for the IPMI interface. It could be useful for a VM setup where the hard disks are configured with PCI passthrough (e.g. a TrueNAS running in a VM on Proxmox), but IPMI needs to be accessed \"remotely\". Please note that the HOST is the BMC network address (not the VM host address). \n2. `[HD zone] hd_names=` is a compulsory parameter for this fan controller, and it must be specified in `/dev/disk/by-id/...` form. Please note that the `/dev/sda` form is not persistent could be changed after a reboot!\n3. `[CPU zone] / [HD zone] min_level= / max_level=` should be configured in alignment with threshold configuration (see more in [this chapter](https://github.com/petersulyok/smfc/blob/main/README.md#6-ipmi-fan-control-and-sensor-thresholds)). Be patient, several refinement cycles could happen.\n4. Several sample configuration files are provided in `./config/samples` folder.\n5. Save/backup your configuration file when you've got the final version. Avoid overwriting if you upgrade to a new version of `smfc`.\n\n\n### 11. How to run `smfc`?\nAfter a manual installation `smfc` can be started and stopped as a standard `systemd` service. Remember to reload `systemd` configuration after a new installation or if you changed the service definition file:\n\n```\nsystemctl daemon-reload\nsystemctl start smfc.service\nsystemctl stop smfc.service\nsystemctl restart smfc.service\nsystemctl status smfc.service\nroot@nas:~# systemctl status smfc\n\u25cf smfc.service - Super Micro Fan Control\n Loaded: loaded (/etc/systemd/system/smfc.service; enabled; preset: enabled)\n Active: active (running) since Mon 2025-06-23 17:55:50 CEST; 6 days ago\n Main PID: 8464 (smfc)\n Tasks: 1 (limit: 76863)\n Memory: 10.4M\n CPU: 7min 35.345s\n CGroup: /system.slice/smfc.service\n \u2514\u25008464 /usr/bin/python3 /usr/local/bin/smfc -c /etc/smfc/smfc.conf -l 3\n\nJun 29 19:17:29 nas smfc.service[8464]: CPU zone: new fan level > 48%/34.0C @ IPMI [0] zone(s).\nJun 29 19:21:07 nas smfc.service[8464]: CPU zone: new fan level > 61%/38.0C @ IPMI [0] zone(s).\nJun 29 19:21:11 nas smfc.service[8464]: CPU zone: new fan level > 48%/34.0C @ IPMI [0] zone(s).\n```\n\nThe `smfc` program has the following parameters:\n\n```\nroot@nas$ smfc --help\nusage: smfc [-h] [-c CONFIG_FILE] [-v] [-l {0,1,2,3,4}] [-o {0,1,2}] [-nd] [-s] [-ne]\n\noptions:\n -h, --help show this help message and exit\n -c CONFIG_FILE configuration file\n -v show program's version number and exit\n -l {0,1,2,3,4} log level: 0-NONE, 1-ERROR(default), 2-CONFIG, 3-INFO, 4-DEBUG\n -o {0,1,2} log output: 0-stdout, 1-stderr, 2-syslog(default)\n -nd no dependency checking\n -s use sudo command\n -ne no fan speed recovery at exit\n```\n\n`smfc` command-line options can be specified in `/etc/default/smfc` file if you run `smfc` as a systemd service. \n\nIf you are testing your configuration, you can start `smfc.py` directly in a terminal (logging to the standard output on debug log level):\n\n\tsmfc -o 0 -l 3\n\nIn case of Docker installation, `smfc` will be executed automatically when the container is started. Its command-line parameters can be specified in the docker-compose file. \n\n### 12. Checking the results and monitoring the logs\nAll messages will be logged to the specific output and the specific level.\nWith the help of command `journalctl` you can check logs easily. For example:\n\n1. listing service logs of the last two hours:\n\n\t\tjournalctl -u smfc --since \"2 hours ago\"\n\n2. listing service logs from the last boot:\n\n\t\tjournalctl -b -u smfc\n\n## 13. FAQ\n\n### Q: My fans are spinning up and loud. What's wrong?\nMost probably, there was an assertion (i.e the rotational speed of a fan went above or below of a IPMI threshold) and IPMI switched back that zone to full rotational speed.\nYou can check the current fan rotational speeds:\n\n\tipmitool sdr\n\nand you can also check IPMI event log and list assertion events:\n\n```\nroot@home:~# ipmitool sel list\n 1 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Critical going low | Asserted\n 2 | 10/19/2023 | 05:15:35 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Asserted\n 3 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Non-recoverable going low | Deasserted\n 4 | 10/19/2023 | 05:15:38 PM CEST | Fan #0x46 | Lower Critical going low | Deasserted\n 5 | 10/19/2023 | 05:20:59 PM CEST | Fan #0x46 | Lower Critical going low | Asserted\n```\n\nIf the problematic fan (causing the alert) is identified, then you must adjust its threshold. This process could take several adjustment cycle. Be patent :)\nYou may read [this chapter](https://github.com/petersulyok/smfc#7-ipmi-fan-control-and-sensor-thresholds) for more details. \n\n### Q: How does the author test/use this service?\nThe configuration is the following:\n\n - [Super Micro X11SCH-F motherboard](https://www.supermicro.com/en/products/motherboard/X11SCH-F)\n - [Intel Core i3-9300T CPU](https://ark.intel.com/content/www/us/en/ark/products/134875/intel-core-i39300t-processor-8m-cache-up-to-3-80-ghz.html)\n - 64 GB ECC DDR4 RAM\n - [Fractal Design Node 804 case](https://www.fractal-design.com/products/cases/node/node-804/black/), with separate chambers for the motherboard and the hard disks:\n \n\t<img src=\"https://www.legitreviews.com/wp-content/uploads/2014/05/fractal-design-node-804-vendor-fans.jpg\" align=\"center\" width=\"500\">\n\n - Debian Linux LTS (actually bookworm with backported Linux kernel 6.5)\n - 8 x [WD Red 12TB (WD120EFAX)](https://shop.westerndigital.com/en-ie/products/outlet/internal-drives/wd-red-plus-sata-3-5-hdd#WD120EFAX) hard disks in ZFS RAID\n - 3 x [Noctua NF-12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm) fans (FAN1, FAN2, FAN4) in CPU zone \n - 2 x [Noctua NF-12 PWM](https://noctua.at/en/products/fan/nf-f12-pwm) fans (FANA, FANB) in HD zone\n\n## 15. References\nFurther readings:\n\n### Super Micro\n - [BMC IPMI User's Guide 1.1b (X10/X11/H11)](https://www.supermicro.com/manuals/other/IPMI_Users_Guide.pdf)\n - [BMC resources](https://www.supermicro.com/en/solutions/management-software/bmc-resources)\n - [IPMI Utilities](https://www.supermicro.com/en/solutions/management-software/ipmi-utilities)\n - [IPMICFG download](https://www.supermicro.com/wdl/utility/IPMICFG/)\n - [IPMICFG User's Guide 1.15 ](https://www.supermicro.com/wdl/utility/IPMICFG/IPMICFG_UserGuide.pdf)\n\n### Forums/blogs\n - [\\[STH forums\\] Reference Material: Supermicro X9/X10/X11 Fan Speed Control](https://forums.servethehome.com/index.php?resources/supermicro-x9-x10-x11-fan-speed-control.20/)\n - [\\[STH forums\\] Addition to X9 motherboards](https://forums.servethehome.com/index.php?threads/supermicro-x9-x10-x11-fan-speed-control.10059/post-339801) \n - [\\[TrueNAS forums\\] How To: Change IPMI Sensor Thresholds using ipmitool](https://www.truenas.com/community/resources/how-to-change-ipmi-sensor-thresholds-using-ipmitool.35/)\n - [\\[TrueNAS forums\\] Script to control fan speed in response to hard drive temperatures](https://www.truenas.com/community/threads/script-to-control-fan-speed-in-response-to-hard-drive-temperatures.41294/)\n - [\\[Pcfe's blog\\] Set fan thresholds on my Super Micro H11DSi-NT](https://blog.pcfe.net/hugo/posts/2018-08-14-epyc-ipmi-fans/)\n\n### Linux kernel\n - [coretemp] [documentation](https://www.kernel.org/doc/html/latest/hwmon/coretemp.html)\n - [drivetemp] [documentation](https://www.kernel.org/doc/html/latest/hwmon/drivetemp.html) and its [GitHub respository](https://github.com/groeck/drivetemp)\n - How to install [hddtemp](https://www.cyberciti.biz/tips/howto-monitor-hard-drive-temperature.html) from a source package\n\n### Similar projects\n - [\\[GitHub\\] Kevin Horton's nas_fan_control](https://github.com/khorton/nas_fan_control)\n - [\\[GitHub\\] Rob Urban's fork nas_fan control](https://github.com/roburban/nas_fan_control)\n - [\\[GitHub\\] sretalla's fork nas_fan control](https://github.com/sretalla/nas_fan_control)\n - [\\[GitHub\\] Andrew Gunnerson's ipmi-fan-control](https://github.com/chenxiaolong/ipmi-fan-control)\n\n> Written with [StackEdit](https://stackedit.io/).\n",
"bugtrack_url": null,
"license": null,
"summary": "Super Micro Fan Control for Linux",
"version": "4.0.0",
"project_urls": {
"Changelog": "https://github.com/petersulyok/smfc/blob/main/CHANGELOG.md",
"Homepage": "https://github.com/petersulyok/smfc",
"Issues": "https://github.com/petersulyok/smfc/issues"
},
"split_keywords": [
"supermicro",
" linux",
" daemon",
" fancontrol"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d9c3b8b2297c30e6839e4102e7afc4e2a796c26ebe20bbdbe56686126f880da1",
"md5": "b5514a32381c36238ee804c247e68bd9",
"sha256": "5be5f7e3a38062b328b2e16cfb370aa673db683b2495271ed2837402b977e57f"
},
"downloads": -1,
"filename": "smfc-4.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b5514a32381c36238ee804c247e68bd9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.9",
"size": 46017,
"upload_time": "2025-07-08T16:28:06",
"upload_time_iso_8601": "2025-07-08T16:28:06.633862Z",
"url": "https://files.pythonhosted.org/packages/d9/c3/b8b2297c30e6839e4102e7afc4e2a796c26ebe20bbdbe56686126f880da1/smfc-4.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "280339092bad1cd05b655b2f3f7f2295847b8d7b6ba0ef6d24b0f55c224f6c33",
"md5": "fb30be89326036f496b91b100b6cbdcf",
"sha256": "c7533697e201a82929cbd87f811fe6bb9532f6c3532fa431aae3556198cd77e8"
},
"downloads": -1,
"filename": "smfc-4.0.0.tar.gz",
"has_sig": false,
"md5_digest": "fb30be89326036f496b91b100b6cbdcf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.9",
"size": 81913,
"upload_time": "2025-07-08T16:28:07",
"upload_time_iso_8601": "2025-07-08T16:28:07.695919Z",
"url": "https://files.pythonhosted.org/packages/28/03/39092bad1cd05b655b2f3f7f2295847b8d7b6ba0ef6d24b0f55c224f6c33/smfc-4.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-08 16:28:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "petersulyok",
"github_project": "smfc",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "smfc"
}
