mcpField
P
probe-rs

probe-rs

github.com/zhinkgit开发772635 次安装1 周前更新
代码仓库

关于 probe-rs

面向嵌入式开发的 `probe-rs` CLI 结构化包装 Skill，适用于需要探针管理和芯片调试的开发者。它覆盖烧录、内存操作、one-shot GDB 调试和 RTT 日志读取，并要求明确指定芯片型号。

主要功能

  1. 01枚举探针并查看目标信息
  2. 02烧录固件、擦除芯片和复位
  3. 03读取及写入内存
  4. 04启动 one-shot GDB 调试
  5. 05读取 RTT 日志

适用场景

  1. 01确认已连接的调试探针和目标
  2. 02向芯片烧录 ELF、HEX、BIN 或 UF2
  3. 03检查或修改目标内存
  4. 04执行一次性 GDB 调试并读取 RTT 日志

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zhinkgit/embeddedskills --skill probe-rs

安装后在 Claude Code 中输入/probe-rs确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

config.example.json
README.md
scripts/
probe_rs_exec.py
probe_rs_gdb_common.py
probe_rs_gdb.py
probe_rs_rtt.py
probe_rs_runtime.py
tests/
test_probe_list.py

详细介绍

来自项目 README

probe-rs 下载与调试

本 skill 提供 probe-rs CLI 的结构化包装，覆盖探针发现、目标信息、烧录、复位、内存读写、one-shot GDB 调试和 RTT 日志读取。

Windows 下优先使用 py -3 调用脚本；若 arm-none-eabi-gdb 已在 PATH 中，gdb 子命令可自动发现，不强依赖 skill config.json。

配置

环境级配置（skill/config.json）

首次使用前建议在 skill 目录下创建 config.json：

{
  "exe": "probe-rs",
  "gdb_exe": "C:\\Program Files\\Arm\\GNU Toolchain mingw-w64-x86_64-arm-none-eabi\\bin\\arm-none-eabi-gdb.exe",
  "gdb_port": 3333,
  "dap_port": 50000,
  "operation_mode": 1
}
  • exe：probe-rs 可执行文件路径或命令名
  • gdb_exe：arm-none-eabi-gdb 路径，gdb 子命令需要
  • gdb_port：默认 GDB 端口
  • dap_port：预留给交互式 DAP 会话
  • operation_mode：1 直接执行 / 2 输出风险摘要但不阻塞 / 3 执行前确认
工程级配置（.embeddedskills/config.json）
{
  "probe-rs": {
    "chip": "STM32F407VGTx",
    "protocol": "swd",
    "probe": "",
    "speed": 4000,
    "connect_under_reset": false
  }
}
  • chip：芯片型号，probe-rs 主后端必填
  • protocol：swd 或 jtag
  • probe：探针选择器，格式 VID:PID[:Serial]
  • speed：调试速率 kHz
  • connect_under_reset：连接时是否保持 reset

参数优先级：CLI 参数 > 工程配置（.embeddedskills/config.json）> state.json > skill 配置（config.json）> 默认值

各层职责：skill config.json 提供工具路径与端口等环境级常量；.embeddedskills/config.json 提供芯片、协议等工程级参数；CLI 参数在单次调用中覆盖一切。

子命令

子命令用途风险
list枚举可用探针低
info查看探针与目标信息低
flash烧录固件（elf/hex/bin/uf2）高
erase擦除芯片非易失存储高
reset复位目标芯片高
read-mem读取内存低
write-mem写内存高
attach / run包装 probe-rs attach/run低
gdb启动 GDB Server 并执行 one-shot 调试低
rtt读取 RTT 日志低

典型调用

# 列出探针
py -3 <skill-dir>/scripts/probe_rs_exec.py list --json

# 烧录 ELF
py -3 <skill-dir>/scripts/probe_rs_exec.py flash --chip STM32F407VGTx --file build/app.elf --json

# 烧录 BIN（必须提供地址）
py -3 <skill-dir>/scripts/probe_rs_exec.py flash --chip STM32F407VGTx --file build/app.bin --address 0x08000000 --json

# 读取内存
py -3 <skill-dir>/scripts/probe_rs_exec.py read-mem --chip STM32F407VGTx --address 0x20000000 --length 16 --width b32 --json

# one-shot backtrace
py -3 <skill-dir>/scripts/probe_rs_gdb.py backtrace --chip STM32F407VGTx --elf build/app.elf --json

# RTT
py -3 <skill-dir>/scripts/probe_rs_rtt.py --chip STM32F407VGTx --json

核心规则

  • 不自动猜测 chip，缺失时直接报错
  • 多探针场景建议显式提供 --probe；若未检测到任何探针，应提示用户检查 USB 连接并重试；若探针配置错误（如 VID:PID 不匹配），应报告具体错误信息并建议运行 list 子命令确认可用探针
  • .bin 烧录必须显式提供地址
  • workflow build-debug 只走 one-shot 诊断包装，不启动需要人工接管的长期 DAP 会话
  • Windows 下若要用 probe-rs 驱动 J-Link，通常需要切换到 WinUSB，这会影响 SEGGER 官方工具继续使用；若仍依赖 J-Link 官方工具链，优先继续用现有 jlink skill

评论

支持 Markdown