Kuman 3.5″ TFT 显示屏在 RetroPie 上安装全步骤指南

概览

Kuman 3.5″ TFT 是树莓派用户热门的高性价比屏幕，尤其适配 RetroPie。不同于 HDMI 显示器，该屏直连树莓派 GPIO 引脚，为模拟站与 DIY 项目提供紧凑方案。以下指南提供可靠、可复现的安装流程，保持系统整洁且功能完整。

前置条件

运行 RetroPie (2018 或更新) 的树莓派。
树莓派联网。
至少 1GB 可用存储空间。
若 RetroPie 安装在 USB 驱动器，运行 sudo raspi-config 选 Expand Filesystem 避免空间不足。
SSH 访问或连接键盘与 HDMI 显示器用于终端操作。

步骤 1 – 下载所需脚本

wget https://raw.githubusercontent.com/adafruit/Raspberry-Pi-Installer-Scripts/master/adafruit-pitft.sh
git clone https://github.com/goodtft/LCD-show.git

第一条命令拉取 Adafruit PiTFT 安装器，第二条克隆 LCD-show 仓库，含管理显示屏的额外工具。

步骤 2 – 赋予脚本执行权限

sudo chmod +x adafruit-pitft.sh
cd LCD-show
sudo chmod +x LCD_35-show
sudo chmod +x LCD-hdmi

LCD-hdmi 脚本允许在需要排查问题时恢复默认 HDMI 输出。

步骤 3 – 运行 Adafruit 安装器

sudo ./adafruit-pitft.sh

按交互提示操作：

选择 4 选 3.5″ TFT 型号。
询问屏幕旋转角度时选合适角度（通常 90 为竖屏模式）。
控制台设置提示选 n 保持 Pi 在控制台模式（或 y 启用 X）。

安装器完成后，树莓派将重启进入新显示配置。

步骤 4 – 验证显示

系统重启后，您应在 Kuman 屏上看到 RetroPie 菜单。若画面花屏或黑屏，复查接线并确保 GPIO 引脚与屏幕手册引脚图一致。

步骤 5 – 恢复 HDMI (可选)

切回 HDMI 只需运行：

sudo ./LCD-hdmi

随后重启树莓派。此命令恢复默认视频输出设置并禁用 TFT 驱动。

故障排查贴士

确保显示屏供电稳定 — 3.5″ 屏峰值电流达 250mA。
若 RetroPie 装在 U 盘，重启前确认 USB 驱动器正确挂载。
检查固件与内核为最新：sudo apt update && sudo apt full-upgrade。

结语

完成以上步骤，您的 Kuman 3.5″ TFT 已完美集成至 RetroPie，带来时尚低轮廓的复古游戏体验。遇到未覆盖问题，请查阅 LCD-show GitHub 仓库或 RetroPie 社区论坛寻求支持。

利用 Azure IoT Edge 模块孪生实现电路状态管理树莓派 3 B+ – 更新特性、规格与选购指南

制造工艺

3D打印

自动化控制系统

工业技术