简介：STM32L431RCT6的LED闪烁基础例程，是一套面向嵌入式开发初学者的完整C语言工程包，围绕Cortex-M4内核超低功耗微控制器，演示了基于STM32CubeMX图形化配置工具完成GPIO推挽输出、系统时钟树配置以及HAL库初始化的标准开发路线，适用于物联网终端、智能家居、传感器节点等应用场景的入门学习。压缩包内共包含196个文件，大小约7.51MB，以49个h头文件和28个c源文件为主体，同时保留26个o目标文件、25个crf交叉引用文件，以及hex与axf编译产物、uvprojx与ewp的工程文件、ioc图形配置、map映射文件和Jlink脚本等，完整还原了从CubeMX生成代码、Keil或IAR编译链接到仿真下载的全过程。内容预览中可见HAL库的RCC、I2C、TIM等驱动源码，配合完整主工程与调试批处理文件，读者既可以对照代码理解库函数调用层次，也可以直接编译后烧录到开发板观察LED周期性闪烁，为后续学习定时器、中断和低功耗模式打下实践基础。整个工程已有2787人学习/下载，特别适合希望通过实际工程快速掌握STM32L431RCT6开发流程的读者。
1. 这个 LED 闪烁例程包到底值不值得下
如果你是刚拿到某款 STM32L431RCT6 开发板，或者手头有个项目准备用这颗低功耗芯片，又不想从寄存器手册从头啃起，那这个"1.基础例程+STM32L431RCT6+LED闪烁实验.rar"就是你最该先打开的资源。它不只是一个点灯工程，而是一整套工程骨架——包含启动文件、链接脚本、时钟初始化、GPIO 控制代码，以及配套的烧录与调试说明。换句话说，你把这个例程跑通了，就等于把 L431 这颗芯片的底层启动链路和编译环境全部打通了，后面做串口、ADC、低功耗休眠都是在这个框架上长出来的。
适合谁用？刚转过来的老 51 开发者、从 Arduino 往寄存器/HAL 走的入门者、以及需要给低功耗项目选型验证的嵌入式工程师。不适合谁？那些指望一个例程包含完整 RTOS 移植或者复杂外设驱动的，请绕道，这只是一个最小系统级的起点工程。
2. 先搞懂 L431RCT6 这颗芯片与例程骨架
2.1 为什么用 STM32L431RCT6 做入门起步
L431RCT6 属于 STM32L4 系列中的低功耗主力型号，核心是 Cortex-M4F，带 FPU，主频最高跑到 80MHz。对比常见的 F103C8T6，L431 的亮点在三点：一是功耗表现，Stop 模式电流可以压到微安级别，适合电池设备；二是 Flash 有 256KB、SRAM 64KB，对大部分 IoT 节点绰绰有余；三是内部集成了 DAC、运放、比较器这些模拟外设。说实话，拿这颗料跑 LED 闪烁有点"大炮打蚊子"，但这正是它的价值——你手里有个资源丰富、功耗可控的平台，后面的扩展空间很大，而不是学完点灯就废了。
板子上的 LED 一般接在某个 GPIO 引脚上，比如常见的 PB2、PC13、PA5，具体看板子原理图，例程代码里已经烧录的时候默认了其中一个。LED 闪烁的原理非常简单：GPIO 配置为推挽输出，然后延时翻转电平，如此循环。
2.2 工程内部有什么：目录结构与文件作用
解压这个 rar 包后，建议先别急着点开工程。用文件管理器过一遍整个目录结构，心里有个地图，后面改代码才不会迷路。常见的一个标准 STM32CubeMX 生成的 MDK-ARM 工程结构是这样的：
LED_Blink/ ├── Core/ │ ├── Inc/ # 头文件目录 │ │ ├── main.h │ │ ├── stm32l4xx_hal_conf.h │ │ └── stm32l4xx_it.h │ └── Src/ # 源码目录 │ ├── main.c │ ├── stm32l4xx_it.c │ └── system_stm32l4xx.c ├── Drivers/ │ ├── CMSIS/ # ARM 内核文件 │ └── STM32L4xx_HAL_Driver/ │ ├── Inc/ │ └── Src/ ├── MDK-ARM/ # Keil 工程文件 │ ├── LED_Blink.uvprojx │ ├── startup_stm32l431rctx.s │ └── ... ├── EWARM/ # IAR 工程（部分包里有） └── STM32CubeIDE/ # 或者这个这个目录划分是有讲究的。Core 里是你自己写的业务逻辑，Drivers 是 ST 官方封装好的 HAL 库，MDK-ARM 里是 Keil 的工程文件和启动文件。你在京东或淘宝买的开发板给的例程，通常就是用 CubeMX 生成后再整理的。
main.c 是核心中的核心，里面完成了时钟初始化（SystemClock_Config）、外设初始化（MX_GPIO_Init）和主循环（while(1)）。system_stm32l4xx.c 负责芯片上电后的基础时钟配置，它是从复位向量到 C 语言 main 函数之间的"桥梁"。启动文件 startup_stm32l431rctx.s 则是更底层的引导，它定义了中断向量表、初始化堆栈和.data/.bss 段。这三者协同，缺一不可。
2.3 从复位到 main：一个例程的完整启动链路
很多初学者直接跳进 main 函数写 LED 翻转，遇到问题就抓瞎，因为你没搞懂在你写的代码运行之前，芯片经历了什么。我把这个流程拆开讲：
第一步，CPU 上电复位，从 0x00000000 地址取栈顶指针，从 0x00000004 取复位中断向量，跳转到 Reset_Handler。第二步，Reset_Handler 里调用 SystemInit()，这个函数在 system_stm32l4xx.c 里，它干的活是设置 Flash 等待周期、切换时钟源到 MSI 或 HSI。第三步，跳转到 __main，注意这是 C 库函数，不是你的 main——它负责把 RW 数据从 Flash 拷贝到 RAM、把 ZI 段清零。第四步，真正进入你的 main()。
这一条链路在任何 STM32 工程里都是标准动作。如果你发现 LED 不闪，而且仿真器连不上芯片，多半是这一步就卡死了——比如供电电压和 Flash 等待周期不匹配。L431 在 80MHz 主频下，Flash 等待周期必须设成 4 个 cycle，否则取指直接硬件错误。
3. 把 LED 闪烁工程跑起来：从 CubeMX 到 Keil
3.1 基于 STM32CubeMX 生成初始化代码
虽然 rar 包里直接给了现成工程，但作为工程习惯，你应该掌握怎么从一个空白芯片生成同样的代码。用 CubeMX 新建工程，芯片型号搜 STM32L431RCTx，然后配置引脚状态：点开你要接 LED 的那个引脚，比如 PB2，在下拉列表里选 GPIO_Output。
时钟树这块是重头戏，也是新手最容易懵的地方。L431 的时钟树有三个关键配置项：
- HSI16：内部 16MHz RC 振荡器，上电默认时钟源，精度一般，适合不需要精确时序的场景
- MSI：多速度内部振荡器，L4 系列特色，频率可以从 100kHz 调到 48MHz，低功耗模式下用它很省电
- PLL：锁相环，可以把 HSI16 或 MSI 倍频到最高 80MHz
例程里用的通常是 MSI 倍频到 80MHz。在 CubeMX 的 Clock Configuration 页里，把 PLL Source 选 MSI，PLLM 设 1，PLLN 设 40，PLLR 设 8，输出就是 80MHz。不过更省事的做法是直接选系统时钟源为 PLL，然后输入期望频率 80，CubeMX 会自动算分频系数。算完之后确认 AHB 和 APB 分频器设置：APB1 最大 80MHz，APB2 最大 80MHz，但别把 APB1 上挂的定时器时钟搞错，APB1 定时器会强制倍频 2 倍。
生成代码后，打开 main.c，你会看到这样一段 GPIO 初始化代码：
static void MX_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; /* GPIO 端口时钟使能 */ __HAL_RCC_GPIOB_CLK_ENABLE(); /* 配置 PB2 引脚为推挽输出 */ GPIO_InitStruct.Pin = GPIO_PIN_2; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP; GPIO_InitStruct.Pull = GPIO_NOPULL; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); }这段代码的逻辑：第一步开 GPIOB 的时钟，这是 STM32 外设的统一要求——不用时钟的外设直接写寄存器是无效的。第二步填初始化结构体，Pin 指定哪个引脚，Mode 选推挽输出（PP），Pull 不上下拉，Speed 选 LOW。LED 这种开关量输出，速度选 LOW 就够了，选 HIGH 反而会引入更陡的边沿，造成 EMI 问题。
注意看 GPIO_InitStruct.Speed 这个字段，我一般会专门提醒新手：L4 系列 GPIO 速度等级分 LOW、MEDIUM、HIGH、VERY_HIGH，分别对应不同的压摆率。点灯用 LOW，I2C 用 OPEN_DRAIN + HIGH 或 VERY_HIGH，SPI 则看时钟频率。速度等级不需要盲目拉满，拉满的结果是功耗上升和信号过冲。
3.2 点亮 LED：HAL_GPIO_WritePin 的用法与延时配合
GPIO 初始化完了，接下来就是主循环里的翻转逻辑。例程 main.c 的 while(1) 里大概长这样：
int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); while (1) { HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); // 低电平点亮 HAL_Delay(500); // 延时 500ms HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET); // 高电平熄灭 HAL_Delay(500); } }这里有个细节我要强调：代码里用的是LED_GPIO_Port和LED_Pin这两个宏，它们在 main.h 里被定义成GPIOB和GPIO_PIN_2。这种通过宏封装引脚的做法是我比较推荐的，因为它把硬件引脚和逻辑操作解耦了——万一板子改版换了引脚，你只需要改 main.h 里的宏定义，不用在代码里搜GPIO_PIN_2。
关于延时，HAL_Delay(500) 依赖 SysTick 中断，而 SysTick 的时钟源在 HAL_Init 里被配置为 HCLK。如果你改了时钟树但是没重新初始化 SysTick，延时时间会漂得离谱。这个在后面避坑章节会专门讲。
3.3 编译烧录前的工程配置：那几个必须检查的选项
Keil 打开工程后，别直接 F7。先过一遍 Options for Target，我每次拿到别人的工程都会按这个顺序检查：
第一项，Device 标签页确认芯片型号是 STM32L431RCTx，如果型号选错，启动文件会不匹配，编译直接报错。第二项，Target 标签页确认 External Clock 还是 HSE，这里要和你的板子硬件一致——如果你的板子没有外部晶振，这里就不要选 HSE，否则初始化 Clock 时会卡死。第三项，C/C++ 标签页的 Define 里必须有STM32L431xx，这是 HAL 库编译时选择外设寄存器结构的宏开关。第四项，Debug 标签页选择你的调试器，ST-Link 就选 ST-Link Debugger，然后进 Settings 确认 SW 模式，把 Flash Download 里的 Reset and Run 打上勾。
最后一项是新手最不容易注意到的：Linker 标签页里的 Use Memory Layout from Target Dialog 要打勾。如果取消了这个勾，Keil 会去找一个 .sct 分散加载文件，而这个文件在工程里如果没有，链接直接报错。
4. 编译烧录与运行验证：一次点亮全过程
4.1 硬件接线与调试器连接
先把板子的硬件准备做对。无论你的板子是把 LED 接到 PB2、PC13 还是 PA5，先找原理图确认两件事：LED 的正极是接 VCC 还是接 GPIO？如果 LED 接法是从 GPIO 拉电流到地（低电平点亮），那 GPIO 输出低电平灯亮；如果 GPIO 灌电流到 LED（高电平点亮），则正逻辑。
烧录器的连接：ST-Link 用 SWD 四线模式，SWDIO 接 PA13，SWCLK 接 PA14，GND 接 GND，3.3V 接板子电源。注意顺序不要接反，SWDIO 和 SWCLK 对调也能连上，但写 Flash 时会报错找不到设备。如果你的板子没有板载调试器，就需要自己接，排线越短越好，特别是 SWCLK 线，长了容易受干扰。
接线完毕后，把 ST-Link 插上电脑，打开设备管理器看端口——ST-Link 会虚拟出一个串口和调试器设备，如果这里都没识别到，后面 Keil 里再怎么折腾也白搭。需要注意的是，Windows 上如果调试器没识别到，优先换 USB 口插主机后置面板，不要插前置 USB Hub 上，这能解决很大一部分"设备掉线"问题。
4.2 Keil 编译、烧录与在线调试
确保前面的工程配置无误后，按 F7 编译。第一次编译会比较久，因为 HAL 库全量编译，大概 30 秒到一分钟。编译输出窗口应该显示零错误、零警告。如果看到警告，比如warning: #1-D: last line of file ends without a newline，不用管；但如果是Error: L6218E: Undefined symbol，那就是启动文件或链接脚本有问题，优先检查芯片型号选择。
烧录有两种方式，看你的偏好。一种是直接按 F8 下载，下载完成后如果勾选了 Reset and Run，程序会立即跑起来，LED 开始闪烁；另一种是进入调试模式，按 Ctrl+F5 启动调试，这在验证初始化代码时很有用。
我一般建议用第二种方式做第一次验证，理由很简单：在线调试模式下，你可以在 SystemClock_Config 函数里设断点，然后打开 Register 窗口看 RCC->CFGR 寄存器的实际值，确认 PLL 确实锁定在 80MHz。如果 SystemClock_Config 里配置有问题，CFGR 的值会和你预期不一致，这比 LED 不亮更早暴露问题。
调试时还有个小技巧：把 View 菜单下的 Watch 窗口打开，添加变量uwTick，这是 HAL 库的系统时基计数器。如果这个值每秒增加 1000，那 SysTick 和时钟树就没有问题，LED 不闪只能从 GPIO 配置上找原因。
4.3 用逻辑分析仪验证闪烁频率与占空比
如果你手头有逻辑分析仪，验证会更加直观。把探针夹在 LED 引脚上，地线夹 GND，打开软件采样，就能看到一串方波。以 500ms 延时为例，逻辑分析仪上读到的应该是 1Hz 方波，高电平 500ms，低电平 500ms。
测到实际频率不对时，别急着改代码。先检查你的时钟配置——用内部 MSI 做时钟源且没有校准的情况下，MSI 本身精度在常温下大概是 ±1% 左右，这个误差直接体现在延时上。如果实测频率偏差达到好几个百分点，那不是 MSI 精度问题，而是 PLL 配置或 SysTick 重装值搞错了。
另外看占空比：如果亮的时间短、灭的时间长，不要奇怪，检查 HAL_GPIO_WritePin 的两个参数有没有写反。很多例程里用 RESET 表示点亮，用 SET 表示熄灭，这个取决于硬件电路；如果板子是 GPIO 输出高电平点亮 LED，那么例程逻辑需要反转，否则你会看到 LED 几乎不亮，因为大部分时间它处于 RESET 状态。
5. STM32L431 LED 例程避坑指南：五个血泪教训
5.1 坑一：芯片型号选成 L432，编译出一堆寄存器错误
现象：编译报错几百个，而且报错集中在 stm32l4xx_hal_gpio.c 里，全部指向不存在的寄存器地址。
原因：Keil 的 Device 型号选错，或者 C/C++ 宏定义里写的是 STM32L432xx。L431 和 L432 虽然都是 L4 系列，但寄存器结构体和内存映射有差异，宏定义会直接决定 HAL 库编译时引用哪套寄存器定义，选错必然报错。
解决：在 Options for Target 里把 Device 改成 STM32L431RCTx，同时把 C/C++ 的 Define 里的芯片宏改成 STM32L431xx，两个配置保持严格同步。从那以后我每次拿到新工程，第一件事就是核对这两个地方。
5.2 坑二：下载成功但板子无反应，LED 死活不亮
现象：Keil 里显示 Download verified OK，但板子上的 LED 不亮，按复位键也没反应。
原因：最常见的有三个。一是 Reset and Run 没勾选，程序烧进去了但没运行，需要手动按复位；二是 LED 引脚在初始化函数里被配置成了复用功能，比如 SDIO、I2C 等；三是板子上 LED 接的引脚和例程代码里定义的引脚不一致，尤其是从淘宝买的板子，因为 PCB 版本差异可能改了引脚连接。
解决：先按一下板子上的复位键排除第一个原因。然后用调试模式跑一下，看 PC 指针是否停在 while(1) 循环里，如果停在那里且寄存器值正常，那就是引脚定义问题——打开开发板的原理图，搜索丝印上的 LED 网络标号，对比 main.h 里宏定义改。
5.3 坑三：HAL_Delay 延时严重漂移，500ms 变成 2 秒
现象：LED 能闪，但闪烁频率明显偏慢，比如 500ms 延时实际变成了 2 秒。
原因：这个坑十有八九出在 SystemClock_Config 的配置顺序上。HAL_Delay 依赖 SysTick 中断，SysTick 的中断频率是 HCLK/1000。如果你先调用了 HAL_Delay 再重新配置时钟树，或者时钟树配置完成之后又切换了 PLL 倍频系数而没有同步更新 SysTick 到新的 HCLK，会导致 uwTick 的计数周期和实际时间不同步。
解决：检查 SystemClock_Config 是否在 HAL_Init 之后第一时间调用，中间不要夹任何 HAL_Delay。同时检查时钟树配置里 APB1 和 APB2 的分频系数，特别是 APB1 定时器时钟默认是 APB1 的 2 倍频，如果 HAL_Delay 依赖的某个外设挂在 APB1 上，这个倍频系数会影响时间基准。
5.4 坑四：调试器连接失败，报错 SWD Communication Failure
现象：Keil 里点 Settings，Debugger 显示 No target connected，报错 SWD Communication Failure。
原因：常见的有四类。一是供电不足——板子只靠调试器取电，但板子上有其他外设（比如 TFT 屏、无线模块）共同抢电流，电压被拉低导致芯片进入欠压复位循环；二是 SWDIO/SWCLK 杜邦线过长，超过 20cm 时信号反射严重；三是芯片之前被烧过读保护（RDP Level 1），调试口被锁死；四是复位引脚被外部电路拉死。
解决：先把板上其他跳线拔掉，仅保留最小系统供电和 SWD 四根线；杜邦线尽量剪短到 10cm 以内。如果确认是读保护锁死，用 ST-Link Utility 或者 CubeProgrammer 连接，全擦除后重新烧录。
5.5 坑五：CubeMX 重新生成代码后，自己写的逻辑被覆盖
现象：在 main.c 里加了一段自定义的传感器读取代码，重新用 CubeMX 改引脚配置后生成，发现自己的代码没了。
原因：CubeMX 会维护一个用户代码保护区间——在代码块之间用/* USER CODE BEGIN */和/* USER CODE END */注释标记的内容在重新生成时会保留，但写在保护区外的代码会被冲洗掉。很多新手不知道这个规则，把逻辑写在保护区外面甚至写在 HAL_GPIO_Init 函数内部。
解决：把自定义代码放进 USER CODE 保护区。
/* USER CODE BEGIN 2 */ uint8_t sensor_read_flag = 0; // 自定义变量定义 /* USER CODE END 2 */ while (1) { /* USER CODE BEGIN 3 */ sensor_read_flag = read_sensor(); // 自定义业务逻辑 if (sensor_read_flag == 1) { HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); } /* USER CODE END 3 */ }从那次以后，我拿到一个 CubeMX 工程，第一步就是搜代码里有多少个 USER CODE 区域，把所有自定义内容全部迁移进去。这个习惯让我少了很多重抄代码的时间。
6. 从点灯到实战：用 L431 的低功耗特性验证例程扩展性
6.1 把 HAL_Delay 换成定时器中断：精确延时的重构思路
点灯跑通了，接下来要思考的是：这个例程骨架能不能支撑真实项目？我的答案是可以，但需要动一个小手术——把阻塞式延时改成定时器中断。原因很简单：HAL_Delay 是忙等待，CPU 在延时期间啥也干不了。如果你的项目里同时要扫按键、驱动 OLED、跑通信协议，一个 500ms 的 HAL_Delay 会把所有其他任务全部卡住。
常见的替代方案是用 TIM2 做定时中断：
static void MX_TIM2_Init(void) { TIM_HandleTypeDef htim2; htim2.Instance = TIM2; htim2.Init.Prescaler = 7999; // 80MHz/8000 = 10kHz htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 4999; // 10kHz/5000 = 2Hz 中断频率 htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; HAL_TIM_Base_Init(&htim2); HAL_NVIC_SetPriority(TIM2_IRQn, 0, 0); HAL_NVIC_EnableIRQ(TIM2_IRQn); }注意这里的 Prescaler 是 7999 而不是 8000，因为 STM32 定时器是从 0 开始计数到重装值，实际分频系数是 Prescaler+1。同理 Period 是 4999 而不是 5000，实际周期是 5000 个计数。算一下：80MHz ÷ 8000 ÷ 5000 = 2Hz，即每 500ms 触发一次中断。这个公式是工程里最常见且必须心里有数的——Prescaler 分频后得到计数频率，Period 决定多少个计数计满溢出。
6.2 用 Stop 模式 + 外部中断做低功耗点灯
L431 和普通 F1 系列最大的区别在于低功耗模式。在电池供电的应用里，LED 不会一直闪，通常是"休眠—唤醒—闪几下—继续休眠"的节奏。用这个例程骨架来验证低功耗切换非常简单，只需要加一条语句：
HAL_SuspendTick(); // 停掉 SysTick HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); SystemClock_Config(); // 唤醒后重新配置时钟 HAL_ResumeTick();这段代码的逻辑：进入 Stop 模式前先挂起 SysTick，因为 Stop 模式下 MSI 时钟会停，SysTick 依赖它计时，如果不挂起会导致唤醒后 HAL_Delay 时间错乱。唤醒后需要重新调用 SystemClock_Config 恢复 80MHz 主频，因为 Stop 模式下大部分时钟域都断了。实际测过，L431 在 Stop 模式下的电流大概是 5 微安左右，加上 RTC 走时大概 8 微安，这比 F103 的停机模式低了将近一个数量级。
用这个思路，你可以做一个更实用的实验：把 LED 接在某个支持外部中断的引脚上，接到一个按键或者震动传感器，按下时触发 EXTI 中断唤醒，闪三下后继续 Stop。我最近做的一个低功耗传感器项目，待机电流压到 9 微安，就是完全复用这个例程的 GPIO 和时钟框架，只加了 EXTI 和 RTC 两处外设。
6.3. 例程里没写但是你会用到的东西：串口打印与错误定位
最后补充一个实际开发中最刚需的技能——在点灯例程里顺手把串口打印加上。点灯只能告诉你"它还在跑"，但跑偏了你看不出原因。建议在例程上做一个小扩展：
#include <stdio.h> int fputc(int ch, FILE *f) { // 把标准库的 putchar 重定向到 USART2 while (!(USART2->ISR & USART_ISR_TXE)) {} USART2->TDR = (uint8_t)ch; return ch; }然后在 main 函数里初始化 USART2 后，就能直接用 printf 输出调试信息。比如延时函数执行前后各打一次时间戳：
printf("LED ON at tick: %lu\r\n", HAL_GetTick()); HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); HAL_Delay(500); printf("LED OFF at tick: %lu\r\n", HAL_GetTick());这两个 tick 值如果相差不是 500，那就说明你的时钟配置或者 HAL_Delay 有了问题。从那以后，我每拿到一个新的 STM32 例程，第一步就是把 printf 重定向加上，把点灯验证升级成"点灯 + 串口打印"双重验证。单纯靠肉眼观察 LED 闪烁频率来判断延时准确度，实在是一种用眼力挑战仪器精度的做法，希望这个习惯能让你少交点学费，这套例程资源也才算真正被你吃透了。希望帮到你。
本文还有配套的精品资源，点击获取
