简介这份STM32F407贪吃蛇游戏程序面向嵌入式初学者与课程设计开发者以经典贪吃蛇为载体帮助读者在Cortex-M4平台上理解GPIO驱动显示、定时器中断控制帧率、按键中断响应、数组状态管理与碰撞检测等核心机制。工程共含159个文件以77个.h头文件和75个.c源文件为主体搭配启动汇编文件、Keil工程与hex可执行文件以及批处理和说明页面等辅助内容压缩包约831KB结构接近完整MDK工程便于直接编译、烧录和二次修改。已有2820人学习说明该案例在STM32入门与项目实践中有较高参考价值。读者可据此梳理外设库组织方式、游戏主循环与中断服务例程的协作关系并借助可运行固件快速验证显示与输入逻辑适合用作嵌入式课程实验、毕业设计原型或自学练手项目。1. 一块吃灰的F407开发板被我改成了能连玩的贪吃蛇某实验室的柜子里躺着一块STM32F407开发板板载3.2寸并口TFT、四个独立按键、一个蜂鸣器。学完GPIO点灯和串口打印之后很多人就把它放回去了因为找不到一个规模刚好的练手项目。这个STM32F407贪吃蛇程序干的就是这件事把一块开发板变成一个能开机、能计分、能掉电保存最高分的小游戏机。它不适合当产品但适合当一次完整工程演练——屏幕驱动、定时器节拍、状态机、输入防抖、Flash存储一条链上全是真实开发里躲不开的东西。想从会点灯跨到能跑起一个小系统的开发者从它入手比啃例程库划算得多。2. 硬件底子与工程骨架从时钟树到屏幕点亮的第一层落地拿到这份工程第一件事不是看游戏逻辑而是看它怎么把一块裸板变成有显示、有时间基准的运行环境。游戏逻辑再花哨时钟配错、屏幕不亮、节拍不准后面全是白搭。这一层也是新手最容易翻车的地方——引脚表看错一个、FSMC 时序差一个周期现象就是花屏或者干脆白屏排查起来像黑匣子。2.1 板级资源盘点与引脚分配整份工程围绕三类外设展开显示、输入、计时。显示用 FSMC 并口驱动 3.2 寸 TFT常见驱动芯片为 ILI9341 一类320×240 分辨率RGB565 色深输入是四个独立按键计时靠一个基本定时器产生毫秒节拍。蜂鸣器负责吃食物和撞墙的音效串口只在调试阶段打印状态正式运行时关掉。我一般会先把引脚占用整理成一张表贴在工程目录的 README 里改板子的时候照着改比翻代码快功能外设/信号典型引脚备注LCD 数据线FSMC_D0~D15PD14/PD15/PD0/PD1 等16 位并口一次写半个字LCD 片选FSMC_NE1PD7Bank1 子区 1LCD 命令/数据选择FSMC_A16PD11高电平写数据、低电平写命令LCD 写使能FSMC_NWEPD5由 FSMC 自动产生LCD 背光TIM4_CH3PB8PWM 调亮度省电也护眼按键 上/下/左/右GPIO 输入PE0~PE3内部上拉按下为低蜂鸣器TIM12_CH1PB14有源蜂鸣器直接给电平即可调试串口USART1PA9/PA10115200-8-N-1选并口屏而不是 SPI 屏理由很实际320×240 的 RGB565 整屏是 153600 字节SPI 跑 42MHz 理论也要 30ms 左右实际还要翻倍FSMC 16 位并口一次写一个半字整屏刷新的时间差一个数量级。贪吃蛇大部分时间是局部刷新SPI 其实也够用但菜单切换、清屏、游戏结束全屏重绘那几下体验差别非常明显。2.2 时钟树配置168MHz 的地基怎么打F407 的标准配置是 HSE 8MHz 晶振经 PLL 倍频到 168MHzAHB 168MHzAPB1 42MHzAPB2 84MHz。这里有个容易忽略的点APB1 预分频不为 1 时挂在 APB1 上的定时器时钟会再乘 2所以 TIM6 实际拿到的是 84MHz不是 42MHz。分频算错游戏节拍就会整体慢一倍蛇爬得像蜗牛。void SystemClock_Config(void) { RCC_OscInitTypeDef osc {0}; RCC_ClkInitTypeDef clk {0}; __HAL_RCC_PWR_CLK_ENABLE(); /* 168MHz 必须开 Scale1 电压档否则高频下不稳定 */ __HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1); osc.OscillatorType RCC_OSCILLATORTYPE_HSE; osc.HSEState RCC_HSE_ON; osc.PLL.PLLState RCC_PLL_ON; osc.PLL.PLLSource RCC_PLLSOURCE_HSE; osc.PLL.PLLM 8; /* 8MHz / 8 1MHz 鉴相输入 */ osc.PLL.PLLN 336; /* 1MHz * 336 336MHz VCO */ osc.PLL.PLLP RCC_PLLP_DIV2; /* 336 / 2 168MHz 系统时钟 */ osc.PLL.PLLQ 7; /* 48MHzUSB/SDIO 用得上 */ HAL_RCC_OscConfig(osc); clk.ClockType RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2; clk.SYSCLKSource RCC_SYSCLKSOURCE_PLLCLK; clk.AHBCLKDivider RCC_SYSCLK_DIV1; /* HCLK 168MHz */ clk.APB1CLKDivider RCC_HCLK_DIV4; /* PCLK1 42MHz定时器 84MHz */ clk.APB2CLKDivider RCC_HCLK_DIV2; /* PCLK2 84MHz */ HAL_RCC_ClockConfig(clk, FLASH_LATENCY_5); /* 168MHz 需 5 个等待周期 */ }PLLM/PLLN/PLLP 三个参数是联动的改任何一个都要重新核对最终频率别只改 N。FLASH_LATENCY_5也不能省168MHz 下 Flash 读速度跟不上等待周期少了会随机死机而且这种死机很玄学——跑着跑着卡住复位又好了查起来极其难受。2.3 FSMC 并口屏初始化让第一帧图像亮起来屏幕点亮分三步FSMC 控制器初始化、面板寄存器序列下发、读 ID 校验。读 ID 这一步别省它是判断接线对不对、时序对不对最直接的证据——ID 读出来是 0x0000 或者 0xFFFF基本就是数据线虚焊或者片选错了。/* NE1 基址 0x60000000RS 接 A16所以数据口地址偏移 0x20000 */ #define LCD_BASE ((uint32_t)0x60000000) #define LCD_REG (*(volatile uint16_t *)(LCD_BASE)) #define LCD_RAM (*(volatile uint16_t *)(LCD_BASE 0x00020000)) static void LCD_FSMC_Init(void) { FSMC_NORSRAM_TimingTypeDef t {0}; hfsmc.Instance FSMC_NORSRAM_DEVICE; /* 16 位数据宽度、NORSRAM 模式、写使能B 模式异步访问 */ t.AddressSetupTime 5; /* 地址建立 5 个 HCLK */ t.AddressHoldTime 0; t.DataSetupTime 8; /* 数据建立 8 个 HCLK太快会花屏 */ t.BusTurnAroundDuration 0; t.CLKDivision 0; t.DataLatency 0; t.AccessMode FSMC_ACCESS_MODE_B; HAL_SRAM_Init(hsram, timing, t); GPIO_InitTypeDef g {0}; g.Pin GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_7 | GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_14 | GPIO_PIN_15; g.Mode GPIO_MODE_AF_PP; g.Pull GPIO_NOPULL; g.Speed GPIO_SPEED_FREQ_VERY_HIGH; g.Alternate GPIO_AF12_FSMC; HAL_GPIO_Init(GPIOD, g); } /* 写命令/写数据靠地址线 A16 区分不用手动拉 IO */ static inline void LCD_WriteCmd(uint16_t cmd) { LCD_REG cmd; } static inline void LCD_WriteData(uint16_t d) { LCD_RAM d; } /* 设置矩形窗口局部刷新全靠它 */ void LCD_SetWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { LCD_WriteCmd(0x2A); /* 列地址设置 */ LCD_WriteData(x0 8); LCD_WriteData(x0 0xFF); LCD_WriteData(x1 8); LCD_WriteData(x1 0xFF); LCD_WriteCmd(0x2B); /* 行地址设置 */ LCD_WriteData(y0 8); LCD_WriteData(y0 0xFF); LCD_WriteData(y1 8); LCD_WriteData(y1 0xFF); LCD_WriteCmd(0x2C); /* 进入写显存模式 */ }DataSetupTime是这里最需要试的参数手册给的典型值是 8~15 个 HCLK设太小屏幕会出现雪花点或者整行错位设太大刷新变慢。板子上延长排线的话建议直接拉到 15宁可慢一点也别花屏。LCD_SetWindow是后面所有局部刷新的基础每次只刷一个格子比如 12×12 像素时窗口设成这一格的范围然后连续写 144 个像素值比全屏刷新快得多。3. 游戏状态机与主循环一个 tick 怎么串起按键、蛇身和屏幕工程跑起来之后最值得看的是主循环的组织方式。很多学生写的贪吃蛇是在定时器中断里直接刷屏、直接处理按键跑起来能动但一改速度或者一加音效就开始卡顿。这份工程把时间推进和渲染拆开中断只负责计一个数剩下的都在主循环里按状态分发改起来心里有底。3.1 四态状态机与它的流转游戏一共四个状态菜单、运行中、暂停、结束。状态机不是什么高深设计它的价值在于把哪个状态下该响应什么按键写死避免出现暂停时蛇还在动、结束后还能转向这类交互 bug。typedef enum { ST_MENU 0, /* 开机菜单等待开始键 */ ST_RUNNING, /* 运行中接受方向输入按节拍前进 */ ST_PAUSED, /* 暂停画面冻结只响应继续/返回 */ ST_OVER /* 结束显示分数等待重开 */ } GameState_e; typedef struct { GameState_e state; uint32_t ms_tick; /* 由定时器中断累加单位 ms */ uint16_t step_ms; /* 当前速度等级对应的步进间隔 */ uint16_t score; uint16_t best; uint8_t dirty; /* 有画面变化时置 1主循环据此刷新 */ } GameCtx_t; static GameCtx_t game { .state ST_MENU, .step_ms 220 };ms_tick在中断里自增主循环拿它和step_ms比较够了就执行一步逻辑并清零。这种软件分频的好处是速度可以随时改改step_ms就行不用动定时器寄存器。3.2 定时器中断与主循环的分工我一般用一个基本定时器TIM6 或 TIM7没有 IO 占用产生 1ms 节拍中断服务函数里只做一件事void TIM6_IRQHandler(void) { if (__HAL_TIM_GET_FLAG(htim6, TIM_FLAG_UPDATE)) { __HAL_TIM_CLEAR_FLAG(htim6, TIM_FLAG_UPDATE); game.ms_tick; /* 只累加绝不在这里刷屏 */ } } void Game_Loop(void) { for (;;) { Input_Poll(); /* 按键扫描防抖 */ Key_Dispatch(); /* 按状态分发按键 */ if (game.ms_tick game.step_ms) { game.ms_tick 0; if (game.state ST_RUNNING) { Game_Step(); /* 蛇前进一格 */ game.dirty 1; } } if (game.dirty) { Render_Flush(); /* 只重绘变化的部分 */ game.dirty 0; } } }中断里坚决不刷屏原因很直接一次全屏刷新是毫秒级的放进 1ms 中断里会把中断撑爆其他中断全被推迟按键响应立刻变迟钝严重时看门狗都会咬。Input_Poll每轮都跑不受游戏节拍限制这样即使蛇走得很慢按键也不会丢。3.3 按键扫描与方向缓冲区按键用 20ms 的状态机防抖连续采样到稳定电平才认一次按下并且记录上一次状态只在上升沿从松开到按下产生事件。方向输入不能直接赋值给下一方向因为一帧之内可能连按两次——比如蛇向右走玩家快速按下上再按左如果直接覆盖下一帧蛇就往左走了等于原地掉头撞自己。#define DIR_QUEUE_LEN 3 static int8_t dir_queue[DIR_QUEUE_LEN]; static uint8_t dir_head, dir_tail, dir_count; /* 入队只在队列不满时接受重复方向直接丢弃 */ void Dir_Push(int8_t d) { if (dir_count 0 dir_queue[(dir_head DIR_QUEUE_LEN - 1) % DIR_QUEUE_LEN] d) return; /* 和上一个待处理方向相同不重复入队 */ if (dir_count DIR_QUEUE_LEN) return; dir_queue[dir_head] d; dir_head (dir_head 1) % DIR_QUEUE_LEN; dir_count; } /* 出队每次逻辑步进只取一个方向 */ int8_t Dir_Pop(int8_t cur) { if (dir_count 0) return cur; int8_t d dir_queue[dir_tail]; dir_tail (dir_tail 1) % DIR_QUEUE_LEN; dir_count--; /* 反向输入直接忽略这是防自杀最后一道闸 */ if ((d DIR_UP cur DIR_DOWN) || (d DIR_DOWN cur DIR_UP) || (d DIR_LEFT cur DIR_RIGHT) || (d DIR_RIGHT cur DIR_LEFT)) return cur; return d; }队列长度给 3 就够再多也没意义——人的手指快不过逻辑帧。Dir_Push里那个和上一个待处理方向相同就丢弃的判断是为了防止长按导致队列塞满无效方向松开后蛇还继续拐好几次手感会非常怪。4. 核心逻辑拆解蛇身队列、食物生成与碰撞检测游戏逻辑部分代码量不大但每一处都藏着选择。用链表还是数组、碰撞检测遍历还是查表、食物怎么随机才不刷进蛇身里这些决定直接影响后期改玩法时的难度。这一层的设计原则是数据结构尽量扁平别引入动态内存F407 的 RAM 虽然有 192KB但游戏机这种东西跑十年不该有一丝内存碎片。4.1 用环形数组表示蛇身蛇的移动本质是头进尾出除了吃到食物那一步长度不变。这种特性用环形数组最合适头指针加一、尾指针加一长度不变吃到食物时只动头指针尾指针不动长度加一。#define GRID_W 20 /* 横向 20 格 */ #define GRID_H 15 /* 纵向 15 格 */ #define CELL_PX 16 /* 每格 16 像素画面上留边 */ #define MAX_SNAKE (GRID_W * GRID_H) typedef struct { int8_t x[MAX_SNAKE]; int8_t y[MAX_SNAKE]; uint16_t head; /* 头指针指向蛇头所在下标 */ uint16_t tail; /* 尾指针指向蛇尾所在下标 */ uint16_t len; int8_t dir; /* 当前方向 */ } Snake_t; /* 前进一步dir 已由 Dir_Pop 给出合法方向 */ int Snake_Move(Snake_t *s, int8_t dir, int8_t fx, int8_t fy, uint8_t ate) { int8_t nx s-x[s-head] DX(dir); int8_t ny s-y[s-head] DY(dir); /* 撞墙判定 */ if (nx 0 || nx GRID_W || ny 0 || ny GRID_H) return -1; /* 撞自身吃食物时不判尾巴尾巴这一帧不动 */ uint16_t end ate ? s-len : s-len - 1; for (uint16_t i 0; i end; i) { uint16_t idx (s-tail i) % MAX_SNAKE; if (s-x[idx] nx s-y[idx] ny) return -1; } s-head (s-head 1) % MAX_SNAKE; s-x[s-head] nx; s-y[s-head] ny; if (!ate) { s-tail (s-tail 1) % MAX_SNAKE; /* 尾进头出长度不变 */ } else { s-len; } s-dir dir; return ate ? 1 : 0; }MAX_SNAKE取格点总数蛇最长也就是铺满整屏不会溢出。ate参数很关键吃食物那一步尾巴不动如果还按尾巴那一格可以走来判定会出现蛇头咬到自己尾巴尖却判定通过的情况视觉上很别扭。返回值 -1 表示撞了0 表示正常走一步1 表示吃到食物调用方根据返回值处理音效和分数。长度到几百之后每次移动都遍历一遍蛇身是 O(n)在 168MHz 上完全无压力。如果想把玩法扩展到更大的棋盘可以再维护一张uint8_t grid[GRID_H][GRID_W]位图蛇头蛇尾移动时同步更新碰撞检测变成 O(1)。4.2 食物生成别让食物刷进蛇肚子里最简单的食物生成是随机取坐标是蛇身就重试。短蛇时没问题蛇长了之后重试次数暴涨极端情况下能卡住几十毫秒表现为画面一顿。稳妥做法是先扫一遍所有空格收进数组再随机取一个下标。static uint16_t empty_idx[GRID_W * GRID_H]; void Food_Spawn(Snake_t *s, int8_t *fx, int8_t *fy) { uint16_t cnt 0; for (int8_t y 0; y GRID_H; y) { for (int8_t x 0; x GRID_W; x) { uint8_t occupied 0; for (uint16_t i 0; i s-len; i) { uint16_t idx (s-tail i) % MAX_SNAKE; if (s-x[idx] x s-y[idx] y) { occupied 1; break; } } if (!occupied) empty_idx[cnt] y * GRID_W x; } } if (cnt 0) { *fx -1; return; } /* 满屏通关 */ uint32_t r Rand_Next() % cnt; /* 均匀取一个空格 */ *fx empty_idx[r] % GRID_W; *fy empty_idx[r] / GRID_W; }随机数源有两种选择。F407 自带硬件 RNG 外设开时钟后读RNG-DR就行质量好如果没有启用 RNG用 SysTick 计数值加一个自增种子做线性同余也能用但要注意别用固定的初始种子否则每次开机食物位置完全一样玩家两把就摸清了规律。这份工程里两种都留了接口工程里通过宏切换。4.3 局部刷新只重绘变化的三格贪吃蛇每走一步画面真正变化的只有三处新的蛇头、旧的蛇尾、可能出现的食物。全屏刷新是最省事的写法但 320×240 全刷一次大约十几毫秒速度等级调高之后会明显掉帧。局部刷新把每次重绘压缩到三个 16×16 的方块耗时降到全屏的百分之一。/* 画一格擦除用背景色画蛇用前景色 */ static void Draw_Cell(int8_t gx, int8_t gy, uint16_t color) { uint16_t px BOARD_X gx * CELL_PX; uint16_t py BOARD_Y gy * CELL_PX; LCD_SetWindow(px, py, px CELL_PX - 1, py CELL_PX - 1); for (uint16_t i 0; i CELL_PX * CELL_PX; i) LCD_WriteData(color); } void Render_Flush(void) { /* 1. 擦掉上一帧的尾巴 */ if (last_tail_valid) Draw_Cell(last_tail_x, last_tail_y, COLOR_BG); /* 2. 画新蛇头顺便给个圆角效果就多画两笔 */ Draw_Cell(snake.x[snake.head], snake.y[snake.head], COLOR_HEAD); /* 3. 头部变回普通身体色上一帧的头 */ if (prev_head_valid) Draw_Cell(prev_head_x, prev_head_y, COLOR_BODY); /* 4. 食物只在刚生成时画一次 */ if (food_fresh) { Draw_Cell(food_x, food_y, COLOR_FOOD); food_fresh 0; } }这里的顺序有讲究先擦尾巴再画头中间不能有任何一次全屏清屏否则屏幕上会出现一闪。BOARD_X、BOARD_Y是棋盘左上角的屏幕坐标留出顶部分数栏和底部提示区。COLOR_HEAD和COLOR_BODY区分开蛇头一眼能认出来这个小细节对手感提升意外地大。4.4 分数与最高分的掉电保存分数在 RAM 里存着没问题最高分要跨掉电保留。F407 有两条路内部 Flash 的一个扇区或者备份寄存器/BKPSRAM。备份寄存器只有几十字节存个uint16_t最高分绰绰有余而且不用擦除写一次就完事内部 Flash 容量大但擦除一个扇区要一两秒而且必须整扇区擦写之前还得先擦。/* 方案一RTC 备份寄存器简单可靠需要 VBAT 或主电不断 */ #define BEST_REG RTC-BKP0R uint16_t Best_Load(void) { uint16_t v (uint16_t)(BEST_REG 0xFFFF); return (v 0xFFFF) ? 0 : v; /* 首次上电是 0xFFFF归零 */ } void Best_Save(uint16_t score) { HAL_PWR_EnableBkUpAccess(); /* 备份域默认写保护必须先开 */ BEST_REG score; } /* 方案二内部 Flash 末扇区适合没有电池的场景 注意擦除会阻塞 1~2 秒只在游戏结束时写且要关中断 */HAL_PWR_EnableBkUpAccess()这一句漏掉的话写备份寄存器完全不生效而且不报错——现象就是最高分永远存不住查半天以为是掉电太快。这是很典型的一个坑第一次遇到能折腾一下午。5. 避坑与排查花屏、串键、蛇穿墙这几类问题这份工程在调试阶段踩过的坑基本集中在三块显示、输入、逻辑。每一块的现象都很有迷惑性比如花屏未必是屏幕坏了蛇穿墙未必是碰撞检测写错了。下面按现象 → 原因 → 解决把高频问题过一遍照着对照能省不少时间。5.1 显示层花屏、残影与清屏慢现象一上电后屏幕一片雪花点偶尔能看出一点图像轮廓。原因通常是 FSMC 的DataSetupTime设得太小或者数据线有一根虚焊。并口 16 根线只要有一根接触不良颜色通道就会整体偏移看起来就是花的。解决顺序是先把DataSetupTime从 8 调到 15看是否改善还没好就写一个测试函数往显存里循环写 0xFFFF 和 0x0000用万用表量每根数据线对地电压异常的补焊。现象二蛇移动时身后拖一条残影尾巴擦不干净。原因是擦尾巴和画新头用了不同的坐标基准或者窗口设置少算了一个像素。LCD_SetWindow(px, py, px CELL_PX - 1, py CELL_PX - 1)的结束坐标是闭区间少减这个 1 就会多刷一格反过来坐标偏移一格残影就留在原地。排查时可以先固定画一个纯色方块看它落在网格的哪个位置对上了再改整体逻辑。现象三菜单切到游戏时明显卡一下像死机了半秒。这是全屏清屏导致的。320×240×2 字节写下去即使并口也要几毫秒到十几毫秒如果清屏函数里还套了逐点判断颜色的逻辑会更慢。解决是把背景色填充改成连续写同一个值中间不做任何分支判断一次窗口设置到底。5.2 输入层按键抖动、方向丢失与反向自杀现象一按一下方向键蛇连拐两次或者明明按了没反应。前者是防抖没做干净后者是扫描周期太长。独立按键的机械抖动一般 5~20ms20ms 采样周期加状态机足够如果主循环里某处有阻塞比如擦 Flash按键就会整段丢失。解决是扫描放主循环最前面任何耗时操作之后强制扫一次。现象二急转弯时蛇莫名其妙撞死回放看是原地掉头。这就是第 3 章那个方向队列存在的意义。玩家在一帧内按了上和左如果两个方向都被立刻采纳蛇就会从上直接拐到左而上一帧它是向右的等于掉头。加了Dir_Pop里的反向过滤之后这类死亡基本消失。现象三暂停后再继续蛇会往暂停前的反方向冲一下。原因是暂停期间方向队列还在被填充恢复时一次性弹出。解决很简单进入暂停状态时清空队列恢复时重新从当前方向开始。5.3 逻辑层食物刷进蛇身、加速失控与满屏死循环现象一食物偶尔出现在蛇身体中间吃不到也消不掉。典型的随机重试漏洞——重试次数有上限达到上限还没找到空格就随便给了个坐标。换成 4.2 节那种先收集空格再随机取的写法这个问题从根上消失。现象二速度等级拉到最高之后蛇像瞬移按键完全跟不上。step_ms设到了 40ms 以下而局部刷新加按键扫描一轮就要几毫秒加上人眼反应时间体验直接崩。速度下限建议卡在 80ms再快就不是难度问题了。解决是在速度升级函数里加一个下限钳位。现象三蛇长到接近满屏时游戏卡死不动。多数是食物生成里的双重循环在蛇很长时退化加上满屏判定缺失导致除零或者死循环。在Food_Spawn里加if (cnt 0)的满屏通关分支问题解决顺便白得一个通关结局。6. 二次开发换玩法、换屏幕、加音效的改造路径这份工程的骨架是状态机 固定节拍 局部渲染这套骨架不只能跑贪吃蛇。把Game_Step换掉状态机的调度、按键队列、渲染接口都能直接复用改成俄罗斯方块或者推箱子工作量主要在新玩法本身而不是外围框架。6.1 骨架复用从贪吃蛇到方块类玩法关键是把逻辑层和渲染层的接口定清楚。现在工程里渲染层对外只暴露三个函数Draw_Cell画单格、Render_Flush增量刷新、Render_All整屏重绘。换玩法时只要新的数据结构能映射到格子 颜色渲染层一行不用改。改造点贪吃蛇俄罗斯方块需要动的文件数据结构环形数组蛇身7×7 方块矩阵 10×20 场地game_logic.c节拍来源固定 step_ms下落间隔随等级变化game.c的调度段碰撞检测边界 蛇身遍历场地位图与方块矩阵与运算collision.c输入语义四方向左右移动 旋转 硬降input_map.h改造顺序建议自下而上先定数据结构再写碰撞再写渲染映射最后接状态机。反着来会陷入界面画出来了但逻辑对不上的反复返工。我一般会在改之前先把新玩法的核心状态用 PC 上的小程序验证一遍逻辑对了再往板子上搬能省掉大量烧录等待。6.2 换屏幕与加音效时的兼容处理换屏是最常见的二次开发需求。如果新屏还是 FSMC 并口、只是驱动 IC 不同那只需要重写初始化寄存器序列和LCD_SetWindow里的命令字其余全不动如果换成 SPI 屏就要把LCD_WriteData换成 SPI 发送并重新评估刷新耗时——原来按局部刷新几毫秒设计的节拍可能要放宽。这里有个检查习惯换屏后先跑一个全屏色块测试红绿蓝白黑依次刷一遍确认没有偏色和错位再跑游戏。音效部分无源蜂鸣器要用 PWM 出不同频率有源蜂鸣器只需给高低电平。工程里把音效封装成Buz_Beep(freq, ms)内部用定时器输出指定频率、用一个软件计数控制时长调用方不关心底层。加音效最容易出的问题是阻塞——HAL_Delay放在主循环里等音效播完蛇就卡住了。做法是只启动定时器就返回时长到了在中断里关掉。6.3 改完之后怎么验证没把节拍搞坏改动越大越要有一个快速自检流程。我的习惯是每次改完跑三步第一步用串口打印每 100 步的实际耗时和step_ms对一下偏差超过 10% 说明主循环里有阻塞第二步把速度等级拉到最高跑五分钟看会不会掉帧或者按键丢失第三步反复进出菜单和暂停十次确认状态机没有残留状态。/* 节拍自检每 100 步打印一次平均步进耗时单位 ms */ static uint32_t t_last, steps; void Tick_Probe(void) { if (steps % 100 0) { uint32_t now HAL_GetTick(); printf(avg step %lu ms, target %u ms\r\n, (now - t_last) / 100, game.step_ms); t_last now; } }这段探针代码平时可以一直留着用宏关掉输出就行。有一回我把局部刷新改成每帧全刷功能看着正常探针一打印平均步进 180ms目标 120ms才知道渲染拖了后腿——肉眼还真不一定看得出来。从那以后我每次动渲染或者动节拍相关的代码都强制走一遍这个三步自检宁可多花十分钟也别在演示的时候翻车。希望帮到你。本文还有配套的精品资源点击获取
简介这份STM32F407贪吃蛇游戏程序面向嵌入式初学者与课程设计开发者以经典贪吃蛇为载体帮助读者在Cortex-M4平台上理解GPIO驱动显示、定时器中断控制帧率、按键中断响应、数组状态管理与碰撞检测等核心机制。工程共含159个文件以77个.h头文件和75个.c源文件为主体搭配启动汇编文件、Keil工程与hex可执行文件以及批处理和说明页面等辅助内容压缩包约831KB结构接近完整MDK工程便于直接编译、烧录和二次修改。已有2820人学习说明该案例在STM32入门与项目实践中有较高参考价值。读者可据此梳理外设库组织方式、游戏主循环与中断服务例程的协作关系并借助可运行固件快速验证显示与输入逻辑适合用作嵌入式课程实验、毕业设计原型或自学练手项目。1. 一块吃灰的F407开发板被我改成了能连玩的贪吃蛇某实验室的柜子里躺着一块STM32F407开发板板载3.2寸并口TFT、四个独立按键、一个蜂鸣器。学完GPIO点灯和串口打印之后很多人就把它放回去了因为找不到一个规模刚好的练手项目。这个STM32F407贪吃蛇程序干的就是这件事把一块开发板变成一个能开机、能计分、能掉电保存最高分的小游戏机。它不适合当产品但适合当一次完整工程演练——屏幕驱动、定时器节拍、状态机、输入防抖、Flash存储一条链上全是真实开发里躲不开的东西。想从会点灯跨到能跑起一个小系统的开发者从它入手比啃例程库划算得多。2. 硬件底子与工程骨架从时钟树到屏幕点亮的第一层落地拿到这份工程第一件事不是看游戏逻辑而是看它怎么把一块裸板变成有显示、有时间基准的运行环境。游戏逻辑再花哨时钟配错、屏幕不亮、节拍不准后面全是白搭。这一层也是新手最容易翻车的地方——引脚表看错一个、FSMC 时序差一个周期现象就是花屏或者干脆白屏排查起来像黑匣子。2.1 板级资源盘点与引脚分配整份工程围绕三类外设展开显示、输入、计时。显示用 FSMC 并口驱动 3.2 寸 TFT常见驱动芯片为 ILI9341 一类320×240 分辨率RGB565 色深输入是四个独立按键计时靠一个基本定时器产生毫秒节拍。蜂鸣器负责吃食物和撞墙的音效串口只在调试阶段打印状态正式运行时关掉。我一般会先把引脚占用整理成一张表贴在工程目录的 README 里改板子的时候照着改比翻代码快功能外设/信号典型引脚备注LCD 数据线FSMC_D0~D15PD14/PD15/PD0/PD1 等16 位并口一次写半个字LCD 片选FSMC_NE1PD7Bank1 子区 1LCD 命令/数据选择FSMC_A16PD11高电平写数据、低电平写命令LCD 写使能FSMC_NWEPD5由 FSMC 自动产生LCD 背光TIM4_CH3PB8PWM 调亮度省电也护眼按键 上/下/左/右GPIO 输入PE0~PE3内部上拉按下为低蜂鸣器TIM12_CH1PB14有源蜂鸣器直接给电平即可调试串口USART1PA9/PA10115200-8-N-1选并口屏而不是 SPI 屏理由很实际320×240 的 RGB565 整屏是 153600 字节SPI 跑 42MHz 理论也要 30ms 左右实际还要翻倍FSMC 16 位并口一次写一个半字整屏刷新的时间差一个数量级。贪吃蛇大部分时间是局部刷新SPI 其实也够用但菜单切换、清屏、游戏结束全屏重绘那几下体验差别非常明显。2.2 时钟树配置168MHz 的地基怎么打F407 的标准配置是 HSE 8MHz 晶振经 PLL 倍频到 168MHzAHB 168MHzAPB1 42MHzAPB2 84MHz。这里有个容易忽略的点APB1 预分频不为 1 时挂在 APB1 上的定时器时钟会再乘 2所以 TIM6 实际拿到的是 84MHz不是 42MHz。分频算错游戏节拍就会整体慢一倍蛇爬得像蜗牛。void SystemClock_Config(void) { RCC_OscInitTypeDef osc {0}; RCC_ClkInitTypeDef clk {0}; __HAL_RCC_PWR_CLK_ENABLE(); /* 168MHz 必须开 Scale1 电压档否则高频下不稳定 */ __HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE1); osc.OscillatorType RCC_OSCILLATORTYPE_HSE; osc.HSEState RCC_HSE_ON; osc.PLL.PLLState RCC_PLL_ON; osc.PLL.PLLSource RCC_PLLSOURCE_HSE; osc.PLL.PLLM 8; /* 8MHz / 8 1MHz 鉴相输入 */ osc.PLL.PLLN 336; /* 1MHz * 336 336MHz VCO */ osc.PLL.PLLP RCC_PLLP_DIV2; /* 336 / 2 168MHz 系统时钟 */ osc.PLL.PLLQ 7; /* 48MHzUSB/SDIO 用得上 */ HAL_RCC_OscConfig(osc); clk.ClockType RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK | RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2; clk.SYSCLKSource RCC_SYSCLKSOURCE_PLLCLK; clk.AHBCLKDivider RCC_SYSCLK_DIV1; /* HCLK 168MHz */ clk.APB1CLKDivider RCC_HCLK_DIV4; /* PCLK1 42MHz定时器 84MHz */ clk.APB2CLKDivider RCC_HCLK_DIV2; /* PCLK2 84MHz */ HAL_RCC_ClockConfig(clk, FLASH_LATENCY_5); /* 168MHz 需 5 个等待周期 */ }PLLM/PLLN/PLLP 三个参数是联动的改任何一个都要重新核对最终频率别只改 N。FLASH_LATENCY_5也不能省168MHz 下 Flash 读速度跟不上等待周期少了会随机死机而且这种死机很玄学——跑着跑着卡住复位又好了查起来极其难受。2.3 FSMC 并口屏初始化让第一帧图像亮起来屏幕点亮分三步FSMC 控制器初始化、面板寄存器序列下发、读 ID 校验。读 ID 这一步别省它是判断接线对不对、时序对不对最直接的证据——ID 读出来是 0x0000 或者 0xFFFF基本就是数据线虚焊或者片选错了。/* NE1 基址 0x60000000RS 接 A16所以数据口地址偏移 0x20000 */ #define LCD_BASE ((uint32_t)0x60000000) #define LCD_REG (*(volatile uint16_t *)(LCD_BASE)) #define LCD_RAM (*(volatile uint16_t *)(LCD_BASE 0x00020000)) static void LCD_FSMC_Init(void) { FSMC_NORSRAM_TimingTypeDef t {0}; hfsmc.Instance FSMC_NORSRAM_DEVICE; /* 16 位数据宽度、NORSRAM 模式、写使能B 模式异步访问 */ t.AddressSetupTime 5; /* 地址建立 5 个 HCLK */ t.AddressHoldTime 0; t.DataSetupTime 8; /* 数据建立 8 个 HCLK太快会花屏 */ t.BusTurnAroundDuration 0; t.CLKDivision 0; t.DataLatency 0; t.AccessMode FSMC_ACCESS_MODE_B; HAL_SRAM_Init(hsram, timing, t); GPIO_InitTypeDef g {0}; g.Pin GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_7 | GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_14 | GPIO_PIN_15; g.Mode GPIO_MODE_AF_PP; g.Pull GPIO_NOPULL; g.Speed GPIO_SPEED_FREQ_VERY_HIGH; g.Alternate GPIO_AF12_FSMC; HAL_GPIO_Init(GPIOD, g); } /* 写命令/写数据靠地址线 A16 区分不用手动拉 IO */ static inline void LCD_WriteCmd(uint16_t cmd) { LCD_REG cmd; } static inline void LCD_WriteData(uint16_t d) { LCD_RAM d; } /* 设置矩形窗口局部刷新全靠它 */ void LCD_SetWindow(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1) { LCD_WriteCmd(0x2A); /* 列地址设置 */ LCD_WriteData(x0 8); LCD_WriteData(x0 0xFF); LCD_WriteData(x1 8); LCD_WriteData(x1 0xFF); LCD_WriteCmd(0x2B); /* 行地址设置 */ LCD_WriteData(y0 8); LCD_WriteData(y0 0xFF); LCD_WriteData(y1 8); LCD_WriteData(y1 0xFF); LCD_WriteCmd(0x2C); /* 进入写显存模式 */ }DataSetupTime是这里最需要试的参数手册给的典型值是 8~15 个 HCLK设太小屏幕会出现雪花点或者整行错位设太大刷新变慢。板子上延长排线的话建议直接拉到 15宁可慢一点也别花屏。LCD_SetWindow是后面所有局部刷新的基础每次只刷一个格子比如 12×12 像素时窗口设成这一格的范围然后连续写 144 个像素值比全屏刷新快得多。3. 游戏状态机与主循环一个 tick 怎么串起按键、蛇身和屏幕工程跑起来之后最值得看的是主循环的组织方式。很多学生写的贪吃蛇是在定时器中断里直接刷屏、直接处理按键跑起来能动但一改速度或者一加音效就开始卡顿。这份工程把时间推进和渲染拆开中断只负责计一个数剩下的都在主循环里按状态分发改起来心里有底。3.1 四态状态机与它的流转游戏一共四个状态菜单、运行中、暂停、结束。状态机不是什么高深设计它的价值在于把哪个状态下该响应什么按键写死避免出现暂停时蛇还在动、结束后还能转向这类交互 bug。typedef enum { ST_MENU 0, /* 开机菜单等待开始键 */ ST_RUNNING, /* 运行中接受方向输入按节拍前进 */ ST_PAUSED, /* 暂停画面冻结只响应继续/返回 */ ST_OVER /* 结束显示分数等待重开 */ } GameState_e; typedef struct { GameState_e state; uint32_t ms_tick; /* 由定时器中断累加单位 ms */ uint16_t step_ms; /* 当前速度等级对应的步进间隔 */ uint16_t score; uint16_t best; uint8_t dirty; /* 有画面变化时置 1主循环据此刷新 */ } GameCtx_t; static GameCtx_t game { .state ST_MENU, .step_ms 220 };ms_tick在中断里自增主循环拿它和step_ms比较够了就执行一步逻辑并清零。这种软件分频的好处是速度可以随时改改step_ms就行不用动定时器寄存器。3.2 定时器中断与主循环的分工我一般用一个基本定时器TIM6 或 TIM7没有 IO 占用产生 1ms 节拍中断服务函数里只做一件事void TIM6_IRQHandler(void) { if (__HAL_TIM_GET_FLAG(htim6, TIM_FLAG_UPDATE)) { __HAL_TIM_CLEAR_FLAG(htim6, TIM_FLAG_UPDATE); game.ms_tick; /* 只累加绝不在这里刷屏 */ } } void Game_Loop(void) { for (;;) { Input_Poll(); /* 按键扫描防抖 */ Key_Dispatch(); /* 按状态分发按键 */ if (game.ms_tick game.step_ms) { game.ms_tick 0; if (game.state ST_RUNNING) { Game_Step(); /* 蛇前进一格 */ game.dirty 1; } } if (game.dirty) { Render_Flush(); /* 只重绘变化的部分 */ game.dirty 0; } } }中断里坚决不刷屏原因很直接一次全屏刷新是毫秒级的放进 1ms 中断里会把中断撑爆其他中断全被推迟按键响应立刻变迟钝严重时看门狗都会咬。Input_Poll每轮都跑不受游戏节拍限制这样即使蛇走得很慢按键也不会丢。3.3 按键扫描与方向缓冲区按键用 20ms 的状态机防抖连续采样到稳定电平才认一次按下并且记录上一次状态只在上升沿从松开到按下产生事件。方向输入不能直接赋值给下一方向因为一帧之内可能连按两次——比如蛇向右走玩家快速按下上再按左如果直接覆盖下一帧蛇就往左走了等于原地掉头撞自己。#define DIR_QUEUE_LEN 3 static int8_t dir_queue[DIR_QUEUE_LEN]; static uint8_t dir_head, dir_tail, dir_count; /* 入队只在队列不满时接受重复方向直接丢弃 */ void Dir_Push(int8_t d) { if (dir_count 0 dir_queue[(dir_head DIR_QUEUE_LEN - 1) % DIR_QUEUE_LEN] d) return; /* 和上一个待处理方向相同不重复入队 */ if (dir_count DIR_QUEUE_LEN) return; dir_queue[dir_head] d; dir_head (dir_head 1) % DIR_QUEUE_LEN; dir_count; } /* 出队每次逻辑步进只取一个方向 */ int8_t Dir_Pop(int8_t cur) { if (dir_count 0) return cur; int8_t d dir_queue[dir_tail]; dir_tail (dir_tail 1) % DIR_QUEUE_LEN; dir_count--; /* 反向输入直接忽略这是防自杀最后一道闸 */ if ((d DIR_UP cur DIR_DOWN) || (d DIR_DOWN cur DIR_UP) || (d DIR_LEFT cur DIR_RIGHT) || (d DIR_RIGHT cur DIR_LEFT)) return cur; return d; }队列长度给 3 就够再多也没意义——人的手指快不过逻辑帧。Dir_Push里那个和上一个待处理方向相同就丢弃的判断是为了防止长按导致队列塞满无效方向松开后蛇还继续拐好几次手感会非常怪。4. 核心逻辑拆解蛇身队列、食物生成与碰撞检测游戏逻辑部分代码量不大但每一处都藏着选择。用链表还是数组、碰撞检测遍历还是查表、食物怎么随机才不刷进蛇身里这些决定直接影响后期改玩法时的难度。这一层的设计原则是数据结构尽量扁平别引入动态内存F407 的 RAM 虽然有 192KB但游戏机这种东西跑十年不该有一丝内存碎片。4.1 用环形数组表示蛇身蛇的移动本质是头进尾出除了吃到食物那一步长度不变。这种特性用环形数组最合适头指针加一、尾指针加一长度不变吃到食物时只动头指针尾指针不动长度加一。#define GRID_W 20 /* 横向 20 格 */ #define GRID_H 15 /* 纵向 15 格 */ #define CELL_PX 16 /* 每格 16 像素画面上留边 */ #define MAX_SNAKE (GRID_W * GRID_H) typedef struct { int8_t x[MAX_SNAKE]; int8_t y[MAX_SNAKE]; uint16_t head; /* 头指针指向蛇头所在下标 */ uint16_t tail; /* 尾指针指向蛇尾所在下标 */ uint16_t len; int8_t dir; /* 当前方向 */ } Snake_t; /* 前进一步dir 已由 Dir_Pop 给出合法方向 */ int Snake_Move(Snake_t *s, int8_t dir, int8_t fx, int8_t fy, uint8_t ate) { int8_t nx s-x[s-head] DX(dir); int8_t ny s-y[s-head] DY(dir); /* 撞墙判定 */ if (nx 0 || nx GRID_W || ny 0 || ny GRID_H) return -1; /* 撞自身吃食物时不判尾巴尾巴这一帧不动 */ uint16_t end ate ? s-len : s-len - 1; for (uint16_t i 0; i end; i) { uint16_t idx (s-tail i) % MAX_SNAKE; if (s-x[idx] nx s-y[idx] ny) return -1; } s-head (s-head 1) % MAX_SNAKE; s-x[s-head] nx; s-y[s-head] ny; if (!ate) { s-tail (s-tail 1) % MAX_SNAKE; /* 尾进头出长度不变 */ } else { s-len; } s-dir dir; return ate ? 1 : 0; }MAX_SNAKE取格点总数蛇最长也就是铺满整屏不会溢出。ate参数很关键吃食物那一步尾巴不动如果还按尾巴那一格可以走来判定会出现蛇头咬到自己尾巴尖却判定通过的情况视觉上很别扭。返回值 -1 表示撞了0 表示正常走一步1 表示吃到食物调用方根据返回值处理音效和分数。长度到几百之后每次移动都遍历一遍蛇身是 O(n)在 168MHz 上完全无压力。如果想把玩法扩展到更大的棋盘可以再维护一张uint8_t grid[GRID_H][GRID_W]位图蛇头蛇尾移动时同步更新碰撞检测变成 O(1)。4.2 食物生成别让食物刷进蛇肚子里最简单的食物生成是随机取坐标是蛇身就重试。短蛇时没问题蛇长了之后重试次数暴涨极端情况下能卡住几十毫秒表现为画面一顿。稳妥做法是先扫一遍所有空格收进数组再随机取一个下标。static uint16_t empty_idx[GRID_W * GRID_H]; void Food_Spawn(Snake_t *s, int8_t *fx, int8_t *fy) { uint16_t cnt 0; for (int8_t y 0; y GRID_H; y) { for (int8_t x 0; x GRID_W; x) { uint8_t occupied 0; for (uint16_t i 0; i s-len; i) { uint16_t idx (s-tail i) % MAX_SNAKE; if (s-x[idx] x s-y[idx] y) { occupied 1; break; } } if (!occupied) empty_idx[cnt] y * GRID_W x; } } if (cnt 0) { *fx -1; return; } /* 满屏通关 */ uint32_t r Rand_Next() % cnt; /* 均匀取一个空格 */ *fx empty_idx[r] % GRID_W; *fy empty_idx[r] / GRID_W; }随机数源有两种选择。F407 自带硬件 RNG 外设开时钟后读RNG-DR就行质量好如果没有启用 RNG用 SysTick 计数值加一个自增种子做线性同余也能用但要注意别用固定的初始种子否则每次开机食物位置完全一样玩家两把就摸清了规律。这份工程里两种都留了接口工程里通过宏切换。4.3 局部刷新只重绘变化的三格贪吃蛇每走一步画面真正变化的只有三处新的蛇头、旧的蛇尾、可能出现的食物。全屏刷新是最省事的写法但 320×240 全刷一次大约十几毫秒速度等级调高之后会明显掉帧。局部刷新把每次重绘压缩到三个 16×16 的方块耗时降到全屏的百分之一。/* 画一格擦除用背景色画蛇用前景色 */ static void Draw_Cell(int8_t gx, int8_t gy, uint16_t color) { uint16_t px BOARD_X gx * CELL_PX; uint16_t py BOARD_Y gy * CELL_PX; LCD_SetWindow(px, py, px CELL_PX - 1, py CELL_PX - 1); for (uint16_t i 0; i CELL_PX * CELL_PX; i) LCD_WriteData(color); } void Render_Flush(void) { /* 1. 擦掉上一帧的尾巴 */ if (last_tail_valid) Draw_Cell(last_tail_x, last_tail_y, COLOR_BG); /* 2. 画新蛇头顺便给个圆角效果就多画两笔 */ Draw_Cell(snake.x[snake.head], snake.y[snake.head], COLOR_HEAD); /* 3. 头部变回普通身体色上一帧的头 */ if (prev_head_valid) Draw_Cell(prev_head_x, prev_head_y, COLOR_BODY); /* 4. 食物只在刚生成时画一次 */ if (food_fresh) { Draw_Cell(food_x, food_y, COLOR_FOOD); food_fresh 0; } }这里的顺序有讲究先擦尾巴再画头中间不能有任何一次全屏清屏否则屏幕上会出现一闪。BOARD_X、BOARD_Y是棋盘左上角的屏幕坐标留出顶部分数栏和底部提示区。COLOR_HEAD和COLOR_BODY区分开蛇头一眼能认出来这个小细节对手感提升意外地大。4.4 分数与最高分的掉电保存分数在 RAM 里存着没问题最高分要跨掉电保留。F407 有两条路内部 Flash 的一个扇区或者备份寄存器/BKPSRAM。备份寄存器只有几十字节存个uint16_t最高分绰绰有余而且不用擦除写一次就完事内部 Flash 容量大但擦除一个扇区要一两秒而且必须整扇区擦写之前还得先擦。/* 方案一RTC 备份寄存器简单可靠需要 VBAT 或主电不断 */ #define BEST_REG RTC-BKP0R uint16_t Best_Load(void) { uint16_t v (uint16_t)(BEST_REG 0xFFFF); return (v 0xFFFF) ? 0 : v; /* 首次上电是 0xFFFF归零 */ } void Best_Save(uint16_t score) { HAL_PWR_EnableBkUpAccess(); /* 备份域默认写保护必须先开 */ BEST_REG score; } /* 方案二内部 Flash 末扇区适合没有电池的场景 注意擦除会阻塞 1~2 秒只在游戏结束时写且要关中断 */HAL_PWR_EnableBkUpAccess()这一句漏掉的话写备份寄存器完全不生效而且不报错——现象就是最高分永远存不住查半天以为是掉电太快。这是很典型的一个坑第一次遇到能折腾一下午。5. 避坑与排查花屏、串键、蛇穿墙这几类问题这份工程在调试阶段踩过的坑基本集中在三块显示、输入、逻辑。每一块的现象都很有迷惑性比如花屏未必是屏幕坏了蛇穿墙未必是碰撞检测写错了。下面按现象 → 原因 → 解决把高频问题过一遍照着对照能省不少时间。5.1 显示层花屏、残影与清屏慢现象一上电后屏幕一片雪花点偶尔能看出一点图像轮廓。原因通常是 FSMC 的DataSetupTime设得太小或者数据线有一根虚焊。并口 16 根线只要有一根接触不良颜色通道就会整体偏移看起来就是花的。解决顺序是先把DataSetupTime从 8 调到 15看是否改善还没好就写一个测试函数往显存里循环写 0xFFFF 和 0x0000用万用表量每根数据线对地电压异常的补焊。现象二蛇移动时身后拖一条残影尾巴擦不干净。原因是擦尾巴和画新头用了不同的坐标基准或者窗口设置少算了一个像素。LCD_SetWindow(px, py, px CELL_PX - 1, py CELL_PX - 1)的结束坐标是闭区间少减这个 1 就会多刷一格反过来坐标偏移一格残影就留在原地。排查时可以先固定画一个纯色方块看它落在网格的哪个位置对上了再改整体逻辑。现象三菜单切到游戏时明显卡一下像死机了半秒。这是全屏清屏导致的。320×240×2 字节写下去即使并口也要几毫秒到十几毫秒如果清屏函数里还套了逐点判断颜色的逻辑会更慢。解决是把背景色填充改成连续写同一个值中间不做任何分支判断一次窗口设置到底。5.2 输入层按键抖动、方向丢失与反向自杀现象一按一下方向键蛇连拐两次或者明明按了没反应。前者是防抖没做干净后者是扫描周期太长。独立按键的机械抖动一般 5~20ms20ms 采样周期加状态机足够如果主循环里某处有阻塞比如擦 Flash按键就会整段丢失。解决是扫描放主循环最前面任何耗时操作之后强制扫一次。现象二急转弯时蛇莫名其妙撞死回放看是原地掉头。这就是第 3 章那个方向队列存在的意义。玩家在一帧内按了上和左如果两个方向都被立刻采纳蛇就会从上直接拐到左而上一帧它是向右的等于掉头。加了Dir_Pop里的反向过滤之后这类死亡基本消失。现象三暂停后再继续蛇会往暂停前的反方向冲一下。原因是暂停期间方向队列还在被填充恢复时一次性弹出。解决很简单进入暂停状态时清空队列恢复时重新从当前方向开始。5.3 逻辑层食物刷进蛇身、加速失控与满屏死循环现象一食物偶尔出现在蛇身体中间吃不到也消不掉。典型的随机重试漏洞——重试次数有上限达到上限还没找到空格就随便给了个坐标。换成 4.2 节那种先收集空格再随机取的写法这个问题从根上消失。现象二速度等级拉到最高之后蛇像瞬移按键完全跟不上。step_ms设到了 40ms 以下而局部刷新加按键扫描一轮就要几毫秒加上人眼反应时间体验直接崩。速度下限建议卡在 80ms再快就不是难度问题了。解决是在速度升级函数里加一个下限钳位。现象三蛇长到接近满屏时游戏卡死不动。多数是食物生成里的双重循环在蛇很长时退化加上满屏判定缺失导致除零或者死循环。在Food_Spawn里加if (cnt 0)的满屏通关分支问题解决顺便白得一个通关结局。6. 二次开发换玩法、换屏幕、加音效的改造路径这份工程的骨架是状态机 固定节拍 局部渲染这套骨架不只能跑贪吃蛇。把Game_Step换掉状态机的调度、按键队列、渲染接口都能直接复用改成俄罗斯方块或者推箱子工作量主要在新玩法本身而不是外围框架。6.1 骨架复用从贪吃蛇到方块类玩法关键是把逻辑层和渲染层的接口定清楚。现在工程里渲染层对外只暴露三个函数Draw_Cell画单格、Render_Flush增量刷新、Render_All整屏重绘。换玩法时只要新的数据结构能映射到格子 颜色渲染层一行不用改。改造点贪吃蛇俄罗斯方块需要动的文件数据结构环形数组蛇身7×7 方块矩阵 10×20 场地game_logic.c节拍来源固定 step_ms下落间隔随等级变化game.c的调度段碰撞检测边界 蛇身遍历场地位图与方块矩阵与运算collision.c输入语义四方向左右移动 旋转 硬降input_map.h改造顺序建议自下而上先定数据结构再写碰撞再写渲染映射最后接状态机。反着来会陷入界面画出来了但逻辑对不上的反复返工。我一般会在改之前先把新玩法的核心状态用 PC 上的小程序验证一遍逻辑对了再往板子上搬能省掉大量烧录等待。6.2 换屏幕与加音效时的兼容处理换屏是最常见的二次开发需求。如果新屏还是 FSMC 并口、只是驱动 IC 不同那只需要重写初始化寄存器序列和LCD_SetWindow里的命令字其余全不动如果换成 SPI 屏就要把LCD_WriteData换成 SPI 发送并重新评估刷新耗时——原来按局部刷新几毫秒设计的节拍可能要放宽。这里有个检查习惯换屏后先跑一个全屏色块测试红绿蓝白黑依次刷一遍确认没有偏色和错位再跑游戏。音效部分无源蜂鸣器要用 PWM 出不同频率有源蜂鸣器只需给高低电平。工程里把音效封装成Buz_Beep(freq, ms)内部用定时器输出指定频率、用一个软件计数控制时长调用方不关心底层。加音效最容易出的问题是阻塞——HAL_Delay放在主循环里等音效播完蛇就卡住了。做法是只启动定时器就返回时长到了在中断里关掉。6.3 改完之后怎么验证没把节拍搞坏改动越大越要有一个快速自检流程。我的习惯是每次改完跑三步第一步用串口打印每 100 步的实际耗时和step_ms对一下偏差超过 10% 说明主循环里有阻塞第二步把速度等级拉到最高跑五分钟看会不会掉帧或者按键丢失第三步反复进出菜单和暂停十次确认状态机没有残留状态。/* 节拍自检每 100 步打印一次平均步进耗时单位 ms */ static uint32_t t_last, steps; void Tick_Probe(void) { if (steps % 100 0) { uint32_t now HAL_GetTick(); printf(avg step %lu ms, target %u ms\r\n, (now - t_last) / 100, game.step_ms); t_last now; } }这段探针代码平时可以一直留着用宏关掉输出就行。有一回我把局部刷新改成每帧全刷功能看着正常探针一打印平均步进 180ms目标 120ms才知道渲染拖了后腿——肉眼还真不一定看得出来。从那以后我每次动渲染或者动节拍相关的代码都强制走一遍这个三步自检宁可多花十分钟也别在演示的时候翻车。希望帮到你。本文还有配套的精品资源点击获取
