产品简介

3.5inch RPi LCD (F) 配备320 × 480分辨率的电容触摸屏，支持顶针通信和 GH1.25 13PIN 连接线两种连接方式，并提供树莓派、ESP32、Pico、Arduino等的示例资料。

产品特性

• 320 × 480 分辨率，262K 彩色，能清晰地显示彩色图片
• 触摸屏透过率高，响应快，寿命长
• 内置 ST7796S 驱动芯片和 GT911 电容触控芯片，分别使用 SPI 和 I2C 接口通信，不占用过多接口引脚资源
• 支持顶针通信和 GH1.25 13PIN 连接线两种连接方式
• 采用黑色沉金工艺，美观耐用
• 提供树莓派、树莓派 Pico、ESP32 以及 Arduino 平台的完整例程和开发资料

接口介绍

产品尺寸

产品参数

配置驱动文件

需要先参考此处步骤#安装驱动模块

• 编辑config.txt配置文件

sudo nano /boot/firmware/config.txt

注释掉双屏配置语句

在[all]末尾添加以下语句

dtparam=i2c_arm=on
dtparam=i2c_arm_baudrate=50000
dtparam=spi=on
dtoverlay=Waveshare35f,fps=60,speed=48000000,rotate=90,ts_rotate_90
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 480 320 60 6 0 0 0
hdmi_drive=2

创建屏幕配置文件

创建98-spi-screen.conf文件

sudo nano /etc/X11/xorg.conf.d/98-spi-screen.conf 

添加下面参数到98-spi-screen.conf文件内

Section "Device"
    Identifier "SPI Screen"    
    Driver "fbdev"
    Option "fbdev" "/dev/fb0"
EndSection

注：整个流程操作完成之后。 如果不显示。 修改"/dev/fb0" 为 "/dev/fb1" 之后再重启看看

切换为X11

sudo raspi-config nonint do_wayland W1

重启生效

此方法必须是基于bookworm-lite版本操作，64位 lite、32位 lite

配置驱动文件

需要先参考此处步骤#安装驱动模块

• 编辑config.txt配置文件

sudo nano /boot/firmware/config.txt

注释掉KMS和双屏配置语句

在[all]末尾添加以下语句

dtparam=i2c_arm=on
dtparam=i2c_arm_baudrate=50000
dtparam=spi=on
dtoverlay=Waveshare35f,fps=60,speed=48000000,rotate=90,ts_rotate_90
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 480 320 60 6 0 0 0
hdmi_drive=2

下载必要的软件

• 安装xorg服务

sudo apt-get install --no-install-recommends xserver-xorg -y
sudo apt-get install --no-install-recommends xinit -y

• 安装桌面管理器

sudo apt install lightdm -y

• 安装树莓派官方GUI

sudo apt install raspberrypi-ui-mods -y  

• 安装git

sudo apt install git -y

• 安装浏览器(可选)

sudo apt install chromium-browser -y

• 安装音乐播放器(可选)

sudo apt install vlc -y

下载运行驱动

打开树莓派终端，执行：

sudo apt install libraspberrypi-dev -y
sudo apt-get install unzip -y
sudo apt-get install cmake -y
sudo wget https://www.waveshare.net/w/upload/6/66/Rpi-fbcp.zip
sudo unzip ./Rpi-fbcp.zip
cd rpi-fbcp/
sudo rm -rf build
sudo mkdir -m 777 ./build
cd ./build
sudo cmake ..
sudo make -j4
sudo install fbcp /usr/local/bin/fbcp

设置自启动startx与fbcp

• 打开Bash shell文件，如果没有则自己创建一个

sudo nano ~/.bashrc

把以下代码加到文件末尾

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
    export FRAMEBUFFER=/dev/fb0
    startx  2> /tmp/xorg_errors
fi

• 创建并编辑一个自启动fbcp服务文件

sudo nano /etc/systemd/system/fbcp.service

在文件内添加服务配置

[Unit]
Description=Framebuffer Copy for Raspberry Pi
After=network.target

[Service]
ExecStartPre=/bin/sleep 20
ExecStart=/usr/local/bin/fbcp
Restart=always
User=root
Group=root

[Install]
WantedBy=multi-user.target

重新加载 systemd 配置

sudo systemctl daemon-reload

服务启用开机自启动

sudo systemctl enable fbcp.service

测试启动服务

sudo systemctl start fbcp.service

设置CLI自动登录

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

Note1：确保树莓派的用户名为pi否则无法正常自动登录
Note2：设置上述所有配置后，系统每次重启期间都会变久一点，SSH也需要等待一会儿才能进入；

安装驱动模块

• 确定当前内核版本

uname -a

此命令将输出完整的内核版本信息。例如，在 Raspberry Pi 5 上执行该命令，可能会得到如下输出：

Linux raspberrypi 6.1.21-v8+ #1642 SMP PREEMPT Mon Apr  3 17:24:16 BST 2023 aarch64 GNU/Linux

这表明此系统的内核版本号是6.1.21，使用的是64位ARM（AArch64）架构。

• 下载安装st7796驱动模块

# 第一步：下载并进入Waveshare-st7796s驱动文件夹
wget https://www.waveshare.net/w/upload/4/49/Waveshare-st7796s.zip
unzip Waveshare-st7796s.zip
cd Waveshare-st7796s
 
# 第二步：cd到对应内核版本号文件目录
# 如上面例子则运行下面指令
cd 6.1.21/64/

# 复制对应版本的st7796s.ko到当前系统
sudo cp st7796s.ko /lib/modules/$(uname -r)/kernel/drivers

# 确保模块在开机时被加载，将模块名添加到 /etc/modules 文件中：
sudo nano /etc/modules

# 在末尾添加
st7796s

终端输入以下语句，处理内核模块依赖关系:

sudo depmod -a

• 配置驱动设备树

cd
wget https://www.waveshare.net/w/upload/2/29/Waveshare35f.dtbo
sudo cp Waveshare35f.dtbo /boot/overlays/

配置驱动文件

需要先参考此处步骤#安装驱动模块

• 编辑config.txt配置文件

sudo nano /boot/config.txt

注释掉KMS和双屏配置语句

在[all]末尾添加以下语句

dtparam=i2c_arm=on
dtparam=i2c_arm_baudrate=50000
dtparam=spi=on
dtoverlay=Waveshare35f,fps=60,speed=48000000,rotate=90,ts_rotate_90
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 480 320 60 6 0 0 0
hdmi_drive=2

下载运行驱动

打开树莓派终端，执行：

sudo apt install libraspberrypi-dev -y
sudo apt-get install unzip -y
sudo apt-get install cmake -y
sudo wget https://www.waveshare.net/w/upload/6/66/Rpi-fbcp.zip
sudo unzip ./Rpi-fbcp.zip
cd rpi-fbcp/
sudo rm -rf build
sudo mkdir -m 777 ./build
cd ./build
sudo cmake ..
sudo make -j4
sudo install fbcp /usr/local/bin/fbcp

设置自启动fbcp

• 打开rc.local文件

sudo nano /etc/rc.local

把以下代码加到exit 0前，注意一定要添加"&" 后台运行，否则可能会出现系统不能启动的情况。

sleep 20
fbcp &

重启后生效