Note
Hello, welcome to the SunFounder Raspberry Pi & Arduino & ESP32 Enthusiasts Community on Facebook! Dive deeper into Raspberry Pi, Arduino, and ESP32 with fellow enthusiasts.
Why Join?
Expert Support: Solve post-sale issues and technical challenges with help from our community and team.
Learn & Share: Exchange tips and tutorials to enhance your skills.
Exclusive Previews: Get early access to new product announcements and sneak peeks.
Special Discounts: Enjoy exclusive discounts on our newest products.
Festive Promotions and Giveaways: Take part in giveaways and holiday promotions.
π Ready to explore and create with us? Click [here] and join today!
FAQο
Compatible Raspberry Pi Modelsο
Currently, the 3.5-inch display is only compatible with Raspberry Pi 4 and Raspberry Pi 5. For Raspberry Pi 3B, 3B+, and Zero 2W, it is not recommended to use them with the 3.5-inch display, as installing the touchscreen driver may cause it to malfunction.
Can this screen work on Ubuntu, Kali Linux, or RetroPie?ο
Yes, but only with specific OS versions. If you install an unsupported version, the screen may not work after installing the driver.
Supported systems:
Raspberry Pi OS
Trixie Desktop (64-bit) (released: 2025-12-04)
Bookworm Desktop (64-bit) (released: 2025-11-24, 2025-05-13, 2025-05-06)
After installing the driver on Bookworm, run
startxto enter the desktop environment.
Ubuntu
ubuntu-24.04.4-preinstalled-desktop-arm64+raspi (Raspberry Pi 4 only)
Kali Linux
RetroPie
Retropie Download page (Raspberry Pi 4 only)
Why does my screen stay black or white after powering on?ο
Make sure the correct driver is installed. See 3. Install the Driver on Different Systems.
Ensure your operating system is compatible. See Installing Raspberry Pi OS.
Check that the screen is properly connected to the GPIO pins.
Can I use the 3.5ββ IPS screen together with an HDMI monitor?ο
No. After installing the 3.5ββ IPS screen driver, it is recommended to disconnect the HDMI monitor.
If the HDMI monitor remains connected, it may show a black screen or no display output.
Restore Display to HDMIο
If you only installed the 3.5ββ display driver and did not make other changes to the config.txt file, you can run the following command to restore:
cd LCD-show sudo ./system_restore.sh
After restoration, the 3.5ββ display will no longer work and the driver will need to be reinstalled. This method applies when your system is relatively clean or freshly set up.
If you have also modified the config.txt file, the safest method is to manually edit it:
Run the following command to open the config.txt file:
sudo nano /boot/config.txt
Scroll to the bottom and comment out the changes added by the 3.5ββ display driver:
[all] hdmi_force_hotplug=1 dtparam=i2c_arm=on dtparam=spi=on enable_uart=1 dtoverlay=mhs35ips:rotate=90 hdmi_group=2 hdmi_mode=1 hdmi_mode=87 hdmi_cvt 480 320 60 6 0 0 0 hdmi_drive=2
Press Ctrl+X, then Y, and Enter to save the file and exit.
Then reboot the Raspberry Pi. The HDMI display will work again.
If you want to restore the 3.5ββ display, simply uncomment the lines above.
What if I get git not found or network errors during installation?ο
Make sure your Raspberry Pi is connected to the internet.
If Git is not installed, run:
sudo apt updatesudo apt install git
Then retry the installation.
Why is the screen orientation incorrect?ο
You can fix the screen and touch orientation by running:
cd LCD-show/(adjust the path depending on your OS)sudo ./rotate.sh 90
Replace 90 with 0, 180, or 270 as needed.
Why does the fan keep spinning? Can it be controlled by software?ο
The fan header provides constant 5V power and does not support software control. The fan will always spin when connected.
What is the operating temperature range?ο
The supported operating temperature is -20Β°C to 60Β°C. Avoid exceeding this range to prevent damage or reduced lifespan.
Remote Access Issuesο
ssh: Could not resolve hostname β¦
Check that the hostname is correct.
If it still fails, use the Raspberry Piβs IP address instead of
<hostname>.local.
The term βsshβ is not recognizedβ¦ (Windows)
OpenSSH is not installed. Install it manually (see Install OpenSSH via Powershell), or use a third-party SSH client (see PuTTY).
Permission denied (publickey,password)
Make sure you are using the correct username and password configured in Raspberry Pi Imager.
Connection refused
Wait 1β2 minutes after powering on.
Confirm that SSH is enabled in Raspberry Pi Imager.