★ FEATURED ARTICLE stm32 开发板买回来后结局通常只有两种一种是照商家例程把 LED 点亮然后放在抽屉里吃灰另一种是越玩越上瘾最后靠它做了好几个实际能用的东西。我希望你成为第二种所以这篇就当是陪你从开箱走到第一个完整项目。我手边这块板子是最常见的 stm32f103 最小系统板芯片是 STM32F103C8T6也就是网上常说的“蓝板”或“红板”。拿到它之后先别急着焊排针也别急着复制代码有些准备工作做对了后面能少走很多弯路。1. 拿到开发板先别急着写代码认识你的板子新手最容易踩的坑就是打开 Keil 找商家例程直接编译下载。结果程序烧进去了板子没反应于是开始怀疑板子坏了。其实很多问题是没搞懂芯片和板子资源造成的。磨刀不误砍柴工先把下面几件事弄清楚后面会顺手很多。市面上九成教程都会让你“点灯”但点灯之前你得先知道自己按下的是哪个开关、控制灯的是哪个引脚。1.1 确认芯片型号是 C8T6 还是 ZET6第一脚怎么找STM32F103 是个大家族不同型号引脚数、Flash、外设都不一样。你手里的如果是 48 脚封装的 C8T6那 Flash 只有 64KB、RAM 20KB适合做中小型项目如果是 144 脚封装的 ZET6Flash 有 512KB外设也更完整。芯片表面会直接丝印型号比如 STM32F103C8T6 或 STM32F103ZET6不要只看商家的购买页拆开包装后自己核对一下才安心。确定型号后还要学会找“第一脚”。常见方法很简单芯片一角通常有一个小圆点或者斜角标记旁边可能写着数字 1LQFP 封装从标记处开始逆时针依次编号。如果丝印不够清楚可以对照开发板原理图里的芯片符号然后用万用表蜂鸣档量引脚和板子上的测试点顺着连通关系找到第一脚的物理位置。千万别在不确定引脚的情况下盲目通电把 5V 接到 3.3V 引脚上芯片大概率直接报废。很多开发板把 3.3V 和 GND 引出排针你可以先通过下载器的接口找到电源引脚用万用表量出板子上的 3.3V、5V、GND、BOOT0 等关键点再动手接线。1.2 板载资源盘点LED、按键、USB、串口都接在哪些引脚拿到开发板第一件事不是打开 IDE而是打开原理图 PDF。很多新手把这个文件忽略了结果后面所有问题都是在猜引脚。以最常见的蓝板为例板载 USB 口通常连接 PA11、PA12用于 USB Device板载串口芯片 CH340 通过 USB 引出调试串口通常接到 PA9、PA10板载 LED 接在某个 GPIO 上不同板子可能是 PC13、PA1、PB0必须看原理图确认。为什么要较真因为有些板子的 LED 是高电平点亮有些是低电平点亮。如果你照着别人的例程默认输出高电平而这个板子是低电平点亮灯就是不亮。按键也是同理有的接上拉按下为低有的接下拉按下为高。你不需要死记每一款板子的引脚但必须能做到拿着原理图顺着网络标号找到 LED 连接到哪个 GPIO按键连接到哪个 GPIO。这个习惯比多写一百行代码都值钱。1.3 先选一条学习路线寄存器、标准库、HAL 库到底学哪个这个话题在各大论坛能吵出几十页我的建议是按最终目标选。如果你只是做毕业设计、DIY 小项目或者工作需要快速出产品从标准库或者 HAL 库任选一个开始如果你想彻底搞懂 ARM 内核、寄存器机制那可以从寄存器点灯入门但第一条路就上寄存器对大多数人来说会比较痛苦。大多数中文教程和老例程仍用标准库因为代码直白很容易看懂每一步在写什么官方现在主推 HAL 库配合 CubeMX 图形化配置生成工程速度快适合做复杂外设的项目。我自己是先拿标准库点灯、按键、串口理解外设寄存器的工作方式之后再用 CubeMX 生成 HAL 工程做实际项目。两条腿走路以后看别人的代码就不吃力。学习路线入门难度代码可读性官方支持适合人群寄存器高差不需要库支持想彻底理解芯片底层逻辑的人标准库低高官方已停止更新看老例程学习、做课程设计的初学者HAL 库中中持续更新维护做产品、快速原型、习惯可视化配置的人选好路线后还要注意标准库和 HAL 库的初始化代码千万不要混在一个工程里。有人拿标准库工程复制了一段 HAL 的串口初始化编译可能不报错运行起来却各种诡异。不是芯片坏了而是两个库的时钟配置和中断处理互相打架。认真选一个把它用熟再考虑换。2. 搭建开发环境从 Keil 到 VS Code把工具链理顺环境搭建是劝退重灾区。我见过很多人在“VS Code 里编译成功但烧录不进开发板”上折腾了一周最后发现是下载器配置没选对。所以我的建议很明确新手先用 Keil MDK别一上来就折腾 VS Code。等你熟悉了编译、下载、调试的基本流程再考虑用 VS Code 或 PlatformIO 提效。工具有很多种但核心目标只有一个顺利把程序烧到片子里并且能在程序里看到运行结果。2.1 Keil MDK 安装和芯片包为什么装完找不到 STM32F103Keil 其实分好几个版本MDK-ARM 才是给 ARM 用的C51 是给 8051 单片机用的。它们可以装在同一台电脑上但是安装目录要分开许可证也要分别激活。如果你之前装过 C51再装 MDK 时不要自作聪明覆盖到同一个目录否则两个版本都启动不了。装了 MDK 之后还是找不到 STM32F103 芯片大概率是因为没装芯片支持包也就是 Keil.STM32F1xx_DFP.pack。这个 pack 里面有启动文件、设备头文件、Flash 下载算法等关键文件。没安装的话Device 列表里根本不会出现 STM32F103C8T6。安装方法很简单打开 Keil点 Pack Installer在里面找 STM32F1xx_DFP 并安装如果网络下载慢可以到 Keil 官网下载离线 pack 文件双击安装注意版本匹配 MDK。很多网盘分享的“绿色版 Keil”自带插件包新手建议直接安装官方版本省去后面一堆坑。2.2 VS Code 配置 STM32 开发环境真要折腾按这套来VS Code 本身只是一台“文字显示器”要给 STM32 用得把它武装成完整 IDE。最省事的组合是 CubeMX 生成初始化代码然后装 EIDE 扩展选中 arm-none-eabi-gcc 作为编译器。这样 VS Code 能负责编辑、编译你不需要写 Makefile 的每个规则。想要调试再装 Cortex-Debug 插件配合 ST-Link 或 OpenOCD。这里最容易出问题的就是 launch.json。最常见的配置点是可执行文件路径、芯片型号、接口类型、SVD 文件。比如你用的调试接口是 ST-Link那 config 里的device要写cortex-m3interface选swdservertype选stlink如果选了 OpenOCD还要写config路径指向你的 openocd.cfg。如果你现在刚接触我建议先忍住别急着搭这个环境。Keil 双击就能下载调试VS Code 折腾半天可能只是编辑器好看学习本身需要的核心能力不是编辑器而是调试思路。2.3 编译成功但烧录失败先查这些点烧录失败是最常见的问题而且报错信息五花八门。常见错误也无非那么几类直接按表格排查最快。错误现象常见原因解决思路J-Link 报 Target DLL has been cancelled调试器与目标板连接不稳定或者 Keil 里的调试器型号选错检查 SWDIO、SWCLK、GND、3.3V 四根线缩短杜邦线必要时降低 SWD 频率Flash Download failed - Cortex-M3Flash 下载算法没选对或芯片写保护在 Keil 的 Utilities 设置里添加 STM32F10x Med-density Flash或者先用 ST-Link Utility 整片擦除No ST-LINK detectedUSB 没识别或驱动没装换一个 USB 口重新插拔到设备管理器看 ST-Link 是否枚举成功程序下载后不运行BOOT0 跳线帽不在 0或没有复位下载后 BOOT00按一下复位键这里还要特别提醒工程路径问题。非常经典的报错长这样load d:\\stm32 prohect\\2-1 stm32工程模板\\objects\\project.axf error: fla...。这不是 Keil 不认汉字而是工程路径里有中文、空格导致编译器生成的 axf 文件路径和下载器实际访问的路径对不上。解决办法很简单把工程目录改成纯英文比如D:\stm32_projects\demo然后重新编译一次。记住不仅是工程路径电脑用户名、桌面路径、Keil 安装路径都最好不要有中文。2.4 引脚被 JTAG 占用PA15、PB3、PB4 怎么当普通 IO 用很多板子把 PA15 引出做普通 GPIO你按照 LED 那些步骤初始化电平写 0 写 1 都没反应其实是因为 STM32F103 默认把这几个引脚用作调试接口 JTAG。PA15 是 JTDIPB3 是 JTRSTPB4 是 JNTRST。要释放这些引脚必须在初始化代码里调用一个重映射函数GPIO_PinRemapConfig(GPIO_Remap_SWJ_JTAGDisable, ENABLE);这个函数的作用是“禁用 JTAG但保留 SWD”。SWD 只需要 SWDIO 和 SWCLK 两根线所以禁掉 JTAG 不影响你以后下载程序。注意不要误写成GPIO_Remap_SWJ_Disable那是把整个 SWJ 都关掉关掉之后板子就无法通过 SWD 下载了。万一真踩了坑得把 BOOT0 拉高用串口 ISP 方式先擦除 Flash才能救回来。所以用到这几个引脚时记得提前加这条语句并且先确认你的下载器是 SWD 模式而不是 JTAG 模式。这也是很多“程序用 ISP 能下载但调试器连不上”的隐藏原因之一。3. 第一个项目别只点灯GPIO、按键、定时器该怎么理解点灯确实是最简单的入门程序但真正让你理解嵌入式开发的是配套的 GPIO 模式、时钟、上拉电阻这些概念。点灯只是表象背后的外设时钟、输出模式、引脚复用这些才是重点。我们跟着把点灯、按键、PWM、延时串起来做学一个功能等于学四样效率高很多。3.1 点灯背后的 GPIO 配置推挽、开漏、复用标准库点灯的代码典型如下几乎每个教程都会写RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, GPIO_InitStructure); GPIO_SetBits(GPIOA, GPIO_Pin_0);第一行开时钟新手最容易抄漏。为什么要开时钟STM32 为了降低功耗几乎所有外设默认都关闭时钟。时钟没开的时候寄存器直接写不进去GPIO 配置完全无效。GPIO 挂在 APB2 总线上所以用RCC_APB2PeriphClockCmd。GPIO_Mode 的选择也有讲究推挽输出能主动输出高电平和低电平驱动能力强点灯、驱动继电器都用它开漏输出只能主动拉低高电平要靠外部上拉电阻适合 I2C 这种需要“线与”的总线。GPIO_Speed 并不是限制引脚输出频率而是配置输出驱动器的翻转速度和压摆率。速度设低了输出上升沿不够快速度设高了在布线不好时容易产生振铃一般点灯用 2MHz 或 50MHz 都行但要理解它不是为了“超频”。3.2 读取按键电路设计与软件消抖自己做按键模块时电路设计可以很简单一个按键一端接 GND另一端接 GPIOGPIO 到 VCC 再接一个 10kΩ 上拉电阻。平时引脚读到高电平按下按键时引脚被拉到低电平。有些开发板已经内置了上拉电阻你要先看原理图确认别重复外接。如果按键接的是内部有上拉能力的引脚用配置输入上拉GPIO_Mode_IPU就可以省掉外部电阻。软件消抖也是必须的机械按键按下去的瞬间会有几毫秒到十几毫秒的抖动直接读取会出现一次按下列出多条状态变化。常用套路是if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) 0) { DelayMs(20); if (GPIO_ReadInputDataBit(GPIOA, GPIO_Pin_0) 0) { // 按键确实按下做一次动作 } }更重要的是边沿触发逻辑。比如你想按一次按键切换一次流水灯方向如果只在 while 循环里判断“电平为低”就切换那按住不放的时候灯会疯狂来回切换。正确做法是记录上一次状态只有从“没按下”变为“按下”的瞬间才执行一次。用一句逻辑表达就是if (current 0 last 1)。很多初学者在这个地方卡很久其实不是代码难而是没有建立“电平状态”和“事件”这两个概念。3.3 定时器不是“延时器”PWM 与输入捕获很多人把定时器理解成“更准确的 delay”这样想太亏了。定时器有定时计数、输出比较、PWM、输入捕获、编码器接口等多种模式。这里用 PWM 控制 LED 呼吸灯作为入门例子顺便把定时器计算摸清楚。假设系统时钟 72MHz用 TIM2 的通道 1输出 500Hz 的 PWM代码结构是这样RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_Init(GPIOA, GPIO_InitStructure); TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_TimeBaseStructure.TIM_Prescaler 71; TIM_TimeBaseStructure.TIM_Period 1999; TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, TIM_TimeBaseStructure); TIM_OCInitTypeDef TIM_OCInitStructure; TIM_OCInitStructure.TIM_OCMode TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_Pulse 1000; TIM_OCInitStructure.TIM_OutputState TIM_OutputState_Enable; TIM_OC1Init(TIM2, TIM_OCInitStructure); TIM_Cmd(TIM2, ENABLE);为什么TIM_Prescaler71因为分频后的计数时钟是 72MHz / (711) 1MHz也就是说计数器每 1us 加一。TIM_Period1999表示计数到 1999 就溢出所以周期是 (19991) us 2ms对应 500Hz。TIM_Pulse1000表示通道输出高电平持续 1000 个计数单位也就是 1ms占空比 50%。要呼吸灯效果就在 while 循环里不断修改TIM_Pulse值并调用TIM_SetCompare1(TIM2, value)让占空比从 0 慢慢加到 100再慢慢减到 0。输入捕获模式则常用于测频率和脉宽。配置上升沿捕获后在中断里读取计数器值两次捕获的差值就是信号周期。注意处理计数器溢出不然测低频信号会得到错误结果。超声波测距正是这种思路的典型应用测出 Echo 引脚高电平持续时间就能换算距离。3.4 delay 卡死八成是时钟和中断问题“stm32 延时函数 delay 卡死”这个问题在论坛里特别常见现象是程序停在 Delay 里不返回或者延时不准确。多数情况不是 Delay 函数本身写错而是系统时钟配置出了问题。标准库例程里的 Delay 一般基于 SysTick它依赖SystemCoreClock这个全局变量来计算每次心跳的时间。如果启动文件里的 SystemInit 没有被正确调用或者外部晶振起振失败导致代码从 HSE 切换到 HSI但 SystemCoreClock 仍然按 72MHz 计算SysTick 的装载值就错了延时会偏到离谱甚至因为设置成了 0 而直接卡进 while 循环。解决思路很硬核先确认板子上 8MHz 晶振是否焊接正常再看代码里有没有调用SystemInit()不要在一个工程里混用正点原子例程的 delay.c 和 HAL 库的 HAL_Delay两者的 SysTick 处理会互相覆盖。我自己就遇到过 HAL_Delay 卡死的情况原因是 CubeMX 生成的 SysTick 回调被别人改写uwTick不再增长。解决方法是恢复 SysTick 中断处理函数或者干脆配一个独立定时器做延时这样主循环不会被阻塞也彻底避开 SysTick 的干扰。学到这里你应该明白一个“简单的延时”背后全是时钟和资源分配的问题。4. 进阶项目把板子接到外面的世界会了 GPIO、按键、定时器你就掌握了控制世界的输入输出基础。但单片机的价值往往在通信和外设扩展。下面几个方向可以按兴趣挑选每个都够你玩一个周末。串口解决调试信息485 解决工业控制超声波解决距离测量USB 和 CAN 则通向更复杂的设备互连。4.1 串口与 485/伺服电机控制调试和外设通信的基础串口 USART 是调试第一手段。标准库初始化波特率、数据位、停止位然后重定向 printf 到串口。常见做法是重写 fputc让调试信息直接输出到串口调试助手。注意如果你用了 MDK 的 MicroLIBprintf 重定向很简单如果不用 MicroLIB要处理半主机模式否则程序会卡在 printf 上。在实际项目里我还会把串口做成一个统一调试模块输出带时间戳的日志比到处放 GPIO 翻转灯来观察状态方便太多。485 控制伺服电机在工业现场很常见。RS485 是半双工差分信号传输距离远、抗干扰强需要 A/B 两根线通常还要在总线两端接 120Ω 终端电阻。控制伺服或步进驱动器往往走 Modbus RTU 协议帧结构里包含地址、功能码、寄存器地址、数据、CRC 校验。STM32 端需要一个方向控制引脚发送前拉高 DE/RE发送结束后恢复接收否则通信会互相干扰。你可以先用串口助手观察驱动器的响应再慢慢把完整协议搬到单片机上。不用自己从零写 Modbus 帧解析有不少开源库可以直接移植比如 agile_modbus 在 STM32 上就能跑省掉很组帧解析的琐碎工作。4.2 超声波测距HCSR04 与时间测量HCSR04 属于“麻雀虽小五脏俱全”的传感器能一次练到 GPIO 输出、GPIO 输入、定时器捕获、中断优先级。原理很直接给 Trig 脚一个大于 10us 的高电平模块内部发出 8 个 40kHz 超声脉冲然后 Echo 脚输出一个高电平高电平持续时间就是声波往返的时间。距离公式是距离(cm) 高电平时间(us) * 0.034 / 2。为什么要除以 2因为声波从模块到障碍物、再从障碍物回到模块走了两趟。测量 Echo 高电平时间有几种方法。最简单是while(GPIO_ReadInputDataBit()SET)加一个变量自增代码容易写但会在等待期间占着 CPU如果有其他任务就容易被拖死。更合理的是用定时器输入捕获上升沿记录第一次计数器值下降沿再记录第二次差值换算成实际时间。这里有个很容易被忽略的硬件问题HCSR04 通常 5V 供电Echo 输出的高电平也可能接近 5V。STM32F103 数据手册上大部分引脚是 5V 容忍的但为了稳妥最好在 Echo 和 GPIO 之间加一个分压电阻或者串一个 1kΩ 电阻避免长期高压影响引脚寿命。另外Trig 脉冲宽度一定要保证至少 10us很多教程用不准确的延时函数发脉冲实际只发出几百纳秒模块根本没响应这时候先拿逻辑分析仪看看波形再怀疑模块坏了。4.3 USB、CAN、LIN这些工业/消费级接口能做什么如果你想把手上的 STM32 接到电脑、手机USB 是个好方向。F103 内置 USB 2.0 FS Device可以做成自定义 HID、虚拟串口 CDC甚至模拟键盘鼠标。很多人会问 stm32 如何做 usb 设备核心链路是这样的先初始化 USB 时钟配置 PA11、PA12 复用为 USB 引脚设置 USB 中断然后启动 USB 库完成枚举枚举成功之后主机才能识别设备。F103 做 USB 时对时钟精度要求比较高最好使用外部晶振配合 PLL 输出准确的 48MHz否则电脑会一直提示“无法识别的 USB 设备”。新手可以先从官方 USB CDC 虚拟串口例程改起先让它能收发数据再研究描述符和端点配置。CAN 总线是汽车和工业控制里的常客STM32 bxCAN 支持标准帧和扩展帧需要外部收发器和 120Ω 终端电阻。很多人遇到“can 通信突然连不上”原因通常集中在波特率不匹配、总线终端电阻缺失、过滤配置错误。如果你只有一个节点想测试 CAN 收发可以用环回模式数据在内部绕一圈返回这样能确认外设本身工作是否正常。LIN 总线在汽车车身网络中很常见成本比 CAN 低配合 LIN 收发器协议更简单适合车窗、灯光等低速控制。学习这些接口有一个共同路径先看协议帧格式再用分析工具抓波形最后在自己的板子上把收发跑通。5. 遇到这些问题先查这几处“板子没反应”“下载失败”“串口乱码”“外设不工作”新手期的问题基本可以归成硬件连接、软件配置、工程管理三类。我把自己常用的排查顺序写下来你可以直接照着做。这一章没有特别高深的理论全是实际调试时最有效的动作。5.1 硬件连接排查不信玄学相信万用表遇到问题先不要改代码先用眼睛看。下载器连接顺序是不是 SWDIO、SWCLK、GND、3.3V 四根杜邦线是不是插反了板子电源灯有没有亮稳压芯片有没有发烫。发烫的常见原因是 3.3V 和 5V 短路或者芯片引脚焊接短路。用万用表蜂鸣档量一遍电源和 GND 之间有没有短路这是我每次拿到新板子的第一个动作。如果上电后系统不稳定试试外接独立 5V 电源不要完全靠下载器供电。下载器带负载能力有限当你接了舵机、蜂鸣器、大电流摄像头后电压一跌落程序就开始随机复位或者表现怪异。这种问题靠改代码永远解决不了。5.2 程序级排查善用 LED 和串口打点如果你怀疑程序没跑起来在 main 开头先翻转一个 LED。如果灯不闪说明没启动或者时钟初始化卡住。接着在关键位置加入串口打印把变量值、状态机当前状态都打出来。很多时候问题不是芯片坏了而是逻辑分支跑错了。使用 Keil 调试模式时可以看外设寄存器窗口确认 RCC 寄存器是否更新、GPIO 输出数据寄存器值是否符合预期。想观察 IO 波形但没有示波器时可以在 Keil 调试状态下打开 Logic Analyzer添加 GPIO 的 ODR 变量设置合适的显示周期能看到引脚翻转频率大概对不对。这个功能聊胜于无能帮你确认软件时序但抓串口和 PWM 波形还是建议备一个几十块钱的逻辑分析仪那是真的能看到信号很多莫名其妙的问题一眼就明白了。5.3 工程模板与版本管理别在中文路径上翻车创建新项目时不要每次从零开始配置最好先做一个标准工程模板以后复制改。工程目录放在纯英文路径下文件名不要带空格。复制模板时记得把关键文件都带走项目文件、所有 source 文件、启动文件 startup_stm32f10x_hd.s、标准库文件。如果只复制 .uvprojx 而漏了启动文件和芯片头文件编译会报一堆找不到文件的错误。建议用 Git 管理每次改动哪怕只是自己一个人开发。每个功能模块拆成一个源文件比如 key.c、usart.c、pwm.c不要在 main.c 里堆几千行代码。等以后做综合项目时你就会明白这些好习惯能省多少时间。模板越干净你后面做项目就越顺手因为每一次“编译失败”都更容易定位是代码问题还是工程配置问题。最后再给你一个实操建议如果让我给刚拿到 stm32 开发板的人定一个小目标我的建议是不要只点灯而是做一个“按键切换模式 超声波测距 串口上报 数码管或 OLED 显示”的小系统。这个系统把 GPIO 输入输出、定时器、通信都串起来了做完这一套你对 stm32 的掌握会远超“会点灯”的那批人。我当年就是从点灯跳到按键控制舵机再跳到串口和传感器联调每完成一个功能就特别有成就感。买回来的开发板不怕“吃灰”怕的是你不敢动手改例程、破坏性地实验。多试几次、多炸几次慢慢就懂透了。
阅读完成 · 觉得有帮助？
