Hardware: Raspberry Pi 3B/3B+/4B/5

Screen: Osoyoo 3.5″ SPI Touchscreen (480×320)

System: Raspberry Pi OS Bookworm (released before 2025-05-13)

Method: fbcp (Framebuffer Copy)

Reference: https://osoyoo.com/2025/06/04/3-5spibookworm/

Purchase Links:

Table of Contents

• Step 1: Burn OS Image
• Step 2: Connect HDMI
• Step 3: Connect Internet
• Step 4: Get IP Address
• Step 5: Install SPI Screen
• Step 6: Power On
• Step 7: SSH Access
• Step 8: Compile fbcp
• Step 9: Edit config.txt
• Step 10: Auto-start
• Step 11: CLI Auto-login
• Step 12: Configure Touch

1Burn OS Image

Burn the Raspberry Pi OS (Bookworm Version) with desktop to a TF card/micro SD card, and insert this card in your Raspberry Pi.

Download OS from: Raspberry Pi Official Website

2Connect HDMI Monitor

Connect Raspberry Pi to your HDMI monitor or TV. Plug a keyboard and mouse into Raspberry Pi USB ports.

3Connect to Internet

Get the Raspberry Pi connected to the Internet via WiFi or Ethernet.

For WiFi setup guide, visit: Raspberry Pi Basic Tutorial

4Get IP Address

Open terminal and enter the following command:

hostname -I

5Install SPI Screen Hardware

Shut down the Raspberry Pi, remove the HDMI monitor, keyboard and mouse. Then install the 3.5″ SPI screen.

6Power On

Power on the Raspberry Pi with the SPI screen installed.

7SSH Remote Access

Use PuTTY (Windows) or terminal (Mac/Linux) to SSH into Raspberry Pi. PuTTY guide

1. Enter the IP address from Step 4
2. Port: 22
3. Click “Open” and login

8Download and Compile fbcp

Execute via SSH:

sudo apt install libraspberrypi-dev -y
sudo apt-get install unzip cmake -y
sudo wget https://osoyoo.com/driver/osoyoo35b.zip
sudo unzip ./osoyoo35b.zip
sudo cp osoyoo35b.dtbo /boot/overlays/
sudo wget https://osoyoo.com/driver/Rpi-fbcp.zip
sudo unzip ./Rpi-fbcp.zip
cd rpi-fbcp/
sudo rm -rf build
sudo mkdir build
cd build
sudo cmake ..
sudo make -j4
sudo install fbcp /usr/local/bin/fbcp

9Edit config.txt

sudo nano /boot/firmware/config.txt

9a. Comment out this line:

#dtoverlay=vc4-kms-v3d

9b. Add at the END of the file:

# ========== SPI Screen Configuration ==========
dtparam=spi=on
dtoverlay=osoyoo35b:speed=20000000
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
hdmi_cvt 480 320 60 6 0 0 0
hdmi_drive=2
display_rotate=2

Save: Ctrl+X, then Y, then Enter.

10Set Auto-start

10a. Configure .bash_profile

sudo nano ~/.bash_profile

Add the following code:

if [ "$(cat /proc/device-tree/model | cut -d ' ' -f 3)" = "5" ]; then
    # RPi 5B configuration
    export FRAMEBUFFER=/dev/fb1
    startx 2> /tmp/xorg_errors
else
    # Non-Pi5 configuration (RPi 3/4)
    export FRAMEBUFFER=/dev/fb0
    fbcp &
    startx 2> /tmp/xorg_errors
fi

10b. Configure 99-fbturbo.conf (if exists)

sudo nano /usr/share/X11/xorg.conf.d/99-fbturbo.conf

If it exists, ensure content is:

Section "Device"
    Identifier  "Allwinner A10/A13 FBDEV"
    Driver      "fbturbo"
    Option      "fbdev" "/dev/fb0"
    Option      "SwapbuffersWait" "true"
EndSection

11Set CLI Auto-login

sudo raspi-config nonint do_boot_behaviour B2
sudo raspi-config nonint do_wayland W1
sudo reboot

12Configure Touch

After desktop works, connect via SSH and install calibration software:

sudo apt-get install xserver-xorg-input-evdev xinput-calibrator -y
sudo cp -rf /usr/share/X11/xorg.conf.d/10-evdev.conf /usr/share/X11/xorg.conf.d/45-evdev.conf

Create calibration config:

sudo nano /usr/share/X11/xorg.conf.d/99-calibration.conf

Add:

Section "InputClass"
    Identifier "calibration"
    MatchProduct "ADS7846 Touchscreen"
    Option "Calibration" "241 3854 3885 240"
    Option "SwapAxes" "1"
EndSection

Reboot:

sudo reboot

Diagnostic Commands

# Check X Server errors
cat /tmp/xorg_errors

# Check framebuffer devices
ls -l /dev/fb*

# Check if fbcp is running (RPi 3/4)
ps aux | grep fbcp

# Check SPI overlay
dmesg | grep -i osoyoo

Common Errors

cd ~/rpi-fbcp/build && sudo make && sudo install fbcp /usr/local/bin/fbcp

One-Click Setup Script

Save as setup-spi-fbcp.sh and run:

chmod +x setup-spi-fbcp.sh && ./setup-spi-fbcp.sh

#!/bin/bash
echo "=== RPi3/4/5 + Osoyoo 3.5 SPI Screen Setup (fbcp) ==="

sudo apt-get update
sudo apt install libraspberrypi-dev -y
sudo apt-get install -y unzip cmake
cd ~
sudo wget -q https://osoyoo.com/driver/osoyoo35b.zip
sudo unzip -o -q ./osoyoo35b.zip
sudo cp osoyoo35b.dtbo /boot/overlays/
sudo wget -q https://osoyoo.com/driver/Rpi-fbcp.zip
sudo unzip -o -q ./Rpi-fbcp.zip
cd rpi-fbcp/ && sudo rm -rf build && sudo mkdir build && cd build
sudo cmake .. && sudo make -j4 && sudo install fbcp /usr/local/bin/fbcp

cd ~
sudo sed -i 's/^dtoverlay=vc4-kms-v3d/#dtoverlay=vc4-kms-v3d/' /boot/firmware/config.txt

if ! grep -q "osoyoo35b" /boot/firmware/config.txt; then
    sudo tee -a /boot/firmware/config.txt > /dev/null << 'CONF' # ========== SPI Screen Configuration ========== dtparam=spi=on dtoverlay=osoyoo35b:speed=20000000 hdmi_force_hotplug=1 max_usb_current=1 hdmi_group=2 hdmi_mode=1 hdmi_mode=87 hdmi_cvt 480 320 60 6 0 0 0 hdmi_drive=2 display_rotate=2 CONF fi cat > ~/.bash_profile << 'EOF' if [ "$(cat /proc/device-tree/model | cut -d ' ' -f 3)" = "5" ]; then export FRAMEBUFFER=/dev/fb1 startx 2> /tmp/xorg_errors
else
    export FRAMEBUFFER=/dev/fb0
    fbcp &
    startx 2> /tmp/xorg_errors
fi
EOF

sudo raspi-config nonint do_boot_behaviour B2
sudo raspi-config nonint do_wayland W1

sudo apt-get install -y xserver-xorg-input-evdev xinput-calibrator
sudo cp -rf /usr/share/X11/xorg.conf.d/10-evdev.conf /usr/share/X11/xorg.conf.d/45-evdev.conf

sudo tee /usr/share/X11/xorg.conf.d/99-calibration.conf > /dev/null << 'EOF'
Section "InputClass"
    Identifier "calibration"
    MatchProduct "ADS7846 Touchscreen"
    Option "Calibration" "241 3854 3885 240"
    Option "SwapAxes" "1"
EndSection
EOF

echo "=== Setup complete. Rebooting... ==="
sleep 3 && sudo reboot

Choose the tutorial that matches your Raspberry Pi model and OS version:

Not sure which to choose?
• Check your Pi model: cat /proc/device-tree/model
• Check your OS version: cat /etc/os-release

Need help or have feedback? Submit a ticket and our team will get back to you within 1-2 working
days. We appreciate your patience!

Working Time: 9 AM – 6 PM GMT+8 (Monday – Friday)

Contact Us: [email protected]

© 2026 Osoyoo | osoyoo.com

Last updated: 2026-02-10