X735-script: Difference between revisions

Replace <comments/> with <comment-streams />
 
(12 intermediate revisions by 3 users not shown)
Line 48: Line 48:
* RetroPie
* RetroPie
* Twister
* Twister
* FreedomBox (Refer to [[#FAQ]] Q7 also)


==Install==
==Install==
Line 326: Line 327:
A:  
A:  


**Issue:**
'''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.
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:**
'''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.
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:**
'''Solution:'''
 
You need to manually download the missing overlay files from the Raspberry Pi firmware repository.
You need to manually download the missing overlay files from the Raspberry Pi firmware repository.


1.  **Check for Missing Files:**
1.  Check for Missing Files:
    First, verify that the files are missing:
  First, verify that the files are missing:
     ```bash
     <code>ls /boot/firmware/overlays/ | grep pwm</code>
    ls /boot/firmware/overlays/ | grep pwm
  *(If no results are shown, the files are missing)*
    ```
    *(If no results are shown, the files are missing)*


2.  **Download the Required Overlays:**
2.  Download the Required Overlays:
    Manually download the necessary `.dtbo` files directly to your overlays directory. You can use `wget` for this:
  Manually download the necessary `.dtbo` files directly to your overlays directory. You can use `wget` for this:
     ```bash
     <code>cd /tmp</code>
     cd /tmp
    <code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-2chan.dtbo</code>
     wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-2chan.dtbo
     <code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-gpio-fan.dtbo</code>
     wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-gpio-fan.dtbo
     <code>wget https://raw.githubusercontent.com/raspberrypi/firmware/master/boot/overlays/pwm-2chan.dtbo</code>
     # ... (Download other pwm*.dtbo files if needed)
     <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
  # Move them to the correct directory
     sudo mv pwm*.dtbo /boot/firmware/overlays/
     <code>sudo mv pwm*.dtbo /boot/firmware/overlays/</code>
    ```


3.  **Configure and Reboot:**
3.  Configure and Reboot:
    Ensure your `/boot/firmware/config.txt` contains the correct overlay line (usually handled by our script), then reboot:
  Ensure your `/boot/firmware/config.txt` contains the correct overlay line (usually handled by our script), then reboot:
     ```bash
     <code>sudo reboot</code>
    sudo reboot
    ```


4.  **Verification:**
4.  Verification:
    After rebooting, check if the overlay loaded successfully:
  After rebooting, check if the overlay loaded successfully:
     ```bash
     <code>dmesg | grep -i pwm</code>
    dmesg | grep -i pwm
  You should now see logs indicating the PWM overlay has been loaded, and the fan script should function correctly.
    ```
    You should now see logs indicating the PWM overlay has been loaded, and the fan script should function correctly.
</div>
</div>
</div>
</div>
Line 371: Line 374:
<div class="toccolours mw-collapsible mw-collapsed">
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.0;">
<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 376: Line 386:


<!--Add review function! -->
<!--Add review function! -->
<comments />
<comment-streams id="main" />


<!--Please choose the  -->
<!--Please choose the  -->