APM32F402/F403 pyOCD 内置支持完整教程：免 Pack 一键烧录调试

在 Linux、macOS 或轻量级 Windows 开发环境中，pyOCD 已经成为嵌入式调试与烧录的主流工具。极海 APM32F402/F403 芯片通过 AN1161 官方方法，可以深度集成到 pyOCD 内部，实现免外部 CMSIS-Pack、直接命令行调用、团队统一环境的高效开发流程。本文基于官方应用笔记，用最直白的工程步骤，带你一次性把 APM32F402/F403 做成 pyOCD 内置目标芯片。

资料获取：AN1161_APM32F402_F403_pyOCD内置支持

1. 为什么要把 APM32F402/F403 内置到 pyOCD？

告别外部 Pack 依赖：不用每次配置都加载 DFP 包，环境更干净
命令行直接调用：-t apm32f402xb 一键识别芯片
团队环境统一：一份定制 pyOCD 共享，所有人配置一致
灵活定制 Flash 算法：可自定义扇区、保护、编程时序
跨系统无缝使用：Windows/macOS/Linux 全平台通用

2. 整体实现思路（官方标准流程）

从 APM32F402/F403 DFP 包中提取 Flash 算法文件（.FLM）
使用 pyOCD 工具将 FLM 转为 Python 格式 Flash 算法
编写 Target 芯片描述文件，定义 Flash/RAM 地址空间
注册到 pyOCD 内置目标列表
测试擦除、下载、调试，验证功能正常

3. 前期准备（必备文件）

安装 Python 3.7+ 和 pyOCD

pip install pyocd

获取 APM32F402 的 Flash 算法文件：从官方 SDK 解压 Geehy.APM32F4xx_DFP.1.0.7.pack找到：APM32F402_128.FLM
下载 pyOCD 官方工具generate_flash_algo.py（来自 pyOCD GitHub/scripts）

4. 四步完成内置支持

第一步：生成 Flash 算法 Python 文件

将 FLM 和脚本放在同一目录，执行命令：

python generate_flash_algo.py -o apm32f402_flash_algo.py APM32F402_128.FLM --ram-address=0x20000000 --stack-size=0x1000

生成：apm32f402_flash_algo.py

第二步：新建 Target 描述文件

路径：pyocd/target/builtin/target_APM32F402xx.py

内容模板（直接复制）：

from ..coresight.coresight_target import CoreSightTarget
from ..core.memory_map import FlashRegion, RamRegion, MemoryMap

# 此处粘贴从apm32f402_flash_algo.py生成的FLASH_ALGO字典
FLASH_ALGO = {
    'load_address': 0x20000000,
    'instructions': [
        0xe7fdbe00, 0x4603b510,
        # ...（中间内容自动生成）
    ],
    'pc_init': 0x20000005,
    'pc_unInit': 0x20000035,
    'pc_program_page': 0x200000c3,
    'pc_erase_sector': 0x20000083,
    'pc_eraseAll': 0x20000047,
    'static_base': 0x200013c,
    'begin_stack': 0x20001940,
    'end_stack': 0x20000940,
    'begin_data': 0x20001000,
    'page_size': 0x400,
}

class APM32F402xB(CoreSightTarget):
    VENDOR = "Geehy"
    MEMORY_MAP = MemoryMap(
        FlashRegion(start=0x08000000, length=0x20000, blocksize=0x400, is_boot_memory=True, algo=FLASH_ALGO),
        RamRegion(start=0x20000000, length=0x8000)
    )
    def __init__(self, session):
        super().__init__(session, self.MEMORY_MAP)

第三步：注册到 pyOCD 内置列表

修改文件：pyocd/target/builtin/__init__.py
添加：

from . import target_APM32F402xx

BUILTIN_TARGETS = {
    # ... 其他芯片 ...
    "apm32f402xb": target_APM32F402xx.APM32F402xB,
}

第四步：测试验证（最关键）

查看目标是否存在

pyocd list --targets

看到 apm32f402xb 即成功

全片擦除测试

pyocd erase --chip -t apm32f402xb

固件下载测试

pyocd flash -t apm32f402xb test.hex

出现编程完成、芯片运行正常，即全部成功。

5. APM32F402/F403 关键内存参数

Flash 起始：0x08000000
Flash 大小：128KB（0x20000）
RAM 起始：0x20000000
RAM 大小：32KB（0x8000）
编程页大小：1KB（0x400）

6. 常见问题速解（AN1161 重点）

无法识别芯片：检查注册名是否为 apm32f402xb，路径是否正确
擦除失败：FLM 文件不对，或 RAM 地址、栈大小设置错误
下载失败：FlashRegion 长度与实际 Flash 不匹配
pyocd 报错algorithm missing：FLASH_ALGO 字典未正确粘贴

AN1161 提供的 APM32F402/F403 集成到 pyOCD 的方法，是目前最稳定、最简洁、最适合团队的官方方案。只需 4 步：提取 FLM → 生成 Python 算法 → 编写 Target → 注册列表，即可实现无 Pack、跨平台、命令行一键烧录调试。无论是个人开发、产线批量烧录还是 CI/CD 自动化部署，这套内置方案都能大幅提升效率。