37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# PWM fan
|
|
|
|
v2 Usermod to to control PWM fan with RPM feedback and temperature control
|
|
|
|
This usermod requires Dallas Temperature usermod to obtain temperature information. If this is not available the fan will always run at 100% speed.
|
|
If the fan does not have _tacho_ (RPM) output you can set the _tacho-pin_ to -1 to not use that feature.
|
|
|
|
You can also set the thershold temperature at which fan runs at lowest speed. If the actual temperature measured will be 3°C greater than threshold temperature the fan will run at 100%.
|
|
|
|
If the _tacho_ is supported the current speed (in RPM) will be repored in WLED Info page.
|
|
|
|
## Installation
|
|
|
|
Add the compile-time option `-D USERMOD_PWM_FAN` to your `platformio.ini` (or `platformio_override.ini`) or use `#define USERMOD_PWM_FAN` in `myconfig.h`.
|
|
You will also need `-D USERMOD_DALLASTEMPERATURE`.
|
|
|
|
### Define Your Options
|
|
|
|
All of the parameters are configured during run-time using Usermods settings page.
|
|
This includes:
|
|
|
|
* PWM output pin (can be configured at compile time `-D PWM_PIN=xx`)
|
|
* tacho input pin (can be configured at compile time `-D TACHO_PIN=xx`)
|
|
* sampling frequency in seconds
|
|
* threshold temperature in degees C
|
|
|
|
_NOTE:_ You may also need to tweak Dallas Temperature usermod sampling frequency to match PWM fan sampling frequency.
|
|
|
|
### PlatformIO requirements
|
|
|
|
No special requirements.
|
|
|
|
## Change Log
|
|
|
|
2021-10
|
|
* First public release
|