5,375
edits
Changes
Jump to navigation
Jump to search
no edit summary
{{GD Template Impl}}
__NOTOC__
This is script installation tutorial for [[NASPi]], [[NASPi Gemini 2.5X735]], and This guideline is similar to [[NASPi CM4-M2XScript]] and [[NASPi CM4-2only because the hardware uses a different GPIO.5]]
<hr/>
The original pwm fan control script is from [https://github.com/pimlie/geekworm-x-c1 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.
==OS that has been tested==
* Raspbian
* DietPi
* Manjaro
* Ubuntu
* myNode
* Umbrel
* Volumio
* RetroPie
* Twister
==Preconfigured <code>config.txt</code>==
To install pwm fan, first add <code>dtoverlay=pwm-2chan,pin2=13,func2=4</code> to <code>/boot/config.txt</code> under [all] or the end of file and <code>reboot</code>:
sudo nano /boot/config.txt
'''Or''' (it's <code>/boot/firmware/config.txt</code> if you are using <code>ubuntu</code>)
sudo nano /boot/firmware/config.txt
Save & exit.
sudo reboot
==Clone the script==
<pre>
git clone https://github.com/geekworm-com/xscript
cd xscript
chmod +x *.sh
</pre>
==Create the x-c1-fan service==
<span class="tb_red_bold"> Note: If your device does not support pwm fans or you are not using pwm, you can skip this step</span>
<pre>
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
</pre>
Then the pwm fan starts running.
==Create the x-c1-pwr service==
<pre>
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
</pre>
==Prepair software shutdown==
sudo cp -f ./x-c1-softsd.sh /usr/local/bin/
Create a alias <code>xoff</code> command to execute the software shutdown
<pre>
echo "alias xoff='sudo /usr/local/bin/x-c1-softsd.sh'" >> ~/.bashrc
source ~/.bashrc
</pre>
Then you can run <code>xoff</code> to execute software shutdown.
==Test safe shutdown==
'''Software safe shutdown command''':
xoff
'''Hardware safe shutdown operation''':
You can verify the safety switch through the onboard switch, press and hold the switch for <code>3</code> 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 <code>1-2</code> seconds to reboot
* press button switch <code>3</code> seconds to safe shutdown,
* press <code>7-8</code> seconds to force shutdown.
==Others==
<code>fan-rpi.py</code> and <code>fan-pigpio.py</code> are no longer used, and are reserved here for research and use by python lovers only.
==FAQ==
<html>
<details>
<summary>Q: How to login <b>volumio</b> via SSH?</summary>
<p>1. Enable SSH:</p>
<p>Visit http://volumio.local/dev/, then click <b>ENABLE SSH</b> button</p>
<p>2. URL connection is IP address, and the default user name is <b>volumio</b>, default password is <b>volumio</b></p>
</details>
<details>
<summary>Q: How to login to <b>Umbrel</b> via SSH?</summary>
A: ssh umbrel@umbrel.local (or ssh umbrel@<IP address of your Umbrel>). the default user name is <b>umbrel</b>, default password is <b>moneyprintergobrrr</b>
</details>
<details>
<summary>Q: How to login to <b>myNode</b> via SSH?</summary>
A: URL connection is IP address, and the default user name is <b>admin</b>, default password is <b>bolt</b>
</details>
<details>
<summary>Q: How to login to <b>DietPi</b> via SSH?</summary>
A: URL connection is IP address, and the default user name is <b>root</b>, default password is <b>dietpi</b>
</details>
<details>
<summary>Q: Is <b>LibreELEC</b> supported?</summary>
A: TODO
</details>
</html>