.. include:: /index.rst :start-after: start_hello_message :end-before: end_hello_message FAQ ============ 1. About Compatible Systems ------------------------------- Systems that passed the test on the Raspberry Pi 5: .. image:: img/compitable_os.png :width: 600 :align: center 2. About Power Button -------------------------- The power button brings out the power button of the Raspberry Pi 5, and it functions just like the power button of the Raspberry Pi 5. .. image:: img/power_button.jpg :width: 400 :align: center * **Shutdown** * If you run **Raspberry Pi OS Desktop** system, you can press the power button twice in quick succession to shutdown. * If you run **Raspberry Pi OS Lite** system, press the power button a single time to initiate a shutdown. * To force a hard shutdown, press and hold the power button. * **Power on** * If the Raspberry Pi board is shut down, but still powered, single-press to power on from a shutdown state. * If you are running a system that does not support a shutdown button, you can hold it for 5 seconds to force a hard shutdown, and single-press to power on from a shutdown state. 3. About the Raspberry Pi AI HAT+ ---------------------------------------------------------- The Raspberry Pi AI HAT+ is not compatible with the Pironman 5. .. image:: img/output3.png :width: 400 The Raspberry Pi AI Kit combines the Raspberry Pi M.2 HAT+ and the Hailo AI accelerator module. .. image:: img/output2.jpg :width: 400 You can detach the Hailo AI accelerator module from the Raspberry Pi AI Kit and directly insert it into the HAT of the Pironman 5 Mini. .. .. image:: img/output4.png .. :width: 800 4. About Micro HDMI Cable ------------------------------------- We recommend using the official Raspberry Pi Micro HDMI cable. Some third-party cables with a connector length shorter than 65 mm may cause poor contact and display issues. .. image:: img/need_mini_hdmi.png :width: 400 5. PI5 Fails to Boot (Red LED)? ------------------------------------------- This issue may be caused by a system update, changes to the boot order, or a corrupted bootloader. You can try the following steps to resolve the problem: #. Reconnect the power supply and check if the PI5 boots successfully. #. Restore the Bootloader * If the PI5 still cannot boot, the bootloader may be corrupted. You can follow this guide: :ref:`update_bootloader_mini` and choose whether to boot from SD card or NVMe/USB. * Insert the prepared SD card into the PI5, power it on, and wait at least 10 seconds. Once the recovery is complete, remove and reformat the SD card. * Then, use Raspberry Pi Imager to flash the latest Raspberry Pi OS, insert the card back, and try booting again. 6. RGB LEDs Not Working? -------------------------- #. The two pins on the Mini HAT are used to connect the RGB LEDs to GPIO10. Ensure that the jumper cap on these two pins are properly in place. .. image:: hardware/img/io_board_rgb_pin.png :width: 300 :align: center #. Verify that the Raspberry Pi is running a compatible operating system. The Pironman 5 only supports the following OS versions: .. image:: img/compitable_os.png :width: 600 :align: center If you have installed an unsupported OS, follow the guide to install a compatible operating system: :ref:`install_the_os_mini`. #. Run the command ``sudo raspi-config`` to open the configuration menu. Navigate to **3 Interfacing Options** -> **I3 SPI** -> **YES**, then click **OK** and **Finish** to enable SPI. After enabling SPI, restart the Pironman 5. If the problem persists after performing the above steps, please send an email to service@sunfounder.com. We will respond as soon as possible. 7. CPU fan not working? ---------------------------------------------- When the CPU temperature has not reached the set threshold, the CPU fan will not working. **Fan Speed Control Based on Temperature** The PWM fan operates dynamically, adjusting its speed according to the Raspberry Pi 5's temperature: * **Below 50°C**: Fan remains off (0% speed). * **At 50°C**: Fan operates at low speed (30% speed). * **At 60°C**: Fan increases to medium speed (50% speed). * **At 67.5°C**: Fan ramps up to high speed (70% speed). * **At 75°C and above**: Fan operates at full speed (100% speed). For more detail please refer to : :ref:`fan_mini` 8. How to disable web dashboard? ------------------------------------------------------ Once you have completed the installation of the ``pironman5`` module, you will be able to access the :ref:`view_control_dashboard_mini`. If you do not need this feature and want to reduce CPU and RAM usage, you can disable the dashboard during the installation of ``pironman5`` by adding the ``--disable-dashboard`` flag. .. code-block:: shell cd ~/pironman5 sudo python3 install.py --disable-dashboard If you have already installed ``pironman 5``, you can remove the ``dashboard`` module and ``influxdb``, then restart pironman5 to apply the changes: .. code-block:: shell /opt/pironman5/env/bin/pip3 uninstall pm-dashboard influxdb sudo apt purge influxdb sudo systemctl restart pironman5 9. How to Control Components Using the ``pironman5`` Command ---------------------------------------------------------------------- You can refer to the following tutorial to control the components of the Pironman 5 using the ``pironman5`` command. * :ref:`view_control_commands_mini` 10. How to Change the Raspberry Pi Boot Order Using Commands ------------------------------------------------------------- If you are already logged into your Raspberry Pi, you can change the boot order using commands. Detailed instructions are as follows: * :ref:`configure_boot_ssd_mini` 11. How to Modify the Boot Order with Raspberry Pi Imager? --------------------------------------------------------------- In addition to modifying the ``BOOT_ORDER`` in the EEPROM configuration, you can also use the **Raspberry Pi Imager** to change the boot order of your Raspberry Pi. It is recommended to use a spare card for this step. * :ref:`update_bootloader_mini` 12. How to Copy the System from the SD Card to an NVMe SSD? ------------------------------------------------------------- If you have an NVMe SSD but do not have an adapter to connect your NVMe to your computer, you can first install the system on your Micro SD card. Once the Pironman 5 boots up successfully, you can copy the system from your Micro SD card to your NVMe SSD. Detailed instructions are as follows: * :ref:`copy_sd_to_nvme_mini` 13. How to Remove the Protective Film from the Acrylic Plates ----------------------------------------------------------------- Two acrylic panels are included in the package, both covered with yellow/transparent protective film on both sides to prevent scratches. The protective film may be a bit difficult to remove. Use a screwdriver to gently scrape at the corners, then carefully peel off the entire film. .. image:: img/peel_off_film.jpg :width: 500 :align: center .. _openssh_powershell_mini: 14. How to Install OpenSSH via Powershell? ---------------------------------------------- When you use ``ssh @.local`` (or ``ssh @``) to connect to your Raspberry Pi, but the following error message appears. .. code-block:: ssh: The term 'ssh' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again. It means your computer system is too old and does not have `OpenSSH `_ pre-installed, you need to follow the tutorial below to install it manually. #. Type ``powershell`` in the search box of your Windows desktop, right click on the ``Windows PowerShell``, and select ``Run as administrator`` from the menu that appears. .. image:: img/powershell_ssh.png :width: 90% #. Use the following command to install ``OpenSSH.Client``. .. code-block:: Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0 #. After installation, the following output will be returned. .. code-block:: Path : Online : True RestartNeeded : False #. Verify the installation by using the following command. .. code-block:: Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*' #. It now tells you that ``OpenSSH.Client`` has been successfully installed. .. code-block:: Name : OpenSSH.Client~~~~0.0.1.0 State : Installed Name : OpenSSH.Server~~~~0.0.1.0 State : NotPresent .. warning:: If the above prompt does not appear, it means that your Windows system is still too old, and you are advised to install a third-party SSH tool, like |link_putty|. #. Now restart PowerShell and continue to run it as administrator. At this point you will be able to log in to your Raspberry Pi using the ``ssh`` command, where you will be prompted to enter the password you set up earlier. .. image:: img/powershell_login.png