A simple PWM fan controller for Orange Pi boards (Only tested on an Orange Pi 5 Plus).
âšī¸ This is for fans connected through standard GPIO header pins. Orange Pi 5 Plus has a dedicated fan header, which can be configured by following the manual.
- Runs as a systemd service
- Automatically control the speed of a PWM fan based on the temperature of the CPU
- Configurable thresholds for fan speed and temperature
- Ramp up and ramp down delays to avoid rapid on/off switching of the fan
I am currently using:
- Orange Pi 5 Plus
- GeeekPi PWM Controllable Fan 40x40x10mm
For the Orange Pi 5 Plus, I connect the fan to the 5V and GND pins and the PWM wire to the physical pin 5 (wPi pin 2) on the GPIO header
Installed the wiringOP library. Check the installation instructions.
Run the following command to install the fan controller:
# Run again with sudo if you get permission errors
curl -sSL https://raw.githubusercontent.com/jamsinclair/opifancontrol/main/install.sh | bash- Copy the
opifancontrol.shscript to/usr/local/bin/and make it executable:
cp opifancontrol.sh /usr/local/bin/opifancontrol
chmod +x /usr/local/bin/opifancontrol- Copy the
opifancontrol.conffile to/etc/:
cp opifancontrol.conf /etc/- Copy the
opifancontrol.servicefile to/etc/systemd/system/:
cp opifancontrol.service /etc/systemd/system/- Enable the service:
systemctl enable opifancontrol.serviceThe configuration file is located at /etc/opifancontrol.conf. The default configuration is:
# The GPIO pin to use for the fan. This is the wPi pin number, not the physical pin number.
# You can find the wPi pin number by running `gpio readall` on the Orange Pi.
FAN_GPIO_PIN=2
# TEMP_LOW, TEMP_MED, TEMP_HIGH are in degrees Celsius
# FAN_LOW, FAN_MED, FAN_HIGH are in percent of max fan speed, max 100.
# The fan will only be turned on if the temperature is above TEMP_LOW.
TEMP_LOW=55
FAN_LOW=50
TEMP_MED=65
FAN_MED=75
TEMP_HIGH=70
FAN_HIGH=100
# How frequently, in seconds, to poll the temperature data
TEMP_POLL_SECONDS=2
# To avoid rapid on/off switching, the fan will delay switching back on if it was recently turned off.
RAMP_UP_DELAY_SECONDS=15
# The ramp down delay is how long the fan will stay on after the temperature drops below the threshold.
RAMP_DOWN_DELAY_SECONDS=60
# The PWM range and clock are used to control the fan speed. You shouldn't need to change these unless you know what you're doing.
# Assumes the CPU fan runs at 25kHz.
PWM_RANGE=192
PWM_CLOCK=4
# Set to true to enable debug logging of fan speed changes.
DEBUG=falseTo uninstall the fan controller, first stop and disable the service:
systemctl stop opifancontrol.service
systemctl disable opifancontrol.serviceThen remove the files:
rm /usr/local/bin/opifancontrol.sh
rm /etc/opifancontrol.conf
rm /etc/systemd/system/opifancontrol.serviceThis project is licensed under the MIT License - see the LICENSE file for details.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent