丁香医生1. 项目背景与需求解析
去年给工作室配了台树莓派做自动化测试机，结果发现每次调试都要接显示器实在太麻烦。正好手头有个闲置的3.5寸小屏幕，但插上去不是花屏就是没信号。查了三天资料才发现，这种第三方屏幕需要单独配置驱动和分辨率参数。今天就把这套完整的驱动方案整理出来，帮大家避开我踩过的坑。
这种小屏幕在树莓派生态里很常见，主要分三种情况：
- 官方7寸触摸屏（即插即用）
- HDMI接口的第三方屏幕（需调整config.txt）
- SPI/I2C接口的迷你屏（需要编译安装驱动）
我们重点解决最麻烦的第三种情况。这类屏幕通常需要：
- 修改/boot/config.txt配置
- 安装特定显示驱动
- 校准触摸参数
- 设置合适的显示分辨率
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 硬件准备与系统配置
2.1 所需材料清单
- 树莓派3B+/4B（其他型号需验证兼容性）
- 3.5寸SPI接口屏幕（常见型号为XPT2046触摸芯片）
- 16GB以上TF卡
- 5V/2.5A电源（带屏功耗较高）
重要提示：先确认屏幕型号！不同厂商的驱动差异很大，我的方案适用于WaveShare的3.5B型号，其他品牌可能需要调整驱动文件。
2.2 基础系统安装
- 使用Raspberry Pi Imager刷入最新版Raspberry Pi OS Lite（无桌面版更稳定）
- 首次启动后执行：
bash复制sudo apt update && sudo apt full-upgrade -y
sudo raspi-config
- 在配置界面中依次开启：
- 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