基于树莓派Zero与Fusion 360的复古掌机DIY全流程指南

1. 项目概述：打造一台属于你自己的复古掌机

如果你和我一样，对童年时那些像素风游戏念念不忘，同时又对动手制作电子设备充满热情，那么这个项目就是为你准备的。我们将一起从零开始，打造一台完全自定义的复古手持街机。它不仅仅是把游戏机装进一个盒子里，而是从外壳的每一道弧线、每一个按钮的位置，到内部系统的每一个配置，都由你亲手设计和实现。整个过程融合了3D建模、嵌入式系统开发和一点点的硬件焊接，最终你会得到一台独一无二、承载着你个人印记的游戏设备。

这个项目的核心是Raspberry Pi Zero，一块信用卡大小的微型电脑，它负责运行RetroPie游戏模拟器系统。而设备的“身体”，也就是外壳和按钮，则通过Fusion 360进行3D建模并打印出来。为什么选择这个组合？因为它的灵活性极高。你不再受限于市面上成品掌机的固定外形和布局，可以根据自己手掌的大小、喜欢的按键手感，甚至是钟爱的某款游戏机的美学风格，来设计专属的外壳。无论是想复刻Game Boy的经典，还是创造一种全新的未来感造型，Fusion 360都能帮你实现。

整个流程可以清晰地分为三个部分：首先是“造壳”，用Fusion 360设计并3D打印出所有结构件；其次是“造芯”，配置Raspberry Pi Zero的软件系统并连接所有硬件；最后是“组装与调试”，将软硬件结合，解决那些必然会遇到的小问题。即使你之前没有3D建模或树莓派的使用经验，只要跟着步骤一步步来，并注意我后面会详细提到的那些“坑”，成功完成它绝对是一次充满成就感的体验。接下来，我们就从最基础的准备工作开始，拆解每一个环节。

2. 核心工具与材料解析：为什么是它们？

在开始动手之前，理解我们选择的每一件工具和材料的背后原因至关重要。这不仅能帮助你在采购时做出正确判断，还能在遇到问题时，知道从哪个环节去排查。

2.1 主控核心：Raspberry Pi Zero 的选型考量

为什么是Pi Zero，而不是功能更强大的Pi 3B+或Pi 4？这完全是由项目需求决定的。我们的目标是制作一台便携、低功耗、紧凑的手持设备。Pi Zero W（带无线模块的版本）尺寸极小（65mm x 30mm），功耗极低（满载约1-1.5W），且性能足以流畅运行RetroPie系统下的绝大多数8位、16位乃至部分32位游戏机模拟器（如FC、SFC、MD、GBA、PS1等）。Pi 3B+或Pi 4性能固然更强，能模拟更多平台，但其更大的尺寸、更高的发热和功耗（需要主动散热和更大电池），对于追求极致便携和续航的手持设备来说，反而是负担。Pi Zero的GPIO引脚数量（40针）也完全足够连接我们计划中的屏幕、按钮和电源。

注意：务必购买Raspberry Pi Zero W或Zero 2 W。原始的Pi Zero（不带W）没有无线模块，这意味着你将无法通过Wi-Fi传输游戏ROM文件，每次添加游戏都需要插拔SD卡，极其不便。Zero 2 W性能更强，但价格也稍高，对于经典游戏模拟而言，Zero W已完全够用。

2.2 设计利器：Fusion 360 在创客项目中的优势

你可能听说过Tinkercad、FreeCAD或Blender，但我强烈推荐使用Fusion 360进行本项目的外壳设计，尤其是它的个人免费授权（用于非商业用途）对爱好者非常友好。原因有三点：参数化设计、装配体功能和社区生态。

参数化设计意味着你画的不是固定的形状，而是由尺寸、约束关系定义的“智能草图”。当你觉得手柄部分太厚时，不需要用鼠标一点点去推拉，只需修改一个“厚度”参数，所有相关联的零件（如外壳、内部支撑柱）都会自动更新。这在反复迭代设计时能节省巨量时间。装配体功能允许你将屏幕、主板、按钮当作单独的“零件”导入，并在虚拟空间中精确地组装起来，检查它们之间是否有干涉（比如螺丝柱是否顶到了屏幕排线），确保打印出来的零件能严丝合缝地拼装。

最后，Fusion 360拥有庞大的用户社区和丰富的教程资源。你在设计卡壳时，很容易找到解决方案。本项目提供的STL文件可以作为你学习的起点，但我鼓励你打开它们，尝试修改按钮布局、增加防滑纹理，甚至为外壳添加个性化的浮雕图案，这才是DIY的精髓。

2.3 关键外设：屏幕与按钮的选购要点

屏幕的选择直接决定了游戏的视觉体验和设备的整体厚度。项目推荐使用的是一款2英寸IPS液晶屏，分辨率通常为320x240。这里有几个关键参数需要关注：

1. 接口：必须选择SPI接口的屏幕，而非HDMI。SPI屏只需要连接寥寥几根线（电源、地、时钟、数据、命令/数据选择、复位），极大地简化了布线，也节省了GPIO资源。HDMI屏需要Pi Zero通过mini HDMI口输出，这会占用宝贵空间，且需要额外的转接板。
2. 驱动芯片：常见的有ILI9341、ST7789等。这决定了后续我们需要安装的驱动程序（如fbcp-ili9341）。购买时务必向卖家确认驱动芯片型号。
3. 供电电压：大部分这类小屏幕是3.3V或5V供电。Pi Zero的GPIO引脚输出是3.3V逻辑电平，所以最好选择3.3V供电的屏幕，以避免电平转换的麻烦。

至于按钮，我们需要的是一种瞬时开关、常开型、带帽的微动开关。通常选择12mm或16mm直径的。你需要购买两种：一种用于方向键（D-pad），一种用于功能键（A, B, X, Y等）。方向键通常使用一个“四向开关”或四个独立的微动开关配合一个十字键帽。购买时注意开关的“手感”（触发行程和压力克数），这会影响游戏操作体验。建议购买口碑较好的品牌，如Sanwa或Seimitsu的兼容款，虽然稍贵，但手感和使用寿命远非廉价开关可比。

3. 从零开始：Fusion 360 外壳设计与建模实战

拿到所有零件后，先别急着焊接。我们首先需要在电脑上完成虚拟的“装配”，确保所有物理零件都能完美地放进我们设计的外壳里。这个过程能避免昂贵的打印材料浪费。

3.1 建立设计基准与导入参考模型

打开Fusion 360，新建一个设计。我建议的第一个步骤不是直接画草图，而是导入参考模型。你可以从供应商网站或开源社区找到Raspberry Pi Zero、所选屏幕和按钮的STEP或STP格式的3D模型（很多制造商都会提供）。将这些模型作为“非参数化”的参考体导入到你的设计中。

为什么要这么做？这能保证你的设计是精确的。你可以测量Pi Zero上螺丝孔的真实距离（通常是58mm x 23mm），屏幕PCB的精确尺寸和排线位置，按钮的直径和安装柱高度。以这些实物模型为基准进行设计，能最大程度避免打印出来后装不进去的尴尬。将Pi Zero模型放置在你设想的位置（通常是主板中部），并以此为中心，规划电池仓、屏幕腔和按钮布局。

3.2 主体外壳的参数化建模流程

主体外壳通常分为上盖（Top）和下盖（Base）。我们从下盖开始。

1. 创建底板草图：新建一个草图平面，绘制一个能包裹所有内部元件（主板、电池、屏幕驱动板）的矩形轮廓。使用“偏移”工具，向内偏移2mm（这是典型的外壳壁厚），生成内轮廓。将外轮廓拉伸（Extrude）15-20mm，形成基础实体。
2. 添加内部结构：这是设计的精髓。使用“拉伸”命令中的“切割”模式，在底板内部挖出放置主板、电池和屏幕的空间。然后，使用“拉伸”中的“新建实体”模式，在主板螺丝孔对应位置创建四个圆柱体作为螺丝柱。螺丝柱的内径要略小于你使用的自攻螺丝直径（例如，用M2.5螺丝，柱子内孔可设计为2.0mm），让螺丝能自己“啃”进去，形成牢固连接。螺丝柱的高度要确保主板安装后，其背面的元件不会触碰到底板。
3. 设计按钮孔：在底板顶部平面上，根据你规划的按钮布局，绘制圆形草图（直径比按钮本体大0.2-0.3mm，预留安装间隙），然后拉伸切割穿透。对于方向键，需要切割一个“十字形”或“圆形”开口。
4. 创建上盖：上盖的设计要与下盖完美契合。最可靠的方法是直接“派生”（Derive）下盖的轮廓到新组件中，然后在其基础上进行修改。上盖需要开出屏幕窗口（尺寸比屏幕可视区略小，以形成边框）、扬声器孔（如果你计划加入）以及与下盖对接的卡扣或螺丝孔位。
5. 设计按钮键帽：键帽是用户直接接触的部分，设计要考虑人体工学。A/B/X/Y等功能键可以设计为凸面球帽，方向键则设计为十字或圆盘状。键帽底部需要有一个“十字柱”或“圆柱”，其尺寸要能紧密套在微动开关的按键柱上（通常有1-2mm的过盈配合）。键帽的高度要确保按下时能有效触发开关，且在自然状态下不会与其他部件摩擦。

3.3 3D打印前的检查与切片设置

设计完成后，使用Fusion 360的“分析”菜单下的“干涉检查”功能，将所有零件（外壳、主板、屏幕、按钮）在虚拟装配体中检查一遍，确保没有任何重叠（红色高亮显示）。

将每个需要打印的零件（下盖、上盖、各个键帽、按钮固定架等）分别导出为STL文件。接下来使用切片软件（如Cura、PrusaSlicer）进行准备。

• 打印材料：推荐使用PETG或ABS。PLA虽然容易打印，但耐热性和韧性较差，在手掌温度下可能轻微变形，且长期使用易脆裂。PETG在强度、韧性和耐热性上取得了很好的平衡，且打印气味小。
• 打印方向：将外壳开口面朝下放置打印。这样，内部的螺丝柱、卡扣等关键结构能获得最好的层间结合力。虽然外壳外表面朝上会看到层纹，但我们可以通过后期打磨处理。
• 支撑结构：对于外壳内部的螺丝柱、以及上盖的屏幕窗口内侧，通常需要生成支撑。在切片软件中启用“仅从构建板生成支撑”或“树状支撑”，以减少与模型本体的接触面积，便于拆除。
• 层高与填充：层高0.2mm可以获得不错的表面质量。填充密度建议在25%-30%，以平衡强度和重量。外壳壁厚至少设置2mm，关键受力部位（如螺丝柱）可以增加到3-4mm。

4. 软件系统搭建：RetroPie配置与驱动安装详解

当3D打印机开始工作时，我们就可以同步进行软件部分的准备了。这部分的核心是让Raspberry Pi Zero变成一个专业的游戏机。

4.1 RetroPie系统镜像的烧录与基础配置

首先，从RetroPie官网下载适用于Raspberry Pi Zero/Zero W的镜像文件。注意，一定要选择ARMv6架构的版本（通常标注为Pi0/0W/1），Pi Zero 2 W则选择ARMv7版本。使用树莓派官方的Raspberry Pi Imager工具进行烧录是最稳妥的方法。

1. 在Imager中，选择“操作系统” -> “RetroPie” -> 对应的版本。
2. 选择你的SD卡（建议至少16GB，Class 10以上速度）。
3. 在烧录前，点击齿轮图标进行高级设置，这是关键一步！在这里你可以预先配置：
   • 设置主机名：如retropie-handheld。
   • 开启SSH：勾选“启用SSH”，方便后续无线连接调试。
   • 配置Wi-Fi：填入你的Wi-Fi SSID和密码。这样系统首次启动时就会自动连接网络。
   • 设置地区设置：时区选择Asia/Shanghai。
4. 点击“烧录”，等待完成。

将SD卡插入Pi Zero，连接电源（暂时用USB线连接电脑或充电宝即可）和HDMI显示器（首次启动需要）。系统会自动扩展文件系统并重启。首次启动会进入EmulationStation前端界面。此时，你需要连接一个USB手柄或键盘进行初始配置（设置语言、配置输入设备）。按照屏幕提示，为第一个控制器（也就是你的键盘或手柄）映射按键。

4.2 GPIO控制器配置：让物理按钮生效

系统启动后，我们需要告诉RetroPie，那些连接在GPIO引脚上的物理按钮应该被识别为什么按键。这里我们使用一个非常优秀的工具：RetroPie GPIO驱动。

1. 从EmulationStation主界面，按F4退出到命令行。或者，如果你预先配置了Wi-Fi，可以通过SSH连接（用户名pi，默认密码raspberry）。
2. 运行RetroPie的配置工具：sudo ~/RetroPie-Setup/retropie_setup.sh
3. 在菜单中选择“Manage Packages” -> “Manage Driver Packages” -> “gpio”相关的驱动。通常有一个叫gpio或gamecond的包。安装它。
4. 安装完成后，返回主菜单，进入“Configuration / tools” ->gpio（或类似选项）。这里会启动一个按键映射程序。
5. 根据屏幕提示，依次按下你连接在GPIO上的每一个按钮（上、下、左、右、A、B、X、Y、选择、开始等）。程序会记录下每个按钮对应的GPIO引脚号，并自动生成配置文件。
6. 完成后重启EmulationStation：sudo systemctl restart emulationstation

现在，你的物理按钮应该可以控制菜单了。如果某个按钮没反应，检查焊接是否虚焊，或者返回gpio配置工具重新映射。

4.3 SPI屏幕驱动编译与安装：替代HDMI输出

这是整个软件部分最具挑战性但也最有趣的一环。我们需要一个程序，将系统原本输出到HDMI的帧缓冲（Framebuffer）内容，复制到SPI屏幕上。fbcp-ili9341就是这个“复制器”。

1. 通过SSH登录到你的Pi Zero。
2. 安装必要的编译工具和库：

   sudo apt-get update sudo apt-get install -y cmake libfreenect-dev libusb-1.0-0-dev

3. 克隆fbcp-ili9341的代码库（确保你的Pi Zero已联网）：

   cd ~ git clone https://github.com/juj/fbcp-ili9341.git cd fbcp-ili9341

4. 创建并进入一个构建目录，然后运行cmake。这里有一个关键参数必须根据你的屏幕型号修改：

   mkdir build cd build cmake -DSPI_BUS_CLOCK_DIVISOR=20 -DILI9341=ON ..

   -DILI9341=ON表示你的屏幕驱动芯片是ILI9341。如果是ST7789，则可能是-DST7789=ON。请务必查阅你屏幕的产品说明书。-DSPI_BUS_CLOCK_DIVISOR=20设置了SPI总线速度，数值越小越快，但太快可能导致花屏，20是一个比较保守稳定的值。
5. 编译并安装：

   make -j sudo ./fbcp-ili9341

   如果编译成功且屏幕点亮并显示内容（可能是命令行或RetroPie界面），恭喜你！但此时程序在前台运行，按Ctrl+C会停止。我们需要让它开机自启。
6. 设置开机自启。编辑系统服务文件：

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

   写入以下内容：

   [Unit] Description=Framebuffer copy service for SPI LCD After=graphical.target [Service] Type=simple ExecStart=/home/pi/fbcp-ili9341/build/fbcp-ili9341 Restart=always User=pi [Install] WantedBy=multi-user.target

   保存退出（Ctrl+X，然后按Y，回车）。然后启用并启动这个服务：

   sudo systemctl enable fbcp.service sudo systemctl start fbcp.service

   重启树莓派，屏幕应该能自动点亮并显示。

5. 硬件组装与焊接：从零散部件到完整设备

当所有打印件冷却固化，软件也准备就绪后，最令人兴奋的硬件组装阶段就开始了。请准备好电烙铁、焊锡丝、助焊剂、万用表（用于通断测试）和一套精细的螺丝刀。

5.1 电路规划与GPIO引脚分配

在动烙铁之前，必须在纸上或脑海里规划好每个部件连接到Pi Zero的哪个GPIO引脚。混乱的接线是后期调试的噩梦。Pi Zero的40针GPIO引脚定义是标准的。以下是一个经典的分配方案，你可以根据自己的按钮数量调整：

重要提示：每个按钮开关都有两个引脚。我们将其中一个引脚连接到上表指定的GPIO信号引脚，另一个引脚全部并联，连接到Pi Zero的任何一个GND（接地）引脚。这种接法称为“共地接法”，是树莓派GPIO输入的标准方式。同时，务必在Pi Zero的3.3V和5V电源引脚上并联一个100μF以上的电解电容，以平滑电源，防止按钮操作时引起的电压波动导致系统重启。

5.2 焊接工艺与线材管理

焊接质量直接决定了设备的可靠性。对于微动开关和排针，建议使用尖头烙铁，温度设置在320°C-350°C。

1. 焊接按钮：将杜邦线（母对公）的母头剪掉，露出线芯。先将线芯上锡，然后在微动开关的引脚上也上一点锡。将线头与引脚对齐，用烙铁头同时加热两者，待焊锡熔化流动后移开烙铁，形成一个光滑的圆锥形焊点。为每根信号线套上不同颜色的热缩管，并在焊接前就标记好对应的功能（如“上”、“A键”），这将为后续排查节省大量时间。
2. 连接屏幕：SPI屏幕通常自带排线或排针。如果是排针，可以直接用杜邦线（公对公）连接。确保连接牢固，顺序完全正确。最稳妥的方法是，对照屏幕说明书和你的接线表，用万用表的蜂鸣档，逐根线检查从Pi Zero引脚到屏幕焊盘是否导通。
3. 电源管理：如果你计划使用电池供电（如一块3.7V的锂电池配合一个5V升压模块），务必在电源模块的输出端（5V）和Pi Zero的5V引脚之间加入一个微型滑动开关，用于物理断电。长期不用时，断开开关可以防止电池过放。

5.3 机械组装步骤与技巧

按照设计顺序进行组装，通常是从内到外：

1. 安装螺丝柱和屏幕：将打印好的螺丝柱用一点CA胶（快干胶）粘在底壳的对应位置。然后将屏幕模块放入底壳的卡槽或通过其自身的螺丝孔固定。在屏幕背面和底壳之间贴一小块双面胶或海绵胶，既能减震又能防止屏幕移位。
2. 固定主板：将Raspberry Pi Zero对准底壳的螺丝柱，用短的自攻螺丝（长度不要超过螺丝柱高度+主板厚度）固定。确保主板平整，GPIO排针朝向预留给按钮接线的方向。
3. 布置按钮与接线：将微动开关从底壳内部放入对应的安装孔，从外部用配套的螺母锁紧。然后将所有按钮的信号线，按照之前的规划，整齐地插到Pi Zero的GPIO排针上。使用扎线带或胶水固定点将多余的线材捆扎好，避免其散落并可能被运动部件挤压。
4. 安装电池：如果使用电池，将其放入预留的电池仓。用绝缘胶带或尼龙扎带固定，防止晃动。将电池的供电线连接到升压模块，再将升压模块的输出连接到Pi Zero的5V和GND引脚。务必确认极性正确！
5. 最终合盖：在合上上盖之前，最后一次检查所有接线是否牢固，有无线头可能被外壳压住。将上盖对准下盖的卡扣或螺丝孔位，轻轻压下。如果设计有螺丝孔，用螺丝固定。如果设计的是卡扣，听到清脆的“咔嗒”声即表示到位。

6. 系统调优与游戏体验提升

设备组装完成并能启动后，工作只完成了一半。接下来的调优决定了它是一台“能玩”的设备，还是一台“好玩的”设备。

6.1 RetroPie高级配置与美化

进入EmulationStation后，按“开始”键可以进入主菜单。

• 添加游戏ROM：最方便的方式是通过网络。确保你的设备连上了Wi-Fi。从电脑浏览器访问\\RETROPIE（Windows）或smb://retropie（Mac），你会看到一个名为roms的共享文件夹。将你的游戏ROM文件（如.nes,.smc,.gb等）拖拽到对应的模拟器文件夹内（如nes,snes,gb）。回到设备上，重启EmulationStation或选择“重启游戏列表”，游戏就会出现。
• 配置视频与音频：对于不同的模拟器，可以单独优化设置。在游戏列表中，按“选择”键（不是开始键）选中一个游戏，选择“游戏设置”，可以配置这个游戏或整个系统的视频分辨率、着色器（Shader，用于模拟CRT扫描线等效果）、帧率限制等。对于Pi Zero，建议保持默认或选择轻量级的着色器，以免性能不足。
• 安装主题：默认主题可能比较朴素。进入RetroPie-Setup工具，在“Manage Packages” -> “Manage Experimental Packages”中，可以找到很多社区制作的精美主题，如pixel、carbon等。安装后，在EmulationStation的UI设置中切换即可。

6.2 性能优化与超频设置（谨慎操作）

Pi Zero的性能有限，为了确保某些较耗资源的游戏（如部分PS1游戏）运行流畅，可以进行小幅超频。超频有风险，可能造成系统不稳定或损坏硬件，需自行承担风险。通过SSH编辑配置文件：sudo nano /boot/config.txt在文件末尾添加以下几行：

# 超频设置 arm_freq=1050 gpu_freq=350 over_voltage=2 force_turbo=1

• arm_freq: CPU频率，默认1000，提升到1050。
• gpu_freq: GPU频率。
• over_voltage: 核心电压微调，有助于稳定。
• force_turbo: 强制开启高性能模式。 保存后重启。观察系统是否稳定，运行高负载游戏测试。如果出现死机、花屏，请降低频率或移除这些设置。务必确保设备散热良好，可以在Pi Zero的芯片上贴一小块散热片。

6.3 续航管理与低功耗技巧

对于手持设备，续航至关重要。

• 选择高效电池：推荐使用容量在2000mAh以上的3.7V锂电池。配合一个高效的5V升压模块（转换效率>90%）。
• 优化软件功耗：
  1. 关闭未使用的接口：编辑/boot/config.txt，可以添加dtparam=audio=off来禁用板载音频（如果你使用USB声卡或GPIO音频），用dtoverlay=pi3-disable-bt禁用蓝牙（Pi Zero W）。
  2. 降低屏幕亮度：如果屏幕支持PWM调光，可以通过软件降低亮度。或者在屏幕的背光供电线上串联一个100-200欧姆的电阻来物理降亮。
  3. 配置待机：虽然RetroPie没有完美的睡眠模式，但你可以设置短时间无操作后自动关闭屏幕背光（如果屏幕支持）。或者养成不用时直接物理开关断电的习惯。
• 实时监控电量：可以添加一个简单的电压检测模块，连接到Pi Zero的某个ADC引脚（需外接ADC芯片，如ADS1115），并编写一个小脚本在屏幕上显示近似电量百分比。

7. 故障排除与常见问题实录

无论准备多么充分，实际制作中总会遇到问题。下面是我在多次制作中遇到的一些典型问题及其解决方法，希望能帮你快速排雷。

7.1 屏幕相关问题

问题1：屏幕一片空白或白屏。

• 检查电源：首先用万用表测量屏幕的VCC和GND引脚是否有3.3V电压。没有则检查接线。
• 检查驱动：确认fbcp-ili9341服务正在运行：sudo systemctl status fbcp.service。查看日志是否有错误：sudo journalctl -u fbcp.service -f。
• 检查SPI启用：运行sudo raspi-config，进入Interface Options->SPI，确保SPI已启用（Enable）。
• 检查接线顺序：这是最常见的问题。务必逐根核对MOSI、SCLK、DC、CS、RST引脚是否与代码中的定义和物理连接完全一致。特别是DC和RST线，接反了会导致无显示。

问题2：屏幕有显示但花屏、闪烁或偏移。

• 降低SPI速度：回到编译fbcp-ili9341的步骤，在cmake命令中增加-DSPI_BUS_CLOCK_DIVISOR=24或更大的数值（如30），重新编译安装。时钟分频数越大，SPI速度越慢，稳定性越高。
• 检查电源干扰：屏幕供电线路可能受到数字信号干扰。在屏幕的VCC和GND引脚之间焊接一个10μF的陶瓷电容和一个0.1μF的瓷片电容，可以很好地滤除高频噪声。
• 调整屏幕参数：有些屏幕可能需要初始化参数微调。查阅fbcp-ili9341的源码目录，可能有针对不同屏幕的配置文件示例，需要你修改源码中的初始化序列并重新编译。

7.2 按钮输入问题

问题3：某个或所有按钮无反应。

• 检查接地：90%的按钮问题源于接地不良。确保所有按钮的第二个引脚都可靠地连接到了同一个GND引脚，并且这个GND引脚与Pi Zero的GND连通。用万用表蜂鸣档测量按钮引脚对地电阻，按下时应接近0欧姆。
• 检查GPIO驱动：运行gpio readall命令，查看你定义的按钮引脚状态。按下按钮时，对应的引脚状态应从1变为0。如果状态不变，是硬件问题（接线、焊接）；如果状态变化但游戏没反应，是软件配置问题。
• 检查RetroPie配置：重新运行GPIO控制器配置工具（sudo ~/RetroPie-Setup/retropie_setup.sh，找到对应驱动配置），确认按键映射正确。有时配置文件可能损坏，可以尝试删除后重新配置：rm /opt/retropie/configs/all/retroarch.cfg（注意这会重置所有RetroArch设置）。

问题4：按钮出现“鬼键”或串键（按A键B键也有反应）。

• 软件去抖：在RetroArch的输入设置中，可以增加“输入去抖延迟”。进入RetroArch设置（游戏中按选择+X呼出菜单），选择Settings->Input->Input Polling Rate，尝试调高一点。
• 硬件滤波：这是更根本的解决方法。在每个按钮的信号线和地线之间焊接一个0.1μF的瓷片电容，可以有效地滤除机械触点抖动产生的毛刺信号。

7.3 系统与性能问题

问题5：系统启动后卡在彩虹屏或命令行。

• 检查电源：Pi Zero对电源非常敏感。使用质量差的充电宝或线径太细的USB线，会导致启动时电压跌落而失败。确保使用5V 2A以上的电源，并尽量缩短USB线长度。已安装的设备功耗过大也可能导致此问题，尝试断开屏幕和所有外设，看能否正常启动。
• 检查SD卡：SD卡损坏或接触不良是常见原因。重新拔插SD卡，或在电脑上用树莓派Imager工具重新烧录一遍系统。
• 检查超频：如果你进行了超频设置，请暂时注释掉/boot/config.txt中的超频参数，重启试试。

问题6：运行游戏时卡顿、掉帧或声音爆音。

• 选择合适模拟器：对于GBA游戏，lr-gpsp核心比lr-mgba更节省资源。对于PS1游戏，lr-pcsx-rearmed是唯一选择，在其核心选项里可以尝试关闭“增强分辨率”（Enhanced Resolution）和“跳帧”（Frame Skip）来提升速度。
• 降低渲染负载：在RetroArch视频设置中，关闭“垂直同步”（VSync），开启“硬同步”（Hard GPU Sync），并降低“硬同步帧数”（如设置为1）。关闭所有复杂的着色器（Shader），使用最简单的“bilinear”过滤即可。
• 监控温度：运行vcgencmd measure_temp查看CPU温度。如果持续高于80°C，可能会触发降频。确保设备通风，必要时在芯片上添加散热片。

完成所有这些步骤后，你得到的将不仅仅是一台游戏机。从无到有的设计、调试、解决问题的过程，其价值远超设备本身。每一次按下自己设计的按键，看到的游戏画面通过自己编译的驱动显示在自己建模打印的外壳里，这种完整的创造闭环带来的满足感，是购买任何成品都无法比拟的。如果第一次尝试有不如意的地方，比如觉得手柄握持感不好，或者某个按键手感生涩，这正是Fusion 360参数化设计的用武之地——修改几个尺寸，重新打印那个零件，很快就能得到改进版。这就是DIY项目的魅力，它永远没有真正的“终点”，而是一个不断优化、融入个人想法和风格的持续过程。