基于BeagleBone Black与LEDscape打造64x64双人LED街机全攻略

1. 项目概述与核心思路

几年前，我在一个创客空间里第一次看到那些由32x32 LED面板拼接起来的巨大显示屏，那种粗粝的像素感和鲜艳的色彩瞬间就把我拉回了80年代的街机厅。当时我就想，能不能用这种“复古未来”的显示技术，自己做一台能摆在桌上的双人街机？这个念头在心里盘桓了很久，直到我遇到了BeagleBone Black（BBB）和LEDscape这个项目，才感觉时机成熟了。今天要分享的，就是这台基于4块32x32 LED面板、BeagleBone Black主板，以及一套街机摇杆按钮打造的64x64分辨率双人桌面街机。它不只是一台游戏机，更是一个融合了嵌入式系统、底层驱动、硬件焊接和结构设计的综合性项目。

这个项目的核心目标很明确：用尽可能“原生”和直接的方式，驱动一个64x64像素的RGB LED显示阵列，并为其配上完整的双人街机控制台和音频系统。为什么选择BBB和LEDscape？市面上能驱动HUB75接口LED面板的方案不少，比如树莓派加专用转接板。但BBB独有的可编程实时单元（PRU）是关键。PRU是一个独立于主CPU的小型协处理器，能实现纳秒级的精准硬件定时，这对于驱动LED面板这种对时序要求极其苛刻的设备来说是绝配。LEDscape正是利用PRU来生成控制信号，从而把主CPU解放出来专心跑游戏逻辑和音频。整个系统跑在Debian Linux上，你可以用C++甚至Python来写游戏，开发体验和普通的嵌入式Linux应用没太大区别。

2. 核心硬件选型与物料清单解析

动手之前，理清每一件物料为什么选它、以及可能遇到的坑，能省下大量时间和冤枉钱。这份清单是我反复试错后的总结，但务必注意，这不是一个“套件”，不同批次或供应商的零件可能存在细微差异，可能需要你灵活调整。

2.1 核心控制器与显示单元

• BeagleBone Black (Rev B或C)：项目的“大脑”。选择BBB而非树莓派，核心原因就是其PRU。主频1GHz的ARM Cortex-A8处理器负责运行游戏系统和逻辑，而两个PRU则被LEDscape用来生成驱动LED面板的精确时序脉冲。一个重要提示：为了腾出足够的GPIO引脚来驱动LED面板和摇杆，我们必须禁用BBB板载的HDMI和eMMC存储。这意味着系统必须从MicroSD卡启动，所以一张高速、可靠的MicroSD卡是必需品。
• 32x32 RGB LED矩阵面板 (4mm点间距) x 4块：这是项目的“脸面”。务必选择HUB75接口的型号。4mm点距在观看距离30-50厘米时，像素感清晰又不至于太粗糙。关键点：尽量购买同一批次的面板。我踩过的坑是，不同批次甚至不同厂商的面板，其RGB信号线的顺序（即HUB75接口的引脚定义）可能存在“绿蓝互换”或其他排列差异。如果混用，会导致颜色完全错乱。购买时最好向卖家确认，或准备好在软件层面调整颜色映射。
• BeagleBone原型扩展板 (Proto Cape)：BBB的GPIO引脚是2.54mm间距的排针，我们需要一个载体来将控制信号（LED数据、摇杆输入）规整地引出。原型扩展板就是干这个的。建议选择带“堆叠”接头（即母座+排针）的型号，这样以后还能在上面插别的模块做调试。

2.2 控制与交互部件

• 街机摇杆 x 2：选择经典的4向或8向微动开关摇杆。注意安装孔的尺寸，需要与后续的亚克力开孔匹配。
• 街机按钮 x 10：包括玩家1、2的“开始”按钮，以及每人两个“动作”按钮。我选用了带灯圈的款式，为了在5V系统下获得足够的亮度，必须将原装的12V灯泡更换为6V规格的，成本很低，效果提升显著。
• USB音频适配器：BBB板载音频输出能力有限，且引脚已被占用。一个独立的USB声卡是更可靠的选择。经验之谈：务必选择Linux免驱（如C-Media芯片组）的型号，避免内核兼容性问题。

2.3 电源与结构件

• 5V/10A直流电源：这是整个系统的动力核心。4块LED面板全亮时电流惊人，加上BBB、声卡和按钮灯，峰值电流可能达到7-8A。一个额定10A的电源能提供充足余量，避免过热或电压跌落导致显示闪烁。
• 电源分配方案：这里有两个主流选择，我称之为“方法A”和“方法B”。
  • 方法A（我用的是这种）：使用一个10位接线端子排，配合短路片将多个端子并联成+5V和GND两组总线。优点是成本低，布局紧凑，所有电源接口集中在一块板上。缺点是需要自己压接或焊接母插片。
  • 方法B（更规整）：使用两块Adafruit的电源分配总线板，一块专用于+5V，一块专用于GND。优点是接线美观，螺丝固定更可靠。缺点是占用空间稍大，且需要更长的连接线。
• 亚克力板 (1/4英寸厚)：用于切割出显示面板的固定架、底座和控制器面板。1/4英寸（约6.35mm）的厚度提供了足够的结构强度来承载LED面板和摇杆的反复操作。你需要准备一块12x12英寸的用来做显示面板支架，一块24x18英寸的用来切割底座和控制器。

2.4 连接线与杂项

• 16芯IDC排线 (18英寸和4英寸)：用于连接BBB扩展板到第一块LED面板，以及面板之间的级联。排线是“插座到插座”类型，并且一定要带防呆键，防止插反烧毁面板。
• 杜邦线、焊锡、热缩管：用于扩展板上的飞线焊接。建议使用不同颜色的22-26AWG规格线材，便于后期调试区分信号。
• 各种规格的螺丝、螺母、垫片和尼龙支柱：用于固定LED面板到亚克力支架、固定亚克力部件到底座，以及作为整机的支撑脚。具体规格和数量在切割图纸中会有体现，但手边多备一些不同长度的M3、M4螺丝和垫片总是好的，装配时经常需要微调。

重要提醒：在订购任何零件，特别是需要激光切割的亚克力件之前，强烈建议你先通读整个制作指南，并尽可能拿到实物进行比划和测试。我自己的“零件坟场”（一堆用不上或不匹配的零件）就是盲目下单的结果。先订一部分核心件，确认尺寸和接口，再订下一批，虽然慢点，但更稳妥。

3. 扩展板（Cape）的焊接与信号定义

这是整个项目硬件部分最需要耐心和细心的环节。扩展板是我们连接BBB与外部世界（LED面板和摇杆）的桥梁，所有信号线都从这里引出。

3.1 扩展板基础组装

首先，将两排46针（总共92针）的排针或堆叠接头焊接到BBB原型扩展板上。如果你用的是堆叠接头（母座在上，排针在下），建议先将扩展板反过来，把接头插入焊盘孔中，用胶带临时固定，再从背面焊接，这样能保证所有针脚绝对垂直。焊完后，务必用万用表的通断档，逐一检查每个焊盘与对应引脚是否连通。我当初偷懒跳过了这一步，后来调试信号时多花了好几个小时排查一个虚焊点。

3.2 LED面板接口焊接

根据LEDscape的驱动要求，我们需要使用BBB的特定GPIO引脚来输出LED面板的控制信号。这些信号包括RGB数据、时钟、锁存和输出使能等。以下是我在项目中验证过的引脚连接表，你需要在扩展板的空闲区域焊接一个16针的单排母座，并按此表连接：

焊接实操要点：

1. 线序确认：上表是标准HUB75引脚定义。但正如之前提到的，你的面板可能需要调整R、G、B的顺序。最稳妥的方法是，在后续“冒烟测试”时，如果颜色不对，参考Adafruit那篇关于HUB75排线的文章，尝试交换RGB线的连接顺序。
2. 飞线技巧：使用不同颜色的细导线（如26AWG单芯线）。焊接前先给扩展板焊盘和导线头上锡。焊接时使用尖头烙铁，速度要快，避免热量堆积导致焊盘脱落。每焊好一根，就用万用表检查连通性。
3. 防呆标记：在16芯排线插到扩展板的一端，用马克笔在红色线（第1针）对应的扩展板位置做个标记，确保每次插入方向一致。

3.3 摇杆与按钮接口焊接

摇杆和按钮本质都是连接到GPIO的数字输入设备（内部上拉或下拉）。我们需要为两个玩家分别焊接一组导线。为了调试方便，我建议先在扩展板上焊接两排多针脚的排母，再将摇杆/按钮的线焊到杜邦头上插入，这样后期更换或测试会灵活很多。以下是引脚定义：

玩家1控制接口：

• 上：P8_38 (GPIO2_15)
• 下：P8_44 (GPIO2_9)
• 左：P8_41 (GPIO2_10)
• 右：P8_42 (GPIO2_11)
• 主动作键：P8_39 (GPIO2_12)
• 副动作键：P8_40 (GPIO2_13)
• 1P开始：P8_45 (GPIO2_6)
• 2P开始：P8_46 (GPIO2_7)

玩家2控制接口：

• 上：P8_35 (GPIO0_8)
• 下：P8_31 (GPIO0_10)
• 左：P8_33 (GPIO0_9)
• 右：P8_34 (GPIO2_17)
• 主动作键：P8_32 (GPIO0_11)
• 副动作键：P8_36 (GPIO2_16)

重要警告：上述用于摇杆的GPIO引脚，在BBB默认配置中可能被HDMI、eMMC或其他功能占用。因此，在后续的软件配置中，必须彻底禁用这些功能，否则系统可能无法启动或摇杆输入失灵。

3.4 音频与电源接口

音频部分相对简单：从扩展板的+5V和GND焊盘各引出一根线，备用给USB声卡供电（虽然声卡通常从USB取电，但这里提供一路电源更灵活）。电源部分，则需要从扩展板的5V和GND焊盘引出较粗的导线（建议18AWG），连接到我们即将制作的电源总线上，为整个扩展板供电。

4. 系统软件配置与LEDscape部署

硬件准备就绪后，我们需要为BBB准备一个“大脑”——操作系统和驱动软件。整个过程在命令行下完成，需要一些Linux基础操作知识。

4.1 准备系统与升级

1. 写入Debian镜像：从BeagleBoard官网下载最新的Debian（如“Buster”或“Bullseye”）镜像。使用balenaEtcher或dd命令将其写入一张至少4GB的MicroSD卡。切记：由于我们要禁用eMMC，系统将完全从这张SD卡运行，因此卡的速度和可靠性至关重要，建议使用Class 10或更高规格的卡。
2. 首次启动与网络：将SD卡插入BBB，通过USB线连接电脑和BBB。BBB会模拟成一个网络设备，你可以通过浏览器访问192.168.7.2或使用SSH（ssh debian@192.168.7.2，默认密码temppwd）登录。首先配置无线或有线网络，确保BBB可以访问互联网以下载软件包。
3. 系统升级：登录后，首先更新软件源并升级所有包。虽然最新的Debian镜像可能已满足要求，但执行一次全面升级是个好习惯：

   sudo apt update sudo apt dist-upgrade sudo reboot

4.2 关键系统配置：释放GPIO引脚

这是让LEDscape和摇杆正常工作的前提。我们需要编辑启动配置文件，禁用与所需GPIO冲突的板载设备。

1. 禁用HDMI与eMMC：编辑/boot/uEnv.txt文件。

   sudo nano /boot/uEnv.txt

   找到包含cape_disable的行（可能被注释），修改或添加如下内容：

   cape_disable=capemgr.disable_partno=BB-BONELT-HDMI,BB-BONELT-HDMIN,BB-BONE-EMMC-2G

   这行配置禁用了HDMI显示和板载eMMC存储器，从而释放出P8和P9口上大量被占用的GPIO引脚供我们使用。保存并退出。

2. 配置USB音频为首选设备：默认情况下，系统可能优先识别板载音频（即便已禁用）。我们需要告诉ALSA（Linux声音系统）优先使用USB声卡。创建或编辑/etc/modprobe.d/alsa-base.conf文件：

   sudo nano /etc/modprobe.d/alsa-base.conf

   在文件末尾添加一行：

   options snd-usb-audio index=0

   这强制将第一个检测到的USB音频设备设置为索引0（默认设备）。保存并退出。

4.3 获取与编译LEDscape

LEDscape是一个专门为BBB PRU编写的LED矩阵驱动库。我们使用一个已经为4块32x32面板配置好的分支。

1. 克隆代码库：

   cd ~ git clone https://github.com/KeithHenrickson/LEDscape.git cd LEDscape

   这个仓库是原版LEDscape的一个分支，预配置了本项目所需的64x64面板布局和引脚定义。

2. 编译：

   make

   编译过程会生成LEDscape驱动、几个示例游戏，以及最重要的——两个“设备树覆盖层”文件（.dtbo）。这些文件会在系统启动时自动加载，将BBB的PRU和GPIO配置成驱动LED面板所需的模式。编译时可能会有一些警告，但只要没有错误（error）就问题不大。

3. 启用开机自启：为了让游戏在BBB启动后自动运行，我们需要安装一个systemd服务。

   sudo cp bin/ledscape.service /etc/systemd/system/ sudo systemctl enable ledscape.service

   现在先不要启动它，因为我们还没有连接硬件。

5. 电源系统构建与“冒烟测试”

在把所有东西装进漂亮的亚克力外壳之前，我们必须进行一次全面的“冒烟测试”（即通电测试），确保每个核心模块都能独立工作，避免装好后发现问题无从下手。

5.1 构建电源总线（以方法A为例）

我采用接线端子排的方案，因为它集成度高。你需要一个10位的端子排、若干短路片（跳线帽）、母插片和相应规格的电线。

1. 准备输入线：剪裁4段约30厘米长的18AWG电线，2红（正极），2黑（负极）。剥开两端绝缘层。
2. 连接DC母座：将两根红线插入5.5/2.1mm DC母座的正极（中心孔）接线端，拧紧。两根黑线插入负极（外侧）接线端，拧紧。务必确保正负极没有短路。
3. 制作总线：将两根红线的另一端一起压入一个适合16-14AWG的母插片并压紧。同样处理两根黑线。将红色插片端子插入端子排的第1位，黑色插片端子插入第5位。
4. 并联端子：使用短路片，将端子排的1-2-3-4位连接起来（形成+5V总线），将5-6-7-8位连接起来（形成GND总线）。第9和10位空置。
5. 连接BBB电源：取一根约20厘米的红线和黑线，焊接到一个DC公头上（对应BBB的电源接口）。另一端压上母插片，分别插入端子排上空闲的+5V和GND位（例如第2位和第6位）。
6. 初步测试：先不要连接任何负载。将5V/10A电源适配器插入DC母座，用万用表测量端子排上任意一个+5V和GND端子之间的电压，应为稳定的5V左右。同时检查+5V总线与GND总线之间没有短路。

5.2 连接LED面板进行测试

这是最激动人心也最紧张的一步，因为LED面板相对脆弱。

1. 连接数据线：将18英寸的16芯排线一端插入扩展板的LED连接器，确保红线朝向扩展板上有标记或缺口的一侧。另一端插入右下角那块LED面板的输入接口（通常标有“IN”）。然后用4英寸的排线，按右下->左下->右上->左上的顺序，将四块面板的“OUT”连接到下一块的“IN”，形成一条菊花链。
2. 连接电源线：每两块面板共用一组电源线（红黑各一）。将这两组线分别接到端子排的+5V和GND上。
3. 连接BBB：将扩展板小心地插到BBB上，对齐所有引脚，均匀用力按下。将DC公头插入BBB电源口。暂时不要插USB线。
4. 连接USB声卡：将其插入BBB的USB口。
5. 上电测试：接通电源适配器。BBB的指示灯应开始闪烁启动。等待约1分钟让系统完全启动。
6. 运行测试程序：通过SSH连接到BBB，进入LEDscape目录，运行：

   sudo bin/run-ledscape

   等待约10秒，你应该会看到LED面板亮起，并显示一个简单的游戏画面（比如“打砖块”的片段）。如果屏幕全亮、闪烁、颜色错乱或没反应，请立即断电检查。
   • 全亮/闪烁：检查数据线是否插反、接触不良，或OE（输出使能）信号连接错误。
   • 颜色错乱：很可能是RGB信号顺序不对。参考之前提到的文章，尝试在软件配置或硬件连接上交换R、G、B线的顺序。
   • 没反应：检查电源是否接通，数据线是否连接到正确的输入口，以及BBB是否已正常启动并加载了设备树覆盖层。

6. 机械结构制作：亚克力切割与组装

测试通过后，就可以为这套电子系统打造一个坚固又美观的“家”了。激光切割亚克力是理想选择。

6.1 文件准备与切割

在LEDscape代码仓库的acrylic目录下，提供了两个CorelDraw (.cdr) 文件：

• LedMount-*.cdr：用于切割固定4块LED面板的支架。需要一块12x12英寸的1/4英寸厚亚克力。
• LedBasePlate-*.cdr：用于切割底座、两个控制面板以及其他所有结构件。需要一块24x18英寸的1/4英寸厚亚克力。

切割前至关重要的步骤：务必拿到所有需要安装在亚克力上的硬件实物，特别是摇杆、按钮、螺丝、支柱。用游标卡尺精确测量它们的安装孔直径、孔距以及底座尺寸。与CDR文件中的设计进行比对。我当初就因为按钮的规格略有不同，导致开孔小了1毫米，不得不返工重切。

6.2 LED显示模块组装

1. 面板定位：将四块LED面板屏幕朝下平放在桌面，按2x2排列，彼此紧靠。将切割好的LED支架亚克力板（有 etched 引导线的一面朝下）盖在面板上。
2. 对齐与预固定：亚克力板上的开孔比面板的螺丝孔稍大，这是为了留出微调对齐的空间。使用M3螺丝和垫片，先用手将四角的大概位置固定，但不要拧紧。
3. 精细对齐：接通电源，运行测试程序。此时你会看到显示画面，但可能因为面板间有缝隙或错位，导致图像在接缝处不连续。在通电状态下，轻轻滑动或微转每块面板，直到64x64的整个画面看起来横平竖直，接缝处的图像连贯。这是一个需要耐心和细心的过程。
4. 最终固定：对齐满意后，逐步拧紧所有M3螺丝，拧紧过程中要时刻注意面板位置是否因受力而移动。可以在螺丝和亚克力之间加一个小垫片，防止拧紧时压裂亚克力。
5. 连接内部线缆：使用4英寸排线，将已经固定好的左右两块面板在中间连接起来。然后用18英寸排线，从右下角面板的“输出”连接到左下角面板的“输入”。最后，将另一根18英寸排线从扩展板的LED端口连接到右下角面板的“输入”。再次检查所有排线的方向（红线位置）。

6.3 控制面板与总装

1. 按钮改装：将街机按钮底部的灯座旋开，取出原装的12V灯泡，替换为6V灯泡。这样在5V供电下才能达到正常亮度。
2. 安装控制器：将摇杆和按钮按照设计图安装到切割好的控制面板亚克力上。从背面用螺母固定。
3. 内部布线：这是最繁琐的步骤。你需要用足够长的导线，将每个摇杆的4个方向微动开关和每个按钮的触点，连接到之前焊接在扩展板上的对应引脚。同时，所有设备的GND线也需要汇接到扩展板的GND上。建议使用不同颜色的线，并用标签或热缩管做好标记。强烈建议在焊接前，用万用表通断档测试每根线。
4. 总装：将LED显示模块、装有BBB和扩展板的“电子舱”、电源总线、控制面板等所有部件，按设计安装到底座亚克力板上。使用不同长度的尼龙支柱将各层隔开，既保持结构稳固，又为线缆留出空间。最后，在底座底部贴上橡胶脚垫。

7. 系统集成、调试与游戏体验

当所有硬件组装完毕，再次上电，系统应该能自动启动并运行默认游戏。如果一切顺利，恭喜你，一台独一无二的双人LED街机已经诞生！

7.1 最终系统检查

1. 电源稳定性：在全白画面（最耗电）时，用手触摸电源适配器和端子排，不应有过热现象。用万用表测量LED面板供电端的电压，不应低于4.8V。
2. 输入测试：进入游戏后，测试每个摇杆方向和按钮是否响应准确、无粘连。可以在LEDscape的示例程序中找一个简单的输入测试画面。
3. 音频测试：插入耳机或连接有源音箱到USB声卡的输出口，检查游戏音效是否正常播放。

7.2 添加你自己的游戏

LEDscape项目自带几个示例游戏（如Bricks）。它的框架已经搭建好，你完全可以在此基础上用C++开发新游戏。游戏逻辑主要写在main.cpp之类的文件中，通过帧缓冲区向LEDscape提交图像，并通过读取/dev/input/eventX或直接读取GPIO状态来获取控制输入。

1. 了解代码结构：研究ledscape.c和示例游戏代码，理解如何初始化显示、绘制像素、播放声音。
2. 编译与替换：将你的游戏代码放在apps/目录下，修改Makefile，然后make编译。将生成的可执行文件替换掉默认的自启动服务指向的文件。
3. 音效与资源：简单的音效可以使用sox等工具生成头文件嵌入代码，或直接播放WAV文件。

7.3 常见问题与排查实录

• 问题：上电后BBB无法启动，或启动后LED屏乱码。

  • 排查：首先检查是否为供电不足。拔掉所有LED面板的电源线，仅给BBB供电，看能否正常启动并通过SSH登录。如果能，则问题在电源。确保你的电源适配器能提供足额10A电流，并且所有电源接头接触良好，线径足够粗（建议18AWG）。
  • 排查：检查/boot/uEnv.txt中的cape_disable设置是否正确。错误的设置可能导致关键GPIO冲突，系统无法启动。
  • 排查：检查扩展板与BBB的连接是否完全插紧，有无引脚弯曲或错位。

• 问题：显示画面有重影、拖尾或亮度不均。

  • 排查：这是典型的时序问题。LEDscape的配置文件（config.c或.dts文件）中有关于时钟频率、OE极性、颜色深度等的参数。不同面板可能需要微调这些参数。参考LEDscape官方文档，尝试调整pru-clock、color-depth等值。
  • 排查：检查OE（输出使能）信号线是否连接正确且可靠。OE信号控制着LED的消隐时间，对消除鬼影至关重要。

• 问题：某个摇杆方向或按钮无响应。

  • 排查：用万用表通断档，在按钮按下/摇杆拨动时，测量对应GPIO引脚与GND之间是否导通。如果不导通，检查按钮焊接、导线连接。
  • 排查：在BBB上，使用cat /sys/class/gpio/gpioXX/value命令（XX为GPIO编号）手动读取引脚状态，看是否随按键变化。如果不变化，可能是该GPIO被其他功能占用，回顾系统配置步骤。

• 问题：USB声卡无声音或系统识别不到。

  • 排查：运行aplay -l和arecord -l命令，查看声卡是否被列出。如果没有，检查声卡是否插好，或尝试更换一个已知兼容的型号。
  • 排查：检查/etc/modprobe.d/alsa-base.conf配置是否正确。可以尝试在文件中添加options snd-usb-audio index=-2先禁用，再改回index=0，然后重启。

这个项目从构思到完成，花费了我大量的业余时间，也报废了不少零件。但当你看到自己编写的简陋小游戏在两个摇杆的控制下，在那片由4096个LED点构成的粗糙而鲜艳的世界里运行时，那种成就感是无可替代的。它不仅仅是一台游戏机，更是一个关于底层硬件交互、实时系统、机械设计和问题解决的完整实践。希望这份详细的记录，能帮你绕过我踩过的那些坑，顺利点亮属于你自己的那一片像素星空。