单片机与物联网 / 系统课时
创建并运行首个工程
创建并运行首个工程
本课将从芯片选择开始,完成 GPIO 配置、工程生成、编译和下载,并用板载 LED 的周期闪烁验证工具链、调试器与目标板连接是否全部正常。
学习目标
- 能根据开发板或芯片型号创建 STM32 工程
- 能配置 LED 引脚并生成初始化代码
- 能完成编译、下载和故障定位
新建工程前的确认
先确认开发板型号、STM32 完整料号、调试器类型以及板载 LED 对应的 GPIO。不同开发板的 LED 引脚和有效电平可能不同,不能直接照搬其他型号的引脚配置。
开发板至少需要连接电源、GND、SWDIO 和 SWCLK。使用板载调试器时通常只需连接 USB;使用外置 ST-LINK 时,还应确认目标电压检测和公共地可靠。
用图形化工具生成工程
打开 STM32CubeMX,或在 STM32CubeIDE 中选择新建 STM32 工程。按开发板或 MCU 型号创建项目后,将 LED 对应引脚设置为 GPIO_Output,输出类型保持推挽,速度选择低速或中速即可。建议把该引脚的用户标签命名为 LED,生成代码后会得到 LED_GPIO_Port 和 LED_Pin 两个宏。
在 Project Manager 中填写工程名,选择实际使用的工具链,并生成工程。生成后重点确认 Core/Src/main.c、Core/Src/gpio.c 和 Core/Inc/main.h 已出现,说明启动代码、HAL 驱动与 GPIO 初始化已经写入工程。
编写 LED 闪烁逻辑
下面是片段示例,应放入生成后的 main.c 中,位于 while (1) 循环内部。它依赖 CubeMX 已生成的 HAL 初始化代码,以及名为 LED 的 GPIO 标签。
while (1)
{
// 每次循环翻转一次 LED 输出电平
HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
HAL_Delay(500);
}预期结果
LED 每 500 ms 翻转一次,完整亮灭周期约为 1 s。HAL_Delay 的单位是毫秒,并依赖系统节拍已经正常工作。若引脚标签不是 LED,应使用工程实际生成的端口宏和引脚宏;若开发板 LED 为低电平点亮,闪烁节奏不受影响,只是亮灭逻辑与高电平点亮相反。
编译、下载并运行
先执行 Build,确认工程没有编译错误。随后连接调试器,执行 Download 或 Debug,将程序写入 Flash,再让目标板继续运行。不同 IDE 的按钮位置和提示文本可能不同,验收标准是编译错误数为 0,下载校验成功,复位后 LED 能持续闪烁。
若编译失败,先检查代码是否写在用户代码区、GPIO 宏是否存在以及工程是否重新生成。若调试器找不到芯片,依次检查供电、USB 或 SWD 接线、驱动、目标电压和 SWD 频率。若下载成功但 LED 不闪烁,优先核对引脚映射、LED 有效电平、MX_GPIO_Init() 是否执行,以及程序是否停在断点中。