2. 开发环境搭建：从零开始，把工具链跑通

说实话，嵌入式开发最磨人的往往不是写代码，而是搭环境。我见过太多新手卡在第一步——IDE装好了，工程建好了，点下载按钮就是没反应。嗯，这节课我们就来把这套流程彻底捋顺。

我们的目标很明确：STM32CubeMX生成初始化代码 → STM32CubeIDE编译调试 → ST-Link/J-Link把程序烧进去 → 串口能看到打印信息。一条龙，全通。

2.1 STM32CubeMX 配置：别小看这个图形化工具

很多人觉得 CubeMX 就是个代码生成器，随便点点就行。我以前也这么想，直到有一次在项目里因为时钟树配错了，整块板子跑起来时序全乱——嗯，从那以后我每次都会仔细检查时钟配置。

核心配置步骤：

1. 选芯片：根据你的板子选具体型号，比如 STM32F407VGT6 或 STM32H743ZIT6。别选错了封装，不然引脚对不上。
2. 配置时钟树 (RCC)：HSE 外部晶振频率是多少？我习惯用 8MHz 或 25MHz。然后通过 PLL 倍频到主频。记得在 Clock Configuration 页面确认 HCLK 没超限。
3. 配置外设：USART1 选异步模式，波特率 115200，数据位 8，停止位 1。GPIO 按需设置推挽输出或浮空输入。
4. 配置调试接口：SYS → Debug 选 Serial Wire。这一步很多人忘，结果烧录器连不上。
5. 生成代码：Project Manager 里设置工程名、路径、IDE 选 STM32CubeIDE。Toolchain / IDE 一定要选对。

2.2 STM32CubeIDE 安装：其实没那么复杂

STM32CubeIDE 是 ST 官方基于 Eclipse 打造的免费 IDE。说白了，它把编译器、调试器、代码编辑集成到了一起。你不需要再单独装 GCC 或者 OpenOCD。

安装要点：

• 去 ST 官网下载最新版安装包，Windows 下直接运行 .exe，Linux 下解压运行安装脚本。
• 安装路径不要带中文和空格。我见过有人装在 "C:\Program Files (x86)" 下面，结果编译报路径错误。
• 安装过程中会提示安装驱动，ST-Link 驱动一定要勾上。
• 首次启动会创建工作空间 (workspace)，建议单独建一个文件夹，不要跟工程混在一起。

导入 CubeMX 生成的工程很简单：File → Import → Existing Projects into Workspace → 选择工程目录。然后就能看到 .c 和 .h 文件了。

2.3 调试器配置：ST-Link vs J-Link

调试器是嵌入式开发的「听诊器」。没有它，你只能靠猜。我个人两种调试器都用过，说说区别：

ST-Link 配置步骤：

1. 用 SWD 接口连接：SWDIO、SWCLK、GND，再加一个 3.3V 给板子供电（可选）。
2. 在 CubeIDE 里：Run → Debug Configurations → Debugger 选项卡 → Debug Probe 选 ST-Link。
3. Interface 选 SWD，频率默认 4MHz 就行。如果线太长，降到 1MHz 更稳定。

J-Link 配置步骤：

1. 同样接 SWD 四根线。J-Link 的 3.3V 输出电流更大，可以直接给目标板供电。
2. 在 CubeIDE 里：Debug Probe 选 J-Link，Interface 选 SWD。
3. 如果提示固件更新，点 Yes。J-Link 的固件更新很频繁，我一般保持最新版。

2.4 串口终端工具：看到打印信息才算活过来了

程序烧进去之后，怎么知道它跑没跑？最直接的办法就是串口打印。printf 重定向到 USART，然后在电脑上用串口工具看输出。

常用串口工具对比：

串口配置参数：

• 波特率：115200（最常用，跟 CubeMX 里配的一致）
• 数据位：8
• 停止位：1
• 校验位：None
• 流控制：None

连接好 USB 转串口模块（比如 CH340 或 CP2102），在设备管理器里看 COM 口号。然后打开串口工具，选对 COM 口和波特率，点连接。如果板子已经在跑程序，应该能看到打印信息了。

2.5 验证：让 LED 闪烁 + 串口打印

环境搭好了，我们来写个最简单的程序验证一下。在 CubeMX 里配好一个 GPIO 输出（比如 PA5 接 LED）和 USART1，生成代码后，在 main.c 的 while(1) 里加上：

HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
HAL_Delay(500);
printf("Hello from STM32! System Clock: %lu Hz\r\n", HAL_RCC_GetSysClockFreq());

别忘了重定向 printf。在 usart.c 或 main.c 里加：

#include <stdio.h>

int __io_putchar(int ch) {
    HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, HAL_MAX_DELAY);
    return ch;
}

编译下载，打开串口工具。如果看到 LED 以 1 秒间隔闪烁，串口每 500ms 打印一次系统时钟频率——恭喜你，环境搭建成功了。

嗯，到这里我们的开发环境就全部跑通了。后面的章节里，我们会基于这套环境一步步深入推理优化和外设驱动调试。工具链顺手了，后面的事就好办了。