APM32 新建工程

本指南演示如何在 CytStudio 中新建一个面向 Geehy（极海）APM32 系列 MCU 的工程，并完成芯片、构建与调试配置。

前置准备

  1. 准备调试方式（三选一）：
    • J-Link：安装 SEGGER J-Link 软件包后连接目标板（见「帮助文档 → 安装调试探针」）
    • DAPLink（CMSIS-DAP）：直接插入 DAPLink 兼容探针即可，CytStudio 原生支持 CMSIS-DAP v1 / v2
    • 内置仿真（Virt-Simulator）：暂时没有开发板也没关系，可在调试配置中选择仿真机型直接调试
  2. 安装工具链：确认已安装 GCC（arm-none-eabi-gcc），或直接使用 CytStudio 内置的 Clang 编译器。
  3. 设备支持：APM32 对应的调试 / 烧录算法可用（CytStudio 已内置APM32F1/F4 CMSIS-Pack 设备支持）。

新建工程步骤

  1. 打开 CytStudio，点击 工程 → 新建工程。
  2. 选择工程所在的文件夹根目录，点击 保存。项目会在左侧文件树中显示。
  3. 点击 工程 → 选项 或者点击 配置当前工程图标，打开工程配置。
  4. 在 芯片类型 中搜索并选择你的 APM32 芯片型号（例如 APM32F407、APM32F103 等）。
  5. 确认 CPU / FPU 配置与芯片手册一致。
  6. 在CMSIS组件中勾选需要的组件模块，然后保存。
  7. 配置 工具链：CytStudio 会根据配置在 GCC / Clang 之间自动选择 (若选择Clang，需要勾选注入TLS(因为APM32的链接脚本没有做对clang语法的完全支持))。

添加源文件与头文件

  1. APM32F1/F4 使用 CMSIS-Pack 组件，只需在组件树中勾选所需模块。
  2. 创建完毕后，在左侧文件树中，工程源码会显示出来。
  3. 包含路径与宏定义会自动并入每次构建；

配置构建

  • 增量编译：点击 F7，仅重编译变更的源文件。
  • 单文件编译：点击 Ctrl + F7 编译当前文件。
  • 重新编译全部：点击 Ctrl + Alt + F7。
  • 链接脚本：在工程配置中指定目标芯片对应的链接脚本（.ld / .icf）。

配置烧录与调试

  1. 连接调试探针到目标板，并确认目标板上电（J-Link 或 DAPLink 均可）。
  2. 在 工程 → 选项 → 调试配置 中选择调试器类型：
    • J-Link：选择 SWD / JTAG 接口与目标速度
    • DAPLink：选中芯片后上方 Core 会自动同步，RAM 基址 / 容量随芯片自动刷新
    • Virt-Simulator：无需硬件，按内核 + 链接地址自动匹配仿真机型（也可手动指定）
  3. 点击 调试 → Debug 进入调试会话；也可直接使用 下载 / 擦除 进行单独烧录。

提示：CytStudio 的 FLM 算法引擎会解析 Keil 风格 .flm 算法并在 RAM 内执行片内烧录，算法优先选用 J-Link 内建，其次为已安装的 Pack FLM；使用 DAPLink 时可在调试配置中勾选「使用内置 FLM」。调试日志会输出探针枚举、SWJ 时钟、端口上电与复位等诊断信息，连接异常时先看这几行。

常见问题

Q: 列表中找不到 APM32 芯片？

请确认已通过 CMSIS-Pack 管理器安装包含该设备支持的 Pack，然后重启工程配置。

Q: 烧录失败 / 无法下载？

  1. 检查调试探针是否已安装驱动并在设备管理器中正确识别（J-Link 需安装 SEGGER 软件包，DAPLink 免驱）
  2. 确认目标板已上电、连接线正常
  3. 检查芯片型号与烧录算法是否匹配；DAPLink 场景请确认已安装对应 Pack 或勾选「使用内置 FLM」

Q: 手边没有 APM32 开发板，能先验证代码吗？

可以在 调试配置 中选择 Virt-Simulator（仿真），用内置 QEMU 仿真调试运行固件，断点、单步、变量与波形都可用；涉及厂商专有外设时序的部分仍需到真机复验。

文档持续更新中，如有疑问欢迎通过问题反馈提交！