1. 项目概述：为连接而生的辅助技术游戏

在嵌入式开发领域，我们常常醉心于实现复杂的功能和炫酷的效果，但有时，一个项目的真正价值，恰恰在于它用最简单的交互，解决了最真实的需求。今天分享的这个项目，源于我在波士顿学院校园学校的一次深度合作。这所学校服务于有广泛辅助需求的学生，在与校长的交流中，我意识到，现有的辅助技术多聚焦于学生与辅助人员（如助教）之间的互动，而学生彼此之间的社交连接，却存在一个未被充分满足的空白。

于是，一个想法诞生了：为什么不创造一个能让两位学生并肩合作或友好竞争的小装置呢？它必须足够简单、直观，又能带来纯粹的快乐。这就是“双人堆叠游戏”的起点。它的核心玩法直白得惊人：两位玩家各自面前有一条由10颗LED组成的灯带和一个特制的大按钮。每按一次按钮，自己灯带上的光点就会向上“堆叠”一格。谁先让自己的10颗LED全部亮起，谁就获胜，随后装置会播放一段庆祝音乐，并自动重置，等待下一轮游戏。

这个看似简单的设计背后，是一系列深思熟虑的可访问性考量：为了照顾视障学生，我们采用了高对比度的黑色哑光表面来衬托鲜艳的LED灯光；为了适配使用自适应座椅的学生，整个设备被设计成垂直站立式，方便从正面平视和操作；为了确保游戏既有趣又不令人沮丧，我们反复测试，优化了“点击次数”与“堆叠反馈”之间的比例，让每一次按压都带来明确、即时的成就感。自设备投入使用以来，已有数十名学生成功体验并享受了它带来的互动乐趣，这让我深感一切努力都是值得的。接下来，我将从设计思路、硬件搭建、代码实现到调试心得，完整拆解这个项目的每一个环节。

2. 核心设计思路与可访问性考量

2.1 需求分析与设计目标确立

任何成功的嵌入式项目都始于清晰的需求分析，而对于辅助技术设备，这一点尤为重要。我们不能仅仅从技术实现的角度思考，而必须将最终用户的能力、局限和使用场景放在首位。通过与校园学校专家的访谈，我明确了几个核心设计目标：

  1. 促进同伴互动 ：设备的核心使命是成为学生之间社交的“破冰器”和“连接器”。因此，它必须是双人参与的，并且互动规则要简单到无需语言解释就能理解。
  2. 确保物理与感知可访问性 ：
    • 视觉 ：考虑到部分学生可能存在低视力或视觉感知障碍，必须提供极高的视觉对比度。我们决定使用纯黑色、不反光的亚克力板作为背景，让彩色LED成为唯一且突出的视觉焦点。
    • 操作 ：学生可能存在精细运动控制困难。因此，输入设备不能是小型按键或需要精确瞄准的传感器。我们选用了专为有限行动能力人群设计的大面积、低阻力按钮，只需用手掌、手臂甚至辅助工具轻触即可触发。
    • 姿态 ：许多学生使用轮椅或特制座椅。因此，设备不能是平放在桌上的，而应是一个垂直的“站姿”装置，确保学生坐在椅子上时，能够以舒适的视角平视LED灯带，并轻松够到按钮。
  3. 提供平衡的挑战与反馈 ：游戏不能太简单而无聊，也不能太难而挫败。关键在于设计一个合理的“进度-反馈”循环。我们通过控制LED灯带的总数（10颗）和每次按键点亮一颗的规则，创造了一个明确、可量化的目标。玩家能清晰看到自己离胜利还有多远，这种即时、累积的正反馈是维持参与度的关键。

2.2 技术栈选型：为何是Arduino与CircuitPython？

在明确了“做什么”之后，下一个关键决策是“用什么做”。我选择了 Arduino微控制器 搭配 CircuitPython 编程语言，这是一个兼顾了可靠性、开发效率和学习曲线的组合。

  • Arduino微控制器 ：作为嵌入式领域的常青树，Arduino拥有无与伦比的生态和稳定性。其GPIO（通用输入输出）引脚驱动LED灯带、读取按钮状态绰绰有余。更重要的是，其硬件设计成熟，供电和信号处理都非常稳定，这对于需要长时间可靠运行的校园设备至关重要。
  • CircuitPython ：这是本项目的“灵魂”所在。与传统的Arduino C++相比，CircuitPython具有巨大优势：
    • 极低的编程门槛 ：它的语法非常接近标准Python，简洁易懂。对于教育者和未来可能想修改项目的人来说，学习成本极低。你甚至可以在设备连接电脑后，直接像操作U盘一样编辑代码文件，无需复杂的编译上传流程。
    • 丰富的内置库 ：CircuitPython原生支持对NeoPixel（一种智能LED）的完美控制，以及音频文件的播放，这让我们实现彩色灯效和播放获胜音乐变得异常简单，几乎只需几行代码。
    • 交互式开发 ：通过串行REPL（交互式解释器），可以实时测试代码片段，调试硬件状态，这大大加快了开发迭代的速度。

这个组合确保了项目既具备工业级的可靠性，又拥有脚本语言的灵活与易用性，特别适合应用于快速原型开发和教育科技领域。

2.3 硬件架构设计

整个系统的硬件架构围绕清晰的数据流和电源管理展开。核心控制单元是Arduino板，它负责处理所有逻辑。两个大型限动按钮分别连接到两个数字输入引脚，并启用内部上拉电阻，这样按钮未按下时引脚读为高电平，按下时接地变为低电平，Arduino便能检测到“按下”动作。

输出部分分为两路：一是两个LED灯带。这里我选择了 WS2812B 智能LED（常被称为NeoPixel），它的每个灯珠都集成了驱动芯片，只需一根数据线即可串联控制数十上百颗灯，极大地简化了布线。两条各10颗的灯带分别连接到Arduino的两个不同的数字输出引脚。二是音频输出，通过一个简单的数字模拟转换器或直接使用支持PWM音频的引脚连接一个小型扬声器，用于播放获胜音效。

整个系统的供电需要仔细考量。LED灯带在全部点亮时耗电较大，尤其是两颗灯带同时高亮度显示时。因此，我选择了一个大容量的便携手机充电宝作为电源，它既能提供5V稳定电压，又有足够的电流容量（建议2A以上），确保系统运行稳定，不会因为电压骤降导致Arduino重启或LED颜色异常。

3. 硬件搭建与结构制作详解

3.1 材料清单与工具准备

一份清晰的物料清单是成功的第一步。以下是构建整个装置所需的核心材料与工具：

电子元件清单：

  1. 微控制器 ：Arduino Uno 或 Leonardo 1块（选择带有足够数字IO引脚且CircuitPython支持良好的型号）。
  2. LED灯带 ：WS2812B (NeoPixel) 灯带，每条约10颗，共2条。注意购买5V工作电压的型号。
  3. 输入设备 ：大型限动按钮 2个。务必选择触感清晰、行程适中、易于按压的款式。
  4. 音频输出 ：小型扬声器（8欧姆，0.5W-1W）1个，或使用带放大功能的喇叭模块。
  5. 连接与供电 ：
    • 面包板 1块（用于原型搭建和测试）。
    • 杜邦线（公对公、公对母）若干。
    • 鳄鱼夹线 8个（用于快速、可靠地连接按钮和电源）。
    • 便携充电宝（5V/2A输出）1个。
    • USB数据线（为Arduino供电和编程）1根。
  6. 结构材料 ：
    • 黑色亚克力板或致密塑料板（约3mm厚），用于制作主体框架和面板。
    • 塑料胶水或亚克力专用胶。

工具清单：

  1. 切割工具 ：勾刀、美工刀，用于精确切割亚克力板。
  2. 焊接工具 ：电烙铁、焊锡丝、助焊剂，用于永久性连接电线与LED灯带、按钮。
  3. 表面处理 ：黑色喷漆（如果塑料板不是黑色），用于营造无反射的哑光背景。
  4. 辅助工具 ：尺子、标记笔、螺丝刀、热熔胶枪（可选，用于内部固定）。

3.2 电路连接与焊接要点

在将一切装入外壳前，强烈建议先在面包板上完成完整的电路原型测试。这是排查硬件问题的黄金阶段。

连接步骤：

  1. 供电总线 ：在面包板上建立5V（正极）和GND（负极）两条电源总线。将充电宝的USB线剪开（或使用USB转接线），红色线接5V总线，黑色线接GND总线。
  2. 连接Arduino ：将Arduino的 5V 和 GND 引脚分别连接到面包板的5V和GND总线。
  3. 连接LED灯带 ：
    • 每条WS2812B灯带都有三个引脚： 5V 、 GND 、 DIN （数据输入）。
    • 将两条灯带的 5V 和 GND 分别并联到电源总线上。 特别注意 ：为避免压降，建议从电源总线直接引较粗的导线供电，而不是全部依赖面包板的小铜条。
    • 将第一条灯带的 DIN 引脚连接到Arduino的某个数字引脚（例如引脚 6 ）。
    • 将第二条灯带的 DIN 引脚连接到Arduino的另一个数字引脚（例如引脚 7 ）。
  4. 连接按钮 ：
    • 每个按钮有两脚或四脚（内部两两连通）。任选一侧的两个引脚。
    • 将第一个按钮的一个引脚用导线连接到Arduino的某个数字引脚（例如引脚 2 ），将同一按钮的另一个引脚连接到 GND 。
    • 在Arduino代码中，将引脚 2 的模式设置为 INPUT_PULLUP （启用内部上拉电阻）。这样，按钮未按下时，引脚通过内部电阻接到 5V ，读取为 HIGH ；按下时，引脚直接接地，读取为 LOW 。
    • 第二个按钮同理，连接到另一个数字引脚（如引脚 3 ）和 GND 。
  5. 连接扬声器 ：如果使用无源扬声器，可以连接到Arduino的支持模拟输出的引脚（如DAC引脚，在Uno上可用数字引脚 9 配合PWM模拟音频）。更稳定的方法是使用一个简单的音频放大模块（如LM386），将Arduino的音频信号放大后驱动扬声器。

焊接与固化： 原型测试无误后，就需要将连接永久化。使用鳄鱼夹线连接按钮和主控板是一个好方法，它比焊接更灵活，也便于后期维护。但对于LED灯带的电源线和数据线，建议进行焊接，并使用热缩管绝缘，以确保长时间使用的可靠性。将所有元件用扎带或热熔胶固定在面包板或一块副板上，使内部整洁牢固。

3.3 外壳设计与制作

外壳不仅是美观，更是实现可访问性设计的关键。

  1. 设计 ：使用CAD软件（如Fusion 360）或直接在纸上绘制草图。设计一个垂直的箱体，正面板分为三个区域：上方左右并列两个透明窗口，用于展示LED灯带；下方左右放置两个大按钮开孔。背面设计可打开的舱门，方便检修。
  2. 材料切割 ：根据设计图纸，用尺子和勾刀在黑色亚克力板上精确划出轮廓，然后小心掰断或用激光切割机切割（如果条件允许）。用美工刀和砂纸打磨边缘，防止割手。
  3. 喷漆处理 ：如果材料本身不是哑光黑，需要进行喷漆。选择哑光黑色喷漆，在通风处薄薄地、均匀地喷涂多层，每层干透后再喷下一层，以获得平整无光的表面。
  4. 组装 ：使用塑料胶水或亚克力胶水将箱体的各个面板粘合。先将LED灯带用双面胶或螺丝固定在正面板背后的对应窗口位置。然后将装有Arduino和线路的副板固定在箱体内部。最后将按钮从正面板的开孔中穿出，在内部用螺母固定。确保所有线缆留有适当余量，不会因拉扯而脱落。
  5. 最终集成 ：关闭后盖前，再次通电测试所有功能。确认无误后，用螺丝固定后盖。一个坚固、美观、专业的辅助技术游戏设备就制作完成了。

4. CircuitPython代码实现解析

代码是项目的灵魂，它定义了交互的逻辑和体验。这里我们使用CircuitPython来编写，其简洁性将体现得淋漓尽致。

4.1 开发环境搭建与库安装

首先，你需要将你的Arduino板刷入CircuitPython固件。访问CircuitPython官网，找到对应你主板型号的 .uf2 固件文件。通常操作方式是：将主板置于Bootloader模式（如双击Arduino Uno R3上的复位按钮），此时它会作为一个U盘出现，将下载的 .uf2 文件拖入该U盘，主板会自动重启并运行CircuitPython。

重启后，电脑上会出现一个名为 CIRCUITPY 的U盘。这就是你的“代码硬盘”。你需要安装必要的库。将 adafruit_neopixel.mpy 库文件（用于控制LED灯带）和 adafruit_audioio 等相关音频库文件（如果需要高级音频处理）复制到 CIRCUITPY 盘的 lib 文件夹内。如果只是播放简单的WAV文件，CircuitPython的内置功能可能已足够。

4.2 主程序逻辑与状态机

游戏的核心是一个状态机，它管理着“等待开始”、“玩家1操作”、“玩家2操作”、“判断胜利”、“庆祝”、“重置”等状态。下面是一个高度概括的代码框架，并附有详细注释。

# 导入必要的库
import board
import digitalio
import neopixel
import time
import audioio
import audiocore

# 1. 硬件引脚定义
BUTTON_P1_PIN = board.D2  # 玩家1按钮
BUTTON_P2_PIN = board.D3  # 玩家2按钮
PIXEL_P1_PIN = board.D6   # 玩家1灯带数据引脚
PIXEL_P2_PIN = board.D7   # 玩家2灯带数据引脚
# 假设音频通过板载DAC引脚A0输出
SPEAKER_PIN = board.A0

# 2. 初始化硬件对象
# 初始化按钮，设置为输入模式并启用内部上拉电阻
button_p1 = digitalio.DigitalInOut(BUTTON_P1_PIN)
button_p1.direction = digitalio.Direction.INPUT
button_p1.pull = digitalio.Pull.UP  # 启用上拉，未按下时为True

button_p2 = digitalio.DigitalInOut(BUTTON_P2_PIN)
button_p2.direction = digitalio.Direction.INPUT
button_p2.pull = digitalio.Pull.UP

# 初始化NeoPixel灯带，每条10颗灯珠
NUM_PIXELS = 10
pixels_p1 = neopixel.NeoPixel(PIXEL_P1_PIN, NUM_PIXELS, brightness=0.5, auto_write=False)
pixels_p2 = neopixel.NeoPixel(PIXEL_P2_PIN, NUM_PIXELS, brightness=0.5, auto_write=False)

# 初始化音频输出
audio = audioio.AudioOut(SPEAKER_PIN)

# 3. 游戏全局变量
p1_score = 0
p2_score = 0
game_active = True  # 游戏是否正在进行
winner = None       # 获胜者：None, “P1”, “P2”

# 4. 加载胜利音效
# 将“For_Boston.wav”文件放在CIRCUITPY根目录下
try:
    wave_file = open("For_Boston.wav", "rb")
    wave = audiocore.WaveFile(wave_file)
except OSError:
    print("找不到音频文件！")
    wave = None

# 5. 辅助函数
def reset_game():
    """重置游戏状态"""
    global p1_score, p2_score, game_active, winner
    p1_score = 0
    p2_score = 0
    game_active = True
    winner = None
    # 清空灯带
    pixels_p1.fill((0, 0, 0))
    pixels_p2.fill((0, 0, 0))
    pixels_p1.show()
    pixels_p2.show()
    print("游戏已重置！")

def update_led_strip(pixels, score):
    """根据分数更新指定灯带的显示"""
    # 先全部关闭
    pixels.fill((0, 0, 0))
    # 点亮从底部开始的score颗灯珠，例如用绿色表示
    for i in range(score):
        pixels[i] = (0, 255, 0)  # RGB绿色
    pixels.show()

def play_victory_sound():
    """播放胜利音效"""
    if wave and audio:
        audio.play(wave)
        # 阻塞等待播放完成，或者可以设置为非阻塞并在主循环中检查
        while audio.playing:
            pass

# 6. 主循环
print("双人堆叠游戏就绪！")
reset_game() # 初始重置

while True:
    # 只有在游戏进行中才检测按钮
    if game_active:
        # 检测玩家1按钮（按下时为False，因为上拉到True）
        if not button_p1.value:
            time.sleep(0.05)  # 简单防抖延时
            if not button_p1.value:  # 再次确认
                p1_score += 1
                print(f"玩家1得分: {p1_score}")
                update_led_strip(pixels_p1, p1_score)
                # 等待按钮释放，避免连续触发
                while not button_p1.value:
                    pass
                time.sleep(0.1)

        # 检测玩家2按钮
        if not button_p2.value:
            time.sleep(0.05)
            if not button_p2.value:
                p2_score += 1
                print(f"玩家2得分: {p2_score}")
                update_led_strip(pixels_p2, p2_score)
                while not button_p2.value:
                    pass
                time.sleep(0.1)

        # 胜利条件判断
        if p1_score >= NUM_PIXELS:
            winner = "P1"
            game_active = False
        elif p2_score >= NUM_PIXELS:
            winner = "P2"
            game_active = False

        # 如果有人获胜
        if winner:
            print(f"玩家 {winner} 获胜！")
            # 让获胜方的灯带闪烁庆祝
            for _ in range(5):
                if winner == "P1":
                    pixels_p1.fill((255, 255, 0)) # 黄色
                    pixels_p1.show()
                else:
                    pixels_p2.fill((255, 255, 0))
                    pixels_p2.show()
                time.sleep(0.3)
                if winner == "P1":
                    pixels_p1.fill((0, 255, 0))
                    pixels_p1.show()
                else:
                    pixels_p2.fill((0, 255, 0))
                    pixels_p2.show()
                time.sleep(0.3)
            # 播放胜利音效
            play_victory_sound()
            # 等待3秒后自动重置
            time.sleep(3)
            reset_game()
    else:
        # 游戏非活跃状态（如庆祝后短暂间隙），可以执行其他动画或待机
        time.sleep(0.1)

    # 主循环延时，降低CPU占用
    time.sleep(0.01)

4.3 关键代码段剖析

  1. 按钮去抖动 ：机械按钮在按下和释放的瞬间会产生快速的电压抖动，可能导致一次按压被误读为多次。代码中使用了简单的延时再检测的方法（ time.sleep(0.05) ）来进行软件去抖，这是一种在要求不高的场景下可靠且简单的方法。
  2. NeoPixel控制 ： adafruit_neopixel 库让控制LED变得非常简单。 auto_write=False 的设置很重要，它意味着在调用 pixels.show() 之前，所有对颜色的更改都不会立即生效。这允许我们一次性设置好所有灯珠的颜色，然后统一发送显示指令，效率更高，也能避免显示过程中的闪烁。
  3. 音频播放 ：CircuitPython的 audioio 模块支持播放未压缩的WAV文件。需要注意的是，为了节省内存和保证播放流畅，WAV文件应为单声道、较低的采样率（如16kHz或22kHz）。高采样率的立体声音频文件可能导致内存不足或播放卡顿。
  4. 状态管理 ：使用 game_active 和 winner 这两个布尔变量清晰地管理游戏状态，使得主循环的逻辑（检测输入、更新显示、判断胜负、庆祝重置）条理分明，易于理解和维护。

5. 调试、优化与扩展思考

5.1 常见问题与排查实录

在项目开发过程中，我遇到了几个典型问题，它们的解决方案或许对你有帮助：

问题现象 可能原因 排查步骤与解决方案
LED灯带部分不亮或颜色错乱 1. 供电不足。
2. 数据线连接松动或接触不良。
3. 数据引脚接错或代码中引脚定义错误。
4. 灯带损坏。		 1. 检查供电 ：用万用表测量灯带正负极电压，全白时应在4.8V以上。建议电源（充电宝）输出能力不低于2A，并从电源 直接 引粗线给灯带供电，避免经过Arduino板。
2. 检查连接 ：重新焊接或压接数据线和电源线。确保数据流向正确（DIN接控制板，DOUT接下一段灯带）。
3. 检查代码 ：确认 NeoPixel 初始化时使用的引脚编号与实际连接一致。
4. 分段测试 ：单独测试一小段灯带，排除整条灯带故障的可能。
按钮响应不灵或连发 1. 机械抖动。
2. 上拉电阻未启用或接触不良。
3. 代码中检测逻辑有误。		 1. 增加去抖动 ：如代码所示，加入短暂延时和释放检测。对于要求高的场景，可使用更稳定的状态机或硬件RC滤波电路。
2. 检查电路 ：确认按钮一端接GPIO，另一端接地。在代码中确认设置了 pull=digitalio.Pull.UP 。
3. 打印调试 ：在循环中打印按钮的实时状态值，观察按下/释放时的变化是否正常。
音频播放无声或杂音 1. 扬声器或连接线损坏。
2. WAV文件格式不支持。
3. 输出引脚无信号或驱动能力不足。		 1. 替换测试 ：用另一个扬声器或耳机测试。
2. 转换音频 ：使用音频编辑软件（如Audacity）将文件转换为单声道、16位PCM、采样率22050Hz或以下的WAV格式。
3. 检查引脚与代码 ：确认音频输出引脚正确，且代码中 AudioOut 对象初始化无误。对于无源扬声器，可能需要外接放大电路。
设备运行一段时间后重启 1. 电源功率不足，导致电压跌落。
2. 代码陷入死循环或内存泄漏（在CircuitPython中较少见，但复杂逻辑可能引起）。		 1. 强化供电 ：这是最常见原因。换用更大容量、更高输出电流的充电宝，并确保所有电源连接点牢固。
2. 简化代码 ：检查主循环中是否有异常耗时的阻塞操作。确保 time.sleep 的延时合理，让系统有机会处理其他任务。

实操心得：电源是嵌入式项目的“定海神针” 。这个项目90%的稳定性问题都源于供电。WS2812B灯珠在全部点亮白色时，单颗电流可达60mA，20颗就是1.2A，再加上Arduino和其他元件，对5V电源的持续输出能力是很大考验。务必选用质量好、标称输出电流足够的移动电源，并且电源线要粗而短，减少线损。

5.2 项目优化与功能扩展

基础版本稳定运行后，可以考虑以下优化和扩展方向，让设备更具吸引力和适应性：

  1. 难度动态调整 ：引入“失误”机制。例如，随机让已点亮的灯珠熄灭一颗，增加不确定性。或者，随着游戏进行，逐渐加快“自动下降”的速度（如果引入的话）。这可以通过在代码中添加随机数生成和更复杂的游戏状态逻辑来实现。
  2. 丰富的视觉与听觉反馈 ：
    • 视觉 ：获胜时不再是简单的闪烁，可以编写一个彩虹渐变或流星划过灯带的庆祝动画。使用 neopixel 库的 colorwheel 函数可以轻松生成彩虹色。
    • 听觉 ：为不同的游戏事件（如得分、即将获胜、失误）添加不同的音效。这需要管理多个音频文件，并可能涉及使用更高级的音频混合库。
  3. 多人模式与协作模式 ：当前是竞争模式。可以增加一个“合作模式”，两位玩家需要交替按下按钮，共同点亮一条更长的灯带，任何一方过快或过慢都会导致进度回退，培养默契。
  4. 数据记录与分析 ：为教师或治疗师增加一个“管理员模式”。通过连接串口或增加一个隐藏按钮，可以导出游戏数据，如每局耗时、双方按键次数等，用于评估学生的参与度和进步情况。
  5. 无线化与网络化 ：使用支持Wi-Fi或蓝牙的Arduino兼容板（如ESP32），可以让两个设备无线对战，或者将游戏数据上传到云端仪表板，实现更大范围的互动和展示。

这个项目从一颗关怀的心出发，以扎实的技术落地。它让我深刻体会到，技术最有温度的时刻，不是它有多么复杂和尖端，而是它如何巧妙地弥合了人与人之间的缝隙，如何让原本困难的事情变得充满乐趣和可能。希望这个详细的拆解，不仅能让你复现出一个有趣的游戏设备，更能启发你利用手边的微控制器，去创造更多连接彼此、点亮生活的作品。

Logo
亚马逊云科技技术品牌专区

更多推荐

cover

会议室音视频协作痛点全解析与专业解决方案

avatar 亚马逊云科技技术品牌专区
cover

PLC自动化|PLC|毕设项目|毕设答辩|基于PLC的小型粮仓粮情监控系统设计

avatar 亚马逊云科技技术品牌专区
cover

DPJ-81基于STM32单片机WiFi智能家居系统 物联网家庭防盗设计

avatar 亚马逊云科技技术品牌专区