2. 嵌入式开发环境搭建：Keil MDK安装、STM32CubeMX安装、驱动安装、工程模板建立

好，咱们正式开始动手了。

这一章，说白了就是给你的电脑“武装”起来。没有趁手的工具，再牛的工程师也写不出代码。我见过不少新手，一上来就急着敲代码，结果环境没配好，折腾半天连个灯都点不亮。嗯，咱们别走那个弯路。

2.1 为什么选Keil MDK和STM32CubeMX？

你可能要问：开发工具那么多，为什么偏偏选这两个？

我个人习惯是这样的：Keil MDK 负责编译、下载、调试，它是咱们的“主战场”。而 STM32CubeMX 呢，是ST官方出的图形化配置工具，专门用来初始化芯片外设。你想想看，以前配置一个定时器要翻几百页数据手册，现在鼠标点几下就搞定了，多省心。

我在项目中遇到过好几次，客户临时要改引脚功能。要是没有CubeMX，我得手动改寄存器，改完还得重新检查冲突。有了它，改个配置、重新生成代码，几分钟的事。

核心思路： CubeMX负责“画图纸”，Keil负责“盖房子”。两者配合，效率翻倍。

2.2 Keil MDK安装——别踩这些坑

Keil MDK，全称是MDK-ARM，专门用来开发ARM内核的芯片。咱们用的STM32就是ARM Cortex-M内核，所以选它没错。

2.2.1 下载与安装

  1. 去官网下载：搜索“Keil MDK Download”，找到ARM版。别下成C51了，那是给51单片机用的。
  2. 安装路径：我建议别用中文路径。以前有个同事，装在了“D:\开发工具\Keil_v5”，结果编译老报错，查了半天是路径里的中文闹的。
  3. 一路Next：安装过程很简单，默认选项就行。唯一要注意的是，安装完成后会弹出一个“Pack Installer”窗口，别急着关。

2.2.2 注册与破解

嗯，这里得说实话。Keil MDK是收费软件，但官方提供了评估版，代码大小限制在32KB以内。咱们做入门学习，32KB完全够用。

如果你需要解除限制，网上有注册机。但我得提醒一句：商用项目请购买正版。我曾经在一个小公司，因为用了盗版被查，罚了十几万，得不偿失。

注意： 注册时，CID号要填对。填错了生成的注册码无效。我见过有人对着屏幕数了五遍CID，还是输错了——别笑，你可能也会这样。

2.3 STM32CubeMX安装——图形化配置利器

CubeMX是ST官方的免费工具，这点很良心。它不仅能配置引脚、时钟、外设，还能自动生成初始化代码。

2.3.1 安装步骤

  1. 下载安装包：去ST官网搜“STM32CubeMX”，下载最新版。需要注册一个ST账号，免费的。
  2. 安装Java环境：CubeMX基于Java，所以你得先装JDK或JRE。版本要求Java 8以上。我建议装JDK 11，稳定。
  3. 安装CubeMX：双击安装包，选好安装路径。同样，别用中文路径。
  4. 安装固件包：打开CubeMX，点击“Help” -> “Manage embedded software packages”。找到你用的芯片型号，比如STM32F103，下载对应的固件包。这一步很关键，没有固件包，CubeMX就是个空壳。

小技巧： 固件包很大，下载慢的话，可以晚上挂机下载。我一般睡觉前点下载，第二天早上就好了。

2.4 驱动安装——让电脑认识你的开发板

开发板插上电脑，没反应？别慌，多半是驱动没装。

2.4.1 常用的驱动类型

驱动名称 适用场景 备注
ST-Link驱动 ST官方调试器 大部分STM32开发板自带
CH340/CP2102驱动 USB转串口模块 便宜开发板常用
J-Link驱动 第三方调试器 性能好，但贵

我个人建议，新手先用ST-Link。它稳定、便宜，而且Keil MDK直接支持，不用额外配置。

2.4.2 安装方法

  1. ST-Link驱动：安装Keil MDK时，会自动安装ST-Link驱动。如果没装成功，可以去ST官网下载“ST-Link Utility”，里面自带驱动。
  2. CH340驱动：淘宝上买的几块钱的USB转串口模块，基本都是CH340芯片。去搜索“CH340驱动”，下载安装就行。注意，Windows 10/11有时会自动安装，但最好手动装一次，确保版本最新。
  3. 检查驱动：插上开发板，打开“设备管理器”。如果看到“端口(COM和LPT)”下面有设备，说明驱动装好了。如果看到黄色感叹号，那就是驱动有问题。

避坑指南： 我曾经遇到过，驱动装好了，但Keil就是识别不到开发板。折腾了半天，发现是USB线的问题——那根线只能充电，不能传数据。所以，请用质量好一点的USB线。

2.5 工程模板建立——磨刀不误砍柴工

每次新建项目都从头配置？太累了。我习惯建立一个工程模板，以后直接复制粘贴。

2.5.1 用CubeMX生成初始化代码

  1. 新建项目：打开CubeMX，点击“New Project”。在“Part Number”里输入你的芯片型号，比如STM32F103C8T6。
  2. 配置时钟：进入“Clock Configuration”页面。我一般选外部晶振（HSE），然后让CubeMX自动计算时钟树。记得把主频调到芯片允许的最高值，比如72MHz。
  3. 配置引脚：在“Pinout & Configuration”页面，把需要用到的外设打开。比如LED灯接在PC13，那就把PC13设为GPIO_Output。
  4. 生成代码：点击“Project” -> “Generate Code”。在“Project Settings”里，选好工具链为“MDK-ARM V5”。然后点“Generate”。

关键点： 生成代码时，CubeMX会创建一个文件夹，里面包含启动文件、系统文件、外设驱动库。这些就是咱们工程模板的基础。

2.5.2 在Keil中建立模板

  1. 打开项目：在生成的文件夹里，找到后缀为“.uvprojx”的文件，双击用Keil打开。
  2. 添加用户代码：在“Application/User”文件夹下，新建一个“main.c”。把CubeMX生成的main.c里的内容复制进去。注意，不要修改CubeMX生成的代码段，它们有特殊的注释标记。
  3. 配置编译选项：点击“Project” -> “Options for Target”。在“Target”标签页里，选好芯片型号。在“C/C++”标签页里，把优化等级设为“-O0”（调试阶段别开优化，不然单步执行会跳来跳去）。
  4. 编译测试：按F7编译。如果没报错，恭喜你，模板建好了。

2.5.3 模板的目录结构

我习惯把模板整理成这样的结构：

Project_Template/
├── Drivers/          # 外设驱动库（CubeMX生成的）
├── Inc/              # 头文件
├── Src/              # 源文件
│   ├── main.c
│   ├── stm32f1xx_it.c
│   └── ...
├── MDK-ARM/          # Keil项目文件
└── .mxproject        # CubeMX配置文件

以后做新项目，直接复制这个文件夹，改个名字，然后在CubeMX里打开“.mxproject”文件，修改配置，重新生成代码就行。

我的习惯： 模板里我会放一个“LED_Blink”的测试代码。每次新建项目，先下载这个代码，确保硬件和软件环境都没问题。这叫“冒烟测试”——如果灯都不亮，后面就不用做了。

2.6 常见问题与解决

  • 编译报错“Error: L6218E: Undefined symbol”：多半是某个.c文件没添加到项目里。去Keil的“Project”窗口检查一下。
  • 下载报错“No ST-Link detected”：驱动没装好，或者USB线有问题。重新装驱动，换根线试试。
  • CubeMX生成代码后，Keil打不开：版本不匹配。CubeMX生成时选“MDK-ARM V5”，Keil也要用V5版本。

嗯，环境搭建这块，说难不难，说简单也容易卡住。我当年第一次装Keil，折腾了整整一个下午，最后发现是杀毒软件把注册机当病毒删了。所以，装软件时暂时关掉杀毒软件，能省不少时间。

下一章，咱们就要开始写真正的代码了。到时候，你会感谢今天花时间把环境搭好的自己。

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