1. STM32开发环境搭建：Keil MDK安装、STM32CubeMX配置、驱动安装与工程模板创建

说实话，很多初学者一上来就急着写代码，结果卡在环境搭建上大半天。我见过不少同事，装完Keil发现找不到芯片，或者CubeMX生成的代码编译报一堆错。其实环境搭好了，后面能省80%的调试时间。这一章，咱们就把地基打牢。

1.1 工具链全景图

先搞清楚我们要装哪些东西。别急着动手，心里有个谱再干。

核心工具链三件套：

  • Keil MDK-ARM —— 编译器+调试器，主力IDE
  • STM32CubeMX —— 图形化配置工具，生成初始化代码
  • 驱动与固件包 —— 让Keil认识你的芯片型号

下面这张图，把整个流程串起来了。你照着走就行。

STM32开发环境搭建流程 安装 Keil MDK-ARM 安装芯片固件包 安装 STM32CubeMX 配置工程 & 生成代码 创建工程模板 💡 避坑提示 安装顺序不要乱！ 先装Keil → 再装固件包 → 最后装CubeMX 否则可能识别不到芯片

1.2 Keil MDK-ARM 安装实战

Keil MDK 是ARM内核MCU的主流IDE。我个人习惯用MDK 5.38a版本，稳定，对STM32全系列支持都很好。

安装步骤

  1. 下载安装包 —— 去Keil官网（keil.com）下载MDK-ARM。注意选对版本，别下成C51了。
  2. 运行安装程序 —— 一路Next，路径建议用默认。我见过有人改到中文路径，结果编译报错找半天原因。
  3. 激活License —— 安装完会弹出License Management。输入你的授权码。如果是评估版，有32KB代码限制，但学基础够用。

⚠️ 我曾经踩过的坑：

安装路径不要带中文或空格！比如“D:\Keil_v5”没问题，但“D:\开发工具\Keil”就可能出幺蛾子。还有，杀毒软件会拦截注册机，装完先关掉杀软再激活。

1.3 芯片固件包安装

装完Keil你会发现，新建工程时找不到STM32F103或F407。为什么？因为Keil默认只带了ARM通用内核，具体芯片的SVD文件、Flash算法、启动文件都在固件包里。

两种安装方式

方式 操作 适用场景
在线安装 Keil内点击 Pack Installer → 搜索芯片型号 → Install 网络好，装单个型号
离线安装 下载 .pack 文件 → 双击安装 网络差，或批量部署

我个人推荐离线安装。去ST官网搜“STM32Cube FW F1”或“STM32Cube FW F4”，下载对应系列的固件包。一个包几百兆，但包含了所有外设驱动库和例程，后面写代码直接抄。

1.4 STM32CubeMX 配置与代码生成

CubeMX是ST官方的图形化配置工具。说白了，就是帮你省掉手写初始化代码的苦力活。你点点鼠标，它生成HAL库代码。

配置流程

  1. 新建工程 —— 选芯片型号，比如STM32F103C8T6。
  2. 配置时钟树 —— 我习惯先配HSE外部晶振，再配PLL倍频到72MHz。CubeMX会帮你算好，超频了它会标红。
  3. 配置外设 —— 比如USART1选异步模式，GPIO选推挽输出。每个引脚功能一目了然。
  4. 生成代码 —— 选Toolchain为MDK-ARM，点Generate Code。

💡 我的小技巧：

生成代码时，Project Settings里把“Generate Peripheral Initialization as a pair of .c/.h files”勾上。这样每个外设单独一个文件，后期维护方便。别把所有初始化都塞进main.c，不然改起来想哭。

1.5 驱动安装：ST-Link与USB转串口

代码写好了，怎么烧进去？怎么看到打印信息？这就靠驱动了。

ST-Link驱动

STM32开发板大多自带ST-Link。插上USB，如果电脑没识别，去ST官网下“ST-Link USB driver”。装好后，设备管理器里能看到“STMicroelectronics STLink dongle”。

USB转串口驱动

常用的CH340或CP2102。淘宝上几块钱的下载器基本都是CH340。驱动装好，设备管理器会出现“USB-SERIAL CH340”。波特率设115200，8N1，就能用串口助手看打印了。

⚠️ 注意：

Win10/Win11有时会自动装驱动，但自动装的版本可能不兼容。我遇到过CH340自动装成旧版，导致串口打不开。解决办法：去官网下最新驱动，手动更新。

1.6 工程模板创建

每次新建工程都从头配一遍？太浪费时间了。我习惯做一个通用模板，以后直接复制。

模板结构

Project_Template/
├── Core/
│   ├── Inc/          # 头文件
│   ├── Src/          # 源文件
│   └── startup/      # 启动文件
├── Drivers/
│   ├── CMSIS/        # 内核抽象层
│   └── STM32F1xx_HAL_Driver/  # HAL库
├── MDK-ARM/          # Keil工程文件
└── .mxproject        # CubeMX配置文件

创建步骤

  1. 用CubeMX生成一次完整工程，配好时钟、USART1、LED引脚。
  2. 把生成的文件夹复制一份，改名“Template”。
  3. 删掉CubeMX生成的main.c里用户代码，只保留初始化部分。
  4. 在main.c里加一个空循环，注释写好“User Code Begin 3”。

模板的好处：

  • 以后新项目直接复制，改芯片型号和引脚配置就行。
  • 时钟、调试接口、串口这些基础配置不用重复配。
  • 团队协作时，大家用同一个模板，代码风格统一。

1.7 验证：点亮LED

环境搭没搭好，跑个点灯程序就知道了。这是嵌入式界的“Hello World”。

/* main.c - 用户代码区域 */
int main(void)
{
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_USART1_UART_Init();

  while (1)
  {
    HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
    HAL_Delay(500);
  }
}

编译通过，下载到板子。如果LED以0.5秒间隔闪烁，恭喜你，环境搭建成功！

💡 如果灯不亮：

先检查ST-Link驱动是否正常。再查CubeMX里LED引脚配置对不对。我遇到过新手把引脚配成开漏输出，结果灯死活不亮。改成推挽输出就好了。

嗯，环境搭建这部分就到这。工具链装好了，模板也建好了，后面咱们就可以专心搞中断管理和性能调优了。记住，基础打牢，后面才飞得起来。

← 上一章 📖 返回目录 下一章 →