第三章 开发环境搭建：Keil MDK安装与配置、GCC工具链使用、调试器配置

好，咱们直接进入正题。做继电保护装置开发，第一步就是把吃饭的家伙——开发环境给整利索了。我见过不少新手，代码写得挺溜，结果卡在环境搭建上，一卡就是半天。说实话，这玩意儿真没那么玄乎，但细节确实不少。

这一章，我带你把 Keil MDK、GCC 工具链、还有 J-Link 和 ST-Link 这两个调试器，从头到尾捋一遍。嗯，跟着我的节奏来，保证你少踩坑。

3.1 Keil MDK 的安装与配置

Keil MDK，说白了就是 ARM 单片机开发最主流的 IDE。尤其是我们做继电保护，很多老项目、成熟方案都跑在 Keil 上。我个人习惯，只要芯片是 ARM Cortex-M 系列，首选就是它。

3.1.1 安装步骤

安装其实很简单，但有几个关键点你得注意：

  1. 版本选择：我个人建议用 MDK 5.38 或更新版本。太老的版本对新型号芯片支持不好。我在项目中遇到过，用 MDK 5.26 死活编译不过新出的某款国产芯片，换了 5.38 就好了。
  2. 安装路径：千万别带中文！千万别带空格！我见过有人装到 "D:\开发工具\Keil_v5" 这种路径，结果编译时各种莫名其妙报错。老老实实用 "D:\Keil_v5" 或者 "C:\Keil_v5"。
  3. 组件选择：安装时，记得勾选上 "C51" 和 "C251" 吗？不，我们做 ARM 的，只勾 "MDK-ARM" 那一项就够了。其他用不到，别浪费硬盘。
警告： 安装完成后，记得用管理员身份运行一次 Keil uVision。否则后续添加芯片包、配置调试器时，可能会提示权限不足。我曾经因为这个折腾了半小时，最后发现就是右键 "以管理员身份运行" 一下的事。

3.1.2 芯片包（Pack）安装

Keil 本身不带芯片支持，你得装对应的 Pack。比如我们做继电保护，常用 STM32F4、STM32H7 或者国产的 GD32、AT32 系列。

操作很简单：

  • 打开 Keil，点击菜单栏的 Pack Installer 图标。
  • 在搜索框输入你的芯片型号，比如 "STM32F407"。
  • 找到对应的 Pack，点击 Install。

这里有个小技巧：离线安装。如果你在公司内网，或者网速慢，可以去 Keil 官网下载 Pack 的 .pack 文件，然后双击安装。速度比在线装快多了。

3.1.3 工程配置要点

新建工程时，有几个配置项我建议你一开始就设好，省得后面改来改去：

配置项 推荐设置 说明
Target - ARM Compiler Use default compiler version 6 V6 编译器优化更好，代码更小。V5 虽然兼容性好，但新项目建议直接用 V6。
Output - Executable 勾选 "Create HEX File" 生成 .hex 文件，用于烧录。不勾的话，你拿什么烧到板子上？
C/C++ - Optimize 调试阶段选 "None (-O0)"，发布阶段选 "Optimize for Size (-Os)" 调试时别开优化，否则变量值都看不到。发布时用 -Os，代码最小，适合 Flash 紧张的继电保护装置。
Debug - Use 根据你的调试器选 "J-LINK / J-TRACE Cortex" 或 "ST-Link Debugger" 这个后面细说。
提示： 我个人习惯在工程目录下建一个 "User" 文件夹，把所有自己写的 .c 和 .h 文件放进去。Keil 的工程文件 (.uvprojx) 放在根目录。这样结构清晰，多人协作时也不容易乱。

3.2 GCC 工具链的使用

说到 GCC，很多做继电保护的老工程师可能不太熟。毕竟 Keil 用惯了。但说实话，GCC 在开源生态、跨平台编译、以及一些国产芯片的支持上，有它独特的优势。我建议你至少了解一下，关键时刻能救命。

3.2.1 为什么需要 GCC？

你想想看，Keil 是收费的，而且只支持 Windows。如果你需要在 Linux 服务器上做自动化编译，或者用 Jenkins 做持续集成，那 GCC 就是唯一的选择。我在项目中就遇到过，客户要求所有代码必须在 Linux 环境下编译通过，否则不给验收。没办法，硬着头皮上了 GCC。

3.2.2 安装 GCC 工具链

ARM 的 GCC 工具链，最常用的是 arm-none-eabi-gcc。安装方式：

  • Windows：去 ARM 官网下载 "GNU Arm Embedded Toolchain" 的 Windows 安装包。安装时记得勾选 "Add path to environment variable"。
  • Linux：直接 apt-get 或 yum 安装。比如 Ubuntu 上：sudo apt-get install gcc-arm-none-eabi。

装完后，打开命令行，输入 arm-none-eabi-gcc --version，能看到版本号就说明装好了。

3.2.3 编译一个简单的工程

假设你有一个 main.c 文件，想用 GCC 编译成 .hex 文件。命令大概是这样的：

arm-none-eabi-gcc -c -mcpu=cortex-m4 -mthumb -O0 -o main.o main.c
arm-none-eabi-ld -T link.ld -o output.elf main.o
arm-none-eabi-objcopy -O ihex output.elf output.hex

嗯，看着有点复杂对吧？别急，实际项目中我们不会手敲这些命令。我们会用 Makefile 或者 CMake 来管理。这里我简单说一下关键点：

  • -mcpu=cortex-m4：指定 CPU 型号。继电保护装置常用 M4 或 M7 内核。
  • -mthumb：使用 Thumb-2 指令集。ARM 模式在 Cortex-M 上已经不用了。
  • -T link.ld：链接脚本。这个文件定义了 Flash、RAM 的地址和大小。每个芯片都不一样，得自己写或者从芯片厂商的 SDK 里拿。
重点： 链接脚本 (.ld) 是 GCC 编译中最容易出错的地方。我建议你第一次用 GCC 时，直接从芯片厂商的官方例程里复制一份，然后根据你的硬件修改 Flash 和 RAM 的大小。千万别自己从头写，容易翻车。

3.2.4 GCC 与 Keil 的差异

如果你习惯了 Keil，刚切到 GCC 时可能会有些不适应。我列几个常见的坑：

  • 语法检查更严格：GCC 对 C 标准的遵循更严格。比如 // 注释在 Keil 里没问题，但在 GCC 的某些老版本里可能报错。建议统一用 /* */。
  • 内联汇编语法不同：Keil 用 __asm，GCC 用 __asm__。而且寄存器名前面要加 % 符号。这个得注意。
  • 优化选项不同：Keil 的 -O0 和 GCC 的 -O0 行为基本一致，但 -Os 的优化策略有细微差别。建议在发布前，用两种工具链分别编译，对比一下生成的代码大小。

3.3 调试器配置：J-Link 与 ST-Link

调试器，说白了就是连接电脑和开发板的桥梁。没有它，你写的代码就是一堆死文字。继电保护装置开发中，最常用的就是 J-Link 和 ST-Link。

3.3.1 J-Link 配置

J-Link 是 SEGGER 公司的产品，稳定、速度快，支持几乎所有 ARM 芯片。我个人最喜欢用它，尤其是调试复杂的中断时序时，J-Link 的实时跟踪功能特别好用。

在 Keil 中配置 J-Link：

  1. 点击 Project - Options for Target - Debug。
  2. 在 "Use" 下拉框中选择 "J-LINK / J-TRACE Cortex"。
  3. 点击旁边的 "Settings" 按钮。
  4. 在 "Debug" 选项卡中，确认 "Port" 选的是 "SW"（SWD 模式），"Max Clock" 建议先选 1MHz。如果连接不稳定，再降低。
  5. 在 "Flash Download" 选项卡中，点击 "Add"，添加你芯片对应的 Flash 算法。比如 STM32F407 就选 "STM32F4xx Flash"。
警告： 连接 J-Link 时，一定要注意接线顺序。SWD 接口只需要 4 根线：SWDIO、SWCLK、GND、VCC（可选）。我见过有人把 SWDIO 和 SWCLK 接反了，结果调试器死活连不上。嗯，别问我怎么知道的。

3.3.2 ST-Link 配置

ST-Link 是 ST 公司为 STM32 做的调试器，便宜、够用。如果你用的是 STM32 芯片，直接用 ST-Link 就行，没必要花冤枉钱买 J-Link。

在 Keil 中配置 ST-Link：

  1. 同样进入 Project - Options for Target - Debug。
  2. 选择 "ST-Link Debugger"。
  3. 点击 "Settings"，在 "Debug" 选项卡中，同样选 "SW" 模式。频率建议选 1.8MHz 或 4MHz，太高了容易不稳定。
  4. 在 "Flash Download" 中，同样添加对应的 Flash 算法。

这里有个区别：ST-Link 的固件需要更新。尤其是你买了新的 STM32 开发板，或者 ST-Link 版本比较老时，建议去 ST 官网下载 "STM32CubeProgrammer"，用它来更新 ST-Link 的固件。我遇到过 ST-Link 连不上电脑，更新固件后就好了。

3.3.3 调试器常见问题排查

调试器连不上，是新手最常遇到的问题。我总结了一个排查清单：

现象 可能原因 解决方法
Keil 提示 "No J-Link found" 驱动没装好，或 USB 线有问题 重新安装 J-Link 驱动，换一根 USB 线试试
连接成功，但下载失败 Flash 算法选错了，或芯片被锁 检查 Flash 算法是否匹配；用 J-Link Commander 解锁芯片
下载成功，但程序不跑 复位电路有问题，或 Boot 引脚配置错误 检查复位引脚电平；确认 BOOT0 和 BOOT1 引脚接地
调试时无法设置断点 优化等级太高，或代码在 RAM 中运行 编译时用 -O0；确认断点地址在 Flash 范围内
提示： 如果你用的是国产芯片，比如 GD32、AT32，调试器配置和 STM32 基本一样。但要注意，有些国产芯片的 Flash 算法需要单独安装。去芯片厂商的官网下载对应的 Keil Pack 或 GCC 支持包即可。

3.4 环境验证：跑一个点灯程序

环境搭好了，调试器也配好了，怎么知道一切正常？最简单的方法——点灯。让 LED 闪烁，是嵌入式开发的 "Hello World"。

我写一个最简单的例子，你直接复制到 Keil 或 GCC 工程里试试：

#include "stm32f4xx.h"

void delay(void) {
    for (uint32_t i = 0; i < 500000; i++);
}

int main(void) {
    // 使能 GPIOD 时钟
    RCC->AHB1ENR |= RCC_AHB1ENR_GPIODEN;
    // 配置 PD12 为推挽输出
    GPIOD->MODER |= GPIO_MODER_MODER12_0;
    GPIOD->OTYPER &= ~GPIO_OTYPER_OT_12;
    GPIOD->OSPEEDR |= GPIO_OSPEEDER_OSPEEDR12;

    while (1) {
        GPIOD->BSRR = GPIO_BSRR_BS_12;  // 点亮 LED
        delay();
        GPIOD->BSRR = GPIO_BSRR_BR_12;  // 熄灭 LED
        delay();
    }
}

编译、下载、运行。如果 LED 开始闪烁，恭喜你，环境搭建成功了！如果不闪，别慌，按上面的排查清单一步步查。我当年第一次点灯，折腾了整整一个下午，最后发现是 LED 的正负极接反了……

嗯，这一章的内容就到这里。环境搭建是基础，基础打牢了，后面写代码才顺手。下一章，我们开始讲继电保护装置的软件架构设计，那才是真正有意思的部分。

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