简介：STM32F103VET6迷你开发板的完整配套程序包，主要面向嵌入式初学者和需要快速搭建STM32项目的开发者，可帮助解决开发板入门、外设驱动编写、系统移植及无线模块集成等问题。资源共含907个文件，以C源文件、H头文件和汇编文件为主，同时包含uv2工程、pdf文档、html网页、图片和备份文件等，压缩包整体18.24MB。目前已有186人浏览学习。程序集成了初始化配置、板级驱动、外设应用框架，并融合uC/OS实时操作系统、uIP网络协议栈、NRF无线通信、网络服务器等模块；还涉及STM32CubeMX配置、HAL库调用、Keil/GCC编译调试、串口日志、JTAG/SWD调试等关键技能。借助清晰的目录结构和工程备份，学习者可对照源码理解时钟、GPIO、USART、SPI、ADC等外设的底层实现，快速迁移到自定义项目中。从基础的点灯、串口通信到高级的网络服务器与蓝牙透传，内容层次清晰，适合不同程度的开发者参考；同时，资源包中的PDF文档和网页示例也便于查阅硬件连接和网络应用开发，整体非常适合自学与二次开发。 手头正好有一块奋斗mini板，花了一周时间从点灯折腾到温度采集，中途踩了不少坑，也积累了一些实战经验。这篇文章就围绕STM32奋斗mini板的程序开发，把环境搭建、串口调试、外设驱动到常见问题排查完整过一遍。不管你是刚拿到板子的新手，还是想快速上手做个小项目的开发者，这篇内容都值得参考。
1. 硬件底盘认识与工程搭建
先说这块板子本身。奋斗mini板是一块典型的STM32F103系列最小系统板（具体型号根据批次可能是F103C8T6或RCT6），板载了USB转串口、电源稳压、复位电路、启动模式选择跳线，还引出了大部分GPIO。相比动不动就十几块钱的纯最小系统板，它把下载电路和串口都集成好了，一根USB线就能同时完成供电、下载和串口通信，这种“折腾成本低”的特性特别适合练习。
1.1 开发方式选型：标准库、HAL库还是寄存器
这是很多新人第一个纠结的问题。我梳理了三种方式的定位：
- 标准外设库：官方早期的C语言函数库，封装程度适中，既能看明白寄存器操作，又不需要自己逐个寄存器配置。参考代码多，网上资料最丰富，特别适合学习原理。
- HAL库：ST主推的抽象层库，配合STM32CubeMX图形化配置，鼠标点点就能生成立脚工程。优点是上手快、移植方便，缺点是封装层厚，出了问题不好追底层。
- 寄存器操作：直接操作寄存器地址，执行效率最高，代码最啰嗦，适合对芯片内部结构有深度兴趣的开发者。
我的建议很直接：如果目标是搞懂原理、为以后做复杂项目打基础，标准库是很好的起点。如果想快速出成果、做产品验证，直接用HAL库加CubeMX。两者不冲突，先标准库理解本质，再切HAL提升效率。寄存器方式除非你是做底层驱动开发，否则现阶段性价比不高。
1.2 从零搭建一个可用工程
不管你选哪种库，工程骨架都是一样的：启动文件、内核相关文件、外设库文件、头文件路径、链接脚本。我用标准库为例，把步骤拆开：
- 去ST官网或GitHub下载标准外设库压缩包（STM32F10x_StdPeriph_Lib_V3.5.0），解压后里面有Libraries、Project、Utilities几个主要目录。
- 新建工程目录，我习惯这样组织：
Project/ ├── User/ // 主函数、中断服务函数 ├── Core/ // 启动文件、内核头文件 ├── Periph/ // 标准库外设源文件 ├── Hardware/ // 自己写的板载外设驱动 └── Output/ // 编译输出- 在Keil MDK里新建工程，芯片型号选择对应的STM32F103系列。
- 把启动文件（startup_stm32f10x_hd.s或md.s，取决于芯片容量）加进Core组。
- 添加标准库必需文件，至少包括：stm32f10x_rcc.c、stm32f10x_gpio.c、stm32f10x_usart.c，用到的外设对应添加。不需要的把对应源文件从工程删掉或注释掉，能显著缩短编译时间。
- 在C/C++选项卡里定义USE_STDPERIPH_DRIVER，并把所有头文件路径加进Include Paths。
- 配置烧录器。使用板载ST-Link或J-Link，在Options for Target的Debug选项卡里选择对应调试器，再在Utilities选项卡里把Setting里的Flash Download勾上Reset and Run。这一步漏了的话，程序烧进去不自动运行，很多人误以为板子是坏的，其实只是没勾这个选项。
2. 串口调试：整个开发过程中最重要的输出窗口
写嵌入式程序，最怕的就是“代码下载进去没反应，也不知道跑没跑、跑到哪里”。串口输出就是你的眼睛。我强烈建议动手做的第一个外设不是LED，就是串口。
2.1 printf重定向的完整配置
奋斗mini板上一般会引出USART1的TX和RX，对应的引脚通常是PA9和PA10，板载USB转串口芯片直接连到了这两个引脚，所以只要在代码里配置好USART1，就能通过USB线在电脑上看到输出。
初始化串口的步骤不复杂：打开GPIO时钟和USART时钟，配置PA9为复用推挽输出、PA10为浮空输入或上拉输入，设置波特率、数据位8位、停止位1位、无校验，使能USART。这些操作标准库的USART_Init和GPIO_Init就能搞定。
关键在于printf重定向。在C标准库中，printf最终会调用fputc函数来输出单个字符。你只需要重写这个函数，把它指向串口发送接口：
int fputc(int ch, FILE *f) { while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) == RESET); USART_SendData(USART1, (uint8_t)ch); return ch; }同时，要在Keil里勾选Use MicroLIB选项。MicroLIB是一个精简版C库，专门为嵌入式设计，它不仅占用空间小，而且对fputc的重定向支持更简单，不勾选的话，printf输出经常不工作或者程序直接卡死。
还有一个细节：默认情况下printf是带缓冲的，但嵌入式环境往往希望立即输出调试信息。重定向fputc之后，因为输出到的是自定义字符设备，通常不会引入额外的行缓冲问题，实测下来直接使用就能实时输出。
2.2 串口助手的选型心得
串口打印有了，电脑端需要一个串口助手来接收。市面上工具很多，我试过的几款列个对比：
| 工具名称 | 特点 | 适用场景 |
|---|---|---|
| SSCOM | 免费、体积小、稳定 | 日常调试首选 |
| XCOM | 支持波形显示、多开串口 | 需要看数据曲线时 |
| 友善串口助手 | 界面简单，支持定时发送 | 快速测试 |
| 山外多功能调试助手 | 带虚拟示波器，能显示多通道波形 | 传感器数据分析 |
| 串口猎人 | 协议解析功能强 | 调试自定义协议 |
我个人日常用SSCOM最频繁，因为它操作直接、开箱即用。做传感器调试时，如果需要看温度变化曲线，我会切到山外调试助手，把ADC采集的温度值通过串口发出去，用它的波形显示功能看实时趋势，比看一行行滚动的数字直观太多了。
还有一点要提醒：串口打开前一定要确认端口号。先在设备管理器里查看USB转串口对应的COM口号，如果插上USB线完全没有反应，大概率是没装CH340或CP2102的驱动，先去装驱动，再谈调试。
3. 一个能上手的实战示例：热敏电阻温度检测
串口通了之后，就可以开始做有点意思的示例了。这里我选热敏电阻温度检测，因为这个项目用到了ADC采样、数据处理、串口输出和简单的数学计算，麻雀虽小五脏俱全，新手走完一遍能打通整个开发流程。
3.1 硬件连接与分压计算原理
奋斗mini板上如果集成了热敏电阻，一般会接在某个ADC通道上，通常是和一个固定电阻组成分压电路。如果板子上没有集成，自己接也很简单：热敏电阻NTC串联一个10k电阻，一端接3.3V，一端接地，中间抽头接到STM32的ADC输入引脚（比如PA1，对应ADC1的通道1）。
这里面的原理用一句话说清楚：NTC热敏电阻的阻值随温度变化，在分压电路里的分压值也随之变化，ADC把电压值转换成数字量，程序再把数字量反算成温度。整个链条的起点，就是这个分压电路。
假设NTC串联电阻R_fixed = 10k，供电电压Vref = 3.3V，NTC在25度时的标称阻值是10k，B值是3950。分压公式：
- Vntc = Vref × Rntc / (Rntc + R_fixed)
- 已知ADC采样值adc_value，12位ADC满量程4095，则 Vntc = 3.3 × adc_value / 4095
- 反推NTC阻值：Rntc = R_fixed × Vntc / (Vref - Vntc)
得到阻值后再用B值公式算温度：
- T = 1 / (1/T0 + ln(Rntc / R0) / B) - 273.15
其中T0是298.15K（即25度），R0是25度时的标称阻值10k，B是3950。这个公式算出来是摄氏度，前提是T和T0都用开尔文温度，所以最后要减273.15。
代码实现时注意：ln函数在C标准库的math.h里，编译时需要在Keil里勾选Use MicroLIB，它会自动带上浮点支持，或者手动添加微库。
3.2 ADC采集与数据处理代码解析
初始化ADC的核心操作如下：打开ADC1和GPIO时钟，把PA1配成模拟输入，设置ADC分频系数（通常PCLK2的6分频或8分频，保证ADC时钟不超过14MHz），设置ADC采样时间为239.5周期（采样时间越长，内阻越大的信号源采样越准），开启ADC并校准，然后就可以启动转换了。
采集部分，我喜欢用DMA加连续转换模式，这样CPU完全不用管采样这件事，数据自动搬到内存里，主循环直接读数组就行。标准库配置DMA的要点：
DMA_InitTypeDef DMA_InitStructure; DMA_DeInit(DMA1_Channel1); DMA_InitStructure.DMA_PeripheralBaseAddr = (uint32_t)&ADC1->DR; DMA_InitStructure.DMA_MemoryBaseAddr = (uint32_t)adc_buf; DMA_InitStructure.DMA_DIR = DMA_DIR_PeripheralSRC; DMA_InitStructure.DMA_BufferSize = 64; DMA_InitStructure.DMA_PeripheralInc = DMA_PeripheralInc_Disable; DMA_InitStructure.DMA_MemoryInc = DMA_MemoryInc_Enable; DMA_InitStructure.DMA_PeripheralDataSize = DMA_PeripheralDataSize_HalfWord; DMA_InitStructure.DMA_MemoryDataSize = DMA_MemoryDataSize_HalfWord; DMA_InitStructure.DMA_Mode = DMA_Mode_Circular; DMA_InitStructure.DMA_Priority = DMA_Priority_High; DMA_InitStructure.DMA_M2M = DMA_M2M_Disable; DMA_Init(DMA1_Channel1, &DMA_InitStructure); DMA_Cmd(DMA1_Channel1, ENABLE);DMA配置的关键是循环模式，这样DMA会自动回绕，64个采样值不断刷新，主循环随时读取都能拿到最新数据。
数据处理这块有一个很容易被忽略的点：单次采样值非常容易受噪声影响，直接拿一个值算温度会来回跳。比较稳妥的做法是软件滤波，我一般用滑动平均：取最近的N次采样值求平均，或者简单点直接连续采64次去掉最大最小再平均。实测下来，用简单的平均值滤波之后，温度显示的波动能从正负2度减少到正负0.3度以内。
然后就是浮点运算。如果你用的是不带FPU的STM32F103，浮点运算芯片内部是用软件模拟的，速度偏慢，但温度采集这种低频应用完全无感。具体算温度时，建议把所有中间变量声明为float，避免int型截断导致误差。我遇到过有人为了省事全部用int，算出来的温度在室温附近直接偏了5度，排查半天才发现是整数除法丢了小数点。
4. 调试工具链的工程化实践
勤用调试器，能有效减少猜代码的时间。你完全可以在Keil里打断点、看变量值、单步执行，而不是靠串口打印一点一点排错。这两者结合，效率会高很多。
4.1 Keil调试界面的正确使用方式
程序下载进板子之后，在Debug模式下点击Start/Stop Debug Session就进入了调试界面。这时候有几个地方非常有价值：
- Register窗口：查看当前寄存器的值变化。比如ADC初始化完后，检查ADC1->CR2的ADON位是否置1，就能马上确认外设有没有被正确使能。
- Watch窗口：添加变量名，实时观察变量值。我习惯把温度计算的所有中间变量都加进去，比如raw_adc、voltage、rntc、temperature，这样算出来的温度不对时，一眼就能看出是哪一步算岔了。
- Memory窗口：直接查看内存区域的值。比如定义一个数组buf[100]，可以在Memory窗口输入&buf，按实际数据类型查看内存数据，批量对比DMA搬运的数据是否符合预期。
- Disassembly窗口：会显示汇编代码和C代码的对应关系。很多新手程序跑着跑着突然跳出这个窗口，一脸懵，后面常见问题部分会详细说。
调试界面设置里有一个非常实用的小技巧：把System Viewer里的外设寄存器全部展开，配合全速运行，你可以实时看到外设寄存器的动态变化，排查一些奇怪的状态异常时特别好用，比反复看代码快得多。
4.2 看门狗、中断优先级与系统稳定性调试
程序简单的时候看不出问题，一旦加入中断、看门狗等机制，调试难度就上来了。分享几个我在实际调试中总结出的经验：
- 中断服务函数越短越好。能在主循环处理的事情，不要在中断里做。中断里只做标志位置位、数据搬运这种轻量操作。我踩过坑：在定时器中断里调用printf函数，结果程序跑一会儿就卡死，查了很久才发现是中断里调用了一个需要的执行时间比中断周期还长的函数，导致中断嵌套异常。
- 配置中断优先级时，相同抢占优先级的中断之间不会互相打断，不同抢占优先级才会。很多外设需要合理分配NVIC优先级，否则高频率中断会把低优先级任务饿死。
- 看门狗一旦开启，主循环必须及时喂狗。调试阶段如果开了看门狗，建议在初始化里暂时注释掉，等程序稳定了再打开，否则你打个断点停在那里，看门狗照样溢出复位，完全没法debug。
5. 开发板程序“跑飞”和烧写异常的处理套路
程序开发过程中，烧不进去、跑飞、启动异常是大概率会遇到的。下面这些坑我用血泪经验给你排查出来。
5.1 烧录失败的常见原因与解决顺序
下载程序失败时，不要慌，按这个顺序排查：
- 检查接线。ST-Link或者J-Link和板子的接线是否按SWDIO、SWCLK、GND、3.3V四线对应，顺序错了烧录工具识别不到芯片。
- 点击Keil的Options for Target，确认Debug下拉框里选择的调试器类型和实际硬件一致。
- 确认芯片没有被读保护。如果之前有人烧录时勾选了读保护选项，芯片的调试接口会被锁定，此时点下载会报“No target connected”之类错误，用STM32 ST-LINK Utility连接后选择Remove Protection即可解除。
- 如果以上都正常，把板子重新上电，或按一下复位键后再点下载。有些情况下芯片内部时钟配置异常导致不进调试模式，上电瞬间点下载成功率更高。
新手最容易忽略的是第4点：如果程序里把芯片主频配置得很高、或者关闭了内部时钟，芯片一上电就跑飞，调试器可能连不上。遇到这种问题，把BOOT0引脚拉高，重新上电，芯片会从系统存储器启动，这时再连接调试器擦除Flash就轻松多了。
5.2 程序进入Disassembly窗口的真相
这个问题的搜索热度相当高，因为几乎所有新手都会撞上。现象是：Keil里全速运行或单步调试时，突然弹出一个Disassembly窗口，里面全是汇编代码，程序“跑丢了”，你怎么按都回不到C代码。其实这不是程序崩溃，而是PC指针（程序计数器）跳到了当前工程C源文件覆盖范围之外的地址。
最常见的原因是：中断服务函数没有实现。比如你在代码里使能了某个外设中断，但没写对应的中断处理函数，也没有在启动文件里做弱定义兜底，那么中断一旦触发，PC指针就会跳到一个未定义的地址，Keil就弹出了反汇编窗口。
处理方法很简单：确认当前使能了哪些中断，在代码里补齐对应的中断服务函数，函数名必须和启动文件里定义的向量表名字一致。比如：
void USART1_IRQHandler(void) { if (USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) { // 处理接收 USART_ClearITPendingBit(USART1, USART_IT_RXNE); } }另一种常见原因是指针越界。比如把一个局部数组下标写超了，或者在数组越界后写入数据，破坏了栈，函数返回时PC被修改成一个非法值，也会进入Disassembly。排查思路：检查最近改动过的数组操作、指针操作，尤其是通过指针往未知地址写数据的代码。
如果是中断向量表问题（比如中断函数名拼写错误），启动文件里默认的弱定义会接住中断，但程序行为变得不可控。建议你在启动文件里给每个中断处理函数都加上默认的空函数（部分启动文件已提供），这样即使漏写了某中断处理函数，程序最多是什么都不做，至少不会直接跑飞。
5.3 实战中几个隐蔽的“初学者杀手”
除了上面两大类，还有几个问题特别容易在新手人群中反复出现：
- 引脚复用功能未开启。GPIO配置成复用功能时，必须调用GPIO_PinRemapConfig或者正确设置AFIO时钟。不少人在用USART或SPI时，引脚配置成普通推挽输出，结果是原子能输出高电平，但外设信号完全不通，高级功能全都不能用。
- 启动文件选错。大容量芯片用hd启动文件，中容量用md，小容量用ld，选错之后程序在启动阶段就异常甚至完全无法运行。确认方法：在芯片型号里看Flash容量，小于128KB用md，大等于128KB用hd。
- 时钟树配置错误。比如外部晶振是8MHz，你在SystemInit里配置成了其他频率，导致主频算错，串口波特率就全错。如果串口输出乱码，优先查波特率，再查外部晶振频率匹配。
6. 从例程到习惯：一套更省心的开发流程
最后再说点更宏观的。在实际开发中，用一个标准化的工程模板作为起点，比每次从头新建工程、配置外设要高效得多。但模板必须是你自己反复验证过的，不能是从网上随便扒一个就无脑使用。
6.1 建立自己的工程模板
把下面这些内容打包保存为模板，每次开新项目直接复制改改：
- 标准库外设的完整文件集合；
- 已经配置好的串口初始化、printf重定向；
- LED闪烁、按键扫KEY之类的底层驱动；
- 一个简单的中断处理框架；
- Keil工程文件（工程名称和用户代码已清空）。
平时遇到好用的代码模块，陆续往模板里加。这样你的模板会越来越像一个“自己的轮子仓库”，开新项目的效率会翻倍提升。
6.2 通用开发流程的经验沉淀
一个典型的小项目，我建议的流程是：先写需求清单、再画硬件连接图、然后逐个模块写驱动、融合成完整逻辑、最后整板联调。千万不要上来就一股脑把所有外设代码堆在main里，后面改起来会非常痛苦。把每个外设的驱动独立成文件，头文件里只暴露对外接口，main函数充当调度中心，这种分层带来的维护优势，会在后续复杂项目里体现得特别明显。
我实测下来的感受是：嵌入式开发更像是“搭积木和拧螺丝的结合体”，前期的工程框架搭得好，后期几乎一路通畅；反过来，前期偷懒省了一小时，后面可能补几天没有头绪的坑。所以，拿到新板子别急着一路往后写，先花时间把工程模板、下载调试、串口输出这三个基础磨顺，后面所有项目都会受益。
如果你也有一块奋斗mini板或者类似开发板，建议按这个顺序走一遍：点亮LED、串口打印、按键中断、ADC采集、OLED显示，每完成一个就巩固一个。等到这几个模块都能随手调通，你的嵌入式基本功也就立住了，尤其是那些“卡住但不知道错在哪”的时刻，想办法查、解决掉，那个过程比任何教程都值钱。
本文还有配套的精品资源，点击获取
