X735-script: Difference between revisions
Replace <comments/> with <comment-streams /> |
|||
| (15 intermediate revisions by 3 users not shown) | |||
| Line 48: | Line 48: | ||
* RetroPie | * RetroPie | ||
* Twister | * Twister | ||
* FreedomBox (Refer to [[#FAQ]] Q7 also) | |||
==Install== | ==Install== | ||
| Line 70: | Line 71: | ||
Please use the following command to get the software script if you are using '''BOOKWORM''' OS | 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 307: | 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 312: | Line 386: | ||
<!--Add review function! --> | <!--Add review function! --> | ||
< | <comment-streams id="main" /> | ||
<!--Please choose the --> | <!--Please choose the --> | ||