1. 项目概述从零打造一个实体化的战舰游戏如果你玩过经典的棋盘游戏“战舰”Battleship在西班牙也叫“Hundir la flota”一定对那种猜测坐标、击沉对方舰队的紧张感印象深刻。但把这款游戏从纸面搬到现实变成一个会发光、会发声、能双人对战的实体电子装置感觉就完全不一样了。这正是我们当时在“创意电子学”课程上想做的事——不是简单地写个软件模拟而是真正动手从电路板、LED屏幕到3D打印外壳完整地造出一个能玩的游戏机。这个项目的核心是Arduino UNO R4 Minima一块性能足够强劲且性价比很高的微控制器。我们用四块16x16的Adafruit LED矩阵面板构成了两个玩家的战场显示屏通过状态机来清晰管理游戏复杂的流程比如放置船只、轮流攻击并用DFPlayer模块来播放击中、失误或胜利的音效增强沉浸感。整个系统的软件骨架是用C搭建的充分利用了面向对象的特性来管理游戏中的各种实体比如战舰对象。为什么选择这个方案首先LED矩阵作为显示方案比LCD屏更具视觉冲击力动态点亮的效果很适合表现战舰被击中的过程。其次状态机是嵌入式游戏开发的经典模式它能将游戏“开始-布阵-攻击A-攻击B-结束”这些离散的阶段管理得井井有条避免代码变成一团乱麻。最后选择Arduino R4 Minima和成熟的Adafruit库意味着我们能把主要精力放在游戏逻辑和交互设计上而不是反复调试底层驱动。无论你是嵌入式开发的初学者想找一个综合性的练手项目还是有一定经验的爱好者希望了解如何将多个硬件模块显示、输入、音频和复杂的软件状态机整合成一个完整产品这个案例都能提供一条清晰的路径。接下来我会拆解我们从硬件设计、软件架构到组装调试的全过程并分享那些在教程里不会写的“踩坑”经验。2. 硬件设计与选型背后的考量硬件是项目的骨架设计之初的决策直接影响后续开发的复杂度和最终体验。我们的目标是做一个外观有趣、交互直观的双人对战设备而不是一个裸露着线材的开发板。2.1 核心控制器为什么是Arduino R4 Minima在项目启动时我们评估了几款常见的微控制器。经典的Arduino UNO R3引脚丰富、生态成熟但其8位的AVR处理器和有限的内存2KB SRAM, 32KB Flash在驱动多块LED矩阵并处理复杂游戏逻辑时可能会捉襟见肘。ESP32功能强大且自带Wi-Fi但对于这个纯线下对战、无需联网的项目来说有些功能过剩且功耗和引脚布局需要额外考虑。Arduino UNO R4 Minima成为了一个平衡的选择。它基于32位的RA4M1微控制器48MHz拥有256KB的Flash和32KB的SRAM性能远超R3。这意味着我们可以更从容地存储和处理LED矩阵的帧缓冲区、游戏状态变量以及音效文件的索引。同时它完全兼容UNO的引脚布局和盾板生态降低了学习和迁移成本。其内置的12位DAC虽然本项目未使用和更多高级外设也为未来升级留下了空间。注意R4 Minima没有USB转串口芯片需要通过其本身的USB-C接口进行编程这在初次使用时需要确认你的Arduino IDE版本是否已支持R4系列并安装了对应板卡包。2.2 显示系统LED矩阵面板的驱动与挑战显示部分是整个项目最“烧钱”但也最出效果的地方。我们为每个玩家配置了两块16x16的Adafruit LED矩阵面板一块作为“攻击屏”显示你猜测的敌方海域另一块作为“防御屏”显示你的舰队布置及被攻击情况。这样两个玩家可以并排而坐各自拥有独立的视野体验更接近真实的棋盘游戏。每块16x16面板有256个LED。我们使用的是WS2812B或类似智能RGB LED也就是常说的“NeoPixel”。这种LED的优点在于每个像素点都可以独立寻址和控制颜色只需要一根数据线进行串联通信极大地简化了布线。四块面板就是1024个LED这对微控制器的内存和计算能力是一个考验。驱动原理我们使用了Adafruit_NeoMatrix库它建立在Adafruit_NeoPixel和Adafruit_GFX库之上。NeoPixel库负责底层时序将颜色数据每个LED需要24位R、G、B各8位通过特定的单线协议发送出去。GFX库提供了画点、画线、绘制位图等高级图形函数。而NeoMatrix库则将一长串LED1024个在逻辑上组织成一块或几块二维矩阵方便我们使用坐标x, y来操作。连线要点所有面板的VCC和GND必须连接到独立的大功率5V电源后面会讲切勿尝试从Arduino板取电电流绝对不够。数据线DIN需要串联Arduino的数字引脚例如D6连接到第一块面板的DIN第一块面板的DOUT连接到第二块面板的DIN以此类推。这种串联方式意味着每个LED的刷新会有微小的级联延迟但对于静态或慢速动画的游戏界面来说完全无感。2.3 输入设备复古手柄的现代化应用为了追求更好的操作手感和怀旧氛围我们选择了经典的任天堂NES手柄作为输入设备。它只有几个简单的按键A, B, Start, Select方向键完美契合游戏需求方向键移动光标A键确认攻击/放置B键功能旋转船只/菜单操作。接口与通信NES手柄使用一种简单的同步串行协议。它只有5根线VCC,GND,Clock,Latch,Data。我们需要用Arduino的三个数字引脚来模拟这个时序Latch引脚置高电平告诉手柄“准备数据”。短暂延迟后Latch置低。然后在Clock引脚产生一个脉冲高-低同时从Data引脚读取一位数据代表一个按键的状态通常低电平表示按下。重复16个脉冲就能读取所有按键的状态。在代码中我们需要根据时序图精确控制这些引脚的高低电平变化。网上有现成的NESController库但自己实现一遍这个协议对于理解底层硬件通信非常有帮助。2.4 音频系统DFPlayer Mini的集成“无声”的游戏缺乏灵魂。我们使用DFPlayer Mini模块来播放音效。这是一个非常廉价且易用的MP3解码模块可以直接读取microSD卡中的音频文件并通过一个简单的串口指令UART进行控制。连接方式DFPlayer的RX、TX连接到Arduino的某个软件串口例如D2,D3VCC和GND接5V电源。音频输出直接连接一个小喇叭。这里有个关键细节DFPlayer的RX引脚逻辑电平是3.3V而Arduino R4 Minima的IO口输出是5V。虽然很多情况下直接连接也能工作但为了稳定和长期可靠最好在Arduino的TX连接DFPlayerRX之间串联一个1kΩ的电阻进行分压或者使用电平转换模块。软件控制通过DFRobotDFPlayerMini库我们可以轻松发送指令如指定曲目号播放、暂停、设置音量等。我们将不同的音效放置船只、发射炮弹、击中、击沉、失误、胜利录制成简短的MP3文件并按顺序命名如0001.mp3,0002.mp3存入SD卡。游戏中只需调用myDFPlayer.play(1);即可播放击中音效。2.5 供电设计不容忽视的“动力心脏”这是硬件部分最容易出问题的地方。1024个WS2812B LED如果全亮白色每个LED电流约60mA理论峰值电流将超过60A虽然游戏中几乎不可能全白全亮但我们必须按最坏情况设计电源。我们为四块面板准备了一个独立的10A、5V开关电源。这个电源专门负责给所有LED供电。Arduino R4 Minima、DFPlayer、手柄等则可以从另一个小功率的5V电源或USB取电或者如果开关电源功率足够且稳定也可以从其上分出一路给控制部分供电但一定要确保共地。关键实践电源线要粗从电源到LED面板的VCC和GND线必须使用足够粗的导线建议18AWG或更粗以减少压降和发热。多点并联供电不要只从一个点给长长的LED灯带供电。应该在电源端引出多组正负线分别连接到不同面板的输入端甚至一块面板的两端以确保末端LED的电压稳定。添加大电容在LED电源的输入端并联一个大容量电解电容如1000µF 16V可以吸收LED快速刷新时产生的瞬间电流脉冲防止电源电压被拉低导致Arduino复位。散热10A的电源模块工作时会发热我们为其加装了一个小风扇进行强制风冷确保长时间游戏稳定。2.6 结构设计3D打印外壳的工程化思考为了让项目从一个“原型”变成一件“产品”我们使用Tinkercad设计了船型外壳并用PLA材料3D打印。设计时需要考虑结构强度外壳要能稳固地容纳四块LED面板、Arduino、电源、音箱等组件并承受操作时的外力。散热开孔在电源和Arduino附近设计通风孔配合风扇形成风道。装配友好设计卡槽和螺丝柱我们用了大量的M2螺丝让LED面板能平整嵌入电路板能固定线材能有序排布。光扩散直接在裸露的LED点阵上看会刺眼且像素感强。我们在LED面板前加装了一层乳白色的亚克力扩散板让光线变得柔和均匀视觉效果提升巨大。硬件部分就像搭积木每个模块的选择和连接都环环相扣。理清电源、信号、结构这三条线项目就成功了一半。3. 软件架构用状态机驾驭复杂游戏逻辑当硬件准备就绪大脑——也就是软件——的设计就成了关键。对于一个包含菜单、布阵、轮流攻击、胜负判断的游戏如果只用一堆if-else和全局变量代码很快就会变得难以维护和调试。我们采用了有限状态机来结构化整个游戏流程这是嵌入式系统乃至游戏开发中处理复杂流程的经典模式。3.1 状态机设计游戏的指挥中心状态机把游戏流程抽象成几个明确的“状态”每个状态下系统只关心特定的输入和完成特定的任务。状态之间的转换由明确的事件触发。我们定义了五个核心状态START开始显示游戏标题和主菜单。玩家可以调整音量和屏幕亮度按下“开始”键进入下一状态。PLACEMENT布阵两位玩家各自在自己的“防御屏”上布置舰队。玩家用方向键移动高亮框用B键旋转船只用A键确认放置。只有当两位玩家都按下“完成”键后状态才转换。ATTACK_P1玩家1攻击玩家1的回合。他在自己的“攻击屏”对应玩家2的防御屏上移动光标按A键向选定坐标开火。系统判断命中与否更新屏幕播放音效。如果击沉了所有敌舰则跳转到END状态否则切换到玩家2的回合。ATTACK_P2玩家2攻击与ATTACK_P1对称玩家2操作。END结束显示胜利者播放胜利/失败音效等待复位或重启。在loop()函数中我们只做一个大的switch-case根据当前状态gameState的值执行对应状态的处理函数。这种结构非常清晰void loop() { switch (gameState) { case STATE_START: handleStartState(); break; case STATE_PLACEMENT: handlePlacementState(); break; case STATE_ATTACK_P1: handleAttackP1State(); break; case STATE_ATTACK_P2: handleAttackP2State(); break; case STATE_END: handleEndState(); break; } // 其他周期性任务如刷新显示即使状态不变也要刷新 matrix.show(); }3.2 面向对象封装战舰类的实现游戏的核心实体是“战舰”。我们使用C的类来封装战舰的属性与行为这比使用多个分散的数组要清晰得多。这体现在BattleShip.hpp和BattleShip.cpp中。BattleShip类设计// BattleShip.hpp #ifndef BATTLESHIP_H #define BATTLESHIP_H #include Arduino.h class BattleShip { public: // 船只类型枚举 enum ShipType { BARQUE1, CRUISER, LONG_SHIP, SUBMARINE, AIRCRAFT_CARRIER }; // 构造函数初始化类型、长度、名称 BattleShip(ShipType type); // 核心方法 bool place(uint8_t startX, uint8_t startY, bool isHorizontal); bool isHit(uint8_t x, uint8_t y); bool isSunk() const; // 获取属性 uint8_t getLength() const { return length; } ShipType getType() const { return type; } // ... 其他getter/setter private: ShipType type; uint8_t length; char name[20]; bool horizontal; uint8_t posX, posY; // 船头坐标 bool hits[5]; // 记录每个部位是否被击中最大长度5 }; #endif关键方法解析place()函数在布阵状态被调用。它需要检查欲放置的位置从startX, startY开始沿水平或垂直方向length格是否超出边界以及是否与已放置的其他船只重叠。这里需要访问一个全局的或传入的“海域地图”数组进行碰撞检测。isHit()函数在攻击状态被调用。传入攻击坐标(x, y)判断该坐标是否位于这条船的船体上。如果是则标记对应的hits[]数组位置为true并返回true表示命中。isSunk()函数检查hits[]数组是否全部为true是则意味着整条船被击沉。通过这样的封装在主程序BattleShip.ino中我们只需要管理一个BattleShip对象的数组例如BattleShip fleetP1[5];调用它们的方法逻辑非常清晰。3.3 图形与音频驱动库函数的有效运用LED矩阵显示我们创建了一个Adafruit_NeoMatrix全局对象。在每一个游戏状态下我们都需要在矩阵上绘制不同的内容。布阵状态在防御屏上用不同颜色绘制已放置的船只例如未放置是网格已放置是蓝色船体用一个高亮框表示当前正在移动的船只位置。攻击状态在攻击屏上用不同颜色标记历史攻击点未攻击是暗色未命中是蓝色命中是绿色击沉是红色。同时防御屏上自己的船被击中部位要变成黄色。 我们使用matrix.drawPixel(x, y, color)来画点matrix.drawRect(x, y, w, h, color)来画框matrix.fillRect来填充区域。为了绘制复杂的标题图片我们使用了工具将位图转换成RGB数组存放到TextoInicio.h这样的头文件中然后用matrix.drawRGBBitmap()函数来显示。音频播放在setup()中初始化DFPlayer对象并设置音量。在游戏的关键节点调用播放函数。例如在isHit()函数返回true时播放命中音效在isSunk()返回true时播放击沉音效。这里要注意非阻塞式播放即调用play()后立即返回不要使用delay()等待播放完成以免卡住游戏主循环。3.4 双循环与时间管理让游戏流畅响应嵌入式游戏没有操作系统来调度任务我们需要在loop()函数中自己管理一切。这里有两个核心循环概念游戏逻辑循环即上面状态机switch-case的部分处理玩家输入、更新游戏状态、判断胜负。显示刷新循环无论游戏逻辑进行到哪一步LED矩阵都需要以一定的频率比如30-60Hz刷新否则会出现闪烁。matrix.show()函数调用会阻塞一小段时间与LED数量成正比将它放在loop()的最后确保每一帧逻辑计算后都刷新一次显示。防抖与输入处理手柄按键读取需要防抖。简单的做法是在检测到按键按下后延迟几十毫秒再读一次确认是否仍为按下状态。更稳健的做法是记录按键状态变化的时间戳。性能优化直接操作1024个LED的缓冲区是内存和计算密集型的。优化方法包括只更新发生变化的部分像素而不是每帧重绘整个屏幕。使用更低的颜色深度比如12位色而非24位色来节省内存和传输时间。确保matrix.setBrightness()设置在一个合理的值如50-100过高的亮度不仅耗电也会增加刷新时间。软件架构是项目的灵魂。一个好的状态机设计能让复杂的游戏逻辑变得模块化、可调试良好的面向对象设计让数据管理井然有序而对底层库的深入理解则能充分发挥硬件性能。4. 核心功能实现与代码剖析有了清晰的架构接下来就是填充血肉实现每个状态的具体功能。这里我会深入几个关键环节展示代码是如何与硬件交互并最终形成游戏体验的。4.1 状态一START状态——菜单与初始化handleStartState()函数负责显示动态标题、绘制菜单选项开始、设置音量、设置亮度并响应手柄输入。void handleStartState() { // 1. 绘制静态背景标题位图 matrix.drawRGBBitmap(0, 0, titleBitmap, 16, 16); // 2. 绘制动态菜单光标 uint32_t cursorColor matrix.ColorHSV(millis() * 10, 255, 255); // 生成彩虹色 matrix.fillRect(0, menuCursorY * 8, 16, 2, cursorColor); // 在菜单项旁画一个闪烁光标 // 3. 读取手柄输入 readController(controller1); if (controller1.buttonJustPressed(A_BUTTON)) { if (menuCursorY 0) { // “开始游戏”选项 gameState STATE_PLACEMENT; resetGame(); // 重置所有游戏数据 } else if (menuCursorY 1) { // 进入音量调节子模式 adjustVolume(); } // ... 其他菜单项处理 } if (controller1.buttonJustPressed(UP_BUTTON)) { menuCursorY (menuCursorY - 1 MENU_ITEMS) % MENU_ITEMS; // 循环向上 } // ... 其他方向键处理 }实操心得菜单光标的视觉反馈很重要。我们用一个随时间变化的颜色ColorHSV配合millis()来绘制它让界面立刻生动起来。buttonJustPressed是一个自定义函数它通过比较当前帧和上一帧的按键状态来识别“刚刚按下”的瞬间避免长按触发多次。4.2 状态二PLACEMENT状态——舰队的布阵逻辑这是游戏中最复杂的逻辑之一。玩家需要将5艘不同长度2-5格的船只放置在自己的16x16网格上不能重叠不能超出边界。数据结构我们用一个二维数组uint8_t gridP1[16][16]来表示玩家1的海域。0代表空水1-5代表放置了对应类型的船只用BattleShip::ShipType枚举值6代表无效用于碰撞检测临时标记。布阵流程玩家选择一艘未放置的船按顺序或按选择键。用方向键移动一个高亮框框的大小等于船的长度和当前方向。按B键旋转船只水平/垂直切换。按A键尝试放置。此时调用当前船只对象的place()方法。place()方法内部进行碰撞检测遍历船只要占用的每一个格子检查grid数组中对应位置是否为0并且坐标在0-15范围内。如果检测通过place()函数会更新船只对象的内部位置属性并返回true。主程序随后更新grid数组并在LED防御屏上将该区域绘制为船只颜色如蓝色。如果检测失败重叠或出界给玩家一个视觉反馈如高亮框快速闪烁红色船只保持未放置状态。bool BattleShip::place(uint8_t startX, uint8_t startY, bool isHorizontal) { // 边界检查 if (isHorizontal) { if (startX length 16) return false; } else { if (startY length 16) return false; } // 碰撞检测需要访问全局或传入的grid for (int i 0; i length; i) { uint8_t checkX isHorizontal ? startX i : startX; uint8_t checkY isHorizontal ? startY : startY i; if (grid[checkY][checkX] ! 0) { // 不为0表示已有船只占用 return false; } } // 放置成功更新对象属性和grid posX startX; posY startY; horizontal isHorizontal; for (int i 0; i length; i) { uint8_t markX isHorizontal ? posX i : posX; uint8_t markY isHorizontal ? posY : posY i; grid[markY][markX] type; // 在grid中标记船只类型 } return true; }避坑指南碰撞检测的grid数组必须是玩家布阵海域的“唯一真相源”。所有绘制和后续命中判断都基于它。在放置成功后更新它在重置游戏时清零它。避免在多个地方维护同一份数据否则极易出现状态不一致的bug。4.3 状态三/四ATTACK状态——攻击判定与游戏核心攻击状态是游戏的核心循环。以玩家1攻击为例handleAttackP1State光标移动读取玩家1手柄的方向键在攻击屏对应玩家2的gridP2上移动一个光标一个单像素高亮框或一个闪烁的点。确认攻击按下A键。获取当前光标坐标(atkX, atkY)。有效性检查检查该坐标在攻击记录数组attackGridP1[16][16]中是否已被攻击过。如果是则忽略此次操作或给出提示。遍历判定遍历玩家2的所有船只对象fleetP2[5]对每艘船调用其isHit(atkX, atkY)方法。结果处理如果任何一艘船的isHit返回true则命中。在攻击屏attackGridP1上将该点标记为“命中”如绿色。在玩家2的防御屏即玩家1看不到但硬件上另一块屏上将该点标记为“被击中”如黄色。播放命中音效。检查被命中的船只是否isSunk()。如果是播放击沉音效并将该船所有格子在攻击屏上标记为“击沉”如红色同时在防御屏上也做相应标记。如果所有船的isHit都返回false则未命中。在攻击屏上将该点标记为“未命中”如蓝色。播放失误音效。回合转换与胜负判断无论命中与否本次攻击结束。检查玩家2的所有船只是否都已沉没遍历fleetP2检查所有isSunk()。如果全部沉没游戏状态跳转到STATE_END并设置获胜者为玩家1。否则切换当前玩家gameState STATE_ATTACK_P2。void handleAttackP1State() { // 移动光标 if (controller1.buttonJustPressed(UP_BUTTON) cursorY 0) cursorY--; // ... 其他方向 // 绘制光标闪烁效果 if ((millis() / 200) % 2 0) { // 每200ms切换一次 matrixAttackP1.drawPixel(cursorX, cursorY, matrix.Color(255, 255, 0)); // 黄色 } // 确认攻击 if (controller1.buttonJustPressed(A_BUTTON)) { if (attackGridP1[cursorY][cursorX] ! ATTACK_NONE) { // 该点已攻击过给予提示如短促蜂鸣声 return; } bool hit false; uint8_t sunkShipIndex 255; // 记录被击沉的船索引 for (int i 0; i 5; i) { if (fleetP2[i].isHit(cursorX, cursorY)) { hit true; attackGridP1[cursorY][cursorX] ATTACK_HIT; // 更新防御屏对应gridP2中的位置 matrixDefenseP2.drawPixel(cursorX, cursorY, COLOR_HIT_YELLOW); myDFPlayer.play(SOUND_HIT); // 播放命中音 if (fleetP2[i].isSunk()) { sunkShipIndex i; myDFPlayer.play(SOUND_SINK); // 标记整艘船为击沉需要知道船的所有格子坐标 markShipAsSunkOnGrid(fleetP2[i], attackGridP1, ATTACK_SUNK); } break; // 一颗炮弹不可能击中两艘船 } } if (!hit) { attackGridP1[cursorY][cursorX] ATTACK_MISS; matrixAttackP1.drawPixel(cursorX, cursorY, COLOR_MISS_BLUE); myDFPlayer.play(SOUND_MISS); } // 检查游戏是否结束 bool allSunk true; for (int i 0; i 5; i) { if (!fleetP2[i].isSunk()) { allSunk false; break; } } if (allSunk) { winner PLAYER_1; gameState STATE_END; } else { // 切换回合 gameState STATE_ATTACK_P2; // 重置光标到中心或其他起始位置 cursorX 8; cursorY 8; } } }4.4 全局显示刷新与双屏同步我们有四块物理屏幕但逻辑上是两个玩家的“攻击屏”和“防御屏”。在代码中我们创建了两个Adafruit_NeoMatrix对象matrixAttackP1,matrixDefenseP1等但实际上每个对象控制着串联的两块物理面板。关键点Adafruit_NeoMatrix在初始化时可以通过参数指定面板的排列方式。例如如果我们把两块16x16面板上下拼接成一个16x32的虚拟矩阵初始化代码可能如下Adafruit_NeoMatrix matrixPlayer1 Adafruit_NeoMatrix( 16, 32, // 宽16像素高32像素两块面板 PIN_MATRIX_P1, // 数据引脚 NEO_MATRIX_TOP NEO_MATRIX_LEFT NEO_MATRIX_ROWS NEO_MATRIX_ZIGZAG, NEO_GRB NEO_KHZ800 );然后我们在绘图时(0,0)到(15,15)是上半部分攻击屏(0,16)到(15,31)是下半部分防御屏。这样用一个对象就控制了两块屏简化了逻辑。在loop()的末尾我们需要调用所有矩阵对象的.show()方法来推送显示数据。为了优化可以设置一个dirty flag只有当某个屏幕的内容确实发生变化时才调用其.show()以减少不必要的总线通信。5. 组装、调试与问题排查实录当代码编写完毕烧录到Arduino后真正的挑战才刚刚开始——将所有的硬件部件组装起来并解决那些意料之外的问题。5.1 分步组装流程3D打印与预处理将所有外壳零件打印好进行必要的打磨特别是卡扣和螺丝孔位确保装配顺畅。用砂纸轻轻打磨亚克力扩散板边缘防止割手。电路连接与测试在壳外进行先电源后信号首先只连接LED矩阵到独立电源用一段简单的测试程序如让所有LED显示白色检查每块面板是否正常点亮电源是否过载发烫。逐模块添加断开电源连接Arduino和DFPlayer上传一个播放指定音效的程序测试音频系统。接着连接一个NES手柄上传手柄测试程序在串口监视器中查看按键数据是否正确。最后串联所有LED将四块面板的数据线按设计串联好上传一个简单的图形测试程序检查四块屏的显示顺序和方向是否正确。Adafruit_NeoMatrix的构造函数参数如NEO_MATRIX_TOP/BOTTOM,ZIGZAG等就是用来调整物理排列与逻辑坐标映射的可能需要反复调整。内部安装与固定将测试好的LED面板用螺丝或卡扣固定到外壳内对应的网格后。将扩散板安装在面板前方。将Arduino、DFPlayer、电源模块用螺丝或尼龙柱固定在外壳底座上。将喇叭固定在预留的出声孔附近。布线管理这是保证长期稳定性的关键。使用扎带或线槽将电源线粗和信号线细分开捆扎。电源正负极尽量用不同颜色的导线区分。数据线LED信号线、手柄线避免与电源线长距离平行走线以减少干扰。如果无法避免尽量垂直交叉。最终集成与封闭将所有连接器插牢再次上电进行全功能测试。确认无误后盖上外壳拧紧螺丝。5.2 典型问题与解决方案速查表以下是我们实际开发中遇到的一些“坑”及其解决方法问题现象可能原因排查步骤与解决方案LED面板部分不亮或闪烁1. 电源功率不足或电压跌落。2. 数据线连接顺序错误或接触不良。3. 第一个LED损坏导致信号无法向后传递。4. 程序中的LED数量定义错误。1.测量电源在LED全白时测量面板输入端的电压。若低于4.5V需检查电源容量和导线线径。在电源端并联大电容如1000µF。2.检查数据流确认DIN和DOUT的连接顺序。用测试程序单独点亮每一块面板定位故障点。3.旁路测试如果怀疑第一块面板损坏尝试将信号线直接接到第二块面板的DIN看后续面板是否正常。4.检查代码确认Adafruit_NeoPixel或NeoMatrix初始化时设置的LED总数是否正确4*2561024。手柄按键无反应或乱跳1. 引脚连接错误。2. 时序问题读取速度太快或太慢。3. 未进行按键消抖。4. 共地问题。1.核对引脚用万用表确认手柄的Clock,Latch,Data线是否与代码中定义的Arduino引脚正确连接。2.调整延时在Latch和Clock信号中加入微小延时delayMicroseconds(5)严格遵循NES手柄的时序图。3.添加消抖在检测到按键按下后延时20-50ms再次读取确认状态。4.确保共地手柄的GND必须与Arduino的GND可靠连接。DFPlayer无声音或播放错误1. 串口接线错误RX/TX交叉。2. 电平不匹配5V vs 3.3V。3. SD卡格式或文件问题。4. 供电不足。1.交叉接线Arduino的TX接DFPlayer的RXArduino的RX接DFPlayer的TX。2.电平转换在ArduinoTX到DFPlayerRX之间串联1kΩ电阻。3.检查SD卡格式化为FAT32音频文件命名为4位数字如0001.mp3放在根目录。尝试用电脑播放确认文件无损。4.独立供电确保DFPlayer有独立的5V供电或从电源模块取电避免从Arduino的5V引脚取电。游戏运行卡顿或复位1. 内存不足堆栈溢出。2.loop()循环中有长时间阻塞操作如delay()。3. 电源干扰导致Arduino复位。1.优化内存使用F()宏将长字符串存到Flash如Serial.println(F(Hello))减少全局数组大小使用PROGMEM存储常量数据如图像数组。2.非阻塞设计用millis()代替delay()进行定时。将音效播放、动画等设计为非阻塞式。3.加强电源滤波在Arduino的VIN和GND之间靠近板子处并联一个100µF电解电容和一个0.1µF陶瓷电容。确保LED电源与Arduino电源的地线良好连接。屏幕显示错位或镜像Adafruit_NeoMatrix初始化参数设置错误。调整Adafruit_NeoMatrix构造函数的第四个参数。这是一个位掩码组合NEO_MATRIX_TOP/BOTTOM、LEFT/RIGHT、ROWS/COLUMNS、ZIGZAG/PROGRESSIVE等标志。例如如果屏幕上下颠倒就加上NEO_MATRIX_BOTTOM。需要根据物理连接和安装方向耐心测试。5.3 调试技巧与心得串口打印是你的好朋友在代码关键节点如状态转换、按键按下、命中判断添加Serial.print()语句输出变量值。这是追踪程序逻辑流最直接的方法。分而治之不要一次性写完全部代码再调试。先写一个让一块LED屏显示测试图案的程序调通。再写手柄测试程序调通。最后将它们和游戏逻辑整合。可视化调试对于游戏状态这种复杂数据可以尝试在串口监视器上用字符画的形式打印出16x16的网格直观看到船只放置和攻击记录比看一堆数字高效得多。压力测试完成基本功能后进行快速点击测试、长时间运行测试看看是否有内存泄漏内存逐渐减少、复位或死机现象。版本控制使用Git如PlatformIO的版本控制功能或Arduino IDE的第三方插件管理代码。每次实现一个稳定功能就提交一次这样当改出新bug时可以轻松回退。从一堆散乱的元件到一台可以流畅对战的游戏机组装和调试阶段耗费的时间往往远超编码。但每解决一个问题你对整个系统的理解就加深一层。当最终两个玩家围坐在你制作的游戏机前沉浸在对战中的那一刻所有的调试和抓狂都是值得的。这个项目不仅仅是一个游戏更是一个关于系统集成、问题解决和工程实践的完整故事。
基于Arduino与状态机实现战舰游戏：硬件集成与软件架构全解析
发布时间：2026/5/28 19:15:31
1. 项目概述从零打造一个实体化的战舰游戏如果你玩过经典的棋盘游戏“战舰”Battleship在西班牙也叫“Hundir la flota”一定对那种猜测坐标、击沉对方舰队的紧张感印象深刻。但把这款游戏从纸面搬到现实变成一个会发光、会发声、能双人对战的实体电子装置感觉就完全不一样了。这正是我们当时在“创意电子学”课程上想做的事——不是简单地写个软件模拟而是真正动手从电路板、LED屏幕到3D打印外壳完整地造出一个能玩的游戏机。这个项目的核心是Arduino UNO R4 Minima一块性能足够强劲且性价比很高的微控制器。我们用四块16x16的Adafruit LED矩阵面板构成了两个玩家的战场显示屏通过状态机来清晰管理游戏复杂的流程比如放置船只、轮流攻击并用DFPlayer模块来播放击中、失误或胜利的音效增强沉浸感。整个系统的软件骨架是用C搭建的充分利用了面向对象的特性来管理游戏中的各种实体比如战舰对象。为什么选择这个方案首先LED矩阵作为显示方案比LCD屏更具视觉冲击力动态点亮的效果很适合表现战舰被击中的过程。其次状态机是嵌入式游戏开发的经典模式它能将游戏“开始-布阵-攻击A-攻击B-结束”这些离散的阶段管理得井井有条避免代码变成一团乱麻。最后选择Arduino R4 Minima和成熟的Adafruit库意味着我们能把主要精力放在游戏逻辑和交互设计上而不是反复调试底层驱动。无论你是嵌入式开发的初学者想找一个综合性的练手项目还是有一定经验的爱好者希望了解如何将多个硬件模块显示、输入、音频和复杂的软件状态机整合成一个完整产品这个案例都能提供一条清晰的路径。接下来我会拆解我们从硬件设计、软件架构到组装调试的全过程并分享那些在教程里不会写的“踩坑”经验。2. 硬件设计与选型背后的考量硬件是项目的骨架设计之初的决策直接影响后续开发的复杂度和最终体验。我们的目标是做一个外观有趣、交互直观的双人对战设备而不是一个裸露着线材的开发板。2.1 核心控制器为什么是Arduino R4 Minima在项目启动时我们评估了几款常见的微控制器。经典的Arduino UNO R3引脚丰富、生态成熟但其8位的AVR处理器和有限的内存2KB SRAM, 32KB Flash在驱动多块LED矩阵并处理复杂游戏逻辑时可能会捉襟见肘。ESP32功能强大且自带Wi-Fi但对于这个纯线下对战、无需联网的项目来说有些功能过剩且功耗和引脚布局需要额外考虑。Arduino UNO R4 Minima成为了一个平衡的选择。它基于32位的RA4M1微控制器48MHz拥有256KB的Flash和32KB的SRAM性能远超R3。这意味着我们可以更从容地存储和处理LED矩阵的帧缓冲区、游戏状态变量以及音效文件的索引。同时它完全兼容UNO的引脚布局和盾板生态降低了学习和迁移成本。其内置的12位DAC虽然本项目未使用和更多高级外设也为未来升级留下了空间。注意R4 Minima没有USB转串口芯片需要通过其本身的USB-C接口进行编程这在初次使用时需要确认你的Arduino IDE版本是否已支持R4系列并安装了对应板卡包。2.2 显示系统LED矩阵面板的驱动与挑战显示部分是整个项目最“烧钱”但也最出效果的地方。我们为每个玩家配置了两块16x16的Adafruit LED矩阵面板一块作为“攻击屏”显示你猜测的敌方海域另一块作为“防御屏”显示你的舰队布置及被攻击情况。这样两个玩家可以并排而坐各自拥有独立的视野体验更接近真实的棋盘游戏。每块16x16面板有256个LED。我们使用的是WS2812B或类似智能RGB LED也就是常说的“NeoPixel”。这种LED的优点在于每个像素点都可以独立寻址和控制颜色只需要一根数据线进行串联通信极大地简化了布线。四块面板就是1024个LED这对微控制器的内存和计算能力是一个考验。驱动原理我们使用了Adafruit_NeoMatrix库它建立在Adafruit_NeoPixel和Adafruit_GFX库之上。NeoPixel库负责底层时序将颜色数据每个LED需要24位R、G、B各8位通过特定的单线协议发送出去。GFX库提供了画点、画线、绘制位图等高级图形函数。而NeoMatrix库则将一长串LED1024个在逻辑上组织成一块或几块二维矩阵方便我们使用坐标x, y来操作。连线要点所有面板的VCC和GND必须连接到独立的大功率5V电源后面会讲切勿尝试从Arduino板取电电流绝对不够。数据线DIN需要串联Arduino的数字引脚例如D6连接到第一块面板的DIN第一块面板的DOUT连接到第二块面板的DIN以此类推。这种串联方式意味着每个LED的刷新会有微小的级联延迟但对于静态或慢速动画的游戏界面来说完全无感。2.3 输入设备复古手柄的现代化应用为了追求更好的操作手感和怀旧氛围我们选择了经典的任天堂NES手柄作为输入设备。它只有几个简单的按键A, B, Start, Select方向键完美契合游戏需求方向键移动光标A键确认攻击/放置B键功能旋转船只/菜单操作。接口与通信NES手柄使用一种简单的同步串行协议。它只有5根线VCC,GND,Clock,Latch,Data。我们需要用Arduino的三个数字引脚来模拟这个时序Latch引脚置高电平告诉手柄“准备数据”。短暂延迟后Latch置低。然后在Clock引脚产生一个脉冲高-低同时从Data引脚读取一位数据代表一个按键的状态通常低电平表示按下。重复16个脉冲就能读取所有按键的状态。在代码中我们需要根据时序图精确控制这些引脚的高低电平变化。网上有现成的NESController库但自己实现一遍这个协议对于理解底层硬件通信非常有帮助。2.4 音频系统DFPlayer Mini的集成“无声”的游戏缺乏灵魂。我们使用DFPlayer Mini模块来播放音效。这是一个非常廉价且易用的MP3解码模块可以直接读取microSD卡中的音频文件并通过一个简单的串口指令UART进行控制。连接方式DFPlayer的RX、TX连接到Arduino的某个软件串口例如D2,D3VCC和GND接5V电源。音频输出直接连接一个小喇叭。这里有个关键细节DFPlayer的RX引脚逻辑电平是3.3V而Arduino R4 Minima的IO口输出是5V。虽然很多情况下直接连接也能工作但为了稳定和长期可靠最好在Arduino的TX连接DFPlayerRX之间串联一个1kΩ的电阻进行分压或者使用电平转换模块。软件控制通过DFRobotDFPlayerMini库我们可以轻松发送指令如指定曲目号播放、暂停、设置音量等。我们将不同的音效放置船只、发射炮弹、击中、击沉、失误、胜利录制成简短的MP3文件并按顺序命名如0001.mp3,0002.mp3存入SD卡。游戏中只需调用myDFPlayer.play(1);即可播放击中音效。2.5 供电设计不容忽视的“动力心脏”这是硬件部分最容易出问题的地方。1024个WS2812B LED如果全亮白色每个LED电流约60mA理论峰值电流将超过60A虽然游戏中几乎不可能全白全亮但我们必须按最坏情况设计电源。我们为四块面板准备了一个独立的10A、5V开关电源。这个电源专门负责给所有LED供电。Arduino R4 Minima、DFPlayer、手柄等则可以从另一个小功率的5V电源或USB取电或者如果开关电源功率足够且稳定也可以从其上分出一路给控制部分供电但一定要确保共地。关键实践电源线要粗从电源到LED面板的VCC和GND线必须使用足够粗的导线建议18AWG或更粗以减少压降和发热。多点并联供电不要只从一个点给长长的LED灯带供电。应该在电源端引出多组正负线分别连接到不同面板的输入端甚至一块面板的两端以确保末端LED的电压稳定。添加大电容在LED电源的输入端并联一个大容量电解电容如1000µF 16V可以吸收LED快速刷新时产生的瞬间电流脉冲防止电源电压被拉低导致Arduino复位。散热10A的电源模块工作时会发热我们为其加装了一个小风扇进行强制风冷确保长时间游戏稳定。2.6 结构设计3D打印外壳的工程化思考为了让项目从一个“原型”变成一件“产品”我们使用Tinkercad设计了船型外壳并用PLA材料3D打印。设计时需要考虑结构强度外壳要能稳固地容纳四块LED面板、Arduino、电源、音箱等组件并承受操作时的外力。散热开孔在电源和Arduino附近设计通风孔配合风扇形成风道。装配友好设计卡槽和螺丝柱我们用了大量的M2螺丝让LED面板能平整嵌入电路板能固定线材能有序排布。光扩散直接在裸露的LED点阵上看会刺眼且像素感强。我们在LED面板前加装了一层乳白色的亚克力扩散板让光线变得柔和均匀视觉效果提升巨大。硬件部分就像搭积木每个模块的选择和连接都环环相扣。理清电源、信号、结构这三条线项目就成功了一半。3. 软件架构用状态机驾驭复杂游戏逻辑当硬件准备就绪大脑——也就是软件——的设计就成了关键。对于一个包含菜单、布阵、轮流攻击、胜负判断的游戏如果只用一堆if-else和全局变量代码很快就会变得难以维护和调试。我们采用了有限状态机来结构化整个游戏流程这是嵌入式系统乃至游戏开发中处理复杂流程的经典模式。3.1 状态机设计游戏的指挥中心状态机把游戏流程抽象成几个明确的“状态”每个状态下系统只关心特定的输入和完成特定的任务。状态之间的转换由明确的事件触发。我们定义了五个核心状态START开始显示游戏标题和主菜单。玩家可以调整音量和屏幕亮度按下“开始”键进入下一状态。PLACEMENT布阵两位玩家各自在自己的“防御屏”上布置舰队。玩家用方向键移动高亮框用B键旋转船只用A键确认放置。只有当两位玩家都按下“完成”键后状态才转换。ATTACK_P1玩家1攻击玩家1的回合。他在自己的“攻击屏”对应玩家2的防御屏上移动光标按A键向选定坐标开火。系统判断命中与否更新屏幕播放音效。如果击沉了所有敌舰则跳转到END状态否则切换到玩家2的回合。ATTACK_P2玩家2攻击与ATTACK_P1对称玩家2操作。END结束显示胜利者播放胜利/失败音效等待复位或重启。在loop()函数中我们只做一个大的switch-case根据当前状态gameState的值执行对应状态的处理函数。这种结构非常清晰void loop() { switch (gameState) { case STATE_START: handleStartState(); break; case STATE_PLACEMENT: handlePlacementState(); break; case STATE_ATTACK_P1: handleAttackP1State(); break; case STATE_ATTACK_P2: handleAttackP2State(); break; case STATE_END: handleEndState(); break; } // 其他周期性任务如刷新显示即使状态不变也要刷新 matrix.show(); }3.2 面向对象封装战舰类的实现游戏的核心实体是“战舰”。我们使用C的类来封装战舰的属性与行为这比使用多个分散的数组要清晰得多。这体现在BattleShip.hpp和BattleShip.cpp中。BattleShip类设计// BattleShip.hpp #ifndef BATTLESHIP_H #define BATTLESHIP_H #include Arduino.h class BattleShip { public: // 船只类型枚举 enum ShipType { BARQUE1, CRUISER, LONG_SHIP, SUBMARINE, AIRCRAFT_CARRIER }; // 构造函数初始化类型、长度、名称 BattleShip(ShipType type); // 核心方法 bool place(uint8_t startX, uint8_t startY, bool isHorizontal); bool isHit(uint8_t x, uint8_t y); bool isSunk() const; // 获取属性 uint8_t getLength() const { return length; } ShipType getType() const { return type; } // ... 其他getter/setter private: ShipType type; uint8_t length; char name[20]; bool horizontal; uint8_t posX, posY; // 船头坐标 bool hits[5]; // 记录每个部位是否被击中最大长度5 }; #endif关键方法解析place()函数在布阵状态被调用。它需要检查欲放置的位置从startX, startY开始沿水平或垂直方向length格是否超出边界以及是否与已放置的其他船只重叠。这里需要访问一个全局的或传入的“海域地图”数组进行碰撞检测。isHit()函数在攻击状态被调用。传入攻击坐标(x, y)判断该坐标是否位于这条船的船体上。如果是则标记对应的hits[]数组位置为true并返回true表示命中。isSunk()函数检查hits[]数组是否全部为true是则意味着整条船被击沉。通过这样的封装在主程序BattleShip.ino中我们只需要管理一个BattleShip对象的数组例如BattleShip fleetP1[5];调用它们的方法逻辑非常清晰。3.3 图形与音频驱动库函数的有效运用LED矩阵显示我们创建了一个Adafruit_NeoMatrix全局对象。在每一个游戏状态下我们都需要在矩阵上绘制不同的内容。布阵状态在防御屏上用不同颜色绘制已放置的船只例如未放置是网格已放置是蓝色船体用一个高亮框表示当前正在移动的船只位置。攻击状态在攻击屏上用不同颜色标记历史攻击点未攻击是暗色未命中是蓝色命中是绿色击沉是红色。同时防御屏上自己的船被击中部位要变成黄色。 我们使用matrix.drawPixel(x, y, color)来画点matrix.drawRect(x, y, w, h, color)来画框matrix.fillRect来填充区域。为了绘制复杂的标题图片我们使用了工具将位图转换成RGB数组存放到TextoInicio.h这样的头文件中然后用matrix.drawRGBBitmap()函数来显示。音频播放在setup()中初始化DFPlayer对象并设置音量。在游戏的关键节点调用播放函数。例如在isHit()函数返回true时播放命中音效在isSunk()返回true时播放击沉音效。这里要注意非阻塞式播放即调用play()后立即返回不要使用delay()等待播放完成以免卡住游戏主循环。3.4 双循环与时间管理让游戏流畅响应嵌入式游戏没有操作系统来调度任务我们需要在loop()函数中自己管理一切。这里有两个核心循环概念游戏逻辑循环即上面状态机switch-case的部分处理玩家输入、更新游戏状态、判断胜负。显示刷新循环无论游戏逻辑进行到哪一步LED矩阵都需要以一定的频率比如30-60Hz刷新否则会出现闪烁。matrix.show()函数调用会阻塞一小段时间与LED数量成正比将它放在loop()的最后确保每一帧逻辑计算后都刷新一次显示。防抖与输入处理手柄按键读取需要防抖。简单的做法是在检测到按键按下后延迟几十毫秒再读一次确认是否仍为按下状态。更稳健的做法是记录按键状态变化的时间戳。性能优化直接操作1024个LED的缓冲区是内存和计算密集型的。优化方法包括只更新发生变化的部分像素而不是每帧重绘整个屏幕。使用更低的颜色深度比如12位色而非24位色来节省内存和传输时间。确保matrix.setBrightness()设置在一个合理的值如50-100过高的亮度不仅耗电也会增加刷新时间。软件架构是项目的灵魂。一个好的状态机设计能让复杂的游戏逻辑变得模块化、可调试良好的面向对象设计让数据管理井然有序而对底层库的深入理解则能充分发挥硬件性能。4. 核心功能实现与代码剖析有了清晰的架构接下来就是填充血肉实现每个状态的具体功能。这里我会深入几个关键环节展示代码是如何与硬件交互并最终形成游戏体验的。4.1 状态一START状态——菜单与初始化handleStartState()函数负责显示动态标题、绘制菜单选项开始、设置音量、设置亮度并响应手柄输入。void handleStartState() { // 1. 绘制静态背景标题位图 matrix.drawRGBBitmap(0, 0, titleBitmap, 16, 16); // 2. 绘制动态菜单光标 uint32_t cursorColor matrix.ColorHSV(millis() * 10, 255, 255); // 生成彩虹色 matrix.fillRect(0, menuCursorY * 8, 16, 2, cursorColor); // 在菜单项旁画一个闪烁光标 // 3. 读取手柄输入 readController(controller1); if (controller1.buttonJustPressed(A_BUTTON)) { if (menuCursorY 0) { // “开始游戏”选项 gameState STATE_PLACEMENT; resetGame(); // 重置所有游戏数据 } else if (menuCursorY 1) { // 进入音量调节子模式 adjustVolume(); } // ... 其他菜单项处理 } if (controller1.buttonJustPressed(UP_BUTTON)) { menuCursorY (menuCursorY - 1 MENU_ITEMS) % MENU_ITEMS; // 循环向上 } // ... 其他方向键处理 }实操心得菜单光标的视觉反馈很重要。我们用一个随时间变化的颜色ColorHSV配合millis()来绘制它让界面立刻生动起来。buttonJustPressed是一个自定义函数它通过比较当前帧和上一帧的按键状态来识别“刚刚按下”的瞬间避免长按触发多次。4.2 状态二PLACEMENT状态——舰队的布阵逻辑这是游戏中最复杂的逻辑之一。玩家需要将5艘不同长度2-5格的船只放置在自己的16x16网格上不能重叠不能超出边界。数据结构我们用一个二维数组uint8_t gridP1[16][16]来表示玩家1的海域。0代表空水1-5代表放置了对应类型的船只用BattleShip::ShipType枚举值6代表无效用于碰撞检测临时标记。布阵流程玩家选择一艘未放置的船按顺序或按选择键。用方向键移动一个高亮框框的大小等于船的长度和当前方向。按B键旋转船只水平/垂直切换。按A键尝试放置。此时调用当前船只对象的place()方法。place()方法内部进行碰撞检测遍历船只要占用的每一个格子检查grid数组中对应位置是否为0并且坐标在0-15范围内。如果检测通过place()函数会更新船只对象的内部位置属性并返回true。主程序随后更新grid数组并在LED防御屏上将该区域绘制为船只颜色如蓝色。如果检测失败重叠或出界给玩家一个视觉反馈如高亮框快速闪烁红色船只保持未放置状态。bool BattleShip::place(uint8_t startX, uint8_t startY, bool isHorizontal) { // 边界检查 if (isHorizontal) { if (startX length 16) return false; } else { if (startY length 16) return false; } // 碰撞检测需要访问全局或传入的grid for (int i 0; i length; i) { uint8_t checkX isHorizontal ? startX i : startX; uint8_t checkY isHorizontal ? startY : startY i; if (grid[checkY][checkX] ! 0) { // 不为0表示已有船只占用 return false; } } // 放置成功更新对象属性和grid posX startX; posY startY; horizontal isHorizontal; for (int i 0; i length; i) { uint8_t markX isHorizontal ? posX i : posX; uint8_t markY isHorizontal ? posY : posY i; grid[markY][markX] type; // 在grid中标记船只类型 } return true; }避坑指南碰撞检测的grid数组必须是玩家布阵海域的“唯一真相源”。所有绘制和后续命中判断都基于它。在放置成功后更新它在重置游戏时清零它。避免在多个地方维护同一份数据否则极易出现状态不一致的bug。4.3 状态三/四ATTACK状态——攻击判定与游戏核心攻击状态是游戏的核心循环。以玩家1攻击为例handleAttackP1State光标移动读取玩家1手柄的方向键在攻击屏对应玩家2的gridP2上移动一个光标一个单像素高亮框或一个闪烁的点。确认攻击按下A键。获取当前光标坐标(atkX, atkY)。有效性检查检查该坐标在攻击记录数组attackGridP1[16][16]中是否已被攻击过。如果是则忽略此次操作或给出提示。遍历判定遍历玩家2的所有船只对象fleetP2[5]对每艘船调用其isHit(atkX, atkY)方法。结果处理如果任何一艘船的isHit返回true则命中。在攻击屏attackGridP1上将该点标记为“命中”如绿色。在玩家2的防御屏即玩家1看不到但硬件上另一块屏上将该点标记为“被击中”如黄色。播放命中音效。检查被命中的船只是否isSunk()。如果是播放击沉音效并将该船所有格子在攻击屏上标记为“击沉”如红色同时在防御屏上也做相应标记。如果所有船的isHit都返回false则未命中。在攻击屏上将该点标记为“未命中”如蓝色。播放失误音效。回合转换与胜负判断无论命中与否本次攻击结束。检查玩家2的所有船只是否都已沉没遍历fleetP2检查所有isSunk()。如果全部沉没游戏状态跳转到STATE_END并设置获胜者为玩家1。否则切换当前玩家gameState STATE_ATTACK_P2。void handleAttackP1State() { // 移动光标 if (controller1.buttonJustPressed(UP_BUTTON) cursorY 0) cursorY--; // ... 其他方向 // 绘制光标闪烁效果 if ((millis() / 200) % 2 0) { // 每200ms切换一次 matrixAttackP1.drawPixel(cursorX, cursorY, matrix.Color(255, 255, 0)); // 黄色 } // 确认攻击 if (controller1.buttonJustPressed(A_BUTTON)) { if (attackGridP1[cursorY][cursorX] ! ATTACK_NONE) { // 该点已攻击过给予提示如短促蜂鸣声 return; } bool hit false; uint8_t sunkShipIndex 255; // 记录被击沉的船索引 for (int i 0; i 5; i) { if (fleetP2[i].isHit(cursorX, cursorY)) { hit true; attackGridP1[cursorY][cursorX] ATTACK_HIT; // 更新防御屏对应gridP2中的位置 matrixDefenseP2.drawPixel(cursorX, cursorY, COLOR_HIT_YELLOW); myDFPlayer.play(SOUND_HIT); // 播放命中音 if (fleetP2[i].isSunk()) { sunkShipIndex i; myDFPlayer.play(SOUND_SINK); // 标记整艘船为击沉需要知道船的所有格子坐标 markShipAsSunkOnGrid(fleetP2[i], attackGridP1, ATTACK_SUNK); } break; // 一颗炮弹不可能击中两艘船 } } if (!hit) { attackGridP1[cursorY][cursorX] ATTACK_MISS; matrixAttackP1.drawPixel(cursorX, cursorY, COLOR_MISS_BLUE); myDFPlayer.play(SOUND_MISS); } // 检查游戏是否结束 bool allSunk true; for (int i 0; i 5; i) { if (!fleetP2[i].isSunk()) { allSunk false; break; } } if (allSunk) { winner PLAYER_1; gameState STATE_END; } else { // 切换回合 gameState STATE_ATTACK_P2; // 重置光标到中心或其他起始位置 cursorX 8; cursorY 8; } } }4.4 全局显示刷新与双屏同步我们有四块物理屏幕但逻辑上是两个玩家的“攻击屏”和“防御屏”。在代码中我们创建了两个Adafruit_NeoMatrix对象matrixAttackP1,matrixDefenseP1等但实际上每个对象控制着串联的两块物理面板。关键点Adafruit_NeoMatrix在初始化时可以通过参数指定面板的排列方式。例如如果我们把两块16x16面板上下拼接成一个16x32的虚拟矩阵初始化代码可能如下Adafruit_NeoMatrix matrixPlayer1 Adafruit_NeoMatrix( 16, 32, // 宽16像素高32像素两块面板 PIN_MATRIX_P1, // 数据引脚 NEO_MATRIX_TOP NEO_MATRIX_LEFT NEO_MATRIX_ROWS NEO_MATRIX_ZIGZAG, NEO_GRB NEO_KHZ800 );然后我们在绘图时(0,0)到(15,15)是上半部分攻击屏(0,16)到(15,31)是下半部分防御屏。这样用一个对象就控制了两块屏简化了逻辑。在loop()的末尾我们需要调用所有矩阵对象的.show()方法来推送显示数据。为了优化可以设置一个dirty flag只有当某个屏幕的内容确实发生变化时才调用其.show()以减少不必要的总线通信。5. 组装、调试与问题排查实录当代码编写完毕烧录到Arduino后真正的挑战才刚刚开始——将所有的硬件部件组装起来并解决那些意料之外的问题。5.1 分步组装流程3D打印与预处理将所有外壳零件打印好进行必要的打磨特别是卡扣和螺丝孔位确保装配顺畅。用砂纸轻轻打磨亚克力扩散板边缘防止割手。电路连接与测试在壳外进行先电源后信号首先只连接LED矩阵到独立电源用一段简单的测试程序如让所有LED显示白色检查每块面板是否正常点亮电源是否过载发烫。逐模块添加断开电源连接Arduino和DFPlayer上传一个播放指定音效的程序测试音频系统。接着连接一个NES手柄上传手柄测试程序在串口监视器中查看按键数据是否正确。最后串联所有LED将四块面板的数据线按设计串联好上传一个简单的图形测试程序检查四块屏的显示顺序和方向是否正确。Adafruit_NeoMatrix的构造函数参数如NEO_MATRIX_TOP/BOTTOM,ZIGZAG等就是用来调整物理排列与逻辑坐标映射的可能需要反复调整。内部安装与固定将测试好的LED面板用螺丝或卡扣固定到外壳内对应的网格后。将扩散板安装在面板前方。将Arduino、DFPlayer、电源模块用螺丝或尼龙柱固定在外壳底座上。将喇叭固定在预留的出声孔附近。布线管理这是保证长期稳定性的关键。使用扎带或线槽将电源线粗和信号线细分开捆扎。电源正负极尽量用不同颜色的导线区分。数据线LED信号线、手柄线避免与电源线长距离平行走线以减少干扰。如果无法避免尽量垂直交叉。最终集成与封闭将所有连接器插牢再次上电进行全功能测试。确认无误后盖上外壳拧紧螺丝。5.2 典型问题与解决方案速查表以下是我们实际开发中遇到的一些“坑”及其解决方法问题现象可能原因排查步骤与解决方案LED面板部分不亮或闪烁1. 电源功率不足或电压跌落。2. 数据线连接顺序错误或接触不良。3. 第一个LED损坏导致信号无法向后传递。4. 程序中的LED数量定义错误。1.测量电源在LED全白时测量面板输入端的电压。若低于4.5V需检查电源容量和导线线径。在电源端并联大电容如1000µF。2.检查数据流确认DIN和DOUT的连接顺序。用测试程序单独点亮每一块面板定位故障点。3.旁路测试如果怀疑第一块面板损坏尝试将信号线直接接到第二块面板的DIN看后续面板是否正常。4.检查代码确认Adafruit_NeoPixel或NeoMatrix初始化时设置的LED总数是否正确4*2561024。手柄按键无反应或乱跳1. 引脚连接错误。2. 时序问题读取速度太快或太慢。3. 未进行按键消抖。4. 共地问题。1.核对引脚用万用表确认手柄的Clock,Latch,Data线是否与代码中定义的Arduino引脚正确连接。2.调整延时在Latch和Clock信号中加入微小延时delayMicroseconds(5)严格遵循NES手柄的时序图。3.添加消抖在检测到按键按下后延时20-50ms再次读取确认状态。4.确保共地手柄的GND必须与Arduino的GND可靠连接。DFPlayer无声音或播放错误1. 串口接线错误RX/TX交叉。2. 电平不匹配5V vs 3.3V。3. SD卡格式或文件问题。4. 供电不足。1.交叉接线Arduino的TX接DFPlayer的RXArduino的RX接DFPlayer的TX。2.电平转换在ArduinoTX到DFPlayerRX之间串联1kΩ电阻。3.检查SD卡格式化为FAT32音频文件命名为4位数字如0001.mp3放在根目录。尝试用电脑播放确认文件无损。4.独立供电确保DFPlayer有独立的5V供电或从电源模块取电避免从Arduino的5V引脚取电。游戏运行卡顿或复位1. 内存不足堆栈溢出。2.loop()循环中有长时间阻塞操作如delay()。3. 电源干扰导致Arduino复位。1.优化内存使用F()宏将长字符串存到Flash如Serial.println(F(Hello))减少全局数组大小使用PROGMEM存储常量数据如图像数组。2.非阻塞设计用millis()代替delay()进行定时。将音效播放、动画等设计为非阻塞式。3.加强电源滤波在Arduino的VIN和GND之间靠近板子处并联一个100µF电解电容和一个0.1µF陶瓷电容。确保LED电源与Arduino电源的地线良好连接。屏幕显示错位或镜像Adafruit_NeoMatrix初始化参数设置错误。调整Adafruit_NeoMatrix构造函数的第四个参数。这是一个位掩码组合NEO_MATRIX_TOP/BOTTOM、LEFT/RIGHT、ROWS/COLUMNS、ZIGZAG/PROGRESSIVE等标志。例如如果屏幕上下颠倒就加上NEO_MATRIX_BOTTOM。需要根据物理连接和安装方向耐心测试。5.3 调试技巧与心得串口打印是你的好朋友在代码关键节点如状态转换、按键按下、命中判断添加Serial.print()语句输出变量值。这是追踪程序逻辑流最直接的方法。分而治之不要一次性写完全部代码再调试。先写一个让一块LED屏显示测试图案的程序调通。再写手柄测试程序调通。最后将它们和游戏逻辑整合。可视化调试对于游戏状态这种复杂数据可以尝试在串口监视器上用字符画的形式打印出16x16的网格直观看到船只放置和攻击记录比看一堆数字高效得多。压力测试完成基本功能后进行快速点击测试、长时间运行测试看看是否有内存泄漏内存逐渐减少、复位或死机现象。版本控制使用Git如PlatformIO的版本控制功能或Arduino IDE的第三方插件管理代码。每次实现一个稳定功能就提交一次这样当改出新bug时可以轻松回退。从一堆散乱的元件到一台可以流畅对战的游戏机组装和调试阶段耗费的时间往往远超编码。但每解决一个问题你对整个系统的理解就加深一层。当最终两个玩家围坐在你制作的游戏机前沉浸在对战中的那一刻所有的调试和抓狂都是值得的。这个项目不仅仅是一个游戏更是一个关于系统集成、问题解决和工程实践的完整故事。
