2. 开发环境搭建：Keil/IAR工程配置、调试器驱动与printf重定向

说实话，很多初学者一上来就急着写代码，结果卡在环境搭建上。我见过太多人花了两三天都点不亮一个LED，最后发现是调试器驱动没装对。这一章，咱们就把这些基础工作一次性搞定。

2.1 开发工具的选择：Keil vs IAR

做STM32开发，主流就是这两家。我个人两个都用过，但平时主力还是Keil。为什么？因为生态好，网上能找到的例程、教程，十有八九都是Keil工程。

2.2 Keil工程配置实战

咱们以STM32F103C8T6为例，走一遍标准流程。

2.2.1 新建工程

1. 打开Keil，点击 Project → New μVision Project
2. 选择芯片型号：STM32F103C8
3. 弹出Manage Run-Time Environment时，先点Cancel。咱们手动加文件，更清楚

2.2.2 添加启动文件和CMSIS核心

你需要从STM32Cube固件包里拷贝以下文件到工程目录：

• startup_stm32f103xb.s — 启动文件
• system_stm32f103xe.c — 系统时钟配置
• stm32f1xx.h — 外设寄存器定义

2.2.3 配置魔法棒（Target & C/C++）

点击 Project → Options for Target（或者直接点魔法棒图标）：

• Target标签：选择正确的ARM编译器，我一般用 ARM Compiler V6.9
• C/C++标签：在Define里加上 STM32F103xE（注意不是C8，因为头文件里xE覆盖了整个系列）
• Include Paths：添加你的头文件路径，比如 .\Inc; .\Drivers\CMSIS\Include

2.3 调试器驱动安装与固件升级

调试器是连接电脑和开发板的桥梁。最常用的就是J-Link和ST-Link。

2.3.1 J-Link驱动安装

1. 去SEGGER官网下载 J-Link Software and Documentation Pack
2. 安装时选择 USB Driver 和 GDB Server
3. 插上J-Link，打开设备管理器，应该能看到 J-Link driver

2.3.2 ST-Link驱动与固件升级

ST-Link是STM32 Nucleo/Discovery板自带的调试器。驱动安装很简单：

• 安装 STM32CubeProgrammer，它会自动装好ST-Link驱动
• 或者单独安装 ST-Link USB driver

固件升级是个容易忽略的点。ST-Link的固件会随着IDE版本更新而更新。如果你发现Keil识别不到ST-Link，八成是固件太旧了。

升级方法：

1. 打开 STM32CubeProgrammer
2. 点击 Firmware Upgrade 按钮
3. 选择最新的固件版本，点击 Upgrade

2.4 printf重定向：让调试信息飞起来

嵌入式调试最原始的方法就是点灯。但点灯只能告诉你“程序跑到了这里”，却说不清楚“变量值是多少”。printf重定向就是解决这个问题的。

2.4.1 原理简述

C库里的printf最终会调用一个底层函数：fputc。我们只需要重写这个函数，把字符输出到串口（UART）即可。

2.4.2 代码实现

在工程里新建一个 retarget.c 文件，写入以下代码：

#include <stdio.h>
#include "stm32f1xx.h"

// 重定向fputc到USART1
int fputc(int ch, FILE *f)
{
    // 等待发送缓冲区空
    while (!(USART1->SR & USART_SR_TXE));
    // 发送一个字节
    USART1->DR = (ch & 0xFF);
    return ch;
}

// 如果需要scanf，还需要重定向fgetc
int fgetc(FILE *f)
{
    while (!(USART1->SR & USART_SR_RXNE));
    return (int)(USART1->DR & 0xFF);
}

2.4.3 使用示例

在主函数里初始化USART1后，就可以愉快地打印了：

int main(void)
{
    // 初始化USART1，波特率115200
    USART1_Init(115200);
    
    printf("System started!\r\n");
    printf("Current temperature: %d\r\n", temperature);
    
    while(1)
    {
        // 主循环
    }
}

2.5 本章知识体系

下面这张图把开发环境搭建的核心流程串起来了，你可以对照着检查自己哪一步还没做：

2.6 常见问题与排查