树莓派3.5寸SPI屏幕驱动安装与配置指南

1. 项目背景与需求解析

去年给工作室配了台树莓派做自动化测试机，结果发现每次调试都要接显示器实在太麻烦。正好手头有个闲置的3.5寸小屏幕，但插上去不是花屏就是没信号。查了三天资料才发现，这种第三方屏幕需要单独配置驱动和分辨率参数。今天就把这套完整的驱动方案整理出来，帮大家避开我踩过的坑。

这种小屏幕在树莓派生态里很常见，主要分三种情况：

• 官方7寸触摸屏（即插即用）
• HDMI接口的第三方屏幕（需调整config.txt）
• SPI/I2C接口的迷你屏（需要编译安装驱动）

我们重点解决最麻烦的第三种情况。这类屏幕通常需要：

1. 修改/boot/config.txt配置
2. 安装特定显示驱动
3. 校准触摸参数
4. 设置合适的显示分辨率

2. 硬件准备与系统配置

2.1 所需材料清单

• 树莓派3B+/4B（其他型号需验证兼容性）
• 3.5寸SPI接口屏幕（常见型号为XPT2046触摸芯片）
• 16GB以上TF卡
• 5V/2.5A电源（带屏功耗较高）

重要提示：先确认屏幕型号！不同厂商的驱动差异很大，我的方案适用于WaveShare的3.5B型号，其他品牌可能需要调整驱动文件。

2.2 基础系统安装

1. 使用Raspberry Pi Imager刷入最新版Raspberry Pi OS Lite（无桌面版更稳定）
2. 首次启动后执行：

bash复制sudo apt update && sudo apt full-upgrade -y
sudo raspi-config

3. 在配置界面中依次开启：
   • SPI接口（Interface Options > SPI > Yes）
   • I2C接口（同路径下）
   • 自动登录（System Options > Boot / Auto Login）

3. 驱动安装全流程

3.1 配置文件修改

编辑/boot/config.txt：

bash复制sudo nano /boot/config.txt

在文件末尾添加：

code复制dtparam=spi=on
dtoverlay=waveshare35b:rotate=270
hdmi_force_hotplug=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 480 320 60

参数说明：

• rotate=270 表示屏幕旋转270度（根据实际安装方向调整）
• hdmi_cvt 设置自定义分辨率（480x320@60Hz）
• waveshare35b 对应特定屏幕的覆盖驱动

3.2 安装触摸驱动

克隆驱动仓库并安装：

bash复制git clone https://github.com/waveshare/LCD-show.git
cd LCD-show/
sudo ./LCD35B-show

安装完成后会提示重启，此时屏幕应该能正常显示但触摸可能还不准。

3.3 触摸校准

执行校准工具：

bash复制sudo apt install xinput-calibrator
xinput_calibrator

按照屏幕提示依次点击四个角的光标，完成后会生成校准参数。将这些参数添加到/usr/share/X11/xorg.conf.d/99-calibration.conf：

code复制Section "InputClass"
    Identifier      "calibration"
    MatchProduct    "ADS7846 Touchscreen"
    Option  "Calibration"   "160 3903 3896 160"
    Option  "SwapAxes"      "1"
EndSection

具体数值以你的校准结果为准。

4. 常见问题解决方案

4.1 屏幕闪烁/花屏

• 检查电源是否达标（建议用万用表测量GPIO 5V引脚电压>4.8V）
• 尝试在config.txt添加：

  code复制core_freq=250
  core_freq_min=100
  

• 更换质量更好的SPI排线

4.2 触摸偏移

• 重新运行xinput_calibrator
• 检查/etc/X11/xorg.conf.d/目录下是否有多个触摸配置文件
• 尝试调整SwapAxes值为0

4.3 高CPU占用

SPI屏幕会占用较多资源，建议：

bash复制sudo nano /etc/rc.local

在exit 0前添加：

code复制/usr/bin/tvservice -o

关闭HDMI输出以节省资源。

5. 进阶优化技巧

5.1 自定义启动画面

1. 安装fbi帧缓冲查看器：

bash复制sudo apt install fbi

2. 将640x480的bmp图片放入/home/pi/
3. 创建服务：

bash复制sudo nano /etc/systemd/system/splashscreen.service

内容为：

code复制[Unit]
Description=Splash Screen

[Service]
ExecStart=/usr/bin/fbi -d /dev/fb0 --noverbose -a /home/pi/splash.bmp
StandardOutput=null

[Install]
WantedBy=multi-user.target

5.2 低功耗模式配置

对于电池供电场景：

bash复制sudo nano /boot/config.txt

添加：

code复制# 降低GPU内存
gpu_mem=16
# 关闭蓝牙/WiFi（根据需要）
dtoverlay=disable-bt
dtoverlay=disable-wifi

这套方案在工作室的10台树莓派上稳定运行了半年多，关键是三点：选对驱动版本、做好电源滤波、校准文件别放错位置。如果遇到黑屏别慌，按住Shift键启动可以跳过加载驱动进入安全模式。