gdb — GDB 服务器
Usage: HFLinkCLI gdb [options]
启动 GDB 远程串行协议(RSP)服务器:多核目标默认每核一个 TCP 端口(基准端口 + 核序号,
最多 4 核),启动后打印端口映射表 coreN(Pname.Punit) -> host:port。
Example:
HFLinkCLI gdb --pack STM32H723ZGTx@STM32H7xx_DFP --interface swd --speed 10000000 \
--rtt --elf app.elf --semihosting
选项
选项 |
参数 |
默认值 |
说明 |
|---|---|---|---|
|
|
|
基准 GDB 端口 [1, 65535];多核每核 |
|
|
|
监听地址; |
|
|
全部核 |
只服务指定核(单核模式),如 |
|
|
无 |
ELF 文件;解析 |
|
flag |
off |
启用 RTT;无 |
|
flag |
off |
启用 ARM semihosting(SYS_WRITEC/WRITE0 输出经 RTT 通道或 stdout) |
|
|
进程 cwd |
semihosting 文件操作的工作目录 |
|
|
无 |
连接后执行的 Lua 配置脚本(如 |
|
flag |
off |
记录每个 RSP 包( |
RTT 控制块定位优先级:--rtt-addr > ELF 符号 > Lua 配置 > 自动扫描。
RTT 数据经全局选项 --rtt-telnet 的 telnet 服务端输出(gdb 下多核默认端口从 19021 起按核递增)。
GDB 侧行为
内存映射:启动时按 Pack 设备信息自动生成 memory-map(RAM/Flash 区段)并报告给 GDB; 这是
load命令走vFlashErase/vFlashWrite流程的前提,Flash 区段直写会被硬件静默丢弃。qSupported:协商
PacketSize=4000、swbreak+、vContSupported+、QStartNoAckMode+等。断点/观察点:
Z0/Z1软/硬件断点,Z2/Z3/Z4写/读/访问观察点。SIGINT:Ctrl-C 触发目标 halt。
monitor 命令
在 GDB 中使用 monitor <command>:
命令 |
说明 |
|---|---|
|
reset-halt:halt → 复位 → 重新 examine → PC/SP 指向复位向量 |
|
启停 RTT |
|
启停 semihosting |
|
读内存显示(count ≤ 256) |
|
写内存 |
|
查询当前 SWD 时钟 |
未识别的 monitor 命令回落到会话内置表(halt / resume / reg 等)。
连接示例
# 单核
HFLinkCLI gdb --pack STM32H723ZGTx@STM32H7xx_DFP --interface swd --speed 10000000
# 双核:GDB 端口 3333/3334,RTT telnet 端口 19021/19022
HFLinkCLI gdb --pack STM32H745ZGTx@STM32H7xx_DFP --interface swd --speed 10000000 -p 3333 --rtt
# GDB 侧
(gdb) target remote :3333
(gdb) load
(gdb) monitor reset
(gdb) continue