X735-script: Difference between revisions
Replace <comments/> with <comment-streams /> |
|||
| (23 intermediate revisions by 3 users not shown) | |||
| Line 15: | Line 15: | ||
2. The script now supports the Raspberry Pi OS '''BOOKWORM''' version. You just need to '''uninstall''' the original script and '''reinstall''' it. Please refer to the following: | 2. The script now supports the Raspberry Pi OS '''Trixie''' and '''BOOKWORM''' version. You just need to '''uninstall''' the original script and '''reinstall''' it. Please refer to the following: | ||
Open ternimal window, then run the following command: | Open ternimal window, then run the following command: | ||
| Line 48: | Line 48: | ||
* RetroPie | * RetroPie | ||
* Twister | * Twister | ||
* FreedomBox (Refer to [[#FAQ]] Q7 also) | |||
==Install== | ==Install== | ||
| Line 65: | Line 66: | ||
===Clone the script=== | ===Clone the script=== | ||
Clone pruduct software script | Clone pruduct software script if use the last '''Trixie''' OS | ||
git clone -b trixie https://github.com/geekworm-com/x735-script | |||
Please use the following command to get the software script if you are using '''BOOKWORM''' OS | |||
git clone https://github.com/geekworm-com/x735-script | git clone https://github.com/geekworm-com/x735-script | ||
'''PS''': Run the following command to view system information: | |||
<pre> | |||
pi@geekworm:~ $ lsb_release -a | |||
No LSB modules are available. | |||
Distributor ID: Raspbian | |||
Description: Raspbian GNU/Linux 13 (trixie) | |||
Release: 13 | |||
Codename: trixie | |||
</pre> | |||
The above last line "Codename" indicates that the current system is '''Trixie''' OS. | |||
Then set executable permissions for script files: | |||
cd x735-script | cd x735-script | ||
chmod +x *.sh | chmod +x *.sh | ||
| Line 92: | Line 108: | ||
Run the following command to install fan service script; | Run the following command to install fan service script; | ||
'''PS''': You can skip this step due to '''X735 V1.0''' does not support PWM fans | |||
sudo ./install-fan-service.sh | sudo ./install-fan-service.sh | ||
Then the pwm fan starts running. | Then the pwm fan starts running. | ||
| Line 102: | Line 120: | ||
===Create the x735-pwr service=== | ===Create the x735-pwr service=== | ||
PS: If you use '''X735 V1.0''', you need to modify '''x735-pwr.service''' file to adapt to the different GPIO of '''X735 v1.0''', you can refer to line 10 of '''x735-pwr.service''' file. | |||
sudo ./install-pwr-service.sh | sudo ./install-pwr-service.sh | ||
| Line 108: | Line 127: | ||
sudo cp -f ./xSoft.sh /usr/local/bin/ | sudo cp -f ./xSoft.sh /usr/local/bin/ | ||
2. Then run the following command to create a alias 'x735off' command | 2. Then run the following command to create a alias 'x735off' command | ||
for X735 V3.0 V2.5 V2.1 V2.0 | |||
echo 'alias x735off="sudo /usr/local/bin/xSoft.sh '''0''' 20"' >> ~/.bashrc | echo 'alias x735off="sudo /usr/local/bin/xSoft.sh '''0''' 20"' >> ~/.bashrc | ||
for X735 1.0 | |||
echo 'alias x735off="sudo /usr/local/bin/xSoft.sh '''0''' 18"' >> ~/.bashrc | |||
3. Run the following command to make the alias '''x735off''' effective | 3. Run the following command to make the alias '''x735off''' effective | ||
source ~/.bashrc | source ~/.bashrc | ||
| Line 296: | Line 319: | ||
</div> | </div> | ||
</div> | </div> | ||
<div class="toccolours mw-collapsible mw-collapsed"> | |||
<div style="font-weight:bold;line-height:1.0;"> | |||
Q7: Fan control fails on FreedomBox OS or Pure Debian (Missing dtbo files) | |||
</div> | |||
<div class="mw-collapsible-content"> | |||
A: | |||
'''Issue:''' | |||
When using FreedomBox OS (or some minimal Debian installations), even after following the installation guide, the fan does not spin. Running `dmesg | grep pwm` returns nothing, and the `/boot/firmware/overlays/` directory is missing the required `pwm-2chan.dtbo` file. | |||
'''Cause:''' | |||
FreedomBox and some minimal Linux distributions do not include the Raspberry Pi specific Device Tree Overlays by default. The line `dtoverlay=pwm-2chan` in `config.txt` fails to load because the underlying driver file is missing from the system. | |||
'''Solution:''' | |||
You need to manually download the missing overlay files from the Raspberry Pi firmware repository. | |||
1. Check for Missing Files: | |||
First, verify that the files are missing: | |||
<code>ls /boot/firmware/overlays/ | grep pwm</code> | |||
*(If no results are shown, the files are missing)* | |||
2. Download the Required Overlays: | |||
Manually download the necessary `.dtbo` files directly to your overlays directory. You can use `wget` for this: | |||
<code>cd /tmp</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-2chan.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-gpio-fan.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-2chan.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-gpio-fan.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-gpio.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-ir-tx.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-pio.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm.dtbo</code> | |||
<code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm1.dtbo</code> | |||
# ... (Download other pwm*.dtbo files if needed) | |||
# Move them to the correct directory | |||
<code>sudo mv pwm*.dtbo /boot/firmware/overlays/</code> | |||
3. Configure and Reboot: | |||
Ensure your `/boot/firmware/config.txt` contains the correct overlay line (usually handled by our script), then reboot: | |||
<code>sudo reboot</code> | |||
4. Verification: | |||
After rebooting, check if the overlay loaded successfully: | |||
<code>dmesg | grep -i pwm</code> | |||
You should now see logs indicating the PWM overlay has been loaded, and the fan script should function correctly. | |||
</div> | |||
</div> | |||
<div class="toccolours mw-collapsible mw-collapsed"> | |||
<div style="font-weight:bold;line-height:1.0;"> | |||
Q8: The fan won't start, and <code>read_fan_speed.py</code> shows 0 RPM. What causes this issue? | |||
</div> | |||
<div class="mw-collapsible-content"> | |||
A: Please verify that the PWM hardware path of your Raspberry Pi matches the one defined in the script. '''e.g.:''' Raspberry Pi 5 uses <code>/sys/class/pwm/pwmchip0</code>, whereas the script is set to <code>pwmchip2</code>. | |||
</div> | |||
</div> | |||
| Line 301: | Line 386: | ||
<!--Add review function! --> | <!--Add review function! --> | ||
< | <comment-streams id="main" /> | ||
<!--Please choose the --> | <!--Please choose the --> | ||