说实话看到后台留言“看了三篇了一行都没让我写呢”我忍不住笑了。这确实是嵌入式C编程之旅前几篇最容易被吐槽的地方。回头想想前几篇确实一直在铺路搭环境、建工程、讲编译流程一点代码都没上。但嵌入式这行有个很现实的门槛——它不像Web前端打开浏览器F12就能改两行看看效果。你连工具链和芯片都还没打通就急着写代码大概率会卡在第一个报错上动弹不得。这一篇我们终于要真正落笔了目标很明确用C写出第一行能跑在STM32上的代码点亮一颗LED。这篇文章会从为什么前三篇不让你写代码讲起然后带你从硬件连接、工程配置到三条核心语句、整个while循环再到常见的排错实录把整个“编译-下载-运行”闭环完整走一遍。1. 为什么折腾了三篇才让你动手1.1 嵌入式入门和Web开发完全是两回事先说个类比在Web开发里你new一个项目脚手架自动帮你拉好依赖浏览器就是你的运行环境改一行代码刷新就能看到结果。嵌入式完全不是这套逻辑。你面对的是一个裸芯片没有操作系统帮你管理内存也没有控制台帮你打印报错甚至你写的代码能不能跑起来取决于启动文件、链接脚本、芯片型号选择、调试器连接这些“工程外围”的东西。这些环节任何一个断了你的代码再对也进不了芯片。所以前几篇花篇幅讲环境搭建、芯片支持包安装、工程模板都是在给你“磨菜刀”。很多人会觉得“我就是想写个点灯看那么细干嘛”。但实际情况是你跳过了这些直接抄代码一旦遇到问题你根本不知道是代码问题还是环境问题。比如编译通过了但烧录失败你会怀疑ST-Link坏了还是接线错了烧录成功了但灯不亮你会怀疑代码逻辑不好还是时钟没配好。我在带人的时候见过太多这种“抄代码半小时、排错一整天”的例子。前三篇不做别的就是让你把工具链和工程结构摸清楚把网上教程常常默认你“已经会了”的部分补齐。也顺便回应一下热词里那些实际需求比如“keil5兼容c51和stm32安装”“stm32芯片包安装”“vscode配置stm32开发环境”。这些确实都是嵌入式入门的高频场景。前几篇已经分别讲过Keil MDK的安装思路和VSCode作为编辑器搭配编译链的方案所以这一篇我会默认你的环境已经能编译一个空的STM32工程。如果还没准备好建议回头补补。不然这篇的代码你就算照着敲也会编译出一堆“找不到头文件”的错误那体验就很糟糕了。1.2 语言选型为什么是C而不是纯C另外还有个必须回答的问题嵌入式开发里C语言已经够通用了为什么这一系列还要用C这不是为了噱头。STM32的官方固件库和HAL库都是C写的但这不代表C没有用武之地。C的类、封装、作用域隔离、模板这些东西在工程规模变大之后非常值钱。比如说你后面要驱动多个传感器、多个外设纯C要靠命名空间前缀和一堆结构体函数指针来模拟“对象”的感觉C直接一个类就封装完了代码复用性和可读性好非常多。当然嵌入式C和桌面C不是一回事。没有STL容器可以随便用异常机制在裸机环境里默认也是关掉的new和delete要慎用。但它保留的类、继承、模板、constexpr这些特性对写驱动、写状态机、写算法来说已经非常好用了。后面几篇我会展示怎么用C封装外设驱动那个优势会比这一篇点灯更明显。点灯这个级别C和C看起来差别不大但我们要从一开始就用C的思维去组织代码而不是把C语言换个.cpp后缀就叫嵌入式C。2. 动手前坐稳硬件与软件清单2.1 硬件怎么选最便宜的板子也能学到八成东西新手入门我一般推荐STM32F103C8T6最小系统板就是俗称的“蓝药丸”或者“Blue Pill”。这板子非常便宜淘宝上一块大概十几块钱但该有的东西都有72MHz主频的Cortex-M3核心、64KB Flash、20KB RAM、一系列GPIO、USART、SPI、I2C、定时器。最重要的是它的资料量极其惊人你搜“STM32F103C8T6教程”能搜出几万条结果。哪怕你后面要做的项目根本不是这个型号学会它的套路之后换到F4、F7、H7系列也就是改改配置的事。除了板子你还需要一个ST-Link V2下载调试器几块钱到几十块钱都有。另外准备一块面包板、几根杜邦线、一颗LED灯珠颜色随意红色或蓝色比较常见、一颗330欧姆左右的电阻。接线非常简单用杜邦线把ST-Link的SWDIO接到板子的PA13SWCLK接到PA14GND接GND3.3V接3.3V。然后用另一组杜邦线从板子的PA5引脚引出串联一个330欧姆电阻再接LED的正极LED负极接板子的GND。这里电阻是为了限制电流防止LED烧坏330欧姆到1K欧姆问题都不大但别用10K以上不然你会看到LED只是微微泛光亮度非常暗。为什么选PA5因为PA5是STM32F103C8T6上最常见的板载LED引脚之一。很多最小系统板上直接焊了一个LED在PC13或者PA1上但用我们自己外接的LED更自由可以直观看到引脚定义、接线和电阻的作用。如果你手上的板子有板载LED连接在PC13那本篇代码改成配置GPIOC的引脚就行原理一模一样。2.2 软件怎么配两种流派我都用过软件方面我实测下来比较顺手的就两条路。一条路是Keil MDK搭配STM32F1系列芯片支持包。Keil的优点是编译速度快调试界面集成度高很多老工程师都在用遇到问题容易找到人问。缺点是Windows下偏多License管理有点烦人。另一条路是STM32CubeIDE加VSCode的组合。CubeIDE基于Eclipse免费跨平台STM32CubeMX图形化配置外设非常方便生成初始化代码之后你可以用VSCode打开工程目录来编辑代码。很多人在热词里搜“vscode配置stm32开发环境”“vscode stm32调试powerlink如何设置launch.json”其实都是在折腾这种方式。CubeIDE本身自带调试功能不一定要折腾VSCode的launch.json但如果你喜欢VSCode的编辑体验把编译和调试命令配进去也是可行的这个过程以后可以单独写一篇。不管是哪条路最后的效果都一样能新建一个STM32F103C8T6的工程能编译出一个hex文件能用ST-Link下载到板子上。这一篇的代码你可以直接用上面任一种工程模板来编译。如果你用的是CubeMX生成工程时不需要勾选任何中间件也不需要配置额外的时钟树直接用默认的HSI内部时钟也可以跑通。但更建议花10秒钟把时钟树切成HSE外部晶振因为后面做串口波特率、定时器定时的时候外部晶振的时间基准更准。3. 第一行代码让LED亮起来3.1 从GPIO开始先把“电”这个事想明白GPIO的全称是General Purpose Input Output通用输入输出口。你可以把它想成一排可以手动拨动的小开关每个引脚都可以配置成输出模式或输入模式。点灯用的就是输出模式。但要真正让这个开关工作你先得给这一排开关所在的电路送上电这个“送电”的动作在STM32里就是开启对应GPIO外设的时钟。很多人第一次写STM32代码会忘记这一步然后灯死活不亮急得团团转。其实芯片设计者是故意的——为了降低功耗默认情况下大部分外设的时钟都是关闭的你用到哪个外设就得先把哪个外设的时钟打开。这个心智模型一旦建立后面的串口、SPI、I2C都是同一个套路只是换了个寄存器名称而已。STM32F103的GPIO配置有两组关键寄存器CRL和CRH。CRL负责配置端口0到7号引脚的模式CRH负责配置8到15号引脚。每组寄存器里每个引脚占4位这4位里又分成MODE位和CNF位。MODE位决定输入还是输出以及输出速度CNF位决定推挽还是开漏或者复用功能。点灯最简单的方式就是设置成通用推挽输出输出速度50MHz。这里“50MHz”不是说你真的会输出那么高的频率而是表示引脚翻转能力的上限你用低速模式也照样能点亮LED只是到了后面做PWM或通信时你才会体会到速度档位的影响。3.2 三行代码点亮LED的核心逻辑先直接给出核心代码然后再逐行解释#include stm32f10x.h int main(void) { RCC-APB2ENR | RCC_APB2ENR_IOPAEN; GPIOA-CRL ~(0xF 20); GPIOA-CRL | (0x2 20); GPIOA-BRR GPIO_BRR_BR5; while(1) { } }这段代码的逻辑其实非常简单。第一行RCC-APB2ENR | RCC_APB2ENR_IOPAEN;就是打开GPIOA的时钟。RCC是Reset and Clock Control的缩写负责整个芯片的时钟管理。APB2ENR是挂在APB2总线上的外设时钟使能寄存器GPIOA恰好挂在这条总线上。IOPAEN这个宏展开之后是((uint32_t)0x00000004)对应第2位。往这一位置1GPIOA的时钟就通了。在C里这段代码和C没什么区别操作的都是同一个寄存器的地址但我建议你从一开始就养成习惯尽量用寄存器库提供的宏名而不是裸数字这样别人看代码时才不会被一串十六进制搞晕。第二段是配置PA5的模式。CRL寄存器的第20到23位正好对应第5号引脚因为每个引脚占4位5乘以4等于20。先把这4位清零然后写入0x2。0x2是通用推挽输出、速度50MHz的编码。如果你写0x3也可以那是输出速度100MHz的一种配置但在F103上推挽输出只有2MHz/10MHz/50MHz三档0x3被映射到50MHz所以很多老工程里也能看到0x3。这里最需要注意的是别把整个寄存器都赋成一个值而要用“先清零、再赋值”的套路这样不影响其他引脚的配置。第三行是点亮LED的关键让PA5输出低电平。GPIOA-BRR GPIO_BRR_BR5;中的BRR是位复位寄存器往对应位置1就能让该引脚输出低电平。为什么低电平会点亮LED因为我们把LED接在PA5和GND之间PA5输出低电平时电流从LED正端流向负端正好形成回路。如果你的LED接法是反过来的那就要用BSRR寄存器置位让引脚输出高电平才能点亮。我这里先选了低电平点亮接线图也按这个来等你自己接线时务必分清正负极。3.3 让LED呼吸起来延时与循环如果代码止步于上面那段LED只会一直亮着虽然也算成功但看起来太静态了。更直观的成就感来自闪烁。要让LED闪烁核心就一句话在循环里不停地翻转引脚状态中间夹一个等待时间。先看完整代码#include stm32f10x.h void delay_soft(volatile uint32_t count) { while(count--) { } } int main(void) { RCC-APB2ENR | RCC_APB2ENR_IOPAEN; GPIOA-CRL ~(0xF 20); GPIOA-CRL | (0x2 20); while(1) { GPIOA-BSRR GPIO_BSRR_BR5; delay_soft(7200000); GPIOA-BSRR GPIO_BSRR_BS5; delay_soft(7200000); } }这里面有意思的地方在于BSRR这个寄存器。BSRR是一个32位寄存器低16位用于置位Set高16位用于复位Reset。往低16位的对应位置1引脚输出高电平往高16位的对应位置1引脚输出低电平。也就是说往同一个寄存器里写不同的位就能同时控制若干个引脚的输出状态而且写的过程是原子性的。相比之下直接操作ODR寄存器会产生“读-改-写”三步操作如果在中断里对同一个引脚操作可能产生竞争条件。我一开始学的时候没这个概念后来做PWM和通信协议时才明白BSRR这种设计就是为了避免多任务下的竞争问题STM32每个GPIO都标配这个寄存器比单纯一个ODR灵活得多。延时函数里我用了一个volatile uint32_t count。volatile告诉编译器这个变量可能会被外部修改不要把它优化掉。否则像while(count--)这种空循环在开优化的情况下很可能被编译器整个删掉代码烧进去灯就会一直亮着不闪又或者闪烁极快到肉眼无法分辨。这个坑我在O2优化下踩过不止一次后来学乖了凡是被刻意用作延时的循环变量都加上volatile。当然真正的工程里不会用这种靠猜的软延时而是用SysTick或定时器来计时后面讲定时器时会专门展开。但作为第一次点灯软延时最直观也最容易理解“CPU在空转”这个概念。编译下载过程很简单。Keil里按F7编译如果0 error 0 warning按F8下载。CubeIDE里先锤子图标编译再点绿色虫子或下载按钮。下载完成后按下板子上的复位键正常情况下你会看到LED以大约1Hz的频率闪烁。这里的延时参数7200000在72MHz主频下大约是0.1秒级的一个循环时间因为每条指令要耗费几个时钟周期空循环还有个跳转开销所以真实延时大概在0.1秒到0.2秒之间。看着会有点闪烁感但完全能识别出来。嫌太快就把计数值加到10000000以上嫌太慢就往下减通过这个调参过程你会对手里的芯片主频有一个体感认知。4. 从单文件到小工程用C组织代码4.1 为什么要把代码拆开上一篇我们那些代码全塞在main.cpp里足够写“Hello World”了但如果一直这么干代码很快就会膨胀成一个大杂烩。点灯只是一个GPIO外设的初始化翻转要是你后面同时操作按键、OLED屏、超声波传感器谁都能想象main.cpp会变成什么惨状。所以从这一篇开始我们要养成“外设驱动模块化”的习惯这也是C真正发挥优势的地方。我们可以把LED相关的操作封装成一个简单的类。头文件led.h这样写#ifndef LED_H #define LED_H #include stm32f10x.h class Led { public: Led(GPIO_TypeDef* port, uint16_t pin); void on(); void off(); void toggle(); private: GPIO_TypeDef* _port; uint16_t _pin; }; #endif然后led.cpp实现这些方法#include led.h Led::Led(GPIO_TypeDef* port, uint16_t pin) : _port(port), _pin(pin) { } void Led::on() { _port-BSRR _pin; } void Led::off() { _port-BSRR static_castuint16_t(_pin 16); } void Led::toggle() { if (_port-ODR _pin) { _port-BRR _pin; } else { _port-BSRR _pin; } }这里有个小细节off()里用了_pin 16把低16位的引脚编号移到高16位这样正好落在BSRR寄存器的复位区内。但注意要把这个结果转换成uint16_t或者直接用uint32_t运算因为_pin本身是16位的左移16位可能溢出。实际在C里移位操作发生在int提升之后所以_pin 16在32位环境下是OK的但养成显式处理位宽的习惯更稳妥。你还可以在构造函数里顺带完成GPIO时钟使能和模式配置不过那样Led类就要知道RCC和CRL这些细节耦合度稍高。我倾向于让外部先把引脚初始化做好Led类只负责“高电平、低电平、翻转”这些控制操作职责单一。main.cpp就用这个类来点灯#include led.h void delay_soft(volatile uint32_t count) { while(count--) { } } int main(void) { RCC-APB2ENR | RCC_APB2ENR_IOPAEN; GPIOA-CRL ~(0xF 20); GPIOA-CRL | (0x2 20); Led led(GPIOA, GPIO_Pin_5); while(1) { led.toggle(); delay_soft(7200000); } }对比一下第一篇的所有代码你会发现main.cpp清爽很多。后面如果要加一个按键控制你就再写个Button类要加一个蜂鸣器就再写个Buzzer类。每个文件只关心自己的外设出了问题直接打开对应文件排查不用在几千行的main.cpp里大海捞针。这就是封装的意义C的class在这里不是花架子而是实打实的工程组织工具。4.2 编译优化、链接脚本与资源约束很多新手写完代码后发现一个诡异现象同样的代码Debug模式下闪烁正常Release模式下灯常亮。这通常是编译器优化造成的。前面说过软延时循环里的计数变量如果没有volatile-O2下可能被直接优化掉整个循环消失。另外你向GPIO-BSRR连续写同一个引脚编译器也可能认为“这是重复的语句”把中间的操作合并掉导致引脚只翻转了一次。解决办法除了加volatile还可以用内嵌汇编或者直接改用SysTick硬件定时器。这也是我强烈建议你尽早告别软延时、转到硬件定时器的原因。说到编译优化就绕不开链接脚本和资源约束。STM32F103C8T6的Flash是64KBRAM是20KB。一个空工程大概占多少编译器生成的map文件里写得很清楚。在Keil里编译后点“Browse Information”或者在工程目录下找.map文件能看到各段的大小text段代码、data段初始化数据、bss段未初始化数据。我试过一个LED类加上main函数Flash占用还不到2KBRAM占用几乎可以忽略。这看似很宽裕但如果你后面用STL容器、异常处理、模板元编程Flash占用会急剧膨胀。嵌入式C有一条不成文的规矩能用值传递就别用动态分配能在上电时静态分配就别运行时new能不用异常就不用异常。不是因为“嵌入式就该这样”而是资源真的有限而且很多MCU的异常处理实现会直接拖慢中断响应。在编译优化级别上我的个人经验是调试阶段用-O0发布阶段用-O2。但-O2之后要重点检查延时、打印、协议栈这类对时序敏感的代码。有些bug在-O0下完全不存在一开-O2就出现这种问题大部分是未定义行为或寄存器操作被编译器重排排查起来非常头疼。所以从一开始写寄存器操作时遇到那种“不应该被随便改动顺序”的代码可以考虑把指针或寄存器地址声明为volatile指针比如volatile GPIO_TypeDef*这样编译器就不会对相关语句做激进重排。5. 排错实录LED不亮我建议你按这个顺序查5.1 常见问题速查表点灯这个实验看起来简单但实际带人时发现卡住的环节五花八门。我把最常见的问题整理成一个表你如果照做完没亮按这个顺序排查基本能找到病根。现象可能原因排查顺序编译报错“找不到stm32f10x.h”芯片支持包没装或工程没选对芯片型号检查Keil的Pack Installer里有没有STM32F1系列CubeIDE的工程是否选了F103C8烧录失败“No target connected”ST-Link接线反了、驱动问题、板子没供电优先交换SWDIO和SWCLK试一次检查驱动管理器按住板子复位键再试烧录报了成功但LED不亮接线错误、电阻太大、时钟没使能、引脚配置错先用手摸或万用表确认PA5是否有电压变化再检查RCC那行是否漏了LED常亮不闪延时被优化、没进while循环、晶振配置问题检查delay参数是否加了volatile用Flash全擦后重新下载一上电就发热或冒烟正负极接反、没接限流电阻立即断电检查接线绝对不要给板子反接电源这个表没法覆盖所有情况但90%的新手问题落在里面。我特别想强调一点如果你的LED接法错误比如正极直接接GND、负极接PA5那高电平逻辑就反了。别人点灯是输出高电平亮你是输出低电平亮代码完全相反。这时候不要硬背“大灯接高电平还是低电平”而是顺着电流回路理一遍LED两端只要有电压差电流就能流过它就亮。理解这个比记住接线图重要得多。5.2 我踩过的三个坑第一是ST-Link接线。第一次用杜邦线连接ST-Link和板子我把SWDIO和SWCLK插反了结果Keil一直提示“No target connected”。我当时还以为是驱动问题重装了驱动、重启了电脑折腾了一个多小时才发现只是两根线插反了。从那以后我每次接线都先拍一张照片对照原理图确认一遍再上电。SWD只需要GND、SWDIO、SWCLK三根线就能下载调试3.3V可以不接因为很多开发板会自己供电但如果你用外部供电电源共地是必须的。第二是电阻选太大。第一次点灯我手边没有330欧姆的电阻随手拿了颗10K的用LED确实亮了但亮度非常弱在稍微亮一点的房间里根本看不出来。我一度怀疑是代码有问题反复检查寄存器配置后来换了颗1K的电阻亮度立刻正常。这里也提醒一下LED限流电阻不是随便选的。普通LED正向压降大约2V工作电流5mA到20mA电阻的选择就是要让电流落在合适范围。3.3V出去减去2V压降剩1.3V加在电阻上如果电流想控制在5mA左右电阻就是1.3V除以5mA约260欧姆所以330欧姆很合适。有人会说“那我用10K省电不是更好”但亮度太低会直接影响调试观察没必要为了省那么点电流给自己添堵。第三是-O2优化把延时优化掉了。这个前面提过是我在切换到Release模式时踩的坑。灯不闪了我还怀疑是芯片坏了后来在代码里加了volatile之后恢复正常。这件事给我一个很深的教训在嵌入式里写代码编译器优化不是“顺便开一下就行”它是程序行为的一部分。你写每一条语句都要清楚它在不同优化级别下可能会被怎么处理。很多C语言教程从没说过volatile但它恰恰是嵌入式C/C最频繁用到的关键字之一不是面试八股是保命用的。5.3 万用表和示波器要不要买排错的时候有个趁手工具会事半功倍。万用表是嵌入式入门最值得投资的工具之一二三十块钱的就能用。量一下PA5对GND的电压代码里输出高电平时应该是3.3V左右输出低电平时接近0V。这个测量能立刻告诉你到底是硬件问题还是软件问题。如果是0V恒定不变可能是引脚配置错了如果是3.3V恒定不变可能是BSRR写反了或者程序没跑起来。示波器更直观但在点灯这个阶段不是必须的等你后面调UART波特率、I2C时序时再考虑。6. 点亮之后你手里有什么每次帮别人点亮第一颗LED我都会问一句你刚才到底做了哪些事很多人说“写了几行代码点了个灯”。其实远远不止。你把STM32的时钟树打开了一个分支你配置了一个GPIO引脚的电气模式你往一个特定地址写入了特定数值你经历了编译、链接、下载、复位的完整流程你在一个没有操作系统的裸芯片上让代码真正“跑”了起来。这一整套流程比“LED亮了”这个结果重要得多。后面做串口、定时器、中断甚至跑RTOS底层都是这些你已经验证过的东西。从这一步往后学习路线就比较清晰了。先是把串口打通用printf往PC上打印调试信息这会让你的排错能力提升一大截然后试一下SysTick定时器做精准延时再尝试定时器PWM输出控制LED亮度感受呼吸灯效果接着可以接一个按键用外部中断检测输入体会中断响应的时序概念。等你把这些基础外设都过了一遍你就会发现网上那些项目比如超声波测距、OLED显示屏菜单、报站器其实都是这些外设的组合应用代码量未必有多大但每一条你都能看懂为什么这么写。最后分享一个我自己的体会点灯这个实验我第一次做的时候卡了整整三天不是代码难而是那时候没人告诉我ST-Link还要接GND共地。三天里我把寄存器改来改去始终以为是软件问题。后来无意中接上地线灯亮了的一瞬间我感觉不是LED亮了而是整个嵌入式世界的大门向我打开了。希望这篇能帮你少走一点我当年走过的弯路顺利把第一行代码真正写进芯片里。
STM32嵌入式C++点灯实战：从环境配置到GPIO控制
说实话看到后台留言“看了三篇了一行都没让我写呢”我忍不住笑了。这确实是嵌入式C编程之旅前几篇最容易被吐槽的地方。回头想想前几篇确实一直在铺路搭环境、建工程、讲编译流程一点代码都没上。但嵌入式这行有个很现实的门槛——它不像Web前端打开浏览器F12就能改两行看看效果。你连工具链和芯片都还没打通就急着写代码大概率会卡在第一个报错上动弹不得。这一篇我们终于要真正落笔了目标很明确用C写出第一行能跑在STM32上的代码点亮一颗LED。这篇文章会从为什么前三篇不让你写代码讲起然后带你从硬件连接、工程配置到三条核心语句、整个while循环再到常见的排错实录把整个“编译-下载-运行”闭环完整走一遍。1. 为什么折腾了三篇才让你动手1.1 嵌入式入门和Web开发完全是两回事先说个类比在Web开发里你new一个项目脚手架自动帮你拉好依赖浏览器就是你的运行环境改一行代码刷新就能看到结果。嵌入式完全不是这套逻辑。你面对的是一个裸芯片没有操作系统帮你管理内存也没有控制台帮你打印报错甚至你写的代码能不能跑起来取决于启动文件、链接脚本、芯片型号选择、调试器连接这些“工程外围”的东西。这些环节任何一个断了你的代码再对也进不了芯片。所以前几篇花篇幅讲环境搭建、芯片支持包安装、工程模板都是在给你“磨菜刀”。很多人会觉得“我就是想写个点灯看那么细干嘛”。但实际情况是你跳过了这些直接抄代码一旦遇到问题你根本不知道是代码问题还是环境问题。比如编译通过了但烧录失败你会怀疑ST-Link坏了还是接线错了烧录成功了但灯不亮你会怀疑代码逻辑不好还是时钟没配好。我在带人的时候见过太多这种“抄代码半小时、排错一整天”的例子。前三篇不做别的就是让你把工具链和工程结构摸清楚把网上教程常常默认你“已经会了”的部分补齐。也顺便回应一下热词里那些实际需求比如“keil5兼容c51和stm32安装”“stm32芯片包安装”“vscode配置stm32开发环境”。这些确实都是嵌入式入门的高频场景。前几篇已经分别讲过Keil MDK的安装思路和VSCode作为编辑器搭配编译链的方案所以这一篇我会默认你的环境已经能编译一个空的STM32工程。如果还没准备好建议回头补补。不然这篇的代码你就算照着敲也会编译出一堆“找不到头文件”的错误那体验就很糟糕了。1.2 语言选型为什么是C而不是纯C另外还有个必须回答的问题嵌入式开发里C语言已经够通用了为什么这一系列还要用C这不是为了噱头。STM32的官方固件库和HAL库都是C写的但这不代表C没有用武之地。C的类、封装、作用域隔离、模板这些东西在工程规模变大之后非常值钱。比如说你后面要驱动多个传感器、多个外设纯C要靠命名空间前缀和一堆结构体函数指针来模拟“对象”的感觉C直接一个类就封装完了代码复用性和可读性好非常多。当然嵌入式C和桌面C不是一回事。没有STL容器可以随便用异常机制在裸机环境里默认也是关掉的new和delete要慎用。但它保留的类、继承、模板、constexpr这些特性对写驱动、写状态机、写算法来说已经非常好用了。后面几篇我会展示怎么用C封装外设驱动那个优势会比这一篇点灯更明显。点灯这个级别C和C看起来差别不大但我们要从一开始就用C的思维去组织代码而不是把C语言换个.cpp后缀就叫嵌入式C。2. 动手前坐稳硬件与软件清单2.1 硬件怎么选最便宜的板子也能学到八成东西新手入门我一般推荐STM32F103C8T6最小系统板就是俗称的“蓝药丸”或者“Blue Pill”。这板子非常便宜淘宝上一块大概十几块钱但该有的东西都有72MHz主频的Cortex-M3核心、64KB Flash、20KB RAM、一系列GPIO、USART、SPI、I2C、定时器。最重要的是它的资料量极其惊人你搜“STM32F103C8T6教程”能搜出几万条结果。哪怕你后面要做的项目根本不是这个型号学会它的套路之后换到F4、F7、H7系列也就是改改配置的事。除了板子你还需要一个ST-Link V2下载调试器几块钱到几十块钱都有。另外准备一块面包板、几根杜邦线、一颗LED灯珠颜色随意红色或蓝色比较常见、一颗330欧姆左右的电阻。接线非常简单用杜邦线把ST-Link的SWDIO接到板子的PA13SWCLK接到PA14GND接GND3.3V接3.3V。然后用另一组杜邦线从板子的PA5引脚引出串联一个330欧姆电阻再接LED的正极LED负极接板子的GND。这里电阻是为了限制电流防止LED烧坏330欧姆到1K欧姆问题都不大但别用10K以上不然你会看到LED只是微微泛光亮度非常暗。为什么选PA5因为PA5是STM32F103C8T6上最常见的板载LED引脚之一。很多最小系统板上直接焊了一个LED在PC13或者PA1上但用我们自己外接的LED更自由可以直观看到引脚定义、接线和电阻的作用。如果你手上的板子有板载LED连接在PC13那本篇代码改成配置GPIOC的引脚就行原理一模一样。2.2 软件怎么配两种流派我都用过软件方面我实测下来比较顺手的就两条路。一条路是Keil MDK搭配STM32F1系列芯片支持包。Keil的优点是编译速度快调试界面集成度高很多老工程师都在用遇到问题容易找到人问。缺点是Windows下偏多License管理有点烦人。另一条路是STM32CubeIDE加VSCode的组合。CubeIDE基于Eclipse免费跨平台STM32CubeMX图形化配置外设非常方便生成初始化代码之后你可以用VSCode打开工程目录来编辑代码。很多人在热词里搜“vscode配置stm32开发环境”“vscode stm32调试powerlink如何设置launch.json”其实都是在折腾这种方式。CubeIDE本身自带调试功能不一定要折腾VSCode的launch.json但如果你喜欢VSCode的编辑体验把编译和调试命令配进去也是可行的这个过程以后可以单独写一篇。不管是哪条路最后的效果都一样能新建一个STM32F103C8T6的工程能编译出一个hex文件能用ST-Link下载到板子上。这一篇的代码你可以直接用上面任一种工程模板来编译。如果你用的是CubeMX生成工程时不需要勾选任何中间件也不需要配置额外的时钟树直接用默认的HSI内部时钟也可以跑通。但更建议花10秒钟把时钟树切成HSE外部晶振因为后面做串口波特率、定时器定时的时候外部晶振的时间基准更准。3. 第一行代码让LED亮起来3.1 从GPIO开始先把“电”这个事想明白GPIO的全称是General Purpose Input Output通用输入输出口。你可以把它想成一排可以手动拨动的小开关每个引脚都可以配置成输出模式或输入模式。点灯用的就是输出模式。但要真正让这个开关工作你先得给这一排开关所在的电路送上电这个“送电”的动作在STM32里就是开启对应GPIO外设的时钟。很多人第一次写STM32代码会忘记这一步然后灯死活不亮急得团团转。其实芯片设计者是故意的——为了降低功耗默认情况下大部分外设的时钟都是关闭的你用到哪个外设就得先把哪个外设的时钟打开。这个心智模型一旦建立后面的串口、SPI、I2C都是同一个套路只是换了个寄存器名称而已。STM32F103的GPIO配置有两组关键寄存器CRL和CRH。CRL负责配置端口0到7号引脚的模式CRH负责配置8到15号引脚。每组寄存器里每个引脚占4位这4位里又分成MODE位和CNF位。MODE位决定输入还是输出以及输出速度CNF位决定推挽还是开漏或者复用功能。点灯最简单的方式就是设置成通用推挽输出输出速度50MHz。这里“50MHz”不是说你真的会输出那么高的频率而是表示引脚翻转能力的上限你用低速模式也照样能点亮LED只是到了后面做PWM或通信时你才会体会到速度档位的影响。3.2 三行代码点亮LED的核心逻辑先直接给出核心代码然后再逐行解释#include stm32f10x.h int main(void) { RCC-APB2ENR | RCC_APB2ENR_IOPAEN; GPIOA-CRL ~(0xF 20); GPIOA-CRL | (0x2 20); GPIOA-BRR GPIO_BRR_BR5; while(1) { } }这段代码的逻辑其实非常简单。第一行RCC-APB2ENR | RCC_APB2ENR_IOPAEN;就是打开GPIOA的时钟。RCC是Reset and Clock Control的缩写负责整个芯片的时钟管理。APB2ENR是挂在APB2总线上的外设时钟使能寄存器GPIOA恰好挂在这条总线上。IOPAEN这个宏展开之后是((uint32_t)0x00000004)对应第2位。往这一位置1GPIOA的时钟就通了。在C里这段代码和C没什么区别操作的都是同一个寄存器的地址但我建议你从一开始就养成习惯尽量用寄存器库提供的宏名而不是裸数字这样别人看代码时才不会被一串十六进制搞晕。第二段是配置PA5的模式。CRL寄存器的第20到23位正好对应第5号引脚因为每个引脚占4位5乘以4等于20。先把这4位清零然后写入0x2。0x2是通用推挽输出、速度50MHz的编码。如果你写0x3也可以那是输出速度100MHz的一种配置但在F103上推挽输出只有2MHz/10MHz/50MHz三档0x3被映射到50MHz所以很多老工程里也能看到0x3。这里最需要注意的是别把整个寄存器都赋成一个值而要用“先清零、再赋值”的套路这样不影响其他引脚的配置。第三行是点亮LED的关键让PA5输出低电平。GPIOA-BRR GPIO_BRR_BR5;中的BRR是位复位寄存器往对应位置1就能让该引脚输出低电平。为什么低电平会点亮LED因为我们把LED接在PA5和GND之间PA5输出低电平时电流从LED正端流向负端正好形成回路。如果你的LED接法是反过来的那就要用BSRR寄存器置位让引脚输出高电平才能点亮。我这里先选了低电平点亮接线图也按这个来等你自己接线时务必分清正负极。3.3 让LED呼吸起来延时与循环如果代码止步于上面那段LED只会一直亮着虽然也算成功但看起来太静态了。更直观的成就感来自闪烁。要让LED闪烁核心就一句话在循环里不停地翻转引脚状态中间夹一个等待时间。先看完整代码#include stm32f10x.h void delay_soft(volatile uint32_t count) { while(count--) { } } int main(void) { RCC-APB2ENR | RCC_APB2ENR_IOPAEN; GPIOA-CRL ~(0xF 20); GPIOA-CRL | (0x2 20); while(1) { GPIOA-BSRR GPIO_BSRR_BR5; delay_soft(7200000); GPIOA-BSRR GPIO_BSRR_BS5; delay_soft(7200000); } }这里面有意思的地方在于BSRR这个寄存器。BSRR是一个32位寄存器低16位用于置位Set高16位用于复位Reset。往低16位的对应位置1引脚输出高电平往高16位的对应位置1引脚输出低电平。也就是说往同一个寄存器里写不同的位就能同时控制若干个引脚的输出状态而且写的过程是原子性的。相比之下直接操作ODR寄存器会产生“读-改-写”三步操作如果在中断里对同一个引脚操作可能产生竞争条件。我一开始学的时候没这个概念后来做PWM和通信协议时才明白BSRR这种设计就是为了避免多任务下的竞争问题STM32每个GPIO都标配这个寄存器比单纯一个ODR灵活得多。延时函数里我用了一个volatile uint32_t count。volatile告诉编译器这个变量可能会被外部修改不要把它优化掉。否则像while(count--)这种空循环在开优化的情况下很可能被编译器整个删掉代码烧进去灯就会一直亮着不闪又或者闪烁极快到肉眼无法分辨。这个坑我在O2优化下踩过不止一次后来学乖了凡是被刻意用作延时的循环变量都加上volatile。当然真正的工程里不会用这种靠猜的软延时而是用SysTick或定时器来计时后面讲定时器时会专门展开。但作为第一次点灯软延时最直观也最容易理解“CPU在空转”这个概念。编译下载过程很简单。Keil里按F7编译如果0 error 0 warning按F8下载。CubeIDE里先锤子图标编译再点绿色虫子或下载按钮。下载完成后按下板子上的复位键正常情况下你会看到LED以大约1Hz的频率闪烁。这里的延时参数7200000在72MHz主频下大约是0.1秒级的一个循环时间因为每条指令要耗费几个时钟周期空循环还有个跳转开销所以真实延时大概在0.1秒到0.2秒之间。看着会有点闪烁感但完全能识别出来。嫌太快就把计数值加到10000000以上嫌太慢就往下减通过这个调参过程你会对手里的芯片主频有一个体感认知。4. 从单文件到小工程用C组织代码4.1 为什么要把代码拆开上一篇我们那些代码全塞在main.cpp里足够写“Hello World”了但如果一直这么干代码很快就会膨胀成一个大杂烩。点灯只是一个GPIO外设的初始化翻转要是你后面同时操作按键、OLED屏、超声波传感器谁都能想象main.cpp会变成什么惨状。所以从这一篇开始我们要养成“外设驱动模块化”的习惯这也是C真正发挥优势的地方。我们可以把LED相关的操作封装成一个简单的类。头文件led.h这样写#ifndef LED_H #define LED_H #include stm32f10x.h class Led { public: Led(GPIO_TypeDef* port, uint16_t pin); void on(); void off(); void toggle(); private: GPIO_TypeDef* _port; uint16_t _pin; }; #endif然后led.cpp实现这些方法#include led.h Led::Led(GPIO_TypeDef* port, uint16_t pin) : _port(port), _pin(pin) { } void Led::on() { _port-BSRR _pin; } void Led::off() { _port-BSRR static_castuint16_t(_pin 16); } void Led::toggle() { if (_port-ODR _pin) { _port-BRR _pin; } else { _port-BSRR _pin; } }这里有个小细节off()里用了_pin 16把低16位的引脚编号移到高16位这样正好落在BSRR寄存器的复位区内。但注意要把这个结果转换成uint16_t或者直接用uint32_t运算因为_pin本身是16位的左移16位可能溢出。实际在C里移位操作发生在int提升之后所以_pin 16在32位环境下是OK的但养成显式处理位宽的习惯更稳妥。你还可以在构造函数里顺带完成GPIO时钟使能和模式配置不过那样Led类就要知道RCC和CRL这些细节耦合度稍高。我倾向于让外部先把引脚初始化做好Led类只负责“高电平、低电平、翻转”这些控制操作职责单一。main.cpp就用这个类来点灯#include led.h void delay_soft(volatile uint32_t count) { while(count--) { } } int main(void) { RCC-APB2ENR | RCC_APB2ENR_IOPAEN; GPIOA-CRL ~(0xF 20); GPIOA-CRL | (0x2 20); Led led(GPIOA, GPIO_Pin_5); while(1) { led.toggle(); delay_soft(7200000); } }对比一下第一篇的所有代码你会发现main.cpp清爽很多。后面如果要加一个按键控制你就再写个Button类要加一个蜂鸣器就再写个Buzzer类。每个文件只关心自己的外设出了问题直接打开对应文件排查不用在几千行的main.cpp里大海捞针。这就是封装的意义C的class在这里不是花架子而是实打实的工程组织工具。4.2 编译优化、链接脚本与资源约束很多新手写完代码后发现一个诡异现象同样的代码Debug模式下闪烁正常Release模式下灯常亮。这通常是编译器优化造成的。前面说过软延时循环里的计数变量如果没有volatile-O2下可能被直接优化掉整个循环消失。另外你向GPIO-BSRR连续写同一个引脚编译器也可能认为“这是重复的语句”把中间的操作合并掉导致引脚只翻转了一次。解决办法除了加volatile还可以用内嵌汇编或者直接改用SysTick硬件定时器。这也是我强烈建议你尽早告别软延时、转到硬件定时器的原因。说到编译优化就绕不开链接脚本和资源约束。STM32F103C8T6的Flash是64KBRAM是20KB。一个空工程大概占多少编译器生成的map文件里写得很清楚。在Keil里编译后点“Browse Information”或者在工程目录下找.map文件能看到各段的大小text段代码、data段初始化数据、bss段未初始化数据。我试过一个LED类加上main函数Flash占用还不到2KBRAM占用几乎可以忽略。这看似很宽裕但如果你后面用STL容器、异常处理、模板元编程Flash占用会急剧膨胀。嵌入式C有一条不成文的规矩能用值传递就别用动态分配能在上电时静态分配就别运行时new能不用异常就不用异常。不是因为“嵌入式就该这样”而是资源真的有限而且很多MCU的异常处理实现会直接拖慢中断响应。在编译优化级别上我的个人经验是调试阶段用-O0发布阶段用-O2。但-O2之后要重点检查延时、打印、协议栈这类对时序敏感的代码。有些bug在-O0下完全不存在一开-O2就出现这种问题大部分是未定义行为或寄存器操作被编译器重排排查起来非常头疼。所以从一开始写寄存器操作时遇到那种“不应该被随便改动顺序”的代码可以考虑把指针或寄存器地址声明为volatile指针比如volatile GPIO_TypeDef*这样编译器就不会对相关语句做激进重排。5. 排错实录LED不亮我建议你按这个顺序查5.1 常见问题速查表点灯这个实验看起来简单但实际带人时发现卡住的环节五花八门。我把最常见的问题整理成一个表你如果照做完没亮按这个顺序排查基本能找到病根。现象可能原因排查顺序编译报错“找不到stm32f10x.h”芯片支持包没装或工程没选对芯片型号检查Keil的Pack Installer里有没有STM32F1系列CubeIDE的工程是否选了F103C8烧录失败“No target connected”ST-Link接线反了、驱动问题、板子没供电优先交换SWDIO和SWCLK试一次检查驱动管理器按住板子复位键再试烧录报了成功但LED不亮接线错误、电阻太大、时钟没使能、引脚配置错先用手摸或万用表确认PA5是否有电压变化再检查RCC那行是否漏了LED常亮不闪延时被优化、没进while循环、晶振配置问题检查delay参数是否加了volatile用Flash全擦后重新下载一上电就发热或冒烟正负极接反、没接限流电阻立即断电检查接线绝对不要给板子反接电源这个表没法覆盖所有情况但90%的新手问题落在里面。我特别想强调一点如果你的LED接法错误比如正极直接接GND、负极接PA5那高电平逻辑就反了。别人点灯是输出高电平亮你是输出低电平亮代码完全相反。这时候不要硬背“大灯接高电平还是低电平”而是顺着电流回路理一遍LED两端只要有电压差电流就能流过它就亮。理解这个比记住接线图重要得多。5.2 我踩过的三个坑第一是ST-Link接线。第一次用杜邦线连接ST-Link和板子我把SWDIO和SWCLK插反了结果Keil一直提示“No target connected”。我当时还以为是驱动问题重装了驱动、重启了电脑折腾了一个多小时才发现只是两根线插反了。从那以后我每次接线都先拍一张照片对照原理图确认一遍再上电。SWD只需要GND、SWDIO、SWCLK三根线就能下载调试3.3V可以不接因为很多开发板会自己供电但如果你用外部供电电源共地是必须的。第二是电阻选太大。第一次点灯我手边没有330欧姆的电阻随手拿了颗10K的用LED确实亮了但亮度非常弱在稍微亮一点的房间里根本看不出来。我一度怀疑是代码有问题反复检查寄存器配置后来换了颗1K的电阻亮度立刻正常。这里也提醒一下LED限流电阻不是随便选的。普通LED正向压降大约2V工作电流5mA到20mA电阻的选择就是要让电流落在合适范围。3.3V出去减去2V压降剩1.3V加在电阻上如果电流想控制在5mA左右电阻就是1.3V除以5mA约260欧姆所以330欧姆很合适。有人会说“那我用10K省电不是更好”但亮度太低会直接影响调试观察没必要为了省那么点电流给自己添堵。第三是-O2优化把延时优化掉了。这个前面提过是我在切换到Release模式时踩的坑。灯不闪了我还怀疑是芯片坏了后来在代码里加了volatile之后恢复正常。这件事给我一个很深的教训在嵌入式里写代码编译器优化不是“顺便开一下就行”它是程序行为的一部分。你写每一条语句都要清楚它在不同优化级别下可能会被怎么处理。很多C语言教程从没说过volatile但它恰恰是嵌入式C/C最频繁用到的关键字之一不是面试八股是保命用的。5.3 万用表和示波器要不要买排错的时候有个趁手工具会事半功倍。万用表是嵌入式入门最值得投资的工具之一二三十块钱的就能用。量一下PA5对GND的电压代码里输出高电平时应该是3.3V左右输出低电平时接近0V。这个测量能立刻告诉你到底是硬件问题还是软件问题。如果是0V恒定不变可能是引脚配置错了如果是3.3V恒定不变可能是BSRR写反了或者程序没跑起来。示波器更直观但在点灯这个阶段不是必须的等你后面调UART波特率、I2C时序时再考虑。6. 点亮之后你手里有什么每次帮别人点亮第一颗LED我都会问一句你刚才到底做了哪些事很多人说“写了几行代码点了个灯”。其实远远不止。你把STM32的时钟树打开了一个分支你配置了一个GPIO引脚的电气模式你往一个特定地址写入了特定数值你经历了编译、链接、下载、复位的完整流程你在一个没有操作系统的裸芯片上让代码真正“跑”了起来。这一整套流程比“LED亮了”这个结果重要得多。后面做串口、定时器、中断甚至跑RTOS底层都是这些你已经验证过的东西。从这一步往后学习路线就比较清晰了。先是把串口打通用printf往PC上打印调试信息这会让你的排错能力提升一大截然后试一下SysTick定时器做精准延时再尝试定时器PWM输出控制LED亮度感受呼吸灯效果接着可以接一个按键用外部中断检测输入体会中断响应的时序概念。等你把这些基础外设都过了一遍你就会发现网上那些项目比如超声波测距、OLED显示屏菜单、报站器其实都是这些外设的组合应用代码量未必有多大但每一条你都能看懂为什么这么写。最后分享一个我自己的体会点灯这个实验我第一次做的时候卡了整整三天不是代码难而是那时候没人告诉我ST-Link还要接GND共地。三天里我把寄存器改来改去始终以为是软件问题。后来无意中接上地线灯亮了的一瞬间我感觉不是LED亮了而是整个嵌入式世界的大门向我打开了。希望这篇能帮你少走一点我当年走过的弯路顺利把第一行代码真正写进芯片里。
