[SOP] HC32系列 VSCode+EIDE+GCC 极速搭建指南：基于官方应用笔记 Rev1.01

发表于 更新于 分类于 ，
手把手教你如何在 Windows/Linux 上摆脱 Keil，使用 VSCode + EIDE + GCC 工具链开发华大 HC32 系列 MCU。包含关键的 Linker 路径修复和 Cortex-Debug 配置。

前言

小华半导体 (XHSC) 官方提供了一份应用笔记，指导在 VSCode 上使用 GCC 开发 HC32 系列 MCU。虽然文档详细，但步骤繁琐。

本文提炼出一条**“最短路径”** SOP，帮助大家快速跑通编译与调试流程。

核心组件：

  1. ARM GCC Toolchain: 编译器 (10.3-2021.10)
  2. EIDE 插件: 项目管理与构建系统
  3. Cortex-Debug 插件: 调试器前端

一、准备工作 (Prerequisites)

1. 下载 ARM GCC 工具链

  • 版本: 10.3-2021.10 (官方推荐)
  • 下载: ARM 官网
  • 安装路径 (Critical): 建议解压到无空格、无中文的简单路径。
    • Example: D:\armgcc\gcc-arm-none-eabi-10.3-2021.10

2. VSCode 插件安装

在扩展市场搜索并安装：

  • Embedded IDE (EIDE)
    • 注: Linux/macOS 用户需预装 .NET 6 Runtime
  • Cortex-Debug

二、关联配置 (Linkage)

这是最关键的一步，必须分别告诉 EIDE 和 Cortex-Debug 工具链在哪里。

1. 配置 EIDE (Builder Path)

  1. VSCode 设置 -> 搜索 @ext:cl.eide。
  2. 找到 EIDE.ARM.GCC: Install Directory。
  3. 填入 GCC 根目录 (不带 bin)。
    • Example: D:\armgcc\gcc-arm-none-eabi-10.3-2021.10

2. 配置 Cortex-Debug (Debugger Path)

  1. VSCode 设置 -> 搜索 @ext:marus25.cortex-debug。
  2. 点击 Edit in settings.json。
  3. 填入 GCC 的 bin 目录 (带 bin)。
1
2
3
4
5
6
7
{
    // EIDE 设置 (根目录)
    "EIDE.ARM.GCC.InstallDirectory": "D:\\armgcc\\gcc-arm-none-eabi-10.3-2021.10",

    // Cortex-Debug 设置 (Bin目录) - 注意双反斜杠
    "cortex-debug.armToolchainPath": "D:\\armgcc\\gcc-arm-none-eabi-10.3-2021.10\\bin"
}

三、工程导入与修复 (Import & Fix)

1. 导入 Eclipse GCC 工程

  1. 点击 EIDE 图标 -> Import Project -> Eclipse embedded gcc projects。

  2. 选择官方模板中的 .cproject 文件。

2. 修复 Linker 路径 (The Trap)

官方模板的 Linker 路径在 EIDE 中不兼容，必须手动修复。

  1. EIDE 视图 -> Builder Options -> Linker。

  2. 找到 Other Linker Options。

  3. 修改 -T 参数为相对路径。

    • ❌ 错误: -T../config/linker/hc32f4a0xi.ld

    • ✅ 正确: -T./config/linker/HC32F4A0xl.ld

    • 注: Linux 下注意文件名大小写。

四、下载与调试 (Flash & Debug)

1. 配置下载器 (Flasher)

  1. EIDE 视图 -> Flasher Configurations。

  2. 选择 pyOCD 或 JLink。

  3. 设置 Target Name (如 hc32f4a0)。

2. 生成调试配置 (Launch.json)

  1. 右键项目根目录 -> Generate Debugger Configuration。

  2. 选择对应下载器 (pyOCD/JLink)。

3. (Pro Tip) 添加 SVD 寄存器视图

为了调试时能看寄存器，修改生成的 .vscode/launch.json：

JSON

1
2
3
4
5
6
7
8
9
10
11
{
    "configurations": [
        {
            "name": "Debug: pyOCD",
            "type": "cortex-debug",
            // ...
            // 添加这一行，指向工程内的 SVD 文件
            "svdFile": "config/svd/HC32F4A0SITB.svd"
        }
    ]
}

五、总结

通过以上 SOP，我们实现了 HC32 开发环境的 Code-as-Infrastructure。相比 Keil，这套环境不仅免费、跨平台，而且拥有极其强大的代码补全和 Git 集成体验。