• 正文
  • 相关推荐
申请入驻 产业图谱

极海 G32R501 Keil Debug Tool 工具使用实操手册

11/12 14:09
62
加入交流群
扫码加入
获取工程师必备礼包
参与热点资讯讨论

本文基于珠海极海半导体 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 工具核心功能

  1. 读取解析编译输出 AXF / ELF 文件,提取栈指针 SP、程序计数器 PC;
  2. 自动修改 / 生成 Keil 调试初始化 INI 脚本;
  3. 在脚本中填充 SP、PC、DCS 密钥配置、BOOT 启动相关配置;
  4. 支持复位时直接加载固件 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 命令行调用示例

  1. 解析 AXF,输出生成调试 INI 脚本:
keil_dbg_tool -a project.axf -d project_dbg.ini
  1. 查看工具版本以及构建日期:
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 脚本关键函数说明

  1. DCS_KEY_Setup() 用于配置 DCS 安全模块密钥;G32R5xx 具备 Zone1、Zone2 两个 DCS 安全区域,每个区域拥有独立 CSM 密钥寄存器;使用_WDWORD()向指定寄存器地址写入密钥;寄存器地址、密钥数值需要查阅芯片对应手册。软件复位事件、调试会话启动都会执行该函数。
  2. Set_SP_PC_Setup() 设置栈指针 SP、程序计数器 PC,同时配置 xPSR 寄存器;该部分数值由keil_dbg_tool解析 AXF 文件自动填充,不需要人工修改。
  3. Setup() 完成 CPU 初始化,调用 SP/PC 设置函数。
  4. OnResetExec() 软件复位触发时自动回调执行,完成 DCS 密钥配置、CPU 与寄存器初始化。

落地提示:禁止手动随意修改由工具生成的 SP、PC 地址,错误数值会直接导致仿真会话异常、程序跑飞。密钥值以芯片数据手册为准,示例中的 0xFFFFFFFF 仅作为演示。

4. MDK‑ARM 工程完整集成操作步骤

将工具配置为 MDK 构建后执行步骤,每次编译工程自动解析 AXF,刷新 debug INI 脚本,保证调试脚本与当前编译固件匹配。

4.1 添加构建后自定义步骤

  1. 将keil_dbg_tool.exe放置到项目目录,例如utilities\子目录;
  2. 打开 MDK 工程,点击工具栏「Options for Target」;
  3. 切换到【User】选项卡;
  4. 在Before Build/Rebuild分组,勾选 Run #1 / Run #2;
  5. 在命令输入框填写完整调用命令;
  6. 点击 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 脚本

  1. 打开工程「Options for Target」;
  2. 切换到【Debug】选项卡;
  3. 在Initialization File项,点击浏览按钮,选中工具生成的*.ini调试脚本;
  4. 确认勾选Load Application at Startup、Run to main();
  5. 点击 OK 保存配置。

生效逻辑:进入仿真调试会话,MDK 会自动加载执行该 INI 脚本,完成 DCS 密钥、SP、PC 寄存器配置。
声明:本文全部内容转录自极海官方 AN1129 V1.1 应用笔记,实际开发需要结合 G32R501 芯片手册完成整机验证。

相关推荐