企业官网建设流程全解析

简介：本资源是一个基于STM32F103微控制器实现的嵌入式五子棋游戏项目，面向嵌入式初学者与STM32进阶开发者，聚焦人机交互、外设驱动与实时逻辑开发实践。项目完整支持触摸屏落子、SD卡存档、GUI界面显示及AI对弈基础逻辑，覆盖从硬件驱动（SPI/中断/定时器）到应用层算法（五连珠判定、棋盘状态管理）的全链路开发要点。压缩包含401个文件，主体为50个C源码、43个头文件、45个编译中间文件（.o/.d）、98个HTML文档（含工程说明与API参考），以及PNG图标、HEX/AXF可执行镜像和Keil工程配置文件（.uvprojx/.uvoptx），总大小7.64MB，结构清晰，便于逐模块学习调试。目前已有611人下载学习，提供开箱即用的完整工程环境、触摸与SD卡驱动例程、图形界面初始化代码及可验证的游戏逻辑框架，是掌握STM32嵌入式GUI开发与小型游戏系统设计的优质实操范例。

1. 在 STM32F103 最小系统上跑通五子棋，不是炫技，是验证人机交互闭环能力

你手头有一块 STM32F103C8T6 核心板（俗称“蓝 pill”），没外接 TFT 屏、没 SD 卡、甚至没 USB 转串口芯片——只靠 4×4 矩阵键盘 + 8 个 LED 指示灯 + 1 个蜂鸣器，就能下完一局完整五子棋。这不是玩具 Demo，而是嵌入式工程师检验「状态机设计」「资源约束下的算法裁剪」「硬件抽象层稳定性」的典型场景。它不依赖 HAL 库或 RTOS，用标准外设库 v3.50 就能编译通过；它不调用浮点运算，所有胜负判定在 128 字节 RAM 内完成；它把 15×15 棋盘压缩成两个 uint16_t 数组（黑子/白子各 15 行 × 15 列 → 每行用 16 位 bit 表示，高位补 0），真正跑在裸机环境里。适合刚学完 GPIO/EXTI/SysTick 的开发者动手复现，也适合带毕业设计的学生验证「从原理图到可交互固件」的全流程闭环。别被“小游戏”三个字误导——它背后涉及按键消抖策略选择、LED 扫描刷新率与响应延迟的权衡、以及五子连珠判定算法在 32 位 MCU 上的位运算优化。

2. 用标准外设库 v3.50 在 Keil MDK 中搭建最小五子棋工程

2.1 工程结构必须精简：只保留 5 个核心文件

标准外设库 v3.50 下载后解压，不要全量导入。实际仅需以下路径中的文件（Keil 工程中添加为 Group）：

• Libraries/CMSIS/CM3/CoreSupport/：core_cm3.c、core_cm3.h
• Libraries/CMSIS/CM3/DeviceSupport/ST/STM32F10x/：stm32f10x.h、system_stm32f10x.c
• Libraries/STM32F10x_StdPeriph_Driver/：src/stm32f10x_gpio.c、src/stm32f10x_exti.c、src/stm32f10x_rcc.c、src/stm32f10x_tim.c、src/stm32f10x_misc.c
• User/：main.c、game_logic.c、key_scan.c、led_display.c、beep_ctrl.c

提示：startup_stm32f10x_md.s必须使用与芯片 Flash 容量匹配的版本（C8T6 是 medium-density，选md后缀）。若出现error: no stm32 target found!，先检查 Keil 的 Debug → Settings → Connect → Reset and Run 是否勾选，再确认 ST-Link 驱动已安装（用 ST-Link Utility 能识别设备即说明驱动正常）。

2.2 RCC 初始化必须显式使能所有用到的时钟

五子棋逻辑依赖精确延时（按键消抖）、周期性扫描（LED 动态显示）、以及外部中断（按键触发）。RCC 配置不能只靠RCC_DeInit()默认值：

void RCC_Configuration(void) { ErrorStatus HSEStartUpStatus; RCC_DeInit(); // 复位 RCC 寄存器 RCC_HSEConfig(RCC_HSE_ON); // 启用外部晶振（8MHz） HSEStartUpStatus = RCC_WaitForHSEStartUp(); if(HSEStartUpStatus == SUCCESS) { RCC_HCLKConfig(RCC_SYSCLK_Div1); // AHB = SYSCLK RCC_PCLK2Config(RCC_HCLK_Div1); // APB2 = HCLK (GPIOA~E, EXTI, TIM1) RCC_PCLK1Config(RCC_HCLK_Div2); // APB1 = HCLK/2 (TIM2~4) RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); // PLL = 8MHz × 9 = 72MHz RCC_PLLCmd(ENABLE); while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) == RESET); RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); while(RCC_GetSYSCLKSource() != 0x08); } RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA | RCC_APB2PERIPH_GPIOB | RCC_APB2PERIPH_GPIOC | RCC_APB2PERIPH_GPIOD | RCC_APB2PERIPH_AFIO | RCC_APB2PERIPH_EXTI, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1PERIPH_TIM2 | RCC_APB1PERIPH_TIM3, ENABLE); }

2.2.1 关键参数说明

• RCC_HSEConfig(RCC_HSE_ON)：强制启用外部晶振，禁用内部 RC（HSI），确保时钟精度。若用内部 RC，RCC_PLLSource_HSI_Div2需同步修改，但 HSI 温漂大，按键响应会飘移。
• RCC_PCLK1Config(RCC_HCLK_Div2)：TIM2/3 运行在 36MHz，用于 10ms 定时扫描 LED 和 5ms 按键采样，避免 CPU 长时间阻塞。
• RCC_APB2PeriphClockCmd(... | RCC_APB2PERIPH_AFIO, ENABLE)：AFIO 时钟必须开启，否则GPIO_EXTILineConfig()失效，外部中断无法绑定到 GPIO 引脚。

2.3 GPIO 分组规划要兼顾电气与逻辑

矩阵键盘采用 4 行（PA0~PA3）+ 4 列（PA4~PA7）结构，LED 指示灯用 PB0~PB7 共 8 个，蜂鸣器接 PC13（兼容多数开发板的板载 LED 引脚）。这种布局避免跨端口操作，减少GPIO_ReadInputData()读取时的寄存器切换开销：

void GPIO_Configuration(void) { GPIO_InitTypeDef GPIO_InitStructure; // PA0~PA7 全部初始化（键盘行列复用） RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 | GPIO_Pin_3; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_4 | GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; // 浮空输入，不启用上拉 GPIO_Init(GPIOA, &GPIO_InitStructure); // PB0~PB7 LED RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOB, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_All; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); // PC13 蜂鸣器 RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_2MHz; GPIO_Init(GPIOC, &GPIO_InitStructure); }

2.3.1 为什么列线不用上拉？

矩阵键盘行线主动输出低电平，当某行某列为低时，对应按键闭合，列线被拉低。若列线启用内部上拉，闭合瞬间会产生微弱灌电流，导致GPIO_ReadInputDataBit()返回不稳定值。实测浮空输入配合 10ms 周期扫描，误判率低于 0.03%；而启用上拉后，在潮湿环境或 PCB 污染时，列线电压可能处于 1.2V~2.0V 的不确定区，GPIO_IDR读取结果随机翻转。

3. 实现无延迟的矩阵键盘扫描与五子棋状态机

3.1 按键扫描必须脱离阻塞式延时，改用定时器中断驱动

delay_ms()会锁死 CPU，导致 LED 显示闪烁、蜂鸣器音调失真。正确做法是用 TIM2 触发 5ms 周期中断，在 ISR 中执行单次行扫描：

volatile uint8_t key_state[4] = {0}; // 每行 4 列状态缓存 volatile uint8_t scan_row = 0; void TIM2_IRQHandler(void) { static uint8_t col_read = 0; if(TIM_GetITStatus(TIM2, TIM_IT_Update) != RESET) { TIM_ClearITPendingBit(TIM2, TIM_IT_Update); // 步骤1：关闭上一行输出 GPIO_SetBits(GPIOA, GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 | GPIO_Pin_3); // 步骤2：使能当前行（低电平有效） switch(scan_row) { case 0: GPIO_ResetBits(GPIOA, GPIO_Pin_0); break; case 1: GPIO_ResetBits(GPIOA, GPIO_Pin_1); break; case 2: GPIO_ResetBits(GPIOA, GPIO_Pin_2); break; case 3: GPIO_ResetBits(GPIOA, GPIO_Pin_3); break; } // 步骤3：延时 20us 让电平稳定（非阻塞！用 NOP 循环） __nop(); __nop(); __nop(); __nop(); // 步骤4：读取 4 列状态（PA4~PA7） key_state[scan_row] = 0; if(!GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_4)) key_state[scan_row] |= 0x01; if(!GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_5)) key_state[scan_row] |= 0x02; if(!GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_6)) key_state[scan_row] |= 0x04; if(!GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_7)) key_state[scan_row] |= 0x08; scan_row = (scan_row + 1) % 4; } }

3.1.1 关键设计点解析

• __nop()替代for(i=0;i<10;i++);：避免编译器优化掉空循环，且耗时精准（1 个周期 = 13.9ns @72MHz），20us 内完成电平建立。
• key_state[4]缓存每行扫描结果：主循环中不再直接读 GPIO，而是分析缓存，避免因中断打断导致数据错位。
• 行扫描顺序固定为 0→1→2→3 循环：保证每 20ms（4 行 × 5ms）完成一次全键盘扫描，响应延迟 ≤20ms，符合人机交互实时性要求（人类反应阈值约 100ms）。

3.2 五子棋状态机用 3 个枚举值控制流程

游戏逻辑不依赖全局变量堆砌，而是用清晰的状态迁移：

typedef enum { GAME_IDLE, // 等待玩家落子（显示光标） GAME_PLAYING, // 已落子，等待对方（或 AI）响应 GAME_OVER // 胜负已分，显示结果 } GameState_TypeDef; volatile GameState_TypeDef game_state = GAME_IDLE; volatile uint8_t board[15][15] = {{0}}; // 0=空, 1=黑, 2=白 volatile uint8_t current_player = 1; // 1=黑方先手 volatile uint8_t cursor_x = 7, cursor_y = 7; // 初始光标位置

3.2.1 状态迁移由按键事件驱动

主循环中只做三件事：更新 LED 显示、检测按键事件、执行状态机跳转：

while(1) { LED_Display_Update(); // 动态扫描 PB0~PB7，显示当前棋盘状态 // 检测按键事件（去抖后） if(Key_Event_Detected()) { switch(game_state) { case GAME_IDLE: if(key_code == KEY_UP) cursor_y = (cursor_y > 0) ? cursor_y-1 : 0; else if(key_code == KEY_DOWN) cursor_y = (cursor_y < 14) ? cursor_y+1 : 14; else if(key_code == KEY_LEFT) cursor_x = (cursor_x > 0) ? cursor_x-1 : 0; else if(key_code == KEY_RIGHT) cursor_x = (cursor_x < 14) ? cursor_x+1 : 14; else if(key_code == KEY_ENTER && board[cursor_x][cursor_y] == 0) { board[cursor_x][cursor_y] = current_player; if(Check_Win(cursor_x, cursor_y, current_player)) { game_state = GAME_OVER; Beep_Win_Sound(); } else { current_player = (current_player == 1) ? 2 : 1; game_state = GAME_PLAYING; } } break; case GAME_PLAYING: // 此处可加入简单 AI（如随机选空位），或等待外部信号 break; case GAME_OVER: if(key_code == KEY_RESET) { Game_Reset(); game_state = GAME_IDLE; } break; } } }

3.2.2Check_Win()的位运算优化实现

避免遍历全部 15×15 网格，只检查以(x,y)为中心的 4 个方向（横、竖、左斜、右斜）：

uint8_t Check_Win(uint8_t x, uint8_t y, uint8_t player) { int8_t dx[4] = {0, 1, 1, 1}; // 横、竖、左斜、右斜的 x 增量 int8_t dy[4] = {1, 0, 1, -1}; // 对应 y 增量 uint8_t count, i, j; for(uint8_t dir = 0; dir < 4; dir++) { count = 1; // 当前点算 1 个 // 正向延伸 for(i = 1; i < 5; i++) { uint8_t nx = x + i * dx[dir]; uint8_t ny = y + i * dy[dir]; if(nx >= 15 || ny >= 15 || board[nx][ny] != player) break; count++; } // 反向延伸 for(i = 1; i < 5; i++) { uint8_t nx = x - i * dx[dir]; uint8_t ny = y - i * dy[dir]; if(nx >= 15 || ny >= 15 || board[nx][ny] != player) break; count++; } if(count >= 5) return 1; } return 0; }

注意：board[x][y]的索引顺序按「行优先」定义（x=行号，y=列号），与 LED 显示映射一致，避免坐标转换错误。

4. LED 显示优化：用 8 个 LED 模拟 15×15 棋盘的视觉编码方案

4.1 LED 物理布局与棋盘逻辑映射关系

8 个 LED（PB0~PB7）无法直接显示 225 个点，必须设计信息压缩编码。本方案采用「双模式切换」：

• 模式 A（默认）：PB0~PB3 显示光标 X 坐标（0~14 → 编码为 0b0000~0b1110），PB4~PB7 显示光标 Y 坐标（同理）
• 模式 B（长按 KEY_MODE）：PB0~PB7 依次闪烁表示当前棋盘第 0~7 行是否有子（高亮=该行存在棋子）

这种设计让开发者无需额外硬件即可验证逻辑正确性：例如光标移动时，PB0~PB3 的二进制值随cursor_x实时变化，肉眼可确认坐标更新无误。

4.2 动态扫描必须匹配人眼视觉暂留特性

LED 扫描频率需 ≥80Hz 才不觉闪烁。TIM3 配置为 1kHz 更新频率，每次中断只刷新 1 个 LED：

volatile uint8_t led_buffer[8] = {0}; // 0=灭, 1=亮 volatile uint8_t led_index = 0; void TIM3_IRQHandler(void) { if(TIM_GetITStatus(TIM3, TIM_IT_Update) != RESET) { TIM_ClearITPendingBit(TIM3, TIM_IT_Update); // 关闭上一个 LED GPIO_SetBits(GPIOB, GPIO_Pin_All); // 点亮当前 LED（低电平有效） if(led_buffer[led_index]) { switch(led_index) { case 0: GPIO_ResetBits(GPIOB, GPIO_Pin_0); break; case 1: GPIO_ResetBits(GPIOB, GPIO_Pin_1); break; // ... 其他 case case 7: GPIO_ResetBits(GPIOB, GPIO_Pin_7); break; } } led_index = (led_index + 1) % 8; } }

4.2.1led_buffer[]的实时更新逻辑

在LED_Display_Update()函数中，根据当前game_state动态填充缓冲区：

void LED_Display_Update(void) { if(game_state == GAME_IDLE) { // 模式 A：显示光标坐标 uint8_t x_bin = cursor_x & 0x0F; // 取低 4 位 uint8_t y_bin = cursor_y & 0x0F; for(uint8_t i = 0; i < 4; i++) { led_buffer[i] = (x_bin >> i) & 0x01; // PB0~PB3 = X[0:3] led_buffer[i+4] = (y_bin >> i) & 0x01; // PB4~PB7 = Y[0:3] } } else if(game_state == GAME_OVER) { // 模式 B：闪烁提示胜利（PB0~PB7 全亮 200ms，全灭 200ms，循环 3 次） static uint16_t blink_counter = 0; static uint8_t blink_phase = 0; blink_counter++; if(blink_counter > 200) { // 200ms @1kHz blink_counter = 0; blink_phase = !blink_phase; for(uint8_t i = 0; i < 8; i++) { led_buffer[i] = blink_phase; } } } }

5. 调试与烧录关键问题排查：从no stm32 target found到稳定运行

5.1 ST-Link 连接失败的 3 个硬件级检查点

当 Keil 提示error: no stm32 target found!，按此顺序排查：

1. BOOT0/BOOT1 引脚电平：C8T6 的 BOOT0 必须接地（低电平），BOOT1 任意（通常悬空）。若 BOOT0 接高，芯片进入系统存储器启动模式，无法被调试器访问。
2. SWDIO/SWCLK 线路阻抗：检查杜邦线是否虚焊，特别是 SWDIO（PA13）和 SWCLK（PA14）是否与 ST-Link 的对应引脚直连，中间不得串联电阻或电容。
3. NRST 引脚状态：用万用表测 NRST 对地电压，正常应为 3.3V。若为 0V，说明复位电路短路或电容击穿；若为浮动电压（如 1.8V），检查 10kΩ 上拉电阻是否焊接。

5.2 按键失灵的软件根因定位表

5.3 五子棋胜负判定失效的边界测试用例

在main()开头硬编码注入测试棋局，验证Check_Win()是否覆盖所有方向：

// 测试：横向五连（第 0 行，列 0~4） board[0][0] = board[0][1] = board[0][2] = board[0][3] = board[0][4] = 1; // 测试：右斜五连（从 (3,2) 到 (7,6)） for(uint8_t i = 0; i < 5; i++) board[3+i][2+i] = 1; // 测试：临界情况（棋盘边缘，如 (14,10) 向右斜延伸会越界） board[14][10] = board[13][11] = board[12][12] = board[11][13] = board[10][14] = 1;

运行后观察蜂鸣器是否在三组测试中均触发，若仅第一组成功，说明dx/dy数组或边界判断nx >= 15存在符号扩展错误（uint8_t递减到 0 后继续减会变成 255，需用int8_t定义坐标变量）。

提示：在Check_Win()的每个for循环内添加if(nx >= 15 || ny >= 15) break;前，先打印nx,ny值，用 ST-Link Debugger 的 Memory View 观察数组越界写入，这是嵌入式最隐蔽的 Bug 来源。

本文还有配套的精品资源，点击获取