单片机与物联网 / 系统课时

创建并运行第一个工程

创建并运行第一个工程

本课使用 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,这些文件共同完成复位入口、内存布局与程序入口连接。

第一个 STM32 工程的构建调试闭环

编写、编译与下载

将 main.c 替换为下面的完整程序。全局变量 counter 使用 volatile,确保编译器不会把调试时需要观察的读写删除;延时循环让变量变化速度降低,便于断点和单步观察。该程序只依赖标准整数类型,不使用 HAL,因此适合验证最基础的启动、链接和调试链路。

c
#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。

预期结果如下:

text
编译:0 errors
下载:固件写入完成并进入调试会话
程序:在 main() 或用户断点处暂停

断点与变量观察

在 counter++; 所在行左侧双击设置断点,然后按 F8 继续运行。程序命中断点后,打开 Variables 视图查看当前值;也可以把 counter 添加到 Expressions 视图。每按一次 F6 单步越过该语句,counter 应增加 1,随后程序进入延时循环并回到下一轮。

预期观察结果如下:

text
首次暂停: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。

本课练习

  1. 将延时上限改为 500000U,重新编译和下载,比较断点再次命中的时间变化。验收条件是工程仍为 0 个错误,且 counter 按 1 递增。
  2. 新增一个 volatile uint32_t doubled,在循环中令它等于 counter * 2U,并在 Expressions 中同时观察两个变量。验收条件是每次暂停时 doubled 都等于 counter 的两倍。

本课总结

  • 最小空工程可以把问题范围收敛到启动文件、链接脚本、编译器、ST-LINK 和调试器本身。
  • volatile 全局变量适合验证下载后的代码是否真实执行,也便于断点和表达式观察。
  • 调试故障应按编译、连接、下载、运行和变量可见性分层定位,而不是一次修改多个设置。

下一课预告

下一阶段将进入 GPIO、时钟和外设初始化,使用可见的 LED 或串口输出来替代纯调试变量,并逐步建立面向硬件行为的验证方法。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建并运行第一个工程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通