单片机与物联网 / 系统课时
创建并运行第一个工程
创建并运行第一个工程
本课使用 STM32CubeIDE 创建一个不依赖外设配置的最小空工程,通过可观察的计数变量验证编译、下载和调试链路。完成后,你将得到一套可重复执行的工程闭环,并能区分构建失败、连接失败和调试观察异常。
学习目标
- 创建与目标芯片或开发板匹配的 STM32CubeIDE 空工程。
- 编译并下载一个完整的最小 C 程序。
- 设置断点、单步执行并观察全局变量变化。
创建最小工程
使用 USB 数据线连接开发板的 ST-LINK 接口,然后打开 File > STM32 Project Create/Import。选择 STM32CubeIDE Empty Project;部分小版本也可从 File > New > STM32 Project 进入。STM32CubeIDE 2.x 保留了基于 MCU 或开发板选择器创建空工程的能力,外设配置与 HAL/LL 代码生成则由独立的 STM32CubeMX 完成。:contentReference[oaicite:2]{index=2}
在 Board Selector 中选择开发板的准确型号;若使用自制板,则在 MCU Selector 中输入芯片完整丝印。工程名设为 FirstProject,语言选择 C,构建配置选择 Debug。创建完成后,项目中应至少包含启动文件、链接脚本和 main.c,这些文件共同完成复位入口、内存布局与程序入口连接。

编写、编译与下载
将 main.c 替换为下面的完整程序。全局变量 counter 使用 volatile,确保编译器不会把调试时需要观察的读写删除;延时循环让变量变化速度降低,便于断点和单步观察。该程序只依赖标准整数类型,不使用 HAL,因此适合验证最基础的启动、链接和调试链路。
#include <stdint.h>
volatile uint32_t counter = 0U;
int main(void)
{
while (1)
{
counter++;
for (volatile uint32_t delay = 0U; delay < 100000U; delay++)
{
__asm volatile ("nop");
}
}
}保存文件后执行 Project > Build Project。构建成功时,Problems 视图应为 0 个错误,并在 Debug 输出目录生成 .elf 文件。随后选择 Run > Debug As > STM32 C/C++ Application;首次启动调试时,IDE 可能先打开调试配置窗口,再通过 ST-LINK 擦除、写入并校验片上 Flash。
预期结果如下:
编译:0 errors
下载:固件写入完成并进入调试会话
程序:在 main() 或用户断点处暂停断点与变量观察
在 counter++; 所在行左侧双击设置断点,然后按 F8 继续运行。程序命中断点后,打开 Variables 视图查看当前值;也可以把 counter 添加到 Expressions 视图。每按一次 F6 单步越过该语句,counter 应增加 1,随后程序进入延时循环并回到下一轮。
预期观察结果如下:
首次暂停:counter = 0
执行一次 counter++:counter = 1
再次执行 counter++:counter = 2常见故障
- 出现
No ST-LINK detected时,先确认使用的是数据线、连接的是调试 USB 口,并检查 ST-LINK 驱动或服务是否正常。 - 下载时无法连接目标芯片,可在调试配置中尝试较低的 SWD 频率,并在确认接线正确后使用 Connect under reset。
- Variables 中看不到
counter,应确认当前使用Debug配置,变量声明包含volatile,并避免启用会消除调试信息的高等级优化。 - 程序停在启动文件而未进入
main(),应检查链接脚本、启动文件和所选芯片型号是否一致,并重新执行 Clean 与 Build。
本课练习
- 将延时上限改为
500000U,重新编译和下载,比较断点再次命中的时间变化。验收条件是工程仍为 0 个错误,且counter按 1 递增。 - 新增一个
volatile uint32_t doubled,在循环中令它等于counter * 2U,并在 Expressions 中同时观察两个变量。验收条件是每次暂停时doubled都等于counter的两倍。
本课总结
- 最小空工程可以把问题范围收敛到启动文件、链接脚本、编译器、ST-LINK 和调试器本身。
volatile全局变量适合验证下载后的代码是否真实执行,也便于断点和表达式观察。- 调试故障应按编译、连接、下载、运行和变量可见性分层定位,而不是一次修改多个设置。
下一课预告
下一阶段将进入 GPIO、时钟和外设初始化,使用可见的 LED 或串口输出来替代纯调试变量,并逐步建立面向硬件行为的验证方法。