【产出】 > 用 STM32CubeIDE 新建工程、在图形界面里配置 LED 引脚和时钟、生成 HAL 代码、编译并通过 ST-LINK 下载调试,让开发板上的 LED 闪起来。
【版本】 > 按 STM32CubeIDE 1.x 编写,以 NUCLEO 开发板和常见的 STM32F103C8T6 最小系统板("蓝色小板")为例。其他系列步骤相同。
一、准备
| 项目 | 说明 |
|---|---|
| 开发板 | NUCLEO 系列板载 ST-LINK,一根 USB 线即可;最小系统板需要另配 ST-LINK V2 下载器 |
| 软件 | STM32CubeIDE(ST 官网免费下载,需注册账号),已集成 CubeMX 配置工具和 ST-LINK 驱动 |
| 接线(最小系统板) | ST-LINK 的 SWDIO、SWCLK、GND、3.3V 分别接板子上同名引脚 |
【注意】 > 安装路径和工作空间(workspace)路径都不要包含中文和空格,否则编译时可能出现找不到文件的错误。
二、新建工程
- 打开 STM32CubeIDE,选择工作空间目录。
- "File → New → STM32 Project",等待它下载芯片数据库(第一次较慢)。
- 选择芯片:
- NUCLEO 开发板:切到 Board Selector 标签,搜索板子型号(如
NUCLEO-F411RE)。 - 最小系统板:在 MCU/MPU Selector 里搜索芯片型号(如
STM32F103C8)。
- NUCLEO 开发板:切到 Board Selector 标签,搜索板子型号(如
- 填写工程名,其余保持默认(C 语言、Executable、STM32Cube),点击完成。用 Board Selector 时,会询问是否按默认值初始化外设,选"是"。
三、在 .ioc 里配置引脚和时钟
工程创建后会打开 .ioc 配置界面,这一步决定了生成的初始化代码。
1. 先开调试接口(最容易漏的一步)
左侧 System Core → SYS,把 Debug 设为 Serial Wire。
【注意】 > 不设置 Serial Wire 时,部分芯片生成的代码会把 PA13 / PA14(SWD 调试引脚)当作普通 GPIO,下载一次之后 ST-LINK 就再也连不上芯片。补救方法见文末故障排查。
2. 配置 LED 引脚
在右侧芯片引脚图上点击 LED 所接的引脚,选择 GPIO_Output:
| 开发板 | LED 引脚 |
|---|---|
| NUCLEO-64 系列(如 F411RE、F401RE) | PA5(用户 LED LD2) |
| STM32F103C8T6 最小系统板 | PC13(低电平点亮) |
右键引脚选择"Enter User Label",起名为 LED,生成的代码里会出现 LED_Pin 和 LED_GPIO_Port 两个宏,代码可读性更好。
3. 时钟
最小系统板一般焊有 8 MHz 外部晶振:
- System Core → RCC,把 High Speed Clock (HSE) 设为 Crystal/Ceramic Resonator。
- 打开 Clock Configuration 标签,在 HCLK 输入框填
72(F103 的最高频率),回车后工具会自动计算分频和倍频。
NUCLEO 开发板使用板选择器的默认时钟配置即可。
4. 生成代码
按 Ctrl+S 保存 .ioc,提示是否生成代码时选"是"。
四、写代码:只写在 USER CODE 区域
打开 Core/Src/main.c,找到主循环:
/* USER CODE BEGIN WHILE */
while (1)
{
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
HAL_Delay(500);
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */
【注意】 > 每次修改
.ioc重新生成代码时,工具会覆盖USER CODE BEGIN和USER CODE END之外的所有内容。自己的代码一定要写在这两行注释之间,否则下次生成就没了。
HAL_Delay() 的单位是毫秒,依赖 SysTick 中断,不能在中断服务函数里调用,否则程序会卡死。
五、编译和下载
- 点击锤子图标(或
Ctrl+B)编译,底部 Console 显示0 errors即成功。 - 点击绿色运行按钮(Run),第一次会弹出调试配置窗口,确认调试器为 ST-LINK (ST-LINK GDB server),点 OK。
- 下载完成后程序自动运行,LED 每 0.5 秒翻转一次。
调试: 点击小虫子图标(Debug)进入调试视图,可以单步执行、加断点、在 Expressions 窗口看变量值。
六、故障排查
| 现象 | 原因与处理 |
|---|---|
No ST-LINK detected | 检查 USB 线和 ST-LINK 驱动;NUCLEO 板确认跳线帽在 ST-LINK 位置 |
| 提示 ST-LINK 固件需要升级 | 按提示用 "Help → ST-LINK Upgrade" 升级,升级时先断开目标板 |
| 第一次能下载,之后连不上 | SWD 引脚被代码改成了普通 GPIO(第三节第 1 步漏设)。处理:在调试配置的 Debugger 页把 Reset behaviour 设为 Connect under reset,按住板上复位键点下载,在复位松开的瞬间连上芯片;连上后先在 .ioc 里改好 Serial Wire 再重新下载 |
| 编译通过但 LED 不亮 | 核对 LED 引脚;PC13 的 LED 是低电平点亮;确认时钟配置里 HSE 设置与板上晶振一致 |
卡在 HAL_Delay | 在中断里调用了 HAL_Delay,或者 SysTick 中断优先级被改得比当前中断低 |
【提示】 > 网上便宜的 F103C8T6 板子有不少是兼容芯片,下载时可能提示芯片 ID 不匹配。这类芯片能否正常使用要看具体型号,学习阶段建议买正规渠道的 NUCLEO 开发板,省去很多排查时间。
延伸阅读
- STM32CubeIDE 下载与文档:https://www.st.com/en/development-tools/stm32cubeide.html
- ST 官方入门教程(STM32 Step by Step):https://wiki.st.com/stm32mcu/wiki/STM32StepByStep:Getting_started_with_STM32_:_STM32_step_by_step
评价 (0)