The original key pwm fan control script is from pimlie/geekworm-x-c1, pimlie implements the pwm fan shell script, which does not depend on third-party python libraries at all. Thanks to pimlie.
Now we think you have successfully flashed the OS Image into Micro SD and and power on the device, and you have also completed the operations such as creating new user required in some Raspberry Pi OS.
After your system boots, then you need to open
Terminal prpgram, then type the following command to complete the installation of the script
OS that has been tested
Note: Not tested with Home Assistant, for some reason, we are not able to upgrade and use the Home Assistant to test, please pay attention to check if there is any update in the future.(If you have successfully tested Home Assistant, welcome to share your experience via email at: email@example.com)
To install pwm fan, first add
/boot/config.txt under [all] or the end of file and
sudo nano /boot/config.txt
/boot/firmware/config.txt if you are using
sudo nano /boot/firmware/config.txt
Save & exit.
Clone the script
git clone https://github.com/geekworm-com/xscript cd xscript chmod +x *.sh
PS: For some OS such as Raspberry Pi OS Lite, the git tool is not installed by default, if you get an error like error: -bash: git: command not found, please run the following command to install the git tool.
sudo apt install -y git
Create the x-c1-fan service
Note: If your device does not support pwm fans or you are not using pwm, you can skip this step
sudo cp -f ./x-c1-fan.sh /usr/local/bin/ sudo cp -f ./x-c1-fan.service /lib/systemd/system sudo systemctl daemon-reload sudo systemctl enable x-c1-fan sudo systemctl start x-c1-fan
Then the pwm fan starts running.
Create the x-c1-pwr service
sudo cp -f ./x-c1-pwr.sh /usr/local/bin/ sudo cp -f x-c1-pwr.service /lib/systemd/system sudo systemctl daemon-reload sudo systemctl enable x-c1-pwr sudo systemctl start x-c1-pwr
Prepair software shutdown script
sudo cp -f ./x-c1-softsd.sh /usr/local/bin/
Create a alias
xoff command to execute the software shutdown
echo "alias xoff='sudo /usr/local/bin/x-c1-softsd.sh'" >> ~/.bashrc source ~/.bashrc
Then you can run
xoff to execute software shutdown.
Test safe shutdown
Software safe shutdown command:
DON'T run the 'shutdown' linux command to shut down, otherwise the power of shield will not be shut down.
Hardware safe shutdown operation:
You can verify the safety switch through the onboard switch, press and hold the switch for
3 seconds, then the blue LED will flash slowly and the shutdown is going then all LEDs will be off until the device is completely powered off.
- press on-board button switch
1-2seconds to reboot
- press button switch
3seconds to safe shutdown,
7-8seconds to force shutdown.
- The code for fan speed control is now in the
fan-pigpio.pyare no longer used, and are reserved here for research and use by python lovers only.
sudo systemctl stop x-c1-fan sudo systemctl disable x-c1-fan
sudo systemctl stop x-c1-pwr sudo systemctl disable x-c1-pwr
xoff allias on .bashrc file
sudo sed -i '/xoff/d' ~/.bashrc source ~/.bashrc
If you have any problems during use, please contact us by email and tell us the product model you are using and the OS version you are using.
Q: How to login volumio via SSH?
1. Enable SSH:
Visit http://volumio.local/dev/, then click ENABLE SSH button
2. URL connection is IP address, and the default user name is volumio, default password is volumio
Q: How to login to Umbrel via SSH?A: ssh firstname.lastname@example.org (or ssh umbrel@
Q: How to login to myNode via SSH?A: URL connection is IP address, and the default user name is admin, default password is bolt
Q: How to login to DietPi via SSH?A: URL connection is IP address, and the default user name is root, default password is dietpi
Q: Is LibreELEC supported?A: TODO