WSAL17951 – Fan HAT/en

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

PWM-controlled fan HAT with PCA9685 driver, I2C interface and integrated temperature monitoring. Includes a 0.91" OLED display (128×32), a 3007 fan (up to 8000 RPM), and 16 PWM outputs.

Related products at JW Tech

• WSAL17951 – PWM Controlled Fan HAT for Raspberry Pi, I2C, Temperature Monitor

Technical overview

• Core: PCA9685 PWM driver as the fan controller with automatic PWM adjustment
• 0.91" OLED display (SSD1306 driver, 128×32 pixels, white, FOV > 160°)
• 3007 fan with up to 8000 RPM
• I2C bus for connecting other host control boards
• 16 PWM outputs for external devices
• Operating voltage 5 V, logic level 3.3 V
• Mounting holes 3.0 mm
• Comes with heat sinks
• Connects via the 40-pin GPIO header of the Raspberry Pi
• Temperature data is read in real time; fan speed adjusts automatically

Commands and examples – verify before use: 

sudo wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
sudo tar zxvf bcm2835-1.71.tar.gz
cd bcm2835-1.71/ && sudo ./configure && sudo make && sudo make check && sudo make install
sudo apt-get install wiringpi
wget https://files.waveshare.com/wiki/common/wiringpi-latest.deb && sudo dpkg -i wiringpi-latest.deb
sudo git clone https://github.com/WiringPi/WiringPi && cd WiringPi && sudo ./build
sudo su && wget https://github.com/joan2937/lg/archive/master.zip && unzip master.zip && cd lg-master && sudo make install
sudo apt-get update && sudo apt-get install python-pip && sudo pip install RPi.GPIO && sudo apt-get install python-smbus
sudo apt-get update && sudo apt-get install python3-pip && sudo pip install RPi.GPIO && sudo apt-get install python3-smbus
cd && sudo apt-get install p7zip-full && wget https://files.waveshare.com/upload/0/06/Fan_HAT.7z && 7z x Fan_HAT.7z -r -o./Fan_HAT
cd Fan_HAT/c/ && make clean && make && sudo ./main
cd Fan_HAT/python/ && sudo python main.py
sudo nano /etc/rc.local

Notes and version constraints

• On Bookworm systems only the lgpio library is available; bcm2835 and wiringPi cannot be installed or used
• The Python library does not need separate installation – the demo can be run directly
• I2C must be enabled on the Raspberry Pi, otherwise error prompts appear
• At low CPU load (~40 °C) the fan barely spins; it speeds up only when the CPU is under heavy computation
• Higher fan speed produces more noise; this is physically expected
• Version-sensitive steps: installation commands differ by OS branch (Bullseye/Bookworm)
• When adding the autostart entry in rc.local, the lines must be inserted before 'exit 0','All listed commands are taken from the source document; verify compatibility with your current system version before running them

Source and revision record

• Fan HAT - Waveshare Wiki
• Source revision: 80830
• Captured: 2026-09-01T02:49:23+00:00
• SHA-256: 7fdbbae38eb46b72f38658ac1a5353378d8b3e1e4f624ce8574858f2e95e0541