1. 项目概述与核心思路刚拿到星火一号这块国产RT-Thread开发板总想用它做点有意思的东西把玩一下硬件和实时操作系统的结合。逛社区论坛时看到有网友zym_0208分享了一个基于LCD屏和按键的贪吃蛇游戏Demo这主意不错经典又有趣。于是兴冲冲地下载下来跑了一下游戏能玩但实测中发现了一些影响体验的小毛病比如按键响应有时不太跟手食物偶尔会刷在奇怪的位置导致蛇吃不到。这勾起了我的“折腾”欲——能不能在它的基础上把代码逻辑理顺把bug修掉甚至优化一下游戏体验呢这个项目的核心就是利用星火一号开发板自带的硬件资源实现一个完整的、可交互的贪吃蛇游戏。你需要用到的核心部件很简单一块LCD屏幕用于显示游戏画面四个独立按键分别对应上下左右方向控制。软件层面则完全基于RT-Thread这个国产的、优秀的物联网实时操作系统。它的价值在于这不仅仅是一个简单的编程练习更是一个综合性的嵌入式小项目涉及到了GPIO中断处理、实时任务调度、LCD驱动显示、以及经典游戏算法的嵌入式实现等多个知识点。无论你是刚接触RT-Thread的新手想通过一个有趣的项目上手还是有一定经验的开发者想看看如何在资源受限的MCU上优雅地组织代码这个案例都很有参考价值。我将在原工程的基础上重点解决几个问题优化按键中断的处理逻辑确保方向控制精准无误重构食物生成算法杜绝“无效食物”的出现并让整个游戏的逻辑更清晰、更健壮。下面我就把修改和优化后的完整实现过程以及其中踩过的坑和总结的经验详细地分享出来。2. 硬件环境搭建与驱动准备2.1 星火一号开发板与核心外设星火一号开发板的核心是一颗ARM Cortex-M系列的微控制器它原生搭载了RT-Thread操作系统开箱即用非常适合进行物联网和嵌入式GUI的快速原型开发。对于我们这个贪吃蛇游戏我们只关心它的两个外设LCD显示屏和GPIO按键。LCD显示屏板子通常搭载一块SPI或并口的LCD屏分辨率可能是240x240或240x320。RT-Thread的软件包中心一般提供了对应的驱动如lcd_spi_dev或lcd_ili9341。我们的游戏画面就将绘制在这块屏幕上。GPIO按键我们需要四个独立的按键来控制蛇的移动方向。在提供的代码中它们分别连接在PC0、PC1、PC4、PC5这四个引脚上。这些引脚被配置为上拉输入模式当按键按下时引脚电平从高由于上拉变为低产生一个下降沿从而触发中断。注意在动手前请务必确认你板载LCD的型号和驱动是否已正确配置。你可以通过RT-Thread的list_device命令查看是否有一个名为lcd或spi_lcd的设备。如果没有需要先去RT-Thread的包管理器(pkgs --update)中搜索并安装对应的LCD驱动软件包。2.2 引脚定义与中断配置详解代码开头对按键引脚进行了宏定义这是硬件层和软件层的桥梁。理解这里的细节很重要#define PIN_KEY0 GET_PIN(C, 0) // 通常映射为“左” #define PIN_KEY1 GET_PIN(C, 1) // 通常映射为“下” #define PIN_KEY2 GET_PIN(C, 4) // 通常映射为“右” #define PIN_KEY3 GET_PIN(C, 5) // 通常映射为“上” #define PIN_LED_R GET_PIN(F, 12) // 红色LED可用于游戏状态指示可选GET_PIN(C, 0)是RT-Thread提供的宏用于将端口C的第0号引脚转换为系统统一的引脚编号。接下来在main函数初始化部分对引脚进行配置// 设置引脚为输入模式并启用内部上拉电阻。 // 当按键未按下时引脚被上拉到高电平按下时引脚被拉到低电平。 rt_pin_mode(PIN_KEY0, PIN_MODE_INPUT_PULLUP); rt_pin_mode(PIN_KEY1, PIN_MODE_INPUT_PULLUP); rt_pin_mode(PIN_KEY2, PIN_MODE_INPUT_PULLUP); rt_pin_mode(PIN_KEY3, PIN_MODE_INPUT_PULLUP); // 绑定中断服务函数。当引脚发生下降沿PIN_IRQ_MODE_FALLING时调用keyDown函数。 // 最后一个参数(void*)X是传递给中断函数的用户数据这里用来区分是哪个按键。 rt_pin_attach_irq(PIN_KEY0, PIN_IRQ_MODE_FALLING, keyDown, (void*)3); rt_pin_attach_irq(PIN_KEY1, PIN_IRQ_MODE_FALLING, keyDown, (void*)2); rt_pin_attach_irq(PIN_KEY2, PIN_IRQ_MODE_FALLING, keyDown, (void*)4); rt_pin_attach_irq(PIN_KEY3, PIN_IRQ_MODE_FALLING, keyDown, (void*)1); // 使能引脚中断 rt_pin_irq_enable(PIN_KEY0, PIN_IRQ_ENABLE); rt_pin_irq_enable(PIN_KEY1, PIN_IRQ_ENABLE); rt_pin_irq_enable(PIN_KEY2, PIN_IRQ_ENABLE); rt_pin_irq_enable(PIN_KEY3, PIN_IRQ_ENABLE);这里有一个关键细节传递给keyDown函数的参数(void*)1到(void*)4并非随意赋值。它需要与后续游戏逻辑中方向判断的case值对应。例如原代码中(void*)3对应case 3:左移这需要根据你的按键实际布局和逻辑定义来保持一致。如果觉得数字不直观可以定义成枚举。2.3 中断服务函数的设计与优化中断服务函数keyDown必须简短高效因为它打断了主程序的正常执行。原版代码在这里处理得比较粗糙我们来看优化后的思路// 全局变量用于在主循环中读取按键值。使用volatile防止编译器优化。 volatile int key_direction DIR_RIGHT; // 初始方向向右 void keyDown(void *args) { int pressed_key (int)args; // 简单的按键防抖和方向反转判断 static rt_tick_t last_tick 0; rt_tick_t current_tick rt_tick_get(); // 简易防抖两次中断间隔小于50ms则忽略 if (current_tick - last_tick rt_tick_from_millisecond(50)) { return; } last_tick current_tick; // 防止蛇直接反向移动例如正在向右时不能立即按左 if ((key_direction DIR_RIGHT pressed_key DIR_LEFT) || (key_direction DIR_LEFT pressed_key DIR_RIGHT) || (key_direction DIR_UP pressed_key DIR_DOWN) || (key_direction DIR_DOWN pressed_key DIR_UP)) { return; // 忽略反向按键 } // 更新方向 key_direction pressed_key; rt_kprintf([ISR] Key %d pressed.\n, pressed_key); }优化点解析防抖处理机械按键在按下和弹起时会产生物理抖动可能导致多次触发中断。通过记录上次中断的时间戳忽略短时间内如50ms内的重复触发能有效提升稳定性。方向反转保护这是贪吃蛇游戏的一个基本规则蛇不能瞬间掉头。在中断层面就过滤掉这种非法操作比在主循环中判断更及时、更安全。使用枚举增强可读性建议将数字1、2、3、4定义为DIR_UPDIR_DOWNDIR_LEFTDIR_RIGHT这样代码意图一目了然。3. 游戏核心逻辑设计与数据结构3.1 地图、蛇与食物的数据建模游戏的所有状态都需要用数据结构清晰地定义出来。我们采用全局变量的方式来管理。#define SNAKE_MAX_LEN 100 // 蛇身最大长度根据屏幕大小和格子大小估算 #define MAP_WIDTH 240 // 屏幕像素宽度 #define MAP_HEIGHT 240 // 屏幕像素高度 #define GRID_SIZE 16 // 每个游戏格子蛇身一节/食物的像素大小 // 食物结构体 typedef struct { int x; // 食物的x坐标像素 int y; // 食物的y坐标像素 } food_t; // 蛇结构体 typedef struct { int speed; // 移动速度像素/次实际上由延时控制这里可表示步长 int length; // 当前蛇身长度含蛇头 int body_x[SNAKE_MAX_LEN]; // 蛇身各节的x坐标数组 int body_y[SNAKE_MAX_LEN]; // 蛇身各节的y坐标数组 // 可以增加方向变量但本例中方向由全局变量key_direction控制 } snake_t; // 全局游戏对象 food_t g_food; snake_t g_snake; volatile int g_key_direction 3; // 初始方向需与中断参数对应 int g_score 0;设计要点坐标系统屏幕左上角为原点(0,0)x轴向右y轴向下。所有坐标都是像素坐标。网格化为了让蛇和食物对齐它们的坐标必须是GRID_SIZE16的整数倍。这简化了碰撞检测和移动逻辑。蛇的存储使用数组来存储蛇身每一节的坐标。蛇头是body_x[0]和body_y[0]。移动时我们只需要更新数组内容然后重绘相关部分。3.2 游戏主循环与状态机贪吃蛇游戏的核心是一个无限循环通常每秒运行多次如每秒3-5次对应300ms延时。每次循环称为一“帧”或一个“滴答”。每一帧内程序按固定顺序执行以下操作处理输入读取由中断更新的g_key_direction。更新游戏状态根据方向计算蛇头的新位置。判断新位置是否撞墙、撞自身游戏结束。判断新位置是否吃到食物。如果吃到食物蛇长度加1分数增加在新位置生成食物。如果没吃到蛇身体向前移动一格尾部消失。渲染画面根据最新的蛇和食物坐标在LCD屏幕上更新显示。延时等待一段时间控制游戏速度。原代码将状态更新和渲染混合在handleFood()函数里我们可以将其拆解得更清晰void game_update() { // 1. 根据当前方向计算蛇头的新位置临时变量 int new_head_x g_snake.body_x[0]; int new_head_y g_snake.body_y[0]; switch(g_key_direction) { case DIR_LEFT: new_head_x - GRID_SIZE; break; case DIR_RIGHT: new_head_x GRID_SIZE; break; case DIR_UP: new_head_y - GRID_SIZE; break; case DIR_DOWN: new_head_y GRID_SIZE; break; } // 2. 碰撞检测 if (is_collision_with_wall(new_head_x, new_head_y) || is_collision_with_self(new_head_x, new_head_y)) { game_over(); return; } // 3. 移动蛇身 move_snake_body(new_head_x, new_head_y); // 4. 吃食物检测与处理 if (new_head_x g_food.x new_head_y g_food.y) { eat_food(); generate_food(); // 生成新食物 } } void game_render() { // 清屏或局部刷新优化性能可选 // lcd_clear(COLOR_BACKGROUND); // 绘制地图边框 draw_border(); // 绘制食物 lcd_show_string(g_food.x, g_food.y, 16, *, COLOR_FOOD); // 绘制蛇 // 蛇头 lcd_show_string(g_snake.body_x[0], g_snake.body_y[0], 16, , COLOR_SNAKE_HEAD); // 蛇身 for (int i 1; i g_snake.length; i) { lcd_show_string(g_snake.body_x[i], g_snake.body_y[i], 16, #, COLOR_SNAKE_BODY); } // 可以增加擦除上一帧蛇尾的逻辑实现更流畅动画 }在主循环中顺序调用game_update()和game_render()然后延时。4. 关键算法实现与深度优化4.1 蛇的移动算法数组移位法这是最核心的算法之一。贪吃蛇的移动特点是蛇头向新方向前进一格每一节身体都移动到它前面一节的位置上。用数组实现非常高效。void move_snake_body(int new_head_x, int new_head_y) { // 保存旧蛇尾坐标用于判断是否需要增长吃食物时或擦除未吃食物时 int old_tail_x g_snake.body_x[g_snake.length - 1]; int old_tail_y g_snake.body_y[g_snake.length - 1]; // 从蛇尾开始向前一节一节地移动坐标避免数据被覆盖 for (int i g_snake.length - 1; i 0; i--) { g_snake.body_x[i] g_snake.body_x[i - 1]; g_snake.body_y[i] g_snake.body_y[i - 1]; } // 设置新的蛇头坐标 g_snake.body_x[0] new_head_x; g_snake.body_y[0] new_head_y; // **优化点局部渲染** // 在未吃食物时我们只需要更新三处新蛇头、旧蛇头变成蛇身第二节、旧蛇尾擦除。 // 这比全屏重绘效率高得多。 // 1. 绘制新蛇头 lcd_show_string(new_head_x, new_head_y, 16, , COLOR_SNAKE_HEAD); // 2. 将原来的蛇头现在是第二节重绘为蛇身 lcd_show_string(g_snake.body_x[1], g_snake.body_y[1], 16, #, COLOR_SNAKE_BODY); // 3. 擦除旧蛇尾如果没吃到食物 // 这个判断可以放在更高层的逻辑里 // lcd_show_string(old_tail_x, old_tail_y, 16, , COLOR_BACKGROUND); }为什么从后往前移动如果从前往后移动当你把body_x[0]赋值给body_x[1]后body_x[0]的值已经丢失被新头坐标覆盖前导致body_x[1]和body_x[2]都变成相同的新头坐标蛇就缩成一团了。从后往前移动确保了每一节在“交出”自己的坐标前已经“接收”了前一节的坐标。4.2 食物的生成算法合法性校验与效率优化原版代码的食物生成逻辑在一个while(1)循环里通过随机数生成坐标然后检查是否合法。这在小地图上没问题但当地图几乎被蛇占满时可能会陷入长时间的循环甚至死循环。我们需要优化。合法性条件坐标必须在游戏区域内避开墙壁。坐标不能与蛇身的任何一节重合。关键细节由于我们使用lcd_show_string显示一个16x16的字符而字符的宽度在像素对齐上可能有讲究原代码提到food.x % 2 0这是为了确保字符显示在偶数像素起始地址避免显示错位。这取决于具体的LCD驱动和字体。如果你的显示正常可以忽略此条件如果出现食物“半截”显示就需要这个校验。优化后的生成算法#define MAX_GENERATION_ATTEMPTS 100 // 最大尝试次数避免死循环 rt_bool_t generate_food(void) { int attempts 0; int is_position_valid RT_FALSE; while (attempts MAX_GENERATION_ATTEMPTS) { // 生成网格内的随机坐标 g_food.x (rt_rand() % (MAP_WIDTH / GRID_SIZE - 2)) * GRID_SIZE GRID_SIZE; // 避开左右墙 g_food.y (rt_rand() % (MAP_HEIGHT / GRID_SIZE - 2)) * GRID_SIZE GRID_SIZE; // 避开上下墙 // 条件3: 如果需要像素对齐根据你的LCD驱动调整或移除 // if (g_food.x % 2 ! 0) continue; // 条件2: 检查是否与蛇身重合 is_position_valid RT_TRUE; for (int i 0; i g_snake.length; i) { if (g_snake.body_x[i] g_food.x g_snake.body_y[i] g_food.y) { is_position_valid RT_FALSE; break; } } if (is_position_valid) { lcd_show_string(g_food.x, g_food.y, 16, *, COLOR_FOOD); rt_kprintf(Food generated at (%d, %d)\n, g_food.x, g_food.y); return RT_TRUE; } } // 如果尝试多次都失败可能蛇已经很长地图快满了。 // 可以在这里处理游戏胜利或者选择一个“尽力而为”的位置例如从空闲格子列表中选一个。 rt_kprintf(Warning: Failed to generate food after %d attempts.\n, MAX_GENERATION_ATTEMPTS); // 一种简单的回退将食物放在一个固定安全位置如左上角第一个可用格但需要额外检查。 return RT_FALSE; }更高级的优化思路 对于大地图或长蛇可以维护一个“空闲格子”的列表或位图。每次蛇移动或食物被吃时更新这个列表。生成食物时直接从空闲格子中随机选取一个时间复杂度是O(1)完全避免了循环碰撞检测。这在蛇很长时优势明显。4.3 碰撞检测的实现碰撞检测需要高效因为它每帧都要执行。// 检测是否撞墙 rt_bool_t is_collision_with_wall(int x, int y) { // 墙壁在坐标0和 MAP_WIDTH - GRID_SIZE 等处 if (x GRID_SIZE || x MAP_WIDTH - GRID_SIZE || y GRID_SIZE || y MAP_HEIGHT - GRID_SIZE) { return RT_TRUE; } return RT_FALSE; } // 检测是否撞到自己 rt_bool_t is_collision_with_self(int head_x, int head_y) { // 从蛇身第一节开始检查第0节是新的头还没更新进去 for (int i 1; i g_snake.length; i) { // 注意从 i1 开始 if (g_snake.body_x[i] head_x g_snake.body_y[i] head_y) { return RT_TRUE; } } return RT_FALSE; }注意撞自身检测的循环起点是i1因为i0是当前蛇头而我们要检测的是新头是否撞上了“旧身体”。5. 工程整合、调试与性能优化实战5.1 主函数框架与模块化整合将上述模块整合进一个清晰的main.c中。RT-Thread的入口通常是main()或app_init()。#include rtthread.h #include rtdevice.h #include lcd.h // 你的LCD驱动头文件 #include snake_game.h // 将游戏相关的数据结构、函数声明放在这里 // 全局变量定义 volatile int g_key_direction DIR_RIGHT; snake_t g_snake; food_t g_food; int g_score 0; int main(void) { rt_kprintf(Snake Game Start!\n); // 1. 硬件初始化 lcd_init(); // 初始化LCD lcd_clear(COLOR_BACKGROUND); key_init(); // 初始化按键中断包含防抖配置 // 2. 游戏初始化 game_init(); // 初始化蛇和食物位置绘制边框 // 3. 游戏主循环 while (1) { // 3.1 更新游戏逻辑 game_update(); // 3.2 检查游戏是否结束 if (g_game_state GAME_OVER) { break; } // 3.3 渲染如果game_update中未包含局部渲染则在此全屏渲染 // game_render(); // 3.4 控制游戏速度 rt_thread_mdelay(300); // 300ms一帧约3.3 FPS } // 4. 游戏结束处理 show_game_over_screen(); rt_thread_mdelay(5000); // 显示5秒结束画面 return 0; }5.2 调试技巧与常见问题排查在嵌入式环境调试rt_kprintf是你的好朋友。在关键位置添加打印信息。问题1按键无反应或反应混乱。排查首先在keyDown中断函数里加打印确认中断是否触发参数是否正确。检查引脚定义、上拉/下拉模式、中断触发模式下降沿、中断使能。注意RT-Thread的中断处理中不能使用rt_thread_mdelay等可能导致挂起的函数。问题2蛇移动时画面闪烁或残留。原因通常是渲染逻辑问题。未吃食物时没有擦除旧蛇尾或者吃食物时增长逻辑和绘制顺序有误。解决采用“局部更新”策略。在move_snake_body中明确知道哪几个格子发生了变化只更新这些格子。未吃食物时绘制新头、将旧头改为身体、擦除旧尾。吃食物时绘制新头、将旧头改为身体、保留旧尾因为长度增加了。问题3食物有时生成在蛇身上或墙上。排查检查generate_food函数中的边界条件。rand() % N的范围是0到N-1。确保计算后坐标在[GRID_SIZE, MAP_WIDTH - 2*GRID_SIZE]范围内。检查随机数种子。如果在循环中频繁调用srand(time(NULL))而time变化不快可能导致随机序列重复。建议在程序开始时只srand一次。问题4游戏速度不稳定或感觉卡顿。排查主循环中除了游戏逻辑和渲染是否做了其他耗时操作确保rt_thread_mdelay是稳定的延时来源。优化如果渲染特别是全屏刷新很慢务必改用局部渲染。LCD的像素操作如lcd_show_string可能底层是SPI通信比较耗时。5.3 性能优化与扩展思考双帧缓冲对于动画游戏闪烁的根源是直接在前缓冲区用户正在看的画面上绘图。如果LCD驱动支持可以开辟一个后缓冲区一块内存在内存中完成一帧所有元素的绘制然后一次性DMA传输到LCD这能完全消除闪烁。分数与速度分级可以让游戏速度随着分数增加而加快减少rt_thread_mdelay的值。这能增加游戏挑战性。使用LVGL等GUI库如果觉得字符显示太简陋可以集成LVGL。LVGL提供了丰富的控件、动画和图形绘制功能你可以用真正的矩形和图片来绘制蛇和食物效果会华丽很多。但这需要更多的内存和CPU资源并且要移植LVGL到你的板子上。加入音效可以利用PWM驱动一个蜂鸣器在吃食物、撞墙时发出不同频率的声音增加趣味性。保存最高分利用板载的Flash或EEPROM保存历史最高分实现简单的持久化存储。6. 完整代码梳理与关键注释以下是整合了上述优化思路后的核心代码框架重点展示了与原始代码不同的部分。/* snake_game.h */ #ifndef __SNAKE_GAME_H__ #define __SNAKE_GAME_H__ #include rtthread.h // 方向枚举提高可读性 typedef enum { DIR_UP 1, DIR_DOWN 2, DIR_LEFT 3, DIR_RIGHT 4 } dir_t; // 游戏状态 typedef enum { GAME_RUNNING, GAME_OVER, GAME_PAUSED } game_state_t; // 食物与蛇结构体定义 // ... (略同前文) // 全局变量声明 extern volatile dir_t g_key_direction; extern snake_t g_snake; extern food_t g_food; extern int g_score; extern game_state_t g_game_state; // 函数声明 void key_init(void); void game_init(void); void game_update(void); void game_render(void); rt_bool_t generate_food(void); void show_game_over_screen(void); #endif/* snake_game.c */ #include snake_game.h #include lcd.h #include stdlib.h // 全局变量定义 volatile dir_t g_key_direction DIR_RIGHT; snake_t g_snake; food_t g_food; int g_score 0; game_state_t g_game_state GAME_RUNNING; // 按键中断服务函数优化版 void key_isr_handler(void *args) { dir_t pressed_dir (dir_t)((int)args); static rt_tick_t last_tick 0; rt_tick_t now rt_tick_get(); // 硬件防抖50ms内只响应一次 if (now - last_tick rt_tick_from_millisecond(50)) { return; } last_tick now; // 软件防抖防止反向指令 if ((g_key_direction DIR_RIGHT pressed_dir DIR_LEFT) || (g_key_direction DIR_LEFT pressed_dir DIR_RIGHT) || (g_key_direction DIR_UP pressed_dir DIR_DOWN) || (g_key_direction DIR_DOWN pressed_dir DIR_UP)) { return; } g_key_direction pressed_dir; } void key_init(void) { // 引脚定义 #define KEY_UP_PIN GET_PIN(C, 5) #define KEY_DOWN_PIN GET_PIN(C, 1) #define KEY_LEFT_PIN GET_PIN(C, 0) #define KEY_RIGHT_PIN GET_PIN(C, 4) // 配置引脚与中断 rt_pin_mode(KEY_UP_PIN, PIN_MODE_INPUT_PULLUP); // ... 配置其他引脚 rt_pin_attach_irq(KEY_UP_PIN, PIN_IRQ_MODE_FALLING, key_isr_handler, (void*)DIR_UP); // ... 绑定其他引脚中断注意参数与枚举值对应 rt_pin_irq_enable(KEY_UP_PIN, PIN_IRQ_ENABLE); // ... 使能其他引脚中断 } void game_init(void) { // 初始化随机数种子 srand(rt_tick_get()); // 初始化蛇 g_snake.length 3; g_snake.speed GRID_SIZE; g_snake.body_x[0] 80; // 初始蛇头位置 g_snake.body_y[0] 80; for (int i 1; i g_snake.length; i) { g_snake.body_x[i] g_snake.body_x[i-1] - GRID_SIZE; // 向左延伸 g_snake.body_y[i] g_snake.body_y[i-1]; } // 绘制边框 draw_border(); // 生成并绘制第一个食物 generate_food(); // 绘制初始蛇 game_render(); } // 游戏状态更新核心 void game_update(void) { if (g_game_state ! GAME_RUNNING) return; // 计算新蛇头位置 int new_head_x g_snake.body_x[0]; int new_head_y g_snake.body_y[0]; switch(g_key_direction) { case DIR_LEFT: new_head_x - GRID_SIZE; break; case DIR_RIGHT: new_head_x GRID_SIZE; break; case DIR_UP: new_head_y - GRID_SIZE; break; case DIR_DOWN: new_head_y GRID_SIZE; break; } // 碰撞检测 if (is_collision_with_wall(new_head_x, new_head_y) || is_collision_with_self(new_head_x, new_head_y)) { g_game_state GAME_OVER; return; } // 移动蛇身局部渲染在此函数内完成 move_snake_body(new_head_x, new_head_y); // 吃食物判断 if (new_head_x g_food.x new_head_y g_food.y) { // 吃到食物蛇长度增加 g_snake.length; if (g_snake.length SNAKE_MAX_LEN) { // 蛇达到最大长度可以视为胜利 g_game_state GAME_OVER; return; } g_score 10; // 生成新食物 if (generate_food() ! RT_TRUE) { rt_kprintf(No space for new food! Game might end soon.\n); } // 注意吃食物时move_snake_body已经处理了增长保留了旧尾 } else { // 没吃到食物需要擦除旧蛇尾 int tail_idx g_snake.length; // 因为刚移动完尾部索引是length数组未使用的部分存着旧尾坐标 // 更清晰的做法在move_snake_body函数返回前保存旧尾坐标并在此擦除。 // 这里为简化假设move_snake_body内部根据是否吃到食物处理了擦除。 } } // 移动蛇身并处理局部渲染 void move_snake_body(int new_head_x, int new_head_y) { static int last_tail_x, last_tail_y; // 用于记录上一次移动前的尾巴位置 static rt_bool_t ate_food_last_frame RT_FALSE; // 保存移动前的尾巴位置用于未吃食物时擦除 if (!ate_food_last_frame g_snake.length 0) { last_tail_x g_snake.body_x[g_snake.length - 1]; last_tail_y g_snake.body_y[g_snake.length - 1]; } ate_food_last_frame RT_FALSE; // 身体向前移动 for (int i g_snake.length - 1; i 0; i--) { g_snake.body_x[i] g_snake.body_x[i - 1]; g_snake.body_y[i] g_snake.body_y[i - 1]; } // 设置新头 g_snake.body_x[0] new_head_x; g_snake.body_y[0] new_head_y; // --- 局部渲染 --- // 1. 绘制新蛇头 lcd_show_string(new_head_x, new_head_y, 16, , COLOR_SNAKE_HEAD); // 2. 将原蛇头位置重绘为蛇身如果长度1 if (g_snake.length 1) { lcd_show_string(g_snake.body_x[1], g_snake.body_y[1], 16, #, COLOR_SNAKE_BODY); } // 3. 如果上一帧没吃食物擦除旧尾巴 // 这个逻辑需要结合game_update中是否吃到食物的判断来联动这里是一个简化示意。 // 更好的设计是将“是否吃食物”作为参数传入此函数。 }这个代码框架比原始版本结构更清晰加入了防抖、方向反转保护、更健壮的食物生成和局部渲染优化。在实际移植时你需要根据具体的LCD驱动API调整绘图函数lcd_show_string并可能调整颜色定义。7. 项目总结与进阶玩法通过这个项目我们完成了一个在星火一号开发板上运行的、基于RT-Thread的贪吃蛇游戏。从修复原版的bug开始我们深入了嵌入式开发的几个关键点GPIO中断的配置与防抖处理、在实时操作系统环境下组织游戏主循环、基于数组的核心游戏算法实现以及针对嵌入式设备的性能优化技巧如局部渲染。这个项目麻雀虽小五脏俱全。它演示了如何将经典的软件算法与硬件交互结合起来。你可以在此基础上继续扩展图形化升级用LVGL绘制更精美的蛇身使用带圆角的矩形和食物使用图片。多种游戏模式增加障碍物、传送门、或者双人对战模式需要更多按键。联网功能利用星火一号的Wi-Fi/蓝牙模块将分数上传到服务器做一个排行榜。功耗优化在游戏暂停时让MCU进入低功耗模式通过按键中断唤醒。最重要的是通过动手解决实际问题——比如按键抖动、食物生成卡死、画面闪烁——你对嵌入式系统的理解会远比只看文档深刻得多。希望这个详细的实现和优化过程能给你带来启发祝你玩得开心也欢迎分享你修改后的更有趣的版本。
基于RT-Thread与星火一号开发板的贪吃蛇游戏实现与优化
1. 项目概述与核心思路刚拿到星火一号这块国产RT-Thread开发板总想用它做点有意思的东西把玩一下硬件和实时操作系统的结合。逛社区论坛时看到有网友zym_0208分享了一个基于LCD屏和按键的贪吃蛇游戏Demo这主意不错经典又有趣。于是兴冲冲地下载下来跑了一下游戏能玩但实测中发现了一些影响体验的小毛病比如按键响应有时不太跟手食物偶尔会刷在奇怪的位置导致蛇吃不到。这勾起了我的“折腾”欲——能不能在它的基础上把代码逻辑理顺把bug修掉甚至优化一下游戏体验呢这个项目的核心就是利用星火一号开发板自带的硬件资源实现一个完整的、可交互的贪吃蛇游戏。你需要用到的核心部件很简单一块LCD屏幕用于显示游戏画面四个独立按键分别对应上下左右方向控制。软件层面则完全基于RT-Thread这个国产的、优秀的物联网实时操作系统。它的价值在于这不仅仅是一个简单的编程练习更是一个综合性的嵌入式小项目涉及到了GPIO中断处理、实时任务调度、LCD驱动显示、以及经典游戏算法的嵌入式实现等多个知识点。无论你是刚接触RT-Thread的新手想通过一个有趣的项目上手还是有一定经验的开发者想看看如何在资源受限的MCU上优雅地组织代码这个案例都很有参考价值。我将在原工程的基础上重点解决几个问题优化按键中断的处理逻辑确保方向控制精准无误重构食物生成算法杜绝“无效食物”的出现并让整个游戏的逻辑更清晰、更健壮。下面我就把修改和优化后的完整实现过程以及其中踩过的坑和总结的经验详细地分享出来。2. 硬件环境搭建与驱动准备2.1 星火一号开发板与核心外设星火一号开发板的核心是一颗ARM Cortex-M系列的微控制器它原生搭载了RT-Thread操作系统开箱即用非常适合进行物联网和嵌入式GUI的快速原型开发。对于我们这个贪吃蛇游戏我们只关心它的两个外设LCD显示屏和GPIO按键。LCD显示屏板子通常搭载一块SPI或并口的LCD屏分辨率可能是240x240或240x320。RT-Thread的软件包中心一般提供了对应的驱动如lcd_spi_dev或lcd_ili9341。我们的游戏画面就将绘制在这块屏幕上。GPIO按键我们需要四个独立的按键来控制蛇的移动方向。在提供的代码中它们分别连接在PC0、PC1、PC4、PC5这四个引脚上。这些引脚被配置为上拉输入模式当按键按下时引脚电平从高由于上拉变为低产生一个下降沿从而触发中断。注意在动手前请务必确认你板载LCD的型号和驱动是否已正确配置。你可以通过RT-Thread的list_device命令查看是否有一个名为lcd或spi_lcd的设备。如果没有需要先去RT-Thread的包管理器(pkgs --update)中搜索并安装对应的LCD驱动软件包。2.2 引脚定义与中断配置详解代码开头对按键引脚进行了宏定义这是硬件层和软件层的桥梁。理解这里的细节很重要#define PIN_KEY0 GET_PIN(C, 0) // 通常映射为“左” #define PIN_KEY1 GET_PIN(C, 1) // 通常映射为“下” #define PIN_KEY2 GET_PIN(C, 4) // 通常映射为“右” #define PIN_KEY3 GET_PIN(C, 5) // 通常映射为“上” #define PIN_LED_R GET_PIN(F, 12) // 红色LED可用于游戏状态指示可选GET_PIN(C, 0)是RT-Thread提供的宏用于将端口C的第0号引脚转换为系统统一的引脚编号。接下来在main函数初始化部分对引脚进行配置// 设置引脚为输入模式并启用内部上拉电阻。 // 当按键未按下时引脚被上拉到高电平按下时引脚被拉到低电平。 rt_pin_mode(PIN_KEY0, PIN_MODE_INPUT_PULLUP); rt_pin_mode(PIN_KEY1, PIN_MODE_INPUT_PULLUP); rt_pin_mode(PIN_KEY2, PIN_MODE_INPUT_PULLUP); rt_pin_mode(PIN_KEY3, PIN_MODE_INPUT_PULLUP); // 绑定中断服务函数。当引脚发生下降沿PIN_IRQ_MODE_FALLING时调用keyDown函数。 // 最后一个参数(void*)X是传递给中断函数的用户数据这里用来区分是哪个按键。 rt_pin_attach_irq(PIN_KEY0, PIN_IRQ_MODE_FALLING, keyDown, (void*)3); rt_pin_attach_irq(PIN_KEY1, PIN_IRQ_MODE_FALLING, keyDown, (void*)2); rt_pin_attach_irq(PIN_KEY2, PIN_IRQ_MODE_FALLING, keyDown, (void*)4); rt_pin_attach_irq(PIN_KEY3, PIN_IRQ_MODE_FALLING, keyDown, (void*)1); // 使能引脚中断 rt_pin_irq_enable(PIN_KEY0, PIN_IRQ_ENABLE); rt_pin_irq_enable(PIN_KEY1, PIN_IRQ_ENABLE); rt_pin_irq_enable(PIN_KEY2, PIN_IRQ_ENABLE); rt_pin_irq_enable(PIN_KEY3, PIN_IRQ_ENABLE);这里有一个关键细节传递给keyDown函数的参数(void*)1到(void*)4并非随意赋值。它需要与后续游戏逻辑中方向判断的case值对应。例如原代码中(void*)3对应case 3:左移这需要根据你的按键实际布局和逻辑定义来保持一致。如果觉得数字不直观可以定义成枚举。2.3 中断服务函数的设计与优化中断服务函数keyDown必须简短高效因为它打断了主程序的正常执行。原版代码在这里处理得比较粗糙我们来看优化后的思路// 全局变量用于在主循环中读取按键值。使用volatile防止编译器优化。 volatile int key_direction DIR_RIGHT; // 初始方向向右 void keyDown(void *args) { int pressed_key (int)args; // 简单的按键防抖和方向反转判断 static rt_tick_t last_tick 0; rt_tick_t current_tick rt_tick_get(); // 简易防抖两次中断间隔小于50ms则忽略 if (current_tick - last_tick rt_tick_from_millisecond(50)) { return; } last_tick current_tick; // 防止蛇直接反向移动例如正在向右时不能立即按左 if ((key_direction DIR_RIGHT pressed_key DIR_LEFT) || (key_direction DIR_LEFT pressed_key DIR_RIGHT) || (key_direction DIR_UP pressed_key DIR_DOWN) || (key_direction DIR_DOWN pressed_key DIR_UP)) { return; // 忽略反向按键 } // 更新方向 key_direction pressed_key; rt_kprintf([ISR] Key %d pressed.\n, pressed_key); }优化点解析防抖处理机械按键在按下和弹起时会产生物理抖动可能导致多次触发中断。通过记录上次中断的时间戳忽略短时间内如50ms内的重复触发能有效提升稳定性。方向反转保护这是贪吃蛇游戏的一个基本规则蛇不能瞬间掉头。在中断层面就过滤掉这种非法操作比在主循环中判断更及时、更安全。使用枚举增强可读性建议将数字1、2、3、4定义为DIR_UPDIR_DOWNDIR_LEFTDIR_RIGHT这样代码意图一目了然。3. 游戏核心逻辑设计与数据结构3.1 地图、蛇与食物的数据建模游戏的所有状态都需要用数据结构清晰地定义出来。我们采用全局变量的方式来管理。#define SNAKE_MAX_LEN 100 // 蛇身最大长度根据屏幕大小和格子大小估算 #define MAP_WIDTH 240 // 屏幕像素宽度 #define MAP_HEIGHT 240 // 屏幕像素高度 #define GRID_SIZE 16 // 每个游戏格子蛇身一节/食物的像素大小 // 食物结构体 typedef struct { int x; // 食物的x坐标像素 int y; // 食物的y坐标像素 } food_t; // 蛇结构体 typedef struct { int speed; // 移动速度像素/次实际上由延时控制这里可表示步长 int length; // 当前蛇身长度含蛇头 int body_x[SNAKE_MAX_LEN]; // 蛇身各节的x坐标数组 int body_y[SNAKE_MAX_LEN]; // 蛇身各节的y坐标数组 // 可以增加方向变量但本例中方向由全局变量key_direction控制 } snake_t; // 全局游戏对象 food_t g_food; snake_t g_snake; volatile int g_key_direction 3; // 初始方向需与中断参数对应 int g_score 0;设计要点坐标系统屏幕左上角为原点(0,0)x轴向右y轴向下。所有坐标都是像素坐标。网格化为了让蛇和食物对齐它们的坐标必须是GRID_SIZE16的整数倍。这简化了碰撞检测和移动逻辑。蛇的存储使用数组来存储蛇身每一节的坐标。蛇头是body_x[0]和body_y[0]。移动时我们只需要更新数组内容然后重绘相关部分。3.2 游戏主循环与状态机贪吃蛇游戏的核心是一个无限循环通常每秒运行多次如每秒3-5次对应300ms延时。每次循环称为一“帧”或一个“滴答”。每一帧内程序按固定顺序执行以下操作处理输入读取由中断更新的g_key_direction。更新游戏状态根据方向计算蛇头的新位置。判断新位置是否撞墙、撞自身游戏结束。判断新位置是否吃到食物。如果吃到食物蛇长度加1分数增加在新位置生成食物。如果没吃到蛇身体向前移动一格尾部消失。渲染画面根据最新的蛇和食物坐标在LCD屏幕上更新显示。延时等待一段时间控制游戏速度。原代码将状态更新和渲染混合在handleFood()函数里我们可以将其拆解得更清晰void game_update() { // 1. 根据当前方向计算蛇头的新位置临时变量 int new_head_x g_snake.body_x[0]; int new_head_y g_snake.body_y[0]; switch(g_key_direction) { case DIR_LEFT: new_head_x - GRID_SIZE; break; case DIR_RIGHT: new_head_x GRID_SIZE; break; case DIR_UP: new_head_y - GRID_SIZE; break; case DIR_DOWN: new_head_y GRID_SIZE; break; } // 2. 碰撞检测 if (is_collision_with_wall(new_head_x, new_head_y) || is_collision_with_self(new_head_x, new_head_y)) { game_over(); return; } // 3. 移动蛇身 move_snake_body(new_head_x, new_head_y); // 4. 吃食物检测与处理 if (new_head_x g_food.x new_head_y g_food.y) { eat_food(); generate_food(); // 生成新食物 } } void game_render() { // 清屏或局部刷新优化性能可选 // lcd_clear(COLOR_BACKGROUND); // 绘制地图边框 draw_border(); // 绘制食物 lcd_show_string(g_food.x, g_food.y, 16, *, COLOR_FOOD); // 绘制蛇 // 蛇头 lcd_show_string(g_snake.body_x[0], g_snake.body_y[0], 16, , COLOR_SNAKE_HEAD); // 蛇身 for (int i 1; i g_snake.length; i) { lcd_show_string(g_snake.body_x[i], g_snake.body_y[i], 16, #, COLOR_SNAKE_BODY); } // 可以增加擦除上一帧蛇尾的逻辑实现更流畅动画 }在主循环中顺序调用game_update()和game_render()然后延时。4. 关键算法实现与深度优化4.1 蛇的移动算法数组移位法这是最核心的算法之一。贪吃蛇的移动特点是蛇头向新方向前进一格每一节身体都移动到它前面一节的位置上。用数组实现非常高效。void move_snake_body(int new_head_x, int new_head_y) { // 保存旧蛇尾坐标用于判断是否需要增长吃食物时或擦除未吃食物时 int old_tail_x g_snake.body_x[g_snake.length - 1]; int old_tail_y g_snake.body_y[g_snake.length - 1]; // 从蛇尾开始向前一节一节地移动坐标避免数据被覆盖 for (int i g_snake.length - 1; i 0; i--) { g_snake.body_x[i] g_snake.body_x[i - 1]; g_snake.body_y[i] g_snake.body_y[i - 1]; } // 设置新的蛇头坐标 g_snake.body_x[0] new_head_x; g_snake.body_y[0] new_head_y; // **优化点局部渲染** // 在未吃食物时我们只需要更新三处新蛇头、旧蛇头变成蛇身第二节、旧蛇尾擦除。 // 这比全屏重绘效率高得多。 // 1. 绘制新蛇头 lcd_show_string(new_head_x, new_head_y, 16, , COLOR_SNAKE_HEAD); // 2. 将原来的蛇头现在是第二节重绘为蛇身 lcd_show_string(g_snake.body_x[1], g_snake.body_y[1], 16, #, COLOR_SNAKE_BODY); // 3. 擦除旧蛇尾如果没吃到食物 // 这个判断可以放在更高层的逻辑里 // lcd_show_string(old_tail_x, old_tail_y, 16, , COLOR_BACKGROUND); }为什么从后往前移动如果从前往后移动当你把body_x[0]赋值给body_x[1]后body_x[0]的值已经丢失被新头坐标覆盖前导致body_x[1]和body_x[2]都变成相同的新头坐标蛇就缩成一团了。从后往前移动确保了每一节在“交出”自己的坐标前已经“接收”了前一节的坐标。4.2 食物的生成算法合法性校验与效率优化原版代码的食物生成逻辑在一个while(1)循环里通过随机数生成坐标然后检查是否合法。这在小地图上没问题但当地图几乎被蛇占满时可能会陷入长时间的循环甚至死循环。我们需要优化。合法性条件坐标必须在游戏区域内避开墙壁。坐标不能与蛇身的任何一节重合。关键细节由于我们使用lcd_show_string显示一个16x16的字符而字符的宽度在像素对齐上可能有讲究原代码提到food.x % 2 0这是为了确保字符显示在偶数像素起始地址避免显示错位。这取决于具体的LCD驱动和字体。如果你的显示正常可以忽略此条件如果出现食物“半截”显示就需要这个校验。优化后的生成算法#define MAX_GENERATION_ATTEMPTS 100 // 最大尝试次数避免死循环 rt_bool_t generate_food(void) { int attempts 0; int is_position_valid RT_FALSE; while (attempts MAX_GENERATION_ATTEMPTS) { // 生成网格内的随机坐标 g_food.x (rt_rand() % (MAP_WIDTH / GRID_SIZE - 2)) * GRID_SIZE GRID_SIZE; // 避开左右墙 g_food.y (rt_rand() % (MAP_HEIGHT / GRID_SIZE - 2)) * GRID_SIZE GRID_SIZE; // 避开上下墙 // 条件3: 如果需要像素对齐根据你的LCD驱动调整或移除 // if (g_food.x % 2 ! 0) continue; // 条件2: 检查是否与蛇身重合 is_position_valid RT_TRUE; for (int i 0; i g_snake.length; i) { if (g_snake.body_x[i] g_food.x g_snake.body_y[i] g_food.y) { is_position_valid RT_FALSE; break; } } if (is_position_valid) { lcd_show_string(g_food.x, g_food.y, 16, *, COLOR_FOOD); rt_kprintf(Food generated at (%d, %d)\n, g_food.x, g_food.y); return RT_TRUE; } } // 如果尝试多次都失败可能蛇已经很长地图快满了。 // 可以在这里处理游戏胜利或者选择一个“尽力而为”的位置例如从空闲格子列表中选一个。 rt_kprintf(Warning: Failed to generate food after %d attempts.\n, MAX_GENERATION_ATTEMPTS); // 一种简单的回退将食物放在一个固定安全位置如左上角第一个可用格但需要额外检查。 return RT_FALSE; }更高级的优化思路 对于大地图或长蛇可以维护一个“空闲格子”的列表或位图。每次蛇移动或食物被吃时更新这个列表。生成食物时直接从空闲格子中随机选取一个时间复杂度是O(1)完全避免了循环碰撞检测。这在蛇很长时优势明显。4.3 碰撞检测的实现碰撞检测需要高效因为它每帧都要执行。// 检测是否撞墙 rt_bool_t is_collision_with_wall(int x, int y) { // 墙壁在坐标0和 MAP_WIDTH - GRID_SIZE 等处 if (x GRID_SIZE || x MAP_WIDTH - GRID_SIZE || y GRID_SIZE || y MAP_HEIGHT - GRID_SIZE) { return RT_TRUE; } return RT_FALSE; } // 检测是否撞到自己 rt_bool_t is_collision_with_self(int head_x, int head_y) { // 从蛇身第一节开始检查第0节是新的头还没更新进去 for (int i 1; i g_snake.length; i) { // 注意从 i1 开始 if (g_snake.body_x[i] head_x g_snake.body_y[i] head_y) { return RT_TRUE; } } return RT_FALSE; }注意撞自身检测的循环起点是i1因为i0是当前蛇头而我们要检测的是新头是否撞上了“旧身体”。5. 工程整合、调试与性能优化实战5.1 主函数框架与模块化整合将上述模块整合进一个清晰的main.c中。RT-Thread的入口通常是main()或app_init()。#include rtthread.h #include rtdevice.h #include lcd.h // 你的LCD驱动头文件 #include snake_game.h // 将游戏相关的数据结构、函数声明放在这里 // 全局变量定义 volatile int g_key_direction DIR_RIGHT; snake_t g_snake; food_t g_food; int g_score 0; int main(void) { rt_kprintf(Snake Game Start!\n); // 1. 硬件初始化 lcd_init(); // 初始化LCD lcd_clear(COLOR_BACKGROUND); key_init(); // 初始化按键中断包含防抖配置 // 2. 游戏初始化 game_init(); // 初始化蛇和食物位置绘制边框 // 3. 游戏主循环 while (1) { // 3.1 更新游戏逻辑 game_update(); // 3.2 检查游戏是否结束 if (g_game_state GAME_OVER) { break; } // 3.3 渲染如果game_update中未包含局部渲染则在此全屏渲染 // game_render(); // 3.4 控制游戏速度 rt_thread_mdelay(300); // 300ms一帧约3.3 FPS } // 4. 游戏结束处理 show_game_over_screen(); rt_thread_mdelay(5000); // 显示5秒结束画面 return 0; }5.2 调试技巧与常见问题排查在嵌入式环境调试rt_kprintf是你的好朋友。在关键位置添加打印信息。问题1按键无反应或反应混乱。排查首先在keyDown中断函数里加打印确认中断是否触发参数是否正确。检查引脚定义、上拉/下拉模式、中断触发模式下降沿、中断使能。注意RT-Thread的中断处理中不能使用rt_thread_mdelay等可能导致挂起的函数。问题2蛇移动时画面闪烁或残留。原因通常是渲染逻辑问题。未吃食物时没有擦除旧蛇尾或者吃食物时增长逻辑和绘制顺序有误。解决采用“局部更新”策略。在move_snake_body中明确知道哪几个格子发生了变化只更新这些格子。未吃食物时绘制新头、将旧头改为身体、擦除旧尾。吃食物时绘制新头、将旧头改为身体、保留旧尾因为长度增加了。问题3食物有时生成在蛇身上或墙上。排查检查generate_food函数中的边界条件。rand() % N的范围是0到N-1。确保计算后坐标在[GRID_SIZE, MAP_WIDTH - 2*GRID_SIZE]范围内。检查随机数种子。如果在循环中频繁调用srand(time(NULL))而time变化不快可能导致随机序列重复。建议在程序开始时只srand一次。问题4游戏速度不稳定或感觉卡顿。排查主循环中除了游戏逻辑和渲染是否做了其他耗时操作确保rt_thread_mdelay是稳定的延时来源。优化如果渲染特别是全屏刷新很慢务必改用局部渲染。LCD的像素操作如lcd_show_string可能底层是SPI通信比较耗时。5.3 性能优化与扩展思考双帧缓冲对于动画游戏闪烁的根源是直接在前缓冲区用户正在看的画面上绘图。如果LCD驱动支持可以开辟一个后缓冲区一块内存在内存中完成一帧所有元素的绘制然后一次性DMA传输到LCD这能完全消除闪烁。分数与速度分级可以让游戏速度随着分数增加而加快减少rt_thread_mdelay的值。这能增加游戏挑战性。使用LVGL等GUI库如果觉得字符显示太简陋可以集成LVGL。LVGL提供了丰富的控件、动画和图形绘制功能你可以用真正的矩形和图片来绘制蛇和食物效果会华丽很多。但这需要更多的内存和CPU资源并且要移植LVGL到你的板子上。加入音效可以利用PWM驱动一个蜂鸣器在吃食物、撞墙时发出不同频率的声音增加趣味性。保存最高分利用板载的Flash或EEPROM保存历史最高分实现简单的持久化存储。6. 完整代码梳理与关键注释以下是整合了上述优化思路后的核心代码框架重点展示了与原始代码不同的部分。/* snake_game.h */ #ifndef __SNAKE_GAME_H__ #define __SNAKE_GAME_H__ #include rtthread.h // 方向枚举提高可读性 typedef enum { DIR_UP 1, DIR_DOWN 2, DIR_LEFT 3, DIR_RIGHT 4 } dir_t; // 游戏状态 typedef enum { GAME_RUNNING, GAME_OVER, GAME_PAUSED } game_state_t; // 食物与蛇结构体定义 // ... (略同前文) // 全局变量声明 extern volatile dir_t g_key_direction; extern snake_t g_snake; extern food_t g_food; extern int g_score; extern game_state_t g_game_state; // 函数声明 void key_init(void); void game_init(void); void game_update(void); void game_render(void); rt_bool_t generate_food(void); void show_game_over_screen(void); #endif/* snake_game.c */ #include snake_game.h #include lcd.h #include stdlib.h // 全局变量定义 volatile dir_t g_key_direction DIR_RIGHT; snake_t g_snake; food_t g_food; int g_score 0; game_state_t g_game_state GAME_RUNNING; // 按键中断服务函数优化版 void key_isr_handler(void *args) { dir_t pressed_dir (dir_t)((int)args); static rt_tick_t last_tick 0; rt_tick_t now rt_tick_get(); // 硬件防抖50ms内只响应一次 if (now - last_tick rt_tick_from_millisecond(50)) { return; } last_tick now; // 软件防抖防止反向指令 if ((g_key_direction DIR_RIGHT pressed_dir DIR_LEFT) || (g_key_direction DIR_LEFT pressed_dir DIR_RIGHT) || (g_key_direction DIR_UP pressed_dir DIR_DOWN) || (g_key_direction DIR_DOWN pressed_dir DIR_UP)) { return; } g_key_direction pressed_dir; } void key_init(void) { // 引脚定义 #define KEY_UP_PIN GET_PIN(C, 5) #define KEY_DOWN_PIN GET_PIN(C, 1) #define KEY_LEFT_PIN GET_PIN(C, 0) #define KEY_RIGHT_PIN GET_PIN(C, 4) // 配置引脚与中断 rt_pin_mode(KEY_UP_PIN, PIN_MODE_INPUT_PULLUP); // ... 配置其他引脚 rt_pin_attach_irq(KEY_UP_PIN, PIN_IRQ_MODE_FALLING, key_isr_handler, (void*)DIR_UP); // ... 绑定其他引脚中断注意参数与枚举值对应 rt_pin_irq_enable(KEY_UP_PIN, PIN_IRQ_ENABLE); // ... 使能其他引脚中断 } void game_init(void) { // 初始化随机数种子 srand(rt_tick_get()); // 初始化蛇 g_snake.length 3; g_snake.speed GRID_SIZE; g_snake.body_x[0] 80; // 初始蛇头位置 g_snake.body_y[0] 80; for (int i 1; i g_snake.length; i) { g_snake.body_x[i] g_snake.body_x[i-1] - GRID_SIZE; // 向左延伸 g_snake.body_y[i] g_snake.body_y[i-1]; } // 绘制边框 draw_border(); // 生成并绘制第一个食物 generate_food(); // 绘制初始蛇 game_render(); } // 游戏状态更新核心 void game_update(void) { if (g_game_state ! GAME_RUNNING) return; // 计算新蛇头位置 int new_head_x g_snake.body_x[0]; int new_head_y g_snake.body_y[0]; switch(g_key_direction) { case DIR_LEFT: new_head_x - GRID_SIZE; break; case DIR_RIGHT: new_head_x GRID_SIZE; break; case DIR_UP: new_head_y - GRID_SIZE; break; case DIR_DOWN: new_head_y GRID_SIZE; break; } // 碰撞检测 if (is_collision_with_wall(new_head_x, new_head_y) || is_collision_with_self(new_head_x, new_head_y)) { g_game_state GAME_OVER; return; } // 移动蛇身局部渲染在此函数内完成 move_snake_body(new_head_x, new_head_y); // 吃食物判断 if (new_head_x g_food.x new_head_y g_food.y) { // 吃到食物蛇长度增加 g_snake.length; if (g_snake.length SNAKE_MAX_LEN) { // 蛇达到最大长度可以视为胜利 g_game_state GAME_OVER; return; } g_score 10; // 生成新食物 if (generate_food() ! RT_TRUE) { rt_kprintf(No space for new food! Game might end soon.\n); } // 注意吃食物时move_snake_body已经处理了增长保留了旧尾 } else { // 没吃到食物需要擦除旧蛇尾 int tail_idx g_snake.length; // 因为刚移动完尾部索引是length数组未使用的部分存着旧尾坐标 // 更清晰的做法在move_snake_body函数返回前保存旧尾坐标并在此擦除。 // 这里为简化假设move_snake_body内部根据是否吃到食物处理了擦除。 } } // 移动蛇身并处理局部渲染 void move_snake_body(int new_head_x, int new_head_y) { static int last_tail_x, last_tail_y; // 用于记录上一次移动前的尾巴位置 static rt_bool_t ate_food_last_frame RT_FALSE; // 保存移动前的尾巴位置用于未吃食物时擦除 if (!ate_food_last_frame g_snake.length 0) { last_tail_x g_snake.body_x[g_snake.length - 1]; last_tail_y g_snake.body_y[g_snake.length - 1]; } ate_food_last_frame RT_FALSE; // 身体向前移动 for (int i g_snake.length - 1; i 0; i--) { g_snake.body_x[i] g_snake.body_x[i - 1]; g_snake.body_y[i] g_snake.body_y[i - 1]; } // 设置新头 g_snake.body_x[0] new_head_x; g_snake.body_y[0] new_head_y; // --- 局部渲染 --- // 1. 绘制新蛇头 lcd_show_string(new_head_x, new_head_y, 16, , COLOR_SNAKE_HEAD); // 2. 将原蛇头位置重绘为蛇身如果长度1 if (g_snake.length 1) { lcd_show_string(g_snake.body_x[1], g_snake.body_y[1], 16, #, COLOR_SNAKE_BODY); } // 3. 如果上一帧没吃食物擦除旧尾巴 // 这个逻辑需要结合game_update中是否吃到食物的判断来联动这里是一个简化示意。 // 更好的设计是将“是否吃食物”作为参数传入此函数。 }这个代码框架比原始版本结构更清晰加入了防抖、方向反转保护、更健壮的食物生成和局部渲染优化。在实际移植时你需要根据具体的LCD驱动API调整绘图函数lcd_show_string并可能调整颜色定义。7. 项目总结与进阶玩法通过这个项目我们完成了一个在星火一号开发板上运行的、基于RT-Thread的贪吃蛇游戏。从修复原版的bug开始我们深入了嵌入式开发的几个关键点GPIO中断的配置与防抖处理、在实时操作系统环境下组织游戏主循环、基于数组的核心游戏算法实现以及针对嵌入式设备的性能优化技巧如局部渲染。这个项目麻雀虽小五脏俱全。它演示了如何将经典的软件算法与硬件交互结合起来。你可以在此基础上继续扩展图形化升级用LVGL绘制更精美的蛇身使用带圆角的矩形和食物使用图片。多种游戏模式增加障碍物、传送门、或者双人对战模式需要更多按键。联网功能利用星火一号的Wi-Fi/蓝牙模块将分数上传到服务器做一个排行榜。功耗优化在游戏暂停时让MCU进入低功耗模式通过按键中断唤醒。最重要的是通过动手解决实际问题——比如按键抖动、食物生成卡死、画面闪烁——你对嵌入式系统的理解会远比只看文档深刻得多。希望这个详细的实现和优化过程能给你带来启发祝你玩得开心也欢迎分享你修改后的更有趣的版本。
