小华半导体 HC32 开发指南

编制日期 2026-10-14

从 DDL 包装不起来、启动文件 missing、时钟配不到目标频率、SWD 被占用锁死，一路到量产烧录、QSPI 外挂存储与三相 FOC —— 一份把「第一次上手会踩的坑」全部前置的工程手册

结论：HC32 是国产 MCU 里模拟外设密度与电机 PWM 能力最突出的一支—— 小华把大量资源压在 PGA / OPA / CMP / 高 MSPS ADC 与互补 PWM 上，空调室外机、洗衣机、变频电机、数字电源这类场景的性价比明显优于同主频竞品。 但上手门槛有三个真实的坎：① 官方 DDL 包只给工程容器不给启动文件，Keil 新工程必然报 missing startup file；② 没有 CubeMX 式配置器，时钟树得照着 CMU 手册一格格算；③ GPIO 必须 PORT_Init() 与 PORT_SetFunc() 成对调用，只调前者引脚完全没反应。 本文按「装环境 → 建工程 → 编译 → 下载 → 调试 → 跑业务 → 量产」的真实顺序组织，每一段都给出可复制的命令、可对照的表格、以及该段最常踩的坑。

报告总结

小华的资料在官网分得很细：数据手册（DS）讲电气与引脚、参考手册（RM）讲寄存器、DDL 驱动库含几十个外设模块与例程，而 Keil DFP 又是独立的 .pack 安装包。网上的中文教程绝大多数停留在「装 DFP → 新建工程 → 点编译 → 点下载」，一旦遇到启动文件找不到、引脚没反应、时钟配不出 200MHz、串口 DMA 收不到数据就无解。本文档做了三件官方分散文档没有做的事：

• 把分散在官网、DS、RM、DDL、社区博客里的事实合并成一份可检索清单，并逐条标注「已核实 / 社区口径 / 待核」，避免把博客里的猜测当规格书用。
• 把「症状 → 原因 → 处置」写成可查的表：22 条高频故障按编译期 / 烧录期 / 运行期分层，每条给根因与最小验证动作。
• 专门补齐外挂存储与电机控制两条实战线：QSPI 接 SPI NOR 的引脚落点与 XIP 窗口、SDIO 挂 SD NAND / eMMC 的资源预算、三相 FOC 对定时器与模拟通道的占用清单。

读者路径

本指南按「你现在卡在哪一步」组织，不必从头读：

1 · 文档导读与阅读路径

先说清楚这份文档管什么、不管什么，避免你在第 6 章卡住时回头翻第 20 章。

1.1 覆盖范围

覆盖以下型号与内容：

1.2 不覆盖什么

为了避免误导，以下内容明确不在本文档范围内：

• 寄存器位级参考。本文只列「哪个模块有哪些资源、配置顺序是什么」，具体位定义请查对应型号的参考手册（RM）。
• 电气认证与安规。EMC/ESD 等级引用 DS 数值，但整机认证不在讨论范围。
• 官方图形化配置工具。截至本文编写日期，本次核查未发现小华官方提供类似 STM32CubeMX 的配置与代码生成工具；若后续官网下载中心上线离线工具，以官方为准。
• 车规 AEC-Q100 认证细节与 ISO 26262 功能安全流程。
• 具体型号的完整料号表。本文只列代表性型号，量产选型请以官网选型表为准。

1.3 版本与命名约定

文中出现的三类词严格区分，别混用：

另外，厂商标识有个历史遗留：资料包、器件头文件与 Keil 器件包里的厂商前缀仍是 HDSC（华大半导体），而品牌已改为「小华半导体 / XHSC」。下载时不要因为 HDSC. 前缀而以为下错了厂商。

1.4 事实来源与免责

本文事实来源按优先级排序：

1. 小华半导体官网产品线页与型号页（产品特性表、选型表）；
2. 官方数据手册：HC32F460 DS 版本号 Rev1.42/Rev1.60、HC32F4A0 DS Rev1.50/Rev1.60、HC32L13x DS Rev2.1；
3. Keil MDK 官方器件页；
4. openEuler drv-frame 开源仓库中的 HC32F460 平台移植层源码（DDL 版本宏、启动文件、链接脚本段名）；
5. 工程师实践帖（标记为「社区」，只用于补充工程经验）。

本文不构成设计建议。量产项目请以你手上型号的最新版数据手册、参考手册与官方例程为唯一依据。

2 · HC32 家族全景与选型

先把「HC32 到底有多少个系列」这件事搞清楚，再谈型号选择。这一章的表是全文引用的基础。

2.1 一句话认识小华 HC32

小华半导体（XHSC）是中国的 32 位 MCU 供应商，产品线覆盖 Cortex-M0 / M0+ / M4 三个档次。它最有辨识度的地方不是主频，而是把大量模拟资源与电机 PWM 能力做进了中低端型号：

• HC32F448（200MHz M4）能同时提供三相互补 PWM、3 单元 12bit 2.5MSps ADC、2 路 DAC 与 4 路比较器，实现「压缩机 + 风机 + 高频 PFC」三合一单芯片控制；
• HC32L136（M0+@48MHz）在 64KB Flash / 8KB SRAM 的体量上放了 3 个运放、2 路带 6bit DAC 的电压比较器、LCD 驱动与 2 路可在深度休眠下工作的 LPUART，深度休眠 0.5µA；
• HC32F4A0（240MHz M4）更极端：4 个 15MSPS DAC、4 个 PGA、8 个 DCU 协处理单元、数学协处理器 MAU 与 16 阶 FIR 滤波器。

理解了这个取向，选型逻辑就简单了：凡是「电机 + 模拟采样 + 成本敏感」的场景，先看小华有没有对口型号，往往比先看主频更有效。

2.2 命名规则怎么读

型号不是随机编码，拆开看基本能推出定位：

2.3 产品线总览

官网产品线页把 MCU 分成四大类共 14 条子线。选型时先定类别，再定档次：

2.4 旗舰 F4A0：240MHz 与 2MB Dual-bank

HC32F4A0 是小华当前的性能天花板，2024 年获 AspenCore/IIC Shanghai 中国 IC 设计成就奖「年度最佳 MCU」，累计出货近 3000 万颗。关键特性（官方 DS Rev1.60）：

2.5 通用主力 F460：200MHz 的均衡之选

HC32F460 是出货面最广的通用 M4，官方 DS Rev1.42 的特性：

F460 官方选型表覆盖 5 种封装，脚数从 48 到 100，Flash 从 256KB 到 512KB，全部 200MHz / 192KB SRAM：

2.6 超低功耗 L 系列：0.5µA 深度休眠

HC32L13x 是低功耗主力（官方 DS Rev2.1）。它最反直觉的地方是在 8KB RAM 的体量上塞了 3 个运放和 2 路带 6bit DAC 的比较器——这是为电池供电的传感器节点准备的：

参考型号：HC32L136K8TA、HC32L136J8TA、HC32L130F8UA、HC32L130E8PA、HC32L130J8TA、HC32L130J8UA。

2.7 电机与家电特色型号

这是小华最有竞争力的部分，官方与公开报道口径：

2.8 选型决策路径

把上面这些收敛成五个问题，从上往下问，命中即停：

• 先用类别字母筛掉一半：电池供电 → L；电机/电源 → M 或 F334；车规 → A；其余 → F。类别定了再看具体子线，能省 80% 的比对时间。
• 同系列内优先选大 Flash 那一档。F460 的 512KB 与 256KB 差价极小，而后期发现 Flash 不够的成本（改板、加外部器件、重做认证）远高于差价。
• 数完 ADC 通道和定时器通道再定封装。100 脚降到 48 脚时 ADC 从 16 通道掉到 10 通道，模拟项目最容易在这里翻车。
• 需要 CAN FD / 以太网 / USB HS / EXMC，直接上 F4A0，F460 没有这些。
• 量产前确认脱机烧录与 SWD 保护方案，别等到产线上才发现只有调试器直烧这条路。

3 · 内核与架构：Cortex-M 加上小华自有外设体系

HC32 的内核就是标准 ARM Cortex-M，所以「算力」和「生态」这两件事不用担心。真正需要重新理解的是外面那一层小华自研的外设体系。

3.1 Cortex-M0+ 与 M4F 的取舍

两个档次的选择非常清晰，选错了后面会很难受：

3.2 小华外设体系的命名逻辑

小华的模块前缀不是随机取的，有一条自己的规则。理解它之后，看手册目录就知道大概有哪些东西：

这张图要记住的核心是三件事：

1. 时钟管理叫 CMU，不是 RCC。你在 STM32 里所有 RCC_ 开头的调用，迁移时都要换成 CLK_ 系列。
2. 引脚模块叫 PORT，不是 GPIO。而且它不只管 GPIO，还管复用功能的选择 —— 这就是两步法的根源。
3. 模拟外设归在 MO 模块（ADC / OPA / CMP / DAC 相关的寄存器与 API 常以 MO 开头或归在 MO 章），不分散在各个外设里。

3.3 CMU 时钟管理模块

CMU 负责六件事：

1. 时钟源选择：六个源（见 10.1 节）里选一个作为 PLL 输入或系统时钟源；
2. PLL 控制：输入分频、倍频、输出分频，以及专用音频 PLL（供 I²S）；
3. 系统时钟切换：把选定的时钟源切到系统时钟（SWT），切换期间 CPU 会短暂停顿；
4. 总线分频：HCLK 与各 PCLK 的分频系数；
5. Flash 等待周期：主频升高后要插入等待周期，否则 Flash 读出错；
6. 时钟监控：CSS 时钟失效检测（时钟挂了能检测到）、时钟输出 MCO。

3.4 PWC 电源与时钟门控

PWC 是电源与时钟的门控枢纽，有三类职责：

• 外设时钟门控（FCG）：每个外设有一组 FCG 位，关掉就省电。移植时最常见的一类错误就是忘了开某个 FCG —— 写寄存器全无效果。
• 电源模式控制：进入 Sleep / Stop / Power down，以及唤醒后恢复。
• VBAT 与备份域：F4A0 有 VBAT 独立供电 + 128Byte 备份寄存器 + 4KB 备份 SRAM。

3.5 AOS 外设事件互触发

AOS（Analog to Digital / Event routing）是一个事件路由矩阵，让外设之间可以互相触发而不经过 CPU。典型用法：

• 定时器触发 ADC 采样 → 采样率由定时器节拍精确决定，抖动远小于软件触发；
• ADC 采样完成触发 DMA 传输 → 数据不落 CPU；
• ADC 转换完成触发定时器更新 → PWM 与采样严格同步，这对电机 FOC 的电流采样对齐是刚需。

3.6 协处理单元 DCU / MAU / FMAC

这是 F4A0 相对 F460 最明显的算力增量，做算法时可以省很多 CPU：

如果你的算法里大量是三角函数，F4A0 的 MAU 能直接吃下来；F460 只能用查表 + 插值。注意 F460 的 DAC 只有 2×8bit，做波形输出要谨慎。

3.7 与 STM32 的兼容边界

这是全章最实用的一节。按「能复用」和「必须重写」分开看：

换句话说，HC32 与 STM32 的兼容只到「指令集 + CMSIS 规范」这一层，往下全部要重写。把它当成「新建一个工程，只是 MCU 换了」，比当成「移植」来做，心态会好很多，成功率也高很多。

4 · 开发环境：DDL 驱动库与 Keil / GCC

这一章解决「装不起来」的问题。HC32 的环境安装有两个独立的包，加上一个历史遗留的坑。

4.1 官方资料包与版本

需要准备两样东西，缺一不可：

DDL 库内的版本宏定义在 hc32_ddl.h 中（社区移植源码实测）：

4.2 DDL 目录结构（两套并存）

这是最让人困惑的一点：不同来源拿到的 DDL 包，目录结构不一样，但说的是同一套东西。

4.3 启动文件与向量表

启动文件是第一个会绊住你的地方。官方包里它不在你以为的路径：

Error: #5: cannot open source input file "startup_HC32F460.s"

4.4 链接脚本与内存映射

链接脚本决定 Flash 与 SRAM 怎么划分。HC32F460 的链接脚本（社区移植版命名 hc32f460xe_flash.ld.s，x 是容量档代号）里有两个特殊段值得记住：

链接脚本还支持 bootloader / application 双模式宏切换，做 IAP 时必需 —— 用它把 BootLoader 与 App 的地址空间隔开。具体宏名请查你所用版本的链接脚本注释，本文不硬写版本相关的宏名。

4.5 Keil MDK 配置全流程

按这个顺序配，每一步都有验收标志：

1. 安装编译器组件。勾选 ARM Compiler 6（ARMCLANG） —— 官方示例工程默认用它。验收：Pack Installer 里能看到 ARMCC/ARMCLANG。
2. 安装 DFP。Pack Installer 搜索 HDSC.HC32F4xx_DFP 安装（社区包名，确切名称与版本以官网为准）。验收：器件树里能看到 HDSC 厂商与 HC32F460 系列。
3. 新建工程并选对器件。Project → New uVision Project，选 HDSC::HC32F460 对应型号。询问是否添加启动文件时选「否」，用 DDL 自带的。验收：工程树里出现设备名。
4. 加入源码与头文件路径。Include Paths 加：./driver/inc、./driver/src、./mcu、./CMSIS/Core/Include；Asm 的 Include Path 要加同样的路径，否则汇编找不到符号。
5. 定义全局宏。加 HC32F460；部分库版本还需 USE_DDL_DRIVER。验收：编译不报未定义宏。
6. 配置 Target。Xtal(MHz) 填实际外部晶振频率（默认 8）；必要时启用 MicroLIB。
7. 加载 Flash 算法。Flash Download 里添加 HC32F460 对应 .FLM（DFP 自带）。验收：没有 No Algorithm found 报错。
8. 加启动文件。按 4.3 节的四步做。验收：编译日志里能看到 assembling startup_*.s 与 __Vectors defined in startup_*.o。

4.6 GCC / openEuler drv-frame 路线

如果你偏好 GCC（免费、可进 CI、或需要 openEuler 这类上游社区支持），可行路径有两条：

drv-frame 的 DDL 版本宏、启动文件参数、链接脚本段名（见 4.3 / 4.4 节）就是从官方 DDL 抄过来的，可以作为交叉验证。

4.7 没有 CubeMX 该怎么办

没有生成器的情况下，把「可复用样板」自己攒起来是最划算的投资：把时钟配置、GPIO 初始化、串口重定向、Flash 封装这四段做成自己项目里的 bsp/ 模块，后面所有项目直接拷贝改，比每次重查手册快得多。本文第 5 章与附录 C 就是这套样板。

5 · 第一个工程：从新建到点亮 LED

目标：一小时内让 LED 亮、能下断点、并能通过串口打印。这一章的每一步都给出验收标志，卡住就停在那一步别往下走。

5.1 硬件前提

调试期最小系统只要四样东西：

5.2 工程目录组织

建议按下面组织，核心原则是DDL 当第三方库引用而不是搬进自己源码改：

这个结构的好处：升级 DDL 版本时只需替换库目录，不用解冲突；自己的业务代码与驱动代码边界清楚，出问题好定位。

5.3 点亮 LED 的六步

1. 确认时钟能跑对。上电后先读 SystemCoreClock，或用 MCO 示波器测输出频率。验收：数值与目标一致。时钟不对就不要往下走 —— 后面所有现象都会失真。
2. 配置 LED 引脚。两步都要写：PORT_SetFunc() 选功能 + PORT_Init() 配电气属性。验收：读回寄存器值符合预期。
3. 配好 SysTick 或定时器时基。SysTick_Init() 之后 SysTick_GetTick() 能返回递增的毫秒数。
4. 配置串口并重定向 printf（见 5.4 节）。验收：串口助手能看到 printf 输出。
5. 在 main() 里下第一个断点。验收：能停在 main() 入口，能单步走过时钟初始化而不跑飞。
6. 翻灯并加断言。用 GPIO_SetPins / GPIO_ClearPins（注意不是 STM32 的 SetBits/ResetBits）翻转，同时开 __DEBUG 断言。

LED 那一段代码的要点就三句：

/* 1. 复用功能与电气属性分开配置 —— 顺序可换，但两步都不能少 */
PORT_SetFunc(GPIOA, GPIO_PIN_05, Func_GPIO_Port);   /* 第 1 步：选功能 */
stc_port_init_t stcPortInit;
PORT_Init(GPIOA, &stcPortInit);                     /* 第 2 步：配电气属性 */

/* 2. 输出翻转：命名与 STM32 不同 */
GPIO_SetPins(GPIOA, GPIO_PIN_05);    /* 不是 GPIO_SetBits */
GPIO_ClearPins(GPIOA, GPIO_PIN_05);  /* 不是 GPIO_ResetBits */

5.4 printf 与串口重定向

DDL 自带 printf 支持，启用方式很简洁：

/* 1) 让能 printf：ddl_config.h 或编译宏里定义 */
#define DDL_PRINT_ENABLE    DDL_ON

/* 2) 初始化串口后调用一次 */
UART_PrintfInit();      /* 宏别名 DDL_PrintfInit */

/* 3) 之后直接用 printf 即可 */
printf("SystemCoreClock = %lu Hz\n", SystemCoreClock);

相关工具函数都在 hc32f460_utility.h：

5.5 编译产物与体积核算

第一次跑通后要做一次体积体检，把结论写进项目 README：

具体核对的三个数：

• Flash 占用 vs 型号容量（注意 F460 有 256KB 与 512KB 两档，选型时就该留余量）；
• SRAM 静态占用（data + bss）加上栈预留 vs 可用 SRAM。M0+ 型号尤其紧张，8KB SRAM 用掉 6KB 就该考虑换型号了；
• 哪些模块被链接进去了。ddl_config.h 里那些没关掉的模块会自动编译进来，白占体积 —— 靠 map 文件逐个确认。