Micro:bit嵌入式开发实战：猜数字游戏的状态机与交互设计

1. 项目概述与核心思路

最近在整理一些适合硬件编程入门的项目，发现一个用Micro:bit实现的“猜数字大小”游戏特别有意思。这个项目麻雀虽小，五脏俱全，它把嵌入式开发里几个核心概念——GPIO控制、事件驱动、状态机、用户交互反馈——都串起来了，而且最终效果直观有趣，无论是自己玩还是拿来教学演示，效果都很好。

简单来说，这个游戏规则很直接：Micro:bit的LED点阵会随机显示一个数字（比如5），然后你需要猜下一个随机出现的数字，会比当前这个数字“更高”还是“更低”。你通过按下板载的A键（代表“更高”）或B键（代表“更低”）来做出选择。猜对了，LED会显示一个笑脸，蜂鸣器发出欢快的提示音，同时你的得分加1；猜错了，则显示哭脸，蜂鸣器发出低沉的音调，游戏结束并显示你的最终得分。

别看规则简单，要实现它，你需要处理好几个关键环节：如何生成公平的随机数序列？如何设计一个清晰的状态机来管理游戏流程（等待显示、等待猜测、判断反馈、结束）？如何利用有限的硬件资源（5x5 LED点阵、两个按钮、一个蜂鸣器）给用户提供丰富即时的反馈？这恰恰是嵌入式开发的魅力所在——在资源受限的环境下，用巧妙的逻辑和简洁的代码解决问题。接下来，我就把这个项目的完整实现过程，包括背后的设计思路、代码细节以及我调试过程中踩过的坑，毫无保留地分享出来。

2. 硬件准备与电路连接解析

工欲善其事，必先利其器。我们先来看看实现这个游戏需要哪些硬件，以及如何正确地连接它们。

2.1 核心硬件清单与选型考量

这个项目对硬件的要求非常基础，核心部件就三样：

1. Micro:bit开发板（V1或V2均可）：这是项目的大脑。V2版本集成了麦克风和扬声器，理论上可以不用外接蜂鸣器，但为了演示通用的GPIO控制方法，我们这里还是使用外接蜂鸣器。两个版本在编程上完全兼容。
2. 有源蜂鸣器模块：用于提供声音反馈。这里有个关键点：务必使用“有源蜂鸣器”。有源蜂鸣器内部集成了振荡电路，给它一个持续的直流电压（比如3.3V）它就会响，控制简单，只需要一个GPIO口控制通断即可。而无源蜂鸣器需要输入特定频率的PWM信号才能发声，控制更复杂。对于这个简单的提示音场景，有源蜂鸣器是最佳选择。
3. 连接线（杜邦线）：若干，用于连接Micro:bit的扩展引脚。

注意：购买蜂鸣器时一定要问清楚或看清楚标识。通常，有源蜂鸣器底部可能封有胶体或贴有标签，标称电压常见为3V、5V或12V。我们选择3V或5V的，因为Micro:bit的GPIO输出高电平为3.3V，驱动3V蜂鸣器正合适，驱动5V的也能响但声音可能小一些。

2.2 电路连接原理与实操步骤

Micro:bit的底部有一排金手指扩展引脚，我们需要用到其中的三个：GND（地）、3V（电源）和一个GPIO口（如P0）。

连接步骤如下：

1. 将蜂鸣器的正极（通常标有“+”或红色线）连接到Micro:bit扩展引脚的3V引脚。这一步是为蜂鸣器提供工作电压。
2. 将蜂鸣器的负极（通常标有“-”或黑色线）连接到Micro:bit扩展引脚的GND引脚。这构成了电流的回路。
3. 最关键的一步：蜂鸣器的信号线（或标有“S”的线）连接到我们准备用于控制的GPIO引脚，例如P0。这样，我们通过程序控制P0引脚输出高电平（3.3V）或低电平（0V），就能控制蜂鸣器响起或静音。

为什么这样连接？这涉及到有源蜂鸣器的驱动电路。蜂鸣器正极接3V，相当于电源正极；负极接GND，相当于电源负极。但这样接上，电流会直接流过蜂鸣器使其长鸣。我们在正极通路中串联了一个由GPIO（P0）控制的“电子开关”。当P0输出高电平时，这个开关“闭合”，电流畅通，蜂鸣器响；当P0输出低电平时，开关“断开”，电路不通，蜂鸣器不响。这种接法称为“高电平驱动”。

实操心得：连接时务必断开USB供电或电池。我曾在带电状态下插拔杜邦线，导致P0引脚瞬间短路，虽然Micro:bit有保护电路没烧坏，但程序出现了不可预知的行为。养成“断电操作”的习惯能避免很多奇怪的问题。另外，杜邦线插在Micro:bit引脚上有时接触不良，如果发现蜂鸣器不响，首先检查所有连接点是否插紧。

3. 软件开发环境与项目初始化

硬件连好了，我们就要给它注入灵魂——程序。Micro:bit最友好的编程环境莫过于微软的MakeCode。

3.1 MakeCode环境详解与项目创建

打开浏览器，访问https://makecode.microbit.org/，你会看到一个图形化的编程界面。对于新手，我强烈建议从“块编程”开始，它直观地展示了程序结构，对理解事件驱动模型非常有帮助。

1. 新建项目：点击“新建项目”，给它起个名字，比如“Higher or Lower Game”。
2. 界面熟悉：中间是编程区，左侧是模拟器，可以实时测试代码效果，右侧是各种功能块的抽屉。我们主要会用到“基本”、“输入”、“音乐”、“游戏”、“逻辑”等分类。
3. 第一个程序：点灯测试：在开始复杂逻辑前，我们先写个最简单的程序验证环境。从“基本”抽屉拖出一个当开机时积木块，再拖一个显示图标块放在里面，选择一颗心。点击模拟器里的“重启”按钮，你应该能看到LED点阵显示一颗心。这说明你的编程环境和逻辑没问题。

3.2 核心变量与状态定义

在编写游戏主逻辑之前，我们需要规划好程序需要“记住”哪些信息。在MakeCode中，我们使用“变量”来存储这些信息。

点击“变量”分类，创建以下变量：

• 当前数字：用来存储LED点阵上正在显示的数字。
• 下一个数字：用来存储已经生成、但尚未显示的下一个随机数字（玩家要猜的就是它和当前数字的大小关系）。
• 分数：记录玩家连续猜对的次数。
• 游戏状态：这是一个非常重要的变量，用于实现状态机。我们可以用数字来表示不同状态，例如：0=游戏结束/初始，1=显示当前数字，2=等待玩家按键猜测，3=显示判断结果。

为什么需要游戏状态变量？想象一下游戏流程：显示数字 -> 等你按A或B -> 判断对错 -> 显示结果 -> 进入下一轮或结束。如果没有状态机，程序可能会在你按下按钮时混乱，比如在显示结果动画时又接收到了按钮事件。状态机让程序在任何时刻都知道自己“正在做什么”以及“接下来该做什么”，这是编写健壮嵌入式程序的关键。

注意事项：在MakeCode中，变量默认是全局的。对于这个小项目这没问题。但在更复杂的项目中，要仔细考虑变量的作用域。初始化变量非常重要，我们会在当开机时块中，为当前数字、下一个数字、分数设置一个初始值（比如0），并将游戏状态设置为1（开始游戏）。

4. 游戏主逻辑与状态机实现

这是整个项目的核心。我们将把游戏分解成几个清晰的状态，并用代码来实现状态之间的转换。

4.1 状态机流程设计与代码实现

我们的游戏状态机循环如下：状态1（显示当前数字） -> 状态2（等待猜测） -> 状态3（判断与反馈） -> 状态1（显示新的当前数字）...如果猜错，则从状态3跳转到状态0（游戏结束）。

4.1.1 初始化与状态1：生成并显示数字

在当开机时块中，我们除了初始化变量，更重要的是启动游戏循环。

1. 设置分数为0。
2. 设置游戏状态为1。
3. 调用一个我们自定义的生成新数字函数（后面会讲），来为当前数字和下一个数字赋初始随机值。
4. 然后，立刻执行一次更新显示函数。

我们创建一个名为更新显示的函数。在这个函数里，我们用一个如果...那么...积木块来判断游戏状态的值。

• 如果游戏状态等于1，我们就用显示数字块来显示当前数字变量。显示完成后，我们不能立刻进入等待猜测状态，因为玩家需要时间看清数字。这里我设置一个暂停(1000)毫秒，然后才将游戏状态设置为2（等待猜测）。这个暂停时间可以根据需要调整，500-1500毫秒都比较合适。

4.1.2 状态2：等待玩家输入与事件驱动

状态2是整个游戏的“等待”阶段。这里我们不需要写一个循环去“等待”，那样会阻塞程序。我们利用Micro:bit的事件驱动模型。 当游戏状态变为2后，程序实际上就“空闲”了，它只是在不断地监听两个事件：当按钮A被按下时和当按钮B被按下时。这就是事件驱动编程的精髓——程序不会主动去查询按钮，而是预先定义好“当某个事件发生时，该做什么”。这非常节省资源，也是现代GUI和Web开发的常见模式。

我们在当按钮A被按下时的块里，第一件事就是检查游戏状态是否等于2。如果不是2（比如还在显示结果动画），那么这次按键就无效，直接忽略。这避免了状态混乱。如果是2，则调用一个检查答案函数，并传入参数“A”。“A”代表玩家猜测“下一个数字更高”。

当按钮B被按下时的处理逻辑完全类似，传入参数“B”代表猜测“更低”。

4.1.3 状态3：答案判断与反馈

检查答案函数是逻辑判断的中心。它接收一个参数猜测（“A”或“B”）。

1. 逻辑判断：使用如果...那么...否则...块。条件判断需要结合当前数字、下一个数字和玩家的猜测。
   • 如果 (猜测是“A”并且下一个数字>当前数字)或者(猜测是“B”并且下一个数字<当前数字)，那么玩家猜对了。
   • 否则，玩家猜错了。
2. 猜对处理：
   • 分数增加1。
   • 设置游戏状态为3（显示结果）。
   • 调用显示反馈函数，传入“正确”。
   • 在反馈显示完毕后，需要准备下一轮：将当前数字的值设置为下一个数字的值。然后，再次调用生成新数字函数，为下一个数字生成一个新的随机数。最后，将游戏状态设回1（显示当前数字），并调用更新显示函数，开始新一轮。
3. 猜错处理：
   • 设置游戏状态为3。
   • 调用显示反馈函数，传入“错误”。
   • 在反馈显示完毕后，将游戏状态设置为0（游戏结束），并调用游戏结束函数。

4.1.4 状态0：游戏结束与重新开始

游戏结束函数负责收尾工作：

1. 清除LED屏幕。
2. 使用显示数字块显示最终的分数，持续几秒让玩家看清。
3. 之后，可以重新初始化所有变量（将分数归零，重新生成数字），并将游戏状态设回1，自动开始新一局。或者，也可以设计为等待玩家同时按下A+B键来重新开始，这增加了交互性。实现方法是：在游戏结束函数最后，设置一个变量等待重启为真，然后在当按钮A按下和当按钮B按下的事件中，加入判断，如果等待重启为真且A和B被同时按下（Micro:bit有当按钮A+B被按下时事件块），则执行初始化，开始新游戏。

4.2 随机数生成与公平性探讨

随机数是这个游戏的灵魂，必须保证其公平性和不可预测性。在MakeCode的“数学”分类中，有在0到10之间取随机数这样的块。我们可以用它来生成数字。

但是，有一个细节需要注意：数字范围。如果范围是0-10，那么出现0或10时，猜测“更高”或“更低”的可能性会消失（例如当前数字是10，下一个数字不可能更高）。这会降低游戏性，并让玩家在边缘数字时只能赌另一边。为了解决这个问题，我有两个方案：

1. 限制有效范围：例如，只在1-9之间生成随机数。这样永远存在“更高”和“更低”两种可能。这是最简单直接的方法。
2. 动态处理边缘情况：如果生成了0，则程序内部将其视为“只能猜更高”；如果生成了10，则视为“只能猜更低”。并在显示时，可以加入特殊提示（比如让数字闪烁）。但这增加了逻辑复杂度。

对于初学者，我强烈推荐方案一。我们在生成新数字函数中，使用在1到9之间取随机数来为下一个数字赋值。而当前数字的初始值，也可以在游戏开始时在这个范围内随机生成。

实操心得：计算机生成的随机数通常是“伪随机数”，对于一个简单的游戏来说完全够用。如果你发现游戏序列有规律，可以尝试在当开机时或每次生成随机数前，执行一个暂停(1)毫秒。因为很多伪随机数算法以系统时间为种子，微小的延时能增加种子的变化，让序列看起来更随机。

5. 用户交互与反馈机制优化

一个好的游戏不仅逻辑要正确，交互体验更要流畅。Micro:bit的LED点阵和蜂鸣器是我们与玩家沟通的桥梁。

5.1 视觉反馈：LED点阵的创意使用

LED点阵只有5x5=25个像素，如何有效地传达信息？

1. 显示数字：直接使用显示数字块。对于多位数，它会滚动显示。为了快速清晰，我们可以约定只显示0-9的个位数（这也支持了我们之前将数字范围定为1-9的决定）。
2. 正确/错误反馈：
   • 正确：显示笑脸图标。但仅仅一个静态笑脸可能不够兴奋。我们可以设计一个简单的动画：先显示笑脸，暂停200毫秒，然后清除屏幕，再显示笑脸，如此重复2-3次。或者，让笑脸从屏幕一侧移动到另一侧。
   • 错误：显示哭脸或叉号图标。同样可以结合动画，比如让哭脸图标闪烁几次。
3. 游戏状态提示：在状态2（等待猜测）时，除了显示数字，我们可以在屏幕角落显示一个闪烁的“？”或箭头，提示玩家可以按键了。在游戏结束时，除了显示分数，可以显示一个骷髅头或结束图标。

5.2 听觉反馈：蜂鸣器驱动与音效设计

蜂鸣器能极大增强游戏的沉浸感。我们之前已经将蜂鸣器连接到了P0引脚。

1. 驱动蜂鸣器：在MakeCode中，控制一个引脚输出高电平来驱动蜂鸣器。但是，更简单的方法是使用“音乐”分类里的积木块。音乐模块默认使用P0引脚播放声音（这正是我们连接的引脚）。我们可以直接使用播放旋律块，而无需直接操作GPIO电平。
2. 设计音效：
   • 正确音效：选择一段简短、上扬、欢快的旋律。例如，使用播放旋律 ba ding 一次，或者用播放音调 中音C 持续 四分之一拍来组合一个简单的胜利旋律。
   • 错误音效：选择一段低沉、下降的旋律。例如，使用播放旋律 wawawawaa 一次。
   • 游戏结束音效：可以是一段长长的、下滑的音阶。
3. 音效与动画同步：在显示反馈函数中，将显示图标动画和播放旋律的积木块并行放置，而不是一个接一个地放。在MakeCode中，多个积木块从上到下执行时，如果下面的块不依赖上面的块，它们几乎是同时开始的。这样就能实现音画同步的效果。如果需要严格的先后顺序（比如先响一声再显示），则使用暂停块来微调。

避坑技巧：蜂鸣器声音可能太刺耳。除了在代码中可以选择不同的音调，你还可以在硬件上串联一个100-330欧姆的电阻在蜂鸣器的正极或信号线上，来降低音量。这是一个非常实用的硬件调试技巧。

5.3 触觉反馈（进阶）：利用Micro:bit V2的震动马达

如果你的Micro:bit是V2版本，它板载了一个震动马达。我们可以用它来提供触觉反馈，让体验更上一层楼。

• 猜对时：短促震动一下。
• 猜错/游戏结束时：长震动一次。 在MakeCode中，可以使用更多分类下的启动震动马达 强度 100% 持续 200 ms积木块来实现。

6. 代码集成、调试与功能扩展

现在，我们将所有的函数和事件处理程序像拼图一样组合起来。

6.1 完整代码逻辑梳理与集成

让我们回顾一下整个程序的骨架：

1. 当开机时：

   • 初始化变量（分数=0， 游戏状态=1）。
   • 调用生成新数字生成初始当前数字和下一个数字。
   • 调用更新显示。

2. 更新显示函数：

   • 判断游戏状态。
   • 如果是1：显示当前数字-> 暂停 ->游戏状态=2。
   • （其他状态的处理，如显示分数等）

3. 当按钮A被按下时：

   • 如果游戏状态==2：调用检查答案(“A”)。

4. 当按钮B被按下时：

   • 如果游戏状态==2：调用检查答案(“B”)。

5. 检查答案(猜测)函数：

   • 判断对错。
   • 猜对：分数+1，游戏状态=3，调用显示反馈(“正确”)，更新数字，游戏状态=1，调用更新显示。
   • 猜错：游戏状态=3，调用显示反馈(“错误”)，游戏状态=0，调用游戏结束。

6. 显示反馈(类型)函数：

   • 根据类型，控制LED显示动画和蜂鸣器播放音效。

7. 游戏结束函数：

   • 显示最终分数。
   • 设置等待重启标志，或直接延时后自动重启。

6.2 模拟调试与真机烧录

MakeCode的模拟器是我们第一个强大的调试工具。

1. 点击模拟器里的A/B按钮，观察LED显示和声音（模拟器会有扬声器图标动画）是否符合预期。
2. 观察变量值的变化。在MakeCode中，你可以点击“JavaScript”视图，查看生成的代码，但更直观的是使用“控制台”功能。在模拟器中，你可以右键点击变量，选择“监视”，它的值会显示在模拟器下方。
3. 测试边界情况：例如，当前数字是1时按B（猜更低），程序应该如何处理？我们的设计是，只要在1-9范围内，猜更低就是错的，并结束游戏。

模拟器测试无误后，就可以烧录到真机了：

1. 点击MakeCode编辑器左下角的下载按钮，会下载一个.hex文件。
2. 用USB线将Micro:bit连接到电脑。它会像一个U盘一样出现。
3. 将下载好的.hex文件拖拽或复制到这个“U盘”里。Micro:bit背后的黄色指示灯会闪烁，表示正在烧录。烧录完成后，它会自动重启并运行新程序。

6.3 常见问题排查速查表

6.4 功能扩展与创意发散

基础版本完成后，你可以尝试以下扩展，让游戏更具挑战性和趣味性：

1. 增加难度等级：引入一个难度变量。初级（数字范围1-5），中级（1-9），高级（0-99）。通过同时按下A+B键或在游戏开始前摇动Micro:bit来切换难度。
2. 限时挑战：在状态2（等待猜测）时，启动一个倒计时。使用游戏分类中的创建精灵和倒计时块，或者在LED上以点亮/熄灭的进度条显示时间。超时未作答视为错误。
3. 连击奖励：连续猜对一定次数（如5次）后，触发一个特殊的奖励动画和音效，并额外加分。
4. 多人游戏模式：利用Micro:bit的无线电功能。一台Micro:bit作为主机出题，其他Micro:bit作为玩家端答题，主机判断对错并广播排名。
5. 添加更多外设：连接一个舵机，猜对时舵机转动举起一面小旗；或者连接一个RGB LED灯，用不同颜色表示正确或错误。

这个基于Micro:bit的猜数字游戏项目，从硬件连接到状态机设计，再到交互反馈优化，完整地走了一遍嵌入式小产品开发的流程。它最宝贵的价值不在于游戏本身多复杂，而在于它清晰地演示了如何将一个问题分解为状态、事件和函数，并用有限的硬件资源创造出完整的用户体验。当你成功让蜂鸣器随着笑脸响起的那一刻，那种连接物理世界与数字逻辑的成就感，正是硬件编程最大的乐趣所在。我建议你在实现基础功能后，一定要尝试一两个扩展功能，那会让你对Micro:bit和MakeCode的理解更深一层。