树莓派抓娃娃机实战：从硬件选型到Python控制全解析

1. 项目概述与核心价值

最近在折腾一个挺有意思的开源项目，叫 ClawArcade。简单来说，这是一个基于树莓派（Raspberry Pi）和 Python 开发的“抓娃娃机”模拟器。但别被“模拟器”这个词骗了，它可不是电脑屏幕上的游戏，而是一个能让你用真实物理硬件——比如步进电机、舵机、电磁铁——去控制一个微型机械爪，在真实的迷你“娃娃机”里抓取小物件的项目。我第一次看到这个项目时，就觉得它完美地融合了硬件、软件和纯粹的乐趣，无论是对于想学习嵌入式开发的爱好者，还是想和孩子一起动手做个有趣玩具的家长，或者单纯想重温街机厅回忆的玩家，都极具吸引力。

这个项目的核心价值在于它的“全栈”实践性。它不像很多纯软件项目，你只需要敲代码。ClawArcade 要求你从零开始，理解硬件电路、焊接连线、编写控制逻辑、设计游戏规则，甚至还要考虑机箱的美观和耐用性。整个过程下来，你几乎能接触到小型自动化项目开发的所有环节。项目作者 TashanGKD 在 GitHub 上提供了相当完整的代码、3D 打印模型和接线图，但说实话，直接照搬可能会遇到不少坑。我花了几个周末的时间，从零件采购到最终调试，把整个流程完整地走了一遍，积累了不少实战经验。这篇文章，我就来详细拆解 ClawArcade 的构建过程，分享那些官方文档里可能没写的细节、选型背后的考量，以及调试过程中踩过的“坑”和填“坑”技巧。

2. 硬件选型与物料清单深度解析

构建 ClawArcade 的第一步，也是最关键的一步，就是硬件选型。官方的物料清单（BOM）给出了一个基础框架，但很多细节需要根据你的具体需求和预算来调整。这里我结合自己的实践，对每个核心部件进行深度解析。

2.1 核心控制器：树莓派的版本选择

项目推荐使用树莓派 3B+ 或更高版本。我强烈建议使用树莓派 4B（2GB或4GB内存版本）。原因有三点：

1. GPIO 引脚充足且稳定：树莓派 4B 的 40-pin GPIO 接口与 3B+ 兼容，但其电源管理和信号稳定性更好。在驱动多个电机时，稳定的 GPIO 输出至关重要，能减少因电压波动导致的电机失步或舵机抖动。
2. 处理能力更强：虽然控制逻辑不复杂，但如果你未来想扩展功能，比如加入摄像头实现视觉识别抓取位置，或者运行一个更复杂的 Web 控制界面，树莓派 4B 更强的 CPU 和 GPU 会给你留出充足的性能余量。
3. 供电需求：树莓派 4B 对供电要求更高（建议 5V/3A），但这恰恰是优点。一个优质的 5V/3A 电源适配器，不仅能稳定驱动树莓派本身，还能通过其 GPIO 的 5V 引脚为部分外围模块（如红外传感器）提供相对干净的电源，简化供电设计。

注意：绝对不要试图用树莓派的 GPIO 5V 引脚直接驱动电机！它的电流输出能力非常有限（通常小于500mA），直接驱动会导致树莓派重启甚至损坏。电机必须由独立的外接电源驱动。

2.2 运动执行机构：电机与驱动模块

这是项目的“肌肉”部分，直接决定了爪子的移动精度和抓取力度。

1. X/Y 轴移动（平面移动）：

   • 电机选择：推荐使用 42 步进电机（如 17HS4401）。这种电机扭矩适中（约 0.4 N.m），体积合适，价格也便宜。两相四线制是最常见和易用的类型。
   • 驱动模块：必须使用步进电机驱动板，如 A4988 或 DRV8825。我推荐DRV8825。虽然 A4988 更便宜，但 DRV8825 支持更高的细分（最高32细分），这意味着电机运行更平稳、噪音更小、定位更精确。对于需要安静、平滑移动的抓娃娃机来说，这点体验提升非常值得。
   • 细分设置：通过驱动板上的 MS1, MS2, MS3 跳线帽设置。我建议设置为1/8 或 1/16 细分。过高的细分（如1/32）可能会在高速移动时导致丢步，而过低的细分（如全步进）则移动顿挫感强。1/8细分是一个在精度和平滑度之间很好的平衡点。

2. Z 轴升降与抓取：

   • 升降电机：同样使用一个 42 步进电机，驱动板配置与 X/Y 轴相同。
   • 抓取机构：这是关键！原项目使用一个9g 微型舵机来模拟爪子的开合。舵机通过接收 PWM 信号来精确控制旋转角度，从而带动连杆机构实现爪子的张开和闭合。
   • 舵机选型心得：市面上 9g 舵机质量参差不齐。务必选择金属齿轮的型号，塑料齿轮的舵机在反复抓取受力后极易扫齿。扭矩最好在 1.8kg·cm 以上。我实测下来，银燕（EMAX）的 ES08MA II（金属齿）非常可靠。

2.3 电源系统设计

混乱的电源是项目失败的主要原因之一。必须进行分离供电。

• 树莓派供电：独立的 5V/3A USB-C 电源适配器。
• 电机驱动供电：需要一个独立的12V 直流电源。总电流需求需要计算：假设每个步进电机工作电流为 0.8A（需根据电机参数和驱动板限流设置调整），三个电机同时工作的峰值电流约为 2.4A。再加上一些余量，选择一个12V/3A 或 4A 的直流电源适配器是稳妥的。注意接口是 5.5*2.1mm 直流插头。
• 电平转换：树莓派 GPIO 是 3.3V 逻辑电平，而 A4988/DRV8825 的 STEP/DIR 信号通常兼容 3.3V，但为了绝对稳定，可以在信号线上串联一个 220Ω 的电阻，或者使用专用的电平转换模块（如 TXS0108E）。我的经验是，对于 DRV8825，直接连接在短距离（<20cm）内通常也能工作，但规范做法是进行电平匹配。

2.4 结构件与传感器

• 机架：项目提供了 3D 打印文件。你可以选择 PLA 材料打印，强度足够。打印时注意设置较高的填充率（建议25%以上），以增加关键受力部件的强度。如果自己没有 3D 打印机，可以在某宝上寻找代打服务。
• 限位开关：用于确定 X, Y, Z 轴的“原点”位置。推荐使用机械式常开（NO）限位开关。当爪子移动触碰到开关时，电路闭合，GPIO 检测到低电平（如果接上拉电阻）或高电平，从而知道已经到达边界。每个轴需要两个，分别用于正负方向的限位。
• 红外对管：用于检测投币。由一个红外发射管和一个红外接收管组成，当硬币穿过它们之间时，会遮挡红外线，接收管输出变化，GPIO 检测到这个变化即视为投币一次。选择调制型红外对管抗环境光干扰能力更强。

完整物料清单（增强版）参考表：

3. 电路连接与系统集成实战

有了所有零件，下一步就是让它们正确地“对话”。电路连接是硬件项目中最需要耐心和细心的环节。

3.1 步进电机与驱动板接线

这是最容易出错的地方。以 DRV8825 驱动一个两相四线步进电机为例：

1. 电机线序识别：首先用万用表找出电机的两相线圈。任意两根线之间测量电阻，阻值较小的两根线属于同一相（如A+和A-）。将四根线分为两组。
2. 连接驱动板：将一组线圈接到驱动板的1A和1B，另一组接到2A和2B。正反接只会影响电机旋转方向，后续在软件中调整即可。
3. 驱动板设置：
   • VMOT和GND：接12V 电机电源的正负极。务必确认极性正确！
   • GND：与树莓派的GND相连，共地。
   • STEP：接树莓派 GPIO（如 GPIO17），每个脉冲电机移动一步。
   • DIR：接树莓派 GPIO（如 GPIO18），高/低电平控制电机正/反转。
   • ENABLE：接树莓派 GPIO（如 GPIO22），低电平有效（使能驱动）。可以接一个下拉电阻到地，并通过 GPIO 控制，方便软件禁用电机。
   • MS1, MS2, MS3：通过跳线帽设置细分。例如，MS1=高，MS2=高，MS3=低，代表1/8细分。
   • 关键步骤：调节电流限制！DRV8825 板子上有一个小的电位器。用万用表测量GND和电位器滑片之间的电压参考值（Vref）。计算公式：Vref = 电流限制 * 0.4。例如，你想将电机电流限制在 0.8A，则Vref = 0.8 * 0.4 = 0.32V。用小螺丝刀慢慢调节电位器，直到万用表显示 0.32V。这一步至关重要，电流太小电机无力，太大会发热严重甚至烧毁驱动芯片。

3.2 树莓派 GPIO 分配规划

合理的 GPIO 规划能让代码更清晰。下面是我采用的分配方案（可根据需要调整）：

实操心得：在面包板上搭建整个电路时，建议分模块进行。先接好一个电机和驱动板，编写简单的测试脚本让它正反转，确认无误后再接入下一个。同时接好所有线再调试，一旦出问题，排查会非常困难。

3.3 机械组装与校准

按照 3D 模型组装机架。重点注意：

1. 同步带张力：皮带不能太松（打滑）也不能太紧（增加电机负载、产生噪音）。装好后用手按压皮带中部，应有轻微弹性。
2. 光轴与直线轴承：确保运动顺畅，无卡滞。可以适当涂抹一点润滑脂。
3. 舵机安装与连杆：舵机臂与爪子连杆的连接需要仔细调整。确保舵机在中立位置时，爪子处于“半开”或“全闭”的理想状态。可能需要多次拆装调试。
4. 限位开关安装：位置要精准。确保爪子移动到极限位置时，能可靠地触发开关，但又不会发生剧烈的机械碰撞。

4. 软件架构与核心代码剖析

硬件就绪后，就到了赋予它灵魂的软件部分。ClawArcade 的软件核心是一个运行在树莓派上的 Python 程序。

4.1 开发环境与依赖安装

首先在树莓派上搭建环境：

# 更新系统 sudo apt update && sudo apt upgrade -y # 安装 Python3 和 pip (通常已预装) sudo apt install python3-pip # 安装必要的库 sudo pip3 install RPi.GPIO # 用于控制GPIO sudo pip3 install pigpio # 更精确的PWM控制（用于舵机），需启动守护进程 sudo apt install python3-numpy # 用于坐标计算（可选但推荐） # 启用并启动 pigpio 守护进程 sudo systemctl enable pigpiod sudo systemctl start pigpiod

RPi.GPIO库简单易用，但对于需要高精度、多路 PWM 的场景（如同时控制多个舵机），pigpio库是更好的选择，它通过硬件 PWM 和 DMA 提供更稳定的信号。

4.2 核心控制类设计

一个好的软件结构能让后续维护和功能扩展变得轻松。我建议将系统分为几个核心类：

1. StepperMotor 类：封装单个步进电机的控制。

   import RPi.GPIO as GPIO import time class StepperMotor: def __init__(self, step_pin, dir_pin, enable_pin=None): self.step_pin = step_pin self.dir_pin = dir_pin self.enable_pin = enable_pin self.steps_per_rev = 200 # 42电机通常为200步/转 self.microsteps = 8 # 与DRV8825跳线设置一致 self.current_position = 0 # 记录相对位置（步数） GPIO.setmode(GPIO.BCM) GPIO.setup(self.step_pin, GPIO.OUT) GPIO.setup(self.dir_pin, GPIO.OUT) if self.enable_pin: GPIO.setup(self.enable_pin, GPIO.OUT) self.disable() # 初始化时先禁用电机 def move(self, steps, speed_delay=0.001): """移动指定步数，正数为正方向，负数为反方向""" if steps == 0: return GPIO.output(self.dir_pin, GPIO.HIGH if steps > 0 else GPIO.LOW) if self.enable_pin: self.enable() for _ in range(abs(steps)): GPIO.output(self.step_pin, GPIO.HIGH) time.sleep(speed_delay/2.0) # 脉冲高电平时间 GPIO.output(self.step_pin, GPIO.LOW) time.sleep(speed_delay/2.0) # 脉冲低电平时间 if self.enable_pin: self.disable() self.current_position += steps def enable(self): if self.enable_pin: GPIO.output(self.enable_pin, GPIO.LOW) # DRV8825低电平使能 def disable(self): if self.enable_pin: GPIO.output(self.enable_pin, GPIO.HIGH)

   • 关键参数：speed_delay控制了脉冲间隔，决定了电机转速。需要根据电机和负载调整，太短会导致丢步。
   • 位置记录：current_position用于实现相对坐标控制。结合限位开关归零后，可以建立绝对坐标系。

2. ServoController 类：使用pigpio控制舵机。

   import pigpio class ServoController: def __init__(self, gpio_pin): self.pi = pigpio.pi() # 连接到本地守护进程 self.gpio_pin = gpio_pin # 舵机PWM参数：频率通常为50Hz，脉宽范围500-2500us对应0-180度 self.servo_min = 500 # 对应0度（爪子闭合） self.servo_max = 2500 # 对应180度（爪子张开） self.pi.set_mode(gpio_pin, pigpio.OUTPUT) def set_angle(self, angle): """设置舵机角度，angle范围0-180""" pulse_width = int(self.servo_min + (angle / 180.0) * (self.servo_max - self.servo_min)) self.pi.set_servo_pulsewidth(self.gpio_pin, pulse_width) def open_claw(self): self.set_angle(120) # 张开角度，需根据机械结构校准 def close_claw(self): self.set_angle(60) # 闭合角度，需根据机械结构校准 def cleanup(self): self.pi.set_servo_pulsewidth(self.gpio_pin, 0) # 停止发送PWM信号 self.pi.stop()

   • 校准：servo_min和servo_max以及open_claw/close_claw的角度值需要根据你的具体舵机和连杆安装情况进行实测校准。用set_angle()函数慢慢测试，找到能使爪子完全张开和完全闭合的角度值。

3. LimitSwitch 类：处理限位开关信号。

   class LimitSwitch: def __init__(self, gpio_pin, name): self.gpio_pin = gpio_pin self.name = name GPIO.setup(self.gpio_pin, GPIO.IN, pull_up_down=GPIO.PUD_UP) # 内部上拉，开关闭合时读到低电平 def is_pressed(self): return GPIO.input(self.gpio_pin) == GPIO.LOW

4. ClawMachine 主控类：协调所有部件，实现核心游戏逻辑。

   class ClawMachine: def __init__(self): # 初始化三个电机对象 self.motor_x = StepperMotor(step_pin=17, dir_pin=18, enable_pin=22) self.motor_y = StepperMotor(step_pin=23, dir_pin=24, enable_pin=25) self.motor_z = StepperMotor(step_pin=12, dir_pin=16, enable_pin=20) # 初始化舵机 self.servo = ServoController(gpio_pin=13) # 初始化限位开关 self.limit_x_left = LimitSwitch(5, "X左") self.limit_x_right = LimitSwitch(6, "X右") # ... 初始化其他限位开关 # 状态变量 self.is_homed = False self.coin_count = 0 def home_all_axes(self): """归零操作：让每个轴向负方向移动，直到触发限位开关，然后后退一点作为零点""" print("开始归零...") # X轴归零 while not self.limit_x_left.is_pressed(): self.motor_x.move(-1, speed_delay=0.002) # 慢速靠近 self.motor_x.move(50, speed_delay=0.002) # 触发后反向移动一段距离，离开限位开关 self.motor_x.current_position = 0 # ... 同理处理Y轴和Z轴 self.is_homed = True print("归零完成。") def move_to(self, x_steps, y_steps, z_steps): """移动到绝对位置（基于归零后的坐标系）""" if not self.is_homed: print("请先执行归零操作！") return # 计算各轴需要移动的相对步数 delta_x = x_steps - self.motor_x.current_position delta_y = y_steps - self.motor_y.current_position delta_z = z_steps - self.motor_z.current_position # 这里可以加入简单的直线插补算法，让爪子斜向移动更平滑 # 简单实现：顺序移动 self.motor_x.move(delta_x) self.motor_y.move(delta_y) self.motor_z.move(delta_z) def play_round(self): """一轮游戏流程""" if self.coin_count <= 0: print("请投币！") return self.coin_count -= 1 print(f"开始游戏，剩余币数：{self.coin_count}") # 1. 移动到随机或预设的抓取点上方 target_x = random.randint(100, 500) # 示例随机坐标 target_y = random.randint(100, 500) self.move_to(target_x, target_y, 300) # Z轴先保持高位 # 2. 下降 self.move_to(target_x, target_y, 50) # 下降到抓取高度 time.sleep(0.5) # 3. 闭合爪子 self.servo.close_claw() time.sleep(1) # 等待抓取动作完成 # 4. 提升 self.move_to(target_x, target_y, 300) # 5. 移动到出货口上方 self.move_to(10, 10, 300) # 6. 下降并张开爪子 self.move_to(10, 10, 100) self.servo.open_claw() time.sleep(0.5) # 7. 提升并返回待机点 self.move_to(10, 10, 300) self.move_to(200, 200, 300) # 待机点 print("本轮游戏结束。") def coin_inserted(self): """投币回调函数""" self.coin_count += 1 print(f"投币成功！当前币数：{self.coin_count}")

4.3 用户界面与交互

为了让项目更完整，可以添加简单的用户界面。

1. 命令行界面 (CLI)：最简单，适合调试。通过输入命令控制移动、归零、抓取等。
2. Web 界面：使用 Flask 或 FastAPI 框架，在树莓派上运行一个本地 Web 服务器。前端页面可以用 HTML/JS 实现，通过按钮或虚拟摇杆发送 AJAX 请求到后端 API，控制机器动作。这样你就可以用手机或电脑浏览器远程操控娃娃机了。
3. 物理按钮：接几个轻触开关到 GPIO，通过中断（GPIO.add_event_detect）来检测按钮按下，实现“开始游戏”、“移动测试”等物理按键功能。

5. 调试、校准与性能优化实录

硬件和软件初步整合后，距离稳定运行还有一段调试的路要走。这个阶段遇到的问题最多，也最能积累经验。

5.1 电机运动问题排查

• 症状：电机不转，但有嗡嗡声。

  • 可能原因1：电流设置过低。回到 DRV8825 的 Vref 调节，确保电流设置正确。
  • 可能原因2：使能引脚（ENABLE）状态不对。检查代码中是否将 ENABLE 引脚设为了高电平（禁用状态）。DRV8825 是低电平使能。
  • 可能原因3：脉冲频率过高。尝试大幅增加speed_delay参数（如从 0.001 改为 0.01），如果电机开始缓慢转动，说明原频率太高，电机/驱动器响应不过来。

• 症状：电机转动方向与预期相反。

  • 解决：在代码中交换DIR引脚的高低电平逻辑，或者直接交换电机连接到驱动板的同一相的两根线（如交换1A和1B）。

• 症状：电机丢步（实际位置与记录位置不符）。

  • 可能原因1：机械阻力过大。检查同步带是否过紧，光轴是否润滑，有无异物卡住。
  • 可能原因2：加速度过快。代码中从静止瞬间加速到高速，可能导致丢步。实现一个简单的加减速控制（梯形或S型曲线），起步和停止时慢慢提速/降速。
  • 可能原因3：电源功率不足。当多个电机同时启动或高速运行时，12V电源输出电流不足，电压被拉低，导致驱动板工作不稳定。用万用表监测电机运行时的电源电压，如果跌落严重（如低于10.5V），需要换用功率更大的电源。

5.2 舵机控制问题

• 症状：舵机抖动或不听使唤。
  • 可能原因1：供电不足。舵机在动作瞬间电流可达数百mA，如果直接从树莓派取电，会导致树莓派电压不稳甚至重启。务必为舵机提供独立的 5V 电源（可以从电机驱动的 12V 电源通过降压模块得到，或单独一个 5V 电源），并与树莓派共地。
  • 可能原因2：PWM 信号干扰。确保信号线远离电机电源线等大电流线路。使用pigpio库通常比RPi.GPIO的软件 PWM 更稳定。
  • 可能原因3：机械负载过重。检查爪子是否被卡住，或者连杆机构阻力太大。舵机扭矩有限。

5.3 坐标系与校准

这是实现精准抓取的基础。

1. 步进当量校准：我们需要知道电机移动一步，爪子在真实世界移动多少毫米。
   • 方法：让电机移动已知步数（如 1000 步），测量爪子实际移动距离（D mm）。
   • 计算：步进当量 = D / 1000(mm/步)。
   • 这个值取决于电机步距角、细分设置、同步轮直径和皮带类型。分别校准 X, Y, Z 轴。
2. 软限位设置：在代码中，根据机架物理尺寸和步进当量，计算出每个轴的最大安全步数。在move_to函数中加入判断，防止指令超出物理范围，即使限位开关失效也能提供一层保护。
3. 抓取点标定：在娃娃机“舞台”上选取几个特征点（如四个角落），手动控制爪子移动到这些点，记录下对应的 (x_steps, y_steps) 坐标。这样就能建立一个从“步数坐标”到“物理位置”的映射。

5.4 游戏逻辑与难度调整

一个有趣的抓娃娃机，其“抓取成功”应该是概率性的。可以通过软件控制“爪力”和“随机偏移”来调整难度。

• 爪力控制：不是真的控制电流，而是控制舵机闭合的“力度”和“时间”。例如，在servo.close_claw()函数中，不直接转到最大闭合角度，而是随机转到 50-70 度（假设最大力是60度），并且只保持很短时间（如0.3秒）就松开，模拟“抓不牢”的感觉。
• 随机偏移：在play_round函数中，计算出的目标抓取点 (target_x, target_y) 可以加上一个小的随机偏移量random.randint(-20, 20)，让爪子每次下落位置略有不同，增加不确定性。
• 成功概率：可以设置一个基础成功率（如30%）。每次游戏时，生成一个随机数，只有小于成功率时，才执行“强力抓取”（闭合角度大，保持时间长），否则执行“无力抓取”。

6. 扩展思路与项目升华

当基础功能稳定运行后，你可以考虑以下扩展，让这个项目更具挑战性和趣味性。

1. 计算机视觉辅助：在机箱顶部安装一个树莓派摄像头（或USB摄像头）。使用 OpenCV 库：
   • 识别奖品位置：通过颜色或形状识别，自动定位“娃娃”的位置，并计算其中心坐标，转换为步进电机坐标，实现自动瞄准。
   • 增强交互：在 Web 界面上显示摄像头实时画面，玩家可以像操作真正的抓娃娃机一样，看着画面控制爪子移动。
2. 联网与多人游戏：将 Flask Web 应用部署到公网（需注意网络安全），让朋友可以通过互联网远程操控你的娃娃机，进行一场“远程抓娃娃”比赛。
3. 声音与灯光效果：增加一个蜂鸣器或小喇叭，播放投币声、移动音效、成功或失败的音效。增加 LED 灯带，根据游戏状态改变灯光颜色和模式，营造氛围。
4. 物理奖品传送：如果你有更强的机械设计能力，可以设计一个真正的奖品滑道和收集箱。当爪子将奖品移动到出货口并松开后，奖品通过滑道落入一个透明箱子中，完成一次完整的出货流程。

构建 ClawArcade 的整个过程，是一次从想法到实物的完整创造之旅。它涉及电子、机械、编程多个领域，每一个问题的解决都带来实实在在的成就感。最难的不是代码本身，而是如何让软硬件可靠地协同工作。我强烈建议你在动手过程中，做好记录，特别是电路连接图、校准参数、遇到的错误和解决方案。这些笔记将成为你最宝贵的财富。最后，别忘了享受这个过程，当看到自己亲手制作的机械爪稳稳抓起第一个小物件时，那种快乐是无可替代的。祝你搭建顺利！