• sales

    +86-0755-88291180

Raspberry Pi Variable-Frequency-Fan User Guide

Introduction

Raspberry Pi Variable-Frequency-Fan, for Raspberry Pi 4B/3B+/3B/3A+/2B

Features

  • Fan speed can be controlled by programming PWM mode
  • Four RGB LEDs can be programmed to achieve status indication and other special effects
  • Provides open source program control code, and the heat dissipation solution makes Raspberry Pi run more stable, perform better
  • Real-time monitoring of the Raspberry Pi's CPU temperature
  • Start the fan when the CPU temperature reaches the set value
  • Multiple temperature threshold settings, corresponding to different fan operating speeds
  • Multiple sets of temperature threshold settings, matching different RGB LED colors, allowing you to easily understand the real-time temperature and heat dissipation effect
  • Real-time monitoring of the working frequency of the Raspberry Pi
  • When the working frequency of the Raspberry Pi reaches the maximum frequency limit, regardless of whether the heat dissipation temperature threshold is reached or not, the fan runs at full speed, which is more intelligent in response to heat
  • The program is based on Python, which is convenient for DIY



Install fan

When the Raspberry Pi is not powered on, connect the fan to pins 1 to 12 of the Raspberry Pi, as shown in the figure.

If the pins are installed incorrectly, the hardware may be damaged. So be sure to confirm the location and power on the Raspberry Pi again.

If you use it with a casing, please confirm whether the casing is compatible with the fan and Raspberry Pi. For example, the following case is compatible with Raspberry Pi 4B and fans. After assembly, the effect is as follows.


Enable SPI of Raspberry Pi

Run the following command in the terminal to enter the configuration interface.

sudo raspi-config

Select Interface Options-SPI to enable SPI. Restart the Raspberry Pi after completion.


Install Python library

The fan driver we provide includes intelligent fan speed control and RGB LED status display. RGB LED relies on apa102-pi library to drive. Therefore, in order to use the complete fan function, this library needs to be installed in advance. Of course, if you don't need the LED status display function, you don't need to install it, and just remove the code related to LED control from the driver code we provide.

Run the following command in the terminal.

sudo apt install -y python3-pip python3-rpi.gpio
sudo pip3 install apa102-pi


Fan driver

The fan driver is open source and can be run after downloading to the Raspberry Pi. Enter the following commands in the terminal.

sudo apt install -y git
cd ~
git clone https://github.com/nxez/rpi-fan
cd rpi-fan

We have prepared two source codes, rpi-fan.py is a fully functional version. rpi-fan-lite.py is a simplified version, without the RGB LED driver.

Enter the following command in the terminal to run

sudo python3 rpi-fan.py

or

sudo python3 rpi-fan-lite.py

To run in the background, add & after the command, for example:

sudo python3 rpi-fan.py &

Set up to run

Edit the rc.local file.

sudo nano /etc/rc.local

Add a line before exit 0 (the path of the script should be modified according to the actual situation):

sudo python3 /home/pi/rpi-fan/rpi-fan.py &

Appendix: Source code description

Taking the full version as an example, the following describes the configurable variables in the source code. If you encounter fan stalls, you can increase the value of speed_base appropriately according to the situation.

# The calculation formula of fan running speed, speed = base speed + (current temperature-temperature threshold) * speed unit increment.
speed = speed_base + (current_temp - threshold_temp) * speed_step

# Fan base speed, range 0 ~ 100。
speed_base = 70
# Rate unit increment.
speed_step = 1.5
# The temperature threshold for starting the fan, the default is 40 degrees.
threshold_temp = 40

# The color value displayed by the RGB LED. Different CPU temperatures correspond to different colors. The default sequence is blue, green, yellow, magenta, and red.
# The value uses RGB color value, from 0x000000 to 0xFFFFFF, the brightness of the color can also be reflected by changing the color value.
c_temp = [0x000008, 0x000800, 0x080800, 0x080008, 0x080000]

# The following settings are used to match the temperature and the LED color. Modify the upper c_temp and the lower temp adjustment to match, and you can set more temperature levels and LED colors by yourself.
c_temp_i = 4
if temp < 60:
    c_temp_i = 3
if temp < 55:
    c_temp_i = 2
if temp < 50:
    c_temp_i = 1
if temp < 40:
    c_temp_i = 0
TAG: Capacitive Touchscreen Raspberry Pi 5 DSI Servo ESP32 S3 2.1 inch Round LCD Development Board 480x480 TouchScreen Display LVGL HMI With QMI8658C 6-Axis Sensor Raspberry Pi5 Raspberry Pi 5 OLED-LCD-HAT-A user guide Serial Server Raspberry Pi 5 Sound Argon ONE V3 Case with FAN IR For Raspberry Pi 5 Raspberry Pi RP2040 LoRa ESP32 C3 Raspberry Pi Camera Milk-V Duo Code Raspberry Pi Pico 2 RP2350 2 inch LCD Capacitive TouchScreen Development Board 240x320 Display QMI8658 6-Axis /OV5640 Camera /SD /Battery Port ESP32 S3 Development Board 1.85 inch Round LCD Display 360&times;360 QMI8658 Sensor / MIC / SD /MP3 Audio /Battery Port LVGL/HMI For Arduino X1012 Raspberry Pi 5 POE And PCIe to M.2 NVMe SSD Board Pi5 2280 Power over Ethernet Raspberry Pi OpenWrt Tutorial 1 Rasperry Pico 2 RP2350 7.3 inch e-Paper Ink Display E6 Full Color Electronic PhotoPainter 800x480 For Calendar/Quotes/Paintings/Posters Jetson Nano IO Board