简介：ALIENTEK MiniSTM32开发板例程包面向STM32初学者与嵌入式开发者，基于STM32F103C8T6芯片，帮助读者快速上手GPIO控制、串口通信、PWM输出、ADC采样、I2C与SPI通信等基础实验，并逐步熟悉Keil uVision、STM32CubeIDE及HAL/LL库的开发流程。压缩包共1415个文件，以676个h头文件与633个c源文件为主体，辅以31个s汇编启动文件、29个uv2工程文件及若干txt说明、asm、pdf文档，整体约5.3MB，工程结构完整，便于按模块检索与编译验证。目前已有285人学习下载。每个例程均配有详细注释，读者可借此理解代码逻辑与底层寄存器操作，掌握从外设驱动到通信协议的实现思路，为后续项目开发与创新应用打下扎实基础。
1. 从一份 ALIENTEK MiniSTM32 开发板例程压缩包说起：它到底能帮你省下多少事
如果你手上正躺着一块 ALIENTEK MiniSTM32 开发板，或者刚从一个压缩包里解出一堆以实验开头的文件夹，却不知道从哪下手，那这篇笔记就是写给你的。ALIENTEK MiniSTM32开发板例程.rar这类资源，本质上是把一块 STM32F103RCT6 核心板从点灯到 USB、SD 卡、文件系统、触摸屏的完整验证代码打包在一起，让你不用从零去翻参考手册的每一个寄存器。它解决的不是“能不能跑”的问题，而是“怎么在最短时间内把板子上的外设一个个点亮，并且知道每个工程里哪些文件是必须留的、哪些是厂商为了演示凑数的”。适合刚接触 STM32 标准库、想用一块现成板子把 GPI0、串口、定时器、ADC、SPI、I2C 这些基础外设串起来的人，也适合已经会写寄存器但想看看别人怎么组织多工程目录的熟手。我见过太多人把压缩包解压完就放在那吃灰，其实只要按对顺序打开前三个工程，后面那些“高级例程”基本就是复制粘贴改引脚的事。
2. 拆开压缩包先别急着编译：目录结构与工程依赖的对应关系
2.1 典型例程包的目录分层与最小可编译单元
一个典型的 ALIENTEK MiniSTM32 例程包，解压后通常长这样：根目录下有一份readme或者说明，然后是一串以数字或功能命名的文件夹，比如1-1 跑马灯、2-1 串口实验、3-1 定时器中断，再往后是4-1 外部中断、5-1 独立看门狗、6-1 待机唤醒，最后可能还有SD卡实验、USB读卡器、触摸屏实验。每个文件夹里一般包含USER、HARDWARE、SYSTEM、CORE、STM32F10x_FWLib这几个子目录。USER放main.c和工程文件，HARDWARE放外设驱动，SYSTEM放延时和串口打印，CORE放启动文件和内核相关，STM32F10x_FWLib是标准外设库。很多人一上来就双击USER里的.uvprojx直接编译，结果报一堆cannot open source input file，原因就是工程里引用的路径是相对路径，而你解压时多套了一层文件夹，或者把STM32F10x_FWLib挪走了。最小可编译单元不是整个包，而是单个实验文件夹加上它引用的库目录，所以第一步应该是确认每个实验文件夹里是否自带STM32F10x_FWLib，如果没有，就要把根目录下的库目录复制到该实验文件夹的同级位置。
2.2 用一条命令检查工程引用路径是否完整
在动手改代码之前，我习惯先用文本方式扫一遍工程文件里的路径引用，看看有没有指向绝对路径的“坑”。以 Keil MDK 的.uvprojx为例，它本质是 XML，里面<FilePath>标签记录了所有源文件位置。在实验文件夹根目录执行下面这条命令，就能把非相对路径的引用揪出来：
# 在当前实验目录下查找 .uvprojx 中所有 FilePath 节点 # 过滤掉以 ..\ 开头的相对路径，剩下的就是可疑的绝对路径或缺失路径 grep -o '<FilePath>[^<]*</FilePath>' *.uvprojx | \ sed 's/<[^>]*>//g' | \ grep -v '^\.\.\\' | \ sort -u逻辑说明：grep -o只输出匹配到的<FilePath>...</FilePath>片段，sed去掉标签留下纯路径，grep -v排除以..\开头的正常相对路径。如果输出里出现C:\Users\...或者D:\...这类盘符路径，说明这个工程在原作者机器上能编译，到你这里就会报文件找不到。解决办法不是去建同样的目录，而是把这些绝对路径改成相对路径，或者直接把缺失的文件从库目录里复制到工程期望的位置。参数上，-o和-v是 grep 的标配，sed 's/<[^>]*>//g'里的[^>]*匹配任意非>字符，保证不会跨标签误删。这一步花两分钟，能省掉后面半小时的“为什么编译不过”的玄学排查。
2.3 标准库版本与启动文件的匹配检查
ALIENTEK MiniSTM32 用的是 STM32F103RCT6，属于大容量产品，Flash 256KB，SRAM 48KB。标准库版本常见的是 V3.5.0，启动文件应该选startup_stm32f10x_hd.s（hd 代表 high density）。如果你在CORE目录里看到的是startup_stm32f10x_md.s，那说明这个工程原本是给中容量芯片准备的，直接烧到 RCT6 上可能跑不起来，或者中断向量表对不上。检查方法很简单：打开CORE目录，看启动文件名，再打开 Keil 的Options for Target→Device，确认芯片型号选的是STM32F103RC。如果启动文件是 md 而芯片是 hd，编译可能通过，但中断一开就飞。我一般会直接把startup_stm32f10x_hd.s复制过去替换，然后在工程里重新添加。另外，stm32f10x.h里有一个#define STM32F10X_HD的宏，必须在Options for Target→C/C++→Define里加上，否则库函数里的一些条件编译会走错分支，比如GPIO_Init对某些寄存器的操作会不完整。这个宏不加，点灯可能正常，但串口和定时器就容易出怪问题。
3. 从跑马灯到串口中断：把第一个工程改成自己的外设验证模板
3.1 跑马灯工程里真正值得抄的是时钟使能和 GPIO 配置顺序
打开1-1 跑马灯的main.c，你会看到类似这样的代码：
#include "stm32f10x.h" #include "delay.h" #include "led.h" int main(void) { delay_init(); // 延时函数初始化 LED_Init(); // LED 端口初始化 while(1) { GPIO_SetBits(GPIOB, GPIO_Pin_5); // PB5 输出高，灭 GPIO_ResetBits(GPIOE, GPIO_Pin_5); // PE5 输出低，亮 delay_ms(500); GPIO_SetBits(GPIOE, GPIO_Pin_5); GPIO_ResetBits(GPIOB, GPIO_Pin_5); delay_ms(500); } }这段代码本身没什么稀奇，但LED_Init()里的顺序才是关键。标准库下配置一个 GPIO 输出，必须严格按这个顺序：先开时钟RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB | RCC_APB2Periph_GPIOE, ENABLE);，再定义GPIO_InitTypeDef结构体，设置GPIO_Pin、GPIO_Mode、GPIO_Speed，最后调GPIO_Init。很多人把时钟使能放到GPIO_Init后面，编译不报错，但引脚就是不动，因为外设时钟没开，寄存器写不进去。参数上，GPIO_Mode选GPIO_Mode_Out_PP（推挽输出），GPIO_Speed选GPIO_Speed_50MHz就行，驱动 LED 不需要高速。delay_init()里通常是用 SysTick 做延时，需要确认SystemCoreClock的值和实际主频一致，否则延时时间会差很多。我一般会把LED_Init改成自己的Board_Init，把串口、LED、按键的初始化都放进去，这样后面每个实验都能直接复用。
3.2 串口实验里中断接收的配置与环形缓冲的简化写法
2-1 串口实验通常只做了发送，或者用查询方式接收。要改成中断接收，需要在usart.c里加几行：
// 串口 1 中断接收初始化片段 void USART1_IRQHandler(void) { u8 res; if(USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) { res = USART_ReceiveData(USART1); // 读取接收到的字节 // 这里可以加环形缓冲写入，或者直接回显 USART_SendData(USART1, res); // 回显 while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET); } }逻辑说明：USART_IT_RXNE是接收数据寄存器非空中断，每收到一个字节触发一次。USART_ReceiveData读走数据后，硬件会自动清标志。回显时用USART_FLAG_TC等待发送完成，避免覆盖。参数上，波特率一般设 115200，USART_InitStructure.USART_WordLength = USART_WordLength_8b，USART_StopBits = USART_StopBits_1，USART_Parity = USART_Parity_No，USART_Mode = USART_Mode_Rx | USART_Mode_Tx。中断优先级用NVIC_Init配置，NVIC_IRQChannel = USART1_IRQn，NVIC_IRQChannelPreemptionPriority和SubPriority根据实际系统调整，一般先设 1 和 1。注意，如果开了中断但没在main里调USART_ITConfig(USART1, USART_IT_RXNE, ENABLE);，中断永远不会进。这个坑我踩过，查了半天以为是硬件问题，其实是软件没开中断使能。
3.3 把延时函数从 SysTick 换成 TIM 做微秒级精度的取舍
delay.c里通常用 SysTick 实现delay_ms和delay_us。SysTick 是 24 位递减计数器，主频 72MHz 时，最大延时约 186ms 一次，所以delay_ms里会用循环累加。如果你需要更精确的微秒级延时，比如驱动 WS2812 或者软件模拟 I2C，SysTick 在中断里被其他任务占用时会有抖动。常见做法是改用 TIM2 或 TIM3 做一个 1MHz 的计数时钟，delay_us直接读计数器差值。改法是把delay_init里的 SysTick 配置换成 TIM 配置，delay_us里用TIM_GetCounter读当前值，配合溢出处理。参数上，TIM 预分频器TIM_Prescaler = 72 - 1，自动重装载TIM_Period = 65535，这样计数频率就是 1MHz，每个计数 1us。代价是占用一个定时器，而且如果延时超过 65ms 需要额外处理溢出。我一般只在需要严格时序的工程里这么改，普通点灯和串口还是用 SysTick 省事。
4. 避坑与排查：例程跑不通时先看这五个地方
4.1 编译通过但下载后没反应，先查 BOOT0 和 BOOT1 跳线
现象：Keil 里编译零错误零警告，下载也提示成功，但板子上的 LED 就是不闪，串口也没输出。原因：STM32 的启动模式由 BOOT0 和 BOOT1 引脚决定，如果 BOOT0 接高电平，芯片会从系统存储器启动，也就是跑内置的 bootloader，而不是你刚烧进去的 Flash 程序。解决：把 BOOT0 跳线帽接回 GND，BOOT1 接 GND 或悬空，然后按一下复位键。ALIENTEK MiniSTM32 板上一般有明确的跳线丝印，BOOT0 和 BOOT1 并排，正常跑程序时两个都接 GND。这个坑在新板子上第一次通电时特别常见，因为出厂可能为了串口下载把 BOOT0 拨到了 3.3V。
4.2 串口打印乱码，先确认外部晶振频率和 SystemInit 里的宏
现象：串口助手上收到一堆乱码，或者偶尔能认出几个字符。原因：system_stm32f10x.c里根据外部晶振频率定义了HSE_VALUE，默认是 8000000（8MHz），但有些板子焊的是 12MHz 晶振，或者你在stm32f10x.h里改了HSE_VALUE却没同步改SystemInit里的 PLL 倍频参数。解决：打开system_stm32f10x.c，找到SetSysClockTo72函数，确认HSE_VALUE和实际晶振一致，然后检查 PLL 的倍频系数。8MHz 晶振下，RCC_PLLMul_9得到 72MHz；12MHz 晶振下，要用RCC_PLLMul_6。改完记得重新编译整个工程，因为SystemInit在启动文件里被调用，只改一个文件不重编可能不生效。
4.3 中断进不去，检查 NVIC 分组和优先级配置
现象：串口中断、定时器中断都配了，但中断服务函数里的断点永远不命中。原因：STM32 的中断优先级分组默认是NVIC_PriorityGroup_0，这时候没有抢占优先级，只有子优先级，而很多例程里直接写NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1;，在分组 0 下这个值会被忽略，导致优先级配置无效。解决：在main开头调NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);，这样有 2 位抢占优先级和 2 位子优先级，然后重新配置NVIC_Init。另外，确认NVIC_IRQChannel写的是USART1_IRQn而不是USART1_IRQHandler，前者是中断号，后者是函数名，写错了编译能过但中断向量表对不上。
4.4 SD 卡实验初始化失败，先降速再查供电
现象：SD_Init()返回失败，串口打印“SD Card Error”。原因：SD 卡在初始化阶段需要低速通信，通常是 400kHz 以下，初始化完成后再切到高速。有些例程里 SPI 分频系数设得太小，一开始就跑到几 MHz，导致卡不响应。解决：在SD_Init里先把 SPI 波特率预分频器设大，比如SPI_BaudRatePrescaler_256，初始化成功后再改成SPI_BaudRatePrescaler_2或_4。另外，SD 卡座如果是从 3.3V 取电，确认板子上 3.3V 稳压芯片的电流够，有些卡在初始化瞬间电流能到 100mA，供电不足会反复失败。我一般会并一个 100uF 电容在卡座电源脚附近。
4.5 触摸屏坐标跳动，校准值要存在 Flash 里而不是每次上电重算
现象：触摸屏实验里，画线时坐标偏移很大，或者每次复位后准星位置都不一样。原因：电阻触摸屏的校准系数（touch_adjust里的四个参数）如果只存在 RAM 里，每次上电都会重新用默认值，而默认值跟实际屏幕的偏差可能很大。解决：在touch.c里加一段读写 STM32 内部 Flash 的代码，把校准后的pos_temp数组存到 Flash 的最后一页，上电时先读，读不到再进校准模式。参数上，Flash 写入前要FLASH_Unlock()，擦除按页擦，写入按半字写，地址选0x0803F800这种最后一页的起始地址。注意不要写到程序区，否则会把代码擦掉。
5. 把例程变成自己的工程模板：裁剪、合并与版本管理
5.1 从多个实验里抽出一个最小系统模板
跑通几个实验后，你会发现每个工程里都有重复的delay.c、sys.c、usart.c。与其每次复制整个文件夹，不如抽一个最小系统模板：只保留CORE、STM32F10x_FWLib、SYSTEM三个目录，USER里放一个空的main.c和工程文件。然后按需往里加HARDWARE下的驱动。具体做法是新建一个Template文件夹，把1-1 跑马灯里的CORE、STM32F10x_FWLib、SYSTEM复制过来，删掉HARDWARE里的led.c和led.h，在main.c里只留delay_init()和空循环。编译一次，确认零错误。以后每做一个新外设，就把对应的.c和.h复制到HARDWARE下，在 Keil 里 Add Existing Files，再在main.c里调初始化。这样工程目录干净，也不会因为某个实验的main.c里有多余代码而干扰。
5.2 用 Git 管理例程修改，忽略编译中间文件
例程包解压后直接git init会把一堆.o、.crf、.axf也纳入版本控制，仓库很快膨胀。正确做法是先写.gitignore：
# 忽略 Keil MDK 编译中间文件和输出文件 *.o *.crf *.d *.axf *.hex *.bin *.htm *.lnp *.map *.lst *.bak *.dep *.iex *.sct *.build_log.htm # 忽略用户界面配置文件 *.uvguix.* *.uvoptx # 忽略 JLink 和 STLink 临时文件 JLinkLog.txt *_JLink*逻辑说明：*.o、*.crf、*.d是编译过程文件，*.axf、*.hex、*.bin是输出文件，*.uvguix.*是 Keil 自动生成的窗口布局文件，不同人打开会变，没必要提交。*.uvoptx里记录了调试器设置和断点，也建议忽略。保留.uvprojx和所有.c、.h就够了。这样每次改代码，git diff只显示源文件变化，不会混入二进制。我一般会在提交信息里写清楚改了哪个外设的哪个参数，比如“串口波特率从 9600 改到 115200”，方便回退。
5.3 用条件编译把多个实验合并到一个工程
如果你不想每次换实验都重新打开一个工程，可以用条件编译把多个main合并。在main.c顶部定义：
#define EXPERIMENT_LED 0 #define EXPERIMENT_USART 1 #define EXPERIMENT_TIMER 2 #define CURRENT_EXPERIMENT EXPERIMENT_USART #if CURRENT_EXPERIMENT == EXPERIMENT_LED #include "led.h" int main(void) { delay_init(); LED_Init(); while(1){ /* 跑马灯代码 */ } } #elif CURRENT_EXPERIMENT == EXPERIMENT_USART #include "usart.h" int main(void) { delay_init(); USART_Init(115200); while(1){ /* 串口代码 */ } } #elif CURRENT_EXPERIMENT == EXPERIMENT_TIMER #include "timer.h" int main(void) { delay_init(); TIM3_Int_Init(4999, 7199); while(1); } #endif逻辑说明：CURRENT_EXPERIMENT决定编译哪一段，改一个宏就切换实验，不用动工程文件。参数上，TIM3_Int_Init(4999, 7199)里 7199 是预分频，4999 是重装载，72MHz / 7200 = 10kHz，10kHz / 5000 = 2Hz，也就是 500ms 中断一次。注意每个实验的初始化函数要放在对应的#if块里，避免未使用的函数被编译进去占空间。这种写法适合个人验证，但正式项目里不建议，因为所有外设的代码都在一个文件里，容易乱。
5.4 烧录后不运行，检查复位电路和电源纹波
最后一个容易忽略的点：有时候程序下载成功，但板子偶尔不启动，按复位又好了。这通常是复位电路上的电容太大或者电源纹波导致上电复位不彻底。ALIENTEK MiniSTM32 的复位引脚上一般有 10k 上拉和 100nF 电容，如果电容焊成了 1uF，上电复位时间会变长，但一般不影响。更常见的是 USB 供电时电流不足，尤其是接了 SD 卡和触摸屏后，3.3V 被拉低到 3.0V 以下，芯片工作不稳定。我一般会用一个 5V 2A 的适配器通过板子上的 DC 口供电，或者用带独立供电的 USB HUB。如果条件允许，用示波器看 3.3V 纹波，峰峰值超过 100mV 就要加滤波电容。这个坑在调试阶段很隐蔽，因为编译和下载都正常，就是运行起来时好时坏。
希望帮到你。
本文还有配套的精品资源，点击获取
