Arduino与舵机制作交互式乐高迷你高尔夫：从电路到代码的完整实践

1. 项目概述：一个可交互的乐高迷你高尔夫系统

如果你手头正好有一块闲置的Arduino UNO开发板，几个乐高积木，还有一个想动手做点有趣玩意儿的心，那么这个项目可能就是为你准备的。这不是一个简单的静态模型，而是一个融合了嵌入式控制、物理交互和创意搭建的完整系统。它的核心玩法很简单：你按住一个按钮，系统上的LED灯会依次亮起，同时一个由伺服电机驱动的乐高高尔夫球杆会逐步向后摆动蓄力；松开按钮，球杆就会猛地向前挥出，将球击向目标。整个过程，你通过按压按钮的时长，直观地控制着“挥杆”的力量。

这个项目麻雀虽小，五脏俱全。它涵盖了从电路设计、代码编写到机械结构搭建的完整流程。对于初学者而言，它是一个绝佳的入门项目，能让你在完成一个有趣成果的过程中，理解数字输入、模拟输出（PWM控制伺服电机）、状态机编程等核心概念。对于有经验的创客，它则提供了一个将电子模块与乐高这种通用构建系统结合的思路，你可以在此基础上扩展传感器、增加记分功能，甚至打造一个完整的迷你高尔夫球场。

在开始之前，你需要明确一点：这个项目的乐趣一半在于功能的实现，另一半在于外观的创意。原作者提供了乐高和木质两种外壳方案，我强烈建议你从乐高版本开始，因为它的容错率高，修改方便，能让你更专注于电子和逻辑部分。无论你选择哪种，最终都将收获一个独一无二的、可以实际游玩的互动装置。

2. 核心硬件选型与电路设计解析

2.1 主控与执行单元：为什么是Arduino UNO和9g舵机？

选择Arduino UNO作为大脑几乎是创客项目的默认选项，原因很实在。首先，它的IO口数量（14个数字口，6个模拟口）对于本项目绰绰有余。我们只需要用到4个数字口（3个LED，1个按钮，1个舵机）。其次，UNO的5V输出能力足以驱动一个小型9g舵机和几个LED。最重要的是，其庞大的社区和丰富的库文件，让驱动伺服电机（Servo.h库）变得异常简单，几乎不需要关心底层PWM波形是如何生成的。

舵机（伺服电机）的选择是项目的关键。这里使用的是常见的TowerPro SG90 9g微型舵机。这种舵机内部包含电机、减速齿轮组、控制电路和电位器，形成一个闭环系统。你给它一个目标角度信号（通常是20ms周期的PWM波，其中高电平脉宽在0.5ms到2.5ms之间对应0到180度），它就会自己转动并保持在该角度。对于模拟高尔夫挥杆动作，舵机的快速响应和精准定位特性非常合适。9g的扭矩对于推动一个乐高小球也完全足够。

注意：市面上有些廉价舵机可能存在“抖舵”或角度不准的问题。在代码中，我们可以通过增加一点死区或微调角度值来补偿。另外，务必确保为舵机提供独立且稳定的5V电源（可以直接从UNO的5V引脚取电，但若同时驱动多个舵机，建议外接电源），避免因电流不足导致UNO重启。

2.2 输入与反馈单元：按钮与LED的电路考量

输入部分是一个常开型轻触按钮。电路设计上采用了上拉电阻的接法。具体来说，按钮一端接GND，另一端接数字引脚4，同时该引脚通过一个10KΩ电阻连接到5V。当按钮未按下时，引脚通过电阻被拉到高电平（5V）；按下时，引脚直接连接到GND，变为低电平（0V）。代码中检测低电平即表示按钮被按下。这种设计比下拉电阻更稳定，可以有效避免引脚悬空时读到不确定的电平值。

视觉反馈由红、黄、绿三个LED提供。每个LED都串联了一个220Ω的限流电阻。这个电阻值很重要，计算依据是欧姆定律。假设LED正向压降约为2V，Arduino输出高电平为5V，那么电阻需要分担3V的电压。对于典型的20mA工作电流，电阻值 R = V / I = 3V / 0.02A = 150Ω。选择220Ω是一个保守且安全的值，既能保证LED足够亮，又能将电流限制在安全范围内（约13.6mA），保护Arduino的IO口。

2.3 电路搭建与焊接要点

原项目使用了面包板进行原型验证，然后焊接到了兼容Arduino的扩展板上。这是一个非常好的实践流程。在面包板上搭建时，务必拍照记录每个元件的连接位置，就像原作者做的那样，这能避免焊接时接错线。

焊接时有几个细节需要注意：

1. 按钮引脚处理：如原作者所述，有些按钮的引脚可能太短，无法可靠插入焊盘。解决方法就是焊接一小段电阻剪下的引线作为“延长脚”。焊接时要快，避免过热损坏按钮内部的弹片。
2. LED极性：长脚为正极（阳极），短脚为负极（阴极）。焊接时务必确认方向，接反了不会亮。
3. 舵机接口：棕色线（通常是棕色或黑色）接GND，红色线接5V，橙色线（或黄色、白色）接信号引脚（本例中是数字引脚3）。信号线顺序接错不会损坏设备，但无法控制。
4. 电源稳定性：所有GND（地线）必须连接到一起，最终汇入Arduino的GND引脚，形成一个共同的参考零电位，这是电路正常工作的基础。

3. 程序逻辑深度剖析与代码实现

项目的核心逻辑全部封装在Arduino的代码中。这段代码实现了一个基于时间的状态机，将按钮按下的时长映射为舵机的角度和LED的点亮状态。

3.1 变量定义与初始化

代码开头定义了控制引脚和状态变量。ledPin1/2/3分别对应绿、黄、红LED，这个顺序与物理世界“绿灯行”的暗示相反，需要注意。ButtonPower变量是整个逻辑的核心，它作为一个计数器，随着按钮按下的时间递增。

在setup()函数中，完成了引脚模式设置（LED为输出，按钮为输入）、串口初始化（用于调试，可观察ButtonPower值的变化）以及舵机的初始定位（Servo1.write(90)）。将舵机初始位置设为90度（中间位置）是一个合理的起点，对应球杆的垂直待机状态。

3.2 主循环逻辑：状态迁移与映射关系

loop()函数以极高的频率不断循环执行，其逻辑流程可以拆解如下：

1. 读取按钮状态：digitalRead(4)读取引脚4的电平。
2. 更新按钮力量值：如果检测到按钮被按下（buttonState == HIGH），则ButtonPower变量每循环一次增加1，并通过delay(30)延时约30毫秒。这意味着ButtonPower大约每30毫秒增加1。这个延时决定了力量积累的“手感”，数值越大，蓄力越慢。
3. 重置机制：如果按钮松开，ButtonPower立即归零。如果ButtonPower计数到90，也会被重置为0。这设置了力量的上限和自动重置条件。
4. 状态判断与输出控制：根据ButtonPower的当前值，程序进入不同的条件分支：
   • ButtonPower == 0：待机状态。舵机回90度，所有LED熄灭。
   • 0 < ButtonPower < 15：第一阶段（轻击）。舵机转到120度，红色LED亮起。此时ButtonPower大约对应0-450毫秒的按压时间。
   • 15 <= ButtonPower < 50：第二阶段（中击）。舵机转到150度，黄色LED也亮起（此时红色仍亮）。
   • 50 <= ButtonPower < 75：第三阶段（重击）。舵机转到180度（最大角度），绿色LED亮起（红黄绿全亮）。
   • 75 <= ButtonPower <= 90：超时缓冲阶段。这是一个巧妙的处理。当按压时间过长（超过约2.25秒），力量值进入75-90区间。此时，舵机角度从180度开始，随着ButtonPower增加而线性递减，计算公式为180 - (ButtonPower-75)*6。当ButtonPower达到90时，角度正好回到90度。同时，LED全部熄灭。这模拟了“蓄力过久，力量泄掉”的效果，给玩家一个清晰的反馈，并自动复位到起点，无需手动松开按钮重来。

实操心得：delay(30)的设置在简单项目中可行，但它会阻塞整个程序。在这30毫秒内，Arduino无法检测按钮是否松开。对于要求更精准响应的场景，应该使用millis()函数进行非阻塞式计时。例如，可以记录按钮按下的时间戳，然后在每次循环中计算经过的时间，这样既能准确计时，又不会影响其他任务的执行。

3.3 代码优化与扩展思路

原代码清晰易懂，非常适合学习。但在实际打磨中，我们可以做以下改进：

1. 消除魔法数字：将15,50,75,90这些阈值，以及30（延时）、120,150,180（角度）等直接写在代码里的数字，用#define或const int定义为有意义的常量。例如：

   const int BTN_POWER_LIGHT = 15; const int BTN_POWER_MEDIUM = 50; const int BTN_POWER_HEAVY = 75; const int BTN_POWER_MAX = 90; const int DELAY_MS = 30; const int ANGLE_LIGHT = 120; const int ANGLE_MEDIUM = 150; const int ANGLE_MAX = 180;

   这样修改后，代码可读性更强，调整参数也只需修改一处。
2. 添加蜂鸣器反馈：可以增加一个无源蜂鸣器，在不同力量阶段发出不同音调的声音，增强沉浸感。
3. 实现连续击球：当前逻辑在挥杆后需要等待ButtonPower归零才能开始下一次。可以修改为：当检测到舵机完成挥杆动作（例如，通过判断角度回到90度）后，自动重置状态，允许立即开始下一次蓄力。

4. 乐高结构搭建详解与技巧

乐高版本的魅力在于其极高的可定制性和便捷性。搭建分为两个主要部分：Arduino控制盒和高尔夫球场。

4.1 Arduino控制盒（发射器）搭建

核心目标是稳固地固定Arduino UNO、面包板，并为舵机预留运动空间。

1. 基础框架：使用两块16x6的乐高板作为底座，用2x4、3x2等基础砖在四周砌起围墙，将Arduino UNO卡在中间。注意预留USB口和电源接口的空隙。
2. 分层结构：在Arduino上方用砖块搭出一个平台，用于放置面包板。确保面包板上的按钮和LED露在外面，方便操作和观察。
3. 舵机安装：这是关键。需要在侧面预留一个至少4x2砖块大小的开口，让舵机的转轴和摇臂能够无阻碍地伸出。可以将舵机用乐高销或梁固定在内部框架上，确保其机身稳固，只有摇臂在运动。
4. 高尔夫球杆连接：将乐高球杆（由板、轴等零件组成）牢固地连接到舵机的摇臂上。可以使用乐高科技系列的十字轴连接件，或者用热熔胶直接粘合（非乐高纯正主义者做法）。确保连接牢固，挥杆时不会脱落。
5. 美化与装饰：用平板覆盖面包板，只留出必要的孔洞。然后用植物、梯子、箱子等装饰件进行美化，让它看起来像一个微缩的发球台或控制塔。

4.2 高尔夫球场搭建

球场是游戏的舞台，搭建相对自由，但需考虑功能性和美观。

1. 地基：使用一块10x20的光面板作为基础，提供平坦的击球面。
2. 果岭：用大量1x4的浅绿色光面砖铺满地基，模拟草坪的质感。光面砖能让小球滚动得更顺畅。
3. 边界与球道：用黄色的砖和板搭建球场边界，起到围挡和视觉引导的作用。可以在球道上设置一些由1x2板构成的轻微障碍，增加趣味性。
4. 球洞（目标区）：这是搭建的重点。原作者设计了一个抬高的球洞区域。用砖块搭出一个10格宽的平台，通过斜坡与主球场连接。球洞本身可以用一个2x2的带孔砖模拟，或者干脆设计一个需要将球击入的“门洞”。在球洞后方可以竖立旗帜作为标志。
5. 发球台：在球场另一端，设置一个黄色的2x2带凸点砖，其中心的单个凸点可以稳稳地卡住乐高高尔夫球，防止它自行滚动。

避坑技巧：乐高球的滚动摩擦力较大，可能需要调整舵机的击打力度。如果球总是滚不远，可以尝试：1) 增加舵机的摆动幅度（修改代码中的最大角度）；2) 确保球杆击球点在球的中部或中下部，以产生向前的滚动而非挑高；3) 使用更光滑的底板材料，或在乐高光面板上涂抹一层薄薄的石蜡以减少摩擦。

5. 木质外壳版本制作指南

木质版本提供了另一种质感选择，制作过程更像传统的木工DIY，适合喜欢动手加工的朋友。

5.1 材料准备与切割

你需要准备厚度约为2厘米的松木或桐木板（易于加工），以及一些2x2厘米的木条作为骨架。

1. 尺寸规划：原设计给出了9x9厘米（前后面板）和9x12厘米（侧面和顶板）的尺寸。你需要根据自己Arduino和面包板的实际布局微调。一个更通用的方法是，将所有元件放在桌面上排列好，量取它们所占的大致长宽高，再每边增加1-2厘米作为外壳的内尺寸。
2. 切割与打磨：使用线锯或手锯仔细切割出各个面板。切割后，务必用砂纸将所有边缘和表面打磨光滑，特别是需要拼接的边角，确保能紧密贴合。
3. 骨架制作：切割四根长度等于外壳高度的2x2木条，作为四个垂直的支柱。

5.2 组装与内部布局

1. 框架组装：首先将两侧的9x12厘米面板用螺丝固定到两根后支柱上。然后，将前后面板固定到四根支柱上，形成箱体框架。这里有个关键技巧：固定前面板（带舵机孔）和后面板（带线缆孔）的螺丝，其位置要与固定侧板的螺丝错开，避免在木头内部“打架”。
2. 底板安装：裁切一块尺寸略大于框架底部的木板作为底板，从框架内部用螺丝向上固定。
3. 开孔：这是最需要耐心的一步。先拆下前后面板，在面板上精确标记出USB线、舵机轴需要穿过的位置。对于方孔（如给舵机机身让位），可以先在四个角钻孔，然后用线锯连接；对于圆孔，可以使用开孔器。开孔宁可先小一点，慢慢修整到合适大小。
4. 内部安装：
   • Arduino固定：在底板对应Arduino安装孔的位置钻孔，使用M3螺丝和尼龙柱将Arduino固定在底板上，使其悬空，利于散热。
   • 面包板支撑：在箱体后部，于两侧支柱之间横着固定一根木条，然后将面包板用双面胶或螺丝固定在这根木条上。
   • 舵机固定：将舵机用螺丝从内部固定在前面板预留的孔洞上，确保转轴能顺畅伸出。

5.3 装饰与球场制作

1. 外观装饰：用冰棒棍紧密地粘贴在箱体侧面，可以营造出田园或海滩木屋的风格。用丙烯颜料上色，干刷技法可以做出做旧效果。
2. 木质球场：单独制作一块9x18厘米的木板作为球场，上面可以用颜料画出球道、障碍区和球洞。用木条或冰棒棍制作围栏和球洞。用热熔胶将这个小球场固定在外壳基座的前方。
3. 功能优化：在底板底部粘贴四个毛毡垫，防止刮伤桌面。确保所有电线都整齐排布，可以用扎带或线卡固定，避免缠绕到运动的舵机上。

6. 系统调试与常见问题排查

即使完全按照步骤制作，也可能会遇到一些问题。下面是一个常见问题排查表，帮助你快速定位和解决。

调试是一个迭代的过程。我的建议是分模块测试：先单独测试按钮和LED的响应，再单独测试舵机能否受控转动，最后整合到一起。使用串口监视器打印关键变量（如buttonState和ButtonPower）的值，是洞察程序运行状态最有效的手段。

这个项目最吸引人的地方，在于它清晰地展示了一个想法如何从电路图、代码演变为一个可触摸、可交互的实体。无论你最终做出来的版本是精致还是略显粗糙，在这个过程中获得的关于系统集成、问题排查和创意实现的经验，远比项目本身更有价值。你可以尝试改变游戏规则，比如增加多个球洞、用光敏电阻做自动计分，或者用蓝牙模块连接手机App来显示分数。