STM32F103C8T6入门实战：从零搭建LED闪烁工程

张

张建站

2026/6/4 7:37:52

10分钟阅读

1. 环境准备搭建STM32开发环境第一次接触STM32开发板时我也被各种专业术语和工具链搞得晕头转向。但实际动手后发现只要按照正确步骤操作点亮LED灯其实并不复杂。我们先从最基础的环境搭建开始。STM32F103C8T6这款开发板俗称蓝板是性价比极高的入门选择。它采用ARM Cortex-M3内核主频72MHz内置64KB Flash和20KB SRAM完全能满足初学者需求。我建议新手直接使用Keil MDK作为开发环境虽然它需要注册但官方提供了32KB代码限制的免费版本对入门项目完全够用。安装Keil MDK时有个小技巧先安装Keil软件再单独安装STM32的设备支持包。这样能避免自动安装时网络问题导致的失败。我实测发现国内网络环境下分步安装成功率更高。设备支持包可以在Keil官网搜索STM32F1xx_DFP下载最新版本。硬件连接也很简单用USB转TTL模块连接开发板的PA9(TX)和PA10(RX)引脚注意交叉连接TX接RXRX接TX。供电可以用USB转TTL的5V输出或者直接用Micro USB接口供电。我第一次使用时犯了个低级错误把3.3V当成了5V接口导致板子无法正常工作大家一定要注意电压匹配。2. 工程创建从空白到完整项目框架打开Keil MDK后点击Project→New μVision Project选择一个空文件夹作为工程目录。这里有个关键点路径不要包含中文和空格否则后期可能出现各种奇怪问题。我习惯在D盘根目录创建STM32_Projects文件夹专门存放工程文件。选择设备型号时在搜索框输入STM32F103C8T6注意要选对后缀。我曾经因为选了STM32F103C8型号导致后续编译出错花了半天时间排查。创建工程后会弹出运行时环境管理窗口这里需要勾选CMSIS下的COREDevice下的StartupSTM32F1xx_StdPeriph_Drivers下的GPIO和RCC接下来创建工程目录结构。我推荐采用这样的组织方式/CMSIS存放核心系统文件/StdPeriph_Driver存放标准外设库/User存放用户代码/Project存放工程文件/Output存放编译输出文件在User文件夹下创建main.c文件时建议先添加基础框架代码#include stm32f10x.h int main(void) { while(1) { // 主循环 } }这个最小框架能确保工程可以正常编译。记得在工程选项的C/C选项卡中添加预定义宏USE_STDPERIPH_DRIVER,STM32F10X_MD并设置正确的头文件包含路径。3. LED硬件电路与GPIO配置STM32F103C8T6开发板通常自带一个用户LED连接在PC13引脚上。我们先要理解LED的驱动原理当PC13输出低电平时LED两端形成电压差而发光输出高电平时LED熄灭。有些开发板设计相反具体要看原理图。配置GPIO需要几个关键步骤使能GPIOC时钟通过RCC_APB2PeriphClockCmd函数初始化GPIO参数设置模式、速度等调用GPIO_Init完成配置这里有个实用技巧使用位带操作可以更直观地控制LED。STM32的位带特性允许我们像操作布尔变量一样操作单个IO口。在头文件中添加以下宏定义#define LED_PORT GPIOC #define LED_PIN GPIO_Pin_13 #define LED_SET() GPIO_SetBits(LED_PORT, LED_PIN) #define LED_RESET() GPIO_ResetBits(LED_PORT, LED_PIN) #define LED_TOGGLE() GPIO_WriteBit(LED_PORT, LED_PIN, \ (BitAction)(1 - GPIO_ReadOutputDataBit(LED_PORT, LED_PIN)))完整的LED初始化函数应该这样写void LED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin LED_PIN; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(LED_PORT, GPIO_InitStructure); LED_SET(); // 初始状态熄灭 }4. 实现LED闪烁的多种方法有了基础配置后我们可以用不同方式实现LED闪烁效果。最简单的就是直接在main函数中交替设置高低电平while(1) { LED_RESET(); // 点亮 Delay_ms(500); LED_SET(); // 熄灭 Delay_ms(500); }但实际项目中不建议使用空循环延时会浪费CPU资源。更专业的做法是使用SysTick定时器实现精确延时。首先初始化SysTickvoid SysTick_Init(void) { if(SysTick_Config(SystemCoreClock / 1000)) // 1ms中断 { while(1); // 初始化失败 } NVIC_SetPriority(SysTick_IRQn, 0); }然后实现一个非阻塞式延时函数volatile uint32_t TimingDelay 0; void Delay_ms(uint32_t nTime) { TimingDelay nTime; while(TimingDelay ! 0); } // 在SysTick中断中调用 void SysTick_Handler(void) { if(TimingDelay ! 0x00) { TimingDelay--; } }更高级的实现是使用定时器PWM模式可以轻松调节LED亮度。以TIM3为例void PWM_Init(void) { TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_OCInitTypeDef TIM_OCInitStructure; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); // 配置PC13为复用推挽输出 GPIO_InitStructure.GPIO_Pin GPIO_Pin_13; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOC, GPIO_InitStructure); // 定时器基础配置 TIM_TimeBaseStructure.TIM_Period 999; // 自动重装载值 TIM_TimeBaseStructure.TIM_Prescaler 71; // 72MHz/(711)1MHz TIM_TimeBaseStructure.TIM_ClockDivision 0; TIM_TimeBaseStructure.TIM_CounterMode TIM_CounterMode_Up; TIM_TimeBaseInit(TIM3, TIM_TimeBaseStructure); // PWM模式配置 TIM_OCInitStructure.TIM_OCMode TIM_OCMode_PWM1; TIM_OCInitStructure.TIM_OutputState TIM_OutputState_Enable; TIM_OCInitStructure.TIM_Pulse 500; // 初始占空比50% TIM_OCInitStructure.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC1Init(TIM3, TIM_OCInitStructure); TIM_Cmd(TIM3, ENABLE); }5. 调试与烧录技巧完成代码编写后点击编译按钮(Build)进行编译。首次编译经常会遇到各种错误最常见的是头文件找不到。这时需要检查是否正确定义了USE_STDPERIPH_DRIVER宏头文件路径是否包含正确是否缺少必要的.c文件(如stm32f10x_flash.c)编译成功后我们需要将程序烧录到开发板。对于STM32F103C8T6可以使用串口烧录方式设置BOOT0为1BOOT1为0进入串口下载模式使用FlyMcu等工具通过串口下载hex文件下载完成后将BOOT0跳线接回0更高效的调试方法是使用ST-Link调试器。在Keil中配置Debug选项选择ST-Link Debugger在Port选项中选择SW勾选Reset and Run在Flash Download中勾选Reset and Run调试时可以利用Keil的实时变量监视功能。在Watch窗口添加要监视的变量如TimingDelay。遇到程序跑飞时可以检查堆栈是否足够我一般设置Stack_Size为0x400Heap_Size为0x200。6. 常见问题排查新手在第一个LED实验中最常遇到的几个问题LED不亮检查硬件连接是否正确LED是否损坏用万用表测量IO口电压变化确认GPIO初始化代码正确执行程序下载失败检查BOOT引脚设置确认串口驱动安装正确尝试降低波特率(如115200→57600)程序运行不稳定检查系统时钟配置确认启动文件(startup_stm32f10x_md.s)选择正确查看.map文件确认内存没有溢出编译时报错缺少头文件检查包含路径和宏定义链接错误确认所有必要源文件已加入工程语法错误检查代码是否符合C99标准我遇到过一个棘手问题LED闪烁几次后停止。最终发现是看门狗没有禁用在系统初始化时添加IWDG_WriteAccessCmd(IWDG_WriteAccess_Disable);解决了问题。7. 进阶扩展思路完成基础LED闪烁后可以尝试以下扩展实验呼吸灯效果通过PWM动态调整占空比实现LED亮度渐变。可以使用如下代码uint16_t pwmVal 0; int8_t dir 1; while(1) { Delay_ms(10); if(dir) pwmVal; else pwmVal--; if(pwmVal 900) dir 0; if(pwmVal 100) dir 1; TIM_SetCompare1(TIM3, pwmVal); }多LED流水灯扩展连接多个LED实现跑马灯效果。需要修改硬件连接和初始化代码#define LED_NUM 4 const uint16_t LED_PINS[LED_NUM] {GPIO_Pin_13, GPIO_Pin_14, GPIO_Pin_15, GPIO_Pin_12}; void LED_Sequence(void) { static uint8_t index 0; GPIO_Write(LED_PORT, ~(1 (LED_PINS[index] 8))); index (index 1) % LED_NUM; Delay_ms(200); }按键控制LED 添加按键检测功能实现按键切换LED状态。需要注意按键消抖处理#define KEY_PORT GPIOA #define KEY_PIN GPIO_Pin_0 uint8_t Key_Scan(void) { static uint8_t key_up 1; if(key_up (GPIO_ReadInputDataBit(KEY_PORT, KEY_PIN) 0)) { Delay_ms(10); key_up 0; if(GPIO_ReadInputDataBit(KEY_PORT, KEY_PIN) 0) return 1; } else if(GPIO_ReadInputDataBit(KEY_PORT, KEY_PIN) 1) { key_up 1; } return 0; }8. 工程优化与最佳实践完成基础功能后我们应该考虑代码的组织结构和可维护性。我推荐采用模块化编程方式创建专门的led.c和led.h文件管理LED相关代码/* led.h */ #ifndef __LED_H #define __LED_H #include stm32f10x.h void LED_Init(void); void LED_On(void); void LED_Off(void); void LED_Toggle(void); #endif使用条件编译增加灵活性/* 根据不同的开发板定义LED连接 */ #if defined(BOARD_V1) #define LED_PORT GPIOC #define LED_PIN GPIO_Pin_13 #elif defined(BOARD_V2) #define LED_PORT GPIOB #define LED_PIN GPIO_Pin_5 #endif添加完善的注释和版本信息/** * file led.c * author Your Name * version V1.0 * date 2023-06-01 * brief LED驱动模块 */使用Doxygen风格注释生成文档/** * brief 初始化LED GPIO * param None * retval None */ void LED_Init(void) { // 实现代码 }创建Makefile实现命令行编译TARGET LED_Demo BUILD_DIR build C_SOURCES \ src/main.c \ src/stm32f10x_it.c \ src/system_stm32f10x.c \ src/led.c # 交叉编译工具链前缀 PREFIX arm-none-eabi- # 包含路径 INCLUDES -Iinc -Icmsis在实际项目中我还习惯添加一个bsp.c文件来集中管理所有硬件初始化这样main函数可以保持简洁void BSP_Init(void) { NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); SysTick_Init(); LED_Init(); KEY_Init(); USART_Init(115200); } int main(void) { BSP_Init(); while(1) { // 应用代码 } }