opifancontrol

A simple PWM fan controller for Orange Pi boards (Only tested on an Orange Pi 5, and Orange Pi 5 Plus).

ℹ️ This is for fans connected through standard GPIO header pins. Orange Pi 5, and Orange Pi 5 Plus also have a dedicated fan header, which can be configured by following the manual.

Features

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

Setup

Hardware Setup

Orange Pi 5

Needed parts:

Orange Pi 5
Noctua NF-A4x10 5V PWM note that only the 5V PWM is supported, other voltages or non PWM variants are not.

Connect the 3 fan wires.

What matters the most is the $\mathbf{\color{blue}{blue\quad PWM}}$ wire matches the software configuration. On the board use the physical pin 7 (wPi pin 2) on the GPIO header to use the default software configuration without any change. If for whatever reason you are forced to use another pin, then you will have to change the FAN_GPIO_PIN. To do that see the configuration section.
For the $\mathbf{\color{yellow}{yellow\quad 5V}}$ you have 2 options physical pins 2 and 4.
For the $\mathbf{\color{black}{black\quad GND}}$ you have 3 options physical pins 6, 14 and 20.

We recommend to use the pins that are closest to each other, therfore physical pins 4 for 5V, 6 for GND and 7 for PWM marked below:

Orange Pi 5 Plus

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

Software Installation

Prerequisites

Installed the wiringOP library. Check the installation instructions.

Install via script

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

Install manually

Install the fan controller manually.

Copy the opifancontrol.sh script to /usr/local/bin/ and make it executable:

cp opifancontrol.sh /usr/local/bin/opifancontrol
chmod +x /usr/local/bin/opifancontrol

Copy the opifancontrol.conf file to /etc/:

cp opifancontrol.conf /etc/

Copy the opifancontrol.service file to /etc/systemd/system/:

cp opifancontrol.service /etc/systemd/system/

Enable the service:

systemctl enable opifancontrol.service

Configuration

The 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=false

Uninstallation

To uninstall the fan controller, first stop and disable the service:

systemctl stop opifancontrol.service
systemctl disable opifancontrol.service

Then remove the files:

rm /usr/local/bin/opifancontrol.sh
rm /etc/opifancontrol.conf
rm /etc/systemd/system/opifancontrol.service

License

This project is licensed under the MIT License - see the LICENSE file for details.

lindsayshuo/opifancontrol