2. CMS32单片机基础

好，咱们正式开始动手。这一章说白了就是“把家伙事儿备齐”。我见过太多学员，代码写得挺溜，结果卡在环境配置上，一卡就是半天。咱们今天就把这事一次性理顺。

2.1 Keil MDK 安装与配置

Keil MDK 是 ARM 内核单片机开发的主流 IDE，CMS32 系列基于 ARM Cortex-M0+ 内核，所以选它没错。我个人习惯用 MDK 5.38 或更新版本，太老的版本对 CMS32 的器件包支持不好。

2.1.1 安装步骤

1. 下载安装包：去 Keil 官网（www.keil.com）下载 MDK-ARM 最新版。注意区分版本，别下成 C51 了。
2. 运行安装程序：一路 Next，路径建议用默认的 C:\Keil_v5。我曾经手贱改到中文路径，结果编译报错找不到头文件，折腾了俩小时。
3. 激活 License：安装完后打开 Keil uVision，点击 File → License Management，输入你的 License ID Code（正版或教育版）。没 License 也能用，但有 32KB 代码限制，咱们 CMS32 的 Bootloader 项目很容易超。
4. 安装器件包：点击 Pack Installer 图标，在搜索框输入“CMS32”，找到对应的 Device Family Pack 并安装。如果网速慢，也可以去中微半导体官网手动下载 .pack 文件，然后双击安装。

2.1.2 工程配置要点

新建工程时，选对芯片型号是关键。CMS32 系列常见型号有 CMS32M53xx、CMS32L05x 等，具体看你手上的开发板。我建议在工程创建后，先检查一下这几个配置：

配置项	推荐设置	说明
Target → ARM Compiler	Use default compiler version 6	V6 编译器优化更好，代码更小
Output → Select Folder for Objects	建议单独建 Obj 文件夹	避免源文件目录被编译中间件污染
C/C++ → Optimize	调试阶段选 -O0	优化等级太高会导致单步调试跳转混乱
Debug → Use Simulator / Use J-Link	选 J-Link / ULink	仿真器调试，后面会细说

2.2 CMS32 官方 SDK 获取与导入

中微半导体提供了完整的 SDK，里面包含了寄存器定义、外设驱动库、以及一些例程。说白了，就是官方帮你写好了底层，你直接调 API 就行。

2.2.1 获取 SDK

有两种方式：

• 官网下载：去中微半导体官网，找到“资料下载” → “CMS32 系列 SDK”，下载最新版本。我记得有一次官网改版，下载链接藏得挺深，你直接搜“CMS32 SDK”更快。
• 从 Pack 安装目录获取：安装完器件包后，SDK 通常会被解压到 C:\Keil_v5\ARM\PACK\ZhongMicro\CMS32_DFP\版本号\ 目录下，里面就有 Library 和 Examples 文件夹。

2.2.2 导入工程模板

我个人习惯不从头新建工程，而是直接用 SDK 里的模板工程改。原因很简单——模板里已经把启动文件、链接脚本、系统时钟配置都弄好了，你直接加自己的代码就行。

操作步骤：

1. 找到 SDK 中的 Examples\GPIO\LED_Blink 文件夹。
2. 复制整个文件夹到你自己的工作目录，重命名为 CMS32_Bootloader_Project。
3. 双击打开 .uvprojx 文件，Keil 会自动加载工程。
4. 在 Project 窗口中，右键 Target1 → Manage Project Items，按你的需求添加 User、Bootloader、App 等分组。

2.3 调试器连接与验证

调试器是开发者的“眼睛”。没有它，你写代码就像蒙着眼走路。咱们主要用 J-Link 和 ULink，这里以 J-Link 为例。

2.3.1 硬件连接

CMS32 开发板通常有标准的 20-pin SWD 接口。接线很简单：

• VCC → 开发板 3.3V
• GND → 开发板 GND
• SWDIO → 开发板 SWDIO
• SWCLK → 开发板 SWCLK

嗯，这里要注意：有些开发板需要外部供电，J-Link 的 VCC 只做电平参考，不提供大电流。我遇到过有人直接用 J-Link 给板子供电，结果电流不够，芯片反复复位，根本连不上。

2.3.2 Keil 调试配置

在 Keil 里点 Project → Options for Target → Debug：

1. 右侧选择 J-Link / J-Trace Cortex。
2. 点击 Settings，在 Debug 选项卡里，Port 选 SW（不是 JTAG），Max Clock 建议先设 1MHz，稳定后再往上调。
3. 切换到 Flash Download 选项卡，勾选 Reset and Run，这样下载完程序后芯片自动运行。

2.3.3 验证：点灯测试

配置完成后，咱们写个最简单的点灯程序验证一下。打开 SDK 里的 main.c，找到 GPIO 初始化部分：

#include "CMS32_GPIO.h"

void GPIO_Init(void)
{
    // 使能 GPIOB 时钟
    SYSCTRL->AHBEN |= (1 << 1);
    
    // 配置 PB0 为推挽输出
    GPIOB->DIR |= (1 << 0);
    GPIOB->OD |= (1 << 0);  // 初始高电平，LED 灭
}

int main(void)
{
    GPIO_Init();
    
    while(1)
    {
        GPIOB->OD ^= (1 << 0);  // 翻转 PB0
        Delay(1000000);          // 简单延时
    }
}

编译通过后，点击 Download 按钮。如果一切正常，你会看到开发板上的 LED 开始闪烁。那一刻，嗯，心里踏实了。

2.4 本章知识体系

下面这张图把整个开发环境搭建的流程串起来了，你可以对照着检查自己走到哪一步了。

2.5 常见问题与避坑

最后，我把这些年遇到的环境搭建问题列一下，你碰到了直接对照排查：

问题现象	可能原因	解决办法
编译报错 #include <CMS32.h> 找不到	器件包未安装或路径未包含	检查 Pack Installer 是否安装成功，或在 C/C++ 选项卡中添加 Include Paths
下载时报 Flash Timeout	复位电路问题或 SWD 时钟太高	检查复位引脚上拉，SWD 时钟降到 100kHz 试一下
调试器识别不到芯片	接线错误或芯片进入低功耗模式	按住复位键再点连接，或者给芯片重新上电
LED 不闪烁	GPIO 引脚号或时钟使能不对	对照原理图确认 LED 接在哪个 GPIO 上，检查时钟寄存器