Arduino电子四子棋：状态机与NeoPixel LED的嵌入式系统实践

1. 项目概述与核心思路

电子四子棋，或者说“四子连线”，是一个经典的双人对弈游戏。传统的玩法是玩家将实体棋子投入一个7列6行的垂直棋盘，谁先让自己的四颗棋子在水平、垂直或对角线上连成一线，谁就获胜。这个项目的有趣之处在于，我们用现代电子技术完全重构了它的交互和呈现方式。你不再需要实体棋子和重力，取而代之的是一个由42颗NeoPixel LED组成的发光矩阵，以及7个对应棋列的物理按钮。当玩家按下按钮，LED矩阵会模拟出一颗“光球”从该列顶部下落的动画，并最终停留在该列最低的可用位置。整个游戏的逻辑、动画和胜负判定，都由一块小小的Arduino Uno微控制器来驱动。

这个项目远不止是“用LED做个棋盘”那么简单。它实际上是一个典型的嵌入式系统综合应用案例，融合了硬件电路设计、嵌入式C++编程、状态机逻辑、3D建模与打印，以及结构组装。对于刚接触Arduino或嵌入式开发的朋友来说，它能让你一次性接触到从信号输入（按钮）、数据处理（状态机逻辑）、到输出控制（LED动画）的完整闭环。而对于有经验的开发者，如何用有限的硬件资源（比如Arduino Uno有限的I/O引脚）实现复杂功能，以及如何设计稳定、高效且易于维护的状态机，都是值得深入探讨的工程实践。

我自己在复现和改进这个项目的过程中，最大的体会是：状态机是这类交互式项目的灵魂。它让原本可能杂乱无章的事件驱动代码，变得像流程图一样清晰可循。下面，我就结合原项目的资料和我自己的实操经验，把这个电子四子棋从设计思路到代码实现，再到硬件搭建的完整过程拆解清楚。

2. 硬件系统设计与核心电路解析

硬件是整个项目的物理基础，设计不当会导致后续编程和调试困难重重。我们的目标是构建一个稳定、可靠且成本可控的硬件平台。

2.1 核心元件选型与考量

主控单元：Arduino Uno选择Arduino Uno几乎是入门项目的标准答案，原因有三：一是生态丰富，资料和库函数唾手可得；二是引脚数量（14个数字I/O，6个模拟输入）对于本项目来说“刚刚好够用”，能逼着我们思考更高效的电路设计；三是USB编程和供电的便利性。虽然像Arduino Mega这样的板子引脚更多，但Uno的性价比和普及度使其成为首选。

显示单元：WS2812B NeoPixel LED为什么是NeoPixel，而不是普通的LED点阵？关键在于“智能”与“简化”。一颗WS2812B LED集成了RGB三色LED和驱动芯片，只需要一根数据线（Data）进行级联控制。这意味着我们驱动42颗LED只需要Arduino的一个数字引脚，极大地节省了I/O资源，也免去了复杂的多路复用扫描电路。其每个像素可独立寻址、全彩显示的特性，为流畅的动画效果（如棋子下落、胜利闪烁）提供了可能。需要注意的是，NeoPixel对时序要求严格，且全亮时电流很大，电源设计是关键。

输入单元：7+1个按钮7个游戏列按钮，1个全局复位按钮。原项目使用了街机风格的按钮，手感好、寿命长，但成本较高。在实际制作中，完全可以使用普通的12mm或16mm自锁/无锁按钮，效果一样。这里的一个核心挑战是：Arduino Uno的数字和模拟引脚加起来，也无法为8个按钮各自分配一个独立引脚。

2.2 核心电路：基于电压分压的多按钮复用方案

这是本项目硬件设计中最巧妙也最需要理解透彻的部分。由于I/O引脚不足，我们不能采用每个按钮接一个数字引脚读取高低电平的常规方法。原项目采用的解决方案是“模拟电压分压网络”。

2.2.1 电路原理其核心思想是构建一个电阻分压网络。将所有按钮的一端连接在一起，接到一个参考电压（如+5V）。每个按钮的另一端，通过一个唯一阻值的电阻，连接到地（GND）。同时，所有电阻的连接点（即按钮与电阻的公共节点）通过一根线连接到Arduino的一个模拟输入引脚（如A0）。

当没有按钮按下时，模拟引脚通过下拉电阻（如果有）或高阻抗状态，读到的是接近0V的电压。当按下某一个按钮时，+5V通过该按钮，流经对应的唯一电阻到地，在模拟引脚处形成一个分压点。根据欧姆定律，这个点的电压V_read = 5V * (R_pull_down / (R_button + R_pull_down))。由于每个按钮对应的R_button阻值不同，按下不同按钮时，V_read就会是一个不同的、可区分的电压值。

注意：电阻值的选择需要精心计算，确保每个按钮按下时产生的电压值之间有足够的间隔（例如大于0.1V），以防止因电源波动或ADC精度导致的误判。通常选择E24系列中阻值差距明显的电阻，如1kΩ, 2.2kΩ, 3.3kΩ, 4.7kΩ, 6.8kΩ, 10kΩ等。

2.2.2 原项目的优化与分支设计在原项目的电路图中，作者提到他们将8个按钮分成了3个“分支”，分别接到A0, A1, A2三个模拟引脚。这是因为如果所有按钮共用一条模拟通道，当电阻值较多时，相邻电阻产生的电压可能过于接近，难以可靠区分。分成3组，每组2-3个按钮，大大降低了每组内电压区分的难度，提高了检测的鲁棒性。这是一种非常务实的工程折中。

2.2.3 代码中的电压判定在代码中，你会看到类似这样的判断：

if ( voltage1 > 4.4 && voltage1 < 4.9 ) { // 判定为按钮1被按下 }

这里的4.4和4.9就是一个电压范围窗口。你需要先用analogRead()读取模拟引脚的值（0-1023对应0-5V），然后换算成电压，或者直接使用原始ADC数值进行比较。通过实验测量每个按钮按下时的实际电压，为其设置一个合理的容差范围，是确保按钮检测稳定的关键步骤。

2.3 电源系统设计：不容忽视的细节

NeoPixel LED是全彩LED，单颗在白色全亮时最大电流可达60mA。42颗同时全亮的理论最大电流就是42 * 60mA = 2520mA (2.52A)。这远远超过了Arduino Uno板载稳压器（通常提供500mA左右）和USB口（500mA）的供电能力。

因此，必须为NeoPixel矩阵提供独立供电！正确的接法是：

1. 准备一个外部的5V/3A以上的开关电源（建议留有余量，选择5V/5A）。
2. 电源的5V和GND直接连接到LED灯带的电源输入端。
3. 至关重要的一步：必须将此外部电源的GND与Arduino的GND连接在一起，确保共地。否则信号无法正确传输。
4. Arduino可以通过外部电源的5V供电，或者继续通过USB/DC口供电（此时需注意其电源总输入能力）。

实操心得：务必在NeoPixel电源正极入口处并联一个至少1000μF的电解电容，以应对LED快速变化时产生的瞬时大电流，防止电源电压被拉低导致Arduino复位或LED颜色异常。这是很多新手容易忽略但极其重要的一点。

3. 软件架构：状态机（State Machine）深度解析

如果说硬件是身体的骨骼和肌肉，那么状态机就是项目的大脑和神经系统。它定义了游戏在任何时刻“处于什么状态”以及“在什么条件下切换到下一个状态”。

3.1 为什么必须是状态机？

试想一下不用状态机怎么写这个游戏？你可能会在主循环loop()里写一大堆if...else，同时检测按钮、更新动画、检查胜负、处理复位……代码很快就会变成难以维护和调试的“面条代码”。状态机的优势在于：

• 清晰性：每个状态只关心自己该做的事，逻辑隔离。
• 可维护性：增加新功能（如音效、新动画）只需增加新的状态或修改状态转移条件，不影响其他部分。
• 可靠性：避免了因事件并发处理不当导致的逻辑错误。

3.2 本项目的四状态模型

原项目代码清晰地划分了四个核心状态，构成了游戏的主循环：

1. 状态1：按钮检测 (Button Sensing)

   • 职责：持续扫描模拟输入引脚，判断是哪个列按钮被按下。同时检测复位按钮（通常接独立数字引脚，因为是全局功能）。
   • 关键逻辑：必须加入“去抖动”和“防连按”机制。机械按钮在按下和弹起时会产生电平抖动，可能导致一次物理按压被误判为多次。通常通过软件延时（如检测到按下后等待10-50ms再次检测）或状态标志位（如buttonblock）来实现。
   • 状态转移：当检测到有效的列按钮按下，且该列未满 (overload[x] == 0)，则记录列号x，并切换到状态2。

2. 状态2：棋子下落动画 (Ball Drop Animation)

   • 职责：在LED矩阵上，从第x列的顶部开始，逐行向下点亮一颗LED，模拟棋子下落，直到到达该列当前的最低空位y[x]。
   • 实现细节：通常使用一个子状态机或循环计数器anistate来控制动画帧。每一帧：熄灭上一帧的LED，点亮下一帧的LED，并加入一个短暂的delay()来控制下落速度。动画结束后，在棋盘状态数组BoardMatrixState[x][y]中记录当前玩家的颜色（如1代表蓝，2代表红），并更新该列的高度y[x]--（因为棋盘原点通常在左上角，下落是y坐标增加）。
   • 状态转移：动画播放完毕，切换到状态3。

3. 状态3：胜负判定 (Win Detect)

   • 职责：以上一步落子的坐标(x, Y)为中心，向四个方向（水平、垂直、两条对角线）扫描，检查是否有连续四个同色棋子。
   • 算法优化：原项目提到“只扫描最近的一行”，这是一种聪明的优化。因为新棋子只可能影响它所在的行、列和对角线。我们不需要每次落子后都全盘扫描42个位置，只需从新落子点向四个方向各延伸3格进行计数即可。这大大减少了计算量，保证了游戏的实时性。
   • 扫描逻辑示例（水平向右）：

     int count = 1; // 从当前落子点开始算 int currentColor = BoardMatrixState[x][Y]; // 向右扫描 for (int i = 1; i < 4; i++) { if (x + i < 7 && BoardMatrixState[x + i][Y] == currentColor) { count++; if (count >= 4) { /* 获胜！ */ } } else { break; // 遇到不同颜色或空位，中断计数 } } // 还需要向左扫描，逻辑类似

   • 状态转移：如果检测到四连，切换到状态4；否则，切换回状态1，等待下一位玩家操作。这里原项目缺少一个“平局判定”状态，我们后面会补充。

4. 状态4：胜利动画 (Win Animation)

   • 职责：用炫目的灯光效果宣布胜利者。原项目是让整个棋盘刷过胜利者的颜色 (colorWipe)。
   • 扩展思路：可以做得更丰富，比如让获胜的四颗棋子闪烁，或者让所有棋子模拟“掉落”清空的效果。动画播放期间，游戏应锁定输入（状态1）。
   • 状态转移：动画结束后，进入一个“等待复位”状态（原项目的状态5），只有按下复位按钮，才跳转回状态1，重新初始化游戏。

3.3 状态机的代码实现框架

在Arduino中，状态机通常用enum定义状态，用switch-case语句在loop()中实现状态分发。

enum GameState { STATE_IDLE, // 初始化/空闲 STATE_BUTTON_SENSE, STATE_BALL_DROP, STATE_WIN_CHECK, STATE_WIN_ANIMATION, STATE_TIE // 新增的平局状态 }; GameState currentState = STATE_IDLE; int currentColumn = -1; int currentPlayer = 1; // 1: 玩家1 (蓝), 2: 玩家2 (红) void loop() { switch (currentState) { case STATE_IDLE: // 初始化棋盘数组，清空LED，设置初始玩家等 initGame(); currentState = STATE_BUTTON_SENSE; break; case STATE_BUTTON_SENSE: // 检测按钮，包括复位按钮 if (resetButtonPressed()) { currentState = STATE_IDLE; break; } int col = readColumnButton(); if (col != -1 && !isColumnFull(col)) { currentColumn = col; currentState = STATE_BALL_DROP; } break; case STATE_BALL_DROP: playDropAnimation(currentColumn, currentPlayer); updateBoard(currentColumn, currentPlayer); // 更新逻辑棋盘 currentState = STATE_WIN_CHECK; break; case STATE_WIN_CHECK: if (checkWin(currentColumn)) { currentState = STATE_WIN_ANIMATION; } else if (isBoardFull()) { currentState = STATE_TIE; // 平局处理 } else { switchPlayer(); // 切换玩家 currentState = STATE_BUTTON_SENSE; } break; case STATE_WIN_ANIMATION: playWinAnimation(getWinnerColor()); // 动画结束后，停留在该状态，等待复位 if (resetButtonPressed()) { currentState = STATE_IDLE; } break; case STATE_TIE: playTieAnimation(); if (resetButtonPressed()) { currentState = STATE_IDLE; } break; } }

这个框架比原项目的示例更完整，增加了平局处理和更清晰的状态转移。在实际编写时，每个case里的函数都需要具体实现。

4. 核心功能模块的代码实现与优化

理解了状态机框架，我们再来深入几个关键模块的代码细节和优化点。

4.1 按钮检测的稳健实现

原项目的按钮检测代码片段给出了基础思路，但我们可以让它更健壮。

// 定义按钮电压阈值（需根据实际测量调整） #define BTN1_MIN 880 // 对应约4.3V (假设ADC参考电压5V, 1024分辨率) #define BTN1_MAX 920 // 对应约4.5V #define BTN2_MIN 750 #define BTN2_MAX 780 // ... 其他按钮 // 防抖和状态记录变量 unsigned long lastDebounceTime = 0; const unsigned long debounceDelay = 50; int lastButtonADC = 0; int buttonPressed = -1; // -1表示无按钮，0-6表示列按钮 int readColumnButton() { int adcValue = analogRead(A0); // 读取分支1的电压 int detectedBtn = -1; // 判断哪个按钮被按下（分支1示例） if (adcValue > BTN1_MIN && adcValue < BTN1_MAX) { detectedBtn = 0; } else if (adcValue > BTN2_MIN && adcValue < BTN2_MAX) { detectedBtn = 1; } // ... 判断其他按钮和分支 // 软件防抖 if (detectedBtn != lastButtonADC) { lastDebounceTime = millis(); } if ((millis() - lastDebounceTime) > debounceDelay) { // 防抖时间过后，确认按钮状态 if (detectedBtn != -1 && buttonPressed == -1) { // 检测到新的有效按下 buttonPressed = detectedBtn; return detectedBtn; } else if (detectedBtn == -1) { // 按钮释放 buttonPressed = -1; } } lastButtonADC = detectedBtn; return -1; // 本次循环未检测到有效的新按下动作 }

这个改进版本加入了经典的防抖逻辑，确保一次物理按压只被识别一次。

4.2 棋盘数据结构的定义与操作

在内存中维护一个逻辑棋盘是高效进行胜负判定的基础。

// 定义棋盘大小 const int COLS = 7; const int ROWS = 6; // 棋盘状态数组：0为空，1为玩家1，2为玩家2 int board[COLS][ROWS] = {0}; // 记录每一列当前棋子堆到的行高（从底部算起，或从顶部算起的空位） int columnHeights[COLS] = {0}; // 初始为0，表示每列都为空 // 在指定列落子 bool dropPiece(int col, int player) { if (col < 0 || col >= COLS) return false; if (columnHeights[col] >= ROWS) return false; // 列已满 int row = columnHeights[col]; // 获取该列最低空位的行索引 board[col][row] = player; columnHeights[col]++; // 该列高度增加 return true; } // 判断指定列是否已满 bool isColumnFull(int col) { return columnHeights[col] >= ROWS; } // 判断整个棋盘是否已满（平局条件） bool isBoardFull() { for (int i = 0; i < COLS; i++) { if (!isColumnFull(i)) { return false; } } return true; }

使用这样的数据结构，dropPiece函数会返回是否成功落子，isColumnFull用于在按钮检测时阻止玩家向满列落子，isBoardFull用于触发平局判定。

4.3 胜负判定算法的完整实现

基于逻辑棋盘和落子坐标，胜负判定可以写得很清晰。

// 从落子点 (col, row) 开始检查是否连成四子 bool checkWin(int col, int row) { int player = board[col][row]; if (player == 0) return false; // 该位置为空 // 方向向量: {dx, dy} int directions[4][2] = { {1, 0}, // 水平右 {0, 1}, // 垂直下 {1, 1}, // 右下对角线 {1, -1} // 右上对角线 }; for (int d = 0; d < 4; d++) { int dx = directions[d][0]; int dy = directions[d][1]; int count = 1; // 算上当前落子 // 向正方向延伸 for (int step = 1; step < 4; step++) { int newCol = col + step * dx; int newRow = row + step * dy; if (newCol >= 0 && newCol < COLS && newRow >= 0 && newRow < ROWS && board[newCol][newRow] == player) { count++; } else { break; } } // 向反方向延伸 for (int step = 1; step < 4; step++) { int newCol = col - step * dx; int newRow = row - step * dy; if (newCol >= 0 && newCol < COLS && newRow >= 0 && newRow < ROWS && board[newCol][newRow] == player) { count++; } else { break; } } if (count >= 4) { return true; // 在这个方向上找到四连 } } return false; // 所有方向都未找到四连 }

这个算法从落子点向四个方向双向搜索，逻辑清晰，且效率足够高（最多检查4 * 2 * 3 = 24个位置）。

4.4 NeoPixel动画与控制

使用FastLED或Adafruit NeoPixel库可以方便地控制LED。这里以Adafruit NeoPixel库为例。

#include <Adafruit_NeoPixel.h> #define LED_PIN 6 #define NUM_LEDS 42 Adafruit_NeoPixel strip(NUM_LEDS, LED_PIN, NEO_GRB + NEO_KHZ800); void setup() { strip.begin(); strip.show(); // 初始化后清空LED strip.setBrightness(100); // 设置亮度（0-255），避免太刺眼 } // 将棋盘坐标(col, row)映射到LED灯带的索引号 // 这取决于你焊接LED灯带的物理走线顺序，需要事先规划好。 int getLedIndex(int col, int row) { // 示例：假设从左下角开始，蛇形向上排列 if (col % 2 == 0) { // 偶数列从下往上 return col * ROWS + row; } else { // 奇数列从上往下 return col * ROWS + (ROWS - 1 - row); } } // 播放下落动画 void playDropAnimation(int col, int player) { int color = (player == 1) ? strip.Color(0, 0, 255) : strip.Color(255, 0, 0); // 蓝或红 int targetRow = columnHeights[col] - 1; // 落子后的行高，动画终点 int currentRow = 0; // 从顶部开始下落 while (currentRow <= targetRow) { strip.clear(); // 清屏，准备绘制新帧 // 绘制已固定的棋子 drawAllFixedPieces(); // 绘制当前下落的“光球” int ledIndex = getLedIndex(col, currentRow); strip.setPixelColor(ledIndex, color); strip.show(); delay(100); // 控制下落速度 currentRow++; } } // 绘制所有已落定的棋子 void drawAllFixedPieces() { for (int c = 0; c < COLS; c++) { for (int r = 0; r < columnHeights[c]; r++) { int player = board[c][r]; if (player != 0) { int color = (player == 1) ? strip.Color(0, 0, 255) : strip.Color(255, 0, 0); strip.setPixelColor(getLedIndex(c, r), color); } } } }

映射函数getLedIndex是关键，它建立了逻辑棋盘坐标和物理LED序列号之间的关系。在焊接LED灯带之前，务必先规划好这个映射关系，并在代码中正确实现，否则显示会错乱。

5. 机械结构与物理构建详解

代码跑通了，接下来就要把它装进一个实实在在的壳子里。原项目使用了大量的3D打印和定制加工，我们完全可以借鉴并简化。

5.1 棋盘结构设计

核心目标是固定42颗LED，并在其上方放置一个能让光线柔和透出的扩散层（乒乓球），最后提供一个整洁的面板。

1. LED固定板：这是最需要精度的一层。你需要在一块板子（亚克力、3D打印件或甚至打孔的PCB）上，精确地开出42个直径略大于LED灯珠（通常5mm）的孔，用于固定LED，确保它们的位置与7x6的棋盘网格严格对齐。LED可以从背面插入，用热熔胶固定。
2. 扩散层与棋盘面板：在原项目中，他们巧妙地将乒乓球切成两半，打磨后粘在LED上方作为灯罩。这能产生非常柔和、均匀的圆形光斑，效果很棒。你需要在上层面板（可以是另一块亚克力或3D打印框架）上开出42个直径约40mm的圆孔，来容纳这些半球形的乒乓球。面板同时起到分隔每个“棋位”的作用。
3. 列按钮安装：在棋盘面板的下方或基座上，安装7个按钮，分别对应7列。按钮的位置标识要清晰。
4. 复位按钮：安装在侧面或基座显眼处。
5. 整体支撑：设计一个支架或底座，将电路板（Arduino、电源模块）、线束以及上述各层结构稳固地组装在一起，并考虑走线空间。

5.2 3D打印与加工要点

• 材料选择：PLA是最常见且易于打印的材料，完全够用。如果希望更耐用或有透光需求，可以考虑PETG或亚克力。
• 设计软件：使用Fusion 360, Tinkercad或原项目作者用的Autodesk Inventor进行设计。关键尺寸是LED孔距、乒乓球孔直径和位置。务必在打印前用卡尺核对数字模型。
• 原项目的教训：他们提到打印了一部分测试后发现尺寸需要调整。强烈建议你先打印一个小的测试件，比如只包含2x3个棋位的局部，验证LED、乒乓球的配合是否严丝合缝，以及组装方式是否合理。
• 非打印方案：如果没3D打印机，完全可以用激光切割亚克力板来制作各层结构，或者用厚卡纸、木板手工制作，成本更低，但需要更多的手工精度。

5.3 焊接与组装流程

1. 预焊接与测试：在将LED焊接到主线上之前，先单独测试每一颗NeoPixel。可以用Arduino写一个简单的测试程序，确保每颗LED的R, G, B通道都能正常工作。然后按照你规划的蛇形走线，将42颗LED焊接串联起来。每焊好几颗就通电测试一次，避免全部焊完才发现中间某颗有问题，排查起来非常痛苦。
2. 电源线加粗：NeoPixel灯带的正极（+5V）和负极（GND）导线，建议使用较粗的线（如AWG22），以减少长距离供电的压降。
3. 按钮电路焊接：按照电路图，仔细焊接电阻分压网络。确保电阻值准确，焊点牢固。可以使用一小块洞洞板来规整这个电路。
4. 分层组装：从底层开始：先固定Arduino和电源模块，然后安装LED固定板并连接灯带，接着放置扩散层（粘好乒乓球的中间层），最后盖上顶层面板。确保各层之间用支柱或螺丝固定好，不会挤压到内部的LED和电线。
5. 最终联调：全部组装完毕后，上电，运行完整的游戏程序。测试每个按钮响应是否准确，动画是否流畅，胜负判定是否正确。

6. 常见问题、调试技巧与进阶优化

即使按照步骤操作，你也可能会遇到一些问题。这里记录了一些常见坑点和解决方法。

6.1 硬件相关问题排查

6.2 软件与逻辑问题排查

6.3 项目进阶优化思路

当基础功能实现后，你可以考虑以下优化，让项目更完善、更酷：

1. 增加音效：使用一个简单的无源蜂鸣器或DFPlayer Mini模块，在棋子下落、获胜时播放不同的音效，体验立刻提升一个档次。
2. 美化动画：胜利动画可以不只是刷色。比如让获胜的四颗棋子交替闪烁，或者实现一个“清盘”动画，让所有棋子依次掉落。
3. 游戏模式扩展：增加一个开始菜单，让玩家可以选择先手后手，甚至未来可以加入简单的AI，实现人机对战。
4. 显示优化：增加一个OLED或LCD屏幕，用于显示当前玩家、获胜次数、落子倒计时等信息。
5. 输入方式升级：觉得按钮不够酷？可以尝试用红外对管或超声波传感器来检测玩家“投掷”棋子的手势，或者用旋钮+按钮进行选择。
6. 网络对战（高阶）：使用ESP8266或ESP32替换Arduino Uno，增加Wi-Fi功能，实现两台设备之间的远程对战。

这个基于Arduino的电子四子棋项目，从概念到实现，完整地走完了一个嵌入式交互产品开发的全流程。它涉及了电路设计、嵌入式编程、数据结构、算法、3D建模和动手组装等多个方面。无论你是想学习状态机编程，还是想做一个有趣的桌面游戏，这个项目都是一个绝佳的起点。最让我有成就感的一刻，不是代码编译通过，而是看到朋友按下按钮，光球应声落下，并在连成四子时屏幕绽放出胜利光芒的那一刻——所有的调试和打磨都值了。希望这份详细的拆解，能帮助你少走弯路，顺利做出属于自己的那台炫酷的电子四子棋。