APM32 新建工程

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

前置准备

1. 安装 J-Link：APM32 下载 / 调试 / 烧录依赖 SEGGER J-Link 软件包（见「帮助文档 → 安装说明」）。
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 调试器到目标板，并确认目标板上电。
2. 在 工程 → 选项 → 调试配置 中设置调试器类型为 J-Link，选择目标速度、运行位置等。
3. 点击 调试 → Debug 进入调试会话；也可直接使用 下载 / 擦除 进行单独烧录。

提示：CytStudio 的 FLM 算法引擎会解析 Keil 风格 .flm 算法并在 RAM 内执行片内烧录，算法优先选用 J-Link 内建，其次为已安装的 Pack FLM。

常见问题

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

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

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

1. 检查 J-Link 驱动是否已安装并在设备管理器中正确识别
2. 确认目标板已上电、连接线正常
3. 检查芯片型号与烧录算法是否匹配

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