本文基于珠海极海半导体 AN1129 (V1.1) 官方文档,完整解读keil_dbg_tool工具的用途、命令行参数、INI 脚本解析、MDK‑ARM 工程集成全流程。G32R5xx 系列芯片仿真调试需要配置 BOOT 启动地址、DCS 安全模块密钥,该工具自动化完成解析 AXF/ELF 文件、生成调试初始化 INI 脚本,解决手动编写调试脚本容易出错的问题,全部配置、命令、操作步骤均源自原厂文档,用于 G32R501 项目仿真调试配置参考。
资料获取:AN1129_G32R501 Keil Debug Tool 用户手册
1. 工具简介与运行环境
G32R5xx 系列 MCU 仿真调试,需要预先配置仿真相关数据流,包含 BOOT 启动地址、DCS(设备配置与安全模块)密钥等配置项。手动编写调试初始化 INI 脚本容易出现 SP 栈指针、PC 程序计数器、DCS 密钥配置错误,直接导致仿真异常、无法正常进入调试会话。
keil_dbg_tool工具可以自动化处理上述配置:解析工程输出 AXF (ELF) 目标文件,自动生成适配芯片的 debug 调试 INI 脚本,简化 G32R501 仿真环境配置工作。
工具运行环境:
- PC 操作系统:Windows10 / Windows11
- 依赖运行环境:Python3.11
2. keil_dbg_tool 工具核心能力与命令行参数
2.1 工具核心功能
- 读取解析编译输出 AXF / ELF 文件,提取栈指针 SP、程序计数器 PC;
- 自动修改 / 生成 Keil 调试初始化 INI 脚本;
- 在脚本中填充 SP、PC、DCS 密钥配置、BOOT 启动相关配置;
- 支持复位时直接加载固件 SP/PC,跳过引导代码,提升调试效率。
2.2 全部命令行参数说明
keil_dbg_tool -a <axf(elf) 文件路径> [-r] -d <输出debug 文件路径> [-v]
| 参数 | 是否可选 | 参数含义 |
|---|---|---|
‑a <axf文件路径> |
必选 | 指定输入 AXF 或者 ELF 目标文件路径 |
‑d <输出debug文件路径> |
必选 | 指定生成输出调试 INI 脚本文件的保存路径 |
‑r |
可选 | 复位调试时跳过引导代码,直接设置固件对应的 SP 与 PC 寄存器 |
‑v |
可选 | 打印工具版本号与构建日期信息 |
‑h |
可选 | 输出工具帮助说明信息 |
2.3 命令行调用示例
- 解析 AXF,输出生成调试 INI 脚本:
keil_dbg_tool -a project.axf -d project_dbg.ini
- 查看工具版本以及构建日期:
keil_dbg_tool -v
3. 调试 INI 初始化脚本解析
INI 脚本是 Keil MDK 的调试初始化脚本,下载完成、软件复位时自动执行脚本内函数,完成 DCS 密钥写入、SP/PC 寄存器赋值。
3.1 INI 脚本完整示例代码
FUNC void DCS_KEY_Setup()
{
// DCS Zone1 CSM
_WDWORD(0x50024020, DCS_ZONE1_CSM0);
_WDWORD(0x50024024, DCS_ZONE1_CSM1);
_WDWORD(0x50024028, DCS_ZONE1_CSM2);
_WDWORD(0x5002402C, DCS_ZONE1_CSM3);
// DCS Zone2 CSM
_WDWORD(0x500240A0, DCS_ZONE2_CSM0);
_WDWORD(0x500240A4, DCS_ZONE2_CSM1);
_WDWORD(0x500240A8, DCS_ZONE2_CSM2);
_WDWORD(0x500240AC, DCS_ZONE2_CSM3);
}
FUNC void Set_SP_PC_Setup(void)
{
SP= 0x20004000;
PC= 0x000009F0;
xPSR |= (1 << 24);
}
FUNC void Setup(void) {
Init_CPU();
Set_SP_PC_Setup();
}
FUNC void OnResetExec (void) { // Executes upon software RESET
DCS_KEY_Setup();
Setup() ; // Setup for running
}
DCS_KEY_Setup();
LOAD %L INCREMENTAL
Setup();
3.2 脚本关键函数说明
- DCS_KEY_Setup() 用于配置 DCS 安全模块密钥;G32R5xx 具备 Zone1、Zone2 两个 DCS 安全区域,每个区域拥有独立 CSM 密钥寄存器;使用
_WDWORD()向指定寄存器地址写入密钥;寄存器地址、密钥数值需要查阅芯片对应手册。软件复位事件、调试会话启动都会执行该函数。 - Set_SP_PC_Setup() 设置栈指针 SP、程序计数器 PC,同时配置 xPSR 寄存器;该部分数值由
keil_dbg_tool解析 AXF 文件自动填充,不需要人工修改。 - Setup() 完成 CPU 初始化,调用 SP/PC 设置函数。
- OnResetExec() 软件复位触发时自动回调执行,完成 DCS 密钥配置、CPU 与寄存器初始化。
落地提示:禁止手动随意修改由工具生成的 SP、PC 地址,错误数值会直接导致仿真会话异常、程序跑飞。密钥值以芯片数据手册为准,示例中的 0xFFFFFFFF 仅作为演示。
4. MDK‑ARM 工程完整集成操作步骤
将工具配置为 MDK 构建后执行步骤,每次编译工程自动解析 AXF,刷新 debug INI 脚本,保证调试脚本与当前编译固件匹配。
4.1 添加构建后自定义步骤
- 将
keil_dbg_tool.exe放置到项目目录,例如utilities\子目录; - 打开 MDK 工程,点击工具栏「Options for Target」;
- 切换到【User】选项卡;
- 在
Before Build/Rebuild分组,勾选 Run #1 / Run #2; - 在命令输入框填写完整调用命令;
- 点击 OK 保存项目配置。
重要路径规则:
- 路径不包含空格:直接填写路径;
- 如果路径包含空格,整个文件路径必须包裹英文双引号,否则命令执行报错。
| 错误写法(路径带空格未加引号) | 正确写法 |
|---|---|
..\my folder\keil_dbg_tool -a project.axf |
..\"my folder"\keil_dbg_tool -a "project.axf" |
参考完整命令示例:
..\..\..\..\utilities\keil_dbg_tool\keil_dbg_tool -r -a "#L" -d .\r501_dbg.ini
4.2 工程指定仿真初始化 INI 脚本
- 打开工程「Options for Target」;
- 切换到【Debug】选项卡;
- 在
Initialization File项,点击浏览按钮,选中工具生成的*.ini调试脚本; - 确认勾选
Load Application at Startup、Run to main(); - 点击 OK 保存配置。
生效逻辑:进入仿真调试会话,MDK 会自动加载执行该 INI 脚本,完成 DCS 密钥、SP、PC 寄存器配置。
声明:本文全部内容转录自极海官方 AN1129 V1.1 应用笔记,实际开发需要结合 G32R501 芯片手册完成整机验证。
62