第二章 嵌入式开发环境搭建：Keil MDK安装、STM32CubeMX配置、J-Link驱动安装、工程模板建立

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

这一章，说白了就是搭台子。台子搭不好，后面唱戏全得摔跟头。我见过太多新手，一上来就急着写代码，结果编译报错找不到头文件、下载器连不上、芯片型号选错……折腾半天，信心全没了。

咱们一步一步来，把环境整利索了。

2.1 Keil MDK 安装——别小看这一步

Keil MDK，咱们做STM32开发最常用的IDE。我个人习惯用MDK 5.38版本，稳定，坑少。

注意： 安装路径不要带中文！不要带空格！我见过有人装到“D:\程序\Keil_v5”里，结果编译某些库文件时路径解析出错，查了半天。

安装步骤其实很简单：

  1. 双击安装包，一路Next
  2. 到License Management那一步，先跳过
  3. 安装完成后，打开Keil，用注册机生成许可证

嗯，这里有个小技巧。注册的时候，CID码一定要复制准确。我刚开始那会儿手敲，输错了一个字母，折腾了半小时才发现。

我的习惯： 装完Keil后，我会顺手把“C:\Keil_v5\UV4”加到系统环境变量PATH里。这样以后在命令行里直接敲“UV4”就能打开工程，省事。

2.2 STM32CubeMX 配置——图形化，真香

以前做STM32开发，得对着数据手册一个个寄存器去配。现在有了CubeMX，图形化点一点，代码就生成了。说白了，这就是个“偷懒神器”。

安装CubeMX之前，得先装好Java运行环境。为什么？因为CubeMX底层是Java写的。我记得有一次帮同事装，他死活打不开，最后发现是JDK版本不对。

推荐版本： Java 11 或 Java 17，别用最新的Java 21，CubeMX有时候兼容性有问题。

装好之后，打开CubeMX，咱们来配一个最简单的工程：

  1. 选择芯片：STM32F103C8T6（电梯门机常用这颗，性价比高）
  2. 配置时钟：外部8MHz晶振，倍频到72MHz
  3. 配置GPIO：PA0作为门到位信号输入，PB1作为电机控制输出
  4. 配置定时器：TIM2作为PWM输出，频率20kHz

配置完，点“Project Manager”，设置好工程名和路径。注意，Toolchain / IDE 要选 MDK-ARM V5。然后点“GENERATE CODE”，代码就生成了。

我曾经踩过的坑： 生成代码时，如果选了“Initialize all peripherals”，CubeMX会在main函数里自动加一堆初始化代码。但有时候这些初始化顺序不对，会导致外设冲突。我的做法是：只勾选“Generate peripheral initialization as a pair of .c/.h files”，然后自己在main里手动调初始化顺序。

2.3 J-Link 驱动安装——连不上？多半是驱动问题

J-Link，调试下载神器。但很多新手卡在这一步——插上J-Link，电脑没反应。

别慌，先检查驱动。

J-Link的驱动安装包叫“JLink_Windows_Vxxx.exe”，去SEGGER官网下最新的就行。安装时注意：

  • 如果用的是J-Link OB（板载版本），驱动会自动装好
  • 如果用的是独立J-Link，可能需要手动指定驱动路径

装好后，打开设备管理器，看看有没有“J-Link”或者“J-Link OB”设备。如果没有，那就是驱动没装上。

一个小技巧： 有时候驱动装上了，但Keil里还是识别不到。这时候可以试试“J-Link Commander”这个小工具。打开它，如果能识别到芯片，说明硬件没问题，问题出在Keil配置上。

2.4 工程模板建立——一次搭建，重复使用

好了，前面那些都装好了，咱们来建一个工程模板。以后每做一个新项目，直接复制这个模板，改改配置就行。

我个人习惯的模板结构是这样的：

Project_Template/
├── Core/
│   ├── Inc/          // 头文件
│   ├── Src/          // 源文件
│   └── Startup/      // 启动文件
├── Drivers/
│   ├── CMSIS/
│   └── STM32F1xx_HAL_Driver/
├── MDK-ARM/          // Keil工程文件
├── .cproject
└── .project

具体操作：

  1. 用CubeMX生成一个基础工程，芯片选STM32F103C8T6
  2. 只保留必要的HAL库文件，把用不到的驱动删掉（比如USB、ETH）
  3. 在Keil里配置好Flash Download算法，选“STM32F10x Med-density Flash”
  4. 配置Debug选项，选“J-Link / J-TRACE Cortex”，然后点“Settings”，确认SWD能识别到芯片
关键一步： 在Keil的“Options for Target” -> “C/C++”里，加上全局宏定义：USE_HAL_DRIVER, STM32F103xE。不加这个，编译会报一堆未定义错误。

模板建好后，编译一次，确保0错误0警告。然后把这个文件夹压缩备份。以后每做一个新项目，解压、改名字、改CubeMX配置、重新生成代码，就搞定了。

我的经验： 模板里最好预置一个“LED闪烁”的测试代码。每次新建项目，先下载这个测试代码，确认硬件和软件环境都正常，再开始写业务逻辑。这能帮你省下大量排查时间。

2.5 避坑指南——我当年犯过的错

最后，分享几个我亲身踩过的坑：

  • Keil版本不兼容： 有一次我用了MDK 5.40，结果某个老项目的库文件编译不过。后来发现是编译器版本升级后，某些语法检查更严格了。解决办法：要么升级库文件，要么用回老版本。
  • J-Link固件版本： 有些盗版J-Link，固件版本太老，连不上新芯片。我遇到过J-Link V8连STM32F4系列死活连不上，换了V9就好了。
  • 路径长度问题： Windows的路径长度限制是260个字符。如果工程路径太深，比如“D:\Projects\2024\Elevator_Door_Controller\Firmware\Source\...”，编译时会报“cannot open source file”。解决办法：把工程放在根目录下，比如“D:\DoorCtrl”。

嗯，环境搭建这块，说难不难，说简单也不简单。关键是要细心，每一步都确认无误再往下走。台子搭好了，后面咱们写代码、调参数，才能顺风顺水。

下一章，咱们开始讲STM32的GPIO和定时器配置——这可是电梯门机控制的核心。

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