jlink
J-Link 下载与在线调试工具,用于探测设备、烧录固件、读写内存、查看寄存器、复位目标、读取 RTT/SWO 日志, 以及在线调试(暂停/恢复/单步/断点运行/调用栈/变量查看)。 当用户提到 J-Link、JLink、RTT、烧录固件、写内存、读内存、寄存器查看、目标复位、探针连通性检查、 在线调试、单步、断点、调用栈时自动触发,也兼容 /jlink 显式调用。 即使用户只是说"烧录一下"、"看看 RTT 输出"或"调试一下",只要上下文涉及 J-Link 探针就应触发此 skill。
zhinkgit · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add zhinkgit/embeddedskills --skill jlink技能说明
name: jlink description: >- J-Link 下载与在线调试工具,用于探测设备、烧录固件、读写内存、查看寄存器、复位目标、读取 RTT/SWO 日志, 以及在线调试(暂停/恢复/单步/断点运行/调用栈/变量查看)。 当用户提到 J-Link、JLink、RTT、烧录固件、写内存、读内存、寄存器查看、目标复位、探针连通性检查、 在线调试、单步、断点、调用栈时自动触发,也兼容 /jlink 显式调用。 即使用户只是说"烧录一下"、"看看 RTT 输出"或"调试一下",只要上下文涉及 J-Link 探针就应触发此 skill。 argument-hint: "[info|flash|read-mem|write-mem|regs|reset|halt|go|step|run-to|rtt|swo|gdb] ..."
J-Link 下载与在线调试
本 skill 提供 J-Link 探针的设备探测、固件烧录、内存读写、寄存器查看、目标复位、RTT 日志读取,以及轻量在线调试和 GDB 源码级调试能力。
配置
环境级配置(skill/config.json)
skill 目录下的 config.json 包含环境级配置(工具路径、端口号等),首次使用前确认 exe 路径正确:
{
"exe": "C:\\Program Files\\SEGGER\\JLink\\JLink.exe",
"gdbserver_exe": "C:\\Program Files\\SEGGER\\JLink\\JLinkGDBServerCL.exe",
"rtt_exe": "C:\\Program Files\\SEGGER\\JLink\\JLinkRTTClient.exe",
"gdb_exe": "C:\\Program Files\\Arm\\GNU Toolchain mingw-w64-x86_64-arm-none-eabi\\bin\\arm-none-eabi-gdb.exe",
"serial_no": "",
"rtt_telnet_port": 0,
"swo_command": [],
"operation_mode": 1
}
exe:JLink.exe 完整路径(必填)gdbserver_exe:JLinkGDBServerCL.exe 路径,RTT 和 GDB 调试需要rtt_exe:JLinkRTTClient.exe 路径gdb_exe:arm-none-eabi-gdb 路径,GDB 源码级调试需要serial_no:默认探针序列号,多探针场景下使用rtt_telnet_port:RTT 端口,0 表示使用工具默认值swo_command:可选,完整 SWO viewer 命令数组,供jlink_swo.py包装operation_mode:1直接执行 /2输出风险摘要但不阻塞 /3执行前确认
工程级配置(.embeddedskills/config.json)
设备参数(device/interface/speed)统一在工作区的 .embeddedskills/config.json 中管理:
{
"jlink": {
"device": "STM32F407VG",
"interface": "SWD",
"speed": "4000"
}
}
device:芯片型号(如 STM32F407VG、GD32F470ZG)interface:调试接口,SWD 或 JTAG,默认 SWDspeed:调试速率 kHz,默认 4000
参数解析优先级:CLI 显式参数 > .embeddedskills/config.json(工程级)> skill/config.json(环境级)> .embeddedskills/state.json > 默认值/报错
成功执行后,确认过的 device/interface/speed 会自动写回工程配置。
子命令
基础操作
| 子命令 | 用途 | 风险 |
|---|---|---|
info | 探测探针与目标连通性 | 低 |
flash | 烧录固件(.hex / .bin / .elf) | 高 |
read-mem | 读取内存区域 | 低 |
write-mem | 写入内存 | 高 |
regs | 查看 CPU 寄存器 | 低 |
reset | 复位目标芯片 | 高 |
rtt | 读取 RTT 日志输出 | 低 |
swo | 包装外部 SWO viewer 为统一事件流 | 低 |
在线调试(JLink Commander)
| 子命令 | 用途 | 风险 |
|---|---|---|
halt | 暂停 CPU,返回寄存器状态 | 低 |
go | 恢复 CPU 运行 | 低 |
step | 单步执行(支持指定步数),返回执行的指令和寄存器 | 低 |
run-to | 设置断点并运行,等待命中后返回状态 | 低 |
GDB 源码级调试
| 子命令 | 用途 | 依赖 |
|---|---|---|
gdb backtrace/locals | 查看调用栈和局部变量 | arm-none-eabi-gdb |
gdb break/continue/next/step/finish/until | one-shot 控制执行流 | arm-none-eabi-gdb |
gdb frame/print/watch/disassemble/threads/crash-report | one-shot 源码级诊断 | arm-none-eabi-gdb |
执行流程
- 读取
skill/config.json,确认exe路径有效 - 读取
.embeddedskills/config.json获取工程级配置(device/interface/speed) - 读取
.embeddedskills/state.json获取历史状态 - 参数解析优先级:CLI 显式参数 >
.embeddedskills/config.json(工程级)>skill/config.json(环境级)>.embeddedskills/state.json> 默认值/报错 - 若当前动作需要
device且仍为空,直接要求用户补充,绝不猜测 - 多探针场景未指定
serial_no时,列出探针让用户选择,不自动选择 - 按
operation_mode决定是否需要确认后执行 - 使用模板生成临时
.jlink命令文件,调用 JLink.exe 时带-NoGui 1 -ExitOnError 1 -AutoConnect 1 - 解析输出和返回码,返回结构化结果
- 成功执行后,将确认过的 device/interface/speed 写回
.embeddedskills/config.json
脚本调用
skill 目录下有四个 Python 脚本,使用标准库实现,无额外依赖。
jlink_exec.py — 基础操作 + 轻量调试
# 探测连通性
python <skill-dir>/scripts/jlink_exec.py info --device GD32F470ZG --json
# 烧录固件
python <skill-dir>/scripts/jlink_exec.py flash --file build/app.hex --device GD32F470ZG --json
# 烧录 .bin(必须提供地址)
python <skill-dir>/scripts/jlink_exec.py flash --file build/app.bin --device GD32F470ZG --address 0x08000000 --json
# 读取内存
python <skill-dir>/scripts/jlink_exec.py read-mem --address 0x08000000 --length 256 --device GD32F470ZG --json
# 写入内存
python <skill-dir>/scripts/jlink_exec.py write-mem --address 0x20000000 --value 0x12345678 --device GD32F470ZG --json
# 查看寄存器
python <skill-dir>/scripts/jlink_exec.py regs --device GD32F470ZG --json
# 复位目标
python <skill-dir>/scripts/jlink_exec.py reset --device GD32F470ZG --json
# 暂停 CPU
python <skill-dir>/scripts/jlink_exec.py halt --device GD32F470ZG --json
# 恢复运行
python <skill-dir>/scripts/jlink_exec.py go --device GD32F470ZG --json
# 单步执行(3 步)
python <skill-dir>/scripts/jlink_exec.py step --device GD32F470ZG --count 3 --json
# 运行到断点地址
python <skill-dir>/scripts/jlink_exec.py run-to --device GD32F470ZG --address 0x08001234 --timeout-ms 3000 --json
通用可选参数:--interface SWD|JTAG、--speed 4000、--serial-no <序列号>、--exe <JLink.exe路径>
jlink_rtt.py — RTT 日志读取
python <skill-dir>/scripts/jlink_rtt.py --device GD32F470ZG --json
可选参数:--serial-no、--channel、--encoding、--rtt-port、--gdbserver-exe <路径>、--rtt-exe <路径>
RTT 工作原理:脚本先通过 JLinkGDBServerCL.exe 建立调试连接,再启动 JLinkRTTClient.exe 读取 RTT 数据。--json 模式输出 JSON Lines。
jlink_swo.py — SWO 事件流包装
# 使用 config.json 里的 swo_command
python <skill-dir>/scripts/jlink_swo.py --json
# 或显式传入 viewer 命令
python <skill-dir>/scripts/jlink_swo.py \
--viewer-cmd JLinkSWOViewerCL.exe -device GD32F470ZG -itf SWD -speed 4000 \
--json
jlink_swo.py 不直接实现 SWO 协议,而是把外部 viewer 的 stdout/stderr 统一包装成 JSON Lines,便于上层 workflow 或 AI 继续消费。
jlink_gdb.py — GDB 源码级调试(需要 arm-none-eabi-gdb)
# 执行自定义 GDB 命令序列
python <skill-dir>/scripts/jlink_gdb.py run \
--gdbserver-exe <路径> --gdb-exe <arm-none-eabi-gdb路径> \
--device GD32F470ZG --elf build/app.elf \
--commands "break main" "continue" "backtrace" "info locals" --json
# 快捷:获取调用栈
python <skill-dir>/scripts/jlink_gdb.py backtrace \
--gdbserver-exe <路径> --gdb-exe <路径> \
--device GD32F470ZG --elf build/app.elf --json
# 快捷:查看局部变量
python <skill-dir>/scripts/jlink_gdb.py locals \
--gdbserver-exe <路径> --gdb-exe <路径> \
--device GD32F470ZG --elf build/app.elf --json
GDB 调试需要 ELF 文件才能进行源码级调试(断点到函数名、查看变量)。没有 ELF 时仍可使用地址级调试。
输出格式
所有脚本以 JSON 格式返回,基础字段为 status(ok/error)、action、summary、details,并可能附带 context、artifacts、metrics、`s