2. 开发环境搭建：Keil MDK安装与配置、CMS32设备包安装、工程模板创建与验证

做嵌入式开发，第一件事就是把“家伙事儿”备齐。我记得刚入行那会儿，光装个Keil就折腾了一下午，版本不对、设备包没装、License死活激活不了……后来带新人，我总让他们先把环境搭好再聊别的。说白了，环境搭得顺不顺，直接影响你后面写代码的心情。

这一章，咱们就把CMS32的开发环境从头到尾捋一遍。跟着我的步骤走，别跳，基本不会出问题。

2.1 Keil MDK的安装与配置

Keil MDK（Microcontroller Development Kit）是ARM内核单片机最主流的IDE。CMS32系列用的是ARM Cortex-M0+内核，所以MDK是首选。我个人习惯用MDK 5.38或更新的版本，太老的版本对CMS32设备包支持不好。

2.1.1 获取安装包

去Keil官网（www.keil.com）下载MDK-Arm安装包。注意区分版本：

  • MDK-Essential：基础版，够用
  • MDK-Plus：带中间件
  • MDK-Professional：全功能

咱们做CMS32开发，MDK-Essential就足够了。别花冤枉钱买Plus或Pro，那些中间件你用不上。

2.1.2 安装步骤

  1. 双击安装包，选择安装路径。我建议别装C盘，万一重装系统全没了。我一般放D:\Keil_v5。
  2. 填写用户信息，随便填，别纠结。
  3. 等待安装完成，大概5-10分钟。
  4. 安装完成后，桌面会出现Keil uVision5图标。
⚠ 注意： 安装路径不要包含中文或空格！我曾经见过有人把路径写成“D:\开发工具\Keil MDK”，结果编译时各种奇葩报错。老老实实用英文路径。

2.1.3 License激活

Keil MDK需要License才能编译超过32KB的代码。CMS32的Flash通常64KB起步，所以必须激活。

  • 打开Keil，点击 File → License Management
  • 复制CID码
  • 用你的License生成器或正版Key生成激活码
  • 粘贴到New License ID Code，点击Add LIC

激活成功后，你会看到有效期。我建议截个图存着，万一重装系统还能找回。

2.2 CMS32设备包的安装

设备包（Device Family Pack）是Keil识别具体芯片的关键。没有它，你连芯片型号都选不到。CMS32的设备包由中微半导体提供，后缀是.pack。

2.2.1 获取设备包

有两种方式：

  • 在线安装：Keil自带Pack Installer，联网后搜索“CMS32”即可
  • 离线安装：从中微官网下载.pack文件，双击安装

我个人推荐离线安装。为什么？在线安装经常因为网络问题卡住，尤其是公司内网。我遇到过好几次下载到99%就断了，气得我直接去官网扒离线包。

2.2.2 安装步骤

  1. 双击.pack文件，Keil会自动识别并弹出安装界面
  2. 点击Next，等待安装完成
  3. 打开Keil，点击 Project → New uVision Project
  4. 在Device对话框中搜索“CMS32”，你会看到类似“Mirochip CMS32M53xx”的选项
💡 小技巧： 安装完设备包后，建议重启一次Keil。有些时候设备包加载不完全，重启能解决90%的“找不到芯片”问题。

2.3 工程模板创建与验证

环境搭好了，咱们来建个工程试试手。这一步很关键，后面所有章节的代码都基于这个模板。

2.3.1 创建新工程

  1. 打开Keil，点击 Project → New uVision Project
  2. 选择工程保存路径，我习惯建一个文件夹叫“CMS32_Projects”，里面按项目分
  3. 输入工程名，比如“CMS32_Template”
  4. 在Device对话框选择你的芯片型号，比如CMS32M5333
  5. 弹出Manage Run-Time Environment时，先别急着勾，直接点OK
📌 核心要点： 工程路径同样不要有中文！我见过有人把工程放在“桌面\我的项目”，结果编译报错“path contains invalid characters”。血的教训。

2.3.2 添加启动文件和核心代码

新建工程后，Keil会自动生成一个Target。你需要手动添加以下文件：

文件 说明 来源
startup_CMS32.s 启动文件，初始化堆栈和中断向量表 设备包自带
system_CMS32.c 系统时钟配置 设备包自带
CMS32.h 主头文件，包含所有寄存器定义 设备包自带
main.c 用户主程序 自己创建

添加方法：在Project窗口右键Source Group，选择 Add Existing Files to Group。

2.3.3 编写验证代码

咱们写一个最简单的点灯程序，验证环境是否正常。CMS32的GPIO操作很简单，直接操作寄存器。

// main.c
#include "CMS32.h"

void delay(volatile uint32_t count) {
    while(count--);
}

int main(void) {
    // 使能GPIOB时钟
    SYS->AHBEN |= (1 << 1);  // 假设GPIOB挂在AHB总线上
    
    // 配置PB0为推挽输出
    GPIOB->MODER &= ~(0x3 << (0 * 2));
    GPIOB->MODER |= (0x1 << (0 * 2));
    
    while(1) {
        GPIOB->ODR |= (1 << 0);   // PB0输出高电平
        delay(500000);
        GPIOB->ODR &= ~(1 << 0);  // PB0输出低电平
        delay(500000);
    }
}
⚠ 注意： 上面的代码是示例，实际CMS32的时钟使能和GPIO寄存器名称请参考芯片数据手册。不同型号的CMS32，外设基地址可能不同。一定要以你手里的芯片手册为准。

2.3.4 编译与下载验证

  1. 点击 Project → Build Target（或按F7）
  2. 观察Output窗口，如果显示“0 Error(s), 0 Warning(s)”，恭喜你，环境没问题
  3. 连接调试器（J-Link或CMS32专用调试器），点击 Debug → Start/Stop Debug Session
  4. 点击Run，观察开发板上的LED是否闪烁

如果LED没亮，别慌。先检查硬件连接，再检查GPIO配置。我遇到过最坑的一次是LED接反了，阳极接GND，阴极接IO口……嗯，那灯永远亮不了。

2.4 知识体系总览

下面这张图把本章的核心流程串起来了。你跟着这个路径走，环境搭建不会迷路。

CMS32开发环境搭建流程 CMS32开发环境搭建流程 ① Keil MDK安装 ② License激活 ③ CMS32设备包安装 ④ 创建工程模板 ⑤ 编译下载验证 💡 建议：每完成一步都验证一下，别等全装完了才发现问题

2.5 常见问题与避坑指南

  • 编译报错“target not created”：检查License是否激活，或者工程路径是否有中文
  • 找不到芯片型号：设备包没装对，或者Keil版本太旧。我建议用MDK 5.38以上
  • 下载失败：检查调试器驱动是否安装，接线是否正确。CMS32的SWD接口是SWDIO和SWCLK，别接反了
  • LED不亮：先量一下IO口电平，再用万用表测LED两端电压。我曾经被一个虚焊的LED坑了整整半天
🔧 我的习惯： 每次搭建新环境，我都会建一个“Hello World”工程——就是点灯。灯亮了，说明环境100%没问题。这个习惯帮我省了无数排查时间。
← 上一章 📖 返回目录 下一章 →