1. 项目概述从像素点到复古街机几年前我在整理工作室的零件盒时翻出了几块尘封已久的MAX7219点阵模块和一块Arduino Uno。看着那些8x8的红色LED一个念头突然冒了出来能不能用这些最简单的元件复刻一个属于我们这代人的童年记忆——Pong这个想法最终催生了这个项目一个完全由Arduino驱动在LED点阵上运行的经典双人乒乓球游戏。这个“Arduino LED Matrix Pong”项目本质上是一个软硬件结合的嵌入式系统。它的核心玩法与1972年雅达利发布的那款开山鼻祖《Pong》一致两名玩家各自控制一块“球拍”在屏幕上下移动将“球”击打回去如果一方漏球则对方得分。不同之处在于我们的“屏幕”是一块或级联的多块8x8 LED点阵模块而“球拍”和“球”都是由一个个发光的像素点构成。MAX7219芯片负责驱动这些LEDArduino则作为大脑处理游戏逻辑、玩家输入和显示控制。它解决的不仅仅是一个“能不能做”的技术问题更是一个“如何优雅地做”的工程实践问题。对于硬件爱好者它是一次绝佳的入门实践涵盖了数字IO控制、SPI通信协议、中断处理、状态机编程等核心概念。对于怀旧玩家它则是一个可以放在桌面的微型街机其简单的交互和即时的反馈能带来最纯粹的电子游戏乐趣。无论你是想学习Arduino与外部芯片的交互还是想亲手打造一个有趣的桌面玩具这个项目都能提供一条清晰、可实现的路径。2. 核心硬件解析为何是MAX7219与Arduino的组合选择MAX7219驱动LED点阵而非直接使用Arduino的IO口扫描或者选择其他驱动芯片如TM1637、HT16K33背后有一系列工程上的权衡。2.1 MAX7219芯片点阵驱动的“瑞士军刀”MAX7219是一款集成化的共阴极LED显示驱动器。它之所以成为点阵项目的首选主要归功于几个关键特性SPI接口简化连接MAX7219通过简单的4线SPISerial Peripheral Interface与微控制器通信。你只需要连接Arduino的3个数字引脚DATA CLK LOAD/CS给它就能控制多达64个LED8x8。这极大节省了宝贵的IO口资源。如果直接用Arduino驱动8x8点阵采用行列扫描方式至少需要16个IO口8行8列这对于只有14个数字IO的Arduino Uno来说几乎是不可接受的。内置硬件扫描与多路复用芯片内部集成了多路复用扫描电路和动态驱动逻辑。这意味着Arduino不需要以很高的频率去逐行刷新LED只需通过SPI发送一次显示数据MAX7219就会自动负责后续的扫描刷新工作将CPU从繁重的显示刷新任务中解放出来使其能专注于游戏逻辑计算。灵活的级联能力单个MAX7219只能驱动一个8x8点阵。但它的设计允许轻松级联。只需将第一块的DOUT引脚连接到第二块的DIN引脚以此类推理论上可以驱动无限多的8x8模块形成一个更大的屏幕。这对于未来扩展游戏画面比如做一个更大的球场提供了可能。在我们的Pong项目中使用2块级联形成一个8x16的横向屏幕球场就显得宽敞多了。可编程亮度与译码模式芯片允许通过寄存器设置16级亮度我们可以根据环境光调节屏幕亮度。虽然Pong游戏用不到7段数码管的译码功能但这体现了芯片的通用性。注意市场上常见的“MAX7219点阵模块”已经将芯片、点阵、限流电阻和必要的滤波电容集成在了一块小PCB上。这大大降低了我们的焊接和调试难度是入门的最佳选择。购买时请确认是“共阴极”点阵模块。2.2 Arduino的定位游戏逻辑与交互的核心Arduino在这个项目中扮演着游戏主机的角色。它的核心任务包括游戏状态管理维护球的位置X Y坐标、速度X Y方向的分量、双方球拍的位置、比分等所有游戏状态变量。物理与碰撞计算每一帧更新球的位置新位置 旧位置 速度。计算球与上下边界、左右边界球拍的碰撞。与球拍的碰撞需要根据击球点计算反弹角度这是游戏手感的来源。玩家输入处理读取两个电位器模拟输入A0 A1的电压值将其映射为球拍在Y轴上的位置。这里使用了模拟输入为游戏带来了平滑的模拟控制体验而非生硬的数字按键。画面渲染根据最新的游戏状态计算出一帧8x16或更大的二进制点阵数据然后通过SPI总线发送给MAX7219驱动模块。游戏流程控制处理发球、得分、胜利判定等游戏规则。选择Arduino Uno是因为其性能足以应对这个级别的计算且生态丰富有成熟的LedControl等库支持MAX7219。如果使用更强大的ESP32或Teensy固然可以实现更复杂的特效或声音但对于经典的Pong而言Uno的简约与纯粹反而更贴合项目气质。3. 电路搭建与连接详解一个可靠的项目始于清晰的电路连接。下图展示了基于两块级联MAX7219模块的经典连接方法所需材料清单Arduino Uno 开发板 x1MAX7219 8x8 LED点阵模块 x2 用于级联成8x16屏幕10kΩ 电位器 x2 用于控制球拍面包板 x1公对公杜邦线 若干USB数据线 x1电路连接步骤供电连接将两个MAX7219模块的VCC引脚连接到Arduino的5V引脚GND引脚连接到Arduino的GND引脚。务必确保共地这是通信稳定的基础。SPI信号线连接核心第一块模块最靠近Arduino的DIN- Arduino 数字引脚11(MOSI)CLK- Arduino 数字引脚13(SCK)CS(或LOAD) - Arduino 数字引脚10(可自定义此处以10为例)第二块模块DIN-第一块模块的DOUT这是级联的关键CLK- 与第一块模块的CLK并联共同接到Arduino引脚13CS- 与第一块模块的CS并联共同接到Arduino引脚10这种接法意味着两个模块共享时钟和片选信号数据从Arduino发给模块1再通过模块1的DOUT传给模块2。当Arduino发送16字节的数据时模块1会拿走前8字节对应它驱动的点阵后8字节则会“流经”它传给模块2。玩家输入连接玩家1左侧电位器中间引脚接 Arduino 模拟输入A0两侧引脚分别接5V和GND。玩家2右侧电位器中间引脚接 Arduino 模拟输入A1两侧引脚分别接5V和GND。实操心得电源去耦如果你发现LED点阵在刷新时有轻微的闪烁或干扰尤其是在球快速移动时很可能是电源噪声。一个立竿见影的改进是在每个MAX7219模块的VCC和GND引脚之间就近焊接一个10μF的电解电容和一个0.1μF的陶瓷电容用于滤除低频和高频噪声。很多成品模块已经包含了这些电容但自己检查一下总是好的。4. 软件架构与核心代码实现我们将使用Arduino IDE进行开发并依赖一个非常优秀的库LedControl。可以通过IDE的库管理器直接搜索安装。4.1 初始化与显示框架#include LedControl.h // 参数DIN, CLK, CS/LOAD, 级联的模块数量 LedControl lc LedControl(11, 13, 10, 2); // 游戏区域定义 (8行 x 16列) const int SCREEN_WIDTH 16; const int SCREEN_HEIGHT 8; // 球拍相关 const int PADDLE_HEIGHT 3; // 球拍高度为3个像素 int paddleLeftY 2; // 左侧球拍顶部Y坐标 int paddleRightY 2; // 右侧球拍顶部Y坐标 const int PADDLE_LEFT_X 0; // 左侧球拍固定在第0列 const int PADDLE_RIGHT_X SCREEN_WIDTH - 1; // 右侧球拍固定在第15列 // 球相关 int ballX SCREEN_WIDTH / 2; int ballY SCREEN_HEIGHT / 2; int ballSpeedX 1; // 1表示向右-1表示向左 int ballSpeedY 1; // 1表示向下-1表示向上 // 比分 int scoreLeft 0; int scoreRight 0; void setup() { // 初始化两个MAX7219模块 for (int i0; i2; i) { lc.shutdown(i, false); // 唤醒模块 lc.setIntensity(i, 8); // 设置亮度0-15 lc.clearDisplay(i); // 清屏 } randomSeed(analogRead(A5)); // 利用未使用的模拟引脚生成随机种子 resetBall(); // 初始化球的位置和速度 } void loop() { readPaddles(); // 读取电位器更新球拍位置 updateBall(); // 更新球的位置并检测碰撞 drawGame(); // 绘制整个游戏画面 delay(50); // 控制游戏帧率约20FPS }LedControl库抽象了底层SPI通信细节让我们可以用setLed(模块地址, 行, 列, 状态)这样直观的函数来控制每一个LED的亮灭。级联后模块0是左侧屏幕模块1是右侧屏幕。4.2 游戏逻辑核心球的运动与碰撞updateBall()函数是游戏的物理引擎。void updateBall() { // 1. 更新位置 ballX ballSpeedX; ballY ballSpeedY; // 2. 检测与上下边界的碰撞 if (ballY 0 || ballY SCREEN_HEIGHT - 1) { ballSpeedY -ballSpeedY; // 垂直方向速度反向 ballY constrain(ballY, 0, SCREEN_HEIGHT - 1); // 防止卡在边界 } // 3. 检测与左侧球拍的碰撞 if (ballX PADDLE_LEFT_X 1 ballSpeedX 0) { // 球到达球拍右侧一格且向左运动 if (ballY paddleLeftY ballY paddleLeftY PADDLE_HEIGHT) { ballSpeedX -ballSpeedX; // 水平方向速度反向 // 可选根据击中球拍的不同位置改变垂直速度增加技巧性 int hitPos ballY - paddleLeftY; if (hitPos 0) ballSpeedY -1; // 击中顶部向上弹 else if (hitPos PADDLE_HEIGHT - 1) ballSpeedY 1; // 击中底部向下弹 // 否则保持原有垂直速度 } } // 4. 检测与右侧球拍的碰撞逻辑镜像 if (ballX PADDLE_RIGHT_X - 1 ballSpeedX 0) { if (ballY paddleRightY ballY paddleRightY PADDLE_HEIGHT) { ballSpeedX -ballSpeedX; // ... 同样可以添加角度变化逻辑 } } // 5. 检测得分球出左右边界 if (ballX 0) { // 球出左界右侧玩家得分 scoreRight; resetBall(); // 可以在这里添加得分提示如快速闪烁屏幕 } if (ballX SCREEN_WIDTH) { // 球出右界左侧玩家得分 scoreLeft; resetBall(); } } void resetBall() { ballX SCREEN_WIDTH / 2; ballY random(1, SCREEN_HEIGHT - 1); // 随机Y位置发球 // 随机决定发球方向但确保水平速度不为0 ballSpeedX (random(0, 2) 0) ? 1 : -1; ballSpeedY (random(0, 2) 0) ? 1 : -1; }碰撞检测的逻辑是游戏的核心。这里采用了一种简单而有效的“前瞻性”检测不是检测球是否与球拍重叠而是检测球在下一帧将要到达的位置是否与球拍区域相交。这比检测当前帧的重叠更符合直觉能减少球“穿拍而过”的BUG。4.3 画面渲染双缓冲与局部刷新直接在循环中频繁调用setLed绘制每个元素效率较低。更高效的做法是使用一个“帧缓冲区”Frame Buffer。byte frameBuffer[SCREEN_HEIGHT][2]; // 8行 x 2字节每字节8列对应两个模块 void drawGame() { // 1. 清空帧缓冲区并非清屏只是在内存中置零 memset(frameBuffer, 0, sizeof(frameBuffer)); // 2. 绘制左侧球拍 (位于模块0) for (int i 0; i PADDLE_HEIGHT; i) { int y paddleLeftY i; if (y 0 y SCREEN_HEIGHT) { bitSet(frameBuffer[y][0], 7 - PADDLE_LEFT_X); // 注意列坐标转换 } } // 3. 绘制右侧球拍 (位于模块1) for (int i 0; i PADDLE_HEIGHT; i) { int y paddleRightY i; if (y 0 y SCREEN_HEIGHT) { // 右侧球拍在模块1列索引为 PADDLE_RIGHT_X - 8 bitSet(frameBuffer[y][1], 7 - (PADDLE_RIGHT_X - 8)); } } // 4. 绘制球 int moduleIndex (ballX 8) ? 0 : 1; // 判断球在哪个模块 int colInModule (ballX 8) ? ballX : ballX - 8; if (ballY 0 ballY SCREEN_HEIGHT) { bitSet(frameBuffer[ballY][moduleIndex], 7 - colInModule); } // 5. 将帧缓冲区数据一次性发送到MAX7219 for (int module 0; module 2; module) { for (int row 0; row SCREEN_HEIGHT; row) { lc.setRow(module, row, frameBuffer[row][module]); } } }使用setRow函数一次性设置一整行8个LED的状态比用8次setLed要快得多。帧缓冲区的机制允许我们在内存中完整地构建好一帧画面然后一次性刷到屏幕上避免了画面撕裂也简化了绘图逻辑。4.4 输入处理电位器的平滑滤波电位器的读数可能会有抖动直接映射会导致球拍抖动。void readPaddles() { // 简单的移动平均滤波 static int leftReadings[5] {0}; static int rightReadings[5] {0}; static int leftIndex 0, rightIndex 0; leftReadings[leftIndex] analogRead(A0); rightReadings[rightIndex] analogRead(A1); leftIndex (leftIndex 1) % 5; rightIndex (rightIndex 1) % 5; long leftSum 0, rightSum 0; for (int i 0; i 5; i) { leftSum leftReadings[i]; rightSum rightReadings[i]; } int leftAvg leftSum / 5; int rightAvg rightSum / 5; // 将模拟值(0-1023)映射到球拍可移动的Y坐标范围(0, SCREEN_HEIGHT - PADDLE_HEIGHT) paddleLeftY map(leftAvg, 0, 1023, 0, SCREEN_HEIGHT - PADDLE_HEIGHT); paddleRightY map(rightAvg, 0, 1023, 0, SCREEN_HEIGHT - PADDLE_HEIGHT); }移动平均滤波是处理模拟信号抖动的经典方法。这里取最近5次读数的平均值能有效平滑球拍移动让操作手感更跟手。5. 功能增强与优化实践基础版本运行稳定后我们可以考虑添加一些功能来提升游戏体验。5.1 添加比分显示在8x16的点阵上同时显示球场和清晰的数字比分比较困难。一个巧妙的方案是得分后暂停游戏用屏幕中央滚动或闪烁的方式显示当前比分几秒钟然后继续。我们可以定义简单的3x5像素字体来显示数字。例如在resetBall()函数中检测到得分后调用一个displayScore()函数void displayScore(int left, int right) { lc.clearDisplay(0); lc.clearDisplay(1); delay(500); // 在屏幕中央绘制比分例如“3 : 5” // 这里需要实现一个简单的数字绘制函数 drawDigit(module, col, digit) drawDigit(0, 2, left / 10); // 左侧分数的十位如果是个位数这里可能是0 drawDigit(0, 5, left % 10); // 左侧分数的个位 // 绘制冒号 lc.setLed(0, 3, 4, true); lc.setLed(0, 5, 4, true); drawDigit(1, 2, right / 10); // 右侧分数的十位 drawDigit(1, 5, right % 10); // 右侧分数的个位 delay(2000); // 显示2秒 // 清屏并恢复游戏画面绘制 }5.2 提升视觉反馈击中特效与球速变化为了让游戏更有趣可以增加击中球拍时的视觉反馈比如让球拍快速闪烁几次。同时可以随着回合进行缓慢增加球的水平速度(ballSpeedX)。// 在碰撞检测到球拍后添加特效 if (ball与球拍碰撞) { ballSpeedX -ballSpeedX; // 球拍闪烁特效 for(int blink 0; blink 3; blink) { drawPaddle(false); // 绘制球拍熄灭状态 delay(50); drawPaddle(true); // 绘制球拍点亮状态 delay(50); } // 每击球5次增加球速确保方向正确 static int hitCount 0; hitCount; if (hitCount % 5 0) { if (ballSpeedX 0) ballSpeedX; else ballSpeedX--; } }5.3 使用中断实现更精准的控制当前主循环loop()中的delay(50)控制了游戏速度但也阻塞了输入读取。对于要求更高的场景可以使用定时器中断来驱动游戏逻辑更新实现固定帧率而主循环只负责非实时任务如显示比分动画。#include TimerOne.h void setup() { // ... 其他初始化 Timer1.initialize(20000); // 设置中断周期为20000微秒50Hz Timer1.attachInterrupt(gameTick); // 指定中断服务函数 } volatile bool updateFlag false; // 用于主循环和中断服务例程通信的标志位 void gameTick() { // 中断服务函数执行要快 readPaddles(); updateBall(); updateFlag true; // 通知主循环可以刷新屏幕了 } void loop() { if (updateFlag) { updateFlag false; drawGame(); // 这里不再需要delay } // 可以在这里处理非实时逻辑如菜单、得分显示等 }使用中断可以使游戏运行更加平滑不受loop中其他代码执行时间的影响。但要注意中断服务函数gameTick()必须非常简短不能在里面调用delay()或执行耗时操作。6. 常见问题排查与调试技巧在制作过程中你可能会遇到以下问题问题现象可能原因排查步骤与解决方案点阵完全不亮1. 电源未接通或接反。2.CS/LOAD引脚接触不良或未初始化。3. 模块处于关断模式。1. 用万用表检查5V和GND是否到位。2. 检查CS引脚连接并在setup()中确认执行了lc.shutdown(0, false)。3. 尝试单独测试一个模块排除级联问题。点阵部分显示错乱或闪烁1. 电源功率不足特别是级联多个模块时。2. SPI信号线受到干扰。3. 程序刷新速率过快或过慢。1. 使用外部5V/2A电源适配器为Arduino和模块独立供电避免USB供电能力不足。2. 确保杜邦线连接牢固尽量缩短连线长度。在VCC和GND间加滤波电容。3. 调整loop中的delay值或检查中断服务函数是否超时。球拍控制不跟手或跳动1. 电位器接触不良或质量差。2. 模拟输入未做滤波处理。3.map函数映射范围不合理。1. 更换电位器或用电表测量其输出是否平滑变化。2. 在代码中加入如前文所述的移动平均滤波。3. 检查map函数的输入输出范围确保球拍不会移出屏幕。可加入constrain函数限制。球穿过球拍或边界1. 碰撞检测逻辑有误。2. 球速过快单帧移动超过1个像素。1. 仔细检查updateBall中的碰撞条件特别是等号判断。添加串口打印输出球和球拍的实时坐标进行调试。2. 确保ballSpeedX和ballSpeedY的绝对值在1或2不要过大。如果加速需考虑更精确的碰撞检测如射线检测。级联的第二块模块不显示1. 级联连线错误特别是DOUT到DIN。2. 初始化库时指定的模块数量不对。3. 绘图时模块索引算错。1. 确认模块1的DOUT接到了模块2的DIN。2. 检查LedControl lc(11,13,10, **2** );中的最后一个参数是否为模块总数。3. 在drawGame函数中确认计算moduleIndex和colInModule的逻辑正确。调试利器串口监视器。在代码关键位置添加Serial.print()语句打印出球的位置、速度、球拍位置、电位器读数等变量是定位逻辑错误最直接有效的方法。例如在碰撞检测前后打印信息可以清楚地看到程序“认为”的碰撞是否发生。这个项目从硬件连接到软件逻辑完整地展示了一个嵌入式互动应用的开发流程。它麻雀虽小五脏俱全。当你看到那个像素小球在自制的屏幕上弹跳并通过亲手焊接的电位器控制球拍时那种成就感是无可替代的。它不仅是向经典的致敬更是你动手能力和工程思维的一次扎实锻炼。 
长河君 · 2026/8/19 14:47:49 · 阅读 1.2k 基于Arduino与MAX7219的LED点阵Pong游戏实现
1. 项目概述从像素点到复古街机几年前我在整理工作室的零件盒时翻出了几块尘封已久的MAX7219点阵模块和一块Arduino Uno。看着那些8x8的红色LED一个念头突然冒了出来能不能用这些最简单的元件复刻一个属于我们这代人的童年记忆——Pong这个想法最终催生了这个项目一个完全由Arduino驱动在LED点阵上运行的经典双人乒乓球游戏。这个“Arduino LED Matrix Pong”项目本质上是一个软硬件结合的嵌入式系统。它的核心玩法与1972年雅达利发布的那款开山鼻祖《Pong》一致两名玩家各自控制一块“球拍”在屏幕上下移动将“球”击打回去如果一方漏球则对方得分。不同之处在于我们的“屏幕”是一块或级联的多块8x8 LED点阵模块而“球拍”和“球”都是由一个个发光的像素点构成。MAX7219芯片负责驱动这些LEDArduino则作为大脑处理游戏逻辑、玩家输入和显示控制。它解决的不仅仅是一个“能不能做”的技术问题更是一个“如何优雅地做”的工程实践问题。对于硬件爱好者它是一次绝佳的入门实践涵盖了数字IO控制、SPI通信协议、中断处理、状态机编程等核心概念。对于怀旧玩家它则是一个可以放在桌面的微型街机其简单的交互和即时的反馈能带来最纯粹的电子游戏乐趣。无论你是想学习Arduino与外部芯片的交互还是想亲手打造一个有趣的桌面玩具这个项目都能提供一条清晰、可实现的路径。2. 核心硬件解析为何是MAX7219与Arduino的组合选择MAX7219驱动LED点阵而非直接使用Arduino的IO口扫描或者选择其他驱动芯片如TM1637、HT16K33背后有一系列工程上的权衡。2.1 MAX7219芯片点阵驱动的“瑞士军刀”MAX7219是一款集成化的共阴极LED显示驱动器。它之所以成为点阵项目的首选主要归功于几个关键特性SPI接口简化连接MAX7219通过简单的4线SPISerial Peripheral Interface与微控制器通信。你只需要连接Arduino的3个数字引脚DATA CLK LOAD/CS给它就能控制多达64个LED8x8。这极大节省了宝贵的IO口资源。如果直接用Arduino驱动8x8点阵采用行列扫描方式至少需要16个IO口8行8列这对于只有14个数字IO的Arduino Uno来说几乎是不可接受的。内置硬件扫描与多路复用芯片内部集成了多路复用扫描电路和动态驱动逻辑。这意味着Arduino不需要以很高的频率去逐行刷新LED只需通过SPI发送一次显示数据MAX7219就会自动负责后续的扫描刷新工作将CPU从繁重的显示刷新任务中解放出来使其能专注于游戏逻辑计算。灵活的级联能力单个MAX7219只能驱动一个8x8点阵。但它的设计允许轻松级联。只需将第一块的DOUT引脚连接到第二块的DIN引脚以此类推理论上可以驱动无限多的8x8模块形成一个更大的屏幕。这对于未来扩展游戏画面比如做一个更大的球场提供了可能。在我们的Pong项目中使用2块级联形成一个8x16的横向屏幕球场就显得宽敞多了。可编程亮度与译码模式芯片允许通过寄存器设置16级亮度我们可以根据环境光调节屏幕亮度。虽然Pong游戏用不到7段数码管的译码功能但这体现了芯片的通用性。注意市场上常见的“MAX7219点阵模块”已经将芯片、点阵、限流电阻和必要的滤波电容集成在了一块小PCB上。这大大降低了我们的焊接和调试难度是入门的最佳选择。购买时请确认是“共阴极”点阵模块。2.2 Arduino的定位游戏逻辑与交互的核心Arduino在这个项目中扮演着游戏主机的角色。它的核心任务包括游戏状态管理维护球的位置X Y坐标、速度X Y方向的分量、双方球拍的位置、比分等所有游戏状态变量。物理与碰撞计算每一帧更新球的位置新位置 旧位置 速度。计算球与上下边界、左右边界球拍的碰撞。与球拍的碰撞需要根据击球点计算反弹角度这是游戏手感的来源。玩家输入处理读取两个电位器模拟输入A0 A1的电压值将其映射为球拍在Y轴上的位置。这里使用了模拟输入为游戏带来了平滑的模拟控制体验而非生硬的数字按键。画面渲染根据最新的游戏状态计算出一帧8x16或更大的二进制点阵数据然后通过SPI总线发送给MAX7219驱动模块。游戏流程控制处理发球、得分、胜利判定等游戏规则。选择Arduino Uno是因为其性能足以应对这个级别的计算且生态丰富有成熟的LedControl等库支持MAX7219。如果使用更强大的ESP32或Teensy固然可以实现更复杂的特效或声音但对于经典的Pong而言Uno的简约与纯粹反而更贴合项目气质。3. 电路搭建与连接详解一个可靠的项目始于清晰的电路连接。下图展示了基于两块级联MAX7219模块的经典连接方法所需材料清单Arduino Uno 开发板 x1MAX7219 8x8 LED点阵模块 x2 用于级联成8x16屏幕10kΩ 电位器 x2 用于控制球拍面包板 x1公对公杜邦线 若干USB数据线 x1电路连接步骤供电连接将两个MAX7219模块的VCC引脚连接到Arduino的5V引脚GND引脚连接到Arduino的GND引脚。务必确保共地这是通信稳定的基础。SPI信号线连接核心第一块模块最靠近Arduino的DIN- Arduino 数字引脚11(MOSI)CLK- Arduino 数字引脚13(SCK)CS(或LOAD) - Arduino 数字引脚10(可自定义此处以10为例)第二块模块DIN-第一块模块的DOUT这是级联的关键CLK- 与第一块模块的CLK并联共同接到Arduino引脚13CS- 与第一块模块的CS并联共同接到Arduino引脚10这种接法意味着两个模块共享时钟和片选信号数据从Arduino发给模块1再通过模块1的DOUT传给模块2。当Arduino发送16字节的数据时模块1会拿走前8字节对应它驱动的点阵后8字节则会“流经”它传给模块2。玩家输入连接玩家1左侧电位器中间引脚接 Arduino 模拟输入A0两侧引脚分别接5V和GND。玩家2右侧电位器中间引脚接 Arduino 模拟输入A1两侧引脚分别接5V和GND。实操心得电源去耦如果你发现LED点阵在刷新时有轻微的闪烁或干扰尤其是在球快速移动时很可能是电源噪声。一个立竿见影的改进是在每个MAX7219模块的VCC和GND引脚之间就近焊接一个10μF的电解电容和一个0.1μF的陶瓷电容用于滤除低频和高频噪声。很多成品模块已经包含了这些电容但自己检查一下总是好的。4. 软件架构与核心代码实现我们将使用Arduino IDE进行开发并依赖一个非常优秀的库LedControl。可以通过IDE的库管理器直接搜索安装。4.1 初始化与显示框架#include LedControl.h // 参数DIN, CLK, CS/LOAD, 级联的模块数量 LedControl lc LedControl(11, 13, 10, 2); // 游戏区域定义 (8行 x 16列) const int SCREEN_WIDTH 16; const int SCREEN_HEIGHT 8; // 球拍相关 const int PADDLE_HEIGHT 3; // 球拍高度为3个像素 int paddleLeftY 2; // 左侧球拍顶部Y坐标 int paddleRightY 2; // 右侧球拍顶部Y坐标 const int PADDLE_LEFT_X 0; // 左侧球拍固定在第0列 const int PADDLE_RIGHT_X SCREEN_WIDTH - 1; // 右侧球拍固定在第15列 // 球相关 int ballX SCREEN_WIDTH / 2; int ballY SCREEN_HEIGHT / 2; int ballSpeedX 1; // 1表示向右-1表示向左 int ballSpeedY 1; // 1表示向下-1表示向上 // 比分 int scoreLeft 0; int scoreRight 0; void setup() { // 初始化两个MAX7219模块 for (int i0; i2; i) { lc.shutdown(i, false); // 唤醒模块 lc.setIntensity(i, 8); // 设置亮度0-15 lc.clearDisplay(i); // 清屏 } randomSeed(analogRead(A5)); // 利用未使用的模拟引脚生成随机种子 resetBall(); // 初始化球的位置和速度 } void loop() { readPaddles(); // 读取电位器更新球拍位置 updateBall(); // 更新球的位置并检测碰撞 drawGame(); // 绘制整个游戏画面 delay(50); // 控制游戏帧率约20FPS }LedControl库抽象了底层SPI通信细节让我们可以用setLed(模块地址, 行, 列, 状态)这样直观的函数来控制每一个LED的亮灭。级联后模块0是左侧屏幕模块1是右侧屏幕。4.2 游戏逻辑核心球的运动与碰撞updateBall()函数是游戏的物理引擎。void updateBall() { // 1. 更新位置 ballX ballSpeedX; ballY ballSpeedY; // 2. 检测与上下边界的碰撞 if (ballY 0 || ballY SCREEN_HEIGHT - 1) { ballSpeedY -ballSpeedY; // 垂直方向速度反向 ballY constrain(ballY, 0, SCREEN_HEIGHT - 1); // 防止卡在边界 } // 3. 检测与左侧球拍的碰撞 if (ballX PADDLE_LEFT_X 1 ballSpeedX 0) { // 球到达球拍右侧一格且向左运动 if (ballY paddleLeftY ballY paddleLeftY PADDLE_HEIGHT) { ballSpeedX -ballSpeedX; // 水平方向速度反向 // 可选根据击中球拍的不同位置改变垂直速度增加技巧性 int hitPos ballY - paddleLeftY; if (hitPos 0) ballSpeedY -1; // 击中顶部向上弹 else if (hitPos PADDLE_HEIGHT - 1) ballSpeedY 1; // 击中底部向下弹 // 否则保持原有垂直速度 } } // 4. 检测与右侧球拍的碰撞逻辑镜像 if (ballX PADDLE_RIGHT_X - 1 ballSpeedX 0) { if (ballY paddleRightY ballY paddleRightY PADDLE_HEIGHT) { ballSpeedX -ballSpeedX; // ... 同样可以添加角度变化逻辑 } } // 5. 检测得分球出左右边界 if (ballX 0) { // 球出左界右侧玩家得分 scoreRight; resetBall(); // 可以在这里添加得分提示如快速闪烁屏幕 } if (ballX SCREEN_WIDTH) { // 球出右界左侧玩家得分 scoreLeft; resetBall(); } } void resetBall() { ballX SCREEN_WIDTH / 2; ballY random(1, SCREEN_HEIGHT - 1); // 随机Y位置发球 // 随机决定发球方向但确保水平速度不为0 ballSpeedX (random(0, 2) 0) ? 1 : -1; ballSpeedY (random(0, 2) 0) ? 1 : -1; }碰撞检测的逻辑是游戏的核心。这里采用了一种简单而有效的“前瞻性”检测不是检测球是否与球拍重叠而是检测球在下一帧将要到达的位置是否与球拍区域相交。这比检测当前帧的重叠更符合直觉能减少球“穿拍而过”的BUG。4.3 画面渲染双缓冲与局部刷新直接在循环中频繁调用setLed绘制每个元素效率较低。更高效的做法是使用一个“帧缓冲区”Frame Buffer。byte frameBuffer[SCREEN_HEIGHT][2]; // 8行 x 2字节每字节8列对应两个模块 void drawGame() { // 1. 清空帧缓冲区并非清屏只是在内存中置零 memset(frameBuffer, 0, sizeof(frameBuffer)); // 2. 绘制左侧球拍 (位于模块0) for (int i 0; i PADDLE_HEIGHT; i) { int y paddleLeftY i; if (y 0 y SCREEN_HEIGHT) { bitSet(frameBuffer[y][0], 7 - PADDLE_LEFT_X); // 注意列坐标转换 } } // 3. 绘制右侧球拍 (位于模块1) for (int i 0; i PADDLE_HEIGHT; i) { int y paddleRightY i; if (y 0 y SCREEN_HEIGHT) { // 右侧球拍在模块1列索引为 PADDLE_RIGHT_X - 8 bitSet(frameBuffer[y][1], 7 - (PADDLE_RIGHT_X - 8)); } } // 4. 绘制球 int moduleIndex (ballX 8) ? 0 : 1; // 判断球在哪个模块 int colInModule (ballX 8) ? ballX : ballX - 8; if (ballY 0 ballY SCREEN_HEIGHT) { bitSet(frameBuffer[ballY][moduleIndex], 7 - colInModule); } // 5. 将帧缓冲区数据一次性发送到MAX7219 for (int module 0; module 2; module) { for (int row 0; row SCREEN_HEIGHT; row) { lc.setRow(module, row, frameBuffer[row][module]); } } }使用setRow函数一次性设置一整行8个LED的状态比用8次setLed要快得多。帧缓冲区的机制允许我们在内存中完整地构建好一帧画面然后一次性刷到屏幕上避免了画面撕裂也简化了绘图逻辑。4.4 输入处理电位器的平滑滤波电位器的读数可能会有抖动直接映射会导致球拍抖动。void readPaddles() { // 简单的移动平均滤波 static int leftReadings[5] {0}; static int rightReadings[5] {0}; static int leftIndex 0, rightIndex 0; leftReadings[leftIndex] analogRead(A0); rightReadings[rightIndex] analogRead(A1); leftIndex (leftIndex 1) % 5; rightIndex (rightIndex 1) % 5; long leftSum 0, rightSum 0; for (int i 0; i 5; i) { leftSum leftReadings[i]; rightSum rightReadings[i]; } int leftAvg leftSum / 5; int rightAvg rightSum / 5; // 将模拟值(0-1023)映射到球拍可移动的Y坐标范围(0, SCREEN_HEIGHT - PADDLE_HEIGHT) paddleLeftY map(leftAvg, 0, 1023, 0, SCREEN_HEIGHT - PADDLE_HEIGHT); paddleRightY map(rightAvg, 0, 1023, 0, SCREEN_HEIGHT - PADDLE_HEIGHT); }移动平均滤波是处理模拟信号抖动的经典方法。这里取最近5次读数的平均值能有效平滑球拍移动让操作手感更跟手。5. 功能增强与优化实践基础版本运行稳定后我们可以考虑添加一些功能来提升游戏体验。5.1 添加比分显示在8x16的点阵上同时显示球场和清晰的数字比分比较困难。一个巧妙的方案是得分后暂停游戏用屏幕中央滚动或闪烁的方式显示当前比分几秒钟然后继续。我们可以定义简单的3x5像素字体来显示数字。例如在resetBall()函数中检测到得分后调用一个displayScore()函数void displayScore(int left, int right) { lc.clearDisplay(0); lc.clearDisplay(1); delay(500); // 在屏幕中央绘制比分例如“3 : 5” // 这里需要实现一个简单的数字绘制函数 drawDigit(module, col, digit) drawDigit(0, 2, left / 10); // 左侧分数的十位如果是个位数这里可能是0 drawDigit(0, 5, left % 10); // 左侧分数的个位 // 绘制冒号 lc.setLed(0, 3, 4, true); lc.setLed(0, 5, 4, true); drawDigit(1, 2, right / 10); // 右侧分数的十位 drawDigit(1, 5, right % 10); // 右侧分数的个位 delay(2000); // 显示2秒 // 清屏并恢复游戏画面绘制 }5.2 提升视觉反馈击中特效与球速变化为了让游戏更有趣可以增加击中球拍时的视觉反馈比如让球拍快速闪烁几次。同时可以随着回合进行缓慢增加球的水平速度(ballSpeedX)。// 在碰撞检测到球拍后添加特效 if (ball与球拍碰撞) { ballSpeedX -ballSpeedX; // 球拍闪烁特效 for(int blink 0; blink 3; blink) { drawPaddle(false); // 绘制球拍熄灭状态 delay(50); drawPaddle(true); // 绘制球拍点亮状态 delay(50); } // 每击球5次增加球速确保方向正确 static int hitCount 0; hitCount; if (hitCount % 5 0) { if (ballSpeedX 0) ballSpeedX; else ballSpeedX--; } }5.3 使用中断实现更精准的控制当前主循环loop()中的delay(50)控制了游戏速度但也阻塞了输入读取。对于要求更高的场景可以使用定时器中断来驱动游戏逻辑更新实现固定帧率而主循环只负责非实时任务如显示比分动画。#include TimerOne.h void setup() { // ... 其他初始化 Timer1.initialize(20000); // 设置中断周期为20000微秒50Hz Timer1.attachInterrupt(gameTick); // 指定中断服务函数 } volatile bool updateFlag false; // 用于主循环和中断服务例程通信的标志位 void gameTick() { // 中断服务函数执行要快 readPaddles(); updateBall(); updateFlag true; // 通知主循环可以刷新屏幕了 } void loop() { if (updateFlag) { updateFlag false; drawGame(); // 这里不再需要delay } // 可以在这里处理非实时逻辑如菜单、得分显示等 }使用中断可以使游戏运行更加平滑不受loop中其他代码执行时间的影响。但要注意中断服务函数gameTick()必须非常简短不能在里面调用delay()或执行耗时操作。6. 常见问题排查与调试技巧在制作过程中你可能会遇到以下问题问题现象可能原因排查步骤与解决方案点阵完全不亮1. 电源未接通或接反。2.CS/LOAD引脚接触不良或未初始化。3. 模块处于关断模式。1. 用万用表检查5V和GND是否到位。2. 检查CS引脚连接并在setup()中确认执行了lc.shutdown(0, false)。3. 尝试单独测试一个模块排除级联问题。点阵部分显示错乱或闪烁1. 电源功率不足特别是级联多个模块时。2. SPI信号线受到干扰。3. 程序刷新速率过快或过慢。1. 使用外部5V/2A电源适配器为Arduino和模块独立供电避免USB供电能力不足。2. 确保杜邦线连接牢固尽量缩短连线长度。在VCC和GND间加滤波电容。3. 调整loop中的delay值或检查中断服务函数是否超时。球拍控制不跟手或跳动1. 电位器接触不良或质量差。2. 模拟输入未做滤波处理。3.map函数映射范围不合理。1. 更换电位器或用电表测量其输出是否平滑变化。2. 在代码中加入如前文所述的移动平均滤波。3. 检查map函数的输入输出范围确保球拍不会移出屏幕。可加入constrain函数限制。球穿过球拍或边界1. 碰撞检测逻辑有误。2. 球速过快单帧移动超过1个像素。1. 仔细检查updateBall中的碰撞条件特别是等号判断。添加串口打印输出球和球拍的实时坐标进行调试。2. 确保ballSpeedX和ballSpeedY的绝对值在1或2不要过大。如果加速需考虑更精确的碰撞检测如射线检测。级联的第二块模块不显示1. 级联连线错误特别是DOUT到DIN。2. 初始化库时指定的模块数量不对。3. 绘图时模块索引算错。1. 确认模块1的DOUT接到了模块2的DIN。2. 检查LedControl lc(11,13,10, **2** );中的最后一个参数是否为模块总数。3. 在drawGame函数中确认计算moduleIndex和colInModule的逻辑正确。调试利器串口监视器。在代码关键位置添加Serial.print()语句打印出球的位置、速度、球拍位置、电位器读数等变量是定位逻辑错误最直接有效的方法。例如在碰撞检测前后打印信息可以清楚地看到程序“认为”的碰撞是否发生。这个项目从硬件连接到软件逻辑完整地展示了一个嵌入式互动应用的开发流程。它麻雀虽小五脏俱全。当你看到那个像素小球在自制的屏幕上弹跳并通过亲手焊接的电位器控制球拍时那种成就感是无可替代的。它不仅是向经典的致敬更是你动手能力和工程思维的一次扎实锻炼。